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

package/src/lib/server/pos-hardware-tax-return-source.js

@@ -0,0 +1,462 @@
+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 POS hardware shop's sales on the operator's sales tax return (AGL-4038).
+ *
+ * The operator is the seller of record for every card reader order, so these
+ * are its OWN sales, unlike the storefront's facilitated ones beside them.
+ * They FOLD INTO the filing figures (Items 1–2 for Texas) as the operator's
+ * own sales outside its invoices, through the contract's `operatorSales`:
+ *
+ *   - **sold online from the shop** — on the platform's own account — under
+ *     "Card reader shop (online)";
+ *   - **sold in person** at the operator's own store's register: already in
+ *     that store's register sale, which the own-stores section folds in
+ *     (`own-store-tax-return-source.ts`), so NOT again here. Only a sale whose
+ *     store is not one of the operator's own (the store was moved, or no
+ *     workspace is named as the operator's own) is folded in from its record
+ *     here, and a review finding says so.
+ *
+ * This card states, worded for the filing jurisdiction:
+ *
+ *   - **every card reader sale by ship-to state** (in person: where the store
+ *     is), with the refunds of the period beside them — the figure an
+ *     economic-nexus threshold elsewhere is measured against;
+ *   - **every order in the period** in the working papers, each with where it
+ *     is folded in.
+ *
+ * Truncation and rows no period can reach are reported, and the platform
+ * raises each as a blocking finding of its own.
+ */ import { firebaseAdmin } from "@aglyn/tenant-data-admin";
+import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn/app-utils/platform-brand";
+import { centsToDollars } from "@aglyn/aglyn/app-utils/tax-jurisdiction-figures";
+import { POS_HARDWARE_SALES_COLLECTION } from "../model/pos-hardware.js";
+import { posHardwareRefundStamp, posHardwareRowInPeriod, posHardwareTaxableBase, posHardwareTaxSummary } from "../model/pos-hardware-tax-summary.js";
+/** The section's id, unique on the return. */ export const POS_HARDWARE_TAX_SECTION_ID = 'posHardware';
+/** The part the shop's online sales fold into the filing figures under. */ export const POS_HARDWARE_SHOP_PART_ID = 'posHardwareShop';
+/** The part an in-person sale at a store that is not the operator's own folds in under. */ export const POS_HARDWARE_IN_PERSON_PART_ID = 'posHardwareInPerson';
+/** Where one retained sale record folds into the filing figures. See the module note. */ export function posHardwareFoldedAs(row, options = {}) {
+    var _options_ownHostIds;
+    if (row.source !== 'in_person') return 'shop';
+    const host = typeof row.posHostId === 'string' ? row.posHostId : '';
+    return host && ((_options_ownHostIds = options.ownHostIds) == null ? void 0 : _options_ownHostIds.has(host)) ? 'store register sale' : 'in-person record';
+}
+/**
+ * The operator's own hardware sales the filing figures fold in from this
+ * section: the shop's online sales, and any in-person sale whose store is not
+ * the operator's own. Every figure is the summary's own math over that part's
+ * records, so the card and the figures cannot disagree.
+ */ export function posHardwareOperatorSales(rows, period, options = {}) {
+    const parts = [
+        {
+            id: POS_HARDWARE_SHOP_PART_ID,
+            label: 'Card reader shop (online)',
+            foldedAs: 'shop'
+        },
+        {
+            id: POS_HARDWARE_IN_PERSON_PART_ID,
+            label: 'Card readers sold in person (store not read)',
+            foldedAs: 'in-person record'
+        }
+    ];
+    return parts.flatMap(({ id, label, foldedAs })=>{
+        const summary = posHardwareTaxSummary(rows.filter((row)=>posHardwareFoldedAs(row, options) === foldedAs), period);
+        const byJurisdiction = Object.fromEntries(Object.entries(summary.byJurisdiction).map(([jurisdiction, figures])=>[
+                jurisdiction,
+                {
+                    transactionCount: figures.transactionCount,
+                    totalSalesCents: figures.totalSalesCents,
+                    taxableSalesCents: figures.taxableSalesCents,
+                    taxCollectedCents: figures.taxCollectedCents,
+                    refundCount: figures.refundedOrders,
+                    refundedSalesCents: figures.refundedSalesCents,
+                    refundedTaxCents: figures.refundedTaxCents
+                }
+            ]));
+        // The shop's part is always stated, so its zero is a figure; an empty
+        // in-person part is simply not there.
+        return foldedAs === 'shop' || Object.keys(byJurisdiction).length ? [
+            {
+                id,
+                label,
+                byJurisdiction
+            }
+        ] : [];
+    });
+}
+const isoOrNull = (value)=>value === null ? null : new Date(value).toISOString();
+const numberOrNull = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : null;
+const textOrNull = (value)=>typeof value === 'string' && value ? value : null;
+const emptyFigures = ()=>({
+        transactionCount: 0,
+        totalSalesCents: 0,
+        taxableSalesCents: 0,
+        taxCollectedCents: 0,
+        taxabilityReasons: {},
+        rates: [],
+        untaxedOrders: 0,
+        refundedOrders: 0,
+        refundedSalesCents: 0,
+        refundedTaxCents: 0
+    });
+/** The filing jurisdiction's hardware figures, or zeros when none sold there. */ export function posHardwareFilingFigures(summary, filing) {
+    var _summary_byJurisdiction_filing_code;
+    return (_summary_byJurisdiction_filing_code = summary.byJurisdiction[filing.code]) != null ? _summary_byJurisdiction_filing_code : emptyFigures();
+}
+/** The section's findings. The platform raises the non-zero ones. */ export function posHardwareTaxFindings(summary, filing, operatorSales = []) {
+    var _ref;
+    const brand = PLATFORM_BRAND_NAME;
+    const figures = posHardwareFilingFigures(summary, filing);
+    const unread = operatorSales.find((part)=>part.id === POS_HARDWARE_IN_PERSON_PART_ID);
+    return [
+        {
+            // REVIEW: the sales ARE in the figures, from their hardware records;
+            // the rest of that store's sales are not, because it is not one of the
+            // operator's own stores.
+            id: 'posHardwareInPersonStoreNotRead',
+            severity: 'review',
+            count: Object.values((_ref = unread == null ? void 0 : unread.byJurisdiction) != null ? _ref : {}).reduce((sum, part)=>sum + part.transactionCount, 0),
+            label: `Card readers sold in person at a store that is not one of ${brand}’s own`,
+            detail: `Folded into ${filing.figuresName} from their hardware records. The store that sold them is not a ` + `site of the workspace named as ${brand}’s own (POS_HARDWARE_SELLER_ORG_ID), so its other sales are ` + 'not in the figures. Name the workspace, or check the store was moved on purpose.'
+        },
+        {
+            id: 'posHardwareUntaxed',
+            severity: 'review',
+            count: figures.untaxedOrders,
+            label: `Card reader hardware sold into ${filing.label} without tax`,
+            detail: 'Sold while Stripe Tax was off for the hardware shop, so no tax was ' + `collected. If the sale was taxable in ${filing.label}, the tax is ` + `still owed, out of ${brand}’s receipt.`
+        },
+        {
+            id: 'posHardwareMissingTaxableBase',
+            severity: 'review',
+            count: summary.attention.ordersMissingTaxableBase,
+            label: 'Card reader hardware orders with tax but no stated base',
+            detail: 'Tax was collected but Stripe’s taxable_amount was not recorded on the ' + 'order, so the hardware taxable-sales line understates the base. Read ' + 'the Checkout Session in Stripe with the tax breakdown expanded.'
+        },
+        {
+            id: 'posHardwareMissingShipTo',
+            severity: 'review',
+            count: summary.attention.ordersMissingShipTo,
+            label: 'Card reader hardware orders with no ship-to region',
+            detail: 'Listed as Not stated, and in no state’s figures. If the order shipped ' + `to ${filing.label}, the hardware lines understate its sales.`
+        },
+        {
+            id: 'posHardwareCanceledWithoutRefund',
+            severity: 'review',
+            count: summary.attention.canceledWithoutRefund,
+            label: 'Canceled card reader hardware orders with no refund recorded',
+            detail: 'Counted as sales: the order is marked canceled or refunded, but no ' + 'refund was recorded on it. Check the payment in Stripe.'
+        }
+    ];
+}
+/** Every ship-to state, the filing jurisdiction first, then by sales. */ export function posHardwareJurisdictionRows(summary, filing) {
+    return Object.entries(summary.byJurisdiction).map(([jurisdiction, figures])=>({
+            jurisdiction,
+            isFilingJurisdiction: jurisdiction === filing.code,
+            orders: figures.transactionCount,
+            totalSalesCents: figures.totalSalesCents,
+            taxableSalesCents: figures.taxableSalesCents,
+            taxCollectedCents: figures.taxCollectedCents,
+            refundedOrders: figures.refundedOrders,
+            refundedSalesCents: figures.refundedSalesCents,
+            refundedTaxCents: figures.refundedTaxCents
+        })).sort((a, b)=>Number(b.isFilingJurisdiction) - Number(a.isFilingJurisdiction) || b.totalSalesCents - a.totalSalesCents || a.jurisdiction.localeCompare(b.jurisdiction));
+}
+const dollars = (centsValue)=>`$${centsToDollars(centsValue)}`;
+function posHardwareTables(summary, filing) {
+    return [
+        {
+            description: 'Sales by where each order shipped, which is where its sales tax is ' + 'sourced, and the refunds made in this period beside them. A state ' + 'other than the one filed here is the figure an economic-nexus ' + 'threshold there is measured against.',
+            columns: [
+                {
+                    label: 'Ship-to state'
+                },
+                {
+                    label: 'Orders',
+                    numeric: true
+                },
+                {
+                    label: 'Total sales',
+                    numeric: true,
+                    money: true
+                },
+                {
+                    label: 'Taxable sales',
+                    numeric: true,
+                    money: true
+                },
+                {
+                    label: 'Tax collected',
+                    numeric: true,
+                    money: true
+                },
+                {
+                    label: 'Refunded in period',
+                    numeric: true,
+                    money: true
+                },
+                {
+                    label: 'Tax refunded',
+                    numeric: true,
+                    money: true
+                }
+            ],
+            rows: posHardwareJurisdictionRows(summary, filing).map((row)=>({
+                    key: row.jurisdiction,
+                    cells: [
+                        _extends({
+                            text: row.jurisdiction === 'unknown' ? 'Not stated' : row.jurisdiction
+                        }, row.isFilingJurisdiction ? {
+                            tag: {
+                                label: 'Registered',
+                                tone: 'attention'
+                            }
+                        } : {}, row.refundedOrders ? {
+                            caption: `${row.refundedOrders} refund${row.refundedOrders === 1 ? '' : 's'} in this period`
+                        } : {}),
+                        {
+                            text: String(row.orders)
+                        },
+                        {
+                            text: dollars(row.totalSalesCents),
+                            strong: row.isFilingJurisdiction
+                        },
+                        {
+                            text: dollars(row.taxableSalesCents)
+                        },
+                        {
+                            text: dollars(row.taxCollectedCents)
+                        },
+                        {
+                            text: dollars(row.refundedSalesCents)
+                        },
+                        {
+                            text: dollars(row.refundedTaxCents)
+                        }
+                    ]
+                })),
+            empty: 'No card reader hardware was sold or refunded in this period.',
+            footnote: 'Every card reader sale, online and in person. The online ones are folded into the filing figures ' + 'as “Card reader shop (online)”; one sold in person is in its store’s register sale there. ' + 'Test-mode orders are in no figure. A refund is counted in the period it was made, whenever the ' + 'order was paid.'
+        }
+    ];
+}
+function posHardwareFigures(summary) {
+    const figures = [
+        {
+            label: 'Orders paid in this period',
+            value: String(summary.orders),
+            note: 'Every ship-to state. Live orders only.'
+        }
+    ];
+    if (summary.excluded.testModeOrders) {
+        figures.push({
+            label: 'Test-mode orders left out',
+            value: String(summary.excluded.testModeOrders),
+            note: 'Made with Stripe’s test keys, so not sales: in no figure above.'
+        });
+    }
+    return figures;
+}
+/** One record as the working papers carry it, for an order the period counts. */ function projectRow(row, period, options) {
+    var _row_totalCents, _row_taxCents, _row_refundedCents;
+    var _row_shipTo, _row_shipTo1;
+    const placed = posHardwareRowInPeriod(row, period);
+    const total = Number((_row_totalCents = row.totalCents) != null ? _row_totalCents : 0) || 0;
+    const tax = Number((_row_taxCents = row.taxCents) != null ? _row_taxCents : 0) || 0;
+    return {
+        orderId: row.orderId,
+        paidAt: isoOrNull(numberOrNull(row.paidAtMs)),
+        status: textOrNull(row.status),
+        state: textOrNull((_row_shipTo = row.shipTo) == null ? void 0 : _row_shipTo.state),
+        country: textOrNull((_row_shipTo1 = row.shipTo) == null ? void 0 : _row_shipTo1.country),
+        totalSalesCents: total - tax,
+        taxableSalesCents: posHardwareTaxableBase(Array.isArray(row.taxLines) ? row.taxLines : []),
+        taxCents: tax,
+        refundedCents: Number((_row_refundedCents = row.refundedCents) != null ? _row_refundedCents : 0) || 0,
+        refundedAt: isoOrNull(posHardwareRefundStamp(row)),
+        inPeriodAs: placed.sale && placed.refund ? 'sale and refund' : placed.sale ? 'sale' : 'refund',
+        foldedAs: posHardwareFoldedAs(row, options)
+    };
+}
+function posHardwareExports(summary, filing, rows) {
+    const brand = PLATFORM_BRAND_NAME;
+    const states = posHardwareJurisdictionRows(summary, filing);
+    return [
+        {
+            placement: 'jurisdictions',
+            rows: [
+                [
+                    `Card reader hardware — ${brand}’s OWN sales by ship-to state (folded into the filing figures above, by source)`
+                ],
+                [
+                    'Ship-to state',
+                    'Orders',
+                    'Total sales (USD)',
+                    'Taxable sales (USD)',
+                    'Tax collected (USD)',
+                    'Refunded in period (USD)',
+                    'Tax refunded (USD)'
+                ],
+                ...states.length ? states.map((row)=>[
+                        row.jurisdiction,
+                        String(row.orders),
+                        centsToDollars(row.totalSalesCents),
+                        centsToDollars(row.taxableSalesCents),
+                        centsToDollars(row.taxCollectedCents),
+                        centsToDollars(row.refundedSalesCents),
+                        centsToDollars(row.refundedTaxCents)
+                    ]) : [
+                    [
+                        '—',
+                        '0',
+                        '0.00',
+                        '0.00',
+                        '0.00',
+                        '0.00',
+                        '0.00'
+                    ]
+                ]
+            ]
+        },
+        {
+            placement: 'sections',
+            rows: [
+                [
+                    'Card reader hardware orders in this period (posHardwareSales) — folded into the filing figures as each says'
+                ],
+                [
+                    'Order',
+                    'Paid (UTC)',
+                    'Status',
+                    'Ship-to state',
+                    'Country',
+                    'Total sales (USD)',
+                    'Taxable sales (USD)',
+                    'Tax collected (USD)',
+                    'Refunded (USD)',
+                    'Refunded at (UTC)',
+                    'In this period as',
+                    'Folded in as'
+                ],
+                ...rows.map((row)=>{
+                    var _row_paidAt, _row_status, _row_state, _row_country, _row_refundedAt;
+                    return [
+                        row.orderId,
+                        (_row_paidAt = row.paidAt) != null ? _row_paidAt : '',
+                        (_row_status = row.status) != null ? _row_status : '',
+                        (_row_state = row.state) != null ? _row_state : '',
+                        (_row_country = row.country) != null ? _row_country : '',
+                        centsToDollars(row.totalSalesCents),
+                        row.taxableSalesCents === null ? 'not stated' : centsToDollars(row.taxableSalesCents),
+                        centsToDollars(row.taxCents),
+                        centsToDollars(row.refundedCents),
+                        (_row_refundedAt = row.refundedAt) != null ? _row_refundedAt : '',
+                        row.inPeriodAs,
+                        row.foldedAs === 'shop' ? 'Card reader shop (online)' : row.foldedAs === 'store register sale' ? 'its store’s register sale' : 'Card readers sold in person (store not read)'
+                    ];
+                })
+            ]
+        }
+    ];
+}
+/**
+ * The hardware section for one period, from records already read. Pure, so
+ * the section a preparer reads can be proved from fixtures.
+ */ export function posHardwareTaxReturnAnswer(read, request, options = {}) {
+    const brand = PLATFORM_BRAND_NAME;
+    const { filing } = request;
+    const period = {
+        start: request.start,
+        end: request.end
+    };
+    const summary = posHardwareTaxSummary(read.rows, period);
+    const operatorSales = posHardwareOperatorSales(read.rows, period, options);
+    const seen = new Set();
+    const rows = read.rows.filter((row)=>{
+        if (!(row == null ? void 0 : row.orderId) || seen.has(row.orderId) || row.livemode !== true) return false;
+        seen.add(row.orderId);
+        const placed = posHardwareRowInPeriod(row, period);
+        return placed.sale || placed.refund;
+    }).map((row)=>projectRow(row, period, options));
+    return {
+        id: POS_HARDWARE_TAX_SECTION_ID,
+        name: 'Card reader hardware',
+        title: `Card reader hardware — ${brand}’s own sales`,
+        help: `Card readers and accessories ${brand} sold to workspaces, online from the POS hardware shop and ` + `in person at its own store. ${brand} is the seller, so these are its own sales, folded into the ` + 'filing figures above.',
+        intro: `${brand} is the seller of record for every card reader order, so these are ` + `${brand}’s OWN sales, not facilitated ones, and they are folded into ${filing.figuresName}: ` + 'the online ones as “Card reader shop (online)”, one sold in person in its store’s register sale. ' + 'Refunds are counted in the period they were made and never netted.',
+        truncated: read.truncated,
+        undatedRows: read.undatedRows,
+        findings: posHardwareTaxFindings(summary, filing, operatorSales),
+        filingLines: [],
+        operatorSales,
+        tables: posHardwareTables(summary, filing),
+        figures: posHardwareFigures(summary),
+        exports: posHardwareExports(summary, filing, rows),
+        summary,
+        rows
+    };
+}
+/**
+ * Reads the period's hardware records and answers for them.
+ *
+ * Three range queries, because a record counts in a period two ways — paid
+ * in it, or refunded in it (by the stamp of the status that refunded it) —
+ * and a fourth, the honesty check: a range query cannot match a record whose
+ * `paidAtMs` is null, so those are counted over all of them and the platform
+ * blocks the return on any. Each is a single-field range, served by
+ * Firestore's automatic index. A query that reaches the row cap marks the
+ * section truncated, and the platform blocks on that too.
+ */ export async function readPosHardwareTaxReturn(request, options = {}) {
+    var _undated_data_count;
+    const collection = firebaseAdmin.app().firestore().collection(POS_HARDWARE_SALES_COLLECTION);
+    const startMs = request.start.getTime();
+    const endMs = request.end.getTime();
+    const inRange = (field)=>collection.where(field, '>=', startMs).where(field, '<', endMs).limit(request.rowCap + 1).get();
+    const [paid, refunded, canceled, undated] = await Promise.all([
+        inRange('paidAtMs'),
+        inRange('refundedAtMs'),
+        inRange('canceledAtMs'),
+        collection.where('paidAtMs', '==', null).count().get()
+    ]);
+    const byId = new Map();
+    for (const snapshot of [
+        paid,
+        refunded,
+        canceled
+    ]){
+        for (const doc of snapshot.docs.slice(0, request.rowCap)){
+            if (!byId.has(doc.id)) {
+                byId.set(doc.id, _extends({}, doc.data(), {
+                    orderId: doc.id
+                }));
+            }
+        }
+    }
+    return posHardwareTaxReturnAnswer({
+        rows: [
+            ...byId.values()
+        ],
+        truncated: [
+            paid,
+            refunded,
+            canceled
+        ].some((snapshot)=>snapshot.size > request.rowCap),
+        undatedRows: Number((_undated_data_count = undated.data().count) != null ? _undated_data_count : 0)
+    }, request, options);
+}
+
+//# sourceMappingURL=pos-hardware-tax-return-source.js.map

package/src/lib/server/pos-hardware-tax-return-source.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-hardware-tax-return-source.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 * The POS hardware shop's sales on the operator's sales tax return (AGL-4038).\n *\n * The operator is the seller of record for every card reader order, so these\n * are its OWN sales, unlike the storefront's facilitated ones beside them.\n * They FOLD INTO the filing figures (Items 1–2 for Texas) as the operator's\n * own sales outside its invoices, through the contract's `operatorSales`:\n *\n *   - **sold online from the shop** — on the platform's own account — under\n *     \"Card reader shop (online)\";\n *   - **sold in person** at the operator's own store's register: already in\n *     that store's register sale, which the own-stores section folds in\n *     (`own-store-tax-return-source.ts`), so NOT again here. Only a sale whose\n *     store is not one of the operator's own (the store was moved, or no\n *     workspace is named as the operator's own) is folded in from its record\n *     here, and a review finding says so.\n *\n * This card states, worded for the filing jurisdiction:\n *\n *   - **every card reader sale by ship-to state** (in person: where the store\n *     is), with the refunds of the period beside them — the figure an\n *     economic-nexus threshold elsewhere is measured against;\n *   - **every order in the period** in the working papers, each with where it\n *     is folded in.\n *\n * Truncation and rows no period can reach are reported, and the platform\n * raises each as a blocking finding of its own.\n */\n\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport { centsToDollars } from '@aglyn/aglyn/app-utils/tax-jurisdiction-figures'\nimport type {\n  TaxReturnExportBlock,\n  TaxReturnFiling,\n  TaxReturnFinding,\n  TaxReturnOperatorSalesPart,\n  TaxReturnSectionFigure,\n  TaxReturnSectionTable,\n  TaxReturnSourceAnswer,\n  TaxReturnSourceRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-tax-return-sources'\nimport { POS_HARDWARE_SALES_COLLECTION } from '../model/pos-hardware'\nimport {\n  posHardwareRefundStamp,\n  posHardwareRowInPeriod,\n  posHardwareTaxableBase,\n  posHardwareTaxSummary,\n  type PosHardwareTaxJurisdiction,\n  type PosHardwareTaxRowInput,\n  type PosHardwareTaxSummary,\n} from '../model/pos-hardware-tax-summary'\n\n/** The section's id, unique on the return. */\nexport const POS_HARDWARE_TAX_SECTION_ID = 'posHardware'\n\n/** The part the shop's online sales fold into the filing figures under. */\nexport const POS_HARDWARE_SHOP_PART_ID = 'posHardwareShop'\n/** The part an in-person sale at a store that is not the operator's own folds in under. */\nexport const POS_HARDWARE_IN_PERSON_PART_ID = 'posHardwareInPerson'\n\n/** Where an order is folded into the filing figures. */\nexport type PosHardwareFoldedAs = 'shop' | 'store register sale' | 'in-person record'\n\n/** Who decides where a record folds in: the operator's own stores, by site id. */\nexport interface PosHardwareFoldOptions {\n  /** The sites of the operator's own stores, whose register sales the own-stores section folds in. */\n  ownHostIds?: ReadonlySet<string>\n}\n\n/** Where one retained sale record folds into the filing figures. See the module note. */\nexport function posHardwareFoldedAs(\n  row: Pick<PosHardwareTaxRowInput, 'source' | 'posHostId'>,\n  options: PosHardwareFoldOptions = {},\n): PosHardwareFoldedAs {\n  if (row.source !== 'in_person') return 'shop'\n  const host = typeof row.posHostId === 'string' ? row.posHostId : ''\n  return host && options.ownHostIds?.has(host) ? 'store register sale' : 'in-person record'\n}\n\n/**\n * The operator's own hardware sales the filing figures fold in from this\n * section: the shop's online sales, and any in-person sale whose store is not\n * the operator's own. Every figure is the summary's own math over that part's\n * records, so the card and the figures cannot disagree.\n */\nexport function posHardwareOperatorSales(\n  rows: readonly PosHardwareTaxRowInput[],\n  period: { start: Date; end: Date },\n  options: PosHardwareFoldOptions = {},\n): TaxReturnOperatorSalesPart[] {\n  const parts: Array<{ id: string; label: string; foldedAs: PosHardwareFoldedAs }> = [\n    { id: POS_HARDWARE_SHOP_PART_ID, label: 'Card reader shop (online)', foldedAs: 'shop' },\n    {\n      id: POS_HARDWARE_IN_PERSON_PART_ID,\n      label: 'Card readers sold in person (store not read)',\n      foldedAs: 'in-person record',\n    },\n  ]\n  return parts.flatMap(({ id, label, foldedAs }) => {\n    const summary = posHardwareTaxSummary(\n      rows.filter((row) => posHardwareFoldedAs(row, options) === foldedAs),\n      period,\n    )\n    const byJurisdiction = Object.fromEntries(\n      Object.entries(summary.byJurisdiction).map(([jurisdiction, figures]) => [\n        jurisdiction,\n        {\n          transactionCount: figures.transactionCount,\n          totalSalesCents: figures.totalSalesCents,\n          taxableSalesCents: figures.taxableSalesCents,\n          taxCollectedCents: figures.taxCollectedCents,\n          refundCount: figures.refundedOrders,\n          refundedSalesCents: figures.refundedSalesCents,\n          refundedTaxCents: figures.refundedTaxCents,\n        },\n      ]),\n    )\n    // The shop's part is always stated, so its zero is a figure; an empty\n    // in-person part is simply not there.\n    return foldedAs === 'shop' || Object.keys(byJurisdiction).length ? [{ id, label, byJurisdiction }] : []\n  })\n}\n\n/** One order as the working papers carry it: amounts and the region, no buyer. */\nexport interface PosHardwareTaxRow {\n  orderId: string\n  paidAt: string | null\n  status: string | null\n  state: string | null\n  country: string | null\n  totalSalesCents: number\n  taxableSalesCents: number | null\n  taxCents: number\n  refundedCents: number\n  refundedAt: string | null\n  /** How the order counts in this period. */\n  inPeriodAs: 'sale' | 'refund' | 'sale and refund'\n  /** Where it is folded into the filing figures. */\n  foldedAs: PosHardwareFoldedAs\n}\n\nconst isoOrNull = (value: number | null): string | null =>\n  value === null ? null : new Date(value).toISOString()\n\nconst numberOrNull = (value: unknown): number | null =>\n  typeof value === 'number' && Number.isFinite(value) ? value : null\n\nconst textOrNull = (value: unknown): string | null =>\n  typeof value === 'string' && value ? value : null\n\nconst emptyFigures = (): PosHardwareTaxJurisdiction => ({\n  transactionCount: 0,\n  totalSalesCents: 0,\n  taxableSalesCents: 0,\n  taxCollectedCents: 0,\n  taxabilityReasons: {},\n  rates: [],\n  untaxedOrders: 0,\n  refundedOrders: 0,\n  refundedSalesCents: 0,\n  refundedTaxCents: 0,\n})\n\n/** The filing jurisdiction's hardware figures, or zeros when none sold there. */\nexport function posHardwareFilingFigures(\n  summary: PosHardwareTaxSummary,\n  filing: TaxReturnFiling,\n): PosHardwareTaxJurisdiction {\n  return summary.byJurisdiction[filing.code] ?? emptyFigures()\n}\n\n/** The section's findings. The platform raises the non-zero ones. */\nexport function posHardwareTaxFindings(\n  summary: PosHardwareTaxSummary,\n  filing: TaxReturnFiling,\n  operatorSales: readonly TaxReturnOperatorSalesPart[] = [],\n): TaxReturnFinding[] {\n  const brand = PLATFORM_BRAND_NAME\n  const figures = posHardwareFilingFigures(summary, filing)\n  const unread = operatorSales.find((part) => part.id === POS_HARDWARE_IN_PERSON_PART_ID)\n  return [\n    {\n      // REVIEW: the sales ARE in the figures, from their hardware records;\n      // the rest of that store's sales are not, because it is not one of the\n      // operator's own stores.\n      id: 'posHardwareInPersonStoreNotRead',\n      severity: 'review',\n      count: Object.values(unread?.byJurisdiction ?? {}).reduce((sum, part) => sum + part.transactionCount, 0),\n      label: `Card readers sold in person at a store that is not one of ${brand}’s own`,\n      detail:\n        `Folded into ${filing.figuresName} from their hardware records. The store that sold them is not a ` +\n        `site of the workspace named as ${brand}’s own (POS_HARDWARE_SELLER_ORG_ID), so its other sales are ` +\n        'not in the figures. Name the workspace, or check the store was moved on purpose.',\n    },\n    {\n      id: 'posHardwareUntaxed',\n      severity: 'review',\n      count: figures.untaxedOrders,\n      label: `Card reader hardware sold into ${filing.label} without tax`,\n      detail:\n        'Sold while Stripe Tax was off for the hardware shop, so no tax was ' +\n        `collected. If the sale was taxable in ${filing.label}, the tax is ` +\n        `still owed, out of ${brand}’s receipt.`,\n    },\n    {\n      id: 'posHardwareMissingTaxableBase',\n      severity: 'review',\n      count: summary.attention.ordersMissingTaxableBase,\n      label: 'Card reader hardware orders with tax but no stated base',\n      detail:\n        'Tax was collected but Stripe’s taxable_amount was not recorded on the ' +\n        'order, so the hardware taxable-sales line understates the base. Read ' +\n        'the Checkout Session in Stripe with the tax breakdown expanded.',\n    },\n    {\n      id: 'posHardwareMissingShipTo',\n      severity: 'review',\n      count: summary.attention.ordersMissingShipTo,\n      label: 'Card reader hardware orders with no ship-to region',\n      detail:\n        'Listed as Not stated, and in no state’s figures. If the order shipped ' +\n        `to ${filing.label}, the hardware lines understate its sales.`,\n    },\n    {\n      id: 'posHardwareCanceledWithoutRefund',\n      severity: 'review',\n      count: summary.attention.canceledWithoutRefund,\n      label: 'Canceled card reader hardware orders with no refund recorded',\n      detail:\n        'Counted as sales: the order is marked canceled or refunded, but no ' +\n        'refund was recorded on it. Check the payment in Stripe.',\n    },\n  ]\n}\n\n/** One ship-to state's row, ready to print. */\nexport interface PosHardwareJurisdictionRow {\n  jurisdiction: string\n  isFilingJurisdiction: boolean\n  orders: number\n  totalSalesCents: number\n  taxableSalesCents: number\n  taxCollectedCents: number\n  refundedOrders: number\n  refundedSalesCents: number\n  refundedTaxCents: number\n}\n\n/** Every ship-to state, the filing jurisdiction first, then by sales. */\nexport function posHardwareJurisdictionRows(\n  summary: PosHardwareTaxSummary,\n  filing: TaxReturnFiling,\n): PosHardwareJurisdictionRow[] {\n  return Object.entries(summary.byJurisdiction)\n    .map(([jurisdiction, figures]) => ({\n      jurisdiction,\n      isFilingJurisdiction: jurisdiction === filing.code,\n      orders: figures.transactionCount,\n      totalSalesCents: figures.totalSalesCents,\n      taxableSalesCents: figures.taxableSalesCents,\n      taxCollectedCents: figures.taxCollectedCents,\n      refundedOrders: figures.refundedOrders,\n      refundedSalesCents: figures.refundedSalesCents,\n      refundedTaxCents: figures.refundedTaxCents,\n    }))\n    .sort(\n      (a, b) =>\n        Number(b.isFilingJurisdiction) - Number(a.isFilingJurisdiction) ||\n        b.totalSalesCents - a.totalSalesCents ||\n        a.jurisdiction.localeCompare(b.jurisdiction),\n    )\n}\n\nconst dollars = (centsValue: number) => `$${centsToDollars(centsValue)}`\n\nfunction posHardwareTables(summary: PosHardwareTaxSummary, filing: TaxReturnFiling): TaxReturnSectionTable[] {\n  return [\n    {\n      description:\n        'Sales by where each order shipped, which is where its sales tax is ' +\n        'sourced, and the refunds made in this period beside them. A state ' +\n        'other than the one filed here is the figure an economic-nexus ' +\n        'threshold there is measured against.',\n      columns: [\n        { label: 'Ship-to state' },\n        { label: 'Orders', numeric: true },\n        { label: 'Total sales', numeric: true, money: true },\n        { label: 'Taxable sales', numeric: true, money: true },\n        { label: 'Tax collected', numeric: true, money: true },\n        { label: 'Refunded in period', numeric: true, money: true },\n        { label: 'Tax refunded', numeric: true, money: true },\n      ],\n      rows: posHardwareJurisdictionRows(summary, filing).map((row) => ({\n        key: row.jurisdiction,\n        cells: [\n          {\n            text: row.jurisdiction === 'unknown' ? 'Not stated' : row.jurisdiction,\n            ...(row.isFilingJurisdiction ? { tag: { label: 'Registered', tone: 'attention' as const } } : {}),\n            ...(row.refundedOrders\n              ? { caption: `${row.refundedOrders} refund${row.refundedOrders === 1 ? '' : 's'} in this period` }\n              : {}),\n          },\n          { text: String(row.orders) },\n          { text: dollars(row.totalSalesCents), strong: row.isFilingJurisdiction },\n          { text: dollars(row.taxableSalesCents) },\n          { text: dollars(row.taxCollectedCents) },\n          { text: dollars(row.refundedSalesCents) },\n          { text: dollars(row.refundedTaxCents) },\n        ],\n      })),\n      empty: 'No card reader hardware was sold or refunded in this period.',\n      footnote:\n        'Every card reader sale, online and in person. The online ones are folded into the filing figures ' +\n        'as “Card reader shop (online)”; one sold in person is in its store’s register sale there. ' +\n        'Test-mode orders are in no figure. A refund is counted in the period it was made, whenever the ' +\n        'order was paid.',\n    },\n  ]\n}\n\nfunction posHardwareFigures(summary: PosHardwareTaxSummary): TaxReturnSectionFigure[] {\n  const figures: TaxReturnSectionFigure[] = [\n    {\n      label: 'Orders paid in this period',\n      value: String(summary.orders),\n      note: 'Every ship-to state. Live orders only.',\n    },\n  ]\n  if (summary.excluded.testModeOrders) {\n    figures.push({\n      label: 'Test-mode orders left out',\n      value: String(summary.excluded.testModeOrders),\n      note: 'Made with Stripe’s test keys, so not sales: in no figure above.',\n    })\n  }\n  return figures\n}\n\n/** One record as the working papers carry it, for an order the period counts. */\nfunction projectRow(\n  row: PosHardwareTaxRowInput,\n  period: { start: Date; end: Date },\n  options: PosHardwareFoldOptions,\n): PosHardwareTaxRow {\n  const placed = posHardwareRowInPeriod(row, period)\n  const total = Number(row.totalCents ?? 0) || 0\n  const tax = Number(row.taxCents ?? 0) || 0\n  return {\n    orderId: row.orderId,\n    paidAt: isoOrNull(numberOrNull(row.paidAtMs)),\n    status: textOrNull(row.status),\n    state: textOrNull(row.shipTo?.state),\n    country: textOrNull(row.shipTo?.country),\n    totalSalesCents: total - tax,\n    taxableSalesCents: posHardwareTaxableBase(Array.isArray(row.taxLines) ? row.taxLines : []),\n    taxCents: tax,\n    refundedCents: Number(row.refundedCents ?? 0) || 0,\n    refundedAt: isoOrNull(posHardwareRefundStamp(row)),\n    inPeriodAs: placed.sale && placed.refund ? 'sale and refund' : placed.sale ? 'sale' : 'refund',\n    foldedAs: posHardwareFoldedAs(row, options),\n  }\n}\n\nfunction posHardwareExports(\n  summary: PosHardwareTaxSummary,\n  filing: TaxReturnFiling,\n  rows: readonly PosHardwareTaxRow[],\n): TaxReturnExportBlock[] {\n  const brand = PLATFORM_BRAND_NAME\n  const states = posHardwareJurisdictionRows(summary, filing)\n  return [\n    {\n      placement: 'jurisdictions',\n      rows: [\n        [`Card reader hardware — ${brand}’s OWN sales by ship-to state (folded into the filing figures above, by source)`],\n        [\n          'Ship-to state',\n          'Orders',\n          'Total sales (USD)',\n          'Taxable sales (USD)',\n          'Tax collected (USD)',\n          'Refunded in period (USD)',\n          'Tax refunded (USD)',\n        ],\n        ...(states.length\n          ? states.map((row) => [\n              row.jurisdiction,\n              String(row.orders),\n              centsToDollars(row.totalSalesCents),\n              centsToDollars(row.taxableSalesCents),\n              centsToDollars(row.taxCollectedCents),\n              centsToDollars(row.refundedSalesCents),\n              centsToDollars(row.refundedTaxCents),\n            ])\n          : [['—', '0', '0.00', '0.00', '0.00', '0.00', '0.00']]),\n      ],\n    },\n    {\n      placement: 'sections',\n      rows: [\n        ['Card reader hardware orders in this period (posHardwareSales) — folded into the filing figures as each says'],\n        [\n          'Order',\n          'Paid (UTC)',\n          'Status',\n          'Ship-to state',\n          'Country',\n          'Total sales (USD)',\n          'Taxable sales (USD)',\n          'Tax collected (USD)',\n          'Refunded (USD)',\n          'Refunded at (UTC)',\n          'In this period as',\n          'Folded in as',\n        ],\n        ...rows.map((row) => [\n          row.orderId,\n          row.paidAt ?? '',\n          row.status ?? '',\n          row.state ?? '',\n          row.country ?? '',\n          centsToDollars(row.totalSalesCents),\n          row.taxableSalesCents === null ? 'not stated' : centsToDollars(row.taxableSalesCents),\n          centsToDollars(row.taxCents),\n          centsToDollars(row.refundedCents),\n          row.refundedAt ?? '',\n          row.inPeriodAs,\n          row.foldedAs === 'shop'\n            ? 'Card reader shop (online)'\n            : row.foldedAs === 'store register sale'\n              ? 'its store’s register sale'\n              : 'Card readers sold in person (store not read)',\n        ]),\n      ],\n    },\n  ]\n}\n\n/**\n * The hardware section for one period, from records already read. Pure, so\n * the section a preparer reads can be proved from fixtures.\n */\nexport function posHardwareTaxReturnAnswer(\n  read: { rows: readonly PosHardwareTaxRowInput[]; truncated: boolean; undatedRows: number },\n  request: TaxReturnSourceRequest,\n  options: PosHardwareFoldOptions = {},\n): TaxReturnSourceAnswer {\n  const brand = PLATFORM_BRAND_NAME\n  const { filing } = request\n  const period = { start: request.start, end: request.end }\n  const summary = posHardwareTaxSummary(read.rows, period)\n  const operatorSales = posHardwareOperatorSales(read.rows, period, options)\n  const seen = new Set<string>()\n  const rows = read.rows\n    .filter((row) => {\n      if (!row?.orderId || seen.has(row.orderId) || row.livemode !== true) return false\n      seen.add(row.orderId)\n      const placed = posHardwareRowInPeriod(row, period)\n      return placed.sale || placed.refund\n    })\n    .map((row) => projectRow(row, period, options))\n  return {\n    id: POS_HARDWARE_TAX_SECTION_ID,\n    name: 'Card reader hardware',\n    title: `Card reader hardware — ${brand}’s own sales`,\n    help:\n      `Card readers and accessories ${brand} sold to workspaces, online from the POS hardware shop and ` +\n      `in person at its own store. ${brand} is the seller, so these are its own sales, folded into the ` +\n      'filing figures above.',\n    intro:\n      `${brand} is the seller of record for every card reader order, so these are ` +\n      `${brand}’s OWN sales, not facilitated ones, and they are folded into ${filing.figuresName}: ` +\n      'the online ones as “Card reader shop (online)”, one sold in person in its store’s register sale. ' +\n      'Refunds are counted in the period they were made and never netted.',\n    truncated: read.truncated,\n    undatedRows: read.undatedRows,\n    findings: posHardwareTaxFindings(summary, filing, operatorSales),\n    filingLines: [],\n    operatorSales,\n    tables: posHardwareTables(summary, filing),\n    figures: posHardwareFigures(summary),\n    exports: posHardwareExports(summary, filing, rows),\n    summary,\n    rows,\n  }\n}\n\n/**\n * Reads the period's hardware records and answers for them.\n *\n * Three range queries, because a record counts in a period two ways — paid\n * in it, or refunded in it (by the stamp of the status that refunded it) —\n * and a fourth, the honesty check: a range query cannot match a record whose\n * `paidAtMs` is null, so those are counted over all of them and the platform\n * blocks the return on any. Each is a single-field range, served by\n * Firestore's automatic index. A query that reaches the row cap marks the\n * section truncated, and the platform blocks on that too.\n */\nexport async function readPosHardwareTaxReturn(\n  request: TaxReturnSourceRequest,\n  options: PosHardwareFoldOptions = {},\n): Promise<TaxReturnSourceAnswer> {\n  const collection = firebaseAdmin.app().firestore().collection(POS_HARDWARE_SALES_COLLECTION)\n  const startMs = request.start.getTime()\n  const endMs = request.end.getTime()\n  const inRange = (field: string) =>\n    collection.where(field, '>=', startMs).where(field, '<', endMs).limit(request.rowCap + 1).get()\n  const [paid, refunded, canceled, undated] = await Promise.all([\n    inRange('paidAtMs'),\n    inRange('refundedAtMs'),\n    inRange('canceledAtMs'),\n    collection.where('paidAtMs', '==', null).count().get(),\n  ])\n  const byId = new Map<string, PosHardwareTaxRowInput>()\n  for (const snapshot of [paid, refunded, canceled]) {\n    for (const doc of snapshot.docs.slice(0, request.rowCap)) {\n      if (!byId.has(doc.id)) {\n        byId.set(doc.id, { ...(doc.data() as Omit<PosHardwareTaxRowInput, 'orderId'>), orderId: doc.id })\n      }\n    }\n  }\n  return posHardwareTaxReturnAnswer(\n    {\n      rows: [...byId.values()],\n      truncated: [paid, refunded, canceled].some((snapshot) => snapshot.size > request.rowCap),\n      undatedRows: Number(undated.data().count ?? 0),\n    },\n    request,\n    options,\n  )\n}\n"],"names":["firebaseAdmin","PLATFORM_BRAND_NAME","centsToDollars","POS_HARDWARE_SALES_COLLECTION","posHardwareRefundStamp","posHardwareRowInPeriod","posHardwareTaxableBase","posHardwareTaxSummary","POS_HARDWARE_TAX_SECTION_ID","POS_HARDWARE_SHOP_PART_ID","POS_HARDWARE_IN_PERSON_PART_ID","posHardwareFoldedAs","row","options","source","host","posHostId","ownHostIds","has","posHardwareOperatorSales","rows","period","parts","id","label","foldedAs","flatMap","summary","filter","byJurisdiction","Object","fromEntries","entries","map","jurisdiction","figures","transactionCount","totalSalesCents","taxableSalesCents","taxCollectedCents","refundCount","refundedOrders","refundedSalesCents","refundedTaxCents","keys","length","isoOrNull","value","Date","toISOString","numberOrNull","Number","isFinite","textOrNull","emptyFigures","taxabilityReasons","rates","untaxedOrders","posHardwareFilingFigures","filing","code","posHardwareTaxFindings","operatorSales","brand","unread","find","part","severity","count","values","reduce","sum","detail","figuresName","attention","ordersMissingTaxableBase","ordersMissingShipTo","canceledWithoutRefund","posHardwareJurisdictionRows","isFilingJurisdiction","orders","sort","a","b","localeCompare","dollars","centsValue","posHardwareTables","description","columns","numeric","money","key","cells","text","tag","tone","caption","String","strong","empty","footnote","posHardwareFigures","note","excluded","testModeOrders","push","projectRow","placed","total","totalCents","tax","taxCents","orderId","paidAt","paidAtMs","status","state","shipTo","country","Array","isArray","taxLines","refundedCents","refundedAt","inPeriodAs","sale","refund","posHardwareExports","states","placement","posHardwareTaxReturnAnswer","read","request","start","end","seen","Set","livemode","add","name","title","help","intro","truncated","undatedRows","findings","filingLines","tables","exports","readPosHardwareTaxReturn","undated","collection","app","firestore","startMs","getTime","endMs","inRange","field","where","limit","rowCap","get","paid","refunded","canceled","Promise","all","byId","Map","snapshot","doc","docs","slice","set","data","some","size"],"mappings":"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"}

package/src/lib/server/pos-hardware-terms.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @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 { PosHardwareInPersonConfig } from '../model/pos-hardware';
+import { type PosHardwareTermsAcceptance } from '../model/pos-hardware-terms';
+export declare class PosHardwareTermsRefusal extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/** What the buyer reads: the version, the sections, the link and the summary. */
+export declare function posHardwareTermsView(): {
+    version: string;
+    sections: string;
+    url: string;
+    summary: string[];
+};
+/** The device a request came from, as an acceptance records it. */
+export declare function posHardwareTermsDevice(headers: Record<string, unknown>): {
+    ip: string | null;
+    userAgent: string | null;
+};
+/** The sale's items and total, for the screen the buyer accepts on. */
+export declare function posHardwareTermsSale(config: PosHardwareInPersonConfig, registerOrderId: string): Promise<{
+    items: string[];
+    acceptance: PosHardwareTermsAcceptance | null;
+}>;
+/** Whether the buyer has accepted, for the register waiting on the display. */
+export declare function posHardwareTermsStatus(config: PosHardwareInPersonConfig, registerOrderId: string): Promise<{
+    acceptance: PosHardwareTermsAcceptance | null;
+}>;
+/** Notes who put the terms on the display, so the display's acceptance names them. */
+export declare function requestPosHardwareTermsOnDisplay(input: {
+    config: PosHardwareInPersonConfig;
+    registerOrderId: string;
+    uid: string;
+    now?: number;
+}): Promise<void>;
+/**
+ * Records the buyer's acceptance on the register sale and on its hardware
+ * order when there is one, in one transaction. The first electronic
+ * acceptance stands; answers the acceptance that holds.
+ */
+export declare function recordPosHardwareTermsAcceptance(input: {
+    config: PosHardwareInPersonConfig;
+    registerOrderId: string;
+    method: 'tablet' | 'display';
+    staffUid: string | null;
+    ip: string | null;
+    userAgent: string | null;
+    now?: number;
+}): Promise<PosHardwareTermsAcceptance>;