@aglyn/plugins-commerce 1.0.0-beta.285 → 1.0.0-beta.288

package/src/lib/model/pos-hardware-in-person.js

@@ -0,0 +1,224 @@
+/**
+ * @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.
+ */ /*==========================================
+ * A REGISTER SALE OF HARDWARE BECOMES A HARDWARE ORDER (AGL-4038).
+ *
+ * The platform's own store sells readers at its register like anything else
+ * it sells: its prices, its promotions, its tax rate, its tenders, its
+ * account. What follows the sale is a hardware order for the buyer's
+ * workspace, built here from the register sale as it was paid — pure, so the
+ * money is specced without Firestore.
+ *
+ * THE HARDWARE'S SHARE OF THE SALE. A sale may hold a reader and a T-shirt.
+ * The order takes the hardware lines at the prices they were rung at, and
+ * the sale's discount and tax fall on them in proportion — the discount by
+ * the lines' share of the items, the tax by their share of what was taxed
+ * (the register taxes the whole basket, less its discount, at one rate).
+ * Each share is rounded half up to the cent in integer math, and a sale of
+ * hardware alone takes the whole discount and the whole tax, to the cent.
+ *
+ * WHO IT BELONGS TO. A sale a register user attached to an account and a
+ * workspace is that workspace's order. Every other one — a kiosk sale, an
+ * offline sale, a buyer with no account yet or no workspace yet — is
+ * PENDING: kept in the selling workspace's own orders, on its "To attach"
+ * list, until it is attached.
+ *=========================================*/ import { POS_HARDWARE_CURRENCY, POS_HARDWARE_IN_PERSON_SHIPPING_LABEL, posHardwareBuyerAddress, posHardwareSku } from "./pos-hardware.js";
+import { posHardwareTermsAcceptance, posHardwareTermsAcceptanceOf } from "./pos-hardware-terms.js";
+const whole = (value)=>{
+    const number = Number(value);
+    return Number.isSafeInteger(number) && number > 0 ? number : 0;
+};
+/** `amount × part / of`, rounded half up, in integer math; 0 when `of` is 0. */ function shareOf(amount, part, of) {
+    if (of <= 0 || amount <= 0 || part <= 0) return 0;
+    if (part >= of) return amount;
+    return Math.floor((amount * part * 2 + of) / (of * 2));
+}
+/**
+ * The hardware's share of a register sale, or `null` when the sale sold no
+ * hardware. `discountCents` and `taxCents` are the SALE's.
+ */ export function posHardwareRegisterShare(input) {
+    const lines = [];
+    let saleItemsCents = 0;
+    for (const line of input.lines){
+        const quantity = whole(line.quantity);
+        const unitCents = whole(line.unitAmountCents);
+        saleItemsCents += quantity * unitCents;
+        const sku = line.sku ? posHardwareSku(line.sku) : null;
+        if (!sku || !quantity) continue;
+        lines.push({
+            sku: sku.id,
+            name: sku.displayName,
+            quantity,
+            unitCents,
+            lineCents: quantity * unitCents
+        });
+    }
+    if (!lines.length) return null;
+    const itemsCents = lines.reduce((sum, line)=>sum + line.lineCents, 0);
+    const saleDiscountCents = Math.min(whole(input.discountCents), saleItemsCents);
+    const discountCents = shareOf(saleDiscountCents, itemsCents, saleItemsCents);
+    const taxableCents = Math.max(0, itemsCents - discountCents);
+    const taxCents = shareOf(whole(input.taxCents), taxableCents, saleItemsCents - saleDiscountCents);
+    return {
+        lines,
+        itemsCents,
+        discountCents,
+        taxableCents,
+        taxCents,
+        totalCents: taxableCents + taxCents
+    };
+}
+/**
+ * One unit per reader sold, in line order; accessories carry no serial and
+ * have no unit. `serials` are the serial numbers taken at the sale, in the
+ * same order, already normalized; a reader with none waits for one.
+ */ export function posHardwareUnits(lines, serials = []) {
+    const units = [];
+    for (const line of lines){
+        var _posHardwareSku;
+        if (((_posHardwareSku = posHardwareSku(line.sku)) == null ? void 0 : _posHardwareSku.kind) !== 'reader') continue;
+        for(let index = 0; index < line.quantity; index += 1){
+            units.push({
+                sku: line.sku,
+                serialNumber: serials[units.length] || null,
+                readerId: null,
+                hostId: null,
+                registeredAtMs: null
+            });
+        }
+    }
+    return units;
+}
+/**
+ * Whose the order is: the workspace the register attached, or pending. A
+ * buyer with an account and a workspace is attached; one with only an
+ * account or only an address is pending until they have a workspace.
+ */ export function posHardwareAttachmentOf(buyer) {
+    var _ref, _ref1;
+    var _text, _text1;
+    const text = (value)=>typeof value === 'string' && value.trim() ? value.trim() : null;
+    const uid = text(buyer == null ? void 0 : buyer.uid);
+    const orgId = text(buyer == null ? void 0 : buyer.orgId);
+    const attached = Boolean(uid && orgId);
+    return {
+        state: attached ? 'attached' : 'pending',
+        email: (_ref = (_text = text(buyer == null ? void 0 : buyer.email)) == null ? void 0 : _text.toLowerCase()) != null ? _ref : null,
+        uid,
+        orgId: attached ? orgId : null,
+        hostId: attached ? text(buyer == null ? void 0 : buyer.hostId) : null,
+        attachedBy: text(buyer == null ? void 0 : buyer.attachedBy),
+        attachedAtMs: attached && Number.isFinite(buyer == null ? void 0 : buyer.attachedAtMs) ? Number(buyer == null ? void 0 : buyer.attachedAtMs) : null,
+        // The reseller's records of who bought it (AGL-4038), when known.
+        name: (_ref1 = (_text1 = text(buyer == null ? void 0 : buyer.name)) == null ? void 0 : _text1.slice(0, 200)) != null ? _ref1 : null,
+        address: posHardwareBuyerAddress(buyer == null ? void 0 : buyer.address)
+    };
+}
+/**
+ * The hardware order a register sale becomes. In-person hardware is handed
+ * over at the sale, so the order starts at Delivered, and moves to Set up
+ * once its readers are registered.
+ *
+ * The tax line states the base the store's rate was applied to — the
+ * hardware's share of what the register taxed — so the platform's return
+ * reads a stated base, never an inferred one.
+ */ export function inPersonPosHardwareOrder(sale) {
+    var _sale_serials, _ref, _attachment_hostId, _attachment_email, _sale_currency, _posHardwareTermsAcceptanceOf;
+    var _sale_taxRegion;
+    const attachment = posHardwareAttachmentOf(sale.buyer);
+    const attached = attachment.state === 'attached';
+    const units = posHardwareUnits(sale.share.lines, (_sale_serials = sale.serials) != null ? _sale_serials : []);
+    const state = (_ref = (_sale_taxRegion = sale.taxRegion) == null ? void 0 : _sale_taxRegion.state) != null ? _ref : null;
+    const taxLines = sale.share.taxCents > 0 ? [
+        {
+            amountCents: sale.share.taxCents,
+            taxabilityReason: null,
+            taxRateId: null,
+            taxableAmountCents: sale.share.taxableCents,
+            jurisdiction: state,
+            rateState: state,
+            percentage: sale.ratePct
+        }
+    ] : [];
+    return {
+        orgId: attached ? attachment.orgId : sale.sellerOrgId,
+        // The buyer's store once they chose one; until then the workspace's,
+        // and the buyer picks the store when they set the reader up.
+        hostId: attached ? (_attachment_hostId = attachment.hostId) != null ? _attachment_hostId : '' : '',
+        createdBy: attachment.uid,
+        contactEmail: (_attachment_email = attachment.email) != null ? _attachment_email : sale.receiptEmail,
+        lines: sale.share.lines,
+        subtotalCents: sale.share.itemsCents,
+        discountCents: sale.share.discountCents,
+        shipping: {
+            method: 'in_person',
+            label: POS_HARDWARE_IN_PERSON_SHIPPING_LABEL,
+            cents: 0,
+            name: null,
+            phone: null,
+            address: null,
+            // Sold at the counter: taxed where the store is, as every sale it rings.
+            taxRegion: sale.taxRegion
+        },
+        taxCents: sale.share.taxCents,
+        totalCents: sale.share.totalCents,
+        currency: (_sale_currency = sale.currency) != null ? _sale_currency : POS_HARDWARE_CURRENCY,
+        automaticTax: false,
+        taxLines,
+        stripeCheckoutSessionId: null,
+        stripePaymentIntentId: null,
+        stripeHardwareOrderId: null,
+        tracking: null,
+        status: 'delivered',
+        livemode: sale.livemode,
+        createdAtMs: sale.paidAtMs,
+        updatedAtMs: sale.paidAtMs,
+        paidAtMs: sale.paidAtMs,
+        deliveredAtMs: sale.paidAtMs,
+        source: 'in_person',
+        // Accepted on the tablet or the display before paying, or else agreed by
+        // paying under the receipt's and the booth sign's notice (Terms 4.28).
+        termsAcceptance: (_posHardwareTermsAcceptanceOf = posHardwareTermsAcceptanceOf(sale.termsAcceptance)) != null ? _posHardwareTermsAcceptanceOf : posHardwareTermsAcceptance({
+            method: 'notice',
+            atMs: sale.paidAtMs
+        }),
+        posSale: {
+            hostId: sale.sellerHostId,
+            orgId: sale.sellerOrgId,
+            orderId: sale.registerOrderId,
+            number: sale.number,
+            registerId: sale.registerId,
+            kiosk: sale.kiosk,
+            offline: sale.offline,
+            paymentLinkSessionId: sale.paymentLinkSessionId
+        },
+        paidTo: {
+            account: 'seller_store',
+            hostId: sale.sellerHostId,
+            orgId: sale.sellerOrgId,
+            tenders: [
+                ...new Set(sale.tenders)
+            ],
+            stripeAccountId: sale.stripeAccountId
+        },
+        attachment,
+        units,
+        serialNumbers: units.flatMap((unit)=>unit.serialNumber ? [
+                unit.serialNumber
+            ] : [])
+    };
+}
+
+//# sourceMappingURL=pos-hardware-in-person.js.map

package/src/lib/model/pos-hardware-in-person.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/pos-hardware-in-person.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\n/*==========================================\n * A REGISTER SALE OF HARDWARE BECOMES A HARDWARE ORDER (AGL-4038).\n *\n * The platform's own store sells readers at its register like anything else\n * it sells: its prices, its promotions, its tax rate, its tenders, its\n * account. What follows the sale is a hardware order for the buyer's\n * workspace, built here from the register sale as it was paid — pure, so the\n * money is specced without Firestore.\n *\n * THE HARDWARE'S SHARE OF THE SALE. A sale may hold a reader and a T-shirt.\n * The order takes the hardware lines at the prices they were rung at, and\n * the sale's discount and tax fall on them in proportion — the discount by\n * the lines' share of the items, the tax by their share of what was taxed\n * (the register taxes the whole basket, less its discount, at one rate).\n * Each share is rounded half up to the cent in integer math, and a sale of\n * hardware alone takes the whole discount and the whole tax, to the cent.\n *\n * WHO IT BELONGS TO. A sale a register user attached to an account and a\n * workspace is that workspace's order. Every other one — a kiosk sale, an\n * offline sale, a buyer with no account yet or no workspace yet — is\n * PENDING: kept in the selling workspace's own orders, on its \"To attach\"\n * list, until it is attached.\n *=========================================*/\n\nimport type { OrderHardwareBuyer } from './commerce-orders'\nimport {\n  POS_HARDWARE_CURRENCY,\n  POS_HARDWARE_IN_PERSON_SHIPPING_LABEL,\n  posHardwareBuyerAddress,\n  posHardwareSku,\n  type PosHardwareAttachment,\n  type PosHardwareLine,\n  type PosHardwareOrder,\n  type PosHardwareSkuId,\n  type PosHardwareTaxLine,\n  type PosHardwareTaxRegion,\n  type PosHardwareUnit,\n} from './pos-hardware'\nimport { posHardwareTermsAcceptance, posHardwareTermsAcceptanceOf } from './pos-hardware-terms'\n\n/** One register line, with the hardware item its product is, when it is one. */\nexport interface PosHardwareRegisterLine {\n  sku: PosHardwareSkuId | null\n  quantity: number\n  unitAmountCents: number\n}\n\nexport interface PosHardwareRegisterShare {\n  lines: PosHardwareLine[]\n  /** The hardware lines at the prices rung. */\n  itemsCents: number\n  discountCents: number\n  /** What tax was charged on: the items less the discount. */\n  taxableCents: number\n  taxCents: number\n  totalCents: number\n}\n\nconst whole = (value: unknown): number => {\n  const number = Number(value)\n  return Number.isSafeInteger(number) && number > 0 ? number : 0\n}\n\n/** `amount × part / of`, rounded half up, in integer math; 0 when `of` is 0. */\nfunction shareOf(amount: number, part: number, of: number): number {\n  if (of <= 0 || amount <= 0 || part <= 0) return 0\n  if (part >= of) return amount\n  return Math.floor((amount * part * 2 + of) / (of * 2))\n}\n\n/**\n * The hardware's share of a register sale, or `null` when the sale sold no\n * hardware. `discountCents` and `taxCents` are the SALE's.\n */\nexport function posHardwareRegisterShare(input: {\n  lines: readonly PosHardwareRegisterLine[]\n  discountCents: number\n  taxCents: number\n}): PosHardwareRegisterShare | null {\n  const lines: PosHardwareLine[] = []\n  let saleItemsCents = 0\n  for (const line of input.lines) {\n    const quantity = whole(line.quantity)\n    const unitCents = whole(line.unitAmountCents)\n    saleItemsCents += quantity * unitCents\n    const sku = line.sku ? posHardwareSku(line.sku) : null\n    if (!sku || !quantity) continue\n    lines.push({ sku: sku.id, name: sku.displayName, quantity, unitCents, lineCents: quantity * unitCents })\n  }\n  if (!lines.length) return null\n  const itemsCents = lines.reduce((sum, line) => sum + line.lineCents, 0)\n  const saleDiscountCents = Math.min(whole(input.discountCents), saleItemsCents)\n  const discountCents = shareOf(saleDiscountCents, itemsCents, saleItemsCents)\n  const taxableCents = Math.max(0, itemsCents - discountCents)\n  const taxCents = shareOf(whole(input.taxCents), taxableCents, saleItemsCents - saleDiscountCents)\n  return { lines, itemsCents, discountCents, taxableCents, taxCents, totalCents: taxableCents + taxCents }\n}\n\n/**\n * One unit per reader sold, in line order; accessories carry no serial and\n * have no unit. `serials` are the serial numbers taken at the sale, in the\n * same order, already normalized; a reader with none waits for one.\n */\nexport function posHardwareUnits(\n  lines: readonly PosHardwareLine[],\n  serials: readonly string[] = [],\n): PosHardwareUnit[] {\n  const units: PosHardwareUnit[] = []\n  for (const line of lines) {\n    if (posHardwareSku(line.sku)?.kind !== 'reader') continue\n    for (let index = 0; index < line.quantity; index += 1) {\n      units.push({\n        sku: line.sku,\n        serialNumber: serials[units.length] || null,\n        readerId: null,\n        hostId: null,\n        registeredAtMs: null,\n      })\n    }\n  }\n  return units\n}\n\n/**\n * Whose the order is: the workspace the register attached, or pending. A\n * buyer with an account and a workspace is attached; one with only an\n * account or only an address is pending until they have a workspace.\n */\nexport function posHardwareAttachmentOf(buyer: OrderHardwareBuyer | null | undefined): PosHardwareAttachment {\n  const text = (value: unknown) => (typeof value === 'string' && value.trim() ? value.trim() : null)\n  const uid = text(buyer?.uid)\n  const orgId = text(buyer?.orgId)\n  const attached = Boolean(uid && orgId)\n  return {\n    state: attached ? 'attached' : 'pending',\n    email: text(buyer?.email)?.toLowerCase() ?? null,\n    uid,\n    orgId: attached ? orgId : null,\n    hostId: attached ? text(buyer?.hostId) : null,\n    attachedBy: text(buyer?.attachedBy),\n    attachedAtMs: attached && Number.isFinite(buyer?.attachedAtMs) ? Number(buyer?.attachedAtMs) : null,\n    // The reseller's records of who bought it (AGL-4038), when known.\n    name: text(buyer?.name)?.slice(0, 200) ?? null,\n    address: posHardwareBuyerAddress(buyer?.address),\n  }\n}\n\n/** The register sale, as the builder reads it. */\nexport interface InPersonRegisterSale {\n  sellerHostId: string\n  sellerOrgId: string\n  registerOrderId: string\n  number: number | null\n  registerId: string | null\n  kiosk: boolean\n  offline: boolean\n  share: PosHardwareRegisterShare\n  /** When the sale was paid: the order's own stamp. */\n  paidAtMs: number\n  /** The tenders that paid it, as its payments name them. */\n  tenders: string[]\n  paymentLinkSessionId: string | null\n  /** The address the receipt went to, kept for staff when nobody is attached. */\n  receiptEmail: string | null\n  buyer: OrderHardwareBuyer | null | undefined\n  /** Serial numbers taken at the sale, normalized, in reader order. */\n  serials?: readonly string[]\n  /** Where the store taxes from: its own address's region. */\n  taxRegion: PosHardwareTaxRegion | null\n  /** The store's rate, in percent, when it charged one. */\n  ratePct: number | null\n  stripeAccountId: string | null\n  livemode: boolean\n  currency?: string\n  /**\n   * How the buyer agreed to the terms of sale before paying (AGL-4038), from\n   * the register sale; absent, the receipt-and-sign notice at the sale.\n   */\n  termsAcceptance?: unknown\n}\n\n/**\n * The hardware order a register sale becomes. In-person hardware is handed\n * over at the sale, so the order starts at Delivered, and moves to Set up\n * once its readers are registered.\n *\n * The tax line states the base the store's rate was applied to — the\n * hardware's share of what the register taxed — so the platform's return\n * reads a stated base, never an inferred one.\n */\nexport function inPersonPosHardwareOrder(sale: InPersonRegisterSale): PosHardwareOrder {\n  const attachment = posHardwareAttachmentOf(sale.buyer)\n  const attached = attachment.state === 'attached'\n  const units = posHardwareUnits(sale.share.lines, sale.serials ?? [])\n  const state = sale.taxRegion?.state ?? null\n  const taxLines: PosHardwareTaxLine[] =\n    sale.share.taxCents > 0\n      ? [\n          {\n            amountCents: sale.share.taxCents,\n            taxabilityReason: null,\n            taxRateId: null,\n            taxableAmountCents: sale.share.taxableCents,\n            jurisdiction: state,\n            rateState: state,\n            percentage: sale.ratePct,\n          },\n        ]\n      : []\n  return {\n    orgId: attached ? (attachment.orgId as string) : sale.sellerOrgId,\n    // The buyer's store once they chose one; until then the workspace's,\n    // and the buyer picks the store when they set the reader up.\n    hostId: attached ? (attachment.hostId ?? '') : '',\n    createdBy: attachment.uid,\n    contactEmail: attachment.email ?? sale.receiptEmail,\n    lines: sale.share.lines,\n    subtotalCents: sale.share.itemsCents,\n    discountCents: sale.share.discountCents,\n    shipping: {\n      method: 'in_person',\n      label: POS_HARDWARE_IN_PERSON_SHIPPING_LABEL,\n      cents: 0,\n      name: null,\n      phone: null,\n      address: null,\n      // Sold at the counter: taxed where the store is, as every sale it rings.\n      taxRegion: sale.taxRegion,\n    },\n    taxCents: sale.share.taxCents,\n    totalCents: sale.share.totalCents,\n    currency: sale.currency ?? POS_HARDWARE_CURRENCY,\n    automaticTax: false,\n    taxLines,\n    stripeCheckoutSessionId: null,\n    stripePaymentIntentId: null,\n    stripeHardwareOrderId: null,\n    tracking: null,\n    status: 'delivered',\n    livemode: sale.livemode,\n    createdAtMs: sale.paidAtMs,\n    updatedAtMs: sale.paidAtMs,\n    paidAtMs: sale.paidAtMs,\n    deliveredAtMs: sale.paidAtMs,\n    source: 'in_person',\n    // Accepted on the tablet or the display before paying, or else agreed by\n    // paying under the receipt's and the booth sign's notice (Terms 4.28).\n    termsAcceptance:\n      posHardwareTermsAcceptanceOf(sale.termsAcceptance) ??\n      posHardwareTermsAcceptance({ method: 'notice', atMs: sale.paidAtMs }),\n    posSale: {\n      hostId: sale.sellerHostId,\n      orgId: sale.sellerOrgId,\n      orderId: sale.registerOrderId,\n      number: sale.number,\n      registerId: sale.registerId,\n      kiosk: sale.kiosk,\n      offline: sale.offline,\n      paymentLinkSessionId: sale.paymentLinkSessionId,\n    },\n    paidTo: {\n      account: 'seller_store',\n      hostId: sale.sellerHostId,\n      orgId: sale.sellerOrgId,\n      tenders: [...new Set(sale.tenders)],\n      stripeAccountId: sale.stripeAccountId,\n    },\n    attachment,\n    units,\n    serialNumbers: units.flatMap((unit) => (unit.serialNumber ? [unit.serialNumber] : [])),\n  }\n}\n"],"names":["POS_HARDWARE_CURRENCY","POS_HARDWARE_IN_PERSON_SHIPPING_LABEL","posHardwareBuyerAddress","posHardwareSku","posHardwareTermsAcceptance","posHardwareTermsAcceptanceOf","whole","value","number","Number","isSafeInteger","shareOf","amount","part","of","Math","floor","posHardwareRegisterShare","input","lines","saleItemsCents","line","quantity","unitCents","unitAmountCents","sku","push","id","name","displayName","lineCents","length","itemsCents","reduce","sum","saleDiscountCents","min","discountCents","taxableCents","max","taxCents","totalCents","posHardwareUnits","serials","units","kind","index","serialNumber","readerId","hostId","registeredAtMs","posHardwareAttachmentOf","buyer","text","trim","uid","orgId","attached","Boolean","state","email","toLowerCase","attachedBy","attachedAtMs","isFinite","slice","address","inPersonPosHardwareOrder","sale","attachment","share","taxRegion","taxLines","amountCents","taxabilityReason","taxRateId","taxableAmountCents","jurisdiction","rateState","percentage","ratePct","sellerOrgId","createdBy","contactEmail","receiptEmail","subtotalCents","shipping","method","label","cents","phone","currency","automaticTax","stripeCheckoutSessionId","stripePaymentIntentId","stripeHardwareOrderId","tracking","status","livemode","createdAtMs","paidAtMs","updatedAtMs","deliveredAtMs","source","termsAcceptance","atMs","posSale","sellerHostId","orderId","registerOrderId","registerId","kiosk","offline","paymentLinkSessionId","paidTo","account","tenders","Set","stripeAccountId","serialNumbers","flatMap","unit"],"mappings":"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"}

package/src/lib/model/pos-hardware-tax-summary.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * THE PLATFORM'S OWN HARDWARE SALES, SUMMED FOR ONE FILING PERIOD (AGL-4038).
+ *
+ * The platform is the seller of record for every card reader order, so these
+ * are its OWN sales, not facilitated ones, and they belong on its sales tax
+ * return. They are recorded in `posHardwareSales` — apart from the invoices
+ * the return sums (`platformRevenue`, written only for a paid invoice, which a
+ * hardware checkout never makes) and apart from the storefront's tax rows
+ * (`storefrontTaxCollected`, whose recorder does not take a hardware session)
+ * — so nothing here is already in another figure on the return. The return
+ * folds them into its filing figures as the operator's own sales
+ * (`server/pos-hardware-tax-return-source.ts`), each sale once.
+ *
+ * THE RULES, each pinned by `pos-hardware-tax-summary.spec.ts`:
+ *
+ * - **A sale is in the period it was PAID**, by `paidAtMs`, half-open: the
+ *   first instant of the period is in, the first instant of the next is not.
+ *   Its status today does not move it: an order paid in the period and
+ *   canceled later is still a sale of the period it was paid in.
+ * - **Total sales** are receipts excluding the tax itself: the total less
+ *   the tax (the items and the shipping).
+ * - **Taxable sales** are the base Stripe Tax applied its rate to, read from
+ *   the order's stored breakdown and never inferred. One order's lines are
+ *   one base taxed at several levels (state, county, city), each line
+ *   stating the same base, so the order's base is the LARGEST stated, never
+ *   their sum. An order taxed with no stated base adds nothing and is counted
+ *   out loud.
+ * - **A refund is in the period it was MADE**, by the stamp of the status
+ *   that refunded it (`refundedAtMs`, or `canceledAtMs` for a cancel), and
+ *   is stated beside the sales, never netted from them — the platform's own
+ *   rule for its invoices. Hardware refunds are whole, so the refunded tax is
+ *   the order's own tax; a partial one is split in the order's own ratio.
+ * - **A canceled order with no refund recorded** stays a sale and is counted
+ *   out loud: the record says canceled and nobody recorded the money coming
+ *   back.
+ * - **Test-mode orders are not sales.** An order made with Stripe's test keys
+ *   is left out of every figure and counted, never dropped silently.
+ * - **Where it shipped decides the jurisdiction**: a shipped sale is sourced
+ *   to its destination. No ship-to region is `unknown`, counted out loud.
+ *
+ * Integer cents throughout. Pure and total: no Firestore, no clock.
+ */
+import { type TaxLineInput, type TaxReturnJurisdiction } from '@aglyn/aglyn/app-utils/tax-jurisdiction-figures';
+/** A `posHardwareSales/{orderId}` record as the return reads it. */
+export interface PosHardwareTaxRowInput {
+    orderId: string;
+    totalCents?: unknown;
+    taxCents?: unknown;
+    currency?: unknown;
+    shipTo?: {
+        country?: unknown;
+        state?: unknown;
+        postalCode?: unknown;
+    } | null;
+    automaticTax?: unknown;
+    taxLines?: TaxLineInput[] | null;
+    status?: unknown;
+    livemode?: unknown;
+    paidAtMs?: unknown;
+    refundedCents?: unknown;
+    refundedAtMs?: unknown;
+    canceledAtMs?: unknown;
+    /** `in_person` for a reader sold at a store's register (AGL-4038), else sold online. */
+    source?: unknown;
+    /** The store whose register sold it, for an in-person sale. */
+    posHostId?: unknown;
+}
+/** One ship-to jurisdiction: the sales paid in the period and the refunds made in it. */
+export interface PosHardwareTaxJurisdiction extends TaxReturnJurisdiction {
+    /** Sales with no tax computed: sold without Stripe Tax. */
+    untaxedOrders: number;
+    refundedOrders: number;
+    /** Refunded receipts excluding tax. */
+    refundedSalesCents: number;
+    refundedTaxCents: number;
+}
+export interface PosHardwareTaxSummary {
+    periodStart: string;
+    periodEnd: string;
+    /** Live sales paid in the period, in every jurisdiction. */
+    orders: number;
+    totalSalesCents: number;
+    taxableSalesCents: number;
+    taxCollectedCents: number;
+    byJurisdiction: Record<string, PosHardwareTaxJurisdiction>;
+    refunds: {
+        orders: number;
+        /** Everything refunded, tax included. */
+        refundedCents: number;
+        refundedSalesCents: number;
+        refundedTaxCents: number;
+    };
+    excluded: {
+        /** Test-mode orders paid in the period: in no figure. */
+        testModeOrders: number;
+    };
+    attention: {
+        untaxedOrders: number;
+        ordersMissingTaxableBase: number;
+        ordersMissingShipTo: number;
+        canceledWithoutRefund: number;
+    };
+}
+/**
+ * The base Stripe stated for one order, or null when no line states one: the
+ * largest of the stated bases, because each jurisdiction level restates the
+ * same base (see the module note).
+ */
+export declare function posHardwareTaxableBase(lines: readonly (TaxLineInput | undefined)[] | null | undefined): number | null;
+/** When the order's refund was made: the stamp of the status that made it. */
+export declare function posHardwareRefundStamp(row: PosHardwareTaxRowInput): number | null;
+/** How a row counts in the period: as a sale, as a refund, as both, or not at all. */
+export declare function posHardwareRowInPeriod(row: PosHardwareTaxRowInput, period: {
+    start: Date;
+    end: Date;
+}): {
+    sale: boolean;
+    refund: boolean;
+};
+/** The period's figures from the records read for it. See the module note. */
+export declare function posHardwareTaxSummary(rows: readonly PosHardwareTaxRowInput[], period: {
+    start: Date;
+    end: Date;
+}): PosHardwareTaxSummary;
+/** The part of a storefront row an in-person hardware record accounts for. */
+export interface PosHardwareStorefrontPart {
+    storefrontTaxRowId: string;
+    /** The hardware's share of the register sale, tax included. */
+    totalCents: number;
+    taxCents: number;
+}
+/** The parts the hardware section counts, from its records. */
+export declare function posHardwareStorefrontParts(records: ReadonlyArray<{
+    source?: unknown;
+    storefrontTaxRowId?: unknown;
+    totalCents?: unknown;
+    taxCents?: unknown;
+    livemode?: unknown;
+}>): PosHardwareStorefrontPart[];
+/**
+ * The storefront rows with each in-person hardware part taken out: a row's
+ * receipts and tax less the hardware's, and a row left with nothing dropped.
+ * A row's stated tax lines are kept as they are: a register sale's row is a
+ * manual-rate row, which states none.
+ */
+export declare function storefrontRowsWithoutInPersonHardware<Row extends {
+    id: string;
+    grossCents?: unknown;
+    taxCents?: unknown;
+}>(rows: readonly Row[], parts: readonly PosHardwareStorefrontPart[]): Row[];

package/src/lib/model/pos-hardware-tax-summary.js

@@ -0,0 +1,225 @@
+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.
+ */ /**
+ * THE PLATFORM'S OWN HARDWARE SALES, SUMMED FOR ONE FILING PERIOD (AGL-4038).
+ *
+ * The platform is the seller of record for every card reader order, so these
+ * are its OWN sales, not facilitated ones, and they belong on its sales tax
+ * return. They are recorded in `posHardwareSales` — apart from the invoices
+ * the return sums (`platformRevenue`, written only for a paid invoice, which a
+ * hardware checkout never makes) and apart from the storefront's tax rows
+ * (`storefrontTaxCollected`, whose recorder does not take a hardware session)
+ * — so nothing here is already in another figure on the return. The return
+ * folds them into its filing figures as the operator's own sales
+ * (`server/pos-hardware-tax-return-source.ts`), each sale once.
+ *
+ * THE RULES, each pinned by `pos-hardware-tax-summary.spec.ts`:
+ *
+ * - **A sale is in the period it was PAID**, by `paidAtMs`, half-open: the
+ *   first instant of the period is in, the first instant of the next is not.
+ *   Its status today does not move it: an order paid in the period and
+ *   canceled later is still a sale of the period it was paid in.
+ * - **Total sales** are receipts excluding the tax itself: the total less
+ *   the tax (the items and the shipping).
+ * - **Taxable sales** are the base Stripe Tax applied its rate to, read from
+ *   the order's stored breakdown and never inferred. One order's lines are
+ *   one base taxed at several levels (state, county, city), each line
+ *   stating the same base, so the order's base is the LARGEST stated, never
+ *   their sum. An order taxed with no stated base adds nothing and is counted
+ *   out loud.
+ * - **A refund is in the period it was MADE**, by the stamp of the status
+ *   that refunded it (`refundedAtMs`, or `canceledAtMs` for a cancel), and
+ *   is stated beside the sales, never netted from them — the platform's own
+ *   rule for its invoices. Hardware refunds are whole, so the refunded tax is
+ *   the order's own tax; a partial one is split in the order's own ratio.
+ * - **A canceled order with no refund recorded** stays a sale and is counted
+ *   out loud: the record says canceled and nobody recorded the money coming
+ *   back.
+ * - **Test-mode orders are not sales.** An order made with Stripe's test keys
+ *   is left out of every figure and counted, never dropped silently.
+ * - **Where it shipped decides the jurisdiction**: a shipped sale is sourced
+ *   to its destination. No ship-to region is `unknown`, counted out loud.
+ *
+ * Integer cents throughout. Pure and total: no Firestore, no clock.
+ */ import { accumulateTaxWorkingPapers, emptyTaxJurisdiction, taxJurisdictionKey } from "@aglyn/aglyn/app-utils/tax-jurisdiction-figures";
+const cents = (value)=>{
+    const parsed = Number(value != null ? value : 0);
+    return Number.isFinite(parsed) ? Math.round(parsed) : 0;
+};
+const stamp = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : null;
+function emptyJurisdiction() {
+    return _extends({}, emptyTaxJurisdiction(), {
+        untaxedOrders: 0,
+        refundedOrders: 0,
+        refundedSalesCents: 0,
+        refundedTaxCents: 0
+    });
+}
+/**
+ * The base Stripe stated for one order, or null when no line states one: the
+ * largest of the stated bases, because each jurisdiction level restates the
+ * same base (see the module note).
+ */ export function posHardwareTaxableBase(lines) {
+    let base = null;
+    for (const line of lines != null ? lines : []){
+        const stated = line == null ? void 0 : line.taxableAmountCents;
+        if (stated === null || stated === undefined || !Number.isFinite(Number(stated))) continue;
+        const rounded = Math.round(Number(stated));
+        base = base === null ? rounded : Math.max(base, rounded);
+    }
+    return base;
+}
+/** When the order's refund was made: the stamp of the status that made it. */ export function posHardwareRefundStamp(row) {
+    var _stamp, _stamp1, _stamp2;
+    if (row.status === 'refunded') return (_stamp = stamp(row.refundedAtMs)) != null ? _stamp : stamp(row.canceledAtMs);
+    if (row.status === 'canceled') return (_stamp1 = stamp(row.canceledAtMs)) != null ? _stamp1 : stamp(row.refundedAtMs);
+    return (_stamp2 = stamp(row.refundedAtMs)) != null ? _stamp2 : stamp(row.canceledAtMs);
+}
+/** How a row counts in the period: as a sale, as a refund, as both, or not at all. */ export function posHardwareRowInPeriod(row, period) {
+    const startMs = period.start.getTime();
+    const endMs = period.end.getTime();
+    const within = (at)=>at !== null && at >= startMs && at < endMs;
+    return {
+        sale: within(stamp(row.paidAtMs)),
+        refund: cents(row.refundedCents) > 0 && within(posHardwareRefundStamp(row))
+    };
+}
+/** The period's figures from the records read for it. See the module note. */ export function posHardwareTaxSummary(rows, period) {
+    const summary = {
+        periodStart: period.start.toISOString(),
+        periodEnd: period.end.toISOString(),
+        orders: 0,
+        totalSalesCents: 0,
+        taxableSalesCents: 0,
+        taxCollectedCents: 0,
+        byJurisdiction: {},
+        refunds: {
+            orders: 0,
+            refundedCents: 0,
+            refundedSalesCents: 0,
+            refundedTaxCents: 0
+        },
+        excluded: {
+            testModeOrders: 0
+        },
+        attention: {
+            untaxedOrders: 0,
+            ordersMissingTaxableBase: 0,
+            ordersMissingShipTo: 0,
+            canceledWithoutRefund: 0
+        }
+    };
+    // The reader merges three queries, so an order can arrive twice.
+    const seen = new Set();
+    for (const row of rows != null ? rows : []){
+        var _summary_byJurisdiction, _jurisdiction, _;
+        if (!(row == null ? void 0 : row.orderId) || seen.has(row.orderId)) continue;
+        seen.add(row.orderId);
+        const placed = posHardwareRowInPeriod(row, period);
+        if (!placed.sale && !placed.refund) continue;
+        if (row.livemode !== true) {
+            if (placed.sale) summary.excluded.testModeOrders += 1;
+            continue;
+        }
+        const total = cents(row.totalCents);
+        const tax = cents(row.taxCents);
+        const jurisdiction = taxJurisdictionKey(row.shipTo);
+        const bucket = (_ = (_summary_byJurisdiction = summary.byJurisdiction)[_jurisdiction = jurisdiction]) != null ? _ : _summary_byJurisdiction[_jurisdiction] = emptyJurisdiction();
+        if (placed.sale) {
+            const lines = Array.isArray(row.taxLines) ? row.taxLines : [];
+            const base = posHardwareTaxableBase(lines);
+            const sales = total - tax;
+            summary.orders += 1;
+            summary.totalSalesCents += sales;
+            summary.taxableSalesCents += base != null ? base : 0;
+            summary.taxCollectedCents += tax;
+            bucket.transactionCount += 1;
+            bucket.totalSalesCents += sales;
+            bucket.taxableSalesCents += base != null ? base : 0;
+            bucket.taxCollectedCents += tax;
+            accumulateTaxWorkingPapers(bucket, lines);
+            if (tax === 0 && row.automaticTax !== true) {
+                bucket.untaxedOrders += 1;
+                summary.attention.untaxedOrders += 1;
+            }
+            if (tax > 0 && base === null) summary.attention.ordersMissingTaxableBase += 1;
+            if (jurisdiction === 'unknown') summary.attention.ordersMissingShipTo += 1;
+            if ((row.status === 'canceled' || row.status === 'refunded') && cents(row.refundedCents) <= 0) {
+                summary.attention.canceledWithoutRefund += 1;
+            }
+        }
+        if (placed.refund) {
+            const refunded = cents(row.refundedCents);
+            // Whole refunds give back the order's own tax; a partial one is split
+            // in the order's own ratio, and a row with no total states no ratio.
+            const refundedTax = refunded >= total ? tax : total > 0 && tax > 0 ? Math.round(refunded * tax / total) : 0;
+            const refundedSales = refunded - refundedTax;
+            summary.refunds.orders += 1;
+            summary.refunds.refundedCents += refunded;
+            summary.refunds.refundedSalesCents += refundedSales;
+            summary.refunds.refundedTaxCents += refundedTax;
+            bucket.refundedOrders += 1;
+            bucket.refundedSalesCents += refundedSales;
+            bucket.refundedTaxCents += refundedTax;
+        }
+    }
+    return summary;
+}
+/** The parts the hardware section counts, from its records. */ export function posHardwareStorefrontParts(records) {
+    return records.flatMap((record)=>record.source === 'in_person' && record.livemode === true && typeof record.storefrontTaxRowId === 'string' && record.storefrontTaxRowId ? [
+            {
+                storefrontTaxRowId: record.storefrontTaxRowId,
+                totalCents: cents(record.totalCents),
+                taxCents: cents(record.taxCents)
+            }
+        ] : []);
+}
+/**
+ * The storefront rows with each in-person hardware part taken out: a row's
+ * receipts and tax less the hardware's, and a row left with nothing dropped.
+ * A row's stated tax lines are kept as they are: a register sale's row is a
+ * manual-rate row, which states none.
+ */ export function storefrontRowsWithoutInPersonHardware(rows, parts) {
+    const byRow = new Map();
+    for (const part of parts){
+        var _byRow_get;
+        const held = (_byRow_get = byRow.get(part.storefrontTaxRowId)) != null ? _byRow_get : {
+            totalCents: 0,
+            taxCents: 0
+        };
+        byRow.set(part.storefrontTaxRowId, {
+            totalCents: held.totalCents + part.totalCents,
+            taxCents: held.taxCents + part.taxCents
+        });
+    }
+    return rows.flatMap((row)=>{
+        const part = byRow.get(row.id);
+        if (!part) return [
+            row
+        ];
+        const gross = cents(row.grossCents) - part.totalCents;
+        if (gross <= 0) return [];
+        return [
+            _extends({}, row, {
+                grossCents: gross,
+                taxCents: Math.max(0, cents(row.taxCents) - part.taxCents)
+            })
+        ];
+    });
+}
+
+//# sourceMappingURL=pos-hardware-tax-summary.js.map