@aglyn/plugins-commerce 1.0.0-beta.232 → 1.0.0-beta.234

package/src/lib/model/commerce-pos-offline.js

@@ -0,0 +1,301 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { computeOrderTotals } from "./commerce-orders.js";
+import { computeTaxCents } from "./commerce-tax.js";
+/*==========================================
+ * THE OFFLINE REGISTER (AGL-3625): the contract every register client — the
+ * web register and the native Aglyn POS app — shares with
+ * `POST /api/commerce/pos-offline-sync`.
+ *
+ * WHAT SELLS OFFLINE IS CASH, AND ONLY CASH.
+ *
+ *  - Card tenders cannot: the reader, Tap to Pay, the typed card and the QR
+ *    link are all server-driven Stripe payments, and Stripe does not take a
+ *    server-driven card payment without the server.
+ *  - Gift cards DO NOT, deliberately. A balance cannot be checked without the
+ *    server, and a capped "allow it anyway" (Square's offer for cards) turns a
+ *    short balance into a sale whose money nobody collected — discovered at
+ *    sync, after the customer left. Square itself does not redeem gift cards
+ *    offline. A gift card is never over-redeemed silently because it is never
+ *    redeemed offline at all.
+ *  - Room charges do not: the stay is validated on the server.
+ *  - Store credit and rewards do not, for the gift card's reason: a balance
+ *    is the server's to check.
+ *  - Codes and store promotions do not: a redemption cap is counted on the
+ *    server. The cashier's own discount, bounded by the site's ceiling, does.
+ *
+ * WHAT THE SALE IS: the register prices the basket from its cached catalog and
+ * the store's own tax rate, takes the cash and queues the sale with a key it
+ * minted. That key is the order's id on the server, so the receipt printed
+ * offline carries the barcode the real order answers to, and a sale sent twice
+ * — a flapping connection, a retry after a lost answer — lands once.
+ *
+ * WHAT THE SERVER DOES WITH IT: records it as it happened, never re-prices the
+ * money the customer handed over, and FLAGS what does not match — a price
+ * that changed, stock that went short, a shift that closed first — on the
+ * order and back to the register. A sale is never dropped for a flag.
+ *=========================================*/ /** The route both register clients sync through. */ export const POS_OFFLINE_SYNC_ROUTE = '/api/commerce/pos-offline-sync';
+/** The most sales one sync request carries; a longer queue sends in batches. */ export const POS_OFFLINE_SYNC_BATCH_MAX = 25;
+/** Lines one offline sale may carry, the same bound the register's basket has. */ export const POS_OFFLINE_SALE_MAX_LINES = 100;
+/** A sale synced later than this after it was rung is flagged `late-sync`. */ export const POS_OFFLINE_LATE_SYNC_MS = 24 * 60 * 60 * 1000;
+/**
+ * How far back a sale's own clock is believed. Older, and the server stamps
+ * the sale at this bound and flags it, rather than letting a device clock
+ * place a sale anywhere in history.
+ */ export const POS_OFFLINE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+/** How far ahead of the server a device clock may run before it is clamped. */ export const POS_OFFLINE_CLOCK_SKEW_MS = 10 * 60 * 1000;
+/** Every tender the register turns off while offline, and why, in its words. */ export const POS_OFFLINE_DISABLED_TENDERS = {
+    card_present: 'Card readers need the connection.',
+    card_keyed: 'Typed cards need the connection.',
+    card_link: 'The QR card link needs the connection.',
+    gift_card: 'A gift card balance can only be checked online.',
+    folio: 'Room charges are checked against the stay online.',
+    credit: 'Store credit and rewards balances can only be checked online.'
+};
+/** Each flag in the words the order and the register show. */ export const POS_OFFLINE_FLAG_LABELS = {
+    'price-changed': 'A price changed after the register cached it; the sale kept the price it was rung at',
+    'unknown-product': 'A product was deleted before the sale synced; the line kept what the receipt printed',
+    'tax-differs': 'The tax rung differs from the store’s rate now; the sale kept the tax it collected',
+    'totals-restated': 'The register’s totals did not add up; the server restated them from the lines',
+    'discount-over-limit': 'The discount is above this register’s limit',
+    'cash-short': 'The cash recorded is less than the total',
+    'stock-short': 'Stock went short: more was sold than the shelf held',
+    'shift-closed': 'Rung in a shift that closed before the sale synced; its Z report does not include it',
+    'no-shift': 'Rung with no shift open, on a site that requires one',
+    'unknown-register': 'The register it was rung on no longer exists',
+    'register-over-cap': 'The register it was rung on is over the plan’s register limit',
+    'late-sync': 'Synced more than a day after it was rung',
+    'clock-adjusted': 'The device clock was off; the sale is dated when it synced',
+    'cashier-unverified': 'The PIN-switched cashier could not be confirmed; the sale is under the signed-in member'
+};
+/**
+ * The totals of an offline sale: the cashier's discount on the goods, then
+ * the store's in-person tax on what is left — exactly the arithmetic the
+ * online register's sale route uses for the same basket with no promotion.
+ * `pricesIncludeTax` adds nothing, as at the online till.
+ */ export function posOfflineSaleTotals(input) {
+    const lines = input.lines.map((line)=>({
+            unitAmountCents: wholeCents(line.unitAmountCents),
+            quantity: Math.max(1, Math.round(Number(line.quantity) || 1))
+        }));
+    const itemsCents = lines.reduce((sum, line)=>sum + line.unitAmountCents * line.quantity, 0);
+    const pct = Number.isFinite(input.discountPct) ? Math.min(100, Math.max(0, input.discountPct)) : 0;
+    const discountCents = Math.min(itemsCents, Math.round(itemsCents * pct / 100));
+    const taxPct = Number(input.tax.pct);
+    const taxCents = taxPct > 0 && !input.tax.pricesIncludeTax ? computeTaxCents(itemsCents - discountCents, taxPct) : 0;
+    return computeOrderTotals(lines, {
+        discountCents,
+        taxCents,
+        feeCents: 0
+    });
+}
+/** Change for cash handed over, never negative. */ export function posOfflineChangeCents(totalCents, tenderedCents) {
+    return Math.max(0, wholeCents(tenderedCents) - wholeCents(totalCents));
+}
+/** A key the register minted: an id the order can take, and nothing else. */ export function posOfflineSaleKeyIsValid(key) {
+    return typeof key === 'string' && /^[A-Za-z0-9_-]{16,64}$/.test(key) && !/^__.*__$/.test(key);
+}
+/**
+ * The sale's time as the server records it: the device's clock when it is
+ * believable, clamped to now when it runs ahead, and to the oldest believable
+ * moment when it claims to be older.
+ */ export function posOfflineSoldAt(soldAtMs, nowMs) {
+    const at = Number(soldAtMs);
+    if (!Number.isFinite(at) || at <= 0) return {
+        atMs: nowMs,
+        adjusted: true
+    };
+    if (at > nowMs + POS_OFFLINE_CLOCK_SKEW_MS) return {
+        atMs: nowMs,
+        adjusted: true
+    };
+    if (at < nowMs - POS_OFFLINE_MAX_AGE_MS) return {
+        atMs: nowMs,
+        adjusted: true
+    };
+    return {
+        atMs: Math.min(at, nowMs),
+        adjusted: false
+    };
+}
+const bounded = (value, max)=>typeof value === 'string' ? value.trim().slice(0, max) : '';
+const cleanId = (value)=>{
+    const id = String(value != null ? value : '').trim();
+    return /^[A-Za-z0-9_-]{1,128}$/.test(id) && !/^__.*__$/.test(id) ? id : '';
+};
+function wholeCents(value) {
+    const number = Math.round(Number(value));
+    return Number.isFinite(number) && number > 0 ? number : 0;
+}
+/**
+ * A queued sale read off the wire, every field typed and bounded — or the
+ * sentence that says why it cannot be read at all. Pure, so the server and
+ * any client that wants to check its own queue answer the same.
+ */ export function sanitizePosOfflineSale(raw) {
+    var _input_discountPct, _input_totals;
+    if (!raw || typeof raw !== 'object') return {
+        ok: false,
+        error: 'Not a sale'
+    };
+    const input = raw;
+    const saleKey = input['saleKey'];
+    if (!posOfflineSaleKeyIsValid(saleKey)) return {
+        ok: false,
+        error: 'The sale has no valid key'
+    };
+    const hostId = cleanId(input['hostId']);
+    const registerId = cleanId(input['registerId']);
+    const signedInUid = bounded(input['signedInUid'], 128);
+    if (!hostId || !registerId || !signedInUid) {
+        return {
+            ok: false,
+            error: 'The sale is missing its site, register or member'
+        };
+    }
+    const rawLines = Array.isArray(input['lines']) ? input['lines'] : [];
+    if (rawLines.length === 0 || rawLines.length > POS_OFFLINE_SALE_MAX_LINES) {
+        return {
+            ok: false,
+            error: 'The sale has no lines'
+        };
+    }
+    const lines = [];
+    for (const line of rawLines){
+        const productId = cleanId(line == null ? void 0 : line.productId);
+        const name = bounded(line == null ? void 0 : line.name, 200);
+        const unit = Math.round(Number(line == null ? void 0 : line.unitAmountCents));
+        const quantity = Math.round(Number(line == null ? void 0 : line.quantity));
+        if (!productId || !name || !Number.isFinite(unit) || unit < 0 || !(quantity >= 1 && quantity <= 99)) {
+            return {
+                ok: false,
+                error: 'A line of the sale cannot be read'
+            };
+        }
+        const variantId = cleanId(line == null ? void 0 : line.variantId);
+        const variantLabel = bounded(line == null ? void 0 : line.variantLabel, 200);
+        const sku = bounded(line == null ? void 0 : line.sku, 100);
+        const productType = [
+            'physical',
+            'digital',
+            'service'
+        ].includes(line == null ? void 0 : line.productType) ? line.productType : undefined;
+        const modifiers = Array.isArray(line == null ? void 0 : line.modifiers) ? line.modifiers.slice(0, 50).map((pick)=>({
+                groupId: cleanId(pick == null ? void 0 : pick.groupId),
+                optionId: cleanId(pick == null ? void 0 : pick.optionId)
+            })).filter((pick)=>pick.groupId && pick.optionId) : [];
+        lines.push(_extends({
+            productId
+        }, variantId ? {
+            variantId
+        } : {}, {
+            name
+        }, variantLabel ? {
+            variantLabel
+        } : {}, sku ? {
+            sku
+        } : {}, productType ? {
+            productType
+        } : {}, {
+            quantity,
+            unitAmountCents: unit
+        }, modifiers.length ? {
+            modifiers
+        } : {}));
+    }
+    const discountPct = Number((_input_discountPct = input['discountPct']) != null ? _input_discountPct : 0);
+    if (!Number.isFinite(discountPct) || discountPct < 0 || discountPct > 100) {
+        return {
+            ok: false,
+            error: 'The sale’s discount cannot be read'
+        };
+    }
+    const totals = (_input_totals = input['totals']) != null ? _input_totals : {};
+    const customerRaw = input['customer'];
+    const customer = {};
+    if (customerRaw && typeof customerRaw === 'object') {
+        const email = bounded(customerRaw.email, 254).toLowerCase();
+        if (email && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) customer.email = email;
+        const name = bounded(customerRaw.name, 200);
+        if (name) customer.name = name;
+        const kind = bounded(customerRaw.kind, 40);
+        const id = cleanId(customerRaw.id);
+        if (kind && kind !== 'none' && id) {
+            customer.kind = kind;
+            customer.id = id;
+        }
+    }
+    const shiftId = cleanId(input['shiftId']);
+    const locationId = cleanId(input['locationId']);
+    const assertion = bounded(input['cashierAssertion'], 2000);
+    const orgId = bounded(input['orgId'], 128);
+    return {
+        ok: true,
+        sale: _extends({
+            v: 1,
+            saleKey,
+            hostId,
+            orgId,
+            signedInUid,
+            registerId,
+            shiftId: shiftId || null
+        }, locationId ? {
+            locationId
+        } : {}, assertion ? {
+            cashierAssertion: assertion
+        } : {}, {
+            soldAtMs: Number(input['soldAtMs']) || 0,
+            lines,
+            discountPct,
+            totals: {
+                itemsCents: wholeCents(totals['itemsCents']),
+                shippingCents: 0,
+                taxCents: wholeCents(totals['taxCents']),
+                discountCents: wholeCents(totals['discountCents']),
+                totalCents: wholeCents(totals['totalCents']),
+                feeCents: 0
+            },
+            cashTenderedCents: wholeCents(input['cashTenderedCents']),
+            changeCents: wholeCents(input['changeCents'])
+        }, Object.keys(customer).length ? {
+            customer
+        } : {})
+    };
+}
+/**
+ * Whether the register's totals are the arithmetic of its own lines: the
+ * goods are the lines' sum, the discount is the percentage of them, and the
+ * total is goods less discount plus the tax it rang. The tax itself is the
+ * register's, and checked against the store's rate separately.
+ */ export function posOfflineTotalsAddUp(sale) {
+    const expected = posOfflineSaleTotals({
+        lines: sale.lines,
+        discountPct: sale.discountPct,
+        tax: {
+            pct: null,
+            pricesIncludeTax: false
+        }
+    });
+    return expected.itemsCents === sale.totals.itemsCents && expected.discountCents === sale.totals.discountCents && sale.totals.taxCents <= sale.totals.itemsCents && sale.totals.totalCents === expected.itemsCents - expected.discountCents + sale.totals.taxCents;
+}
+/** The flags in the order and words the register lists them. */ export function posOfflineFlagLabels(flags) {
+    return flags.map((flag)=>{
+        var _POS_OFFLINE_FLAG_LABELS_flag;
+        return (_POS_OFFLINE_FLAG_LABELS_flag = POS_OFFLINE_FLAG_LABELS[flag]) != null ? _POS_OFFLINE_FLAG_LABELS_flag : flag;
+    });
+}
+
+//# sourceMappingURL=commerce-pos-offline.js.map

package/src/lib/model/commerce-pos-offline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-pos-offline.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 { computeOrderTotals, type OrderLineItem, type OrderTotals } from './commerce-orders'\nimport { computeTaxCents } from './commerce-tax'\nimport type { ModifierSelection } from './product-modifiers'\n\n/*==========================================\n * THE OFFLINE REGISTER (AGL-3625): the contract every register client — the\n * web register and the native Aglyn POS app — shares with\n * `POST /api/commerce/pos-offline-sync`.\n *\n * WHAT SELLS OFFLINE IS CASH, AND ONLY CASH.\n *\n *  - Card tenders cannot: the reader, Tap to Pay, the typed card and the QR\n *    link are all server-driven Stripe payments, and Stripe does not take a\n *    server-driven card payment without the server.\n *  - Gift cards DO NOT, deliberately. A balance cannot be checked without the\n *    server, and a capped \"allow it anyway\" (Square's offer for cards) turns a\n *    short balance into a sale whose money nobody collected — discovered at\n *    sync, after the customer left. Square itself does not redeem gift cards\n *    offline. A gift card is never over-redeemed silently because it is never\n *    redeemed offline at all.\n *  - Room charges do not: the stay is validated on the server.\n *  - Store credit and rewards do not, for the gift card's reason: a balance\n *    is the server's to check.\n *  - Codes and store promotions do not: a redemption cap is counted on the\n *    server. The cashier's own discount, bounded by the site's ceiling, does.\n *\n * WHAT THE SALE IS: the register prices the basket from its cached catalog and\n * the store's own tax rate, takes the cash and queues the sale with a key it\n * minted. That key is the order's id on the server, so the receipt printed\n * offline carries the barcode the real order answers to, and a sale sent twice\n * — a flapping connection, a retry after a lost answer — lands once.\n *\n * WHAT THE SERVER DOES WITH IT: records it as it happened, never re-prices the\n * money the customer handed over, and FLAGS what does not match — a price\n * that changed, stock that went short, a shift that closed first — on the\n * order and back to the register. A sale is never dropped for a flag.\n *=========================================*/\n\n/** The route both register clients sync through. */\nexport const POS_OFFLINE_SYNC_ROUTE = '/api/commerce/pos-offline-sync'\n\n/** The most sales one sync request carries; a longer queue sends in batches. */\nexport const POS_OFFLINE_SYNC_BATCH_MAX = 25\n\n/** Lines one offline sale may carry, the same bound the register's basket has. */\nexport const POS_OFFLINE_SALE_MAX_LINES = 100\n\n/** A sale synced later than this after it was rung is flagged `late-sync`. */\nexport const POS_OFFLINE_LATE_SYNC_MS = 24 * 60 * 60 * 1000\n\n/**\n * How far back a sale's own clock is believed. Older, and the server stamps\n * the sale at this bound and flags it, rather than letting a device clock\n * place a sale anywhere in history.\n */\nexport const POS_OFFLINE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000\n\n/** How far ahead of the server a device clock may run before it is clamped. */\nexport const POS_OFFLINE_CLOCK_SKEW_MS = 10 * 60 * 1000\n\n/** The one tender an offline sale takes. */\nexport type PosOfflineTender = 'cash'\n\n/** Every tender the register turns off while offline, and why, in its words. */\nexport const POS_OFFLINE_DISABLED_TENDERS: Readonly<Record<string, string>> = {\n  card_present: 'Card readers need the connection.',\n  card_keyed: 'Typed cards need the connection.',\n  card_link: 'The QR card link needs the connection.',\n  gift_card: 'A gift card balance can only be checked online.',\n  folio: 'Room charges are checked against the stay online.',\n  credit: 'Store credit and rewards balances can only be checked online.',\n}\n\n/** One basket line as the register rang it. */\nexport interface PosOfflineSaleLine {\n  productId: string\n  variantId?: string\n  name: string\n  /** Variant options and modifier choices, as the receipt printed them. */\n  variantLabel?: string\n  sku?: string\n  productType?: 'physical' | 'digital' | 'service'\n  quantity: number\n  /** Per unit, modifiers included, from the cached catalog. */\n  unitAmountCents: number\n  modifiers?: ModifierSelection[]\n}\n\n/** The customer the register attached: only what the sale and its receipt need. */\nexport interface PosOfflineSaleCustomer {\n  email?: string\n  name?: string\n  kind?: string\n  id?: string\n}\n\n/** One sale rung while offline, exactly as the register queued it. */\nexport interface PosOfflineSale {\n  v: 1\n  /** The register's key for this sale, minted once; the order's id on the server. */\n  saleKey: string\n  hostId: string\n  /** The workspace the register was signed in to. */\n  orgId: string\n  /** Who was signed in on the device: the only member who may sync it. */\n  signedInUid: string\n  registerId: string\n  /** The shift open on the register when the sale was rung. */\n  shiftId?: string | null\n  locationId?: string\n  /** A PIN-switched cashier's assertion, valid when the sale was rung. */\n  cashierAssertion?: string\n  /** The device's clock when the cash was taken. */\n  soldAtMs: number\n  lines: PosOfflineSaleLine[]\n  /** The cashier's discount, a percentage of the goods. */\n  discountPct: number\n  /** The totals the receipt printed and the customer paid. */\n  totals: OrderTotals\n  cashTenderedCents: number\n  changeCents: number\n  customer?: PosOfflineSaleCustomer\n}\n\n/** What does not match, said on the order and back to the register. */\nexport type PosOfflineFlag =\n  | 'price-changed'\n  | 'unknown-product'\n  | 'tax-differs'\n  | 'totals-restated'\n  | 'discount-over-limit'\n  | 'cash-short'\n  | 'stock-short'\n  | 'shift-closed'\n  | 'no-shift'\n  | 'unknown-register'\n  | 'register-over-cap'\n  | 'late-sync'\n  | 'clock-adjusted'\n  | 'cashier-unverified'\n\n/** Each flag in the words the order and the register show. */\nexport const POS_OFFLINE_FLAG_LABELS: Record<PosOfflineFlag, string> = {\n  'price-changed': 'A price changed after the register cached it; the sale kept the price it was rung at',\n  'unknown-product': 'A product was deleted before the sale synced; the line kept what the receipt printed',\n  'tax-differs': 'The tax rung differs from the store’s rate now; the sale kept the tax it collected',\n  'totals-restated': 'The register’s totals did not add up; the server restated them from the lines',\n  'discount-over-limit': 'The discount is above this register’s limit',\n  'cash-short': 'The cash recorded is less than the total',\n  'stock-short': 'Stock went short: more was sold than the shelf held',\n  'shift-closed': 'Rung in a shift that closed before the sale synced; its Z report does not include it',\n  'no-shift': 'Rung with no shift open, on a site that requires one',\n  'unknown-register': 'The register it was rung on no longer exists',\n  'register-over-cap': 'The register it was rung on is over the plan’s register limit',\n  'late-sync': 'Synced more than a day after it was rung',\n  'clock-adjusted': 'The device clock was off; the sale is dated when it synced',\n  'cashier-unverified': 'The PIN-switched cashier could not be confirmed; the sale is under the signed-in member',\n}\n\n/** A line whose stock went short when the sale synced. */\nexport interface PosOfflineStockConflict {\n  productId: string\n  variantId?: string\n  name: string\n  /** Units sold. */\n  requested: number\n  /** Units the shelf actually gave up. */\n  applied: number\n  /** Units sold that the shelf did not hold. */\n  shortUnits: number\n}\n\n/** What the order records about having been rung offline. */\nexport interface PosOfflineOrderStamp {\n  saleKey: string\n  /** The device's clock when the cash was taken. */\n  soldAtMs: number\n  syncedAtMs: number\n  /** Who synced it: always the member who was signed in when it was rung. */\n  syncedBy: string\n  flags: PosOfflineFlag[]\n  stockConflicts?: PosOfflineStockConflict[]\n  /** The server's own price per line where it differed, for the merchant to compare. */\n  priceDrift?: Array<{ index: number; rungCents: number; currentCents: number }>\n}\n\n/** Why a sale was refused, and whether the register should keep trying. */\nexport type PosOfflineRefusal =\n  | 'wrong-staff'\n  | 'wrong-site'\n  | 'wrong-workspace'\n  | 'invalid'\n  | 'conflict'\n  | 'failed'\n\n/** What became of one sale the register sent. */\nexport type PosOfflineOutcomeStatus = 'recorded' | 'replayed' | 'refused'\n\n/**\n * One sale's answer, in the order the request sent them. `recorded` and\n * `replayed` carry the order; `refused` carries the reason, the sentence and\n * whether to keep trying. One flat shape, so every register client — the web\n * register and the native apps — decodes it the same way.\n */\nexport interface PosOfflineSaleOutcome {\n  saleKey: string\n  status: PosOfflineOutcomeStatus\n  orderId?: string\n  number?: number | null\n  flags?: PosOfflineFlag[]\n  stockConflicts?: PosOfflineStockConflict[]\n  reason?: PosOfflineRefusal\n  error?: string\n  /** Keep it queued and try again later (a transient failure). */\n  retry?: boolean\n}\n\nexport interface PosOfflineSyncRequest {\n  hostId: string\n  sales: PosOfflineSale[]\n}\n\nexport interface PosOfflineSyncResponse {\n  results: PosOfflineSaleOutcome[]\n}\n\n/** One register as the offline kit lists it. */\nexport interface PosOfflineKitRegister {\n  id: string\n  name: string\n  locationId?: string\n  openShiftId: string | null\n}\n\n/**\n * Everything a register needs to sell offline besides the catalog, from\n * `GET /api/commerce/pos-offline-sync?hostId=`: the server's own answers, so\n * the register and the sync agree about the rate and the rules.\n */\nexport interface PosOfflineKit {\n  v: 1\n  hostId: string\n  orgId: string\n  issuedAtMs: number\n  /** Offline selling is possible for this site right now. */\n  available: boolean\n  /** Why not, in the cashier's words, when it is not. */\n  unavailableReason?: string\n  /** The store's own in-person rate; `null` pct is no tax. */\n  tax: { pct: number | null; pricesIncludeTax: boolean }\n  maxDiscountPct: number\n  requireOpenShift: boolean\n  registers: PosOfflineKitRegister[]\n  /** What the receipt prints at its head and foot. `logo` is the stored value. */\n  receipt: {\n    name: string\n    logo?: string\n    address?: string\n    footer?: string\n    returnPolicy?: string\n  }\n}\n\n/**\n * The totals of an offline sale: the cashier's discount on the goods, then\n * the store's in-person tax on what is left — exactly the arithmetic the\n * online register's sale route uses for the same basket with no promotion.\n * `pricesIncludeTax` adds nothing, as at the online till.\n */\nexport function posOfflineSaleTotals(input: {\n  lines: ReadonlyArray<Pick<PosOfflineSaleLine, 'unitAmountCents' | 'quantity'>>\n  discountPct: number\n  tax: { pct: number | null; pricesIncludeTax: boolean }\n}): OrderTotals {\n  const lines = input.lines.map((line) => ({\n    unitAmountCents: wholeCents(line.unitAmountCents),\n    quantity: Math.max(1, Math.round(Number(line.quantity) || 1)),\n  }))\n  const itemsCents = lines.reduce((sum, line) => sum + line.unitAmountCents * line.quantity, 0)\n  const pct = Number.isFinite(input.discountPct) ? Math.min(100, Math.max(0, input.discountPct)) : 0\n  const discountCents = Math.min(itemsCents, Math.round((itemsCents * pct) / 100))\n  const taxPct = Number(input.tax.pct)\n  const taxCents =\n    taxPct > 0 && !input.tax.pricesIncludeTax ? computeTaxCents(itemsCents - discountCents, taxPct) : 0\n  return computeOrderTotals(lines as unknown as OrderLineItem[], { discountCents, taxCents, feeCents: 0 })\n}\n\n/** Change for cash handed over, never negative. */\nexport function posOfflineChangeCents(totalCents: number, tenderedCents: number): number {\n  return Math.max(0, wholeCents(tenderedCents) - wholeCents(totalCents))\n}\n\n/** A key the register minted: an id the order can take, and nothing else. */\nexport function posOfflineSaleKeyIsValid(key: unknown): key is string {\n  return typeof key === 'string' && /^[A-Za-z0-9_-]{16,64}$/.test(key) && !/^__.*__$/.test(key)\n}\n\n/**\n * The sale's time as the server records it: the device's clock when it is\n * believable, clamped to now when it runs ahead, and to the oldest believable\n * moment when it claims to be older.\n */\nexport function posOfflineSoldAt(\n  soldAtMs: number,\n  nowMs: number,\n): { atMs: number; adjusted: boolean } {\n  const at = Number(soldAtMs)\n  if (!Number.isFinite(at) || at <= 0) return { atMs: nowMs, adjusted: true }\n  if (at > nowMs + POS_OFFLINE_CLOCK_SKEW_MS) return { atMs: nowMs, adjusted: true }\n  if (at < nowMs - POS_OFFLINE_MAX_AGE_MS) return { atMs: nowMs, adjusted: true }\n  return { atMs: Math.min(at, nowMs), adjusted: false }\n}\n\nconst bounded = (value: unknown, max: number): string =>\n  typeof value === 'string' ? value.trim().slice(0, max) : ''\n\nconst cleanId = (value: unknown): string => {\n  const id = String(value ?? '').trim()\n  return /^[A-Za-z0-9_-]{1,128}$/.test(id) && !/^__.*__$/.test(id) ? id : ''\n}\n\nfunction wholeCents(value: unknown): number {\n  const number = Math.round(Number(value))\n  return Number.isFinite(number) && number > 0 ? number : 0\n}\n\n/**\n * A queued sale read off the wire, every field typed and bounded — or the\n * sentence that says why it cannot be read at all. Pure, so the server and\n * any client that wants to check its own queue answer the same.\n */\nexport function sanitizePosOfflineSale(\n  raw: unknown,\n): { ok: true; sale: PosOfflineSale } | { ok: false; error: string } {\n  if (!raw || typeof raw !== 'object') return { ok: false, error: 'Not a sale' }\n  const input = raw as Record<string, any>\n  const saleKey = input['saleKey']\n  if (!posOfflineSaleKeyIsValid(saleKey)) return { ok: false, error: 'The sale has no valid key' }\n  const hostId = cleanId(input['hostId'])\n  const registerId = cleanId(input['registerId'])\n  const signedInUid = bounded(input['signedInUid'], 128)\n  if (!hostId || !registerId || !signedInUid) {\n    return { ok: false, error: 'The sale is missing its site, register or member' }\n  }\n  const rawLines = Array.isArray(input['lines']) ? input['lines'] : []\n  if (rawLines.length === 0 || rawLines.length > POS_OFFLINE_SALE_MAX_LINES) {\n    return { ok: false, error: 'The sale has no lines' }\n  }\n  const lines: PosOfflineSaleLine[] = []\n  for (const line of rawLines) {\n    const productId = cleanId(line?.productId)\n    const name = bounded(line?.name, 200)\n    const unit = Math.round(Number(line?.unitAmountCents))\n    const quantity = Math.round(Number(line?.quantity))\n    if (!productId || !name || !Number.isFinite(unit) || unit < 0 || !(quantity >= 1 && quantity <= 99)) {\n      return { ok: false, error: 'A line of the sale cannot be read' }\n    }\n    const variantId = cleanId(line?.variantId)\n    const variantLabel = bounded(line?.variantLabel, 200)\n    const sku = bounded(line?.sku, 100)\n    const productType = ['physical', 'digital', 'service'].includes(line?.productType)\n      ? (line.productType as PosOfflineSaleLine['productType'])\n      : undefined\n    const modifiers = Array.isArray(line?.modifiers)\n      ? (line.modifiers as unknown[])\n          .slice(0, 50)\n          .map((pick: any) => ({ groupId: cleanId(pick?.groupId), optionId: cleanId(pick?.optionId) }))\n          .filter((pick) => pick.groupId && pick.optionId)\n      : []\n    lines.push({\n      productId,\n      ...(variantId ? { variantId } : {}),\n      name,\n      ...(variantLabel ? { variantLabel } : {}),\n      ...(sku ? { sku } : {}),\n      ...(productType ? { productType } : {}),\n      quantity,\n      unitAmountCents: unit,\n      ...(modifiers.length ? { modifiers } : {}),\n    })\n  }\n  const discountPct = Number(input['discountPct'] ?? 0)\n  if (!Number.isFinite(discountPct) || discountPct < 0 || discountPct > 100) {\n    return { ok: false, error: 'The sale’s discount cannot be read' }\n  }\n  const totals = (input['totals'] ?? {}) as Record<string, unknown>\n  const customerRaw = input['customer']\n  const customer: PosOfflineSaleCustomer = {}\n  if (customerRaw && typeof customerRaw === 'object') {\n    const email = bounded((customerRaw as any).email, 254).toLowerCase()\n    if (email && /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email)) customer.email = email\n    const name = bounded((customerRaw as any).name, 200)\n    if (name) customer.name = name\n    const kind = bounded((customerRaw as any).kind, 40)\n    const id = cleanId((customerRaw as any).id)\n    if (kind && kind !== 'none' && id) {\n      customer.kind = kind\n      customer.id = id\n    }\n  }\n  const shiftId = cleanId(input['shiftId'])\n  const locationId = cleanId(input['locationId'])\n  const assertion = bounded(input['cashierAssertion'], 2000)\n  const orgId = bounded(input['orgId'], 128)\n  return {\n    ok: true,\n    sale: {\n      v: 1,\n      saleKey,\n      hostId,\n      orgId,\n      signedInUid,\n      registerId,\n      shiftId: shiftId || null,\n      ...(locationId ? { locationId } : {}),\n      ...(assertion ? { cashierAssertion: assertion } : {}),\n      soldAtMs: Number(input['soldAtMs']) || 0,\n      lines,\n      discountPct,\n      totals: {\n        itemsCents: wholeCents(totals['itemsCents']),\n        shippingCents: 0,\n        taxCents: wholeCents(totals['taxCents']),\n        discountCents: wholeCents(totals['discountCents']),\n        totalCents: wholeCents(totals['totalCents']),\n        feeCents: 0,\n      },\n      cashTenderedCents: wholeCents(input['cashTenderedCents']),\n      changeCents: wholeCents(input['changeCents']),\n      ...(Object.keys(customer).length ? { customer } : {}),\n    },\n  }\n}\n\n/**\n * Whether the register's totals are the arithmetic of its own lines: the\n * goods are the lines' sum, the discount is the percentage of them, and the\n * total is goods less discount plus the tax it rang. The tax itself is the\n * register's, and checked against the store's rate separately.\n */\nexport function posOfflineTotalsAddUp(sale: Pick<PosOfflineSale, 'lines' | 'discountPct' | 'totals'>): boolean {\n  const expected = posOfflineSaleTotals({\n    lines: sale.lines,\n    discountPct: sale.discountPct,\n    tax: { pct: null, pricesIncludeTax: false },\n  })\n  return (\n    expected.itemsCents === sale.totals.itemsCents &&\n    expected.discountCents === sale.totals.discountCents &&\n    sale.totals.taxCents <= sale.totals.itemsCents &&\n    sale.totals.totalCents === expected.itemsCents - expected.discountCents + sale.totals.taxCents\n  )\n}\n\n/** The flags in the order and words the register lists them. */\nexport function posOfflineFlagLabels(flags: readonly PosOfflineFlag[]): string[] {\n  return flags.map((flag) => POS_OFFLINE_FLAG_LABELS[flag] ?? flag)\n}\n"],"names":["computeOrderTotals","computeTaxCents","POS_OFFLINE_SYNC_ROUTE","POS_OFFLINE_SYNC_BATCH_MAX","POS_OFFLINE_SALE_MAX_LINES","POS_OFFLINE_LATE_SYNC_MS","POS_OFFLINE_MAX_AGE_MS","POS_OFFLINE_CLOCK_SKEW_MS","POS_OFFLINE_DISABLED_TENDERS","card_present","card_keyed","card_link","gift_card","folio","credit","POS_OFFLINE_FLAG_LABELS","posOfflineSaleTotals","input","lines","map","line","unitAmountCents","wholeCents","quantity","Math","max","round","Number","itemsCents","reduce","sum","pct","isFinite","discountPct","min","discountCents","taxPct","tax","taxCents","pricesIncludeTax","feeCents","posOfflineChangeCents","totalCents","tenderedCents","posOfflineSaleKeyIsValid","key","test","posOfflineSoldAt","soldAtMs","nowMs","at","atMs","adjusted","bounded","value","trim","slice","cleanId","id","String","number","sanitizePosOfflineSale","raw","ok","error","saleKey","hostId","registerId","signedInUid","rawLines","Array","isArray","length","productId","name","unit","variantId","variantLabel","sku","productType","includes","undefined","modifiers","pick","groupId","optionId","filter","push","totals","customerRaw","customer","email","toLowerCase","kind","shiftId","locationId","assertion","orgId","sale","v","cashierAssertion","shippingCents","cashTenderedCents","changeCents","Object","keys","posOfflineTotalsAddUp","expected","posOfflineFlagLabels","flags","flag"],"mappings":"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"}

package/src/lib/model/commerce-pos-ops.d.ts

@@ -16,7 +16,9 @@
  */
 import type { PrintReport } from './commerce-printers';
 /** How one payment toward a sale was taken, in the register's tender words. */
-export type PosTenderMethod = 'cash' | 'card_present' | 'card_keyed' | 'card_link' | 'gift_card' | 'folio';
+export type PosTenderMethod = 'cash' | 'card_present' | 'card_keyed' | 'card_link' | 'gift_card' | 'folio'
+/** Store credit another plugin keeps (AGL-3640). */
+ | 'credit';
 export declare const POS_TENDER_METHODS: readonly PosTenderMethod[];
 /** What each tender is called on a report, a receipt and a refund. */
 export declare const POS_TENDER_LABELS: Readonly<Record<PosTenderMethod, string>>;
@@ -36,6 +38,10 @@ export interface PosOrderTender {
     paymentIntentId?: string;
     giftCardId?: string;
     reservationId?: string;
+    /** For `credit` (AGL-3640): the provider, its account handle, and its name. */
+    creditProviderId?: string;
+    creditReference?: string;
+    creditLabel?: string;
     cardBrand?: string;
     last4?: string;
     cashTenderedCents?: number;
@@ -70,7 +76,9 @@ export interface PosTenderSource {
  */
 export declare function posOrderTenders(order: PosTenderSource | null | undefined): PosOrderTender[];
 /** A tender as one line of a receipt: `Card •• 4242`. */
-export declare function posTenderLabel(tender: Pick<PosOrderTender, 'method' | 'cardBrand' | 'last4'>): string;
+export declare function posTenderLabel(tender: Pick<PosOrderTender, 'method' | 'cardBrand' | 'last4'> & {
+    creditLabel?: string;
+}): string;
 /**
  * Cash that moved through the drawer without a sale: money put in, money
  * paid out for a reason (a delivery, petty cash), a drop to the safe, and
@@ -128,12 +136,14 @@ export interface PosShift {
     cashEvents: PosCashEvent[];
     closedBy?: string;
     closedByName?: string;
-    closedAtMs?: number;
+    closedAtMs?: number | null;
     /** What the closing cashier counted in the drawer. */
-    countedCashCents?: number;
-    expectedCashCents?: number;
+    countedCashCents?: number | null;
+    expectedCashCents?: number | null;
     /** counted − expected: positive is over, negative is short. */
-    varianceCents?: number;
+    varianceCents?: number | null;
+    /** The Z report's `netSalesCents`, flattened so the history can order by it. */
+    netSalesCents?: number | null;
     closingNote?: string;
     /** The Z report, frozen when the shift closed. */
     report?: PosShiftReport;

package/src/lib/model/commerce-pos-ops.js

@@ -23,7 +23,8 @@ export const POS_TENDER_METHODS = [
     'card_keyed',
     'card_link',
     'gift_card',
-    'folio'
+    'folio',
+    'credit'
 ];
 /** What each tender is called on a report, a receipt and a refund. */ export const POS_TENDER_LABELS = {
     cash: 'Cash',
@@ -31,7 +32,8 @@ export const POS_TENDER_METHODS = [
     card_keyed: 'Card (keyed)',
     card_link: 'Card (payment link)',
     gift_card: 'Gift card',
-    folio: 'Room charge'
+    folio: 'Room charge',
+    credit: 'Store credit'
 };
 /** The tenders whose money moved through Stripe and goes back through it. */ export const POS_STRIPE_TENDERS = new Set([
     'card_present',
@@ -71,6 +73,12 @@ const isTenderMethod = (value)=>typeof value === 'string' && POS_TENDER_METHODS.
             giftCardId: payment.giftCardId
         } : {}, payment.reservationId ? {
             reservationId: payment.reservationId
+        } : {}, payment.creditProviderId ? {
+            creditProviderId: payment.creditProviderId
+        } : {}, payment.creditReference ? {
+            creditReference: payment.creditReference
+        } : {}, payment.creditLabel ? {
+            creditLabel: payment.creditLabel
         } : {}, payment.cardBrand ? {
             cardBrand: payment.cardBrand
         } : {}, payment.last4 ? {
@@ -83,8 +91,7 @@ const isTenderMethod = (value)=>typeof value === 'string' && POS_TENDER_METHODS.
     });
 }
 /** A tender as one line of a receipt: `Card •• 4242`. */ export function posTenderLabel(tender) {
-    var _POS_TENDER_LABELS_tender_method;
-    const base = (_POS_TENDER_LABELS_tender_method = POS_TENDER_LABELS[tender.method]) != null ? _POS_TENDER_LABELS_tender_method : tender.method;
+    const base = tender.method === 'credit' && tender.creditLabel || POS_TENDER_LABELS[tender.method] || tender.method;
     if (tender.last4) {
         return `${tender.cardBrand ? capitalize(tender.cardBrand) : base} •• ${tender.last4}`;
     }
@@ -424,6 +431,7 @@ const dollars = (cents)=>cents == null ? '' : (Math.round(cents) / 100).toFixed(
     'card_keyed',
     'card_link',
     'gift_card',
+    'credit',
     'folio',
     'cash'
 ];