@endora-commerce/mod-inventory 0.100.0

package/dist/migrations/20260503T182812_inventory_workflow.js

@@ -0,0 +1,205 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Inventory module — multi-warehouse rewrite (feature 010).
+ *
+ * What this migration does, in order (data-model.md §10):
+ *   1. Create `warehouses` table; seed the `Default` warehouse with
+ *      deterministic UUID `00000000-0000-4000-8000-00000000d017`.
+ *   2. Add `warehouse_id` to `stock_levels`, backfill every existing
+ *      row to the Default UUID, swap the unique index to include
+ *      warehouse_id.
+ *   3. Create `warehouse_channel_assignments`; for every existing
+ *      sales channel insert a `(default_warehouse, channel, isDefault=true)`
+ *      seed row.
+ *   4. Extend `availability_notifications` with `email` + `status`
+ *      columns, relax `customer_account_id` to nullable, add the
+ *      "at least one recipient" CHECK constraint.
+ *   5. (moved) The stock-management columns on `products` and their
+ *      `products_fulfilment_strategy_check` constraint, and
+ *   6. (moved) the three threshold columns on `categories`, are `catalog`'s:
+ *      its entities map them, and since feature 134
+ *      (`specs/134-paid-module-extraction/research.md` D15) they are created
+ *      by `catalog`'s `Migration20260925T125527CatalogInventoryColumns`. This
+ *      migration keeps its class name and position, and lost only those
+ *      statements in `up()` and `down()` — with them, a database whose
+ *      `catalog` migration already ran failed when `inventory` was installed
+ *      later, and this module's hard uninstall dropped columns it does not own.
+ *   7. Create `inventory_thresholds`; insert the global row at
+ *      foundation defaults (high=100, medium=20, low=1).
+ *   8. Create `stock_allocations`.
+ *
+ * The deterministic seed UUID lets retried migrations stay
+ * idempotent and lets other modules' tests reference the Default
+ * warehouse by id.
+ */
+export class Migration20260503T182812InventoryWorkflow extends Migration {
+    async up() {
+        // ============================================================
+        // 1. warehouses
+        // ============================================================
+        this.addSql(`
+      create table "warehouses" (
+        "id" uuid not null,
+        "name" varchar(160) not null,
+        "code" varchar(64) not null,
+        "active" boolean not null default true,
+        "description" text null,
+        "address" jsonb null,
+        "contact_name" varchar(160) null,
+        "contact_email" varchar(320) null,
+        "contact_phone" varchar(64) null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "warehouses_pkey" primary key ("id"),
+        constraint "warehouses_code_unique" unique ("code"),
+        constraint "warehouses_code_format_check" check ("code" ~ '^[a-z][a-z0-9_-]*[a-z0-9]$')
+      );
+    `);
+        this.addSql(`create index "warehouses_active_idx" on "warehouses" ("active");`);
+        // Seed Default warehouse with deterministic UUID for migration idempotency.
+        this.addSql(`
+      insert into "warehouses" ("id", "name", "code", "active", "created_at", "updated_at")
+      values ('00000000-0000-4000-8000-00000000d017', 'Default', 'default', true, now(), now())
+      on conflict ("id") do nothing;
+    `);
+        // ============================================================
+        // 2. stock_levels — extend with warehouse_id
+        // ============================================================
+        this.addSql(`alter table "stock_levels" add column "warehouse_id" uuid null;`);
+        this.addSql(`
+      update "stock_levels"
+         set "warehouse_id" = '00000000-0000-4000-8000-00000000d017'::uuid
+       where "warehouse_id" is null;
+    `);
+        this.addSql(`alter table "stock_levels" alter column "warehouse_id" set not null;`);
+        this.addSql(`drop index if exists "stock_levels_product_variant_unique";`);
+        this.addSql(`
+      create unique index "stock_levels_product_variant_warehouse_unique"
+        on "stock_levels" (
+          "product_id",
+          coalesce("variant_id", '00000000-0000-0000-0000-000000000000'::uuid),
+          "warehouse_id"
+        );
+    `);
+        // ============================================================
+        // 3. warehouse_channel_assignments
+        // ============================================================
+        this.addSql(`
+      create table "warehouse_channel_assignments" (
+        "id" uuid not null,
+        "warehouse_id" uuid not null,
+        "sales_channel_id" uuid not null,
+        "is_default" boolean not null default false,
+        "sort_order" int not null default 0,
+        "created_at" timestamptz not null,
+        constraint "warehouse_channel_assignments_pkey" primary key ("id"),
+        constraint "wca_warehouse_fk" foreign key ("warehouse_id") references "warehouses" ("id") on delete cascade,
+        constraint "wca_unique_pair" unique ("warehouse_id", "sales_channel_id")
+      );
+    `);
+        this.addSql(`
+      create unique index "wca_one_default_per_channel"
+        on "warehouse_channel_assignments" ("sales_channel_id")
+        where "is_default" = true;
+    `);
+        // Seed the Default warehouse as default for every existing channel.
+        this.addSql(`
+      insert into "warehouse_channel_assignments"
+        ("id", "warehouse_id", "sales_channel_id", "is_default", "sort_order", "created_at")
+      select gen_random_uuid(), '00000000-0000-4000-8000-00000000d017'::uuid, sc."id", true, 0, now()
+        from "sales_channels" sc;
+    `);
+        // ============================================================
+        // 4. availability_notifications — extend
+        // ============================================================
+        this.addSql(`alter table "availability_notifications" add column "email" varchar(320) null;`);
+        this.addSql(`alter table "availability_notifications" add column "status" varchar(16) not null default 'queued';`);
+        this.addSql(`alter table "availability_notifications" alter column "customer_account_id" drop not null;`);
+        this.addSql(`
+      alter table "availability_notifications"
+        add constraint "an_recipient_check"
+        check ("customer_account_id" is not null or "email" is not null);
+    `);
+        this.addSql(`
+      alter table "availability_notifications"
+        add constraint "an_status_check"
+        check ("status" in ('queued','notified','cancelled'));
+    `);
+        this.addSql(`create index "an_product_status_idx" on "availability_notifications" ("product_id", "status");`);
+        // ============================================================
+        // 7. inventory_thresholds + global seed
+        // ============================================================
+        this.addSql(`
+      create table "inventory_thresholds" (
+        "id" uuid not null,
+        "scope_kind" varchar(16) not null,
+        "scope_id" uuid null,
+        "threshold_high" int null,
+        "threshold_medium" int null,
+        "threshold_low" int null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "inventory_thresholds_pkey" primary key ("id"),
+        constraint "it_scope_check" check (
+          ("scope_kind" = 'global' and "scope_id" is null)
+          or ("scope_kind" <> 'global' and "scope_id" is not null)
+        ),
+        constraint "it_scope_kind_check" check ("scope_kind" in ('global','category','product'))
+      );
+    `);
+        this.addSql(`
+      create unique index "it_global_unique" on "inventory_thresholds" ("scope_kind")
+        where "scope_kind" = 'global';
+    `);
+        this.addSql(`
+      create unique index "it_scoped_unique"
+        on "inventory_thresholds" ("scope_kind", "scope_id")
+        where "scope_kind" <> 'global';
+    `);
+        this.addSql(`
+      insert into "inventory_thresholds"
+        ("id", "scope_kind", "scope_id", "threshold_high", "threshold_medium", "threshold_low", "created_at", "updated_at")
+      values (gen_random_uuid(), 'global', null, 100, 20, 1, now(), now());
+    `);
+        // ============================================================
+        // 8. stock_allocations
+        // ============================================================
+        this.addSql(`
+      create table "stock_allocations" (
+        "id" uuid not null,
+        "order_item_id" uuid not null,
+        "warehouse_id" uuid not null,
+        "quantity" int not null,
+        "is_backorder" boolean not null default false,
+        "created_at" timestamptz not null,
+        "released_at" timestamptz null,
+        constraint "stock_allocations_pkey" primary key ("id"),
+        constraint "sa_warehouse_fk" foreign key ("warehouse_id") references "warehouses" ("id") on delete restrict,
+        constraint "sa_qty_positive" check ("quantity" > 0),
+        constraint "sa_unique_per_line" unique ("order_item_id", "warehouse_id")
+      );
+    `);
+        this.addSql(`create index "sa_warehouse_idx" on "stock_allocations" ("warehouse_id");`);
+    }
+    async down() {
+        // Best-effort rollback — stock_allocations + warehouse_channel_assignments
+        // data is lost; existing reservations may need a manual re-`reserved+=` pass.
+        this.addSql(`drop table if exists "stock_allocations" cascade;`);
+        this.addSql(`drop table if exists "inventory_thresholds" cascade;`);
+        this.addSql(`drop table if exists "warehouse_channel_assignments" cascade;`);
+        this.addSql(`alter table "availability_notifications" drop constraint if exists "an_status_check";`);
+        this.addSql(`alter table "availability_notifications" drop constraint if exists "an_recipient_check";`);
+        this.addSql(`drop index if exists "an_product_status_idx";`);
+        this.addSql(`alter table "availability_notifications" drop column if exists "status";`);
+        this.addSql(`alter table "availability_notifications" drop column if exists "email";`);
+        this.addSql(`alter table "availability_notifications" alter column "customer_account_id" set not null;`);
+        this.addSql(`drop index if exists "stock_levels_product_variant_warehouse_unique";`);
+        this.addSql(`alter table "stock_levels" drop column if exists "warehouse_id";`);
+        this.addSql(`
+      create unique index "stock_levels_product_variant_unique"
+        on "stock_levels" ("product_id", coalesce("variant_id", '00000000-0000-0000-0000-000000000000'::uuid));
+    `);
+        this.addSql(`drop table if exists "warehouses" cascade;`);
+    }
+}
+//# sourceMappingURL=20260503T182812_inventory_workflow.js.map

package/dist/migrations/20260503T182812_inventory_workflow.js.map

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

package/dist/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.d.ts

@@ -0,0 +1,14 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Adds `default_low_stock_threshold` to `warehouses`. When a Product has
+ * no per-product `low_stock_threshold`, this column acts as the fallback
+ * threshold for that warehouse's contribution to the low-stock signal.
+ *
+ * Nullable so existing rows (including the seeded `Default` warehouse)
+ * stay untouched until an operator opts in.
+ */
+export declare class Migration20260611T140347InventoryWarehouseDefaultLowStockThreshold extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260611T140347_inventory_warehouse_default_low_stock_threshold.d.ts.map

package/dist/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140347_inventory_warehouse_default_low_stock_threshold.d.ts","sourceRoot":"","sources":["../../src/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,qBAAa,kEAAmE,SAAQ,SAAS;IAChF,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC"}

package/dist/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.js

@@ -0,0 +1,18 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Adds `default_low_stock_threshold` to `warehouses`. When a Product has
+ * no per-product `low_stock_threshold`, this column acts as the fallback
+ * threshold for that warehouse's contribution to the low-stock signal.
+ *
+ * Nullable so existing rows (including the seeded `Default` warehouse)
+ * stay untouched until an operator opts in.
+ */
+export class Migration20260611T140347InventoryWarehouseDefaultLowStockThreshold extends Migration {
+    async up() {
+        this.addSql(`alter table "warehouses" add column "default_low_stock_threshold" int null;`);
+    }
+    async down() {
+        this.addSql(`alter table "warehouses" drop column if exists "default_low_stock_threshold";`);
+    }
+}
+//# sourceMappingURL=20260611T140347_inventory_warehouse_default_low_stock_threshold.js.map

package/dist/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140347_inventory_warehouse_default_low_stock_threshold.js","sourceRoot":"","sources":["../../src/migrations/20260611T140347_inventory_warehouse_default_low_stock_threshold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,OAAO,kEAAmE,SAAQ,SAAS;IACtF,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CACT,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CACT,+EAA+E,CAChF,CAAC;IACJ,CAAC;CACF"}

package/dist/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.d.ts

@@ -0,0 +1,28 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Per-warehouse low-stock thresholds.
+ *
+ * Adds the `product_warehouse_low_stock_thresholds` table holding (product,
+ * warehouse) thresholds. Only consulted when the product is in
+ * `per_warehouse` mode.
+ *
+ * It used to add `products.low_stock_threshold_mode` ('cumulative' |
+ * 'per_warehouse', default 'cumulative') and
+ * `products_low_stock_threshold_mode_check` as well, and to drop both on
+ * revert. That column is `catalog`'s — its `Product` entity maps it — and since
+ * feature 134 (`specs/134-paid-module-extraction/research.md` D15) it is
+ * created by `catalog`'s `Migration20260925T125527CatalogInventoryColumns`.
+ * This migration keeps its class name and lost only those statements. The
+ * `pwlst_product_fk` reference to `products` stays: it is a foreign key from
+ * this module's own table to a module it declares.
+ *
+ * Resolution chain in `per_warehouse` mode (per warehouse):
+ *   1. Row in `product_warehouse_low_stock_thresholds`.
+ *   2. `warehouses.default_low_stock_threshold` fallback.
+ *   3. No threshold.
+ */
+export declare class Migration20260611T140348InventoryPerWarehouseLowStockThresholds extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260611T140348_inventory_per_warehouse_low_stock_thresholds.d.ts.map

package/dist/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140348_inventory_per_warehouse_low_stock_thresholds.d.ts","sourceRoot":"","sources":["../../src/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,+DAAgE,SAAQ,SAAS;IAC7E,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC"}

package/dist/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.js

@@ -0,0 +1,48 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Per-warehouse low-stock thresholds.
+ *
+ * Adds the `product_warehouse_low_stock_thresholds` table holding (product,
+ * warehouse) thresholds. Only consulted when the product is in
+ * `per_warehouse` mode.
+ *
+ * It used to add `products.low_stock_threshold_mode` ('cumulative' |
+ * 'per_warehouse', default 'cumulative') and
+ * `products_low_stock_threshold_mode_check` as well, and to drop both on
+ * revert. That column is `catalog`'s — its `Product` entity maps it — and since
+ * feature 134 (`specs/134-paid-module-extraction/research.md` D15) it is
+ * created by `catalog`'s `Migration20260925T125527CatalogInventoryColumns`.
+ * This migration keeps its class name and lost only those statements. The
+ * `pwlst_product_fk` reference to `products` stays: it is a foreign key from
+ * this module's own table to a module it declares.
+ *
+ * Resolution chain in `per_warehouse` mode (per warehouse):
+ *   1. Row in `product_warehouse_low_stock_thresholds`.
+ *   2. `warehouses.default_low_stock_threshold` fallback.
+ *   3. No threshold.
+ */
+export class Migration20260611T140348InventoryPerWarehouseLowStockThresholds extends Migration {
+    async up() {
+        this.addSql(`
+      create table "product_warehouse_low_stock_thresholds" (
+        "product_id" uuid not null,
+        "warehouse_id" uuid not null,
+        "threshold" int not null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "product_warehouse_low_stock_thresholds_pkey"
+          primary key ("product_id", "warehouse_id"),
+        constraint "pwlst_threshold_nonneg" check ("threshold" >= 0),
+        constraint "pwlst_product_fk"
+          foreign key ("product_id") references "products" ("id") on delete cascade,
+        constraint "pwlst_warehouse_fk"
+          foreign key ("warehouse_id") references "warehouses" ("id") on delete cascade
+      );
+    `);
+        this.addSql(`create index "pwlst_warehouse_idx" on "product_warehouse_low_stock_thresholds" ("warehouse_id");`);
+    }
+    async down() {
+        this.addSql(`drop table if exists "product_warehouse_low_stock_thresholds" cascade;`);
+    }
+}
+//# sourceMappingURL=20260611T140348_inventory_per_warehouse_low_stock_thresholds.js.map

package/dist/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140348_inventory_per_warehouse_low_stock_thresholds.js","sourceRoot":"","sources":["../../src/migrations/20260611T140348_inventory_per_warehouse_low_stock_thresholds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,+DAAgE,SAAQ,SAAS;IACnF,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;KAeX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CACT,wEAAwE,CACzE,CAAC;IACJ,CAAC;CACF"}

package/dist/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.d.ts

@@ -0,0 +1,44 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * `stock_allocations.order_item_id` gains the foreign key it never had
+ * (D-94.1, site 1 — the family D-90 opened with `shipments.order_id`).
+ *
+ * `placeOrder` locks `stock_levels` under `PESSIMISTIC_WRITE`, increments
+ * `reserved` and inserts one `stock_allocations` row per (order item,
+ * warehouse) — all on the placement `EntityManager`, so a placement that then
+ * fails releases the reservation by rolling back. D-78 point 2 rules such a
+ * seam permanent and *declared*, and what makes the declaration honest is a
+ * constraint. The omission was never a decision: the same `create table`
+ * (`20260503T182812_inventory_workflow.ts:199-211`) constrains `warehouse_id`
+ * with `sa_warehouse_fk` and leaves `order_item_id` — same statement, same
+ * `not null` shape, carrying the unique index — bare. It tracks the module
+ * boundary, nothing else.
+ *
+ * `on delete restrict`, for a sharper reason than symmetry with `payments`:
+ * an allocation row is one half of a counter. Deleting an `order_items` row
+ * under `cascade` would drop its allocations and leave `stock_levels.reserved`
+ * overcounted for ever. `restrict` says the only correct thing — release it
+ * first.
+ *
+ * The column accepted unconstrained values from 2026-05-03 until this
+ * migration, so the constraint is preceded by an explicit orphan report:
+ * an operator whose data has orphans gets a sentence naming the count, the
+ * reserved units at stake and the first ten values, not a bare `23503`.
+ * Rows returned mean stock is reserved for a line that no longer exists and
+ * no code path will ever release it. Remedy, in order: export the rows,
+ * delete them, and — because `stock_allocations` carries no product or
+ * variant — recompute `stock_levels.reserved` from the surviving allocations
+ * in a maintenance window (the query is in
+ * `specs/077-f3-consequence-rulings/co-transactional-fk-family.md` § D-94.2).
+ * Do not run the recompute blind: a deployment with no orphans does not need
+ * it, and it is the one step that touches rows the defect did not.
+ *
+ * `inventory` declares `orders` in its manifest `dependencies` for this edge
+ * (AGENTS.md § Migrations item 4). It is the one constraint of the four that
+ * closes no cycle.
+ */
+export declare class Migration20260818T081243InventoryStockAllocationOrderItemFk extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260818T081243_inventory_stock_allocation_order_item_fk.d.ts.map

package/dist/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260818T081243_inventory_stock_allocation_order_item_fk.d.ts","sourceRoot":"","sources":["../../src/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,2DAA4D,SAAQ,SAAS;IACzE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC"}

package/dist/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.js

@@ -0,0 +1,81 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * `stock_allocations.order_item_id` gains the foreign key it never had
+ * (D-94.1, site 1 — the family D-90 opened with `shipments.order_id`).
+ *
+ * `placeOrder` locks `stock_levels` under `PESSIMISTIC_WRITE`, increments
+ * `reserved` and inserts one `stock_allocations` row per (order item,
+ * warehouse) — all on the placement `EntityManager`, so a placement that then
+ * fails releases the reservation by rolling back. D-78 point 2 rules such a
+ * seam permanent and *declared*, and what makes the declaration honest is a
+ * constraint. The omission was never a decision: the same `create table`
+ * (`20260503T182812_inventory_workflow.ts:199-211`) constrains `warehouse_id`
+ * with `sa_warehouse_fk` and leaves `order_item_id` — same statement, same
+ * `not null` shape, carrying the unique index — bare. It tracks the module
+ * boundary, nothing else.
+ *
+ * `on delete restrict`, for a sharper reason than symmetry with `payments`:
+ * an allocation row is one half of a counter. Deleting an `order_items` row
+ * under `cascade` would drop its allocations and leave `stock_levels.reserved`
+ * overcounted for ever. `restrict` says the only correct thing — release it
+ * first.
+ *
+ * The column accepted unconstrained values from 2026-05-03 until this
+ * migration, so the constraint is preceded by an explicit orphan report:
+ * an operator whose data has orphans gets a sentence naming the count, the
+ * reserved units at stake and the first ten values, not a bare `23503`.
+ * Rows returned mean stock is reserved for a line that no longer exists and
+ * no code path will ever release it. Remedy, in order: export the rows,
+ * delete them, and — because `stock_allocations` carries no product or
+ * variant — recompute `stock_levels.reserved` from the surviving allocations
+ * in a maintenance window (the query is in
+ * `specs/077-f3-consequence-rulings/co-transactional-fk-family.md` § D-94.2).
+ * Do not run the recompute blind: a deployment with no orphans does not need
+ * it, and it is the one step that touches rows the defect did not.
+ *
+ * `inventory` declares `orders` in its manifest `dependencies` for this edge
+ * (AGENTS.md § Migrations item 4). It is the one constraint of the four that
+ * closes no cycle.
+ */
+export class Migration20260818T081243InventoryStockAllocationOrderItemFk extends Migration {
+    async up() {
+        this.addSql(`
+      do $$
+      declare
+        orphan_count bigint;
+        reserved_units bigint;
+        sample text;
+      begin
+        select count(*),
+               coalesce(sum(a."quantity") filter (where a."released_at" is null), 0)
+          into orphan_count, reserved_units
+          from "stock_allocations" a
+          left join "order_items" oi on oi."id" = a."order_item_id"
+         where oi."id" is null;
+
+        if orphan_count > 0 then
+          select string_agg(x."order_item_id"::text, ', ') into sample
+            from (
+              select distinct a."order_item_id"
+                from "stock_allocations" a
+                left join "order_items" oi on oi."id" = a."order_item_id"
+               where oi."id" is null
+               limit 10
+            ) x;
+          raise exception
+            'stock_allocations_order_item_fk cannot be added: % orphaned stock_allocations.order_item_id value(s) reference no order_items row, holding % reserved unit(s) no code path will release (first ten: %). Export and delete those allocations, then recompute stock_levels.reserved from the surviving ones, then re-run the migration.',
+            orphan_count, reserved_units, sample;
+        end if;
+      end $$;
+    `);
+        this.addSql(`
+      alter table "stock_allocations"
+        add constraint "stock_allocations_order_item_fk" foreign key ("order_item_id")
+          references "order_items" ("id") on delete restrict;
+    `);
+    }
+    async down() {
+        this.addSql(`alter table "stock_allocations" drop constraint if exists "stock_allocations_order_item_fk";`);
+    }
+}
+//# sourceMappingURL=20260818T081243_inventory_stock_allocation_order_item_fk.js.map

package/dist/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260818T081243_inventory_stock_allocation_order_item_fk.js","sourceRoot":"","sources":["../../src/migrations/20260818T081243_inventory_stock_allocation_order_item_fk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAO,2DAA4D,SAAQ,SAAS;IAC/E,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CACT,8FAA8F,CAC/F,CAAC;IACJ,CAAC;CACF"}

package/dist/migrations/20260830T182139_inventory_organization_attribution.d.ts

@@ -0,0 +1,109 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * D-187 — `availability_notifications` gains its organisation, and a row that
+ * names a customer account carries one.
+ *
+ * Feature 087 Group B, class 3 of 4 (`specs/087-tenant-scope-enforcement/`).
+ * `AvailabilityNotification` is `@CustomerScoped`, and until this migration the
+ * `allowed-set` arm of `customerFilterCond` had no column to grant on: a sales
+ * representative assigned to the buyer's own organisation was shown **none** of
+ * their back-in-stock subscriptions and told so, through the
+ * `ORGANIZATION_ATTRIBUTION_PENDING` notice the refusing arm records. The
+ * column is what turns that into an answer.
+ *
+ * ## The column and the read arrive together, on purpose
+ *
+ * `customerOrganizationColumn` asks the ORM's own metadata whether the filtered
+ * entity carries `organizationId`, **per query**, so the entity property in
+ * this same merge request is what switches the grant on — there is no third
+ * artefact, no flag and no staging. At the same instant the notice retires
+ * itself: it is keyed on the column's *absence*.
+ *
+ * That pairing is why this migration is not "column and backfill". From the
+ * moment the grant is live, a row inserted without an organisation is invisible
+ * to the representative who serves that organisation, on a screen that has just
+ * stopped explaining itself — and MikroORM applies no filter to `INSERT`
+ * (`r1-spike.md` §4, measured), so the filter cannot refuse it. The `CHECK`
+ * below is the only refusal an `INSERT` has.
+ *
+ * ## An implication, not an equivalence
+ *
+ * `customer_account_id is null or organization_id is not null` is FR-010 and
+ * FR-011 together and nothing wider: an **owned** row has an organisation, an
+ * **ownerless** row need not. This table is ownerless by construction for the
+ * storefront's anonymous "notify me when in stock" dialog — feature 010 dropped
+ * `NOT NULL` from `customer_account_id` and added `an_recipient_check`
+ * (`20260503T182812_inventory_workflow.ts`), whose whole purpose is to admit a
+ * row whose only recipient is an e-mail address — and who such a row belongs to
+ * is R-6's open question. The equivalence would answer it in the schema, which
+ * D-187 declines to do.
+ *
+ * Unlike `pwa`, nothing here can produce the opposite shape. There is no
+ * association write on this table: `customer_account_id` is written once, in
+ * `AvailabilityNotificationService.subscribe`'s `em.create`, and never assigned
+ * on an existing row (grep of `packages/modules/inventory/src` for
+ * `customerAccountId`: one write, the rest reads). So an ownerless row carrying
+ * an organisation is not reachable, and the shape the implication leaves open
+ * is empty here rather than held by a test.
+ *
+ * ## No foreign key
+ *
+ * Matching `Cart`, `Comparison` and `PushSubscription`, none of which carries
+ * one. D-187 withdraws `r1-spike.md` §8's `on delete set null` recommendation
+ * as contradicting FR-011: it produces a row that names an account and no
+ * organisation, which is precisely the state this migration makes unreachable,
+ * and under the constraint below it would abort an unrelated organisation
+ * delete with a message about a table the operator was not touching. If one is
+ * ever taken here it must be `restrict`, and it is not this migration's
+ * decision.
+ *
+ * ## Derive, then count, then refuse — never delete
+ *
+ * The derivation is the owning account's own organisation. **On this table the
+ * refusal is a real branch, not a formality**, and that is why it is written
+ * with as much care as the derivation: like `push_subscriptions` and unlike
+ * `comparisons`, `availability_notifications` has **no foreign key** on
+ * `customer_account_id` — the core foundation migration
+ * (`20260424T165847_core_foundation_init.ts`) declares the column and an index
+ * and constrains nothing — so a row naming an account that is gone is
+ * representable here.
+ *
+ * It is nevertheless empty today, and the reason is worth knowing rather than
+ * hoping: a customer account is never hard-deleted in this tree.
+ * `customer-account-lifecycle-ports.ts` soft-deletes, restores and
+ * **anonymises** — the last one rewrites the e-mail and the name and keeps the
+ * row — and every one of those still satisfies `organization_id NOT NULL`
+ * (D-178), so it still derives. Change any of that and the count below is the
+ * only thing that would notice.
+ *
+ * It raises with the count and up to twenty ids and deletes nothing (D-184), in
+ * the shape `20260825T141659_customer_accounts_organization_required.ts`
+ * established and `20260830T112911_carts_organization_attribution_check.ts` and
+ * `20260830T172022_pwa_organization_attribution.ts` repeated. Deleting would be
+ * particularly wrong here: a queued subscription is a promise to a customer
+ * that they will be told when the product returns, and a migration is not the
+ * place to break one.
+ *
+ * ## Ownership, and nothing to declare in the manifest
+ *
+ * `availability_notifications` is the one Group B table whose `create table` is
+ * not its module's — it comes from the core foundation migration. This column
+ * migration is still `inventory`'s, because the entity is, and module ownership
+ * is what the registry and a hard uninstall key on (D-142).
+ *
+ * `inventory` already declares both `customer_accounts` and `organizations` in
+ * its manifest `dependencies`, so the table this reads is created before this
+ * runs. No foreign key is added, so `fk-dependency-drift` has nothing to say
+ * either, and a migration naming another module's table is outside
+ * `check:module-boundary`'s population by that check's own rule.
+ *
+ * The standing guard is
+ * `backend/test/integration/tenancy/customer-scoped-organization-completeness.test.ts`,
+ * which derives its population from the ORM's metadata rather than from a list
+ * — so this class is covered by gaining the column, with no edit to that file.
+ */
+export declare class Migration20260830T182139InventoryOrganizationAttribution extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260830T182139_inventory_organization_attribution.d.ts.map

package/dist/migrations/20260830T182139_inventory_organization_attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260830T182139_inventory_organization_attribution.d.ts","sourceRoot":"","sources":["../../src/migrations/20260830T182139_inventory_organization_attribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGG;AACH,qBAAa,wDAAyD,SAAQ,SAAS;IACtE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAqEnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAarC"}