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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-payment.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 {\n  consumeRateLimit,\n  firebaseAdmin,\n  getPluginConfig,\n} from '@aglyn/tenant-data-admin'\nimport { buildRoute, Route, type PluginApiHandler } from '@aglyn/aglyn/server'\nimport recordCapturedContact from '@aglyn/aglyn/plugin-manager/record-captured-contact'\nimport { pluginSmsAvailable } from '@aglyn/aglyn/plugin-manager/plugin-sms-messaging'\nimport { finishPosDisplayReceipt } from './pos-display'\nimport * as CommerceModel from '../model'\nimport { posRegisterSettings } from '../plugin-config'\nimport {\n  authorizePosStaff,\n  posIdempotencyKey,\n  posQueryBody,\n  posRequestBody,\n  type PosStaff,\n} from './pos-auth'\nimport {\n  applyPosPayment,\n  deliverChosenPosReceipt,\n  posPaymentId,\n  posSaleSummary,\n  readPosSale,\n  releasePosSaleDiscount,\n  type PosLiftedOrder,\n  type PosPaymentOutcome,\n} from './pos-sale'\nimport { posPaymentCashierId } from './pos-sale-stamp'\nimport { printPosSaleReceipt } from './pos-print'\nimport {\n  POS_CURRENCY,\n  posStripe,\n  posStripeErrorMessage,\n  posStripeTestMode,\n  posTerminalAvailable,\n} from './pos-stripe'\nimport {\n  cancelPosCardPayment,\n  createCardPresentIntent,\n  refreshPosCardPayment,\n  retryCardPresentPayment,\n  simulatePosReaderTap,\n  startCardKeyedPayment,\n  startCardLinkPayment,\n  startCardPresentPayment,\n} from './pos-terminal'\n\n/**\n * `POST /api/commerce/pos-payment` (AGL-3607): every tender against an OPEN\n * register sale, one `action` per request.\n *\n * The sale was priced by `pos-order.ts` (`payment: 'open'`); nothing here\n * re-prices it or lets the register name a total. Each payment-starting action\n * needs the register's `Idempotency-Key`, from which the payment's id is\n * derived: pressing a tender twice, or retrying after a lost response, finds\n * the payment the first press started instead of taking the money twice.\n */\nexport const posPaymentHandler: PluginApiHandler = async (req, res) => {\n  // `sale` is a read and may be a GET, so a register re-reading its sale does\n  // not spend the console's write budget; everything else moves money.\n  const body = req.method === 'GET' ? posQueryBody(req) : posRequestBody(req)\n  if (\n    !(\n      req.method === 'POST' ||\n      (req.method === 'GET' && (body['action'] === 'sale' || body['action'] === 'context'))\n    )\n  ) {\n    return res.status(405).json({ error: 'Method not allowed' })\n  }\n  const hostId = String(body['hostId'] ?? '')\n  const gate = await authorizePosStaff(req, hostId)\n  if ('error' in gate) return res.status(gate.status).json({ error: gate.error })\n  let staff = gate.staff\n  const action = String(body['action'] ?? '')\n  const orderId = String(body['orderId'] ?? '')\n  try {\n    if (action === 'gift-card-balance') {\n      return await giftCardBalance(staff, body, res)\n    }\n    if (action === 'context') {\n      // What the register needs to draw its tenders: the site's tip and\n      // receipt settings, whether card readers are offered at all, and the\n      // key the typed-card form loads Stripe with.\n      const readers = posTerminalAvailable()\n        ? (\n            await firebaseAdmin\n              .app()\n              .firestore()\n              .collection('hosts')\n              .doc(hostId)\n              .collection('terminalReaders')\n              .limit(50)\n              .get()\n          ).docs.map((doc: any) => ({\n            id: doc.id as string,\n            label: String(doc.get('label') ?? 'Card reader'),\n            registerId: (doc.get('registerId') as string | undefined) ?? null,\n            status: String(doc.get('status') ?? 'offline'),\n            livemode: Boolean(doc.get('livemode')),\n          }))\n        : []\n      return res.status(200).json({\n        settings: posRegisterSettings(\n          await getPluginConfig(staff.orgId || undefined, 'commerce', { hostId }),\n        ),\n        terminal: { available: posTerminalAvailable(), testMode: posStripeTestMode() },\n        readers,\n        publishableKey: String(process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY ?? ''),\n        // A text receipt is offered only when an SMS provider is on (AGL-3610).\n        smsReceipts: pluginSmsAvailable(),\n      })\n    }\n    if (!orderId) return res.status(400).json({ error: 'Missing orderId' })\n    const startsPayment = [\n      'card-present-sdk',\n      'cash',\n      'gift-card',\n      'folio',\n      'card-present',\n      'card-keyed',\n      'card-link',\n    ].includes(action)\n    const attemptKey = posIdempotencyKey(req)\n    if (startsPayment && !attemptKey) {\n      return res.status(400).json({ error: 'Missing Idempotency-Key' })\n    }\n    const paymentId = startsPayment\n      ? posPaymentId(orderId, attemptKey)\n      : String(body['paymentId'] ?? '')\n    // The cashier a PIN switched in takes the payment (AGL-3609).\n    if (startsPayment && body['cashierAssertion']) {\n      staff = {\n        ...staff,\n        uid: await posPaymentCashierId({\n          hostId,\n          orderId,\n          signedInUid: staff.uid,\n          assertion: body['cashierAssertion'],\n        }),\n      }\n    }\n    const amountCents = Math.round(Number(body['amountCents'] ?? 0))\n    const tipCents = Math.round(Number(body['tipCents'] ?? 0)) || 0\n    const settings = posRegisterSettings(\n      await getPluginConfig(staff.orgId || undefined, 'commerce', { hostId }),\n    )\n    let outcome: (PosPaymentOutcome & { clientSecret?: string; paymentIntentId?: string }) | null = null\n    switch (action) {\n      case 'sale': {\n        const order = await readPosSale(hostId, orderId)\n        if (!order) return res.status(404).json({ error: 'Unknown sale' })\n        outcome = { ok: true, order, payment: null, completed: false, changed: false }\n        break\n      }\n      case 'cash':\n        outcome = await takeCash(staff, orderId, paymentId, body, tipCents)\n        break\n      case 'gift-card':\n        outcome = await takeGiftCard(staff, orderId, paymentId, body)\n        break\n      case 'folio':\n        outcome = await takeFolio(staff, orderId, paymentId, body)\n        break\n      case 'card-present':\n        outcome = await startCardPresentPayment({\n          hostId,\n          orderId,\n          paymentId,\n          amountCents,\n          tipCents,\n          cashierId: staff.uid,\n          org: staff.org,\n          readerId: String(body['readerId'] ?? ''),\n          settings,\n        })\n        break\n      case 'card-present-sdk':\n        // Collected by a native app's Stripe Terminal SDK (Tap to Pay or a\n        // Bluetooth reader, AGL-3618) against this server-made intent; it\n        // settles exactly like a smart-reader payment.\n        outcome = await createCardPresentIntent({\n          hostId,\n          orderId,\n          paymentId,\n          amountCents,\n          tipCents,\n          cashierId: staff.uid,\n          org: staff.org,\n        })\n        break\n      case 'card-keyed':\n        outcome = await startCardKeyedPayment({\n          hostId,\n          orderId,\n          paymentId,\n          amountCents,\n          tipCents,\n          cashierId: staff.uid,\n          org: staff.org,\n        })\n        break\n      case 'card-link':\n        outcome = await startCardLinkPayment({\n          hostId,\n          orderId,\n          paymentId,\n          amountCents,\n          tipCents,\n          cashierId: staff.uid,\n          org: staff.org,\n          returnUrl: await registerReturnUrl(req.headers.host, hostId, staff),\n        })\n        break\n      case 'status':\n        outcome = await refreshPosCardPayment({ hostId, orderId, paymentId })\n        break\n      case 'cancel':\n        outcome = await cancelPosCardPayment({ hostId, orderId, paymentId })\n        break\n      case 'retry':\n        outcome = await retryCardPresentPayment({ hostId, orderId, paymentId, settings })\n        break\n      case 'simulate':\n        outcome = await simulatePosReaderTap({\n          hostId,\n          orderId,\n          paymentId,\n          cardNumber: String(body['cardNumber'] ?? ''),\n        })\n        break\n      case 'void':\n        outcome = await voidPosSale(staff, orderId)\n        break\n      case 'receipt':\n        outcome = await recordReceiptChoice(staff, orderId, body)\n        break\n      default:\n        return res.status(400).json({ error: 'Unknown action' })\n    }\n    if ('error' in outcome) return res.status(outcome.status).json({ error: outcome.error })\n    return res.status(200).json({\n      sale: posSaleSummary(outcome.order),\n      ...(outcome.payment ? { paymentId: outcome.payment.id } : {}),\n      completed: outcome.order.status === 'paid',\n      ...(outcome.clientSecret ? { clientSecret: outcome.clientSecret } : {}),\n      ...(outcome.paymentIntentId ? { paymentIntentId: outcome.paymentIntentId } : {}),\n    })\n  } catch (error) {\n    console.error('[pos-payment]', action, error)\n    return res.status(500).json({ error: 'Payment failed — check the sale before trying again' })\n  }\n}\n\n/** Where a QR payment page sends the customer back to: the register. */\nasync function registerReturnUrl(\n  requestHost: string | string[] | undefined,\n  hostId: string,\n  staff: PosStaff,\n): Promise<string> {\n  const origin = `https://${String(requestHost ?? '')}`\n  const subdomain = (\n    await firebaseAdmin.app().firestore().collection('hostIndex').doc(hostId).get()\n  ).get('subdomain') as string | undefined\n  const orgSlug = staff.org?.['slug'] as string | undefined\n  return orgSlug && subdomain\n    ? `${origin}${buildRoute(Route.HOST_PLUGIN, { orgSlug, host: subdomain, pluginSlug: 'pos' })}`\n    : origin\n}\n\n/** The balance a new tender may take, or a refusal. */\nfunction tenderable(\n  order: PosLiftedOrder,\n  payments: CommerceModel.OrderPayment[],\n): number {\n  return CommerceModel.posTenderableCents(Number(order.totals?.totalCents ?? 0), payments)\n}\n\nconst NOT_OPEN = { kind: 'refuse' as const, status: 409, error: 'This sale is no longer open' }\n\n/**\n * Cash: the amount defaults to whatever is left, the change is what the\n * customer handed over beyond it (and beyond any tip they chose).\n */\nasync function takeCash(\n  staff: PosStaff,\n  orderId: string,\n  paymentId: string,\n  body: Record<string, any>,\n  tipCents: number,\n): Promise<PosPaymentOutcome> {\n  const tenderedCents = Math.round(Number(body['tenderedCents'] ?? 0))\n  const askedCents = Math.round(Number(body['amountCents'] ?? 0))\n  return await applyPosPayment({\n    hostId: staff.hostId,\n    orderId,\n    paymentId,\n    decide: ({ order, payments, existing }) => {\n      if (existing) return { kind: 'keep' }\n      if (order.status !== 'pending') return NOT_OPEN\n      if (!Number.isFinite(tenderedCents) || tenderedCents <= 0) {\n        return { kind: 'refuse', status: 400, error: 'Enter the cash received.' }\n      }\n      const open = tenderable(order, payments)\n      if (open <= 0) return { kind: 'refuse', status: 409, error: 'Nothing is left to pay on this sale.' }\n      const amountCents =\n        askedCents > 0 ? Math.min(askedCents, open) : Math.min(open, Math.max(0, tenderedCents - tipCents))\n      if (!(amountCents > 0)) {\n        return { kind: 'refuse', status: 400, error: 'The cash received does not cover the tip.' }\n      }\n      const tipProblem = CommerceModel.posTipProblem(tipCents, amountCents)\n      if (tipProblem) return { kind: 'refuse', status: 400, error: tipProblem }\n      if (tenderedCents < amountCents + tipCents) {\n        return { kind: 'refuse', status: 400, error: 'Cash received is short' }\n      }\n      const total = Number(order.totals?.totalCents ?? 0)\n      const now = Date.now()\n      return {\n        kind: 'put',\n        payment: {\n          id: paymentId,\n          method: 'cash',\n          amountCents,\n          ...(tipCents > 0 ? { tipCents } : {}),\n          status: 'succeeded',\n          atMs: now,\n          settledAtMs: now,\n          cashTenderedCents: tenderedCents,\n          changeCents: tenderedCents - amountCents - tipCents,\n          takeFeeCents: CommerceModel.posTakeShareCents({\n            takeFeeCents: Number(order.posTakeFeeCents ?? 0),\n            totalCents: total,\n            amountCents,\n          }),\n          feeCents: 0,\n          cashierId: staff.uid,\n        },\n      }\n    },\n  })\n}\n\nfunction giftCardRef(hostId: string, code: string) {\n  return firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection('giftCards')\n    .doc(code)\n}\n\n/** A gift card's spendable balance, for the cashier to read to the customer. */\nasync function giftCardBalance(\n  staff: PosStaff,\n  body: Record<string, any>,\n  res: Parameters<PluginApiHandler>[1],\n): Promise<void> {\n  const code = CommerceModel.giftCardCodeOf(body['code'])\n  const rate = await consumeRateLimit(`pos-gift-balance:${staff.uid}`, {\n    limit: 30,\n    windowMs: 60_000,\n  })\n  if (!rate.allowed) {\n    return res.status(429).json({ error: 'Too many balance checks. Wait a minute and try again.' })\n  }\n  if (CommerceModel.giftCardCodeProblem(code)) {\n    return res.status(404).json({ error: 'No gift card has that code.' })\n  }\n  const snapshot = await giftCardRef(staff.hostId, code).get()\n  if (!snapshot.exists) return res.status(404).json({ error: 'No gift card has that code.' })\n  const card = snapshot.data() as CommerceModel.HostGiftCard\n  return res.status(200).json({\n    availableCents: CommerceModel.giftCardAvailableCents(card, Date.now()),\n    frozen: CommerceModel.isGiftCardFrozen(card),\n    voided: Number(card.voidedAtMs) > 0,\n    last4: code.slice(-4),\n  })\n}\n\n/**\n * A gift card: takes the smaller of what the card can give and what is left\n * to pay, in ONE transaction with the sale. The card's spendable balance\n * honours every live hold an online checkout placed on it (AGL-2449), and a\n * frozen card gives nothing (AGL-3363), so the till and the website can\n * never spend the same dollars.\n */\nasync function takeGiftCard(\n  staff: PosStaff,\n  orderId: string,\n  paymentId: string,\n  body: Record<string, any>,\n): Promise<PosPaymentOutcome> {\n  const code = CommerceModel.giftCardCodeOf(body['code'])\n  if (CommerceModel.giftCardCodeProblem(code)) {\n    return { ok: false, status: 404, error: 'No gift card has that code.' }\n  }\n  const askedCents = Math.round(Number(body['amountCents'] ?? 0))\n  const cardRef = giftCardRef(staff.hostId, code)\n  return await applyPosPayment({\n    hostId: staff.hostId,\n    orderId,\n    paymentId,\n    prepare: async (transaction) => {\n      const snapshot = await transaction.get(cardRef)\n      return snapshot.exists ? (snapshot.data() as CommerceModel.HostGiftCard) : null\n    },\n    decide: ({ order, payments, existing, context: card }) => {\n      if (existing) return { kind: 'keep' }\n      if (order.status !== 'pending') return NOT_OPEN\n      if (!card) return { kind: 'refuse', status: 404, error: 'No gift card has that code.' }\n      const available = CommerceModel.giftCardAvailableCents(card, Date.now())\n      if (available <= 0) {\n        return {\n          kind: 'refuse',\n          status: 409,\n          error: CommerceModel.isGiftCardFrozen(card)\n            ? 'This gift card is on hold and cannot be used right now.'\n            : 'This gift card has no balance left.',\n        }\n      }\n      const open = tenderable(order, payments)\n      const amountCents = Math.min(available, open, askedCents > 0 ? askedCents : open)\n      if (!(amountCents > 0)) {\n        return { kind: 'refuse', status: 409, error: 'Nothing is left to pay on this sale.' }\n      }\n      const now = Date.now()\n      return {\n        kind: 'put',\n        payment: {\n          id: paymentId,\n          method: 'gift_card',\n          amountCents,\n          status: 'succeeded',\n          atMs: now,\n          settledAtMs: now,\n          giftCardId: code,\n          last4: code.slice(-4),\n          takeFeeCents: CommerceModel.posTakeShareCents({\n            takeFeeCents: Number(order.posTakeFeeCents ?? 0),\n            totalCents: Number(order.totals?.totalCents ?? 0),\n            amountCents,\n          }),\n          feeCents: 0,\n          cashierId: staff.uid,\n        },\n      }\n    },\n    write: (transaction, card, payment) => {\n      transaction.set(\n        cardRef,\n        {\n          balanceCents: Math.max(0, Number(card?.balanceCents ?? 0) - payment.amountCents),\n          lastUsedAtMs: Date.now(),\n        },\n        { merge: true },\n      )\n    },\n  })\n}\n\nfunction reservationRef(hostId: string, reservationId: string) {\n  return firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection('reservations')\n    .doc(reservationId)\n}\n\n/** Charged to a checked-in stay's folio, in the same commit as the payment. */\nasync function takeFolio(\n  staff: PosStaff,\n  orderId: string,\n  paymentId: string,\n  body: Record<string, any>,\n): Promise<PosPaymentOutcome> {\n  const reservationId = String(body['reservationId'] ?? '')\n  if (!/^[A-Za-z0-9_-]{1,128}$/.test(reservationId)) {\n    return { ok: false, status: 400, error: 'Pick a reservation' }\n  }\n  const askedCents = Math.round(Number(body['amountCents'] ?? 0))\n  const stayRef = reservationRef(staff.hostId, reservationId)\n  return await applyPosPayment({\n    hostId: staff.hostId,\n    orderId,\n    paymentId,\n    prepare: async (transaction) => (await transaction.get(stayRef)).exists as boolean,\n    decide: ({ order, payments, existing, context: stayExists }) => {\n      if (existing) return { kind: 'keep' }\n      if (order.status !== 'pending') return NOT_OPEN\n      if (!stayExists) return { kind: 'refuse', status: 404, error: 'Unknown reservation' }\n      const open = tenderable(order, payments)\n      const amountCents = Math.min(open, askedCents > 0 ? askedCents : open)\n      if (!(amountCents > 0)) {\n        return { kind: 'refuse', status: 409, error: 'Nothing is left to pay on this sale.' }\n      }\n      const now = Date.now()\n      return {\n        kind: 'put',\n        payment: {\n          id: paymentId,\n          method: 'folio',\n          amountCents,\n          status: 'succeeded',\n          atMs: now,\n          settledAtMs: now,\n          reservationId,\n          folioAtMs: now,\n          takeFeeCents: CommerceModel.posTakeShareCents({\n            takeFeeCents: Number(order.posTakeFeeCents ?? 0),\n            totalCents: Number(order.totals?.totalCents ?? 0),\n            amountCents,\n          }),\n          feeCents: 0,\n          cashierId: staff.uid,\n        },\n        event: { event: 'folio', detail: `Charged to reservation ${reservationId}` },\n      }\n    },\n    write: (transaction, _stay, payment) => {\n      // `update`, never a merge-set: a missing stay must not be minted as a\n      // stub holding one folio line (AGL-1760). It exists — read above.\n      transaction.update(stayRef, {\n        folio: firebaseAdmin.firestore.FieldValue.arrayUnion({\n          orderId,\n          paymentId: payment.id,\n          amountCents: payment.amountCents,\n          note: 'Register sale',\n          atMs: payment.folioAtMs ?? Date.now(),\n        }),\n      })\n    },\n  })\n}\n\n/**\n * Abandons an open sale: everything it took is handed back first — cards\n * refunded in full (tip included, fee and transfer reversed), gift cards\n * re-credited, the room charge taken off the folio, cash marked as returned —\n * and only then is the order cancelled. A refund Stripe refuses stops the void\n * with the sale still open and its payment still recorded, never cancelled\n * over money that did not come back.\n */\nexport async function voidPosSale(\n  staff: PosStaff,\n  orderId: string,\n): Promise<PosPaymentOutcome> {\n  const hostId = staff.hostId\n  const order = await readPosSale(hostId, orderId)\n  if (!order) return { ok: false, status: 404, error: 'Unknown sale' }\n  if (order.status === 'cancelled') return { ok: true, order, payment: null, completed: false, changed: false }\n  if (order.status !== 'pending' || !Array.isArray(order.payments)) {\n    return {\n      ok: false,\n      status: 409,\n      error: 'This sale is already paid. Refund it from the order instead.',\n    }\n  }\n  for (const payment of CommerceModel.orderPayments(order)) {\n    if (payment.status === 'pending' && CommerceModel.isCardPaymentMethod(payment.method)) {\n      const cancelled = await cancelPosCardPayment({ hostId, orderId, paymentId: payment.id })\n      if (!cancelled.ok) return cancelled\n    }\n  }\n  // Re-read after the cancels: one may have completed the sale in the gap.\n  const current = await readPosSale(hostId, orderId)\n  if (!current) return { ok: false, status: 404, error: 'Unknown sale' }\n  if (current.status !== 'pending') {\n    return {\n      ok: false,\n      status: 409,\n      error: 'The last card payment went through and the sale is paid. Refund it from the order instead.',\n    }\n  }\n  for (const payment of CommerceModel.orderPayments(current)) {\n    if (payment.status !== 'succeeded') continue\n    const reversed = await reversePayment(staff, current, payment)\n    if (!reversed.ok) return reversed\n  }\n  const firestore = firebaseAdmin.app().firestore()\n  const orderRef = firestore.collection('hosts').doc(hostId).collection('orders').doc(orderId)\n  const cancelled = await firestore.runTransaction(async (transaction: any) => {\n    const fresh = {\n      ...(CommerceModel.liftLegacyOrder(((await transaction.get(orderRef)).data() ?? {}) as any) as any),\n      $id: orderId,\n    } as PosLiftedOrder\n    if (fresh.status !== 'pending') return null\n    const open = CommerceModel.orderPayments(fresh).some(\n      (payment) => payment.status === 'pending' || payment.status === 'succeeded',\n    )\n    if (open) return null\n    const next = {\n      ...fresh,\n      status: 'cancelled' as const,\n      timeline: CommerceModel.appendOrderEvent(fresh, 'pos-sale-voided', 'Voided at the register'),\n    }\n    transaction.set(\n      orderRef,\n      {\n        status: 'cancelled',\n        cancelledAtMs: Date.now(),\n        timeline: next.timeline,\n        ...CommerceModel.orderListFields(next, orderId),\n      },\n      { merge: true },\n    )\n    return next\n  })\n  if (!cancelled) {\n    return { ok: false, status: 409, error: 'A payment on this sale changed. Check it and try again.' }\n  }\n  await releasePosSaleDiscount(hostId, current)\n  return { ok: true, order: cancelled, payment: null, completed: false, changed: true }\n}\n\n/** Hands one settled payment back, recording `reversed` in the same commit. */\nasync function reversePayment(\n  staff: PosStaff,\n  order: PosLiftedOrder,\n  payment: CommerceModel.OrderPayment,\n): Promise<PosPaymentOutcome> {\n  const hostId = staff.hostId\n  if (CommerceModel.isCardPaymentMethod(payment.method)) {\n    if (!payment.paymentIntentId) {\n      return { ok: false, status: 409, error: 'A card payment on this sale has no charge to refund.' }\n    }\n    const refund = await posStripe('POST', 'refunds', {\n      idempotencyKey: `pos-void:${payment.id}`,\n      params: {\n        payment_intent: payment.paymentIntentId,\n        reverse_transfer: true,\n        refund_application_fee: true,\n        'metadata[kind]': 'pos-void',\n        'metadata[orderId]': order.$id,\n      },\n    })\n    if (!refund.ok) {\n      return {\n        ok: false,\n        status: 502,\n        error: posStripeErrorMessage(refund.body, 'The card refund failed. The sale is still open.'),\n      }\n    }\n  }\n  const cardRef = payment.giftCardId ? giftCardRef(hostId, payment.giftCardId) : null\n  const stayRef = payment.reservationId ? reservationRef(hostId, payment.reservationId) : null\n  return await applyPosPayment({\n    hostId,\n    orderId: order.$id,\n    paymentId: payment.id,\n    prepare: async (transaction) => {\n      if (payment.method === 'gift_card' && cardRef) {\n        const snapshot = await transaction.get(cardRef)\n        return { card: snapshot.exists ? (snapshot.data() as CommerceModel.HostGiftCard) : null, folio: null }\n      }\n      if (payment.method === 'folio' && stayRef) {\n        const snapshot = await transaction.get(stayRef)\n        return { card: null, folio: snapshot.exists ? ((snapshot.get('folio') ?? []) as any[]) : null }\n      }\n      return { card: null, folio: null }\n    },\n    decide: ({ existing }) => {\n      if (!existing) return { kind: 'refuse', status: 404, error: 'Unknown payment' }\n      if (existing.status !== 'succeeded') return { kind: 'keep' }\n      return {\n        kind: 'put',\n        payment: { ...existing, status: 'reversed' },\n        event: {\n          event: 'pos-payment-reversed',\n          detail:\n            existing.method === 'cash'\n              ? `${CommerceModel.describeOrderPayment(existing)} handed back in cash`\n              : `${CommerceModel.describeOrderPayment(existing)} returned`,\n        },\n      }\n    },\n    write: (transaction, context, reversed) => {\n      if (reversed.method === 'gift_card' && cardRef && context.card) {\n        transaction.set(\n          cardRef,\n          { balanceCents: Number(context.card.balanceCents ?? 0) + reversed.amountCents },\n          { merge: true },\n        )\n      }\n      if (reversed.method === 'folio' && stayRef && context.folio) {\n        transaction.update(stayRef, {\n          folio: context.folio.filter((entry) => entry?.paymentId !== reversed.id),\n        })\n      }\n    },\n  })\n}\n\n/** A repeat of the same receipt choice inside this window sends nothing more. */\nconst RECEIPT_REPEAT_WINDOW_MS = 2 * 60 * 1000\n\n/**\n * How the customer wants their receipt, from the cashier or the customer\n * display. Kept on the order; an email chosen after the sale is paid is sent\n * at once, and one chosen before is sent when it completes.\n */\nasync function recordReceiptChoice(\n  staff: PosStaff,\n  orderId: string,\n  body: Record<string, any>,\n): Promise<PosPaymentOutcome> {\n  const channel = String(body['channel'] ?? '') as CommerceModel.PosReceiptChannel\n  if (!['email', 'sms', 'print', 'none'].includes(channel)) {\n    return { ok: false, status: 400, error: 'Choose email, text, print or no receipt.' }\n  }\n  const to =\n    channel === 'email'\n      ? CommerceModel.posDisplayEmail(body['to'])\n      : channel === 'sms'\n        ? CommerceModel.posDisplayPhone(body['to'])\n        : ''\n  if ((channel === 'email' || channel === 'sms') && !to) {\n    return {\n      ok: false,\n      status: 400,\n      error: channel === 'email' ? 'Enter a valid email address.' : 'Enter a valid phone number.',\n    }\n  }\n  if (channel === 'sms' && !pluginSmsAvailable()) {\n    return { ok: false, status: 409, error: 'Text receipts are not set up for this store.' }\n  }\n  const marketingOptIn = channel === 'email' && body['marketingOptIn'] === true\n  const firestore = firebaseAdmin.app().firestore()\n  const orderRef = firestore.collection('hosts').doc(staff.hostId).collection('orders').doc(orderId)\n  const order = await firestore.runTransaction(async (transaction: any) => {\n    const snapshot = await transaction.get(orderRef)\n    if (!snapshot.exists) return null\n    const fresh = {\n      ...(CommerceModel.liftLegacyOrder((snapshot.data() ?? {}) as any) as any),\n      $id: orderId,\n    } as PosLiftedOrder\n    if (fresh.channel !== 'pos') return null\n    // The same choice twice in a row (a double tap, or the display and the\n    // cashier answering together) is one receipt, not two.\n    const previous = fresh.receiptRequest\n    if (\n      fresh.status === 'paid' &&\n      previous &&\n      previous.channel === channel &&\n      String(previous.to ?? '') === to &&\n      Date.now() - Number(previous.atMs ?? 0) < RECEIPT_REPEAT_WINDOW_MS\n    ) {\n      return { ...fresh, repeated: true } as PosLiftedOrder & { repeated?: boolean }\n    }\n    const receiptRequest = {\n      channel,\n      ...(to ? { to } : {}),\n      ...(marketingOptIn ? { marketingOptIn: true } : {}),\n      atMs: Date.now(),\n    }\n    transaction.set(\n      orderRef,\n      {\n        receiptRequest,\n        ...(channel === 'email' && !fresh.customerEmail\n          ? {\n              customerEmail: to,\n              ...CommerceModel.orderListFields({ ...fresh, customerEmail: to }, orderId),\n            }\n          : {}),\n        // The receipt door texts `customerPhone` (AGL-3610).\n        ...(channel === 'sms' ? { customerPhone: to } : {}),\n      },\n      { merge: true },\n    )\n    return { ...fresh, receiptRequest } as PosLiftedOrder & { repeated?: boolean }\n  })\n  if (!order) return { ok: false, status: 404, error: 'Unknown sale' }\n  if (order.repeated) return { ok: true, order, payment: null, completed: false, changed: false }\n  if (order.status === 'paid' && channel === 'print') {\n    // Chosen after the sale completed: printed now on the register's receipt\n    // printer, under the sale's own key so it never prints twice (AGL-3609).\n    await printPosSaleReceipt(staff.hostId, orderId)\n  }\n  if (order.status === 'paid' && order.registerId) {\n    // The customer has answered (or the cashier for them): the display says\n    // thank you and drops the address they typed (AGL-3608).\n    await finishPosDisplayReceipt(staff.hostId, order.registerId).catch((error: unknown) =>\n      console.error('[pos-payment] display finish failed', error),\n    )\n  }\n  if (order.status === 'paid' && (channel === 'email' || channel === 'sms')) {\n    // Chosen after the sale completed: sent now, to where they said.\n    const sent = await deliverChosenPosReceipt(\n      { hostId: staff.hostId, orderId },\n      { channel, to, orderEmail: String(order.customerEmail ?? '') },\n    )\n    if (channel === 'email') {\n      await recordCapturedContact({\n        orgId: '',\n        hostId: staff.hostId,\n        identity: { email: to },\n        surface: 'relationship',\n        lifecycleFloor: 'customer',\n        ...(marketingOptIn ? { marketingConsent: true } : {}),\n        interaction: {\n          source: 'order',\n          refId: orderId,\n          summary: `In-store purchase (${CommerceModel.formatReceiptMoney(\n            Number(order.totals?.totalCents ?? 0),\n            POS_CURRENCY,\n          )})`,\n        },\n      }).catch((error: unknown) => console.error('[pos-payment] contact capture failed', error))\n    }\n    if (sent !== 'sent') {\n      // A failed send is not a repeat: the cashier's retry goes out.\n      await orderRef\n        .set({ receiptRequest: { atMs: 0 } }, { merge: true })\n        .catch((error: unknown) => console.error('[pos-payment] receipt retry reset failed', error))\n    }\n    if (sent === 'not_configured') {\n      return {\n        ok: false,\n        status: 409,\n        error: channel === 'sms' ? 'Text receipts are not set up for this store.' : 'Email is not set up.',\n      }\n    }\n    if (sent !== 'sent') return { ok: false, status: 502, error: 'The receipt could not be sent.' }\n  }\n  return { ok: true, order, payment: null, completed: false, changed: true }\n}\n"],"names":["consumeRateLimit","firebaseAdmin","getPluginConfig","buildRoute","Route","recordCapturedContact","pluginSmsAvailable","finishPosDisplayReceipt","CommerceModel","posRegisterSettings","authorizePosStaff","posIdempotencyKey","posQueryBody","posRequestBody","applyPosPayment","deliverChosenPosReceipt","posPaymentId","posSaleSummary","readPosSale","releasePosSaleDiscount","posPaymentCashierId","printPosSaleReceipt","POS_CURRENCY","posStripe","posStripeErrorMessage","posStripeTestMode","posTerminalAvailable","cancelPosCardPayment","createCardPresentIntent","refreshPosCardPayment","retryCardPresentPayment","simulatePosReaderTap","startCardKeyedPayment","startCardLinkPayment","startCardPresentPayment","posPaymentHandler","req","res","body","method","status","json","error","hostId","String","gate","staff","action","orderId","giftCardBalance","process","readers","app","firestore","collection","doc","limit","get","docs","map","id","label","registerId","livemode","Boolean","settings","orgId","undefined","terminal","available","testMode","publishableKey","env","NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY","smsReceipts","startsPayment","includes","attemptKey","paymentId","uid","signedInUid","assertion","amountCents","Math","round","Number","tipCents","outcome","order","ok","payment","completed","changed","takeCash","takeGiftCard","takeFolio","cashierId","org","readerId","returnUrl","registerReturnUrl","headers","host","cardNumber","voidPosSale","recordReceiptChoice","sale","clientSecret","paymentIntentId","console","requestHost","origin","subdomain","orgSlug","HOST_PLUGIN","pluginSlug","tenderable","payments","posTenderableCents","totals","totalCents","NOT_OPEN","kind","tenderedCents","askedCents","decide","existing","isFinite","open","min","max","tipProblem","posTipProblem","total","now","Date","atMs","settledAtMs","cashTenderedCents","changeCents","takeFeeCents","posTakeShareCents","posTakeFeeCents","feeCents","giftCardRef","code","giftCardCodeOf","rate","windowMs","allowed","giftCardCodeProblem","snapshot","exists","card","data","availableCents","giftCardAvailableCents","frozen","isGiftCardFrozen","voided","voidedAtMs","last4","slice","cardRef","prepare","transaction","context","giftCardId","write","set","balanceCents","lastUsedAtMs","merge","reservationRef","reservationId","test","stayRef","stayExists","folioAtMs","event","detail","_stay","update","folio","FieldValue","arrayUnion","note","Array","isArray","orderPayments","isCardPaymentMethod","cancelled","current","reversed","reversePayment","orderRef","runTransaction","fresh","liftLegacyOrder","$id","some","next","timeline","appendOrderEvent","cancelledAtMs","orderListFields","refund","idempotencyKey","params","payment_intent","reverse_transfer","refund_application_fee","describeOrderPayment","filter","entry","RECEIPT_REPEAT_WINDOW_MS","channel","to","posDisplayEmail","posDisplayPhone","marketingOptIn","previous","receiptRequest","repeated","customerEmail","customerPhone","catch","sent","orderEmail","identity","email","surface","lifecycleFloor","marketingConsent","interaction","source","refId","summary","formatReceiptMoney"],"mappings":"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"}

package/src/lib/server/pos-print.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { HostOrder } from '../model/commerce-orders';
+import type { PosCashEventType } from '../model/commerce-pos-ops';
+import type { PrintReport } from '../model/commerce-printers';
+import { type PosRegisterSettings } from '../plugin-config';
+import { type PosSaleCompletedEvent } from './pos-sale';
+import { orderReceipt, queueRegisterPrint } from './printers';
+export interface PosPrintDeps {
+    firestore(): any;
+    queue: typeof queueRegisterPrint;
+    receipt: typeof orderReceipt;
+    /** The site's register settings (tips, receipts, display). */
+    registerSettings(hostId: string): Promise<PosRegisterSettings>;
+    /** A member's name as the receipt prints it. */
+    memberName(uid: string): Promise<string>;
+}
+export declare function defaultPosPrintDeps(): PosPrintDeps;
+/**
+ * What a completed sale puts on paper: the receipt when the site always
+ * prints or the customer asked for print, never when they chose email, a
+ * text or nothing — and the drawer whenever cash changed hands.
+ */
+export declare function posSalePrintPlan(order: Pick<HostOrder, 'payments' | 'status' | 'channel'> & {
+    receiptRequest?: {
+        channel?: string;
+    } | null;
+}, receiptDefault: PosRegisterSettings['receiptDefault']): {
+    receipt: boolean;
+    drawer: boolean;
+};
+/** A completed register sale's receipt and drawer, by {@link posSalePrintPlan}. */
+export declare function printPosSale(event: Pick<PosSaleCompletedEvent, 'hostId' | 'orderId'>, deps?: PosPrintDeps): Promise<{
+    jobIds: string[];
+}>;
+/**
+ * The receipt a customer asked for on the display AFTER the sale completed.
+ * Under the sale's own key, so a receipt the completion already printed is
+ * not printed twice.
+ */
+export declare function printPosSaleReceipt(hostId: string, orderId: string, deps?: PosPrintDeps): Promise<{
+    jobIds: string[];
+}>;
+/** Opens the drawer for cash that moved without a sale. */
+export declare function kickPosDrawer(input: {
+    hostId: string;
+    registerId: string;
+    reason: PosCashEventType | 'cash_refund';
+    /** The event or return id: a retried tap kicks once. */
+    causeId: string;
+    createdBy?: string;
+}, deps?: PosPrintDeps): Promise<{
+    jobIds: string[];
+}>;
+/** Queues a shift report on the register's receipt printer; no printer, no jobs. */
+export declare function printPosShiftReport(input: {
+    hostId: string;
+    registerId: string;
+    shiftId: string;
+    report: PrintReport;
+    createdBy?: string;
+    /** Distinguishes a second deliberate print of the same report. */
+    attemptKey: string;
+}, deps?: PosPrintDeps): Promise<{
+    jobIds: string[];
+}>;
+/** Prints every completed register sale; safe to call more than once. */
+export declare function registerPosSalePrinting(): void;

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

@@ -0,0 +1,193 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { firebaseAdmin, getOrgForHost, getPluginConfig } from "@aglyn/tenant-data-admin";
+import { findUserByUidAcrossPools } from "@aglyn/tenant-data-admin/server/auth-pools";
+import { orderPayments } from "../model/commerce-pos.js";
+import { posRegisterSettings } from "../plugin-config.js";
+import { onPosSaleCompleted } from "./pos-sale.js";
+import { orderReceipt, queueRegisterPrint } from "./printers.js";
+export function defaultPosPrintDeps() {
+    return {
+        firestore: ()=>firebaseAdmin.app().firestore(),
+        queue: queueRegisterPrint,
+        receipt: orderReceipt,
+        registerSettings: async (hostId)=>{
+            const owner = await getOrgForHost(hostId).catch(()=>null);
+            return posRegisterSettings((owner == null ? void 0 : owner.orgId) ? await getPluginConfig(owner.orgId, 'commerce', {
+                hostId
+            }).catch(()=>({})) : {});
+        },
+        memberName: async (uid)=>{
+            // Every pool: a member who signs in through SSO lives in a GCIP tenant
+            // pool, not the project one (AGL-1122).
+            try {
+                var _this;
+                const user = (_this = await findUserByUidAcrossPools(uid)) == null ? void 0 : _this.record;
+                return (user == null ? void 0 : user.displayName) || (user == null ? void 0 : user.email) || '';
+            } catch (unused) {
+                return '';
+            }
+        }
+    };
+}
+/** The one key a sale's receipt prints under, whichever path asks first. */ const SALE_RECEIPT_REASON = 'sale';
+/**
+ * What a completed sale puts on paper: the receipt when the site always
+ * prints or the customer asked for print, never when they chose email, a
+ * text or nothing — and the drawer whenever cash changed hands.
+ */ export function posSalePrintPlan(order, receiptDefault) {
+    var _order_receiptRequest;
+    const drawer = orderPayments(order).some((payment)=>payment.status === 'succeeded' && payment.method === 'cash');
+    const choice = (_order_receiptRequest = order.receiptRequest) == null ? void 0 : _order_receiptRequest.channel;
+    const receipt = choice ? choice === 'print' : receiptDefault === 'print';
+    return {
+        receipt,
+        drawer
+    };
+}
+/**
+ * True when the customer chose a printed receipt: it then prints on the
+ * register's first printer even when none is set to print every sale.
+ */ function customerAskedForPrint(order) {
+    var _order_receiptRequest;
+    return ((_order_receiptRequest = order.receiptRequest) == null ? void 0 : _order_receiptRequest.channel) === 'print';
+}
+async function readOrder(deps, hostId, orderId) {
+    const snapshot = await deps.firestore().collection('hosts').doc(hostId).collection('orders').doc(orderId).get();
+    return snapshot.exists ? snapshot.data() : null;
+}
+async function saleReceipt(deps, hostId, orderId, order) {
+    const [receipt, cashierName] = await Promise.all([
+        deps.receipt(hostId, orderId, order, {
+            firestore: deps.firestore()
+        }),
+        order.cashierId ? deps.memberName(order.cashierId) : Promise.resolve('')
+    ]);
+    return cashierName ? _extends({}, receipt, {
+        cashierName
+    }) : receipt;
+}
+/** A completed register sale's receipt and drawer, by {@link posSalePrintPlan}. */ export async function printPosSale(event, deps = defaultPosPrintDeps()) {
+    try {
+        const order = await readOrder(deps, event.hostId, event.orderId);
+        if (!order || order.channel !== 'pos' || !order.registerId) return {
+            jobIds: []
+        };
+        const settings = await deps.registerSettings(event.hostId);
+        const plan = posSalePrintPlan(order, settings.receiptDefault);
+        // The kitchen ticket prints whatever the customer chose for their own
+        // receipt (AGL-3619): it is an order to make, not paper for the customer,
+        // and only printers set to print kitchen tickets receive it.
+        const receipt = await saleReceipt(deps, event.hostId, event.orderId, order);
+        return await deps.queue(_extends({
+            hostId: event.hostId,
+            registerId: order.registerId
+        }, plan.receipt ? {
+            receipt
+        } : {}, customerAskedForPrint(order) ? {
+            receiptChoice: 'print'
+        } : {}, {
+            kitchenTicket: receipt,
+            openDrawer: plan.drawer,
+            orderId: event.orderId,
+            reason: SALE_RECEIPT_REASON,
+            idempotencyKey: event.orderId,
+            firestore: deps.firestore()
+        }));
+    } catch (error) {
+        console.error('[pos-print] sale print failed', event.orderId, error);
+        return {
+            jobIds: []
+        };
+    }
+}
+/**
+ * The receipt a customer asked for on the display AFTER the sale completed.
+ * Under the sale's own key, so a receipt the completion already printed is
+ * not printed twice.
+ */ export async function printPosSaleReceipt(hostId, orderId, deps = defaultPosPrintDeps()) {
+    try {
+        const order = await readOrder(deps, hostId, orderId);
+        if (!order || order.channel !== 'pos' || !order.registerId) return {
+            jobIds: []
+        };
+        return await deps.queue({
+            hostId,
+            registerId: order.registerId,
+            receipt: await saleReceipt(deps, hostId, orderId, order),
+            // Asked for by name, so it prints even when no printer auto-prints.
+            receiptChoice: 'print',
+            orderId,
+            reason: SALE_RECEIPT_REASON,
+            idempotencyKey: orderId,
+            firestore: deps.firestore()
+        });
+    } catch (error) {
+        console.error('[pos-print] receipt print failed', orderId, error);
+        return {
+            jobIds: []
+        };
+    }
+}
+/** Opens the drawer for cash that moved without a sale. */ export async function kickPosDrawer(input, deps = defaultPosPrintDeps()) {
+    try {
+        return await deps.queue(_extends({
+            hostId: input.hostId,
+            registerId: input.registerId,
+            openDrawer: true,
+            reason: input.reason,
+            idempotencyKey: input.causeId
+        }, input.createdBy ? {
+            createdBy: input.createdBy
+        } : {}, {
+            firestore: deps.firestore()
+        }));
+    } catch (error) {
+        console.error('[pos-print] drawer kick failed', input.causeId, error);
+        return {
+            jobIds: []
+        };
+    }
+}
+/** Queues a shift report on the register's receipt printer; no printer, no jobs. */ export async function printPosShiftReport(input, deps = defaultPosPrintDeps()) {
+    try {
+        return await deps.queue(_extends({
+            hostId: input.hostId,
+            registerId: input.registerId,
+            report: input.report,
+            reason: input.report.title === 'Z REPORT' ? 'z_report' : 'x_report',
+            idempotencyKey: `${input.shiftId}-${input.attemptKey}`
+        }, input.createdBy ? {
+            createdBy: input.createdBy
+        } : {}, {
+            firestore: deps.firestore()
+        }));
+    } catch (error) {
+        console.error('[pos-print] report print failed', input.shiftId, error);
+        return {
+            jobIds: []
+        };
+    }
+}
+let subscribed = false;
+/** Prints every completed register sale; safe to call more than once. */ export function registerPosSalePrinting() {
+    if (subscribed) return;
+    subscribed = true;
+    onPosSaleCompleted((event)=>printPosSale(event).then(()=>undefined));
+}
+
+//# sourceMappingURL=pos-print.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-print.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 { firebaseAdmin, getOrgForHost, getPluginConfig } from '@aglyn/tenant-data-admin'\nimport { findUserByUidAcrossPools } from '@aglyn/tenant-data-admin/server/auth-pools'\nimport type { HostOrder } from '../model/commerce-orders'\nimport { orderPayments } from '../model/commerce-pos'\nimport type { PosCashEventType } from '../model/commerce-pos-ops'\nimport type { PrintReport } from '../model/commerce-printers'\nimport { posRegisterSettings, type PosRegisterSettings } from '../plugin-config'\nimport { onPosSaleCompleted, type PosSaleCompletedEvent } from './pos-sale'\nimport { orderReceipt, queueRegisterPrint } from './printers'\n\n/*==========================================\n * THE REGISTER'S PAPER AND DRAWER (AGL-3609), through the cloud printer\n * queue (AGL-3619) rather than a second one:\n *\n *   a completed sale    its receipt, when the site always prints or the\n *                       customer chose print, a kitchen ticket on the\n *                       printers that print them, and a drawer kick when\n *                       cash was taken\n *   a cash event        paid in, paid out, a safe drop or a cash refund\n *                       opens the drawer\n *   an X or Z report    printed on the register's receipt printer\n *\n * Every job is keyed on its cause (the order, the event, the return), so a\n * cause delivered twice prints once. Nothing here can fail the money that\n * caused it: each entry point logs and returns.\n *=========================================*/\n\nexport interface PosPrintDeps {\n  firestore(): any\n  queue: typeof queueRegisterPrint\n  receipt: typeof orderReceipt\n  /** The site's register settings (tips, receipts, display). */\n  registerSettings(hostId: string): Promise<PosRegisterSettings>\n  /** A member's name as the receipt prints it. */\n  memberName(uid: string): Promise<string>\n}\n\nexport function defaultPosPrintDeps(): PosPrintDeps {\n  return {\n    firestore: () => firebaseAdmin.app().firestore(),\n    queue: queueRegisterPrint,\n    receipt: orderReceipt,\n    registerSettings: async (hostId) => {\n      const owner = await getOrgForHost(hostId).catch(() => null)\n      return posRegisterSettings(\n        owner?.orgId ? await getPluginConfig(owner.orgId, 'commerce', { hostId }).catch(() => ({})) : {},\n      )\n    },\n    memberName: async (uid) => {\n      // Every pool: a member who signs in through SSO lives in a GCIP tenant\n      // pool, not the project one (AGL-1122).\n      try {\n        const user = (await findUserByUidAcrossPools(uid))?.record\n        return user?.displayName || user?.email || ''\n      } catch {\n        return ''\n      }\n    },\n  }\n}\n\n/** The one key a sale's receipt prints under, whichever path asks first. */\nconst SALE_RECEIPT_REASON = 'sale'\n\n/**\n * What a completed sale puts on paper: the receipt when the site always\n * prints or the customer asked for print, never when they chose email, a\n * text or nothing — and the drawer whenever cash changed hands.\n */\nexport function posSalePrintPlan(\n  order: Pick<HostOrder, 'payments' | 'status' | 'channel'> & {\n    receiptRequest?: { channel?: string } | null\n  },\n  receiptDefault: PosRegisterSettings['receiptDefault'],\n): { receipt: boolean; drawer: boolean } {\n  const drawer = orderPayments(order as Parameters<typeof orderPayments>[0]).some(\n    (payment) => payment.status === 'succeeded' && payment.method === 'cash',\n  )\n  const choice = order.receiptRequest?.channel\n  const receipt = choice ? choice === 'print' : receiptDefault === 'print'\n  return { receipt, drawer }\n}\n\n/**\n * True when the customer chose a printed receipt: it then prints on the\n * register's first printer even when none is set to print every sale.\n */\nfunction customerAskedForPrint(order: { receiptRequest?: { channel?: string } | null }): boolean {\n  return order.receiptRequest?.channel === 'print'\n}\n\nasync function readOrder(deps: PosPrintDeps, hostId: string, orderId: string) {\n  const snapshot = await deps\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection('orders')\n    .doc(orderId)\n    .get()\n  return snapshot.exists ? (snapshot.data() as HostOrder & Record<string, any>) : null\n}\n\nasync function saleReceipt(\n  deps: PosPrintDeps,\n  hostId: string,\n  orderId: string,\n  order: HostOrder & Record<string, any>,\n) {\n  const [receipt, cashierName] = await Promise.all([\n    deps.receipt(hostId, orderId, order, { firestore: deps.firestore() }),\n    order.cashierId ? deps.memberName(order.cashierId) : Promise.resolve(''),\n  ])\n  return cashierName ? { ...receipt, cashierName } : receipt\n}\n\n/** A completed register sale's receipt and drawer, by {@link posSalePrintPlan}. */\nexport async function printPosSale(\n  event: Pick<PosSaleCompletedEvent, 'hostId' | 'orderId'>,\n  deps: PosPrintDeps = defaultPosPrintDeps(),\n): Promise<{ jobIds: string[] }> {\n  try {\n    const order = await readOrder(deps, event.hostId, event.orderId)\n    if (!order || order.channel !== 'pos' || !order.registerId) return { jobIds: [] }\n    const settings = await deps.registerSettings(event.hostId)\n    const plan = posSalePrintPlan(order, settings.receiptDefault)\n    // The kitchen ticket prints whatever the customer chose for their own\n    // receipt (AGL-3619): it is an order to make, not paper for the customer,\n    // and only printers set to print kitchen tickets receive it.\n    const receipt = await saleReceipt(deps, event.hostId, event.orderId, order)\n    return await deps.queue({\n      hostId: event.hostId,\n      registerId: order.registerId,\n      ...(plan.receipt ? { receipt } : {}),\n      ...(customerAskedForPrint(order) ? { receiptChoice: 'print' as const } : {}),\n      kitchenTicket: receipt,\n      openDrawer: plan.drawer,\n      orderId: event.orderId,\n      reason: SALE_RECEIPT_REASON,\n      idempotencyKey: event.orderId,\n      firestore: deps.firestore(),\n    })\n  } catch (error) {\n    console.error('[pos-print] sale print failed', event.orderId, error)\n    return { jobIds: [] }\n  }\n}\n\n/**\n * The receipt a customer asked for on the display AFTER the sale completed.\n * Under the sale's own key, so a receipt the completion already printed is\n * not printed twice.\n */\nexport async function printPosSaleReceipt(\n  hostId: string,\n  orderId: string,\n  deps: PosPrintDeps = defaultPosPrintDeps(),\n): Promise<{ jobIds: string[] }> {\n  try {\n    const order = await readOrder(deps, hostId, orderId)\n    if (!order || order.channel !== 'pos' || !order.registerId) return { jobIds: [] }\n    return await deps.queue({\n      hostId,\n      registerId: order.registerId,\n      receipt: await saleReceipt(deps, hostId, orderId, order),\n      // Asked for by name, so it prints even when no printer auto-prints.\n      receiptChoice: 'print',\n      orderId,\n      reason: SALE_RECEIPT_REASON,\n      idempotencyKey: orderId,\n      firestore: deps.firestore(),\n    })\n  } catch (error) {\n    console.error('[pos-print] receipt print failed', orderId, error)\n    return { jobIds: [] }\n  }\n}\n\n/** Opens the drawer for cash that moved without a sale. */\nexport async function kickPosDrawer(\n  input: {\n    hostId: string\n    registerId: string\n    reason: PosCashEventType | 'cash_refund'\n    /** The event or return id: a retried tap kicks once. */\n    causeId: string\n    createdBy?: string\n  },\n  deps: PosPrintDeps = defaultPosPrintDeps(),\n): Promise<{ jobIds: string[] }> {\n  try {\n    return await deps.queue({\n      hostId: input.hostId,\n      registerId: input.registerId,\n      openDrawer: true,\n      reason: input.reason,\n      idempotencyKey: input.causeId,\n      ...(input.createdBy ? { createdBy: input.createdBy } : {}),\n      firestore: deps.firestore(),\n    })\n  } catch (error) {\n    console.error('[pos-print] drawer kick failed', input.causeId, error)\n    return { jobIds: [] }\n  }\n}\n\n/** Queues a shift report on the register's receipt printer; no printer, no jobs. */\nexport async function printPosShiftReport(\n  input: {\n    hostId: string\n    registerId: string\n    shiftId: string\n    report: PrintReport\n    createdBy?: string\n    /** Distinguishes a second deliberate print of the same report. */\n    attemptKey: string\n  },\n  deps: PosPrintDeps = defaultPosPrintDeps(),\n): Promise<{ jobIds: string[] }> {\n  try {\n    return await deps.queue({\n      hostId: input.hostId,\n      registerId: input.registerId,\n      report: input.report,\n      reason: input.report.title === 'Z REPORT' ? 'z_report' : 'x_report',\n      idempotencyKey: `${input.shiftId}-${input.attemptKey}`,\n      ...(input.createdBy ? { createdBy: input.createdBy } : {}),\n      firestore: deps.firestore(),\n    })\n  } catch (error) {\n    console.error('[pos-print] report print failed', input.shiftId, error)\n    return { jobIds: [] }\n  }\n}\n\nlet subscribed = false\n\n/** Prints every completed register sale; safe to call more than once. */\nexport function registerPosSalePrinting(): void {\n  if (subscribed) return\n  subscribed = true\n  onPosSaleCompleted((event) => printPosSale(event).then(() => undefined))\n}\n"],"names":["firebaseAdmin","getOrgForHost","getPluginConfig","findUserByUidAcrossPools","orderPayments","posRegisterSettings","onPosSaleCompleted","orderReceipt","queueRegisterPrint","defaultPosPrintDeps","firestore","app","queue","receipt","registerSettings","hostId","owner","catch","orgId","memberName","uid","user","record","displayName","email","SALE_RECEIPT_REASON","posSalePrintPlan","order","receiptDefault","drawer","some","payment","status","method","choice","receiptRequest","channel","customerAskedForPrint","readOrder","deps","orderId","snapshot","collection","doc","get","exists","data","saleReceipt","cashierName","Promise","all","cashierId","resolve","printPosSale","event","registerId","jobIds","settings","plan","receiptChoice","kitchenTicket","openDrawer","reason","idempotencyKey","error","console","printPosSaleReceipt","kickPosDrawer","input","causeId","createdBy","printPosShiftReport","report","title","shiftId","attemptKey","subscribed","registerPosSalePrinting","then","undefined"],"mappings":"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"}

package/src/lib/server/pos-readers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginApiHandler } from '@aglyn/aglyn/server';
+/**
+ * `POST /api/commerce/pos-readers` (AGL-3607): the site's Stripe Terminal
+ * card readers, from the "Card readers" settings card, and the server-side
+ * removal of a register.
+ *
+ * Every action names a reader by id, and every one reads that reader under
+ * the CALLER's site first (`ownedTerminalReader`): a reader id copied from
+ * another store is "not on this site", whatever Stripe would say about it.
+ */
+export declare const posReadersHandler: PluginApiHandler;