@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/transfer/transfer-keys.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/transfer/transfer-keys.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*\n * THE COMMERCE TRANSFER RESOURCES (AGL-3531), by the key each is declared\n * under in `plugins.config.json` (`transferResources`). Every one is a site's\n * records (`scope: host`); the console's lists open the import wizard and the\n * export dialog on these keys through the core launcher.\n *\n * | key | import | why |\n * | -- | -- | -- |\n * | products | yes | matched by handle, then SKU, then ID; a match is updated |\n * | categories | yes | matched by slug, then name, then ID |\n * | discounts | yes | matched by code, then name, then ID; new ones start switched off |\n * | coupons | yes | matched by code; new ones start switched off |\n * | orders | no | an order is the record of a sale, written by checkout alone |\n * | gift cards | yes, by issuing | each row issues a card through the issue path, confirmed by its total; owners and admins only |\n */\n\nexport const COMMERCE_PRODUCTS_TRANSFER = 'commerce.products'\nexport const COMMERCE_ORDERS_TRANSFER = 'commerce.orders'\nexport const COMMERCE_DISCOUNTS_TRANSFER = 'commerce.discounts'\nexport const COMMERCE_COUPONS_TRANSFER = 'commerce.coupons'\nexport const COMMERCE_GIFT_CARDS_TRANSFER = 'commerce.gift-cards'\nexport const COMMERCE_CATEGORIES_TRANSFER = 'commerce.categories'\n\n/** Every commerce resource key, in the order the hub lists them. */\nexport const COMMERCE_TRANSFER_RESOURCES = [\n  COMMERCE_PRODUCTS_TRANSFER,\n  COMMERCE_CATEGORIES_TRANSFER,\n  COMMERCE_ORDERS_TRANSFER,\n  COMMERCE_DISCOUNTS_TRANSFER,\n  COMMERCE_COUPONS_TRANSFER,\n  COMMERCE_GIFT_CARDS_TRANSFER,\n] as const\n\n/** The resources a file may write; the others are exported only. */\nexport const COMMERCE_IMPORTABLE_TRANSFERS: ReadonlySet<string> = new Set([\n  COMMERCE_PRODUCTS_TRANSFER,\n  COMMERCE_CATEGORIES_TRANSFER,\n  COMMERCE_DISCOUNTS_TRANSFER,\n  COMMERCE_COUPONS_TRANSFER,\n  COMMERCE_GIFT_CARDS_TRANSFER,\n])\n\n/**\n * The gift card import's Confirm step (AGL-3551), and the key its answer\n * rides under in the wizard's `extras`: the total value typed back.\n */\nexport const GIFT_CARD_CONFIRM_STEP_ID = 'gift-card-total'\n"],"names":["COMMERCE_PRODUCTS_TRANSFER","COMMERCE_ORDERS_TRANSFER","COMMERCE_DISCOUNTS_TRANSFER","COMMERCE_COUPONS_TRANSFER","COMMERCE_GIFT_CARDS_TRANSFER","COMMERCE_CATEGORIES_TRANSFER","COMMERCE_TRANSFER_RESOURCES","COMMERCE_IMPORTABLE_TRANSFERS","Set","GIFT_CARD_CONFIRM_STEP_ID"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;CAcC,GAED,OAAO,MAAMA,6BAA6B,oBAAmB;AAC7D,OAAO,MAAMC,2BAA2B,kBAAiB;AACzD,OAAO,MAAMC,8BAA8B,qBAAoB;AAC/D,OAAO,MAAMC,4BAA4B,mBAAkB;AAC3D,OAAO,MAAMC,+BAA+B,sBAAqB;AACjE,OAAO,MAAMC,+BAA+B,sBAAqB;AAEjE,kEAAkE,GAClE,OAAO,MAAMC,8BAA8B;IACzCN;IACAK;IACAJ;IACAC;IACAC;IACAC;CACD,CAAS;AAEV,kEAAkE,GAClE,OAAO,MAAMG,gCAAqD,IAAIC,IAAI;IACxER;IACAK;IACAH;IACAC;IACAC;CACD,EAAC;AAEF;;;CAGC,GACD,OAAO,MAAMK,4BAA4B,kBAAiB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/transfer/transfer-keys.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*\n * THE COMMERCE TRANSFER RESOURCES (AGL-3531), by the key each is declared\n * under in `plugins.config.json` (`transferResources`). Every one is a site's\n * records (`scope: host`); the console's lists open the import wizard and the\n * export dialog on these keys through the core launcher.\n *\n * | key | import | why |\n * | -- | -- | -- |\n * | products | yes | matched by handle, then SKU, then ID; a match is updated |\n * | categories | yes | matched by slug, then name, then ID |\n * | discounts | yes | matched by code, then name, then ID; new ones start switched off |\n * | coupons | yes | matched by code; new ones start switched off |\n * | orders | no | an order is the record of a sale, written by checkout alone |\n * | gift cards | yes, by issuing | each row issues a card through the issue path, confirmed by its total; owners and admins only |\n * | tracking numbers | yes, by shipping | each row is a parcel: it ships what its order still owes, or replaces a shipped order's tracking when the person chooses (AGL-3613) |\n */\n\nexport const COMMERCE_PRODUCTS_TRANSFER = 'commerce.products'\nexport const COMMERCE_ORDERS_TRANSFER = 'commerce.orders'\nexport const COMMERCE_DISCOUNTS_TRANSFER = 'commerce.discounts'\nexport const COMMERCE_COUPONS_TRANSFER = 'commerce.coupons'\nexport const COMMERCE_GIFT_CARDS_TRANSFER = 'commerce.gift-cards'\nexport const COMMERCE_CATEGORIES_TRANSFER = 'commerce.categories'\nexport const COMMERCE_TRACKING_TRANSFER = 'commerce.tracking'\n\n/** Every commerce resource key, in the order the hub lists them. */\nexport const COMMERCE_TRANSFER_RESOURCES = [\n  COMMERCE_PRODUCTS_TRANSFER,\n  COMMERCE_CATEGORIES_TRANSFER,\n  COMMERCE_ORDERS_TRANSFER,\n  COMMERCE_DISCOUNTS_TRANSFER,\n  COMMERCE_COUPONS_TRANSFER,\n  COMMERCE_GIFT_CARDS_TRANSFER,\n  COMMERCE_TRACKING_TRANSFER,\n] as const\n\n/** The resources a file may write; the others are exported only. */\nexport const COMMERCE_IMPORTABLE_TRANSFERS: ReadonlySet<string> = new Set([\n  COMMERCE_PRODUCTS_TRANSFER,\n  COMMERCE_CATEGORIES_TRANSFER,\n  COMMERCE_DISCOUNTS_TRANSFER,\n  COMMERCE_COUPONS_TRANSFER,\n  COMMERCE_GIFT_CARDS_TRANSFER,\n  COMMERCE_TRACKING_TRANSFER,\n])\n\n/**\n * The gift card import's Confirm step (AGL-3551), and the key its answer\n * rides under in the wizard's `extras`: the total value typed back.\n */\nexport const GIFT_CARD_CONFIRM_STEP_ID = 'gift-card-total'\n"],"names":["COMMERCE_PRODUCTS_TRANSFER","COMMERCE_ORDERS_TRANSFER","COMMERCE_DISCOUNTS_TRANSFER","COMMERCE_COUPONS_TRANSFER","COMMERCE_GIFT_CARDS_TRANSFER","COMMERCE_CATEGORIES_TRANSFER","COMMERCE_TRACKING_TRANSFER","COMMERCE_TRANSFER_RESOURCES","COMMERCE_IMPORTABLE_TRANSFERS","Set","GIFT_CARD_CONFIRM_STEP_ID"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GAED,OAAO,MAAMA,6BAA6B,oBAAmB;AAC7D,OAAO,MAAMC,2BAA2B,kBAAiB;AACzD,OAAO,MAAMC,8BAA8B,qBAAoB;AAC/D,OAAO,MAAMC,4BAA4B,mBAAkB;AAC3D,OAAO,MAAMC,+BAA+B,sBAAqB;AACjE,OAAO,MAAMC,+BAA+B,sBAAqB;AACjE,OAAO,MAAMC,6BAA6B,oBAAmB;AAE7D,kEAAkE,GAClE,OAAO,MAAMC,8BAA8B;IACzCP;IACAK;IACAJ;IACAC;IACAC;IACAC;IACAE;CACD,CAAS;AAEV,kEAAkE,GAClE,OAAO,MAAME,gCAAqD,IAAIC,IAAI;IACxET;IACAK;IACAH;IACAC;IACAC;IACAE;CACD,EAAC;AAEF;;;CAGC,GACD,OAAO,MAAMI,4BAA4B,kBAAiB"}

package/src/lib/utils/code128.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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.
+ */
+/** Bar/space widths of symbols 0–106, ISO/IEC 15417. */
+export declare const CODE128_PATTERNS: readonly string[];
+/**
+ * The symbol values for `text`: code set C for an even run of digits, B for
+ * anything else printable (ASCII 32–126). Throws on a character code 128
+ * cannot carry in set B rather than printing a barcode that scans as
+ * something else.
+ */
+export declare function code128Values(text: string): number[];
+/** The barcode as module widths, bar first, quiet zones not included. */
+export declare function code128Widths(text: string): number[];
+/**
+ * An SVG of the barcode: black bars on white with a ten-module quiet zone
+ * each side, sized in modules so the printer's own resolution decides the
+ * physical width. `crispEdges` keeps a thermal head from smearing a bar.
+ */
+export declare function code128Svg(text: string, options?: {
+    height?: number;
+    moduleWidth?: number;
+    title?: string;
+}): string;

package/src/lib/utils/code128.js

@@ -0,0 +1,199 @@
+/**
+ * @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.
+ */ /*==========================================
+ * CODE 128, AS AN SVG (AGL-3609).
+ *
+ * The receipt prints the order number as a barcode so the register's return
+ * lookup can scan it back: a keyboard-wedge scanner types the digits and
+ * presses Enter, exactly as it does for a product. Code 128 because every
+ * scanner reads it and a short number stays short — an even run of digits
+ * packs two to a symbol in code set C.
+ *
+ * Each symbol is six alternating bar and space widths (bar first) adding up
+ * to eleven modules; the stop symbol has a seventh bar. The check symbol is
+ * the start value plus each data value times its position, modulo 103.
+ *=========================================*/ /** Bar/space widths of symbols 0–106, ISO/IEC 15417. */ export const CODE128_PATTERNS = [
+    '212222',
+    '222122',
+    '222221',
+    '121223',
+    '121322',
+    '131222',
+    '122213',
+    '122312',
+    '132212',
+    '221213',
+    '221312',
+    '231212',
+    '112232',
+    '122132',
+    '122231',
+    '113222',
+    '123122',
+    '123221',
+    '223211',
+    '221132',
+    '221231',
+    '213212',
+    '223112',
+    '312131',
+    '311222',
+    '321122',
+    '321221',
+    '312212',
+    '322112',
+    '322211',
+    '212123',
+    '212321',
+    '232121',
+    '111323',
+    '131123',
+    '131321',
+    '112313',
+    '132113',
+    '132311',
+    '211313',
+    '231113',
+    '231311',
+    '112133',
+    '112331',
+    '132131',
+    '113123',
+    '113321',
+    '133121',
+    '313121',
+    '211331',
+    '231131',
+    '213113',
+    '213311',
+    '213131',
+    '311123',
+    '311321',
+    '331121',
+    '312113',
+    '312311',
+    '332111',
+    '314111',
+    '221411',
+    '431111',
+    '111224',
+    '111422',
+    '121124',
+    '121421',
+    '141122',
+    '141221',
+    '112214',
+    '112412',
+    '122114',
+    '122411',
+    '142112',
+    '142211',
+    '241211',
+    '221114',
+    '413111',
+    '241112',
+    '134111',
+    '111242',
+    '121142',
+    '121241',
+    '114212',
+    '124112',
+    '124211',
+    '411212',
+    '421112',
+    '421211',
+    '212141',
+    '214121',
+    '412121',
+    '111143',
+    '111341',
+    '131141',
+    '114113',
+    '114311',
+    '411113',
+    '411311',
+    '113141',
+    '114131',
+    '311141',
+    '411131',
+    '211412',
+    '211214',
+    '211232',
+    '2331112'
+];
+const START_B = 104;
+const START_C = 105;
+const STOP = 106;
+/**
+ * The symbol values for `text`: code set C for an even run of digits, B for
+ * anything else printable (ASCII 32–126). Throws on a character code 128
+ * cannot carry in set B rather than printing a barcode that scans as
+ * something else.
+ */ export function code128Values(text) {
+    const value = String(text != null ? text : '');
+    if (!value) throw new Error('Nothing to encode');
+    const useC = /^\d+$/.test(value) && value.length % 2 === 0;
+    const data = [];
+    if (useC) {
+        for(let at = 0; at < value.length; at += 2)data.push(Number(value.slice(at, at + 2)));
+    } else {
+        for (const character of value){
+            const code = character.charCodeAt(0);
+            if (code < 32 || code > 126) throw new Error(`Cannot encode "${character}" in a barcode`);
+            data.push(code - 32);
+        }
+    }
+    const start = useC ? START_C : START_B;
+    const checksum = data.reduce((sum, symbol, index)=>sum + symbol * (index + 1), start) % 103;
+    return [
+        start,
+        ...data,
+        checksum,
+        STOP
+    ];
+}
+/** The barcode as module widths, bar first, quiet zones not included. */ export function code128Widths(text) {
+    return code128Values(text).flatMap((symbol)=>{
+        var _CODE128_PATTERNS_symbol;
+        return [
+            ...(_CODE128_PATTERNS_symbol = CODE128_PATTERNS[symbol]) != null ? _CODE128_PATTERNS_symbol : ''
+        ].map(Number);
+    });
+}
+/**
+ * An SVG of the barcode: black bars on white with a ten-module quiet zone
+ * each side, sized in modules so the printer's own resolution decides the
+ * physical width. `crispEdges` keeps a thermal head from smearing a bar.
+ */ export function code128Svg(text, options = {}) {
+    var _options_moduleWidth, _options_height, _options_title;
+    const moduleWidth = (_options_moduleWidth = options.moduleWidth) != null ? _options_moduleWidth : 2;
+    const height = (_options_height = options.height) != null ? _options_height : 60;
+    const quiet = 10;
+    const widths = code128Widths(text);
+    const totalModules = widths.reduce((sum, width)=>sum + width, 0) + quiet * 2;
+    let x = quiet;
+    const bars = [];
+    widths.forEach((width, index)=>{
+        if (index % 2 === 0) {
+            bars.push(`<rect x="${x * moduleWidth}" y="0" width="${width * moduleWidth}" height="${height}"/>`);
+        }
+        x += width;
+    });
+    const title = String((_options_title = options.title) != null ? _options_title : text).replace(/[<>&"]/g, '');
+    return `<svg xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${title}" ` + `viewBox="0 0 ${totalModules * moduleWidth} ${height}" ` + `width="${totalModules * moduleWidth}" height="${height}" shape-rendering="crispEdges">` + `<rect width="100%" height="100%" fill="#fff"/><g fill="#000">${bars.join('')}</g></svg>`;
+}
+
+//# sourceMappingURL=code128.js.map

package/src/lib/utils/code128.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/code128.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 * CODE 128, AS AN SVG (AGL-3609).\n *\n * The receipt prints the order number as a barcode so the register's return\n * lookup can scan it back: a keyboard-wedge scanner types the digits and\n * presses Enter, exactly as it does for a product. Code 128 because every\n * scanner reads it and a short number stays short — an even run of digits\n * packs two to a symbol in code set C.\n *\n * Each symbol is six alternating bar and space widths (bar first) adding up\n * to eleven modules; the stop symbol has a seventh bar. The check symbol is\n * the start value plus each data value times its position, modulo 103.\n *=========================================*/\n\n/** Bar/space widths of symbols 0–106, ISO/IEC 15417. */\nexport const CODE128_PATTERNS: readonly string[] = [\n  '212222', '222122', '222221', '121223', '121322', '131222', '122213', '122312',\n  '132212', '221213', '221312', '231212', '112232', '122132', '122231', '113222',\n  '123122', '123221', '223211', '221132', '221231', '213212', '223112', '312131',\n  '311222', '321122', '321221', '312212', '322112', '322211', '212123', '212321',\n  '232121', '111323', '131123', '131321', '112313', '132113', '132311', '211313',\n  '231113', '231311', '112133', '112331', '132131', '113123', '113321', '133121',\n  '313121', '211331', '231131', '213113', '213311', '213131', '311123', '311321',\n  '331121', '312113', '312311', '332111', '314111', '221411', '431111', '111224',\n  '111422', '121124', '121421', '141122', '141221', '112214', '112412', '122114',\n  '122411', '142112', '142211', '241211', '221114', '413111', '241112', '134111',\n  '111242', '121142', '121241', '114212', '124112', '124211', '411212', '421112',\n  '421211', '212141', '214121', '412121', '111143', '111341', '131141', '114113',\n  '114311', '411113', '411311', '113141', '114131', '311141', '411131', '211412',\n  '211214', '211232', '2331112',\n]\n\nconst START_B = 104\nconst START_C = 105\nconst STOP = 106\n\n/**\n * The symbol values for `text`: code set C for an even run of digits, B for\n * anything else printable (ASCII 32–126). Throws on a character code 128\n * cannot carry in set B rather than printing a barcode that scans as\n * something else.\n */\nexport function code128Values(text: string): number[] {\n  const value = String(text ?? '')\n  if (!value) throw new Error('Nothing to encode')\n  const useC = /^\\d+$/.test(value) && value.length % 2 === 0\n  const data: number[] = []\n  if (useC) {\n    for (let at = 0; at < value.length; at += 2) data.push(Number(value.slice(at, at + 2)))\n  } else {\n    for (const character of value) {\n      const code = character.charCodeAt(0)\n      if (code < 32 || code > 126) throw new Error(`Cannot encode \"${character}\" in a barcode`)\n      data.push(code - 32)\n    }\n  }\n  const start = useC ? START_C : START_B\n  const checksum = data.reduce((sum, symbol, index) => sum + symbol * (index + 1), start) % 103\n  return [start, ...data, checksum, STOP]\n}\n\n/** The barcode as module widths, bar first, quiet zones not included. */\nexport function code128Widths(text: string): number[] {\n  return code128Values(text).flatMap((symbol) =>\n    [...(CODE128_PATTERNS[symbol] ?? '')].map(Number),\n  )\n}\n\n/**\n * An SVG of the barcode: black bars on white with a ten-module quiet zone\n * each side, sized in modules so the printer's own resolution decides the\n * physical width. `crispEdges` keeps a thermal head from smearing a bar.\n */\nexport function code128Svg(\n  text: string,\n  options: { height?: number; moduleWidth?: number; title?: string } = {},\n): string {\n  const moduleWidth = options.moduleWidth ?? 2\n  const height = options.height ?? 60\n  const quiet = 10\n  const widths = code128Widths(text)\n  const totalModules = widths.reduce((sum, width) => sum + width, 0) + quiet * 2\n  let x = quiet\n  const bars: string[] = []\n  widths.forEach((width, index) => {\n    if (index % 2 === 0) {\n      bars.push(\n        `<rect x=\"${x * moduleWidth}\" y=\"0\" width=\"${width * moduleWidth}\" height=\"${height}\"/>`,\n      )\n    }\n    x += width\n  })\n  const title = String(options.title ?? text).replace(/[<>&\"]/g, '')\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" role=\"img\" aria-label=\"${title}\" ` +\n    `viewBox=\"0 0 ${totalModules * moduleWidth} ${height}\" ` +\n    `width=\"${totalModules * moduleWidth}\" height=\"${height}\" shape-rendering=\"crispEdges\">` +\n    `<rect width=\"100%\" height=\"100%\" fill=\"#fff\"/><g fill=\"#000\">${bars.join('')}</g></svg>`\n  )\n}\n"],"names":["CODE128_PATTERNS","START_B","START_C","STOP","code128Values","text","value","String","Error","useC","test","length","data","at","push","Number","slice","character","code","charCodeAt","start","checksum","reduce","sum","symbol","index","code128Widths","flatMap","map","code128Svg","options","moduleWidth","height","quiet","widths","totalModules","width","x","bars","forEach","title","replace","join"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;2CAY2C,GAE3C,sDAAsD,GACtD,OAAO,MAAMA,mBAAsC;IACjD;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IAAU;IACtE;IAAU;IAAU;CACrB,CAAA;AAED,MAAMC,UAAU;AAChB,MAAMC,UAAU;AAChB,MAAMC,OAAO;AAEb;;;;;CAKC,GACD,OAAO,SAASC,cAAcC,IAAY;IACxC,MAAMC,QAAQC,OAAOF,eAAAA,OAAQ;IAC7B,IAAI,CAACC,OAAO,MAAM,IAAIE,MAAM;IAC5B,MAAMC,OAAO,QAAQC,IAAI,CAACJ,UAAUA,MAAMK,MAAM,GAAG,MAAM;IACzD,MAAMC,OAAiB,EAAE;IACzB,IAAIH,MAAM;QACR,IAAK,IAAII,KAAK,GAAGA,KAAKP,MAAMK,MAAM,EAAEE,MAAM,EAAGD,KAAKE,IAAI,CAACC,OAAOT,MAAMU,KAAK,CAACH,IAAIA,KAAK;IACrF,OAAO;QACL,KAAK,MAAMI,aAAaX,MAAO;YAC7B,MAAMY,OAAOD,UAAUE,UAAU,CAAC;YAClC,IAAID,OAAO,MAAMA,OAAO,KAAK,MAAM,IAAIV,MAAM,CAAC,eAAe,EAAES,UAAU,cAAc,CAAC;YACxFL,KAAKE,IAAI,CAACI,OAAO;QACnB;IACF;IACA,MAAME,QAAQX,OAAOP,UAAUD;IAC/B,MAAMoB,WAAWT,KAAKU,MAAM,CAAC,CAACC,KAAKC,QAAQC,QAAUF,MAAMC,SAAUC,CAAAA,QAAQ,CAAA,GAAIL,SAAS;IAC1F,OAAO;QAACA;WAAUR;QAAMS;QAAUlB;KAAK;AACzC;AAEA,uEAAuE,GACvE,OAAO,SAASuB,cAAcrB,IAAY;IACxC,OAAOD,cAAcC,MAAMsB,OAAO,CAAC,CAACH;YAC7BxB;eAAL;gBAAKA,2BAAAA,gBAAgB,CAACwB,OAAO,YAAxBxB,2BAA4B;SAAI,CAAC4B,GAAG,CAACb;;AAE9C;AAEA;;;;CAIC,GACD,OAAO,SAASc,WACdxB,IAAY,EACZyB,UAAqE,CAAC,CAAC;QAEnDA,sBACLA,iBAcMA;IAfrB,MAAMC,eAAcD,uBAAAA,QAAQC,WAAW,YAAnBD,uBAAuB;IAC3C,MAAME,UAASF,kBAAAA,QAAQE,MAAM,YAAdF,kBAAkB;IACjC,MAAMG,QAAQ;IACd,MAAMC,SAASR,cAAcrB;IAC7B,MAAM8B,eAAeD,OAAOZ,MAAM,CAAC,CAACC,KAAKa,QAAUb,MAAMa,OAAO,KAAKH,QAAQ;IAC7E,IAAII,IAAIJ;IACR,MAAMK,OAAiB,EAAE;IACzBJ,OAAOK,OAAO,CAAC,CAACH,OAAOX;QACrB,IAAIA,QAAQ,MAAM,GAAG;YACnBa,KAAKxB,IAAI,CACP,CAAC,SAAS,EAAEuB,IAAIN,YAAY,eAAe,EAAEK,QAAQL,YAAY,UAAU,EAAEC,OAAO,GAAG,CAAC;QAE5F;QACAK,KAAKD;IACP;IACA,MAAMI,QAAQjC,QAAOuB,iBAAAA,QAAQU,KAAK,YAAbV,iBAAiBzB,MAAMoC,OAAO,CAAC,WAAW;IAC/D,OACE,CAAC,+DAA+D,EAAED,MAAM,EAAE,CAAC,GAC3E,CAAC,aAAa,EAAEL,eAAeJ,YAAY,CAAC,EAAEC,OAAO,EAAE,CAAC,GACxD,CAAC,OAAO,EAAEG,eAAeJ,YAAY,UAAU,EAAEC,OAAO,+BAA+B,CAAC,GACxF,CAAC,6DAA6D,EAAEM,KAAKI,IAAI,CAAC,IAAI,UAAU,CAAC;AAE7F"}

package/src/lib/utils/order-invoice.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type HostOrder } from '../model/commerce-orders';
+/**
+ * The printable invoice (AGL-3611), beside the packing slip: the order as a
+ * bill — who sold it, to whom, each line with its unit price, the totals,
+ * what was refunded and what was paid in the end.
+ *
+ * A string of markup, because it is written into a print popup the way the
+ * packing slip is, and the browser's print dialog saves it as a PDF. Every
+ * value is escaped: the addresses are typed by the shopper, and the popup
+ * inherits the console's origin (AGL-2283). No `<style>` and no `style`
+ * attributes, because the popup inherits the console's content security
+ * policy; the layout is the table attributes HTML still honors.
+ */
+export interface OrderInvoiceStore {
+    /** The business's name, as its emails sign. */
+    name: string;
+    /** The store's currency, for an order that does not carry its own. */
+    currency: string;
+    /** The receipt footer the store set, printed at the foot. */
+    footer?: string | null;
+    /** The store's terms address, printed at the foot. */
+    termsUrl?: string | null;
+}
+type InvoiceOrder = Pick<HostOrder, 'number' | 'status' | 'lineItems' | 'totals' | 'refundedCents' | 'customerName' | 'customerEmail' | 'shippingAddress' | 'billingAddress'> & {
+    createdAtMs?: number;
+    currency?: string;
+    amountCents?: number;
+};
+/** Money in the order's currency, integer cents in. */
+export declare function invoiceMoney(cents: number, currency: string): string;
+/** What the payment line says. */
+export declare function invoicePaymentStatus(order: Pick<InvoiceOrder, 'status' | 'refundedCents' | 'totals' | 'amountCents'>): string;
+/** The invoice's markup: a full document body, every value escaped. */
+export declare function buildOrderInvoiceHtml(input: {
+    order: InvoiceOrder;
+    orderId: string;
+    store: OrderInvoiceStore;
+}): string;
+export {};

package/src/lib/utils/order-invoice.js

@@ -0,0 +1,127 @@
+/**
+ * @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 { formatOrderNumber, orderCreatedAtMs } from "../model/commerce-orders.js";
+import { escapeHtml } from "./escape-html.js";
+/** Money in the order's currency, integer cents in. */ export function invoiceMoney(cents, currency) {
+    const amount = (Number(cents) || 0) / 100;
+    try {
+        return new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: currency || 'USD'
+        }).format(amount);
+    } catch (unused) {
+        return `${amount.toFixed(2)} ${String(currency || '').toUpperCase()}`.trim();
+    }
+}
+function addressLines(address) {
+    if (!address) return [];
+    return [
+        address.name,
+        address.line1,
+        address.line2,
+        [
+            address.city,
+            address.state,
+            address.postalCode
+        ].filter(Boolean).join(' '),
+        address.country,
+        address.phone
+    ].map((part)=>String(part != null ? part : '').trim()).filter(Boolean);
+}
+/** What the payment line says. */ export function invoicePaymentStatus(order) {
+    var _ref, _ref1, _order_refundedCents, _order_status;
+    var _order_totals;
+    const total = Number((_ref = (_ref1 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref1 : order.amountCents) != null ? _ref : 0);
+    const refunded = Math.max(0, Number((_order_refundedCents = order.refundedCents) != null ? _order_refundedCents : 0));
+    const status = String((_order_status = order.status) != null ? _order_status : '');
+    if (status === 'pending' || status === 'draft') return 'Awaiting payment';
+    if (status === 'cancelled') return 'Canceled';
+    if (refunded > 0 && refunded >= total) return 'Refunded';
+    if (refunded > 0) return 'Paid, partially refunded';
+    return 'Paid';
+}
+/** The invoice's markup: a full document body, every value escaped. */ export function buildOrderInvoiceHtml(input) {
+    var _ref, _order_lineItems, _ref1, _ref2, _order_refundedCents, _order_customerName, _order_customerEmail, _order_lineItems1, _ref3, _ref4, _ref5, _ref6;
+    const { order, orderId, store } = input;
+    const currency = String(order.currency || store.currency || 'USD').toUpperCase();
+    const money = (cents)=>escapeHtml(invoiceMoney(cents, currency));
+    const number = formatOrderNumber(order, orderId);
+    const createdAt = orderCreatedAtMs(order);
+    const totals = order.totals;
+    const itemsCents = (_ref = totals == null ? void 0 : totals.itemsCents) != null ? _ref : ((_order_lineItems = order.lineItems) != null ? _order_lineItems : []).reduce((sum, line)=>sum + Number(line.unitAmountCents || 0) * Number(line.quantity || 0), 0);
+    const totalCents = Number((_ref1 = (_ref2 = totals == null ? void 0 : totals.totalCents) != null ? _ref2 : order.amountCents) != null ? _ref1 : itemsCents);
+    const refundedCents = Math.max(0, Number((_order_refundedCents = order.refundedCents) != null ? _order_refundedCents : 0));
+    const billTo = [
+        ...order.billingAddress ? addressLines(order.billingAddress) : [
+            (_order_customerName = order.customerName) != null ? _order_customerName : ''
+        ].filter(Boolean),
+        (_order_customerEmail = order.customerEmail) != null ? _order_customerEmail : ''
+    ].filter(Boolean);
+    const shipTo = addressLines(order.shippingAddress);
+    const rows = ((_order_lineItems1 = order.lineItems) != null ? _order_lineItems1 : []).map((line)=>{
+        const quantity = Number(line.quantity) || 0;
+        const unit = Number(line.unitAmountCents) || 0;
+        const detail = [
+            line.variantLabel ? escapeHtml(line.variantLabel) : '',
+            line.sku ? `SKU ${escapeHtml(line.sku)}` : ''
+        ].filter(Boolean).join(' · ');
+        return `<tr><td>${escapeHtml(line.name)}${detail ? `<br/><small>${detail}</small>` : ''}</td>` + `<td align="right">${escapeHtml(quantity)}</td>` + `<td align="right">${money(unit)}</td>` + `<td align="right">${money(unit * quantity)}</td></tr>`;
+    }).join('');
+    const summary = [
+        [
+            'Subtotal',
+            money(itemsCents)
+        ]
+    ];
+    if (Number((_ref3 = totals == null ? void 0 : totals.discountCents) != null ? _ref3 : 0) > 0) summary.push([
+        'Discount',
+        `−${money(Number(totals == null ? void 0 : totals.discountCents))}`
+    ]);
+    if (Number((_ref4 = totals == null ? void 0 : totals.shippingCents) != null ? _ref4 : 0) > 0) summary.push([
+        'Shipping',
+        money(Number(totals == null ? void 0 : totals.shippingCents))
+    ]);
+    if (Number((_ref5 = totals == null ? void 0 : totals.taxCents) != null ? _ref5 : 0) > 0) summary.push([
+        'Tax',
+        money(Number(totals == null ? void 0 : totals.taxCents))
+    ]);
+    summary.push([
+        '<b>Total</b>',
+        `<b>${money(totalCents)}</b>`
+    ]);
+    if (Number((_ref6 = totals == null ? void 0 : totals.tipCents) != null ? _ref6 : 0) > 0) summary.push([
+        'Tip',
+        money(Number(totals == null ? void 0 : totals.tipCents))
+    ]);
+    if (refundedCents > 0) {
+        summary.push([
+            'Refunded',
+            `−${money(refundedCents)}`
+        ]);
+        summary.push([
+            '<b>Net paid</b>',
+            `<b>${money(Math.max(0, totalCents - refundedCents))}</b>`
+        ]);
+    }
+    const block = (title, lines)=>lines.length ? `<td valign="top"><b>${title}</b><br/>${lines.map((line)=>escapeHtml(line)).join('<br/>')}</td>` : '';
+    return `<title>${escapeHtml(`Invoice ${number}`)}</title>` + `<h2>${escapeHtml(store.name || 'Invoice')}</h2>` + `<h3>${escapeHtml(`Invoice ${number}`)}</h3>` + `<p>${createdAt ? `Date: ${escapeHtml(new Date(createdAt).toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric'
+    }))}<br/>` : ''}` + `Payment: ${escapeHtml(invoicePaymentStatus(order))}<br/>Currency: ${escapeHtml(currency)}</p>` + `<table width="100%" cellpadding="6"><tr>${block('Bill to', billTo)}${block('Ship to', shipTo)}</tr></table>` + `<table width="100%" cellpadding="6" border="1" cellspacing="0">` + `<tr><th align="left">Item</th><th align="right">Qty</th><th align="right">Unit price</th><th align="right">Amount</th></tr>` + rows + `</table>` + `<table width="100%" cellpadding="4">${summary.map(([label, value])=>`<tr><td align="right" width="80%">${label}</td><td align="right">${value}</td></tr>`).join('')}</table>` + (store.footer ? `<p>${escapeHtml(store.footer)}</p>` : '') + (store.termsUrl ? `<p><small>Terms: ${escapeHtml(store.termsUrl)}</small></p>` : '');
+}
+
+//# sourceMappingURL=order-invoice.js.map

package/src/lib/utils/order-invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/order-invoice.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  formatOrderNumber,\n  orderCreatedAtMs,\n  type HostOrder,\n  type OrderAddress,\n} from '../model/commerce-orders'\nimport { escapeHtml } from './escape-html'\n\n/**\n * The printable invoice (AGL-3611), beside the packing slip: the order as a\n * bill — who sold it, to whom, each line with its unit price, the totals,\n * what was refunded and what was paid in the end.\n *\n * A string of markup, because it is written into a print popup the way the\n * packing slip is, and the browser's print dialog saves it as a PDF. Every\n * value is escaped: the addresses are typed by the shopper, and the popup\n * inherits the console's origin (AGL-2283). No `<style>` and no `style`\n * attributes, because the popup inherits the console's content security\n * policy; the layout is the table attributes HTML still honors.\n */\n\nexport interface OrderInvoiceStore {\n  /** The business's name, as its emails sign. */\n  name: string\n  /** The store's currency, for an order that does not carry its own. */\n  currency: string\n  /** The receipt footer the store set, printed at the foot. */\n  footer?: string | null\n  /** The store's terms address, printed at the foot. */\n  termsUrl?: string | null\n}\n\ntype InvoiceOrder = Pick<\n  HostOrder,\n  | 'number'\n  | 'status'\n  | 'lineItems'\n  | 'totals'\n  | 'refundedCents'\n  | 'customerName'\n  | 'customerEmail'\n  | 'shippingAddress'\n  | 'billingAddress'\n> & { createdAtMs?: number; currency?: string; amountCents?: number }\n\n/** Money in the order's currency, integer cents in. */\nexport function invoiceMoney(cents: number, currency: string): string {\n  const amount = (Number(cents) || 0) / 100\n  try {\n    return new Intl.NumberFormat('en-US', { style: 'currency', currency: currency || 'USD' }).format(amount)\n  } catch {\n    return `${amount.toFixed(2)} ${String(currency || '').toUpperCase()}`.trim()\n  }\n}\n\nfunction addressLines(address: OrderAddress | undefined | null): string[] {\n  if (!address) return []\n  return [\n    address.name,\n    address.line1,\n    address.line2,\n    [address.city, address.state, address.postalCode].filter(Boolean).join(' '),\n    address.country,\n    address.phone,\n  ]\n    .map((part) => String(part ?? '').trim())\n    .filter(Boolean)\n}\n\n/** What the payment line says. */\nexport function invoicePaymentStatus(order: Pick<InvoiceOrder, 'status' | 'refundedCents' | 'totals' | 'amountCents'>): string {\n  const total = Number(order.totals?.totalCents ?? order.amountCents ?? 0)\n  const refunded = Math.max(0, Number(order.refundedCents ?? 0))\n  const status = String(order.status ?? '')\n  if (status === 'pending' || status === 'draft') return 'Awaiting payment'\n  if (status === 'cancelled') return 'Canceled'\n  if (refunded > 0 && refunded >= total) return 'Refunded'\n  if (refunded > 0) return 'Paid, partially refunded'\n  return 'Paid'\n}\n\n/** The invoice's markup: a full document body, every value escaped. */\nexport function buildOrderInvoiceHtml(input: {\n  order: InvoiceOrder\n  orderId: string\n  store: OrderInvoiceStore\n}): string {\n  const { order, orderId, store } = input\n  const currency = String(order.currency || store.currency || 'USD').toUpperCase()\n  const money = (cents: number) => escapeHtml(invoiceMoney(cents, currency))\n  const number = formatOrderNumber(order, orderId)\n  const createdAt = orderCreatedAtMs(order as never)\n  const totals = order.totals\n  const itemsCents =\n    totals?.itemsCents ??\n    (order.lineItems ?? []).reduce((sum, line) => sum + Number(line.unitAmountCents || 0) * Number(line.quantity || 0), 0)\n  const totalCents = Number(totals?.totalCents ?? order.amountCents ?? itemsCents)\n  const refundedCents = Math.max(0, Number(order.refundedCents ?? 0))\n\n  const billTo = [\n    ...(order.billingAddress ? addressLines(order.billingAddress) : [order.customerName ?? ''].filter(Boolean)),\n    order.customerEmail ?? '',\n  ].filter(Boolean)\n  const shipTo = addressLines(order.shippingAddress)\n\n  const rows = (order.lineItems ?? [])\n    .map((line) => {\n      const quantity = Number(line.quantity) || 0\n      const unit = Number(line.unitAmountCents) || 0\n      const detail = [line.variantLabel ? escapeHtml(line.variantLabel) : '', line.sku ? `SKU ${escapeHtml(line.sku)}` : '']\n        .filter(Boolean)\n        .join(' · ')\n      return (\n        `<tr><td>${escapeHtml(line.name)}${detail ? `<br/><small>${detail}</small>` : ''}</td>` +\n        `<td align=\"right\">${escapeHtml(quantity)}</td>` +\n        `<td align=\"right\">${money(unit)}</td>` +\n        `<td align=\"right\">${money(unit * quantity)}</td></tr>`\n      )\n    })\n    .join('')\n\n  const summary: Array<[string, string]> = [['Subtotal', money(itemsCents)]]\n  if (Number(totals?.discountCents ?? 0) > 0) summary.push(['Discount', `−${money(Number(totals?.discountCents))}`])\n  if (Number(totals?.shippingCents ?? 0) > 0) summary.push(['Shipping', money(Number(totals?.shippingCents))])\n  if (Number(totals?.taxCents ?? 0) > 0) summary.push(['Tax', money(Number(totals?.taxCents))])\n  summary.push(['<b>Total</b>', `<b>${money(totalCents)}</b>`])\n  if (Number(totals?.tipCents ?? 0) > 0) summary.push(['Tip', money(Number(totals?.tipCents))])\n  if (refundedCents > 0) {\n    summary.push(['Refunded', `−${money(refundedCents)}`])\n    summary.push(['<b>Net paid</b>', `<b>${money(Math.max(0, totalCents - refundedCents))}</b>`])\n  }\n\n  const block = (title: string, lines: string[]) =>\n    lines.length ? `<td valign=\"top\"><b>${title}</b><br/>${lines.map((line) => escapeHtml(line)).join('<br/>')}</td>` : ''\n\n  return (\n    `<title>${escapeHtml(`Invoice ${number}`)}</title>` +\n    `<h2>${escapeHtml(store.name || 'Invoice')}</h2>` +\n    `<h3>${escapeHtml(`Invoice ${number}`)}</h3>` +\n    `<p>${createdAt ? `Date: ${escapeHtml(new Date(createdAt).toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' }))}<br/>` : ''}` +\n    `Payment: ${escapeHtml(invoicePaymentStatus(order))}<br/>Currency: ${escapeHtml(currency)}</p>` +\n    `<table width=\"100%\" cellpadding=\"6\"><tr>${block('Bill to', billTo)}${block('Ship to', shipTo)}</tr></table>` +\n    `<table width=\"100%\" cellpadding=\"6\" border=\"1\" cellspacing=\"0\">` +\n    `<tr><th align=\"left\">Item</th><th align=\"right\">Qty</th><th align=\"right\">Unit price</th><th align=\"right\">Amount</th></tr>` +\n    rows +\n    `</table>` +\n    `<table width=\"100%\" cellpadding=\"4\">${summary\n      .map(([label, value]) => `<tr><td align=\"right\" width=\"80%\">${label}</td><td align=\"right\">${value}</td></tr>`)\n      .join('')}</table>` +\n    (store.footer ? `<p>${escapeHtml(store.footer)}</p>` : '') +\n    (store.termsUrl ? `<p><small>Terms: ${escapeHtml(store.termsUrl)}</small></p>` : '')\n  )\n}\n"],"names":["formatOrderNumber","orderCreatedAtMs","escapeHtml","invoiceMoney","cents","currency","amount","Number","Intl","NumberFormat","style","format","toFixed","String","toUpperCase","trim","addressLines","address","name","line1","line2","city","state","postalCode","filter","Boolean","join","country","phone","map","part","invoicePaymentStatus","order","total","totals","totalCents","amountCents","refunded","Math","max","refundedCents","status","buildOrderInvoiceHtml","input","orderId","store","money","number","createdAt","itemsCents","lineItems","reduce","sum","line","unitAmountCents","quantity","billTo","billingAddress","customerName","customerEmail","shipTo","shippingAddress","rows","unit","detail","variantLabel","sku","summary","discountCents","push","shippingCents","taxCents","tipCents","block","title","lines","length","Date","toLocaleDateString","year","month","day","label","value","footer","termsUrl"],"mappings":"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"}

package/src/lib/utils/use-checkout-return-notice.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The shopper-facing half of `server/checkout-status.ts` (AGL-3606): on the
+ * page Stripe returned them to, say plainly when the payment did NOT go
+ * through — a redirect-based method whose bank step failed comes back to the
+ * same `?order=success&session_id=…` a paid order does.
+ *
+ * Silent for a paid session, and on every ordinary page view (no
+ * `session_id`). Both the cart and the product page mount this, so the first
+ * mount claims the session and any sibling stays quiet — one notice, not two.
+ */
+export interface CheckoutReturnNotice {
+    severity: 'warning' | 'info';
+    message: string;
+}
+/** Test seam: the claim set outlives a test otherwise. */
+export declare function __resetCheckoutReturnNotice(): void;
+export declare function checkoutReturnNoticeFor(status: string, paymentStatus: string): CheckoutReturnNotice | null;
+export declare function useCheckoutReturnNotice(hostId: string, siteFetch?: typeof fetch): [CheckoutReturnNotice | null, () => void];

package/src/lib/utils/use-checkout-return-notice.js

@@ -0,0 +1,78 @@
+/**
+ * @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.
+ */ 'use client';
+import { useEffect, useState } from "react";
+const claimed = new Set();
+/** Test seam: the claim set outlives a test otherwise. */ export function __resetCheckoutReturnNotice() {
+    claimed.clear();
+}
+export function checkoutReturnNoticeFor(status, paymentStatus) {
+    if (status === 'open') {
+        return {
+            severity: 'warning',
+            message: 'Your payment was not completed and nothing was charged. Your items are still here, so you can check out again.'
+        };
+    }
+    if (status === 'expired') {
+        return {
+            severity: 'warning',
+            message: 'That checkout expired before it was paid, and nothing was charged. You can check out again.'
+        };
+    }
+    if (status === 'complete' && paymentStatus === 'unpaid') {
+        return {
+            severity: 'info',
+            message: 'Your order was placed. Your payment is still processing.'
+        };
+    }
+    return null;
+}
+export function useCheckoutReturnNotice(hostId, siteFetch = fetch) {
+    const [notice, setNotice] = useState(null);
+    useEffect(()=>{
+        var _params_get;
+        if (typeof window === 'undefined' || !hostId) return;
+        const params = new URLSearchParams(window.location.search);
+        if (params.get('order') !== 'success') return;
+        const sessionId = (_params_get = params.get('session_id')) != null ? _params_get : '';
+        if (!sessionId || claimed.has(sessionId)) return;
+        // Claimed for the document, not the effect run: under StrictMode the
+        // effect runs twice and the second run must not start a second lookup —
+        // nor may the first one's answer be thrown away, which is why there is no
+        // `active` guard (a state update after unmount is a no-op).
+        claimed.add(sessionId);
+        void (async ()=>{
+            try {
+                var _ref, _ref1;
+                const response = await siteFetch(`/api/commerce/checkout-status?hostId=${encodeURIComponent(hostId)}&sessionId=${encodeURIComponent(sessionId)}`);
+                if (!response.ok) return;
+                const body = await response.json();
+                setNotice(checkoutReturnNoticeFor(String((_ref = body == null ? void 0 : body.status) != null ? _ref : ''), String((_ref1 = body == null ? void 0 : body.paymentStatus) != null ? _ref1 : '')));
+            } catch (unused) {
+            // Saying nothing is the pre-existing behavior, and the safe one.
+            }
+        })();
+    }, [
+        hostId,
+        siteFetch
+    ]);
+    return [
+        notice,
+        ()=>setNotice(null)
+    ];
+}
+
+//# sourceMappingURL=use-checkout-return-notice.js.map

package/src/lib/utils/use-checkout-return-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/use-checkout-return-notice.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'use client'\n\nimport { useEffect, useState } from 'react'\n\n/**\n * The shopper-facing half of `server/checkout-status.ts` (AGL-3606): on the\n * page Stripe returned them to, say plainly when the payment did NOT go\n * through — a redirect-based method whose bank step failed comes back to the\n * same `?order=success&session_id=…` a paid order does.\n *\n * Silent for a paid session, and on every ordinary page view (no\n * `session_id`). Both the cart and the product page mount this, so the first\n * mount claims the session and any sibling stays quiet — one notice, not two.\n */\n\nexport interface CheckoutReturnNotice {\n  severity: 'warning' | 'info'\n  message: string\n}\n\nconst claimed = new Set<string>()\n\n/** Test seam: the claim set outlives a test otherwise. */\nexport function __resetCheckoutReturnNotice(): void {\n  claimed.clear()\n}\n\nexport function checkoutReturnNoticeFor(\n  status: string,\n  paymentStatus: string,\n): CheckoutReturnNotice | null {\n  if (status === 'open') {\n    return {\n      severity: 'warning',\n      message:\n        'Your payment was not completed and nothing was charged. Your items are still here, so you can check out again.',\n    }\n  }\n  if (status === 'expired') {\n    return {\n      severity: 'warning',\n      message:\n        'That checkout expired before it was paid, and nothing was charged. You can check out again.',\n    }\n  }\n  if (status === 'complete' && paymentStatus === 'unpaid') {\n    return {\n      severity: 'info',\n      message: 'Your order was placed. Your payment is still processing.',\n    }\n  }\n  return null\n}\n\nexport function useCheckoutReturnNotice(\n  hostId: string,\n  siteFetch: typeof fetch = fetch,\n): [CheckoutReturnNotice | null, () => void] {\n  const [notice, setNotice] = useState<CheckoutReturnNotice | null>(null)\n  useEffect(() => {\n    if (typeof window === 'undefined' || !hostId) return\n    const params = new URLSearchParams(window.location.search)\n    if (params.get('order') !== 'success') return\n    const sessionId = params.get('session_id') ?? ''\n    if (!sessionId || claimed.has(sessionId)) return\n    // Claimed for the document, not the effect run: under StrictMode the\n    // effect runs twice and the second run must not start a second lookup —\n    // nor may the first one's answer be thrown away, which is why there is no\n    // `active` guard (a state update after unmount is a no-op).\n    claimed.add(sessionId)\n    void (async () => {\n      try {\n        const response = await siteFetch(\n          `/api/commerce/checkout-status?hostId=${encodeURIComponent(\n            hostId,\n          )}&sessionId=${encodeURIComponent(sessionId)}`,\n        )\n        if (!response.ok) return\n        const body = (await response.json()) as {\n          status?: string\n          paymentStatus?: string\n        }\n        setNotice(\n          checkoutReturnNoticeFor(\n            String(body?.status ?? ''),\n            String(body?.paymentStatus ?? ''),\n          ),\n        )\n      } catch {\n        // Saying nothing is the pre-existing behavior, and the safe one.\n      }\n    })()\n  }, [hostId, siteFetch])\n  return [notice, () => setNotice(null)]\n}\n"],"names":["useEffect","useState","claimed","Set","__resetCheckoutReturnNotice","clear","checkoutReturnNoticeFor","status","paymentStatus","severity","message","useCheckoutReturnNotice","hostId","siteFetch","fetch","notice","setNotice","params","window","URLSearchParams","location","search","get","sessionId","has","add","response","encodeURIComponent","ok","body","json","String"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;AAEA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAkB3C,MAAMC,UAAU,IAAIC;AAEpB,wDAAwD,GACxD,OAAO,SAASC;IACdF,QAAQG,KAAK;AACf;AAEA,OAAO,SAASC,wBACdC,MAAc,EACdC,aAAqB;IAErB,IAAID,WAAW,QAAQ;QACrB,OAAO;YACLE,UAAU;YACVC,SACE;QACJ;IACF;IACA,IAAIH,WAAW,WAAW;QACxB,OAAO;YACLE,UAAU;YACVC,SACE;QACJ;IACF;IACA,IAAIH,WAAW,cAAcC,kBAAkB,UAAU;QACvD,OAAO;YACLC,UAAU;YACVC,SAAS;QACX;IACF;IACA,OAAO;AACT;AAEA,OAAO,SAASC,wBACdC,MAAc,EACdC,YAA0BC,KAAK;IAE/B,MAAM,CAACC,QAAQC,UAAU,GAAGf,SAAsC;IAClED,UAAU;YAIUiB;QAHlB,IAAI,OAAOC,WAAW,eAAe,CAACN,QAAQ;QAC9C,MAAMK,SAAS,IAAIE,gBAAgBD,OAAOE,QAAQ,CAACC,MAAM;QACzD,IAAIJ,OAAOK,GAAG,CAAC,aAAa,WAAW;QACvC,MAAMC,aAAYN,cAAAA,OAAOK,GAAG,CAAC,yBAAXL,cAA4B;QAC9C,IAAI,CAACM,aAAarB,QAAQsB,GAAG,CAACD,YAAY;QAC1C,qEAAqE;QACrE,wEAAwE;QACxE,0EAA0E;QAC1E,4DAA4D;QAC5DrB,QAAQuB,GAAG,CAACF;QACZ,KAAK,AAAC,CAAA;YACJ,IAAI;;gBACF,MAAMG,WAAW,MAAMb,UACrB,CAAC,qCAAqC,EAAEc,mBACtCf,QACA,WAAW,EAAEe,mBAAmBJ,YAAY;gBAEhD,IAAI,CAACG,SAASE,EAAE,EAAE;gBAClB,MAAMC,OAAQ,MAAMH,SAASI,IAAI;gBAIjCd,UACEV,wBACEyB,eAAOF,wBAAAA,KAAMtB,MAAM,mBAAI,KACvBwB,gBAAOF,wBAAAA,KAAMrB,aAAa,oBAAI;YAGpC,EAAE,eAAM;YACN,iEAAiE;YACnE;QACF,CAAA;IACF,GAAG;QAACI;QAAQC;KAAU;IACtB,OAAO;QAACE;QAAQ,IAAMC,UAAU;KAAM;AACxC"}