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

package/src/lib/server/pos-shift.js

@@ -0,0 +1,484 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { createResourceUid } from "@aglyn/aglyn/app-utils/create-resource-uid";
+import { computePosShiftReport, posShiftPrintReport, posCashVarianceCents } from "../model/commerce-pos-ops.js";
+import { authorizePosOps, defaultPosOpsDeps, posOpsBody, posOpsCleanId, readPosRegister, resolvePosCashier } from "./pos-ops-gate.js";
+/*==========================================
+ * SHIFTS AND THE CASH DRAWER (AGL-3609): `POST /api/commerce/pos-shift`.
+ *
+ *   open        a starting float; refused while the register has a shift open
+ *   cash-event  paid in, paid out or a safe drop, with a reason
+ *   x-report    the open shift's figures so far, changing nothing
+ *   close       the counted cash, the Z report frozen onto the shift
+ *   current     the register's open shift, or none
+ *
+ * ONE OPEN SHIFT PER REGISTER is the register document's `openShiftId`,
+ * claimed and released inside the same transaction as the shift it names.
+ * Two tablets opening the same till at once both read the register; the
+ * transaction that commits second re-reads it, finds the first one's shift
+ * and refuses — there is no window in which both stand.
+ *=========================================*/ /** The most sales one report reads; past it the report says it is partial. */ export const POS_SHIFT_SALES_CEILING = 5000;
+/** The largest float or cash movement the drawer records in one entry. */ export const POS_CASH_ENTRY_MAX_CENTS = 10000000;
+const CASH_EVENT_TYPES = new Set([
+    'paid_in',
+    'paid_out',
+    'drop'
+]);
+function cents(value) {
+    const number = Number(value);
+    if (!Number.isFinite(number)) return null;
+    const rounded = Math.round(number);
+    return rounded >= 0 && rounded <= POS_CASH_ENTRY_MAX_CENTS ? rounded : null;
+}
+/**
+ * The figures for a shift, read from the sales stamped with it and the
+ * returns rung against it. Inside a transaction when one is given, so a Z
+ * report and the close it freezes see the same sales.
+ */ export async function readPosShiftReport(registerRef, hostRef, shiftId, shift, transaction) {
+    const salesQuery = hostRef.collection('orders').where('shiftId', '==', shiftId).limit(POS_SHIFT_SALES_CEILING + 1);
+    const returnsQuery = registerRef.collection('returns').where('shiftId', '==', shiftId).limit(2000);
+    const [salesSnapshot, returnsSnapshot] = transaction ? await Promise.all([
+        transaction.get(salesQuery),
+        transaction.get(returnsQuery)
+    ]) : await Promise.all([
+        salesQuery.get(),
+        returnsQuery.get()
+    ]);
+    const sales = salesSnapshot.docs.slice(0, POS_SHIFT_SALES_CEILING).map((doc)=>{
+        var _doc_data;
+        return (_doc_data = doc.data()) != null ? _doc_data : {};
+    });
+    const refunds = returnsSnapshot.docs.map((doc)=>{
+        var _doc_data, _data_refundedCents;
+        const data = (_doc_data = doc.data()) != null ? _doc_data : {};
+        const tenders = Array.isArray(data['tenders']) ? data['tenders'] : [];
+        return {
+            refundedCents: Number((_data_refundedCents = data['refundedCents']) != null ? _data_refundedCents : 0),
+            tenders: tenders.filter((tender)=>(tender == null ? void 0 : tender.status) !== 'failed').map((tender)=>{
+                var _tender_amountCents;
+                return {
+                    method: tender.method,
+                    amountCents: Number((_tender_amountCents = tender.amountCents) != null ? _tender_amountCents : 0)
+                };
+            })
+        };
+    });
+    return computePosShiftReport({
+        shift,
+        sales,
+        refunds,
+        truncated: salesSnapshot.docs.length > POS_SHIFT_SALES_CEILING
+    });
+}
+function shiftOf(data) {
+    var _data_openingFloatCents;
+    if (!data) return null;
+    return _extends({}, data, {
+        cashEvents: Array.isArray(data['cashEvents']) ? data['cashEvents'] : [],
+        openingFloatCents: Number((_data_openingFloatCents = data['openingFloatCents']) != null ? _data_openingFloatCents : 0)
+    });
+}
+export async function handlePosShift(deps, req) {
+    var _body_action;
+    if (req.method !== 'POST') return {
+        status: 405,
+        body: {
+            error: 'Method not allowed'
+        }
+    };
+    const body = posOpsBody(req);
+    const gate = await authorizePosOps(deps, req, body['hostId']);
+    if ('error' in gate) return {
+        status: gate.status,
+        body: {
+            error: gate.error
+        }
+    };
+    const staff = gate.staff;
+    const register = await readPosRegister(staff, body['registerId']);
+    if ('error' in register) return {
+        status: register.status,
+        body: {
+            error: register.error
+        }
+    };
+    const registerId = register.ref.id;
+    const { cashierId } = await resolvePosCashier(deps, staff, registerId, body['cashierAssertion']);
+    const action = String((_body_action = body['action']) != null ? _body_action : '');
+    const firestore = deps.firestore();
+    const shifts = register.ref.collection('shifts');
+    switch(action){
+        case 'current':
+            {
+                var _register_data_openShiftId;
+                const openShiftId = String((_register_data_openShiftId = register.data['openShiftId']) != null ? _register_data_openShiftId : '');
+                if (!openShiftId) return {
+                    status: 200,
+                    body: {
+                        shift: null
+                    }
+                };
+                const shift = shiftOf((await shifts.doc(openShiftId).get()).data());
+                return {
+                    status: 200,
+                    body: {
+                        shift: shift && shift.status === 'open' ? _extends({
+                            id: openShiftId
+                        }, shift) : null
+                    }
+                };
+            }
+        case 'open':
+            {
+                var _body_openingFloatCents;
+                const float = cents((_body_openingFloatCents = body['openingFloatCents']) != null ? _body_openingFloatCents : 0);
+                if (float == null) return {
+                    status: 400,
+                    body: {
+                        error: 'Enter the starting cash as an amount.'
+                    }
+                };
+                const shiftRef = shifts.doc(createResourceUid());
+                const now = deps.now();
+                const openedByName = await deps.memberName(cashierId);
+                return await firestore.runTransaction(async (transaction)=>{
+                    var _fresh_get;
+                    const fresh = await transaction.get(register.ref);
+                    const standing = String((_fresh_get = fresh.get('openShiftId')) != null ? _fresh_get : '');
+                    if (standing) {
+                        const standingShift = await transaction.get(shifts.doc(standing));
+                        if (standingShift.exists && standingShift.get('status') === 'open') {
+                            return {
+                                status: 409,
+                                body: {
+                                    error: 'This register already has a shift open. Close it before opening another.',
+                                    shiftId: standing
+                                }
+                            };
+                        }
+                    }
+                    const shift = {
+                        hostId: staff.hostId,
+                        registerId,
+                        status: 'open',
+                        openedBy: cashierId,
+                        openedByName,
+                        openedAtMs: now,
+                        openingFloatCents: float,
+                        cashEvents: []
+                    };
+                    transaction.create(shiftRef, shift);
+                    transaction.update(register.ref, {
+                        openShiftId: shiftRef.id
+                    });
+                    return {
+                        status: 200,
+                        body: {
+                            shift: _extends({
+                                id: shiftRef.id
+                            }, shift)
+                        }
+                    };
+                });
+            }
+        case 'cash-event':
+            {
+                var _body_type, _body_reason;
+                const type = String((_body_type = body['type']) != null ? _body_type : '');
+                if (!CASH_EVENT_TYPES.has(type)) {
+                    return {
+                        status: 400,
+                        body: {
+                            error: 'Choose paid in, paid out or a safe drop.'
+                        }
+                    };
+                }
+                const amount = cents(body['amountCents']);
+                if (!amount) return {
+                    status: 400,
+                    body: {
+                        error: 'Enter an amount above zero.'
+                    }
+                };
+                const reason = String((_body_reason = body['reason']) != null ? _body_reason : '').trim().slice(0, 200);
+                if (!reason && type !== 'drop') {
+                    return {
+                        status: 400,
+                        body: {
+                            error: 'Say what the cash was for.'
+                        }
+                    };
+                }
+                const eventId = posOpsCleanId(body['eventId']) || createResourceUid();
+                const recorded = await firestore.runTransaction(async (transaction)=>{
+                    var _fresh_get;
+                    const fresh = await transaction.get(register.ref);
+                    const shiftId = String((_fresh_get = fresh.get('openShiftId')) != null ? _fresh_get : '');
+                    if (!shiftId) return {
+                        status: 409,
+                        body: {
+                            error: 'Open a shift first.'
+                        }
+                    };
+                    const shiftRef = shifts.doc(shiftId);
+                    const shift = shiftOf((await transaction.get(shiftRef)).data());
+                    if (!shift || shift.status !== 'open') {
+                        return {
+                            status: 409,
+                            body: {
+                                error: 'Open a shift first.'
+                            }
+                        };
+                    }
+                    // A retried tap carries the same id: recorded once, answered twice.
+                    if (shift.cashEvents.some((event)=>event.id === eventId)) {
+                        return {
+                            status: 200,
+                            body: {
+                                shift: _extends({
+                                    id: shiftId
+                                }, shift),
+                                replayed: true
+                            }
+                        };
+                    }
+                    const event = {
+                        id: eventId,
+                        type,
+                        amountCents: amount,
+                        reason,
+                        by: cashierId,
+                        atMs: deps.now()
+                    };
+                    const cashEvents = [
+                        ...shift.cashEvents,
+                        event
+                    ];
+                    transaction.update(shiftRef, {
+                        cashEvents
+                    });
+                    return {
+                        status: 200,
+                        body: {
+                            shift: _extends({
+                                id: shiftId
+                            }, shift, {
+                                cashEvents
+                            })
+                        }
+                    };
+                });
+                // The drawer opens for the cash once it is on the record; a replayed
+                // tap kicked it the first time.
+                if (recorded.status === 200 && !recorded.body['replayed']) {
+                    await deps.printer.kickDrawer({
+                        hostId: staff.hostId,
+                        registerId,
+                        reason: type,
+                        causeId: eventId,
+                        createdBy: cashierId
+                    });
+                }
+                return recorded;
+            }
+        case 'print-report':
+            {
+                var _register_data_openShiftId1, _host_get;
+                // An X report of the open shift, or the Z report a closed one froze, on
+                // the register's receipt printer. `printed: false` tells the register
+                // there is no cloud printer, and it prints through the browser instead.
+                const requested = posOpsCleanId(body['shiftId']) || String((_register_data_openShiftId1 = register.data['openShiftId']) != null ? _register_data_openShiftId1 : '');
+                if (!requested) return {
+                    status: 409,
+                    body: {
+                        error: 'No shift is open on this register.'
+                    }
+                };
+                const shift = shiftOf((await shifts.doc(requested).get()).data());
+                if (!shift) return {
+                    status: 404,
+                    body: {
+                        error: 'Unknown shift'
+                    }
+                };
+                const closed = shift.status === 'closed' && shift.report;
+                const report = closed ? shift.report : await readPosShiftReport(register.ref, staff.hostRef, requested, shift);
+                const host = await staff.hostRef.get();
+                const by = closed ? shift.closedByName : shift.openedByName;
+                const printed = await deps.printer.printReport({
+                    hostId: staff.hostId,
+                    registerId,
+                    shiftId: requested,
+                    report: posShiftPrintReport(_extends({
+                        title: closed ? 'Z REPORT' : 'X REPORT',
+                        storeName: String((_host_get = host.get('displayName')) != null ? _host_get : '') || 'Register'
+                    }, register.data['name'] ? {
+                        registerName: String(register.data['name'])
+                    } : {}, by ? {
+                        subtitle: `${closed ? 'Closed' : 'Opened'} by ${by}`
+                    } : {}, {
+                        report
+                    }, closed ? {
+                        shift
+                    } : {})),
+                    createdBy: cashierId,
+                    attemptKey: posOpsCleanId(body['attemptKey']) || String(deps.now())
+                });
+                return {
+                    status: 200,
+                    body: {
+                        printed: printed.jobIds.length > 0,
+                        jobIds: printed.jobIds
+                    }
+                };
+            }
+        case 'x-report':
+            {
+                var _register_data_openShiftId2;
+                const shiftId = String((_register_data_openShiftId2 = register.data['openShiftId']) != null ? _register_data_openShiftId2 : '');
+                const shift = shiftId ? shiftOf((await shifts.doc(shiftId).get()).data()) : null;
+                if (!shift || shift.status !== 'open') {
+                    return {
+                        status: 409,
+                        body: {
+                            error: 'No shift is open on this register.'
+                        }
+                    };
+                }
+                const report = await readPosShiftReport(register.ref, staff.hostRef, shiftId, shift);
+                return {
+                    status: 200,
+                    body: {
+                        shiftId,
+                        shift: _extends({
+                            id: shiftId
+                        }, shift),
+                        report
+                    }
+                };
+            }
+        case 'close':
+            {
+                var _body_note;
+                const counted = cents(body['countedCashCents']);
+                if (counted == null) return {
+                    status: 400,
+                    body: {
+                        error: 'Enter the cash you counted.'
+                    }
+                };
+                const note = String((_body_note = body['note']) != null ? _body_note : '').trim().slice(0, 500);
+                const expectedShiftId = posOpsCleanId(body['shiftId']);
+                const closedByName = await deps.memberName(cashierId);
+                return await firestore.runTransaction(async (transaction)=>{
+                    var _fresh_get;
+                    const fresh = await transaction.get(register.ref);
+                    const shiftId = String((_fresh_get = fresh.get('openShiftId')) != null ? _fresh_get : '');
+                    if (!shiftId) return {
+                        status: 409,
+                        body: {
+                            error: 'No shift is open on this register.'
+                        }
+                    };
+                    // A stale tablet closing a shift another tablet already closed and
+                    // reopened must not close the new one with the old count.
+                    if (expectedShiftId && expectedShiftId !== shiftId) {
+                        return {
+                            status: 409,
+                            body: {
+                                error: 'That shift is already closed. Refresh to see the open one.'
+                            }
+                        };
+                    }
+                    const shiftRef = shifts.doc(shiftId);
+                    const shift = shiftOf((await transaction.get(shiftRef)).data());
+                    if (!shift || shift.status !== 'open') {
+                        return {
+                            status: 409,
+                            body: {
+                                error: 'No shift is open on this register.'
+                            }
+                        };
+                    }
+                    const report = await readPosShiftReport(register.ref, staff.hostRef, shiftId, shift, transaction);
+                    const closed = _extends({
+                        status: 'closed',
+                        closedBy: cashierId,
+                        closedByName,
+                        closedAtMs: deps.now(),
+                        countedCashCents: counted,
+                        expectedCashCents: report.expectedCashCents,
+                        varianceCents: posCashVarianceCents(counted, report.expectedCashCents),
+                        report
+                    }, note ? {
+                        closingNote: note
+                    } : {});
+                    transaction.update(shiftRef, closed);
+                    transaction.update(register.ref, {
+                        openShiftId: null
+                    });
+                    return {
+                        status: 200,
+                        body: {
+                            shift: _extends({
+                                id: shiftId
+                            }, shift, closed),
+                            report
+                        }
+                    };
+                });
+            }
+        default:
+            return {
+                status: 400,
+                body: {
+                    error: 'Unknown action'
+                }
+            };
+    }
+}
+/** Whether a register may take a sale or pay cash out, by the site's shift rule. */ export async function posShiftForSale(staff, registerRef) {
+    var _register_get;
+    const register = await registerRef.get();
+    const shiftId = String((_register_get = register.get('openShiftId')) != null ? _register_get : '') || null;
+    if (!shiftId && staff.settings.requireOpenShift) {
+        return {
+            ok: false,
+            error: 'Open a shift on this register before ringing a sale.'
+        };
+    }
+    return {
+        ok: true,
+        shiftId
+    };
+}
+export function createPosShiftHandler(deps = defaultPosOpsDeps) {
+    return async (req, res)=>{
+        try {
+            const outcome = await handlePosShift(deps(), req);
+            return res.status(outcome.status).json(outcome.body);
+        } catch (error) {
+            console.error('[pos-shift] failed', error);
+            return res.status(500).json({
+                error: 'The shift could not be updated'
+            });
+        }
+    };
+}
+export const posShiftHandler = createPosShiftHandler();
+
+//# sourceMappingURL=pos-shift.js.map

package/src/lib/server/pos-shift.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-shift.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 { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport type { PluginApiHandler, PluginApiRequest } from '@aglyn/aglyn/server'\nimport {\n  computePosShiftReport,\n  posShiftPrintReport,\n  posCashVarianceCents,\n  type PosCashEvent,\n  type PosCashEventType,\n  type PosShift,\n  type PosShiftRefund,\n  type PosShiftReport,\n  type PosShiftSale,\n} from '../model/commerce-pos-ops'\nimport {\n  authorizePosOps,\n  defaultPosOpsDeps,\n  posOpsBody,\n  posOpsCleanId,\n  readPosRegister,\n  resolvePosCashier,\n  type PosOpsDeps,\n  type PosOpsStaff,\n} from './pos-ops-gate'\n\n/*==========================================\n * SHIFTS AND THE CASH DRAWER (AGL-3609): `POST /api/commerce/pos-shift`.\n *\n *   open        a starting float; refused while the register has a shift open\n *   cash-event  paid in, paid out or a safe drop, with a reason\n *   x-report    the open shift's figures so far, changing nothing\n *   close       the counted cash, the Z report frozen onto the shift\n *   current     the register's open shift, or none\n *\n * ONE OPEN SHIFT PER REGISTER is the register document's `openShiftId`,\n * claimed and released inside the same transaction as the shift it names.\n * Two tablets opening the same till at once both read the register; the\n * transaction that commits second re-reads it, finds the first one's shift\n * and refuses — there is no window in which both stand.\n *=========================================*/\n\n/** The most sales one report reads; past it the report says it is partial. */\nexport const POS_SHIFT_SALES_CEILING = 5000\n/** The largest float or cash movement the drawer records in one entry. */\nexport const POS_CASH_ENTRY_MAX_CENTS = 10_000_000\n\nconst CASH_EVENT_TYPES: ReadonlySet<PosCashEventType> = new Set(['paid_in', 'paid_out', 'drop'])\n\nfunction cents(value: unknown): number | null {\n  const number = Number(value)\n  if (!Number.isFinite(number)) return null\n  const rounded = Math.round(number)\n  return rounded >= 0 && rounded <= POS_CASH_ENTRY_MAX_CENTS ? rounded : null\n}\n\n/**\n * The figures for a shift, read from the sales stamped with it and the\n * returns rung against it. Inside a transaction when one is given, so a Z\n * report and the close it freezes see the same sales.\n */\nexport async function readPosShiftReport(\n  registerRef: FirebaseFirestore.DocumentReference,\n  hostRef: FirebaseFirestore.DocumentReference,\n  shiftId: string,\n  shift: Pick<PosShift, 'openingFloatCents' | 'cashEvents'>,\n  transaction?: FirebaseFirestore.Transaction,\n): Promise<PosShiftReport> {\n  const salesQuery = hostRef\n    .collection('orders')\n    .where('shiftId', '==', shiftId)\n    .limit(POS_SHIFT_SALES_CEILING + 1)\n  const returnsQuery = registerRef.collection('returns').where('shiftId', '==', shiftId).limit(2000)\n  const [salesSnapshot, returnsSnapshot] = transaction\n    ? await Promise.all([transaction.get(salesQuery), transaction.get(returnsQuery)])\n    : await Promise.all([salesQuery.get(), returnsQuery.get()])\n  const sales = salesSnapshot.docs\n    .slice(0, POS_SHIFT_SALES_CEILING)\n    .map((doc) => (doc.data() ?? {}) as PosShiftSale)\n  const refunds: PosShiftRefund[] = returnsSnapshot.docs.map((doc) => {\n    const data = (doc.data() ?? {}) as Record<string, any>\n    const tenders = Array.isArray(data['tenders']) ? data['tenders'] : []\n    return {\n      refundedCents: Number(data['refundedCents'] ?? 0),\n      tenders: tenders\n        .filter((tender: any) => tender?.status !== 'failed')\n        .map((tender: any) => ({ method: tender.method, amountCents: Number(tender.amountCents ?? 0) })),\n    }\n  })\n  return computePosShiftReport({\n    shift,\n    sales,\n    refunds,\n    truncated: salesSnapshot.docs.length > POS_SHIFT_SALES_CEILING,\n  })\n}\n\nfunction shiftOf(data: Record<string, any> | undefined): PosShift | null {\n  if (!data) return null\n  return {\n    ...(data as PosShift),\n    cashEvents: Array.isArray(data['cashEvents']) ? (data['cashEvents'] as PosCashEvent[]) : [],\n    openingFloatCents: Number(data['openingFloatCents'] ?? 0),\n  }\n}\n\ntype Outcome = { status: number; body: Record<string, unknown> }\n\nexport async function handlePosShift(\n  deps: PosOpsDeps,\n  req: PluginApiRequest,\n): Promise<Outcome> {\n  if (req.method !== 'POST') return { status: 405, body: { error: 'Method not allowed' } }\n  const body = posOpsBody(req)\n  const gate = await authorizePosOps(deps, req, body['hostId'])\n  if ('error' in gate) return { status: gate.status, body: { error: gate.error } }\n  const staff = gate.staff\n  const register = await readPosRegister(staff, body['registerId'])\n  if ('error' in register) return { status: register.status, body: { error: register.error } }\n  const registerId = register.ref.id\n  const { cashierId } = await resolvePosCashier(deps, staff, registerId, body['cashierAssertion'])\n  const action = String(body['action'] ?? '')\n  const firestore = deps.firestore()\n  const shifts = register.ref.collection('shifts')\n\n  switch (action) {\n    case 'current': {\n      const openShiftId = String(register.data['openShiftId'] ?? '')\n      if (!openShiftId) return { status: 200, body: { shift: null } }\n      const shift = shiftOf((await shifts.doc(openShiftId).get()).data())\n      return {\n        status: 200,\n        body: { shift: shift && shift.status === 'open' ? { id: openShiftId, ...shift } : null },\n      }\n    }\n\n    case 'open': {\n      const float = cents(body['openingFloatCents'] ?? 0)\n      if (float == null) return { status: 400, body: { error: 'Enter the starting cash as an amount.' } }\n      const shiftRef = shifts.doc(createResourceUid())\n      const now = deps.now()\n      const openedByName = await deps.memberName(cashierId)\n      return await firestore.runTransaction(async (transaction) => {\n        const fresh = await transaction.get(register.ref)\n        const standing = String(fresh.get('openShiftId') ?? '')\n        if (standing) {\n          const standingShift = await transaction.get(shifts.doc(standing))\n          if (standingShift.exists && standingShift.get('status') === 'open') {\n            return {\n              status: 409,\n              body: {\n                error: 'This register already has a shift open. Close it before opening another.',\n                shiftId: standing,\n              },\n            }\n          }\n        }\n        const shift: PosShift = {\n          hostId: staff.hostId,\n          registerId,\n          status: 'open',\n          openedBy: cashierId,\n          openedByName,\n          openedAtMs: now,\n          openingFloatCents: float,\n          cashEvents: [],\n        }\n        transaction.create(shiftRef, shift)\n        transaction.update(register.ref, { openShiftId: shiftRef.id })\n        return { status: 200, body: { shift: { id: shiftRef.id, ...shift } } }\n      })\n    }\n\n    case 'cash-event': {\n      const type = String(body['type'] ?? '') as PosCashEventType\n      if (!CASH_EVENT_TYPES.has(type)) {\n        return { status: 400, body: { error: 'Choose paid in, paid out or a safe drop.' } }\n      }\n      const amount = cents(body['amountCents'])\n      if (!amount) return { status: 400, body: { error: 'Enter an amount above zero.' } }\n      const reason = String(body['reason'] ?? '').trim().slice(0, 200)\n      if (!reason && type !== 'drop') {\n        return { status: 400, body: { error: 'Say what the cash was for.' } }\n      }\n      const eventId = posOpsCleanId(body['eventId']) || createResourceUid()\n      const recorded: Outcome = await firestore.runTransaction(async (transaction) => {\n        const fresh = await transaction.get(register.ref)\n        const shiftId = String(fresh.get('openShiftId') ?? '')\n        if (!shiftId) return { status: 409, body: { error: 'Open a shift first.' } }\n        const shiftRef = shifts.doc(shiftId)\n        const shift = shiftOf((await transaction.get(shiftRef)).data())\n        if (!shift || shift.status !== 'open') {\n          return { status: 409, body: { error: 'Open a shift first.' } }\n        }\n        // A retried tap carries the same id: recorded once, answered twice.\n        if (shift.cashEvents.some((event) => event.id === eventId)) {\n          return { status: 200, body: { shift: { id: shiftId, ...shift }, replayed: true } }\n        }\n        const event: PosCashEvent = {\n          id: eventId,\n          type,\n          amountCents: amount,\n          reason,\n          by: cashierId,\n          atMs: deps.now(),\n        }\n        const cashEvents = [...shift.cashEvents, event]\n        transaction.update(shiftRef, { cashEvents })\n        return { status: 200, body: { shift: { id: shiftId, ...shift, cashEvents } } }\n      })\n      // The drawer opens for the cash once it is on the record; a replayed\n      // tap kicked it the first time.\n      if (recorded.status === 200 && !recorded.body['replayed']) {\n        await deps.printer.kickDrawer({\n          hostId: staff.hostId,\n          registerId,\n          reason: type as Exclude<PosCashEventType, 'refund'>,\n          causeId: eventId,\n          createdBy: cashierId,\n        })\n      }\n      return recorded\n    }\n\n    case 'print-report': {\n      // An X report of the open shift, or the Z report a closed one froze, on\n      // the register's receipt printer. `printed: false` tells the register\n      // there is no cloud printer, and it prints through the browser instead.\n      const requested = posOpsCleanId(body['shiftId']) || String(register.data['openShiftId'] ?? '')\n      if (!requested) return { status: 409, body: { error: 'No shift is open on this register.' } }\n      const shift = shiftOf((await shifts.doc(requested).get()).data())\n      if (!shift) return { status: 404, body: { error: 'Unknown shift' } }\n      const closed = shift.status === 'closed' && shift.report\n      const report = closed\n        ? (shift.report as PosShiftReport)\n        : await readPosShiftReport(register.ref, staff.hostRef, requested, shift)\n      const host = await staff.hostRef.get()\n      const by = closed ? shift.closedByName : shift.openedByName\n      const printed = await deps.printer.printReport({\n        hostId: staff.hostId,\n        registerId,\n        shiftId: requested,\n        report: posShiftPrintReport({\n          title: closed ? 'Z REPORT' : 'X REPORT',\n          storeName: String(host.get('displayName') ?? '') || 'Register',\n          ...(register.data['name'] ? { registerName: String(register.data['name']) } : {}),\n          ...(by ? { subtitle: `${closed ? 'Closed' : 'Opened'} by ${by}` } : {}),\n          report,\n          ...(closed ? { shift } : {}),\n        }),\n        createdBy: cashierId,\n        attemptKey: posOpsCleanId(body['attemptKey']) || String(deps.now()),\n      })\n      return { status: 200, body: { printed: printed.jobIds.length > 0, jobIds: printed.jobIds } }\n    }\n\n    case 'x-report': {\n      const shiftId = String(register.data['openShiftId'] ?? '')\n      const shift = shiftId ? shiftOf((await shifts.doc(shiftId).get()).data()) : null\n      if (!shift || shift.status !== 'open') {\n        return { status: 409, body: { error: 'No shift is open on this register.' } }\n      }\n      const report = await readPosShiftReport(register.ref, staff.hostRef, shiftId, shift)\n      return { status: 200, body: { shiftId, shift: { id: shiftId, ...shift }, report } }\n    }\n\n    case 'close': {\n      const counted = cents(body['countedCashCents'])\n      if (counted == null) return { status: 400, body: { error: 'Enter the cash you counted.' } }\n      const note = String(body['note'] ?? '').trim().slice(0, 500)\n      const expectedShiftId = posOpsCleanId(body['shiftId'])\n      const closedByName = await deps.memberName(cashierId)\n      return await firestore.runTransaction(async (transaction) => {\n        const fresh = await transaction.get(register.ref)\n        const shiftId = String(fresh.get('openShiftId') ?? '')\n        if (!shiftId) return { status: 409, body: { error: 'No shift is open on this register.' } }\n        // A stale tablet closing a shift another tablet already closed and\n        // reopened must not close the new one with the old count.\n        if (expectedShiftId && expectedShiftId !== shiftId) {\n          return {\n            status: 409,\n            body: { error: 'That shift is already closed. Refresh to see the open one.' },\n          }\n        }\n        const shiftRef = shifts.doc(shiftId)\n        const shift = shiftOf((await transaction.get(shiftRef)).data())\n        if (!shift || shift.status !== 'open') {\n          return { status: 409, body: { error: 'No shift is open on this register.' } }\n        }\n        const report = await readPosShiftReport(\n          register.ref,\n          staff.hostRef,\n          shiftId,\n          shift,\n          transaction,\n        )\n        const closed: Partial<PosShift> = {\n          status: 'closed',\n          closedBy: cashierId,\n          closedByName,\n          closedAtMs: deps.now(),\n          countedCashCents: counted,\n          expectedCashCents: report.expectedCashCents,\n          varianceCents: posCashVarianceCents(counted, report.expectedCashCents),\n          report,\n          ...(note ? { closingNote: note } : {}),\n        }\n        transaction.update(shiftRef, closed)\n        transaction.update(register.ref, { openShiftId: null })\n        return { status: 200, body: { shift: { id: shiftId, ...shift, ...closed }, report } }\n      })\n    }\n\n    default:\n      return { status: 400, body: { error: 'Unknown action' } }\n  }\n}\n\n/** Whether a register may take a sale or pay cash out, by the site's shift rule. */\nexport async function posShiftForSale(\n  staff: Pick<PosOpsStaff, 'settings'>,\n  registerRef: FirebaseFirestore.DocumentReference,\n): Promise<{ ok: true; shiftId: string | null } | { ok: false; error: string }> {\n  const register = await registerRef.get()\n  const shiftId = String(register.get('openShiftId') ?? '') || null\n  if (!shiftId && staff.settings.requireOpenShift) {\n    return { ok: false, error: 'Open a shift on this register before ringing a sale.' }\n  }\n  return { ok: true, shiftId }\n}\n\nexport function createPosShiftHandler(deps: () => PosOpsDeps = defaultPosOpsDeps): PluginApiHandler {\n  return async (req, res) => {\n    try {\n      const outcome = await handlePosShift(deps(), req)\n      return res.status(outcome.status).json(outcome.body)\n    } catch (error) {\n      console.error('[pos-shift] failed', error)\n      return res.status(500).json({ error: 'The shift could not be updated' })\n    }\n  }\n}\n\nexport const posShiftHandler = createPosShiftHandler()\n"],"names":["createResourceUid","computePosShiftReport","posShiftPrintReport","posCashVarianceCents","authorizePosOps","defaultPosOpsDeps","posOpsBody","posOpsCleanId","readPosRegister","resolvePosCashier","POS_SHIFT_SALES_CEILING","POS_CASH_ENTRY_MAX_CENTS","CASH_EVENT_TYPES","Set","cents","value","number","Number","isFinite","rounded","Math","round","readPosShiftReport","registerRef","hostRef","shiftId","shift","transaction","salesQuery","collection","where","limit","returnsQuery","salesSnapshot","returnsSnapshot","Promise","all","get","sales","docs","slice","map","doc","data","refunds","tenders","Array","isArray","refundedCents","filter","tender","status","method","amountCents","truncated","length","shiftOf","cashEvents","openingFloatCents","handlePosShift","deps","req","body","error","gate","staff","register","registerId","ref","id","cashierId","action","String","firestore","shifts","openShiftId","float","shiftRef","now","openedByName","memberName","runTransaction","fresh","standing","standingShift","exists","hostId","openedBy","openedAtMs","create","update","type","has","amount","reason","trim","eventId","recorded","some","event","replayed","by","atMs","printer","kickDrawer","causeId","createdBy","host","requested","closed","report","closedByName","printed","printReport","title","storeName","registerName","subtitle","attemptKey","jobIds","counted","note","expectedShiftId","closedBy","closedAtMs","countedCashCents","expectedCashCents","varianceCents","closingNote","posShiftForSale","settings","requireOpenShift","ok","createPosShiftHandler","res","outcome","json","console","posShiftHandler"],"mappings":"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"}

package/src/lib/server/pos-staff-pin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 { PluginApiHandler, PluginApiRequest } from '@aglyn/aglyn/server';
+import { type PosOpsDeps } from './pos-ops-gate';
+type Outcome = {
+    status: number;
+    body: Record<string, unknown>;
+};
+export declare function handlePosStaffPin(deps: PosOpsDeps, req: PluginApiRequest): Promise<Outcome>;
+export declare function createPosStaffPinHandler(deps?: () => PosOpsDeps): PluginApiHandler;
+export declare const posStaffPinHandler: PluginApiHandler;
+export {};