@endora-commerce/mod-import-export 0.100.0

package/dist/backend/services/adapters/customers.adapter.d.ts

@@ -0,0 +1,16 @@
+import type { ImportExportAdapter, ImportExportPorts } from '../adapter.js';
+/**
+ * Customer accounts: export only.
+ *
+ * Importing customer accounts safely requires a password-handling story
+ * (random secret + forced reset email) that doesn't belong in a CSV
+ * upload UI. Operators that need to provision accounts in bulk should
+ * use the API + the password-reset flow.
+ *
+ * Feature 075 / D-74 — two owners, because the sheet names an account's
+ * organisation: the entity is offered only while both modules are effectively
+ * present, and `organizations` being off removes this one export rather than
+ * breaking the centre.
+ */
+export declare function customersAdapter(ports: ImportExportPorts): ImportExportAdapter;
+//# sourceMappingURL=customers.adapter.d.ts.map

package/dist/backend/services/adapters/customers.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.adapter.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/adapters/customers.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAqC9E"}

package/dist/backend/services/adapters/customers.adapter.js

@@ -0,0 +1,48 @@
+/**
+ * Customer accounts: export only.
+ *
+ * Importing customer accounts safely requires a password-handling story
+ * (random secret + forced reset email) that doesn't belong in a CSV
+ * upload UI. Operators that need to provision accounts in bulk should
+ * use the API + the password-reset flow.
+ *
+ * Feature 075 / D-74 — two owners, because the sheet names an account's
+ * organisation: the entity is offered only while both modules are effectively
+ * present, and `organizations` being off removes this one export rather than
+ * breaking the centre.
+ */
+export function customersAdapter(ports) {
+    return {
+        name: 'customers',
+        owners: ['customer_accounts', 'organizations'],
+        exportHeader: [
+            'email',
+            'organization_name',
+            'first_name',
+            'last_name',
+            'role',
+            'email_verified_at',
+            'last_login_at',
+        ],
+        async exportRows() {
+            const accounts = await ports.customerAccounts.listAll();
+            if (accounts.length === 0)
+                return [];
+            const orgIds = Array.from(new Set(accounts
+                .map((a) => a.organizationId)
+                .filter((id) => typeof id === 'string' && id.length > 0)));
+            const orgs = orgIds.length > 0 ? await ports.organizations.findByIds(orgIds) : [];
+            const orgNameById = new Map(orgs.map((o) => [o.id, o.name]));
+            return accounts.map((a) => [
+                a.email,
+                a.organizationId ? (orgNameById.get(a.organizationId) ?? '') : '',
+                a.firstName,
+                a.lastName,
+                a.role,
+                a.emailVerifiedAt?.toISOString() ?? '',
+                a.lastLoginAt?.toISOString() ?? '',
+            ]);
+        },
+    };
+}
+//# sourceMappingURL=customers.adapter.js.map

package/dist/backend/services/adapters/customers.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.adapter.js","sourceRoot":"","sources":["../../../../src/backend/services/adapters/customers.adapter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;QAC9C,YAAY,EAAE;YACZ,OAAO;YACP,mBAAmB;YACnB,YAAY;YACZ,WAAW;YACX,MAAM;YACN,mBAAmB;YACnB,eAAe;SACP;QAEV,KAAK,CAAC,UAAU;YACd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CACvB,IAAI,GAAG,CACL,QAAQ;iBACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;iBAC5B,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CACzE,CACF,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACzB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;gBACjE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE;gBACtC,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/adapters/orders.adapter.d.ts

@@ -0,0 +1,13 @@
+import type { ImportExportAdapter, ImportExportPorts } from '../adapter.js';
+/**
+ * Orders: export only.
+ *
+ * Orders are produced by the checkout flow; importing historical orders
+ * into a running system would bypass stock reservation, payment tracking,
+ * audit logging, and the credit-limit reservation lifecycle.
+ *
+ * Feature 075 / D-74 — `OrderReadPort.listAll` was published by Phase P with
+ * "for the bulk export adapter" in its own doc comment. This is that adapter.
+ */
+export declare function ordersAdapter(ports: ImportExportPorts): ImportExportAdapter;
+//# sourceMappingURL=orders.adapter.d.ts.map

package/dist/backend/services/adapters/orders.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.adapter.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/adapters/orders.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAqC3E"}

package/dist/backend/services/adapters/orders.adapter.js

@@ -0,0 +1,48 @@
+/**
+ * Orders: export only.
+ *
+ * Orders are produced by the checkout flow; importing historical orders
+ * into a running system would bypass stock reservation, payment tracking,
+ * audit logging, and the credit-limit reservation lifecycle.
+ *
+ * Feature 075 / D-74 — `OrderReadPort.listAll` was published by Phase P with
+ * "for the bulk export adapter" in its own doc comment. This is that adapter.
+ */
+export function ordersAdapter(ports) {
+    return {
+        name: 'orders',
+        owners: ['orders'],
+        exportHeader: [
+            'id',
+            'placed_at',
+            'organization_id',
+            'placed_by_customer_account_id',
+            'status',
+            'payment_status',
+            'currency',
+            'subtotal',
+            'tax_total',
+            'discount_total',
+            'delivery_total',
+            'total',
+        ],
+        async exportRows() {
+            const orders = await ports.orders.listAll();
+            return orders.map((o) => [
+                o.id,
+                o.placedAt.toISOString(),
+                o.organizationId,
+                o.placedByCustomerAccountId,
+                o.status,
+                o.paymentStatus,
+                o.currency,
+                o.subtotal,
+                o.taxTotal,
+                o.discountTotal,
+                o.deliveryTotal,
+                o.total,
+            ]);
+        },
+    };
+}
+//# sourceMappingURL=orders.adapter.js.map

package/dist/backend/services/adapters/orders.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.adapter.js","sourceRoot":"","sources":["../../../../src/backend/services/adapters/orders.adapter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB;IACpD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EAAE;YACZ,IAAI;YACJ,WAAW;YACX,iBAAiB;YACjB,+BAA+B;YAC/B,QAAQ;YACR,gBAAgB;YAChB,UAAU;YACV,UAAU;YACV,WAAW;YACX,gBAAgB;YAChB,gBAAgB;YAChB,OAAO;SACC;QAEV,KAAK,CAAC,UAAU;YACd,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACvB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE;gBACxB,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,yBAAyB;gBAC3B,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,KAAK;aACR,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/adapters/products.adapter.d.ts

@@ -0,0 +1,16 @@
+import type { ImportExportAdapter, ImportExportPorts } from '../adapter.js';
+/**
+ * Products import/export. The CSV is intentionally flat — multilingual
+ * `name`/`description` collapse to a single locale column (defaults to
+ * `en-US`). Power users who need full multi-locale round-trip should use the
+ * JSON API directly.
+ *
+ * Feature 075 / D-74 — `catalog` owns the write. The two enum columns are
+ * parsed against the **published** schemas rather than a private allow-list
+ * this module kept: the old one still accepted `archived`, a status feature 032
+ * renamed to `inactive` five months ago, and wrote it into a column no other
+ * path can produce it in. `productStatusWriteSchema` is the interactive admin
+ * API's own answer to a legacy `archived` write, so the two paths now agree.
+ */
+export declare function productsAdapter(ports: ImportExportPorts): ImportExportAdapter;
+//# sourceMappingURL=products.adapter.d.ts.map

package/dist/backend/services/adapters/products.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.adapter.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/adapters/products.adapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CA+E7E"}

package/dist/backend/services/adapters/products.adapter.js

@@ -0,0 +1,88 @@
+import { productStatusWriteSchema, productVisibilitySchema, } from '@endora-commerce/contracts';
+/**
+ * Products import/export. The CSV is intentionally flat — multilingual
+ * `name`/`description` collapse to a single locale column (defaults to
+ * `en-US`). Power users who need full multi-locale round-trip should use the
+ * JSON API directly.
+ *
+ * Feature 075 / D-74 — `catalog` owns the write. The two enum columns are
+ * parsed against the **published** schemas rather than a private allow-list
+ * this module kept: the old one still accepted `archived`, a status feature 032
+ * renamed to `inactive` five months ago, and wrote it into a column no other
+ * path can produce it in. `productStatusWriteSchema` is the interactive admin
+ * API's own answer to a legacy `archived` write, so the two paths now agree.
+ */
+export function productsAdapter(ports) {
+    return {
+        name: 'products',
+        owners: ['catalog'],
+        exportHeader: [
+            'id',
+            'sku',
+            'slug',
+            'type',
+            'status',
+            'visibility',
+            'name_en',
+            'description_en',
+        ],
+        async exportRows() {
+            const rows = await ports.catalogProducts.listAll();
+            return rows.map((p) => [
+                p.id,
+                p.sku,
+                p.slug,
+                p.type,
+                p.status,
+                p.visibility,
+                p.name['en-US'] ?? '',
+                p.description['en-US'] ?? '',
+            ]);
+        },
+        importHeader: ['sku', 'status', 'visibility', 'name_en', 'description_en'],
+        async importRows(records) {
+            const errors = [];
+            const rows = [];
+            for (const [index, record] of records.entries()) {
+                const sku = record['sku']?.trim();
+                if (!sku) {
+                    errors.push({ index, reason: 'sku is required' });
+                    continue;
+                }
+                const row = { sku };
+                const statusRaw = record['status']?.trim();
+                if (statusRaw) {
+                    const parsed = productStatusWriteSchema.safeParse(statusRaw);
+                    if (!parsed.success) {
+                        errors.push({ index, reason: `invalid status: ${statusRaw}` });
+                        continue;
+                    }
+                    row.status = parsed.data;
+                }
+                const visibilityRaw = record['visibility']?.trim();
+                if (visibilityRaw) {
+                    const parsed = productVisibilitySchema.safeParse(visibilityRaw);
+                    if (!parsed.success) {
+                        errors.push({ index, reason: `invalid visibility: ${visibilityRaw}` });
+                        continue;
+                    }
+                    row.visibility = parsed.data;
+                }
+                const nameEn = record['name_en'];
+                if (nameEn !== undefined && nameEn !== '')
+                    row.name = { 'en-US': nameEn };
+                const descEn = record['description_en'];
+                if (descEn !== undefined && descEn !== '')
+                    row.description = { 'en-US': descEn };
+                // The `type` field is intentionally not editable post-create — see the
+                // FIELD_IMMUTABLE error code in catalog. Operators changing a product's
+                // structural type should issue a delete + recreate via the API.
+                rows.push(row);
+            }
+            if (errors.length > 0)
+                return { imported: 0, errors };
+            return ports.catalogBulkImport.importProducts(rows);
+        },
+    };
+}
+//# sourceMappingURL=products.adapter.js.map

package/dist/backend/services/adapters/products.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.adapter.js","sourceRoot":"","sources":["../../../../src/backend/services/adapters/products.adapter.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/adapters/stock.adapter.d.ts

@@ -0,0 +1,15 @@
+import type { ImportExportAdapter, ImportExportPorts } from '../adapter.js';
+/**
+ * Stock levels import/export. Reservations are read-only — operators only
+ * edit `on_hand`. The variant column is optional; an empty value addresses
+ * the simple-product baseline level.
+ *
+ * Feature 075 / D-74 — this adapter used to write `inventory`'s `stock_levels`
+ * while this module declared `catalog` and `auth` as its only dependencies, and
+ * it addressed the seeded warehouse by a **copy** of `inventory`'s
+ * deterministic UUID pasted into the function body. Both go with the write: the
+ * rows belong to `inventory`, so `inventory` applies them, and the row a caller
+ * passes names a SKU and a quantity because that is all a spreadsheet knows.
+ */
+export declare function stockAdapter(ports: ImportExportPorts): ImportExportAdapter;
+//# sourceMappingURL=stock.adapter.d.ts.map

package/dist/backend/services/adapters/stock.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.adapter.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/adapters/stock.adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAoD1E"}

package/dist/backend/services/adapters/stock.adapter.js

@@ -0,0 +1,62 @@
+/**
+ * Stock levels import/export. Reservations are read-only — operators only
+ * edit `on_hand`. The variant column is optional; an empty value addresses
+ * the simple-product baseline level.
+ *
+ * Feature 075 / D-74 — this adapter used to write `inventory`'s `stock_levels`
+ * while this module declared `catalog` and `auth` as its only dependencies, and
+ * it addressed the seeded warehouse by a **copy** of `inventory`'s
+ * deterministic UUID pasted into the function body. Both go with the write: the
+ * rows belong to `inventory`, so `inventory` applies them, and the row a caller
+ * passes names a SKU and a quantity because that is all a spreadsheet knows.
+ */
+export function stockAdapter(ports) {
+    return {
+        name: 'stock',
+        owners: ['inventory', 'catalog'],
+        exportHeader: ['product_sku', 'variant_id', 'on_hand', 'reserved'],
+        async exportRows() {
+            // The SKU is `catalog`'s and the level is `inventory`'s, so the export is
+            // two reads and a join here rather than one module knowing the other's
+            // table. A level whose product does not resolve is dropped, exactly as it
+            // was when the join was a `Map` over an entity query.
+            const products = await ports.catalogProducts.listAll();
+            if (products.length === 0)
+                return [];
+            const skuByProductId = new Map(products.map((p) => [p.id, p.sku]));
+            const levels = await ports.inventoryStock.listStockForProducts([...skuByProductId.keys()]);
+            return levels
+                .map((l) => {
+                const sku = skuByProductId.get(l.productId);
+                if (!sku)
+                    return null;
+                return [sku, l.variantId ?? '', String(l.onHand), String(l.reserved)];
+            })
+                .filter((row) => row !== null);
+        },
+        importHeader: ['product_sku', 'variant_id', 'on_hand'],
+        async importRows(records) {
+            const errors = [];
+            const rows = [];
+            for (const [index, record] of records.entries()) {
+                const productSku = record['product_sku']?.trim();
+                if (!productSku) {
+                    errors.push({ index, reason: 'product_sku is required' });
+                    continue;
+                }
+                const onHandRaw = record['on_hand']?.trim();
+                const onHand = onHandRaw ? Number.parseInt(onHandRaw, 10) : NaN;
+                if (Number.isNaN(onHand) || onHand < 0) {
+                    errors.push({ index, reason: `invalid on_hand: ${onHandRaw}` });
+                    continue;
+                }
+                const variantId = record['variant_id']?.trim() || null;
+                rows.push({ productSku, variantId, onHand });
+            }
+            if (errors.length > 0)
+                return { imported: 0, errors };
+            return ports.inventoryStockImport.importStockLevels(rows);
+        },
+    };
+}
+//# sourceMappingURL=stock.adapter.js.map

package/dist/backend/services/adapters/stock.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.adapter.js","sourceRoot":"","sources":["../../../../src/backend/services/adapters/stock.adapter.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/csv-codec.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal RFC 4180 CSV codec (Constitution Principle IV — no new dep).
+ *
+ * Handles quoted fields containing commas, double-quotes, and newlines.
+ * Trades feature breadth for zero dependencies; if a real-world CSV
+ * variant (e.g. semicolon delimiter, BOM marker, Excel quirks) appears in
+ * traffic, that is the trigger to revisit and either extend this codec or
+ * adopt a vetted library with a written justification per Principle IV.
+ */
+export declare function parseCsv(input: string): string[][];
+export declare function serializeCsv(rows: ReadonlyArray<ReadonlyArray<string>>): string;
+/**
+ * Converts a parsed CSV (header row + data rows) into an array of
+ * string-keyed records. Throws on duplicate header keys.
+ */
+export declare function rowsToRecords(rows: string[][]): Array<Record<string, string>>;
+//# sourceMappingURL=csv-codec.d.ts.map

package/dist/backend/services/csv-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-codec.d.ts","sourceRoot":"","sources":["../../../src/backend/services/csv-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CA2ClD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAE/E;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiB7E"}

package/dist/backend/services/csv-codec.js

@@ -0,0 +1,95 @@
+/**
+ * Minimal RFC 4180 CSV codec (Constitution Principle IV — no new dep).
+ *
+ * Handles quoted fields containing commas, double-quotes, and newlines.
+ * Trades feature breadth for zero dependencies; if a real-world CSV
+ * variant (e.g. semicolon delimiter, BOM marker, Excel quirks) appears in
+ * traffic, that is the trigger to revisit and either extend this codec or
+ * adopt a vetted library with a written justification per Principle IV.
+ */
+export function parseCsv(input) {
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    // Strip a leading UTF-8 BOM if Excel emitted one.
+    const text = input.charCodeAt(0) === 0xfeff ? input.slice(1) : input;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (inQuotes) {
+            if (c === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                field += c;
+            }
+            continue;
+        }
+        if (c === '"' && field.length === 0) {
+            inQuotes = true;
+        }
+        else if (c === ',') {
+            row.push(field);
+            field = '';
+        }
+        else if (c === '\r') {
+            // Swallow — the trailing \n closes the row.
+        }
+        else if (c === '\n') {
+            row.push(field);
+            rows.push(row);
+            row = [];
+            field = '';
+        }
+        else {
+            field += c;
+        }
+    }
+    if (field.length > 0 || row.length > 0) {
+        row.push(field);
+        rows.push(row);
+    }
+    return rows;
+}
+export function serializeCsv(rows) {
+    return rows.map((r) => r.map(serializeField).join(',')).join('\n') + '\n';
+}
+function serializeField(value) {
+    if (value.includes('"') ||
+        value.includes(',') ||
+        value.includes('\n') ||
+        value.includes('\r')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+/**
+ * Converts a parsed CSV (header row + data rows) into an array of
+ * string-keyed records. Throws on duplicate header keys.
+ */
+export function rowsToRecords(rows) {
+    if (rows.length === 0)
+        return [];
+    const header = rows[0].map((h) => h.trim());
+    const seen = new Set();
+    for (const h of header) {
+        if (seen.has(h)) {
+            throw new Error(`duplicate header column: "${h}"`);
+        }
+        seen.add(h);
+    }
+    return rows.slice(1).map((row) => {
+        const out = {};
+        header.forEach((key, i) => {
+            out[key] = row[i] ?? '';
+        });
+        return out;
+    });
+}
+//# sourceMappingURL=csv-codec.js.map

package/dist/backend/services/csv-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-codec.js","sourceRoot":"","sources":["../../../src/backend/services/csv-codec.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/import-export-service.d.ts

@@ -0,0 +1,52 @@
+import { type ImportExportEntity } from '@endora-commerce/contracts';
+import type { ImportExportPorts } from './adapter.js';
+/**
+ * ImportExportService — adapter dispatcher.
+ *
+ * Each entity has a single source of truth (the adapter), keeping the
+ * route layer free of per-entity branches.
+ *
+ * **What this module owns after D-74**: the CSV codec, the header validation,
+ * the row numbering, the 400/404/405 envelope and the entity registry. What it
+ * no longer owns is the write — a catalogue import is `catalog`'s transaction
+ * and a stock import is `inventory`'s, because every row of either lands in one
+ * owner's tables. All-or-nothing did not move with it: the owner applies a run
+ * whole or applies none of it, and a column this module rejects stops the run
+ * before the owner is asked at all.
+ *
+ * **Presence is decided per entity** (Principle XVII rule 5). The entity list
+ * used to be a literal in the admin SPA, so an operator who switched `inventory`
+ * off was still offered a Stock import. It is derived from the effective state
+ * here, which is also what makes the module's five `degrades-without`
+ * declarations true instead of decorative.
+ */
+export interface ImportReport {
+    imported: number;
+    errors: Array<{
+        rowNumber: number;
+        reason: string;
+    }>;
+}
+export declare class ImportExportService {
+    private readonly adapters;
+    constructor(ports: ImportExportPorts);
+    /**
+     * The entities this deployment can offer right now: the ones whose every
+     * owner is effectively present. Read per call rather than cached, because an
+     * operator flips a module while the process is running.
+     */
+    listEntities(): ImportExportEntity[];
+    exportToCsv(entity: string): Promise<string>;
+    /**
+     * Apply a CSV file. Either every row lands or none — the owner runs the whole
+     * batch in one transaction. Per-row validation errors are collected and
+     * returned; the presence of any error means nothing was applied, so the
+     * operator can fix the spreadsheet and re-upload deterministically.
+     */
+    importFromCsv(entity: string, csv: string): Promise<ImportReport>;
+    exportHeaderFor(entity: string): readonly string[];
+    importHeaderFor(entity: string): readonly string[] | undefined;
+    private available;
+    private adapterFor;
+}
+//# sourceMappingURL=import-export-service.d.ts.map

package/dist/backend/services/import-export-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-export-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/import-export-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIlF,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAO3E;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAE9C,KAAK,EAAE,iBAAiB;IAUpC;;;;OAIG;IACH,YAAY,IAAI,kBAAkB,EAAE;IAQ9B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlD;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+CvE,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAIlD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS;IAI9D,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;CAiBnB"}

package/dist/backend/services/import-export-service.js

@@ -0,0 +1,100 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { effectiveState } from '@endora-commerce/platform/kernel';
+import { parseCsv, rowsToRecords, serializeCsv } from './csv-codec.js';
+import { productsAdapter } from './adapters/products.adapter.js';
+import { categoriesAdapter } from './adapters/categories.adapter.js';
+import { stockAdapter } from './adapters/stock.adapter.js';
+import { customersAdapter } from './adapters/customers.adapter.js';
+import { ordersAdapter } from './adapters/orders.adapter.js';
+export class ImportExportService {
+    adapters;
+    constructor(ports) {
+        this.adapters = [
+            productsAdapter(ports),
+            categoriesAdapter(ports),
+            stockAdapter(ports),
+            customersAdapter(ports),
+            ordersAdapter(ports),
+        ];
+    }
+    /**
+     * The entities this deployment can offer right now: the ones whose every
+     * owner is effectively present. Read per call rather than cached, because an
+     * operator flips a module while the process is running.
+     */
+    listEntities() {
+        return this.available().map((adapter) => ({
+            name: adapter.name,
+            exportHeader: [...adapter.exportHeader],
+            importHeader: adapter.importHeader ? [...adapter.importHeader] : null,
+        }));
+    }
+    async exportToCsv(entity) {
+        const adapter = this.adapterFor(entity);
+        const rows = await adapter.exportRows();
+        return serializeCsv([Array.from(adapter.exportHeader), ...rows]);
+    }
+    /**
+     * Apply a CSV file. Either every row lands or none — the owner runs the whole
+     * batch in one transaction. Per-row validation errors are collected and
+     * returned; the presence of any error means nothing was applied, so the
+     * operator can fix the spreadsheet and re-upload deterministically.
+     */
+    async importFromCsv(entity, csv) {
+        const adapter = this.adapterFor(entity);
+        if (!adapter.importHeader || !adapter.importRows) {
+            throw new HttpError(405, ERROR_CODES.VALIDATION_FAILED, `Import is not supported for "${entity}".`);
+        }
+        let parsed;
+        try {
+            parsed = parseCsv(csv);
+        }
+        catch (err) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, err instanceof Error ? err.message : 'Failed to parse CSV.');
+        }
+        if (parsed.length === 0) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'CSV is empty.');
+        }
+        const rawHeader = parsed[0].map((h) => h.trim());
+        for (const required of adapter.importHeader) {
+            if (!rawHeader.includes(required)) {
+                throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, `Missing required header column: ${required}`);
+            }
+        }
+        const report = await adapter.importRows(rowsToRecords(parsed));
+        return {
+            imported: report.imported,
+            // Row numbers are 1-based and exclude the header line, matching what
+            // spreadsheet apps display. The owner counts rows from 0 and knows
+            // nothing about a header line, so the translation happens here.
+            errors: report.errors.map((error) => ({
+                rowNumber: error.index + 2,
+                reason: error.reason,
+            })),
+        };
+    }
+    exportHeaderFor(entity) {
+        return this.adapterFor(entity).exportHeader;
+    }
+    importHeaderFor(entity) {
+        return this.adapterFor(entity).importHeader;
+    }
+    available() {
+        return this.adapters.filter((adapter) => adapter.owners.every((owner) => effectiveState.isPresent(owner)));
+    }
+    adapterFor(entity) {
+        const available = this.available();
+        const adapter = available.find((candidate) => candidate.name === entity);
+        if (!adapter) {
+            // Same 404 an unknown slug has always produced, and deliberately so: an
+            // entity whose owner an operator switched off is an entity this
+            // deployment does not have, not one that is broken.
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Unknown import/export entity "${entity}". Supported: ${available
+                .map((candidate) => candidate.name)
+                .join(', ')}.`);
+        }
+        return adapter;
+    }
+}
+//# sourceMappingURL=import-export-service.js.map

package/dist/backend/services/import-export-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-export-service.js","sourceRoot":"","sources":["../../../src/backend/services/import-export-service.ts"],"names":[],"mappings":"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"}