@mitumbadotafrica/logistics 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,64 @@
+# @mitumbadotafrica/logistics
+
+The headless, carrier-neutral client for Mitumba Logistics. It speaks the HTTP contract and
+nothing else: no carrier code, no routing rules, no secrets. Re-exports
+`@mitumbadotafrica/logistics-contract`, so one import is enough.
+
+```bash
+npm install @mitumbadotafrica/logistics
+```
+
+```ts
+import { MitumbaLogistics } from '@mitumbadotafrica/logistics'
+
+const logistics = new MitumbaLogistics({ token: () => session.accessToken })
+```
+
+`token` is a string or a function returning one (sync or async). `baseUrl`, `fetch`, `maxRetries`
+and `debug` are optional. A non-2xx response throws a `LogisticsError` with `status`, `code` and,
+where the backend gives one, `reason`.
+
+## Checkout delivery: basket quotes
+
+Price each shop's basket before any order exists. The backend derives the origin from the shop.
+You send the destination: a saved address, or a "Deliver to" point with its region.
+
+```ts
+const { baskets } = await logistics.quoteBaskets({
+  market_code: 'KE',
+  destination: { type: 'address', address_id },
+  baskets: [{ store_id, items: [{ listing_id, quantity: 2 }] }],
+})
+```
+
+Each basket is `available` with options, or `unavailable` with a `reason`. An available basket
+has one option per door method and one per nearby pickup hub (`option.hub`). The helpers below
+arrange what came back. They never choose a carrier or invent a price:
+
+| Helper | Use |
+|---|---|
+| `methodChoices(basket)` | Options grouped by method, with the cheapest and whether a hub is picked |
+| `methodLabel(method)`, `unavailableLabel(reason)`, `etaLabel(eta)` | Buyer-facing copy, overridable, safe for unknown values |
+| `isQuoteExpired(option)` | Re-quote once `expires_at` has passed |
+| `checkoutDeliveries(baskets, picks)` | The `deliveries: [{ store_id, quote_id }]` checkout takes, or which shops are missing or undeliverable |
+
+A quote is bound to the buyer, shop, market, destination and the basket's exact items. Re-quote
+after any of them changes.
+
+## Seller delivery data
+
+```ts
+await logistics.setStoreOrigin(storeId, { latitude, longitude, address_line, dropoff_node_id: null })
+await logistics.setListingPackage(listingId, 'medium')   // small | medium | large | oversize
+```
+
+`getStoreOrigin` and `getListingPackage` read them back. A listing without a size reports its
+category default (`source: 'category_default'`).
+
+## Orders and parcels
+
+`getMarkets()`, `quote()` (an existing order), `createParcel()`, `getParcel()`, and
+`pollParcel(client, parcelId, options)`. `pollParcel` stops at a terminal status, or at
+`action_required` so you can surface the next action.
+
+MIT

package/dist/index.cjs

@@ -25,7 +25,13 @@ __export(index_exports, {
   HttpClient: () => HttpClient,
   LogisticsError: () => LogisticsError,
   MitumbaLogistics: () => MitumbaLogistics,
-  pollParcel: () => pollParcel
+  checkoutDeliveries: () => checkoutDeliveries,
+  etaLabel: () => etaLabel,
+  isQuoteExpired: () => isQuoteExpired,
+  methodChoices: () => methodChoices,
+  methodLabel: () => methodLabel,
+  pollParcel: () => pollParcel,
+  unavailableLabel: () => unavailableLabel
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -73,6 +79,10 @@ var HttpClient = class {
   async post(path, body, options) {
     return this.request("POST", path, body, options);
   }
+  /** PUT replaces a whole resource, so it is idempotent; it is still only retried on network errors. */
+  async put(path, body, options) {
+    return this.request("PUT", path, body, options);
+  }
   async request(method, path, body, options) {
     const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
     const token = options?.token ?? await this.resolveToken();
@@ -161,6 +171,37 @@ var MitumbaLogistics = class {
   async getParcel(parcelId, options) {
     return this.http.get(`/logistics/parcels/${encodeURIComponent(parcelId)}`, options);
   }
+  /**
+   * Price each shop basket before any order exists. Origin is the shop (derived
+   * by the backend); destination is the buyer's saved address or a "Deliver to"
+   * point. Each available basket has one option per door method and one per
+   * nearby pickup hub; pass the picked option's `quote_id` per shop to checkout.
+   * An unservable basket comes back `unavailable` with a reason, not as an error.
+   * Requires the buyer's token.
+   */
+  async quoteBaskets(input, options) {
+    return this.http.post("/logistics/basket-quotes", input, options);
+  }
+  /** Seller: where a shop's parcels start. Fields are null until set. */
+  async getStoreOrigin(storeId, options) {
+    return this.http.get(`/logistics/stores/${encodeURIComponent(storeId)}/origin`, options);
+  }
+  /** Seller: replace a shop's dispatch point. */
+  async setStoreOrigin(storeId, input, options) {
+    return this.http.put(`/logistics/stores/${encodeURIComponent(storeId)}/origin`, input, options);
+  }
+  /** Seller: a listing's package size, or its category default when unset. */
+  async getListingPackage(listingId, options) {
+    return this.http.get(`/logistics/listings/${encodeURIComponent(listingId)}/package`, options);
+  }
+  /** Seller: set a listing's package size. */
+  async setListingPackage(listingId, packageSize, options) {
+    return this.http.put(
+      `/logistics/listings/${encodeURIComponent(listingId)}/package`,
+      { package_size: packageSize },
+      options
+    );
+  }
 };
 
 // src/polling.ts
@@ -208,6 +249,66 @@ function sleep(ms, signal) {
   });
 }
 
+// src/delivery.ts
+function methodChoices(basket) {
+  const byMethod = /* @__PURE__ */ new Map();
+  for (const option of basket.options) {
+    const options = byMethod.get(option.method) ?? [];
+    options.push(option);
+    byMethod.set(option.method, options);
+  }
+  return [...byMethod].map(([method, options]) => ({
+    method,
+    options,
+    cheapest: options.reduce((best, option) => option.price.minor_units < best.price.minor_units ? option : best),
+    needsHub: options.some((option) => option.hub !== void 0)
+  }));
+}
+var METHOD_LABELS = {
+  pickup_point: "Pickup point",
+  doorstep: "Door delivery",
+  same_day: "Same-day delivery",
+  branch_collection: "Branch collection"
+};
+function methodLabel(method, overrides = {}) {
+  return overrides[method] ?? METHOD_LABELS[method] ?? method.replace(/_/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+}
+function unavailableLabel(reason, overrides = {}) {
+  const defaults = {
+    no_carrier_for_lane: "No delivery is available from this shop to your location yet.",
+    outside_market: "This shop does not deliver to that location.",
+    listing_unavailable: "An item from this shop is no longer available."
+  };
+  const key = reason ?? "";
+  return overrides[key] ?? defaults[key] ?? "Delivery is unavailable for this shop.";
+}
+function etaLabel(eta) {
+  if (eta.max_days <= 1 && eta.min_days === 0) return "Same day";
+  if (eta.min_days === eta.max_days) return `${eta.max_days} ${eta.max_days === 1 ? "day" : "days"}`;
+  return `${eta.min_days}\u2013${eta.max_days} days`;
+}
+function isQuoteExpired(option, now = /* @__PURE__ */ new Date()) {
+  return Date.parse(option.expires_at) <= now.getTime();
+}
+function checkoutDeliveries(baskets, picks) {
+  const missing = [];
+  const unavailable = [];
+  const deliveries = [];
+  for (const basket of baskets) {
+    if (basket.status !== "available" || basket.options.length === 0) {
+      unavailable.push(basket.store_id);
+      continue;
+    }
+    const quoteId = picks[basket.store_id];
+    if (!quoteId || !basket.options.some((option) => option.quote_id === quoteId)) {
+      missing.push(basket.store_id);
+      continue;
+    }
+    deliveries.push({ store_id: basket.store_id, quote_id: quoteId });
+  }
+  return missing.length === 0 && unavailable.length === 0 ? { ok: true, deliveries } : { ok: false, missing, unavailable };
+}
+
 // src/index.ts
 __reExport(index_exports, require("@mitumbadotafrica/logistics-contract"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -216,6 +317,12 @@ __reExport(index_exports, require("@mitumbadotafrica/logistics-contract"), modul
   HttpClient,
   LogisticsError,
   MitumbaLogistics,
+  checkoutDeliveries,
+  etaLabel,
+  isQuoteExpired,
+  methodChoices,
+  methodLabel,
   pollParcel,
+  unavailableLabel,
   ...require("@mitumbadotafrica/logistics-contract")
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { MarketsResponse, QuoteRequest, QuoteResponse, CreateParcelResponse, ParcelView, LogisticsErrorBody } from '@mitumbadotafrica/logistics-contract';
+import { MarketsResponse, QuoteRequest, QuoteResponse, CreateParcelResponse, ParcelView, BasketQuoteRequest, BasketQuoteResponse, StoreOrigin, StoreOriginInput, ListingPackage, PackageSize, LogisticsErrorBody, FulfilmentMethod, BasketQuoteOption, BasketQuote } from '@mitumbadotafrica/logistics-contract';
 export * from '@mitumbadotafrica/logistics-contract';
 
 /** Canonical public API base. Override for staging/self-hosting. */
@@ -76,6 +76,23 @@ declare class MitumbaLogistics {
      * whether one exists.
      */
     getParcel(parcelId: string, options?: RequestOptions): Promise<ParcelView>;
+    /**
+     * Price each shop basket before any order exists. Origin is the shop (derived
+     * by the backend); destination is the buyer's saved address or a "Deliver to"
+     * point. Each available basket has one option per door method and one per
+     * nearby pickup hub; pass the picked option's `quote_id` per shop to checkout.
+     * An unservable basket comes back `unavailable` with a reason, not as an error.
+     * Requires the buyer's token.
+     */
+    quoteBaskets(input: BasketQuoteRequest, options?: RequestOptions): Promise<BasketQuoteResponse>;
+    /** Seller: where a shop's parcels start. Fields are null until set. */
+    getStoreOrigin(storeId: string, options?: RequestOptions): Promise<StoreOrigin>;
+    /** Seller: replace a shop's dispatch point. */
+    setStoreOrigin(storeId: string, input: StoreOriginInput, options?: RequestOptions): Promise<StoreOrigin>;
+    /** Seller: a listing's package size, or its category default when unset. */
+    getListingPackage(listingId: string, options?: RequestOptions): Promise<ListingPackage>;
+    /** Seller: set a listing's package size. */
+    setListingPackage(listingId: string, packageSize: PackageSize, options?: RequestOptions): Promise<ListingPackage>;
 }
 
 /**
@@ -94,6 +111,8 @@ declare class HttpClient {
     private resolveToken;
     get<T>(path: string, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
+    /** PUT replaces a whole resource, so it is idempotent; it is still only retried on network errors. */
+    put<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
     private request;
 }
 
@@ -146,4 +165,54 @@ interface PollParcelOptions {
  */
 declare function pollParcel(client: MitumbaLogistics, parcelId: string, options?: PollParcelOptions): Promise<ParcelView | null>;
 
-export { type CreateParcelInput, DEFAULT_BASE_URL, HttpClient, LogisticsError, MitumbaLogistics, type MitumbaLogisticsConfig, type PollParcelOptions, type RequestOptions, type ShipmentPartyInput, pollParcel };
+/**
+ * Framework-free helpers for a checkout's delivery step, shared by the React and
+ * React Native pickers. They only arrange what the backend returned: the client
+ * never chooses a carrier, never prices, and never invents an option.
+ */
+/** The options of one method for a basket. A pickup method lists one option per hub. */
+interface MethodChoice {
+    method: FulfilmentMethod;
+    options: BasketQuoteOption[];
+    /** The cheapest option of the method, for a "from KES X" line. */
+    cheapest: BasketQuoteOption;
+    /** True when the buyer picks a hub (the options carry `hub`). */
+    needsHub: boolean;
+}
+/** Group a basket's options by method, in the order the backend returned them. */
+declare function methodChoices(basket: BasketQuote): MethodChoice[];
+/** Buyer-facing name for a method. An unknown method is humanised, never an error. */
+declare function methodLabel(method: FulfilmentMethod, overrides?: Partial<Record<string, string>>): string;
+/** Buyer-facing copy for an unavailable basket. An unknown reason gets the generic line. */
+declare function unavailableLabel(reason: string | undefined, overrides?: Partial<Record<string, string>>): string;
+/** "Same day", "1 day", "2–4 days". */
+declare function etaLabel(eta: {
+    min_days: number;
+    max_days: number;
+}): string;
+/** Has an option's quote stopped being claimable? Re-quote before checkout if so. */
+declare function isQuoteExpired(option: Pick<BasketQuoteOption, 'expires_at'>, now?: Date): boolean;
+/** One shop's pick, as checkout takes it: `deliveries: [{ store_id, quote_id }]`. */
+interface CheckoutDelivery {
+    store_id: string;
+    quote_id: string;
+}
+type CheckoutDeliveriesResult = {
+    ok: true;
+    deliveries: CheckoutDelivery[];
+}
+/** Shops the buyer has not picked a valid option for, and shops that cannot be delivered. */
+ | {
+    ok: false;
+    missing: string[];
+    unavailable: string[];
+};
+/**
+ * Turn the buyer's picks (store id → quote id) into checkout's `deliveries`.
+ * Every basket needs exactly one pick among its own options; an unavailable
+ * basket blocks checkout (the shop's items must be removed or the destination
+ * changed). A pick that is not one of the basket's options counts as missing.
+ */
+declare function checkoutDeliveries(baskets: readonly BasketQuote[], picks: Readonly<Record<string, string | undefined>>): CheckoutDeliveriesResult;
+
+export { type CheckoutDeliveriesResult, type CheckoutDelivery, type CreateParcelInput, DEFAULT_BASE_URL, HttpClient, LogisticsError, type MethodChoice, MitumbaLogistics, type MitumbaLogisticsConfig, type PollParcelOptions, type RequestOptions, type ShipmentPartyInput, checkoutDeliveries, etaLabel, isQuoteExpired, methodChoices, methodLabel, pollParcel, unavailableLabel };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MarketsResponse, QuoteRequest, QuoteResponse, CreateParcelResponse, ParcelView, LogisticsErrorBody } from '@mitumbadotafrica/logistics-contract';
+import { MarketsResponse, QuoteRequest, QuoteResponse, CreateParcelResponse, ParcelView, BasketQuoteRequest, BasketQuoteResponse, StoreOrigin, StoreOriginInput, ListingPackage, PackageSize, LogisticsErrorBody, FulfilmentMethod, BasketQuoteOption, BasketQuote } from '@mitumbadotafrica/logistics-contract';
 export * from '@mitumbadotafrica/logistics-contract';
 
 /** Canonical public API base. Override for staging/self-hosting. */
@@ -76,6 +76,23 @@ declare class MitumbaLogistics {
      * whether one exists.
      */
     getParcel(parcelId: string, options?: RequestOptions): Promise<ParcelView>;
+    /**
+     * Price each shop basket before any order exists. Origin is the shop (derived
+     * by the backend); destination is the buyer's saved address or a "Deliver to"
+     * point. Each available basket has one option per door method and one per
+     * nearby pickup hub; pass the picked option's `quote_id` per shop to checkout.
+     * An unservable basket comes back `unavailable` with a reason, not as an error.
+     * Requires the buyer's token.
+     */
+    quoteBaskets(input: BasketQuoteRequest, options?: RequestOptions): Promise<BasketQuoteResponse>;
+    /** Seller: where a shop's parcels start. Fields are null until set. */
+    getStoreOrigin(storeId: string, options?: RequestOptions): Promise<StoreOrigin>;
+    /** Seller: replace a shop's dispatch point. */
+    setStoreOrigin(storeId: string, input: StoreOriginInput, options?: RequestOptions): Promise<StoreOrigin>;
+    /** Seller: a listing's package size, or its category default when unset. */
+    getListingPackage(listingId: string, options?: RequestOptions): Promise<ListingPackage>;
+    /** Seller: set a listing's package size. */
+    setListingPackage(listingId: string, packageSize: PackageSize, options?: RequestOptions): Promise<ListingPackage>;
 }
 
 /**
@@ -94,6 +111,8 @@ declare class HttpClient {
     private resolveToken;
     get<T>(path: string, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
+    /** PUT replaces a whole resource, so it is idempotent; it is still only retried on network errors. */
+    put<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
     private request;
 }
 
@@ -146,4 +165,54 @@ interface PollParcelOptions {
  */
 declare function pollParcel(client: MitumbaLogistics, parcelId: string, options?: PollParcelOptions): Promise<ParcelView | null>;
 
-export { type CreateParcelInput, DEFAULT_BASE_URL, HttpClient, LogisticsError, MitumbaLogistics, type MitumbaLogisticsConfig, type PollParcelOptions, type RequestOptions, type ShipmentPartyInput, pollParcel };
+/**
+ * Framework-free helpers for a checkout's delivery step, shared by the React and
+ * React Native pickers. They only arrange what the backend returned: the client
+ * never chooses a carrier, never prices, and never invents an option.
+ */
+/** The options of one method for a basket. A pickup method lists one option per hub. */
+interface MethodChoice {
+    method: FulfilmentMethod;
+    options: BasketQuoteOption[];
+    /** The cheapest option of the method, for a "from KES X" line. */
+    cheapest: BasketQuoteOption;
+    /** True when the buyer picks a hub (the options carry `hub`). */
+    needsHub: boolean;
+}
+/** Group a basket's options by method, in the order the backend returned them. */
+declare function methodChoices(basket: BasketQuote): MethodChoice[];
+/** Buyer-facing name for a method. An unknown method is humanised, never an error. */
+declare function methodLabel(method: FulfilmentMethod, overrides?: Partial<Record<string, string>>): string;
+/** Buyer-facing copy for an unavailable basket. An unknown reason gets the generic line. */
+declare function unavailableLabel(reason: string | undefined, overrides?: Partial<Record<string, string>>): string;
+/** "Same day", "1 day", "2–4 days". */
+declare function etaLabel(eta: {
+    min_days: number;
+    max_days: number;
+}): string;
+/** Has an option's quote stopped being claimable? Re-quote before checkout if so. */
+declare function isQuoteExpired(option: Pick<BasketQuoteOption, 'expires_at'>, now?: Date): boolean;
+/** One shop's pick, as checkout takes it: `deliveries: [{ store_id, quote_id }]`. */
+interface CheckoutDelivery {
+    store_id: string;
+    quote_id: string;
+}
+type CheckoutDeliveriesResult = {
+    ok: true;
+    deliveries: CheckoutDelivery[];
+}
+/** Shops the buyer has not picked a valid option for, and shops that cannot be delivered. */
+ | {
+    ok: false;
+    missing: string[];
+    unavailable: string[];
+};
+/**
+ * Turn the buyer's picks (store id → quote id) into checkout's `deliveries`.
+ * Every basket needs exactly one pick among its own options; an unavailable
+ * basket blocks checkout (the shop's items must be removed or the destination
+ * changed). A pick that is not one of the basket's options counts as missing.
+ */
+declare function checkoutDeliveries(baskets: readonly BasketQuote[], picks: Readonly<Record<string, string | undefined>>): CheckoutDeliveriesResult;
+
+export { type CheckoutDeliveriesResult, type CheckoutDelivery, type CreateParcelInput, DEFAULT_BASE_URL, HttpClient, LogisticsError, type MethodChoice, MitumbaLogistics, type MitumbaLogisticsConfig, type PollParcelOptions, type RequestOptions, type ShipmentPartyInput, checkoutDeliveries, etaLabel, isQuoteExpired, methodChoices, methodLabel, pollParcel, unavailableLabel };

package/dist/index.js

@@ -42,6 +42,10 @@ var HttpClient = class {
   async post(path, body, options) {
     return this.request("POST", path, body, options);
   }
+  /** PUT replaces a whole resource, so it is idempotent; it is still only retried on network errors. */
+  async put(path, body, options) {
+    return this.request("PUT", path, body, options);
+  }
   async request(method, path, body, options) {
     const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
     const token = options?.token ?? await this.resolveToken();
@@ -130,6 +134,37 @@ var MitumbaLogistics = class {
   async getParcel(parcelId, options) {
     return this.http.get(`/logistics/parcels/${encodeURIComponent(parcelId)}`, options);
   }
+  /**
+   * Price each shop basket before any order exists. Origin is the shop (derived
+   * by the backend); destination is the buyer's saved address or a "Deliver to"
+   * point. Each available basket has one option per door method and one per
+   * nearby pickup hub; pass the picked option's `quote_id` per shop to checkout.
+   * An unservable basket comes back `unavailable` with a reason, not as an error.
+   * Requires the buyer's token.
+   */
+  async quoteBaskets(input, options) {
+    return this.http.post("/logistics/basket-quotes", input, options);
+  }
+  /** Seller: where a shop's parcels start. Fields are null until set. */
+  async getStoreOrigin(storeId, options) {
+    return this.http.get(`/logistics/stores/${encodeURIComponent(storeId)}/origin`, options);
+  }
+  /** Seller: replace a shop's dispatch point. */
+  async setStoreOrigin(storeId, input, options) {
+    return this.http.put(`/logistics/stores/${encodeURIComponent(storeId)}/origin`, input, options);
+  }
+  /** Seller: a listing's package size, or its category default when unset. */
+  async getListingPackage(listingId, options) {
+    return this.http.get(`/logistics/listings/${encodeURIComponent(listingId)}/package`, options);
+  }
+  /** Seller: set a listing's package size. */
+  async setListingPackage(listingId, packageSize, options) {
+    return this.http.put(
+      `/logistics/listings/${encodeURIComponent(listingId)}/package`,
+      { package_size: packageSize },
+      options
+    );
+  }
 };
 
 // src/polling.ts
@@ -177,6 +212,66 @@ function sleep(ms, signal) {
   });
 }
 
+// src/delivery.ts
+function methodChoices(basket) {
+  const byMethod = /* @__PURE__ */ new Map();
+  for (const option of basket.options) {
+    const options = byMethod.get(option.method) ?? [];
+    options.push(option);
+    byMethod.set(option.method, options);
+  }
+  return [...byMethod].map(([method, options]) => ({
+    method,
+    options,
+    cheapest: options.reduce((best, option) => option.price.minor_units < best.price.minor_units ? option : best),
+    needsHub: options.some((option) => option.hub !== void 0)
+  }));
+}
+var METHOD_LABELS = {
+  pickup_point: "Pickup point",
+  doorstep: "Door delivery",
+  same_day: "Same-day delivery",
+  branch_collection: "Branch collection"
+};
+function methodLabel(method, overrides = {}) {
+  return overrides[method] ?? METHOD_LABELS[method] ?? method.replace(/_/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+}
+function unavailableLabel(reason, overrides = {}) {
+  const defaults = {
+    no_carrier_for_lane: "No delivery is available from this shop to your location yet.",
+    outside_market: "This shop does not deliver to that location.",
+    listing_unavailable: "An item from this shop is no longer available."
+  };
+  const key = reason ?? "";
+  return overrides[key] ?? defaults[key] ?? "Delivery is unavailable for this shop.";
+}
+function etaLabel(eta) {
+  if (eta.max_days <= 1 && eta.min_days === 0) return "Same day";
+  if (eta.min_days === eta.max_days) return `${eta.max_days} ${eta.max_days === 1 ? "day" : "days"}`;
+  return `${eta.min_days}\u2013${eta.max_days} days`;
+}
+function isQuoteExpired(option, now = /* @__PURE__ */ new Date()) {
+  return Date.parse(option.expires_at) <= now.getTime();
+}
+function checkoutDeliveries(baskets, picks) {
+  const missing = [];
+  const unavailable = [];
+  const deliveries = [];
+  for (const basket of baskets) {
+    if (basket.status !== "available" || basket.options.length === 0) {
+      unavailable.push(basket.store_id);
+      continue;
+    }
+    const quoteId = picks[basket.store_id];
+    if (!quoteId || !basket.options.some((option) => option.quote_id === quoteId)) {
+      missing.push(basket.store_id);
+      continue;
+    }
+    deliveries.push({ store_id: basket.store_id, quote_id: quoteId });
+  }
+  return missing.length === 0 && unavailable.length === 0 ? { ok: true, deliveries } : { ok: false, missing, unavailable };
+}
+
 // src/index.ts
 export * from "@mitumbadotafrica/logistics-contract";
 export {
@@ -184,5 +279,11 @@ export {
   HttpClient,
   LogisticsError,
   MitumbaLogistics,
-  pollParcel
+  checkoutDeliveries,
+  etaLabel,
+  isQuoteExpired,
+  methodChoices,
+  methodLabel,
+  pollParcel,
+  unavailableLabel
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mitumbadotafrica/logistics",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Asset-light carrier-orchestration SDK — carrier-neutral headless client for Kenyan couriers. Zero UI, zero carrier knowledge.",
   "license": "MIT",
   "repository": {
@@ -49,7 +49,7 @@
     "clean": "rimraf dist .turbo"
   },
   "dependencies": {
-    "@mitumbadotafrica/logistics-contract": "0.1.0"
+    "@mitumbadotafrica/logistics-contract": "0.2.0"
   },
   "devDependencies": {
     "rimraf": "^6.0.1",