@aglyn/plugins-commerce 1.0.0-beta.260 → 1.0.0-beta.262

package/src/lib/printing/product-labels.js

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -37,10 +38,46 @@ export function labelSize(id) {
     return (_LABEL_SIZES_find = LABEL_SIZES.find((size)=>size.id === id)) != null ? _LABEL_SIZES_find : LABEL_SIZES[0];
 }
 const copiesOf = (label)=>Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(label.copies) || 0)));
-const priceText = (label)=>{
+const priceText = (label)=>labelPriceText(label);
+/**
+ * The labels a product prints: one row per variant, its options as the
+ * detail, its price and the code the register looks up (the barcode, else
+ * the SKU). A row with no code prints nothing until one is added. One copy
+ * each to start; the person changes the counts before printing.
+ */ export function productLabelRows(product) {
+    return product.variants.map((variant)=>{
+        var _variant_options;
+        const options = Object.values((_variant_options = variant.options) != null ? _variant_options : {}).filter(Boolean);
+        return _extends({
+            variantId: variant.id,
+            name: product.name
+        }, options.length ? {
+            detail: options.join(' / ')
+        } : {}, Number.isFinite(Number(variant.priceUsd)) ? {
+            priceCents: Math.round(Number(variant.priceUsd) * 100)
+        } : {}, {
+            currency: 'usd',
+            code: String(variant.barcode || variant.sku || '').trim(),
+            copies: 1
+        });
+    });
+}
+/** The rows that print: a code and at least one copy, each count kept within {@link MAX_LABEL_COPIES}. */ export function printableLabelRows(rows) {
+    return rows.filter((row)=>row.code && copiesOf(row) > 0);
+}
+/** How many labels the rows print in all. */ export function labelCopiesTotal(rows) {
+    return printableLabelRows(rows).reduce((sum, row)=>sum + copiesOf(row), 0);
+}
+/** A typed copy count as the dialog keeps it: whole, at least 0, at most {@link MAX_LABEL_COPIES}. */ export function labelCopiesFromInput(value) {
+    return Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(value) || 0)));
+}
+/** The label's price line, empty when it has no price. */ export function labelPriceText(label) {
     var _label_currency;
     return label.priceCents != null && Number.isFinite(label.priceCents) ? formatReceiptMoney(Math.round(label.priceCents), (_label_currency = label.currency) != null ? _label_currency : 'usd') : '';
-};
+}
+/** The file name the ZPL download is saved under. */ export function labelsZplFileName(productName) {
+    return `labels-${(productName != null ? productName : 'product').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase()}.zpl`;
+}
 /*==========================================
  * The printable page
  *=========================================*/ export function productLabelsHtml(labels, sizeId) {

package/src/lib/printing/product-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/printing/product-labels.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { escapeHtml } from '../utils/escape-html'\nimport { barcodeSvg, encodeBarcode, type EncodedBarcode } from '../barcode/barcode-encode'\nimport { formatReceiptMoney } from '../model/commerce-receipt'\nimport { toPrintable } from './print-document'\n\n/**\n * Product and shelf labels (AGL-3619): a product's name, its options, its\n * price and a barcode the register scans back, on the small thermal labels\n * a Zebra, Rollo, DYMO or Brother label printer takes.\n *\n * Two outputs from one description. A printable page (one label per page,\n * the page sized to the label) prints through the label printer's own\n * driver from any browser. ZPL is the Zebra printer language, sent to a\n * Zebra as a file; it prints sharper and faster and needs no driver\n * settings, so a store with a Zebra can skip the print dialog altogether.\n */\n\nexport interface ProductLabel {\n  name: string\n  /** A variant's options, e.g. `Large / Blue`. */\n  detail?: string\n  priceCents?: number\n  currency?: string\n  /** The variant's barcode, else its SKU: what the register looks up. */\n  code: string\n  copies: number\n}\n\nexport interface LabelSize {\n  id: string\n  label: string\n  widthIn: number\n  heightIn: number\n}\n\n/** The two sizes almost every label printer stocks for product labels. */\nexport const LABEL_SIZES: readonly LabelSize[] = [\n  { id: '2.25x1.25', label: '2.25 x 1.25 in (57 x 32 mm)', widthIn: 2.25, heightIn: 1.25 },\n  { id: '2x1', label: '2 x 1 in (51 x 25 mm)', widthIn: 2, heightIn: 1 },\n]\n\n/** One print run is capped; a typo of 5000 copies should not drain a roll. */\nexport const MAX_LABEL_COPIES = 500\n\nexport function labelSize(id: string | undefined): LabelSize {\n  return LABEL_SIZES.find((size) => size.id === id) ?? LABEL_SIZES[0]\n}\n\nconst copiesOf = (label: ProductLabel) => Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(label.copies) || 0)))\n\nconst priceText = (label: ProductLabel) =>\n  label.priceCents != null && Number.isFinite(label.priceCents)\n    ? formatReceiptMoney(Math.round(label.priceCents), label.currency ?? 'usd')\n    : ''\n\n/*==========================================\n * The printable page\n *=========================================*/\n\nexport function productLabelsHtml(labels: ProductLabel[], sizeId?: string): string {\n  const size = labelSize(sizeId)\n  const pages: string[] = []\n  for (const label of labels) {\n    const encoded = encodeBarcode(label.code)\n    const page =\n      '<section class=\"label\">' +\n      `<div class=\"name\">${escapeHtml(label.name)}</div>` +\n      (label.detail ? `<div class=\"detail\">${escapeHtml(label.detail)}</div>` : '') +\n      (priceText(label) ? `<div class=\"price\">${escapeHtml(priceText(label))}</div>` : '') +\n      (encoded\n        ? `<div class=\"bars\">${barcodeSvg(encoded)}</div><div class=\"code\">${escapeHtml(encoded.text)}</div>`\n        : '') +\n      '</section>'\n    for (let copy = 0; copy < copiesOf(label); copy += 1) pages.push(page)\n  }\n  const width = `${size.widthIn}in`\n  const height = `${size.heightIn}in`\n  return (\n    '<!doctype html><html><head><meta charset=\"utf-8\"><title>Labels</title><style>' +\n    `@page{size:${width} ${height};margin:0}` +\n    '*{box-sizing:border-box}html,body{margin:0;padding:0;font-family:Arial,Helvetica,sans-serif}' +\n    `.label{width:${width};height:${height};padding:0.06in 0.08in;overflow:hidden;display:flex;flex-direction:column;page-break-after:always;break-after:page}` +\n    '.label:last-child{page-break-after:auto;break-after:auto}' +\n    '.name{font-size:9pt;font-weight:700;line-height:1.1;max-height:2.2em;overflow:hidden}' +\n    '.detail{font-size:7pt;line-height:1.1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}' +\n    '.price{font-size:11pt;font-weight:700;line-height:1.2}' +\n    '.bars{flex:1;min-height:0.3in}.bars svg{width:100%;height:100%;display:block}' +\n    '.code{font-size:7pt;text-align:center;letter-spacing:0.05em}' +\n    '</style></head><body>' +\n    pages.join('') +\n    '</body></html>'\n  )\n}\n\n/*==========================================\n * ZPL\n *=========================================*/\n\n/** Zebra's desktop printers print at 203 dpi; the 300 dpi models are listed by name. */\nexport type ZplDpi = 203 | 300\n\n/**\n * Field text for ZPL. `^FH` makes `_` the escape, so the three characters\n * ZPL treats as commands or that escape (`^`, `~`, `_`) are written as hex,\n * and the rest is folded to the printer's ASCII font.\n */\nexport function zplText(value: unknown): string {\n  return toPrintable(value).replace(/[_^~]/g, (char) => `_${char.charCodeAt(0).toString(16).toUpperCase()}`)\n}\n\nfunction zplBarcode(encoded: EncodedBarcode, x: number, y: number, height: number, moduleDots: number): string {\n  const at = `^FO${x},${y}^BY${moduleDots}`\n  switch (encoded.format) {\n    case 'ean_13':\n      // ZPL takes the 12 data digits and adds the check digit itself.\n      return `${at}^BEN,${height},Y,N^FD${encoded.text.slice(0, 12)}^FS`\n    case 'upc_a':\n      return `${at}^BUN,${height},Y,N,Y^FD${encoded.text.slice(0, 11)}^FS`\n    case 'ean_8':\n      return `${at}^B8N,${height},Y,N^FD${encoded.text.slice(0, 7)}^FS`\n    default:\n      // Mode A: the printer picks sets B and C itself, as the page does.\n      return `${at}^BCN,${height},Y,N,N,A^FH^FD${zplText(encoded.text)}^FS`\n  }\n}\n\nexport function productLabelsZpl(labels: ProductLabel[], sizeId?: string, dpi: ZplDpi = 203): string {\n  const size = labelSize(sizeId)\n  const width = Math.round(size.widthIn * dpi)\n  const height = Math.round(size.heightIn * dpi)\n  const margin = Math.round(0.08 * dpi)\n  const font = Math.round(dpi / 9)\n  const small = Math.round(dpi / 12)\n  const moduleDots = dpi >= 300 ? 3 : 2\n  const out: string[] = []\n  for (const label of labels) {\n    const copies = copiesOf(label)\n    if (!copies) continue\n    const encoded = encodeBarcode(label.code)\n    let y = margin\n    const fields: string[] = []\n    fields.push(`^FO${margin},${y}^A0N,${font},${font}^FB${width - margin * 2},2,0,L^FH^FD${zplText(label.name)}^FS`)\n    y += font * 2 + 2\n    if (label.detail) {\n      fields.push(`^FO${margin},${y}^A0N,${small},${small}^FB${width - margin * 2},1,0,L^FH^FD${zplText(label.detail)}^FS`)\n      y += small + 2\n    }\n    const price = priceText(label)\n    if (price) {\n      fields.push(`^FO${margin},${y}^A0N,${font},${font}^FH^FD${zplText(price)}^FS`)\n      y += font + 4\n    }\n    if (encoded) {\n      // What is left of the label, less the printed digits under the bars.\n      const barHeight = Math.max(Math.round(dpi * 0.2), height - y - margin - small - 4)\n      fields.push(zplBarcode(encoded, margin, y, barHeight, moduleDots))\n    }\n    out.push(`^XA^CI0^PW${width}^LL${height}^LH0,0${fields.join('')}^PQ${copies},0,1,Y^XZ`)\n  }\n  return out.join('\\n')\n}\n"],"names":["escapeHtml","barcodeSvg","encodeBarcode","formatReceiptMoney","toPrintable","LABEL_SIZES","id","label","widthIn","heightIn","MAX_LABEL_COPIES","labelSize","find","size","copiesOf","Math","max","min","floor","Number","copies","priceText","priceCents","isFinite","round","currency","productLabelsHtml","labels","sizeId","pages","encoded","code","page","name","detail","text","copy","push","width","height","join","zplText","value","replace","char","charCodeAt","toString","toUpperCase","zplBarcode","x","y","moduleDots","at","format","slice","productLabelsZpl","dpi","margin","font","small","out","fields","price","barHeight"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/printing/product-labels.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { escapeHtml } from '../utils/escape-html'\nimport { barcodeSvg, encodeBarcode, type EncodedBarcode } from '../barcode/barcode-encode'\nimport { formatReceiptMoney } from '../model/commerce-receipt'\nimport type { HostProduct } from '../model/commerce'\nimport { toPrintable } from './print-document'\n\n/**\n * Product and shelf labels (AGL-3619): a product's name, its options, its\n * price and a barcode the register scans back, on the small thermal labels\n * a Zebra, Rollo, DYMO or Brother label printer takes.\n *\n * Two outputs from one description. A printable page (one label per page,\n * the page sized to the label) prints through the label printer's own\n * driver from any browser. ZPL is the Zebra printer language, sent to a\n * Zebra as a file; it prints sharper and faster and needs no driver\n * settings, so a store with a Zebra can skip the print dialog altogether.\n */\n\nexport interface ProductLabel {\n  name: string\n  /** A variant's options, e.g. `Large / Blue`. */\n  detail?: string\n  priceCents?: number\n  currency?: string\n  /** The variant's barcode, else its SKU: what the register looks up. */\n  code: string\n  copies: number\n}\n\nexport interface LabelSize {\n  id: string\n  label: string\n  widthIn: number\n  heightIn: number\n}\n\n/** The two sizes almost every label printer stocks for product labels. */\nexport const LABEL_SIZES: readonly LabelSize[] = [\n  { id: '2.25x1.25', label: '2.25 x 1.25 in (57 x 32 mm)', widthIn: 2.25, heightIn: 1.25 },\n  { id: '2x1', label: '2 x 1 in (51 x 25 mm)', widthIn: 2, heightIn: 1 },\n]\n\n/** One print run is capped; a typo of 5000 copies should not drain a roll. */\nexport const MAX_LABEL_COPIES = 500\n\nexport function labelSize(id: string | undefined): LabelSize {\n  return LABEL_SIZES.find((size) => size.id === id) ?? LABEL_SIZES[0]\n}\n\nconst copiesOf = (label: ProductLabel) => Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(label.copies) || 0)))\n\nconst priceText = (label: ProductLabel) => labelPriceText(label)\n\n/** A label the products list prints for one variant, with the variant it is for. */\nexport type ProductLabelRow = ProductLabel & { variantId: string }\n\n/**\n * The labels a product prints: one row per variant, its options as the\n * detail, its price and the code the register looks up (the barcode, else\n * the SKU). A row with no code prints nothing until one is added. One copy\n * each to start; the person changes the counts before printing.\n */\nexport function productLabelRows(product: Pick<HostProduct, 'name' | 'variants'>): ProductLabelRow[] {\n  return product.variants.map((variant) => {\n    const options = Object.values(variant.options ?? {}).filter(Boolean)\n    return {\n      variantId: variant.id,\n      name: product.name,\n      ...(options.length ? { detail: options.join(' / ') } : {}),\n      ...(Number.isFinite(Number(variant.priceUsd))\n        ? { priceCents: Math.round(Number(variant.priceUsd) * 100) }\n        : {}),\n      currency: 'usd',\n      code: String(variant.barcode || variant.sku || '').trim(),\n      copies: 1,\n    }\n  })\n}\n\n/** The rows that print: a code and at least one copy, each count kept within {@link MAX_LABEL_COPIES}. */\nexport function printableLabelRows<T extends ProductLabel>(rows: readonly T[]): T[] {\n  return rows.filter((row) => row.code && copiesOf(row) > 0)\n}\n\n/** How many labels the rows print in all. */\nexport function labelCopiesTotal(rows: readonly ProductLabel[]): number {\n  return printableLabelRows(rows).reduce((sum, row) => sum + copiesOf(row), 0)\n}\n\n/** A typed copy count as the dialog keeps it: whole, at least 0, at most {@link MAX_LABEL_COPIES}. */\nexport function labelCopiesFromInput(value: unknown): number {\n  return Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(value) || 0)))\n}\n\n/** The label's price line, empty when it has no price. */\nexport function labelPriceText(label: Pick<ProductLabel, 'priceCents' | 'currency'>): string {\n  return label.priceCents != null && Number.isFinite(label.priceCents)\n    ? formatReceiptMoney(Math.round(label.priceCents), label.currency ?? 'usd')\n    : ''\n}\n\n/** The file name the ZPL download is saved under. */\nexport function labelsZplFileName(productName: string | undefined): string {\n  return `labels-${(productName ?? 'product').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase()}.zpl`\n}\n\n/*==========================================\n * The printable page\n *=========================================*/\n\nexport function productLabelsHtml(labels: ProductLabel[], sizeId?: string): string {\n  const size = labelSize(sizeId)\n  const pages: string[] = []\n  for (const label of labels) {\n    const encoded = encodeBarcode(label.code)\n    const page =\n      '<section class=\"label\">' +\n      `<div class=\"name\">${escapeHtml(label.name)}</div>` +\n      (label.detail ? `<div class=\"detail\">${escapeHtml(label.detail)}</div>` : '') +\n      (priceText(label) ? `<div class=\"price\">${escapeHtml(priceText(label))}</div>` : '') +\n      (encoded\n        ? `<div class=\"bars\">${barcodeSvg(encoded)}</div><div class=\"code\">${escapeHtml(encoded.text)}</div>`\n        : '') +\n      '</section>'\n    for (let copy = 0; copy < copiesOf(label); copy += 1) pages.push(page)\n  }\n  const width = `${size.widthIn}in`\n  const height = `${size.heightIn}in`\n  return (\n    '<!doctype html><html><head><meta charset=\"utf-8\"><title>Labels</title><style>' +\n    `@page{size:${width} ${height};margin:0}` +\n    '*{box-sizing:border-box}html,body{margin:0;padding:0;font-family:Arial,Helvetica,sans-serif}' +\n    `.label{width:${width};height:${height};padding:0.06in 0.08in;overflow:hidden;display:flex;flex-direction:column;page-break-after:always;break-after:page}` +\n    '.label:last-child{page-break-after:auto;break-after:auto}' +\n    '.name{font-size:9pt;font-weight:700;line-height:1.1;max-height:2.2em;overflow:hidden}' +\n    '.detail{font-size:7pt;line-height:1.1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}' +\n    '.price{font-size:11pt;font-weight:700;line-height:1.2}' +\n    '.bars{flex:1;min-height:0.3in}.bars svg{width:100%;height:100%;display:block}' +\n    '.code{font-size:7pt;text-align:center;letter-spacing:0.05em}' +\n    '</style></head><body>' +\n    pages.join('') +\n    '</body></html>'\n  )\n}\n\n/*==========================================\n * ZPL\n *=========================================*/\n\n/** Zebra's desktop printers print at 203 dpi; the 300 dpi models are listed by name. */\nexport type ZplDpi = 203 | 300\n\n/**\n * Field text for ZPL. `^FH` makes `_` the escape, so the three characters\n * ZPL treats as commands or that escape (`^`, `~`, `_`) are written as hex,\n * and the rest is folded to the printer's ASCII font.\n */\nexport function zplText(value: unknown): string {\n  return toPrintable(value).replace(/[_^~]/g, (char) => `_${char.charCodeAt(0).toString(16).toUpperCase()}`)\n}\n\nfunction zplBarcode(encoded: EncodedBarcode, x: number, y: number, height: number, moduleDots: number): string {\n  const at = `^FO${x},${y}^BY${moduleDots}`\n  switch (encoded.format) {\n    case 'ean_13':\n      // ZPL takes the 12 data digits and adds the check digit itself.\n      return `${at}^BEN,${height},Y,N^FD${encoded.text.slice(0, 12)}^FS`\n    case 'upc_a':\n      return `${at}^BUN,${height},Y,N,Y^FD${encoded.text.slice(0, 11)}^FS`\n    case 'ean_8':\n      return `${at}^B8N,${height},Y,N^FD${encoded.text.slice(0, 7)}^FS`\n    default:\n      // Mode A: the printer picks sets B and C itself, as the page does.\n      return `${at}^BCN,${height},Y,N,N,A^FH^FD${zplText(encoded.text)}^FS`\n  }\n}\n\nexport function productLabelsZpl(labels: ProductLabel[], sizeId?: string, dpi: ZplDpi = 203): string {\n  const size = labelSize(sizeId)\n  const width = Math.round(size.widthIn * dpi)\n  const height = Math.round(size.heightIn * dpi)\n  const margin = Math.round(0.08 * dpi)\n  const font = Math.round(dpi / 9)\n  const small = Math.round(dpi / 12)\n  const moduleDots = dpi >= 300 ? 3 : 2\n  const out: string[] = []\n  for (const label of labels) {\n    const copies = copiesOf(label)\n    if (!copies) continue\n    const encoded = encodeBarcode(label.code)\n    let y = margin\n    const fields: string[] = []\n    fields.push(`^FO${margin},${y}^A0N,${font},${font}^FB${width - margin * 2},2,0,L^FH^FD${zplText(label.name)}^FS`)\n    y += font * 2 + 2\n    if (label.detail) {\n      fields.push(`^FO${margin},${y}^A0N,${small},${small}^FB${width - margin * 2},1,0,L^FH^FD${zplText(label.detail)}^FS`)\n      y += small + 2\n    }\n    const price = priceText(label)\n    if (price) {\n      fields.push(`^FO${margin},${y}^A0N,${font},${font}^FH^FD${zplText(price)}^FS`)\n      y += font + 4\n    }\n    if (encoded) {\n      // What is left of the label, less the printed digits under the bars.\n      const barHeight = Math.max(Math.round(dpi * 0.2), height - y - margin - small - 4)\n      fields.push(zplBarcode(encoded, margin, y, barHeight, moduleDots))\n    }\n    out.push(`^XA^CI0^PW${width}^LL${height}^LH0,0${fields.join('')}^PQ${copies},0,1,Y^XZ`)\n  }\n  return out.join('\\n')\n}\n"],"names":["escapeHtml","barcodeSvg","encodeBarcode","formatReceiptMoney","toPrintable","LABEL_SIZES","id","label","widthIn","heightIn","MAX_LABEL_COPIES","labelSize","find","size","copiesOf","Math","max","min","floor","Number","copies","priceText","labelPriceText","productLabelRows","product","variants","map","variant","options","Object","values","filter","Boolean","variantId","name","length","detail","join","isFinite","priceUsd","priceCents","round","currency","code","String","barcode","sku","trim","printableLabelRows","rows","row","labelCopiesTotal","reduce","sum","labelCopiesFromInput","value","labelsZplFileName","productName","replace","toLowerCase","productLabelsHtml","labels","sizeId","pages","encoded","page","text","copy","push","width","height","zplText","char","charCodeAt","toString","toUpperCase","zplBarcode","x","y","moduleDots","at","format","slice","productLabelsZpl","dpi","margin","font","small","out","fields","price","barHeight"],"mappings":"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"}

package/src/lib/server/order-figures.js

@@ -15,6 +15,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { PLUGIN_FIGURE_MAX_ROWS, pluginFigureChange, pluginFigureWindows, registerPluginFigureReader } from "@aglyn/aglyn/plugin-manager/plugin-figures";
+import { figureCount, figureHasColumn, figurePlural, figureRanked, figureWithChange } from "@aglyn/aglyn/app-utils/weekly-summary";
 import { BUNDLE_ID } from "../constants/bundle-common.js";
 import { orderWindowFigures, productSales } from "../model/order-figures.js";
 /** Orders one window reads; a store past it is told its figures read low. */ export const ORDER_FIGURES_WINDOW_CEILING = 1000;
@@ -73,6 +74,27 @@ export function orderFigureReaders(firestore) {
             scope: 'site',
             windows: WINDOWS,
             feature: 'commerceAnalytics',
+            weeklySummary: {
+                order: 70,
+                lines: (table)=>{
+                    const week = table.rows[0];
+                    if (!week || !figureHasColumn(table, 'revenue')) return [];
+                    const orders = figureCount(week['orders']);
+                    if (!orders && !figureCount(week['revenue'])) return [];
+                    return [
+                        `Sales: ${figureWithChange(table, week, 'revenue', 'revenueChange')} from ${figurePlural(orders, 'order', 'orders')}`
+                    ];
+                },
+                headline: (table)=>{
+                    var _table_rows_;
+                    const count = figureCount((_table_rows_ = table.rows[0]) == null ? void 0 : _table_rows_['orders']);
+                    return count ? {
+                        count,
+                        one: 'order',
+                        many: 'orders'
+                    } : null;
+                }
+            },
             read: async (request)=>{
                 const refused = refusal(request);
                 if (refused) return refused;
@@ -159,6 +181,15 @@ export function orderFigureReaders(firestore) {
             scope: 'site',
             windows: WINDOWS,
             feature: 'commerceAnalytics',
+            weeklySummary: {
+                order: 80,
+                lines: (table)=>{
+                    const top = figureHasColumn(table, 'units') ? figureRanked(table, 'product', 'units', 'sold') : null;
+                    return top ? [
+                        `Top products: ${top}`
+                    ] : [];
+                }
+            },
             read: async (request)=>{
                 const refused = refusal(request);
                 if (refused) return refused;

package/src/lib/server/order-figures.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/order-figures.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  PLUGIN_FIGURE_MAX_ROWS,\n  pluginFigureChange,\n  pluginFigureWindows,\n  registerPluginFigureReader,\n  type PluginFigureReader,\n  type PluginFigureRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport {\n  orderWindowFigures,\n  productSales,\n  type OrderFigureSource,\n} from '../model/order-figures'\n\n/**\n * The store's sales figures for another plugin to read (AGL-2915): what the\n * Analytics tab's card shows, as tables on the `plugin-figures` seam. The\n * insight job reads them by id and never reads an order.\n *\n * A table carries sums and counts and product names — never a buyer, an\n * address or an order. Sold under `commerceAnalytics`, the entitlement the\n * card is sold under.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** Orders one window reads; a store past it is told its figures read low. */\nexport const ORDER_FIGURES_WINDOW_CEILING = 1_000\n\nconst WINDOWS: readonly number[] = [7, 14, 30, 90]\n\nconst SOURCE = { label: 'Store analytics', path: 'products/analytics' }\n\nasync function ordersBetween(\n  firestore: Firestore,\n  hostId: string,\n  startMs: number,\n  endMs: number,\n): Promise<{ orders: OrderFigureSource[]; truncated: boolean }> {\n  // `createdAtMs` is the field every order writer stamps and the one the\n  // orders group is indexed on; range and order on it need no composite index.\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(hostId)\n    .collection('orders')\n    .where('createdAtMs', '>=', startMs)\n    .where('createdAtMs', '<', endMs)\n    .orderBy('createdAtMs', 'desc')\n    .limit(ORDER_FIGURES_WINDOW_CEILING + 1)\n    .get()\n  const orders = snapshot.docs.map((doc) => ({ ...(doc.data() ?? {}), $id: doc.id }) as OrderFigureSource)\n  return {\n    orders: orders.slice(0, ORDER_FIGURES_WINDOW_CEILING),\n    truncated: orders.length > ORDER_FIGURES_WINDOW_CEILING,\n  }\n}\n\nconst dollars = (cents: number): number => Math.round(cents) / 100\n\nfunction ceilingNote(truncated: boolean): string[] {\n  return truncated\n    ? [\n        `The store took more than ${ORDER_FIGURES_WINDOW_CEILING.toLocaleString('en-US')} orders in a window, so its figures are summed over the most recent ${ORDER_FIGURES_WINDOW_CEILING.toLocaleString('en-US')} and read low.`,\n      ]\n    : []\n}\n\nfunction refusal(request: PluginFigureRequest) {\n  if (!request.hostId) return { ok: false as const, status: 400 as const, error: 'Open a site to read its sales' }\n  if (!WINDOWS.includes(request.days)) {\n    return { ok: false as const, status: 400 as const, error: 'That window is not one sales are read over' }\n  }\n  return null\n}\n\nexport function orderFigureReaders(firestore: () => Firestore): PluginFigureReader[] {\n  return [\n    {\n      id: 'commerce.sales',\n      label: 'Sales',\n      description:\n        'The store’s revenue, orders and average order over the window and the window before it, with the change in revenue and in orders. Pending, canceled and test orders are left out, and refunds come off.',\n      scope: 'site',\n      windows: WINDOWS,\n      feature: 'commerceAnalytics',\n      read: async (request) => {\n        const refused = refusal(request)\n        if (refused) return refused\n        const hostId = request.hostId as string\n        const { current, previous } = pluginFigureWindows(request.now, request.days)\n        const [now, before] = await Promise.all([\n          ordersBetween(firestore(), hostId, current.startMs, current.endMs),\n          ordersBetween(firestore(), hostId, previous.startMs, previous.endMs),\n        ])\n        const a = orderWindowFigures(now.orders, current.startMs, current.endMs)\n        const b = orderWindowFigures(before.orders, previous.startMs, previous.endMs)\n        return {\n          ok: true,\n          table: {\n            title: 'Sales',\n            source: SOURCE,\n            period: { from: current.from, to: current.to, days: request.days },\n            columns: [\n              { key: 'window', label: 'Window', kind: 'text' },\n              { key: 'revenue', label: 'Revenue', kind: 'money', currency: 'USD' },\n              { key: 'orders', label: 'Orders', kind: 'count' },\n              { key: 'averageOrder', label: 'Average order', kind: 'money', currency: 'USD' },\n              { key: 'revenueChange', label: 'Revenue change', kind: 'change' },\n              { key: 'ordersChange', label: 'Orders change', kind: 'change' },\n            ],\n            rows: [\n              {\n                window: `${current.from} to ${current.to}`,\n                revenue: dollars(a.revenueCents),\n                orders: a.orders,\n                averageOrder: dollars(a.averageCents),\n                revenueChange: pluginFigureChange(a.revenueCents, b.revenueCents),\n                ordersChange: pluginFigureChange(a.orders, b.orders),\n              },\n              {\n                window: `${previous.from} to ${previous.to}`,\n                revenue: dollars(b.revenueCents),\n                orders: b.orders,\n                averageOrder: dollars(b.averageCents),\n                revenueChange: null,\n                ordersChange: null,\n              },\n            ],\n            omitted: 0,\n            notes: ceilingNote(now.truncated || before.truncated),\n          },\n        }\n      },\n    },\n    {\n      id: 'commerce.products',\n      label: 'Top products',\n      description: 'The products that brought in the most over the window, with units sold and line revenue.',\n      scope: 'site',\n      windows: WINDOWS,\n      feature: 'commerceAnalytics',\n      read: async (request) => {\n        const refused = refusal(request)\n        if (refused) return refused\n        const { current } = pluginFigureWindows(request.now, request.days)\n        const window = await ordersBetween(firestore(), request.hostId as string, current.startMs, current.endMs)\n        const sales = productSales(window.orders)\n        return {\n          ok: true,\n          table: {\n            title: 'Top products',\n            source: SOURCE,\n            period: { from: current.from, to: current.to, days: request.days },\n            columns: [\n              { key: 'product', label: 'Product', kind: 'text' },\n              { key: 'units', label: 'Units', kind: 'count' },\n              { key: 'revenue', label: 'Line revenue', kind: 'money', currency: 'USD' },\n            ],\n            rows: sales\n              .slice(0, PLUGIN_FIGURE_MAX_ROWS)\n              .map((entry) => ({ product: entry.name, units: entry.units, revenue: dollars(entry.cents) })),\n            omitted: Math.max(0, sales.length - PLUGIN_FIGURE_MAX_ROWS),\n            notes: [\n              'Line revenue is each line’s price times its quantity, before discounts, shipping and tax.',\n              ...ceilingNote(window.truncated),\n            ],\n          },\n        }\n      },\n    },\n  ]\n}\n\n/** Registers the sales readers from the console surface, where insight jobs run. */\nexport function registerOrderFigureReaders(firestore: () => Firestore): void {\n  for (const reader of orderFigureReaders(firestore)) {\n    registerPluginFigureReader(reader, { pluginId: BUNDLE_ID })\n  }\n}\n"],"names":["PLUGIN_FIGURE_MAX_ROWS","pluginFigureChange","pluginFigureWindows","registerPluginFigureReader","BUNDLE_ID","orderWindowFigures","productSales","ORDER_FIGURES_WINDOW_CEILING","WINDOWS","SOURCE","label","path","ordersBetween","firestore","hostId","startMs","endMs","snapshot","collection","doc","where","orderBy","limit","get","orders","docs","map","data","$id","id","slice","truncated","length","dollars","cents","Math","round","ceilingNote","toLocaleString","refusal","request","ok","status","error","includes","days","orderFigureReaders","description","scope","windows","feature","read","refused","current","previous","now","before","Promise","all","a","b","table","title","source","period","from","to","columns","key","kind","currency","rows","window","revenue","revenueCents","averageOrder","averageCents","revenueChange","ordersChange","omitted","notes","sales","entry","product","name","units","max","registerOrderFigureReaders","reader","pluginId"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/order-figures.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  PLUGIN_FIGURE_MAX_ROWS,\n  pluginFigureChange,\n  pluginFigureWindows,\n  registerPluginFigureReader,\n  type PluginFigureReader,\n  type PluginFigureRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport {\n  figureCount,\n  figureHasColumn,\n  figurePlural,\n  figureRanked,\n  figureWithChange,\n} from '@aglyn/aglyn/app-utils/weekly-summary'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport {\n  orderWindowFigures,\n  productSales,\n  type OrderFigureSource,\n} from '../model/order-figures'\n\n/**\n * The store's sales figures for another plugin to read (AGL-2915): what the\n * Analytics tab's card shows, as tables on the `plugin-figures` seam. The\n * insight job reads them by id and never reads an order.\n *\n * A table carries sums and counts and product names — never a buyer, an\n * address or an order. Sold under `commerceAnalytics`, the entitlement the\n * card is sold under.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** Orders one window reads; a store past it is told its figures read low. */\nexport const ORDER_FIGURES_WINDOW_CEILING = 1_000\n\nconst WINDOWS: readonly number[] = [7, 14, 30, 90]\n\nconst SOURCE = { label: 'Store analytics', path: 'products/analytics' }\n\nasync function ordersBetween(\n  firestore: Firestore,\n  hostId: string,\n  startMs: number,\n  endMs: number,\n): Promise<{ orders: OrderFigureSource[]; truncated: boolean }> {\n  // `createdAtMs` is the field every order writer stamps and the one the\n  // orders group is indexed on; range and order on it need no composite index.\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(hostId)\n    .collection('orders')\n    .where('createdAtMs', '>=', startMs)\n    .where('createdAtMs', '<', endMs)\n    .orderBy('createdAtMs', 'desc')\n    .limit(ORDER_FIGURES_WINDOW_CEILING + 1)\n    .get()\n  const orders = snapshot.docs.map((doc) => ({ ...(doc.data() ?? {}), $id: doc.id }) as OrderFigureSource)\n  return {\n    orders: orders.slice(0, ORDER_FIGURES_WINDOW_CEILING),\n    truncated: orders.length > ORDER_FIGURES_WINDOW_CEILING,\n  }\n}\n\nconst dollars = (cents: number): number => Math.round(cents) / 100\n\nfunction ceilingNote(truncated: boolean): string[] {\n  return truncated\n    ? [\n        `The store took more than ${ORDER_FIGURES_WINDOW_CEILING.toLocaleString('en-US')} orders in a window, so its figures are summed over the most recent ${ORDER_FIGURES_WINDOW_CEILING.toLocaleString('en-US')} and read low.`,\n      ]\n    : []\n}\n\nfunction refusal(request: PluginFigureRequest) {\n  if (!request.hostId) return { ok: false as const, status: 400 as const, error: 'Open a site to read its sales' }\n  if (!WINDOWS.includes(request.days)) {\n    return { ok: false as const, status: 400 as const, error: 'That window is not one sales are read over' }\n  }\n  return null\n}\n\nexport function orderFigureReaders(firestore: () => Firestore): PluginFigureReader[] {\n  return [\n    {\n      id: 'commerce.sales',\n      label: 'Sales',\n      description:\n        'The store’s revenue, orders and average order over the window and the window before it, with the change in revenue and in orders. Pending, canceled and test orders are left out, and refunds come off.',\n      scope: 'site',\n      windows: WINDOWS,\n      feature: 'commerceAnalytics',\n      weeklySummary: {\n        order: 70,\n        lines: (table) => {\n          const week = table.rows[0]\n          if (!week || !figureHasColumn(table, 'revenue')) return []\n          const orders = figureCount(week['orders'])\n          if (!orders && !figureCount(week['revenue'])) return []\n          return [\n            `Sales: ${figureWithChange(table, week, 'revenue', 'revenueChange')} from ${figurePlural(orders, 'order', 'orders')}`,\n          ]\n        },\n        headline: (table) => {\n          const count = figureCount(table.rows[0]?.['orders'])\n          return count ? { count, one: 'order', many: 'orders' } : null\n        },\n      },\n      read: async (request) => {\n        const refused = refusal(request)\n        if (refused) return refused\n        const hostId = request.hostId as string\n        const { current, previous } = pluginFigureWindows(request.now, request.days)\n        const [now, before] = await Promise.all([\n          ordersBetween(firestore(), hostId, current.startMs, current.endMs),\n          ordersBetween(firestore(), hostId, previous.startMs, previous.endMs),\n        ])\n        const a = orderWindowFigures(now.orders, current.startMs, current.endMs)\n        const b = orderWindowFigures(before.orders, previous.startMs, previous.endMs)\n        return {\n          ok: true,\n          table: {\n            title: 'Sales',\n            source: SOURCE,\n            period: { from: current.from, to: current.to, days: request.days },\n            columns: [\n              { key: 'window', label: 'Window', kind: 'text' },\n              { key: 'revenue', label: 'Revenue', kind: 'money', currency: 'USD' },\n              { key: 'orders', label: 'Orders', kind: 'count' },\n              { key: 'averageOrder', label: 'Average order', kind: 'money', currency: 'USD' },\n              { key: 'revenueChange', label: 'Revenue change', kind: 'change' },\n              { key: 'ordersChange', label: 'Orders change', kind: 'change' },\n            ],\n            rows: [\n              {\n                window: `${current.from} to ${current.to}`,\n                revenue: dollars(a.revenueCents),\n                orders: a.orders,\n                averageOrder: dollars(a.averageCents),\n                revenueChange: pluginFigureChange(a.revenueCents, b.revenueCents),\n                ordersChange: pluginFigureChange(a.orders, b.orders),\n              },\n              {\n                window: `${previous.from} to ${previous.to}`,\n                revenue: dollars(b.revenueCents),\n                orders: b.orders,\n                averageOrder: dollars(b.averageCents),\n                revenueChange: null,\n                ordersChange: null,\n              },\n            ],\n            omitted: 0,\n            notes: ceilingNote(now.truncated || before.truncated),\n          },\n        }\n      },\n    },\n    {\n      id: 'commerce.products',\n      label: 'Top products',\n      description: 'The products that brought in the most over the window, with units sold and line revenue.',\n      scope: 'site',\n      windows: WINDOWS,\n      feature: 'commerceAnalytics',\n      weeklySummary: {\n        order: 80,\n        lines: (table) => {\n          const top = figureHasColumn(table, 'units') ? figureRanked(table, 'product', 'units', 'sold') : null\n          return top ? [`Top products: ${top}`] : []\n        },\n      },\n      read: async (request) => {\n        const refused = refusal(request)\n        if (refused) return refused\n        const { current } = pluginFigureWindows(request.now, request.days)\n        const window = await ordersBetween(firestore(), request.hostId as string, current.startMs, current.endMs)\n        const sales = productSales(window.orders)\n        return {\n          ok: true,\n          table: {\n            title: 'Top products',\n            source: SOURCE,\n            period: { from: current.from, to: current.to, days: request.days },\n            columns: [\n              { key: 'product', label: 'Product', kind: 'text' },\n              { key: 'units', label: 'Units', kind: 'count' },\n              { key: 'revenue', label: 'Line revenue', kind: 'money', currency: 'USD' },\n            ],\n            rows: sales\n              .slice(0, PLUGIN_FIGURE_MAX_ROWS)\n              .map((entry) => ({ product: entry.name, units: entry.units, revenue: dollars(entry.cents) })),\n            omitted: Math.max(0, sales.length - PLUGIN_FIGURE_MAX_ROWS),\n            notes: [\n              'Line revenue is each line’s price times its quantity, before discounts, shipping and tax.',\n              ...ceilingNote(window.truncated),\n            ],\n          },\n        }\n      },\n    },\n  ]\n}\n\n/** Registers the sales readers from the console surface, where insight jobs run. */\nexport function registerOrderFigureReaders(firestore: () => Firestore): void {\n  for (const reader of orderFigureReaders(firestore)) {\n    registerPluginFigureReader(reader, { pluginId: BUNDLE_ID })\n  }\n}\n"],"names":["PLUGIN_FIGURE_MAX_ROWS","pluginFigureChange","pluginFigureWindows","registerPluginFigureReader","figureCount","figureHasColumn","figurePlural","figureRanked","figureWithChange","BUNDLE_ID","orderWindowFigures","productSales","ORDER_FIGURES_WINDOW_CEILING","WINDOWS","SOURCE","label","path","ordersBetween","firestore","hostId","startMs","endMs","snapshot","collection","doc","where","orderBy","limit","get","orders","docs","map","data","$id","id","slice","truncated","length","dollars","cents","Math","round","ceilingNote","toLocaleString","refusal","request","ok","status","error","includes","days","orderFigureReaders","description","scope","windows","feature","weeklySummary","order","lines","table","week","rows","headline","count","one","many","read","refused","current","previous","now","before","Promise","all","a","b","title","source","period","from","to","columns","key","kind","currency","window","revenue","revenueCents","averageOrder","averageCents","revenueChange","ordersChange","omitted","notes","top","sales","entry","product","name","units","max","registerOrderFigureReaders","reader","pluginId"],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type PluginApiHandler } from '@aglyn/aglyn/server';
+import { type HostOrder } from '../model';
+export type OrderPrintKind = 'invoice' | 'packing-slip';
+export declare const ORDER_PRINT_KINDS: readonly OrderPrintKind[];
+type Firestore = FirebaseFirestore.Firestore;
+export interface OrderPrintDeps {
+    firestore?: () => Firestore;
+    verifyIdToken?: (token: string) => Promise<Record<string, unknown> & {
+        uid: string;
+    }>;
+}
+/** The page and its title for one order: what the console's popup is given. */
+export declare function orderPrintPage(kind: OrderPrintKind, input: {
+    order: HostOrder;
+    orderId: string;
+    host?: Record<string, unknown> | null;
+    store?: Record<string, unknown> | null;
+}): {
+    title: string;
+    html: string;
+};
+export declare function createOrderPrintHandler(options?: OrderPrintDeps): PluginApiHandler;
+export declare const orderPrintHandler: PluginApiHandler;
+export {};

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

@@ -0,0 +1,113 @@
+/**
+ * @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 { isRefusedIdToken } from "@aglyn/tenant-data-admin/server/id-token-refusal";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin";
+import { formatOrderNumber, liftLegacyOrder } from "../model/index.js";
+import { buildOrderInvoiceHtml, invoiceStoreFrom } from "../utils/order-invoice.js";
+import { buildPackingSlipHtml } from "../utils/order-packing-slip.js";
+import { validId } from "./products-write.js";
+export const ORDER_PRINT_KINDS = [
+    'invoice',
+    'packing-slip'
+];
+/** The page and its title for one order: what the console's popup is given. */ export function orderPrintPage(kind, input) {
+    const number = formatOrderNumber(input.order, input.orderId);
+    if (kind === 'packing-slip') {
+        return {
+            title: `Packing slip ${number}`,
+            html: buildPackingSlipHtml(input.order, input.orderId)
+        };
+    }
+    return {
+        title: `Invoice ${number}`,
+        html: buildOrderInvoiceHtml({
+            order: input.order,
+            orderId: input.orderId,
+            store: invoiceStoreFrom(input.host, input.store)
+        })
+    };
+}
+export function createOrderPrintHandler(options = {}) {
+    return async (req, res)=>{
+        var _options_firestore, _options_verifyIdToken, _req_query_kind, _req_headers_authorization;
+        if (req.method !== 'GET') return res.status(405).json({
+            error: 'Method not allowed'
+        });
+        const firestore = (_options_firestore = options.firestore) != null ? _options_firestore : ()=>firebaseAdmin.app().firestore();
+        const verifyIdToken = (_options_verifyIdToken = options.verifyIdToken) != null ? _options_verifyIdToken : (token)=>firebaseAdmin.app().auth().verifyIdToken(token);
+        const hostId = req.query['hostId'];
+        const orderId = req.query['orderId'];
+        const kind = String((_req_query_kind = req.query['kind']) != null ? _req_query_kind : '');
+        if (!validId(hostId) || !validId(orderId)) return res.status(400).json({
+            error: 'Missing site or order'
+        });
+        if (!ORDER_PRINT_KINDS.includes(kind)) return res.status(400).json({
+            error: 'kind must be invoice or packing-slip'
+        });
+        const authorization = String((_req_headers_authorization = req.headers.authorization) != null ? _req_headers_authorization : '');
+        const token = authorization.startsWith('Bearer ') ? authorization.slice('Bearer '.length) : '';
+        if (!token) return res.status(401).json({
+            error: 'Unauthenticated'
+        });
+        try {
+            var _host_get, _stored_data, _ref;
+            let decoded;
+            try {
+                decoded = await verifyIdToken(token);
+            } catch (error) {
+                // Only a refused token is the caller's; an Auth outage is a 500 (AGL-2852).
+                if (!isRefusedIdToken(error)) throw error;
+                return res.status(401).json({
+                    error: 'Sign in again to continue'
+                });
+            }
+            const db = firestore();
+            const hostRef = db.collection('hosts').doc(hostId);
+            const host = await hostRef.get();
+            if (!host.exists) return res.status(404).json({
+                error: 'Unknown site'
+            });
+            const role = ((_host_get = host.get('memberRoles')) != null ? _host_get : {})[decoded.uid];
+            if (decoded['staff'] !== true && role !== 'admin' && role !== 'editor') {
+                return res.status(403).json({
+                    error: 'Not permitted'
+                });
+            }
+            const [stored, store] = await Promise.all([
+                hostRef.collection('orders').doc(orderId).get(),
+                kind === 'invoice' ? hostRef.collection('settings').doc('store').get() : Promise.resolve(null)
+            ]);
+            if (!stored.exists) return res.status(404).json({
+                error: 'This order no longer exists'
+            });
+            const order = liftLegacyOrder((_stored_data = stored.data()) != null ? _stored_data : {});
+            return res.status(200).json(orderPrintPage(kind, {
+                order,
+                orderId,
+                host: host.data(),
+                store: (_ref = store == null ? void 0 : store.data()) != null ? _ref : null
+            }));
+        } catch (error) {
+            console.error('[commerce/order-print]', error);
+            return res.status(500).json({
+                error: 'The page could not be made'
+            });
+        }
+    };
+}
+export const orderPrintHandler = createOrderPrintHandler();
+
+//# sourceMappingURL=order-print.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/order-print.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { isRefusedIdToken } from '@aglyn/tenant-data-admin/server/id-token-refusal'\nimport { type PluginApiHandler } from '@aglyn/aglyn/server'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin'\nimport { formatOrderNumber, liftLegacyOrder, type HostOrder } from '../model'\nimport { buildOrderInvoiceHtml, invoiceStoreFrom } from '../utils/order-invoice'\nimport { buildPackingSlipHtml } from '../utils/order-packing-slip'\nimport { validId } from './products-write'\n\n/*\n * `GET /api/commerce/order-print?hostId&orderId&kind` (AGL-3841): the order\n * dialog's \"Packing slip\" and \"Invoice\" for the native apps, which print them\n * through the device's own print sheet.\n *\n * The console builds both pages in the browser from the order it is showing\n * (`utils/order-packing-slip.ts`, `utils/order-invoice.ts`) and prints them\n * from a popup. This route runs the same two builders over the stored order,\n * the site and its store settings, and answers the markup with the title the\n * popup has, so an app prints the console's own page rather than a copy of\n * its layout.\n *\n * Gate: who may read the order (`canReadHostSensitive` in the rules: the\n * site's `admin` and `editor`), or staff. A read, so a frozen site still\n * prints.\n */\n\nexport type OrderPrintKind = 'invoice' | 'packing-slip'\n\nexport const ORDER_PRINT_KINDS: readonly OrderPrintKind[] = ['invoice', 'packing-slip']\n\ntype Firestore = FirebaseFirestore.Firestore\n\nexport interface OrderPrintDeps {\n  firestore?: () => Firestore\n  verifyIdToken?: (token: string) => Promise<Record<string, unknown> & { uid: string }>\n}\n\n/** The page and its title for one order: what the console's popup is given. */\nexport function orderPrintPage(\n  kind: OrderPrintKind,\n  input: {\n    order: HostOrder\n    orderId: string\n    host?: Record<string, unknown> | null\n    store?: Record<string, unknown> | null\n  },\n): { title: string; html: string } {\n  const number = formatOrderNumber(input.order, input.orderId)\n  if (kind === 'packing-slip') {\n    return { title: `Packing slip ${number}`, html: buildPackingSlipHtml(input.order, input.orderId) }\n  }\n  return {\n    title: `Invoice ${number}`,\n    html: buildOrderInvoiceHtml({\n      order: input.order,\n      orderId: input.orderId,\n      store: invoiceStoreFrom(input.host, input.store),\n    }),\n  }\n}\n\nexport function createOrderPrintHandler(options: OrderPrintDeps = {}): PluginApiHandler {\n  return async (req, res) => {\n    if (req.method !== 'GET') return res.status(405).json({ error: 'Method not allowed' })\n    const firestore = options.firestore ?? (() => firebaseAdmin.app().firestore() as unknown as Firestore)\n    const verifyIdToken =\n      options.verifyIdToken ?? ((token: string) => firebaseAdmin.app().auth().verifyIdToken(token) as never)\n    const hostId = req.query['hostId']\n    const orderId = req.query['orderId']\n    const kind = String(req.query['kind'] ?? '') as OrderPrintKind\n    if (!validId(hostId) || !validId(orderId)) return res.status(400).json({ error: 'Missing site or order' })\n    if (!ORDER_PRINT_KINDS.includes(kind)) return res.status(400).json({ error: 'kind must be invoice or packing-slip' })\n    const authorization = String(req.headers.authorization ?? '')\n    const token = authorization.startsWith('Bearer ') ? authorization.slice('Bearer '.length) : ''\n    if (!token) return res.status(401).json({ error: 'Unauthenticated' })\n    try {\n      let decoded: Record<string, unknown> & { uid: string }\n      try {\n        decoded = await verifyIdToken(token)\n      } catch (error) {\n        // Only a refused token is the caller's; an Auth outage is a 500 (AGL-2852).\n        if (!isRefusedIdToken(error)) throw error\n        return res.status(401).json({ error: 'Sign in again to continue' })\n      }\n      const db = firestore()\n      const hostRef = db.collection('hosts').doc(hostId)\n      const host = await hostRef.get()\n      if (!host.exists) return res.status(404).json({ error: 'Unknown site' })\n      const role = (host.get('memberRoles') ?? {})[decoded.uid]\n      if (decoded['staff'] !== true && role !== 'admin' && role !== 'editor') {\n        return res.status(403).json({ error: 'Not permitted' })\n      }\n      const [stored, store] = await Promise.all([\n        hostRef.collection('orders').doc(orderId).get(),\n        kind === 'invoice' ? hostRef.collection('settings').doc('store').get() : Promise.resolve(null),\n      ])\n      if (!stored.exists) return res.status(404).json({ error: 'This order no longer exists' })\n      const order = liftLegacyOrder((stored.data() ?? {}) as never)\n      return res.status(200).json(\n        orderPrintPage(kind, {\n          order,\n          orderId,\n          host: host.data() as Record<string, unknown>,\n          store: (store?.data() ?? null) as Record<string, unknown> | null,\n        }),\n      )\n    } catch (error) {\n      console.error('[commerce/order-print]', error)\n      return res.status(500).json({ error: 'The page could not be made' })\n    }\n  }\n}\n\nexport const orderPrintHandler = createOrderPrintHandler()\n"],"names":["isRefusedIdToken","firebaseAdmin","formatOrderNumber","liftLegacyOrder","buildOrderInvoiceHtml","invoiceStoreFrom","buildPackingSlipHtml","validId","ORDER_PRINT_KINDS","orderPrintPage","kind","input","number","order","orderId","title","html","store","host","createOrderPrintHandler","options","req","res","method","status","json","error","firestore","app","verifyIdToken","token","auth","hostId","query","String","includes","authorization","headers","startsWith","slice","length","stored","decoded","db","hostRef","collection","doc","get","exists","role","uid","Promise","all","resolve","data","console","orderPrintHandler"],"mappings":"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"}

package/src/lib/server/products-write.d.ts

@@ -85,6 +85,32 @@ export declare function stockAttemptId(uid: string, key: string): string;
  * it and moves nothing twice.
  */
 export declare function createProductStockHandler(options?: ProductsWriteDeps): PluginApiHandler;
+/**
+ * The first slug in `base`, `base-2`, `base-3`… no product of the site holds,
+ * as the console's slug ledger claims one (`product-slugs.ts`): a second
+ * Duplicate of the same product does not mint a second `-copy` (AGL-3321).
+ */
+export declare function claimProductSlug(products: FirebaseFirestore.CollectionReference, base: string): Promise<string>;
+/**
+ * `POST /api/commerce/products/duplicate` (AGL-3841): the products list's
+ * Duplicate for the native apps. The console builds the copy in the browser
+ * (`productDuplicateFields`, its slug ledger, the copy's smart collections)
+ * and creates it through the quota-enforcing resources route; this runs the
+ * same model over the stored product and creates it under the save route's
+ * create door (the plan's commerce entitlement and its product quota, counted
+ * in the same transaction). `newProductId` is the client's, so a retry finds
+ * its own copy and answers `replayed`.
+ */
+export declare function createProductDuplicateHandler(options?: ProductsWriteDeps): PluginApiHandler;
+/**
+ * `POST /api/commerce/products/delete` (AGL-3841): the products list's Delete
+ * for the native apps, the console's write (`deletedAt` on the product, which
+ * stops it being purchasable) with the site-wide cache drop, under the save
+ * route's gate. Deleting a deleted product answers `already`.
+ */
+export declare function createProductDeleteHandler(options?: ProductsWriteDeps): PluginApiHandler;
 export declare const productSaveHandler: PluginApiHandler;
 export declare const productStockHandler: PluginApiHandler;
+export declare const productDuplicateHandler: PluginApiHandler;
+export declare const productDeleteHandler: PluginApiHandler;
 export {};