@cogenta/commerce 0.2.0 → 0.4.3

package/dist/catalog/csv.js

@@ -0,0 +1,396 @@
+import { isCogentaError } from '@cogenta/core';
+import { minorUnitExponent, normaliseCurrency } from '../money.js';
+/**
+ * CSV import/export for the catalogue (fiche 51 task 6), following the exact
+ * shape `@cogenta/api`'s redirect router already established for its own CSV
+ * feature: a hand-written, zero-dependency reader/writer (R9 — the whole
+ * feature is quoted fields, embedded commas/newlines and doubled-quote
+ * escaping), a header row matched **by name**, case-insensitively and in any
+ * order (the "correspondance de colonnes" the fiche asks for — a real export
+ * from another shop or from a spreadsheet a person reordered still imports),
+ * and a strict two-call preview/apply split: nothing is written until a
+ * caller that has already seen `outcome` for every row asks a second time
+ * with `apply: true`.
+ *
+ * One row is one variant. A product is looked up (or created) by `handle`;
+ * several rows sharing a handle add several variants to the same product —
+ * only the first row that creates the product uses its `title`/`status`
+ * columns, later rows for the same still-new handle reuse what the first
+ * row already decided.
+ */
+const HEADER = [
+    'handle',
+    'title',
+    'status',
+    'sku',
+    'variant',
+    'price',
+    'currency',
+    'onhand',
+    'allowbackorder',
+    'weightgrams',
+    'taxcategory',
+    'lowstockthreshold',
+    'compareprice',
+    'salestartsat',
+    'saleendsat',
+    'widthmm',
+    'heightmm',
+    'depthmm',
+];
+/** Parses CSV text into rows of fields — copied from `@cogenta/api`'s `csv.ts`
+ * rather than depended on: the two packages are siblings (`@cogenta/commerce`
+ * has no dependency on `@cogenta/api` today, and a CSV reader is not a reason
+ * to start one), and RFC 4180 does not change. */
+function parseCsv(text) {
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    let i = 0;
+    const length = text.length;
+    while (i < length) {
+        const ch = text[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            field += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inQuotes = true;
+            i += 1;
+            continue;
+        }
+        if (ch === ',') {
+            row.push(field);
+            field = '';
+            i += 1;
+            continue;
+        }
+        if (ch === '\r') {
+            i += 1;
+            continue;
+        }
+        if (ch === '\n') {
+            row.push(field);
+            rows.push(row);
+            row = [];
+            field = '';
+            i += 1;
+            continue;
+        }
+        field += ch;
+        i += 1;
+    }
+    if (field.length > 0 || row.length > 0) {
+        row.push(field);
+        rows.push(row);
+    }
+    return rows;
+}
+function escapeField(value) {
+    return /[",\r\n]/u.test(value) ? `"${value.replace(/"/gu, '""')}"` : value;
+}
+function stringifyCsv(rows) {
+    return (rows.map((row) => row.map(escapeField).join(',')).join('\r\n') + (rows.length > 0 ? '\r\n' : ''));
+}
+function formatMajor(amountMinor, currency) {
+    const exponent = minorUnitExponent(currency);
+    return (amountMinor / 10 ** exponent).toFixed(exponent);
+}
+/** Rounds to the nearest minor unit rather than truncating. `null` for anything not a plain, non-negative number. */
+function parseMajor(text, currency) {
+    const trimmed = text.trim();
+    if (trimmed === '' || Number.isNaN(Number(trimmed)))
+        return null;
+    const major = Number(trimmed);
+    if (!Number.isFinite(major) || major < 0)
+        return null;
+    return Math.round(major * 10 ** minorUnitExponent(currency));
+}
+function parseNullableInt(text) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return null;
+    const value = Number(trimmed);
+    return Number.isInteger(value) && value >= 0 ? value : undefined;
+}
+function parseNullableDate(text) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return null;
+    return Number.isNaN(new Date(trimmed).getTime()) ? undefined : trimmed;
+}
+export function exportProductsCsv(products, variantsByProduct) {
+    const rows = [[...HEADER]];
+    for (const product of products) {
+        const variants = variantsByProduct.get(product.id) ?? [];
+        for (const variant of variants) {
+            rows.push([
+                product.handle,
+                product.title,
+                product.status,
+                variant.sku,
+                variant.title,
+                formatMajor(variant.priceMinor, variant.currency),
+                variant.currency,
+                String(variant.onHand),
+                String(variant.allowBackorder),
+                String(variant.weightGrams),
+                variant.taxCategory,
+                variant.lowStockThreshold === null ? '' : String(variant.lowStockThreshold),
+                variant.compareAtPriceMinor === null
+                    ? ''
+                    : formatMajor(variant.compareAtPriceMinor, variant.currency),
+                variant.saleStartsAt ?? '',
+                variant.saleEndsAt ?? '',
+                variant.widthMm === null ? '' : String(variant.widthMm),
+                variant.heightMm === null ? '' : String(variant.heightMm),
+                variant.depthMm === null ? '' : String(variant.depthMm),
+            ]);
+        }
+    }
+    return stringifyCsv(rows);
+}
+function parseImportCsv(csv, maxRows) {
+    const table = parseCsv(csv);
+    if (table.length === 0) {
+        return { rows: [], issues: [{ line: 0, detail: 'The file is empty.' }] };
+    }
+    const header = (table[0] ?? []).map((cell) => cell.trim().toLowerCase());
+    const index = (name) => header.indexOf(name);
+    const required = ['handle', 'title', 'sku', 'variant', 'price', 'currency'];
+    const missing = required.filter((name) => index(name) === -1);
+    if (missing.length > 0) {
+        return {
+            rows: [],
+            issues: [{ line: 1, detail: `The header row is missing: ${missing.join(', ')}.` }],
+        };
+    }
+    const cell = (cells, name) => (cells[index(name)] ?? '').trim();
+    const rows = [];
+    const issues = [];
+    const dataRows = table.slice(1, 1 + maxRows);
+    for (const [offset, cells] of dataRows.entries()) {
+        const line = offset + 2;
+        if (cells.length === 1 && (cells[0] ?? '').trim() === '')
+            continue;
+        const handle = cell(cells, 'handle').toLowerCase();
+        const title = cell(cells, 'title');
+        const sku = cell(cells, 'sku');
+        const variantTitle = cell(cells, 'variant');
+        const rawStatus = index('status') === -1 ? '' : cell(cells, 'status');
+        const currency = normaliseCurrency(cell(cells, 'currency') || 'EUR');
+        if (handle === '' || title === '' || sku === '' || variantTitle === '') {
+            issues.push({ line, detail: 'Missing "handle", "title", "sku" or "variant".' });
+            continue;
+        }
+        if (rawStatus !== '' && rawStatus !== 'active' && rawStatus !== 'archived') {
+            issues.push({ line, detail: `"${rawStatus}" is not "active" or "archived".` });
+            continue;
+        }
+        const priceMinor = parseMajor(cell(cells, 'price'), currency);
+        if (priceMinor === null) {
+            issues.push({ line, detail: `"${cell(cells, 'price')}" is not a usable price.` });
+            continue;
+        }
+        const onHandRaw = cell(cells, 'onhand');
+        const onHand = onHandRaw === '' ? 0 : Number(onHandRaw);
+        if (!Number.isInteger(onHand) || onHand < 0) {
+            issues.push({ line, detail: `"${onHandRaw}" is not a usable stock count.` });
+            continue;
+        }
+        const lowStockThreshold = parseNullableInt(cell(cells, 'lowstockthreshold'));
+        const widthMm = parseNullableInt(cell(cells, 'widthmm'));
+        const heightMm = parseNullableInt(cell(cells, 'heightmm'));
+        const depthMm = parseNullableInt(cell(cells, 'depthmm'));
+        if (lowStockThreshold === undefined ||
+            widthMm === undefined ||
+            heightMm === undefined ||
+            depthMm === undefined) {
+            issues.push({ line, detail: 'A threshold or dimension column is not a whole number.' });
+            continue;
+        }
+        const comparePriceText = cell(cells, 'compareprice');
+        const compareAtPriceMinor = comparePriceText === '' ? null : parseMajor(comparePriceText, currency);
+        if (comparePriceText !== '' && compareAtPriceMinor === null) {
+            issues.push({ line, detail: `"${comparePriceText}" is not a usable compare-at price.` });
+            continue;
+        }
+        const saleStartsAt = parseNullableDate(cell(cells, 'salestartsat'));
+        const saleEndsAt = parseNullableDate(cell(cells, 'saleendsat'));
+        if (saleStartsAt === undefined || saleEndsAt === undefined) {
+            issues.push({ line, detail: 'A sale date column is not a usable date.' });
+            continue;
+        }
+        rows.push({
+            line,
+            handle,
+            title,
+            status: rawStatus === 'archived' ? 'archived' : 'active',
+            sku,
+            variantTitle,
+            priceMinor,
+            currency,
+            onHand,
+            allowBackorder: cell(cells, 'allowbackorder').toLowerCase() === 'true',
+            weightGrams: Number(cell(cells, 'weightgrams')) || 0,
+            taxCategory: cell(cells, 'taxcategory') || 'standard',
+            lowStockThreshold,
+            compareAtPriceMinor,
+            saleStartsAt,
+            saleEndsAt,
+            widthMm,
+            heightMm,
+            depthMm,
+        });
+    }
+    if (table.length - 1 > maxRows) {
+        issues.push({
+            line: maxRows + 2,
+            detail: `Only the first ${maxRows} data rows were read; the rest of the file was not.`,
+        });
+    }
+    return { rows, issues };
+}
+export async function previewProductsImport(csv, catalog, maxRows = 5000) {
+    const { rows, issues } = parseImportCsv(csv, maxRows);
+    const lastLineIndexBySku = new Map();
+    for (const [index, row] of rows.entries())
+        lastLineIndexBySku.set(row.sku, index);
+    const variantCache = new Map();
+    const outcomes = [];
+    for (const [index, row] of rows.entries()) {
+        if (lastLineIndexBySku.get(row.sku) !== index) {
+            outcomes.push({
+                line: row.line,
+                handle: row.handle,
+                sku: row.sku,
+                outcome: 'duplicate',
+                detail: 'A later row in this file uses the same SKU; only that one will be applied.',
+            });
+            continue;
+        }
+        if (!variantCache.has(row.sku)) {
+            variantCache.set(row.sku, await catalog.readVariantBySku(row.sku));
+        }
+        const existing = variantCache.get(row.sku) ?? null;
+        outcomes.push({
+            line: row.line,
+            handle: row.handle,
+            sku: row.sku,
+            outcome: existing === null ? 'create' : 'update',
+            ...(existing === null
+                ? {}
+                : { detail: `Currently priced at ${existing.priceMinor} ${existing.currency}.` }),
+        });
+    }
+    const summary = {
+        create: 0,
+        update: 0,
+        duplicate: 0,
+        invalid: issues.length,
+    };
+    for (const outcome of outcomes)
+        summary[outcome.outcome] = (summary[outcome.outcome] ?? 0) + 1;
+    return { rows: outcomes, issues, summary };
+}
+export async function applyProductsImport(csv, catalog, maxRows = 5000) {
+    const { rows, issues } = parseImportCsv(csv, maxRows);
+    const lastLineIndexBySku = new Map();
+    for (const [index, row] of rows.entries())
+        lastLineIndexBySku.set(row.sku, index);
+    const applicable = rows.filter((row, index) => lastLineIndexBySku.get(row.sku) === index);
+    let created = 0;
+    let updated = 0;
+    const failed = [...issues];
+    const productIdByHandle = new Map();
+    // Sequential, not `Promise.all`: each write is its own set of queries
+    // against one SQLite writer lock, and racing them would only serialise
+    // behind it anyway while making the per-row failure report meaningless.
+    for (const row of applicable) {
+        try {
+            let productId = productIdByHandle.get(row.handle);
+            if (productId === undefined) {
+                const existingProduct = await catalog.readProductByHandle(row.handle);
+                const product = existingProduct ??
+                    (await catalog.createProduct({
+                        handle: row.handle,
+                        title: row.title,
+                        status: row.status,
+                    }));
+                productId = product.id;
+                productIdByHandle.set(row.handle, productId);
+            }
+            const existingVariant = await catalog.readVariantBySku(row.sku);
+            if (existingVariant === null) {
+                await catalog.createVariant({
+                    productId,
+                    sku: row.sku,
+                    title: row.variantTitle,
+                    priceMinor: row.priceMinor,
+                    currency: row.currency,
+                    onHand: row.onHand,
+                    allowBackorder: row.allowBackorder,
+                    weightGrams: row.weightGrams,
+                    taxCategory: row.taxCategory,
+                    lowStockThreshold: row.lowStockThreshold,
+                    compareAtPriceMinor: row.compareAtPriceMinor,
+                    saleStartsAt: row.saleStartsAt,
+                    saleEndsAt: row.saleEndsAt,
+                    widthMm: row.widthMm,
+                    heightMm: row.heightMm,
+                    depthMm: row.depthMm,
+                });
+                created += 1;
+            }
+            else {
+                await catalog.updateVariant(existingVariant.id, {
+                    title: row.variantTitle,
+                    priceMinor: row.priceMinor,
+                    currency: row.currency,
+                    allowBackorder: row.allowBackorder,
+                    weightGrams: row.weightGrams,
+                    taxCategory: row.taxCategory,
+                    lowStockThreshold: row.lowStockThreshold,
+                    compareAtPriceMinor: row.compareAtPriceMinor,
+                    saleStartsAt: row.saleStartsAt,
+                    saleEndsAt: row.saleEndsAt,
+                    widthMm: row.widthMm,
+                    heightMm: row.heightMm,
+                    depthMm: row.depthMm,
+                });
+                // The stock count on an import row is a snapshot, not a delta — a
+                // real stock take, going through the same audited path every other
+                // absolute stock write does (fiche 51 task 4).
+                if (existingVariant.onHand !== row.onHand) {
+                    await catalog.setStock(existingVariant.id, row.onHand, { note: 'CSV import' });
+                }
+                updated += 1;
+            }
+        }
+        catch (error) {
+            failed.push({
+                line: row.line,
+                detail: isCogentaError(error) ? error.message : String(error),
+            });
+        }
+    }
+    return {
+        created,
+        updated,
+        skipped: rows.length - applicable.length,
+        failed,
+    };
+}
+//# sourceMappingURL=csv.js.map

package/dist/catalog/csv.js.map

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

package/dist/catalog/store.d.ts

@@ -1,11 +1,14 @@
 import { type DatabaseHandle, type SqlExecutor } from '@cogenta/core';
-import type { CreateProductInput, CreateVariantInput, Product, ProductStatus, StockRequest, StockShortfall, UpdateProductInput, UpdateVariantInput, Variant } from './types.js';
+import type { CreateProductInput, CreateVariantInput, Product, ProductStatus, ProductTerm, StockMovement, StockMovementOptions, StockRequest, StockShortfall, UpdateProductInput, UpdateVariantInput, Variant } from './types.js';
 export interface ProductListOptions {
     readonly status?: ProductStatus;
     /** Case-insensitive substring of handle or title. */
     readonly search?: string;
     readonly limit?: number;
     readonly offset?: number;
+    /** `createdAt` (the historical default) unless stated otherwise (fiche 51 task 2). */
+    readonly sort?: 'createdAt' | 'title' | 'handle';
+    readonly direction?: 'asc' | 'desc';
 }
 /**
  * The outcome of taking stock. Never a boolean and never a throw for the
@@ -34,10 +37,14 @@ export interface CatalogStore {
     updateVariant(id: string, input: UpdateVariantInput): Promise<Variant>;
     deleteVariant(id: string): Promise<void>;
     listVariants(productId: string): Promise<readonly Variant[]>;
+    /** Every variant with a threshold set whose `onHand` has reached or crossed
+     * it, lowest stock first (fiche 51 task 4). A variant with no threshold is
+     * never in this list, however low its stock. */
+    listLowStock(): Promise<readonly Variant[]>;
     /** Sets absolute stock. For a stock take, never for a sale. */
-    setStock(variantId: string, onHand: number): Promise<Variant>;
+    setStock(variantId: string, onHand: number, options?: StockMovementOptions): Promise<Variant>;
     /** Adds to stock. For a delivery, and for putting a cancelled order back. */
-    restock(requests: readonly StockRequest[], tx?: SqlExecutor): Promise<void>;
+    restock(requests: readonly StockRequest[], tx?: SqlExecutor, options?: StockMovementOptions): Promise<void>;
     /**
      * Takes stock for a sale, atomically, all lines or none.
      *
@@ -47,7 +54,20 @@ export interface CatalogStore {
      * racing for the last unit both pass the read, and exactly one passes the
      * UPDATE — which is the difference between a shop and an oversold shop.
      */
-    takeStock(requests: readonly StockRequest[], tx?: SqlExecutor): Promise<StockOutcome>;
+    takeStock(requests: readonly StockRequest[], tx?: SqlExecutor, options?: StockMovementOptions): Promise<StockOutcome>;
+    /** A variant's append-only stock history, most recent first (fiche 51 task 4). */
+    listStockMovements(variantId: string): Promise<readonly StockMovement[]>;
+    /** A product's classification against zero or more taxonomies (fiche 51 task 3). */
+    listProductTerms(productId: string): Promise<readonly ProductTerm[]>;
+    /**
+     * Replaces everything this product carries in `taxonomy` with `termIds` —
+     * the same "whole field, replaced on save" semantics `f.taxonomy` already
+     * uses on a collection entry. Terms of a *different* taxonomy on the same
+     * product are untouched.
+     */
+    setProductTerms(productId: string, taxonomy: string, termIds: readonly string[]): Promise<readonly ProductTerm[]>;
+    /** The product linked to this content entry, if any — the reverse of `contentRef` (fiche 51 task 1). */
+    readProductByContentRef(collection: string, entryId: string): Promise<Product | null>;
 }
 export declare function createCatalogStore(db: DatabaseHandle, now?: () => number): CatalogStore;
 //# sourceMappingURL=store.d.ts.map

package/dist/catalog/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/catalog/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAInB,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACR,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAA;AAE9E,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAChD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC5D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE;yEACqE;IACrE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,YAAY,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAEvE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAChD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACtD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAE5D,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACtF;AA+GD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,YAAY,CAqUjG"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/catalog/store.ts"],"names":[],"mappings":"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"}