@lacspace/courier
Courier / last-mile delivery toolkit — canonical delivery state machine, Pathao (Nepal) adapter, and inbound webhook verification + status normalization. Zero-dependency, isomorphic.
npm i @lacspace/courierUsage
import { createPathaoAdapter, verifyPathaoWebhook, parsePathaoWebhook } from "@lacspace/courier";
const pathao = createPathaoAdapter({ clientId, clientSecret, username, password, storeId: 42 });
const shipment = await pathao.createOrder({
recipientName: "Sita", recipientPhone: "98xxxxxxxx",
recipientAddress: "Baneshwor, KTM", amountToCollect: 250000, itemQuantity: 1,
});
// inbound webhook -> canonical status, no more manual clicking
if (verifyPathaoWebhook({ headerSecret: req.headers["x-pathao-signature"], expectedSecret })) {
const evt = parsePathaoWebhook(req.body); // { status: "delivered", consignmentId, ... }
}Exports 11
createPathaoAdaptertransitioncanTransitionisTerminalnormalizePathaoStatusparsePathaoWebhookverifyPathaoWebhookverifyWebhookSignatureDELIVERY_TRANSITIONSPATHAO_STATUS_MAPCourierErrorKeywords
More in Commerce & Ledger
Headless, framework-agnostic shopping-cart engine — pure, immutable & serializable. Add/merge lines, set quantities, compute tax/discount/shipping totals in integer minor units. Isomorphic (Node, edge, browser).
@lacspace/inventoryStock-tracking engine that prevents overselling — reserve, release, commit & restock over a plain { onHand, reserved } state. Immutable, bring-your-own-store, throws before it oversells. Isomorphic.
@lacspace/commissionCommission & payout calculation engine — flat, percentage and marginal-tiered rules with min/cap, plus exact proportional split with remainder distribution. Integer minor units, zero floats. Isomorphic.
@lacspace/settlementSettlement, netting & reconciliation for multi-party payouts — net signed ledger entries per account, reconcile expected vs actual, and list payable positive balances. Integer minor units, pure functions. Isomorphic.
@lacspace/couponDiscount & coupon engine — percent, fixed and free-shipping codes with validity windows, minimum-subtotal, discount caps and usage limits. Integer minor units, no float drift. Zero-dependency, isomorphic.
@lacspace/taxVAT & sales-tax done right — exact integer minor-unit arithmetic (no float cents bugs), add/extract tax, inclusive & exclusive prices, compound taxes, half-up/bankers rounding. Isomorphic.