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

package/src/lib/components/console/pos-ops/use-pos-cashier.js

@@ -0,0 +1,128 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { callPosOps } from "./pos-ops-api.js";
+/** Refresh a cashier assertion this long before it expires. */ const REFRESH_MARGIN_MS = 3 * 60 * 1000;
+/** How often the register checks the idle clock and the expiry. */ const TICK_MS = 15 * 1000;
+/**
+ * Who is at the register (AGL-3609).
+ *
+ * Holds the cashier a PIN switched in, refreshes their assertion while they
+ * keep working (the server re-checks their role on every refresh), and LOCKS
+ * the register after `autoLockMinutes` without a tap or a key — dropping the
+ * assertion, so the next person has to enter their own PIN. An expired
+ * assertion the refresh could not renew drops back to the signed-in member
+ * rather than ringing sales under a name the server would refuse.
+ */ export function usePosCashier(options) {
+    const { hostId, registerId, autoLockMinutes } = options;
+    const { data: user } = useUser();
+    const [cashier, setCashier] = useState(null);
+    const [locked, setLocked] = useState(false);
+    const lastActivity = useRef(Date.now());
+    const refreshing = useRef(false);
+    // A different register is a different till: nobody carries over.
+    useEffect(()=>{
+        setCashier(null);
+        setLocked(false);
+    }, [
+        hostId,
+        registerId
+    ]);
+    useEffect(()=>{
+        const touch = ()=>{
+            lastActivity.current = Date.now();
+        };
+        window.addEventListener('pointerdown', touch, {
+            passive: true
+        });
+        window.addEventListener('keydown', touch);
+        return ()=>{
+            window.removeEventListener('pointerdown', touch);
+            window.removeEventListener('keydown', touch);
+        };
+    }, []);
+    useEffect(()=>{
+        const timer = window.setInterval(()=>{
+            const now = Date.now();
+            if (autoLockMinutes > 0 && !locked && now - lastActivity.current > autoLockMinutes * 60000) {
+                setCashier(null);
+                setLocked(true);
+                return;
+            }
+            if (!cashier) return;
+            if (now >= cashier.expiresAtMs) {
+                setCashier(null);
+                return;
+            }
+            if (cashier.expiresAtMs - now > REFRESH_MARGIN_MS || refreshing.current) return;
+            // Only a cashier who is still working earns a fresh assertion.
+            if (now - lastActivity.current > REFRESH_MARGIN_MS) return;
+            refreshing.current = true;
+            void callPosOps(user, 'pos-staff-pin', {
+                hostId,
+                registerId,
+                action: 'refresh',
+                assertion: cashier.assertion
+            }).then((answer)=>{
+                refreshing.current = false;
+                if (answer.ok && answer.body.assertion && answer.body.expiresAtMs) {
+                    setCashier((current)=>current && current.memberUid === cashier.memberUid ? _extends({}, current, {
+                            assertion: answer.body.assertion,
+                            expiresAtMs: answer.body.expiresAtMs
+                        }) : current);
+                } else if (answer.status === 401 || answer.status === 403) {
+                    setCashier(null);
+                }
+            });
+        }, TICK_MS);
+        return ()=>window.clearInterval(timer);
+    }, [
+        autoLockMinutes,
+        locked,
+        cashier,
+        user,
+        hostId,
+        registerId
+    ]);
+    const switchTo = useCallback((assertion)=>{
+        lastActivity.current = Date.now();
+        setCashier(assertion);
+        setLocked(false);
+    }, []);
+    const signOutCashier = useCallback(()=>setCashier(null), []);
+    const lock = useCallback(()=>{
+        setCashier(null);
+        setLocked(true);
+    }, []);
+    const unlock = useCallback(()=>{
+        lastActivity.current = Date.now();
+        setLocked(false);
+    }, []);
+    return {
+        cashier,
+        assertion: cashier == null ? void 0 : cashier.assertion,
+        locked,
+        switchTo,
+        signOutCashier,
+        lock,
+        unlock
+    };
+}
+
+//# sourceMappingURL=use-pos-cashier.js.map

package/src/lib/components/console/pos-ops/use-pos-cashier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/use-pos-cashier.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'use client'\n\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport { callPosOps } from './pos-ops-api'\nimport type { PosStaffAssertion } from './pos-pin-pad.component'\n\n/** Refresh a cashier assertion this long before it expires. */\nconst REFRESH_MARGIN_MS = 3 * 60 * 1000\n/** How often the register checks the idle clock and the expiry. */\nconst TICK_MS = 15 * 1000\n\nexport interface PosCashierState {\n  /** The member a PIN switched in, or `null` for whoever is signed in. */\n  cashier: PosStaffAssertion | null\n  /** The assertion every register call carries, or `undefined`. */\n  assertion: string | undefined\n  /** The register is locked and waits for a PIN. */\n  locked: boolean\n  switchTo: (assertion: PosStaffAssertion) => void\n  /** Back to the signed-in member. */\n  signOutCashier: () => void\n  lock: () => void\n  /** Lifts a lock without a PIN: only for a site where nobody has one. */\n  unlock: () => void\n}\n\n/**\n * Who is at the register (AGL-3609).\n *\n * Holds the cashier a PIN switched in, refreshes their assertion while they\n * keep working (the server re-checks their role on every refresh), and LOCKS\n * the register after `autoLockMinutes` without a tap or a key — dropping the\n * assertion, so the next person has to enter their own PIN. An expired\n * assertion the refresh could not renew drops back to the signed-in member\n * rather than ringing sales under a name the server would refuse.\n */\nexport function usePosCashier(options: {\n  hostId: string\n  registerId: string\n  autoLockMinutes: number\n}): PosCashierState {\n  const { hostId, registerId, autoLockMinutes } = options\n  const { data: user } = useUser()\n  const [cashier, setCashier] = useState<PosStaffAssertion | null>(null)\n  const [locked, setLocked] = useState(false)\n  const lastActivity = useRef(Date.now())\n  const refreshing = useRef(false)\n\n  // A different register is a different till: nobody carries over.\n  useEffect(() => {\n    setCashier(null)\n    setLocked(false)\n  }, [hostId, registerId])\n\n  useEffect(() => {\n    const touch = () => {\n      lastActivity.current = Date.now()\n    }\n    window.addEventListener('pointerdown', touch, { passive: true })\n    window.addEventListener('keydown', touch)\n    return () => {\n      window.removeEventListener('pointerdown', touch)\n      window.removeEventListener('keydown', touch)\n    }\n  }, [])\n\n  useEffect(() => {\n    const timer = window.setInterval(() => {\n      const now = Date.now()\n      if (autoLockMinutes > 0 && !locked && now - lastActivity.current > autoLockMinutes * 60_000) {\n        setCashier(null)\n        setLocked(true)\n        return\n      }\n      if (!cashier) return\n      if (now >= cashier.expiresAtMs) {\n        setCashier(null)\n        return\n      }\n      if (cashier.expiresAtMs - now > REFRESH_MARGIN_MS || refreshing.current) return\n      // Only a cashier who is still working earns a fresh assertion.\n      if (now - lastActivity.current > REFRESH_MARGIN_MS) return\n      refreshing.current = true\n      void callPosOps<{ assertion?: string; expiresAtMs?: number }>(user, 'pos-staff-pin', {\n        hostId,\n        registerId,\n        action: 'refresh',\n        assertion: cashier.assertion,\n      }).then((answer) => {\n        refreshing.current = false\n        if (answer.ok && answer.body.assertion && answer.body.expiresAtMs) {\n          setCashier((current) =>\n            current && current.memberUid === cashier.memberUid\n              ? { ...current, assertion: answer.body.assertion!, expiresAtMs: answer.body.expiresAtMs! }\n              : current,\n          )\n        } else if (answer.status === 401 || answer.status === 403) {\n          setCashier(null)\n        }\n      })\n    }, TICK_MS)\n    return () => window.clearInterval(timer)\n  }, [autoLockMinutes, locked, cashier, user, hostId, registerId])\n\n  const switchTo = useCallback((assertion: PosStaffAssertion) => {\n    lastActivity.current = Date.now()\n    setCashier(assertion)\n    setLocked(false)\n  }, [])\n  const signOutCashier = useCallback(() => setCashier(null), [])\n  const lock = useCallback(() => {\n    setCashier(null)\n    setLocked(true)\n  }, [])\n  const unlock = useCallback(() => {\n    lastActivity.current = Date.now()\n    setLocked(false)\n  }, [])\n\n  return { cashier, assertion: cashier?.assertion, locked, switchTo, signOutCashier, lock, unlock }\n}\n"],"names":["useUser","useCallback","useEffect","useRef","useState","callPosOps","REFRESH_MARGIN_MS","TICK_MS","usePosCashier","options","hostId","registerId","autoLockMinutes","data","user","cashier","setCashier","locked","setLocked","lastActivity","Date","now","refreshing","touch","current","window","addEventListener","passive","removeEventListener","timer","setInterval","expiresAtMs","action","assertion","then","answer","ok","body","memberUid","status","clearInterval","switchTo","signOutCashier","lock","unlock"],"mappings":"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"}

package/src/lib/components/console/pos-ops/use-pos-sale-receipt.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 PosReceiptOrder } from '../../../model/commerce-pos-ops';
+export interface PosSaleReceipt {
+    /** The stored sale, once read; the receipt prints from it, never from the basket. */
+    order: (PosReceiptOrder & {
+        registerId?: string;
+    }) | null;
+    /** Prints the 80 mm receipt (or the gift receipt); false while the sale is unread. */
+    print: (gift?: boolean) => boolean;
+}
+/**
+ * The thermal receipt of one completed sale, for the tablet register's
+ * receipt step (AGL-3607): the same receipt, store header and gift option the
+ * operations strip prints (AGL-3609), read back from the stored order.
+ */
+export declare function usePosSaleReceipt(input: {
+    hostId: string;
+    orderId: string;
+    registerName?: string;
+    cashierName?: string;
+}): PosSaleReceipt;

package/src/lib/components/console/pos-ops/use-pos-sale-receipt.js

@@ -0,0 +1,64 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { doc } from "firebase/firestore";
+import { useCallback } from "react";
+import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
+import { buildPosReceipt } from "../../../model/commerce-pos-ops.js";
+import { usePosReceiptStore } from "./pos-receipt-actions.component.js";
+import { printPosReceipt } from "./pos-receipt.js";
+/**
+ * The thermal receipt of one completed sale, for the tablet register's
+ * receipt step (AGL-3607): the same receipt, store header and gift option the
+ * operations strip prints (AGL-3609), read back from the stored order.
+ */ export function usePosSaleReceipt(input) {
+    const { hostId, orderId, registerName, cashierName } = input;
+    const firestore = useFirestore();
+    const store = usePosReceiptStore(hostId);
+    const { data } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId, 'orders', orderId), [
+        firestore,
+        hostId,
+        orderId
+    ]);
+    const order = data != null ? data : null;
+    const print = useCallback((gift = false)=>{
+        if (!order) return false;
+        printPosReceipt(buildPosReceipt(_extends({
+            orderId,
+            order,
+            store,
+            gift
+        }, cashierName ? {
+            cashierName
+        } : {}, registerName ? {
+            registerName
+        } : {})));
+        return true;
+    }, [
+        order,
+        orderId,
+        store,
+        cashierName,
+        registerName
+    ]);
+    return {
+        order,
+        print
+    };
+}
+
+//# sourceMappingURL=use-pos-sale-receipt.js.map

package/src/lib/components/console/pos-ops/use-pos-sale-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/use-pos-sale-receipt.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'use client'\n\nimport { doc } from 'firebase/firestore'\nimport { useCallback } from 'react'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { buildPosReceipt, type PosReceiptOrder } from '../../../model/commerce-pos-ops'\nimport { usePosReceiptStore } from './pos-receipt-actions.component'\nimport { printPosReceipt } from './pos-receipt'\n\nexport interface PosSaleReceipt {\n  /** The stored sale, once read; the receipt prints from it, never from the basket. */\n  order: (PosReceiptOrder & { registerId?: string }) | null\n  /** Prints the 80 mm receipt (or the gift receipt); false while the sale is unread. */\n  print: (gift?: boolean) => boolean\n}\n\n/**\n * The thermal receipt of one completed sale, for the tablet register's\n * receipt step (AGL-3607): the same receipt, store header and gift option the\n * operations strip prints (AGL-3609), read back from the stored order.\n */\nexport function usePosSaleReceipt(input: {\n  hostId: string\n  orderId: string\n  registerName?: string\n  cashierName?: string\n}): PosSaleReceipt {\n  const { hostId, orderId, registerName, cashierName } = input\n  const firestore = useFirestore()\n  const store = usePosReceiptStore(hostId)\n  const { data } = useFirestoreDoc<PosReceiptOrder & { registerId?: string }>(\n    () => doc(firestore, 'hosts', hostId, 'orders', orderId),\n    [firestore, hostId, orderId],\n  )\n  const order = data ?? null\n  const print = useCallback(\n    (gift = false) => {\n      if (!order) return false\n      printPosReceipt(\n        buildPosReceipt({\n          orderId,\n          order,\n          store,\n          gift,\n          ...(cashierName ? { cashierName } : {}),\n          ...(registerName ? { registerName } : {}),\n        }),\n      )\n      return true\n    },\n    [order, orderId, store, cashierName, registerName],\n  )\n  return { order, print }\n}\n"],"names":["doc","useCallback","useFirestore","useFirestoreDoc","buildPosReceipt","usePosReceiptStore","printPosReceipt","usePosSaleReceipt","input","hostId","orderId","registerName","cashierName","firestore","store","data","order","print","gift"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;AAEA,SAASA,GAAG,QAAQ,qBAAoB;AACxC,SAASC,WAAW,QAAQ,QAAO;AACnC,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAC9E,SAASC,eAAe,QAA8B,qCAAiC;AACvF,SAASC,kBAAkB,QAAQ,qCAAiC;AACpE,SAASC,eAAe,QAAQ,mBAAe;AAS/C;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,KAKjC;IACC,MAAM,EAAEC,MAAM,EAAEC,OAAO,EAAEC,YAAY,EAAEC,WAAW,EAAE,GAAGJ;IACvD,MAAMK,YAAYX;IAClB,MAAMY,QAAQT,mBAAmBI;IACjC,MAAM,EAAEM,IAAI,EAAE,GAAGZ,gBACf,IAAMH,IAAIa,WAAW,SAASJ,QAAQ,UAAUC,UAChD;QAACG;QAAWJ;QAAQC;KAAQ;IAE9B,MAAMM,QAAQD,eAAAA,OAAQ;IACtB,MAAME,QAAQhB,YACZ,CAACiB,OAAO,KAAK;QACX,IAAI,CAACF,OAAO,OAAO;QACnBV,gBACEF,gBAAgB;YACdM;YACAM;YACAF;YACAI;WACIN,cAAc;YAAEA;QAAY,IAAI,CAAC,GACjCD,eAAe;YAAEA;QAAa,IAAI,CAAC;QAG3C,OAAO;IACT,GACA;QAACK;QAAON;QAASI;QAAOF;QAAaD;KAAa;IAEpD,OAAO;QAAEK;QAAOC;IAAM;AACxB"}

package/src/lib/components/console/pos-page.component.d.ts

@@ -1,4 +1,7 @@
 import type { ConsolePluginPageProps } from '@aglyn/aglyn';
+import { PRODUCT_LIST_QUERY } from '../../constants/product-list-query';
+import { type RegisterLine } from './pos/pos-cart-panel.component';
+import { type PosItemChoice } from './pos/pos-item-dialog.component';
 /**
  * The products hub's query (AGL-3321), narrowed to what the till may sell:
  * live products (`deletedAt == null`, the list's scope), `status == active`,
@@ -12,14 +15,19 @@ export declare function posProductPlan(options: {
         field: 'barcodes' | 'skus';
         value: string;
     };
+    /** A category chip (AGL-3607): served by the storefront's own composite. */
+    categoryId?: string;
+    /** The Quick keys chip (AGL-3607): products marked `posQuickKey`. */
+    quickKeys?: boolean;
 }): import("@aglyn/shared-ui-jsx/const/list-query-plan").ListQueryPlan;
 /**
- * POS register (AGL-312): touch-first full-screen sale surface —
- * product grid with search/barcode (keyboard-wedge scanners type into
- * the search box and press Enter), a register cart with a whole-sale
- * discount, and cash / QR-card / reservation-folio settlement through
- * the server-priced pos-order API. Receipts print via the browser.
+ * The grid's query: the products hub's, plus the category a chip picks
+ * (AGL-3607). `categoryIds CONTAINS, nameLower ASC` is a composite the
+ * storefront catalog already declares.
  */
+export declare const POS_GRID_QUERY: typeof PRODUCT_LIST_QUERY;
+/** The basket line an item-sheet choice makes: label and estimate from the product. */
+export declare function registerLineFor(product: any, choice: PosItemChoice): RegisterLine;
 export declare function PosConsolePage({ hostId }: ConsolePluginPageProps): import("react").JSX.Element;
 export declare namespace PosConsolePage {
     var displayName: string;