@endora-commerce/mod-inventory 0.100.0

package/dist/backend/services/csv-stock-importer.js

@@ -0,0 +1,154 @@
+import { randomUUID } from 'crypto';
+import { StockLevel } from '../entities/stock-level.entity.js';
+import { Warehouse } from '../entities/warehouse.entity.js';
+/**
+ * CSV stock importer (US7 / FR-031).
+ *
+ * Accepts a CSV with a `sku,onHand` header row and applies the on-hand
+ * value for each product *into the chosen warehouse*. The format is:
+ *
+ *   sku,onHand
+ *   PRD-001,42
+ *   PRD-002,0
+ *
+ * Rows whose SKU does not resolve to a Product produce a
+ * `product_not_found` error. Negative or non-integer onHand values
+ * produce `invalid_quantity`. Malformed rows (wrong column count, no
+ * comma) produce `malformed_row`. The function returns a summary for
+ * the operator UI; the file itself is never persisted.
+ *
+ * Implementation note (research §R8): Node-native streaming + manual
+ * row split keeps the dep graph minimal. The XLSX path lives in a
+ * sibling file and uses `read-excel-file` (selected per T003).
+ */
+export class CsvStockImporter {
+    emFactory;
+    catalogProducts;
+    eventBus;
+    auditLog;
+    constructor(emFactory, 
+    /**
+     * `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). A
+     * sheet addresses a product by SKU, so somebody has to ask `catalog`; the
+     * `product_not_found` row error is raised from its answer.
+     */
+    catalogProducts, eventBus, auditLog) {
+        this.emFactory = emFactory;
+        this.catalogProducts = catalogProducts;
+        this.eventBus = eventBus;
+        this.auditLog = auditLog;
+    }
+    async run(input, auditCtx) {
+        const lines = input.csv.split(/\r?\n/);
+        const errors = [];
+        let rowsRead = 0;
+        let rowsApplied = 0;
+        let rowsSkipped = 0;
+        if (lines.length === 0) {
+            return { rowsRead: 0, rowsApplied: 0, rowsSkipped: 0, errors };
+        }
+        const header = (lines[0] ?? '').split(',').map((c) => c.trim().toLowerCase());
+        const skuIdx = header.indexOf('sku');
+        const onHandIdx = header.indexOf('onhand');
+        if (skuIdx === -1 || onHandIdx === -1) {
+            return {
+                rowsRead: 0,
+                rowsApplied: 0,
+                rowsSkipped: 0,
+                errors: [
+                    {
+                        row: 1,
+                        sku: '',
+                        reason: 'malformed_row',
+                    },
+                ],
+            };
+        }
+        const em = this.emFactory();
+        const dataLines = lines.slice(1).filter((l) => l.trim().length > 0);
+        rowsRead = dataLines.length;
+        for (let i = 0; i < dataLines.length; i++) {
+            const lineNo = i + 2;
+            const cells = (dataLines[i] ?? '').split(',').map((c) => c.trim());
+            if (cells.length < Math.max(skuIdx, onHandIdx) + 1) {
+                errors.push({ row: lineNo, sku: '', reason: 'malformed_row' });
+                rowsSkipped += 1;
+                continue;
+            }
+            const sku = cells[skuIdx] ?? '';
+            const onHandRaw = cells[onHandIdx] ?? '';
+            const onHand = Number.parseInt(onHandRaw, 10);
+            if (!Number.isFinite(onHand) || onHand < 0 || String(onHand) !== onHandRaw) {
+                errors.push({ row: lineNo, sku, reason: 'invalid_quantity' });
+                rowsSkipped += 1;
+                continue;
+            }
+            const product = await this.catalogProducts.findBySku(sku);
+            if (!product) {
+                errors.push({ row: lineNo, sku, reason: 'product_not_found' });
+                rowsSkipped += 1;
+                continue;
+            }
+            if (input.dryRun) {
+                rowsApplied += 1;
+                continue;
+            }
+            let row = await em.findOne(StockLevel, {
+                productId: product.id,
+                warehouseId: input.warehouseId,
+                variantId: null,
+            });
+            const before = row?.onHand ?? 0;
+            if (row) {
+                row.onHand = onHand;
+            }
+            else {
+                row = em.create(StockLevel, {
+                    productId: product.id,
+                    warehouseId: input.warehouseId,
+                    onHand,
+                });
+            }
+            await em.persistAndFlush(row);
+            rowsApplied += 1;
+            if (this.eventBus && before !== onHand) {
+                this.eventBus.emit('inventory.adjusted.v1', {
+                    eventId: randomUUID(),
+                    occurredAt: new Date().toISOString(),
+                    productId: product.id,
+                    warehouseId: input.warehouseId,
+                    variantId: null,
+                    before,
+                    after: onHand,
+                });
+            }
+        }
+        // Feature 024 — single summary audit row per CSV import, never per
+        // CSV line. Dry runs are not audited (no state changed).
+        if (this.auditLog && auditCtx && !input.dryRun && rowsApplied > 0) {
+            const warehouse = await em.findOne(Warehouse, { id: input.warehouseId });
+            await this.auditLog.record({
+                actorAdminUserId: auditCtx.actorAdminUserId,
+                ...(auditCtx.impersonatedCustomerAccountId !== undefined
+                    ? { impersonatedCustomerAccountId: auditCtx.impersonatedCustomerAccountId }
+                    : {}),
+                action: 'stock_level.bulk_import',
+                objectType: 'bulk_operation',
+                objectId: randomUUID(),
+                stateAfter: {
+                    warehouseId: input.warehouseId,
+                    warehouseCode: warehouse?.code ?? null,
+                    fileName: input.fileName ?? null,
+                    rowsProcessed: rowsApplied,
+                    rowsSkipped,
+                    rowsErrored: errors.length,
+                },
+                ...(auditCtx.ipAddress !== undefined ? { ipAddress: auditCtx.ipAddress } : {}),
+                ...(auditCtx.userAgent !== undefined ? { userAgent: auditCtx.userAgent } : {}),
+                ...(auditCtx.requestId !== undefined ? { requestId: auditCtx.requestId } : {}),
+            });
+        }
+        return { rowsRead, rowsApplied, rowsSkipped, errors };
+    }
+}
+//# sourceMappingURL=csv-stock-importer.js.map

package/dist/backend/services/csv-stock-importer.js.map

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

package/dist/backend/services/display-band-resolver.d.ts

@@ -0,0 +1,19 @@
+import type { ThresholdLevel } from './threshold-resolver.js';
+/**
+ * Display-band resolver — pure function (feature 010 / FR-017 to FR-020).
+ *
+ * Maps cumulative on-hand + thresholds to one of:
+ *   `high` | `medium` | `low` | `out_of_stock` | `available`
+ *
+ * `available` is the special bucket returned when `manageStock = false`
+ * — the storefront treats the product as always available regardless
+ * of stock numbers (FR-022).
+ */
+export type DisplayBand = 'high' | 'medium' | 'low' | 'out_of_stock' | 'available';
+export interface ResolveDisplayBandInput {
+    manageStock: boolean;
+    cumulativeOnHand: number;
+    thresholds: ThresholdLevel;
+}
+export declare function resolveDisplayBand(input: ResolveDisplayBandInput): DisplayBand;
+//# sourceMappingURL=display-band-resolver.d.ts.map

package/dist/backend/services/display-band-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-band-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/display-band-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AAEnF,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAmB9E"}

package/dist/backend/services/display-band-resolver.js

@@ -0,0 +1,21 @@
+export function resolveDisplayBand(input) {
+    if (!input.manageStock)
+        return 'available';
+    const onHand = Math.max(0, input.cumulativeOnHand);
+    if (onHand <= 0)
+        return 'out_of_stock';
+    const high = input.thresholds.high;
+    if (high !== null && high !== undefined && onHand >= high)
+        return 'high';
+    const medium = input.thresholds.medium;
+    if (medium !== null && medium !== undefined && onHand >= medium)
+        return 'medium';
+    const low = input.thresholds.low;
+    if (low !== null && low !== undefined && onHand >= low)
+        return 'low';
+    // No applicable threshold (or below `low`) but on-hand > 0: treat
+    // as low. The display-mode `available_or_not` collapses this to
+    // `available` at render time.
+    return 'low';
+}
+//# sourceMappingURL=display-band-resolver.js.map

package/dist/backend/services/display-band-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-band-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/display-band-resolver.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,IAAI,CAAC,KAAK,CAAC,WAAW;QAAE,OAAO,WAAW,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnD,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,cAAc,CAAC;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;IACnC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IAEzE,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,MAAM;QAAE,OAAO,QAAQ,CAAC;IAEjF,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IAErE,kEAAkE;IAClE,gEAAgE;IAChE,8BAA8B;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/backend/services/effective-fulfilment-strategy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Effective fulfilment-strategy resolver — pure function.
+ *
+ * The implementation moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013): it is pure over its arguments — three configuration layers in, one
+ * resolved strategy out — so switching `inventory` off cannot change the
+ * answer and a gated port answering 503 would be a bug rather than a degrade.
+ *
+ * `orders` calls it at placement, inside its own transaction, through a
+ * dynamic import. Publishing it lets that cut remove the dynamic import rather
+ * than wrap it.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { type FulfilmentLayer, type EffectiveFulfilment, resolveEffectiveFulfilmentStrategy, } from '@endora-commerce/contracts';
+//# sourceMappingURL=effective-fulfilment-strategy.d.ts.map

package/dist/backend/services/effective-fulfilment-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-fulfilment-strategy.d.ts","sourceRoot":"","sources":["../../../src/backend/services/effective-fulfilment-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,kCAAkC,GACnC,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/effective-fulfilment-strategy.js

@@ -0,0 +1,16 @@
+/**
+ * Effective fulfilment-strategy resolver — pure function.
+ *
+ * The implementation moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013): it is pure over its arguments — three configuration layers in, one
+ * resolved strategy out — so switching `inventory` off cannot change the
+ * answer and a gated port answering 503 would be a bug rather than a degrade.
+ *
+ * `orders` calls it at placement, inside its own transaction, through a
+ * dynamic import. Publishing it lets that cut remove the dynamic import rather
+ * than wrap it.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { resolveEffectiveFulfilmentStrategy, } from '@endora-commerce/contracts';
+//# sourceMappingURL=effective-fulfilment-strategy.js.map

package/dist/backend/services/effective-fulfilment-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-fulfilment-strategy.js","sourceRoot":"","sources":["../../../src/backend/services/effective-fulfilment-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAGL,kCAAkC,GACnC,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/fulfilment-strategy-resolver.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fulfilment-strategy resolver — pure function (feature 010 / FR-029…FR-033,
+ * research §R4).
+ *
+ * The implementation moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013), with its twin in `effective-fulfilment-strategy.ts` and for the
+ * same reason: candidate warehouses in, an allocation decision out, and no
+ * table read anywhere in it.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { type CandidateWarehouse, type AllocationDecision, type ResolveAllocationsInput, type AllocationOutcome, resolveAllocations, } from '@endora-commerce/contracts';
+//# sourceMappingURL=fulfilment-strategy-resolver.d.ts.map

package/dist/backend/services/fulfilment-strategy-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfilment-strategy-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/fulfilment-strategy-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/fulfilment-strategy-resolver.js

@@ -0,0 +1,13 @@
+/**
+ * Fulfilment-strategy resolver — pure function (feature 010 / FR-029…FR-033,
+ * research §R4).
+ *
+ * The implementation moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013), with its twin in `effective-fulfilment-strategy.ts` and for the
+ * same reason: candidate warehouses in, an allocation decision out, and no
+ * table read anywhere in it.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { resolveAllocations, } from '@endora-commerce/contracts';
+//# sourceMappingURL=fulfilment-strategy-resolver.js.map

package/dist/backend/services/fulfilment-strategy-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfilment-strategy-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/fulfilment-strategy-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAKL,kBAAkB,GACnB,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/inventory-read-port.d.ts

@@ -0,0 +1,65 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CandidateWarehouse, ChannelWarehouse, InventoryStockReadPort, StockLevelRecord, WarehouseChannelAssignmentRecord, WarehouseRecord } from '@endora-commerce/contracts';
+import { StockLevel } from '../entities/stock-level.entity.js';
+import { Warehouse } from '../entities/warehouse.entity.js';
+import { WarehouseChannelAssignment } from '../entities/warehouse-channel-assignment.entity.js';
+/**
+ * The stock read model `inventory` publishes (feature 075, Phase P).
+ *
+ * `orders` reads stock at placement, and it does so through a **dynamic**
+ * import inside a method body — invisible to a reviewer scanning the import
+ * block, which is why the boundary check was taught to see one. What it
+ * assembles there is this module's business: candidate warehouses for a line
+ * on a channel, with `available = onHand - reserved`, joined across three
+ * tables and ordered by warehouse code.
+ *
+ * `candidatesFor` is therefore the method with no direct predecessor — the
+ * others are transcriptions. It exists because the assembly, not the rows, is
+ * what the caller wanted, and assembling it in `orders` put this module's join
+ * in another module's transaction.
+ */
+export declare class InventoryStockReadService implements InventoryStockReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    listStockForProducts(productIds: readonly string[], options?: {
+        warehouseId?: string;
+    }): Promise<StockLevelRecord[]>;
+    listWarehouses(options?: {
+        activeOnly?: boolean;
+    }): Promise<WarehouseRecord[]>;
+    listChannelAssignments(salesChannelId: string): Promise<WarehouseChannelAssignmentRecord[]>;
+    /**
+     * The channel → warehouse binding placement allocates against (D-94.4).
+     *
+     * This was a knex join inside `orders`' placement transaction —
+     * `warehouse_channel_assignments as a` joined to `warehouses as w`, two of
+     * this module's tables named by hand in another module's method body, with
+     * the empty-channel fallback spelled out of a UUID constant copied from
+     * `warehouse.entity.ts`. Both halves are this module's business, so both are
+     * here: the ordering placement walks (`isDefault desc, sortOrder asc,
+     * createdAt asc`, which is *not* `listChannelAssignments`' ordering) and the
+     * default-warehouse fallback.
+     *
+     * The fallback is not dead code kept for tests. The boot-time
+     * `WarehouseChannelReconciler` binds the default warehouse to every channel,
+     * so a production deployment does not reach it — but a seed-skipped
+     * environment, and a channel whose only bound warehouses have been
+     * deactivated, both do, and answering nothing there would refuse every line
+     * rather than allocate against the default.
+     *
+     * Read through this module's own `EntityManager`, deliberately: it is the
+     * *binding*, not the stock. The caller reads and locks `stock_levels` itself,
+     * on its own transaction — see the port's doc comment for why
+     * `candidatesFor` cannot stand in here.
+     */
+    listChannelWarehouses(salesChannelId: string): Promise<ChannelWarehouse[]>;
+    candidatesFor(input: {
+        productId: string;
+        variantId?: string | null;
+        salesChannelId: string | null;
+    }): Promise<CandidateWarehouse[]>;
+}
+export declare function toWarehouseRecord(warehouse: Warehouse): WarehouseRecord;
+export declare function toStockLevelRecord(level: StockLevel): StockLevelRecord;
+export declare function toWarehouseChannelAssignmentRecord(assignment: WarehouseChannelAssignment): WarehouseChannelAssignmentRecord;
+//# sourceMappingURL=inventory-read-port.d.ts.map

package/dist/backend/services/inventory-read-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-read-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/inventory-read-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gCAAgC,EAChC,eAAe,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAGL,SAAS,EACV,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAEhG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,oBAAoB,CACxB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IASxB,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAS9E,sBAAsB,CAC1B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,EAAE,CAAC;IAS9C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqC1E,aAAa,CAAC,KAAK,EAAE;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAsClC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAevE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAWtE;AAED,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,0BAA0B,GACrC,gCAAgC,CASlC"}

package/dist/backend/services/inventory-read-port.js

@@ -0,0 +1,168 @@
+import { StockLevel } from '../entities/stock-level.entity.js';
+import { DEFAULT_WAREHOUSE_CODE, DEFAULT_WAREHOUSE_ID, Warehouse, } from '../entities/warehouse.entity.js';
+import { WarehouseChannelAssignment } from '../entities/warehouse-channel-assignment.entity.js';
+/**
+ * The stock read model `inventory` publishes (feature 075, Phase P).
+ *
+ * `orders` reads stock at placement, and it does so through a **dynamic**
+ * import inside a method body — invisible to a reviewer scanning the import
+ * block, which is why the boundary check was taught to see one. What it
+ * assembles there is this module's business: candidate warehouses for a line
+ * on a channel, with `available = onHand - reserved`, joined across three
+ * tables and ordered by warehouse code.
+ *
+ * `candidatesFor` is therefore the method with no direct predecessor — the
+ * others are transcriptions. It exists because the assembly, not the rows, is
+ * what the caller wanted, and assembling it in `orders` put this module's join
+ * in another module's transaction.
+ */
+export class InventoryStockReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async listStockForProducts(productIds, options) {
+        if (productIds.length === 0)
+            return [];
+        const rows = await this.emFactory().find(StockLevel, {
+            productId: { $in: [...productIds] },
+            ...(options?.warehouseId ? { warehouseId: options.warehouseId } : {}),
+        });
+        return rows.map(toStockLevelRecord);
+    }
+    async listWarehouses(options) {
+        const rows = await this.emFactory().find(Warehouse, options?.activeOnly ? { active: true } : {}, { orderBy: { code: 'asc' } });
+        return rows.map(toWarehouseRecord);
+    }
+    async listChannelAssignments(salesChannelId) {
+        const rows = await this.emFactory().find(WarehouseChannelAssignment, { salesChannelId }, { orderBy: { sortOrder: 'asc', id: 'asc' } });
+        return rows.map(toWarehouseChannelAssignmentRecord);
+    }
+    /**
+     * The channel → warehouse binding placement allocates against (D-94.4).
+     *
+     * This was a knex join inside `orders`' placement transaction —
+     * `warehouse_channel_assignments as a` joined to `warehouses as w`, two of
+     * this module's tables named by hand in another module's method body, with
+     * the empty-channel fallback spelled out of a UUID constant copied from
+     * `warehouse.entity.ts`. Both halves are this module's business, so both are
+     * here: the ordering placement walks (`isDefault desc, sortOrder asc,
+     * createdAt asc`, which is *not* `listChannelAssignments`' ordering) and the
+     * default-warehouse fallback.
+     *
+     * The fallback is not dead code kept for tests. The boot-time
+     * `WarehouseChannelReconciler` binds the default warehouse to every channel,
+     * so a production deployment does not reach it — but a seed-skipped
+     * environment, and a channel whose only bound warehouses have been
+     * deactivated, both do, and answering nothing there would refuse every line
+     * rather than allocate against the default.
+     *
+     * Read through this module's own `EntityManager`, deliberately: it is the
+     * *binding*, not the stock. The caller reads and locks `stock_levels` itself,
+     * on its own transaction — see the port's doc comment for why
+     * `candidatesFor` cannot stand in here.
+     */
+    async listChannelWarehouses(salesChannelId) {
+        const em = this.emFactory();
+        const assignments = await em.find(WarehouseChannelAssignment, { salesChannelId }, { orderBy: { isDefault: 'desc', sortOrder: 'asc', createdAt: 'asc' } });
+        if (assignments.length > 0) {
+            const warehouses = await em.find(Warehouse, {
+                active: true,
+                id: { $in: assignments.map((a) => a.warehouseId) },
+            });
+            const byId = new Map(warehouses.map((w) => [w.id, w]));
+            const bound = assignments.flatMap((assignment) => {
+                const warehouse = byId.get(assignment.warehouseId);
+                // The `active` filter is a join condition, not a post-filter with a
+                // fabricated stand-in: a deactivated warehouse is not a candidate.
+                if (!warehouse)
+                    return [];
+                return [
+                    {
+                        warehouseId: assignment.warehouseId,
+                        warehouseCode: warehouse.code,
+                        isDefault: assignment.isDefault,
+                    },
+                ];
+            });
+            if (bound.length > 0)
+                return bound;
+        }
+        return [
+            {
+                warehouseId: DEFAULT_WAREHOUSE_ID,
+                warehouseCode: DEFAULT_WAREHOUSE_CODE,
+                isDefault: true,
+            },
+        ];
+    }
+    async candidatesFor(input) {
+        const em = this.emFactory();
+        // Which warehouses serve this channel. No channel, or a channel nobody
+        // assigned a warehouse to, means "every active warehouse" — the same
+        // fallback the availability resolver already applies, so a deployment that
+        // never configured the channel mapping keeps working.
+        const assignments = input.salesChannelId === null
+            ? []
+            : await em.find(WarehouseChannelAssignment, { salesChannelId: input.salesChannelId });
+        const assignedIds = assignments.map((a) => a.warehouseId);
+        const defaultIds = new Set(assignments.filter((a) => a.isDefault).map((a) => a.warehouseId));
+        const warehouses = await em.find(Warehouse, { active: true, ...(assignedIds.length > 0 ? { id: { $in: assignedIds } } : {}) }, { orderBy: { code: 'asc' } });
+        if (warehouses.length === 0)
+            return [];
+        const stock = await em.find(StockLevel, {
+            productId: input.productId,
+            variantId: input.variantId ?? null,
+            warehouseId: { $in: warehouses.map((w) => w.id) },
+        });
+        const byWarehouse = new Map(stock.map((s) => [s.warehouseId, s]));
+        return warehouses.map((warehouse) => {
+            const level = byWarehouse.get(warehouse.id);
+            return {
+                warehouseId: warehouse.id,
+                warehouseCode: warehouse.code,
+                available: level ? level.onHand - level.reserved : 0,
+                isDefault: defaultIds.has(warehouse.id),
+            };
+        });
+    }
+}
+export function toWarehouseRecord(warehouse) {
+    return {
+        id: warehouse.id,
+        name: warehouse.name,
+        code: warehouse.code,
+        active: warehouse.active,
+        description: warehouse.description ?? null,
+        address: warehouse.address ?? null,
+        contactName: warehouse.contactName ?? null,
+        contactEmail: warehouse.contactEmail ?? null,
+        contactPhone: warehouse.contactPhone ?? null,
+        defaultLowStockThreshold: warehouse.defaultLowStockThreshold ?? null,
+        createdAt: warehouse.createdAt,
+        updatedAt: warehouse.updatedAt,
+    };
+}
+export function toStockLevelRecord(level) {
+    return {
+        id: level.id,
+        productId: level.productId,
+        variantId: level.variantId ?? null,
+        warehouseId: level.warehouseId,
+        onHand: level.onHand,
+        reserved: level.reserved,
+        createdAt: level.createdAt,
+        updatedAt: level.updatedAt,
+    };
+}
+export function toWarehouseChannelAssignmentRecord(assignment) {
+    return {
+        id: assignment.id,
+        warehouseId: assignment.warehouseId,
+        salesChannelId: assignment.salesChannelId,
+        isDefault: assignment.isDefault,
+        sortOrder: assignment.sortOrder,
+        createdAt: assignment.createdAt,
+    };
+}
+//# sourceMappingURL=inventory-read-port.js.map

package/dist/backend/services/inventory-read-port.js.map

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

package/dist/backend/services/inventory-reservation-apply-port.d.ts

@@ -0,0 +1,62 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { InventoryReservationApplyPort, PlacementStockSnapshot } from '../../ports/index.js';
+/**
+ * `inventoryReservationApplyPort` — the stock reservation order placement
+ * performs, written on the caller's `EntityManager` (feature 080, T048; D-169).
+ *
+ * `orders` held this module's `StockLevel` and `StockAllocation` classes for it
+ * until T048, and held them **twice**: statically at the top of
+ * `order-service.ts` for the reservation, and through an `await import()`
+ * inside `releaseAllocations` for the release. The header comment above those
+ * static imports claimed D-94.4 had removed the dynamic pair; it had not, and a
+ * dynamic import is invisible to a reviewer scanning the block, which is
+ * exactly the property a boundary exception must not have. Both spellings are
+ * gone with this file.
+ *
+ * **The transaction is unchanged, and that is the point of the conversion.**
+ * The `PESSIMISTIC_WRITE` is still taken on placement's own `EntityManager` and
+ * still held until the order commits; the allocation rows are still written
+ * after the order items are flushed, because
+ * `stock_allocations_order_item_fk` is `on delete restrict`; the release still
+ * runs in the transaction `releaseAllocations` opens. What changed is that the
+ * statements are written by the module that owns the two tables, and that what
+ * crosses the boundary is `PlacementStockSnapshot` — published records —
+ * instead of managed rows the consumer could move any column of (D-77's first
+ * narrowing).
+ *
+ * The port's own doc block, in `../ports/index.js`, states the constraint, the
+ * lock and the off-state answer.
+ */
+export declare class InventoryReservationApplyService implements InventoryReservationApplyPort {
+    lockAvailabilityForPlacement(em: EntityManager, input: {
+        productId: string;
+        variantId: string | null;
+        warehouseIds: readonly string[];
+    }): Promise<PlacementStockSnapshot[]>;
+    reserveForPlacement(em: EntityManager, input: {
+        productId: string;
+        variantId: string | null;
+        allocations: ReadonlyArray<{
+            warehouseId: string;
+            quantity: number;
+        }>;
+    }): Promise<void>;
+    recordAllocationsForOrderItems(em: EntityManager, input: {
+        allocations: ReadonlyArray<{
+            orderItemId: string;
+            warehouseId: string;
+            quantity: number;
+            isBackorder: boolean;
+        }>;
+    }): Promise<void>;
+    releaseForOrderItems(em: EntityManager, input: {
+        items: ReadonlyArray<{
+            orderItemId: string;
+            productId: string;
+            variantId: string | null;
+        }>;
+    }): Promise<{
+        released: number;
+    }>;
+}
+//# sourceMappingURL=inventory-reservation-apply-port.d.ts.map

package/dist/backend/services/inventory-reservation-apply-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-reservation-apply-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/inventory-reservation-apply-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,gCAAiC,YAAW,6BAA6B;IAC9E,4BAA4B,CAChC,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;KACjC,GACA,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAqB9B,mBAAmB,CACvB,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,aAAa,CAAC;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvE,GACA,OAAO,CAAC,IAAI,CAAC;IAsCV,8BAA8B,CAClC,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QACL,WAAW,EAAE,aAAa,CAAC;YACzB,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,EAAE,OAAO,CAAC;SACtB,CAAC,CAAC;KACJ,GACA,OAAO,CAAC,IAAI,CAAC;IAiBV,oBAAoB,CACxB,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QACL,KAAK,EAAE,aAAa,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;SAC1B,CAAC,CAAC;KACJ,GACA,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CA+BjC"}