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

package/src/lib/components/console/pos-kiosk/kiosk-staff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-kiosk/kiosk-staff.tsx"],"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'use client'\n\nimport Alert from '@mui/material/Alert'\nimport Button from '@mui/material/Button'\nimport Dialog from '@mui/material/Dialog'\nimport DialogActions from '@mui/material/DialogActions'\nimport DialogContent from '@mui/material/DialogContent'\nimport DialogContentText from '@mui/material/DialogContentText'\nimport DialogTitle from '@mui/material/DialogTitle'\nimport MenuItem from '@mui/material/MenuItem'\nimport Stack from '@mui/material/Stack'\nimport TextField from '@mui/material/TextField'\nimport { type FormEvent, useEffect, useState } from 'react'\nimport { kioskApi, type PosKioskSettingsView } from './pos-kiosk-api'\n\n/**\n * Staff unlock (AGL-3623): a corner button, then the staff PIN the register\n * uses, checked on the server. No names are listed — the screen faces the\n * public — and a right PIN opens the kiosk's settings for a few minutes:\n * which card reader it sends payments to, and leaving kiosk mode.\n */\nexport function KioskStaffControl({\n  token,\n  onExit,\n  onUnauthorized,\n}: {\n  token: string\n  /** Kiosk mode was left: the device is unpaired. */\n  onExit: () => void\n  onUnauthorized: () => void\n}) {\n  const [stage, setStage] = useState<'closed' | 'pin' | 'settings'>('closed')\n  const [pin, setPin] = useState('')\n  const [unlock, setUnlock] = useState<{ unlock: string; expiresAtMs: number } | null>(null)\n  const [view, setView] = useState<PosKioskSettingsView | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n  const [confirmExit, setConfirmExit] = useState(false)\n\n  const close = () => {\n    setStage('closed')\n    setPin('')\n    setUnlock(null)\n    setView(null)\n    setError(null)\n    setConfirmExit(false)\n  }\n\n  // The unlock lapses on its own: the settings close with it.\n  useEffect(() => {\n    if (!unlock) return undefined\n    const timer = setTimeout(close, Math.max(0, unlock.expiresAtMs - Date.now()))\n    return () => clearTimeout(timer)\n  }, [unlock])\n\n  const submitPin = async (event: FormEvent) => {\n    event.preventDefault()\n    if (busy || pin.length < 4) return\n    setBusy(true)\n    setError(null)\n    const result = await kioskApi.unlock(token, pin)\n    setPin('')\n    if (!result.ok || !result.value) {\n      setBusy(false)\n      if (result.status === 401 && /not paired/i.test(result.error ?? '')) return onUnauthorized()\n      setError(result.error ?? 'That PIN is not right.')\n      return\n    }\n    const opened = await kioskApi.settings(token, result.value.unlock)\n    setBusy(false)\n    setUnlock(result.value)\n    setView(opened.value ?? null)\n    setStage('settings')\n  }\n\n  const chooseReader = async (readerId: string) => {\n    if (!unlock) return\n    setBusy(true)\n    const result = await kioskApi.setReader(token, unlock.unlock, readerId)\n    setBusy(false)\n    if (result.ok && result.value) setView(result.value)\n    else setError(result.error ?? 'The card reader could not be changed.')\n  }\n\n  const exit = async () => {\n    if (!unlock) return\n    setBusy(true)\n    const result = await kioskApi.exit(token, unlock.unlock)\n    setBusy(false)\n    if (!result.ok) {\n      setError(result.error ?? 'Kiosk mode could not be turned off.')\n      return\n    }\n    close()\n    onExit()\n  }\n\n  return (\n    <>\n      <Button\n        size=\"small\"\n        color=\"inherit\"\n        onClick={() => setStage('pin')}\n        sx={(theme) => ({ position: 'fixed', left: theme.spacing(1), top: theme.spacing(1), opacity: 0.4 })}\n      >\n        {'Staff'}\n      </Button>\n      <Dialog open={stage === 'pin'} onClose={() => (busy ? undefined : close())} maxWidth=\"xs\" fullWidth>\n        <form onSubmit={submitPin}>\n          <DialogTitle>{'Staff unlock'}</DialogTitle>\n          <DialogContent>\n            <Stack spacing={2} sx={{ pt: 1 }}>\n              <DialogContentText>{'Enter your register PIN.'}</DialogContentText>\n              <TextField\n                value={pin}\n                onChange={(event) => setPin(event.target.value.replace(/\\D/g, '').slice(0, 6))}\n                type=\"password\"\n                autoFocus\n                autoComplete=\"off\"\n                slotProps={{ htmlInput: { inputMode: 'numeric', pattern: '[0-9]*', maxLength: 6, 'aria-label': 'Staff PIN' } }}\n              />\n              {error ? <Alert severity=\"error\">{error}</Alert> : null}\n            </Stack>\n          </DialogContent>\n          <DialogActions>\n            <Button onClick={close} disabled={busy}>\n              {'Cancel'}\n            </Button>\n            <Button type=\"submit\" variant=\"contained\" disabled={busy || pin.length < 4}>\n              {busy ? 'Checking…' : 'Unlock'}\n            </Button>\n          </DialogActions>\n        </form>\n      </Dialog>\n      <Dialog open={stage === 'settings'} onClose={() => (busy ? undefined : close())} maxWidth=\"xs\" fullWidth>\n        <DialogTitle>{view?.label || 'Kiosk settings'}</DialogTitle>\n        <DialogContent>\n          <Stack spacing={2} sx={{ pt: 1 }}>\n            {view && view.readers.length > 0 ? (\n              <TextField\n                select\n                label=\"Card reader\"\n                value={view.readerId ?? ''}\n                disabled={busy}\n                onChange={(event) => void chooseReader(event.target.value)}\n              >\n                <MenuItem value=\"\">{'None — pay at counter only'}</MenuItem>\n                {view.readers.map((reader) => (\n                  <MenuItem key={reader.id} value={reader.id}>\n                    {`${reader.label} (${reader.status})`}\n                  </MenuItem>\n                ))}\n              </TextField>\n            ) : (\n              <DialogContentText>{'No card reader is assigned to this register.'}</DialogContentText>\n            )}\n            {confirmExit ? (\n              <Alert severity=\"warning\">\n                {'This unpairs the kiosk. To use it again, show a new kiosk code on the register.'}\n              </Alert>\n            ) : null}\n            {error ? <Alert severity=\"error\">{error}</Alert> : null}\n          </Stack>\n        </DialogContent>\n        <DialogActions>\n          {confirmExit ? (\n            <Button color=\"error\" variant=\"contained\" disabled={busy} onClick={() => void exit()}>\n              {'Exit kiosk mode'}\n            </Button>\n          ) : (\n            <Button color=\"error\" disabled={busy} onClick={() => setConfirmExit(true)}>\n              {'Exit kiosk mode'}\n            </Button>\n          )}\n          <Button onClick={() => window.location.reload()} disabled={busy}>\n            {'Reload'}\n          </Button>\n          <Button variant=\"contained\" onClick={close} disabled={busy}>\n            {'Done'}\n          </Button>\n        </DialogActions>\n      </Dialog>\n    </>\n  )\n}\n"],"names":["Alert","Button","Dialog","DialogActions","DialogContent","DialogContentText","DialogTitle","MenuItem","Stack","TextField","useEffect","useState","kioskApi","KioskStaffControl","token","onExit","onUnauthorized","view","stage","setStage","pin","setPin","unlock","setUnlock","setView","error","setError","busy","setBusy","confirmExit","setConfirmExit","close","undefined","timer","setTimeout","Math","max","expiresAtMs","Date","now","clearTimeout","submitPin","event","opened","preventDefault","length","result","ok","value","status","test","settings","chooseReader","readerId","setReader","exit","size","color","onClick","sx","theme","position","left","spacing","top","opacity","open","onClose","maxWidth","fullWidth","form","onSubmit","pt","onChange","target","replace","slice","type","autoFocus","autoComplete","slotProps","htmlInput","inputMode","pattern","maxLength","severity","disabled","variant","label","readers","select","map","reader","id","window","location","reload"],"mappings":"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"}

package/src/lib/components/console/pos-kiosk/pos-kiosk-api.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @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 * as CommerceModel from '../../../model';
+/**
+ * The self-service kiosk's half of `/api/commerce/pos-kiosk` (AGL-3623).
+ *
+ * Every call carries the kiosk's device token — the customer display's
+ * header, because a kiosk is paired exactly like one — and never a staff
+ * session. 401 means the kiosk was unpaired (or its register removed), which
+ * the page reads as "pair again".
+ */
+export declare const POS_KIOSK_ENDPOINT = "/api/commerce/pos-kiosk";
+/**
+ * Where the kiosk's token lives on the device: the ONE thing it stores.
+ * Nothing a customer chooses or types is ever written to storage.
+ */
+export declare const POS_KIOSK_TOKEN_KEY = "aglyn.posKioskToken";
+export interface PosKioskResult<T> {
+    ok: boolean;
+    /** The HTTP status, or 0 when the request never landed. */
+    status: number;
+    value?: T;
+    error?: string;
+}
+export declare function readKioskToken(): string | null;
+export declare function storeKioskToken(token: string | null): void;
+/** Every key the kiosk could own on this origin starts with this. */
+export declare const POS_KIOSK_STORAGE_PREFIX = "aglyn.posKiosk";
+/**
+ * The idle reset's storage sweep: every kiosk key in local and session
+ * storage but the device token. The kiosk keeps a customer's cart, email and
+ * phone in memory only, so on a working kiosk this finds nothing; it is the
+ * guarantee that nothing a customer chose outlives their turn should a later
+ * change ever persist some of it. Other pages' keys on the console origin
+ * are not the kiosk's to touch.
+ */
+export declare function clearKioskCustomerStorage(): void;
+export declare const kioskApi: {
+    context: (token: string) => Promise<PosKioskResult<CommerceModel.PosKioskContext>>;
+    catalog: (token: string, categoryId: string | null) => Promise<PosKioskResult<CommerceModel.PosKioskCatalog>>;
+    sale: (token: string, orderId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    checkout: (token: string, lines: CommerceModel.PosKioskLine[], attemptKey: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    pay: (token: string, input: {
+        orderId: string;
+        method: "reader" | "tap";
+        tipChoice: "percent" | "custom" | "none";
+        tipPercent?: number;
+        tipCents?: number;
+    }, attemptKey: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+        paymentId?: string;
+        clientSecret?: string;
+        paymentIntentId?: string;
+    }>>;
+    paymentStatus: (token: string, orderId: string, paymentId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    cancelPayment: (token: string, orderId: string, paymentId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    simulate: (token: string, orderId: string, paymentId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    counter: (token: string, orderId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    receipt: (token: string, input: {
+        orderId: string;
+        channel: CommerceModel.PosReceiptChannel;
+        to?: string;
+        marketingOptIn?: boolean;
+    }) => Promise<PosKioskResult<{
+        ok: true;
+    }>>;
+    abandon: (token: string, orderId: string) => Promise<PosKioskResult<{
+        sale: CommerceModel.PosKioskSale;
+    }>>;
+    unlock: (token: string, pin: string) => Promise<PosKioskResult<{
+        unlock: string;
+        expiresAtMs: number;
+    }>>;
+    settings: (token: string, unlock: string) => Promise<PosKioskResult<PosKioskSettingsView>>;
+    setReader: (token: string, unlock: string, readerId: string) => Promise<PosKioskResult<PosKioskSettingsView>>;
+    exit: (token: string, unlock: string) => Promise<PosKioskResult<{
+        ok: true;
+    }>>;
+};
+export interface PosKioskSettingsView {
+    readers: Array<{
+        id: string;
+        label: string;
+        status: string;
+    }>;
+    readerId: string | null;
+    label: string;
+}

package/src/lib/components/console/pos-kiosk/pos-kiosk-api.js

@@ -0,0 +1,189 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { POS_DISPLAY_TOKEN_HEADER } from "../pos-display/pos-display-api.js";
+/**
+ * The self-service kiosk's half of `/api/commerce/pos-kiosk` (AGL-3623).
+ *
+ * Every call carries the kiosk's device token — the customer display's
+ * header, because a kiosk is paired exactly like one — and never a staff
+ * session. 401 means the kiosk was unpaired (or its register removed), which
+ * the page reads as "pair again".
+ */ export const POS_KIOSK_ENDPOINT = '/api/commerce/pos-kiosk';
+/**
+ * Where the kiosk's token lives on the device: the ONE thing it stores.
+ * Nothing a customer chooses or types is ever written to storage.
+ */ export const POS_KIOSK_TOKEN_KEY = 'aglyn.posKioskToken';
+export function readKioskToken() {
+    try {
+        return window.localStorage.getItem(POS_KIOSK_TOKEN_KEY) || null;
+    } catch (unused) {
+        return null;
+    }
+}
+export function storeKioskToken(token) {
+    try {
+        if (token) window.localStorage.setItem(POS_KIOSK_TOKEN_KEY, token);
+        else window.localStorage.removeItem(POS_KIOSK_TOKEN_KEY);
+    } catch (unused) {
+    // Storage blocked: the kiosk works until it reloads, then asks for a code.
+    }
+}
+/** Every key the kiosk could own on this origin starts with this. */ export const POS_KIOSK_STORAGE_PREFIX = 'aglyn.posKiosk';
+/**
+ * The idle reset's storage sweep: every kiosk key in local and session
+ * storage but the device token. The kiosk keeps a customer's cart, email and
+ * phone in memory only, so on a working kiosk this finds nothing; it is the
+ * guarantee that nothing a customer chose outlives their turn should a later
+ * change ever persist some of it. Other pages' keys on the console origin
+ * are not the kiosk's to touch.
+ */ export function clearKioskCustomerStorage() {
+    for (const pick of [
+        ()=>window.localStorage,
+        ()=>window.sessionStorage
+    ]){
+        try {
+            const storage = pick();
+            const keys = [];
+            for(let index = 0; index < storage.length; index++){
+                const key = storage.key(index);
+                if (key && key.startsWith(POS_KIOSK_STORAGE_PREFIX) && key !== POS_KIOSK_TOKEN_KEY) keys.push(key);
+            }
+            for (const key of keys)storage.removeItem(key);
+        } catch (unused) {
+        // Blocked storage holds nothing to clear.
+        }
+    }
+}
+async function call(token, init) {
+    const headers = {
+        [POS_DISPLAY_TOKEN_HEADER]: token
+    };
+    if (init.method === 'POST') {
+        headers['Content-Type'] = 'application/json';
+        if (init.attemptKey) headers['Idempotency-Key'] = init.attemptKey;
+    }
+    try {
+        const response = await fetch(init.method === 'GET' ? `${POS_KIOSK_ENDPOINT}?${new URLSearchParams(init.query).toString()}` : POS_KIOSK_ENDPOINT, _extends({
+            method: init.method,
+            headers,
+            cache: 'no-store'
+        }, init.method === 'POST' ? {
+            body: JSON.stringify(init.body)
+        } : {}));
+        const payload = await response.json().catch(()=>null);
+        if (!response.ok) {
+            var _ref;
+            return {
+                ok: false,
+                status: response.status,
+                error: String((_ref = payload == null ? void 0 : payload['error']) != null ? _ref : 'Something went wrong. Try again.')
+            };
+        }
+        return {
+            ok: true,
+            status: response.status,
+            value: payload != null ? payload : {}
+        };
+    } catch (unused) {
+        return {
+            ok: false,
+            status: 0,
+            error: 'No connection. Try again.'
+        };
+    }
+}
+const post = (token, body, attemptKey)=>call(token, _extends({
+        method: 'POST',
+        body
+    }, attemptKey ? {
+        attemptKey
+    } : {}));
+export const kioskApi = {
+    context: (token)=>call(token, {
+            method: 'GET',
+            query: {
+                action: 'context'
+            }
+        }),
+    catalog: (token, categoryId)=>call(token, {
+            method: 'GET',
+            query: _extends({
+                action: 'catalog'
+            }, categoryId ? {
+                categoryId
+            } : {})
+        }),
+    sale: (token, orderId)=>call(token, {
+            method: 'GET',
+            query: {
+                action: 'sale',
+                orderId
+            }
+        }),
+    checkout: (token, lines, attemptKey)=>post(token, {
+            action: 'checkout',
+            lines
+        }, attemptKey),
+    pay: (token, input, attemptKey)=>post(token, _extends({
+            action: 'pay'
+        }, input), attemptKey),
+    paymentStatus: (token, orderId, paymentId)=>post(token, {
+            action: 'payment-status',
+            orderId,
+            paymentId
+        }),
+    cancelPayment: (token, orderId, paymentId)=>post(token, {
+            action: 'cancel-payment',
+            orderId,
+            paymentId
+        }),
+    simulate: (token, orderId, paymentId)=>post(token, {
+            action: 'simulate',
+            orderId,
+            paymentId
+        }),
+    counter: (token, orderId)=>post(token, {
+            action: 'counter',
+            orderId
+        }),
+    receipt: (token, input)=>post(token, _extends({
+            action: 'receipt'
+        }, input)),
+    abandon: (token, orderId)=>post(token, {
+            action: 'abandon',
+            orderId
+        }),
+    unlock: (token, pin)=>post(token, {
+            action: 'unlock',
+            pin
+        }),
+    settings: (token, unlock)=>post(token, {
+            action: 'settings',
+            unlock
+        }),
+    setReader: (token, unlock, readerId)=>post(token, {
+            action: 'set-reader',
+            unlock,
+            readerId
+        }),
+    exit: (token, unlock)=>post(token, {
+            action: 'exit',
+            unlock
+        })
+};
+
+//# sourceMappingURL=pos-kiosk-api.js.map

package/src/lib/components/console/pos-kiosk/pos-kiosk-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-kiosk/pos-kiosk-api.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 * as CommerceModel from '../../../model'\nimport { POS_DISPLAY_TOKEN_HEADER } from '../pos-display/pos-display-api'\n\n/**\n * The self-service kiosk's half of `/api/commerce/pos-kiosk` (AGL-3623).\n *\n * Every call carries the kiosk's device token — the customer display's\n * header, because a kiosk is paired exactly like one — and never a staff\n * session. 401 means the kiosk was unpaired (or its register removed), which\n * the page reads as \"pair again\".\n */\nexport const POS_KIOSK_ENDPOINT = '/api/commerce/pos-kiosk'\n\n/**\n * Where the kiosk's token lives on the device: the ONE thing it stores.\n * Nothing a customer chooses or types is ever written to storage.\n */\nexport const POS_KIOSK_TOKEN_KEY = 'aglyn.posKioskToken'\n\nexport interface PosKioskResult<T> {\n  ok: boolean\n  /** The HTTP status, or 0 when the request never landed. */\n  status: number\n  value?: T\n  error?: string\n}\n\nexport function readKioskToken(): string | null {\n  try {\n    return window.localStorage.getItem(POS_KIOSK_TOKEN_KEY) || null\n  } catch {\n    return null\n  }\n}\n\nexport function storeKioskToken(token: string | null): void {\n  try {\n    if (token) window.localStorage.setItem(POS_KIOSK_TOKEN_KEY, token)\n    else window.localStorage.removeItem(POS_KIOSK_TOKEN_KEY)\n  } catch {\n    // Storage blocked: the kiosk works until it reloads, then asks for a code.\n  }\n}\n\n/** Every key the kiosk could own on this origin starts with this. */\nexport const POS_KIOSK_STORAGE_PREFIX = 'aglyn.posKiosk'\n\n/**\n * The idle reset's storage sweep: every kiosk key in local and session\n * storage but the device token. The kiosk keeps a customer's cart, email and\n * phone in memory only, so on a working kiosk this finds nothing; it is the\n * guarantee that nothing a customer chose outlives their turn should a later\n * change ever persist some of it. Other pages' keys on the console origin\n * are not the kiosk's to touch.\n */\nexport function clearKioskCustomerStorage(): void {\n  for (const pick of [() => window.localStorage, () => window.sessionStorage]) {\n    try {\n      const storage = pick()\n      const keys: string[] = []\n      for (let index = 0; index < storage.length; index++) {\n        const key = storage.key(index)\n        if (key && key.startsWith(POS_KIOSK_STORAGE_PREFIX) && key !== POS_KIOSK_TOKEN_KEY) keys.push(key)\n      }\n      for (const key of keys) storage.removeItem(key)\n    } catch {\n      // Blocked storage holds nothing to clear.\n    }\n  }\n}\n\nasync function call<T>(\n  token: string,\n  init: { method: 'GET'; query: Record<string, string> } | { method: 'POST'; body: Record<string, unknown>; attemptKey?: string },\n): Promise<PosKioskResult<T>> {\n  const headers: Record<string, string> = { [POS_DISPLAY_TOKEN_HEADER]: token }\n  if (init.method === 'POST') {\n    headers['Content-Type'] = 'application/json'\n    if (init.attemptKey) headers['Idempotency-Key'] = init.attemptKey\n  }\n  try {\n    const response = await fetch(\n      init.method === 'GET'\n        ? `${POS_KIOSK_ENDPOINT}?${new URLSearchParams(init.query).toString()}`\n        : POS_KIOSK_ENDPOINT,\n      {\n        method: init.method,\n        headers,\n        cache: 'no-store',\n        ...(init.method === 'POST' ? { body: JSON.stringify(init.body) } : {}),\n      },\n    )\n    const payload = (await response.json().catch(() => null)) as Record<string, unknown> | null\n    if (!response.ok) {\n      return {\n        ok: false,\n        status: response.status,\n        error: String(payload?.['error'] ?? 'Something went wrong. Try again.'),\n      }\n    }\n    return { ok: true, status: response.status, value: (payload ?? {}) as T }\n  } catch {\n    return { ok: false, status: 0, error: 'No connection. Try again.' }\n  }\n}\n\nconst post = <T>(token: string, body: Record<string, unknown>, attemptKey?: string) =>\n  call<T>(token, { method: 'POST', body, ...(attemptKey ? { attemptKey } : {}) })\n\nexport const kioskApi = {\n  context: (token: string) => call<CommerceModel.PosKioskContext>(token, { method: 'GET', query: { action: 'context' } }),\n  catalog: (token: string, categoryId: string | null) =>\n    call<CommerceModel.PosKioskCatalog>(token, {\n      method: 'GET',\n      query: { action: 'catalog', ...(categoryId ? { categoryId } : {}) },\n    }),\n  sale: (token: string, orderId: string) =>\n    call<{ sale: CommerceModel.PosKioskSale }>(token, { method: 'GET', query: { action: 'sale', orderId } }),\n  checkout: (token: string, lines: CommerceModel.PosKioskLine[], attemptKey: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'checkout', lines }, attemptKey),\n  pay: (\n    token: string,\n    input: {\n      orderId: string\n      method: 'reader' | 'tap'\n      tipChoice: 'percent' | 'custom' | 'none'\n      tipPercent?: number\n      tipCents?: number\n    },\n    attemptKey: string,\n  ) =>\n    post<{ sale: CommerceModel.PosKioskSale; paymentId?: string; clientSecret?: string; paymentIntentId?: string }>(\n      token,\n      { action: 'pay', ...input },\n      attemptKey,\n    ),\n  paymentStatus: (token: string, orderId: string, paymentId: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'payment-status', orderId, paymentId }),\n  cancelPayment: (token: string, orderId: string, paymentId: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'cancel-payment', orderId, paymentId }),\n  simulate: (token: string, orderId: string, paymentId: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'simulate', orderId, paymentId }),\n  counter: (token: string, orderId: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'counter', orderId }),\n  receipt: (\n    token: string,\n    input: { orderId: string; channel: CommerceModel.PosReceiptChannel; to?: string; marketingOptIn?: boolean },\n  ) => post<{ ok: true }>(token, { action: 'receipt', ...input }),\n  abandon: (token: string, orderId: string) =>\n    post<{ sale: CommerceModel.PosKioskSale }>(token, { action: 'abandon', orderId }),\n  unlock: (token: string, pin: string) => post<{ unlock: string; expiresAtMs: number }>(token, { action: 'unlock', pin }),\n  settings: (token: string, unlock: string) =>\n    post<PosKioskSettingsView>(token, { action: 'settings', unlock }),\n  setReader: (token: string, unlock: string, readerId: string) =>\n    post<PosKioskSettingsView>(token, { action: 'set-reader', unlock, readerId }),\n  exit: (token: string, unlock: string) => post<{ ok: true }>(token, { action: 'exit', unlock }),\n}\n\nexport interface PosKioskSettingsView {\n  readers: Array<{ id: string; label: string; status: string }>\n  readerId: string | null\n  label: string\n}\n"],"names":["POS_DISPLAY_TOKEN_HEADER","POS_KIOSK_ENDPOINT","POS_KIOSK_TOKEN_KEY","readKioskToken","window","localStorage","getItem","storeKioskToken","token","setItem","removeItem","POS_KIOSK_STORAGE_PREFIX","clearKioskCustomerStorage","pick","sessionStorage","storage","keys","index","length","key","startsWith","push","call","init","headers","method","attemptKey","response","fetch","URLSearchParams","query","toString","cache","body","JSON","stringify","payload","json","catch","ok","status","error","String","value","post","kioskApi","context","action","catalog","categoryId","sale","orderId","checkout","lines","pay","input","paymentStatus","paymentId","cancelPayment","simulate","counter","receipt","abandon","unlock","pin","settings","setReader","readerId","exit"],"mappings":"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"}

package/src/lib/components/console/pos-kiosk/use-kiosk-idle.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The kiosk's idle clock (AGL-3623). While `active`, every touch, click or
+ * key restarts it; after `idleSeconds` of nothing it starts a visible
+ * `warningSeconds` countdown ("Still there?"), and when that runs out it
+ * calls `onExpire` — the page's reset, which clears the cart and anything
+ * the customer typed. A touch during the countdown cancels it.
+ */
+export declare function useKioskIdle(options: {
+    active: boolean;
+    idleSeconds: number;
+    warningSeconds: number;
+    onExpire: () => void;
+}): {
+    warning: number | null;
+    stillHere: () => void;
+};

package/src/lib/components/console/pos-kiosk/use-kiosk-idle.js

@@ -0,0 +1,80 @@
+/**
+ * @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 { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * The kiosk's idle clock (AGL-3623). While `active`, every touch, click or
+ * key restarts it; after `idleSeconds` of nothing it starts a visible
+ * `warningSeconds` countdown ("Still there?"), and when that runs out it
+ * calls `onExpire` — the page's reset, which clears the cart and anything
+ * the customer typed. A touch during the countdown cancels it.
+ */ export function useKioskIdle(options) {
+    const { active, idleSeconds, warningSeconds } = options;
+    const [warning, setWarning] = useState(null);
+    const lastTouch = useRef(Date.now());
+    const expire = useRef(options.onExpire);
+    expire.current = options.onExpire;
+    const stillHere = useCallback(()=>{
+        lastTouch.current = Date.now();
+        setWarning(null);
+    }, []);
+    useEffect(()=>{
+        if (!active) {
+            setWarning(null);
+            return undefined;
+        }
+        lastTouch.current = Date.now();
+        const touched = ()=>{
+            lastTouch.current = Date.now();
+            setWarning((current)=>current === null ? current : null);
+        };
+        const events = [
+            'pointerdown',
+            'keydown',
+            'touchstart',
+            'wheel'
+        ];
+        for (const event of events)window.addEventListener(event, touched, {
+            passive: true
+        });
+        const timer = setInterval(()=>{
+            const idleFor = (Date.now() - lastTouch.current) / 1000;
+            if (idleFor < idleSeconds) return;
+            const left = Math.ceil(idleSeconds + warningSeconds - idleFor);
+            if (left <= 0) {
+                lastTouch.current = Date.now();
+                setWarning(null);
+                expire.current();
+                return;
+            }
+            setWarning(left);
+        }, 1000);
+        return ()=>{
+            clearInterval(timer);
+            for (const event of events)window.removeEventListener(event, touched);
+        };
+    }, [
+        active,
+        idleSeconds,
+        warningSeconds
+    ]);
+    return {
+        warning,
+        stillHere
+    };
+}
+
+//# sourceMappingURL=use-kiosk-idle.js.map

package/src/lib/components/console/pos-kiosk/use-kiosk-idle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-kiosk/use-kiosk-idle.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'use client'\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\n/**\n * The kiosk's idle clock (AGL-3623). While `active`, every touch, click or\n * key restarts it; after `idleSeconds` of nothing it starts a visible\n * `warningSeconds` countdown (\"Still there?\"), and when that runs out it\n * calls `onExpire` — the page's reset, which clears the cart and anything\n * the customer typed. A touch during the countdown cancels it.\n */\nexport function useKioskIdle(options: {\n  active: boolean\n  idleSeconds: number\n  warningSeconds: number\n  onExpire: () => void\n}): { warning: number | null; stillHere: () => void } {\n  const { active, idleSeconds, warningSeconds } = options\n  const [warning, setWarning] = useState<number | null>(null)\n  const lastTouch = useRef(Date.now())\n  const expire = useRef(options.onExpire)\n  expire.current = options.onExpire\n\n  const stillHere = useCallback(() => {\n    lastTouch.current = Date.now()\n    setWarning(null)\n  }, [])\n\n  useEffect(() => {\n    if (!active) {\n      setWarning(null)\n      return undefined\n    }\n    lastTouch.current = Date.now()\n    const touched = () => {\n      lastTouch.current = Date.now()\n      setWarning((current) => (current === null ? current : null))\n    }\n    const events = ['pointerdown', 'keydown', 'touchstart', 'wheel'] as const\n    for (const event of events) window.addEventListener(event, touched, { passive: true })\n    const timer = setInterval(() => {\n      const idleFor = (Date.now() - lastTouch.current) / 1000\n      if (idleFor < idleSeconds) return\n      const left = Math.ceil(idleSeconds + warningSeconds - idleFor)\n      if (left <= 0) {\n        lastTouch.current = Date.now()\n        setWarning(null)\n        expire.current()\n        return\n      }\n      setWarning(left)\n    }, 1000)\n    return () => {\n      clearInterval(timer)\n      for (const event of events) window.removeEventListener(event, touched)\n    }\n  }, [active, idleSeconds, warningSeconds])\n\n  return { warning, stillHere }\n}\n"],"names":["useCallback","useEffect","useRef","useState","useKioskIdle","options","active","idleSeconds","warningSeconds","warning","setWarning","lastTouch","Date","now","expire","onExpire","current","stillHere","undefined","touched","events","event","window","addEventListener","passive","timer","setInterval","idleFor","left","Math","ceil","clearInterval","removeEventListener"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAEhE;;;;;;CAMC,GACD,OAAO,SAASC,aAAaC,OAK5B;IACC,MAAM,EAAEC,MAAM,EAAEC,WAAW,EAAEC,cAAc,EAAE,GAAGH;IAChD,MAAM,CAACI,SAASC,WAAW,GAAGP,SAAwB;IACtD,MAAMQ,YAAYT,OAAOU,KAAKC,GAAG;IACjC,MAAMC,SAASZ,OAAOG,QAAQU,QAAQ;IACtCD,OAAOE,OAAO,GAAGX,QAAQU,QAAQ;IAEjC,MAAME,YAAYjB,YAAY;QAC5BW,UAAUK,OAAO,GAAGJ,KAAKC,GAAG;QAC5BH,WAAW;IACb,GAAG,EAAE;IAELT,UAAU;QACR,IAAI,CAACK,QAAQ;YACXI,WAAW;YACX,OAAOQ;QACT;QACAP,UAAUK,OAAO,GAAGJ,KAAKC,GAAG;QAC5B,MAAMM,UAAU;YACdR,UAAUK,OAAO,GAAGJ,KAAKC,GAAG;YAC5BH,WAAW,CAACM,UAAaA,YAAY,OAAOA,UAAU;QACxD;QACA,MAAMI,SAAS;YAAC;YAAe;YAAW;YAAc;SAAQ;QAChE,KAAK,MAAMC,SAASD,OAAQE,OAAOC,gBAAgB,CAACF,OAAOF,SAAS;YAAEK,SAAS;QAAK;QACpF,MAAMC,QAAQC,YAAY;YACxB,MAAMC,UAAU,AAACf,CAAAA,KAAKC,GAAG,KAAKF,UAAUK,OAAO,AAAD,IAAK;YACnD,IAAIW,UAAUpB,aAAa;YAC3B,MAAMqB,OAAOC,KAAKC,IAAI,CAACvB,cAAcC,iBAAiBmB;YACtD,IAAIC,QAAQ,GAAG;gBACbjB,UAAUK,OAAO,GAAGJ,KAAKC,GAAG;gBAC5BH,WAAW;gBACXI,OAAOE,OAAO;gBACd;YACF;YACAN,WAAWkB;QACb,GAAG;QACH,OAAO;YACLG,cAAcN;YACd,KAAK,MAAMJ,SAASD,OAAQE,OAAOU,mBAAmB,CAACX,OAAOF;QAChE;IACF,GAAG;QAACb;QAAQC;QAAaC;KAAe;IAExC,OAAO;QAAEC;QAASQ;IAAU;AAC9B"}

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

@@ -0,0 +1,28 @@
+import type { ConsolePublicPageProps } from '@aglyn/aglyn';
+import * as CommerceModel from '../../model';
+import { type PosItemChoice } from './pos/pos-item-dialog.component';
+import { type KioskCartLine } from './pos-kiosk/kiosk-menu';
+/** How often the kiosk asks after a card payment in flight. */
+export declare const POS_KIOSK_PAYMENT_POLL_MS = 1500;
+/** A product as the register's item sheet takes it, from the kiosk's catalog. */
+export declare function kioskItemProduct(product: CommerceModel.PosKioskProduct): CommerceModel.HostProduct & {
+    $id: string;
+};
+/** The cart line a choice makes: same item and choices merge. */
+export declare function kioskCartLine(product: CommerceModel.PosKioskProduct, choice: PosItemChoice): KioskCartLine;
+/**
+ * The self-service kiosk (AGL-3623), served at `/kiosk/commerce/pos-kiosk`
+ * with no staff session: a customer builds their own order and pays on the
+ * register's card reader or Tap to Pay, or sends it to the counter.
+ *
+ * It holds one secret — the kiosk token from pairing — and everything the
+ * customer chooses or types lives in this component's memory only. The idle
+ * reset (and "Done", and "Start over") voids an unpaid order, drops the
+ * cart, the tip and any email or phone, sweeps the kiosk's storage keys, and
+ * remounts every screen, so the next customer finds nothing of the last.
+ */
+declare function PosKioskPage(_props: ConsolePublicPageProps): import("react").JSX.Element;
+declare namespace PosKioskPage {
+    var displayName: string;
+}
+export default PosKioskPage;