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

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

@@ -0,0 +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\nexport const POS_TENDER_METHODS: readonly PosTenderMethod[] = [\n  'cash',\n  'card_present',\n  'card_keyed',\n  'card_link',\n  'gift_card',\n  'folio',\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}\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  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.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(tender: Pick<PosOrderTender, 'method' | 'cardBrand' | 'last4'>): string {\n  const base = 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  closedAtMs?: number\n  /** What the closing cashier counted in the drawer. */\n  countedCashCents?: number\n  expectedCashCents?: number\n  /** counted − expected: positive is over, negative is short. */\n  varianceCents?: number\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\nconst dollars = (cents: number | 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 | 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  '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","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","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","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":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,cAAc,QAAwB,uBAAmB;AAClE,SAASC,aAAa,QAAQ,oBAAgB;AAE9C,SAASC,oBAAoB,QAAQ,wBAAoB;AA6BzD,OAAO,MAAMC,qBAAiD;IAC5D;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,oEAAoE,GACpE,OAAO,MAAMC,oBAA+D;IAC1EC,MAAM;IACNC,cAAc;IACdC,YAAY;IACZC,WAAW;IACXC,WAAW;IACXC,OAAO;AACT,EAAC;AAED,2EAA2E,GAC3E,OAAO,MAAMC,qBAAmD,IAAIC,IAAI;IACtE;IACA;IACA;CACD,EAAC;AAsBF,MAAMC,aAAa,CAACC;IAClB,MAAMC,SAASC,KAAKC,KAAK,CAACC,OAAOJ;IACjC,OAAOI,OAAOC,QAAQ,CAACJ,WAAWA,SAAS,IAAIA,SAAS;AAC1D;AAGA,MAAMK,iBAAiB,CAACN,QACtB,OAAOA,UAAU,YAAY,AAACX,mBAAyCkB,QAAQ,CAACP;AAclF;;;;;;;;;;;;CAYC,GACD,OAAO,SAASQ,gBAAgBC,KAAyC;IACvE,IAAI,CAACA,OAAO,OAAO,EAAE;IACrB,OAAOtB,cAAcsB,OAClBC,MAAM,CAAC,CAACC,UAAYA,QAAQC,MAAM,KAAK,eAAeN,eAAeK,QAAQE,MAAM,GACnFC,GAAG,CAAC,CAACH;YAIiBA;YAA+CF;eAJnD;YACjBM,IAAIJ,QAAQI,EAAE;YACdF,QAAQF,QAAQE,MAAM;YACtBG,aAAajB,WAAWY,QAAQK,WAAW;YAC3CC,UAAUlB,YAAWY,oBAAAA,QAAQM,QAAQ,YAAhBN,oBAAqBA,QAAQI,EAAE,KAAK,YAAWN,gBAAAA,MAAMS,MAAM,qBAAZT,cAAcQ,QAAQ,GAAG;WACzFN,QAAQQ,eAAe,GAAG;YAAEA,iBAAiBR,QAAQQ,eAAe;QAAC,IAAI,CAAC,GAC1ER,QAAQS,UAAU,GAAG;YAAEA,YAAYT,QAAQS,UAAU;QAAC,IAAI,CAAC,GAC3DT,QAAQU,aAAa,GAAG;YAAEA,eAAeV,QAAQU,aAAa;QAAC,IAAI,CAAC,GACpEV,QAAQW,SAAS,GAAG;YAAEA,WAAWX,QAAQW,SAAS;QAAC,IAAI,CAAC,GACxDX,QAAQY,KAAK,GAAG;YAAEA,OAAOZ,QAAQY,KAAK;QAAC,IAAI,CAAC,GAC5CZ,QAAQa,iBAAiB,IAAI,OAAO;YAAEA,mBAAmBzB,WAAWY,QAAQa,iBAAiB;QAAE,IAAI,CAAC,GACpGb,QAAQc,WAAW,IAAI,OAAO;YAAEA,aAAa1B,WAAWY,QAAQc,WAAW;QAAE,IAAI,CAAC;;AAE5F;AAEA,uDAAuD,GACvD,OAAO,SAASC,eAAeC,MAA8D;QAC9ErC;IAAb,MAAMsC,QAAOtC,mCAAAA,iBAAiB,CAACqC,OAAOd,MAAM,CAAC,YAAhCvB,mCAAoCqC,OAAOd,MAAM;IAC9D,IAAIc,OAAOJ,KAAK,EAAE;QAChB,OAAO,GAAGI,OAAOL,SAAS,GAAGO,WAAWF,OAAOL,SAAS,IAAIM,KAAK,IAAI,EAAED,OAAOJ,KAAK,EAAE;IACvF;IACA,OAAOK;AACT;AAEA,SAASC,WAAW7B,KAAa;IAC/B,OAAOA,QAAQA,MAAM8B,MAAM,CAAC,GAAGC,WAAW,KAAK/B,MAAMgC,KAAK,CAAC,KAAKhC;AAClE;AAaA,OAAO,MAAMiC,wBAAoE;IAC/EC,SAAS;IACTC,UAAU;IACVC,MAAM;IACNC,QAAQ;AACV,EAAC;AAiED,2CAA2C,GAC3C,OAAO,SAASC,mBAAmBC,MAAkD;IAMnF,MAAMC,MAAM,CAACC,OACX,CAACF,iBAAAA,SAAU,EAAE,EACV7B,MAAM,CAAC,CAACgC,QAAUA,CAAAA,yBAAAA,MAAOD,IAAI,MAAKA,MAClCE,MAAM,CAAC,CAACC,OAAOF,QAAUE,QAAQ7C,WAAW2C,MAAM1B,WAAW,GAAG;IACrE,OAAO;QACL6B,aAAaL,IAAI;QACjBM,cAAcN,IAAI;QAClBO,YAAYP,IAAI;QAChBQ,kBAAkBR,IAAI;IACxB;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASS,qBAAqBC,KAOpC;IACC,OACEnD,WAAWmD,MAAMC,iBAAiB,IAClCpD,WAAWmD,MAAME,cAAc,IAC/BrD,WAAWmD,MAAML,WAAW,IAC5B9C,WAAWmD,MAAMJ,YAAY,IAC7B/C,WAAWmD,MAAMH,UAAU,IAC3BhD,WAAWmD,MAAMF,gBAAgB;AAErC;AAkBA;;;;;;CAMC,GACD,OAAO,SAASK,sBAAsBH,KAKrC;IACC,MAAMI,gBAA0D,CAAC;IACjE,MAAMC,kBAA4D,CAAC;IACnE,IAAIC,aAAa;IACjB,IAAIC,kBAAkB;IACtB,IAAIC,iBAAiB;IACrB,IAAIC,WAAW;IACf,IAAIC,YAAY;IAChB,IAAIR,iBAAiB;IACrB,KAAK,MAAMS,QAAQX,MAAMY,KAAK,CAAE;;YAIAD,cACDA,eACNA,eAEUA;QAPjC,IAAIA,KAAKjD,MAAM,KAAK,aAAaiD,KAAKjD,MAAM,KAAK,aAAa;QAC9D,MAAMmD,UAAUvD,gBAAgBqD;QAChCL,cAAc;QACdC,mBAAmB1D,oBAAW8D,eAAAA,KAAK3C,MAAM,qBAAX2C,aAAaG,UAAU,mBAAIH,KAAK7C,WAAW;QACzE0C,kBAAkB3D,YAAW8D,gBAAAA,KAAK3C,MAAM,qBAAX2C,cAAaI,aAAa;QACvDN,YAAY5D,YAAW8D,gBAAAA,KAAK3C,MAAM,qBAAX2C,cAAaF,QAAQ;QAC5C,MAAMO,aAAaH,QAAQpB,MAAM,CAAC,CAACH,KAAKb,SAAWa,MAAMb,OAAOV,QAAQ,EAAE;QAC1E2C,aAAa1D,KAAKiE,GAAG,CAACpE,YAAW8D,gBAAAA,KAAK3C,MAAM,qBAAX2C,cAAa5C,QAAQ,GAAGiD;QACzD,KAAK,MAAMvC,UAAUoC,QAAS;gBACIT;YAAhCA,aAAa,CAAC3B,OAAOd,MAAM,CAAC,GAAG,EAACyC,+BAAAA,aAAa,CAAC3B,OAAOd,MAAM,CAAC,YAA5ByC,+BAAgC,KAAK3B,OAAOX,WAAW;YACvF,IAAIW,OAAOd,MAAM,KAAK,QAAQuC,kBAAkBzB,OAAOX,WAAW,GAAGW,OAAOV,QAAQ;QACtF;IACF;IACA,IAAImD,eAAe;IACnB,KAAK,MAAM/B,UAAUa,MAAMmB,OAAO,CAAE;YAEbhC;QADrB+B,gBAAgBrE,WAAWsC,OAAOiC,aAAa;QAC/C,KAAK,MAAM3C,WAAUU,kBAAAA,OAAO0B,OAAO,YAAd1B,kBAAkB,EAAE,CAAE;gBAGtCkB;YAFH,IAAI,CAACjD,eAAeqB,OAAOd,MAAM,GAAG;YACpC0C,eAAe,CAAC5B,OAAOd,MAAM,CAAC,GAC5B,EAAC0C,iCAAAA,eAAe,CAAC5B,OAAOd,MAAM,CAAC,YAA9B0C,iCAAkC,KAAKxD,WAAW4B,OAAOX,WAAW;QACzE;IACF;IACA,MAAMzB,OAAO+C,mBAAmBY,MAAMqB,KAAK,CAACC,UAAU;IACtD,MAAMrB,oBAAoBpD,WAAWmD,MAAMqB,KAAK,CAACpB,iBAAiB;IAClE,OAAO;QACLK;QACAC;QACAC;QACAC;QACAC;QACAN;QACAmB,aAAavB,MAAMmB,OAAO,CAACK,MAAM;QACjCN;QACAb;QACAoB,eAAelB,kBAAkBW;QACjCjB;QACAC;OACG7D;QACHqF,mBAAmB3B,qBAAqB;YAAEE;YAAmBC;WAAmB7D;OAC5E2D,MAAM2B,SAAS,GAAG;QAAEA,WAAW;IAAK,IAAI,CAAC;AAEjD;AAEA,6DAA6D,GAC7D,OAAO,SAASC,qBAAqBC,gBAAwB,EAAEH,iBAAyB;IACtF,OAAO1E,KAAKC,KAAK,CAACC,OAAO2E,qBAAqB,KAAK7E,KAAKC,KAAK,CAACC,OAAOwE,sBAAsB;AAC7F;AAEA,0EAA0E,GAC1E,OAAO,SAASI,SAASC,KAAa;IACpC,MAAMjF,QAAQE,KAAKC,KAAK,CAACC,OAAO6E,UAAU;IAC1C,OAAO,GAAGjF,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,AAACE,CAAAA,KAAKgF,GAAG,CAAClF,SAAS,GAAE,EAAGmF,OAAO,CAAC,IAAI;AACxE;AAEA,0EAA0E,GAC1E,SAASC,QAAQpF,KAAc;IAC7B,IAAIqF,OAAOrF,SAAS,OAAO,KAAKsF,OAAOtF;IACvC,IAAI,eAAeuF,IAAI,CAACF,SAAS,CAAC,kBAAkBE,IAAI,CAACF,OAAOA,OAAO,CAAC,CAAC,EAAEA,MAAM;IACjF,OAAO,WAAWE,IAAI,CAACF,QAAQ,CAAC,CAAC,EAAEA,KAAKG,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,GAAGH;AACnE;AAEA,MAAMI,UAAU,CAACR,QACfA,SAAS,OAAO,KAAK,AAAC/E,CAAAA,KAAKC,KAAK,CAAC8E,SAAS,GAAE,EAAGE,OAAO,CAAC;AAEzD,6EAA6E,GAC7E,OAAO,SAASO,aACdC,MAAuE,EACvEC,aAAsC,CAACC,MAAQA,GAAG;IAElD,MAAMC,SAAS;QACb;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;KACD;IACD,MAAMC,MAAM,CAACC,KAA4BA,KAAK,IAAIC,KAAKD,IAAIE,WAAW,KAAK;IAC3E,MAAMC,OAAOR,OAAO7E,GAAG,CAAC,CAACyD;YAGlB6B,oCACAA,kCACAA,iCAIH7B,qBAEAA,qBAEkBA,2BAUA6B,iCACAA,6BAMV7B;QA7BV,MAAM6B,SAAS7B,MAAM6B,MAAM;QAC3B,MAAMC,OAAOD,SACT,EAACA,qCAAAA,OAAO9C,aAAa,CAAC9D,YAAY,YAAjC4G,qCAAqC,OACrCA,mCAAAA,OAAO9C,aAAa,CAAC7D,UAAU,YAA/B2G,mCAAmC,OACnCA,kCAAAA,OAAO9C,aAAa,CAAC5D,SAAS,YAA9B0G,kCAAkC,KACnCE;QACJ,OAAO;YACL/B,MAAMxD,EAAE;aACRwD,sBAAAA,MAAMgC,YAAY,YAAlBhC,sBAAsBA,MAAMiC,UAAU;YACtCT,IAAIxB,MAAMkC,UAAU;aACpBlC,sBAAAA,MAAMmC,YAAY,YAAlBnC,sBAAsBqB,WAAWrB,MAAMoC,QAAQ;YAC/CZ,IAAIxB,MAAMqC,UAAU;YACpBrC,MAAMsC,QAAQ,IAAItC,sBAAAA,MAAMuC,YAAY,YAAlBvC,sBAAsBqB,WAAWrB,MAAMsC,QAAQ,IAAK;oBACtET,0BAAAA,OAAQ5C,UAAU,mBAAI;YACtBiC,QAAQW,0BAAAA,OAAQ3C,eAAe;YAC/BgC,QAAQW,0BAAAA,OAAQhC,YAAY;YAC5BqB,QAAQW,0BAAAA,OAAQzB,aAAa;YAC7Bc,QAAQW,0BAAAA,OAAQ1C,cAAc;YAC9B+B,QAAQW,0BAAAA,OAAQzC,QAAQ;YACxB8B,QAAQW,0BAAAA,OAAQxC,SAAS;YACzB6B,QAAQW,0BAAAA,OAAQhD,cAAc;YAC9BqC,QAAQY;YACRZ,QAAQW,UAAUA,kCAAAA,OAAO9C,aAAa,CAAC3D,SAAS,YAA9ByG,kCAAkC,IAAKE;YACzDb,QAAQW,UAAUA,8BAAAA,OAAO9C,aAAa,CAAC1D,KAAK,YAA1BwG,8BAA8B,IAAKE;YACrDb,QAAQlB,MAAMpB,iBAAiB;YAC/BsC,QAAQW,0BAAAA,OAAQvD,WAAW;YAC3B4C,QAAQW,0BAAAA,OAAQtD,YAAY;YAC5B2C,QAAQW,0BAAAA,OAAQrD,UAAU;YAC1B0C,QAAQW,0BAAAA,OAAQpD,gBAAgB;YAChCyC,SAAQlB,2BAAAA,MAAMK,iBAAiB,YAAvBL,2BAA2B6B,0BAAAA,OAAQxB,iBAAiB;YAC5Da,QAAQlB,MAAMQ,gBAAgB;YAC9BU,QAAQlB,MAAMwC,aAAa;SAC5B;IACH;IACA,OAAO;QAACjB;WAAWK;KAAK,CAACrF,GAAG,CAAC,CAACkG,MAAQA,IAAIlG,GAAG,CAACsE,SAAS6B,IAAI,CAAC,MAAMA,IAAI,CAAC;AACzE;AA8BA;;;;;CAKC,GACD,OAAO,SAASC,oBAAoBzG,KAAsB;QAC1CA;QAM0CA,eAEPA;IARjD,MAAM0G,SAAQ1G,mBAAAA,MAAM2G,SAAS,YAAf3G,mBAAmB,EAAE;IACnC,MAAM4G,QAAQF,MAAMrG,GAAG,CACrB,CAACwG;;eACCpH,KAAKiE,GAAG,CAAC,GAAGjE,KAAKC,KAAK,CAACC,eAAOkH,wBAAAA,KAAMC,eAAe,mBAAI,OACvDrH,KAAKiE,GAAG,CAAC,GAAGjE,KAAKC,KAAK,CAACC,gBAAOkH,wBAAAA,KAAME,QAAQ,oBAAI;;IAEpD,MAAMC,iBAAiBvI,eAAemI,OAAOtH,YAAWU,gBAAAA,MAAMS,MAAM,qBAAZT,cAAcwD,aAAa;IACnF,MAAMyD,MAAML,MAAMvG,GAAG,CAAC,CAACmE,OAAO0C;YAA+BF;eAArBvH,KAAKiE,GAAG,CAAC,GAAGc,UAASwC,wBAAAA,cAAc,CAACE,MAAM,YAArBF,wBAAyB;;IACtF,MAAMG,YAAY1I,eAAewI,KAAK3H,YAAWU,iBAAAA,MAAMS,MAAM,qBAAZT,eAAckD,QAAQ;IACvE,OAAO+D,IAAI5G,GAAG,CAAC,CAACmE,OAAO0C;YAAmBC;eAAT3C,UAAS2C,mBAAAA,SAAS,CAACD,MAAM,YAAhBC,mBAAoB;;AAChE;AAEA,sFAAsF,GACtF,OAAO,SAASC,sBAAsBpH,KAAsB;QAC5CA,kBACaA;IAD3B,MAAM0G,SAAQ1G,mBAAAA,MAAM2G,SAAS,YAAf3G,mBAAmB,EAAE;IACnC,MAAMqH,aAAa,IAAIhI,KAAIW,6BAAAA,MAAMsH,mBAAmB,YAAzBtH,6BAA6B,EAAE;IAC1D,OAAO0G,MAAMrG,GAAG,CAAC,CAACwG,MAAMK;;YAGalH;QAFnC,MAAM+G,WAAWtH,KAAKiE,GAAG,CAAC,GAAGjE,KAAKC,KAAK,CAACC,eAAOkH,wBAAAA,KAAME,QAAQ,mBAAI;QACjE,IAAIM,WAAWE,GAAG,CAACL,QAAQ,OAAOH;QAClC,MAAMS,WAAW/H,KAAKC,KAAK,CAACC,iBAAOK,4BAAAA,MAAMyH,kBAAkB,qBAAxBzH,yBAA0B,CAAC6E,OAAOqC,OAAO,oBAAI;QAChF,OAAOzH,KAAKiI,GAAG,CAACX,UAAUtH,KAAKiE,GAAG,CAAC,GAAG/D,OAAOC,QAAQ,CAAC4H,YAAYA,WAAW;IAC/E;AACF;AAeA;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASG,cACd3H,KAAsB,EACtB4H,KAA+B,EAC/BC,gBAAmC,EAAE;QAEvB7H;QA4CDA;IA5Cb,MAAM0G,SAAQ1G,mBAAAA,MAAM2G,SAAS,YAAf3G,mBAAmB,EAAE;IACnC,IAAI,CAAC4H,MAAM3D,MAAM,EAAE,OAAO;QAAE6D,IAAI;QAAOC,OAAO;IAAoC;IAClF,MAAMC,SAASvB,oBAAoBzG;IACnC,MAAMwH,WAAWJ,sBAAsBpH;IACvC,MAAMiI,OAAO,IAAI5I;IACjB,MAAM6I,YAAsB,EAAE;IAC9B,MAAMC,eAAuC,CAAC;IAC9C,KAAK,MAAM,CAACjB,OAAOkB,MAAM,IAAIZ,SAASa,OAAO,GAAI,IAAID,QAAQ,GAAGD,YAAY,CAACtD,OAAOqC,OAAO,GAAGkB;IAC9F,MAAME,iBAA2B,EAAE;IACnC,KAAK,MAAMC,QAAQX,MAAO;kBAYRJ,iBAC2BK,sBAa7BG;YAf8BtB;QAV5C,MAAMQ,QAAQvH,OAAO4I,KAAKrB,KAAK;QAC/B,MAAMH,WAAWpH,OAAO4I,KAAKxB,QAAQ;QACrC,IAAI,CAACpH,OAAO6I,SAAS,CAACtB,UAAUA,QAAQ,KAAKA,SAASR,MAAMzC,MAAM,EAAE;YAClE,OAAO;gBAAE6D,IAAI;gBAAOC,OAAO,CAAC,KAAK,EAAEQ,KAAKrB,KAAK,CAAC,sBAAsB,CAAC;YAAC;QACxE;QACA,IAAIe,KAAKV,GAAG,CAACL,QAAQ,OAAO;YAAEY,IAAI;YAAOC,OAAO;QAAgC;QAChFE,KAAKQ,GAAG,CAACvB;QACT,IAAI,CAACvH,OAAO6I,SAAS,CAACzB,aAAaA,WAAW,GAAG;YAC/C,OAAO;gBAAEe,IAAI;gBAAOC,OAAO;YAA6C;QAC1E;QACA,MAAM5F,QAAQ1C,KAAKiE,GAAG,CAAC,GAAGjE,KAAKC,KAAK,CAACC,gBAAO+G,eAAAA,KAAK,CAACQ,MAAM,qBAAZR,aAAcK,QAAQ,mBAAI;QACtE,MAAM2B,WAAUlB,kBAAAA,QAAQ,CAACN,MAAM,YAAfM,kBAAmB;QACnC,MAAMmB,OAAOlJ,KAAKiE,GAAG,CAAC,GAAGjE,KAAKC,KAAK,CAACC,QAAOkI,uBAAAA,aAAa,CAACX,MAAM,YAApBW,uBAAwB;QACnE,IAAIa,UAAUC,OAAO5B,WAAW5E,OAAO;;gBAMTuE,eAEdA,eACAA;YARd,MAAMkC,OAAOnJ,KAAKiE,GAAG,CAAC,GAAGvB,QAAQuG,UAAUC;YAC3C,OAAO;gBACLb,IAAI;gBACJC,OACEa,OAAO,IACH,CAAC,KAAK,EAAEA,KAAK,KAAK,YAAElC,gBAAAA,KAAK,CAACQ,MAAM,qBAAZR,cAAcmC,IAAI,oBAAI,YAAY,wBAAwB,CAAC,GAC/EF,OAAO,IACL,CAAC,CAAC,YAAEjC,gBAAAA,KAAK,CAACQ,MAAM,qBAAZR,cAAcmC,IAAI,oBAAI,YAAY,kDAAkD,CAAC,GACzF,CAAC,CAAC,YAAEnC,gBAAAA,KAAK,CAACQ,MAAM,qBAAZR,cAAcmC,IAAI,oBAAI,YAAY,4BAA4B,CAAC;YAC7E;QACF;QACA,MAAMtJ,SAAQyI,gBAAAA,MAAM,CAACd,MAAM,YAAbc,gBAAiB;QAC/BE,UAAUY,IAAI,CACZrJ,KAAKC,KAAK,CAAC,AAACH,QAASmJ,CAAAA,UAAU3B,QAAO,IAAM5E,SAAS1C,KAAKC,KAAK,CAAC,AAACH,QAAQmJ,UAAWvG;QAEtFgG,YAAY,CAACtD,OAAOqC,OAAO,GAAGwB,UAAU3B;QACxC,IAAI2B,UAAU3B,aAAa5E,OAAOmG,eAAeQ,IAAI,CAAC5B;IACxD;IACA,MAAM6B,YAAYtJ,KAAKiE,GAAG,CACxB,GACApE,YAAWU,gBAAAA,MAAMS,MAAM,qBAAZT,cAAcuD,UAAU,IAAIjE,WAAWU,MAAM6D,aAAa;IAEvE,MAAMmF,QAAQd,UAAUhG,MAAM,CAAC,CAACH,KAAKyC,QAAUzC,MAAMyC,OAAO;IAC5D,MAAMyE,cAAcxJ,KAAKiI,GAAG,CAACsB,OAAOD;IACpC,IAAI,CAAEE,CAAAA,cAAc,CAAA,GAAI,OAAO;QAAEnB,IAAI;QAAOC,OAAO;IAA2C;IAC9F,OAAO;QAAED,IAAI;QAAMmB;QAAaf;QAAWT,oBAAoBU;QAAcG;IAAe;AAC9F;AASA;;;;;CAKC,GACD,OAAO,SAASY,sBAAsBlJ,KAAsB;QAEzBA;IADjC,MAAMsD,UAAUvD,gBAAgBC;IAChC,MAAMmJ,aAAaC,OAAOpB,MAAM,EAAChI,2BAAAA,MAAMqJ,iBAAiB,YAAvBrJ,2BAA2B,CAAC,GAAGkC,MAAM,CACpE,CAACH,KAAKyC,QAAUzC,MAAMzC,WAAWkF,QACjC;IAEF,IAAI8E,eAAe7J,KAAKiE,GAAG,CAAC,GAAGpE,WAAWU,MAAM6D,aAAa,IAAIsF;IACjE,MAAMI,UAAU;WAAIjG;KAAQ,CAACkG,IAAI,CAC/B,CAACC,GAAGC,IAAM/J,OAAOP,mBAAmBmI,GAAG,CAACmC,EAAEtJ,MAAM,KAAKT,OAAOP,mBAAmBmI,GAAG,CAACkC,EAAErJ,MAAM;IAE7F,MAAMuJ,aAAa,IAAIC;IACvB,KAAK,MAAM1I,UAAUqI,QAAS;YAC2BvJ;QAAvD,IAAI4I,OAAOnJ,KAAKiE,GAAG,CAAC,GAAGxC,OAAOX,WAAW,GAAGjB,YAAWU,4BAAAA,MAAMqJ,iBAAiB,qBAAvBrJ,yBAAyB,CAACkB,OAAOZ,EAAE,CAAC;QAC3F,IAAIlB,mBAAmBmI,GAAG,CAACrG,OAAOd,MAAM,KAAKkJ,eAAe,GAAG;YAC7D,MAAMO,QAAQpK,KAAKiI,GAAG,CAACkB,MAAMU;YAC7BV,QAAQiB;YACRP,gBAAgBO;QAClB;QACAF,WAAWG,GAAG,CAAC5I,OAAOZ,EAAE,EAAEsI;IAC5B;IACA,OAAOtF,QAAQjD,GAAG,CAAC,CAACa;YAA0CyI;eAA9B,aAAKzI;YAAQ6I,eAAe,GAAEJ,kBAAAA,WAAWK,GAAG,CAAC9I,OAAOZ,EAAE,aAAxBqJ,kBAA6B;;;AAC7F;AAEA;;;;CAIC,GACD,MAAMM,eAA2C;IAC/C;IACA;IACA;IACA;IACA;IACA;CACD;AAMD;;;;;;;;CAQC,GACD,OAAO,SAASC,eACdlK,KAAsB,EACtBO,WAAmB,EACnB4J,SAA4E;IAE5E,MAAMC,SAAS9K,WAAWiB;IAC1B,MAAM+C,UAAU4F,sBAAsBlJ;IACtC,IAAI,CAACsD,QAAQW,MAAM,EAAE,OAAO;QAAE6D,IAAI;QAAOC,OAAO;IAA0C;IAC1F,IAAIoC,aAAaA,UAAUlG,MAAM,EAAE;QACjC,MAAMoG,cAAqC,EAAE;QAC7C,MAAMC,OAAO,IAAIjL;QACjB,KAAK,MAAMkC,SAAS4I,UAAW;YAC7B,MAAMjJ,SAASoC,QAAQiH,IAAI,CAAC,CAACC,YAAcA,UAAUlK,EAAE,KAAKiB,MAAMkJ,SAAS;YAC3E,IAAI,CAACvJ,QAAQ,OAAO;gBAAE4G,IAAI;gBAAOC,OAAO;YAAqC;YAC7E,IAAIuC,KAAK/C,GAAG,CAACrG,OAAOZ,EAAE,GAAG,OAAO;gBAAEwH,IAAI;gBAAOC,OAAO;YAAkC;YACtFuC,KAAK7B,GAAG,CAACvH,OAAOZ,EAAE;YAClB,MAAMkE,QAAQ/E,KAAKC,KAAK,CAACC,OAAO4B,MAAMhB,WAAW;YACjD,IAAI,CAACZ,OAAOC,QAAQ,CAAC4E,UAAUA,QAAQ,GAAG,OAAO;gBAAEsD,IAAI;gBAAOC,OAAO;YAAmC;YACxG,IAAIvD,UAAU,GAAG;YACjB,IAAIA,QAAQtD,OAAO6I,eAAe,EAAE;gBAClC,OAAO;oBACLjC,IAAI;oBACJC,OAAO,GAAG9G,eAAeC,QAAQ,uBAAuB,EAAEqD,SAASrD,OAAO6I,eAAe,EAAE,CAAC,CAAC;gBAC/F;YACF;YACAM,YAAYvB,IAAI,CAAC;gBAAE2B,WAAWvJ,OAAOZ,EAAE;gBAAEF,QAAQc,OAAOd,MAAM;gBAAEG,aAAaiE;YAAM;QACrF;QACA,MAAMrC,QAAQkI,YAAYnI,MAAM,CAAC,CAACH,KAAKR,QAAUQ,MAAMR,MAAMhB,WAAW,EAAE;QAC1E,IAAI4B,UAAUiI,QAAQ;YACpB,OAAO;gBACLtC,IAAI;gBACJC,OAAO,CAAC,cAAc,EAAExD,SAAS6F,QAAQ,uBAAuB,EAAE7F,SAASpC,OAAO,CAAC,CAAC;YACtF;QACF;QACA,OAAO;YAAE2F,IAAI;YAAMuC;QAAY;IACjC;IACA,MAAMd,UAAU;WAAIjG;KAAQ,CAACkG,IAAI,CAC/B,CAACC,GAAGC,IAAMO,aAAaS,OAAO,CAACjB,EAAErJ,MAAM,IAAI6J,aAAaS,OAAO,CAAChB,EAAEtJ,MAAM;IAE1E,MAAMiK,cAAqC,EAAE;IAC7C,IAAIzB,OAAOwB;IACX,KAAK,MAAMlJ,UAAUqI,QAAS;QAC5B,IAAI,CAAEX,CAAAA,OAAO,CAAA,GAAI;QACjB,MAAMpE,QAAQ/E,KAAKiI,GAAG,CAACkB,MAAM1H,OAAO6I,eAAe;QACnD,IAAI,CAAEvF,CAAAA,QAAQ,CAAA,GAAI;QAClB6F,YAAYvB,IAAI,CAAC;YAAE2B,WAAWvJ,OAAOZ,EAAE;YAAEF,QAAQc,OAAOd,MAAM;YAAEG,aAAaiE;QAAM;QACnFoE,QAAQpE;IACV;IACA,IAAIoE,OAAO,GAAG;QACZ,OAAO;YACLd,IAAI;YACJC,OAAO,CAAC,KAAK,EAAExD,SAAS6F,SAASxB,MAAM,qCAAqC,CAAC;QAC/E;IACF;IACA,OAAO;QAAEd,IAAI;QAAMuC;IAAY;AACjC;AAwBA;;2CAE2C,GAE3C,wEAAwE,GACxE,OAAO,MAAMM,+BAA+B,KAAK,KAAK,KAAI;AAC1D,iEAAiE,GACjE,OAAO,MAAMC,+BAA+B,IAAI,KAAK,KAAI;AACzD,yDAAyD,GACzD,OAAO,MAAMC,uBAAuB,EAAC;AACrC,8BAA8B,GAC9B,OAAO,MAAMC,qBAAqB,KAAK,KAAK,KAAI;AAEhD;;;CAGC,GACD,OAAO,SAASC,cAAcC,GAAY;QAK1BC,UAAmBA;IAJjC,MAAM1L,QAAQ,OAAOyL,QAAQ,WAAWA,MAAM;IAC9C,IAAI,CAAC,YAAYlG,IAAI,CAACvF,QAAQ,OAAO;IACrC,IAAI,YAAYuF,IAAI,CAACvF,QAAQ,OAAO;IACpC,MAAM0L,SAAS;WAAI1L;KAAM,CAACc,GAAG,CAACV;IAC9B,MAAMuL,OAAO,EAACD,WAAAA,MAAM,CAAC,EAAE,YAATA,WAAa,OAAMA,YAAAA,MAAM,CAAC,EAAE,YAATA,YAAa;IAC9C,IACE,AAACC,CAAAA,SAAS,KAAKA,SAAS,CAAC,CAAA,KACzBD,OAAOE,KAAK,CAAC,CAACC,OAAOlE;YAAkC+D;eAAxB/D,UAAU,KAAKkE,UAASH,WAAAA,MAAM,CAAC/D,QAAQ,EAAE,YAAjB+D,WAAqB,OAAOC;QACnF;QACA,OAAO;IACT;IACA,OAAO;AACT;AAqDA;;;;;;;;CAQC,GACD,OAAO,SAASG,gBAAgB5I,KAe/B;QAiBGA,mBAKqBA,sBAgBC6I;IArCxB,MAAM,EAAEtL,KAAK,EAAE,GAAGyC;IAClB,MAAM8I,OAAO9I,MAAM8I,IAAI,KAAK;IAC5B,MAAMD,OAAO3M,qBAAqB8D,MAAM+I,OAAO,EAAExL,OAAqD;QACpGyL,WAAWhJ,MAAMiJ,KAAK,CAAC7C,IAAI;IAC7B;IACA,MAAMnC,QAA0B4E,KAAK5E,KAAK,CAACrG,GAAG,CAAC,CAACwG,OAAU;YACxDgC,MAAMhC,KAAKgC,IAAI;WACXhC,KAAK8E,MAAM,GAAG;YAAEC,cAAc/E,KAAK8E,MAAM;QAAC,IAAI,CAAC;YACnD5E,UAAUF,KAAKE,QAAQ;YACvBD,iBAAiByE,OAAO,IAAI1E,KAAKgF,SAAS;YAC1C3D,WAAWqD,OAAO,IAAI1E,KAAKtD,UAAU;;IAEvC,MAAM/D,SAASG,OAAOK,MAAMR,MAAM;IAClC,MAAMyL,SAAStL,OAAO6I,SAAS,CAAChJ,WAAWA,SAAS,IAAIqF,OAAOrF,UAAU;IACzE,MAAMsM,cAAcnM,OAAOK,MAAM8L,WAAW,KAAK;IACjD,MAAMC,cACJtJ,oBAAAA,MAAMsJ,UAAU,YAAhBtJ,oBAAqB,CAAC8C,KAAgBA,KAAK,IAAIC,KAAKD,IAAIyG,cAAc,KAAK;IAC7E,MAAMC,QAAQ,CAACzH,QAA+B+G,OAAO,IAAIjM,WAAWkF;IACpE,OAAO;QACLiH,WAAWhJ,MAAMiJ,KAAK,CAAC7C,IAAI;OACvBpG,MAAMiJ,KAAK,CAACQ,OAAO,GAAG;QAAEA,SAASzJ,MAAMiJ,KAAK,CAACQ,OAAO;IAAC,IAAI,CAAC;QAC9DC,cAActH,QAAOpC,uBAAAA,MAAMiJ,KAAK,CAACU,OAAO,YAAnB3J,uBAAuB,IACzC4J,KAAK,CAAC,SACNhM,GAAG,CAAC,CAACwG,OAASA,KAAKyF,IAAI,IACvBrM,MAAM,CAACsM;QACVC,aAAavB,SAAS,CAAC,CAAC,EAAEA,QAAQ,GAAG,CAAC,CAAC,EAAExI,MAAM+I,OAAO,CAACjK,KAAK,CAAC,GAAG,IAAI;QACpEkL,cAAcxB,UAAUxI,MAAM+I,OAAO;QACrCkB,WAAWX,WAAWD;OAClBrJ,MAAMkK,WAAW,GAAG;QAAEA,aAAalK,MAAMkK,WAAW;IAAC,IAAI,CAAC,GAC1DlK,MAAMqD,YAAY,GAAG;QAAEA,cAAcrD,MAAMqD,YAAY;IAAC,IAAI,CAAC,GAC7D9F,MAAM4M,YAAY,GAAG;QAAEA,cAAc/H,OAAO7E,MAAM4M,YAAY;IAAE,IAAI,CAAC;QACzElG;QACAmG,eAAeZ,MAAMX,KAAKuB,aAAa;QACvCrJ,eAAeyI,MAAMX,KAAK9H,aAAa;QACvCN,UAAU+I,MAAMX,KAAKpI,QAAQ;QAC7BK,YAAY0I,MAAMX,KAAK/H,UAAU;QACjC/C,UAAUyL,MAAMX,KAAK9K,QAAQ;QAC7B8C,SAASiI,OAAO,EAAE,IAAID,gBAAAA,KAAKhI,OAAO,YAAZgI,gBAAgB,EAAE;QACxCtK,aAAaiL,MAAMX,KAAKtK,WAAW;QACnC6C,eAAeoI,MAAMX,KAAKzH,aAAa;OACnCpB,MAAMiJ,KAAK,CAACoB,MAAM,GAAG;QAAEA,QAAQrK,MAAMiJ,KAAK,CAACoB,MAAM;IAAC,IAAI,CAAC,GACvDrK,MAAMiJ,KAAK,CAACqB,YAAY,GAAG;QAAEA,cAActK,MAAMiJ,KAAK,CAACqB,YAAY;IAAC,IAAI,CAAC;QAC7ExB;;AAEJ;AAQA,qEAAqE,GACrE,OAAO,SAASyB,mBACdrH,MAAsB,EACtB7B,KAA4D;QA6CtCA,sBAA2CA,uBACnCA;IA5C9B,MAAMR,UAAU1E,mBAAmBqB,MAAM,CACvC,CAACG;YAAYuF,8BAA2CA;eAA5C,EAACA,+BAAAA,OAAO9C,aAAa,CAACzC,OAAO,YAA5BuF,+BAAgC,KAAK,KAAK,EAACA,iCAAAA,OAAO7C,eAAe,CAAC1C,OAAO,YAA9BuF,iCAAkC,KAAK;;IAEjG,OAAO;QACL;YACEsH,SAAS;YACTvH,MAAM;gBACJ;oBAAEwH,OAAO;oBAAU3N,OAAOsF,OAAOc,OAAO5C,UAAU;gBAAE;gBACpD;oBAAEmK,OAAO;oBAAe3N,OAAOgF,SAASoB,OAAO3C,eAAe;gBAAE;gBAChE;oBAAEkK,OAAO;oBAAa3N,OAAOgF,SAASoB,OAAO1C,cAAc;gBAAE;gBAC7D;oBAAEiK,OAAO;oBAAO3N,OAAOgF,SAASoB,OAAOzC,QAAQ;gBAAE;gBACjD;oBAAEgK,OAAO;oBAAQ3N,OAAOgF,SAASoB,OAAOxC,SAAS;gBAAE;gBACnD;oBAAE+J,OAAO,CAAC,SAAS,EAAEvH,OAAO3B,WAAW,CAAC,CAAC,CAAC;oBAAEzE,OAAO,CAAC,CAAC,EAAEgF,SAASoB,OAAOhC,YAAY,GAAG;gBAAC;gBACvF;oBAAEuJ,OAAO;oBAAa3N,OAAOgF,SAASoB,OAAOzB,aAAa;oBAAGiJ,QAAQ;gBAAK;aAC3E;QACH;QACA;YACEF,SAAS;YACTvH,MAAMpC,QAAQW,MAAM,GAChBX,QAAQjD,GAAG,CAAC,CAACD;oBAGAuF,8BACPA,gCACiBA;uBALE;oBACvBuH,OAAOrO,iBAAiB,CAACuB,OAAO;oBAChCb,OACEgF,UAASoB,+BAAAA,OAAO9C,aAAa,CAACzC,OAAO,YAA5BuF,+BAAgC,KACxC,CAAA,EAACA,iCAAAA,OAAO7C,eAAe,CAAC1C,OAAO,YAA9BuF,iCAAkC,KAAK,IACrC,CAAC,GAAG,EAAEpB,UAASoB,kCAAAA,OAAO7C,eAAe,CAAC1C,OAAO,YAA9BuF,kCAAkC,GAAG,CAAC,CAAC,GACtD,EAAC;gBACT;iBACA;gBAAC;oBAAEuH,OAAO;oBAAgB3N,OAAO;gBAAG;aAAE;QAC5C;QACA;YACE0N,SAAS;YACTvH,MAAM;gBACJ;oBAAEwH,OAAO;oBAAiB3N,OAAOgF,SAASoB,OAAOjD,iBAAiB;gBAAE;gBACpE;oBAAEwK,OAAO;oBAAc3N,OAAOgF,SAASoB,OAAOhD,cAAc;gBAAE;gBAC9D;oBAAEuK,OAAO;oBAAW3N,OAAOgF,SAASoB,OAAOvD,WAAW;gBAAE;gBACxD;oBAAE8K,OAAO;oBAAY3N,OAAO,CAAC,CAAC,EAAEgF,SAASoB,OAAOtD,YAAY,GAAG;gBAAC;gBAChE;oBAAE6K,OAAO;oBAAc3N,OAAO,CAAC,CAAC,EAAEgF,SAASoB,OAAOrD,UAAU,GAAG;gBAAC;gBAChE;oBAAE4K,OAAO;oBAAgB3N,OAAO,CAAC,CAAC,EAAEgF,SAASoB,OAAOpD,gBAAgB,GAAG;gBAAC;gBACxE;oBAAE2K,OAAO;oBAAsB3N,OAAOgF,SAASoB,OAAOxB,iBAAiB;oBAAGgJ,QAAQ;gBAAK;mBACnFrJ,CAAAA,yBAAAA,MAAOQ,gBAAgB,KAAI,OAC3B;oBACE;wBAAE4I,OAAO;wBAAW3N,OAAOgF,SAAST,MAAMQ,gBAAgB;oBAAE;oBAC5D;wBACE4I,OAAO,EAACpJ,uBAAAA,MAAMwC,aAAa,YAAnBxC,uBAAuB,KAAK,IAAI,UAAU,EAACA,wBAAAA,MAAMwC,aAAa,YAAnBxC,wBAAuB,KAAK,IAAI,SAAS;wBAC5FvE,OAAOgF,UAAST,wBAAAA,MAAMwC,aAAa,YAAnBxC,wBAAuB;wBACvCqJ,QAAQ;oBACV;iBACD,GACD,EAAE;aACP;QACH;KACD;AACH;AAEA,8DAA8D,GAC9D,OAAO,SAASC,oBAAoB3K,KAOnC;IACC,OAAO;QACL4K,OAAO5K,MAAM4K,KAAK;QAClB5B,WAAWhJ,MAAMgJ,SAAS;OACtBhJ,MAAM6K,QAAQ,IAAI7K,MAAMqD,YAAY,GACpC;QAAEwH,UAAU;YAAC7K,MAAMqD,YAAY;YAAErD,MAAM6K,QAAQ;SAAC,CAACrN,MAAM,CAACsM,SAAS/F,IAAI,CAAC;IAAO,IAC7E,CAAC;QACL+G,UAAUP,mBAAmBvK,MAAMkD,MAAM,EAAElD,MAAMqB,KAAK;;AAE1D"}

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

@@ -0,0 +1,263 @@
+/**
+ * @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.
+ */
+/** How one payment toward a register sale was taken. */
+export type OrderPaymentMethod = 'cash'
+/** A Stripe Terminal smart reader (tap, insert or swipe). */
+ | 'card_present'
+/** A card typed into the console by staff (card not present). */
+ | 'card_keyed'
+/** The Stripe payment page the customer opens from a QR code. */
+ | 'card_link' | 'gift_card'
+/** Charged to a checked-in reservation's folio. */
+ | 'folio';
+export type OrderPaymentStatus = 
+/** Started and not finished: reserves its amount against the balance. */
+'pending' | 'succeeded'
+/** Declined or errored; may be retried, reserves nothing. */
+ | 'failed' | 'canceled'
+/** Taken and then handed back when the open sale was voided. */
+ | 'reversed';
+export declare const ORDER_PAYMENT_METHODS: readonly OrderPaymentMethod[];
+/** One payment toward a register sale, on `HostOrder.payments`. */
+export interface OrderPayment {
+    /** Stable id, derived from the register's attempt key so a retry finds it. */
+    id: string;
+    method: OrderPaymentMethod;
+    /** Cents put toward the sale. Never includes the tip. */
+    amountCents: number;
+    /** Gratuity on top of `amountCents`, the merchant's and not revenue. */
+    tipCents?: number;
+    status: OrderPaymentStatus;
+    /** When the payment was started. */
+    atMs: number;
+    /** When it reached `succeeded`. */
+    settledAtMs?: number;
+    /** Stripe PaymentIntent for `card_present` / `card_keyed` / a paid link. */
+    paymentIntentId?: string;
+    /** Stripe Checkout Session for `card_link`. */
+    checkoutSessionId?: string;
+    /** The payment page a `card_link` payment shows as a QR. */
+    checkoutUrl?: string;
+    /** The Terminal reader a `card_present` payment runs on. */
+    readerId?: string;
+    /** The gift card's code (its document id) for `gift_card`. */
+    giftCardId?: string;
+    cardBrand?: string;
+    last4?: string;
+    /** Cash handed over for a `cash` payment, and the change given back. */
+    cashTenderedCents?: number;
+    changeCents?: number;
+    /** The stay a `folio` payment was charged to. */
+    reservationId?: string;
+    /** The folio entry's `atMs`, so a void can remove exactly that entry. */
+    folioAtMs?: number;
+    /**
+     * The platform's take attributed to this payment (excludes the tip). For a
+     * card payment it is netted from the payout with Stripe's processing cost
+     * added, and recorded in `feeCents`; otherwise it accrues to the invoice.
+     */
+    takeFeeCents?: number;
+    /** The `application_fee_amount` a card payment carried, or 0. */
+    feeCents?: number;
+    /** Why a `failed` payment failed, in words the cashier can read out. */
+    failureMessage?: string;
+    /** Whether Stripe moved real money; absent for tenders Stripe never saw. */
+    livemode?: boolean;
+    /** The console user who took the payment. */
+    cashierId?: string;
+}
+/** The tenders whose money moves through Stripe. */
+export declare const POS_CARD_METHODS: ReadonlySet<OrderPaymentMethod>;
+export declare function isCardPaymentMethod(method: OrderPaymentMethod): boolean;
+/**
+ * The order's payments, read through one door.
+ *
+ * Orders written before the ledger existed carry no `payments`, so one is
+ * INFERRED from the fields the single-tender register wrote: a folio sale has
+ * `reservationId`, a QR sale has `checkoutSessionId`, and anything else on the
+ * POS channel was cash. A pending legacy sale is the QR link still waiting.
+ * Online orders paid through Stripe Checkout read as one `card_link` payment.
+ * Nothing is written back: this is a reader, never a migration.
+ */
+export declare function orderPayments(order: {
+    payments?: OrderPayment[] | null;
+    channel?: string;
+    status?: string;
+    totals?: {
+        totalCents?: number;
+        tipCents?: number;
+    } | null;
+    amountCents?: number;
+    reservationId?: string;
+    checkoutSessionId?: string;
+    paymentIntentId?: string;
+    createdAtMs?: number;
+}): OrderPayment[];
+/** Cents put toward the sale by payments that succeeded. */
+export declare function posSettledCents(payments: readonly OrderPayment[]): number;
+/**
+ * Cents spoken for: succeeded payments plus the ones still in flight. A
+ * reader waiting for a tap has claimed its share of the balance, so a second
+ * tender cannot be started for the same money.
+ */
+export declare function posReservedCents(payments: readonly OrderPayment[]): number;
+/** What the customer still owes, by settled payments. */
+export declare function posBalanceDueCents(totalCents: number, payments: readonly OrderPayment[]): number;
+/** What a NEW payment may still take: the balance less what is in flight. */
+export declare function posTenderableCents(totalCents: number, payments: readonly OrderPayment[]): number;
+/** Tips taken across the sale's settled payments. */
+export declare function posTipCents(payments: readonly OrderPayment[]): number;
+/**
+ * The share of the sale's take a payment of `amountCents` carries.
+ *
+ * Proportional to the part of the SALE it pays, never to the tip. Card
+ * payments carry their share in `application_fee_amount`; whatever the card
+ * shares leave is accrued to the invoice at completion
+ * ({@link posInvoiceTakeCents}), so the take is exact however the sale was
+ * split and however each share rounded.
+ */
+export declare function posTakeShareCents(input: {
+    takeFeeCents: number;
+    totalCents: number;
+    amountCents: number;
+}): number;
+/**
+ * What of the sale's take was NOT netted from a card payout, and therefore
+ * goes on the merchant's invoice: the whole take less every succeeded card
+ * payment's share. Never negative.
+ */
+export declare function posInvoiceTakeCents(input: {
+    takeFeeCents: number;
+    payments: readonly OrderPayment[];
+}): number;
+/** How the sale's fee reaches the platform, from what actually paid it. */
+export declare function posFeeCollection(payments: readonly OrderPayment[]): 'payout' | 'invoice' | 'split';
+/** A one-line description of a payment for the register, receipt and timeline. */
+export declare function describeOrderPayment(payment: OrderPayment): string;
+export declare const ORDER_PAYMENT_METHOD_LABELS: Record<OrderPaymentMethod, string>;
+/** The presets a merchant starts with. */
+export declare const POS_TIP_PERCENTAGES_DEFAULT: readonly number[];
+/**
+ * The merchant's tip presets from the plugin setting, a comma list such as
+ * `15, 18, 20, 25`. Whole percentages from 1 to 100, at most four, in the order
+ * given; anything unreadable falls back to the defaults rather than showing
+ * the customer an empty choice.
+ */
+export declare function posTipPercentages(raw: unknown): number[];
+/** A percentage tip on `baseCents`, rounded to the cent. */
+export declare function posTipFromPercent(baseCents: number, percent: number): number;
+/** The largest tip the register accepts on one payment: the payment itself. */
+export declare function posTipProblem(tipCents: number, amountCents: number): string | null;
+export type PosDisplayMode = 'idle'
+/** The live basket, mirrored as the cashier builds it. */
+ | 'cart'
+/** The customer picks a tip. */
+ | 'tip'
+/** The customer picks how they want their receipt. */
+ | 'receipt'
+/** A card payment is waiting on the reader. */
+ | 'processing' | 'thanks';
+export type PosReceiptChannel = 'email' | 'sms' | 'print' | 'none';
+export interface PosDisplayLine {
+    name: string;
+    variantLabel?: string;
+    quantity: number;
+    amountCents: number;
+}
+export interface PosDisplayCart {
+    lines: PosDisplayLine[];
+    itemsCents: number;
+    discountCents: number;
+    taxCents: number;
+    totalCents: number;
+    /** Taken so far, and what is still due, once payments start. */
+    paidCents?: number;
+    dueCents?: number;
+    tipCents?: number;
+}
+/** The customer's answer to the current prompt. */
+export interface PosDisplayResponse {
+    /** The prompt this answers; a stale answer is refused. */
+    promptId: string;
+    tipCents?: number;
+    tipPercent?: number;
+    /** `none` when the customer chose no tip. */
+    tipChoice?: 'percent' | 'custom' | 'none';
+    receiptChannel?: PosReceiptChannel;
+    email?: string;
+    phone?: string;
+    marketingOptIn?: boolean;
+    atMs: number;
+}
+export interface PosDisplayState {
+    mode: PosDisplayMode;
+    updatedAtMs: number;
+    /**
+     * The ISO currency every amount on the screen is in (`usd`). Stamped by
+     * the server from the store's own currency, never taken from the register.
+     */
+    currency?: string;
+    /** Changes every time the register asks something new. */
+    promptId?: string;
+    cart?: PosDisplayCart;
+    tip?: {
+        /** What a percentage is taken of: the amount being paid now. */
+        baseCents: number;
+        percentages: number[];
+        allowCustom: boolean;
+    };
+    receipt?: {
+        channels: PosReceiptChannel[];
+        /** Whether to offer the store's marketing opt-in under the email field. */
+        offerMarketing: boolean;
+    };
+    processing?: {
+        message: string;
+    };
+    response?: PosDisplayResponse;
+}
+/** 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. */
+export declare const POS_DISPLAY_PAIRING_TTL_MS: number;
+/** A thank-you screen returns to idle on the display after this long. */
+export declare const POS_DISPLAY_THANKS_MS = 8000;
+/** An email address as the display may store it, or '' when it is not one. */
+export declare function posDisplayEmail(value: unknown): string;
+/** A phone number as digits with an optional leading +, or '' when too short. */
+export declare function posDisplayPhone(value: unknown): string;
+/**
+ * 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 declare function sanitizePosDisplayState(raw: unknown, nowMs: number): 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
+ * register asked: a stale screen, a replay, or a mode that takes no answer.
+ */
+export declare function sanitizePosDisplayResponse(state: PosDisplayState | null | undefined, raw: unknown, nowMs: number): PosDisplayResponse | null;
+/**
+ * The state as the DISPLAY reads it. The customer's own typed address is
+ * never echoed back to the screen: once answered, the prompt is done and the
+ * 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'> & {
+    answered: boolean;
+};