@endora-commerce/mod-price-lists 0.100.0

package/dist/backend/routes.storefront.d.ts

@@ -0,0 +1,47 @@
+import type { FastifyInstance } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PriceListService } from './services/price-list-service.js';
+import type { PricingServiceContract } from './services/pricing-service.interface.js';
+import { type CatalogProductReadPort, type OrganizationDetailsPort } from '@endora-commerce/contracts';
+export interface StorefrontPricingRoutesDeps {
+    priceListService: PriceListService;
+    pricingService: PricingServiceContract;
+    emFactory: () => EntityManager;
+    /**
+     * Feature 075 Phase C — the product these two routes price, over `catalog`'s
+     * read port instead of its `Product` entity. It fails closed when `catalog`
+     * is off, which is the answer a storefront price probe should get: quoting a
+     * price for a product the platform will not serve is worse than refusing.
+     */
+    catalogProductRead: CatalogProductReadPort;
+    /**
+     * The buying organisation behind a signed-in request (issue #265). The same
+     * port the admin resolved-price probe in `routes.ts` reads, for the same
+     * reason: a price is resolved against an Organization, and the request only
+     * carries its id.
+     */
+    organizationDetails: OrganizationDetailsPort;
+}
+/**
+ * Storefront pricing endpoints (T025/T026 / contracts/pricing-resolution).
+ *
+ *   GET /api/v1/storefront/products/:id/resolved-price
+ *   GET /api/v1/storefront/pricing/display-mode/:productId
+ *
+ * Mounted from `plugin.ts` under the platform's existing
+ * `/api/v1/storefront/` prefix. Both routes are reachable without a credential
+ * and both **read** one when it is there, through the single
+ * {@link pricingViewerOf} above.
+ *
+ * The header above used to say auth was "intentionally absent", and the handler
+ * below passed `organization: null` to the engine behind a comment promising
+ * the organisation would be derived "when wired" (issue #265). It never was —
+ * so the one endpoint on the platform whose name promises a per-customer answer
+ * quoted every caller the channel price, from feature 011 until now. The
+ * ruling MR !796 settled for the catalogue applies here unchanged: an anonymous
+ * visitor sees the channel price, a signed-in buyer sees their own — and since
+ * issue #271 the display mode beside it is resolved for the same viewer, so the
+ * two cannot answer "net or gross for this buyer?" differently.
+ */
+export declare function registerStorefrontPricingRoutes(app: FastifyInstance, deps: StorefrontPricingRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

package/dist/backend/routes.storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAG7B,MAAM,4BAA4B,CAAC;AAIpC,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,sBAAsB,CAAC;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B;;;;;OAKG;IACH,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C;;;;;OAKG;IACH,mBAAmB,EAAE,uBAAuB,CAAC;CAC9C;AA2CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CA+Gf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,131 @@
+import { isProductVisibleTo, } from '@endora-commerce/contracts';
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+import { markPersonalisedPricing, productAudienceOf } from '@endora-commerce/platform/http';
+async function pricingViewerOf(request, organizationDetails) {
+    const audience = productAudienceOf(request);
+    // `null` covers three callers whose answers happen to agree: the anonymous
+    // visitor, the authenticated caller with no Organization (feature 026's
+    // guest-style account, an unbound API key), and the buyer whose Organization
+    // row is gone.
+    const organization = audience.organizationId === null
+        ? null
+        : await organizationDetails.findById(audience.organizationId);
+    return { audience, organization, customerKind: organization ? 'signed_in' : 'guest' };
+}
+/**
+ * Storefront pricing endpoints (T025/T026 / contracts/pricing-resolution).
+ *
+ *   GET /api/v1/storefront/products/:id/resolved-price
+ *   GET /api/v1/storefront/pricing/display-mode/:productId
+ *
+ * Mounted from `plugin.ts` under the platform's existing
+ * `/api/v1/storefront/` prefix. Both routes are reachable without a credential
+ * and both **read** one when it is there, through the single
+ * {@link pricingViewerOf} above.
+ *
+ * The header above used to say auth was "intentionally absent", and the handler
+ * below passed `organization: null` to the engine behind a comment promising
+ * the organisation would be derived "when wired" (issue #265). It never was —
+ * so the one endpoint on the platform whose name promises a per-customer answer
+ * quoted every caller the channel price, from feature 011 until now. The
+ * ruling MR !796 settled for the catalogue applies here unchanged: an anonymous
+ * visitor sees the channel price, a signed-in buyer sees their own — and since
+ * issue #271 the display mode beside it is resolved for the same viewer, so the
+ * two cannot answer "net or gross for this buyer?" differently.
+ */
+export async function registerStorefrontPricingRoutes(app, deps) {
+    const { priceListService, pricingService, catalogProductRead, organizationDetails } = deps;
+    app.get('/api/v1/storefront/pricing/display-mode/:productId', async (request, reply) => {
+        const viewer = await pricingViewerOf(request, organizationDetails);
+        // Before the read, as the resolved price below does: this answer is
+        // derived for the caller once the caller names an Organization, so it must
+        // not enter a cache another caller can read. The anonymous answer stays
+        // unstamped and is still the representation the storefront's shared
+        // window and a crawler hold (Principle VII).
+        markPersonalisedPricing(reply, viewer.audience);
+        const product = await catalogProductRead.findById(request.params.productId);
+        // Issue #227 — this route took a bare product id and answered about it.
+        // Whether a price is even displayed for a product an operator restricted
+        // to one distributor is that operator's answer, so the row has to pass the
+        // audience test before this route says anything about it at all.
+        if (!product || !isProductVisibleTo(product, viewer.audience)) {
+            reply.status(404);
+            return { error: { code: 'NOT_FOUND', message: 'Product not found.' } };
+        }
+        // Feature 053 / FR-002: read the channel resolved once by the canonical
+        // middleware (`getResolvedChannel()`) — no header re-parse, no re-query.
+        const channel = getResolvedChannel(request);
+        // Issue #271 — the viewer's, matching the price. This route used to pass
+        // `organizationId: null, customerKind: 'guest'` unconditionally, so the
+        // cart that reads it got the `unauthenticated_display_mode` key while the
+        // product page's resolved price carried the signed-in one: the same buyer,
+        // the same product, two conventions. The chain the resolver walks is
+        // unchanged — Product → Category → Organization → Settings, the
+        // organisation's say being the `price_display_mode_overrides` row it
+        // already consults — and only the viewer handed to it moved.
+        const mode = await priceListService.resolveDisplayMode({
+            productId: product.id,
+            organizationId: viewer.organization?.id ?? null,
+            salesChannelId: channel.id,
+            customerKind: viewer.customerKind,
+        });
+        return { data: { displayMode: mode } };
+    });
+    app.get('/api/v1/storefront/products/:id/resolved-price', async (request, reply) => {
+        const viewer = await pricingViewerOf(request, organizationDetails);
+        // Before the read, as `catalog`'s public routes do: this response's price
+        // is resolved for the caller, and so is the 404 below, so a response that
+        // named an organisation must not enter a shared cache whatever it turned
+        // out to be. Anonymous responses are left unstamped and unchanged — still
+        // the representation a crawler indexes.
+        markPersonalisedPricing(reply, viewer.audience);
+        const product = await catalogProductRead.findById(request.params.id);
+        // Issue #227 — see the display-mode route above. A resolved price is the
+        // most direct disclosure this module has.
+        if (!product || !isProductVisibleTo(product, viewer.audience)) {
+            reply.status(404);
+            return { error: { code: 'NOT_FOUND', message: 'Product not found.' } };
+        }
+        const channel = getResolvedChannel(request);
+        const quantity = Math.max(1, Number(request.query.quantity ?? '1') || 1);
+        const currency = request.query.currency?.toUpperCase();
+        const variantId = request.query.variantId ?? null;
+        // The engine reads `customerGroupId` off the record `pricingViewerOf`
+        // loaded, so the organisation's group travels with it; a customer's *own*
+        // group override (feature 040 R6) is not resolved here, exactly as it is
+        // not on the catalogue listing this page's cards come from.
+        const out = await pricingService.resolveEngine({
+            product,
+            variantId,
+            context: {
+                quantity,
+                organization: viewer.organization,
+                salesChannel: channel,
+                ...(currency ? { currencyCode: currency } : {}),
+            },
+        });
+        return {
+            data: {
+                resolvedPrice: {
+                    baseListId: out.base.listId,
+                    basePrice: out.base.bracket
+                        ? { amount: out.base.bracket.amount, currency: out.currencyCode }
+                        : null,
+                    saleListId: out.sale?.listId ?? null,
+                    salePrice: out.sale
+                        ? { amount: out.sale.bracket.amount, currency: out.currencyCode }
+                        : null,
+                    displayMode: out.displayMode,
+                    currencyCode: out.currencyCode,
+                    quantityBracket: out.base.bracket
+                        ? {
+                            minQuantity: out.base.bracket.minQuantity,
+                            maxQuantity: out.base.bracket.maxQuantity ?? null,
+                        }
+                        : null,
+                },
+            },
+        };
+    });
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

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

package/dist/backend/services/application-rule-evaluator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure rule evaluator (feature 011 / FR-022, FR-023, FR-026, FR-029).
+ *
+ * The implementation moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013): it is a pure function over an `ApplicationRule` — a shape that
+ * package already declares — and a context of plain ids, so switching
+ * `price_lists` off cannot change whether a rule matches and a gated port
+ * answering 503 would be a bug rather than a degrade.
+ *
+ * There is a second reason it had to be one implementation rather than a port:
+ * `organizations` evaluates the same rules to work out an organisation's
+ * effective price lists, and it must reach the *same* answer the resolver
+ * does. Two copies that drifted would show an operator one set of lists on the
+ * organisation screen and price from another at checkout.
+ *
+ * The two type names widen when they leave the module (`ResolutionContext` and
+ * `RuleEvaluation` are too generic for a package every module imports), so
+ * they are aliased back here. Both this shim and the aliases go with the last
+ * consumer Phase C rewires.
+ */
+import type { PriceListResolutionContext, PriceListRuleEvaluation } from '@endora-commerce/contracts';
+export { evaluateApplicationRule } from '@endora-commerce/contracts';
+export type ResolutionContext = PriceListResolutionContext;
+export type RuleEvaluation = PriceListRuleEvaluation;
+//# sourceMappingURL=application-rule-evaluator.d.ts.map

package/dist/backend/services/application-rule-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-rule-evaluator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/application-rule-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAAC"}

package/dist/backend/services/application-rule-evaluator.js

@@ -0,0 +1,2 @@
+export { evaluateApplicationRule } from '@endora-commerce/contracts';
+//# sourceMappingURL=application-rule-evaluator.js.map

package/dist/backend/services/application-rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-rule-evaluator.js","sourceRoot":"","sources":["../../../src/backend/services/application-rule-evaluator.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/audit-references.d.ts

@@ -0,0 +1,11 @@
+import type { AuditReferenceRegistryPort } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+/**
+ * What a `price_list` audit row is called, and where the admin app shows it
+ * (feature 075, D-87 drain).
+ *
+ * `audit_logs` used to run `select id, name, code from price_lists` and spell
+ * `/price-lists/{id}` into its own switch statement.
+ */
+export declare function registerPriceListAuditReferences(registry: AuditReferenceRegistryPort, emFactory: () => EntityManager): void;
+//# sourceMappingURL=audit-references.d.ts.map

package/dist/backend/services/audit-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/audit-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,0BAA0B,EACpC,SAAS,EAAE,MAAM,aAAa,GAC7B,IAAI,CAiBN"}

package/dist/backend/services/audit-references.js

@@ -0,0 +1,23 @@
+import { PriceList } from '../entities/price-list.entity.js';
+/**
+ * What a `price_list` audit row is called, and where the admin app shows it
+ * (feature 075, D-87 drain).
+ *
+ * `audit_logs` used to run `select id, name, code from price_lists` and spell
+ * `/price-lists/{id}` into its own switch statement.
+ */
+export function registerPriceListAuditReferences(registry, emFactory) {
+    registry.register({
+        ownerModuleId: 'price_lists',
+        referenceType: 'price_list',
+        resolve: async (ids) => {
+            const rows = await emFactory().find(PriceList, { id: { $in: [...ids] } }, { fields: ['id', 'name', 'code'] });
+            return rows.map((row) => ({
+                id: row.id,
+                label: row.name.length > 0 ? row.name : row.code,
+                url: `/price-lists/${row.id}`,
+            }));
+        },
+    });
+}
+//# sourceMappingURL=audit-references.js.map

package/dist/backend/services/audit-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-references.js","sourceRoot":"","sources":["../../../src/backend/services/audit-references.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAoC,EACpC,SAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC;QAChB,aAAa,EAAE,aAAa;QAC5B,aAAa,EAAE,YAAY;QAC3B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,IAAI,CACjC,SAAS,EACT,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,EAAE,EACzB,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACnC,CAAC;YACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;gBAChD,GAAG,EAAE,gBAAgB,GAAG,CAAC,EAAE,EAAE;aAC9B,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/default-price-list-migration.d.ts

@@ -0,0 +1,70 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogProductReadPort } from '@endora-commerce/contracts';
+/**
+ * Default price list migration helper (feature 011 / US1, FR-002, FR-003,
+ * research §R7).
+ *
+ * Surfaced as a callable service so:
+ *   - migration `031` invokes it inline at upgrade time (preserved here),
+ *   - an admin "repair" command can re-run it idempotently,
+ *   - integration tests can re-seed `Default` after a truncate.
+ *
+ * Returns a structured report: how many products got fresh assignments, how
+ * many bracket rows were written, and which products received an identity
+ * copy across more than one currency (so administrators can revisit and set
+ * proper per-currency values per Q3).
+ */
+export declare const DEFAULT_PRICE_LIST_ID = "00000000-0000-4000-8000-00000000d51b";
+export interface MigrationReport {
+    /** Products newly assigned to the Default list during this run. */
+    productsAssigned: number;
+    /** Bracket rows newly inserted during this run. */
+    bracketRowsInserted: number;
+    /** Products that ended up with > 1 currency bracket (multi-currency identity copy). */
+    productsWithMultiCurrencyIdentityCopy: Array<{
+        productId: string;
+        currencies: string[];
+        legacyAmount: string;
+    }>;
+    /** Products skipped because the legacy field was unparseable. */
+    productsSkipped: Array<{
+        productId: string;
+        reason: string;
+    }>;
+}
+export declare class DefaultPriceListMigrator {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    /**
+     * Idempotent upsert of the seeded `Default` price list. Re-running is a
+     * no-op when the row already exists. Used by both migration 031 and any
+     * test fixture that truncates `price_lists` and needs to restore Default.
+     */
+    seedDefault(): Promise<void>;
+    /**
+     * Idempotent re-run of the legacy `attributeValues.defaultPrice` migration.
+     * Re-runs are no-ops because every UPSERT keys on natural primary keys.
+     * Does NOT strip the legacy `attributeValues.defaultPrice` / `price` keys
+     * (per the expand→migrate→contract rollout — see Phase 2 strategy note in
+     * tasks.md).
+     *
+     * Auto-seeds the Default row first so this method works against a fresh
+     * test fixture that just truncated `price_lists`.
+     *
+     * Feature 075 Phase C — the product list arrives over `catalog`'s published
+     * read port instead of `em.find(Product, {})`.
+     *
+     * The port is a **parameter of this method**, not of the constructor, for two
+     * reasons. `seedDefault` needs nothing of `catalog`, and eighteen of this
+     * class's twenty callers only ever call that — a constructor argument would
+     * make all of them declare a dependency two of them have. And the read has to
+     * happen on the **caller's** unit of work: a backfill run inside an open
+     * transaction, as the dev seed and the migration tests do, must see the
+     * products that transaction has just written, which a port bound to another
+     * fork cannot. Passing it per call is what lets the caller say which
+     * `EntityManager` the read runs on, and the previous `em.find(Product, …)`
+     * only got that right by accident of sharing this class's own factory.
+     */
+    run(catalogProductRead: CatalogProductReadPort): Promise<MigrationReport>;
+}
+//# sourceMappingURL=default-price-list-migration.d.ts.map

package/dist/backend/services/default-price-list-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-price-list-migration.d.ts","sourceRoot":"","sources":["../../../src/backend/services/default-price-list-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,qCAAqC,EAAE,KAAK,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,iEAAiE;IACjE,eAAe,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAE3D;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAgClC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,GAAG,CAAC,kBAAkB,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;CAiGhF"}

package/dist/backend/services/default-price-list-migration.js

@@ -0,0 +1,177 @@
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { PriceList } from '../entities/price-list.entity.js';
+import { PriceListProduct } from '../entities/price-list-product.entity.js';
+import { PriceListPriceBracket } from '../entities/price-list-price-bracket.entity.js';
+/**
+ * Default price list migration helper (feature 011 / US1, FR-002, FR-003,
+ * research §R7).
+ *
+ * Surfaced as a callable service so:
+ *   - migration `031` invokes it inline at upgrade time (preserved here),
+ *   - an admin "repair" command can re-run it idempotently,
+ *   - integration tests can re-seed `Default` after a truncate.
+ *
+ * Returns a structured report: how many products got fresh assignments, how
+ * many bracket rows were written, and which products received an identity
+ * copy across more than one currency (so administrators can revisit and set
+ * proper per-currency values per Q3).
+ */
+export const DEFAULT_PRICE_LIST_ID = '00000000-0000-4000-8000-00000000d51b';
+export class DefaultPriceListMigrator {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    /**
+     * Idempotent upsert of the seeded `Default` price list. Re-running is a
+     * no-op when the row already exists. Used by both migration 031 and any
+     * test fixture that truncates `price_lists` and needs to restore Default.
+     */
+    async seedDefault() {
+        // command-coverage-ignore: one-time system bootstrap that seeds the Default
+        // price list at install/migration time — not an admin action.
+        const em = this.emFactory();
+        const existing = await em.findOne(PriceList, { id: DEFAULT_PRICE_LIST_ID });
+        if (existing) {
+            // Keep engine columns coherent if they were left unset on an older row.
+            existing.name = 'Default';
+            existing.type = 'base';
+            existing.status = 'active';
+            existing.applicationRule = { kind: 'all' };
+            existing.isSystem = true;
+            existing.modifiedAt = new Date();
+            await em.flush();
+            return;
+        }
+        const row = em.create(PriceList, {
+            id: DEFAULT_PRICE_LIST_ID,
+            code: 'default',
+            name: 'Default',
+            currency: 'PLN',
+            isDefault: true,
+            priority: 0,
+            type: 'base',
+            status: 'active',
+            applicationRule: { kind: 'all' },
+            isSystem: true,
+            modifiedAt: new Date(),
+        });
+        await em.persistAndFlush(row);
+    }
+    /**
+     * Idempotent re-run of the legacy `attributeValues.defaultPrice` migration.
+     * Re-runs are no-ops because every UPSERT keys on natural primary keys.
+     * Does NOT strip the legacy `attributeValues.defaultPrice` / `price` keys
+     * (per the expand→migrate→contract rollout — see Phase 2 strategy note in
+     * tasks.md).
+     *
+     * Auto-seeds the Default row first so this method works against a fresh
+     * test fixture that just truncated `price_lists`.
+     *
+     * Feature 075 Phase C — the product list arrives over `catalog`'s published
+     * read port instead of `em.find(Product, {})`.
+     *
+     * The port is a **parameter of this method**, not of the constructor, for two
+     * reasons. `seedDefault` needs nothing of `catalog`, and eighteen of this
+     * class's twenty callers only ever call that — a constructor argument would
+     * make all of them declare a dependency two of them have. And the read has to
+     * happen on the **caller's** unit of work: a backfill run inside an open
+     * transaction, as the dev seed and the migration tests do, must see the
+     * products that transaction has just written, which a port bound to another
+     * fork cannot. Passing it per call is what lets the caller say which
+     * `EntityManager` the read runs on, and the previous `em.find(Product, …)`
+     * only got that right by accident of sharing this class's own factory.
+     */
+    async run(catalogProductRead) {
+        // command-coverage-ignore: one-time data migration (backfills the Default
+        // price list + assignments) run at install/upgrade — not an admin action.
+        await this.seedDefault();
+        const em = this.emFactory();
+        // Discover the currencies exposed by any sales channel + always include PLN
+        // as the platform's default currency (matches migration 031's fallback).
+        const channels = await em.find(SalesChannel, {});
+        const currencies = new Set(['PLN']);
+        for (const ch of channels) {
+            for (const c of ch.currencies ?? []) {
+                if (typeof c === 'string' && c.length === 3) {
+                    currencies.add(c.toUpperCase());
+                }
+            }
+        }
+        // Discover legacy-priced products through `catalog`'s read port.
+        const products = await catalogProductRead.listAll();
+        const skipped = [];
+        const candidates = [];
+        for (const p of products) {
+            const av = p.attributeValues;
+            if (!av)
+                continue;
+            const raw = av['defaultPrice'] ?? av['price'];
+            if (raw == null)
+                continue;
+            const amount = Number(raw);
+            if (!Number.isFinite(amount) || amount < 0) {
+                skipped.push({ productId: p.id, reason: 'legacy_price_invalid' });
+                continue;
+            }
+            candidates.push({ productId: p.id, legacyAmount: amount.toFixed(4) });
+        }
+        let productsAssigned = 0;
+        let bracketRowsInserted = 0;
+        const multiCurrency = [];
+        const currencyList = [...currencies].sort();
+        // Pass 1: assignments — flush before inserting brackets so the FK from
+        // bracket → assignment is satisfied at insert time.
+        for (const c of candidates) {
+            const existingAssignment = await em.findOne(PriceListProduct, {
+                priceListId: DEFAULT_PRICE_LIST_ID,
+                productId: c.productId,
+            });
+            if (!existingAssignment) {
+                em.create(PriceListProduct, {
+                    priceListId: DEFAULT_PRICE_LIST_ID,
+                    productId: c.productId,
+                });
+                productsAssigned += 1;
+            }
+        }
+        await em.flush();
+        // Pass 2: brackets per currency.
+        for (const c of candidates) {
+            for (const cur of currencyList) {
+                const existingBracket = await em.findOne(PriceListPriceBracket, {
+                    priceListId: DEFAULT_PRICE_LIST_ID,
+                    productId: c.productId,
+                    currencyCode: cur,
+                    minQuantity: 1,
+                });
+                if (!existingBracket) {
+                    em.create(PriceListPriceBracket, {
+                        priceListId: DEFAULT_PRICE_LIST_ID,
+                        productId: c.productId,
+                        currencyCode: cur,
+                        minQuantity: 1,
+                        maxQuantity: null,
+                        amount: c.legacyAmount,
+                    });
+                    bracketRowsInserted += 1;
+                }
+            }
+            if (currencyList.length > 1) {
+                multiCurrency.push({
+                    productId: c.productId,
+                    currencies: currencyList,
+                    legacyAmount: c.legacyAmount,
+                });
+            }
+        }
+        await em.flush();
+        return {
+            productsAssigned,
+            bracketRowsInserted,
+            productsWithMultiCurrencyIdentityCopy: multiCurrency,
+            productsSkipped: skipped,
+        };
+    }
+}
+//# sourceMappingURL=default-price-list-migration.js.map

package/dist/backend/services/default-price-list-migration.js.map

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

package/dist/backend/services/display-mode-resolver.d.ts

@@ -0,0 +1,78 @@
+import type { DisplayMode } from '@endora-commerce/contracts';
+/**
+ * Pure display-mode resolver (feature 011 / FR-039).
+ *
+ * Walks the chain Product → Category → Organization → Settings (default for
+ * signed-in, unauthenticated for guests) and returns the first non-`inherit`
+ * value. Guests carry `organizationId === null`, in which case the
+ * Organization-level lookup is skipped.
+ *
+ * The category-level lookup picks the most specific category override the
+ * product belongs to — defined as the deepest category in the tree, with
+ * a deterministic tie-break on `(sort_order asc, id asc)`. The category
+ * depth + tie-break logic lives at the SQL layer; this pure resolver just
+ * receives the already-picked override row (or null).
+ */
+export type CustomerKind = 'guest' | 'signed_in';
+export type ResolvedFrom = 'product' | 'category' | 'organization' | 'settings.default' | 'settings.unauthenticated';
+export interface DisplayModeOverrideLookup {
+    /** Product-level override row or null. */
+    productOverride: DisplayMode | null;
+    /** Most-specific category-level override the product belongs to, or null. */
+    categoryOverride: DisplayMode | null;
+    /** Organization-level override or null (also null for guests). */
+    organizationOverride: DisplayMode | null;
+}
+export interface SettingsDefaults {
+    defaultDisplayMode: DisplayMode;
+    unauthenticatedDisplayMode: DisplayMode;
+}
+export interface ResolvedDisplayMode {
+    mode: DisplayMode;
+    resolvedFrom: ResolvedFrom;
+}
+export declare function resolveDisplayMode(customer: CustomerKind, overrides: DisplayModeOverrideLookup, settings: SettingsDefaults): ResolvedDisplayMode;
+/**
+ * One category-scope override, with the three fields the chain ranks it by.
+ *
+ * `resolveDisplayMode` above receives the already-picked override; the ranking
+ * that picks it used to live inline in `PriceListService`, which is why the
+ * batched path could have ranked differently from the per-product one. It is
+ * here now, so both hand their candidates to the same comparator.
+ */
+export interface DisplayModeCategoryCandidate {
+    mode: DisplayMode;
+    /** Ancestors above the category itself — deeper is more specific. */
+    depth: number;
+    sortOrder: number;
+    categoryId: string;
+}
+/** Most specific first: deepest, then `(sort_order asc, id asc)` as tie-break. */
+export declare function pickCategoryOverride(candidates: readonly DisplayModeCategoryCandidate[]): DisplayModeCategoryCandidate | null;
+export type DisplayModeDecision = {
+    source: 'product' | 'category' | 'organization';
+    mode: DisplayMode;
+} | {
+    source: 'settings';
+};
+/**
+ * The chain's decision with the settings tier left **unread**.
+ *
+ * The eager `resolveDisplayMode` above wants both settings values in hand,
+ * which is one query per product on a listing page and two more on a cart line
+ * that an override already answered. This form names the settings step instead
+ * of taking its value, so the per-product path reads the pair only when it is
+ * reached and the batched path reads it once for the whole page.
+ *
+ * `organizationOverride` is the caller's answer to "is this a signed-in
+ * customer with an organization" — a guest passes `null`, exactly as the
+ * eager resolver's `customer === 'signed_in'` guard requires.
+ */
+export declare function decideDisplayMode(inputs: {
+    productOverride: DisplayMode | null;
+    categoryCandidates: readonly DisplayModeCategoryCandidate[];
+    organizationOverride: DisplayMode | null;
+}): DisplayModeDecision;
+/** Which `pricing.*` settings key answers for this customer kind. */
+export declare function settingsDisplayModeKey(customer: CustomerKind): 'default_display_mode' | 'unauthenticated_display_mode';
+//# sourceMappingURL=display-mode-resolver.d.ts.map

package/dist/backend/services/display-mode-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-mode-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/display-mode-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,UAAU,GACV,cAAc,GACd,kBAAkB,GAClB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,eAAe,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,6EAA6E;IAC7E,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,kEAAkE;IAClE,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,WAAW,CAAC;IAChC,0BAA0B,EAAE,WAAW,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,yBAAyB,EACpC,QAAQ,EAAE,gBAAgB,GACzB,mBAAmB,CAiBrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,WAAW,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,4BAA4B,EAAE,GAClD,4BAA4B,GAAG,IAAI,CAkBrC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3B;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,eAAe,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1C,GAAG,mBAAmB,CAUtB;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,GACrB,sBAAsB,GAAG,8BAA8B,CAEzD"}