@endora-commerce/mod-price-lists 0.100.0

package/dist/migrations/20260504T125655_price_lists_engine.js

@@ -0,0 +1,319 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Price Lists engine — feature 011 schema reshape (additive rollout).
+ *
+ * What this migration does, in order (data-model.md §7):
+ *   1. Acquire an advisory lock to coalesce concurrent migrators.
+ *   2. Add the engine columns to `price_lists`: type, status, starts_at,
+ *      ends_at, modified_at, application_rule (JSONB), is_system. The legacy
+ *      columns (code, currency, priority, is_default) remain in place — they
+ *      will be dropped by a follow-up migration once every reader migrates to
+ *      the engine resolver. Widen `name` from varchar(160) to varchar(200).
+ *   3. Create `price_list_products` (assignment join).
+ *   4. Create `price_list_price_brackets` (multi-currency multi-bracket per
+ *      pair; service-layer overlap check, not a DB constraint — research §R3).
+ *   5. Create `price_display_mode_overrides` (Org/Cat/Product overrides).
+ *   6. Seed the `Default` price list with deterministic UUID
+ *      `00000000-0000-4000-8000-00000000d51b`. Idempotent: ON CONFLICT
+ *      (id) DO UPDATE keeps both the legacy AND engine columns coherent.
+ *   7. Migrate every Product's `attributeValues.defaultPrice` (with
+ *      `attributeValues.price` as fallback) into one bracket row per
+ *      currency exposed by any sales channel (research §R7). The legacy
+ *      JSONB key is NOT stripped; existing readers continue to work.
+ *
+ * The migration is idempotent: re-running adds no rows, no columns are
+ * re-altered (PostgreSQL's "if not exists" guards every DDL), and the seed
+ * row's deterministic UUID prevents duplication.
+ */
+const DEFAULT_PRICE_LIST_ID = '00000000-0000-4000-8000-00000000d51b';
+const ADVISORY_LOCK_KEY = 11; // feature number, namespaced into pg_advisory_xact_lock.
+export class Migration20260504T125655PriceListsEngine extends Migration {
+    async up() {
+        // ============================================================
+        // 1. Advisory lock — coalesce concurrent migrators
+        // ============================================================
+        this.addSql(`select pg_advisory_xact_lock(${ADVISORY_LOCK_KEY});`);
+        // ============================================================
+        // 2. price_lists — additive engine columns
+        // ============================================================
+        this.addSql(`alter table "price_lists" alter column "name" type varchar(200);`);
+        this.addSql(`
+      alter table "price_lists"
+        add column if not exists "type" varchar(8) not null default 'base',
+        add column if not exists "status" varchar(16) not null default 'draft',
+        add column if not exists "starts_at" timestamptz null,
+        add column if not exists "ends_at" timestamptz null,
+        add column if not exists "modified_at" timestamptz not null default now(),
+        add column if not exists "application_rule" jsonb not null default '{"kind":"all"}'::jsonb,
+        add column if not exists "is_system" boolean not null default false;
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        drop constraint if exists "price_lists_type_check";
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        add constraint "price_lists_type_check" check ("type" in ('base','sale'));
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        drop constraint if exists "price_lists_status_check";
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        add constraint "price_lists_status_check"
+          check ("status" in ('draft','active','scheduled','expired'));
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        drop constraint if exists "price_lists_dates_check";
+    `);
+        this.addSql(`
+      alter table "price_lists"
+        add constraint "price_lists_dates_check"
+          check ("ends_at" is null or "starts_at" is null or "ends_at" > "starts_at");
+    `);
+        this.addSql(`create index if not exists "price_lists_status_idx" on "price_lists" ("status");`);
+        this.addSql(`create index if not exists "price_lists_type_idx" on "price_lists" ("type");`);
+        this.addSql(`create index if not exists "price_lists_modified_at_idx" on "price_lists" ("modified_at" desc);`);
+        this.addSql(`
+      create index if not exists "price_lists_status_starts_at_idx"
+        on "price_lists" ("starts_at")
+        where "status" = 'scheduled';
+    `);
+        this.addSql(`
+      create index if not exists "price_lists_status_ends_at_idx"
+        on "price_lists" ("ends_at")
+        where "status" = 'active' and "ends_at" is not null;
+    `);
+        // ============================================================
+        // 3. price_list_products — assignment join
+        // ============================================================
+        this.addSql(`
+      create table if not exists "price_list_products" (
+        "price_list_id" uuid not null,
+        "product_id" uuid not null,
+        "created_at" timestamptz not null default now(),
+        constraint "price_list_products_pkey" primary key ("price_list_id", "product_id"),
+        constraint "price_list_products_list_fk"
+          foreign key ("price_list_id") references "price_lists" ("id") on delete cascade,
+        constraint "price_list_products_product_fk"
+          foreign key ("product_id") references "products" ("id") on delete cascade
+      );
+    `);
+        this.addSql(`
+      create index if not exists "price_list_products_product_idx"
+        on "price_list_products" ("product_id");
+    `);
+        // ============================================================
+        // 4. price_list_price_brackets — multi-currency multi-bracket prices
+        // ============================================================
+        this.addSql(`
+      create table if not exists "price_list_price_brackets" (
+        "price_list_id" uuid not null,
+        "product_id" uuid not null,
+        "currency_code" varchar(3) not null,
+        "min_quantity" integer not null,
+        "max_quantity" integer null,
+        "amount" numeric(14, 4) not null,
+        "created_at" timestamptz not null default now(),
+        "updated_at" timestamptz not null default now(),
+        constraint "price_list_price_brackets_pkey"
+          primary key ("price_list_id", "product_id", "currency_code", "min_quantity"),
+        constraint "price_list_price_brackets_min_qty_check" check ("min_quantity" >= 1),
+        constraint "price_list_price_brackets_max_qty_check"
+          check ("max_quantity" is null or "max_quantity" >= "min_quantity"),
+        constraint "price_list_price_brackets_amount_check" check ("amount" >= 0),
+        constraint "price_list_price_brackets_assignment_fk"
+          foreign key ("price_list_id", "product_id")
+          references "price_list_products" ("price_list_id", "product_id")
+          on delete cascade
+      );
+    `);
+        // ============================================================
+        // 5. price_display_mode_overrides — Org/Cat/Product overrides
+        // ============================================================
+        this.addSql(`
+      create table if not exists "price_display_mode_overrides" (
+        "scope" varchar(16) not null,
+        "target_id" uuid not null,
+        "mode" varchar(16) not null,
+        "created_at" timestamptz not null default now(),
+        "updated_at" timestamptz not null default now(),
+        constraint "price_display_mode_overrides_pkey" primary key ("scope", "target_id"),
+        constraint "price_display_mode_overrides_scope_check"
+          check ("scope" in ('organization','category','product')),
+        constraint "price_display_mode_overrides_mode_check"
+          check ("mode" in ('gross_only','net_only','both','none'))
+      );
+    `);
+        // ============================================================
+        // 6. Seed Default price list (idempotent via deterministic UUID).
+        //    If a different price_list already carries is_default=true (e.g. a
+        //    pre-feature-011 dev seed produced one with a random UUID like
+        //    `default_pln`), re-point its children onto the deterministic row and
+        //    drop the legacy row. Without this, the partial unique index
+        //    `uniq_price_lists_one_default` (created by migration 014) blocks the
+        //    seed insert.
+        // ============================================================
+        this.addSql(`
+      do $$
+      declare
+        v_target_id uuid := '${DEFAULT_PRICE_LIST_ID}'::uuid;
+        v_legacy_id uuid;
+      begin
+        select "id" into v_legacy_id
+          from "price_lists"
+          where "is_default" = true and "id" <> v_target_id
+          limit 1;
+
+        if v_legacy_id is not null then
+          -- Release the partial unique index before inserting the deterministic row.
+          update "price_lists" set "is_default" = false where "id" = v_legacy_id;
+        end if;
+
+        insert into "price_lists" (
+          "id", "code", "name", "currency",
+          "is_default", "priority",
+          "type", "status", "modified_at",
+          "application_rule", "is_system",
+          "created_at", "updated_at"
+        )
+        values (
+          v_target_id, 'default', 'Default', 'PLN',
+          true, 0,
+          'base', 'active', now(),
+          '{"kind":"all"}'::jsonb, true,
+          now(), now()
+        )
+        on conflict ("id") do update set
+          "name" = excluded."name",
+          "type" = excluded."type",
+          "status" = excluded."status",
+          "is_default" = true,
+          "is_system" = excluded."is_system",
+          "application_rule" = excluded."application_rule";
+
+        if v_legacy_id is not null then
+          -- Re-point legacy-feature-014 children onto the deterministic row,
+          -- then delete the legacy row.
+          update "price_list_items"
+            set "price_list_id" = v_target_id
+            where "price_list_id" = v_legacy_id;
+          update "price_list_assignments"
+            set "price_list_id" = v_target_id
+            where "price_list_id" = v_legacy_id;
+          delete from "price_lists" where "id" = v_legacy_id;
+        end if;
+      end
+      $$;
+    `);
+        // ============================================================
+        // 7. Migrate legacy attributeValues.defaultPrice → bracket rows
+        //    (one row per currency exposed by any sales channel; identity copy
+        //     per Q3 / FR-002. Legacy keys are NOT stripped — see expand→migrate
+        //     →contract note in Phase 2 of tasks.md.)
+        // ============================================================
+        this.addSql(`
+      with currencies as (
+        select distinct upper(c::text) as code
+        from sales_channels sc, lateral jsonb_array_elements_text(sc.currencies) as c
+        where length(c) = 3
+      ),
+      legacy_priced as (
+        select
+          p."id" as product_id,
+          coalesce(
+            (p."attribute_values"->>'defaultPrice')::numeric,
+            (p."attribute_values"->>'price')::numeric
+          ) as legacy_price
+        from "products" p
+        where (p."attribute_values" ? 'defaultPrice') or (p."attribute_values" ? 'price')
+      ),
+      assignment_upserts as (
+        insert into "price_list_products" ("price_list_id", "product_id", "created_at")
+        select '${DEFAULT_PRICE_LIST_ID}'::uuid, lp.product_id, now()
+        from legacy_priced lp
+        on conflict ("price_list_id", "product_id") do nothing
+        returning 1
+      )
+      insert into "price_list_price_brackets" (
+        "price_list_id", "product_id", "currency_code",
+        "min_quantity", "max_quantity", "amount",
+        "created_at", "updated_at"
+      )
+      select
+        '${DEFAULT_PRICE_LIST_ID}'::uuid,
+        lp.product_id,
+        c.code,
+        1,
+        null,
+        lp.legacy_price,
+        now(),
+        now()
+      from legacy_priced lp
+      cross join currencies c
+      where lp.legacy_price is not null and lp.legacy_price >= 0
+      on conflict ("price_list_id", "product_id", "currency_code", "min_quantity") do nothing;
+    `);
+        // Fallback: deployments that have not yet seeded sales-channel currencies
+        // get a single PLN row per product so the seed at least covers the
+        // platform's default currency. Idempotent.
+        this.addSql(`
+      with legacy_priced as (
+        select
+          p."id" as product_id,
+          coalesce(
+            (p."attribute_values"->>'defaultPrice')::numeric,
+            (p."attribute_values"->>'price')::numeric
+          ) as legacy_price
+        from "products" p
+        where (p."attribute_values" ? 'defaultPrice') or (p."attribute_values" ? 'price')
+      ),
+      ensure_assignment as (
+        insert into "price_list_products" ("price_list_id", "product_id", "created_at")
+        select '${DEFAULT_PRICE_LIST_ID}'::uuid, product_id, now()
+        from legacy_priced
+        on conflict ("price_list_id", "product_id") do nothing
+        returning 1
+      )
+      insert into "price_list_price_brackets" (
+        "price_list_id", "product_id", "currency_code",
+        "min_quantity", "max_quantity", "amount",
+        "created_at", "updated_at"
+      )
+      select
+        '${DEFAULT_PRICE_LIST_ID}'::uuid, product_id, 'PLN', 1, null,
+        legacy_price, now(), now()
+      from legacy_priced
+      where legacy_price is not null and legacy_price >= 0
+      on conflict ("price_list_id", "product_id", "currency_code", "min_quantity") do nothing;
+    `);
+    }
+    async down() {
+        this.addSql(`drop table if exists "price_list_price_brackets" cascade;`);
+        this.addSql(`drop table if exists "price_list_products" cascade;`);
+        this.addSql(`drop table if exists "price_display_mode_overrides" cascade;`);
+        this.addSql(`drop index if exists "price_lists_status_idx";`);
+        this.addSql(`drop index if exists "price_lists_type_idx";`);
+        this.addSql(`drop index if exists "price_lists_modified_at_idx";`);
+        this.addSql(`drop index if exists "price_lists_status_starts_at_idx";`);
+        this.addSql(`drop index if exists "price_lists_status_ends_at_idx";`);
+        this.addSql(`alter table "price_lists" drop constraint if exists "price_lists_dates_check";`);
+        this.addSql(`alter table "price_lists" drop constraint if exists "price_lists_status_check";`);
+        this.addSql(`alter table "price_lists" drop constraint if exists "price_lists_type_check";`);
+        this.addSql(`
+      alter table "price_lists"
+        drop column if exists "is_system",
+        drop column if exists "application_rule",
+        drop column if exists "modified_at",
+        drop column if exists "ends_at",
+        drop column if exists "starts_at",
+        drop column if exists "status",
+        drop column if exists "type";
+    `);
+        // Note: the seeded Default row, if it survived, stays — drop logic
+        // is left to a future contract migration once 014's tables are dropped.
+    }
+}
+//# sourceMappingURL=20260504T125655_price_lists_engine.js.map

package/dist/migrations/20260504T125655_price_lists_engine.js.map

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

package/dist/migrations/20260817T055457_price_lists_single_system_price_list.d.ts

@@ -0,0 +1,15 @@
+import { Migration } from '@mikro-orm/migrations';
+/** The partial unique index this migration installs. */
+export declare const SYSTEM_PRICE_LIST_INDEX = "price_lists_is_system_unique";
+/**
+ * `up()` as data, so the demotion can be exercised against a database that has
+ * actually drifted — which a freshly migrated test database never has.
+ * `test/integration/price_lists/system-price-list-singleton.test.ts` replays
+ * these statements after re-creating the drift.
+ */
+export declare const SINGLE_SYSTEM_PRICE_LIST_SQL: readonly string[];
+export declare class Migration20260817T055457PriceListsSingleSystemPriceList extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260817T055457_price_lists_single_system_price_list.d.ts.map

package/dist/migrations/20260817T055457_price_lists_single_system_price_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260817T055457_price_lists_single_system_price_list.d.ts","sourceRoot":"","sources":["../../src/migrations/20260817T055457_price_lists_single_system_price_list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA4BlD,wDAAwD;AACxD,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAczD,CAAC;AAEF,qBAAa,uDAAwD,SAAQ,SAAS;IACrE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAInB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260817T055457_price_lists_single_system_price_list.js

@@ -0,0 +1,58 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Exactly one system price list, enforced by the database (issue #50).
+ *
+ * `is_system` marks the seeded `Default` row — the terminal fallback of the
+ * resolution chain (feature 011, FR-026/FR-027). Since the issue-#132 ruling
+ * made catalogue listings ask `price_lists` for the price they show, that row
+ * is load-bearing: the chain is *default price list → prices attached directly
+ * to the product → no price displayed*. Nothing enforced the singleton, so a
+ * second `is_system` row was merely a convention away, and a test fixture
+ * created one.
+ *
+ * `price_lists` is `@RuleScoped()` — it carries **no** tenant column, because
+ * organisation targeting lives inside `application_rule` rather than beside it.
+ * So the singleton is platform-wide and the index has no tenant key to add:
+ * one `is_system` row in the table, full stop. A per-organisation index here
+ * would be a column that does not exist.
+ *
+ * The demotion below runs first so the index can be created on a database that
+ * already drifted. It keeps the canonically seeded `Default` row when present
+ * and otherwise the oldest system row, and clears the flag on the rest. That
+ * drops no list, no assignment and no bracket — only a marker that was never
+ * valid on more than one row.
+ */
+const DEFAULT_PRICE_LIST_ID = '00000000-0000-4000-8000-00000000d51b';
+/** The partial unique index this migration installs. */
+export const SYSTEM_PRICE_LIST_INDEX = 'price_lists_is_system_unique';
+/**
+ * `up()` as data, so the demotion can be exercised against a database that has
+ * actually drifted — which a freshly migrated test database never has.
+ * `test/integration/price_lists/system-price-list-singleton.test.ts` replays
+ * these statements after re-creating the drift.
+ */
+export const SINGLE_SYSTEM_PRICE_LIST_SQL = [
+    `update "price_lists"
+      set "is_system" = false
+    where "is_system" = true
+      and "id" <> (
+        select "id"
+          from "price_lists"
+         where "is_system" = true
+         order by ("id" = '${DEFAULT_PRICE_LIST_ID}') desc, "created_at" asc, "id" asc
+         limit 1
+      );`,
+    `create unique index if not exists "${SYSTEM_PRICE_LIST_INDEX}"
+     on "price_lists" ("is_system")
+     where "is_system" = true;`,
+];
+export class Migration20260817T055457PriceListsSingleSystemPriceList extends Migration {
+    async up() {
+        for (const statement of SINGLE_SYSTEM_PRICE_LIST_SQL)
+            this.addSql(statement);
+    }
+    async down() {
+        this.addSql(`drop index if exists "${SYSTEM_PRICE_LIST_INDEX}";`);
+    }
+}
+//# sourceMappingURL=20260817T055457_price_lists_single_system_price_list.js.map

package/dist/migrations/20260817T055457_price_lists_single_system_price_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260817T055457_price_lists_single_system_price_list.js","sourceRoot":"","sources":["../../src/migrations/20260817T055457_price_lists_single_system_price_list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,qBAAqB,GAAG,sCAAsC,CAAC;AAErE,wDAAwD;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC7D;;;;;;;6BAO2B,qBAAqB;;SAEzC;IACP,sCAAsC,uBAAuB;;+BAEhC;CAC9B,CAAC;AAEF,MAAM,OAAO,uDAAwD,SAAQ,SAAS;IAC3E,KAAK,CAAC,EAAE;QACf,KAAK,MAAM,SAAS,IAAI,4BAA4B;YAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/E,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,yBAAyB,uBAAuB,IAAI,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/migrations/20260821T135907_price_lists_unit_price_amount_index.d.ts

@@ -0,0 +1,40 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * The one storage cost of feature 086: a partial covering index over the
+ * quantity-1 brackets, in amount order.
+ *
+ * `price_list_price_brackets` at `min_quantity = 1` **is** the per-(price list,
+ * product) unit price, exactly and by check constraint. The table carries
+ * `check (min_quantity >= 1)` and `check (max_quantity is null or
+ * max_quantity >= min_quantity)`, and `resolvePriceBracket(rows, currency, 1)`
+ * accepts a row when `min_quantity <= 1` and `max_quantity is null or >= 1`.
+ * The first reduces to `min_quantity = 1`; the second always holds. So the
+ * partial predicate below is not a heuristic narrowing — it selects every
+ * listing price and nothing else, which is why a partial index can be built on
+ * it at all.
+ *
+ * **Column order, and why it is this one.** `price_list_id` and `currency_code`
+ * are equality predicates that select one candidate stream; `amount` is the
+ * ordering; `product_id` is the tie-break that makes the merge's order total
+ * and makes the scan index-only (measured: `Heap Fetches: 0`). Reversing the
+ * last two would cost a heap fetch per row and lose the tie-break's position in
+ * the sort.
+ *
+ * **Descending needs no second index.** PostgreSQL scans a btree backwards, so
+ * `order by amount desc, product_id desc` uses this one.
+ *
+ * Measured on the design's synthetic corpora: 7 432 kB over 112 000
+ * assignments, 132 MB over 1 597 000. Without it the ordering is a sort of the
+ * whole candidate relation — 206 ms with a 4 176 kB external merge to disk, per
+ * page view, per viewer.
+ *
+ * No foreign key, so no manifest `dependencies` entry changes and
+ * `fk-dependency-drift` is unaffected.
+ */
+/** The index this migration installs — named once, read by the perf bench. */
+export declare const UNIT_PRICE_AMOUNT_INDEX = "price_list_price_brackets_unit_amount_idx";
+export declare class Migration20260821T135907PriceListsUnitPriceAmountIndex extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260821T135907_price_lists_unit_price_amount_index.d.ts.map

package/dist/migrations/20260821T135907_price_lists_unit_price_amount_index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260821T135907_price_lists_unit_price_amount_index.d.ts","sourceRoot":"","sources":["../../src/migrations/20260821T135907_price_lists_unit_price_amount_index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,8CAA8C,CAAC;AAEnF,qBAAa,sDAAuD,SAAQ,SAAS;IACpE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260821T135907_price_lists_unit_price_amount_index.js

@@ -0,0 +1,46 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * The one storage cost of feature 086: a partial covering index over the
+ * quantity-1 brackets, in amount order.
+ *
+ * `price_list_price_brackets` at `min_quantity = 1` **is** the per-(price list,
+ * product) unit price, exactly and by check constraint. The table carries
+ * `check (min_quantity >= 1)` and `check (max_quantity is null or
+ * max_quantity >= min_quantity)`, and `resolvePriceBracket(rows, currency, 1)`
+ * accepts a row when `min_quantity <= 1` and `max_quantity is null or >= 1`.
+ * The first reduces to `min_quantity = 1`; the second always holds. So the
+ * partial predicate below is not a heuristic narrowing — it selects every
+ * listing price and nothing else, which is why a partial index can be built on
+ * it at all.
+ *
+ * **Column order, and why it is this one.** `price_list_id` and `currency_code`
+ * are equality predicates that select one candidate stream; `amount` is the
+ * ordering; `product_id` is the tie-break that makes the merge's order total
+ * and makes the scan index-only (measured: `Heap Fetches: 0`). Reversing the
+ * last two would cost a heap fetch per row and lose the tie-break's position in
+ * the sort.
+ *
+ * **Descending needs no second index.** PostgreSQL scans a btree backwards, so
+ * `order by amount desc, product_id desc` uses this one.
+ *
+ * Measured on the design's synthetic corpora: 7 432 kB over 112 000
+ * assignments, 132 MB over 1 597 000. Without it the ordering is a sort of the
+ * whole candidate relation — 206 ms with a 4 176 kB external merge to disk, per
+ * page view, per viewer.
+ *
+ * No foreign key, so no manifest `dependencies` entry changes and
+ * `fk-dependency-drift` is unaffected.
+ */
+/** The index this migration installs — named once, read by the perf bench. */
+export const UNIT_PRICE_AMOUNT_INDEX = 'price_list_price_brackets_unit_amount_idx';
+export class Migration20260821T135907PriceListsUnitPriceAmountIndex extends Migration {
+    async up() {
+        this.addSql(`create index if not exists "${UNIT_PRICE_AMOUNT_INDEX}"
+           on "price_list_price_brackets" ("price_list_id", "currency_code", "amount", "product_id")
+        where "min_quantity" = 1;`);
+    }
+    async down() {
+        this.addSql(`drop index if exists "${UNIT_PRICE_AMOUNT_INDEX}";`);
+    }
+}
+//# sourceMappingURL=20260821T135907_price_lists_unit_price_amount_index.js.map

package/dist/migrations/20260821T135907_price_lists_unit_price_amount_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260821T135907_price_lists_unit_price_amount_index.js","sourceRoot":"","sources":["../../src/migrations/20260821T135907_price_lists_unit_price_amount_index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,2CAA2C,CAAC;AAEnF,MAAM,OAAO,sDAAuD,SAAQ,SAAS;IAC1E,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CACT,+BAA+B,uBAAuB;;kCAE1B,CAC7B,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,yBAAyB,uBAAuB,IAAI,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which orders **this module's own** migrations
+ * and nothing else (feature 081). Where the block sits relative to every other
+ * module's is decided by the manifest `dependencies` graph.
+ *
+ * The **named** exports stay, and the asymmetry with `./backend` — which
+ * publishes an array and no entity class by name (D-168) — is deliberate.
+ * `db/migrations-registry.generated.ts` imports each class by name from this
+ * specifier, and a migration class name is contract in a way an entity class
+ * name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom
+ * is a query against a table nobody created.
+ */
+import { Migration20260426T075235PriceListsPricingInit } from './20260426T075235_price_lists_pricing_init.js';
+import { Migration20260504T125655PriceListsEngine } from './20260504T125655_price_lists_engine.js';
+import { Migration20260817T055457PriceListsSingleSystemPriceList } from './20260817T055457_price_lists_single_system_price_list.js';
+import { Migration20260821T135907PriceListsUnitPriceAmountIndex } from './20260821T135907_price_lists_unit_price_amount_index.js';
+export declare const migrations: (typeof Migration20260426T075235PriceListsPricingInit)[];
+export { Migration20260426T075235PriceListsPricingInit, Migration20260504T125655PriceListsEngine, Migration20260817T055457PriceListsSingleSystemPriceList, Migration20260821T135907PriceListsUnitPriceAmountIndex, };
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,6CAA6C,EAAE,MAAM,+CAA+C,CAAC;AAC9G,OAAO,EAAE,wCAAwC,EAAE,MAAM,yCAAyC,CAAC;AACnG,OAAO,EAAE,uDAAuD,EAAE,MAAM,2DAA2D,CAAC;AACpI,OAAO,EAAE,sDAAsD,EAAE,MAAM,0DAA0D,CAAC;AAElI,eAAO,MAAM,UAAU,0DAKtB,CAAC;AAEF,OAAO,EACL,6CAA6C,EAC7C,wCAAwC,EACxC,uDAAuD,EACvD,sDAAsD,GACvD,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,35 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which orders **this module's own** migrations
+ * and nothing else (feature 081). Where the block sits relative to every other
+ * module's is decided by the manifest `dependencies` graph.
+ *
+ * The **named** exports stay, and the asymmetry with `./backend` — which
+ * publishes an array and no entity class by name (D-168) — is deliberate.
+ * `db/migrations-registry.generated.ts` imports each class by name from this
+ * specifier, and a migration class name is contract in a way an entity class
+ * name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom
+ * is a query against a table nobody created.
+ */
+import { Migration20260426T075235PriceListsPricingInit } from './20260426T075235_price_lists_pricing_init.js';
+import { Migration20260504T125655PriceListsEngine } from './20260504T125655_price_lists_engine.js';
+import { Migration20260817T055457PriceListsSingleSystemPriceList } from './20260817T055457_price_lists_single_system_price_list.js';
+import { Migration20260821T135907PriceListsUnitPriceAmountIndex } from './20260821T135907_price_lists_unit_price_amount_index.js';
+export const migrations = [
+    Migration20260426T075235PriceListsPricingInit,
+    Migration20260504T125655PriceListsEngine,
+    Migration20260817T055457PriceListsSingleSystemPriceList,
+    Migration20260821T135907PriceListsUnitPriceAmountIndex,
+];
+export { Migration20260426T075235PriceListsPricingInit, Migration20260504T125655PriceListsEngine, Migration20260817T055457PriceListsSingleSystemPriceList, Migration20260821T135907PriceListsUnitPriceAmountIndex, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,6CAA6C,EAAE,MAAM,+CAA+C,CAAC;AAC9G,OAAO,EAAE,wCAAwC,EAAE,MAAM,yCAAyC,CAAC;AACnG,OAAO,EAAE,uDAAuD,EAAE,MAAM,2DAA2D,CAAC;AACpI,OAAO,EAAE,sDAAsD,EAAE,MAAM,0DAA0D,CAAC;AAElI,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,6CAA6C;IAC7C,wCAAwC;IACxC,uDAAuD;IACvD,sDAAsD;CACvD,CAAC;AAEF,OAAO,EACL,6CAA6C,EAC7C,wCAAwC,EACxC,uDAAuD,EACvD,sDAAsD,GACvD,CAAC"}