@endora-commerce/mod-inventory 0.100.0

package/dist/backend/services/availability-notification-service.js

@@ -0,0 +1,363 @@
+import { ANONYMOUS_PRODUCT_AUDIENCE, ERROR_CODES, isProductVisibleTo, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { outOfRequestChannel, } from '@endora-commerce/platform/kernel';
+import { AvailabilityNotification } from '../entities/availability-notification.entity.js';
+import { StockLevel } from '../entities/stock-level.entity.js';
+/**
+ * The two attribution columns, written together from one resolved owner.
+ *
+ * This module has a single write — there is no association path that adopts an
+ * anonymous subscription into an account later, which is what makes one
+ * function enough here where `pwa` needs both directions of an upsert to go
+ * through it.
+ */
+function ownerColumns(owner) {
+    return owner.kind === 'customer'
+        ? { customerAccountId: owner.customerAccountId, organizationId: owner.organizationId }
+        : {
+            customerAccountId: null,
+            // FR-011 — an anonymous subscription belongs to no organisation, and
+            // the constraint says nothing about it. `an_recipient_check` is what
+            // keeps such a row addressable: its `email` is the recipient. Who it
+            // *should* belong to is R-6's open question and is not answered here.
+            organizationId: null,
+        };
+}
+/**
+ * AvailabilityNotificationService — feature 010 / US6 surface.
+ *
+ * The original foundation 001 service had a single `subscribe(customerId,
+ * productId, variantId?)` entry point. Feature 010 extends it for the
+ * three customer paths spelled out in spec.md US6:
+ *
+ *   - storefront customer signed-in → email pre-filled from the account
+ *   - storefront anonymous → caller supplies the email
+ *   - admin browses + cancels any queued row
+ *
+ * The restock fan-out lives on `AvailabilityWorker.dispatchForStockIncrease`
+ * (already exists from foundation 001); the worker is rewired in US6 to
+ * subscribe to `inventory.adjusted.v1` events with `before === 0 &&
+ * after > 0` so a stock-bump fans out one email per queued row.
+ */
+export class AvailabilityNotificationService {
+    emFactory;
+    catalogProducts;
+    customerAccounts;
+    channelMembership;
+    mailer;
+    templateEmail;
+    constructor(emFactory, 
+    /** `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). */
+    catalogProducts, 
+    /**
+     * `customerAccountReadPort`, owned by `customer_accounts` (feature 075).
+     *
+     * Feature 087 / D-187 gives it a second reader: the organisation an owned
+     * subscription carries. It was already **required** here before that
+     * ruling and stays so — this module has exactly one construction site
+     * (`plugin.ts`) and it holds the gated port, so a composition that cannot
+     * answer "which organisation owns this account" cannot build the service
+     * at all. Nothing had to be argued for; it is recorded because `pwa` had
+     * to widen its constructor for the same read and the two modules now sit
+     * in the same state.
+     *
+     * Resolved through `lazyPort`, so a switched-off `customer_accounts`
+     * refuses at the call with the 503 `MODULE_DISABLED` envelope rather than
+     * at composition time.
+     */
+    customerAccounts, 
+    /**
+     * `salesChannelMembershipPort` — the sanctioned bridge accessor
+     * (Constitution XII), through which {@link subscribe} asks whether the
+     * request's channel publishes the product at all.
+     *
+     * Required rather than optional, and placed before the two optional
+     * transports so a construction site cannot leave it off by accident: an
+     * optional channel gate is a composition that silently answers without one,
+     * which is precisely the state this parameter was added to end. It is a
+     * kernel registration rather than a module's, so it adds no edge to this
+     * module's manifest.
+     */
+    channelMembership, mailer, templateEmail) {
+        this.emFactory = emFactory;
+        this.catalogProducts = catalogProducts;
+        this.customerAccounts = customerAccounts;
+        this.channelMembership = channelMembership;
+        this.mailer = mailer;
+        this.templateEmail = templateEmail;
+    }
+    /**
+     * The organisation that owns a subscription belonging to this account —
+     * feature 087 Group B, D-187.
+     *
+     * Total, and refuses rather than returning `null`:
+     * `customer_accounts.organization_id` is `NOT NULL` (D-178), so an account
+     * that resolves always has one, and an account that does not resolve is a
+     * caller naming a row that is not there. Either way there is no organisation
+     * to stamp, and a subscription written without one is a buyer hidden from
+     * the representative who serves them — which is the whole defect this column
+     * exists to close. So the write stops here, where the message can name the
+     * account, instead of at the constraint.
+     */
+    async #organizationOf(customerAccountId) {
+        const account = await this.customerAccounts.findById(customerAccountId);
+        if (!account) {
+            throw new Error(`AvailabilityNotificationService: customer account ${customerAccountId} does not resolve, ` +
+                'so the availability notification it would own has no organisation to carry.');
+        }
+        return account.organizationId;
+    }
+    /** The caller's owner input, with the organisation a customer owner implies. */
+    async #resolveOwner(customerAccountId) {
+        if (customerAccountId === null || customerAccountId === undefined)
+            return { kind: 'anonymous' };
+        return {
+            kind: 'customer',
+            customerAccountId,
+            organizationId: await this.#organizationOf(customerAccountId),
+        };
+    }
+    /**
+     * May this caller acquire this product at all — the two filters every
+     * product acquisition seam owes (issue #227, issue #259).
+     *
+     * Both are asked through the shared machinery rather than restated here:
+     * `isProductVisibleTo` is the platform's one answer to "may this audience see
+     * this product", and {@link outOfRequestChannel} is the channel half, which
+     * that predicate says in writing it is not. The channel is read off the
+     * request scope through `salesChannelMembershipPort` — the sanctioned bridge
+     * accessor — and never re-resolved here; outside a request (a worker, a CLI,
+     * a fixture calling the service directly) there is no channel to be out of
+     * and the gate answers `false`.
+     *
+     * The caller gets **one** answer for "no", and the reason is the whole point:
+     * the three states this can refuse — the row is not there, the operator
+     * restricted it to another organisation, another channel sells it — must be
+     * one response, or an unauthenticated caller can sort product ids by reading
+     * which refusal came back. The later gates (`PRODUCT_UNMANAGED_STOCK`,
+     * `PRODUCT_IN_STOCK`) do discriminate, deliberately and harmlessly: they are
+     * reached only for a product this caller may already see in the catalogue,
+     * whose existence and stock band that catalogue answers anyway.
+     */
+    async #mayAcquire(product, audience) {
+        if (!isProductVisibleTo(product, audience ?? ANONYMOUS_PRODUCT_AUDIENCE))
+            return false;
+        return !(await outOfRequestChannel(this.channelMembership, product.id));
+    }
+    /**
+     * Subscribe a customer / anonymous email to a product's restock signal.
+     *
+     * Refuses with 404 PRODUCT_NOT_FOUND for every product this caller may not
+     * acquire — see {@link #mayAcquire}; with 422 PRODUCT_IN_STOCK when
+     * cumulative on-hand > 0; with 409 PRODUCT_UNMANAGED_STOCK when the product
+     * opted out of stock tracking; and idempotently returns the existing row on a
+     * re-subscribe.
+     */
+    async subscribe(input) {
+        // command-coverage-ignore: customer back-in-stock notification opt-in — a
+        // self-service subscription record, not an audited domain-state mutation.
+        const em = this.emFactory();
+        const product = await this.catalogProducts.findById(input.productId, { liveOnly: true });
+        // Asking to be told when a product returns is an **acquisition**: the
+        // caller names a product id they chose, the platform stores a row against
+        // it, and answers later with an e-mail naming it. So the two gates every
+        // other acquisition seam applies are applied here, and all three states —
+        // absent, restricted, sold on another channel — leave through the one
+        // refusal below.
+        if (!product || !(await this.#mayAcquire(product, input.audience))) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
+        }
+        if (!product.manageStock) {
+            throw new HttpError(409, 'PRODUCT_UNMANAGED_STOCK', 'Product does not track stock; subscribe is unnecessary.');
+        }
+        // Cumulative on-hand across every warehouse — the subscribe is gated
+        // platform-wide, not per channel.
+        // `em.execute`, not `em.getKnex()`: a knex handle carries no transaction
+        // context, so this in-stock gate would answer from outside a transaction the
+        // caller holds open while the `em.findOne` below answers from inside it
+        // (issue #207).
+        const sumRows = (await em.execute(`select sum(on_hand) as on_hand from stock_levels where product_id = ?`, [input.productId]));
+        const cumulative = Number(sumRows[0]?.on_hand ?? 0);
+        if (cumulative > 0) {
+            throw new HttpError(422, ERROR_CODES.PRODUCT_IN_STOCK, 'Product is currently in stock — no notification needed.');
+        }
+        const existing = await em.findOne(AvailabilityNotification, {
+            productId: input.productId,
+            variantId: input.variantId ?? null,
+            email: input.email,
+            notifiedAt: null,
+            status: 'queued',
+        });
+        if (existing)
+            return existing;
+        // D-187 — resolved **before** the first managed entity is touched. `em.create`
+        // registers the row with the unit of work, so a refusal raised after it
+        // would leave an owned, unattributed subscription there for whatever
+        // flushes this request next.
+        const owner = await this.#resolveOwner(input.customerAccountId);
+        const subscription = em.create(AvailabilityNotification, {
+            productId: input.productId,
+            ...(input.variantId !== undefined && input.variantId !== null
+                ? { variantId: input.variantId }
+                : {}),
+            // D-187 — the only place a subscription is inserted, and the organisation
+            // goes in with the account. `ownerColumns` takes a *resolved* owner, so
+            // the customer branch has no shape in which the organisation could be
+            // omitted; the anonymous branch has none to carry (FR-011).
+            ...ownerColumns(owner),
+            email: input.email,
+            status: 'queued',
+        });
+        await em.persistAndFlush(subscription);
+        return subscription;
+    }
+    async cancel(id) {
+        // command-coverage-ignore: customer notification opt-out — flips a
+        // self-service subscription to cancelled, not an audited domain mutation.
+        const em = this.emFactory();
+        const row = await em.findOne(AvailabilityNotification, { id });
+        if (!row) {
+            throw new HttpError(404, 'AVAILABILITY_NOTIFICATION_NOT_FOUND', 'Subscription not found.');
+        }
+        row.status = 'cancelled';
+        await em.flush();
+    }
+    async listForAdmin(filter = {}) {
+        const em = this.emFactory();
+        const page = Math.max(0, filter.page ?? 0);
+        const pageSize = Math.min(Math.max(1, filter.pageSize ?? 50), 200);
+        const where = {};
+        if (filter.productId)
+            where['productId'] = filter.productId;
+        if (filter.status)
+            where['status'] = filter.status;
+        const [rows, total] = await em.findAndCount(AvailabilityNotification, where, {
+            orderBy: { requestedAt: 'desc' },
+            offset: page * pageSize,
+            limit: pageSize,
+        });
+        if (rows.length === 0)
+            return { items: [], page, pageSize, total };
+        const productIds = Array.from(new Set(rows.map((r) => r.productId)));
+        const products = await this.catalogProducts.findByIds(productIds);
+        const productById = new Map(products.map((p) => [p.id, p]));
+        const customerIds = Array.from(new Set(rows.map((r) => r.customerAccountId).filter((id) => typeof id === 'string')));
+        const customers = customerIds.length
+            ? await this.customerAccounts.findByIds(customerIds)
+            : [];
+        const customerById = new Map(customers.map((c) => [c.id, c]));
+        return {
+            items: rows.map((r) => {
+                const p = productById.get(r.productId);
+                const productName = p
+                    ? p.name['en-US'] ?? Object.values(p.name)[0] ?? p.sku
+                    : '—';
+                const email = r.email ??
+                    (r.customerAccountId ? customerById.get(r.customerAccountId)?.email ?? '' : '');
+                return {
+                    id: r.id,
+                    productId: r.productId,
+                    productName: String(productName),
+                    productSku: p?.sku ?? '',
+                    customerAccountId: r.customerAccountId ?? null,
+                    email,
+                    status: r.status,
+                    queuedAt: r.requestedAt.toISOString(),
+                    notifiedAt: r.notifiedAt ? r.notifiedAt.toISOString() : null,
+                };
+            }),
+            page,
+            pageSize,
+            total,
+        };
+    }
+    /**
+     * Restock fan-out — invoked by AvailabilityWorker when cumulative on-hand
+     * crosses from 0 to > 0 for a (product, variant) pair. Emits one mail
+     * per queued row and flips status → 'notified'.
+     */
+    async processRestockedFanOut(input) {
+        // command-coverage-ignore: background notification delivery — flips queued
+        // subscriptions to 'notified' after send, delivery bookkeeping (not domain).
+        if (!this.mailer && !this.templateEmail)
+            return { notified: 0 };
+        const em = this.emFactory();
+        const where = {
+            productId: input.productId,
+            status: 'queued',
+            notifiedAt: null,
+        };
+        if (input.variantId === undefined || input.variantId === null) {
+            where['variantId'] = null;
+        }
+        else {
+            where['variantId'] = input.variantId;
+        }
+        const rows = await em.find(AvailabilityNotification, where);
+        if (rows.length === 0)
+            return { notified: 0 };
+        const product = await this.catalogProducts.findById(input.productId);
+        const productName = product
+            ? product.name['en-US'] ?? Object.values(product.name)[0] ?? product.sku
+            : 'product';
+        const customerIds = Array.from(new Set(rows.map((r) => r.customerAccountId).filter((id) => typeof id === 'string')));
+        const customers = customerIds.length
+            ? await this.customerAccounts.findByIds(customerIds)
+            : [];
+        const emailById = new Map(customers.map((c) => [c.id, c.email]));
+        const now = new Date();
+        let notified = 0;
+        for (const row of rows) {
+            const to = row.email ?? (row.customerAccountId ? emailById.get(row.customerAccountId) : null);
+            if (!to) {
+                row.status = 'cancelled';
+                row.notifiedAt = now;
+                continue;
+            }
+            const messageId = `availability:${row.id}`;
+            const meta = {
+                productId: input.productId,
+                variantId: input.variantId ?? null,
+                notificationId: row.id,
+            };
+            let sentViaTemplate = false;
+            if (this.templateEmail) {
+                sentViaTemplate = await this.templateEmail.trySend({
+                    code: 'availability_back_in_stock',
+                    to,
+                    messageId,
+                    variables: { product: { name: productName } },
+                    meta,
+                });
+            }
+            if (!sentViaTemplate && this.mailer) {
+                const outcome = await this.mailer.send({
+                    messageId,
+                    to,
+                    subject: `Back in stock: ${productName}`,
+                    text: `Good news — "${productName}" is available again.`,
+                    kind: 'availability_back_in_stock',
+                    meta,
+                });
+                if (outcome.status !== 'sent') {
+                    // Still marked notified below: the transport's one suppression is an
+                    // already-accepted `messageId`, so this subscriber has the message.
+                    console.warn('[inventory] the back-in-stock e-mail was not sent', {
+                        notificationId: row.id,
+                        reason: outcome.reason,
+                    });
+                }
+            }
+            row.status = 'notified';
+            row.notifiedAt = now;
+            notified += 1;
+        }
+        await em.flush();
+        return { notified };
+    }
+    /** Stand-in helper used to keep the unused entity import alive. */
+    static getStockLevelEntity() {
+        return StockLevel;
+    }
+}
+//# sourceMappingURL=availability-notification-service.js.map

package/dist/backend/services/availability-notification-service.js.map

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

package/dist/backend/services/availability-worker.d.ts

@@ -0,0 +1,57 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogProductReadPort, CustomerAccountReadPort, EmailMailerPort } from '@endora-commerce/contracts';
+export interface AdjustedPayload {
+    productId: string;
+    warehouseId: string;
+    variantId: string | null;
+    before: number;
+    after: number;
+}
+/**
+ * Availability worker (T136 / FR-061).
+ *
+ * Call `dispatchForStockIncrease({ productId, variantId? })` after any
+ * stock-mutation path that raises a (product, variant) row's onHand. The
+ * worker:
+ *
+ *   1. Loads every AvailabilityNotification for that (productId, variantId)
+ *      that hasn't yet been notified.
+ *   2. For each subscriber, sends a back-in-stock email via the injected
+ *      Mailer.
+ *   3. Marks the notification consumed (`notifiedAt = now`) inside one
+ *      flush so a worker crash mid-batch doesn't double-send (the next
+ *      run re-loads only un-notified rows).
+ *
+ * Production composition can swap synchronous dispatch for a BullMQ job
+ * by binding a queue producer to the same method signature.
+ */
+export declare class AvailabilityWorker {
+    private readonly emFactory;
+    private readonly mailer;
+    /** `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). */
+    private readonly catalogProducts;
+    /** `customerAccountReadPort`, owned by `customer_accounts` (feature 075). */
+    private readonly customerAccounts;
+    constructor(emFactory: () => EntityManager, mailer: EmailMailerPort, 
+    /** `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). */
+    catalogProducts: CatalogProductReadPort, 
+    /** `customerAccountReadPort`, owned by `customer_accounts` (feature 075). */
+    customerAccounts: CustomerAccountReadPort);
+    dispatchForStockIncrease(input: {
+        productId: string;
+        variantId?: string | null;
+    }): Promise<{
+        notified: number;
+    }>;
+    /**
+     * `inventory.adjusted.v1` — fan out only when cumulative on-hand across all
+     * warehouses crossed from 0 to > 0 for the (product, variant) pair, not on
+     * every `stock_levels` row tweak.
+     *
+     * The subscription lives in this module's `backend.ts` and goes through
+     * `ctx.subscribe`, so a switched-off `inventory` sends no back-in-stock mail
+     * (issue #107). It used to be a bare `eventBus.on` here.
+     */
+    handleAdjusted(payload: AdjustedPayload): Promise<void>;
+}
+//# sourceMappingURL=availability-worker.d.ts.map

package/dist/backend/services/availability-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability-worker.d.ts","sourceRoot":"","sources":["../../../src/backend/services/availability-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAIpC,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;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBALhB,SAAS,EAAE,MAAM,aAAa,EAC9B,MAAM,EAAE,eAAe;IACxC,2EAA2E;IAC1D,eAAe,EAAE,sBAAsB;IACxD,6EAA6E;IAC5D,gBAAgB,EAAE,uBAAuB;IAGtD,wBAAwB,CAAC,KAAK,EAAE;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA2EjC;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAwB9D"}

package/dist/backend/services/availability-worker.js

@@ -0,0 +1,135 @@
+import { AvailabilityNotification } from '../entities/availability-notification.entity.js';
+import { withSystemScope } from '@endora-commerce/platform/tenancy';
+/**
+ * Availability worker (T136 / FR-061).
+ *
+ * Call `dispatchForStockIncrease({ productId, variantId? })` after any
+ * stock-mutation path that raises a (product, variant) row's onHand. The
+ * worker:
+ *
+ *   1. Loads every AvailabilityNotification for that (productId, variantId)
+ *      that hasn't yet been notified.
+ *   2. For each subscriber, sends a back-in-stock email via the injected
+ *      Mailer.
+ *   3. Marks the notification consumed (`notifiedAt = now`) inside one
+ *      flush so a worker crash mid-batch doesn't double-send (the next
+ *      run re-loads only un-notified rows).
+ *
+ * Production composition can swap synchronous dispatch for a BullMQ job
+ * by binding a queue producer to the same method signature.
+ */
+export class AvailabilityWorker {
+    emFactory;
+    mailer;
+    catalogProducts;
+    customerAccounts;
+    constructor(emFactory, mailer, 
+    /** `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). */
+    catalogProducts, 
+    /** `customerAccountReadPort`, owned by `customer_accounts` (feature 075). */
+    customerAccounts) {
+        this.emFactory = emFactory;
+        this.mailer = mailer;
+        this.catalogProducts = catalogProducts;
+        this.customerAccounts = customerAccounts;
+    }
+    async dispatchForStockIncrease(input) {
+        // command-coverage-ignore: background restock fan-out — stamps notifiedAt on
+        // subscriptions as it sends, delivery bookkeeping (not an audited domain write).
+        // Feature 050 — triggered off a stock-increase event; may run detached, so
+        // scope the AvailabilityNotification reads under a system context.
+        return withSystemScope('availability stock-increase', async () => {
+            const em = this.emFactory();
+            const product = await this.catalogProducts.findById(input.productId);
+            if (!product)
+                return { notified: 0 };
+            const where = {
+                productId: input.productId,
+                notifiedAt: null,
+            };
+            if (input.variantId === undefined || input.variantId === null) {
+                where['variantId'] = null;
+            }
+            else {
+                where['variantId'] = input.variantId;
+            }
+            const subscriptions = await em.find(AvailabilityNotification, where);
+            if (subscriptions.length === 0)
+                return { notified: 0 };
+            const customerIds = Array.from(new Set(subscriptions
+                .map((s) => s.customerAccountId)
+                .filter((id) => typeof id === 'string')));
+            const customers = customerIds.length > 0 ? await this.customerAccounts.findByIds(customerIds) : [];
+            const emailById = new Map(customers.map((c) => [c.id, c.email]));
+            const productName = product.name['en-US'] ?? Object.values(product.name)[0] ?? product.sku;
+            const now = new Date();
+            for (const sub of subscriptions) {
+                // Feature 010: subscriptions can carry an `email` directly
+                // (anonymous path). Prefer that; otherwise fall back to the
+                // customer-account email.
+                const to = sub.email ?? (sub.customerAccountId ? emailById.get(sub.customerAccountId) : null);
+                if (!to) {
+                    // Customer was deleted; mark consumed anyway so we stop retrying.
+                    sub.notifiedAt = now;
+                    continue;
+                }
+                const outcome = await this.mailer.send({
+                    messageId: `availability:${sub.id}`,
+                    to,
+                    subject: `Back in stock: ${productName}`,
+                    text: `Good news — "${productName}" is available again.`,
+                    kind: 'availability_back_in_stock',
+                    meta: {
+                        productId: input.productId,
+                        variantId: input.variantId ?? null,
+                        notificationId: sub.id,
+                    },
+                });
+                if (outcome.status !== 'sent') {
+                    // The subscription is still consumed: the one suppression a transport
+                    // performs is an already-accepted `messageId`, which means this
+                    // subscriber was notified by an earlier run. Re-sending it is the
+                    // duplicate the idempotency key exists to prevent.
+                    console.warn('[inventory] the back-in-stock e-mail was not sent', {
+                        notificationId: sub.id,
+                        reason: outcome.reason,
+                    });
+                }
+                sub.notifiedAt = now;
+            }
+            await em.flush();
+            return { notified: subscriptions.length };
+        });
+    }
+    /**
+     * `inventory.adjusted.v1` — fan out only when cumulative on-hand across all
+     * warehouses crossed from 0 to > 0 for the (product, variant) pair, not on
+     * every `stock_levels` row tweak.
+     *
+     * The subscription lives in this module's `backend.ts` and goes through
+     * `ctx.subscribe`, so a switched-off `inventory` sends no back-in-stock mail
+     * (issue #107). It used to be a bare `eventBus.on` here.
+     */
+    async handleAdjusted(payload) {
+        if (payload.after <= 0)
+            return;
+        const em = this.emFactory();
+        // `em.execute`, not `em.getKnex()`: a knex handle takes its own pooled
+        // connection, so a caller that raised this event from inside a transaction
+        // would have the sum answered from outside it (issue #207).
+        const variantClause = payload.variantId === null ? 'variant_id is null' : 'variant_id = ?';
+        const variantParams = payload.variantId === null ? [] : [payload.variantId];
+        const sumRows = (await em.execute(`select sum(on_hand) as on_hand
+         from stock_levels
+        where product_id = ? and ${variantClause}`, [payload.productId, ...variantParams]));
+        const cumulativeAfter = Number(sumRows[0]?.on_hand ?? 0);
+        const cumulativeBefore = cumulativeAfter - (payload.after - payload.before);
+        if (cumulativeBefore > 0 || cumulativeAfter <= 0)
+            return;
+        await this.dispatchForStockIncrease({
+            productId: payload.productId,
+            variantId: payload.variantId,
+        });
+    }
+}
+//# sourceMappingURL=availability-worker.js.map

package/dist/backend/services/availability-worker.js.map

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

package/dist/backend/services/csv-stock-importer.d.ts

@@ -0,0 +1,52 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogProductReadPort, StockImportResult } from '@endora-commerce/contracts';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { InventoryAuditContext } from '../plugin.js';
+export interface CsvImportInput {
+    csv: string;
+    warehouseId: string;
+    dryRun?: boolean;
+    /** Optional original filename — surfaces in the audit row summary. */
+    fileName?: string | null;
+}
+/**
+ * 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 declare class CsvStockImporter {
+    private readonly 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.
+     */
+    private readonly catalogProducts;
+    private readonly eventBus?;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * `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: CatalogProductReadPort, eventBus?: EventBus | undefined, auditLog?: AuditPort | undefined);
+    run(input: CsvImportInput, auditCtx?: InventoryAuditContext): Promise<StockImportResult>;
+}
+//# sourceMappingURL=csv-stock-importer.d.ts.map

package/dist/backend/services/csv-stock-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-stock-importer.d.ts","sourceRoot":"","sources":["../../../src/backend/services/csv-stock-importer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EAEtB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAIjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBART,SAAS,EAAE,MAAM,aAAa;IAC/C;;;;OAIG;IACc,eAAe,EAAE,sBAAsB,EACvC,QAAQ,CAAC,EAAE,QAAQ,YAAA,EACnB,QAAQ,CAAC,EAAE,SAAS,YAAA;IAGjC,GAAG,CACP,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;CAyH9B"}