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

package/src/lib/model/order-status-view.js

@@ -13,8 +13,10 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ import { fulfillmentIsActive, fulfillmentLineQuantities } from "./order-fulfillment.js";
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { fulfillmentIsActive, fulfillmentLineQuantities } from "./order-fulfillment.js";
 import { carrierLabelFor, fulfillmentTrackingUrl } from "./tracking-url.js";
+import { ORDER_LOCAL_DELIVERY_STATUS_LABELS, ORDER_PICKUP_STATUS_LABELS, orderLocalDeliveryStatus, orderPickupStatus } from "./order-local-fulfillment.js";
 const STATUS_LABELS = {
     pending: 'Awaiting payment',
     paid: 'Confirmed',
@@ -33,13 +35,22 @@ function eventAt(order, ...events) {
     return found ? Number(found.atMs) || null : null;
 }
 /** Builds the public projection. Pure; the caller has verified the link. */ export function buildOrderStatusView(input) {
-    var _order_lineItems, _order_fulfillments, _order_refundedLineItemIds, _ref, _order_amountCents, _eventAt, _ref1, _STATUS_LABELS_status, _ref2, _ref3, _ref4, _ref5, _order_refundedCents, _order_extras, _input_actions;
+    var _order_lineItems, _order_fulfillments, _order_refundedLineItemIds, _ref, _order_amountCents, _eventAt, _ref1, _STATUS_LABELS_status, _ref2, _ref3, _ref4, _ref5, _order_refundedCents, _order_extras, _input_actions, _pickup_locationName, _pickup_address, _pickup_hours, _pickup_instructions, _delivery_windowLabel;
     var _shipments_;
     const { order } = input;
     const lineItems = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
     const active = ((_order_fulfillments = order.fulfillments) != null ? _order_fulfillments : []).filter(fulfillmentIsActive);
+    // A handover is not a parcel (AGL-3624): it has no carrier or tracking,
+    // and the pickup or delivery block below says what happened.
+    const parcels = active.filter((fulfillment)=>!fulfillment.handover);
     const shippedByLine = new Map();
-    const shipments = active.map((fulfillment)=>{
+    for (const fulfillment of active.filter((entry)=>entry.handover)){
+        for (const entry of fulfillmentLineQuantities(order, fulfillment)){
+            var _shippedByLine_get;
+            shippedByLine.set(entry.lineItemId, ((_shippedByLine_get = shippedByLine.get(entry.lineItemId)) != null ? _shippedByLine_get : 0) + entry.quantity);
+        }
+    }
+    const shipments = parcels.map((fulfillment)=>{
         var _fulfillment_id, _fulfillment_trackingNumber;
         const quantities = fulfillmentLineQuantities(order, fulfillment);
         for (const entry of quantities){
@@ -95,6 +106,8 @@ function eventAt(order, ...events) {
             done: status !== 'pending' && paidAtMs !== null
         }
     ];
+    const pickup = order.fulfillmentMethod === 'pickup' ? order.pickup : undefined;
+    const delivery = order.fulfillmentMethod === 'local_delivery' ? order.localDelivery : undefined;
     if (status === 'cancelled') {
         steps.push({
             key: 'cancelled',
@@ -102,6 +115,32 @@ function eventAt(order, ...events) {
             atMs: eventAt(order, 'cancelled'),
             done: true
         });
+    } else if (pickup) {
+        const pickupStatus = orderPickupStatus(pickup.status);
+        steps.push({
+            key: 'ready_for_pickup',
+            label: 'Ready for pickup',
+            atMs: Number(pickup.readyAtMs) || null,
+            done: pickupStatus !== 'preparing'
+        }, {
+            key: 'picked_up',
+            label: 'Picked up',
+            atMs: Number(pickup.pickedUpAtMs) || null,
+            done: pickupStatus === 'picked_up'
+        });
+    } else if (delivery) {
+        const deliveryStatus = orderLocalDeliveryStatus(delivery.status);
+        steps.push({
+            key: 'out_for_delivery',
+            label: 'Out for delivery',
+            atMs: Number(delivery.outForDeliveryAtMs) || null,
+            done: deliveryStatus === 'out_for_delivery' || deliveryStatus === 'delivered'
+        }, {
+            key: 'delivered',
+            label: 'Delivered',
+            atMs: Number(delivery.deliveredAtMs) || deliveredAt,
+            done: deliveryStatus === 'delivered' || status === 'delivered'
+        });
     } else {
         steps.push({
             key: 'shipped',
@@ -127,11 +166,11 @@ function eventAt(order, ...events) {
             done: true
         });
     }
-    return {
+    return _extends({
         storeName: input.storeName,
         number: input.number,
         status,
-        statusLabel: (_STATUS_LABELS_status = STATUS_LABELS[status]) != null ? _STATUS_LABELS_status : 'Confirmed',
+        statusLabel: pickup && status !== 'refunded' && status !== 'cancelled' ? ORDER_PICKUP_STATUS_LABELS[orderPickupStatus(pickup.status)] : delivery && status !== 'refunded' && status !== 'cancelled' ? ORDER_LOCAL_DELIVERY_STATUS_LABELS[orderLocalDeliveryStatus(delivery.status)] : (_STATUS_LABELS_status = STATUS_LABELS[status]) != null ? _STATUS_LABELS_status : 'Confirmed',
         createdAtMs,
         currency: input.currency || 'USD',
         lines,
@@ -150,7 +189,22 @@ function eventAt(order, ...events) {
         shipments,
         steps,
         actions: (_input_actions = input.actions) != null ? _input_actions : []
-    };
+    }, pickup ? {
+        pickup: {
+            locationName: String((_pickup_locationName = pickup.locationName) != null ? _pickup_locationName : ''),
+            address: (_pickup_address = pickup.address) != null ? _pickup_address : null,
+            hours: (_pickup_hours = pickup.hours) != null ? _pickup_hours : null,
+            instructions: (_pickup_instructions = pickup.instructions) != null ? _pickup_instructions : null,
+            status: orderPickupStatus(pickup.status),
+            statusLabel: ORDER_PICKUP_STATUS_LABELS[orderPickupStatus(pickup.status)]
+        }
+    } : {}, delivery ? {
+        localDelivery: {
+            windowLabel: (_delivery_windowLabel = delivery.windowLabel) != null ? _delivery_windowLabel : null,
+            status: orderLocalDeliveryStatus(delivery.status),
+            statusLabel: ORDER_LOCAL_DELIVERY_STATUS_LABELS[orderLocalDeliveryStatus(delivery.status)]
+        }
+    } : {});
 }
 
 //# sourceMappingURL=order-status-view.js.map

package/src/lib/model/order-status-view.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-status-view.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\nimport type { HostOrder, OrderStatus } from './commerce-orders'\nimport { fulfillmentIsActive, fulfillmentLineQuantities } from './order-fulfillment'\nimport { carrierLabelFor, fulfillmentTrackingUrl } from './tracking-url'\n\n/**\n * What the guest order-status page shows (AGL-3610): the ONE projection of an\n * order that leaves the server for a visitor holding a signed link.\n *\n * Allow-listed, never spread: an order document carries the buyer's email,\n * phone and addresses, Stripe ids, risk signals and the merchant's notes, and\n * a forwarded link must disclose no more than the email it arrived in. Every\n * field below is one the buyer's own receipt or shipping email already\n * states. New fields are added here deliberately, or not at all.\n */\nexport interface OrderStatusLine {\n  name: string\n  variantLabel: string | null\n  quantity: number\n  amountCents: number\n  /** Units of this line in an active shipment. */\n  shippedQuantity: number\n  refunded: boolean\n}\n\nexport interface OrderStatusShipment {\n  id: string\n  atMs: number\n  carrier: string | null\n  trackingNumber: string | null\n  trackingUrl: string | null\n  lines: Array<{ name: string; quantity: number }>\n}\n\nexport interface OrderStatusStep {\n  key: 'placed' | 'paid' | 'shipped' | 'delivered' | 'cancelled' | 'refunded'\n  label: string\n  atMs: number | null\n  done: boolean\n}\n\n/**\n * Something the buyer can do from the page — \"Request a return\" is the case\n * the order-processing lane (AGL-3611) adds through\n * `registerOrderStatusActions` on the server. The page renders each as a\n * button to `url`; it knows nothing of what the action is.\n */\nexport interface OrderStatusAction {\n  id: string\n  label: string\n  url: string\n}\n\nexport interface OrderStatusView {\n  storeName: string\n  number: string\n  status: OrderStatus\n  /** The status as a buyer reads it. */\n  statusLabel: string\n  createdAtMs: number | null\n  currency: string\n  lines: OrderStatusLine[]\n  totals: {\n    itemsCents: number\n    shippingCents: number\n    taxCents: number\n    discountCents: number\n    totalCents: number\n    refundedCents: number\n  }\n  /**\n   * Optional lines the buyer took at checkout (AGL-3635) — \"Package\n   * protection\" — by the name and price their receipt states. Optional so\n   * an answer from before this field reads as none.\n   */\n  extras?: Array<{ label: string; amountCents: number }>\n  shipments: OrderStatusShipment[]\n  steps: OrderStatusStep[]\n  actions: OrderStatusAction[]\n}\n\nconst STATUS_LABELS: Record<OrderStatus, string> = {\n  pending: 'Awaiting payment',\n  paid: 'Confirmed',\n  partially_fulfilled: 'Partly shipped',\n  fulfilled: 'Shipped',\n  delivered: 'Delivered',\n  cancelled: 'Canceled',\n  refunded: 'Refunded',\n}\n\nfunction eventAt(order: HostOrder, ...events: string[]): number | null {\n  const found = (order.timeline ?? []).find((entry) =>\n    events.includes(String(entry?.event ?? '')),\n  )\n  return found ? Number(found.atMs) || null : null\n}\n\n/** Builds the public projection. Pure; the caller has verified the link. */\nexport function buildOrderStatusView(input: {\n  order: HostOrder\n  orderId: string\n  storeName: string\n  currency?: string\n  number: string\n  actions?: OrderStatusAction[]\n}): OrderStatusView {\n  const { order } = input\n  const lineItems = order.lineItems ?? []\n  const active = (order.fulfillments ?? []).filter(fulfillmentIsActive)\n  const shippedByLine = new Map<number, number>()\n  const shipments: OrderStatusShipment[] = active\n    .map((fulfillment) => {\n      const quantities = fulfillmentLineQuantities(order, fulfillment)\n      for (const entry of quantities) {\n        shippedByLine.set(\n          entry.lineItemId,\n          (shippedByLine.get(entry.lineItemId) ?? 0) + entry.quantity,\n        )\n      }\n      return {\n        id: String(fulfillment.id ?? ''),\n        atMs: Number(fulfillment.atMs) || 0,\n        carrier: fulfillment.carrier ? carrierLabelFor(fulfillment.carrier) : null,\n        trackingNumber: fulfillment.trackingNumber ?? null,\n        trackingUrl: fulfillmentTrackingUrl(fulfillment),\n        lines: quantities.map((entry) => ({\n          name: String(lineItems[entry.lineItemId]?.name ?? 'Item'),\n          quantity: entry.quantity,\n        })),\n      }\n    })\n    .sort((a, b) => a.atMs - b.atMs)\n  const refundedLines = new Set(order.refundedLineItemIds ?? [])\n  const lines: OrderStatusLine[] = lineItems.map((line, index) => ({\n    name: String(line.name ?? 'Item'),\n    variantLabel: line.variantLabel ?? null,\n    quantity: Number(line.quantity) || 0,\n    amountCents: (Number(line.unitAmountCents) || 0) * (Number(line.quantity) || 0),\n    shippedQuantity: Math.min(Number(line.quantity) || 0, shippedByLine.get(index) ?? 0),\n    refunded: refundedLines.has(index),\n  }))\n  const totals = order.totals\n  const totalCents = totals?.totalCents ?? Number(order.amountCents ?? 0)\n  const status = order.status\n  const createdAtMs = Number(order.createdAtMs) || null\n  const paidAtMs = eventAt(order, 'paid') ?? (status !== 'pending' ? createdAtMs : null)\n  const firstShipAt = shipments[0]?.atMs ?? eventAt(order, 'fulfilled', 'partially_fulfilled')\n  const deliveredAt = eventAt(order, 'delivered')\n  const steps: OrderStatusStep[] = [\n    { key: 'placed', label: 'Order placed', atMs: createdAtMs, done: true },\n    {\n      key: 'paid',\n      label: 'Payment confirmed',\n      atMs: paidAtMs,\n      done: status !== 'pending' && paidAtMs !== null,\n    },\n  ]\n  if (status === 'cancelled') {\n    steps.push({ key: 'cancelled', label: 'Canceled', atMs: eventAt(order, 'cancelled'), done: true })\n  } else {\n    steps.push(\n      {\n        key: 'shipped',\n        label: status === 'partially_fulfilled' ? 'Partly shipped' : 'Shipped',\n        atMs: firstShipAt,\n        done: ['partially_fulfilled', 'fulfilled', 'delivered'].includes(status) ||\n          shipments.length > 0,\n      },\n      {\n        key: 'delivered',\n        label: 'Delivered',\n        atMs: deliveredAt,\n        done: status === 'delivered' || deliveredAt !== null,\n      },\n    )\n  }\n  if (status === 'refunded') {\n    steps.push({ key: 'refunded', label: 'Refunded', atMs: eventAt(order, 'refund'), done: true })\n  }\n  return {\n    storeName: input.storeName,\n    number: input.number,\n    status,\n    statusLabel: STATUS_LABELS[status] ?? 'Confirmed',\n    createdAtMs,\n    currency: input.currency || 'USD',\n    lines,\n    totals: {\n      itemsCents: totals?.itemsCents ?? lines.reduce((sum, line) => sum + line.amountCents, 0),\n      shippingCents: totals?.shippingCents ?? 0,\n      taxCents: totals?.taxCents ?? 0,\n      discountCents: totals?.discountCents ?? 0,\n      totalCents,\n      refundedCents: Number(order.refundedCents ?? 0) || 0,\n    },\n    extras: (order.extras ?? [])\n      .filter((extra) => extra && Number(extra.amountCents) > 0)\n      .map((extra) => ({ label: String(extra.label || 'Extra'), amountCents: Number(extra.amountCents) })),\n    shipments,\n    steps,\n    actions: input.actions ?? [],\n  }\n}\n"],"names":["fulfillmentIsActive","fulfillmentLineQuantities","carrierLabelFor","fulfillmentTrackingUrl","STATUS_LABELS","pending","paid","partially_fulfilled","fulfilled","delivered","cancelled","refunded","eventAt","order","events","found","timeline","find","entry","includes","String","event","Number","atMs","buildOrderStatusView","input","shipments","lineItems","active","fulfillments","filter","shippedByLine","Map","map","fulfillment","quantities","set","lineItemId","get","quantity","id","carrier","trackingNumber","trackingUrl","lines","name","sort","a","b","refundedLines","Set","refundedLineItemIds","line","index","variantLabel","amountCents","unitAmountCents","shippedQuantity","Math","min","has","totals","totalCents","status","createdAtMs","paidAtMs","firstShipAt","deliveredAt","steps","key","label","done","push","length","storeName","number","statusLabel","currency","itemsCents","reduce","sum","shippingCents","taxCents","discountCents","refundedCents","extras","extra","actions"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-status-view.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\nimport type { HostOrder, OrderStatus } from './commerce-orders'\nimport { fulfillmentIsActive, fulfillmentLineQuantities } from './order-fulfillment'\nimport { carrierLabelFor, fulfillmentTrackingUrl } from './tracking-url'\nimport {\n  ORDER_LOCAL_DELIVERY_STATUS_LABELS,\n  ORDER_PICKUP_STATUS_LABELS,\n  orderLocalDeliveryStatus,\n  orderPickupStatus,\n  type OrderLocalDeliveryStatus,\n  type OrderPickupStatus,\n} from './order-local-fulfillment'\n\n/**\n * What the guest order-status page shows (AGL-3610): the ONE projection of an\n * order that leaves the server for a visitor holding a signed link.\n *\n * Allow-listed, never spread: an order document carries the buyer's email,\n * phone and addresses, Stripe ids, risk signals and the merchant's notes, and\n * a forwarded link must disclose no more than the email it arrived in. Every\n * field below is one the buyer's own receipt or shipping email already\n * states. New fields are added here deliberately, or not at all.\n */\nexport interface OrderStatusLine {\n  name: string\n  variantLabel: string | null\n  quantity: number\n  amountCents: number\n  /** Units of this line in an active shipment. */\n  shippedQuantity: number\n  refunded: boolean\n}\n\nexport interface OrderStatusShipment {\n  id: string\n  atMs: number\n  carrier: string | null\n  trackingNumber: string | null\n  trackingUrl: string | null\n  lines: Array<{ name: string; quantity: number }>\n}\n\nexport interface OrderStatusStep {\n  key:\n    | 'placed'\n    | 'paid'\n    | 'shipped'\n    | 'delivered'\n    | 'cancelled'\n    | 'refunded'\n    // Pickup and the store's own delivery (AGL-3624).\n    | 'ready_for_pickup'\n    | 'picked_up'\n    | 'out_for_delivery'\n  label: string\n  atMs: number | null\n  done: boolean\n}\n\n/**\n * Something the buyer can do from the page — \"Request a return\" is the case\n * the order-processing lane (AGL-3611) adds through\n * `registerOrderStatusActions` on the server. The page renders each as a\n * button to `url`; it knows nothing of what the action is.\n */\nexport interface OrderStatusAction {\n  id: string\n  label: string\n  url: string\n}\n\nexport interface OrderStatusView {\n  storeName: string\n  number: string\n  status: OrderStatus\n  /** The status as a buyer reads it. */\n  statusLabel: string\n  createdAtMs: number | null\n  currency: string\n  lines: OrderStatusLine[]\n  totals: {\n    itemsCents: number\n    shippingCents: number\n    taxCents: number\n    discountCents: number\n    totalCents: number\n    refundedCents: number\n  }\n  /**\n   * Optional lines the buyer took at checkout (AGL-3635) — \"Package\n   * protection\" — by the name and price their receipt states. Optional so\n   * an answer from before this field reads as none.\n   */\n  extras?: Array<{ label: string; amountCents: number }>\n  shipments: OrderStatusShipment[]\n  steps: OrderStatusStep[]\n  actions: OrderStatusAction[]\n  /**\n   * Where to collect a pickup order (AGL-3624) — the location the buyer chose\n   * and its hours, as the ready-for-pickup email states them.\n   */\n  pickup?: {\n    locationName: string\n    address: string | null\n    hours: string | null\n    instructions: string | null\n    status: OrderPickupStatus\n    statusLabel: string\n  }\n  /** When the store's own driver brings it (AGL-3624). */\n  localDelivery?: {\n    windowLabel: string | null\n    status: OrderLocalDeliveryStatus\n    statusLabel: string\n  }\n}\n\nconst STATUS_LABELS: Record<OrderStatus, string> = {\n  pending: 'Awaiting payment',\n  paid: 'Confirmed',\n  partially_fulfilled: 'Partly shipped',\n  fulfilled: 'Shipped',\n  delivered: 'Delivered',\n  cancelled: 'Canceled',\n  refunded: 'Refunded',\n}\n\nfunction eventAt(order: HostOrder, ...events: string[]): number | null {\n  const found = (order.timeline ?? []).find((entry) =>\n    events.includes(String(entry?.event ?? '')),\n  )\n  return found ? Number(found.atMs) || null : null\n}\n\n/** Builds the public projection. Pure; the caller has verified the link. */\nexport function buildOrderStatusView(input: {\n  order: HostOrder\n  orderId: string\n  storeName: string\n  currency?: string\n  number: string\n  actions?: OrderStatusAction[]\n}): OrderStatusView {\n  const { order } = input\n  const lineItems = order.lineItems ?? []\n  const active = (order.fulfillments ?? []).filter(fulfillmentIsActive)\n  // A handover is not a parcel (AGL-3624): it has no carrier or tracking,\n  // and the pickup or delivery block below says what happened.\n  const parcels = active.filter((fulfillment) => !fulfillment.handover)\n  const shippedByLine = new Map<number, number>()\n  for (const fulfillment of active.filter((entry) => entry.handover)) {\n    for (const entry of fulfillmentLineQuantities(order, fulfillment)) {\n      shippedByLine.set(entry.lineItemId, (shippedByLine.get(entry.lineItemId) ?? 0) + entry.quantity)\n    }\n  }\n  const shipments: OrderStatusShipment[] = parcels\n    .map((fulfillment) => {\n      const quantities = fulfillmentLineQuantities(order, fulfillment)\n      for (const entry of quantities) {\n        shippedByLine.set(\n          entry.lineItemId,\n          (shippedByLine.get(entry.lineItemId) ?? 0) + entry.quantity,\n        )\n      }\n      return {\n        id: String(fulfillment.id ?? ''),\n        atMs: Number(fulfillment.atMs) || 0,\n        carrier: fulfillment.carrier ? carrierLabelFor(fulfillment.carrier) : null,\n        trackingNumber: fulfillment.trackingNumber ?? null,\n        trackingUrl: fulfillmentTrackingUrl(fulfillment),\n        lines: quantities.map((entry) => ({\n          name: String(lineItems[entry.lineItemId]?.name ?? 'Item'),\n          quantity: entry.quantity,\n        })),\n      }\n    })\n    .sort((a, b) => a.atMs - b.atMs)\n  const refundedLines = new Set(order.refundedLineItemIds ?? [])\n  const lines: OrderStatusLine[] = lineItems.map((line, index) => ({\n    name: String(line.name ?? 'Item'),\n    variantLabel: line.variantLabel ?? null,\n    quantity: Number(line.quantity) || 0,\n    amountCents: (Number(line.unitAmountCents) || 0) * (Number(line.quantity) || 0),\n    shippedQuantity: Math.min(Number(line.quantity) || 0, shippedByLine.get(index) ?? 0),\n    refunded: refundedLines.has(index),\n  }))\n  const totals = order.totals\n  const totalCents = totals?.totalCents ?? Number(order.amountCents ?? 0)\n  const status = order.status\n  const createdAtMs = Number(order.createdAtMs) || null\n  const paidAtMs = eventAt(order, 'paid') ?? (status !== 'pending' ? createdAtMs : null)\n  const firstShipAt = shipments[0]?.atMs ?? eventAt(order, 'fulfilled', 'partially_fulfilled')\n  const deliveredAt = eventAt(order, 'delivered')\n  const steps: OrderStatusStep[] = [\n    { key: 'placed', label: 'Order placed', atMs: createdAtMs, done: true },\n    {\n      key: 'paid',\n      label: 'Payment confirmed',\n      atMs: paidAtMs,\n      done: status !== 'pending' && paidAtMs !== null,\n    },\n  ]\n  const pickup = order.fulfillmentMethod === 'pickup' ? order.pickup : undefined\n  const delivery = order.fulfillmentMethod === 'local_delivery' ? order.localDelivery : undefined\n  if (status === 'cancelled') {\n    steps.push({ key: 'cancelled', label: 'Canceled', atMs: eventAt(order, 'cancelled'), done: true })\n  } else if (pickup) {\n    const pickupStatus = orderPickupStatus(pickup.status)\n    steps.push(\n      {\n        key: 'ready_for_pickup',\n        label: 'Ready for pickup',\n        atMs: Number(pickup.readyAtMs) || null,\n        done: pickupStatus !== 'preparing',\n      },\n      {\n        key: 'picked_up',\n        label: 'Picked up',\n        atMs: Number(pickup.pickedUpAtMs) || null,\n        done: pickupStatus === 'picked_up',\n      },\n    )\n  } else if (delivery) {\n    const deliveryStatus = orderLocalDeliveryStatus(delivery.status)\n    steps.push(\n      {\n        key: 'out_for_delivery',\n        label: 'Out for delivery',\n        atMs: Number(delivery.outForDeliveryAtMs) || null,\n        done: deliveryStatus === 'out_for_delivery' || deliveryStatus === 'delivered',\n      },\n      {\n        key: 'delivered',\n        label: 'Delivered',\n        atMs: Number(delivery.deliveredAtMs) || deliveredAt,\n        done: deliveryStatus === 'delivered' || status === 'delivered',\n      },\n    )\n  } else {\n    steps.push(\n      {\n        key: 'shipped',\n        label: status === 'partially_fulfilled' ? 'Partly shipped' : 'Shipped',\n        atMs: firstShipAt,\n        done: ['partially_fulfilled', 'fulfilled', 'delivered'].includes(status) ||\n          shipments.length > 0,\n      },\n      {\n        key: 'delivered',\n        label: 'Delivered',\n        atMs: deliveredAt,\n        done: status === 'delivered' || deliveredAt !== null,\n      },\n    )\n  }\n  if (status === 'refunded') {\n    steps.push({ key: 'refunded', label: 'Refunded', atMs: eventAt(order, 'refund'), done: true })\n  }\n  return {\n    storeName: input.storeName,\n    number: input.number,\n    status,\n    statusLabel:\n      pickup && status !== 'refunded' && status !== 'cancelled'\n        ? ORDER_PICKUP_STATUS_LABELS[orderPickupStatus(pickup.status)]\n        : delivery && status !== 'refunded' && status !== 'cancelled'\n          ? ORDER_LOCAL_DELIVERY_STATUS_LABELS[orderLocalDeliveryStatus(delivery.status)]\n          : (STATUS_LABELS[status] ?? 'Confirmed'),\n    createdAtMs,\n    currency: input.currency || 'USD',\n    lines,\n    totals: {\n      itemsCents: totals?.itemsCents ?? lines.reduce((sum, line) => sum + line.amountCents, 0),\n      shippingCents: totals?.shippingCents ?? 0,\n      taxCents: totals?.taxCents ?? 0,\n      discountCents: totals?.discountCents ?? 0,\n      totalCents,\n      refundedCents: Number(order.refundedCents ?? 0) || 0,\n    },\n    extras: (order.extras ?? [])\n      .filter((extra) => extra && Number(extra.amountCents) > 0)\n      .map((extra) => ({ label: String(extra.label || 'Extra'), amountCents: Number(extra.amountCents) })),\n    shipments,\n    steps,\n    actions: input.actions ?? [],\n    ...(pickup\n      ? {\n          pickup: {\n            locationName: String(pickup.locationName ?? ''),\n            address: pickup.address ?? null,\n            hours: pickup.hours ?? null,\n            instructions: pickup.instructions ?? null,\n            status: orderPickupStatus(pickup.status),\n            statusLabel: ORDER_PICKUP_STATUS_LABELS[orderPickupStatus(pickup.status)],\n          },\n        }\n      : {}),\n    ...(delivery\n      ? {\n          localDelivery: {\n            windowLabel: delivery.windowLabel ?? null,\n            status: orderLocalDeliveryStatus(delivery.status),\n            statusLabel: ORDER_LOCAL_DELIVERY_STATUS_LABELS[orderLocalDeliveryStatus(delivery.status)],\n          },\n        }\n      : {}),\n  }\n}\n"],"names":["fulfillmentIsActive","fulfillmentLineQuantities","carrierLabelFor","fulfillmentTrackingUrl","ORDER_LOCAL_DELIVERY_STATUS_LABELS","ORDER_PICKUP_STATUS_LABELS","orderLocalDeliveryStatus","orderPickupStatus","STATUS_LABELS","pending","paid","partially_fulfilled","fulfilled","delivered","cancelled","refunded","eventAt","order","events","found","timeline","find","entry","includes","String","event","Number","atMs","buildOrderStatusView","input","pickup","delivery","shipments","lineItems","active","fulfillments","filter","parcels","fulfillment","handover","shippedByLine","Map","set","lineItemId","get","quantity","map","quantities","id","carrier","trackingNumber","trackingUrl","lines","name","sort","a","b","refundedLines","Set","refundedLineItemIds","line","index","variantLabel","amountCents","unitAmountCents","shippedQuantity","Math","min","has","totals","totalCents","status","createdAtMs","paidAtMs","firstShipAt","deliveredAt","steps","key","label","done","fulfillmentMethod","undefined","localDelivery","push","pickupStatus","readyAtMs","pickedUpAtMs","deliveryStatus","outForDeliveryAtMs","deliveredAtMs","length","storeName","number","statusLabel","currency","itemsCents","reduce","sum","shippingCents","taxCents","discountCents","refundedCents","extras","extra","actions","locationName","address","hours","instructions","windowLabel"],"mappings":"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"}

package/src/lib/model/product-write.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type HostProduct, type InventoryAdjustment, type InventoryAdjustmentReason, type SmartCollectionRules } from './commerce';
+/** A product as the editor holds it: the stored fields plus keys the listener or a seed may carry. */
+export type EditedProduct = HostProduct & {
+    $id?: string;
+    skus?: string[];
+    barcodes?: string[];
+    stockHolds?: Record<string, unknown>;
+};
+/**
+ * The fields a product save writes, before its collection membership and its
+ * timestamps: the product as edited, with
+ *
+ *  - `$id` dropped (AGL-1374): the listener's synthetic key, never a field;
+ *  - the seed's `skus` / `barcodes` dropped (AGL-3321): `productSearchFields`
+ *    omits each when no variant has one, so a seeded copy would outlive the
+ *    last SKU;
+ *  - the trimmed name with the search keys derived from it, together, so the
+ *    two cannot drift (AGL-2501);
+ *  - a slug, the primary variant's price, the stock fields, the first image
+ *    and `updatedAtMs`.
+ */
+export declare function productSaveFields(current: EditedProduct, nowMs: number): {
+    imageUrl: string;
+    updatedAtMs: number;
+    inventory: number | null;
+    soldOut: boolean;
+    slug: string;
+    priceUsd: number;
+    name: string;
+    nameLower: string;
+    nameTokens: string[];
+    nameReversed: string;
+    skus?: string[];
+    barcodes?: string[];
+    priceFromCents?: number;
+    description?: string;
+    type: import("./commerce").ProductType;
+    status: import("./commerce").ProductStatus;
+    mediaUrls?: string[];
+    categoryIds?: string[];
+    collectionIds?: string[];
+    tags?: string[];
+    options?: import("./commerce").ProductOption[];
+    variants: import("./commerce").ProductVariant[];
+    seo?: {
+        title?: string;
+        description?: string;
+        imageUrl?: string;
+    };
+    channel?: import("./product-channel").ProductChannelFacts;
+    supplierId?: string;
+    oversellPolicy?: "deny" | "backorder";
+    taxExempt?: boolean;
+    digitalFiles?: Array<{
+        url: string;
+        fileName: string;
+        version?: string;
+    }>;
+    downloadLimit?: number;
+    subscription?: {
+        interval: "month" | "year";
+        trialDays?: number;
+    };
+    subscriptionOptional?: boolean;
+    gatedVideos?: Array<{
+        url: string;
+        title?: string;
+    }>;
+    relatedProductIds?: string[];
+    shipping?: import("./commerce").ProductShippingFacts;
+    giftCard?: boolean;
+    lowStockThreshold?: number;
+    modifierGroups?: import("./product-modifiers").ProductModifierGroup[];
+    posQuickKey?: boolean;
+    createdAtMs?: number;
+    deletedAt?: number | null;
+    stockHolds?: Record<string, unknown>;
+};
+/** What the smart-collection rules are matched against: the saved name with the product's own facts. */
+export declare function productMembershipInput(fields: {
+    name: string;
+}, current: Pick<HostProduct, 'type' | 'tags' | 'categoryIds' | 'variants'>): {
+    name: string;
+    type: import("./commerce").ProductType;
+    tags: string[];
+    categoryIds: string[];
+    variants: import("./commerce").ProductVariant[];
+};
+/**
+ * An EDIT's replacing write, without its membership and server timestamp:
+ * live stock holds are not the editor's to write (AGL-2356), so the seed's
+ * are dropped and the stored ones carried; the product stays live
+ * (`deletedAt: null`, AGL-3321).
+ */
+export declare function productEditWrite(fields: ReturnType<typeof productSaveFields>, liveHolds: Record<string, unknown> | null | undefined): {
+    deletedAt: any;
+    stockHolds?: Record<string, unknown>;
+    imageUrl: string;
+    updatedAtMs: number;
+    inventory: number | null;
+    soldOut: boolean;
+    slug: string;
+    priceUsd: number;
+    name: string;
+    nameLower: string;
+    nameTokens: string[];
+    nameReversed: string;
+    skus?: string[];
+    barcodes?: string[];
+    priceFromCents?: number;
+    description?: string;
+    type: import("./commerce").ProductType;
+    status: import("./commerce").ProductStatus;
+    mediaUrls?: string[];
+    categoryIds?: string[];
+    collectionIds?: string[];
+    tags?: string[];
+    options?: import("./commerce").ProductOption[];
+    variants: import("./commerce").ProductVariant[];
+    seo?: {
+        title?: string;
+        description?: string;
+        imageUrl?: string;
+    };
+    channel?: import("./product-channel").ProductChannelFacts;
+    supplierId?: string;
+    oversellPolicy?: "deny" | "backorder";
+    taxExempt?: boolean;
+    digitalFiles?: Array<{
+        url: string;
+        fileName: string;
+        version?: string;
+    }>;
+    downloadLimit?: number;
+    subscription?: {
+        interval: "month" | "year";
+        trialDays?: number;
+    };
+    subscriptionOptional?: boolean;
+    gatedVideos?: Array<{
+        url: string;
+        title?: string;
+    }>;
+    relatedProductIds?: string[];
+    shipping?: import("./commerce").ProductShippingFacts;
+    giftCard?: boolean;
+    lowStockThreshold?: number;
+    modifierGroups?: import("./product-modifiers").ProductModifierGroup[];
+    posQuickKey?: boolean;
+    createdAtMs?: number;
+};
+/** A smart collection as `hosts/{hostId}/collections` stores it, as the membership rules read it. */
+export declare function smartCollectionRulesOf(id: string, data: Record<string, unknown>): SmartCollectionRules;
+/** One stock adjustment, as the Adjust stock dialog asks for it. */
+export interface StockAdjustment {
+    variantId: string;
+    delta: number;
+    reason: InventoryAdjustmentReason;
+    locationId?: string;
+}
+/**
+ * The product update and the ledger row one stock adjustment writes: the
+ * variants with the count moved, the stock fields that move with it
+ * (AGL-3321), and the same `inventoryAdjustments` row the sale webhook writes
+ * (AGL-281). A zero or non-numeric delta writes nothing.
+ */
+export declare function stockAdjustmentWrite(product: HostProduct, productId: string, adjustment: StockAdjustment, nowMs: number): {
+    update: Record<string, unknown>;
+    ledger: InventoryAdjustment;
+} | null;

package/src/lib/model/product-write.js

@@ -0,0 +1,116 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { adjustVariantInventory, commerceSlug, productSearchFields, productStockFields } from "./commerce.js";
+/**
+ * The fields a product save writes, before its collection membership and its
+ * timestamps: the product as edited, with
+ *
+ *  - `$id` dropped (AGL-1374): the listener's synthetic key, never a field;
+ *  - the seed's `skus` / `barcodes` dropped (AGL-3321): `productSearchFields`
+ *    omits each when no variant has one, so a seeded copy would outlive the
+ *    last SKU;
+ *  - the trimmed name with the search keys derived from it, together, so the
+ *    two cannot drift (AGL-2501);
+ *  - a slug, the primary variant's price, the stock fields, the first image
+ *    and `updatedAtMs`.
+ */ export function productSaveFields(current, nowMs) {
+    var _ref, _ref1, _ref2;
+    var _current_mediaUrls;
+    const { $id: _syntheticId, skus: _seededSkus, barcodes: _seededBarcodes } = current, currentFields = _object_without_properties_loose(current, [
+        "$id",
+        "skus",
+        "barcodes"
+    ]);
+    const primaryVariant = current.variants[0];
+    return _extends({}, currentFields, productSearchFields({
+        name: current.name.trim().slice(0, 120),
+        variants: current.variants
+    }), {
+        slug: current.slug || commerceSlug(current.name),
+        priceUsd: (_ref = primaryVariant == null ? void 0 : primaryVariant.priceUsd) != null ? _ref : 0
+    }, productStockFields({
+        variants: current.variants,
+        oversellPolicy: current.oversellPolicy
+    }), {
+        imageUrl: (_ref1 = (_ref2 = (_current_mediaUrls = current.mediaUrls) == null ? void 0 : _current_mediaUrls[0]) != null ? _ref2 : current.imageUrl) != null ? _ref1 : null,
+        updatedAtMs: nowMs
+    });
+}
+/** What the smart-collection rules are matched against: the saved name with the product's own facts. */ export function productMembershipInput(fields, current) {
+    return {
+        name: fields.name,
+        type: current.type,
+        tags: current.tags,
+        categoryIds: current.categoryIds,
+        variants: current.variants
+    };
+}
+/**
+ * An EDIT's replacing write, without its membership and server timestamp:
+ * live stock holds are not the editor's to write (AGL-2356), so the seed's
+ * are dropped and the stored ones carried; the product stays live
+ * (`deletedAt: null`, AGL-3321).
+ */ export function productEditWrite(fields, liveHolds) {
+    const { stockHolds: _seededHolds } = fields, withoutHolds = _object_without_properties_loose(fields, [
+        "stockHolds"
+    ]);
+    return _extends({}, withoutHolds, liveHolds ? {
+        stockHolds: liveHolds
+    } : {}, {
+        deletedAt: null
+    });
+}
+/** A smart collection as `hosts/{hostId}/collections` stores it, as the membership rules read it. */ export function smartCollectionRulesOf(id, data) {
+    var _data_rules;
+    return {
+        id,
+        rules: (_data_rules = data['rules']) != null ? _data_rules : [],
+        matchAll: data['matchAll']
+    };
+}
+/**
+ * The product update and the ledger row one stock adjustment writes: the
+ * variants with the count moved, the stock fields that move with it
+ * (AGL-3321), and the same `inventoryAdjustments` row the sale webhook writes
+ * (AGL-281). A zero or non-numeric delta writes nothing.
+ */ export function stockAdjustmentWrite(product, productId, adjustment, nowMs) {
+    const delta = Math.round(Number(adjustment.delta));
+    if (!delta) return null;
+    const variants = adjustVariantInventory(product, adjustment.variantId, delta, adjustment.locationId || undefined);
+    return {
+        update: _extends({
+            variants
+        }, productStockFields(_extends({}, product, {
+            variants
+        })), {
+            updatedAtMs: nowMs
+        }),
+        ledger: _extends({
+            productId,
+            variantId: adjustment.variantId,
+            delta,
+            reason: adjustment.reason
+        }, adjustment.locationId ? {
+            locationId: adjustment.locationId
+        } : {}, {
+            atMs: nowMs
+        })
+    };
+}
+
+//# sourceMappingURL=product-write.js.map

package/src/lib/model/product-write.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/product-write.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\nimport {\n  adjustVariantInventory,\n  commerceSlug,\n  type HostProduct,\n  type InventoryAdjustment,\n  type InventoryAdjustmentReason,\n  productSearchFields,\n  productStockFields,\n  type SmartCollectionRules,\n} from './commerce'\n\n/*\n * WHAT A PRODUCT SAVE AND A STOCK ADJUSTMENT WRITE, worked out once.\n *\n * The console's product editor and its Adjust stock dialog compute these\n * fields in the browser before their Firestore writes; the native apps save\n * through `commerce/products/save` and `commerce/products/stock`, which run\n * this same code on the server. One computation, so a product saved from a\n * phone carries exactly the search keys, stock verdict, price, image and\n * smart-collection membership the console would have written.\n */\n\n/** A product as the editor holds it: the stored fields plus keys the listener or a seed may carry. */\nexport type EditedProduct = HostProduct & {\n  $id?: string\n  skus?: string[]\n  barcodes?: string[]\n  stockHolds?: Record<string, unknown>\n}\n\n/**\n * The fields a product save writes, before its collection membership and its\n * timestamps: the product as edited, with\n *\n *  - `$id` dropped (AGL-1374): the listener's synthetic key, never a field;\n *  - the seed's `skus` / `barcodes` dropped (AGL-3321): `productSearchFields`\n *    omits each when no variant has one, so a seeded copy would outlive the\n *    last SKU;\n *  - the trimmed name with the search keys derived from it, together, so the\n *    two cannot drift (AGL-2501);\n *  - a slug, the primary variant's price, the stock fields, the first image\n *    and `updatedAtMs`.\n */\nexport function productSaveFields(current: EditedProduct, nowMs: number) {\n  const {\n    $id: _syntheticId,\n    skus: _seededSkus,\n    barcodes: _seededBarcodes,\n    ...currentFields\n  } = current\n  const primaryVariant = current.variants[0]\n  return {\n    ...currentFields,\n    ...productSearchFields({\n      name: current.name.trim().slice(0, 120),\n      variants: current.variants,\n    }),\n    slug: current.slug || commerceSlug(current.name),\n    priceUsd: primaryVariant?.priceUsd ?? 0,\n    ...productStockFields({\n      variants: current.variants,\n      oversellPolicy: current.oversellPolicy,\n    }),\n    imageUrl: current.mediaUrls?.[0] ?? current.imageUrl ?? null,\n    updatedAtMs: nowMs,\n  }\n}\n\n/** What the smart-collection rules are matched against: the saved name with the product's own facts. */\nexport function productMembershipInput(\n  fields: { name: string },\n  current: Pick<HostProduct, 'type' | 'tags' | 'categoryIds' | 'variants'>,\n) {\n  return {\n    name: fields.name,\n    type: current.type,\n    tags: current.tags,\n    categoryIds: current.categoryIds,\n    variants: current.variants,\n  }\n}\n\n/**\n * An EDIT's replacing write, without its membership and server timestamp:\n * live stock holds are not the editor's to write (AGL-2356), so the seed's\n * are dropped and the stored ones carried; the product stays live\n * (`deletedAt: null`, AGL-3321).\n */\nexport function productEditWrite(\n  fields: ReturnType<typeof productSaveFields>,\n  liveHolds: Record<string, unknown> | null | undefined,\n) {\n  const { stockHolds: _seededHolds, ...withoutHolds } = fields as typeof fields & {\n    stockHolds?: Record<string, unknown>\n  }\n  return {\n    ...withoutHolds,\n    ...(liveHolds ? { stockHolds: liveHolds } : {}),\n    deletedAt: null,\n  }\n}\n\n/** A smart collection as `hosts/{hostId}/collections` stores it, as the membership rules read it. */\nexport function smartCollectionRulesOf(id: string, data: Record<string, unknown>): SmartCollectionRules {\n  return {\n    id,\n    rules: (data['rules'] as SmartCollectionRules['rules']) ?? [],\n    matchAll: data['matchAll'] as boolean | undefined,\n  }\n}\n\n/** One stock adjustment, as the Adjust stock dialog asks for it. */\nexport interface StockAdjustment {\n  variantId: string\n  delta: number\n  reason: InventoryAdjustmentReason\n  locationId?: string\n}\n\n/**\n * The product update and the ledger row one stock adjustment writes: the\n * variants with the count moved, the stock fields that move with it\n * (AGL-3321), and the same `inventoryAdjustments` row the sale webhook writes\n * (AGL-281). A zero or non-numeric delta writes nothing.\n */\nexport function stockAdjustmentWrite(\n  product: HostProduct,\n  productId: string,\n  adjustment: StockAdjustment,\n  nowMs: number,\n): { update: Record<string, unknown>; ledger: InventoryAdjustment } | null {\n  const delta = Math.round(Number(adjustment.delta))\n  if (!delta) return null\n  const variants = adjustVariantInventory(product, adjustment.variantId, delta, adjustment.locationId || undefined)\n  return {\n    update: {\n      variants,\n      ...productStockFields({ ...product, variants }),\n      updatedAtMs: nowMs,\n    },\n    ledger: {\n      productId,\n      variantId: adjustment.variantId,\n      delta,\n      reason: adjustment.reason,\n      ...(adjustment.locationId ? { locationId: adjustment.locationId } : {}),\n      atMs: nowMs,\n    },\n  }\n}\n"],"names":["adjustVariantInventory","commerceSlug","productSearchFields","productStockFields","productSaveFields","current","nowMs","$id","_syntheticId","skus","_seededSkus","barcodes","_seededBarcodes","currentFields","primaryVariant","variants","name","trim","slice","slug","priceUsd","oversellPolicy","imageUrl","mediaUrls","updatedAtMs","productMembershipInput","fields","type","tags","categoryIds","productEditWrite","liveHolds","stockHolds","_seededHolds","withoutHolds","deletedAt","smartCollectionRulesOf","id","data","rules","matchAll","stockAdjustmentWrite","product","productId","adjustment","delta","Math","round","Number","variantId","locationId","undefined","update","ledger","reason","atMs"],"mappings":";;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,sBAAsB,EACtBC,YAAY,EAIZC,mBAAmB,EACnBC,kBAAkB,QAEb,gBAAY;AAqBnB;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,kBAAkBC,OAAsB,EAAEC,KAAa;cAoBzDD;QAAAA;IAnBZ,MAAM,EACJE,KAAKC,YAAY,EACjBC,MAAMC,WAAW,EACjBC,UAAUC,eAAe,EAE1B,GAAGP,SADCQ,iDACDR;;;;;IACJ,MAAMS,iBAAiBT,QAAQU,QAAQ,CAAC,EAAE;IAC1C,OAAO,aACFF,eACAX,oBAAoB;QACrBc,MAAMX,QAAQW,IAAI,CAACC,IAAI,GAAGC,KAAK,CAAC,GAAG;QACnCH,UAAUV,QAAQU,QAAQ;IAC5B;QACAI,MAAMd,QAAQc,IAAI,IAAIlB,aAAaI,QAAQW,IAAI;QAC/CI,QAAQ,UAAEN,kCAAAA,eAAgBM,QAAQ,mBAAI;OACnCjB,mBAAmB;QACpBY,UAAUV,QAAQU,QAAQ;QAC1BM,gBAAgBhB,QAAQgB,cAAc;IACxC;QACAC,QAAQ,GAAEjB,kBAAAA,qBAAAA,QAAQkB,SAAS,qBAAjBlB,kBAAmB,CAAC,EAAE,oBAAIA,QAAQiB,QAAQ,YAA1CjB,QAA8C;QACxDmB,aAAalB;;AAEjB;AAEA,sGAAsG,GACtG,OAAO,SAASmB,uBACdC,MAAwB,EACxBrB,OAAwE;IAExE,OAAO;QACLW,MAAMU,OAAOV,IAAI;QACjBW,MAAMtB,QAAQsB,IAAI;QAClBC,MAAMvB,QAAQuB,IAAI;QAClBC,aAAaxB,QAAQwB,WAAW;QAChCd,UAAUV,QAAQU,QAAQ;IAC5B;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASe,iBACdJ,MAA4C,EAC5CK,SAAqD;IAErD,MAAM,EAAEC,YAAYC,YAAY,EAAmB,GAAGP,QAAjBQ,gDAAiBR;;;IAGtD,OAAO,aACFQ,cACCH,YAAY;QAAEC,YAAYD;IAAU,IAAI,CAAC;QAC7CI,WAAW;;AAEf;AAEA,mGAAmG,GACnG,OAAO,SAASC,uBAAuBC,EAAU,EAAEC,IAA6B;QAGpEA;IAFV,OAAO;QACLD;QACAE,KAAK,GAAGD,cAAAA,IAAI,CAAC,QAAQ,YAAbA,cAAmD,EAAE;QAC7DE,UAAUF,IAAI,CAAC,WAAW;IAC5B;AACF;AAUA;;;;;CAKC,GACD,OAAO,SAASG,qBACdC,OAAoB,EACpBC,SAAiB,EACjBC,UAA2B,EAC3BtC,KAAa;IAEb,MAAMuC,QAAQC,KAAKC,KAAK,CAACC,OAAOJ,WAAWC,KAAK;IAChD,IAAI,CAACA,OAAO,OAAO;IACnB,MAAM9B,WAAWf,uBAAuB0C,SAASE,WAAWK,SAAS,EAAEJ,OAAOD,WAAWM,UAAU,IAAIC;IACvG,OAAO;QACLC,QAAQ;YACNrC;WACGZ,mBAAmB,aAAKuC;YAAS3B;;YACpCS,aAAalB;;QAEf+C,QAAQ;YACNV;YACAM,WAAWL,WAAWK,SAAS;YAC/BJ;YACAS,QAAQV,WAAWU,MAAM;WACrBV,WAAWM,UAAU,GAAG;YAAEA,YAAYN,WAAWM,UAAU;QAAC,IAAI,CAAC;YACrEK,MAAMjD;;IAEV;AACF"}

package/src/lib/plugin-config.js

@@ -16,6 +16,7 @@
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { posTipPercentages } from "./model/commerce-pos.js";
 import { POS_OPS_CONFIG_DEFAULTS, POS_OPS_CONFIG_FIELDS } from "./pos-ops-config.js";
+import { POS_KIOSK_CONFIG_DEFAULTS, POS_KIOSK_CONFIG_FIELDS } from "./pos-kiosk-config.js";
 /**
  * The ceiling a register may discount to, when the merchant has not set one
  * (AGL-2161).
@@ -108,7 +109,10 @@ import { POS_OPS_CONFIG_DEFAULTS, POS_OPS_CONFIG_FIELDS } from "./pos-ops-config
         },
         // RUNNING THE REGISTER (AGL-3609): shifts, refund limits, the idle lock
         // and what a printed receipt carries.
-        ...POS_OPS_CONFIG_FIELDS
+        ...POS_OPS_CONFIG_FIELDS,
+        // THE SELF-SERVICE KIOSK (AGL-3623): pay at counter, the idle reset and
+        // its welcome line.
+        ...POS_KIOSK_CONFIG_FIELDS
     ],
     defaults: _extends({
         posMaxDiscountPct: POS_MAX_DISCOUNT_PCT_DEFAULT,
@@ -117,7 +121,7 @@ import { POS_OPS_CONFIG_DEFAULTS, POS_OPS_CONFIG_FIELDS } from "./pos-ops-config
         posReceiptDefault: 'ask',
         posDisplayMessage: '',
         posDisplayMarketingOptIn: true
-    }, POS_OPS_CONFIG_DEFAULTS)
+    }, POS_OPS_CONFIG_DEFAULTS, POS_KIOSK_CONFIG_DEFAULTS)
 };
 /**
  * The register settings out of a merged commerce config, with every value

package/src/lib/plugin-config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/plugin-config.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\nimport type { PluginConfigSchema } from '@aglyn/aglyn'\nimport { posTipPercentages } from './model/commerce-pos'\nimport { POS_OPS_CONFIG_DEFAULTS, POS_OPS_CONFIG_FIELDS } from './pos-ops-config'\n\n/**\n * The ceiling a register may discount to, when the merchant has not set one\n * (AGL-2161).\n *\n * 100, i.e. today's behaviour exactly. That is deliberate and is the one\n * number in this fix that is NOT a safety judgement:\n *\n * - A full comp is a legitimate register operation — a damaged item, a\n *   goodwill gesture, a staff meal — and every merchant on the platform has\n *   had it since POS shipped.\n * - Any lower default would change what merchants charge their own customers\n *   on the day it deployed, without them asking. Picking that number is a\n *   merchant policy decision, not a bug fix, and inventing one here would be\n *   the same class of mistake as inventing a billing rate.\n *\n * What AGL-2161 actually fixes is that there was no ceiling to set and no\n * refusal when one was exceeded: the request body's `discountPct` was clamped\n * into range and rung up, so a register sending `150` silently comped the\n * whole sale. The ceiling is now real, enforced server-side, refused rather\n * than clamped, and one config value away from being lower.\n */\nexport const POS_MAX_DISCOUNT_PCT_DEFAULT = 100\n\n/**\n * Commerce plugin config schema (AGL-428 framework, AGL-2161 adopter).\n *\n * PURE DATA (type-only aglyn import), the same shape as bookings': the client\n * barrel registers it via '@aglyn/aglyn' and the /server entry via\n * '@aglyn/aglyn/server', so neither bundle drags in the other's barrel.\n *\n * `min`/`max` are not decoration — `mergePluginConfig` coerces a stored value\n * into the declared range and falls back to the default on junk, so the\n * ceiling itself cannot be forged out of bounds by a manager editing the\n * settings doc directly.\n */\nexport const COMMERCE_CONFIG_SCHEMA: PluginConfigSchema = {\n  pluginId: 'commerce',\n  fields: [\n    {\n      key: 'posMaxDiscountPct',\n      label: 'Maximum register discount (%)',\n      type: 'number',\n      min: 0,\n      max: 100,\n      description:\n        'The largest discount the point of sale will accept on a sale. ' +\n        'A register that asks for more is refused, and the sale is not rung ' +\n        'up. Set to 0 to stop staff discounting at the register entirely.',\n    },\n    // THE REGISTER'S TIPS, RECEIPTS AND CUSTOMER DISPLAY (AGL-3607, AGL-3608).\n    // Off by default: a store that never asked for tips does not start\n    // asking its customers for one on the day this ships.\n    {\n      key: 'posTippingEnabled',\n      label: 'Ask for tips at the register',\n      type: 'boolean',\n      description:\n        'Offers the customer a tip on the card reader and on the customer ' +\n        'display. Tips are yours: they are not counted as sales and carry no ' +\n        'platform fee.',\n    },\n    {\n      key: 'posTipPercentages',\n      label: 'Tip choices (%)',\n      type: 'string',\n      description:\n        'Up to four percentages, separated by commas, shown to the customer ' +\n        'as tip buttons. The customer can also enter an amount or choose no tip.',\n    },\n    {\n      key: 'posReceiptDefault',\n      label: 'Receipts at the register',\n      type: 'select',\n      options: [\n        { value: 'ask', label: 'Ask the customer' },\n        { value: 'print', label: 'Always print' },\n        { value: 'none', label: 'No receipt unless asked' },\n      ],\n      description:\n        'With a customer display paired, \"Ask the customer\" lets them choose ' +\n        'email, print or no receipt on their own screen.',\n    },\n    {\n      key: 'posDisplayMessage',\n      label: 'Customer display welcome',\n      type: 'string',\n      description:\n        'The line the customer display shows under your store name between ' +\n        'sales. Leave blank for \"Welcome\".',\n    },\n    {\n      key: 'posDisplayMarketingOptIn',\n      label: 'Offer email sign-up on the customer display',\n      type: 'boolean',\n      description:\n        'Shows an unticked \"Email me news and offers\" box when a customer ' +\n        'asks for an email receipt. Only a ticked box adds them to your ' +\n        'marketing audience.',\n    },\n    // RUNNING THE REGISTER (AGL-3609): shifts, refund limits, the idle lock\n    // and what a printed receipt carries.\n    ...POS_OPS_CONFIG_FIELDS,\n  ],\n  defaults: {\n    posMaxDiscountPct: POS_MAX_DISCOUNT_PCT_DEFAULT,\n    posTippingEnabled: false,\n    posTipPercentages: '15, 18, 20, 25',\n    posReceiptDefault: 'ask',\n    posDisplayMessage: '',\n    posDisplayMarketingOptIn: true,\n    ...POS_OPS_CONFIG_DEFAULTS,\n  },\n}\n\n/** The register's tip, receipt and display settings, resolved for one site. */\nexport interface PosRegisterSettings {\n  tippingEnabled: boolean\n  tipPercentages: number[]\n  receiptDefault: 'ask' | 'print' | 'none'\n  displayMessage: string\n  displayMarketingOptIn: boolean\n}\n\n/**\n * The register settings out of a merged commerce config, with every value\n * typed and bounded so the register, the display and the server agree.\n */\nexport function posRegisterSettings(\n  config: Record<string, unknown> | null | undefined,\n): PosRegisterSettings {\n  const receipt = String(config?.['posReceiptDefault'] ?? 'ask')\n  return {\n    tippingEnabled: config?.['posTippingEnabled'] === true,\n    tipPercentages: posTipPercentages(config?.['posTipPercentages']),\n    receiptDefault:\n      receipt === 'print' || receipt === 'none' ? receipt : 'ask',\n    displayMessage: String(config?.['posDisplayMessage'] ?? '').trim().slice(0, 120),\n    displayMarketingOptIn: config?.['posDisplayMarketingOptIn'] !== false,\n  }\n}\n\n/**\n * The ceiling for one org, read defensively (AGL-2161).\n *\n * Spelled here rather than at the call site so the POS route and any later\n * reader cannot disagree about what a missing or malformed value means. The\n * framework has already clamped and defaulted by the time this runs; the\n * second `Number.isFinite` guard is for the schema-less case, where\n * `getPluginConfig` returns the raw doc untouched.\n */\nexport function posMaxDiscountPct(\n  config: Record<string, unknown> | null | undefined,\n): number {\n  const raw = Number(config?.['posMaxDiscountPct'])\n  if (!Number.isFinite(raw)) return POS_MAX_DISCOUNT_PCT_DEFAULT\n  return Math.min(100, Math.max(0, raw))\n}\n"],"names":["posTipPercentages","POS_OPS_CONFIG_DEFAULTS","POS_OPS_CONFIG_FIELDS","POS_MAX_DISCOUNT_PCT_DEFAULT","COMMERCE_CONFIG_SCHEMA","pluginId","fields","key","label","type","min","max","description","options","value","defaults","posMaxDiscountPct","posTippingEnabled","posReceiptDefault","posDisplayMessage","posDisplayMarketingOptIn","posRegisterSettings","config","receipt","String","tippingEnabled","tipPercentages","receiptDefault","displayMessage","trim","slice","displayMarketingOptIn","raw","Number","isFinite","Math"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,iBAAiB,QAAQ,0BAAsB;AACxD,SAASC,uBAAuB,EAAEC,qBAAqB,QAAQ,sBAAkB;AAEjF;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMC,+BAA+B,IAAG;AAE/C;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,yBAA6C;IACxDC,UAAU;IACVC,QAAQ;QACN;YACEC,KAAK;YACLC,OAAO;YACPC,MAAM;YACNC,KAAK;YACLC,KAAK;YACLC,aACE,mEACA,wEACA;QACJ;QACA,2EAA2E;QAC3E,mEAAmE;QACnE,sDAAsD;QACtD;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,sEACA,yEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,wEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNI,SAAS;gBACP;oBAAEC,OAAO;oBAAON,OAAO;gBAAmB;gBAC1C;oBAAEM,OAAO;oBAASN,OAAO;gBAAe;gBACxC;oBAAEM,OAAO;oBAAQN,OAAO;gBAA0B;aACnD;YACDI,aACE,yEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,uEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,sEACA,oEACA;QACJ;QACA,wEAAwE;QACxE,sCAAsC;WACnCV;KACJ;IACDa,UAAU;QACRC,mBAAmBb;QACnBc,mBAAmB;QACnBjB,mBAAmB;QACnBkB,mBAAmB;QACnBC,mBAAmB;QACnBC,0BAA0B;OACvBnB;AAEP,EAAC;AAWD;;;CAGC,GACD,OAAO,SAASoB,oBACdC,MAAkD;;IAElD,MAAMC,UAAUC,eAAOF,0BAAAA,MAAQ,CAAC,oBAAoB,mBAAI;IACxD,OAAO;QACLG,gBAAgBH,CAAAA,0BAAAA,MAAQ,CAAC,oBAAoB,MAAK;QAClDI,gBAAgB1B,kBAAkBsB,0BAAAA,MAAQ,CAAC,oBAAoB;QAC/DK,gBACEJ,YAAY,WAAWA,YAAY,SAASA,UAAU;QACxDK,gBAAgBJ,gBAAOF,0BAAAA,MAAQ,CAAC,oBAAoB,oBAAI,IAAIO,IAAI,GAAGC,KAAK,CAAC,GAAG;QAC5EC,uBAAuBT,CAAAA,0BAAAA,MAAQ,CAAC,2BAA2B,MAAK;IAClE;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASN,kBACdM,MAAkD;IAElD,MAAMU,MAAMC,OAAOX,0BAAAA,MAAQ,CAAC,oBAAoB;IAChD,IAAI,CAACW,OAAOC,QAAQ,CAACF,MAAM,OAAO7B;IAClC,OAAOgC,KAAKzB,GAAG,CAAC,KAAKyB,KAAKxB,GAAG,CAAC,GAAGqB;AACnC"}
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/plugin-config.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\nimport type { PluginConfigSchema } from '@aglyn/aglyn'\nimport { posTipPercentages } from './model/commerce-pos'\nimport { POS_OPS_CONFIG_DEFAULTS, POS_OPS_CONFIG_FIELDS } from './pos-ops-config'\nimport { POS_KIOSK_CONFIG_DEFAULTS, POS_KIOSK_CONFIG_FIELDS } from './pos-kiosk-config'\n\n/**\n * The ceiling a register may discount to, when the merchant has not set one\n * (AGL-2161).\n *\n * 100, i.e. today's behaviour exactly. That is deliberate and is the one\n * number in this fix that is NOT a safety judgement:\n *\n * - A full comp is a legitimate register operation — a damaged item, a\n *   goodwill gesture, a staff meal — and every merchant on the platform has\n *   had it since POS shipped.\n * - Any lower default would change what merchants charge their own customers\n *   on the day it deployed, without them asking. Picking that number is a\n *   merchant policy decision, not a bug fix, and inventing one here would be\n *   the same class of mistake as inventing a billing rate.\n *\n * What AGL-2161 actually fixes is that there was no ceiling to set and no\n * refusal when one was exceeded: the request body's `discountPct` was clamped\n * into range and rung up, so a register sending `150` silently comped the\n * whole sale. The ceiling is now real, enforced server-side, refused rather\n * than clamped, and one config value away from being lower.\n */\nexport const POS_MAX_DISCOUNT_PCT_DEFAULT = 100\n\n/**\n * Commerce plugin config schema (AGL-428 framework, AGL-2161 adopter).\n *\n * PURE DATA (type-only aglyn import), the same shape as bookings': the client\n * barrel registers it via '@aglyn/aglyn' and the /server entry via\n * '@aglyn/aglyn/server', so neither bundle drags in the other's barrel.\n *\n * `min`/`max` are not decoration — `mergePluginConfig` coerces a stored value\n * into the declared range and falls back to the default on junk, so the\n * ceiling itself cannot be forged out of bounds by a manager editing the\n * settings doc directly.\n */\nexport const COMMERCE_CONFIG_SCHEMA: PluginConfigSchema = {\n  pluginId: 'commerce',\n  fields: [\n    {\n      key: 'posMaxDiscountPct',\n      label: 'Maximum register discount (%)',\n      type: 'number',\n      min: 0,\n      max: 100,\n      description:\n        'The largest discount the point of sale will accept on a sale. ' +\n        'A register that asks for more is refused, and the sale is not rung ' +\n        'up. Set to 0 to stop staff discounting at the register entirely.',\n    },\n    // THE REGISTER'S TIPS, RECEIPTS AND CUSTOMER DISPLAY (AGL-3607, AGL-3608).\n    // Off by default: a store that never asked for tips does not start\n    // asking its customers for one on the day this ships.\n    {\n      key: 'posTippingEnabled',\n      label: 'Ask for tips at the register',\n      type: 'boolean',\n      description:\n        'Offers the customer a tip on the card reader and on the customer ' +\n        'display. Tips are yours: they are not counted as sales and carry no ' +\n        'platform fee.',\n    },\n    {\n      key: 'posTipPercentages',\n      label: 'Tip choices (%)',\n      type: 'string',\n      description:\n        'Up to four percentages, separated by commas, shown to the customer ' +\n        'as tip buttons. The customer can also enter an amount or choose no tip.',\n    },\n    {\n      key: 'posReceiptDefault',\n      label: 'Receipts at the register',\n      type: 'select',\n      options: [\n        { value: 'ask', label: 'Ask the customer' },\n        { value: 'print', label: 'Always print' },\n        { value: 'none', label: 'No receipt unless asked' },\n      ],\n      description:\n        'With a customer display paired, \"Ask the customer\" lets them choose ' +\n        'email, print or no receipt on their own screen.',\n    },\n    {\n      key: 'posDisplayMessage',\n      label: 'Customer display welcome',\n      type: 'string',\n      description:\n        'The line the customer display shows under your store name between ' +\n        'sales. Leave blank for \"Welcome\".',\n    },\n    {\n      key: 'posDisplayMarketingOptIn',\n      label: 'Offer email sign-up on the customer display',\n      type: 'boolean',\n      description:\n        'Shows an unticked \"Email me news and offers\" box when a customer ' +\n        'asks for an email receipt. Only a ticked box adds them to your ' +\n        'marketing audience.',\n    },\n    // RUNNING THE REGISTER (AGL-3609): shifts, refund limits, the idle lock\n    // and what a printed receipt carries.\n    ...POS_OPS_CONFIG_FIELDS,\n    // THE SELF-SERVICE KIOSK (AGL-3623): pay at counter, the idle reset and\n    // its welcome line.\n    ...POS_KIOSK_CONFIG_FIELDS,\n  ],\n  defaults: {\n    posMaxDiscountPct: POS_MAX_DISCOUNT_PCT_DEFAULT,\n    posTippingEnabled: false,\n    posTipPercentages: '15, 18, 20, 25',\n    posReceiptDefault: 'ask',\n    posDisplayMessage: '',\n    posDisplayMarketingOptIn: true,\n    ...POS_OPS_CONFIG_DEFAULTS,\n    ...POS_KIOSK_CONFIG_DEFAULTS,\n  },\n}\n\n/** The register's tip, receipt and display settings, resolved for one site. */\nexport interface PosRegisterSettings {\n  tippingEnabled: boolean\n  tipPercentages: number[]\n  receiptDefault: 'ask' | 'print' | 'none'\n  displayMessage: string\n  displayMarketingOptIn: boolean\n}\n\n/**\n * The register settings out of a merged commerce config, with every value\n * typed and bounded so the register, the display and the server agree.\n */\nexport function posRegisterSettings(\n  config: Record<string, unknown> | null | undefined,\n): PosRegisterSettings {\n  const receipt = String(config?.['posReceiptDefault'] ?? 'ask')\n  return {\n    tippingEnabled: config?.['posTippingEnabled'] === true,\n    tipPercentages: posTipPercentages(config?.['posTipPercentages']),\n    receiptDefault:\n      receipt === 'print' || receipt === 'none' ? receipt : 'ask',\n    displayMessage: String(config?.['posDisplayMessage'] ?? '').trim().slice(0, 120),\n    displayMarketingOptIn: config?.['posDisplayMarketingOptIn'] !== false,\n  }\n}\n\n/**\n * The ceiling for one org, read defensively (AGL-2161).\n *\n * Spelled here rather than at the call site so the POS route and any later\n * reader cannot disagree about what a missing or malformed value means. The\n * framework has already clamped and defaulted by the time this runs; the\n * second `Number.isFinite` guard is for the schema-less case, where\n * `getPluginConfig` returns the raw doc untouched.\n */\nexport function posMaxDiscountPct(\n  config: Record<string, unknown> | null | undefined,\n): number {\n  const raw = Number(config?.['posMaxDiscountPct'])\n  if (!Number.isFinite(raw)) return POS_MAX_DISCOUNT_PCT_DEFAULT\n  return Math.min(100, Math.max(0, raw))\n}\n"],"names":["posTipPercentages","POS_OPS_CONFIG_DEFAULTS","POS_OPS_CONFIG_FIELDS","POS_KIOSK_CONFIG_DEFAULTS","POS_KIOSK_CONFIG_FIELDS","POS_MAX_DISCOUNT_PCT_DEFAULT","COMMERCE_CONFIG_SCHEMA","pluginId","fields","key","label","type","min","max","description","options","value","defaults","posMaxDiscountPct","posTippingEnabled","posReceiptDefault","posDisplayMessage","posDisplayMarketingOptIn","posRegisterSettings","config","receipt","String","tippingEnabled","tipPercentages","receiptDefault","displayMessage","trim","slice","displayMarketingOptIn","raw","Number","isFinite","Math"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,iBAAiB,QAAQ,0BAAsB;AACxD,SAASC,uBAAuB,EAAEC,qBAAqB,QAAQ,sBAAkB;AACjF,SAASC,yBAAyB,EAAEC,uBAAuB,QAAQ,wBAAoB;AAEvF;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMC,+BAA+B,IAAG;AAE/C;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,yBAA6C;IACxDC,UAAU;IACVC,QAAQ;QACN;YACEC,KAAK;YACLC,OAAO;YACPC,MAAM;YACNC,KAAK;YACLC,KAAK;YACLC,aACE,mEACA,wEACA;QACJ;QACA,2EAA2E;QAC3E,mEAAmE;QACnE,sDAAsD;QACtD;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,sEACA,yEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,wEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNI,SAAS;gBACP;oBAAEC,OAAO;oBAAON,OAAO;gBAAmB;gBAC1C;oBAAEM,OAAO;oBAASN,OAAO;gBAAe;gBACxC;oBAAEM,OAAO;oBAAQN,OAAO;gBAA0B;aACnD;YACDI,aACE,yEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,uEACA;QACJ;QACA;YACEL,KAAK;YACLC,OAAO;YACPC,MAAM;YACNG,aACE,sEACA,oEACA;QACJ;QACA,wEAAwE;QACxE,sCAAsC;WACnCZ;QACH,wEAAwE;QACxE,oBAAoB;WACjBE;KACJ;IACDa,UAAU;QACRC,mBAAmBb;QACnBc,mBAAmB;QACnBnB,mBAAmB;QACnBoB,mBAAmB;QACnBC,mBAAmB;QACnBC,0BAA0B;OACvBrB,yBACAE;AAEP,EAAC;AAWD;;;CAGC,GACD,OAAO,SAASoB,oBACdC,MAAkD;;IAElD,MAAMC,UAAUC,eAAOF,0BAAAA,MAAQ,CAAC,oBAAoB,mBAAI;IACxD,OAAO;QACLG,gBAAgBH,CAAAA,0BAAAA,MAAQ,CAAC,oBAAoB,MAAK;QAClDI,gBAAgB5B,kBAAkBwB,0BAAAA,MAAQ,CAAC,oBAAoB;QAC/DK,gBACEJ,YAAY,WAAWA,YAAY,SAASA,UAAU;QACxDK,gBAAgBJ,gBAAOF,0BAAAA,MAAQ,CAAC,oBAAoB,oBAAI,IAAIO,IAAI,GAAGC,KAAK,CAAC,GAAG;QAC5EC,uBAAuBT,CAAAA,0BAAAA,MAAQ,CAAC,2BAA2B,MAAK;IAClE;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASN,kBACdM,MAAkD;IAElD,MAAMU,MAAMC,OAAOX,0BAAAA,MAAQ,CAAC,oBAAoB;IAChD,IAAI,CAACW,OAAOC,QAAQ,CAACF,MAAM,OAAO7B;IAClC,OAAOgC,KAAKzB,GAAG,CAAC,KAAKyB,KAAKxB,GAAG,CAAC,GAAGqB;AACnC"}

package/src/lib/plugin.js

@@ -18,6 +18,7 @@ import { mdiStorefrontOutline } from "@aglyn/shared-data-mdi";
 import { lazy } from "react";
 const PosConsolePage = lazy(()=>import("./components/console/pos-page.component.js"));
 /** The customer display (AGL-3608): loads only on the public page that shows it. */ const PosDisplayPage = lazy(()=>import("./components/console/pos-display-page.component.js"));
+const PosKioskPage = lazy(()=>import("./components/console/pos-kiosk-page.component.js"));
 const CommerceGlanceCard = lazy(()=>import("./components/console/commerce-glance-card.component.js"));
 const NewestSiteUsersCard = lazy(()=>import("./components/console/newest-site-users-card.component.js"));
 const SiteMemberPurchases = lazy(()=>import("./components/console/site-member-purchases.component.js"));
@@ -30,6 +31,7 @@ import { registerCommerceZones } from "./components/console/product-zones.js";
 import { registerCommerceOrderZones } from "./components/console/order-zones.js";
 import { registerCommerceReturnZones } from "./components/console/return-zones.js";
 import { registerCommerceStoreZones } from "./components/console/store-zones.js";
+import { registerCommercePosZones } from "./components/console/pos-zones.js";
 import { registerCommerceTransferUi } from "./transfer/register-transfer-ui.js";
 import { COMMERCE_SEARCH_SOURCES } from "./model/commerce-search-sources.js";
 import { COMMERCE_CONFIG_SCHEMA } from "./plugin-config.js";
@@ -58,6 +60,8 @@ import { COMMERCE_CONFIG_SCHEMA } from "./plugin-config.js";
     registerCommerceReturnZones();
     // The orders list's bulk actions and the store's Settings (AGL-3612).
     registerCommerceStoreZones();
+    // The register's orders from other channels — a delivery app's (AGL-3644).
+    registerCommercePosZones();
     // Its import and export resources' names and the products wizard's own
     // step (AGL-3531); the server halves register from the console's server
     // declarations.
@@ -81,6 +85,13 @@ import { COMMERCE_CONFIG_SCHEMA } from "./plugin-config.js";
                 path: '/pos-display',
                 title: 'Customer display',
                 Component: PosDisplayPage
+            },
+            // The self-service kiosk (AGL-3623), paired the same way with a kiosk
+            // code; `server/pos-kiosk.ts` refuses every call without its token.
+            {
+                path: '/pos-kiosk',
+                title: 'Self-service kiosk',
+                Component: PosKioskPage
             }
         ],
         // Dashboard/analytics glance card (AGL-419): rendered through the