@aglyn/plugins-commerce 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/transfer/transfer-header-actions.component.js

@@ -0,0 +1,79 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TransferResumeImport } from "@aglyn/aglyn/app-utils/transfer-resume-import";
+import { useTransferLauncher } from "@aglyn/aglyn/app-utils/transfer-launcher-context";
+import { Button, Stack } from "@mui/material";
+import { COMMERCE_IMPORTABLE_TRANSFERS } from "./transfer-keys.js";
+/**
+ * A commerce card's Import and Export, for its card header (AGL-3531): the
+ * console's import wizard and export dialog on the card's resource, through
+ * the core launcher. Each shows only when the launcher's `can` says the
+ * person may (AGL-3554) — their access on the site, the resource's
+ * `importRoles` (gift cards: a site's admins) and the workspace's plan —
+ * and Import only for a resource a file may write. Off the console shell
+ * there is no launcher, and nothing renders.
+ */ export function TransferHeaderActions(props) {
+    const { resource, hostId, noun, onImported } = props;
+    const transfer = useTransferLauncher();
+    if (!transfer) return null;
+    const target = {
+        resource,
+        scope: 'host',
+        hostId
+    };
+    const canImport = COMMERCE_IMPORTABLE_TRANSFERS.has(resource) && transfer.can('import', target);
+    const canExport = transfer.can('export', target);
+    if (!canImport && !canExport) return null;
+    const suffix = noun ? ` ${noun}` : '';
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1,
+        children: [
+            canImport ? /*#__PURE__*/ _jsx(TransferResumeImport, _extends({
+                target: target
+            }, onImported ? {
+                onFinished: onImported
+            } : {})) : null,
+            canImport ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>transfer.openImport(_extends({
+                        resource,
+                        scope: 'host',
+                        hostId
+                    }, onImported ? {
+                        onFinished: onImported
+                    } : {})),
+                children: `Import${suffix}`
+            }) : null,
+            canExport ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>transfer.openExport({
+                        resource,
+                        scope: 'host',
+                        hostId
+                    }),
+                children: `Export${suffix}`
+            }) : null
+        ]
+    });
+}
+TransferHeaderActions.displayName = 'TransferHeaderActions';
+export default TransferHeaderActions;
+
+//# sourceMappingURL=transfer-header-actions.component.js.map

package/src/lib/transfer/transfer-header-actions.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/transfer/transfer-header-actions.component.tsx"],"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 { TransferResumeImport } from '@aglyn/aglyn/app-utils/transfer-resume-import'\nimport { useTransferLauncher } from '@aglyn/aglyn/app-utils/transfer-launcher-context'\nimport { Button, Stack } from '@mui/material'\nimport { COMMERCE_IMPORTABLE_TRANSFERS } from './transfer-keys'\n\nexport interface TransferHeaderActionsProps {\n  /** The commerce resource key (`transfer-keys.ts`). */\n  resource: string\n  hostId: string\n  /** What the buttons name, when the card holds more than this resource (\"categories\"). */\n  noun?: string\n  /** Called when the person leaves the import wizard from its results. */\n  onImported?(): void\n}\n\n/**\n * A commerce card's Import and Export, for its card header (AGL-3531): the\n * console's import wizard and export dialog on the card's resource, through\n * the core launcher. Each shows only when the launcher's `can` says the\n * person may (AGL-3554) — their access on the site, the resource's\n * `importRoles` (gift cards: a site's admins) and the workspace's plan —\n * and Import only for a resource a file may write. Off the console shell\n * there is no launcher, and nothing renders.\n */\nexport function TransferHeaderActions(props: TransferHeaderActionsProps) {\n  const { resource, hostId, noun, onImported } = props\n  const transfer = useTransferLauncher()\n  if (!transfer) return null\n  const target = { resource, scope: 'host' as const, hostId }\n  const canImport = COMMERCE_IMPORTABLE_TRANSFERS.has(resource) && transfer.can('import', target)\n  const canExport = transfer.can('export', target)\n  if (!canImport && !canExport) return null\n  const suffix = noun ? ` ${noun}` : ''\n  return (\n    <Stack direction=\"row\" spacing={1}>\n      {/* An import left unfinished, reopened where it stopped (AGL-3549). */}\n      {canImport ? <TransferResumeImport target={target} {...(onImported ? { onFinished: onImported } : {})} /> : null}\n      {canImport ? (\n        <Button\n          size=\"small\"\n          onClick={() =>\n            transfer.openImport({ resource, scope: 'host', hostId, ...(onImported ? { onFinished: onImported } : {}) })\n          }\n        >\n          {`Import${suffix}`}\n        </Button>\n      ) : null}\n      {canExport ? (\n        <Button size=\"small\" onClick={() => transfer.openExport({ resource, scope: 'host', hostId })}>\n          {`Export${suffix}`}\n        </Button>\n      ) : null}\n    </Stack>\n  )\n}\nTransferHeaderActions.displayName = 'TransferHeaderActions'\n\nexport default TransferHeaderActions\n"],"names":["TransferResumeImport","useTransferLauncher","Button","Stack","COMMERCE_IMPORTABLE_TRANSFERS","TransferHeaderActions","props","resource","hostId","noun","onImported","transfer","target","scope","canImport","has","can","canExport","suffix","direction","spacing","onFinished","size","onClick","openImport","openExport","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAEA,SAASA,oBAAoB,QAAQ,gDAA+C;AACpF,SAASC,mBAAmB,QAAQ,mDAAkD;AACtF,SAASC,MAAM,EAAEC,KAAK,QAAQ,gBAAe;AAC7C,SAASC,6BAA6B,QAAQ,qBAAiB;AAY/D;;;;;;;;CAQC,GACD,OAAO,SAASC,sBAAsBC,KAAiC;IACrE,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,IAAI,EAAEC,UAAU,EAAE,GAAGJ;IAC/C,MAAMK,WAAWV;IACjB,IAAI,CAACU,UAAU,OAAO;IACtB,MAAMC,SAAS;QAAEL;QAAUM,OAAO;QAAiBL;IAAO;IAC1D,MAAMM,YAAYV,8BAA8BW,GAAG,CAACR,aAAaI,SAASK,GAAG,CAAC,UAAUJ;IACxF,MAAMK,YAAYN,SAASK,GAAG,CAAC,UAAUJ;IACzC,IAAI,CAACE,aAAa,CAACG,WAAW,OAAO;IACrC,MAAMC,SAAST,OAAO,CAAC,CAAC,EAAEA,MAAM,GAAG;IACnC,qBACE,MAACN;QAAMgB,WAAU;QAAMC,SAAS;;YAE7BN,0BAAY,KAACd;gBAAqBY,QAAQA;eAAaF,aAAa;gBAAEW,YAAYX;YAAW,IAAI,CAAC,MAAS;YAC3GI,0BACC,KAACZ;gBACCoB,MAAK;gBACLC,SAAS,IACPZ,SAASa,UAAU,CAAC;wBAAEjB;wBAAUM,OAAO;wBAAQL;uBAAYE,aAAa;wBAAEW,YAAYX;oBAAW,IAAI,CAAC;0BAGvG,CAAC,MAAM,EAAEQ,QAAQ;iBAElB;YACHD,0BACC,KAACf;gBAAOoB,MAAK;gBAAQC,SAAS,IAAMZ,SAASc,UAAU,CAAC;wBAAElB;wBAAUM,OAAO;wBAAQL;oBAAO;0BACvF,CAAC,MAAM,EAAEU,QAAQ;iBAElB;;;AAGV;AACAb,sBAAsBqB,WAAW,GAAG;AAEpC,eAAerB,sBAAqB"}

package/src/lib/transfer/transfer-keys.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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.
+ */
+export declare const COMMERCE_PRODUCTS_TRANSFER = "commerce.products";
+export declare const COMMERCE_ORDERS_TRANSFER = "commerce.orders";
+export declare const COMMERCE_DISCOUNTS_TRANSFER = "commerce.discounts";
+export declare const COMMERCE_COUPONS_TRANSFER = "commerce.coupons";
+export declare const COMMERCE_GIFT_CARDS_TRANSFER = "commerce.gift-cards";
+export declare const COMMERCE_CATEGORIES_TRANSFER = "commerce.categories";
+/** Every commerce resource key, in the order the hub lists them. */
+export declare const COMMERCE_TRANSFER_RESOURCES: readonly ["commerce.products", "commerce.categories", "commerce.orders", "commerce.discounts", "commerce.coupons", "commerce.gift-cards"];
+/** The resources a file may write; the others are exported only. */
+export declare const COMMERCE_IMPORTABLE_TRANSFERS: ReadonlySet<string>;
+/**
+ * The gift card import's Confirm step (AGL-3551), and the key its answer
+ * rides under in the wizard's `extras`: the total value typed back.
+ */
+export declare const GIFT_CARD_CONFIRM_STEP_ID = "gift-card-total";

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

@@ -0,0 +1,56 @@
+/**
+ * @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 COMMERCE TRANSFER RESOURCES (AGL-3531), by the key each is declared
+ * under in `plugins.config.json` (`transferResources`). Every one is a site's
+ * records (`scope: host`); the console's lists open the import wizard and the
+ * export dialog on these keys through the core launcher.
+ *
+ * | key | import | why |
+ * | -- | -- | -- |
+ * | products | yes | matched by handle, then SKU, then ID; a match is updated |
+ * | categories | yes | matched by slug, then name, then ID |
+ * | discounts | yes | matched by code, then name, then ID; new ones start switched off |
+ * | coupons | yes | matched by code; new ones start switched off |
+ * | orders | no | an order is the record of a sale, written by checkout alone |
+ * | gift cards | yes, by issuing | each row issues a card through the issue path, confirmed by its total; owners and admins only |
+ */ export const COMMERCE_PRODUCTS_TRANSFER = 'commerce.products';
+export const COMMERCE_ORDERS_TRANSFER = 'commerce.orders';
+export const COMMERCE_DISCOUNTS_TRANSFER = 'commerce.discounts';
+export const COMMERCE_COUPONS_TRANSFER = 'commerce.coupons';
+export const COMMERCE_GIFT_CARDS_TRANSFER = 'commerce.gift-cards';
+export const COMMERCE_CATEGORIES_TRANSFER = 'commerce.categories';
+/** Every commerce resource key, in the order the hub lists them. */ export const COMMERCE_TRANSFER_RESOURCES = [
+    COMMERCE_PRODUCTS_TRANSFER,
+    COMMERCE_CATEGORIES_TRANSFER,
+    COMMERCE_ORDERS_TRANSFER,
+    COMMERCE_DISCOUNTS_TRANSFER,
+    COMMERCE_COUPONS_TRANSFER,
+    COMMERCE_GIFT_CARDS_TRANSFER
+];
+/** The resources a file may write; the others are exported only. */ export const COMMERCE_IMPORTABLE_TRANSFERS = new Set([
+    COMMERCE_PRODUCTS_TRANSFER,
+    COMMERCE_CATEGORIES_TRANSFER,
+    COMMERCE_DISCOUNTS_TRANSFER,
+    COMMERCE_COUPONS_TRANSFER,
+    COMMERCE_GIFT_CARDS_TRANSFER
+]);
+/**
+ * The gift card import's Confirm step (AGL-3551), and the key its answer
+ * rides under in the wizard's `extras`: the total value typed back.
+ */ export const GIFT_CARD_CONFIRM_STEP_ID = 'gift-card-total';
+
+//# sourceMappingURL=transfer-keys.js.map

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

@@ -0,0 +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"}

package/src/lib/model/commerce-io.d.ts

@@ -1,36 +0,0 @@
-/**
- * @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.
- */
-/**
- * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV
- * dialect — the migration wedge for switchers: `Handle` groups variant
- * rows into one product, `Option1..3 Name/Value` build the option axes,
- * `Variant *` columns carry per-variant data, and repeated-handle rows
- * with only `Image Src` add media. Export mirrors the same columns so
- * round-trips are lossless for the fields both sides share.
- */
-import { type HostProduct } from './commerce';
-export declare const PRODUCT_CSV_HEADER: readonly ["Handle", "Title", "Body (HTML)", "Type", "Tags", "Published", "Option1 Name", "Option1 Value", "Option2 Name", "Option2 Value", "Option3 Name", "Option3 Value", "Variant SKU", "Variant Barcode", "Variant Price", "Variant Compare At Price", "Variant Inventory Qty", "Variant Grams", "Image Src"];
-/** One row per variant; extra image rows follow Shopify's convention. */
-export declare function productsToCsv(products: Array<HostProduct & {
-    $id?: string;
-}>): string;
-export interface ProductCsvImport {
-    products: HostProduct[];
-    /** Row-anchored problems; importable products still parse. */
-    errors: string[];
-}
-export declare function parseProductsCsv(text: string): ProductCsvImport;

package/src/lib/model/commerce-io.js

@@ -1,245 +0,0 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV
- * dialect — the migration wedge for switchers: `Handle` groups variant
- * rows into one product, `Option1..3 Name/Value` build the option axes,
- * `Variant *` columns carry per-variant data, and repeated-handle rows
- * with only `Image Src` add media. Export mirrors the same columns so
- * round-trips are lossless for the fields both sides share.
- */ import { commerceSlug, validateProduct } from "./commerce.js";
-import { parseCsv } from "@aglyn/aglyn/app-utils/csv";
-export const PRODUCT_CSV_HEADER = [
-    'Handle',
-    'Title',
-    'Body (HTML)',
-    'Type',
-    'Tags',
-    'Published',
-    'Option1 Name',
-    'Option1 Value',
-    'Option2 Name',
-    'Option2 Value',
-    'Option3 Name',
-    'Option3 Value',
-    'Variant SKU',
-    'Variant Barcode',
-    'Variant Price',
-    'Variant Compare At Price',
-    'Variant Inventory Qty',
-    'Variant Grams',
-    'Image Src'
-];
-function csvCell(value) {
-    const text = value == null ? '' : String(value);
-    return /[",\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
-}
-/** One row per variant; extra image rows follow Shopify's convention. */ export function productsToCsv(products) {
-    const lines = [
-        PRODUCT_CSV_HEADER.join(',')
-    ];
-    for (const product of products){
-        var _product_options, _product_mediaUrls;
-        const options = (_product_options = product.options) != null ? _product_options : [];
-        product.variants.forEach((variant, index)=>{
-            var _product_description, _product_tags, _variant_sku, _variant_barcode, _variant_compareAtPriceUsd, _variant_inventory, _variant_weightGrams, _ref;
-            var _product_mediaUrls;
-            const optionCells = [];
-            for(let axis = 0; axis < 3; axis += 1){
-                var _ref1, _ref2;
-                var _variant_options;
-                const option = options[axis];
-                optionCells.push(index === 0 ? (_ref1 = option == null ? void 0 : option.name) != null ? _ref1 : '' : '', option ? (_ref2 = (_variant_options = variant.options) == null ? void 0 : _variant_options[option.name]) != null ? _ref2 : '' : '');
-            }
-            lines.push([
-                csvCell(product.slug),
-                csvCell(index === 0 ? product.name : ''),
-                csvCell(index === 0 ? (_product_description = product.description) != null ? _product_description : '' : ''),
-                csvCell(index === 0 ? product.type : ''),
-                csvCell(index === 0 ? ((_product_tags = product.tags) != null ? _product_tags : []).join(', ') : ''),
-                csvCell(index === 0 ? String(product.status === 'active') : ''),
-                ...optionCells.map(csvCell),
-                csvCell((_variant_sku = variant.sku) != null ? _variant_sku : ''),
-                csvCell((_variant_barcode = variant.barcode) != null ? _variant_barcode : ''),
-                csvCell(variant.priceUsd),
-                csvCell((_variant_compareAtPriceUsd = variant.compareAtPriceUsd) != null ? _variant_compareAtPriceUsd : ''),
-                csvCell((_variant_inventory = variant.inventory) != null ? _variant_inventory : ''),
-                csvCell((_variant_weightGrams = variant.weightGrams) != null ? _variant_weightGrams : ''),
-                csvCell(index === 0 ? (_ref = (_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls[0]) != null ? _ref : '' : '')
-            ].join(','));
-        });
-        for (const url of ((_product_mediaUrls = product.mediaUrls) != null ? _product_mediaUrls : []).slice(1)){
-            lines.push([
-                csvCell(product.slug),
-                ...Array(PRODUCT_CSV_HEADER.length - 2).fill(''),
-                csvCell(url)
-            ].join(','));
-        }
-    }
-    return lines.join('\n');
-}
-/** Case-insensitive column lookup so hand-edited headers still map. */ function headerIndex(header) {
-    const map = new Map();
-    header.forEach((cell, index)=>map.set(cell.trim().toLowerCase(), index));
-    return map;
-}
-export function parseProductsCsv(text) {
-    const rows = parseCsv(text);
-    if (rows.length < 2) {
-        return {
-            products: [],
-            errors: [
-                'No data rows found'
-            ]
-        };
-    }
-    const columns = headerIndex(rows[0]);
-    const cell = (row, name)=>{
-        var _row_index;
-        const index = columns.get(name.toLowerCase());
-        return index == null ? '' : ((_row_index = row[index]) != null ? _row_index : '').trim();
-    };
-    if (!columns.has('handle') || !columns.has('title')) {
-        return {
-            products: [],
-            errors: [
-                'Missing required columns: Handle, Title'
-            ]
-        };
-    }
-    const byHandle = new Map();
-    const errors = [];
-    rows.slice(1).forEach((row, rowIndex)=>{
-        var _product_mediaUrls;
-        const line = rowIndex + 2;
-        const handle = commerceSlug(cell(row, 'handle'));
-        if (!handle) {
-            if (row.some((value)=>value.trim())) {
-                errors.push(`Row ${line}: missing Handle`);
-            }
-            return;
-        }
-        let product = byHandle.get(handle);
-        const title = cell(row, 'title');
-        if (!product) {
-            if (!title) {
-                // Image-only continuation row for a product we never saw.
-                errors.push(`Row ${line}: first row for "${handle}" needs a Title`);
-                return;
-            }
-            const published = cell(row, 'published').toLowerCase();
-            const type = cell(row, 'type').toLowerCase();
-            product = {
-                name: title,
-                slug: handle,
-                description: cell(row, 'body (html)') || undefined,
-                type: [
-                    'physical',
-                    'digital',
-                    'service'
-                ].includes(type) ? type : 'physical',
-                status: published === 'false' ? 'draft' : 'active',
-                tags: cell(row, 'tags') ? cell(row, 'tags').split(',').map((tag)=>tag.trim()).filter(Boolean) : undefined,
-                options: [],
-                variants: [],
-                mediaUrls: []
-            };
-            byHandle.set(handle, product);
-        }
-        const imageSrc = cell(row, 'image src');
-        if (imageSrc && !((_product_mediaUrls = product.mediaUrls) != null ? _product_mediaUrls : []).includes(imageSrc)) {
-            var _product_mediaUrls1;
-            product.mediaUrls = [
-                ...(_product_mediaUrls1 = product.mediaUrls) != null ? _product_mediaUrls1 : [],
-                imageSrc
-            ];
-        }
-        const priceRaw = cell(row, 'variant price');
-        const hasVariant = priceRaw !== '' || cell(row, 'variant sku') !== '';
-        if (!hasVariant) return;
-        const options = {};
-        for(let axis = 1; axis <= 3; axis += 1){
-            var _product_options_;
-            const name = cell(row, `option${axis} name`);
-            const value = cell(row, `option${axis} value`);
-            if (name && product.options[axis - 1] == null) {
-                product.options[axis - 1] = {
-                    name,
-                    values: []
-                };
-            }
-            const optionName = (_product_options_ = product.options[axis - 1]) == null ? void 0 : _product_options_.name;
-            if (optionName && value) {
-                options[optionName] = value;
-                const axisOption = product.options[axis - 1];
-                if (!axisOption.values.includes(value)) {
-                    axisOption.values.push(value);
-                }
-            }
-        }
-        const price = Number(priceRaw);
-        if (!Number.isFinite(price) || price < 0) {
-            errors.push(`Row ${line}: invalid Variant Price "${priceRaw}"`);
-            return;
-        }
-        const qtyRaw = cell(row, 'variant inventory qty');
-        const compareRaw = cell(row, 'variant compare at price');
-        const gramsRaw = cell(row, 'variant grams');
-        const variant = _extends({
-            id: `v${product.variants.length + 1}`
-        }, Object.keys(options).length ? {
-            options
-        } : {}, {
-            priceUsd: price
-        }, cell(row, 'variant sku') ? {
-            sku: cell(row, 'variant sku')
-        } : {}, cell(row, 'variant barcode') ? {
-            barcode: cell(row, 'variant barcode')
-        } : {}, compareRaw && Number.isFinite(Number(compareRaw)) ? {
-            compareAtPriceUsd: Number(compareRaw)
-        } : {}, {
-            inventory: qtyRaw === '' ? null : Math.max(0, Math.round(Number(qtyRaw)))
-        }, gramsRaw && Number.isFinite(Number(gramsRaw)) ? {
-            weightGrams: Number(gramsRaw)
-        } : {});
-        product.variants.push(variant);
-    });
-    const products = [];
-    for (const [handle, product] of byHandle){
-        var _product_options, _ref;
-        var _product_mediaUrls;
-        product.options = ((_product_options = product.options) != null ? _product_options : []).filter(Boolean);
-        if (product.options.length === 0) delete product.options;
-        if (((_ref = (_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls.length) != null ? _ref : 0) === 0) delete product.mediaUrls;
-        if (product.variants.length === 0) {
-            errors.push(`"${handle}": no variant rows (needs Variant Price)`);
-            continue;
-        }
-        const problem = validateProduct(product);
-        if (problem) {
-            errors.push(`"${handle}": ${problem}`);
-            continue;
-        }
-        products.push(product);
-    }
-    return {
-        products,
-        errors
-    };
-}
-
-//# sourceMappingURL=commerce-io.js.map

package/src/lib/model/commerce-io.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-io.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 * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV\n * dialect — the migration wedge for switchers: `Handle` groups variant\n * rows into one product, `Option1..3 Name/Value` build the option axes,\n * `Variant *` columns carry per-variant data, and repeated-handle rows\n * with only `Image Src` add media. Export mirrors the same columns so\n * round-trips are lossless for the fields both sides share.\n */\n\nimport {\n  commerceSlug,\n  validateProduct,\n  type HostProduct,\n  type ProductOption,\n  type ProductStatus,\n  type ProductVariant,\n} from './commerce'\nimport { parseCsv } from '@aglyn/aglyn/app-utils/csv'\n\nexport const PRODUCT_CSV_HEADER = [\n  'Handle',\n  'Title',\n  'Body (HTML)',\n  'Type',\n  'Tags',\n  'Published',\n  'Option1 Name',\n  'Option1 Value',\n  'Option2 Name',\n  'Option2 Value',\n  'Option3 Name',\n  'Option3 Value',\n  'Variant SKU',\n  'Variant Barcode',\n  'Variant Price',\n  'Variant Compare At Price',\n  'Variant Inventory Qty',\n  'Variant Grams',\n  'Image Src',\n] as const\n\nfunction csvCell(value: unknown): string {\n  const text = value == null ? '' : String(value)\n  return /[\",\\n]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n}\n\n/** One row per variant; extra image rows follow Shopify's convention. */\nexport function productsToCsv(\n  products: Array<HostProduct & { $id?: string }>,\n): string {\n  const lines = [PRODUCT_CSV_HEADER.join(',')]\n  for (const product of products) {\n    const options = product.options ?? []\n    product.variants.forEach((variant, index) => {\n      const optionCells: string[] = []\n      for (let axis = 0; axis < 3; axis += 1) {\n        const option = options[axis]\n        optionCells.push(\n          index === 0 ? (option?.name ?? '') : '',\n          option ? (variant.options?.[option.name] ?? '') : '',\n        )\n      }\n      lines.push(\n        [\n          csvCell(product.slug),\n          csvCell(index === 0 ? product.name : ''),\n          csvCell(index === 0 ? (product.description ?? '') : ''),\n          csvCell(index === 0 ? product.type : ''),\n          csvCell(index === 0 ? (product.tags ?? []).join(', ') : ''),\n          csvCell(index === 0 ? String(product.status === 'active') : ''),\n          ...optionCells.map(csvCell),\n          csvCell(variant.sku ?? ''),\n          csvCell(variant.barcode ?? ''),\n          csvCell(variant.priceUsd),\n          csvCell(variant.compareAtPriceUsd ?? ''),\n          csvCell(variant.inventory ?? ''),\n          csvCell(variant.weightGrams ?? ''),\n          csvCell(index === 0 ? (product.mediaUrls?.[0] ?? '') : ''),\n        ].join(','),\n      )\n    })\n    for (const url of (product.mediaUrls ?? []).slice(1)) {\n      lines.push(\n        [\n          csvCell(product.slug),\n          ...Array(PRODUCT_CSV_HEADER.length - 2).fill(''),\n          csvCell(url),\n        ].join(','),\n      )\n    }\n  }\n  return lines.join('\\n')\n}\n\nexport interface ProductCsvImport {\n  products: HostProduct[]\n  /** Row-anchored problems; importable products still parse. */\n  errors: string[]\n}\n\n/** Case-insensitive column lookup so hand-edited headers still map. */\nfunction headerIndex(header: string[]): Map<string, number> {\n  const map = new Map<string, number>()\n  header.forEach((cell, index) =>\n    map.set(cell.trim().toLowerCase(), index),\n  )\n  return map\n}\n\nexport function parseProductsCsv(text: string): ProductCsvImport {\n  const rows = parseCsv(text)\n  if (rows.length < 2) {\n    return { products: [], errors: ['No data rows found'] }\n  }\n  const columns = headerIndex(rows[0])\n  const cell = (row: string[], name: string): string => {\n    const index = columns.get(name.toLowerCase())\n    return index == null ? '' : (row[index] ?? '').trim()\n  }\n  if (!columns.has('handle') || !columns.has('title')) {\n    return {\n      products: [],\n      errors: ['Missing required columns: Handle, Title'],\n    }\n  }\n\n  const byHandle = new Map<string, HostProduct>()\n  const errors: string[] = []\n  rows.slice(1).forEach((row, rowIndex) => {\n    const line = rowIndex + 2\n    const handle = commerceSlug(cell(row, 'handle'))\n    if (!handle) {\n      if (row.some((value) => value.trim())) {\n        errors.push(`Row ${line}: missing Handle`)\n      }\n      return\n    }\n    let product = byHandle.get(handle)\n    const title = cell(row, 'title')\n    if (!product) {\n      if (!title) {\n        // Image-only continuation row for a product we never saw.\n        errors.push(`Row ${line}: first row for \"${handle}\" needs a Title`)\n        return\n      }\n      const published = cell(row, 'published').toLowerCase()\n      const type = cell(row, 'type').toLowerCase()\n      product = {\n        name: title,\n        slug: handle,\n        description: cell(row, 'body (html)') || undefined,\n        type: ['physical', 'digital', 'service'].includes(type)\n          ? (type as HostProduct['type'])\n          : 'physical',\n        status: (published === 'false'\n          ? 'draft'\n          : 'active') as ProductStatus,\n        tags: cell(row, 'tags')\n          ? cell(row, 'tags')\n              .split(',')\n              .map((tag) => tag.trim())\n              .filter(Boolean)\n          : undefined,\n        options: [],\n        variants: [],\n        mediaUrls: [],\n      }\n      byHandle.set(handle, product)\n    }\n\n    const imageSrc = cell(row, 'image src')\n    if (imageSrc && !(product.mediaUrls ?? []).includes(imageSrc)) {\n      product.mediaUrls = [...(product.mediaUrls ?? []), imageSrc]\n    }\n\n    const priceRaw = cell(row, 'variant price')\n    const hasVariant = priceRaw !== '' || cell(row, 'variant sku') !== ''\n    if (!hasVariant) return\n\n    const options: Record<string, string> = {}\n    for (let axis = 1; axis <= 3; axis += 1) {\n      const name = cell(row, `option${axis} name`)\n      const value = cell(row, `option${axis} value`)\n      if (name && product.options![axis - 1] == null) {\n        product.options![axis - 1] = { name, values: [] }\n      }\n      const optionName = product.options![axis - 1]?.name\n      if (optionName && value) {\n        options[optionName] = value\n        const axisOption = product.options![axis - 1] as ProductOption\n        if (!axisOption.values.includes(value)) {\n          axisOption.values.push(value)\n        }\n      }\n    }\n\n    const price = Number(priceRaw)\n    if (!Number.isFinite(price) || price < 0) {\n      errors.push(`Row ${line}: invalid Variant Price \"${priceRaw}\"`)\n      return\n    }\n    const qtyRaw = cell(row, 'variant inventory qty')\n    const compareRaw = cell(row, 'variant compare at price')\n    const gramsRaw = cell(row, 'variant grams')\n    const variant: ProductVariant = {\n      id: `v${product.variants.length + 1}`,\n      ...(Object.keys(options).length ? { options } : {}),\n      priceUsd: price,\n      ...(cell(row, 'variant sku') ? { sku: cell(row, 'variant sku') } : {}),\n      ...(cell(row, 'variant barcode')\n        ? { barcode: cell(row, 'variant barcode') }\n        : {}),\n      ...(compareRaw && Number.isFinite(Number(compareRaw))\n        ? { compareAtPriceUsd: Number(compareRaw) }\n        : {}),\n      inventory: qtyRaw === '' ? null : Math.max(0, Math.round(Number(qtyRaw))),\n      ...(gramsRaw && Number.isFinite(Number(gramsRaw))\n        ? { weightGrams: Number(gramsRaw) }\n        : {}),\n    }\n    product.variants.push(variant)\n  })\n\n  const products: HostProduct[] = []\n  for (const [handle, product] of byHandle) {\n    product.options = (product.options ?? []).filter(Boolean)\n    if (product.options.length === 0) delete product.options\n    if ((product.mediaUrls?.length ?? 0) === 0) delete product.mediaUrls\n    if (product.variants.length === 0) {\n      errors.push(`\"${handle}\": no variant rows (needs Variant Price)`)\n      continue\n    }\n    const problem = validateProduct(product)\n    if (problem) {\n      errors.push(`\"${handle}\": ${problem}`)\n      continue\n    }\n    products.push(product)\n  }\n  return { products, errors }\n}\n"],"names":["commerceSlug","validateProduct","parseCsv","PRODUCT_CSV_HEADER","csvCell","value","text","String","test","replace","productsToCsv","products","lines","join","product","options","variants","forEach","variant","index","optionCells","axis","option","push","name","slug","description","type","tags","status","map","sku","barcode","priceUsd","compareAtPriceUsd","inventory","weightGrams","mediaUrls","url","slice","Array","length","fill","headerIndex","header","Map","cell","set","trim","toLowerCase","parseProductsCsv","rows","errors","columns","row","get","has","byHandle","rowIndex","line","handle","some","title","published","undefined","includes","split","tag","filter","Boolean","imageSrc","priceRaw","hasVariant","values","optionName","axisOption","price","Number","isFinite","qtyRaw","compareRaw","gramsRaw","id","Object","keys","Math","max","round","problem"],"mappings":"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"}

package/src/lib/server/contact-refund.d.ts

@@ -1,117 +0,0 @@
-/**
- * @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.
- */
-/**
- * Money going BACK to a customer, recorded on their contact (AGL-1754).
- *
- * `upsertHostContact` accumulates `ltvCents` and nothing anywhere decremented
- * it, so a customer who bought $500 and returned all of it read identically to
- * one who bought $500 and kept it — and the first surface built on the field
- * (RFM segmentation, a lifetime-value column, a best-customers list) would have
- * ranked a serial returner among the merchant's best customers.
- *
- * WHAT THIS WRITES, AND WHY IT IS NOT A DECREMENT
- *
- * `ltvCents` is left exactly as it is and the reversal is recorded BESIDE it:
- *
- * | field | meaning |
- * | -- | -- |
- * | `ltvCents` | gross money handed over, unchanged (AGL-1748) |
- * | `refundedCents` | gross money handed back |
- * | `ordersCount` | orders placed, unchanged |
- * | `refundedOrdersCount` | of those, how many ended fully reversed |
- * | `lastRefundAtMs` | when money last went back |
- *
- * This is the shape AGL-1747 chose two days earlier for the same question on
- * the orders CSV — `amountUsd` stayed gross under its existing name and
- * `refundedUsd`/`netUsd` were appended — and it is the shape AGL-1748 named
- * when it recorded the gross semantics in `upsert-contact.ts`. Netting in
- * place would make a stored number mean one thing for rows written before this
- * commit and another for rows written after, with nothing on the document to
- * tell the two apart. Two fields cost one number's worth of storage and keep
- * both facts, and a reader that wants the net has `ltvCents - refundedCents`.
- *
- * It also answers "can it go negative?" by moving the question off storage.
- * Both figures are monotonic counters of money that actually moved in one
- * direction, so neither can go negative. The DERIVED net can, for exactly one
- * reason: an order placed before AGL-1748 taught POS, drafts, reservations and
- * bookings to pass `purchaseCents` at all, whose sale was never added and whose
- * refund is subtracted here. That is a true statement about the data, and
- * clamping it away at write time would erase the only evidence that a purchase
- * is missing. AGL-1753 is the backfill that reconciles it, by SETTING both
- * fields from the orders — which already carry `refundedCents`, so whatever a
- * reader decides here costs the rebuild nothing. A merchant-facing reader
- * should show gross and refunded, and clamp only the net it ranks on.
- *
- * `ordersCount` is deliberately NOT decremented. A fully refunded order still
- * happened, and a decrement cannot be undone by a reader that would rather
- * count it — while `refundedOrdersCount` beside it lets RFM's frequency term
- * net the two, or not, at the point of display. Same argument as the amount,
- * one field along.
- *
- * WHEN THE CONTACT IS MISSING, THIS REFUSES — and records the refusal.
- *
- * Refusing is right on AGL-1732's test, "does refusing discard money or work
- * that already happened?", because it does not: the refund is durable on the
- * order (`refundedCents`, the timeline entry, Stripe), and the contact is a
- * derived aggregate that AGL-1753's rebuild reads back out of those same
- * orders. Creating one here would be worse three ways — creation is audience
- * BAND gated, so it hard-bands a Free org (raising the AGL-891 dropped-contacts
- * alert for a record the merchant never had) or meters onto a paid invoice; the
- * contact it created would hold a refund and no purchase, which is the negative
- * lifetime value above with nothing to reconcile it against; and it is the
- * phantom-document shape the `updateExisting` sweep spent yesterday closing.
- *
- * So the write is an `update()`, never `set(…, { merge: true })` — the contact
- * may have been deleted between the query and the write, and a merge-set would
- * resurrect it as a document holding nothing but a refund. Every refusal
- * increments `hosts/{hostId}/counters/contactRefundsUnmatched`, the counter
- * shape `contactsDropped` already uses, so a refund that reached no contact is
- * countable rather than silent.
- *
- * CHARGEBACKS (AGL-1554) are a separate decision and are NOT handled here.
- * This takes `kind` so the handler that eventually answers
- * `charge.dispute.closed` can record a lost dispute through the same writer
- * with the same fields: money reversed is money reversed, whichever door it
- * left by, and only the wording of the timeline entry differs.
- */
-export declare function recordContactRefund(options: {
-    hostId: string;
-    /** The order the money went back on — the contact timeline's `refId`. */
-    orderId: string;
-    /**
-     * The buyer as the ORDER recorded them, raw. Normalized here, because that
-     * is the key the contacts collection is stored under and orders are not
-     * consistent about it (AGL-1753 item 3). No `name` rides along on purpose: a
-     * refund is not a capture point and must not rewrite who the contact is.
-     */
-    email: unknown;
-    /**
-     * Cents reversed by THIS attempt, never the order total. `refund.ts` caps
-     * each attempt against what is left, so several partials on one order sum to
-     * at most the order total; this follows that number rather than recomputing
-     * it.
-     */
-    amountCents: number;
-    /**
-     * True only for the write that moved the order INTO `refunded`. Two partials
-     * settling concurrently can both observe a fully refunded total, so the
-     * caller decides this from the status transition it made, not from the
-     * total it read.
-     */
-    closedTheOrder: boolean;
-    kind?: 'refund' | 'chargeback';
-}): Promise<void>;