@endora-commerce/mod-inventory 0.100.0

package/dist/backend/index.js

@@ -0,0 +1,351 @@
+import { resolveAllocations, resolveEffectiveFulfilmentStrategy } from '@endora-commerce/contracts';
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { effectiveState } from '@endora-commerce/platform/kernel';
+import { inventoryModule } from './plugin.js';
+import { StockLevelService } from './services/stock-level-service.js';
+import { InventoryStockReadService } from './services/inventory-read-port.js';
+import { InventoryReservationApplyService } from './services/inventory-reservation-apply-port.js';
+import { InventoryStockImportService } from './services/stock-import.service.js';
+import { InventoryProductThresholdWriteService } from './services/product-threshold-write.service.js';
+import { WarehouseChannelService } from './services/warehouse-channel-service.js';
+import { WarehouseChannelReconciler } from './services/warehouse-channel-reconciler.js';
+import { AVAILABILITY_BACK_IN_STOCK_DEFAULT, LOW_STOCK_ALERT_DEFAULT } from './email-templates/transactional-defaults.js';
+import { inventoryPromptTools } from './prompt-tools.js';
+import { registerWarehouseCountryReferences } from './services/warehouse-country-reference.js';
+import { registerInventoryAuditReferences } from './services/audit-references.js';
+import { AvailabilityNotification } from './entities/availability-notification.entity.js';
+import { InventoryThreshold } from './entities/inventory-threshold.entity.js';
+import { ProductWarehouseLowStockThreshold } from './entities/product-warehouse-low-stock-threshold.entity.js';
+import { StockAllocation } from './entities/stock-allocation.entity.js';
+import { StockLevel } from './entities/stock-level.entity.js';
+import { WarehouseChannelAssignment } from './entities/warehouse-channel-assignment.entity.js';
+import { Warehouse } from './entities/warehouse.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        inventory: ctx
+            .asFunction(({ emFactory, eventBus, auditLogService }) => inventoryModule({
+            emFactory,
+            eventBus,
+            auditLogService,
+            settingsService: lazyPort(ctx, 'settingsReadPort'),
+            channelResolver: lazyPort(ctx, 'salesChannelResolutionPort'),
+            dictionaryValidator: lazyPort(ctx, 'dictionaryValidator'),
+            // Feature 075, Phase C — the four reads and one write this module used
+            // to take by importing `catalog`'s, `customer_accounts`' and `email`'s
+            // files. Every one of them kept answering with its owner switched off.
+            catalogProducts: lazyPort(ctx, 'catalogProductReadPort'),
+            catalogCategories: lazyPort(ctx, 'catalogCategoryReadPort'),
+            catalogCategoryWrites: lazyPort(ctx, 'catalogCategoryWritePort'),
+            customerAccounts: lazyPort(ctx, 'customerAccountReadPort'),
+            // Issue #259 — the channel assortment gate on the notify-me seam. A
+            // kernel registration, not a module's, so there is no edge to declare
+            // in the manifest.
+            salesChannelMembership: lazyPort(ctx, 'salesChannelMembershipPort'),
+            mailer: lazyPort(ctx, 'emailMailer'),
+            requireAdmin: (permission) => async (req, reply) => ctx.cradle().requireAdmin(permission)(req, reply),
+            requireCustomer: (req, reply) => ctx.cradle().requireCustomer(req, reply),
+            resolveCustomerContext: (req) => ctx.cradle().customerContextResolver(req),
+            resolveSystemDefaultChannelId: () => ctx.cradle().settingsChannelResolver(),
+            resolveAdminAuditContext: (req) => ctx.cradle().inventoryAdminAuditContext(req),
+            templateEmail: {
+                trySend: (input) => ctx.cradle().templateEmailPort.trySend(input),
+            },
+            // Composed from the two halves, without a `catch` — the root closure
+            // this replaces had one, which would have read a disabled-module
+            // throw as "every warehouse is allowed" (T138).
+            resolveOrganizationWarehouseAllowList: async (req) => {
+                const cradle = ctx.cradle();
+                const organizationId = cradle.customerOrganizationIdResolver(req);
+                if (organizationId === null)
+                    return null;
+                return cradle.organizationRestrictionPort.allowedIdsFor(organizationId, 'warehouseIds');
+            },
+        }))
+            .singleton(),
+    });
+    /**
+     * Feature 075, Phase P — the stock read model.
+     *
+     * `orders` assembles candidate warehouses for a line from three of this
+     * module's tables today, inside its own transaction, reaching them through a
+     * **dynamic** import. `candidatesFor` is that assembly, on this side of the
+     * boundary; the three list methods beside it are the transcriptions
+     * `import_export` and the dev seed need.
+     */
+    ctx.di.providePort('inventoryStockReadPort', ctx
+        .asFunction(({ emFactory }) => new InventoryStockReadService(emFactory))
+        .singleton());
+    /**
+     * D-94.4 — the warehouse-picking policy, published.
+     *
+     * `orders` reached both functions through `await import(
+     * '../../inventory/services/…')` inside the placement method body. They are
+     * pure over their arguments, so nothing here reads a table and nothing takes
+     * an `EntityManager`; what the port buys is that the policy is asked of its
+     * owner rather than re-implemented by whoever edits the import next.
+     *
+     * A separate port from `inventoryStockReadPort` on purpose: a read port that
+     * also decides policy makes its own name a lie.
+     *
+     * The gate `providePort` wraps this in is real but never reached from
+     * placement: `orders` declares this name `degrades-without` and asks
+     * `effectiveState.isPresent('inventory')` before the reservation block, so
+     * with this module off there is no plan to compute rather than a 503 in the
+     * middle of one.
+     */
+    ctx.di.providePort('inventoryFulfilmentPlanningPort', ctx
+        .asFunction(() => ({
+        resolveEffectiveStrategy: resolveEffectiveFulfilmentStrategy,
+        planAllocations: resolveAllocations,
+    }))
+        .singleton());
+    /**
+     * Feature 080, T048 / D-169 — the stock reservation, published.
+     *
+     * `orders` reached this module's `StockLevel` and `StockAllocation` classes
+     * for it, statically for the reservation and through an `await import()` for
+     * the release, and wrote both tables itself: the `FOR UPDATE` read, the
+     * `reserved` increment, the allocation insert and the release loop. D-168
+     * leaves a packaged `inventory` no entity class for a stranger to name, so
+     * the reach had to go before this module moves; the transaction it runs in
+     * did not change, and `stock_allocations_order_item_fk` is untouched.
+     *
+     * A third `inventory` name rather than a widening of either port above, and
+     * the three differ in exactly which transaction they run in:
+     * `inventoryStockReadPort` reads on this module's own `EntityManager`,
+     * `inventoryFulfilmentPlanningPort` opens none at all — it is pure over its
+     * arguments — and this one takes placement's, because the
+     * `PESSIMISTIC_WRITE` has to be held until the order commits and the
+     * allocation rows cannot exist before their order items do.
+     *
+     * The gate `providePort` wraps this in is real but never reached from
+     * placement, for the same reason `inventoryFulfilmentPlanningPort`'s is not:
+     * `orders` declares this name `degrades-without` and asks
+     * `effectiveState.isPresent('inventory')` before the reservation block and
+     * before the cancellation release, so with this module off nothing is
+     * reserved and nothing is released — rather than a 503 in the middle of a
+     * placement.
+     */
+    ctx.di.providePort('inventoryReservationApplyPort', ctx.asFunction(() => new InventoryReservationApplyService()).singleton());
+    /**
+     * D-74 — the bulk stock import. `import_export` wrote `stock_levels` from its
+     * own transaction, with no Command, no audit row and the seeded warehouse id
+     * pasted in as a literal; all three come back here, where the rows live.
+     *
+     * `catalogProductReadPort` is resolved lazily and per call: a spreadsheet
+     * addresses a product by SKU, and this module already declares `catalog`.
+     */
+    ctx.di.providePort('inventoryStockImportPort', ctx
+        .asFunction(({ commandBus }) => new InventoryStockImportService(commandBus, lazyPort(ctx, 'catalogProductReadPort')))
+        .singleton());
+    /**
+     * Issue #185 — the per-warehouse threshold copy, published.
+     *
+     * `catalog`'s product duplication wrote these rows itself, with an
+     * `insert … select` naming this module's table. It named no import specifier,
+     * so `check:module-boundary`'s specifier pass could not see it; it asked no
+     * gate, so it kept writing with this module switched off; and it left no
+     * audit row here, so the rows arrived with nothing on this side having decided
+     * they should. The port is the whole remedy: one Command, one audit row, and
+     * the gate `providePort` wraps it in.
+     *
+     * `catalog` declares this name `degrades-without` and decides presence in
+     * front of the gate, so the duplication itself never meets a 503 — see the
+     * contract's note on why the copy owns its own transaction.
+     */
+    ctx.di.providePort('inventoryProductThresholdWritePort', ctx
+        .asFunction(({ commandBus }) => new InventoryProductThresholdWriteService(commandBus))
+        .singleton());
+    ctx.di.providePort('inventoryAvailabilityPort', ctx
+        .asFunction(({ emFactory, eventBus, auditLogService }) => {
+        const warehouseChannels = new WarehouseChannelService(emFactory, auditLogService);
+        const stockLevels = new StockLevelService(emFactory, lazyPort(ctx, 'catalogProductReadPort'), lazyPort(ctx, 'catalogCategoryReadPort'), eventBus, auditLogService);
+        return {
+            async resolveAvailabilityBands(productIds, salesChannelId) {
+                const candidateWarehouseIds = await warehouseChannels.resolveCandidateWarehouseIds(salesChannelId);
+                return stockLevels.resolveAvailabilityBands(productIds, candidateWarehouseIds.length > 0 ? candidateWarehouseIds : undefined);
+            },
+        };
+    })
+        .singleton());
+    /**
+     * The three reactors this module owns (issue #107).
+     *
+     * All three were bare `eventBus.on` calls inside the plugin body, so a
+     * switched-off `inventory` still sent back-in-stock mail, still sent low-stock
+     * alerts and still wrote the mirrored threshold row — three writes on a module
+     * an operator believed was absent. `ctx.subscribe` puts each behind
+     * `subscribeForModule`, which reads the effective state per event.
+     *
+     * The threshold mirror re-reads the changed setting, and reads the value that
+     * was just written: `SettingsAdminService` drops the settings cache at the
+     * write seam and awaits the drop before it emits (issue #45). This used to
+     * depend on the kernel's invalidator being registered ahead of this handler —
+     * true, but only by composition order, which nothing preserved.
+     */
+    const handle = () => ctx.cradle().inventory.handle;
+    ctx.subscribe('inventory.adjusted.v1', async (payload) => {
+        await handle().availabilityWorker.handleAdjusted(payload);
+    });
+    ctx.subscribe('inventory.adjusted.v1', async (payload) => {
+        await handle().lowStockAlertService.handleAdjusted(payload);
+    });
+    ctx.subscribe('settings.value_changed', async (payload) => {
+        await handle().thresholdSettingsMirror?.onSettingChanged(payload);
+    });
+    ctx.routes(async (app) => {
+        await ctx.cradle().inventory.plugin(app);
+    });
+    /**
+     * Migration 030 seeds the Default warehouse and tries to bind it to every
+     * channel, but it runs *before* the default-channel reconciler creates the
+     * system channel at boot. This catches up at runtime so a channel is never
+     * seen without at least one warehouse assignment (feature 026 US3).
+     *
+     * It ran from `composition.ts` until T143a — which meant it ran with this
+     * module switched off, and did not run in the harness at all
+     * (`harness-parity` carried it as a production-only construct). As a boot
+     * hook it does neither.
+     */
+    ctx.onBoot(async () => {
+        // Presence is decided here — first, and outside anything that could catch it
+        // (issue #146, D-68). The reconciler creates a
+        // `warehouse_channel_assignments` row per sales channel, so with the module
+        // switched off it wrote this module's tables at every boot. A boot hook has
+        // no caller to answer, so the question is asked rather than thrown:
+        // `runBootHooks` re-throws as `ModuleCompositionError`, which `index.ts`
+        // turns into `process.exit(1)`.
+        //
+        // The consequence of returning: a sales channel created while `inventory` is
+        // off gets its default warehouse assignment at the **next boot** rather than
+        // at reactivation. That is acceptable because the reconcile is idempotent
+        // and every read of those rows is gated anyway. If it stops being
+        // acceptable, the repair is to drive the reconcile from the activation
+        // event — not to un-probe this hook.
+        if (!effectiveState.isPresent('inventory'))
+            return;
+        await new WarehouseChannelReconciler(ctx.cradle().emFactory()).run();
+    });
+    /**
+     * The default subject and content for the 2 transactional emails this
+     * module declares in its manifest (T143a).
+     *
+     * These were fourteen `emailDefaultsRegistry.register(...)` calls in
+     * `composition.ts`, each importing a template constant out of the module that
+     * owns it — a root reaching into seven modules to hand their own content to
+     * an eighth. Each module registers its own now.
+     *
+     * `ctx.onBoot` rather than a registration: the registry is *read* once, by
+     * `transactional_emails`' boot reconciler inside its plugin body. Boot hooks
+     * run during composition and plugin bodies only when the Fastify app is
+     * built, so this always lands first — by construction, not by ordering luck.
+     */
+    ctx.onBoot(async () => {
+        const defaults = lazyPort(ctx, 'emailDefaultsPort');
+        defaults.register('low_stock_alert', LOW_STOCK_ALERT_DEFAULT, 'inventory');
+        defaults.register('availability_back_in_stock', AVAILABILITY_BACK_IN_STOCK_DEFAULT, 'inventory');
+    });
+    /**
+     * The assistant tools this module contributes (D-44).
+     *
+     * Both roots built the warehouse resolver and the `set_stock_level` mutation
+     * from this module's own services and pushed them into `prompt_actions`'
+     * registry, because pushing from here would have made `prompt_actions` a
+     * declared dependency — and that declaration is what would have made an
+     * optional assistant undeactivatable while `inventory` is present.
+     * `nonBindingDependencies` declares the edge without that claim.
+     *
+     * A push, not a pull. The registry is a plain registration, so this resolves
+     * no gate, and the host drops every tool whose recorded owner is not
+     * effectively present.
+     */
+    ctx.onBoot(() => {
+        const cradle = ctx.cradle();
+        const registry = cradle.promptActionToolRegistry;
+        for (const tool of inventoryPromptTools({
+            emFactory: cradle.emFactory,
+            catalogProducts: lazyPort(ctx, 'catalogProductReadPort'),
+            catalogCategories: lazyPort(ctx, 'catalogCategoryReadPort'),
+            eventBus: cradle.eventBus,
+            auditLogService: cradle.auditLogService,
+        })) {
+            registry.register(tool);
+        }
+    });
+    /**
+     * This module's rows carry a country code, so it answers "who still points at
+     * this country?" about its own tables (feature 077, D-87), where the owner used
+     * to count them with SQL naming this module's tables.
+     *
+     * A **contribution** hook: it pushes an inert descriptor into `countryReferenceRegistry`,
+     * an ungated registry, and carries no presence probe (D-62/D-68). Probing
+     * would be wrong in the dangerous direction — a switched-off module still owns
+     * the rows, so its country must still refuse the delete, which is the
+     * enumeration policy the registry states.
+     */
+    ctx.onBoot(() => {
+        registerWarehouseCountryReferences(lazyPort(ctx, 'countryReferenceRegistry'), ctx.cradle().emFactory);
+    });
+    /**
+     * What an audit row about a warehouse is called, and where the admin app shows it
+     * (feature 075, D-87 drain).
+     *
+     * `audit_logs` used to answer both by hand — one SQL statement naming this
+     * module's table, and this module's admin route spelled into its own switch.
+     * A read port would have been the wrong repair: `audit_logs` is a
+     * cross-cutting reader, and five ports into it would be five edges pointing
+     * from the record towards the things it records. One of the five contributors
+     * (`inventory`) is switchable, and `audit_logs` is `nonDeactivatable`, so that
+     * edge would also have taken the operator's switch away. A push costs nothing
+     * and reads the same for all five.
+     *
+     * A **contribution** hook: it pushes an inert resolver into
+     * `auditReferenceRegistry`, an ungated registry, and carries no presence probe
+     * (D-67/D-68). The registry's own enumeration policy is what drops this entry
+     * while the module is absent — probing here would make the drop survive a
+     * reactivation until the next restart.
+     */
+    ctx.onBoot(() => {
+        registerInventoryAuditReferences(lazyPort(ctx, 'auditReferenceRegistry'), ctx.cradle().emFactory);
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table->owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * The order is the one `db/entities-registry.generated.ts` declared before this
+ * module became a package, so the registered set is the same list in the same
+ * sequence.
+ */
+export const entities = [
+    AvailabilityNotification,
+    InventoryThreshold,
+    ProductWarehouseLowStockThreshold,
+    StockAllocation,
+    StockLevel,
+    WarehouseChannelAssignment,
+    Warehouse,
+];
+/**
+ * The warehouse↔channel reconciler and this module's system warehouse id,
+ * published **by name** on `./backend`.
+ *
+ * The host's demo composition runs the reconciler, and a host program is
+ * composed against this package's `dist` while the ORM is registered from the
+ * same `entities` array above — so a filesystem path into this file's source
+ * would evaluate `warehouse.entity.ts` a second time and the reconciler would
+ * `em.create` a `WarehouseChannelAssignment` class the ORM has never heard of
+ * (D-160.6.1). D-168 bars an entity class from leaving by this door; a service
+ * and a constant are not entities, and `price_lists`' `DefaultPriceListMigrator`
+ * / `DEFAULT_PRICE_LIST_ID` pair is the precedent for exactly this shape.
+ */
+export { WarehouseChannelReconciler } from './services/warehouse-channel-reconciler.js';
+export { DEFAULT_WAREHOUSE_ID } from './entities/warehouse.entity.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

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

package/dist/backend/plugin.d.ts

@@ -0,0 +1,113 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { EventBus } from '@endora-commerce/platform/events';
+import { AvailabilityWorker } from './services/availability-worker.js';
+import { ThresholdSettingsMirror } from './services/threshold-settings-mirror.js';
+import { LowStockAlertService, type InventoryTemplateEmailPort } from './services/low-stock-alert-service.js';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import type { SalesChannelResolutionPort } from '@endora-commerce/platform/kernel';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { CatalogCategoryReadPort, CatalogCategoryWritePort, CatalogProductReadPort, CustomerAccountReadPort, DictionaryValidator, EmailMailerPort } from '@endora-commerce/contracts';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface InventoryAuditContext {
+    actorAdminUserId: string;
+    impersonatedCustomerAccountId?: string | null;
+    ipAddress?: string | null;
+    userAgent?: string | null;
+    requestId?: string | null;
+}
+/**
+ * Composition root for the inventory module — feature 010.
+ *
+ * Adds WarehouseService + StockLevelService alongside the existing
+ * AvailabilityNotificationService. Routes are registered via the
+ * plug-in factory so test harnesses get the same wiring.
+ */
+export interface InventoryModuleOptions {
+    emFactory: () => EntityManager;
+    /**
+     * The three reads and one write this module performs across a boundary
+     * (feature 075, Phase C). Required, not optional: `catalog` and
+     * `customer_accounts` are declared dependencies, and an optional port is a
+     * composition that silently answers without them — which is exactly what an
+     * entity import was.
+     */
+    catalogProducts: CatalogProductReadPort;
+    catalogCategories: CatalogCategoryReadPort;
+    catalogCategoryWrites: CatalogCategoryWritePort;
+    customerAccounts: CustomerAccountReadPort;
+    /**
+     * `salesChannelMembershipPort` — the sanctioned bridge accessor
+     * (Constitution XII) the notify-when-available seam narrows against, through
+     * `outOfRequestChannel`. Required for the same reason the four ports above
+     * are: an optional channel gate is a composition that answers without one.
+     */
+    salesChannelMembership: SalesChannelMembershipPort;
+    requireCustomer: (req: FastifyRequest, reply: unknown) => Promise<void>;
+    resolveCustomerContext: (req: FastifyRequest) => {
+        customerAccountId: string;
+        organizationId: string;
+    };
+    /** When supplied, the admin stock-level read + set routes are registered. */
+    requireAdmin?: RequireAdminFactory;
+    /** Optional event bus for `inventory.adjusted.v1` emission. */
+    eventBus?: EventBus;
+    /** Optional channel resolver — when supplied, storefront-public stock
+     *  reads scope cumulative on-hand to the caller's channel binding. */
+    channelResolver?: SalesChannelResolutionPort;
+    /** Optional settings service used to read the inventory.display_mode key
+     *  for the storefront-public display-mode endpoint. */
+    settingsService?: SettingsReadPort;
+    /**
+     * `emailMailer`, owned by `email`, as its published contract (feature 075).
+     * Required: the `ConsoleMailer` default this used to fall back to was a value
+     * import of another module's driver, and it has had no reachable caller since
+     * the container started resolving `emailMailer` for every composition.
+     */
+    mailer: EmailMailerPort;
+    /** Feature 047 — optional admin-editable template path for inventory emails. */
+    templateEmail?: InventoryTemplateEmailPort;
+    /** Channel id used to read inventory.* settings for low-stock alerts. */
+    settingsChannelId?: string;
+    /** Lazy lookup for the system-default channel id; used by the
+     *  threshold-settings mirror. Falls back to {@link channelResolver}
+     *  when omitted. */
+    resolveSystemDefaultChannelId?: () => Promise<string | null>;
+    dictionaryValidator?: DictionaryValidator;
+    /** Feature 024 — optional cross-module hook so warehouse / stock /
+     *  threshold / CSV-import mutations land in the audit log. Tests that
+     *  don't care about audit can omit it. */
+    auditLogService?: AuditPort;
+    /** Feature 024 — resolves the admin actor identity for audit entries. */
+    resolveAdminAuditContext?: (request: FastifyRequest) => {
+        actorAdminUserId: string;
+        impersonatedCustomerAccountId?: string | null;
+    };
+    /**
+     * Feature 026 US4 — when provided, the storefront stock-figure endpoint
+     * intersects its candidate warehouse set with the Organization's assigned
+     * warehouses. Empty / null ⇒ platform defaults apply.
+     */
+    resolveOrganizationWarehouseAllowList?: (req: FastifyRequest) => Promise<string[] | null>;
+}
+/**
+ * The three event handlers this module owns, exposed so `backend.ts` can
+ * register them through `ctx.subscribe` (issue #107).
+ *
+ * They were attached here with a bare `eventBus.on`, which is why a switched-off
+ * `inventory` still mailed back-in-stock notices, still mailed low-stock alerts
+ * and still wrote the mirrored threshold row.
+ */
+export interface InventoryModuleHandle {
+    availabilityWorker: AvailabilityWorker;
+    lowStockAlertService: LowStockAlertService;
+    /** Absent when this composition wired no settings service. */
+    thresholdSettingsMirror: ThresholdSettingsMirror | undefined;
+}
+export interface InventoryModuleResult {
+    plugin: (app: FastifyInstance) => Promise<void>;
+    handle: InventoryModuleHandle;
+}
+export declare function inventoryModule(options: InventoryModuleOptions): InventoryModuleResult;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/backend/plugin.d.ts.map

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

package/dist/backend/plugin.js

@@ -0,0 +1,75 @@
+import { AvailabilityNotificationService } from './services/availability-notification-service.js';
+import { AvailabilityWorker } from './services/availability-worker.js';
+import { CsvStockImporter } from './services/csv-stock-importer.js';
+import { ThresholdSettingsMirror } from './services/threshold-settings-mirror.js';
+import { WarehouseService } from './services/warehouse-service.js';
+import { StockLevelService } from './services/stock-level-service.js';
+import { WarehouseChannelService } from './services/warehouse-channel-service.js';
+import { ThresholdAdminService } from './services/threshold-admin-service.js';
+import { LowStockAlertService } from './services/low-stock-alert-service.js';
+import { registerInventoryRoutes } from './routes.js';
+import { registerInventoryAdminRoutes } from './routes.admin.js';
+export function inventoryModule(options) {
+    const mailer = options.mailer;
+    const availabilityWorker = new AvailabilityWorker(options.emFactory, mailer, options.catalogProducts, options.customerAccounts);
+    const lowStockAlertService = new LowStockAlertService(options.emFactory, mailer, options.catalogProducts, options.settingsService, options.settingsChannelId, options.templateEmail);
+    let thresholdSettingsMirror;
+    if (options.settingsService) {
+        // D-48 — the last branch used to be `sysDefault?.id ?? null`, which
+        // mirrored the threshold settings platform-wide on a branch the platform
+        // guarantees against. `null` here now means only what it always should
+        // have: this composition wired no channel resolver at all.
+        const resolveChannelId = options.resolveSystemDefaultChannelId ??
+            (async () => {
+                if (options.settingsChannelId)
+                    return options.settingsChannelId;
+                if (!options.channelResolver)
+                    return null;
+                return (await options.channelResolver.getSystemDefault()).id;
+            });
+        thresholdSettingsMirror = new ThresholdSettingsMirror(options.emFactory, options.settingsService, resolveChannelId);
+    }
+    const plugin = async (app) => {
+        const availabilityService = new AvailabilityNotificationService(options.emFactory, options.catalogProducts, options.customerAccounts, options.salesChannelMembership, mailer, options.templateEmail);
+        const warehouseChannelService = new WarehouseChannelService(options.emFactory, options.auditLogService);
+        const stockLevelService = new StockLevelService(options.emFactory, options.catalogProducts, options.catalogCategories, options.eventBus, options.auditLogService);
+        const thresholdAdminService = new ThresholdAdminService(options.emFactory, options.catalogCategories, options.catalogCategoryWrites, options.catalogProducts, options.auditLogService);
+        await registerInventoryRoutes(app, {
+            emFactory: options.emFactory,
+            catalogProducts: options.catalogProducts,
+            catalogCategories: options.catalogCategories,
+            customerAccounts: options.customerAccounts,
+            availabilityService,
+            requireCustomer: options.requireCustomer,
+            resolveCustomerContext: options.resolveCustomerContext,
+            warehouseChannelService,
+            stockLevelService,
+            ...(options.channelResolver ? { channelResolver: options.channelResolver } : {}),
+            ...(options.settingsService ? { settingsService: options.settingsService } : {}),
+            ...(options.resolveOrganizationWarehouseAllowList
+                ? { resolveOrganizationWarehouseAllowList: options.resolveOrganizationWarehouseAllowList }
+                : {}),
+        });
+        if (options.requireAdmin) {
+            const warehouseService = new WarehouseService(options.emFactory, options.dictionaryValidator, options.auditLogService);
+            const csvStockImporter = new CsvStockImporter(options.emFactory, options.catalogProducts, options.eventBus, options.auditLogService);
+            await registerInventoryAdminRoutes(app, {
+                emFactory: options.emFactory,
+                catalogProducts: options.catalogProducts,
+                warehouseService,
+                stockLevelService,
+                warehouseChannelService,
+                thresholdAdminService,
+                lowStockAlertService,
+                availabilityNotificationService: availabilityService,
+                csvStockImporter,
+                requireAdmin: options.requireAdmin,
+                ...(options.resolveAdminAuditContext
+                    ? { resolveAdminAuditContext: options.resolveAdminAuditContext }
+                    : {}),
+            });
+        }
+    };
+    return { plugin, handle: { availabilityWorker, lowStockAlertService, thresholdSettingsMirror } };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/backend/plugin.js.map

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

package/dist/backend/prompt-tools.d.ts

@@ -0,0 +1,23 @@
+import { type CatalogCategoryReadPort, type CatalogProductReadPort, type PromptActionTool } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/**
+ * Inventory's contribution to the prompt-assistant tool catalogue
+ * (feature 043, data-model §4): the warehouse resolver and the flagship
+ * `set_stock_level` mutation. The mutation's preview is server-computed
+ * from the same rows the execution will touch (FR-004), and execution
+ * rides `StockLevelService.setOnHand` — the exact path of the manual
+ * inventory screen, including its `stock_level.adjust` audit row.
+ */
+export interface InventoryPromptToolsDeps {
+    emFactory: () => EntityManager;
+    /** `catalogProductReadPort`, owned by `catalog` (feature 075, Phase C). */
+    catalogProducts: CatalogProductReadPort;
+    /** `catalogCategoryReadPort`, owned by `catalog` — read by the stock service. */
+    catalogCategories: CatalogCategoryReadPort;
+    eventBus?: EventBus;
+    auditLogService?: AuditPort;
+}
+export declare function inventoryPromptTools(deps: InventoryPromptToolsDeps): PromptActionTool[];
+//# sourceMappingURL=prompt-tools.d.ts.map

package/dist/backend/prompt-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-tools.d.ts","sourceRoot":"","sources":["../../src/backend/prompt-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAItB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAMlE;;;;;;;GAOG;AAEH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,2EAA2E;IAC3E,eAAe,EAAE,sBAAsB,CAAC;IACxC,iFAAiF;IACjF,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,gBAAgB,EAAE,CAgFvF"}