@aglyn/plugins-commerce 1.0.0-beta.285 → 1.0.0-beta.287

package/src/lib/model/commerce-kiosk-offer.js

@@ -0,0 +1,35 @@
+/**
+ * @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.
+ */ /*
+ * Kept out of `commerce.ts` on purpose: that module is in commerce's eager
+ * console bundle, and only the kiosk route and the product editor, both
+ * loaded on demand, ask this.
+ */ /**
+ * Whether the self-service kiosk offers a product, or one of its variants
+ * (AGL-4038). Only an explicit `false` turns either off, so a product stored
+ * before the choice existed is offered exactly as it was. A variant is
+ * offered only when its product is: the product's choice is the outer one.
+ * Nothing here is about a kind of product — what any merchant sells is
+ * theirs to put on the kiosk or keep off it.
+ */ export function productOfferedOnKiosk(product, variantId) {
+    var _product_variants;
+    if (!product || product.offerOnKiosk === false) return false;
+    if (!variantId) return true;
+    const variant = ((_product_variants = product.variants) != null ? _product_variants : []).find((candidate)=>candidate.id === variantId);
+    return (variant == null ? void 0 : variant.offerOnKiosk) !== false;
+}
+
+//# sourceMappingURL=commerce-kiosk-offer.js.map

package/src/lib/model/commerce-kiosk-offer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-kiosk-offer.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*\n * Kept out of `commerce.ts` on purpose: that module is in commerce's eager\n * console bundle, and only the kiosk route and the product editor, both\n * loaded on demand, ask this.\n */\n\n/**\n * Whether the self-service kiosk offers a product, or one of its variants\n * (AGL-4038). Only an explicit `false` turns either off, so a product stored\n * before the choice existed is offered exactly as it was. A variant is\n * offered only when its product is: the product's choice is the outer one.\n * Nothing here is about a kind of product — what any merchant sells is\n * theirs to put on the kiosk or keep off it.\n */\nexport function productOfferedOnKiosk(\n  product: { offerOnKiosk?: unknown; variants?: ReadonlyArray<{ id: string; offerOnKiosk?: unknown }> } | null | undefined,\n  variantId?: string | null,\n): boolean {\n  if (!product || product.offerOnKiosk === false) return false\n  if (!variantId) return true\n  const variant = (product.variants ?? []).find((candidate) => candidate.id === variantId)\n  return variant?.offerOnKiosk !== false\n}\n"],"names":["productOfferedOnKiosk","product","variantId","offerOnKiosk","variant","variants","find","candidate","id"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GAED;;;;;;;CAOC,GACD,OAAO,SAASA,sBACdC,OAAwH,EACxHC,SAAyB;QAIRD;IAFjB,IAAI,CAACA,WAAWA,QAAQE,YAAY,KAAK,OAAO,OAAO;IACvD,IAAI,CAACD,WAAW,OAAO;IACvB,MAAME,UAAU,EAACH,oBAAAA,QAAQI,QAAQ,YAAhBJ,oBAAoB,EAAE,EAAEK,IAAI,CAAC,CAACC,YAAcA,UAAUC,EAAE,KAAKN;IAC9E,OAAOE,CAAAA,2BAAAA,QAASD,YAAY,MAAK;AACnC"}

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

@@ -102,6 +102,12 @@ export interface OrderLineItem {
     supplierId?: string;
     /** Fulfillment id once this line ships (AGL-288). */
     fulfillmentId?: string;
+    /**
+     * The day the buyer chose to use a check-in item (a day pass bought ahead,
+     * AGL-4043), `YYYY-MM-DD` on the store's calendar. Absent: it is due on
+     * the day the order was placed.
+     */
+    useDayKey?: string;
 }
 export interface OrderTotals {
     itemsCents: number;
@@ -380,9 +386,44 @@ export interface OrderCredit {
     amountCents: number;
     appliedAs: 'discount' | 'tender';
 }
+/**
+ * The buyer a register user attached to a sale of point of sale hardware on
+ * the platform's own store (AGL-4038): an account the lookup found and the
+ * workspace (and store, when they chose one) the hardware is for, or an
+ * address for someone with no account yet, invited to sign up.
+ */
+export interface OrderHardwareBuyer {
+    uid: string | null;
+    orgId: string | null;
+    hostId: string | null;
+    email: string | null;
+    /** The register user who attached them, and when. */
+    attachedBy: string;
+    attachedAtMs: number;
+    /**
+     * The buyer's name and business address, for the platform's reseller
+     * records (AGL-4038): the account's name, or what the register typed.
+     */
+    name?: string | null;
+    address?: {
+        line1: string;
+        line2?: string;
+        city: string;
+        state?: string;
+        postalCode: string;
+        country: string;
+    } | null;
+}
 export interface HostOrder {
     /** Human order number, sequential per host (e.g. #1042). */
     number?: number;
+    /**
+     * The distinct use days its lines name (`OrderLineItem.useDayKey`,
+     * AGL-4043), stamped by every creator through `withOrderListFields` so the
+     * window finds a pass bought ahead on the day it is for. Absent when no
+     * line names one.
+     */
+    useDayKeys?: string[];
     /** Optional lines the buyer added at checkout (AGL-3635); see {@link OrderExtra}. */
     extras?: OrderExtra[];
     /**
@@ -452,6 +493,41 @@ export interface HostOrder {
      */
     posSource?: 'kiosk';
     kioskDeviceId?: string;
+    /**
+     * A register sale on the platform's own store that sold point of sale
+     * hardware (AGL-4038): set when the sale is written, cleared once its
+     * hardware order is recorded, so a sale whose recording was missed is
+     * found again rather than lost.
+     */
+    hardwareSalePending?: boolean;
+    /** The hardware order the sale became (`orgs/{orgId}/hardwareOrders/{id}`). */
+    hardwareOrderId?: string;
+    /** Whose the sale's hardware is, as the register attached them (AGL-4038). */
+    hardwareBuyer?: OrderHardwareBuyer;
+    /**
+     * How the buyer of a register sale of hardware agreed to the terms of sale
+     * (AGL-4038, `model/pos-hardware-terms.ts`): on the tablet, on the
+     * customer display, or by the receipt-and-sign notice. The first one stands.
+     */
+    hardwareTermsAcceptance?: {
+        version: string;
+        sections: string;
+        method: 'tablet' | 'display' | 'notice';
+        atMs: number;
+        staffUid: string | null;
+        ip: string | null;
+        userAgent: string | null;
+    };
+    /** Who put the terms of sale on the customer display, and when: the acceptance names them. */
+    hardwareTermsRequest?: {
+        by: string;
+        atMs: number;
+    };
+    /**
+     * The serial numbers of the readers the sale sold, scanned or typed at the
+     * sale before its hardware order was recorded (AGL-4038), in reader order.
+     */
+    hardwareSerials?: string[];
     /**
      * Set while a kiosk order waits in its register's queue for a cashier to
      * take payment ("Pay at counter"), and when it joined.

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

@@ -22,6 +22,7 @@
  * I/O here.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { stripeIdIsTestMode } from "@aglyn/aglyn/app-utils/stripe-deployment-mode";
+import { isCheckInDayKey } from "./commerce-check-in-product.js";
 import { lineRequiresShipping, orderLineFulfillmentStates } from "./order-fulfillment.js";
 /**
  * Legal status transitions. Refund/cancel policies: anything paid can
@@ -347,11 +348,16 @@ export function computeCheckoutSessionTotals(lineItems, session, parts) {
     const goodsCents = Number((_ref2 = session == null ? void 0 : session.amount_total) != null ? _ref2 : 0) - Number((_ref3 = details == null ? void 0 : details.amount_tax) != null ? _ref3 : 0) - Number((_ref4 = details == null ? void 0 : details.amount_shipping) != null ? _ref4 : 0) - lineItemTaxCents + Number((_ref5 = details == null ? void 0 : details.amount_discount) != null ? _ref5 : 0) + pricedInDiscountCents;
     const unitAmountCents = metadataCents(metadata.unitAmountCents) || Math.max(0, Math.round(goodsCents / quantity));
     const variantId = String((_metadata_variantId = metadata.variantId) != null ? _metadata_variantId : '');
+    // The day the buyer chose to use a check-in item (AGL-4043), checked when
+    // the session was made; re-read only for its shape here.
+    const useDayKey = isCheckInDayKey(metadata.useDayKey) ? String(metadata.useDayKey) : '';
     const lineItems = [
         _extends({
             productId: String((_metadata_productId = metadata.productId) != null ? _metadata_productId : '')
         }, variantId ? {
             variantId
+        } : {}, useDayKey ? {
+            useDayKey
         } : {}, {
             name: snapshot.name
         }, snapshot.variantLabel ? {