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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/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 * Storefront sales on the operator's sales tax return (AGL-1904, AGL-3080).\n *\n * The operator's return sums its own invoices; this is the storefront's half\n * of it, answered through the platform's tax return source contract\n * (`@aglyn/aglyn/plugin-manager/plugin-tax-return-sources`). It reads\n * `storefrontTaxCollected` — a SEPARATE collection from the operator's own\n * invoices, queried and reported separately, because a storefront row's\n * money is mostly the merchant's while an invoice row's is the operator's.\n * Summing the two would put other companies' receipts into the return's\n * total sales, which is why they never meet in one query and never share a\n * figure.\n *\n * What it answers, all worded for the filing jurisdiction the platform\n * resolved:\n *\n *   - **The three liability buckets**, never summed — see\n *     `model/storefront-tax-summary.ts`.\n *   - **A blocking finding for the platform-liable tax** in the filing\n *     jurisdiction. Every storefront checkout is created on the platform's\n *     own account, so a `mode: 'stripe'` store's shopper is charged tax Stripe\n *     computes against the PLATFORM's registrations — measured, not inferred.\n *     That money is in the platform's balance and is NOT in the filing\n *     figures, which sum the operator's own sales only. Filing those without\n *     deciding what to do with this figure is exactly the shortfall an\n *     auditor finds. It states the mechanics and asks for a decision; it does\n *     NOT assert a marketplace-facilitator position — that attaches by\n *     operation of law and belongs to counsel, not to this report.\n *   - **Two lines beneath the filing figures** — the platform-liable tax and\n *     the merchant's own rate, stated side by side and never folded into a\n *     form item, because this report does not decide how storefront receipts\n *     are reported and adding them to one would be deciding it silently.\n *   - **Facilitated sales by buyer state** — the economic-nexus question\n *     (AGL-1956), with the three buckets SUMMED per jurisdiction on purpose:\n *     a threshold counts the sale whoever remits it. Who remits is still\n *     carried per row.\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 {\n  asRowDate,\n  centsToDollars,\n} from '@aglyn/aglyn/app-utils/tax-jurisdiction-figures'\nimport type {\n  TaxReturnExportBlock,\n  TaxReturnFiling,\n  TaxReturnFilingLine,\n  TaxReturnFinding,\n  TaxReturnSectionTable,\n  TaxReturnSource,\n  TaxReturnSourceAnswer,\n  TaxReturnSourceRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-tax-return-sources'\nimport {\n  storefrontTaxSummary,\n  type StorefrontTaxReturnRowInput,\n  type StorefrontTaxSummary,\n} from '../model/storefront-tax-summary'\n\n/** One row of the storefront listing, as the working papers carry it. */\nexport interface StorefrontTaxRow {\n  id: string\n  hostId: string | null\n  orgId: string | null\n  paidAt: string | null\n  taxMode: string | null\n  taxLiability: string | null\n  grossCents: number\n  taxCents: number\n  taxableSalesCents: number\n  state: string | null\n  country: string | null\n}\n\n/** A liability bucket, ready to print. */\nexport interface StorefrontTaxBucketRow {\n  id: 'aglynLiable' | 'merchantManual' | 'connectedAccountLiable'\n  label: string\n  /** Who owes it — the sentence that decides whether it is on this return. */\n  liability: string\n  transactionCount: number\n  grossDollars: string\n  taxableSalesDollars: string\n  taxCollectedDollars: string\n  /** True when this row is money in the platform's balance under its registration. */\n  platformLiable: boolean\n}\n\n/** One state's facilitated storefront sales, for the nexus question. */\nexport interface StorefrontFacilitatedJurisdictionRow {\n  jurisdiction: string\n  /** True for the one jurisdiction this deployment files a return in. */\n  isFilingJurisdiction: boolean\n  transactionCount: number\n  totalSalesDollars: string\n  taxCollectedDollars: string\n  /** The part of `taxCollectedDollars` the platform holds and must remit. */\n  platformLiableTaxDollars: string\n  /** True when NO tax was collected on any sale into this state. */\n  untaxed: boolean\n}\n\n/**\n * Storefront tax in the FILING jurisdiction that Stripe computed against the\n * platform's own registrations.\n *\n * The one figure that decides whether a period can be filed from the filing\n * lines alone. Deliberately excludes `merchantManual` — a merchant's own\n * configured rate never touched those registrations. Read against the\n * configured jurisdiction rather than Texas, because a hard-coded key answers\n * `0.00` everywhere else — and a zero here reads as \"nothing to decide\" on\n * the one finding that blocks filing.\n */\nexport function storefrontPlatformLiableCents(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): number {\n  const figures = summary?.aglynLiable?.byJurisdiction?.[filing.code]\n  const cents = Number(figures?.taxCollectedCents ?? 0)\n  return Number.isFinite(cents) ? cents : 0\n}\n\n/** The merchant's own configured tax in the filing jurisdiction. */\nfunction merchantManualCents(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): number {\n  return Number(\n    summary?.merchantManual?.byJurisdiction?.[filing.code]?.taxCollectedCents ?? 0,\n  )\n}\n\n/** The storefront's findings. The platform raises the non-zero ones. */\nexport function storefrontTaxFindings(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnFinding[] {\n  const brand = PLATFORM_BRAND_NAME\n  return [\n    {\n      // BLOCKING on purpose — see the module note.\n      id: 'storefrontAglynLiableTax',\n      severity: 'blocking',\n      count: storefrontPlatformLiableCents(summary, filing),\n      label: `${filing.label} storefront tax collected under ${brand}’s registration`,\n      detail:\n        'Cents. Charged to shoppers on merchants’ storefront sales, computed ' +\n        'by Stripe Tax against THE PLATFORM’s registrations (the session is ' +\n        'created on the platform account), and settled into the platform’s ' +\n        `balance. It is NOT included in ${filing.figuresName} below. Decide ` +\n        'with counsel how it is reported before filing — do not file as if ' +\n        'it were zero.',\n    },\n    {\n      id: 'storefrontUnclassified',\n      severity: 'blocking',\n      count: Number(summary?.attention?.rowsUnclassified ?? 0),\n      label: 'Storefront rows with an unrecognised tax mode',\n      detail:\n        'Not counted in any storefront bucket, so they are in no figure at ' +\n        'all. Classify them before filing.',\n    },\n    {\n      id: 'storefrontMissingTaxableBase',\n      severity: 'review',\n      count: Number(summary?.attention?.rowsMissingTaxableBase ?? 0),\n      label: 'Storefront rows with tax but no stated base',\n      detail:\n        'Tax was collected but Stripe’s taxable_amount could not be read, so ' +\n        'the storefront taxable-sales figure understates the base. Re-read ' +\n        'the session in Stripe with the tax breakdown expanded.',\n    },\n  ]\n}\n\n/**\n * The two lines beneath the filing figures: the platform-liable tax and the\n * merchant's own rate, separately, and outside every form item.\n */\nexport function storefrontFilingLines(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnFilingLine[] {\n  const brand = PLATFORM_BRAND_NAME\n  const platformLiable = centsToDollars(storefrontPlatformLiableCents(summary, filing))\n  const merchant = centsToDollars(merchantManualCents(summary, filing))\n  if (filing.form === 'tx-webfile') {\n    return [\n      {\n        item: '—',\n        label: `${filing.label} storefront tax under ${brand}’s registration (NOT in ${filing.figuresName})`,\n        dollars: platformLiable,\n        note:\n          `Collected from shoppers on merchants’ sales and held in ${brand}’s ` +\n          'balance. Excluded from every item above. Its treatment on the ' +\n          'return is a question for counsel — see AGL-1904.',\n      },\n      {\n        item: '—',\n        label: `${filing.label} storefront tax under the MERCHANT’s own rate (not ${brand}’s)`,\n        dollars: merchant,\n        note:\n          `A manual-mode store’s own configured rate. ${brand}’s registrations ` +\n          'played no part in computing it. Shown so it is visibly NOT the line ' +\n          'above — the two must never be added together.',\n      },\n    ]\n  }\n  return [\n    {\n      item: '—',\n      label: `${filing.code} storefront tax under the platform’s registration (NOT in the figures above)`,\n      dollars: platformLiable,\n      note:\n        'Collected from shoppers on merchants’ sales and held in the ' +\n        'platform’s balance. Excluded from every figure above. Its treatment ' +\n        'on the return is a question for the operator’s own counsel.',\n    },\n    {\n      item: '—',\n      label: `${filing.code} storefront tax under the MERCHANT’s own rate`,\n      dollars: merchant,\n      note:\n        'A manual-mode store’s own configured rate. The platform’s ' +\n        'registrations played no part in computing it. Shown so it is ' +\n        'visibly NOT the line above — the two must never be added together.',\n    },\n  ]\n}\n\n/** The three liability buckets, in the order a reader decides them. */\nexport function storefrontBucketRows(\n  summary: StorefrontTaxSummary,\n): StorefrontTaxBucketRow[] {\n  const brand = PLATFORM_BRAND_NAME\n  const buckets: Array<{\n    id: StorefrontTaxBucketRow['id']\n    label: string\n    liability: string\n    platformLiable: boolean\n  }> = [\n    {\n      id: 'aglynLiable',\n      label: `Computed against ${brand}’s registrations`,\n      liability: `In ${brand}’s balance. Stripe Tax computed it on ${brand}’s platform account.`,\n      platformLiable: true,\n    },\n    {\n      id: 'merchantManual',\n      label: 'Merchant’s own configured rate',\n      liability: `The merchant’s. It never touched an ${brand} registration and is not ${brand}’s to remit.`,\n      platformLiable: false,\n    },\n    {\n      id: 'connectedAccountLiable',\n      label: 'Stripe Tax named the connected account liable',\n      liability: 'The connected account’s. Empty today.',\n      platformLiable: false,\n    },\n  ]\n  return buckets.map((bucket) => {\n    const figures = summary?.[bucket.id]\n    return {\n      id: bucket.id,\n      label: bucket.label,\n      liability: bucket.liability,\n      transactionCount: Number(figures?.transactionCount ?? 0),\n      grossDollars: centsToDollars(figures?.grossCents),\n      taxableSalesDollars: centsToDollars(figures?.taxableSalesCents),\n      taxCollectedDollars: centsToDollars(figures?.taxCollectedCents),\n      platformLiable: bucket.platformLiable,\n    }\n  })\n}\n\n/**\n * FACILITATED SALES BY STATE — the economic-nexus question (AGL-1956).\n *\n * The question a state asks a marketplace facilitator is \"how much did you\n * facilitate INTO this state, and in how many transactions\" — not \"how much\n * tax did you collect there\". A state the operator is not registered in\n * collects nothing by definition, which is exactly why collection cannot be\n * the measure: the states worth watching are the ones showing $0 tax and a\n * rising sales figure.\n *\n * So this SUMS the three liability buckets per jurisdiction. The rule that\n * the operator's own invoices and storefront rows are never summed still\n * holds — nothing here touches the operator's own sales; within the\n * storefront collection the buckets differ only in WHO REMITS, and a nexus\n * threshold counts the sale whoever remits it. Who remits is still carried\n * per row, because \"do we have nexus here\" and \"what do we owe here\" are\n * answered off the same rows and must not blur.\n *\n * ⚠️ A LOWER BOUND, deliberately rather than silently: `storefront-tax-record.ts`\n * files no row at all for a sale whose `taxMode` resolves to `none`, so a\n * wholly untaxed storefront sale is invisible here — the population nexus\n * detection most needs. Closing it is a write-side change recorded on\n * AGL-1956. The filing jurisdiction does not depend on any of this: a filer\n * registered where it is established has no in-state threshold left to cross.\n */\nexport function storefrontFacilitatedJurisdictionRows(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): StorefrontFacilitatedJurisdictionRow[] {\n  if (!summary) return []\n  const totals = new Map<\n    string,\n    { count: number; salesCents: number; taxCents: number; platformCents: number }\n  >()\n  const buckets: Array<[StorefrontTaxBucketRow['id'], boolean]> = [\n    ['aglynLiable', true],\n    ['merchantManual', false],\n    ['connectedAccountLiable', false],\n  ]\n  for (const [id, platformLiable] of buckets) {\n    const byJurisdiction = summary[id]?.byJurisdiction ?? {}\n    for (const [jurisdiction, figures] of Object.entries(byJurisdiction)) {\n      const entry = totals.get(jurisdiction) ?? {\n        count: 0,\n        salesCents: 0,\n        taxCents: 0,\n        platformCents: 0,\n      }\n      const taxCents = Number(figures?.taxCollectedCents ?? 0)\n      entry.count += Number(figures?.transactionCount ?? 0)\n      entry.salesCents += Number(figures?.totalSalesCents ?? 0)\n      entry.taxCents += taxCents\n      if (platformLiable) entry.platformCents += taxCents\n      totals.set(jurisdiction, entry)\n    }\n  }\n  return [...totals.entries()]\n    .map(([jurisdiction, entry]) => ({\n      jurisdiction,\n      isFilingJurisdiction: jurisdiction === filing.code,\n      transactionCount: entry.count,\n      totalSalesDollars: centsToDollars(entry.salesCents),\n      taxCollectedDollars: centsToDollars(entry.taxCents),\n      platformLiableTaxDollars: centsToDollars(entry.platformCents),\n      untaxed: entry.taxCents === 0,\n    }))\n    .sort(\n      (a, b) =>\n        // The filing jurisdiction first — it is the one obligation that does\n        // not wait on a threshold — then by the figure a threshold is\n        // actually measured against.\n        Number(b.isFilingJurisdiction) - Number(a.isFilingJurisdiction) ||\n        Number(b.totalSalesDollars) - Number(a.totalSalesDollars) ||\n        a.jurisdiction.localeCompare(b.jurisdiction),\n    )\n}\n\n/** The storefront's two tables on the return's screen. */\nfunction storefrontTables(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnSectionTable[] {\n  const brand = PLATFORM_BRAND_NAME\n  return [\n    {\n      // Split by who owes it, never summed — one \"storefront tax\" total would\n      // merge two facts into a number that is true of neither.\n      columns: [\n        { label: 'Bucket' },\n        { label: 'Sales', numeric: true },\n        { label: 'Gross', numeric: true, money: true },\n        { label: 'Taxable sales', numeric: true, money: true },\n        { label: 'Tax collected', numeric: true, money: true },\n      ],\n      rows: storefrontBucketRows(summary).map((row) => ({\n        key: row.id,\n        cells: [\n          {\n            text: row.label,\n            caption: row.liability,\n            ...(row.platformLiable\n              ? { tag: { label: `${brand} holds this`, tone: 'attention' as const } }\n              : {}),\n          },\n          { text: String(row.transactionCount) },\n          { text: `$${row.grossDollars}` },\n          { text: `$${row.taxableSalesDollars}` },\n          { text: `$${row.taxCollectedDollars}`, strong: row.platformLiable },\n        ],\n      })),\n      empty: 'This period’s response carries no storefront figures.',\n    },\n    {\n      heading: 'Facilitated sales by buyer state',\n      description:\n        `What ${brand} facilitated into each state, whoever remits the ` +\n        'tax — the figure an economic-nexus threshold is measured ' +\n        `against. ${filing.code} needs no threshold: the filer is ` +\n        'established there, so the obligation is unconditional. A ' +\n        'region showing sales and no tax is the one to watch.',\n      columns: [\n        { label: 'Buyer state' },\n        { label: 'Sales', numeric: true },\n        { label: 'Total sales', numeric: true, money: true },\n        { label: 'Tax collected', numeric: true, money: true },\n        { label: `Of which ${brand} owes`, numeric: true, money: true },\n      ],\n      rows: storefrontFacilitatedJurisdictionRows(summary, filing).map((row) => ({\n        key: row.jurisdiction,\n        cells: [\n          {\n            text: row.jurisdiction === 'unknown' ? 'Not stated' : row.jurisdiction,\n            ...(row.isFilingJurisdiction\n              ? { tag: { label: 'Registered', tone: 'attention' as const } }\n              : row.untaxed\n                ? { tag: { label: 'No tax collected', tone: 'neutral' as const } }\n                : {}),\n          },\n          { text: String(row.transactionCount) },\n          { text: `$${row.totalSalesDollars}` },\n          { text: `$${row.taxCollectedDollars}` },\n          {\n            text: `$${row.platformLiableTaxDollars}`,\n            strong: Number(row.platformLiableTaxDollars) > 0,\n          },\n        ],\n      })),\n      empty: 'No storefront sales recorded in this period.',\n      footnote:\n        'A LOWER BOUND. A storefront sale that collected no tax at ' +\n        'all files no row, so it is missing here — which is exactly ' +\n        'the population a nexus check wants. Recorded on AGL-1956.',\n    },\n  ]\n}\n\n/**\n * The storefront's blocks of the working-papers export: the nexus figures\n * beside the operator's own sales by jurisdiction — a different taxpayer's\n * money and never summed with them — and the liability buckets after the\n * working papers.\n */\nfunction storefrontExports(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnExportBlock[] {\n  const brand = PLATFORM_BRAND_NAME\n  const facilitated = storefrontFacilitatedJurisdictionRows(summary, filing)\n  return [\n    {\n      placement: 'jurisdictions',\n      rows: [\n        ['Facilitated sales by buyer state (merchants’ storefronts)'],\n        [\n          'Buyer state',\n          'Sales',\n          'Total sales (USD)',\n          'Tax collected (USD)',\n          `Of which ${brand} owes (USD)`,\n        ],\n        ...(facilitated.length\n          ? facilitated.map((row) => [\n              row.jurisdiction,\n              String(row.transactionCount),\n              row.totalSalesDollars,\n              row.taxCollectedDollars,\n              row.platformLiableTaxDollars,\n            ])\n          : [['—', '0', '0.00', '0.00', '0.00']]),\n        [\n          'LOWER BOUND — a storefront sale that collected no tax files no row, ' +\n            `so it is absent here. ${filing.code} needs no threshold: the filer ` +\n            'is established there.',\n        ],\n      ],\n    },\n    {\n      placement: 'sections',\n      rows: [\n        [\n          'Storefront commerce tax by liability (AGL-1904) — NOT in ' +\n            (filing.form === 'tx-webfile' ? 'the Webfile figures' : 'the breakdown above'),\n        ],\n        [\n          'Bucket',\n          'Who owes it',\n          'Transactions',\n          'Gross (USD)',\n          'Taxable sales (USD)',\n          'Tax collected (USD)',\n        ],\n        ...storefrontBucketRows(summary).map((row) => [\n          row.label,\n          row.liability,\n          String(row.transactionCount),\n          row.grossDollars,\n          row.taxableSalesDollars,\n          row.taxCollectedDollars,\n        ]),\n      ],\n    },\n  ]\n}\n\n/** One storefront row as the working papers carry it. */\nfunction projectRow(row: StorefrontTaxReturnRowInput): StorefrontTaxRow {\n  return {\n    id: row.id,\n    hostId: typeof row.hostId === 'string' ? row.hostId : null,\n    orgId: row.orgId ?? null,\n    paidAt: asRowDate(row.paidAt)?.toISOString() ?? null,\n    taxMode: typeof row.taxMode === 'string' ? row.taxMode : null,\n    taxLiability: typeof row.taxLiability === 'string' ? row.taxLiability : null,\n    grossCents: Number(row.grossCents ?? 0),\n    taxCents: Number(row.taxCents ?? 0),\n    taxableSalesCents: (Array.isArray(row.taxLines) ? row.taxLines : [])\n      .map((line) => Number(line?.taxableAmountCents ?? 0))\n      .reduce((sum, base) => sum + (Number.isFinite(base) ? base : 0), 0),\n    state: typeof row.customerAddress?.state === 'string' ? row.customerAddress.state : null,\n    country:\n      typeof row.customerAddress?.country === 'string' ? row.customerAddress.country : null,\n  }\n}\n\n/**\n * The storefront's answer for one period, from rows already read. Pure, so\n * the section a preparer reads can be proved from fixtures.\n */\nexport function storefrontTaxReturnAnswer(\n  read: {\n    rows: readonly StorefrontTaxReturnRowInput[]\n    truncated: boolean\n    undatedRows: number\n  },\n  request: TaxReturnSourceRequest,\n): TaxReturnSourceAnswer {\n  const brand = PLATFORM_BRAND_NAME\n  const { filing } = request\n  const summary = storefrontTaxSummary(read.rows, request)\n  return {\n    id: 'storefront',\n    name: 'Storefront',\n    title: 'Storefront commerce tax — merchants’ sales',\n    help:\n      'Tax charged to shoppers on merchants’ storefronts, split by who owes it. None of it is in the filing figures above.',\n    intro:\n      `None of this is in the ${\n        filing.form === 'tx-webfile' ? 'Webfile' : 'breakdown'\n      } figures above, which sum ` +\n      `${brand}’s OWN sales only. The first row is the one that ` +\n      `needs a decision: those sessions are created on ${brand}’s ` +\n      `platform account, so Stripe computed that tax against ` +\n      `${brand}’s registrations and it settled into ${brand}’s balance.`,\n    truncated: read.truncated,\n    undatedRows: read.undatedRows,\n    findings: storefrontTaxFindings(summary, filing),\n    filingLines: storefrontFilingLines(summary, filing),\n    tables: storefrontTables(summary, filing),\n    figures: [],\n    exports: storefrontExports(summary, filing),\n    summary,\n    rows: read.rows.map(projectRow),\n  }\n}\n\n/**\n * The storefront's source, registered on the console's API surface: the\n * staff return awaits that surface before it asks.\n *\n * Two queries, and the second is the honesty check: the period query ranges\n * on `paidAt`, and a Firestore range query CANNOT match a document whose\n * field is null — so a row that failed to date itself would be invisible to\n * every period. The equality probe counts those rows, over all of them, and\n * the platform blocks the return on any.\n */\nexport const commerceTaxReturnSource: TaxReturnSource = {\n  async read(request) {\n    const collection = firebaseAdmin.app().firestore().collection('storefrontTaxCollected')\n    const [inPeriod, undated] = await Promise.all([\n      collection\n        .where('paidAt', '>=', request.start)\n        .where('paidAt', '<', request.end)\n        .limit(request.rowCap + 1)\n        .get(),\n      collection.where('paidAt', '==', null).count().get(),\n    ])\n    const rows: StorefrontTaxReturnRowInput[] = inPeriod.docs\n      .slice(0, request.rowCap)\n      .map((doc) => ({\n        id: doc.id,\n        ...(doc.data() as Omit<StorefrontTaxReturnRowInput, 'id'>),\n      }))\n    return storefrontTaxReturnAnswer(\n      {\n        rows,\n        truncated: inPeriod.size > request.rowCap,\n        undatedRows: Number(undated.data().count ?? 0),\n      },\n      request,\n    )\n  },\n}\n"],"names":["firebaseAdmin","PLATFORM_BRAND_NAME","asRowDate","centsToDollars","storefrontTaxSummary","storefrontPlatformLiableCents","summary","filing","figures","aglynLiable","byJurisdiction","code","cents","Number","taxCollectedCents","isFinite","merchantManualCents","merchantManual","storefrontTaxFindings","brand","id","severity","count","label","detail","figuresName","attention","rowsUnclassified","rowsMissingTaxableBase","storefrontFilingLines","platformLiable","merchant","form","item","dollars","note","storefrontBucketRows","buckets","liability","map","bucket","transactionCount","grossDollars","grossCents","taxableSalesDollars","taxableSalesCents","taxCollectedDollars","storefrontFacilitatedJurisdictionRows","totals","Map","jurisdiction","Object","entries","entry","get","salesCents","taxCents","platformCents","totalSalesCents","set","isFilingJurisdiction","totalSalesDollars","platformLiableTaxDollars","untaxed","sort","a","b","localeCompare","storefrontTables","columns","numeric","money","rows","row","key","cells","text","caption","tag","tone","String","strong","empty","heading","description","footnote","storefrontExports","facilitated","placement","length","projectRow","hostId","orgId","paidAt","toISOString","taxMode","taxLiability","Array","isArray","taxLines","line","taxableAmountCents","reduce","sum","base","state","customerAddress","country","storefrontTaxReturnAnswer","read","request","name","title","help","intro","truncated","undatedRows","findings","filingLines","tables","exports","commerceTaxReturnSource","undated","collection","app","firestore","inPeriod","Promise","all","where","start","end","limit","rowCap","docs","slice","doc","data","size"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/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 * Storefront sales on the operator's sales tax return (AGL-1904, AGL-3080).\n *\n * The operator's return sums its own invoices; this is the storefront's half\n * of it, answered through the platform's tax return source contract\n * (`@aglyn/aglyn/plugin-manager/plugin-tax-return-sources`). It reads\n * `storefrontTaxCollected` — a SEPARATE collection from the operator's own\n * invoices, queried and reported separately, because a storefront row's\n * money is mostly the merchant's while an invoice row's is the operator's.\n * Summing the two would put other companies' receipts into the return's\n * total sales, which is why they never meet in one query and never share a\n * figure.\n *\n * What it answers, all worded for the filing jurisdiction the platform\n * resolved:\n *\n *   - **The three liability buckets**, never summed — see\n *     `model/storefront-tax-summary.ts`.\n *   - **A blocking finding for the platform-liable tax** in the filing\n *     jurisdiction. Every storefront checkout is created on the platform's\n *     own account, so a `mode: 'stripe'` store's shopper is charged tax Stripe\n *     computes against the PLATFORM's registrations — measured, not inferred.\n *     That money is in the platform's balance and is NOT in the filing\n *     figures, which sum the operator's own sales only. Filing those without\n *     deciding what to do with this figure is exactly the shortfall an\n *     auditor finds. It states the mechanics and asks for a decision; it does\n *     NOT assert a marketplace-facilitator position — that attaches by\n *     operation of law and belongs to counsel, not to this report.\n *   - **Two lines beneath the filing figures** — the platform-liable tax and\n *     the merchant's own rate, stated side by side and never folded into a\n *     form item, because this report does not decide how storefront receipts\n *     are reported and adding them to one would be deciding it silently.\n *   - **Facilitated sales by buyer state** — the economic-nexus question\n *     (AGL-1956), with the three buckets SUMMED per jurisdiction on purpose:\n *     a threshold counts the sale whoever remits it. Who remits is still\n *     carried per row.\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 {\n  asRowDate,\n  centsToDollars,\n} from '@aglyn/aglyn/app-utils/tax-jurisdiction-figures'\nimport type {\n  TaxReturnExportBlock,\n  TaxReturnFiling,\n  TaxReturnFilingLine,\n  TaxReturnFinding,\n  TaxReturnSectionTable,\n  TaxReturnSource,\n  TaxReturnSourceAnswer,\n  TaxReturnSourceRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-tax-return-sources'\nimport {\n  storefrontTaxSummary,\n  type StorefrontTaxReturnRowInput,\n  type StorefrontTaxSummary,\n} from '../model/storefront-tax-summary'\nimport { readPosHardwareTaxReturn } from './pos-hardware-tax-return-source'\nimport { POS_HARDWARE_SALES_COLLECTION } from '../model/pos-hardware'\nimport {\n  posHardwareStorefrontParts,\n  storefrontRowsWithoutInPersonHardware,\n} from '../model/pos-hardware-tax-summary'\nimport { statedTaxableBase } from '../model/own-store-tax-summary'\nimport {\n  ownStoreTaxReturnAnswer,\n  readOwnStoreOrders,\n  resolveOwnStores,\n  type OwnStores,\n} from './own-store-tax-return-source'\n\n/**\n * How far either side of the period an in-person hardware record is read,\n * to meet the storefront row its register sale filed: the two are written\n * seconds apart, so a week is more than enough for either edge.\n */\nconst IN_PERSON_ROW_MARGIN_MS = 7 * 24 * 60 * 60 * 1000\n\n/** One row of the storefront listing, as the working papers carry it. */\nexport interface StorefrontTaxRow {\n  id: string\n  hostId: string | null\n  orgId: string | null\n  paidAt: string | null\n  taxMode: string | null\n  taxLiability: string | null\n  grossCents: number\n  taxCents: number\n  taxableSalesCents: number\n  state: string | null\n  country: string | null\n}\n\n/** A liability bucket, ready to print. */\nexport interface StorefrontTaxBucketRow {\n  id: 'aglynLiable' | 'merchantManual' | 'connectedAccountLiable'\n  label: string\n  /** Who owes it — the sentence that decides whether it is on this return. */\n  liability: string\n  transactionCount: number\n  grossDollars: string\n  taxableSalesDollars: string\n  taxCollectedDollars: string\n  /** True when this row is money in the platform's balance under its registration. */\n  platformLiable: boolean\n}\n\n/** One state's facilitated storefront sales, for the nexus question. */\nexport interface StorefrontFacilitatedJurisdictionRow {\n  jurisdiction: string\n  /** True for the one jurisdiction this deployment files a return in. */\n  isFilingJurisdiction: boolean\n  transactionCount: number\n  totalSalesDollars: string\n  taxCollectedDollars: string\n  /** The part of `taxCollectedDollars` the platform holds and must remit. */\n  platformLiableTaxDollars: string\n  /** True when NO tax was collected on any sale into this state. */\n  untaxed: boolean\n}\n\n/**\n * Storefront tax in the FILING jurisdiction that Stripe computed against the\n * platform's own registrations.\n *\n * The one figure that decides whether a period can be filed from the filing\n * lines alone. Deliberately excludes `merchantManual` — a merchant's own\n * configured rate never touched those registrations. Read against the\n * configured jurisdiction rather than Texas, because a hard-coded key answers\n * `0.00` everywhere else — and a zero here reads as \"nothing to decide\" on\n * the one finding that blocks filing.\n */\nexport function storefrontPlatformLiableCents(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): number {\n  const figures = summary?.aglynLiable?.byJurisdiction?.[filing.code]\n  const cents = Number(figures?.taxCollectedCents ?? 0)\n  return Number.isFinite(cents) ? cents : 0\n}\n\n/** The merchant's own configured tax in the filing jurisdiction. */\nfunction merchantManualCents(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): number {\n  return Number(\n    summary?.merchantManual?.byJurisdiction?.[filing.code]?.taxCollectedCents ?? 0,\n  )\n}\n\n/** The storefront's findings. The platform raises the non-zero ones. */\nexport function storefrontTaxFindings(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnFinding[] {\n  const brand = PLATFORM_BRAND_NAME\n  return [\n    {\n      // BLOCKING on purpose — see the module note.\n      id: 'storefrontAglynLiableTax',\n      severity: 'blocking',\n      count: storefrontPlatformLiableCents(summary, filing),\n      label: `${filing.label} storefront tax collected under ${brand}’s registration`,\n      detail:\n        'Cents. Charged to shoppers on merchants’ storefront sales, computed ' +\n        'by Stripe Tax against THE PLATFORM’s registrations (the session is ' +\n        'created on the platform account), and settled into the platform’s ' +\n        `balance. It is NOT included in ${filing.figuresName} below. Decide ` +\n        'with counsel how it is reported before filing — do not file as if ' +\n        'it were zero.',\n    },\n    {\n      id: 'storefrontUnclassified',\n      severity: 'blocking',\n      count: Number(summary?.attention?.rowsUnclassified ?? 0),\n      label: 'Storefront rows with an unrecognised tax mode',\n      detail:\n        'Not counted in any storefront bucket, so they are in no figure at ' +\n        'all. Classify them before filing.',\n    },\n    {\n      id: 'storefrontMissingTaxableBase',\n      severity: 'review',\n      count: Number(summary?.attention?.rowsMissingTaxableBase ?? 0),\n      label: 'Storefront rows with tax but no stated base',\n      detail:\n        'Tax was collected but Stripe’s taxable_amount could not be read, so ' +\n        'the storefront taxable-sales figure understates the base. Re-read ' +\n        'the session in Stripe with the tax breakdown expanded.',\n    },\n  ]\n}\n\n/**\n * The two lines beneath the filing figures: the platform-liable tax and the\n * merchant's own rate, separately, and outside every form item.\n */\nexport function storefrontFilingLines(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnFilingLine[] {\n  const brand = PLATFORM_BRAND_NAME\n  const platformLiable = centsToDollars(storefrontPlatformLiableCents(summary, filing))\n  const merchant = centsToDollars(merchantManualCents(summary, filing))\n  if (filing.form === 'tx-webfile') {\n    return [\n      {\n        item: '—',\n        label: `${filing.label} storefront tax under ${brand}’s registration (NOT in ${filing.figuresName})`,\n        dollars: platformLiable,\n        note:\n          `Collected from shoppers on merchants’ sales and held in ${brand}’s ` +\n          'balance. Excluded from every item above. Its treatment on the ' +\n          'return is a question for counsel — see AGL-1904.',\n      },\n      {\n        item: '—',\n        label: `${filing.label} storefront tax under the MERCHANT’s own rate (not ${brand}’s)`,\n        dollars: merchant,\n        note:\n          `A manual-mode store’s own configured rate. ${brand}’s registrations ` +\n          'played no part in computing it. Shown so it is visibly NOT the line ' +\n          'above — the two must never be added together.',\n      },\n    ]\n  }\n  return [\n    {\n      item: '—',\n      label: `${filing.code} storefront tax under the platform’s registration (NOT in the figures above)`,\n      dollars: platformLiable,\n      note:\n        'Collected from shoppers on merchants’ sales and held in the ' +\n        'platform’s balance. Excluded from every figure above. Its treatment ' +\n        'on the return is a question for the operator’s own counsel.',\n    },\n    {\n      item: '—',\n      label: `${filing.code} storefront tax under the MERCHANT’s own rate`,\n      dollars: merchant,\n      note:\n        'A manual-mode store’s own configured rate. The platform’s ' +\n        'registrations played no part in computing it. Shown so it is ' +\n        'visibly NOT the line above — the two must never be added together.',\n    },\n  ]\n}\n\n/** The three liability buckets, in the order a reader decides them. */\nexport function storefrontBucketRows(\n  summary: StorefrontTaxSummary,\n): StorefrontTaxBucketRow[] {\n  const brand = PLATFORM_BRAND_NAME\n  const buckets: Array<{\n    id: StorefrontTaxBucketRow['id']\n    label: string\n    liability: string\n    platformLiable: boolean\n  }> = [\n    {\n      id: 'aglynLiable',\n      label: `Computed against ${brand}’s registrations`,\n      liability: `In ${brand}’s balance. Stripe Tax computed it on ${brand}’s platform account.`,\n      platformLiable: true,\n    },\n    {\n      id: 'merchantManual',\n      label: 'Merchant’s own configured rate',\n      liability: `The merchant’s. It never touched an ${brand} registration and is not ${brand}’s to remit.`,\n      platformLiable: false,\n    },\n    {\n      id: 'connectedAccountLiable',\n      label: 'Stripe Tax named the connected account liable',\n      liability: 'The connected account’s. Empty today.',\n      platformLiable: false,\n    },\n  ]\n  return buckets.map((bucket) => {\n    const figures = summary?.[bucket.id]\n    return {\n      id: bucket.id,\n      label: bucket.label,\n      liability: bucket.liability,\n      transactionCount: Number(figures?.transactionCount ?? 0),\n      grossDollars: centsToDollars(figures?.grossCents),\n      taxableSalesDollars: centsToDollars(figures?.taxableSalesCents),\n      taxCollectedDollars: centsToDollars(figures?.taxCollectedCents),\n      platformLiable: bucket.platformLiable,\n    }\n  })\n}\n\n/**\n * FACILITATED SALES BY STATE — the economic-nexus question (AGL-1956).\n *\n * The question a state asks a marketplace facilitator is \"how much did you\n * facilitate INTO this state, and in how many transactions\" — not \"how much\n * tax did you collect there\". A state the operator is not registered in\n * collects nothing by definition, which is exactly why collection cannot be\n * the measure: the states worth watching are the ones showing $0 tax and a\n * rising sales figure.\n *\n * So this SUMS the three liability buckets per jurisdiction. The rule that\n * the operator's own invoices and storefront rows are never summed still\n * holds — nothing here touches the operator's own sales; within the\n * storefront collection the buckets differ only in WHO REMITS, and a nexus\n * threshold counts the sale whoever remits it. Who remits is still carried\n * per row, because \"do we have nexus here\" and \"what do we owe here\" are\n * answered off the same rows and must not blur.\n *\n * ⚠️ A LOWER BOUND, deliberately rather than silently: `storefront-tax-record.ts`\n * files no row at all for a sale whose `taxMode` resolves to `none`, so a\n * wholly untaxed storefront sale is invisible here — the population nexus\n * detection most needs. Closing it is a write-side change recorded on\n * AGL-1956. The filing jurisdiction does not depend on any of this: a filer\n * registered where it is established has no in-state threshold left to cross.\n */\nexport function storefrontFacilitatedJurisdictionRows(\n  summary: StorefrontTaxSummary | null | undefined,\n  filing: TaxReturnFiling,\n): StorefrontFacilitatedJurisdictionRow[] {\n  if (!summary) return []\n  const totals = new Map<\n    string,\n    { count: number; salesCents: number; taxCents: number; platformCents: number }\n  >()\n  const buckets: Array<[StorefrontTaxBucketRow['id'], boolean]> = [\n    ['aglynLiable', true],\n    ['merchantManual', false],\n    ['connectedAccountLiable', false],\n  ]\n  for (const [id, platformLiable] of buckets) {\n    const byJurisdiction = summary[id]?.byJurisdiction ?? {}\n    for (const [jurisdiction, figures] of Object.entries(byJurisdiction)) {\n      const entry = totals.get(jurisdiction) ?? {\n        count: 0,\n        salesCents: 0,\n        taxCents: 0,\n        platformCents: 0,\n      }\n      const taxCents = Number(figures?.taxCollectedCents ?? 0)\n      entry.count += Number(figures?.transactionCount ?? 0)\n      entry.salesCents += Number(figures?.totalSalesCents ?? 0)\n      entry.taxCents += taxCents\n      if (platformLiable) entry.platformCents += taxCents\n      totals.set(jurisdiction, entry)\n    }\n  }\n  return [...totals.entries()]\n    .map(([jurisdiction, entry]) => ({\n      jurisdiction,\n      isFilingJurisdiction: jurisdiction === filing.code,\n      transactionCount: entry.count,\n      totalSalesDollars: centsToDollars(entry.salesCents),\n      taxCollectedDollars: centsToDollars(entry.taxCents),\n      platformLiableTaxDollars: centsToDollars(entry.platformCents),\n      untaxed: entry.taxCents === 0,\n    }))\n    .sort(\n      (a, b) =>\n        // The filing jurisdiction first — it is the one obligation that does\n        // not wait on a threshold — then by the figure a threshold is\n        // actually measured against.\n        Number(b.isFilingJurisdiction) - Number(a.isFilingJurisdiction) ||\n        Number(b.totalSalesDollars) - Number(a.totalSalesDollars) ||\n        a.jurisdiction.localeCompare(b.jurisdiction),\n    )\n}\n\n/** The storefront's two tables on the return's screen. */\nfunction storefrontTables(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnSectionTable[] {\n  const brand = PLATFORM_BRAND_NAME\n  return [\n    {\n      // Split by who owes it, never summed — one \"storefront tax\" total would\n      // merge two facts into a number that is true of neither.\n      columns: [\n        { label: 'Bucket' },\n        { label: 'Sales', numeric: true },\n        { label: 'Gross', numeric: true, money: true },\n        { label: 'Taxable sales', numeric: true, money: true },\n        { label: 'Tax collected', numeric: true, money: true },\n      ],\n      rows: storefrontBucketRows(summary).map((row) => ({\n        key: row.id,\n        cells: [\n          {\n            text: row.label,\n            caption: row.liability,\n            ...(row.platformLiable\n              ? { tag: { label: `${brand} holds this`, tone: 'attention' as const } }\n              : {}),\n          },\n          { text: String(row.transactionCount) },\n          { text: `$${row.grossDollars}` },\n          { text: `$${row.taxableSalesDollars}` },\n          { text: `$${row.taxCollectedDollars}`, strong: row.platformLiable },\n        ],\n      })),\n      empty: 'This period’s response carries no storefront figures.',\n    },\n    {\n      heading: 'Facilitated sales by buyer state',\n      description:\n        `What ${brand} facilitated into each state, whoever remits the ` +\n        'tax — the figure an economic-nexus threshold is measured ' +\n        `against. ${filing.code} needs no threshold: the filer is ` +\n        'established there, so the obligation is unconditional. A ' +\n        'region showing sales and no tax is the one to watch.',\n      columns: [\n        { label: 'Buyer state' },\n        { label: 'Sales', numeric: true },\n        { label: 'Total sales', numeric: true, money: true },\n        { label: 'Tax collected', numeric: true, money: true },\n        { label: `Of which ${brand} owes`, numeric: true, money: true },\n      ],\n      rows: storefrontFacilitatedJurisdictionRows(summary, filing).map((row) => ({\n        key: row.jurisdiction,\n        cells: [\n          {\n            text: row.jurisdiction === 'unknown' ? 'Not stated' : row.jurisdiction,\n            ...(row.isFilingJurisdiction\n              ? { tag: { label: 'Registered', tone: 'attention' as const } }\n              : row.untaxed\n                ? { tag: { label: 'No tax collected', tone: 'neutral' as const } }\n                : {}),\n          },\n          { text: String(row.transactionCount) },\n          { text: `$${row.totalSalesDollars}` },\n          { text: `$${row.taxCollectedDollars}` },\n          {\n            text: `$${row.platformLiableTaxDollars}`,\n            strong: Number(row.platformLiableTaxDollars) > 0,\n          },\n        ],\n      })),\n      empty: 'No storefront sales recorded in this period.',\n      footnote:\n        'A LOWER BOUND. A storefront sale that collected no tax at ' +\n        'all files no row, so it is missing here — which is exactly ' +\n        'the population a nexus check wants. Recorded on AGL-1956.',\n    },\n  ]\n}\n\n/**\n * The storefront's blocks of the working-papers export: the nexus figures\n * beside the operator's own sales by jurisdiction — a different taxpayer's\n * money and never summed with them — and the liability buckets after the\n * working papers.\n */\nfunction storefrontExports(\n  summary: StorefrontTaxSummary,\n  filing: TaxReturnFiling,\n): TaxReturnExportBlock[] {\n  const brand = PLATFORM_BRAND_NAME\n  const facilitated = storefrontFacilitatedJurisdictionRows(summary, filing)\n  return [\n    {\n      placement: 'jurisdictions',\n      rows: [\n        ['Facilitated sales by buyer state (merchants’ storefronts)'],\n        [\n          'Buyer state',\n          'Sales',\n          'Total sales (USD)',\n          'Tax collected (USD)',\n          `Of which ${brand} owes (USD)`,\n        ],\n        ...(facilitated.length\n          ? facilitated.map((row) => [\n              row.jurisdiction,\n              String(row.transactionCount),\n              row.totalSalesDollars,\n              row.taxCollectedDollars,\n              row.platformLiableTaxDollars,\n            ])\n          : [['—', '0', '0.00', '0.00', '0.00']]),\n        [\n          'LOWER BOUND — a storefront sale that collected no tax files no row, ' +\n            `so it is absent here. ${filing.code} needs no threshold: the filer ` +\n            'is established there.',\n        ],\n      ],\n    },\n    {\n      placement: 'sections',\n      rows: [\n        [\n          'Storefront commerce tax by liability (AGL-1904) — NOT in ' +\n            (filing.form === 'tx-webfile' ? 'the Webfile figures' : 'the breakdown above'),\n        ],\n        [\n          'Bucket',\n          'Who owes it',\n          'Transactions',\n          'Gross (USD)',\n          'Taxable sales (USD)',\n          'Tax collected (USD)',\n        ],\n        ...storefrontBucketRows(summary).map((row) => [\n          row.label,\n          row.liability,\n          String(row.transactionCount),\n          row.grossDollars,\n          row.taxableSalesDollars,\n          row.taxCollectedDollars,\n        ]),\n      ],\n    },\n  ]\n}\n\n/** One storefront row as the working papers carry it. */\nfunction projectRow(row: StorefrontTaxReturnRowInput): StorefrontTaxRow {\n  return {\n    id: row.id,\n    hostId: typeof row.hostId === 'string' ? row.hostId : null,\n    orgId: row.orgId ?? null,\n    paidAt: asRowDate(row.paidAt)?.toISOString() ?? null,\n    taxMode: typeof row.taxMode === 'string' ? row.taxMode : null,\n    taxLiability: typeof row.taxLiability === 'string' ? row.taxLiability : null,\n    grossCents: Number(row.grossCents ?? 0),\n    taxCents: Number(row.taxCents ?? 0),\n    taxableSalesCents: (Array.isArray(row.taxLines) ? row.taxLines : [])\n      .map((line) => Number(line?.taxableAmountCents ?? 0))\n      .reduce((sum, base) => sum + (Number.isFinite(base) ? base : 0), 0),\n    state: typeof row.customerAddress?.state === 'string' ? row.customerAddress.state : null,\n    country:\n      typeof row.customerAddress?.country === 'string' ? row.customerAddress.country : null,\n  }\n}\n\n/**\n * The storefront's answer for one period, from rows already read. Pure, so\n * the section a preparer reads can be proved from fixtures.\n */\nexport function storefrontTaxReturnAnswer(\n  read: {\n    rows: readonly StorefrontTaxReturnRowInput[]\n    truncated: boolean\n    undatedRows: number\n    /** Rows of the operator's own stores, which their own card folds in instead (AGL-4038). */\n    ownStoreRows?: number\n  },\n  request: TaxReturnSourceRequest,\n): TaxReturnSourceAnswer {\n  const brand = PLATFORM_BRAND_NAME\n  const { filing } = request\n  const summary = storefrontTaxSummary(read.rows, request)\n  return {\n    id: 'storefront',\n    name: 'Storefront',\n    title: 'Storefront commerce tax — merchants’ sales',\n    help:\n      'Tax charged to shoppers on merchants’ storefronts, split by who owes it. None of it is in the filing figures above.',\n    intro:\n      `None of this is in the ${\n        filing.form === 'tx-webfile' ? 'Webfile' : 'breakdown'\n      } figures above, which sum ` +\n      `${brand}’s OWN sales only. The first row is the one that ` +\n      `needs a decision: those sessions are created on ${brand}’s ` +\n      `platform account, so Stripe computed that tax against ` +\n      `${brand}’s registrations and it settled into ${brand}’s balance.`,\n    truncated: read.truncated,\n    undatedRows: read.undatedRows,\n    findings: storefrontTaxFindings(summary, filing),\n    filingLines: storefrontFilingLines(summary, filing),\n    tables: storefrontTables(summary, filing),\n    figures: read.ownStoreRows\n      ? [\n          {\n            label: `Rows of ${brand}’s own stores`,\n            value: String(read.ownStoreRows),\n            note: `${brand}’s own sales, not a merchant’s: on the own stores card and folded into the filing figures, never here.`,\n          },\n        ]\n      : [],\n    exports: storefrontExports(summary, filing),\n    summary,\n    rows: read.rows.map(projectRow),\n  }\n}\n\n/**\n * Commerce's source, registered on the console's API surface: the staff\n * return awaits that surface before it asks. It answers three sections, one\n * per kind of sale commerce records apart:\n *\n *   - the storefront's FACILITATED sales — merchants' money (below);\n *   - the POS hardware shop's, the operator's own\n *     (`pos-hardware-tax-return-source.ts`, AGL-4038);\n *   - the operator's own stores', its own too (`own-store-tax-return-source.ts`,\n *     AGL-4038).\n *\n * The operator's own stores are resolved FIRST, because each of the others\n * leaves their sales to the third: the storefront drops their tax rows (and\n * hands their stated bases over), and the hardware section folds in no\n * reader sold at their registers. So every sale is counted once. Any read\n * failing refuses all three, so a half-read commerce never reads as a\n * complete one.\n */\nexport const commerceTaxReturnSource: TaxReturnSource = {\n  async read(request) {\n    const own = await resolveOwnStores()\n    const ownHostIds = new Set(own.stores.map((store) => store.hostId))\n    const [storefrontRead, hardware, ownOrders] = await Promise.all([\n      readStorefrontTaxRows(request),\n      readPosHardwareTaxReturn(request, { ownHostIds }),\n      readOwnStoreOrders(request, own.stores),\n    ])\n    const isOwn = (row: StorefrontTaxReturnRowInput) => isOwnStoreRow(row, own)\n    const ownRows = storefrontRead.rows.filter(isOwn)\n    const storefront = storefrontTaxReturnAnswer(\n      { ...storefrontRead, rows: storefrontRead.rows.filter((row) => !isOwn(row)), ownStoreRows: ownRows.length },\n      request,\n    )\n    // The base Stripe stated on an own store's online sale, by its order id\n    // (an online order is keyed by its Checkout Session, as its row is).\n    const statedBases = new Map<string, number>()\n    for (const row of ownRows) {\n      const base = statedTaxableBase(Array.isArray(row.taxLines) ? row.taxLines : [])\n      if (base !== null) statedBases.set(row.id, base)\n    }\n    const ownStores = ownStoreTaxReturnAnswer({ own, read: ownOrders, statedBases }, request)\n    return [storefront, hardware, ownStores]\n  },\n}\n\n/** Whether a storefront tax row is one of the operator's own stores' (AGL-4038). */\nexport function isOwnStoreRow(\n  row: Pick<StorefrontTaxReturnRowInput, 'hostId' | 'orgId'>,\n  own: OwnStores,\n): boolean {\n  if (typeof row.hostId === 'string' && own.stores.some((store) => store.hostId === row.hostId)) return true\n  return Boolean(own.orgId) && row.orgId === own.orgId\n}\n\n/**\n * The storefront's section.\n *\n * Two queries, and the second is the honesty check: the period query ranges\n * on `paidAt`, and a Firestore range query CANNOT match a document whose\n * field is null — so a row that failed to date itself would be invisible to\n * every period. The equality probe counts those rows, over all of them, and\n * the platform blocks the return on any.\n */\nexport async function readStorefrontTaxReturn(\n  request: TaxReturnSourceRequest,\n): Promise<TaxReturnSourceAnswer> {\n  return storefrontTaxReturnAnswer(await readStorefrontTaxRows(request), request)\n}\n\n/** The storefront's rows for the period, before any is set aside. See {@link readStorefrontTaxReturn}. */\nexport async function readStorefrontTaxRows(request: TaxReturnSourceRequest): Promise<{\n  rows: StorefrontTaxReturnRowInput[]\n  truncated: boolean\n  undatedRows: number\n}> {\n  const firestore = firebaseAdmin.app().firestore()\n  const collection = firestore.collection('storefrontTaxCollected')\n  const [inPeriod, undated, inPerson] = await Promise.all([\n    collection\n      .where('paidAt', '>=', request.start)\n      .where('paidAt', '<', request.end)\n      .limit(request.rowCap + 1)\n      .get(),\n    collection.where('paidAt', '==', null).count().get(),\n    // The platform's own in-person hardware sales around the period\n    // (AGL-4038): the hardware section counts them, so their part of the\n    // register sale's storefront row comes out here (`posHardwareSales`\n    // `source, paidAtMs`).\n    firestore\n      .collection(POS_HARDWARE_SALES_COLLECTION)\n      .where('source', '==', 'in_person')\n      .where('paidAtMs', '>=', request.start.getTime() - IN_PERSON_ROW_MARGIN_MS)\n      .where('paidAtMs', '<', request.end.getTime() + IN_PERSON_ROW_MARGIN_MS)\n      .limit(request.rowCap)\n      .get(),\n  ])\n  const rows: StorefrontTaxReturnRowInput[] = storefrontRowsWithoutInPersonHardware(\n    inPeriod.docs.slice(0, request.rowCap).map((doc) => ({\n      id: doc.id,\n      ...(doc.data() as Omit<StorefrontTaxReturnRowInput, 'id'>),\n    })),\n    posHardwareStorefrontParts(inPerson.docs.map((doc) => doc.data())),\n  )\n  return {\n    rows,\n    truncated: inPeriod.size > request.rowCap,\n    undatedRows: Number(undated.data().count ?? 0),\n  }\n}\n"],"names":["firebaseAdmin","PLATFORM_BRAND_NAME","asRowDate","centsToDollars","storefrontTaxSummary","readPosHardwareTaxReturn","POS_HARDWARE_SALES_COLLECTION","posHardwareStorefrontParts","storefrontRowsWithoutInPersonHardware","statedTaxableBase","ownStoreTaxReturnAnswer","readOwnStoreOrders","resolveOwnStores","IN_PERSON_ROW_MARGIN_MS","storefrontPlatformLiableCents","summary","filing","figures","aglynLiable","byJurisdiction","code","cents","Number","taxCollectedCents","isFinite","merchantManualCents","merchantManual","storefrontTaxFindings","brand","id","severity","count","label","detail","figuresName","attention","rowsUnclassified","rowsMissingTaxableBase","storefrontFilingLines","platformLiable","merchant","form","item","dollars","note","storefrontBucketRows","buckets","liability","map","bucket","transactionCount","grossDollars","grossCents","taxableSalesDollars","taxableSalesCents","taxCollectedDollars","storefrontFacilitatedJurisdictionRows","totals","Map","jurisdiction","Object","entries","entry","get","salesCents","taxCents","platformCents","totalSalesCents","set","isFilingJurisdiction","totalSalesDollars","platformLiableTaxDollars","untaxed","sort","a","b","localeCompare","storefrontTables","columns","numeric","money","rows","row","key","cells","text","caption","tag","tone","String","strong","empty","heading","description","footnote","storefrontExports","facilitated","placement","length","projectRow","hostId","orgId","paidAt","toISOString","taxMode","taxLiability","Array","isArray","taxLines","line","taxableAmountCents","reduce","sum","base","state","customerAddress","country","storefrontTaxReturnAnswer","read","request","name","title","help","intro","truncated","undatedRows","findings","filingLines","tables","ownStoreRows","value","exports","commerceTaxReturnSource","own","ownHostIds","Set","stores","store","storefrontRead","hardware","ownOrders","Promise","all","readStorefrontTaxRows","isOwn","isOwnStoreRow","ownRows","filter","storefront","statedBases","ownStores","some","Boolean","readStorefrontTaxReturn","undated","firestore","app","collection","inPeriod","inPerson","where","start","end","limit","rowCap","getTime","docs","slice","doc","data","size"],"mappings":"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"}

package/src/lib/server.js

@@ -266,6 +266,83 @@ registerPluginJob({
         }
     }
 });
+/**
+ * The monthly 4G charge for Stripe Reader S710s (AGL-4038): each workspace
+ * whose readers had 4G in the month just ended is charged once, through
+ * core's usage-invoice charge. Every six hours, so the charge goes out early
+ * on the 1st and one that could not reach Stripe is tried again the same
+ * day; a month already settled costs a read per workspace. Nothing runs
+ * where 4G is not offered (`POS_CELLULAR_MONTHLY_COST_CENTS` unset).
+ * Per-host: a store locked for security or abuse is not charged while it is.
+ */ registerPluginJob({
+    pluginId: BUNDLE_ID,
+    name: 'pos-cellular-billing',
+    intervalMinutes: 6 * 60,
+    description: 'Charge each workspace for 4G on its Stripe Reader S710s for the month just ended, once (AGL-4038).',
+    lockdown: {
+        scope: 'per-host'
+    },
+    handler: async (gate)=>{
+        if (!process.env.STRIPE_SECRET_KEY || !process.env.POS_CELLULAR_MONTHLY_COST_CENTS) return;
+        const { runPosCellularBilling } = await import("./server/pos-cellular-billing.js");
+        const report = await runPosCellularBilling(gate);
+        if (report.workspaces || report.storesGone || report.warned || report.turnedOff || report.paidLate) {
+            console.info(`commerce: 4G for ${report.month} — ${report.paid} paid, ${report.open} left open, ` + `${report.failed} not reached, ${report.unbillable} not billable, ${report.deferred} deferred, ` + `${report.storesGone} deleted stores turned off; unpaid charges: ${report.warned} warned, ` + `${report.paidLate} paid since, ${report.turnedOff} turned off`);
+        }
+    }
+});
+/**
+ * Card reader start-up screens (AGL-4048) that went stale with nobody opening
+ * the POS devices card: a logo changed on the organization profile or the
+ * white-label brand, or the logo's file replaced in the media library. Every
+ * 15 minutes, like the recovery pair: a store whose screen did not move costs
+ * a few reads and no Stripe call, and nothing a merchant saves waits on it.
+ * A screen Stripe refused is retried after six hours here, and at once when
+ * the card is opened.
+ */ registerPluginJob({
+    pluginId: BUNDLE_ID,
+    name: 'pos-reader-splash-refresh',
+    intervalMinutes: RECOVERY_JOB_INTERVAL_MINUTES,
+    description: 'Bring card reader start-up screens up to date after a logo change (AGL-4048).',
+    lockdown: {
+        scope: 'per-host'
+    },
+    handler: async (gate)=>{
+        if (!process.env.STRIPE_SECRET_KEY) return;
+        const { refreshPosReaderSplashes } = await import("./server/pos-reader-splash.js");
+        const result = await refreshPosReaderSplashes(gate);
+        if (result.applied || result.failed || result.more) {
+            console.info(`commerce: reader start-up screens — ${result.applied} updated, ` + `${result.failed} failed${result.more ? ', more stores than one pass reaches' : ''}`);
+        }
+    }
+});
+/**
+ * Cards taken offline whose sale never synced (AGL-4039).
+ *
+ * HOURLY. The alert falls due six hours after the intent was first seen, and
+ * Stripe's authorization lasts about two days, so an hour's delay costs
+ * nothing and leaves the beat one collection-group range read that is empty in
+ * the ordinary case. It never captures: without the sale there is no fee to
+ * capture with, so it tells the operator and the site's managers instead.
+ *
+ * Not gated on `isEmailConfigured()`: the console notification and the
+ * operator alert both work without mail.
+ */ registerPluginJob({
+    pluginId: BUNDLE_ID,
+    name: 'offline-card-unsynced',
+    intervalMinutes: 60,
+    description: 'Tell the operator and the site when a card taken offline reached Stripe but its sale never synced (AGL-4039).',
+    lockdown: {
+        scope: 'per-host'
+    },
+    handler: async (gate)=>{
+        const { scanUnsyncedOfflineCards } = await import("./server/pos-offline-card-reconcile.js");
+        const scan = await scanUnsyncedOfflineCards(gate);
+        if (scan.alerted) {
+            console.warn(`commerce: ${scan.alerted} cards taken offline have no synced sale`);
+        }
+    }
+});
 /**
  * A visitor's payment door: it opens a Stripe Checkout Session for whoever
  * calls it, so the dispatcher holds it to the card-testing counters
@@ -435,6 +512,11 @@ registerPluginJob({
     // (AGL-4046): availability re-asked inside the transaction that writes, so
     // two staff cannot hand out the last unit at once. Loaded on first call.
     registerPluginApiRoute('commerce/reservations/walk-in', async (req, res)=>(await import("./server/reservation-walk-in.js")).reservationWalkInHandler(req, res));
+    // A stay's guest count after it is booked (AGL-4043), from the Reservations
+    // card and the check-in screen: the walk-in's gate, and the stay's
+    // check-ins for today on brought in line in the same transaction. Loaded
+    // on first call.
+    registerPluginApiRoute('commerce/reservations/guests', async (req, res)=>(await import("./server/reservation-guests.js")).reservationGuestsHandler(req, res));
     // The products list's Duplicate and Delete for the native apps (AGL-3841):
     // the console's own copy and soft delete, with the site-wide cache drop.
     registerPluginApiRoute('commerce/products/duplicate', async (req, res)=>(await import("./server/products-write.js")).productDuplicateHandler(req, res));
@@ -502,13 +584,29 @@ registerPluginJob({
     // and order list, gated like a sale and hidden until the deployment prices
     // it; and the staff page's orders, which name no site. Loaded on first call.
     registerPluginApiRoute('commerce/pos-hardware', async (req, res)=>(await import("./server/pos-hardware.js")).posHardwareHandler(req, res));
+    // Selling a card reader in person at the platform's own store's register
+    // (AGL-4038): whether this store is that seller. Gated like a sale, and
+    // silent about the configuration on every other store. Loaded on first call.
+    registerPluginApiRoute('commerce/pos-hardware-sale', async (req, res)=>(await import("./server/pos-hardware-sale.js")).posHardwareSaleHandler(req, res));
     // A store's card reader start-up screen (AGL-4048): the POS devices card's
-    // setting, gated like a sale, and the staff page's platform default. Both
-    // draw images, so each loads with its first call.
+    // setting, gated like a sale, and the staff page's platform default. Each
+    // loads with its first call; the drawing they ask for is the images
+    // route's, below.
     registerPluginApiRoute('commerce/pos-reader-splash', async (req, res)=>(await import("./server/pos-reader-splash.js")).posReaderSplashHandler(req, res));
     registerPluginApiRoute('commerce/admin/reader-splash', {
         web: async (request)=>(await import("./server/pos-reader-splash-admin.js")).posReaderSplashAdmin(request)
     });
+    // The image work behind both (AGL-4048): drawing a screen and reading an
+    // uploaded one take `sharp`, whose native library only the console's
+    // plugins' image function ships (`/api/plugin-images/…`), so the plugin
+    // API's function does not carry it. Called by our own servers, signed; a
+    // machine's door.
+    registerPluginApiRoute('commerce/pos-reader-splash-images', {
+        web: async (request)=>(await import("./server/pos-reader-splash-images-route.js")).posReaderSplashImagesRoute(request)
+    }, {
+        machine: true,
+        images: true
+    });
     registerPluginApiRoute('commerce/admin/hardware-orders', {
         web: async (request)=>(await import("./server/pos-hardware-admin.js")).posHardwareAdminOrders(request)
     });