@aglyn/plugins-commerce 1.0.0-beta.232 → 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":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,mBAAmB,EAAEC,yBAAyB,QAAQ,yBAAqB;AACpF,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,oBAAgB;AA8ExE,MAAMC,gBAA6C;IACjDC,SAAS;IACTC,MAAM;IACNC,qBAAqB;IACrBC,WAAW;IACXC,WAAW;IACXC,WAAW;IACXC,UAAU;AACZ;AAEA,SAASC,QAAQC,KAAgB,EAAE,GAAGC,MAAgB;QACrCD;IAAf,MAAME,QAAQ,EAACF,kBAAAA,MAAMG,QAAQ,YAAdH,kBAAkB,EAAE,EAAEI,IAAI,CAAC,CAACC;;eACzCJ,OAAOK,QAAQ,CAACC,eAAOF,yBAAAA,MAAOG,KAAK,mBAAI;;IAEzC,OAAON,QAAQO,OAAOP,MAAMQ,IAAI,KAAK,OAAO;AAC9C;AAEA,0EAA0E,GAC1E,OAAO,SAASC,qBAAqBC,KAOpC;QAEmBZ,kBACFA,qBAwBcA,kCAUkBA,oBAG/BD,iBAsCFR,mDAUWS,sBAEfA,eAKAY;QAtDSC;IAxCpB,MAAM,EAAEb,KAAK,EAAE,GAAGY;IAClB,MAAME,aAAYd,mBAAAA,MAAMc,SAAS,YAAfd,mBAAmB,EAAE;IACvC,MAAMe,SAAS,EAACf,sBAAAA,MAAMgB,YAAY,YAAlBhB,sBAAsB,EAAE,EAAEiB,MAAM,CAAC9B;IACjD,MAAM+B,gBAAgB,IAAIC;IAC1B,MAAMN,YAAmCE,OACtCK,GAAG,CAAC,CAACC;YASSA,iBAGKA;QAXlB,MAAMC,aAAalC,0BAA0BY,OAAOqB;QACpD,KAAK,MAAMhB,SAASiB,WAAY;gBAG3BJ;YAFHA,cAAcK,GAAG,CACflB,MAAMmB,UAAU,EAChB,EAACN,qBAAAA,cAAcO,GAAG,CAACpB,MAAMmB,UAAU,aAAlCN,qBAAuC,KAAKb,MAAMqB,QAAQ;QAE/D;QACA,OAAO;YACLC,IAAIpB,QAAOc,kBAAAA,YAAYM,EAAE,YAAdN,kBAAkB;YAC7BX,MAAMD,OAAOY,YAAYX,IAAI,KAAK;YAClCkB,SAASP,YAAYO,OAAO,GAAGvC,gBAAgBgC,YAAYO,OAAO,IAAI;YACtEC,cAAc,GAAER,8BAAAA,YAAYQ,cAAc,YAA1BR,8BAA8B;YAC9CS,aAAaxC,uBAAuB+B;YACpCU,OAAOT,WAAWF,GAAG,CAAC,CAACf;;oBACRS;uBADmB;oBAChCkB,MAAMzB,gBAAOO,8BAAAA,SAAS,CAACT,MAAMmB,UAAU,CAAC,qBAA3BV,4BAA6BkB,IAAI,mBAAI;oBAClDN,UAAUrB,MAAMqB,QAAQ;gBAC1B;;QACF;IACF,GACCO,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAExB,IAAI,GAAGyB,EAAEzB,IAAI;IACjC,MAAM0B,gBAAgB,IAAIC,KAAIrC,6BAAAA,MAAMsC,mBAAmB,YAAzBtC,6BAA6B,EAAE;IAC7D,MAAM+B,QAA2BjB,UAAUM,GAAG,CAAC,CAACmB,MAAMC;YACvCD,YACCA,oBAGwCrB;eALS;YAC/Dc,MAAMzB,QAAOgC,aAAAA,KAAKP,IAAI,YAATO,aAAa;YAC1BE,YAAY,GAAEF,qBAAAA,KAAKE,YAAY,YAAjBF,qBAAqB;YACnCb,UAAUjB,OAAO8B,KAAKb,QAAQ,KAAK;YACnCgB,aAAa,AAACjC,CAAAA,OAAO8B,KAAKI,eAAe,KAAK,CAAA,IAAMlC,CAAAA,OAAO8B,KAAKb,QAAQ,KAAK,CAAA;YAC7EkB,iBAAiBC,KAAKC,GAAG,CAACrC,OAAO8B,KAAKb,QAAQ,KAAK,IAAGR,qBAAAA,cAAcO,GAAG,CAACe,kBAAlBtB,qBAA4B;YAClFpB,UAAUsC,cAAcW,GAAG,CAACP;QAC9B;;IACA,MAAMQ,SAAShD,MAAMgD,MAAM;IAC3B,MAAMC,qBAAaD,0BAAAA,OAAQC,UAAU,mBAAIxC,QAAOT,qBAAAA,MAAM0C,WAAW,YAAjB1C,qBAAqB;IACrE,MAAMkD,SAASlD,MAAMkD,MAAM;IAC3B,MAAMC,cAAc1C,OAAOT,MAAMmD,WAAW,KAAK;IACjD,MAAMC,YAAWrD,WAAAA,QAAQC,OAAO,mBAAfD,WAA2BmD,WAAW,YAAYC,cAAc;IACjF,MAAME,wBAAcxC,cAAAA,SAAS,CAAC,EAAE,qBAAZA,YAAcH,IAAI,oBAAIX,QAAQC,OAAO,aAAa;IACtE,MAAMsD,cAAcvD,QAAQC,OAAO;IACnC,MAAMuD,QAA2B;QAC/B;YAAEC,KAAK;YAAUC,OAAO;YAAgB/C,MAAMyC;YAAaO,MAAM;QAAK;QACtE;YACEF,KAAK;YACLC,OAAO;YACP/C,MAAM0C;YACNM,MAAMR,WAAW,aAAaE,aAAa;QAC7C;KACD;IACD,IAAIF,WAAW,aAAa;QAC1BK,MAAMI,IAAI,CAAC;YAAEH,KAAK;YAAaC,OAAO;YAAY/C,MAAMX,QAAQC,OAAO;YAAc0D,MAAM;QAAK;IAClG,OAAO;QACLH,MAAMI,IAAI,CACR;YACEH,KAAK;YACLC,OAAOP,WAAW,wBAAwB,mBAAmB;YAC7DxC,MAAM2C;YACNK,MAAM;gBAAC;gBAAuB;gBAAa;aAAY,CAACpD,QAAQ,CAAC4C,WAC/DrC,UAAU+C,MAAM,GAAG;QACvB,GACA;YACEJ,KAAK;YACLC,OAAO;YACP/C,MAAM4C;YACNI,MAAMR,WAAW,eAAeI,gBAAgB;QAClD;IAEJ;IACA,IAAIJ,WAAW,YAAY;QACzBK,MAAMI,IAAI,CAAC;YAAEH,KAAK;YAAYC,OAAO;YAAY/C,MAAMX,QAAQC,OAAO;YAAW0D,MAAM;QAAK;IAC9F;IACA,OAAO;QACLG,WAAWjD,MAAMiD,SAAS;QAC1BC,QAAQlD,MAAMkD,MAAM;QACpBZ;QACAa,WAAW,GAAExE,wBAAAA,aAAa,CAAC2D,OAAO,YAArB3D,wBAAyB;QACtC4D;QACAa,UAAUpD,MAAMoD,QAAQ,IAAI;QAC5BjC;QACAiB,QAAQ;YACNiB,UAAU,WAAEjB,0BAAAA,OAAQiB,UAAU,oBAAIlC,MAAMmC,MAAM,CAAC,CAACC,KAAK5B,OAAS4B,MAAM5B,KAAKG,WAAW,EAAE;YACtF0B,aAAa,WAAEpB,0BAAAA,OAAQoB,aAAa,oBAAI;YACxCC,QAAQ,WAAErB,0BAAAA,OAAQqB,QAAQ,oBAAI;YAC9BC,aAAa,WAAEtB,0BAAAA,OAAQsB,aAAa,oBAAI;YACxCrB;YACAsB,eAAe9D,QAAOT,uBAAAA,MAAMuE,aAAa,YAAnBvE,uBAAuB,MAAM;QACrD;QACAwE,QAAQ,EAACxE,gBAAAA,MAAMwE,MAAM,YAAZxE,gBAAgB,EAAE,EACxBiB,MAAM,CAAC,CAACwD,QAAUA,SAAShE,OAAOgE,MAAM/B,WAAW,IAAI,GACvDtB,GAAG,CAAC,CAACqD,QAAW,CAAA;gBAAEhB,OAAOlD,OAAOkE,MAAMhB,KAAK,IAAI;gBAAUf,aAAajC,OAAOgE,MAAM/B,WAAW;YAAE,CAAA;QACnG7B;QACA0C;QACAmB,OAAO,GAAE9D,iBAAAA,MAAM8D,OAAO,YAAb9D,iBAAiB,EAAE;IAC9B;AACF"}
+{"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/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"));
@@ -84,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

package/src/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiStorefrontOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nconst PosConsolePage = lazy(() => import('./components/console/pos-page.component'))\n/** The customer display (AGL-3608): loads only on the public page that shows it. */\nconst PosDisplayPage = lazy(() => import('./components/console/pos-display-page.component'))\nconst CommerceGlanceCard = lazy(\n  () => import('./components/console/commerce-glance-card.component'),\n)\nconst NewestSiteUsersCard = lazy(\n  () => import('./components/console/newest-site-users-card.component'),\n)\nconst SiteMemberPurchases = lazy(\n  () => import('./components/console/site-member-purchases.component'),\n)\nimport { COMMERCE_CONSOLE_SECTIONS } from './components/commerce-console-sections'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { COMMERCE_PERMISSIONS } from './model/plugin-permissions'\nimport { registerCommerceRecordLists } from './model/commerce-record-lists'\nimport { registerCommerceRecordRoutes } from './model/commerce-record-routes'\nimport { registerCommerceZones } from './components/console/product-zones'\nimport { registerCommerceOrderZones } from './components/console/order-zones'\nimport { registerCommerceReturnZones } from './components/console/return-zones'\nimport { registerCommerceStoreZones } from './components/console/store-zones'\nimport { registerCommercePosZones } from './components/console/pos-zones'\nimport { registerCommerceTransferUi } from './transfer/register-transfer-ui'\nimport { COMMERCE_SEARCH_SOURCES } from './model/commerce-search-sources'\nimport { COMMERCE_CONFIG_SCHEMA } from './plugin-config'\n\n/** Code-split: the Products console page only loads when opened. */\nconst CommerceConsolePage = lazy(() => import('./components/commerce-console-page'))\n\n/**\n * Console half (AGL-395): registers the Products nav item in the\n * ConsoleExtension registry so the commerce console surface is owned by the\n * plugin, like events and email. The page body still lives in the console\n * app (`/[hostId]/products`): its product editor depends on the app's media\n * browser, which transitively pulls in the org/session context, so a full\n * body relocation needs a plugin-consumable media-picker context first —\n * tracked as follow-up. The nav item omits a `Component`, so the shell's\n * nav renders the link and the existing named route serves the page.\n */\nexport function registerCommerceConsole(): void {\n  // Where a product is read, for surfaces outside this plugin (AGL-3080).\n  registerCommerceRecordRoutes()\n  registerCommerceRecordLists()\n  // The zones its product editor, products hub and CSV import dialog host,\n  // with the props each hands a widget (AGL-2916, AGL-3080).\n  registerCommerceZones()\n  // …and the order dialog's two (AGL-3611), where a shipping plugin's widget\n  // buys a label and records the shipment through the dialog's own route.\n  registerCommerceOrderZones()\n  // …and the return dialog's (AGL-3611), where a shipping plugin's widget\n  // buys the buyer a return label and attaches it through this plugin's route.\n  registerCommerceReturnZones()\n  // The orders list's bulk actions and the store's Settings (AGL-3612).\n  registerCommerceStoreZones()\n  // The register's orders from other channels — a delivery app's (AGL-3644).\n  registerCommercePosZones()\n  // Its import and export resources' names and the products wizard's own\n  // step (AGL-3531); the server halves register from the console's server\n  // declarations.\n  registerCommerceTransferUi()\n  // Plugin-declared permissions (AGL-435): tier defaults ride every\n  // resolved role set; custom roles override key-by-key.\n  Aglyn.registerPluginPermissions(COMMERCE_PERMISSIONS)\n  // Register discount ceiling (AGL-2161) — the generic settings card renders\n  // it from this schema, so there is no bespoke UI to keep in sync.\n  Aglyn.registerPluginConfigSchema(COMMERCE_CONFIG_SCHEMA)\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Commerce',\n    searchSources: COMMERCE_SEARCH_SOURCES,\n    // The screen a register turns toward its customer (AGL-3608), at\n    // `/kiosk/commerce/pos-display`. No staff session: the device proves\n    // itself with the display token it got by pairing, and\n    // `server/pos-display.ts` refuses every read without one.\n    publicPages: [\n      { path: '/pos-display', title: 'Customer display', Component: PosDisplayPage },\n    ],\n    // Dashboard/analytics glance card (AGL-419): rendered through the\n    // shell's 'commerceGlance' widget slot.\n    widgets: [\n      {\n        slot: 'commerceGlance',\n        widgetId: 'commerce-glance',\n        title: 'Commerce',\n        Component: CommerceGlanceCard,\n      },\n      // What a site user bought — lifetime total, orders and subscriptions —\n      // in their drawer on the site's Users page: the orders and\n      // subscriptions are this plugin's.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.siteMember,\n        widgetId: 'commerce-site-member-purchases',\n        title: 'Purchases',\n        Component: SiteMemberPurchases,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Products',\n        href: '/products',\n        icon: { path: mdiStorefrontOutline.path },\n        // Sections as ROUTES (AGL-2501): `/products/orders` and friends are\n        // real URLs the shell resolves and gates, so the page mounts the one\n        // being read instead of subscribing all six.\n        sections: COMMERCE_CONSOLE_SECTIONS,\n        header: {\n          title: 'Products',\n          icon: { path: mdiStorefrontOutline.path },\n          // The overview, not `catalog`: this surface is the whole commerce\n          // console — Catalog, Orders, Promotions and Reservations.\n          docsTopic: 'commerce',\n        },\n        Component: CommerceConsolePage,\n      },\n      {\n        // POS register (AGL-312/419): relocated from the app's /pos route —\n        // the generic [pluginSlug] shell now serves it at the same URL.\n        label: 'POS',\n        href: '/pos',\n        /*\n         * WHO may open the register, declared on THIS nav item rather than on\n         * the extension.\n         *\n         * A key here narrows one surface; a key on the extension would gate\n         * every surface it registers, and Products is the sibling — a catalog\n         * anyone who works on the site may open. The register is the one that\n         * takes money and lists checked-in guests by name, so the two\n         * genuinely have different answers and only this one is narrowed.\n         *\n         * `managePos` rather than a dotted catalog key because it is the key\n         * the sale itself is refused by: `server/pos-order.ts` resolves the\n         * member's permission map and returns 403 unless `managePos` holds.\n         * The shell answers this declaration out of that same resolved map, so\n         * the console offers a register exactly to the people the route will\n         * accept a sale from — the gate and its server twin cannot disagree,\n         * because they are reading one value.\n         *\n         * `pos-order.ts` stays the enforcement point regardless. This decides\n         * whether the surface is built at all, which is the part a check\n         * inside the page cannot do: by the time the page can refuse itself it\n         * has mounted and its product, register, location and reservation\n         * listeners are already open.\n         */\n        permission: 'managePos',\n        icon: { path: mdiStorefrontOutline.path },\n        header: { title: 'Point of Sale', docsTopic: 'pos' },\n        Component: PosConsolePage,\n      },\n    ],\n  })\n  /*\n   * The USER ACCOUNTS half, registered under its own id.\n   *\n   * `accounts` is a switch rather than a bundle: the member blocks and every\n   * `membership/*` handler ship inside this package, which is why the id\n   * carries no loader manifest entry of its own. A second extension is how a\n   * card about visitor accounts is gated on the switch that decides whether\n   * the site serves them — `listConsoleWidgets` filters by the workspace's\n   * effective plugin ids, and `accounts` is default-OFF per site.\n   *\n   * A separate call rather than more widgets on the commerce extension: the\n   * registry is keyed by `pluginId` and that key IS the gate, so folding this\n   * card in above would have kept the dashboard defect it fixes — `Newest\n   * site users` on a site whose /signin returns 404.\n   */\n  Aglyn.registerConsoleExtension({\n    pluginId: Aglyn.ACCOUNTS_PLUGIN_ID,\n    displayName: 'User Accounts',\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        widgetId: 'accounts-newest-site-users',\n        title: 'Newest site users',\n        Component: NewestSiteUsersCard,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","mdiStorefrontOutline","lazy","PosConsolePage","PosDisplayPage","CommerceGlanceCard","NewestSiteUsersCard","SiteMemberPurchases","COMMERCE_CONSOLE_SECTIONS","BUNDLE_ID","COMMERCE_PERMISSIONS","registerCommerceRecordLists","registerCommerceRecordRoutes","registerCommerceZones","registerCommerceOrderZones","registerCommerceReturnZones","registerCommerceStoreZones","registerCommercePosZones","registerCommerceTransferUi","COMMERCE_SEARCH_SOURCES","COMMERCE_CONFIG_SCHEMA","CommerceConsolePage","registerCommerceConsole","registerPluginPermissions","registerPluginConfigSchema","registerConsoleExtension","pluginId","displayName","searchSources","publicPages","path","title","Component","widgets","slot","widgetId","CONSOLE_WIDGET_SLOTS","siteMember","navItems","label","href","icon","sections","header","docsTopic","permission","ACCOUNTS_PLUGIN_ID","hostDashboard"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiStorefrontOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nconst PosConsolePage = lazy(() => import('./components/console/pos-page.component'))\n/** The customer display (AGL-3608): loads only on the public page that shows it. */\nconst PosDisplayPage = lazy(() => import('./components/console/pos-display-page.component'))\nconst PosKioskPage = lazy(() => import('./components/console/pos-kiosk-page.component'))\nconst CommerceGlanceCard = lazy(\n  () => import('./components/console/commerce-glance-card.component'),\n)\nconst NewestSiteUsersCard = lazy(\n  () => import('./components/console/newest-site-users-card.component'),\n)\nconst SiteMemberPurchases = lazy(\n  () => import('./components/console/site-member-purchases.component'),\n)\nimport { COMMERCE_CONSOLE_SECTIONS } from './components/commerce-console-sections'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { COMMERCE_PERMISSIONS } from './model/plugin-permissions'\nimport { registerCommerceRecordLists } from './model/commerce-record-lists'\nimport { registerCommerceRecordRoutes } from './model/commerce-record-routes'\nimport { registerCommerceZones } from './components/console/product-zones'\nimport { registerCommerceOrderZones } from './components/console/order-zones'\nimport { registerCommerceReturnZones } from './components/console/return-zones'\nimport { registerCommerceStoreZones } from './components/console/store-zones'\nimport { registerCommercePosZones } from './components/console/pos-zones'\nimport { registerCommerceTransferUi } from './transfer/register-transfer-ui'\nimport { COMMERCE_SEARCH_SOURCES } from './model/commerce-search-sources'\nimport { COMMERCE_CONFIG_SCHEMA } from './plugin-config'\n\n/** Code-split: the Products console page only loads when opened. */\nconst CommerceConsolePage = lazy(() => import('./components/commerce-console-page'))\n\n/**\n * Console half (AGL-395): registers the Products nav item in the\n * ConsoleExtension registry so the commerce console surface is owned by the\n * plugin, like events and email. The page body still lives in the console\n * app (`/[hostId]/products`): its product editor depends on the app's media\n * browser, which transitively pulls in the org/session context, so a full\n * body relocation needs a plugin-consumable media-picker context first —\n * tracked as follow-up. The nav item omits a `Component`, so the shell's\n * nav renders the link and the existing named route serves the page.\n */\nexport function registerCommerceConsole(): void {\n  // Where a product is read, for surfaces outside this plugin (AGL-3080).\n  registerCommerceRecordRoutes()\n  registerCommerceRecordLists()\n  // The zones its product editor, products hub and CSV import dialog host,\n  // with the props each hands a widget (AGL-2916, AGL-3080).\n  registerCommerceZones()\n  // …and the order dialog's two (AGL-3611), where a shipping plugin's widget\n  // buys a label and records the shipment through the dialog's own route.\n  registerCommerceOrderZones()\n  // …and the return dialog's (AGL-3611), where a shipping plugin's widget\n  // buys the buyer a return label and attaches it through this plugin's route.\n  registerCommerceReturnZones()\n  // The orders list's bulk actions and the store's Settings (AGL-3612).\n  registerCommerceStoreZones()\n  // The register's orders from other channels — a delivery app's (AGL-3644).\n  registerCommercePosZones()\n  // Its import and export resources' names and the products wizard's own\n  // step (AGL-3531); the server halves register from the console's server\n  // declarations.\n  registerCommerceTransferUi()\n  // Plugin-declared permissions (AGL-435): tier defaults ride every\n  // resolved role set; custom roles override key-by-key.\n  Aglyn.registerPluginPermissions(COMMERCE_PERMISSIONS)\n  // Register discount ceiling (AGL-2161) — the generic settings card renders\n  // it from this schema, so there is no bespoke UI to keep in sync.\n  Aglyn.registerPluginConfigSchema(COMMERCE_CONFIG_SCHEMA)\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Commerce',\n    searchSources: COMMERCE_SEARCH_SOURCES,\n    // The screen a register turns toward its customer (AGL-3608), at\n    // `/kiosk/commerce/pos-display`. No staff session: the device proves\n    // itself with the display token it got by pairing, and\n    // `server/pos-display.ts` refuses every read without one.\n    publicPages: [\n      { path: '/pos-display', title: 'Customer display', Component: PosDisplayPage },\n      // The self-service kiosk (AGL-3623), paired the same way with a kiosk\n      // code; `server/pos-kiosk.ts` refuses every call without its token.\n      { path: '/pos-kiosk', title: 'Self-service kiosk', Component: PosKioskPage },\n    ],\n    // Dashboard/analytics glance card (AGL-419): rendered through the\n    // shell's 'commerceGlance' widget slot.\n    widgets: [\n      {\n        slot: 'commerceGlance',\n        widgetId: 'commerce-glance',\n        title: 'Commerce',\n        Component: CommerceGlanceCard,\n      },\n      // What a site user bought — lifetime total, orders and subscriptions —\n      // in their drawer on the site's Users page: the orders and\n      // subscriptions are this plugin's.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.siteMember,\n        widgetId: 'commerce-site-member-purchases',\n        title: 'Purchases',\n        Component: SiteMemberPurchases,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Products',\n        href: '/products',\n        icon: { path: mdiStorefrontOutline.path },\n        // Sections as ROUTES (AGL-2501): `/products/orders` and friends are\n        // real URLs the shell resolves and gates, so the page mounts the one\n        // being read instead of subscribing all six.\n        sections: COMMERCE_CONSOLE_SECTIONS,\n        header: {\n          title: 'Products',\n          icon: { path: mdiStorefrontOutline.path },\n          // The overview, not `catalog`: this surface is the whole commerce\n          // console — Catalog, Orders, Promotions and Reservations.\n          docsTopic: 'commerce',\n        },\n        Component: CommerceConsolePage,\n      },\n      {\n        // POS register (AGL-312/419): relocated from the app's /pos route —\n        // the generic [pluginSlug] shell now serves it at the same URL.\n        label: 'POS',\n        href: '/pos',\n        /*\n         * WHO may open the register, declared on THIS nav item rather than on\n         * the extension.\n         *\n         * A key here narrows one surface; a key on the extension would gate\n         * every surface it registers, and Products is the sibling — a catalog\n         * anyone who works on the site may open. The register is the one that\n         * takes money and lists checked-in guests by name, so the two\n         * genuinely have different answers and only this one is narrowed.\n         *\n         * `managePos` rather than a dotted catalog key because it is the key\n         * the sale itself is refused by: `server/pos-order.ts` resolves the\n         * member's permission map and returns 403 unless `managePos` holds.\n         * The shell answers this declaration out of that same resolved map, so\n         * the console offers a register exactly to the people the route will\n         * accept a sale from — the gate and its server twin cannot disagree,\n         * because they are reading one value.\n         *\n         * `pos-order.ts` stays the enforcement point regardless. This decides\n         * whether the surface is built at all, which is the part a check\n         * inside the page cannot do: by the time the page can refuse itself it\n         * has mounted and its product, register, location and reservation\n         * listeners are already open.\n         */\n        permission: 'managePos',\n        icon: { path: mdiStorefrontOutline.path },\n        header: { title: 'Point of Sale', docsTopic: 'pos' },\n        Component: PosConsolePage,\n      },\n    ],\n  })\n  /*\n   * The USER ACCOUNTS half, registered under its own id.\n   *\n   * `accounts` is a switch rather than a bundle: the member blocks and every\n   * `membership/*` handler ship inside this package, which is why the id\n   * carries no loader manifest entry of its own. A second extension is how a\n   * card about visitor accounts is gated on the switch that decides whether\n   * the site serves them — `listConsoleWidgets` filters by the workspace's\n   * effective plugin ids, and `accounts` is default-OFF per site.\n   *\n   * A separate call rather than more widgets on the commerce extension: the\n   * registry is keyed by `pluginId` and that key IS the gate, so folding this\n   * card in above would have kept the dashboard defect it fixes — `Newest\n   * site users` on a site whose /signin returns 404.\n   */\n  Aglyn.registerConsoleExtension({\n    pluginId: Aglyn.ACCOUNTS_PLUGIN_ID,\n    displayName: 'User Accounts',\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        widgetId: 'accounts-newest-site-users',\n        title: 'Newest site users',\n        Component: NewestSiteUsersCard,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","mdiStorefrontOutline","lazy","PosConsolePage","PosDisplayPage","PosKioskPage","CommerceGlanceCard","NewestSiteUsersCard","SiteMemberPurchases","COMMERCE_CONSOLE_SECTIONS","BUNDLE_ID","COMMERCE_PERMISSIONS","registerCommerceRecordLists","registerCommerceRecordRoutes","registerCommerceZones","registerCommerceOrderZones","registerCommerceReturnZones","registerCommerceStoreZones","registerCommercePosZones","registerCommerceTransferUi","COMMERCE_SEARCH_SOURCES","COMMERCE_CONFIG_SCHEMA","CommerceConsolePage","registerCommerceConsole","registerPluginPermissions","registerPluginConfigSchema","registerConsoleExtension","pluginId","displayName","searchSources","publicPages","path","title","Component","widgets","slot","widgetId","CONSOLE_WIDGET_SLOTS","siteMember","navItems","label","href","icon","sections","header","docsTopic","permission","ACCOUNTS_PLUGIN_ID","hostDashboard"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,oBAAoB,QAAQ,yBAAwB;AAC7D,SAASC,IAAI,QAAQ,QAAO;AAC5B,MAAMC,iBAAiBD,KAAK,IAAM,MAAM,CAAC;AACzC,kFAAkF,GAClF,MAAME,iBAAiBF,KAAK,IAAM,MAAM,CAAC;AACzC,MAAMG,eAAeH,KAAK,IAAM,MAAM,CAAC;AACvC,MAAMI,qBAAqBJ,KACzB,IAAM,MAAM,CAAC;AAEf,MAAMK,sBAAsBL,KAC1B,IAAM,MAAM,CAAC;AAEf,MAAMM,sBAAsBN,KAC1B,IAAM,MAAM,CAAC;AAEf,SAASO,yBAAyB,QAAQ,4CAAwC;AAClF,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,oBAAoB,QAAQ,gCAA4B;AACjE,SAASC,2BAA2B,QAAQ,mCAA+B;AAC3E,SAASC,4BAA4B,QAAQ,oCAAgC;AAC7E,SAASC,qBAAqB,QAAQ,wCAAoC;AAC1E,SAASC,0BAA0B,QAAQ,sCAAkC;AAC7E,SAASC,2BAA2B,QAAQ,uCAAmC;AAC/E,SAASC,0BAA0B,QAAQ,sCAAkC;AAC7E,SAASC,wBAAwB,QAAQ,oCAAgC;AACzE,SAASC,0BAA0B,QAAQ,qCAAiC;AAC5E,SAASC,uBAAuB,QAAQ,qCAAiC;AACzE,SAASC,sBAAsB,QAAQ,qBAAiB;AAExD,kEAAkE,GAClE,MAAMC,sBAAsBpB,KAAK,IAAM,MAAM,CAAC;AAE9C;;;;;;;;;CASC,GACD,OAAO,SAASqB;IACd,wEAAwE;IACxEV;IACAD;IACA,yEAAyE;IACzE,2DAA2D;IAC3DE;IACA,2EAA2E;IAC3E,wEAAwE;IACxEC;IACA,wEAAwE;IACxE,6EAA6E;IAC7EC;IACA,sEAAsE;IACtEC;IACA,2EAA2E;IAC3EC;IACA,uEAAuE;IACvE,wEAAwE;IACxE,gBAAgB;IAChBC;IACA,kEAAkE;IAClE,uDAAuD;IACvDnB,MAAMwB,yBAAyB,CAACb;IAChC,2EAA2E;IAC3E,kEAAkE;IAClEX,MAAMyB,0BAA0B,CAACJ;IACjCrB,MAAM0B,wBAAwB,CAAC;QAC7BC,UAAUjB;QACVkB,aAAa;QACbC,eAAeT;QACf,iEAAiE;QACjE,qEAAqE;QACrE,uDAAuD;QACvD,0DAA0D;QAC1DU,aAAa;YACX;gBAAEC,MAAM;gBAAgBC,OAAO;gBAAoBC,WAAW7B;YAAe;YAC7E,sEAAsE;YACtE,oEAAoE;YACpE;gBAAE2B,MAAM;gBAAcC,OAAO;gBAAsBC,WAAW5B;YAAa;SAC5E;QACD,kEAAkE;QAClE,wCAAwC;QACxC6B,SAAS;YACP;gBACEC,MAAM;gBACNC,UAAU;gBACVJ,OAAO;gBACPC,WAAW3B;YACb;YACA,uEAAuE;YACvE,2DAA2D;YAC3D,mCAAmC;YACnC;gBACE6B,MAAMnC,MAAMqC,oBAAoB,CAACC,UAAU;gBAC3CF,UAAU;gBACVJ,OAAO;gBACPC,WAAWzB;YACb;SACD;QACD+B,UAAU;YACR;gBACEC,OAAO;gBACPC,MAAM;gBACNC,MAAM;oBAAEX,MAAM9B,qBAAqB8B,IAAI;gBAAC;gBACxC,oEAAoE;gBACpE,qEAAqE;gBACrE,6CAA6C;gBAC7CY,UAAUlC;gBACVmC,QAAQ;oBACNZ,OAAO;oBACPU,MAAM;wBAAEX,MAAM9B,qBAAqB8B,IAAI;oBAAC;oBACxC,kEAAkE;oBAClE,0DAA0D;oBAC1Dc,WAAW;gBACb;gBACAZ,WAAWX;YACb;YACA;gBACE,oEAAoE;gBACpE,gEAAgE;gBAChEkB,OAAO;gBACPC,MAAM;gBACN;;;;;;;;;;;;;;;;;;;;;;;SAuBC,GACDK,YAAY;gBACZJ,MAAM;oBAAEX,MAAM9B,qBAAqB8B,IAAI;gBAAC;gBACxCa,QAAQ;oBAAEZ,OAAO;oBAAiBa,WAAW;gBAAM;gBACnDZ,WAAW9B;YACb;SACD;IACH;IACA;;;;;;;;;;;;;;GAcC,GACDH,MAAM0B,wBAAwB,CAAC;QAC7BC,UAAU3B,MAAM+C,kBAAkB;QAClCnB,aAAa;QACbM,SAAS;YACP;gBACEC,MAAMnC,MAAMqC,oBAAoB,CAACW,aAAa;gBAC9CZ,UAAU;gBACVJ,OAAO;gBACPC,WAAW1B;YACb;SACD;IACH;AACF;AAEA,cAAc,YAAQ"}

package/src/lib/pos-kiosk-config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 { PluginConfigField } from '@aglyn/aglyn';
+export declare const POS_KIOSK_CONFIG_FIELDS: PluginConfigField[];
+export declare const POS_KIOSK_CONFIG_DEFAULTS: Record<string, unknown>;
+export interface PosKioskSettings {
+    payAtCounter: boolean;
+    idleSeconds: number;
+    welcome: string;
+}
+/** Read defensively, for a config read with or without the schema. */
+export declare function posKioskSettings(config: Record<string, unknown> | null | undefined): PosKioskSettings;

package/src/lib/pos-kiosk-config.js

@@ -0,0 +1,59 @@
+/**
+ * @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 { POS_KIOSK_IDLE_SECONDS_DEFAULT, POS_KIOSK_IDLE_SECONDS_MAX, POS_KIOSK_IDLE_SECONDS_MIN, posKioskIdleSeconds } from "./model/commerce-pos-kiosk.js";
+/*==========================================
+ * THE SELF-SERVICE KIOSK'S SETTINGS (AGL-3623). Pure data, spread into
+ * `COMMERCE_CONFIG_SCHEMA` beside the register's own, so the settings form,
+ * the kiosk route and the kiosk read one set of keys with one set of bounds.
+ * Tips and receipts are the register's settings: a kiosk asks for a tip
+ * exactly when the register does.
+ *=========================================*/ export const POS_KIOSK_CONFIG_FIELDS = [
+    {
+        key: 'posKioskPayAtCounter',
+        label: 'Kiosk: let customers pay at the counter',
+        type: 'boolean',
+        description: 'Adds "Pay at counter" to the self-service kiosk. The order goes to the ' + 'register’s queue with its number, and a cashier takes payment there.'
+    },
+    {
+        key: 'posKioskIdleSeconds',
+        label: 'Kiosk: start over after (seconds idle)',
+        type: 'number',
+        min: POS_KIOSK_IDLE_SECONDS_MIN,
+        max: POS_KIOSK_IDLE_SECONDS_MAX,
+        description: 'After this long without a touch the kiosk asks "Still there?", then ' + 'clears the cart and anything the customer typed.'
+    },
+    {
+        key: 'posKioskWelcome',
+        label: 'Kiosk welcome',
+        type: 'string',
+        description: 'The line the kiosk’s start screen shows under your store name. Leave blank for "Order here".'
+    }
+];
+export const POS_KIOSK_CONFIG_DEFAULTS = {
+    posKioskPayAtCounter: true,
+    posKioskIdleSeconds: POS_KIOSK_IDLE_SECONDS_DEFAULT,
+    posKioskWelcome: ''
+};
+/** Read defensively, for a config read with or without the schema. */ export function posKioskSettings(config) {
+    var _ref;
+    return {
+        payAtCounter: (config == null ? void 0 : config['posKioskPayAtCounter']) !== false,
+        idleSeconds: posKioskIdleSeconds(config == null ? void 0 : config['posKioskIdleSeconds']),
+        welcome: String((_ref = config == null ? void 0 : config['posKioskWelcome']) != null ? _ref : '').trim().slice(0, 120)
+    };
+}
+
+//# sourceMappingURL=pos-kiosk-config.js.map

package/src/lib/pos-kiosk-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/pos-kiosk-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 { PluginConfigField } from '@aglyn/aglyn'\nimport {\n  POS_KIOSK_IDLE_SECONDS_DEFAULT,\n  POS_KIOSK_IDLE_SECONDS_MAX,\n  POS_KIOSK_IDLE_SECONDS_MIN,\n  posKioskIdleSeconds,\n} from './model/commerce-pos-kiosk'\n\n/*==========================================\n * THE SELF-SERVICE KIOSK'S SETTINGS (AGL-3623). Pure data, spread into\n * `COMMERCE_CONFIG_SCHEMA` beside the register's own, so the settings form,\n * the kiosk route and the kiosk read one set of keys with one set of bounds.\n * Tips and receipts are the register's settings: a kiosk asks for a tip\n * exactly when the register does.\n *=========================================*/\n\nexport const POS_KIOSK_CONFIG_FIELDS: PluginConfigField[] = [\n  {\n    key: 'posKioskPayAtCounter',\n    label: 'Kiosk: let customers pay at the counter',\n    type: 'boolean',\n    description:\n      'Adds \"Pay at counter\" to the self-service kiosk. The order goes to the ' +\n      'register’s queue with its number, and a cashier takes payment there.',\n  },\n  {\n    key: 'posKioskIdleSeconds',\n    label: 'Kiosk: start over after (seconds idle)',\n    type: 'number',\n    min: POS_KIOSK_IDLE_SECONDS_MIN,\n    max: POS_KIOSK_IDLE_SECONDS_MAX,\n    description:\n      'After this long without a touch the kiosk asks \"Still there?\", then ' +\n      'clears the cart and anything the customer typed.',\n  },\n  {\n    key: 'posKioskWelcome',\n    label: 'Kiosk welcome',\n    type: 'string',\n    description: 'The line the kiosk’s start screen shows under your store name. Leave blank for \"Order here\".',\n  },\n]\n\nexport const POS_KIOSK_CONFIG_DEFAULTS: Record<string, unknown> = {\n  posKioskPayAtCounter: true,\n  posKioskIdleSeconds: POS_KIOSK_IDLE_SECONDS_DEFAULT,\n  posKioskWelcome: '',\n}\n\nexport interface PosKioskSettings {\n  payAtCounter: boolean\n  idleSeconds: number\n  welcome: string\n}\n\n/** Read defensively, for a config read with or without the schema. */\nexport function posKioskSettings(config: Record<string, unknown> | null | undefined): PosKioskSettings {\n  return {\n    payAtCounter: config?.['posKioskPayAtCounter'] !== false,\n    idleSeconds: posKioskIdleSeconds(config?.['posKioskIdleSeconds']),\n    welcome: String(config?.['posKioskWelcome'] ?? '').trim().slice(0, 120),\n  }\n}\n"],"names":["POS_KIOSK_IDLE_SECONDS_DEFAULT","POS_KIOSK_IDLE_SECONDS_MAX","POS_KIOSK_IDLE_SECONDS_MIN","posKioskIdleSeconds","POS_KIOSK_CONFIG_FIELDS","key","label","type","description","min","max","POS_KIOSK_CONFIG_DEFAULTS","posKioskPayAtCounter","posKioskWelcome","posKioskSettings","config","payAtCounter","idleSeconds","welcome","String","trim","slice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SACEA,8BAA8B,EAC9BC,0BAA0B,EAC1BC,0BAA0B,EAC1BC,mBAAmB,QACd,gCAA4B;AAEnC;;;;;;2CAM2C,GAE3C,OAAO,MAAMC,0BAA+C;IAC1D;QACEC,KAAK;QACLC,OAAO;QACPC,MAAM;QACNC,aACE,4EACA;IACJ;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNE,KAAKP;QACLQ,KAAKT;QACLO,aACE,yEACA;IACJ;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNC,aAAa;IACf;CACD,CAAA;AAED,OAAO,MAAMG,4BAAqD;IAChEC,sBAAsB;IACtBT,qBAAqBH;IACrBa,iBAAiB;AACnB,EAAC;AAQD,oEAAoE,GACpE,OAAO,SAASC,iBAAiBC,MAAkD;;IACjF,OAAO;QACLC,cAAcD,CAAAA,0BAAAA,MAAQ,CAAC,uBAAuB,MAAK;QACnDE,aAAad,oBAAoBY,0BAAAA,MAAQ,CAAC,sBAAsB;QAChEG,SAASC,eAAOJ,0BAAAA,MAAQ,CAAC,kBAAkB,mBAAI,IAAIK,IAAI,GAAGC,KAAK,CAAC,GAAG;IACrE;AACF"}

package/src/lib/server/api-v1/openapi.js

@@ -165,6 +165,14 @@ export const ORDERS_API_V1_DESCRIPTION = {
                 additionalProperties: true
             }
         },
+        credits: {
+            type: 'array',
+            description: 'Store credit another plugin kept that paid part of the sale, such as rewards: `[{ providerId, pluginId, reference, label, last4, amountCents, appliedAs }]`. `appliedAs` is `discount` for a checkout redemption and `tender` for a register payment. Empty when there were none.',
+            items: {
+                type: 'object',
+                additionalProperties: true
+            }
+        },
         refundedCents: int('Amount refunded so far.'),
         disputed: bool('Whether a chargeback is open.'),
         taxMode: nullable(str('The tax regime: `stripe-automatic` (Stripe Tax, collected and remitted by the platform as marketplace facilitator), `manual` (your own rate) or `none`. `null` on an order from before it was recorded.')),

package/src/lib/server/api-v1/openapi.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/server/api-v1/openapi.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  type ApiV1ResourceDescription,\n  booleanField as bool,\n  integerField as int,\n  nullableField as nullable,\n  objectKindField as OBJECT_FIELD,\n  openObjectField as objectOf,\n  postalAddressField as ADDRESS,\n  queryParam as q,\n  RECORD_STAMPS as STAMPS,\n  stringField as str,\n  stringListField as strList,\n} from '@aglyn/tenant-data-admin/server/api-v1-description'\n\n/**\n * A site's products and orders as the customer API's OpenAPI document\n * describes them — what the console's builder turns into paths, tags and\n * schemas, and the MCP tools derive from. Transcribed unchanged from the\n * builder's own list when the resources moved here (AGL-3080);\n * `api-v1-openapi.spec.ts` holds the document to every endpoint the\n * documentation promises.\n */\nexport const PRODUCTS_API_V1_DESCRIPTION: ApiV1ResourceDescription = {\n  tag: 'Products',\n  description: 'A site’s catalog. Read-only over the API.',\n  schemaName: 'Product',\n  required: ['id', 'object', 'name'],\n  fields: {\n    id: str('Product id.'),\n    object: OBJECT_FIELD('product'),\n    name: str('Product name.'),\n    slug: str('URL slug.'),\n    description: nullable(str('Description.')),\n    type: str('Product type.'),\n    status: str('Publication status.'),\n    tags: strList('Free-form tags.'),\n    categoryIds: strList('Categories this product belongs to.'),\n    mediaUrls: strList('Image URLs.'),\n    options: { type: 'array', description: 'Option definitions, e.g. size.', items: { type: 'object', additionalProperties: true } },\n    variants: { type: 'array', description: 'Purchasable variants.', items: { type: 'object', additionalProperties: true } },\n    inventory: nullable(int('Stock on hand, when tracked.')),\n    subscription: nullable(objectOf('Subscription terms, when the product is one.')),\n    ...STAMPS,\n  },\n  ops: [\n    { path: '/v1/sites/{siteId}/products', method: 'get', operationId: 'listProducts', summary: 'List products', list: true, returns: 'Product', description: 'Rows deleted since they were written are dropped after the read, so pages can come back short.', pathParams: [{ name: 'siteId', description: 'Site id.' }] },\n    { path: '/v1/sites/{siteId}/products/{productId}', method: 'get', operationId: 'getProduct', summary: 'Retrieve a product', returns: 'Product', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'productId', description: 'Product id.' }] },\n  ],\n}\n\nexport const ORDERS_API_V1_DESCRIPTION: ApiV1ResourceDescription = {\n  tag: 'Orders',\n  description: 'A site’s orders. Status moves are constrained.',\n  schemaName: 'Order',\n  required: ['id', 'object', 'number', 'status'],\n  writable: ['status', 'carrier', 'trackingNumber', 'trackingUrl', 'lineItems', 'notify'],\n  writeOnly: {\n    status: { type: 'string', enum: ['fulfilled', 'delivered'], description: 'The status to move the order to.' },\n    carrier: str('Free text, e.g. `UPS`. Trimmed to 40 characters. USPS, UPS, FedEx, DHL, Canada Post, Royal Mail and Australia Post get a tracking link.'),\n    trackingNumber: str('Free text. Trimmed to 60 characters.'),\n    trackingUrl: str('An https tracking link, for a carrier the link is not derived for.'),\n    lineItems: {\n      type: 'array',\n      description:\n        'With `status: fulfilled`, the units this shipment covers: `[{ lineItemId, quantity }]`, where `lineItemId` is the line’s index. Omitted, the shipment covers everything still to ship. More than is left is `409 conflict` (`code: \"over_fulfilled\"`). Send an `Idempotency-Key` header so a retried partial shipment is recorded once.',\n      items: { type: 'object', additionalProperties: true },\n    },\n    notify: bool('Whether the buyer is told about this shipment. Defaults to true.'),\n  },\n  writeRequired: ['status'],\n  fields: {\n    id: str('Order id.'),\n    object: OBJECT_FIELD('order'),\n    number: int('Human-facing order number.'),\n    status: str('Order status.'),\n    channel: str('`online` by default. Older orders carry no stored value, so `?channel=online` drops them after the read.'),\n    currency: str('ISO 4217 code.'),\n    customerEmail: nullable(str('Customer email.')),\n    customerName: nullable(str('Customer name.')),\n    lineItems: { type: 'array', description: 'What was bought.', items: { type: 'object', additionalProperties: true } },\n    totals: objectOf('Money totals, in the smallest unit of `currency`. `extrasCents` is the optional lines the buyer added at checkout, inside `totalCents` and outside `itemsCents`.'),\n    extras: { type: 'array', description: 'Optional lines the buyer added at checkout, such as package protection: `[{ id, pluginId, key, label, amountCents, quoteRef }]`. Empty when there were none.', items: { type: 'object', additionalProperties: true } },\n    refundedCents: int('Amount refunded so far.'),\n    disputed: bool('Whether a chargeback is open.'),\n    taxMode: nullable(str('The tax regime: `stripe-automatic` (Stripe Tax, collected and remitted by the platform as marketplace facilitator), `manual` (your own rate) or `none`. `null` on an order from before it was recorded.')),\n    taxEngine: nullable(objectOf('The tax service you connected, when one was asked for this sale’s tax: `provider` (`avalara` or `taxjar`), `providerLabel`, `status` (`quoted` when its tax was charged, `fallback` when it did not answer and your own rate was charged), `reason` (`timeout` or `error` on a fallback) and `sandbox`. `null` when no service was asked.')),\n    shippingAddress: ADDRESS(),\n    couponCode: nullable(str('Coupon applied.')),\n    fulfillments: { type: 'array', description: 'Shipments and deliveries.', items: { type: 'object', additionalProperties: true } },\n    created: STAMPS.created,\n  },\n  ops: [\n    { path: '/v1/sites/{siteId}/orders', method: 'get', operationId: 'listOrders', summary: 'List orders', list: true, returns: 'Order', filters: [q('channel', '`online` is a default rather than a stored value, so filtering on it drops older orders after the read.'), q('status', 'Order status.')], pathParams: [{ name: 'siteId', description: 'Site id.' }] },\n    { path: '/v1/sites/{siteId}/orders/{orderId}', method: 'get', operationId: 'getOrder', summary: 'Retrieve an order', returns: 'Order', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'orderId', description: 'Order id.' }] },\n    { path: '/v1/sites/{siteId}/orders/{orderId}', method: 'patch', operationId: 'updateOrder', summary: 'Move an order’s status', accepts: 'OrderWrite', returns: 'Order', description: 'An illegal transition is `409 conflict` (`code: \"order_transition\"`), and the message names the status it is in.', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'orderId', description: 'Order id.' }] },\n  ],\n}\n"],"names":["booleanField","bool","integerField","int","nullableField","nullable","objectKindField","OBJECT_FIELD","openObjectField","objectOf","postalAddressField","ADDRESS","queryParam","q","RECORD_STAMPS","STAMPS","stringField","str","stringListField","strList","PRODUCTS_API_V1_DESCRIPTION","tag","description","schemaName","required","fields","id","object","name","slug","type","status","tags","categoryIds","mediaUrls","options","items","additionalProperties","variants","inventory","subscription","ops","path","method","operationId","summary","list","returns","pathParams","ORDERS_API_V1_DESCRIPTION","writable","writeOnly","enum","carrier","trackingNumber","trackingUrl","lineItems","notify","writeRequired","number","channel","currency","customerEmail","customerName","totals","extras","refundedCents","disputed","taxMode","taxEngine","shippingAddress","couponCode","fulfillments","created","filters","accepts"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/server/api-v1/openapi.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  type ApiV1ResourceDescription,\n  booleanField as bool,\n  integerField as int,\n  nullableField as nullable,\n  objectKindField as OBJECT_FIELD,\n  openObjectField as objectOf,\n  postalAddressField as ADDRESS,\n  queryParam as q,\n  RECORD_STAMPS as STAMPS,\n  stringField as str,\n  stringListField as strList,\n} from '@aglyn/tenant-data-admin/server/api-v1-description'\n\n/**\n * A site's products and orders as the customer API's OpenAPI document\n * describes them — what the console's builder turns into paths, tags and\n * schemas, and the MCP tools derive from. Transcribed unchanged from the\n * builder's own list when the resources moved here (AGL-3080);\n * `api-v1-openapi.spec.ts` holds the document to every endpoint the\n * documentation promises.\n */\nexport const PRODUCTS_API_V1_DESCRIPTION: ApiV1ResourceDescription = {\n  tag: 'Products',\n  description: 'A site’s catalog. Read-only over the API.',\n  schemaName: 'Product',\n  required: ['id', 'object', 'name'],\n  fields: {\n    id: str('Product id.'),\n    object: OBJECT_FIELD('product'),\n    name: str('Product name.'),\n    slug: str('URL slug.'),\n    description: nullable(str('Description.')),\n    type: str('Product type.'),\n    status: str('Publication status.'),\n    tags: strList('Free-form tags.'),\n    categoryIds: strList('Categories this product belongs to.'),\n    mediaUrls: strList('Image URLs.'),\n    options: { type: 'array', description: 'Option definitions, e.g. size.', items: { type: 'object', additionalProperties: true } },\n    variants: { type: 'array', description: 'Purchasable variants.', items: { type: 'object', additionalProperties: true } },\n    inventory: nullable(int('Stock on hand, when tracked.')),\n    subscription: nullable(objectOf('Subscription terms, when the product is one.')),\n    ...STAMPS,\n  },\n  ops: [\n    { path: '/v1/sites/{siteId}/products', method: 'get', operationId: 'listProducts', summary: 'List products', list: true, returns: 'Product', description: 'Rows deleted since they were written are dropped after the read, so pages can come back short.', pathParams: [{ name: 'siteId', description: 'Site id.' }] },\n    { path: '/v1/sites/{siteId}/products/{productId}', method: 'get', operationId: 'getProduct', summary: 'Retrieve a product', returns: 'Product', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'productId', description: 'Product id.' }] },\n  ],\n}\n\nexport const ORDERS_API_V1_DESCRIPTION: ApiV1ResourceDescription = {\n  tag: 'Orders',\n  description: 'A site’s orders. Status moves are constrained.',\n  schemaName: 'Order',\n  required: ['id', 'object', 'number', 'status'],\n  writable: ['status', 'carrier', 'trackingNumber', 'trackingUrl', 'lineItems', 'notify'],\n  writeOnly: {\n    status: { type: 'string', enum: ['fulfilled', 'delivered'], description: 'The status to move the order to.' },\n    carrier: str('Free text, e.g. `UPS`. Trimmed to 40 characters. USPS, UPS, FedEx, DHL, Canada Post, Royal Mail and Australia Post get a tracking link.'),\n    trackingNumber: str('Free text. Trimmed to 60 characters.'),\n    trackingUrl: str('An https tracking link, for a carrier the link is not derived for.'),\n    lineItems: {\n      type: 'array',\n      description:\n        'With `status: fulfilled`, the units this shipment covers: `[{ lineItemId, quantity }]`, where `lineItemId` is the line’s index. Omitted, the shipment covers everything still to ship. More than is left is `409 conflict` (`code: \"over_fulfilled\"`). Send an `Idempotency-Key` header so a retried partial shipment is recorded once.',\n      items: { type: 'object', additionalProperties: true },\n    },\n    notify: bool('Whether the buyer is told about this shipment. Defaults to true.'),\n  },\n  writeRequired: ['status'],\n  fields: {\n    id: str('Order id.'),\n    object: OBJECT_FIELD('order'),\n    number: int('Human-facing order number.'),\n    status: str('Order status.'),\n    channel: str('`online` by default. Older orders carry no stored value, so `?channel=online` drops them after the read.'),\n    currency: str('ISO 4217 code.'),\n    customerEmail: nullable(str('Customer email.')),\n    customerName: nullable(str('Customer name.')),\n    lineItems: { type: 'array', description: 'What was bought.', items: { type: 'object', additionalProperties: true } },\n    totals: objectOf('Money totals, in the smallest unit of `currency`. `extrasCents` is the optional lines the buyer added at checkout, inside `totalCents` and outside `itemsCents`.'),\n    extras: { type: 'array', description: 'Optional lines the buyer added at checkout, such as package protection: `[{ id, pluginId, key, label, amountCents, quoteRef }]`. Empty when there were none.', items: { type: 'object', additionalProperties: true } },\n    credits: { type: 'array', description: 'Store credit another plugin kept that paid part of the sale, such as rewards: `[{ providerId, pluginId, reference, label, last4, amountCents, appliedAs }]`. `appliedAs` is `discount` for a checkout redemption and `tender` for a register payment. Empty when there were none.', items: { type: 'object', additionalProperties: true } },\n    refundedCents: int('Amount refunded so far.'),\n    disputed: bool('Whether a chargeback is open.'),\n    taxMode: nullable(str('The tax regime: `stripe-automatic` (Stripe Tax, collected and remitted by the platform as marketplace facilitator), `manual` (your own rate) or `none`. `null` on an order from before it was recorded.')),\n    taxEngine: nullable(objectOf('The tax service you connected, when one was asked for this sale’s tax: `provider` (`avalara` or `taxjar`), `providerLabel`, `status` (`quoted` when its tax was charged, `fallback` when it did not answer and your own rate was charged), `reason` (`timeout` or `error` on a fallback) and `sandbox`. `null` when no service was asked.')),\n    shippingAddress: ADDRESS(),\n    couponCode: nullable(str('Coupon applied.')),\n    fulfillments: { type: 'array', description: 'Shipments and deliveries.', items: { type: 'object', additionalProperties: true } },\n    created: STAMPS.created,\n  },\n  ops: [\n    { path: '/v1/sites/{siteId}/orders', method: 'get', operationId: 'listOrders', summary: 'List orders', list: true, returns: 'Order', filters: [q('channel', '`online` is a default rather than a stored value, so filtering on it drops older orders after the read.'), q('status', 'Order status.')], pathParams: [{ name: 'siteId', description: 'Site id.' }] },\n    { path: '/v1/sites/{siteId}/orders/{orderId}', method: 'get', operationId: 'getOrder', summary: 'Retrieve an order', returns: 'Order', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'orderId', description: 'Order id.' }] },\n    { path: '/v1/sites/{siteId}/orders/{orderId}', method: 'patch', operationId: 'updateOrder', summary: 'Move an order’s status', accepts: 'OrderWrite', returns: 'Order', description: 'An illegal transition is `409 conflict` (`code: \"order_transition\"`), and the message names the status it is in.', pathParams: [{ name: 'siteId', description: 'Site id.' }, { name: 'orderId', description: 'Order id.' }] },\n  ],\n}\n"],"names":["booleanField","bool","integerField","int","nullableField","nullable","objectKindField","OBJECT_FIELD","openObjectField","objectOf","postalAddressField","ADDRESS","queryParam","q","RECORD_STAMPS","STAMPS","stringField","str","stringListField","strList","PRODUCTS_API_V1_DESCRIPTION","tag","description","schemaName","required","fields","id","object","name","slug","type","status","tags","categoryIds","mediaUrls","options","items","additionalProperties","variants","inventory","subscription","ops","path","method","operationId","summary","list","returns","pathParams","ORDERS_API_V1_DESCRIPTION","writable","writeOnly","enum","carrier","trackingNumber","trackingUrl","lineItems","notify","writeRequired","number","channel","currency","customerEmail","customerName","totals","extras","credits","refundedCents","disputed","taxMode","taxEngine","shippingAddress","couponCode","fulfillments","created","filters","accepts"],"mappings":"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"}

package/src/lib/server/api-v1/order-view.d.ts

@@ -46,6 +46,15 @@ export declare function orderViewFromData(id: string, data: Record<string, any>)
         amountCents: number;
         quoteRef: string;
     }[];
+    credits: {
+        providerId: string;
+        pluginId: string;
+        reference: string;
+        label: string;
+        last4: string;
+        amountCents: number;
+        appliedAs: "discount" | "tender";
+    }[];
     refundedCents: number;
     taxMode: string;
     taxEngine: import("../../model/commerce-tax-engine").OrderTaxEngineStamp;
@@ -65,3 +74,13 @@ export declare function orderViewFromData(id: string, data: Record<string, any>)
     }[];
     created: unknown;
 };
+/** The plugin credits an order carries, online and at the register (AGL-3640). */
+export declare function orderCreditsView(data: Record<string, any>): Array<{
+    providerId: string;
+    pluginId: string;
+    reference: string;
+    label: string;
+    last4: string;
+    amountCents: number;
+    appliedAs: 'discount' | 'tender';
+}>;