@aglyn/plugins-commerce 1.0.0-beta.231 → 1.0.0-beta.233

package/src/lib/model/buyer-notifications.js

@@ -16,8 +16,10 @@
  */ /**
  * What a store tells its buyer, and when (AGL-3610).
  *
- * Five moments in an order's life each send the buyer one message: the
- * receipt, each shipment, delivery, each refund and a cancellation. A store
+ * Each moment in an order's life sends the buyer one message: the receipt,
+ * each shipment, delivery, each refund and a cancellation — and, for an
+ * order collected or brought by the store (AGL-3624), ready for pickup,
+ * picked up and out for delivery. A store
  * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`
  * — and ONLY off: every moment is ON unless an explicit `false` is stored,
  * because transaction messages are on by default for every store, existing
@@ -33,14 +35,21 @@
     'shipped',
     'delivered',
     'refunded',
-    'cancelled'
+    'cancelled',
+    // Pickup and the store's own delivery (AGL-3624).
+    'ready_for_pickup',
+    'picked_up',
+    'out_for_delivery'
 ];
 /** The designable email each moment sends: keys in `tenant-emails.ts`. */ export const BUYER_NOTIFICATION_EMAIL_KEYS = {
     receipt: 'order-receipt',
     shipped: 'order-shipped',
     delivered: 'order-delivered',
     refunded: 'order-refunded',
-    cancelled: 'order-cancelled'
+    cancelled: 'order-cancelled',
+    ready_for_pickup: 'order-ready-for-pickup',
+    picked_up: 'order-picked-up',
+    out_for_delivery: 'order-out-for-delivery'
 };
 /** How the store settings card names each moment. */ export const BUYER_NOTIFICATION_LABELS = {
     receipt: {
@@ -62,6 +71,18 @@
     cancelled: {
         label: 'Order canceled',
         description: 'When you cancel an order.'
+    },
+    ready_for_pickup: {
+        label: 'Ready for pickup',
+        description: 'When you mark a pickup order ready, with where to collect it and the pickup hours.'
+    },
+    picked_up: {
+        label: 'Order picked up',
+        description: 'When a pickup order is collected.'
+    },
+    out_for_delivery: {
+        label: 'Out for delivery',
+        description: 'When your own driver sets out with a local delivery order.'
     }
 };
 /** Whether a moment (or the `texts` channel) is on. Only `false` is off. */ export function buyerNotificationEnabled(settings, key) {

package/src/lib/model/buyer-notifications.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/buyer-notifications.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * What a store tells its buyer, and when (AGL-3610).\n *\n * Five moments in an order's life each send the buyer one message: the\n * receipt, each shipment, delivery, each refund and a cancellation. A store\n * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`\n * — and ONLY off: every moment is ON unless an explicit `false` is stored,\n * because transaction messages are on by default for every store, existing\n * and new (the 2026-10-06 decision AGL-3600 implemented for the owner's own\n * notices). An absent map, an absent key and a malformed value all read as\n * on, so a schema slip can never silence a store's receipts.\n *\n * `texts` is the channel switch rather than a moment: when the platform can\n * send texts and the order carries the buyer's phone number, each moment that\n * is on also goes by text unless the store turned texts off.\n */\nexport const BUYER_NOTIFICATION_EVENTS = [\n  'receipt',\n  'shipped',\n  'delivered',\n  'refunded',\n  'cancelled',\n] as const\n\nexport type BuyerNotificationEvent = (typeof BUYER_NOTIFICATION_EVENTS)[number]\n\nexport type BuyerNotificationChannel = 'email' | 'sms'\n\nexport type BuyerNotificationSettings = Partial<\n  Record<BuyerNotificationEvent | 'texts', boolean>\n>\n\n/** The designable email each moment sends: keys in `tenant-emails.ts`. */\nexport const BUYER_NOTIFICATION_EMAIL_KEYS: Readonly<\n  Record<BuyerNotificationEvent, string>\n> = {\n  receipt: 'order-receipt',\n  shipped: 'order-shipped',\n  delivered: 'order-delivered',\n  refunded: 'order-refunded',\n  cancelled: 'order-cancelled',\n}\n\n/** How the store settings card names each moment. */\nexport const BUYER_NOTIFICATION_LABELS: Readonly<\n  Record<BuyerNotificationEvent, { label: string; description: string }>\n> = {\n  receipt: {\n    label: 'Order receipt',\n    description:\n      'When an order is paid: online, from a payment link, or at the register when the customer gives an email.',\n  },\n  shipped: {\n    label: 'Order shipped',\n    description:\n      'Each time you ship part or all of an order, with the carrier and tracking link.',\n  },\n  delivered: {\n    label: 'Order delivered',\n    description: 'When you mark an order delivered.',\n  },\n  refunded: {\n    label: 'Refund issued',\n    description: 'Each refund, with the amount and any items you named.',\n  },\n  cancelled: {\n    label: 'Order canceled',\n    description: 'When you cancel an order.',\n  },\n}\n\n/** Whether a moment (or the `texts` channel) is on. Only `false` is off. */\nexport function buyerNotificationEnabled(\n  settings: unknown,\n  key: BuyerNotificationEvent | 'texts',\n): boolean {\n  if (!settings || typeof settings !== 'object') return true\n  return (settings as Record<string, unknown>)[key] !== false\n}\n\n/**\n * The idempotency key for one message: which moment, which occurrence of it\n * (a shipment id, a refund id; `order` for the once-per-order moments) and\n * which channel. Stored as a field name under `buyerNotifications` on the\n * order, so it is restricted to characters a Firestore field path takes\n * without quoting.\n */\nexport function buyerNotificationMarker(\n  event: BuyerNotificationEvent,\n  occurrence: string,\n  channel: BuyerNotificationChannel,\n): string {\n  const safe = (value: string) =>\n    String(value || 'order')\n      .replace(/[^A-Za-z0-9_-]/g, '_')\n      .slice(0, 120)\n  return `${event}__${safe(occurrence)}__${channel}`\n}\n\n/**\n * Formats integer cents in the store's currency. Falls back to a plain dollar\n * figure for a currency code `Intl` does not know, rather than throwing on a\n * stored typo.\n */\nexport function formatOrderMoney(cents: number, currency = 'USD'): string {\n  const amount = (Number(cents) || 0) / 100\n  try {\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: String(currency || 'USD').toUpperCase(),\n    }).format(amount)\n  } catch {\n    return `$${amount.toFixed(2)}`\n  }\n}\n"],"names":["BUYER_NOTIFICATION_EVENTS","BUYER_NOTIFICATION_EMAIL_KEYS","receipt","shipped","delivered","refunded","cancelled","BUYER_NOTIFICATION_LABELS","label","description","buyerNotificationEnabled","settings","key","buyerNotificationMarker","event","occurrence","channel","safe","value","String","replace","slice","formatOrderMoney","cents","currency","amount","Number","Intl","NumberFormat","style","toUpperCase","format","toFixed"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMA,4BAA4B;IACvC;IACA;IACA;IACA;IACA;CACD,CAAS;AAUV,wEAAwE,GACxE,OAAO,MAAMC,gCAET;IACFC,SAAS;IACTC,SAAS;IACTC,WAAW;IACXC,UAAU;IACVC,WAAW;AACb,EAAC;AAED,mDAAmD,GACnD,OAAO,MAAMC,4BAET;IACFL,SAAS;QACPM,OAAO;QACPC,aACE;IACJ;IACAN,SAAS;QACPK,OAAO;QACPC,aACE;IACJ;IACAL,WAAW;QACTI,OAAO;QACPC,aAAa;IACf;IACAJ,UAAU;QACRG,OAAO;QACPC,aAAa;IACf;IACAH,WAAW;QACTE,OAAO;QACPC,aAAa;IACf;AACF,EAAC;AAED,0EAA0E,GAC1E,OAAO,SAASC,yBACdC,QAAiB,EACjBC,GAAqC;IAErC,IAAI,CAACD,YAAY,OAAOA,aAAa,UAAU,OAAO;IACtD,OAAO,AAACA,QAAoC,CAACC,IAAI,KAAK;AACxD;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,wBACdC,KAA6B,EAC7BC,UAAkB,EAClBC,OAAiC;IAEjC,MAAMC,OAAO,CAACC,QACZC,OAAOD,SAAS,SACbE,OAAO,CAAC,mBAAmB,KAC3BC,KAAK,CAAC,GAAG;IACd,OAAO,GAAGP,MAAM,EAAE,EAAEG,KAAKF,YAAY,EAAE,EAAEC,SAAS;AACpD;AAEA;;;;CAIC,GACD,OAAO,SAASM,iBAAiBC,KAAa,EAAEC,WAAW,KAAK;IAC9D,MAAMC,SAAS,AAACC,CAAAA,OAAOH,UAAU,CAAA,IAAK;IACtC,IAAI;QACF,OAAO,IAAII,KAAKC,YAAY,CAAC,SAAS;YACpCC,OAAO;YACPL,UAAUL,OAAOK,YAAY,OAAOM,WAAW;QACjD,GAAGC,MAAM,CAACN;IACZ,EAAE,eAAM;QACN,OAAO,CAAC,CAAC,EAAEA,OAAOO,OAAO,CAAC,IAAI;IAChC;AACF"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/buyer-notifications.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * What a store tells its buyer, and when (AGL-3610).\n *\n * Each moment in an order's life sends the buyer one message: the receipt,\n * each shipment, delivery, each refund and a cancellation — and, for an\n * order collected or brought by the store (AGL-3624), ready for pickup,\n * picked up and out for delivery. A store\n * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`\n * — and ONLY off: every moment is ON unless an explicit `false` is stored,\n * because transaction messages are on by default for every store, existing\n * and new (the 2026-10-06 decision AGL-3600 implemented for the owner's own\n * notices). An absent map, an absent key and a malformed value all read as\n * on, so a schema slip can never silence a store's receipts.\n *\n * `texts` is the channel switch rather than a moment: when the platform can\n * send texts and the order carries the buyer's phone number, each moment that\n * is on also goes by text unless the store turned texts off.\n */\nexport const BUYER_NOTIFICATION_EVENTS = [\n  'receipt',\n  'shipped',\n  'delivered',\n  'refunded',\n  'cancelled',\n  // Pickup and the store's own delivery (AGL-3624).\n  'ready_for_pickup',\n  'picked_up',\n  'out_for_delivery',\n] as const\n\nexport type BuyerNotificationEvent = (typeof BUYER_NOTIFICATION_EVENTS)[number]\n\nexport type BuyerNotificationChannel = 'email' | 'sms'\n\nexport type BuyerNotificationSettings = Partial<\n  Record<BuyerNotificationEvent | 'texts', boolean>\n>\n\n/** The designable email each moment sends: keys in `tenant-emails.ts`. */\nexport const BUYER_NOTIFICATION_EMAIL_KEYS: Readonly<\n  Record<BuyerNotificationEvent, string>\n> = {\n  receipt: 'order-receipt',\n  shipped: 'order-shipped',\n  delivered: 'order-delivered',\n  refunded: 'order-refunded',\n  cancelled: 'order-cancelled',\n  ready_for_pickup: 'order-ready-for-pickup',\n  picked_up: 'order-picked-up',\n  out_for_delivery: 'order-out-for-delivery',\n}\n\n/** How the store settings card names each moment. */\nexport const BUYER_NOTIFICATION_LABELS: Readonly<\n  Record<BuyerNotificationEvent, { label: string; description: string }>\n> = {\n  receipt: {\n    label: 'Order receipt',\n    description:\n      'When an order is paid: online, from a payment link, or at the register when the customer gives an email.',\n  },\n  shipped: {\n    label: 'Order shipped',\n    description:\n      'Each time you ship part or all of an order, with the carrier and tracking link.',\n  },\n  delivered: {\n    label: 'Order delivered',\n    description: 'When you mark an order delivered.',\n  },\n  refunded: {\n    label: 'Refund issued',\n    description: 'Each refund, with the amount and any items you named.',\n  },\n  cancelled: {\n    label: 'Order canceled',\n    description: 'When you cancel an order.',\n  },\n  ready_for_pickup: {\n    label: 'Ready for pickup',\n    description: 'When you mark a pickup order ready, with where to collect it and the pickup hours.',\n  },\n  picked_up: {\n    label: 'Order picked up',\n    description: 'When a pickup order is collected.',\n  },\n  out_for_delivery: {\n    label: 'Out for delivery',\n    description: 'When your own driver sets out with a local delivery order.',\n  },\n}\n\n/** Whether a moment (or the `texts` channel) is on. Only `false` is off. */\nexport function buyerNotificationEnabled(\n  settings: unknown,\n  key: BuyerNotificationEvent | 'texts',\n): boolean {\n  if (!settings || typeof settings !== 'object') return true\n  return (settings as Record<string, unknown>)[key] !== false\n}\n\n/**\n * The idempotency key for one message: which moment, which occurrence of it\n * (a shipment id, a refund id; `order` for the once-per-order moments) and\n * which channel. Stored as a field name under `buyerNotifications` on the\n * order, so it is restricted to characters a Firestore field path takes\n * without quoting.\n */\nexport function buyerNotificationMarker(\n  event: BuyerNotificationEvent,\n  occurrence: string,\n  channel: BuyerNotificationChannel,\n): string {\n  const safe = (value: string) =>\n    String(value || 'order')\n      .replace(/[^A-Za-z0-9_-]/g, '_')\n      .slice(0, 120)\n  return `${event}__${safe(occurrence)}__${channel}`\n}\n\n/**\n * Formats integer cents in the store's currency. Falls back to a plain dollar\n * figure for a currency code `Intl` does not know, rather than throwing on a\n * stored typo.\n */\nexport function formatOrderMoney(cents: number, currency = 'USD'): string {\n  const amount = (Number(cents) || 0) / 100\n  try {\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: String(currency || 'USD').toUpperCase(),\n    }).format(amount)\n  } catch {\n    return `$${amount.toFixed(2)}`\n  }\n}\n"],"names":["BUYER_NOTIFICATION_EVENTS","BUYER_NOTIFICATION_EMAIL_KEYS","receipt","shipped","delivered","refunded","cancelled","ready_for_pickup","picked_up","out_for_delivery","BUYER_NOTIFICATION_LABELS","label","description","buyerNotificationEnabled","settings","key","buyerNotificationMarker","event","occurrence","channel","safe","value","String","replace","slice","formatOrderMoney","cents","currency","amount","Number","Intl","NumberFormat","style","toUpperCase","format","toFixed"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,MAAMA,4BAA4B;IACvC;IACA;IACA;IACA;IACA;IACA,kDAAkD;IAClD;IACA;IACA;CACD,CAAS;AAUV,wEAAwE,GACxE,OAAO,MAAMC,gCAET;IACFC,SAAS;IACTC,SAAS;IACTC,WAAW;IACXC,UAAU;IACVC,WAAW;IACXC,kBAAkB;IAClBC,WAAW;IACXC,kBAAkB;AACpB,EAAC;AAED,mDAAmD,GACnD,OAAO,MAAMC,4BAET;IACFR,SAAS;QACPS,OAAO;QACPC,aACE;IACJ;IACAT,SAAS;QACPQ,OAAO;QACPC,aACE;IACJ;IACAR,WAAW;QACTO,OAAO;QACPC,aAAa;IACf;IACAP,UAAU;QACRM,OAAO;QACPC,aAAa;IACf;IACAN,WAAW;QACTK,OAAO;QACPC,aAAa;IACf;IACAL,kBAAkB;QAChBI,OAAO;QACPC,aAAa;IACf;IACAJ,WAAW;QACTG,OAAO;QACPC,aAAa;IACf;IACAH,kBAAkB;QAChBE,OAAO;QACPC,aAAa;IACf;AACF,EAAC;AAED,0EAA0E,GAC1E,OAAO,SAASC,yBACdC,QAAiB,EACjBC,GAAqC;IAErC,IAAI,CAACD,YAAY,OAAOA,aAAa,UAAU,OAAO;IACtD,OAAO,AAACA,QAAoC,CAACC,IAAI,KAAK;AACxD;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,wBACdC,KAA6B,EAC7BC,UAAkB,EAClBC,OAAiC;IAEjC,MAAMC,OAAO,CAACC,QACZC,OAAOD,SAAS,SACbE,OAAO,CAAC,mBAAmB,KAC3BC,KAAK,CAAC,GAAG;IACd,OAAO,GAAGP,MAAM,EAAE,EAAEG,KAAKF,YAAY,EAAE,EAAEC,SAAS;AACpD;AAEA;;;;CAIC,GACD,OAAO,SAASM,iBAAiBC,KAAa,EAAEC,WAAW,KAAK;IAC9D,MAAMC,SAAS,AAACC,CAAAA,OAAOH,UAAU,CAAA,IAAK;IACtC,IAAI;QACF,OAAO,IAAII,KAAKC,YAAY,CAAC,SAAS;YACpCC,OAAO;YACPL,UAAUL,OAAOK,YAAY,OAAOM,WAAW;QACjD,GAAGC,MAAM,CAACN;IACZ,EAAE,eAAM;QACN,OAAO,CAAC,CAAC,EAAEA,OAAOO,OAAO,CAAC,IAAI;IAChC;AACF"}

package/src/lib/model/commerce-orders.d.ts

@@ -27,6 +27,8 @@ import type { PaymentRisk } from '@aglyn/aglyn/app-utils/payment-risk';
 import type { ProductType } from './commerce';
 import type { StorefrontTaxMode } from './commerce-tax-decision';
 import type { OrderPayment } from './commerce-pos';
+import type { PosOfflineOrderStamp } from './commerce-pos-offline';
+import type { OrderFulfillmentMethod, OrderLocalDelivery, OrderPickup } from './order-local-fulfillment';
 export type OrderStatus = 'pending' | 'paid' | 'partially_fulfilled' | 'fulfilled' | 'delivered' | 'cancelled' | 'refunded';
 /**
  * Where the sale came through. `subscription` is a recurring cycle of a
@@ -37,7 +39,48 @@ export type OrderStatus = 'pending' | 'paid' | 'partially_fulfilled' | 'fulfille
  * there is nothing to ship, and AGL-1732's "a subscription is not an order"
  * stands for them.
  */
-export type OrderChannel = 'online' | 'pos' | 'draft' | 'subscription';
+export type OrderChannel = 'online' | 'pos' | 'draft' | 'subscription' | 'marketplace';
+/**
+ * Where an order sold on an outside channel came from (AGL-3638): a
+ * marketplace that took the buyer's money and pays the merchant out. Written
+ * once, by the import that recorded the order (`server/channel-orders.ts`).
+ */
+export interface OrderChannelSource {
+    /** The importer's id for the channel, e.g. `ebay`. */
+    channelId: string;
+    /** What the merchant calls it, e.g. `eBay`. */
+    channelLabel: string;
+    /** The channel's own order id, the import's idempotency key. */
+    externalOrderId: string;
+    /** What the merchant sees on the channel. */
+    externalRef: string;
+    /** Which order line each of the channel's lines became, for a shipment sent back to it. */
+    lines: Array<{
+        lineIndex: number;
+        externalLineId: string;
+    }>;
+    /** ISO 4217, upper case: the currency every amount on the order is in. */
+    currency: string;
+    /** The channel collected this order's tax and remits it, as the marketplace facilitator. */
+    taxRemittedByChannel: true;
+    /**
+     * What the channel charged the merchant for the sale, RECORDED for the
+     * merchant's books and never charged by Aglyn; `null` until the channel
+     * says.
+     */
+    fees: Array<{
+        label: string;
+        amountCents: number;
+    }> | null;
+    feesTotalCents: number | null;
+    /**
+     * How the goods leave (AGL-3644): `courier`, handed to the channel's own
+     * courier (a delivery app); absent reads as `ship`.
+     */
+    handoff?: 'ship' | 'courier';
+    /** The channel's ids of the refunds and adjustments recorded on the order, so each is recorded once (AGL-3644). */
+    refundIds?: string[];
+}
 /** Snapshot of what was bought — self-contained for history. */
 export interface OrderLineItem {
     productId: string;
@@ -148,6 +191,12 @@ export interface OrderFulfillment {
     updatedAtMs?: number;
     /** Whether the buyer was to be told about this shipment. */
     notify?: boolean;
+    /**
+     * Handed over rather than shipped (AGL-3624): collected at a pickup
+     * location or brought by the store's own driver. No carrier, no tracking,
+     * and no "your order has shipped" message.
+     */
+    handover?: 'pickup' | 'local_delivery';
     atMs: number;
 }
 /**
@@ -306,13 +355,38 @@ export interface OrderUnresolvedLine {
     quantity: number;
 }
 /** `hosts/{hostId}/orders/{id}` doc. */
+/**
+ * Store credit another plugin kept that came off an online sale (AGL-3640),
+ * as core's checkout-credits seam records it (`PluginCheckoutCreditSold`),
+ * restated here so the order model stays pure for the native apps.
+ */
+export interface OrderCredit {
+    /** `{pluginId}.{key}`. */
+    providerId: string;
+    pluginId: string;
+    key: string;
+    /** The provider's own handle on the account; never a code. */
+    reference: string;
+    label: string;
+    last4: string;
+    amountCents: number;
+    appliedAs: 'discount' | 'tender';
+}
 export interface HostOrder {
     /** Human order number, sequential per host (e.g. #1042). */
     number?: number;
     /** Optional lines the buyer added at checkout (AGL-3635); see {@link OrderExtra}. */
     extras?: OrderExtra[];
+    /**
+     * Store credit another plugin kept that came off an ONLINE sale (AGL-3640),
+     * as its provider recorded it. A register sale's credit is one of its
+     * `payments` instead.
+     */
+    credits?: OrderCredit[];
     status: OrderStatus;
     channel?: OrderChannel;
+    /** The outside channel an order with channel `marketplace` was sold on (AGL-3638). */
+    channelSource?: OrderChannelSource;
     /**
      * Which location's stock this sale came off, for the multi-location counts
      * of AGL-286. Written by the POS register, the only sale path that decrements
@@ -323,6 +397,16 @@ export interface HostOrder {
      * erases the restock.
      */
     locationId?: string;
+    /**
+     * How the buyer chose to receive the order (AGL-3624). Absent reads as
+     * shipped, which every order before pickup and local delivery was. Also
+     * stamps `locationId` above when the stock came off that location.
+     */
+    fulfillmentMethod?: OrderFulfillmentMethod;
+    /** The pickup the buyer chose (AGL-3624), with `fulfillmentMethod` `pickup`. */
+    pickup?: OrderPickup;
+    /** The store's own delivery the buyer chose (AGL-3624), with `fulfillmentMethod` `local_delivery`. */
+    localDelivery?: OrderLocalDelivery;
     /**
      * The register a POS sale was rung on, and the console user who rang it
      * (AGL-472, AGL-3607).
@@ -354,6 +438,18 @@ export interface HostOrder {
         to?: string;
         atMs: number;
     };
+    /**
+     * A register sale a customer built at a self-service kiosk (AGL-3623), and
+     * the kiosk (its device token's hash prefix).
+     */
+    posSource?: 'kiosk';
+    kioskDeviceId?: string;
+    /**
+     * Set while a kiosk order waits in its register's queue for a cashier to
+     * take payment ("Pay at counter"), and when it joined.
+     */
+    kioskQueueRegisterId?: string;
+    kioskQueuedAtMs?: number;
     /**
      * The register discount that was applied, and the member who applied it
      * (AGL-2161). Present only on a POS order that carries a discount.
@@ -421,6 +517,12 @@ export interface HostOrder {
     shippingAddress?: OrderAddress;
     billingAddress?: OrderAddress;
     timeline?: OrderTimelineEvent[];
+    /**
+     * A register sale rung while offline (AGL-3625): when it was rung, when it
+     * synced, and what did not match — stock that went short, a price that
+     * changed. Absent on every other order.
+     */
+    offline?: PosOfflineOrderStamp;
     fulfillments?: OrderFulfillment[];
     note?: string;
     couponCode?: string;

package/src/lib/model/commerce-orders.js

@@ -852,7 +852,8 @@ export function computeCheckoutSessionTotals(lineItems, session, parts) {
     online: 'Online',
     pos: 'POS',
     draft: 'Draft',
-    subscription: 'Subscription'
+    subscription: 'Subscription',
+    marketplace: 'Marketplace'
 };
 /** Human label for a channel, tolerating a legacy/unknown value. */ export function orderChannelLabel(channel) {
     var _ref, _ORDER_CHANNEL_LABELS_;