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

package/src/lib/components/console/pos-ops/pos-customer-lookup.component.js

@@ -0,0 +1,289 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Button, Chip, Dialog, DialogActions, DialogContent, DialogTitle, List, ListItemButton, ListItemText, Stack, TextField, Typography } from "@mui/material";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useEffect, useRef, useState } from "react";
+import { posMoney } from "../../../model/commerce-pos-ops.js";
+import { callPosOps } from "./pos-ops-api.js";
+/** How long typing pauses before the register asks. */ const SEARCH_DEBOUNCE_MS = 250;
+/**
+ * The customer at the register (AGL-3609): search the workspace's people by
+ * name, email or phone, see what they have bought here before, attach them
+ * to the sale — or add a new one in a few taps. Where the workspace keeps no
+ * people, it falls back to an email typed for the receipt.
+ */ export function PosCustomerLookup(props) {
+    const { hostId, value, onChange } = props;
+    const { data: user } = useUser();
+    const [text, setText] = useState('');
+    const [results, setResults] = useState([]);
+    const [available, setAvailable] = useState(true);
+    const [stats, setStats] = useState(null);
+    const [adding, setAdding] = useState(false);
+    const [draft, setDraft] = useState({
+        name: '',
+        email: '',
+        phone: ''
+    });
+    const [error, setError] = useState('');
+    const [busy, setBusy] = useState(false);
+    const latest = useRef(0);
+    useEffect(()=>{
+        const typed = text.trim();
+        if (typed.length < 2 || !user) {
+            setResults([]);
+            return;
+        }
+        const ticket = ++latest.current;
+        const timer = window.setTimeout(()=>{
+            void callPosOps(user, 'pos-customer', {
+                hostId,
+                action: 'search',
+                text: typed
+            }).then((answer)=>{
+                var _answer_body_customers;
+                if (ticket !== latest.current) return;
+                setAvailable(answer.body.available !== false);
+                setResults(answer.ok ? (_answer_body_customers = answer.body.customers) != null ? _answer_body_customers : [] : []);
+            });
+        }, SEARCH_DEBOUNCE_MS);
+        return ()=>window.clearTimeout(timer);
+    }, [
+        text,
+        user,
+        hostId
+    ]);
+    useEffect(()=>{
+        setStats(null);
+        if (!(value == null ? void 0 : value.email) || !user) return;
+        let active = true;
+        void callPosOps(user, 'pos-customer', {
+            hostId,
+            action: 'stats',
+            email: value.email
+        }).then((answer)=>{
+            if (active && answer.ok) {
+                var _answer_body_orderCount, _answer_body_lifetimeSpendCents;
+                setStats({
+                    orderCount: Number((_answer_body_orderCount = answer.body.orderCount) != null ? _answer_body_orderCount : 0),
+                    lifetimeSpendCents: Number((_answer_body_lifetimeSpendCents = answer.body.lifetimeSpendCents) != null ? _answer_body_lifetimeSpendCents : 0)
+                });
+            }
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        value == null ? void 0 : value.email,
+        user,
+        hostId
+    ]);
+    const pick = (customer)=>{
+        onChange(customer);
+        setText('');
+        setResults([]);
+    };
+    const typedEmail = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(text.trim()) ? text.trim().toLowerCase() : '';
+    const create = async ()=>{
+        var _answer_body_error;
+        setBusy(true);
+        setError('');
+        const answer = await callPosOps(user, 'pos-customer', _extends({
+            hostId,
+            action: 'create'
+        }, draft));
+        setBusy(false);
+        if (!answer.ok || !answer.body.customer) return setError((_answer_body_error = answer.body.error) != null ? _answer_body_error : 'Could not add the customer.');
+        pick(answer.body.customer);
+        setAdding(false);
+    };
+    if (value) {
+        return /*#__PURE__*/ _jsxs(Stack, {
+            direction: "row",
+            spacing: 1,
+            useFlexGap: true,
+            sx: {
+                alignItems: 'center',
+                flexWrap: 'wrap'
+            },
+            children: [
+                /*#__PURE__*/ _jsx(Chip, {
+                    label: value.name || value.email || 'Customer',
+                    onDelete: ()=>onChange(null),
+                    color: "primary",
+                    variant: "outlined"
+                }),
+                value.name && value.email ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: value.email
+                }) : null,
+                stats ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: stats.orderCount ? `${stats.orderCount} past ${stats.orderCount === 1 ? 'order' : 'orders'} · ${posMoney(stats.lifetimeSpendCents)} spent` : 'First order here'
+                }) : null
+            ]
+        });
+    }
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 0.5,
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                children: [
+                    /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Customer",
+                        placeholder: available ? 'Name, email or phone' : 'Email for the receipt',
+                        value: text,
+                        onChange: (event)=>setText(event.target.value),
+                        onKeyDown: (event)=>{
+                            if (event.key === 'Enter' && !available && typedEmail) {
+                                pick({
+                                    kind: 'none',
+                                    id: '',
+                                    name: '',
+                                    email: typedEmail,
+                                    phone: null
+                                });
+                            }
+                        },
+                        sx: {
+                            flex: 1
+                        }
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        onClick: ()=>{
+                            setDraft({
+                                name: '',
+                                email: typedEmail,
+                                phone: ''
+                            });
+                            setError('');
+                            setAdding(true);
+                        },
+                        children: 'New customer'
+                    })
+                ]
+            }),
+            results.length ? /*#__PURE__*/ _jsx(List, {
+                dense: true,
+                disablePadding: true,
+                children: results.map((customer)=>/*#__PURE__*/ _jsx(ListItemButton, {
+                        onClick: ()=>pick(customer),
+                        children: /*#__PURE__*/ _jsx(ListItemText, {
+                            primary: customer.name || customer.email || 'Unnamed',
+                            secondary: [
+                                customer.email,
+                                customer.phone
+                            ].filter(Boolean).join(' · ')
+                        })
+                    }, `${customer.kind}:${customer.id}`))
+            }) : null,
+            !available && typedEmail ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>pick({
+                        kind: 'none',
+                        id: '',
+                        name: '',
+                        email: typedEmail,
+                        phone: null
+                    }),
+                sx: {
+                    alignSelf: 'flex-start'
+                },
+                children: `Use ${typedEmail}`
+            }) : null,
+            /*#__PURE__*/ _jsxs(Dialog, {
+                open: adding,
+                onClose: ()=>setAdding(false),
+                maxWidth: "xs",
+                fullWidth: true,
+                children: [
+                    /*#__PURE__*/ _jsx(DialogTitle, {
+                        children: 'New customer'
+                    }),
+                    /*#__PURE__*/ _jsx(DialogContent, {
+                        children: /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 2,
+                            sx: {
+                                pt: 1
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    autoFocus: true,
+                                    label: "Name",
+                                    value: draft.name,
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            name: event.target.value
+                                        }))
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Email",
+                                    type: "email",
+                                    value: draft.email,
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            email: event.target.value
+                                        }))
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Phone (optional)",
+                                    type: "tel",
+                                    value: draft.phone,
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            phone: event.target.value
+                                        }))
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: 'Adding a customer does not sign them up for marketing email.'
+                                }),
+                                error ? /*#__PURE__*/ _jsx(Alert, {
+                                    severity: "warning",
+                                    children: error
+                                }) : null
+                            ]
+                        })
+                    }),
+                    /*#__PURE__*/ _jsxs(DialogActions, {
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, {
+                                onClick: ()=>setAdding(false),
+                                children: 'Cancel'
+                            }),
+                            /*#__PURE__*/ _jsx(Button, {
+                                variant: "contained",
+                                disabled: busy,
+                                onClick: create,
+                                children: 'Add customer'
+                            })
+                        ]
+                    })
+                ]
+            })
+        ]
+    });
+}
+PosCustomerLookup.displayName = 'PosCustomerLookup';
+export default PosCustomerLookup;
+
+//# sourceMappingURL=pos-customer-lookup.component.js.map

package/src/lib/components/console/pos-ops/pos-customer-lookup.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/pos-customer-lookup.component.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\n'use client'\n\nimport {\n  Alert,\n  Button,\n  Chip,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  List,\n  ListItemButton,\n  ListItemText,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useEffect, useRef, useState } from 'react'\nimport { posMoney } from '../../../model/commerce-pos-ops'\nimport { callPosOps } from './pos-ops-api'\n\n/** The customer a sale is rung for. `id` is empty when no record system keeps people. */\nexport interface PosSelectedCustomer {\n  kind: string\n  id: string\n  name: string\n  email: string | null\n  phone: string | null\n}\n\nexport interface PosCustomerLookupProps {\n  hostId: string\n  value: PosSelectedCustomer | null\n  onChange: (customer: PosSelectedCustomer | null) => void\n}\n\n/** How long typing pauses before the register asks. */\nconst SEARCH_DEBOUNCE_MS = 250\n\n/**\n * The customer at the register (AGL-3609): search the workspace's people by\n * name, email or phone, see what they have bought here before, attach them\n * to the sale — or add a new one in a few taps. Where the workspace keeps no\n * people, it falls back to an email typed for the receipt.\n */\nexport function PosCustomerLookup(props: PosCustomerLookupProps) {\n  const { hostId, value, onChange } = props\n  const { data: user } = useUser()\n  const [text, setText] = useState('')\n  const [results, setResults] = useState<PosSelectedCustomer[]>([])\n  const [available, setAvailable] = useState(true)\n  const [stats, setStats] = useState<{ orderCount: number; lifetimeSpendCents: number } | null>(null)\n  const [adding, setAdding] = useState(false)\n  const [draft, setDraft] = useState({ name: '', email: '', phone: '' })\n  const [error, setError] = useState('')\n  const [busy, setBusy] = useState(false)\n  const latest = useRef(0)\n\n  useEffect(() => {\n    const typed = text.trim()\n    if (typed.length < 2 || !user) {\n      setResults([])\n      return\n    }\n    const ticket = ++latest.current\n    const timer = window.setTimeout(() => {\n      void callPosOps<{ available?: boolean; customers?: PosSelectedCustomer[] }>(user, 'pos-customer', {\n        hostId,\n        action: 'search',\n        text: typed,\n      }).then((answer) => {\n        if (ticket !== latest.current) return\n        setAvailable(answer.body.available !== false)\n        setResults(answer.ok ? (answer.body.customers ?? []) : [])\n      })\n    }, SEARCH_DEBOUNCE_MS)\n    return () => window.clearTimeout(timer)\n  }, [text, user, hostId])\n\n  useEffect(() => {\n    setStats(null)\n    if (!value?.email || !user) return\n    let active = true\n    void callPosOps<{ orderCount?: number; lifetimeSpendCents?: number }>(user, 'pos-customer', {\n      hostId,\n      action: 'stats',\n      email: value.email,\n    }).then((answer) => {\n      if (active && answer.ok) {\n        setStats({\n          orderCount: Number(answer.body.orderCount ?? 0),\n          lifetimeSpendCents: Number(answer.body.lifetimeSpendCents ?? 0),\n        })\n      }\n    })\n    return () => {\n      active = false\n    }\n  }, [value?.email, user, hostId])\n\n  const pick = (customer: PosSelectedCustomer) => {\n    onChange(customer)\n    setText('')\n    setResults([])\n  }\n\n  const typedEmail = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(text.trim()) ? text.trim().toLowerCase() : ''\n\n  const create = async () => {\n    setBusy(true)\n    setError('')\n    const answer = await callPosOps<{ customer?: PosSelectedCustomer }>(user, 'pos-customer', {\n      hostId,\n      action: 'create',\n      ...draft,\n    })\n    setBusy(false)\n    if (!answer.ok || !answer.body.customer) return setError(answer.body.error ?? 'Could not add the customer.')\n    pick(answer.body.customer)\n    setAdding(false)\n  }\n\n  if (value) {\n    return (\n      <Stack direction=\"row\" spacing={1} useFlexGap sx={{ alignItems: 'center', flexWrap: 'wrap' }}>\n        <Chip\n          label={value.name || value.email || 'Customer'}\n          onDelete={() => onChange(null)}\n          color=\"primary\"\n          variant=\"outlined\"\n        />\n        {value.name && value.email ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {value.email}\n          </Typography>\n        ) : null}\n        {stats ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {stats.orderCount\n              ? `${stats.orderCount} past ${stats.orderCount === 1 ? 'order' : 'orders'} · ${posMoney(\n                  stats.lifetimeSpendCents,\n                )} spent`\n              : 'First order here'}\n          </Typography>\n        ) : null}\n      </Stack>\n    )\n  }\n\n  return (\n    <Stack spacing={0.5}>\n      <Stack direction=\"row\" spacing={1}>\n        <TextField\n          size=\"small\"\n          label=\"Customer\"\n          placeholder={available ? 'Name, email or phone' : 'Email for the receipt'}\n          value={text}\n          onChange={(event) => setText(event.target.value)}\n          onKeyDown={(event) => {\n            if (event.key === 'Enter' && !available && typedEmail) {\n              pick({ kind: 'none', id: '', name: '', email: typedEmail, phone: null })\n            }\n          }}\n          sx={{ flex: 1 }}\n        />\n        <Button\n          size=\"small\"\n          onClick={() => {\n            setDraft({ name: '', email: typedEmail, phone: '' })\n            setError('')\n            setAdding(true)\n          }}\n        >\n          {'New customer'}\n        </Button>\n      </Stack>\n      {results.length ? (\n        <List dense disablePadding>\n          {results.map((customer) => (\n            <ListItemButton key={`${customer.kind}:${customer.id}`} onClick={() => pick(customer)}>\n              <ListItemText\n                primary={customer.name || customer.email || 'Unnamed'}\n                secondary={[customer.email, customer.phone].filter(Boolean).join(' · ')}\n              />\n            </ListItemButton>\n          ))}\n        </List>\n      ) : null}\n      {!available && typedEmail ? (\n        <Button size=\"small\" onClick={() => pick({ kind: 'none', id: '', name: '', email: typedEmail, phone: null })} sx={{ alignSelf: 'flex-start' }}>\n          {`Use ${typedEmail}`}\n        </Button>\n      ) : null}\n      <Dialog open={adding} onClose={() => setAdding(false)} maxWidth=\"xs\" fullWidth>\n        <DialogTitle>{'New customer'}</DialogTitle>\n        <DialogContent>\n          <Stack spacing={2} sx={{ pt: 1 }}>\n            <TextField\n              autoFocus\n              label=\"Name\"\n              value={draft.name}\n              onChange={(event) => setDraft({ ...draft, name: event.target.value })}\n            />\n            <TextField\n              label=\"Email\"\n              type=\"email\"\n              value={draft.email}\n              onChange={(event) => setDraft({ ...draft, email: event.target.value })}\n            />\n            <TextField\n              label=\"Phone (optional)\"\n              type=\"tel\"\n              value={draft.phone}\n              onChange={(event) => setDraft({ ...draft, phone: event.target.value })}\n            />\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'Adding a customer does not sign them up for marketing email.'}\n            </Typography>\n            {error ? <Alert severity=\"warning\">{error}</Alert> : null}\n          </Stack>\n        </DialogContent>\n        <DialogActions>\n          <Button onClick={() => setAdding(false)}>{'Cancel'}</Button>\n          <Button variant=\"contained\" disabled={busy} onClick={create}>\n            {'Add customer'}\n          </Button>\n        </DialogActions>\n      </Dialog>\n    </Stack>\n  )\n}\n\nPosCustomerLookup.displayName = 'PosCustomerLookup'\n\nexport default PosCustomerLookup\n"],"names":["Alert","Button","Chip","Dialog","DialogActions","DialogContent","DialogTitle","List","ListItemButton","ListItemText","Stack","TextField","Typography","useUser","useEffect","useRef","useState","posMoney","callPosOps","SEARCH_DEBOUNCE_MS","PosCustomerLookup","props","hostId","value","onChange","data","user","text","setText","results","setResults","available","setAvailable","stats","setStats","adding","setAdding","draft","setDraft","name","email","phone","error","setError","busy","setBusy","latest","typed","trim","length","ticket","current","timer","window","setTimeout","action","then","answer","body","ok","customers","clearTimeout","active","orderCount","Number","lifetimeSpendCents","pick","customer","typedEmail","test","toLowerCase","create","direction","spacing","useFlexGap","sx","alignItems","flexWrap","label","onDelete","color","variant","size","placeholder","event","target","onKeyDown","key","kind","id","flex","onClick","dense","disablePadding","map","primary","secondary","filter","Boolean","join","alignSelf","open","onClose","maxWidth","fullWidth","pt","autoFocus","type","severity","disabled","displayName"],"mappings":"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"}

package/src/lib/components/console/pos-ops/pos-last-receipt.component.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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.
+ */
+export interface PosLastReceiptProps {
+    hostId: string;
+    orderId: string;
+    registerName?: string;
+    /** The cashier's name as the receipt prints it. */
+    cashierName?: string;
+}
+/**
+ * The register's last sale (AGL-3609): its receipt and gift receipt for the
+ * browser's print dialog, read from the stored order — so the printout
+ * carries the tenders, tip and change the server recorded, not the basket the
+ * register remembers — and the register's cloud printer when it has one.
+ */
+export declare function PosLastReceipt(props: PosLastReceiptProps): import("react").JSX.Element;
+export declare namespace PosLastReceipt {
+    var displayName: string;
+}
+export default PosLastReceipt;

package/src/lib/components/console/pos-ops/pos-last-receipt.component.js

@@ -0,0 +1,61 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Stack, Typography } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
+import { PosReceiptActions } from "./pos-receipt-actions.component.js";
+/**
+ * The register's last sale (AGL-3609): its receipt and gift receipt for the
+ * browser's print dialog, read from the stored order — so the printout
+ * carries the tenders, tip and change the server recorded, not the basket the
+ * register remembers — and the register's cloud printer when it has one.
+ */ export function PosLastReceipt(props) {
+    const firestore = useFirestore();
+    const { data: order } = useFirestoreDoc(()=>doc(firestore, 'hosts', props.hostId, 'orders', props.orderId), [
+        firestore,
+        props.hostId,
+        props.orderId
+    ]);
+    if (!order) return null;
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 0.5,
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                children: order.number ? `Last sale #${order.number}` : 'Last sale'
+            }),
+            /*#__PURE__*/ _jsx(PosReceiptActions, _extends({
+                hostId: props.hostId,
+                orderId: props.orderId,
+                order: _extends({}, order, props.cashierName ? {
+                    cashierName: props.cashierName
+                } : {})
+            }, props.registerName ? {
+                registerName: props.registerName
+            } : {}, {
+                cloudPrint: "sale"
+            }))
+        ]
+    });
+}
+PosLastReceipt.displayName = 'PosLastReceipt';
+export default PosLastReceipt;
+
+//# sourceMappingURL=pos-last-receipt.component.js.map

package/src/lib/components/console/pos-ops/pos-last-receipt.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/pos-last-receipt.component.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\n'use client'\n\nimport { Stack, Typography } from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport type { PosReceiptOrder } from '../../../model/commerce-pos-ops'\nimport { PosReceiptActions } from './pos-receipt-actions.component'\n\nexport interface PosLastReceiptProps {\n  hostId: string\n  orderId: string\n  registerName?: string\n  /** The cashier's name as the receipt prints it. */\n  cashierName?: string\n}\n\n/**\n * The register's last sale (AGL-3609): its receipt and gift receipt for the\n * browser's print dialog, read from the stored order — so the printout\n * carries the tenders, tip and change the server recorded, not the basket the\n * register remembers — and the register's cloud printer when it has one.\n */\nexport function PosLastReceipt(props: PosLastReceiptProps) {\n  const firestore = useFirestore()\n  const { data: order } = useFirestoreDoc<PosReceiptOrder & { registerId?: string; number?: number }>(\n    () => doc(firestore, 'hosts', props.hostId, 'orders', props.orderId),\n    [firestore, props.hostId, props.orderId],\n  )\n  if (!order) return null\n  return (\n    <Stack spacing={0.5}>\n      <Typography variant=\"caption\" color=\"text.secondary\">\n        {order.number ? `Last sale #${order.number}` : 'Last sale'}\n      </Typography>\n      <PosReceiptActions\n        hostId={props.hostId}\n        orderId={props.orderId}\n        order={{ ...order, ...(props.cashierName ? { cashierName: props.cashierName } : {}) }}\n        {...(props.registerName ? { registerName: props.registerName } : {})}\n        cloudPrint=\"sale\"\n      />\n    </Stack>\n  )\n}\n\nPosLastReceipt.displayName = 'PosLastReceipt'\n\nexport default PosLastReceipt\n"],"names":["Stack","Typography","doc","useFirestore","useFirestoreDoc","PosReceiptActions","PosLastReceipt","props","firestore","data","order","hostId","orderId","spacing","variant","color","number","cashierName","registerName","cloudPrint","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAEA,SAASA,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACjD,SAASC,GAAG,QAAQ,qBAAoB;AACxC,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAE9E,SAASC,iBAAiB,QAAQ,qCAAiC;AAUnE;;;;;CAKC,GACD,OAAO,SAASC,eAAeC,KAA0B;IACvD,MAAMC,YAAYL;IAClB,MAAM,EAAEM,MAAMC,KAAK,EAAE,GAAGN,gBACtB,IAAMF,IAAIM,WAAW,SAASD,MAAMI,MAAM,EAAE,UAAUJ,MAAMK,OAAO,GACnE;QAACJ;QAAWD,MAAMI,MAAM;QAAEJ,MAAMK,OAAO;KAAC;IAE1C,IAAI,CAACF,OAAO,OAAO;IACnB,qBACE,MAACV;QAAMa,SAAS;;0BACd,KAACZ;gBAAWa,SAAQ;gBAAUC,OAAM;0BACjCL,MAAMM,MAAM,GAAG,CAAC,WAAW,EAAEN,MAAMM,MAAM,EAAE,GAAG;;0BAEjD,KAACX;gBACCM,QAAQJ,MAAMI,MAAM;gBACpBC,SAASL,MAAMK,OAAO;gBACtBF,OAAO,aAAKA,OAAWH,MAAMU,WAAW,GAAG;oBAAEA,aAAaV,MAAMU,WAAW;gBAAC,IAAI,CAAC;eAC5EV,MAAMW,YAAY,GAAG;gBAAEA,cAAcX,MAAMW,YAAY;YAAC,IAAI,CAAC;gBAClEC,YAAW;;;;AAInB;AAEAb,eAAec,WAAW,GAAG;AAE7B,eAAed,eAAc"}

package/src/lib/components/console/pos-ops/pos-operations-bar.component.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @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 { PosCashierState } from './use-pos-cashier';
+export interface PosOperationsBarProps {
+    hostId: string;
+    registerId: string;
+    registerName?: string;
+    cashier: PosCashierState;
+    /** Ring the exchange after a return: a new sale for the same customer. */
+    onExchange?: (customer: {
+        email: string | null;
+        name: string | null;
+    }) => void;
+}
+/**
+ * The register's operations strip (AGL-3609): who is ringing (and a PIN
+ * switch to someone else), the shift and drawer, returns, and the lock. Sits
+ * above the basket; every control is a tablet-sized button.
+ */
+export declare function PosOperationsBar(props: PosOperationsBarProps): import("react").JSX.Element;
+export declare namespace PosOperationsBar {
+    var displayName: string;
+}
+export default PosOperationsBar;

package/src/lib/components/console/pos-ops/pos-operations-bar.component.js

@@ -0,0 +1,129 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Button, Chip, Stack, Typography } from "@mui/material";
+import { useState } from "react";
+import { PosPinPad } from "./pos-pin-pad.component.js";
+import { PosReturnDialog } from "./pos-return-dialog.component.js";
+import { PosShiftPanel } from "./pos-shift-panel.component.js";
+/**
+ * The register's operations strip (AGL-3609): who is ringing (and a PIN
+ * switch to someone else), the shift and drawer, returns, and the lock. Sits
+ * above the basket; every control is a tablet-sized button.
+ */ export function PosOperationsBar(props) {
+    const { hostId, registerId, cashier } = props;
+    const [switching, setSwitching] = useState(false);
+    const [returning, setReturning] = useState(false);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1,
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                useFlexGap: true,
+                sx: {
+                    alignItems: 'center',
+                    flexWrap: 'wrap'
+                },
+                children: [
+                    /*#__PURE__*/ _jsx(Chip, _extends({
+                        size: "small",
+                        variant: "outlined",
+                        label: cashier.cashier ? `Cashier: ${cashier.cashier.name}` : 'Cashier: you'
+                    }, cashier.cashier ? {
+                        onDelete: cashier.signOutCashier
+                    } : {})),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        onClick: ()=>setSwitching(true),
+                        disabled: !registerId,
+                        children: 'Switch cashier'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        onClick: cashier.lock,
+                        disabled: !registerId,
+                        children: 'Lock'
+                    }),
+                    /*#__PURE__*/ _jsx(Box, {
+                        sx: {
+                            flex: 1
+                        }
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        variant: "outlined",
+                        onClick: ()=>setReturning(true),
+                        disabled: !registerId,
+                        children: 'Return'
+                    })
+                ]
+            }),
+            registerId ? /*#__PURE__*/ _jsx(PosShiftPanel, _extends({
+                hostId: hostId,
+                registerId: registerId
+            }, props.registerName ? {
+                registerName: props.registerName
+            } : {}, cashier.assertion ? {
+                cashierAssertion: cashier.assertion
+            } : {})) : null,
+            /*#__PURE__*/ _jsx(PosPinPad, {
+                open: switching,
+                hostId: hostId,
+                registerId: registerId,
+                purpose: "cashier",
+                onClose: ()=>setSwitching(false),
+                onVerified: (assertion)=>{
+                    cashier.switchTo(assertion);
+                    setSwitching(false);
+                }
+            }),
+            /*#__PURE__*/ _jsx(PosPinPad, {
+                open: cashier.locked,
+                hostId: hostId,
+                registerId: registerId,
+                purpose: "cashier",
+                title: "Register locked",
+                prompt: "Enter your PIN to use the register.",
+                dismissible: false,
+                onClose: cashier.unlock,
+                onVerified: cashier.switchTo
+            }),
+            /*#__PURE__*/ _jsx(PosReturnDialog, _extends({
+                open: returning,
+                hostId: hostId,
+                registerId: registerId
+            }, cashier.assertion ? {
+                cashierAssertion: cashier.assertion
+            } : {}, {
+                onClose: ()=>setReturning(false)
+            }, props.onExchange ? {
+                onExchange: props.onExchange
+            } : {})),
+            cashier.locked ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                children: 'Locked'
+            }) : null
+        ]
+    });
+}
+PosOperationsBar.displayName = 'PosOperationsBar';
+export default PosOperationsBar;
+
+//# sourceMappingURL=pos-operations-bar.component.js.map

package/src/lib/components/console/pos-ops/pos-operations-bar.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/pos-operations-bar.component.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\n'use client'\n\nimport { Box, Button, Chip, Stack, Typography } from '@mui/material'\nimport { useState } from 'react'\nimport { PosPinPad } from './pos-pin-pad.component'\nimport { PosReturnDialog } from './pos-return-dialog.component'\nimport { PosShiftPanel } from './pos-shift-panel.component'\nimport type { PosCashierState } from './use-pos-cashier'\n\nexport interface PosOperationsBarProps {\n  hostId: string\n  registerId: string\n  registerName?: string\n  cashier: PosCashierState\n  /** Ring the exchange after a return: a new sale for the same customer. */\n  onExchange?: (customer: { email: string | null; name: string | null }) => void\n}\n\n/**\n * The register's operations strip (AGL-3609): who is ringing (and a PIN\n * switch to someone else), the shift and drawer, returns, and the lock. Sits\n * above the basket; every control is a tablet-sized button.\n */\nexport function PosOperationsBar(props: PosOperationsBarProps) {\n  const { hostId, registerId, cashier } = props\n  const [switching, setSwitching] = useState(false)\n  const [returning, setReturning] = useState(false)\n  return (\n    <Stack spacing={1}>\n      <Stack direction=\"row\" spacing={1} useFlexGap sx={{ alignItems: 'center', flexWrap: 'wrap' }}>\n        <Chip\n          size=\"small\"\n          variant=\"outlined\"\n          label={cashier.cashier ? `Cashier: ${cashier.cashier.name}` : 'Cashier: you'}\n          {...(cashier.cashier ? { onDelete: cashier.signOutCashier } : {})}\n        />\n        <Button size=\"small\" onClick={() => setSwitching(true)} disabled={!registerId}>\n          {'Switch cashier'}\n        </Button>\n        <Button size=\"small\" onClick={cashier.lock} disabled={!registerId}>\n          {'Lock'}\n        </Button>\n        <Box sx={{ flex: 1 }} />\n        <Button size=\"small\" variant=\"outlined\" onClick={() => setReturning(true)} disabled={!registerId}>\n          {'Return'}\n        </Button>\n      </Stack>\n      {registerId ? (\n        <PosShiftPanel\n          hostId={hostId}\n          registerId={registerId}\n          {...(props.registerName ? { registerName: props.registerName } : {})}\n          {...(cashier.assertion ? { cashierAssertion: cashier.assertion } : {})}\n        />\n      ) : null}\n      <PosPinPad\n        open={switching}\n        hostId={hostId}\n        registerId={registerId}\n        purpose=\"cashier\"\n        onClose={() => setSwitching(false)}\n        onVerified={(assertion) => {\n          cashier.switchTo(assertion)\n          setSwitching(false)\n        }}\n      />\n      <PosPinPad\n        open={cashier.locked}\n        hostId={hostId}\n        registerId={registerId}\n        purpose=\"cashier\"\n        title=\"Register locked\"\n        prompt=\"Enter your PIN to use the register.\"\n        dismissible={false}\n        onClose={cashier.unlock}\n        onVerified={cashier.switchTo}\n      />\n      <PosReturnDialog\n        open={returning}\n        hostId={hostId}\n        registerId={registerId}\n        {...(cashier.assertion ? { cashierAssertion: cashier.assertion } : {})}\n        onClose={() => setReturning(false)}\n        {...(props.onExchange ? { onExchange: props.onExchange } : {})}\n      />\n      {cashier.locked ? (\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {'Locked'}\n        </Typography>\n      ) : null}\n    </Stack>\n  )\n}\n\nPosOperationsBar.displayName = 'PosOperationsBar'\n\nexport default PosOperationsBar\n"],"names":["Box","Button","Chip","Stack","Typography","useState","PosPinPad","PosReturnDialog","PosShiftPanel","PosOperationsBar","props","hostId","registerId","cashier","switching","setSwitching","returning","setReturning","spacing","direction","useFlexGap","sx","alignItems","flexWrap","size","variant","label","name","onDelete","signOutCashier","onClick","disabled","lock","flex","registerName","assertion","cashierAssertion","open","purpose","onClose","onVerified","switchTo","locked","title","prompt","dismissible","unlock","onExchange","color","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAEA,SAASA,GAAG,EAAEC,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACpE,SAASC,QAAQ,QAAQ,QAAO;AAChC,SAASC,SAAS,QAAQ,6BAAyB;AACnD,SAASC,eAAe,QAAQ,mCAA+B;AAC/D,SAASC,aAAa,QAAQ,iCAA6B;AAY3D;;;;CAIC,GACD,OAAO,SAASC,iBAAiBC,KAA4B;IAC3D,MAAM,EAAEC,MAAM,EAAEC,UAAU,EAAEC,OAAO,EAAE,GAAGH;IACxC,MAAM,CAACI,WAAWC,aAAa,GAAGV,SAAS;IAC3C,MAAM,CAACW,WAAWC,aAAa,GAAGZ,SAAS;IAC3C,qBACE,MAACF;QAAMe,SAAS;;0BACd,MAACf;gBAAMgB,WAAU;gBAAMD,SAAS;gBAAGE,UAAU;gBAACC,IAAI;oBAAEC,YAAY;oBAAUC,UAAU;gBAAO;;kCACzF,KAACrB;wBACCsB,MAAK;wBACLC,SAAQ;wBACRC,OAAOb,QAAQA,OAAO,GAAG,CAAC,SAAS,EAAEA,QAAQA,OAAO,CAACc,IAAI,EAAE,GAAG;uBACzDd,QAAQA,OAAO,GAAG;wBAAEe,UAAUf,QAAQgB,cAAc;oBAAC,IAAI,CAAC;kCAEjE,KAAC5B;wBAAOuB,MAAK;wBAAQM,SAAS,IAAMf,aAAa;wBAAOgB,UAAU,CAACnB;kCAChE;;kCAEH,KAACX;wBAAOuB,MAAK;wBAAQM,SAASjB,QAAQmB,IAAI;wBAAED,UAAU,CAACnB;kCACpD;;kCAEH,KAACZ;wBAAIqB,IAAI;4BAAEY,MAAM;wBAAE;;kCACnB,KAAChC;wBAAOuB,MAAK;wBAAQC,SAAQ;wBAAWK,SAAS,IAAMb,aAAa;wBAAOc,UAAU,CAACnB;kCACnF;;;;YAGJA,2BACC,KAACJ;gBACCG,QAAQA;gBACRC,YAAYA;eACPF,MAAMwB,YAAY,GAAG;gBAAEA,cAAcxB,MAAMwB,YAAY;YAAC,IAAI,CAAC,GAC7DrB,QAAQsB,SAAS,GAAG;gBAAEC,kBAAkBvB,QAAQsB,SAAS;YAAC,IAAI,CAAC,MAEpE;0BACJ,KAAC7B;gBACC+B,MAAMvB;gBACNH,QAAQA;gBACRC,YAAYA;gBACZ0B,SAAQ;gBACRC,SAAS,IAAMxB,aAAa;gBAC5ByB,YAAY,CAACL;oBACXtB,QAAQ4B,QAAQ,CAACN;oBACjBpB,aAAa;gBACf;;0BAEF,KAACT;gBACC+B,MAAMxB,QAAQ6B,MAAM;gBACpB/B,QAAQA;gBACRC,YAAYA;gBACZ0B,SAAQ;gBACRK,OAAM;gBACNC,QAAO;gBACPC,aAAa;gBACbN,SAAS1B,QAAQiC,MAAM;gBACvBN,YAAY3B,QAAQ4B,QAAQ;;0BAE9B,KAAClC;gBACC8B,MAAMrB;gBACNL,QAAQA;gBACRC,YAAYA;eACPC,QAAQsB,SAAS,GAAG;gBAAEC,kBAAkBvB,QAAQsB,SAAS;YAAC,IAAI,CAAC;gBACpEI,SAAS,IAAMtB,aAAa;eACvBP,MAAMqC,UAAU,GAAG;gBAAEA,YAAYrC,MAAMqC,UAAU;YAAC,IAAI,CAAC;YAE7DlC,QAAQ6B,MAAM,iBACb,KAACtC;gBAAWqB,SAAQ;gBAAUuB,OAAM;0BACjC;iBAED;;;AAGV;AAEAvC,iBAAiBwC,WAAW,GAAG;AAE/B,eAAexC,iBAAgB"}

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

@@ -0,0 +1,37 @@
+/**
+ * @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.
+ */
+/** The register's operations routes (AGL-3609). */
+export type PosOpsRoute = 'pos-shift' | 'pos-staff-pin' | 'pos-customer' | 'pos-return';
+export interface PosOpsAnswer<T = Record<string, any>> {
+    ok: boolean;
+    status: number;
+    body: T & {
+        error?: string;
+    };
+}
+/**
+ * One call to a register route, answered as data — a refusal is a status and
+ * a sentence for the cashier, never a throw the register has to catch. A
+ * network failure answers status 0.
+ */
+export declare function callPosOps<T = Record<string, any>>(user: unknown, route: PosOpsRoute, body: Record<string, unknown>, options?: {
+    idempotencyKey?: string;
+}): Promise<PosOpsAnswer<T>>;
+/** A fresh attempt id for one tap that moves money or cash. */
+export declare function newPosAttemptKey(): string;
+/** Dollars typed at the register → whole cents, or `null` for not-an-amount. */
+export declare function parsePosDollars(value: string): number | null;