@aglyn/plugins-commerce 1.0.0-beta.284 → 1.0.0-beta.287

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-pos-ops.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 { apportionCents, type HostOrder } from './commerce-orders'\nimport { orderPayments } from './commerce-pos'\nimport type { PrintReport } from './commerce-printers'\nimport { receiptDataFromOrder } from './commerce-receipt'\n\n/*==========================================\n * RUNNING THE REGISTER (AGL-3609): shifts and the cash drawer, register\n * returns and the receipt. Pure and client-safe: the routes, the register\n * and the reports all compute from these, so a drawer's expected cash is one\n * formula wherever it is shown.\n *\n * Where each thing lives:\n *\n *   hosts/{hostId}/registers/{registerId}\n *       `openShiftId` — the one open shift, claimed in a transaction\n *   hosts/{hostId}/registers/{registerId}/shifts/{shiftId}   {@link PosShift}\n *   hosts/{hostId}/registers/{registerId}/returns/{returnId} {@link PosRegisterReturn}\n *   hosts/{hostId}/posStaffPins/{uid}                         server-only\n *\n * Everything under `registers` is written by the Admin SDK only (the\n * register pool is billed), and every member of the site may read it.\n *=========================================*/\n\n/** How one payment toward a sale was taken, in the register's tender words. */\nexport type PosTenderMethod =\n  | 'cash'\n  | 'card_present'\n  | 'card_keyed'\n  | 'card_link'\n  | 'gift_card'\n  | 'folio'\n  /** Store credit another plugin keeps (AGL-3640). */\n  | 'credit'\n\nexport const POS_TENDER_METHODS: readonly PosTenderMethod[] = [\n  'cash',\n  'card_present',\n  'card_keyed',\n  'card_link',\n  'gift_card',\n  'folio',\n  'credit',\n]\n\n/** What each tender is called on a report, a receipt and a refund. */\nexport const POS_TENDER_LABELS: Readonly<Record<PosTenderMethod, string>> = {\n  cash: 'Cash',\n  card_present: 'Card',\n  card_keyed: 'Card (keyed)',\n  card_link: 'Card (payment link)',\n  gift_card: 'Gift card',\n  folio: 'Room charge',\n  credit: 'Store credit',\n}\n\n/** The tenders whose money moved through Stripe and goes back through it. */\nexport const POS_STRIPE_TENDERS: ReadonlySet<PosTenderMethod> = new Set([\n  'card_present',\n  'card_keyed',\n  'card_link',\n])\n\n/**\n * One settled payment toward a sale, as the shift report and a register\n * return read it.\n */\nexport interface PosOrderTender {\n  /** The payment's id on the order, or `legacy` for an order before the tender ledger. */\n  id: string\n  method: PosTenderMethod\n  /** Cents put toward the sale; never the tip, never the change. */\n  amountCents: number\n  tipCents: number\n  paymentIntentId?: string\n  giftCardId?: string\n  reservationId?: string\n  /** For `credit` (AGL-3640): the provider, its account handle, and its name. */\n  creditProviderId?: string\n  creditReference?: string\n  creditLabel?: string\n  cardBrand?: string\n  last4?: string\n  cashTenderedCents?: number\n  changeCents?: number\n}\n\nconst wholeCents = (value: unknown): number => {\n  const number = Math.round(Number(value))\n  return Number.isFinite(number) && number > 0 ? number : 0\n}\n\n\nconst isTenderMethod = (value: unknown): value is PosTenderMethod =>\n  typeof value === 'string' && (POS_TENDER_METHODS as readonly string[]).includes(value)\n\n/** The order fields the tender reader looks at. */\nexport interface PosTenderSource {\n  payments?: unknown\n  channel?: string\n  status?: string\n  totals?: { totalCents?: number; tipCents?: number } | null\n  amountCents?: number\n  reservationId?: string\n  checkoutSessionId?: string\n  paymentIntentId?: string\n}\n\n/**\n * THE ONE PLACE THE TENDER LEDGER IS READ (AGL-3609).\n *\n * A register sale may carry `payments[]` — one entry per tender, the ledger\n * the split-tender register writes (AGL-3607) — and only the payments that\n * SUCCEEDED count: a declined card or a voided gift card took nothing. An\n * order written before that ledger is one payment, inferred the way the\n * ledger's own reader infers it: a folio when it names a reservation, a card\n * link when Stripe saw it (or it came through the storefront), cash otherwise.\n *\n * The ledger's own reader (`orderPayments`) does both; this narrows it to the\n * settled payments and the fields a report or a refund reads.\n */\nexport function posOrderTenders(order: PosTenderSource | null | undefined): PosOrderTender[] {\n  if (!order) return []\n  return orderPayments(order as Parameters<typeof orderPayments>[0])\n    .filter((payment) => payment.status === 'succeeded' && isTenderMethod(payment.method))\n    .map((payment) => ({\n      id: payment.id,\n      method: payment.method as PosTenderMethod,\n      amountCents: wholeCents(payment.amountCents),\n      tipCents: wholeCents(payment.tipCents ?? (payment.id === 'legacy' ? order.totals?.tipCents : 0)),\n      ...(payment.paymentIntentId ? { paymentIntentId: payment.paymentIntentId } : {}),\n      ...(payment.giftCardId ? { giftCardId: payment.giftCardId } : {}),\n      ...(payment.reservationId ? { reservationId: payment.reservationId } : {}),\n      ...(payment.creditProviderId ? { creditProviderId: payment.creditProviderId } : {}),\n      ...(payment.creditReference ? { creditReference: payment.creditReference } : {}),\n      ...(payment.creditLabel ? { creditLabel: payment.creditLabel } : {}),\n      ...(payment.cardBrand ? { cardBrand: payment.cardBrand } : {}),\n      ...(payment.last4 ? { last4: payment.last4 } : {}),\n      ...(payment.cashTenderedCents != null ? { cashTenderedCents: wholeCents(payment.cashTenderedCents) } : {}),\n      ...(payment.changeCents != null ? { changeCents: wholeCents(payment.changeCents) } : {}),\n    }))\n}\n\n/** A tender as one line of a receipt: `Card •• 4242`. */\nexport function posTenderLabel(\n  tender: Pick<PosOrderTender, 'method' | 'cardBrand' | 'last4'> & { creditLabel?: string },\n): string {\n  const base = (tender.method === 'credit' && tender.creditLabel) || POS_TENDER_LABELS[tender.method] || tender.method\n  if (tender.last4) {\n    return `${tender.cardBrand ? capitalize(tender.cardBrand) : base} •• ${tender.last4}`\n  }\n  return base\n}\n\nfunction capitalize(value: string): string {\n  return value ? value.charAt(0).toUpperCase() + value.slice(1) : value\n}\n\n/*==========================================\n * SHIFTS AND THE CASH DRAWER\n *=========================================*/\n\n/**\n * Cash that moved through the drawer without a sale: money put in, money\n * paid out for a reason (a delivery, petty cash), a drop to the safe, and\n * a register return paid out in cash.\n */\nexport type PosCashEventType = 'paid_in' | 'paid_out' | 'drop' | 'refund'\n\nexport const POS_CASH_EVENT_LABELS: Readonly<Record<PosCashEventType, string>> = {\n  paid_in: 'Paid in',\n  paid_out: 'Paid out',\n  drop: 'Safe drop',\n  refund: 'Cash refund',\n}\n\nexport interface PosCashEvent {\n  /** The register's attempt id, so a retried tap records one event. */\n  id: string\n  type: PosCashEventType\n  amountCents: number\n  reason: string\n  /** The member who moved the cash. */\n  by: string\n  atMs: number\n  /** The order a `refund` paid out against. */\n  orderId?: string\n}\n\n/** Sales, refunds and cash movements over one shift. */\nexport interface PosShiftReport {\n  orderCount: number\n  /** What customers paid for the goods: order totals, tax in, tips out. */\n  grossSalesCents: number\n  discountsCents: number\n  taxCents: number\n  tipsCents: number\n  salesByTender: Partial<Record<PosTenderMethod, number>>\n  refundCount: number\n  refundsCents: number\n  refundsByTender: Partial<Record<PosTenderMethod, number>>\n  /** Gross sales less refunds. */\n  netSalesCents: number\n  openingFloatCents: number\n  cashSalesCents: number\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n  /** float + cash sales + paid in − paid out − drops − cash refunds. */\n  expectedCashCents: number\n  /** More sales were stamped with the shift than the report could read. */\n  truncated?: boolean\n}\n\n/** `hosts/{hostId}/registers/{registerId}/shifts/{shiftId}`. */\nexport interface PosShift {\n  hostId: string\n  registerId: string\n  status: 'open' | 'closed'\n  openedBy: string\n  /** The member's name when the shift opened, for the history and the export. */\n  openedByName?: string\n  openedAtMs: number\n  openingFloatCents: number\n  cashEvents: PosCashEvent[]\n  closedBy?: string\n  closedByName?: string\n  /*\n   * The history sorts by each of the five below (AGL-3680), and an `orderBy`\n   * drops a shift that lacks the field, so the shift is opened with each one\n   * `null` and the close fills them — see `POS_SHIFT_LIST_QUERY`.\n   */\n  closedAtMs?: number | null\n  /** What the closing cashier counted in the drawer. */\n  countedCashCents?: number | null\n  expectedCashCents?: number | null\n  /** counted − expected: positive is over, negative is short. */\n  varianceCents?: number | null\n  /** The Z report's `netSalesCents`, flattened so the history can order by it. */\n  netSalesCents?: number | null\n  closingNote?: string\n  /** The Z report, frozen when the shift closed. */\n  report?: PosShiftReport\n}\n\n/** The cash-event sums one formula reads. */\nexport function posCashEventTotals(events: readonly PosCashEvent[] | null | undefined): {\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n} {\n  const sum = (type: PosCashEventType) =>\n    (events ?? [])\n      .filter((event) => event?.type === type)\n      .reduce((total, event) => total + wholeCents(event.amountCents), 0)\n  return {\n    paidInCents: sum('paid_in'),\n    paidOutCents: sum('paid_out'),\n    dropsCents: sum('drop'),\n    cashRefundsCents: sum('refund'),\n  }\n}\n\n/**\n * THE DRAWER'S EXPECTED CASH: what should be in it when it is counted.\n *\n *   opening float + cash sales + paid in − paid out − safe drops − cash refunds\n *\n * Cash SALES are the cash tender's `amountCents`, which is what the sale took\n * and never what the customer handed over: the change went straight back out\n * of the same drawer. A tip left in cash is in the drawer too, so it counts.\n */\nexport function posExpectedCashCents(input: {\n  openingFloatCents: number\n  cashSalesCents: number\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n}): number {\n  return (\n    wholeCents(input.openingFloatCents) +\n    wholeCents(input.cashSalesCents) +\n    wholeCents(input.paidInCents) -\n    wholeCents(input.paidOutCents) -\n    wholeCents(input.dropsCents) -\n    wholeCents(input.cashRefundsCents)\n  )\n}\n\n/** A sale as the shift report reads it. */\nexport interface PosShiftSale extends PosTenderSource {\n  totals?: {\n    totalCents?: number\n    discountCents?: number\n    taxCents?: number\n    tipCents?: number\n  } | null\n}\n\n/** A register return as the shift report reads it. */\nexport interface PosShiftRefund {\n  refundedCents: number\n  tenders: Array<{ method: PosTenderMethod; amountCents: number }>\n}\n\n/**\n * The X report (mid-shift) and the Z report (at close) are this one function\n * over the sales stamped with the shift, the returns rung at the register\n * during it and the shift's own cash events. A pending sale took no money and\n * a cancelled one gave it back, so neither counts; a sale refunded LATER\n * still counts as a sale, and its refund is counted where it was paid out.\n */\nexport function computePosShiftReport(input: {\n  shift: Pick<PosShift, 'openingFloatCents' | 'cashEvents'>\n  sales: readonly PosShiftSale[]\n  refunds: readonly PosShiftRefund[]\n  truncated?: boolean\n}): PosShiftReport {\n  const salesByTender: Partial<Record<PosTenderMethod, number>> = {}\n  const refundsByTender: Partial<Record<PosTenderMethod, number>> = {}\n  let orderCount = 0\n  let grossSalesCents = 0\n  let discountsCents = 0\n  let taxCents = 0\n  let tipsCents = 0\n  let cashSalesCents = 0\n  for (const sale of input.sales) {\n    if (sale.status === 'pending' || sale.status === 'cancelled') continue\n    const tenders = posOrderTenders(sale)\n    orderCount += 1\n    grossSalesCents += wholeCents(sale.totals?.totalCents ?? sale.amountCents)\n    discountsCents += wholeCents(sale.totals?.discountCents)\n    taxCents += wholeCents(sale.totals?.taxCents)\n    const tenderTips = tenders.reduce((sum, tender) => sum + tender.tipCents, 0)\n    tipsCents += Math.max(wholeCents(sale.totals?.tipCents), tenderTips)\n    for (const tender of tenders) {\n      salesByTender[tender.method] = (salesByTender[tender.method] ?? 0) + tender.amountCents\n      if (tender.method === 'cash') cashSalesCents += tender.amountCents + tender.tipCents\n    }\n  }\n  let refundsCents = 0\n  for (const refund of input.refunds) {\n    refundsCents += wholeCents(refund.refundedCents)\n    for (const tender of refund.tenders ?? []) {\n      if (!isTenderMethod(tender.method)) continue\n      refundsByTender[tender.method] =\n        (refundsByTender[tender.method] ?? 0) + wholeCents(tender.amountCents)\n    }\n  }\n  const cash = posCashEventTotals(input.shift.cashEvents)\n  const openingFloatCents = wholeCents(input.shift.openingFloatCents)\n  return {\n    orderCount,\n    grossSalesCents,\n    discountsCents,\n    taxCents,\n    tipsCents,\n    salesByTender,\n    refundCount: input.refunds.length,\n    refundsCents,\n    refundsByTender,\n    netSalesCents: grossSalesCents - refundsCents,\n    openingFloatCents,\n    cashSalesCents,\n    ...cash,\n    expectedCashCents: posExpectedCashCents({ openingFloatCents, cashSalesCents, ...cash }),\n    ...(input.truncated ? { truncated: true } : {}),\n  }\n}\n\n/** counted − expected; positive is over, negative is short. */\nexport function posCashVarianceCents(countedCashCents: number, expectedCashCents: number): number {\n  return Math.round(Number(countedCashCents) || 0) - Math.round(Number(expectedCashCents) || 0)\n}\n\n/** `$12.34`, `-$0.50` — the register's money format, store currency USD. */\nexport function posMoney(cents: number): string {\n  const value = Math.round(Number(cents) || 0)\n  return `${value < 0 ? '-' : ''}$${(Math.abs(value) / 100).toFixed(2)}`\n}\n\n/** One CSV cell, quoted when it needs to be and never read as a formula. */\nfunction csvCell(value: unknown): string {\n  let cell = value == null ? '' : String(value)\n  if (/^[=+\\-@\\t\\r]/.test(cell) && !/^-?\\d+(\\.\\d+)?$/.test(cell)) cell = `'${cell}`\n  return /[\",\\r\\n]/.test(cell) ? `\"${cell.replace(/\"/g, '\"\"')}\"` : cell\n}\n\nexport { csvCell as posCsvCell }\n\nconst dollars = (cents: number | null | undefined): string =>\n  cents == null ? '' : (Math.round(cents) / 100).toFixed(2)\n\n/** The shift history as a spreadsheet: one row per shift, money in dollars. */\nexport function posShiftsCsv(\n  shifts: ReadonlyArray<PosShift & { id: string; registerName?: string }>,\n  memberName: (uid: string) => string = (uid) => uid,\n): string {\n  const header = [\n    'Shift',\n    'Register',\n    'Opened',\n    'Opened by',\n    'Closed',\n    'Closed by',\n    'Orders',\n    'Gross sales',\n    'Refunds',\n    'Net sales',\n    'Discounts',\n    'Tax',\n    'Tips',\n    'Cash sales',\n    'Card sales',\n    'Gift card sales',\n    'Room charges',\n    'Opening float',\n    'Paid in',\n    'Paid out',\n    'Safe drops',\n    'Cash refunds',\n    'Expected cash',\n    'Counted cash',\n    'Variance',\n  ]\n  const iso = (ms: number | null | undefined) => (ms ? new Date(ms).toISOString() : '')\n  const rows = shifts.map((shift) => {\n    const report = shift.report\n    const card = report\n      ? (report.salesByTender.card_present ?? 0) +\n        (report.salesByTender.card_keyed ?? 0) +\n        (report.salesByTender.card_link ?? 0)\n      : undefined\n    return [\n      shift.id,\n      shift.registerName ?? shift.registerId,\n      iso(shift.openedAtMs),\n      shift.openedByName ?? memberName(shift.openedBy),\n      iso(shift.closedAtMs),\n      shift.closedBy ? (shift.closedByName ?? memberName(shift.closedBy)) : '',\n      report?.orderCount ?? '',\n      dollars(report?.grossSalesCents),\n      dollars(report?.refundsCents),\n      dollars(report?.netSalesCents),\n      dollars(report?.discountsCents),\n      dollars(report?.taxCents),\n      dollars(report?.tipsCents),\n      dollars(report?.cashSalesCents),\n      dollars(card),\n      dollars(report ? (report.salesByTender.gift_card ?? 0) : undefined),\n      dollars(report ? (report.salesByTender.folio ?? 0) : undefined),\n      dollars(shift.openingFloatCents),\n      dollars(report?.paidInCents),\n      dollars(report?.paidOutCents),\n      dollars(report?.dropsCents),\n      dollars(report?.cashRefundsCents),\n      dollars(shift.expectedCashCents ?? report?.expectedCashCents),\n      dollars(shift.countedCashCents),\n      dollars(shift.varianceCents),\n    ]\n  })\n  return [header, ...rows].map((row) => row.map(csvCell).join(',')).join('\\r\\n')\n}\n\n/*==========================================\n * RETURNS AT THE REGISTER\n *=========================================*/\n\n/** One line picked for return: its index on the order and how many units. */\nexport interface PosReturnPick {\n  index: number\n  quantity: number\n}\n\n/** The order fields a return reads. */\nexport interface PosReturnSource extends PosTenderSource {\n  lineItems?: Array<{ unitAmountCents?: number; quantity?: number; name?: string }> | null\n  totals?: {\n    totalCents?: number\n    discountCents?: number\n    taxCents?: number\n    shippingCents?: number\n    tipCents?: number\n  } | null\n  refundedCents?: number\n  refundedLineItemIds?: number[]\n  /** Units of each line already returned at a register, by line index. */\n  returnedQuantities?: Record<string, number>\n  /** Cents already refunded to each payment by a register return. */\n  posPaymentRefunds?: Record<string, number>\n}\n\n/**\n * What each line is worth back, whole: its price less its share of the\n * order's discount, plus its share of the order's tax — the same\n * apportionment `orderLineRefundCents` uses for the discount, extended to the\n * tax a register sale charged on top. Shipping and tips are not a line's.\n */\nexport function posReturnLineValues(order: PosReturnSource): number[] {\n  const lines = order.lineItems ?? []\n  const gross = lines.map(\n    (line) =>\n      Math.max(0, Math.round(Number(line?.unitAmountCents ?? 0))) *\n      Math.max(1, Math.round(Number(line?.quantity ?? 1))),\n  )\n  const discountShares = apportionCents(gross, wholeCents(order.totals?.discountCents))\n  const net = gross.map((cents, index) => Math.max(0, cents - (discountShares[index] ?? 0)))\n  const taxShares = apportionCents(net, wholeCents(order.totals?.taxCents))\n  return net.map((cents, index) => cents + (taxShares[index] ?? 0))\n}\n\n/** Units of each line already returned, a line refunded whole counting as all of it. */\nexport function posReturnedQuantities(order: PosReturnSource): number[] {\n  const lines = order.lineItems ?? []\n  const wholeLines = new Set(order.refundedLineItemIds ?? [])\n  return lines.map((line, index) => {\n    const quantity = Math.max(1, Math.round(Number(line?.quantity ?? 1)))\n    if (wholeLines.has(index)) return quantity\n    const returned = Math.round(Number(order.returnedQuantities?.[String(index)] ?? 0))\n    return Math.min(quantity, Math.max(0, Number.isFinite(returned) ? returned : 0))\n  })\n}\n\nexport type PosReturnPlan =\n  | {\n      ok: true\n      refundCents: number\n      /** Cents per picked line, in the order picked. */\n      lineCents: number[]\n      /** The order's per-line returned quantities after this return. */\n      returnedQuantities: Record<string, number>\n      /** Lines this return finishes, for `refundedLineItemIds`. */\n      completedLines: number[]\n    }\n  | { ok: false; error: string }\n\n/**\n * What a return of these picks refunds, to the cent.\n *\n * Each line's value is split across its units CUMULATIVELY: returning `k` of\n * `n` units already returned `r` refunds `round(V·(r+k)/n) − round(V·r/n)`,\n * so returning a line one unit at a time refunds exactly what returning it\n * whole would have, and the rounding never strands or invents a cent. The\n * sum is capped at what is left to refund on the order — a refund given\n * from the order dialog already took its share.\n *\n * `heldElsewhere` is, per line, the units an online return (the returns\n * flow) already holds or took back. They cap what the register may take, but\n * they are not written into `returnedQuantities`, which counts only what the\n * register itself took.\n */\nexport function planPosReturn(\n  order: PosReturnSource,\n  picks: readonly PosReturnPick[],\n  heldElsewhere: readonly number[] = [],\n): PosReturnPlan {\n  const lines = order.lineItems ?? []\n  if (!picks.length) return { ok: false, error: 'Pick at least one item to return.' }\n  const values = posReturnLineValues(order)\n  const returned = posReturnedQuantities(order)\n  const seen = new Set<number>()\n  const lineCents: number[] = []\n  const nextReturned: Record<string, number> = {}\n  for (const [index, count] of returned.entries()) if (count > 0) nextReturned[String(index)] = count\n  const completedLines: number[] = []\n  for (const pick of picks) {\n    const index = Number(pick.index)\n    const quantity = Number(pick.quantity)\n    if (!Number.isInteger(index) || index < 0 || index >= lines.length) {\n      return { ok: false, error: `Line ${pick.index} is not on this order.` }\n    }\n    if (seen.has(index)) return { ok: false, error: 'Each line can be picked once.' }\n    seen.add(index)\n    if (!Number.isInteger(quantity) || quantity < 1) {\n      return { ok: false, error: 'Return at least one of each line you pick.' }\n    }\n    const total = Math.max(1, Math.round(Number(lines[index]?.quantity ?? 1)))\n    const already = returned[index] ?? 0\n    const held = Math.max(0, Math.round(Number(heldElsewhere[index] ?? 0)))\n    if (already + held + quantity > total) {\n      const left = Math.max(0, total - already - held)\n      return {\n        ok: false,\n        error:\n          left > 0\n            ? `Only ${left} of \"${lines[index]?.name ?? 'that item'}\" can still be returned.`\n            : held > 0\n              ? `\"${lines[index]?.name ?? 'That item'}\" is already in a return. Finish it under Returns.`\n              : `\"${lines[index]?.name ?? 'That item'}\" has already been returned.`,\n      }\n    }\n    const value = values[index] ?? 0\n    lineCents.push(\n      Math.round((value * (already + quantity)) / total) - Math.round((value * already) / total),\n    )\n    nextReturned[String(index)] = already + quantity\n    if (already + quantity === total) completedLines.push(index)\n  }\n  const remaining = Math.max(\n    0,\n    wholeCents(order.totals?.totalCents) - wholeCents(order.refundedCents),\n  )\n  const asked = lineCents.reduce((sum, cents) => sum + cents, 0)\n  const refundCents = Math.min(asked, remaining)\n  if (!(refundCents > 0)) return { ok: false, error: 'Nothing is left to refund on this order.' }\n  return { ok: true, refundCents, lineCents, returnedQuantities: nextReturned, completedLines }\n}\n\n/** One slice of a refund, sent back to one of the sale's payments. */\nexport interface PosRefundAllocation {\n  paymentId: string\n  method: PosTenderMethod\n  amountCents: number\n}\n\n/**\n * What each payment can still take back: what it put toward the sale, less\n * what register returns already sent to it. A refund given from the order\n * dialog refunds through Stripe without naming a payment, so whatever it\n * took that no payment accounts for comes off the Stripe payments first.\n */\nexport function posRefundableByTender(order: PosReturnSource): Array<PosOrderTender & { refundableCents: number }> {\n  const tenders = posOrderTenders(order)\n  const attributed = Object.values(order.posPaymentRefunds ?? {}).reduce(\n    (sum, cents) => sum + wholeCents(cents),\n    0,\n  )\n  let unattributed = Math.max(0, wholeCents(order.refundedCents) - attributed)\n  const ordered = [...tenders].sort(\n    (a, b) => Number(POS_STRIPE_TENDERS.has(b.method)) - Number(POS_STRIPE_TENDERS.has(a.method)),\n  )\n  const refundable = new Map<string, number>()\n  for (const tender of ordered) {\n    let left = Math.max(0, tender.amountCents - wholeCents(order.posPaymentRefunds?.[tender.id]))\n    if (POS_STRIPE_TENDERS.has(tender.method) && unattributed > 0) {\n      const taken = Math.min(left, unattributed)\n      left -= taken\n      unattributed -= taken\n    }\n    refundable.set(tender.id, left)\n  }\n  return tenders.map((tender) => ({ ...tender, refundableCents: refundable.get(tender.id) ?? 0 }))\n}\n\n/**\n * The order a refund goes back in, when the cashier does not split it by\n * hand: the cards first, then store credit, then the room, and the drawer\n * LAST — so cash leaves the till only for what the customer paid in cash.\n */\nconst REFUND_ORDER: readonly PosTenderMethod[] = [\n  'card_present',\n  'card_keyed',\n  'card_link',\n  'gift_card',\n  'credit',\n  'folio',\n  'cash',\n]\n\nexport type PosRefundSplit =\n  | { ok: true; allocations: PosRefundAllocation[] }\n  | { ok: false; error: string }\n\n/**\n * Sends `amountCents` back to the sale's own payments.\n *\n * With no `requested` split, each payment takes what it can in\n * {@link REFUND_ORDER}. With one, every slice must name a payment of this\n * sale and fit what that payment can still take, and the slices must add up\n * to the refund exactly — a refund is never sent to a tender the sale was\n * not paid with.\n */\nexport function splitPosRefund(\n  order: PosReturnSource,\n  amountCents: number,\n  requested?: ReadonlyArray<{ paymentId: string; amountCents: number }> | null,\n): PosRefundSplit {\n  const amount = wholeCents(amountCents)\n  const tenders = posRefundableByTender(order)\n  if (!tenders.length) return { ok: false, error: 'This order has no payment to refund to.' }\n  if (requested && requested.length) {\n    const allocations: PosRefundAllocation[] = []\n    const used = new Set<string>()\n    for (const slice of requested) {\n      const tender = tenders.find((candidate) => candidate.id === slice.paymentId)\n      if (!tender) return { ok: false, error: 'That payment is not on this order.' }\n      if (used.has(tender.id)) return { ok: false, error: 'Each payment can be named once.' }\n      used.add(tender.id)\n      const cents = Math.round(Number(slice.amountCents))\n      if (!Number.isFinite(cents) || cents < 0) return { ok: false, error: 'Refund amounts must be positive.' }\n      if (cents === 0) continue\n      if (cents > tender.refundableCents) {\n        return {\n          ok: false,\n          error: `${posTenderLabel(tender)} can take back at most ${posMoney(tender.refundableCents)}.`,\n        }\n      }\n      allocations.push({ paymentId: tender.id, method: tender.method, amountCents: cents })\n    }\n    const total = allocations.reduce((sum, slice) => sum + slice.amountCents, 0)\n    if (total !== amount) {\n      return {\n        ok: false,\n        error: `The refund is ${posMoney(amount)}; the split adds up to ${posMoney(total)}.`,\n      }\n    }\n    return { ok: true, allocations }\n  }\n  const ordered = [...tenders].sort(\n    (a, b) => REFUND_ORDER.indexOf(a.method) - REFUND_ORDER.indexOf(b.method),\n  )\n  const allocations: PosRefundAllocation[] = []\n  let left = amount\n  for (const tender of ordered) {\n    if (!(left > 0)) break\n    const cents = Math.min(left, tender.refundableCents)\n    if (!(cents > 0)) continue\n    allocations.push({ paymentId: tender.id, method: tender.method, amountCents: cents })\n    left -= cents\n  }\n  if (left > 0) {\n    return {\n      ok: false,\n      error: `Only ${posMoney(amount - left)} can go back to this sale's payments.`,\n    }\n  }\n  return { ok: true, allocations }\n}\n\n/** `hosts/{hostId}/registers/{registerId}/returns/{returnId}`. */\nexport interface PosRegisterReturn {\n  hostId: string\n  registerId: string\n  orderId: string\n  orderNumber?: number\n  /** The shift the drawer was in when the return was rung, if one was open. */\n  shiftId?: string\n  lines: Array<{ index: number; quantity: number; name: string; refundCents: number }>\n  refundedCents: number\n  tenders: Array<PosRefundAllocation & { status: 'refunded' | 'failed'; refundId?: string; error?: string }>\n  restocked: boolean\n  locationId?: string\n  /** The member at the register (by PIN or by sign-in). */\n  cashierId: string\n  /** The manager whose PIN allowed a refund above the cashier's limit. */\n  approvedBy?: string\n  reason?: string\n  status: 'refunded' | 'partial'\n  atMs: number\n}\n\n/*==========================================\n * STAFF PINS\n *=========================================*/\n\n/** How long a cashier PIN switch lasts before the register asks again. */\nexport const POS_CASHIER_ASSERTION_TTL_MS = 15 * 60 * 1000\n/** A manager's approval is for the one refund in front of them. */\nexport const POS_MANAGER_ASSERTION_TTL_MS = 2 * 60 * 1000\n/** Wrong PINs in a row before the member is locked out. */\nexport const POS_PIN_MAX_ATTEMPTS = 5\n/** How long a lockout lasts. */\nexport const POS_PIN_LOCKOUT_MS = 15 * 60 * 1000\n\n/**\n * Why a PIN cannot be used, or `null` when it can: 4 to 6 digits, and not\n * one a stranger tries first — every digit the same, or a straight run.\n */\nexport function posPinProblem(pin: unknown): string | null {\n  const value = typeof pin === 'string' ? pin : ''\n  if (!/^\\d{4,6}$/.test(value)) return 'A PIN is 4 to 6 digits.'\n  if (/^(\\d)\\1+$/.test(value)) return 'Pick a PIN that is not one digit repeated.'\n  const digits = [...value].map(Number)\n  const step = (digits[1] ?? 0) - (digits[0] ?? 0)\n  if (\n    (step === 1 || step === -1) &&\n    digits.every((digit, index) => index === 0 || digit - (digits[index - 1] ?? 0) === step)\n  ) {\n    return 'Pick a PIN that is not a straight run like 1234.'\n  }\n  return null\n}\n\n/*==========================================\n * THE THERMAL RECEIPT\n *=========================================*/\n\nexport interface PosReceiptLine {\n  name: string\n  variantLabel?: string\n  quantity: number\n  unitAmountCents: number\n  lineCents: number\n}\n\nexport interface PosReceipt {\n  storeName: string\n  logoUrl?: string\n  addressLines: string[]\n  orderNumber: string\n  /** The digits the barcode encodes and the register's return lookup reads. */\n  barcodeValue: string\n  dateLabel: string\n  cashierName?: string\n  registerName?: string\n  customerName?: string\n  lines: PosReceiptLine[]\n  subtotalCents: number\n  discountCents: number\n  taxCents: number\n  totalCents: number\n  tipCents: number\n  tenders: Array<{ label: string; amountCents: number }>\n  changeCents: number\n  refundedCents: number\n  footer?: string\n  returnPolicy?: string\n  /** A gift receipt: the items and nothing about what they cost. */\n  gift: boolean\n}\n\n/** The order fields a receipt prints. */\nexport interface PosReceiptOrder extends PosReturnSource {\n  number?: number\n  createdAtMs?: number\n  customerName?: string | null\n  lineItems?: Array<{\n    name?: string\n    variantLabel?: string\n    unitAmountCents?: number\n    quantity?: number\n  }> | null\n}\n\n/**\n * The receipt for one sale, from the order alone plus what the store prints\n * on every receipt. The sale's lines, totals, tenders and change are the\n * receipt model's (`receiptDataFromOrder`, the one the cloud printers print\n * from), so a browser print and a cloud print never disagree; this adds the\n * logo, the address, the return policy and the gift receipt. A gift receipt\n * keeps the lines and the barcode — the recipient's way to return — and\n * drops every price, total and tender.\n */\nexport function buildPosReceipt(input: {\n  orderId: string\n  order: PosReceiptOrder\n  store: {\n    name: string\n    logoUrl?: string\n    address?: string\n    footer?: string\n    returnPolicy?: string\n  }\n  cashierName?: string\n  registerName?: string\n  gift?: boolean\n  /** How the date prints; the register's own locale by default. */\n  formatDate?: (ms: number) => string\n}): PosReceipt {\n  const { order } = input\n  const gift = input.gift === true\n  const data = receiptDataFromOrder(input.orderId, order as unknown as HostOrder & Record<string, any>, {\n    storeName: input.store.name,\n  })\n  const lines: PosReceiptLine[] = data.lines.map((line) => ({\n    name: line.name,\n    ...(line.detail ? { variantLabel: line.detail } : {}),\n    quantity: line.quantity,\n    unitAmountCents: gift ? 0 : line.unitCents,\n    lineCents: gift ? 0 : line.totalCents,\n  }))\n  const number = Number(order.number)\n  const digits = Number.isInteger(number) && number > 0 ? String(number) : ''\n  const createdAtMs = Number(order.createdAtMs) || 0\n  const formatDate =\n    input.formatDate ?? ((ms: number) => (ms ? new Date(ms).toLocaleString() : ''))\n  const money = (cents: number | undefined) => (gift ? 0 : wholeCents(cents))\n  return {\n    storeName: input.store.name,\n    ...(input.store.logoUrl ? { logoUrl: input.store.logoUrl } : {}),\n    addressLines: String(input.store.address ?? '')\n      .split(/\\r?\\n/)\n      .map((line) => line.trim())\n      .filter(Boolean),\n    orderNumber: digits ? `#${digits}` : `#${input.orderId.slice(0, 8)}`,\n    barcodeValue: digits || input.orderId,\n    dateLabel: formatDate(createdAtMs),\n    ...(input.cashierName ? { cashierName: input.cashierName } : {}),\n    ...(input.registerName ? { registerName: input.registerName } : {}),\n    ...(order.customerName ? { customerName: String(order.customerName) } : {}),\n    lines,\n    subtotalCents: money(data.subtotalCents),\n    discountCents: money(data.discountCents),\n    taxCents: money(data.taxCents),\n    totalCents: money(data.totalCents),\n    tipCents: money(data.tipCents),\n    tenders: gift ? [] : (data.tenders ?? []),\n    changeCents: money(data.changeCents),\n    refundedCents: money(data.refundedCents),\n    ...(input.store.footer ? { footer: input.store.footer } : {}),\n    ...(input.store.returnPolicy ? { returnPolicy: input.store.returnPolicy } : {}),\n    gift,\n  }\n}\n\n/** One titled block of an X or Z report: what the screen, the browser print and a cloud printer all show. */\nexport interface PosShiftReportSection {\n  section: string\n  rows: Array<{ label: string; value: string; strong?: boolean }>\n}\n\n/** The rows of an X or Z report, in the order a manager reads them. */\nexport function posShiftReportRows(\n  report: PosShiftReport,\n  shift?: Pick<PosShift, 'countedCashCents' | 'varianceCents'>,\n): PosShiftReportSection[] {\n  const tenders = POS_TENDER_METHODS.filter(\n    (method) => (report.salesByTender[method] ?? 0) > 0 || (report.refundsByTender[method] ?? 0) > 0,\n  )\n  return [\n    {\n      section: 'Sales',\n      rows: [\n        { label: 'Orders', value: String(report.orderCount) },\n        { label: 'Gross sales', value: posMoney(report.grossSalesCents) },\n        { label: 'Discounts', value: posMoney(report.discountsCents) },\n        { label: 'Tax', value: posMoney(report.taxCents) },\n        { label: 'Tips', value: posMoney(report.tipsCents) },\n        { label: `Refunds (${report.refundCount})`, value: `-${posMoney(report.refundsCents)}` },\n        { label: 'Net sales', value: posMoney(report.netSalesCents), strong: true },\n      ],\n    },\n    {\n      section: 'By tender',\n      rows: tenders.length\n        ? tenders.map((method) => ({\n            label: POS_TENDER_LABELS[method],\n            value:\n              posMoney(report.salesByTender[method] ?? 0) +\n              ((report.refundsByTender[method] ?? 0) > 0\n                ? ` (−${posMoney(report.refundsByTender[method] ?? 0)})`\n                : ''),\n          }))\n        : [{ label: 'No sales yet', value: '' }],\n    },\n    {\n      section: 'Cash drawer',\n      rows: [\n        { label: 'Starting cash', value: posMoney(report.openingFloatCents) },\n        { label: 'Cash sales', value: posMoney(report.cashSalesCents) },\n        { label: 'Paid in', value: posMoney(report.paidInCents) },\n        { label: 'Paid out', value: `-${posMoney(report.paidOutCents)}` },\n        { label: 'Safe drops', value: `-${posMoney(report.dropsCents)}` },\n        { label: 'Cash refunds', value: `-${posMoney(report.cashRefundsCents)}` },\n        { label: 'Expected in drawer', value: posMoney(report.expectedCashCents), strong: true },\n        ...(shift?.countedCashCents != null\n          ? [\n              { label: 'Counted', value: posMoney(shift.countedCashCents) },\n              {\n                label: (shift.varianceCents ?? 0) < 0 ? 'Short' : (shift.varianceCents ?? 0) > 0 ? 'Over' : 'Balanced',\n                value: posMoney(shift.varianceCents ?? 0),\n                strong: true,\n              },\n            ]\n          : []),\n      ],\n    },\n  ]\n}\n\n/** A shift's X or Z report as the receipt printer prints it. */\nexport function posShiftPrintReport(input: {\n  title: 'X REPORT' | 'Z REPORT'\n  storeName: string\n  registerName?: string\n  report: PosShiftReport\n  shift?: Pick<PosShift, 'countedCashCents' | 'varianceCents'>\n  subtitle?: string\n}): PrintReport {\n  return {\n    title: input.title,\n    storeName: input.storeName,\n    ...(input.subtitle || input.registerName\n      ? { subtitle: [input.registerName, input.subtitle].filter(Boolean).join(' - ') }\n      : {}),\n    sections: posShiftReportRows(input.report, input.shift),\n  }\n}\n"],"names":["apportionCents","orderPayments","receiptDataFromOrder","POS_TENDER_METHODS","POS_TENDER_LABELS","cash","card_present","card_keyed","card_link","gift_card","folio","credit","POS_STRIPE_TENDERS","Set","wholeCents","value","number","Math","round","Number","isFinite","isTenderMethod","includes","posOrderTenders","order","filter","payment","status","method","map","id","amountCents","tipCents","totals","paymentIntentId","giftCardId","reservationId","creditProviderId","creditReference","creditLabel","cardBrand","last4","cashTenderedCents","changeCents","posTenderLabel","tender","base","capitalize","charAt","toUpperCase","slice","POS_CASH_EVENT_LABELS","paid_in","paid_out","drop","refund","posCashEventTotals","events","sum","type","event","reduce","total","paidInCents","paidOutCents","dropsCents","cashRefundsCents","posExpectedCashCents","input","openingFloatCents","cashSalesCents","computePosShiftReport","salesByTender","refundsByTender","orderCount","grossSalesCents","discountsCents","taxCents","tipsCents","sale","sales","tenders","totalCents","discountCents","tenderTips","max","refundsCents","refunds","refundedCents","shift","cashEvents","refundCount","length","netSalesCents","expectedCashCents","truncated","posCashVarianceCents","countedCashCents","posMoney","cents","abs","toFixed","csvCell","cell","String","test","replace","posCsvCell","dollars","posShiftsCsv","shifts","memberName","uid","header","iso","ms","Date","toISOString","rows","report","card","undefined","registerName","registerId","openedAtMs","openedByName","openedBy","closedAtMs","closedBy","closedByName","varianceCents","row","join","posReturnLineValues","lines","lineItems","gross","line","unitAmountCents","quantity","discountShares","net","index","taxShares","posReturnedQuantities","wholeLines","refundedLineItemIds","has","returned","returnedQuantities","min","planPosReturn","picks","heldElsewhere","ok","error","values","seen","lineCents","nextReturned","count","entries","completedLines","pick","isInteger","add","already","held","left","name","push","remaining","asked","refundCents","posRefundableByTender","attributed","Object","posPaymentRefunds","unattributed","ordered","sort","a","b","refundable","Map","taken","set","refundableCents","get","REFUND_ORDER","splitPosRefund","requested","amount","allocations","used","find","candidate","paymentId","indexOf","POS_CASHIER_ASSERTION_TTL_MS","POS_MANAGER_ASSERTION_TTL_MS","POS_PIN_MAX_ATTEMPTS","POS_PIN_LOCKOUT_MS","posPinProblem","pin","digits","step","every","digit","buildPosReceipt","data","gift","orderId","storeName","store","detail","variantLabel","unitCents","createdAtMs","formatDate","toLocaleString","money","logoUrl","addressLines","address","split","trim","Boolean","orderNumber","barcodeValue","dateLabel","cashierName","customerName","subtotalCents","footer","returnPolicy","posShiftReportRows","section","label","strong","posShiftPrintReport","title","subtitle","sections"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-pos-ops.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 { apportionCents, type HostOrder } from './commerce-orders'\nimport { withPosHardwareReceiptNotice } from './pos-hardware-terms'\nimport { orderPayments } from './commerce-pos'\nimport type { PrintReport } from './commerce-printers'\nimport { receiptDataFromOrder } from './commerce-receipt'\n\n/*==========================================\n * RUNNING THE REGISTER (AGL-3609): shifts and the cash drawer, register\n * returns and the receipt. Pure and client-safe: the routes, the register\n * and the reports all compute from these, so a drawer's expected cash is one\n * formula wherever it is shown.\n *\n * Where each thing lives:\n *\n *   hosts/{hostId}/registers/{registerId}\n *       `openShiftId` — the one open shift, claimed in a transaction\n *   hosts/{hostId}/registers/{registerId}/shifts/{shiftId}   {@link PosShift}\n *   hosts/{hostId}/registers/{registerId}/returns/{returnId} {@link PosRegisterReturn}\n *   hosts/{hostId}/posStaffPins/{uid}                         server-only\n *\n * Everything under `registers` is written by the Admin SDK only (the\n * register pool is billed), and every member of the site may read it.\n *=========================================*/\n\n/** How one payment toward a sale was taken, in the register's tender words. */\nexport type PosTenderMethod =\n  | 'cash'\n  | 'card_present'\n  | 'card_keyed'\n  | 'card_link'\n  | 'gift_card'\n  | 'folio'\n  /** Store credit another plugin keeps (AGL-3640). */\n  | 'credit'\n\nexport const POS_TENDER_METHODS: readonly PosTenderMethod[] = [\n  'cash',\n  'card_present',\n  'card_keyed',\n  'card_link',\n  'gift_card',\n  'folio',\n  'credit',\n]\n\n/** What each tender is called on a report, a receipt and a refund. */\nexport const POS_TENDER_LABELS: Readonly<Record<PosTenderMethod, string>> = {\n  cash: 'Cash',\n  card_present: 'Card',\n  card_keyed: 'Card (keyed)',\n  card_link: 'Card (payment link)',\n  gift_card: 'Gift card',\n  folio: 'Room charge',\n  credit: 'Store credit',\n}\n\n/** The tenders whose money moved through Stripe and goes back through it. */\nexport const POS_STRIPE_TENDERS: ReadonlySet<PosTenderMethod> = new Set([\n  'card_present',\n  'card_keyed',\n  'card_link',\n])\n\n/**\n * One settled payment toward a sale, as the shift report and a register\n * return read it.\n */\nexport interface PosOrderTender {\n  /** The payment's id on the order, or `legacy` for an order before the tender ledger. */\n  id: string\n  method: PosTenderMethod\n  /** Cents put toward the sale; never the tip, never the change. */\n  amountCents: number\n  tipCents: number\n  paymentIntentId?: string\n  giftCardId?: string\n  reservationId?: string\n  /** For `credit` (AGL-3640): the provider, its account handle, and its name. */\n  creditProviderId?: string\n  creditReference?: string\n  creditLabel?: string\n  cardBrand?: string\n  last4?: string\n  cashTenderedCents?: number\n  changeCents?: number\n}\n\nconst wholeCents = (value: unknown): number => {\n  const number = Math.round(Number(value))\n  return Number.isFinite(number) && number > 0 ? number : 0\n}\n\n\nconst isTenderMethod = (value: unknown): value is PosTenderMethod =>\n  typeof value === 'string' && (POS_TENDER_METHODS as readonly string[]).includes(value)\n\n/** The order fields the tender reader looks at. */\nexport interface PosTenderSource {\n  payments?: unknown\n  channel?: string\n  status?: string\n  totals?: { totalCents?: number; tipCents?: number } | null\n  amountCents?: number\n  reservationId?: string\n  checkoutSessionId?: string\n  paymentIntentId?: string\n}\n\n/**\n * THE ONE PLACE THE TENDER LEDGER IS READ (AGL-3609).\n *\n * A register sale may carry `payments[]` — one entry per tender, the ledger\n * the split-tender register writes (AGL-3607) — and only the payments that\n * SUCCEEDED count: a declined card or a voided gift card took nothing. An\n * order written before that ledger is one payment, inferred the way the\n * ledger's own reader infers it: a folio when it names a reservation, a card\n * link when Stripe saw it (or it came through the storefront), cash otherwise.\n *\n * The ledger's own reader (`orderPayments`) does both; this narrows it to the\n * settled payments and the fields a report or a refund reads.\n */\nexport function posOrderTenders(order: PosTenderSource | null | undefined): PosOrderTender[] {\n  if (!order) return []\n  return orderPayments(order as Parameters<typeof orderPayments>[0])\n    .filter((payment) => payment.status === 'succeeded' && isTenderMethod(payment.method))\n    .map((payment) => ({\n      id: payment.id,\n      method: payment.method as PosTenderMethod,\n      amountCents: wholeCents(payment.amountCents),\n      tipCents: wholeCents(payment.tipCents ?? (payment.id === 'legacy' ? order.totals?.tipCents : 0)),\n      ...(payment.paymentIntentId ? { paymentIntentId: payment.paymentIntentId } : {}),\n      ...(payment.giftCardId ? { giftCardId: payment.giftCardId } : {}),\n      ...(payment.reservationId ? { reservationId: payment.reservationId } : {}),\n      ...(payment.creditProviderId ? { creditProviderId: payment.creditProviderId } : {}),\n      ...(payment.creditReference ? { creditReference: payment.creditReference } : {}),\n      ...(payment.creditLabel ? { creditLabel: payment.creditLabel } : {}),\n      ...(payment.cardBrand ? { cardBrand: payment.cardBrand } : {}),\n      ...(payment.last4 ? { last4: payment.last4 } : {}),\n      ...(payment.cashTenderedCents != null ? { cashTenderedCents: wholeCents(payment.cashTenderedCents) } : {}),\n      ...(payment.changeCents != null ? { changeCents: wholeCents(payment.changeCents) } : {}),\n    }))\n}\n\n/** A tender as one line of a receipt: `Card •• 4242`. */\nexport function posTenderLabel(\n  tender: Pick<PosOrderTender, 'method' | 'cardBrand' | 'last4'> & { creditLabel?: string },\n): string {\n  const base = (tender.method === 'credit' && tender.creditLabel) || POS_TENDER_LABELS[tender.method] || tender.method\n  if (tender.last4) {\n    return `${tender.cardBrand ? capitalize(tender.cardBrand) : base} •• ${tender.last4}`\n  }\n  return base\n}\n\nfunction capitalize(value: string): string {\n  return value ? value.charAt(0).toUpperCase() + value.slice(1) : value\n}\n\n/*==========================================\n * SHIFTS AND THE CASH DRAWER\n *=========================================*/\n\n/**\n * Cash that moved through the drawer without a sale: money put in, money\n * paid out for a reason (a delivery, petty cash), a drop to the safe, and\n * a register return paid out in cash.\n */\nexport type PosCashEventType = 'paid_in' | 'paid_out' | 'drop' | 'refund'\n\nexport const POS_CASH_EVENT_LABELS: Readonly<Record<PosCashEventType, string>> = {\n  paid_in: 'Paid in',\n  paid_out: 'Paid out',\n  drop: 'Safe drop',\n  refund: 'Cash refund',\n}\n\nexport interface PosCashEvent {\n  /** The register's attempt id, so a retried tap records one event. */\n  id: string\n  type: PosCashEventType\n  amountCents: number\n  reason: string\n  /** The member who moved the cash. */\n  by: string\n  atMs: number\n  /** The order a `refund` paid out against. */\n  orderId?: string\n}\n\n/** Sales, refunds and cash movements over one shift. */\nexport interface PosShiftReport {\n  orderCount: number\n  /** What customers paid for the goods: order totals, tax in, tips out. */\n  grossSalesCents: number\n  discountsCents: number\n  taxCents: number\n  tipsCents: number\n  salesByTender: Partial<Record<PosTenderMethod, number>>\n  refundCount: number\n  refundsCents: number\n  refundsByTender: Partial<Record<PosTenderMethod, number>>\n  /** Gross sales less refunds. */\n  netSalesCents: number\n  openingFloatCents: number\n  cashSalesCents: number\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n  /** float + cash sales + paid in − paid out − drops − cash refunds. */\n  expectedCashCents: number\n  /** More sales were stamped with the shift than the report could read. */\n  truncated?: boolean\n}\n\n/** `hosts/{hostId}/registers/{registerId}/shifts/{shiftId}`. */\nexport interface PosShift {\n  hostId: string\n  registerId: string\n  status: 'open' | 'closed'\n  openedBy: string\n  /** The member's name when the shift opened, for the history and the export. */\n  openedByName?: string\n  openedAtMs: number\n  openingFloatCents: number\n  cashEvents: PosCashEvent[]\n  closedBy?: string\n  closedByName?: string\n  /*\n   * The history sorts by each of the five below (AGL-3680), and an `orderBy`\n   * drops a shift that lacks the field, so the shift is opened with each one\n   * `null` and the close fills them — see `POS_SHIFT_LIST_QUERY`.\n   */\n  closedAtMs?: number | null\n  /** What the closing cashier counted in the drawer. */\n  countedCashCents?: number | null\n  expectedCashCents?: number | null\n  /** counted − expected: positive is over, negative is short. */\n  varianceCents?: number | null\n  /** The Z report's `netSalesCents`, flattened so the history can order by it. */\n  netSalesCents?: number | null\n  closingNote?: string\n  /** The Z report, frozen when the shift closed. */\n  report?: PosShiftReport\n}\n\n/** The cash-event sums one formula reads. */\nexport function posCashEventTotals(events: readonly PosCashEvent[] | null | undefined): {\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n} {\n  const sum = (type: PosCashEventType) =>\n    (events ?? [])\n      .filter((event) => event?.type === type)\n      .reduce((total, event) => total + wholeCents(event.amountCents), 0)\n  return {\n    paidInCents: sum('paid_in'),\n    paidOutCents: sum('paid_out'),\n    dropsCents: sum('drop'),\n    cashRefundsCents: sum('refund'),\n  }\n}\n\n/**\n * THE DRAWER'S EXPECTED CASH: what should be in it when it is counted.\n *\n *   opening float + cash sales + paid in − paid out − safe drops − cash refunds\n *\n * Cash SALES are the cash tender's `amountCents`, which is what the sale took\n * and never what the customer handed over: the change went straight back out\n * of the same drawer. A tip left in cash is in the drawer too, so it counts.\n */\nexport function posExpectedCashCents(input: {\n  openingFloatCents: number\n  cashSalesCents: number\n  paidInCents: number\n  paidOutCents: number\n  dropsCents: number\n  cashRefundsCents: number\n}): number {\n  return (\n    wholeCents(input.openingFloatCents) +\n    wholeCents(input.cashSalesCents) +\n    wholeCents(input.paidInCents) -\n    wholeCents(input.paidOutCents) -\n    wholeCents(input.dropsCents) -\n    wholeCents(input.cashRefundsCents)\n  )\n}\n\n/** A sale as the shift report reads it. */\nexport interface PosShiftSale extends PosTenderSource {\n  totals?: {\n    totalCents?: number\n    discountCents?: number\n    taxCents?: number\n    tipCents?: number\n  } | null\n}\n\n/** A register return as the shift report reads it. */\nexport interface PosShiftRefund {\n  refundedCents: number\n  tenders: Array<{ method: PosTenderMethod; amountCents: number }>\n}\n\n/**\n * The X report (mid-shift) and the Z report (at close) are this one function\n * over the sales stamped with the shift, the returns rung at the register\n * during it and the shift's own cash events. A pending sale took no money and\n * a cancelled one gave it back, so neither counts; a sale refunded LATER\n * still counts as a sale, and its refund is counted where it was paid out.\n */\nexport function computePosShiftReport(input: {\n  shift: Pick<PosShift, 'openingFloatCents' | 'cashEvents'>\n  sales: readonly PosShiftSale[]\n  refunds: readonly PosShiftRefund[]\n  truncated?: boolean\n}): PosShiftReport {\n  const salesByTender: Partial<Record<PosTenderMethod, number>> = {}\n  const refundsByTender: Partial<Record<PosTenderMethod, number>> = {}\n  let orderCount = 0\n  let grossSalesCents = 0\n  let discountsCents = 0\n  let taxCents = 0\n  let tipsCents = 0\n  let cashSalesCents = 0\n  for (const sale of input.sales) {\n    if (sale.status === 'pending' || sale.status === 'cancelled') continue\n    const tenders = posOrderTenders(sale)\n    orderCount += 1\n    grossSalesCents += wholeCents(sale.totals?.totalCents ?? sale.amountCents)\n    discountsCents += wholeCents(sale.totals?.discountCents)\n    taxCents += wholeCents(sale.totals?.taxCents)\n    const tenderTips = tenders.reduce((sum, tender) => sum + tender.tipCents, 0)\n    tipsCents += Math.max(wholeCents(sale.totals?.tipCents), tenderTips)\n    for (const tender of tenders) {\n      salesByTender[tender.method] = (salesByTender[tender.method] ?? 0) + tender.amountCents\n      if (tender.method === 'cash') cashSalesCents += tender.amountCents + tender.tipCents\n    }\n  }\n  let refundsCents = 0\n  for (const refund of input.refunds) {\n    refundsCents += wholeCents(refund.refundedCents)\n    for (const tender of refund.tenders ?? []) {\n      if (!isTenderMethod(tender.method)) continue\n      refundsByTender[tender.method] =\n        (refundsByTender[tender.method] ?? 0) + wholeCents(tender.amountCents)\n    }\n  }\n  const cash = posCashEventTotals(input.shift.cashEvents)\n  const openingFloatCents = wholeCents(input.shift.openingFloatCents)\n  return {\n    orderCount,\n    grossSalesCents,\n    discountsCents,\n    taxCents,\n    tipsCents,\n    salesByTender,\n    refundCount: input.refunds.length,\n    refundsCents,\n    refundsByTender,\n    netSalesCents: grossSalesCents - refundsCents,\n    openingFloatCents,\n    cashSalesCents,\n    ...cash,\n    expectedCashCents: posExpectedCashCents({ openingFloatCents, cashSalesCents, ...cash }),\n    ...(input.truncated ? { truncated: true } : {}),\n  }\n}\n\n/** counted − expected; positive is over, negative is short. */\nexport function posCashVarianceCents(countedCashCents: number, expectedCashCents: number): number {\n  return Math.round(Number(countedCashCents) || 0) - Math.round(Number(expectedCashCents) || 0)\n}\n\n/** `$12.34`, `-$0.50` — the register's money format, store currency USD. */\nexport function posMoney(cents: number): string {\n  const value = Math.round(Number(cents) || 0)\n  return `${value < 0 ? '-' : ''}$${(Math.abs(value) / 100).toFixed(2)}`\n}\n\n/** One CSV cell, quoted when it needs to be and never read as a formula. */\nfunction csvCell(value: unknown): string {\n  let cell = value == null ? '' : String(value)\n  if (/^[=+\\-@\\t\\r]/.test(cell) && !/^-?\\d+(\\.\\d+)?$/.test(cell)) cell = `'${cell}`\n  return /[\",\\r\\n]/.test(cell) ? `\"${cell.replace(/\"/g, '\"\"')}\"` : cell\n}\n\nexport { csvCell as posCsvCell }\n\nconst dollars = (cents: number | null | undefined): string =>\n  cents == null ? '' : (Math.round(cents) / 100).toFixed(2)\n\n/** The shift history as a spreadsheet: one row per shift, money in dollars. */\nexport function posShiftsCsv(\n  shifts: ReadonlyArray<PosShift & { id: string; registerName?: string }>,\n  memberName: (uid: string) => string = (uid) => uid,\n): string {\n  const header = [\n    'Shift',\n    'Register',\n    'Opened',\n    'Opened by',\n    'Closed',\n    'Closed by',\n    'Orders',\n    'Gross sales',\n    'Refunds',\n    'Net sales',\n    'Discounts',\n    'Tax',\n    'Tips',\n    'Cash sales',\n    'Card sales',\n    'Gift card sales',\n    'Room charges',\n    'Opening float',\n    'Paid in',\n    'Paid out',\n    'Safe drops',\n    'Cash refunds',\n    'Expected cash',\n    'Counted cash',\n    'Variance',\n  ]\n  const iso = (ms: number | null | undefined) => (ms ? new Date(ms).toISOString() : '')\n  const rows = shifts.map((shift) => {\n    const report = shift.report\n    const card = report\n      ? (report.salesByTender.card_present ?? 0) +\n        (report.salesByTender.card_keyed ?? 0) +\n        (report.salesByTender.card_link ?? 0)\n      : undefined\n    return [\n      shift.id,\n      shift.registerName ?? shift.registerId,\n      iso(shift.openedAtMs),\n      shift.openedByName ?? memberName(shift.openedBy),\n      iso(shift.closedAtMs),\n      shift.closedBy ? (shift.closedByName ?? memberName(shift.closedBy)) : '',\n      report?.orderCount ?? '',\n      dollars(report?.grossSalesCents),\n      dollars(report?.refundsCents),\n      dollars(report?.netSalesCents),\n      dollars(report?.discountsCents),\n      dollars(report?.taxCents),\n      dollars(report?.tipsCents),\n      dollars(report?.cashSalesCents),\n      dollars(card),\n      dollars(report ? (report.salesByTender.gift_card ?? 0) : undefined),\n      dollars(report ? (report.salesByTender.folio ?? 0) : undefined),\n      dollars(shift.openingFloatCents),\n      dollars(report?.paidInCents),\n      dollars(report?.paidOutCents),\n      dollars(report?.dropsCents),\n      dollars(report?.cashRefundsCents),\n      dollars(shift.expectedCashCents ?? report?.expectedCashCents),\n      dollars(shift.countedCashCents),\n      dollars(shift.varianceCents),\n    ]\n  })\n  return [header, ...rows].map((row) => row.map(csvCell).join(',')).join('\\r\\n')\n}\n\n/*==========================================\n * RETURNS AT THE REGISTER\n *=========================================*/\n\n/** One line picked for return: its index on the order and how many units. */\nexport interface PosReturnPick {\n  index: number\n  quantity: number\n}\n\n/** The order fields a return reads. */\nexport interface PosReturnSource extends PosTenderSource {\n  lineItems?: Array<{ unitAmountCents?: number; quantity?: number; name?: string }> | null\n  totals?: {\n    totalCents?: number\n    discountCents?: number\n    taxCents?: number\n    shippingCents?: number\n    tipCents?: number\n  } | null\n  refundedCents?: number\n  refundedLineItemIds?: number[]\n  /** Units of each line already returned at a register, by line index. */\n  returnedQuantities?: Record<string, number>\n  /** Cents already refunded to each payment by a register return. */\n  posPaymentRefunds?: Record<string, number>\n}\n\n/**\n * What each line is worth back, whole: its price less its share of the\n * order's discount, plus its share of the order's tax — the same\n * apportionment `orderLineRefundCents` uses for the discount, extended to the\n * tax a register sale charged on top. Shipping and tips are not a line's.\n */\nexport function posReturnLineValues(order: PosReturnSource): number[] {\n  const lines = order.lineItems ?? []\n  const gross = lines.map(\n    (line) =>\n      Math.max(0, Math.round(Number(line?.unitAmountCents ?? 0))) *\n      Math.max(1, Math.round(Number(line?.quantity ?? 1))),\n  )\n  const discountShares = apportionCents(gross, wholeCents(order.totals?.discountCents))\n  const net = gross.map((cents, index) => Math.max(0, cents - (discountShares[index] ?? 0)))\n  const taxShares = apportionCents(net, wholeCents(order.totals?.taxCents))\n  return net.map((cents, index) => cents + (taxShares[index] ?? 0))\n}\n\n/** Units of each line already returned, a line refunded whole counting as all of it. */\nexport function posReturnedQuantities(order: PosReturnSource): number[] {\n  const lines = order.lineItems ?? []\n  const wholeLines = new Set(order.refundedLineItemIds ?? [])\n  return lines.map((line, index) => {\n    const quantity = Math.max(1, Math.round(Number(line?.quantity ?? 1)))\n    if (wholeLines.has(index)) return quantity\n    const returned = Math.round(Number(order.returnedQuantities?.[String(index)] ?? 0))\n    return Math.min(quantity, Math.max(0, Number.isFinite(returned) ? returned : 0))\n  })\n}\n\nexport type PosReturnPlan =\n  | {\n      ok: true\n      refundCents: number\n      /** Cents per picked line, in the order picked. */\n      lineCents: number[]\n      /** The order's per-line returned quantities after this return. */\n      returnedQuantities: Record<string, number>\n      /** Lines this return finishes, for `refundedLineItemIds`. */\n      completedLines: number[]\n    }\n  | { ok: false; error: string }\n\n/**\n * What a return of these picks refunds, to the cent.\n *\n * Each line's value is split across its units CUMULATIVELY: returning `k` of\n * `n` units already returned `r` refunds `round(V·(r+k)/n) − round(V·r/n)`,\n * so returning a line one unit at a time refunds exactly what returning it\n * whole would have, and the rounding never strands or invents a cent. The\n * sum is capped at what is left to refund on the order — a refund given\n * from the order dialog already took its share.\n *\n * `heldElsewhere` is, per line, the units an online return (the returns\n * flow) already holds or took back. They cap what the register may take, but\n * they are not written into `returnedQuantities`, which counts only what the\n * register itself took.\n */\nexport function planPosReturn(\n  order: PosReturnSource,\n  picks: readonly PosReturnPick[],\n  heldElsewhere: readonly number[] = [],\n): PosReturnPlan {\n  const lines = order.lineItems ?? []\n  if (!picks.length) return { ok: false, error: 'Pick at least one item to return.' }\n  const values = posReturnLineValues(order)\n  const returned = posReturnedQuantities(order)\n  const seen = new Set<number>()\n  const lineCents: number[] = []\n  const nextReturned: Record<string, number> = {}\n  for (const [index, count] of returned.entries()) if (count > 0) nextReturned[String(index)] = count\n  const completedLines: number[] = []\n  for (const pick of picks) {\n    const index = Number(pick.index)\n    const quantity = Number(pick.quantity)\n    if (!Number.isInteger(index) || index < 0 || index >= lines.length) {\n      return { ok: false, error: `Line ${pick.index} is not on this order.` }\n    }\n    if (seen.has(index)) return { ok: false, error: 'Each line can be picked once.' }\n    seen.add(index)\n    if (!Number.isInteger(quantity) || quantity < 1) {\n      return { ok: false, error: 'Return at least one of each line you pick.' }\n    }\n    const total = Math.max(1, Math.round(Number(lines[index]?.quantity ?? 1)))\n    const already = returned[index] ?? 0\n    const held = Math.max(0, Math.round(Number(heldElsewhere[index] ?? 0)))\n    if (already + held + quantity > total) {\n      const left = Math.max(0, total - already - held)\n      return {\n        ok: false,\n        error:\n          left > 0\n            ? `Only ${left} of \"${lines[index]?.name ?? 'that item'}\" can still be returned.`\n            : held > 0\n              ? `\"${lines[index]?.name ?? 'That item'}\" is already in a return. Finish it under Returns.`\n              : `\"${lines[index]?.name ?? 'That item'}\" has already been returned.`,\n      }\n    }\n    const value = values[index] ?? 0\n    lineCents.push(\n      Math.round((value * (already + quantity)) / total) - Math.round((value * already) / total),\n    )\n    nextReturned[String(index)] = already + quantity\n    if (already + quantity === total) completedLines.push(index)\n  }\n  const remaining = Math.max(\n    0,\n    wholeCents(order.totals?.totalCents) - wholeCents(order.refundedCents),\n  )\n  const asked = lineCents.reduce((sum, cents) => sum + cents, 0)\n  const refundCents = Math.min(asked, remaining)\n  if (!(refundCents > 0)) return { ok: false, error: 'Nothing is left to refund on this order.' }\n  return { ok: true, refundCents, lineCents, returnedQuantities: nextReturned, completedLines }\n}\n\n/** One slice of a refund, sent back to one of the sale's payments. */\nexport interface PosRefundAllocation {\n  paymentId: string\n  method: PosTenderMethod\n  amountCents: number\n}\n\n/**\n * What each payment can still take back: what it put toward the sale, less\n * what register returns already sent to it. A refund given from the order\n * dialog refunds through Stripe without naming a payment, so whatever it\n * took that no payment accounts for comes off the Stripe payments first.\n */\nexport function posRefundableByTender(order: PosReturnSource): Array<PosOrderTender & { refundableCents: number }> {\n  const tenders = posOrderTenders(order)\n  const attributed = Object.values(order.posPaymentRefunds ?? {}).reduce(\n    (sum, cents) => sum + wholeCents(cents),\n    0,\n  )\n  let unattributed = Math.max(0, wholeCents(order.refundedCents) - attributed)\n  const ordered = [...tenders].sort(\n    (a, b) => Number(POS_STRIPE_TENDERS.has(b.method)) - Number(POS_STRIPE_TENDERS.has(a.method)),\n  )\n  const refundable = new Map<string, number>()\n  for (const tender of ordered) {\n    let left = Math.max(0, tender.amountCents - wholeCents(order.posPaymentRefunds?.[tender.id]))\n    if (POS_STRIPE_TENDERS.has(tender.method) && unattributed > 0) {\n      const taken = Math.min(left, unattributed)\n      left -= taken\n      unattributed -= taken\n    }\n    refundable.set(tender.id, left)\n  }\n  return tenders.map((tender) => ({ ...tender, refundableCents: refundable.get(tender.id) ?? 0 }))\n}\n\n/**\n * The order a refund goes back in, when the cashier does not split it by\n * hand: the cards first, then store credit, then the room, and the drawer\n * LAST — so cash leaves the till only for what the customer paid in cash.\n */\nconst REFUND_ORDER: readonly PosTenderMethod[] = [\n  'card_present',\n  'card_keyed',\n  'card_link',\n  'gift_card',\n  'credit',\n  'folio',\n  'cash',\n]\n\nexport type PosRefundSplit =\n  | { ok: true; allocations: PosRefundAllocation[] }\n  | { ok: false; error: string }\n\n/**\n * Sends `amountCents` back to the sale's own payments.\n *\n * With no `requested` split, each payment takes what it can in\n * {@link REFUND_ORDER}. With one, every slice must name a payment of this\n * sale and fit what that payment can still take, and the slices must add up\n * to the refund exactly — a refund is never sent to a tender the sale was\n * not paid with.\n */\nexport function splitPosRefund(\n  order: PosReturnSource,\n  amountCents: number,\n  requested?: ReadonlyArray<{ paymentId: string; amountCents: number }> | null,\n): PosRefundSplit {\n  const amount = wholeCents(amountCents)\n  const tenders = posRefundableByTender(order)\n  if (!tenders.length) return { ok: false, error: 'This order has no payment to refund to.' }\n  if (requested && requested.length) {\n    const allocations: PosRefundAllocation[] = []\n    const used = new Set<string>()\n    for (const slice of requested) {\n      const tender = tenders.find((candidate) => candidate.id === slice.paymentId)\n      if (!tender) return { ok: false, error: 'That payment is not on this order.' }\n      if (used.has(tender.id)) return { ok: false, error: 'Each payment can be named once.' }\n      used.add(tender.id)\n      const cents = Math.round(Number(slice.amountCents))\n      if (!Number.isFinite(cents) || cents < 0) return { ok: false, error: 'Refund amounts must be positive.' }\n      if (cents === 0) continue\n      if (cents > tender.refundableCents) {\n        return {\n          ok: false,\n          error: `${posTenderLabel(tender)} can take back at most ${posMoney(tender.refundableCents)}.`,\n        }\n      }\n      allocations.push({ paymentId: tender.id, method: tender.method, amountCents: cents })\n    }\n    const total = allocations.reduce((sum, slice) => sum + slice.amountCents, 0)\n    if (total !== amount) {\n      return {\n        ok: false,\n        error: `The refund is ${posMoney(amount)}; the split adds up to ${posMoney(total)}.`,\n      }\n    }\n    return { ok: true, allocations }\n  }\n  const ordered = [...tenders].sort(\n    (a, b) => REFUND_ORDER.indexOf(a.method) - REFUND_ORDER.indexOf(b.method),\n  )\n  const allocations: PosRefundAllocation[] = []\n  let left = amount\n  for (const tender of ordered) {\n    if (!(left > 0)) break\n    const cents = Math.min(left, tender.refundableCents)\n    if (!(cents > 0)) continue\n    allocations.push({ paymentId: tender.id, method: tender.method, amountCents: cents })\n    left -= cents\n  }\n  if (left > 0) {\n    return {\n      ok: false,\n      error: `Only ${posMoney(amount - left)} can go back to this sale's payments.`,\n    }\n  }\n  return { ok: true, allocations }\n}\n\n/** `hosts/{hostId}/registers/{registerId}/returns/{returnId}`. */\nexport interface PosRegisterReturn {\n  hostId: string\n  registerId: string\n  orderId: string\n  orderNumber?: number\n  /** The shift the drawer was in when the return was rung, if one was open. */\n  shiftId?: string\n  lines: Array<{ index: number; quantity: number; name: string; refundCents: number }>\n  refundedCents: number\n  tenders: Array<PosRefundAllocation & { status: 'refunded' | 'failed'; refundId?: string; error?: string }>\n  restocked: boolean\n  locationId?: string\n  /** The member at the register (by PIN or by sign-in). */\n  cashierId: string\n  /** The manager whose PIN allowed a refund above the cashier's limit. */\n  approvedBy?: string\n  reason?: string\n  status: 'refunded' | 'partial'\n  atMs: number\n}\n\n/*==========================================\n * STAFF PINS\n *=========================================*/\n\n/** How long a cashier PIN switch lasts before the register asks again. */\nexport const POS_CASHIER_ASSERTION_TTL_MS = 15 * 60 * 1000\n/** A manager's approval is for the one refund in front of them. */\nexport const POS_MANAGER_ASSERTION_TTL_MS = 2 * 60 * 1000\n/** Wrong PINs in a row before the member is locked out. */\nexport const POS_PIN_MAX_ATTEMPTS = 5\n/** How long a lockout lasts. */\nexport const POS_PIN_LOCKOUT_MS = 15 * 60 * 1000\n\n/**\n * Why a PIN cannot be used, or `null` when it can: 4 to 6 digits, and not\n * one a stranger tries first — every digit the same, or a straight run.\n */\nexport function posPinProblem(pin: unknown): string | null {\n  const value = typeof pin === 'string' ? pin : ''\n  if (!/^\\d{4,6}$/.test(value)) return 'A PIN is 4 to 6 digits.'\n  if (/^(\\d)\\1+$/.test(value)) return 'Pick a PIN that is not one digit repeated.'\n  const digits = [...value].map(Number)\n  const step = (digits[1] ?? 0) - (digits[0] ?? 0)\n  if (\n    (step === 1 || step === -1) &&\n    digits.every((digit, index) => index === 0 || digit - (digits[index - 1] ?? 0) === step)\n  ) {\n    return 'Pick a PIN that is not a straight run like 1234.'\n  }\n  return null\n}\n\n/*==========================================\n * THE THERMAL RECEIPT\n *=========================================*/\n\nexport interface PosReceiptLine {\n  name: string\n  variantLabel?: string\n  quantity: number\n  unitAmountCents: number\n  lineCents: number\n}\n\nexport interface PosReceipt {\n  storeName: string\n  logoUrl?: string\n  addressLines: string[]\n  orderNumber: string\n  /** The digits the barcode encodes and the register's return lookup reads. */\n  barcodeValue: string\n  dateLabel: string\n  cashierName?: string\n  registerName?: string\n  customerName?: string\n  lines: PosReceiptLine[]\n  subtotalCents: number\n  discountCents: number\n  taxCents: number\n  totalCents: number\n  tipCents: number\n  tenders: Array<{ label: string; amountCents: number }>\n  changeCents: number\n  refundedCents: number\n  footer?: string\n  returnPolicy?: string\n  /** A gift receipt: the items and nothing about what they cost. */\n  gift: boolean\n}\n\n/** The order fields a receipt prints. */\nexport interface PosReceiptOrder extends PosReturnSource {\n  number?: number\n  createdAtMs?: number\n  customerName?: string | null\n  lineItems?: Array<{\n    name?: string\n    variantLabel?: string\n    unitAmountCents?: number\n    quantity?: number\n  }> | null\n}\n\n/**\n * The receipt for one sale, from the order alone plus what the store prints\n * on every receipt. The sale's lines, totals, tenders and change are the\n * receipt model's (`receiptDataFromOrder`, the one the cloud printers print\n * from), so a browser print and a cloud print never disagree; this adds the\n * logo, the address, the return policy and the gift receipt. A gift receipt\n * keeps the lines and the barcode — the recipient's way to return — and\n * drops every price, total and tender.\n */\nexport function buildPosReceipt(input: {\n  orderId: string\n  order: PosReceiptOrder\n  store: {\n    name: string\n    logoUrl?: string\n    address?: string\n    footer?: string\n    returnPolicy?: string\n  }\n  cashierName?: string\n  registerName?: string\n  gift?: boolean\n  /** How the date prints; the register's own locale by default. */\n  formatDate?: (ms: number) => string\n}): PosReceipt {\n  const { order } = input\n  const gift = input.gift === true\n  const data = receiptDataFromOrder(input.orderId, order as unknown as HostOrder & Record<string, any>, {\n    storeName: input.store.name,\n  })\n  const lines: PosReceiptLine[] = data.lines.map((line) => ({\n    name: line.name,\n    ...(line.detail ? { variantLabel: line.detail } : {}),\n    quantity: line.quantity,\n    unitAmountCents: gift ? 0 : line.unitCents,\n    lineCents: gift ? 0 : line.totalCents,\n  }))\n  const number = Number(order.number)\n  const digits = Number.isInteger(number) && number > 0 ? String(number) : ''\n  const createdAtMs = Number(order.createdAtMs) || 0\n  const formatDate =\n    input.formatDate ?? ((ms: number) => (ms ? new Date(ms).toLocaleString() : ''))\n  const money = (cents: number | undefined) => (gift ? 0 : wholeCents(cents))\n  return {\n    storeName: input.store.name,\n    ...(input.store.logoUrl ? { logoUrl: input.store.logoUrl } : {}),\n    addressLines: String(input.store.address ?? '')\n      .split(/\\r?\\n/)\n      .map((line) => line.trim())\n      .filter(Boolean),\n    orderNumber: digits ? `#${digits}` : `#${input.orderId.slice(0, 8)}`,\n    barcodeValue: digits || input.orderId,\n    dateLabel: formatDate(createdAtMs),\n    ...(input.cashierName ? { cashierName: input.cashierName } : {}),\n    ...(input.registerName ? { registerName: input.registerName } : {}),\n    ...(order.customerName ? { customerName: String(order.customerName) } : {}),\n    lines,\n    subtotalCents: money(data.subtotalCents),\n    discountCents: money(data.discountCents),\n    taxCents: money(data.taxCents),\n    totalCents: money(data.totalCents),\n    tipCents: money(data.tipCents),\n    tenders: gift ? [] : (data.tenders ?? []),\n    changeCents: money(data.changeCents),\n    refundedCents: money(data.refundedCents),\n    // A sale of card reader hardware prints the terms it is sold under\n    // (AGL-4038, Terms 4.28), after the store's own footer.\n    ...(withPosHardwareReceiptNotice(input.store.footer, order as Record<string, unknown>)\n      ? { footer: withPosHardwareReceiptNotice(input.store.footer, order as Record<string, unknown>) }\n      : {}),\n    ...(input.store.returnPolicy ? { returnPolicy: input.store.returnPolicy } : {}),\n    gift,\n  }\n}\n\n/** One titled block of an X or Z report: what the screen, the browser print and a cloud printer all show. */\nexport interface PosShiftReportSection {\n  section: string\n  rows: Array<{ label: string; value: string; strong?: boolean }>\n}\n\n/** The rows of an X or Z report, in the order a manager reads them. */\nexport function posShiftReportRows(\n  report: PosShiftReport,\n  shift?: Pick<PosShift, 'countedCashCents' | 'varianceCents'>,\n): PosShiftReportSection[] {\n  const tenders = POS_TENDER_METHODS.filter(\n    (method) => (report.salesByTender[method] ?? 0) > 0 || (report.refundsByTender[method] ?? 0) > 0,\n  )\n  return [\n    {\n      section: 'Sales',\n      rows: [\n        { label: 'Orders', value: String(report.orderCount) },\n        { label: 'Gross sales', value: posMoney(report.grossSalesCents) },\n        { label: 'Discounts', value: posMoney(report.discountsCents) },\n        { label: 'Tax', value: posMoney(report.taxCents) },\n        { label: 'Tips', value: posMoney(report.tipsCents) },\n        { label: `Refunds (${report.refundCount})`, value: `-${posMoney(report.refundsCents)}` },\n        { label: 'Net sales', value: posMoney(report.netSalesCents), strong: true },\n      ],\n    },\n    {\n      section: 'By tender',\n      rows: tenders.length\n        ? tenders.map((method) => ({\n            label: POS_TENDER_LABELS[method],\n            value:\n              posMoney(report.salesByTender[method] ?? 0) +\n              ((report.refundsByTender[method] ?? 0) > 0\n                ? ` (−${posMoney(report.refundsByTender[method] ?? 0)})`\n                : ''),\n          }))\n        : [{ label: 'No sales yet', value: '' }],\n    },\n    {\n      section: 'Cash drawer',\n      rows: [\n        { label: 'Starting cash', value: posMoney(report.openingFloatCents) },\n        { label: 'Cash sales', value: posMoney(report.cashSalesCents) },\n        { label: 'Paid in', value: posMoney(report.paidInCents) },\n        { label: 'Paid out', value: `-${posMoney(report.paidOutCents)}` },\n        { label: 'Safe drops', value: `-${posMoney(report.dropsCents)}` },\n        { label: 'Cash refunds', value: `-${posMoney(report.cashRefundsCents)}` },\n        { label: 'Expected in drawer', value: posMoney(report.expectedCashCents), strong: true },\n        ...(shift?.countedCashCents != null\n          ? [\n              { label: 'Counted', value: posMoney(shift.countedCashCents) },\n              {\n                label: (shift.varianceCents ?? 0) < 0 ? 'Short' : (shift.varianceCents ?? 0) > 0 ? 'Over' : 'Balanced',\n                value: posMoney(shift.varianceCents ?? 0),\n                strong: true,\n              },\n            ]\n          : []),\n      ],\n    },\n  ]\n}\n\n/** A shift's X or Z report as the receipt printer prints it. */\nexport function posShiftPrintReport(input: {\n  title: 'X REPORT' | 'Z REPORT'\n  storeName: string\n  registerName?: string\n  report: PosShiftReport\n  shift?: Pick<PosShift, 'countedCashCents' | 'varianceCents'>\n  subtitle?: string\n}): PrintReport {\n  return {\n    title: input.title,\n    storeName: input.storeName,\n    ...(input.subtitle || input.registerName\n      ? { subtitle: [input.registerName, input.subtitle].filter(Boolean).join(' - ') }\n      : {}),\n    sections: posShiftReportRows(input.report, input.shift),\n  }\n}\n"],"names":["apportionCents","withPosHardwareReceiptNotice","orderPayments","receiptDataFromOrder","POS_TENDER_METHODS","POS_TENDER_LABELS","cash","card_present","card_keyed","card_link","gift_card","folio","credit","POS_STRIPE_TENDERS","Set","wholeCents","value","number","Math","round","Number","isFinite","isTenderMethod","includes","posOrderTenders","order","filter","payment","status","method","map","id","amountCents","tipCents","totals","paymentIntentId","giftCardId","reservationId","creditProviderId","creditReference","creditLabel","cardBrand","last4","cashTenderedCents","changeCents","posTenderLabel","tender","base","capitalize","charAt","toUpperCase","slice","POS_CASH_EVENT_LABELS","paid_in","paid_out","drop","refund","posCashEventTotals","events","sum","type","event","reduce","total","paidInCents","paidOutCents","dropsCents","cashRefundsCents","posExpectedCashCents","input","openingFloatCents","cashSalesCents","computePosShiftReport","salesByTender","refundsByTender","orderCount","grossSalesCents","discountsCents","taxCents","tipsCents","sale","sales","tenders","totalCents","discountCents","tenderTips","max","refundsCents","refunds","refundedCents","shift","cashEvents","refundCount","length","netSalesCents","expectedCashCents","truncated","posCashVarianceCents","countedCashCents","posMoney","cents","abs","toFixed","csvCell","cell","String","test","replace","posCsvCell","dollars","posShiftsCsv","shifts","memberName","uid","header","iso","ms","Date","toISOString","rows","report","card","undefined","registerName","registerId","openedAtMs","openedByName","openedBy","closedAtMs","closedBy","closedByName","varianceCents","row","join","posReturnLineValues","lines","lineItems","gross","line","unitAmountCents","quantity","discountShares","net","index","taxShares","posReturnedQuantities","wholeLines","refundedLineItemIds","has","returned","returnedQuantities","min","planPosReturn","picks","heldElsewhere","ok","error","values","seen","lineCents","nextReturned","count","entries","completedLines","pick","isInteger","add","already","held","left","name","push","remaining","asked","refundCents","posRefundableByTender","attributed","Object","posPaymentRefunds","unattributed","ordered","sort","a","b","refundable","Map","taken","set","refundableCents","get","REFUND_ORDER","splitPosRefund","requested","amount","allocations","used","find","candidate","paymentId","indexOf","POS_CASHIER_ASSERTION_TTL_MS","POS_MANAGER_ASSERTION_TTL_MS","POS_PIN_MAX_ATTEMPTS","POS_PIN_LOCKOUT_MS","posPinProblem","pin","digits","step","every","digit","buildPosReceipt","data","gift","orderId","storeName","store","detail","variantLabel","unitCents","createdAtMs","formatDate","toLocaleString","money","logoUrl","addressLines","address","split","trim","Boolean","orderNumber","barcodeValue","dateLabel","cashierName","customerName","subtotalCents","footer","returnPolicy","posShiftReportRows","section","label","strong","posShiftPrintReport","title","subtitle","sections"],"mappings":"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"}

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

@@ -222,7 +222,13 @@ export type PosDisplayMode = 'idle'
 /** The customer picks how they want their receipt. */
  | 'receipt'
 /** A card payment is waiting on the reader. */
- | 'processing' | 'thanks';
+ | 'processing' | 'thanks'
+/**
+ * Another plugin's screen (AGL-4042), asked for through core's customer
+ * display seam (`plugin-customer-display`): the display opens that
+ * plugin's public page, which sends it back here when the customer is done.
+ */
+ | 'screen';
 export type PosReceiptChannel = 'email' | 'sms' | 'print' | 'none';
 export interface PosDisplayLine {
     name: string;
@@ -280,8 +286,28 @@ export interface PosDisplayState {
     processing?: {
         message: string;
     };
+    /** The plugin page a `screen` state opens, as core's seam shapes it. */
+    screen?: PosDisplayScreen;
+    /**
+     * The staff member (uid) who put {@link screen} on the display (AGL-4042),
+     * stamped by the server from the session that pushed it, never taken from
+     * the register's body. Core's display verifier names them to the screen's
+     * plugin, whose record of what the customer did there names who showed it.
+     * Never sent to the display.
+     */
+    screenShownBy?: string;
     response?: PosDisplayResponse;
 }
+/**
+ * A plugin's screen on the display (AGL-4042): the shape of core's
+ * `CustomerDisplayScreen`, restated so this module imports nothing. The
+ * server checks it with core's own sanitizer before it is stored.
+ */
+export interface PosDisplayScreen {
+    pluginId: string;
+    path: string;
+    params: Record<string, string>;
+}
 /** Most lines a display state carries; a longer basket shows its newest. */
 export declare const POS_DISPLAY_MAX_LINES = 60;
 /** A pairing code lives this long before the register must show a new one. */
@@ -297,7 +323,14 @@ export declare function posDisplayPhone(value: unknown): string;
  * of anything the customer screen has no business holding. The register is
  * staff and trusted for intent, not for shape.
  */
-export declare function sanitizePosDisplayState(raw: unknown, nowMs: number): PosDisplayState;
+export declare function sanitizePosDisplayState(raw: unknown, nowMs: number, options?: {
+    /**
+     * Checks a `screen` state's plugin page (core's
+     * `sanitizeCustomerDisplayScreen`). Without it, or when it refuses, a
+     * `screen` state is idle: nothing opens on the display unchecked.
+     */
+    screen?: (raw: unknown) => PosDisplayScreen | null;
+}): PosDisplayState;
 /**
  * The customer's answer as the DISPLAY may send it, checked against the
  * prompt it claims to answer. Returns null when it answers nothing the
@@ -310,6 +343,6 @@ export declare function sanitizePosDisplayResponse(state: PosDisplayState | null
  * screen shows what comes next, so nothing a later customer could read off
  * an unattended tablet is ever sent to it.
  */
-export declare function posDisplayPublicState(state: PosDisplayState | null | undefined, nowMs: number): Omit<PosDisplayState, 'response'> & {
+export declare function posDisplayPublicState(state: PosDisplayState | null | undefined, nowMs: number): Omit<PosDisplayState, 'response' | 'screenShownBy'> & {
     answered: boolean;
 };

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

@@ -277,7 +277,7 @@ const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  * The display state as the REGISTER may send it: clamped, typed and stripped
  * of anything the customer screen has no business holding. The register is
  * staff and trusted for intent, not for shape.
- */ export function sanitizePosDisplayState(raw, nowMs) {
+ */ export function sanitizePosDisplayState(raw, nowMs, options = {}) {
     var _input_promptId;
     const input = raw && typeof raw === 'object' ? raw : {};
     const modes = [
@@ -286,15 +286,21 @@ const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
         'tip',
         'receipt',
         'processing',
-        'thanks'
+        'thanks',
+        'screen'
     ];
-    const mode = modes.includes(input['mode']) ? input['mode'] : 'idle';
+    const asked = modes.includes(input['mode']) ? input['mode'] : 'idle';
+    const promptId = String((_input_promptId = input['promptId']) != null ? _input_promptId : '').slice(0, 64);
+    // A screen opens once per prompt, so one without a prompt, or one the
+    // checker refuses, opens nothing.
+    const screen = asked === 'screen' && promptId && options.screen ? options.screen(input['screen']) : null;
+    const mode = asked === 'screen' && !screen ? 'idle' : asked;
     const state = {
         mode,
         updatedAtMs: nowMs
     };
-    const promptId = String((_input_promptId = input['promptId']) != null ? _input_promptId : '').slice(0, 64);
     if (promptId) state.promptId = promptId;
+    if (mode === 'screen' && screen) state.screen = screen;
     const cart = input['cart'];
     if (cart && typeof cart === 'object' && mode !== 'idle') {
         const lines = (Array.isArray(cart.lines) ? cart.lines : []).slice(-POS_DISPLAY_MAX_LINES).map((line)=>{
@@ -426,8 +432,10 @@ const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
         updatedAtMs: nowMs,
         answered: false
     };
-    const { response } = state, rest = _object_without_properties_loose(state, [
-        "response"
+    // Who showed a plugin's screen is the server's to know, not the display's.
+    const { response, screenShownBy: _shownBy } = state, rest = _object_without_properties_loose(state, [
+        "response",
+        "screenShownBy"
     ]);
     if (rest.mode === 'thanks' && nowMs - rest.updatedAtMs > POS_DISPLAY_THANKS_MS) {
         return {