@endora-commerce/mod-inventory 0.100.0

package/dist/backend/services/inventory-reservation-apply-port.js

@@ -0,0 +1,134 @@
+import { LockMode } from '@mikro-orm/core';
+import { StockAllocation } from '../entities/stock-allocation.entity.js';
+import { StockLevel } from '../entities/stock-level.entity.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 class InventoryReservationApplyService {
+    async lockAvailabilityForPlacement(em, input) {
+        const snapshot = [];
+        // One row at a time, so the lock is fine-grained — a single `$in` query
+        // would take a write lock on every candidate warehouse's row for the line
+        // whether or not the plan ends up touching it. On `em`, so every lock is
+        // held by the caller's transaction until the order commits.
+        for (const warehouseId of input.warehouseIds) {
+            const row = await em.findOne(StockLevel, { productId: input.productId, variantId: input.variantId, warehouseId }, { lockMode: LockMode.PESSIMISTIC_WRITE });
+            // A published record, never the managed entity (D-77's first narrowing).
+            // An absent row answers `0`, which is the same promise a row at zero
+            // makes; whether the write below inserts or updates is this module's to
+            // know and not the caller's.
+            snapshot.push({ warehouseId, available: row ? row.onHand - row.reserved : 0 });
+        }
+        return snapshot;
+    }
+    async reserveForPlacement(em, input) {
+        // command-coverage-ignore: the stock half of an order placement, inside the
+        // caller's transaction. `orders` audits the placement as one operation
+        // through its own Command, and a stock movement this module records
+        // separately would attribute the same decision twice; the audited stock
+        // writes are the admin adjustments in `StockLevelService`, which are
+        // decisions in their own right.
+        for (const allocation of input.allocations) {
+            // The row this transaction locked a moment ago, back out of the identity
+            // map. Re-reading it rather than carrying the managed instance across the
+            // seam is the whole content of D-77's first narrowing: a consumer that
+            // holds the row can move any column of it.
+            const row = await em.findOne(StockLevel, {
+                productId: input.productId,
+                variantId: input.variantId,
+                warehouseId: allocation.warehouseId,
+            });
+            if (row) {
+                row.reserved += allocation.quantity;
+                continue;
+            }
+            // No row for this line in this warehouse: open one so the reserved
+            // counter has somewhere to live. Still no on-hand — nothing has arrived,
+            // it is only promised.
+            const fresh = em.create(StockLevel, {
+                productId: input.productId,
+                ...(input.variantId ? { variantId: input.variantId } : {}),
+                warehouseId: allocation.warehouseId,
+                onHand: 0,
+                reserved: allocation.quantity,
+            });
+            em.persist(fresh);
+        }
+        // Deliberately not flushed: the caller's transaction flushes this beside
+        // the order items whose foreign key holds the allocation rows, which is the
+        // statement order the reservation has always had.
+    }
+    async recordAllocationsForOrderItems(em, input) {
+        // command-coverage-ignore: the provenance rows of an audited order
+        // placement, inside that placement's own transaction — the same reasoning
+        // `reserveForPlacement` above carries.
+        for (const allocation of input.allocations) {
+            em.persist(em.create(StockAllocation, {
+                orderItemId: allocation.orderItemId,
+                warehouseId: allocation.warehouseId,
+                quantity: allocation.quantity,
+                isBackorder: allocation.isBackorder,
+            }));
+        }
+        await em.flush();
+    }
+    async releaseForOrderItems(em, input) {
+        // command-coverage-ignore: the stock side of an audited cancellation. The
+        // `order.status_transition` Command owns the audit trail for the decision;
+        // this is its lifecycle side effect, and mirrors `credit_limits`'
+        // reserve/release pair.
+        if (input.items.length === 0)
+            return { released: 0 };
+        const allocations = await em.find(StockAllocation, {
+            orderItemId: { $in: input.items.map((i) => i.orderItemId) },
+            releasedAt: null,
+        });
+        if (allocations.length === 0)
+            return { released: 0 };
+        const lineByOrderItemId = new Map(input.items.map((i) => [i.orderItemId, i]));
+        const now = new Date();
+        for (const allocation of allocations) {
+            const line = lineByOrderItemId.get(allocation.orderItemId);
+            if (!line)
+                continue;
+            const row = await em.findOne(StockLevel, {
+                productId: line.productId,
+                variantId: line.variantId,
+                warehouseId: allocation.warehouseId,
+            });
+            // `Math.max(0, …)` rather than a bare subtraction: a counter that has
+            // already been corrected by hand must not be driven negative by a release
+            // it no longer accounts for.
+            if (row)
+                row.reserved = Math.max(0, row.reserved - allocation.quantity);
+            allocation.releasedAt = now;
+        }
+        await em.flush();
+        return { released: allocations.length };
+    }
+}
+//# sourceMappingURL=inventory-reservation-apply-port.js.map

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

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

package/dist/backend/services/low-stock-alert-service.d.ts

@@ -0,0 +1,87 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogProductReadPort, EmailMailerPort } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import { StockLevel } from '../entities/stock-level.entity.js';
+/** Feature 047 — structural port for sending via the admin-editable templates. */
+export interface InventoryTemplateEmailPort {
+    trySend(input: {
+        code: string;
+        to: string;
+        messageId: string;
+        variables: Record<string, unknown>;
+        meta?: Record<string, unknown> | undefined;
+    }): Promise<boolean>;
+}
+export interface LowStockSummaryRow {
+    productId: string;
+    productSku: string;
+    productName: string;
+    cumulativeOnHand: number;
+    lowStockThreshold: number;
+}
+export interface AdjustedPayload {
+    productId: string;
+    warehouseId: string;
+    variantId: string | null;
+    before: number;
+    after: number;
+}
+/**
+ * LowStockAlertService (US4 / FR-013).
+ *
+ * Listens for `inventory.adjusted.v1` and fires a single email per
+ * crossing — that is, when *cumulative* on-hand for a product drops
+ * from above the threshold to at-or-below it. The crossing detector
+ * is platform-wide (not per-channel) because the recipient is a
+ * single platform-side mailbox configured by
+ * `inventory.low_stock_alert_recipient_email`.
+ *
+ * `listLowStock()` powers the admin Home Stock Alerts panel + the
+ * dedicated `/inventory/low-stock` page.
+ */
+export declare class LowStockAlertService {
+    private readonly emFactory;
+    private readonly mailer;
+    /**
+     * `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). The
+     * crossing detector and the admin panel both need the product's SKU, name
+     * and threshold, and both used to load the entity out of a table that is
+     * still there when `catalog` is off — so a switched-off catalogue still
+     * produced low-stock alerts about it.
+     */
+    private readonly catalogProducts;
+    private readonly settingsService?;
+    /** Channel id used to read inventory settings — typically the
+     *  system default. */
+    private readonly settingsChannelId?;
+    private readonly templateEmail?;
+    constructor(emFactory: () => EntityManager, mailer: EmailMailerPort, 
+    /**
+     * `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). The
+     * crossing detector and the admin panel both need the product's SKU, name
+     * and threshold, and both used to load the entity out of a table that is
+     * still there when `catalog` is off — so a switched-off catalogue still
+     * produced low-stock alerts about it.
+     */
+    catalogProducts: CatalogProductReadPort, settingsService?: SettingsReadPort | undefined, 
+    /** Channel id used to read inventory settings — typically the
+     *  system default. */
+    settingsChannelId?: string | undefined, templateEmail?: InventoryTemplateEmailPort | undefined);
+    listLowStock(): Promise<LowStockSummaryRow[]>;
+    /**
+     * `inventory.adjusted.v1` — one e-mail per crossing of the product's low-stock
+     * threshold. Registered in this module's `backend.ts` through `ctx.subscribe`,
+     * so the alert stops with the module (issue #107); it used to be a bare
+     * `eventBus.on` here, which kept mailing while `inventory` was switched off.
+     */
+    handleAdjusted(payload: AdjustedPayload): Promise<void>;
+    private fireEmail;
+    private resolveRecipient;
+    /**
+     * Stand-in helper used by tests + the StockLevel mutation paths to
+     * satisfy the unused-stock entity import. Removing it would risk
+     * the pruner stripping the import in incremental builds.
+     */
+    static getStockLevelEntity(): typeof StockLevel;
+}
+//# sourceMappingURL=low-stock-alert-service.d.ts.map

package/dist/backend/services/low-stock-alert-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"low-stock-alert-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/low-stock-alert-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EAEtB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAG/D,kFAAkF;AAClF,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC5C,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC;0BACsB;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAdd,SAAS,EAAE,MAAM,aAAa,EAC9B,MAAM,EAAE,eAAe;IACxC;;;;;;OAMG;IACc,eAAe,EAAE,sBAAsB,EACvC,eAAe,CAAC,EAAE,gBAAgB,YAAA;IACnD;0BACsB;IACL,iBAAiB,CAAC,EAAE,MAAM,YAAA,EAC1B,aAAa,CAAC,EAAE,0BAA0B,YAAA;IAGvD,YAAY,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkCnD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAuB/C,SAAS;YA0CT,gBAAgB;IAgB9B;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO,UAAU;CAGhD"}

package/dist/backend/services/low-stock-alert-service.js

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+import { StockLevel } from '../entities/stock-level.entity.js';
+import { INVENTORY_SETTING_CODES } from '../../manifest.js';
+/**
+ * LowStockAlertService (US4 / FR-013).
+ *
+ * Listens for `inventory.adjusted.v1` and fires a single email per
+ * crossing — that is, when *cumulative* on-hand for a product drops
+ * from above the threshold to at-or-below it. The crossing detector
+ * is platform-wide (not per-channel) because the recipient is a
+ * single platform-side mailbox configured by
+ * `inventory.low_stock_alert_recipient_email`.
+ *
+ * `listLowStock()` powers the admin Home Stock Alerts panel + the
+ * dedicated `/inventory/low-stock` page.
+ */
+export class LowStockAlertService {
+    emFactory;
+    mailer;
+    catalogProducts;
+    settingsService;
+    settingsChannelId;
+    templateEmail;
+    constructor(emFactory, mailer, 
+    /**
+     * `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). The
+     * crossing detector and the admin panel both need the product's SKU, name
+     * and threshold, and both used to load the entity out of a table that is
+     * still there when `catalog` is off — so a switched-off catalogue still
+     * produced low-stock alerts about it.
+     */
+    catalogProducts, settingsService, 
+    /** Channel id used to read inventory settings — typically the
+     *  system default. */
+    settingsChannelId, templateEmail) {
+        this.emFactory = emFactory;
+        this.mailer = mailer;
+        this.catalogProducts = catalogProducts;
+        this.settingsService = settingsService;
+        this.settingsChannelId = settingsChannelId;
+        this.templateEmail = templateEmail;
+    }
+    async listLowStock() {
+        const em = this.emFactory();
+        // `em.execute`, not `em.getKnex()`: a knex handle takes its own pooled
+        // connection, so the report would answer from outside a transaction the
+        // caller holds open (issue #207).
+        const rows = (await em.execute(`select product_id, sum(on_hand) as on_hand from stock_levels group by product_id`));
+        if (rows.length === 0)
+            return [];
+        const productIds = rows.map((r) => r.product_id);
+        const products = await this.catalogProducts.findByIds(productIds);
+        const productById = new Map(products.map((p) => [p.id, p]));
+        const result = [];
+        for (const row of rows) {
+            const p = productById.get(row.product_id);
+            if (!p)
+                continue;
+            if (!p.manageStock)
+                continue;
+            const threshold = p.lowStockThreshold;
+            if (threshold === null)
+                continue;
+            const cumulative = Number(row.on_hand ?? 0);
+            if (cumulative > threshold)
+                continue;
+            const productName = p.name['en-US'] ?? Object.values(p.name)[0] ?? p.sku;
+            result.push({
+                productId: p.id,
+                productSku: p.sku,
+                productName: String(productName),
+                cumulativeOnHand: cumulative,
+                lowStockThreshold: threshold,
+            });
+        }
+        return result;
+    }
+    /**
+     * `inventory.adjusted.v1` — one e-mail per crossing of the product's low-stock
+     * threshold. Registered in this module's `backend.ts` through `ctx.subscribe`,
+     * so the alert stops with the module (issue #107); it used to be a bare
+     * `eventBus.on` here, which kept mailing while `inventory` was switched off.
+     */
+    async handleAdjusted(payload) {
+        const em = this.emFactory();
+        const product = await this.catalogProducts.findById(payload.productId);
+        if (!product || !product.manageStock)
+            return;
+        const threshold = product.lowStockThreshold;
+        if (threshold === null)
+            return;
+        // Recompute cumulative across all warehouses (the event payload only
+        // carries one warehouse's delta). before/after for the cumulative
+        // crossing is `cumulativeBefore = (newCumulative - delta)`.
+        // `em.execute`, not `em.getKnex()` — same reason as the report above.
+        const sumRows = (await em.execute(`select sum(on_hand) as on_hand from stock_levels where product_id = ?`, [product.id]));
+        const cumulativeAfter = Number(sumRows[0]?.on_hand ?? 0);
+        const cumulativeBefore = cumulativeAfter - (payload.after - payload.before);
+        if (cumulativeBefore > threshold && cumulativeAfter <= threshold) {
+            await this.fireEmail(product, cumulativeAfter, threshold);
+        }
+    }
+    async fireEmail(product, cumulative, threshold) {
+        const recipient = await this.resolveRecipient();
+        if (!recipient)
+            return;
+        const productName = product.name['en-US'] ?? Object.values(product.name)[0] ?? product.sku;
+        const messageId = `inventory.low-stock:${product.id}:${Date.now()}`;
+        const meta = { productId: product.id, cumulativeOnHand: cumulative, threshold };
+        if (this.templateEmail) {
+            const sent = await this.templateEmail.trySend({
+                code: 'low_stock_alert',
+                to: recipient,
+                messageId,
+                variables: {
+                    product: { name: productName, sku: product.sku },
+                    cumulativeOnHand: cumulative,
+                    threshold,
+                },
+                meta,
+            });
+            if (sent)
+                return;
+        }
+        const outcome = await this.mailer.send({
+            messageId,
+            to: recipient,
+            subject: `Low stock: ${productName}`,
+            text: `Cumulative on-hand for "${productName}" (SKU ${product.sku}) has crossed the low-stock threshold.\n\n  Current cumulative on-hand: ${cumulative}\n  Threshold: ${threshold}\n`,
+            kind: 'low_stock_alert',
+            meta,
+        });
+        if (outcome.status !== 'sent') {
+            // This fires from a crossing detector with no caller to answer, so the
+            // non-send is named here and durable in D-59's record.
+            console.warn('[inventory] the low-stock alert was not sent', {
+                productId: product.id,
+                reason: outcome.reason,
+            });
+        }
+    }
+    async resolveRecipient() {
+        if (this.settingsService && this.settingsChannelId) {
+            try {
+                const value = await this.settingsService.get(INVENTORY_SETTING_CODES.LOW_STOCK_ALERT_RECIPIENT_EMAIL, this.settingsChannelId, z.string());
+                if (value && value.trim().length > 0)
+                    return value.trim();
+            }
+            catch {
+                // fall through
+            }
+        }
+        return process.env['INVENTORY_LOW_STOCK_RECIPIENT'] ?? null;
+    }
+    /**
+     * Stand-in helper used by tests + the StockLevel mutation paths to
+     * satisfy the unused-stock entity import. Removing it would risk
+     * the pruner stripping the import in incremental builds.
+     */
+    static getStockLevelEntity() {
+        return StockLevel;
+    }
+}
+//# sourceMappingURL=low-stock-alert-service.js.map

package/dist/backend/services/low-stock-alert-service.js.map

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

package/dist/backend/services/product-threshold-write.service.d.ts

@@ -0,0 +1,38 @@
+import type { InventoryProductThresholdWritePort, ProductThresholdCopyResult } from '@endora-commerce/contracts';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+/**
+ * The per-warehouse threshold copy this module publishes (issue #185).
+ *
+ * `catalog`'s `duplicateProduct` used to write these rows itself:
+ *
+ * ```
+ * insert into "product_warehouse_low_stock_thresholds"
+ *   ("product_id", "warehouse_id", "threshold", "created_at", "updated_at")
+ *   select ?, "warehouse_id", "threshold", now(), now()
+ *     from "product_warehouse_low_stock_thresholds" where "product_id" = ?
+ * ```
+ *
+ * — on `catalog`'s `EntityManager`, after its `CommandBus.run` had already
+ * returned, with this module's activation state never consulted. It is the same
+ * shape D-74 took off `import_export` for `stock_levels`, and it comes back for
+ * the same three reasons: the write is one Command and one audit row, it is
+ * gated by the module that owns the rows, and the caller stops needing to know
+ * the table's columns.
+ *
+ * **Its own transaction, deliberately.** `duplicateProduct` commits the product
+ * row first and then copies each bridge — the code says so at the seam and has
+ * since feature 054 ("a partially-copied dup is no worse than today"). Nothing
+ * here can be co-transactional with a transaction that has already committed,
+ * and nothing should want to be: a duplicate without per-warehouse thresholds
+ * falls back to the product-level and warehouse-level chain, which is precisely
+ * what a duplicate looks like on a deployment that never installed this module.
+ */
+export declare class InventoryProductThresholdWriteService implements InventoryProductThresholdWritePort {
+    private readonly commandBus;
+    constructor(commandBus: CommandBus);
+    copyProductWarehouseThresholds(input: {
+        sourceProductId: string;
+        targetProductId: string;
+    }): Promise<ProductThresholdCopyResult>;
+}
+//# sourceMappingURL=product-threshold-write.service.d.ts.map

package/dist/backend/services/product-threshold-write.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-threshold-write.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/product-threshold-write.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qCACX,YAAW,kCAAkC;IAEjC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAE7C,8BAA8B,CAAC,KAAK,EAAE;QAC1C,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAkDxC"}

package/dist/backend/services/product-threshold-write.service.js

@@ -0,0 +1,80 @@
+import { ProductWarehouseLowStockThreshold } from '../entities/product-warehouse-low-stock-threshold.entity.js';
+/**
+ * The per-warehouse threshold copy this module publishes (issue #185).
+ *
+ * `catalog`'s `duplicateProduct` used to write these rows itself:
+ *
+ * ```
+ * insert into "product_warehouse_low_stock_thresholds"
+ *   ("product_id", "warehouse_id", "threshold", "created_at", "updated_at")
+ *   select ?, "warehouse_id", "threshold", now(), now()
+ *     from "product_warehouse_low_stock_thresholds" where "product_id" = ?
+ * ```
+ *
+ * — on `catalog`'s `EntityManager`, after its `CommandBus.run` had already
+ * returned, with this module's activation state never consulted. It is the same
+ * shape D-74 took off `import_export` for `stock_levels`, and it comes back for
+ * the same three reasons: the write is one Command and one audit row, it is
+ * gated by the module that owns the rows, and the caller stops needing to know
+ * the table's columns.
+ *
+ * **Its own transaction, deliberately.** `duplicateProduct` commits the product
+ * row first and then copies each bridge — the code says so at the seam and has
+ * since feature 054 ("a partially-copied dup is no worse than today"). Nothing
+ * here can be co-transactional with a transaction that has already committed,
+ * and nothing should want to be: a duplicate without per-warehouse thresholds
+ * falls back to the product-level and warehouse-level chain, which is precisely
+ * what a duplicate looks like on a deployment that never installed this module.
+ */
+export class InventoryProductThresholdWriteService {
+    commandBus;
+    constructor(commandBus) {
+        this.commandBus = commandBus;
+    }
+    async copyProductWarehouseThresholds(input) {
+        return this.commandBus.run({
+            action: 'inventory.product_thresholds.copy',
+            objectType: 'product_warehouse_low_stock_threshold',
+            objectId: input.targetProductId,
+            run: async ({ em }) => {
+                const source = await em.find(ProductWarehouseLowStockThreshold, {
+                    productId: input.sourceProductId,
+                });
+                if (source.length === 0) {
+                    // Nothing changed state, so nothing is recorded — the rule
+                    // `SalesChannelMembershipService` applies to an idempotent add.
+                    return { result: { copied: 0 }, skipAudit: true };
+                }
+                const existing = await em.find(ProductWarehouseLowStockThreshold, {
+                    productId: input.targetProductId,
+                    warehouseId: { $in: source.map((row) => row.warehouseId) },
+                });
+                const byWarehouse = new Map(existing.map((row) => [row.warehouseId, row]));
+                for (const row of source) {
+                    const target = byWarehouse.get(row.warehouseId);
+                    if (target) {
+                        target.threshold = row.threshold;
+                        continue;
+                    }
+                    em.persist(em.create(ProductWarehouseLowStockThreshold, {
+                        productId: input.targetProductId,
+                        warehouseId: row.warehouseId,
+                        threshold: row.threshold,
+                        createdAt: new Date(),
+                        updatedAt: new Date(),
+                    }));
+                }
+                await em.flush();
+                return {
+                    result: { copied: source.length },
+                    after: {
+                        sourceProductId: input.sourceProductId,
+                        targetProductId: input.targetProductId,
+                        copied: source.length,
+                    },
+                };
+            },
+        });
+    }
+}
+//# sourceMappingURL=product-threshold-write.service.js.map

package/dist/backend/services/product-threshold-write.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-threshold-write.service.js","sourceRoot":"","sources":["../../../src/backend/services/product-threshold-write.service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iCAAiC,EAAE,MAAM,6DAA6D,CAAC;AAEhH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,qCAAqC;IAGnB;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD,KAAK,CAAC,8BAA8B,CAAC,KAGpC;QACC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAA6B;YACrD,MAAM,EAAE,mCAAmC;YAC3C,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,KAAK,CAAC,eAAe;YAC/B,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;gBACpB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE;oBAC9D,SAAS,EAAE,KAAK,CAAC,eAAe;iBACjC,CAAC,CAAC;gBACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,2DAA2D;oBAC3D,gEAAgE;oBAChE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;gBACpD,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE;oBAChE,SAAS,EAAE,KAAK,CAAC,eAAe;oBAChC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;iBAC3D,CAAC,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBAE3E,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;oBACzB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBAChD,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;wBACjC,SAAS;oBACX,CAAC;oBACD,EAAE,CAAC,OAAO,CACR,EAAE,CAAC,MAAM,CAAC,iCAAiC,EAAE;wBAC3C,SAAS,EAAE,KAAK,CAAC,eAAe;wBAChC,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,SAAS,EAAE,IAAI,IAAI,EAAE;wBACrB,SAAS,EAAE,IAAI,IAAI,EAAE;qBACtB,CAAC,CACH,CAAC;gBACJ,CAAC;gBACD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBAEjB,OAAO;oBACL,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;oBACjC,KAAK,EAAE;wBACL,eAAe,EAAE,KAAK,CAAC,eAAe;wBACtC,eAAe,EAAE,KAAK,CAAC,eAAe;wBACtC,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+import type { BulkImportReport, CatalogProductReadPort, InventoryStockImportPort, StockLevelImportRow } from '@endora-commerce/contracts';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+/**
+ * Bulk import of stock levels (feature 075, D-74).
+ *
+ * The counterpart of `catalog`'s bulk import, and it exists for the same three
+ * reasons: the write is one Command and one audit row, validation runs before
+ * anything is applied, and the whole run is all-or-nothing.
+ *
+ * Two things came back to this module with it. The rows are `stock_levels`, and
+ * `import_export` was writing them while declaring a dependency on `catalog` and
+ * `auth` only — an edge no check in the tree could see, because this module
+ * ships the migration and that one ships none. And the seeded warehouse was
+ * addressed by a **copy** of the deterministic UUID this module exports, pasted
+ * into a function body; a duplicated constant is a coupling `check:module-boundary`
+ * is structurally unable to report, since it reads import specifiers.
+ *
+ * The row carries no warehouse, which is the pre-existing contract of the CSV
+ * path rather than a simplification taken here: foundation 001's sheet has no
+ * warehouse column, so every row lands in the default warehouse. The
+ * warehouse-scoped importer is `CsvStockImporter`, reached from this module's
+ * own admin route.
+ */
+export declare class InventoryStockImportService implements InventoryStockImportPort {
+    private readonly commandBus;
+    /**
+     * SKU → product id. A spreadsheet addresses a product the way an operator
+     * does, so somebody has to ask `catalog`; doing it here is what lets the
+     * rejected-row message ("unknown product_sku") be raised by the module that
+     * knows the answer.
+     */
+    private readonly products;
+    constructor(commandBus: CommandBus, 
+    /**
+     * SKU → product id. A spreadsheet addresses a product the way an operator
+     * does, so somebody has to ask `catalog`; doing it here is what lets the
+     * rejected-row message ("unknown product_sku") be raised by the module that
+     * knows the answer.
+     */
+    products: CatalogProductReadPort);
+    importStockLevels(rows: readonly StockLevelImportRow[]): Promise<BulkImportReport>;
+}
+//# sourceMappingURL=stock-import.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stock-import.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/stock-import.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAKrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAExE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAPR,UAAU,EAAE,UAAU;IACvC;;;;;OAKG;IACc,QAAQ,EAAE,sBAAsB;IAG7C,iBAAiB,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwFzF"}