@endora-commerce/mod-price-lists 0.100.0

package/dist/backend/services/price-list-resolver.d.ts

@@ -0,0 +1,26 @@
+import type { RuleEvaluation } from './application-rule-evaluator.js';
+/**
+ * Pure priority chain resolver (feature 011 / FR-026, FR-027).
+ *
+ * Picks one matching list per the deterministic order:
+ *   1. List whose rule explicitly names the customer's Organization
+ *   2. else explicit Customer Group
+ *   3. else explicit Category
+ *   4. else explicit Sales Channel
+ *   5. else any other matching list
+ *
+ * Tie-break at every step: most recent `modifiedAt` first, then
+ * lexicographically smallest `name`. Tie-break is total — the same input
+ * yields the same picked list every run.
+ */
+export interface PriceListCandidate<TList = unknown> {
+    list: TList;
+    evaluation: RuleEvaluation;
+    modifiedAt: Date;
+    name: string;
+    /** Marker for the seeded `Default` row — the resolver's terminal fallback. */
+    isSystem: boolean;
+}
+export declare function pickPriorityChain<TList>(candidates: readonly PriceListCandidate<TList>[]): PriceListCandidate<TList> | null;
+export declare function tieBreak<TList>(candidates: readonly PriceListCandidate<TList>[]): PriceListCandidate<TList>;
+//# sourceMappingURL=price-list-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price-list-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/price-list-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO;IACjD,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EACrC,UAAU,EAAE,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAC/C,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAqBlC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAC5B,UAAU,EAAE,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAC/C,kBAAkB,CAAC,KAAK,CAAC,CAQ3B"}

package/dist/backend/services/price-list-resolver.js

@@ -0,0 +1,37 @@
+const PRIORITY_ORDER = [
+    'organization',
+    'customerGroup',
+    'category',
+    'salesChannel',
+];
+export function pickPriorityChain(candidates) {
+    if (candidates.length === 0)
+        return null;
+    for (const level of PRIORITY_ORDER) {
+        const atLevel = candidates.filter((c) => c.evaluation.explicitOn.has(level));
+        if (atLevel.length === 0)
+            continue;
+        if (level === 'organization') {
+            // Feature 056 — within the organization level, a list naming a NEARER org
+            // (smaller nearness rank) outranks one naming a farther ancestor (R5). A
+            // flat direct-org match is rank 0, so flat behavior is unchanged.
+            const nearest = Math.min(...atLevel.map((c) => c.evaluation.organizationRank ?? Number.POSITIVE_INFINITY));
+            const nearestOnly = atLevel.filter((c) => (c.evaluation.organizationRank ?? Number.POSITIVE_INFINITY) === nearest);
+            return tieBreak(nearestOnly);
+        }
+        return tieBreak(atLevel);
+    }
+    // Step 5 — any other matching list. Default lives here.
+    return tieBreak(candidates);
+}
+export function tieBreak(candidates) {
+    // Most recent modifiedAt first, then lexicographic name.
+    const sorted = [...candidates].sort((a, b) => {
+        const dt = b.modifiedAt.getTime() - a.modifiedAt.getTime();
+        if (dt !== 0)
+            return dt;
+        return a.name.localeCompare(b.name);
+    });
+    return sorted[0];
+}
+//# sourceMappingURL=price-list-resolver.js.map

package/dist/backend/services/price-list-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-list-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/price-list-resolver.ts"],"names":[],"mappings":"AA0BA,MAAM,cAAc,GAAiC;IACnD,cAAc;IACd,eAAe;IACf,UAAU;IACV,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,UAAgD;IAEhD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,0EAA0E;YAC1E,yEAAyE;YACzE,kEAAkE;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,IAAI,MAAM,CAAC,iBAAiB,CAAC,CACjF,CAAC;YACF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,IAAI,MAAM,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAC/E,CAAC;YACF,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,wDAAwD;IACxD,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,UAAgD;IAEhD,yDAAyD;IACzD,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;AACpB,CAAC"}

package/dist/backend/services/price-list-service.d.ts

@@ -0,0 +1,431 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type ApplicationRule } from '@endora-commerce/contracts';
+import type { CatalogCategoryReadPort, CatalogProductReadPort, CustomerGroupReadPort, OrganizationDetailsPort } from '@endora-commerce/contracts';
+import { PriceList } from '../entities/price-list.entity.js';
+import { PriceDisplayModeOverride } from '../entities/price-display-mode-override.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+import type { PriceListsAuditContext } from '../plugin.js';
+export type DisplayMode = 'gross_only' | 'net_only' | 'both' | 'none';
+export type DisplayModeOverrideScope = 'organization' | 'category' | 'product';
+export type PriceListStatus = 'draft' | 'active' | 'scheduled' | 'expired';
+export type PriceListType = 'base' | 'sale';
+export interface CreatePriceListInput {
+    name: string;
+    type: PriceListType;
+    startsAt?: Date | null;
+    endsAt?: Date | null;
+    applicationRule?: ApplicationRule;
+}
+export interface PatchPriceListInput {
+    name?: string;
+    type?: PriceListType;
+    startsAt?: Date | null;
+    endsAt?: Date | null;
+    applicationRule?: ApplicationRule;
+}
+export interface BracketInput {
+    minQuantity: number;
+    maxQuantity: number | null;
+    /** Decimal amount as string (the storage shape on `price_list_price_brackets`). */
+    amount: string;
+}
+export interface ReplaceProductsResult {
+    added: number;
+    removed: number;
+    unchanged: number;
+}
+export interface CopyCurrencyResult {
+    added: number;
+}
+/**
+ * The neighbours this service has to **ask** rather than query (feature 075
+ * Phase C).
+ *
+ * A price-list rule and a display-mode override both point at rows two other
+ * modules own — an organisation, a category, a product — and this service used
+ * to validate them with `em.count(Organization, …)` and friends, which is
+ * another module's table on this module's connection. It answers rows whatever
+ * state that module is in, so an operator with `catalog` switched off could
+ * still pin a price list to a category the platform will not serve.
+ *
+ * Grouped into one object because it is one decision: a composition either
+ * knows how to reach its neighbours or it does not, and there is no coherent
+ * state where it can resolve categories but not organisations.
+ */
+export interface PriceListTargetReads {
+    organizationDetails: OrganizationDetailsPort;
+    catalogCategoryRead: CatalogCategoryReadPort;
+    catalogProductRead: CatalogProductReadPort;
+    /**
+     * Feature 076 (D-79) — customer groups moved to `customer_accounts`, so the
+     * rule-target validation reads them the same way it already read
+     * organisations and categories.
+     */
+    customerGroupRead: CustomerGroupReadPort;
+}
+/**
+ * PriceListService — admin CRUD over PriceList + the two child collections
+ * (items + assignments). Keeping all three operations on the same service
+ * keeps the "edit a price list and its rules" admin flow on one transaction
+ * boundary when we need it later.
+ */
+export declare class PriceListService {
+    #private;
+    private readonly emFactory;
+    /**
+     * Optional pricing cache. Every write path on this service calls
+     * `invalidateAll()` so the next read repopulates from the DB.
+     * Coarse but correct — fan-out makes per-tuple invalidation
+     * unprofitable until profiling shows otherwise.
+     */
+    private readonly pricingCache?;
+    /** Feature 024 — optional audit log writer. When omitted, no audit
+     *  rows are emitted (tests that don't care about audit pass nothing). */
+    private readonly auditLog?;
+    /**
+     * Feature 054 — when injected, `patch` runs through the Command Bus so the
+     * update is audited co-transactionally (Principle XIII). Optional: bus-less
+     * construction keeps the legacy audit path, byte-identical.
+     */
+    private readonly commandBus?;
+    /**
+     * Feature 075 Phase C — the ports behind every rule-target and
+     * override-target existence check. Optional in the signature because a
+     * price list with no organisation, category or product target never reaches
+     * them; **never optional in effect**, because the paths that need them
+     * refuse rather than skip when they are absent (see {@link targets}).
+     */
+    private readonly targetReads?;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * Optional pricing cache. Every write path on this service calls
+     * `invalidateAll()` so the next read repopulates from the DB.
+     * Coarse but correct — fan-out makes per-tuple invalidation
+     * unprofitable until profiling shows otherwise.
+     */
+    pricingCache?: {
+        invalidateAll: () => void;
+    } | undefined, 
+    /** Feature 024 — optional audit log writer. When omitted, no audit
+     *  rows are emitted (tests that don't care about audit pass nothing). */
+    auditLog?: AuditPort | undefined, 
+    /**
+     * Feature 054 — when injected, `patch` runs through the Command Bus so the
+     * update is audited co-transactionally (Principle XIII). Optional: bus-less
+     * construction keeps the legacy audit path, byte-identical.
+     */
+    commandBus?: CommandBus | undefined, 
+    /**
+     * Feature 075 Phase C — the ports behind every rule-target and
+     * override-target existence check. Optional in the signature because a
+     * price list with no organisation, category or product target never reaches
+     * them; **never optional in effect**, because the paths that need them
+     * refuse rather than skip when they are absent (see {@link targets}).
+     */
+    targetReads?: PriceListTargetReads | undefined);
+    /**
+     * The neighbour ports, or a refusal. Skipping the validation when nothing was
+     * wired would turn "this composition cannot reach `catalog`" into "every
+     * category id is valid", which is the fail-open shape feature 075 exists to
+     * remove.
+     */
+    private targets;
+    private invalidatePricingCache;
+    private audit;
+    listEngine(filter?: {
+        status?: PriceListStatus[];
+        type?: PriceListType[];
+        search?: string;
+    }): Promise<PriceList[]>;
+    getById(id: string, em?: EntityManager): Promise<PriceList>;
+    remove(id: string): Promise<void>;
+    /**
+     * Default-list rule-attachment guard (FR-006). Rejects any attempt to attach
+     * a non-empty Application Rule to the seeded `Default` row.
+     */
+    assertCanSetApplicationRule(id: string, rule: {
+        kind: string;
+    }): Promise<void>;
+    /**
+     * Default-list status-change guard (FR-005 / FR-006 / spec.md §State Machines).
+     * The system Default row stays `active` for the platform's lifetime. The
+     * service rejects any attempt to move it to `draft`, `scheduled`, or `expired`.
+     */
+    assertCanTransitionStatus(id: string, nextStatus: 'draft' | 'active' | 'scheduled' | 'expired'): Promise<void>;
+    /**
+     * Create a new price list. Status defaults to `draft`. Default-list
+     * protections are out of scope here — system rows are seeded by migration
+     * 031, never created via this method.
+     */
+    create(input: CreatePriceListInput, auditCtx?: PriceListsAuditContext): Promise<PriceList>;
+    /**
+     * Partial update. Bumps `modifiedAt` on every material change.
+     * Refuses non-empty rule attachment on the seeded `Default` row (FR-006).
+     */
+    patch(id: string, input: PatchPriceListInput, auditCtx?: PriceListsAuditContext): Promise<PriceList>;
+    /**
+     * Manual transition: draft → active (or scheduled / expired if dates
+     * dictate). FR-009 row 1.
+     */
+    activate(id: string, auditCtx?: PriceListsAuditContext): Promise<PriceList>;
+    /**
+     * Manual transition: any state → draft. Freezes the list immediately.
+     */
+    draftify(id: string, auditCtx?: PriceListsAuditContext): Promise<PriceList>;
+    /**
+     * Duplicate a price list. Copies the rule, the assigned products, and
+     * every bracket row. Resets status to `draft`, clears dates, and derives
+     * a unique name (suffix ` (copy)`, ` (copy 2)`, …) — FR-013.
+     */
+    duplicate(id: string, auditCtx?: PriceListsAuditContext): Promise<PriceList>;
+    /**
+     * Normalise + validate an Application Rule (US4 / FR-020..FR-024).
+     *
+     * Steps in order:
+     *   1. Recursively walk the AST.
+     *   2. For criteria: dedupe values, uppercase currency codes, validate
+     *      target IDs against their respective tables. Empty `values` arrays
+     *      collapse to `{ kind: 'all' }`.
+     *   3. For groups: recursively normalise each child, then drop children
+     *      that collapsed to `{ kind: 'all' }`. If the group becomes empty
+     *      it collapses to `{ kind: 'all' }` as well; if it's left with a
+     *      single child, that child takes its place.
+     *   4. Reject malformed currencies, depth > 5, and unknown target IDs
+     *      with `400 VALIDATION_FAILED`.
+     *
+     * Returns the normalised rule. Does NOT enforce FR-023 (non-Default
+     * rules must be non-empty); that gate fires at activation time.
+     */
+    normaliseAndValidateRule(rule: ApplicationRule): Promise<ApplicationRule>;
+    private normaliseRuleNode;
+    /**
+     * Validate that every value in an ID-based criterion is a real row in the
+     * appropriate table. Throws `400 VALIDATION_FAILED` for any unknown ID.
+     */
+    private assertTargetsExist;
+    /**
+     * Date sanity per FR-010: `endsAt` must be greater than `startsAt`; at
+     * creation time `endsAt` must be in the future.
+     */
+    private assertDateSanity;
+    /**
+     * For a given product, return every price list the product is assigned
+     * to with a per-currency bracket summary and a deep-link path. Powers
+     * the admin Catalog product editor's Pricing tab (FR-044/045/046).
+     */
+    summarizeBracketsForProduct(productId: string): Promise<Array<{
+        list: {
+            id: string;
+            name: string;
+            type: 'base' | 'sale';
+            status: 'draft' | 'active' | 'scheduled' | 'expired';
+            modifiedAt: Date;
+        };
+        summary: Array<{
+            currencyCode: string;
+            summary: string;
+        }>;
+        deepLinkPath: string;
+    }>>;
+    /**
+     * Build a human-readable summary string for one currency's bracket
+     * series, e.g.:
+     *   - "80,0000 across 1 bracket"
+     *   - "80,0000 – 100,0000 across 3 brackets"
+     * The numeric formatting deliberately keeps the storage scale (4
+     * fractional digits); the admin UI may re-format per locale.
+     */
+    private summariseBrackets;
+    private formatAmount;
+    /**
+     * Upsert a per-Org / per-Category / per-Product display-mode override
+     * (FR-038). The mode value `'inherit'` deletes the override row.
+     * Validates the target ID against the appropriate table — orphans are
+     * refused with 400 (the polymorphic FK is enforced here, not at the DB
+     * level, since the target table varies — see data-model.md §1.4).
+     */
+    upsertDisplayModeOverride(scope: DisplayModeOverrideScope, targetId: string, mode: DisplayMode | 'inherit'): Promise<PriceDisplayModeOverride | null>;
+    listDisplayModeOverrides(scope?: DisplayModeOverrideScope): Promise<PriceDisplayModeOverride[]>;
+    getDisplayModeOverride(scope: DisplayModeOverrideScope, targetId: string): Promise<PriceDisplayModeOverride | null>;
+    /**
+     * Update a `pricing.*` settings-group display-mode key. Settings are
+     * per-sales-channel under the foundation settings module — when no
+     * channel is supplied, this method writes the value across every
+     * sales channel (treating it as a tenant-wide override). For
+     * channel-specific overrides, callers may pass a single channel.
+     *
+     * `key` is the bare suffix (e.g. `default_display_mode` or
+     * `unauthenticated_display_mode`) — the full code is derived as
+     * `pricing.<key>`.
+     */
+    setSettingsDisplayMode(key: 'default_display_mode' | 'unauthenticated_display_mode', mode: DisplayMode, salesChannelId?: string): Promise<void>;
+    /**
+     * Read the value of a `pricing.*` display-mode setting for a sales
+     * channel. Resolves along the settings tier chain
+     *   per-channel override → global value → manifest `defaultValue`
+     * (mirroring `SettingsService.get`). The global tier lives on
+     * `settings.global_value` and is what the admin "All channels" editor
+     * writes; without it a globally-set mode (e.g. `both`) was ignored and
+     * the resolver silently fell back to the manifest default `gross_only`.
+     */
+    readSettingsDisplayMode(key: 'default_display_mode' | 'unauthenticated_display_mode', salesChannelId: string): Promise<DisplayMode>;
+    /**
+     * Resolve the effective display mode for a (product, organization?,
+     * salesChannel) tuple along the FR-039 chain
+     *   Product → Category → Organization → Settings.
+     *
+     * Walks the product's category memberships to find the most specific
+     * category override (deepest in the tree, with `(sort_order ASC, id ASC)`
+     * as the deterministic tie-break). Reads override rows from
+     * `price_display_mode_overrides`; falls back to the per-channel
+     * settings value (`default_display_mode` for signed-in customers,
+     * `unauthenticated_display_mode` for guests).
+     */
+    resolveDisplayMode(input: {
+        productId: string;
+        organizationId: string | null;
+        salesChannelId: string;
+        customerKind: 'guest' | 'signed_in';
+    }): Promise<DisplayMode>;
+    /**
+     * The chain's answer with **no product in hand** — feature 086 / FR-016.
+     *
+     * A price ordering and a price range are refused where the page may not show
+     * prices at all, and `pricing.unauthenticated_display_mode = none` is the
+     * supported "hide prices until login" configuration. Deciding that needs the
+     * mode a *page* resolves to, which is the Organization → Settings tail of the
+     * FR-039 chain with the product and category steps deliberately absent.
+     *
+     * **The absence is the ruling, not a shortcut** (spec 086, clarification 2).
+     * A single product overridden to `none` keeps its position in a price
+     * ordering: a per-product override reads as "ask us for a quote" rather than
+     * "this price is secret", and withdrawing the whole control because one
+     * product opts out would make the sort appear and disappear as a buyer walks
+     * the catalogue. Moving those products to the tail instead is a change to
+     * this method's two omitted steps and to nothing else.
+     *
+     * The decision itself still goes through `decideDisplayMode`, so a page and a
+     * card cannot rank the organisation tier differently.
+     */
+    resolvePageDisplayMode(input: {
+        organizationId: string | null;
+        salesChannelId: string;
+        customerKind: 'guest' | 'signed_in';
+    }): Promise<DisplayMode>;
+    /**
+     * The same chain for a **set** of products (issue #132 follow-up).
+     *
+     * A catalogue listing asked this question once per product, which cost four
+     * to six queries per card on the page's hottest read. Every step is a set
+     * lookup — the product-scope overrides, the category memberships, the
+     * category-scope overrides, the one organization row and the one settings
+     * pair — so the whole page costs what a single product used to.
+     *
+     * The *decision* is not duplicated: both this method and `resolveDisplayMode`
+     * hand their four inputs to `decideDisplayMode`, so a batched page cannot
+     * rank an override differently from a product page. Only the loading differs.
+     *
+     * `categoryIdsByProduct` is an optional prefetch for a caller that has
+     * already read the memberships — `PricingService.resolveListingPrices` needs
+     * them for the application rules and would otherwise read the same table
+     * twice per page.
+     */
+    resolveDisplayModes(input: {
+        productIds: readonly string[];
+        organizationId: string | null;
+        salesChannelId: string;
+        customerKind: 'guest' | 'signed_in';
+        categoryIdsByProduct?: ReadonlyMap<string, ReadonlySet<string>>;
+    }): Promise<Map<string, DisplayMode>>;
+    /**
+     * `(product, category)` memberships for a set of products, read through
+     * `catalog`'s port (feature 075 / D-87).
+     *
+     * One call for the whole set, not one per product: the port takes the array
+     * for exactly this reason, and a page turning into a round trip per card is
+     * the regression this shape exists to prevent.
+     *
+     * **Structural, deliberately** — no `activeOnly`. The single-product path
+     * ranks the same memberships, and `evaluateApplicationRule`'s `category`
+     * criterion tests the raw membership, so narrowing to live categories here
+     * would make the display-mode chain and the rule that prices the product
+     * disagree about which categories a product is in.
+     *
+     * Every product asked about gets an entry, so an uncategorised product is an
+     * empty set rather than a missing key.
+     */
+    private loadCategoryMemberships;
+    /**
+     * Turn category-scope override rows into the chain's ranking inputs.
+     *
+     * `ancestorsOf` answers the category **and** its ancestors, nearest-first, so
+     * one port call replaces the `findOne` plus the parent-pointer loop that
+     * walked `catalog`'s table a level at a time. Depth is the chain length minus
+     * the category itself; an unknown id answers an empty chain and is dropped,
+     * which is what the old `continue` did.
+     */
+    private rankCategoryOverrides;
+    /**
+     * Validate that a polymorphic override target exists in the appropriate
+     * table. Throws 400 VALIDATION_FAILED on orphan target IDs (FR-038).
+     */
+    private assertOverrideTargetExists;
+    /**
+     * List the assigned products for a price list, with their per-currency
+     * brackets in `minQuantity` ascending order. Powers the admin Products
+     * tab and the linked-price-lists panel from US8.
+     */
+    listProducts(priceListId: string): Promise<Array<{
+        productId: string;
+        bracketsByCurrency: Record<string, BracketInput[]>;
+    }>>;
+    /**
+     * Idempotent append: assigns a single product to a price list. No-op when
+     * the assignment already exists. The list's `modifiedAt` is bumped only
+     * when the assignment is actually new.
+     */
+    addProduct(priceListId: string, productId: string): Promise<void>;
+    /**
+     * Removes a product's assignment + its bracket rows (cascade via FK).
+     * No-op when the assignment does not exist.
+     */
+    removeProduct(priceListId: string, productId: string): Promise<void>;
+    /**
+     * Bulk delta replacement of the product roster. Adds new pairs, removes
+     * pairs absent from the request. Returns the {added, removed, unchanged}
+     * counts. Cascade deletes brackets for removed pairs.
+     */
+    replaceProducts(priceListId: string, productIds: readonly string[], auditCtx?: PriceListsAuditContext): Promise<ReplaceProductsResult>;
+    /**
+     * Bulk replacement of bracket rows for one (list, product) pair across
+     * every currency in the request. Currencies absent from the input are
+     * cleared. Brackets are validated for:
+     *   - assignment existence (404 when product is not in the list);
+     *   - per-row sanity: minQuantity ≥ 1, maxQuantity ≥ minQuantity (when
+     *     present), amount ≥ 0;
+     *   - per-currency overlap freedom (FR-015).
+     *
+     * The whole save runs in one EM flush so a partial save is impossible.
+     */
+    replaceBrackets(priceListId: string, productId: string, bracketsByCurrency: Record<string, readonly BracketInput[]>, auditCtx?: PriceListsAuditContext): Promise<Record<string, BracketInput[]>>;
+    /**
+     * Convenience: copy one currency's brackets into other currencies for the
+     * same (list, product) pair. The target currencies' existing brackets (if
+     * any) are NOT cleared — this method appends. Conflicts on
+     * `(currency, minQuantity)` are refused via the PK constraint (caller
+     * should normally use this on currencies with no brackets yet, e.g. via
+     * the admin "Copy currency" affordance).
+     */
+    copyCurrencyBrackets(priceListId: string, productId: string, fromCurrency: string, toCurrencies: readonly string[]): Promise<CopyCurrencyResult>;
+    /**
+     * Per-row bracket sanity (FR-014, FR-015).
+     */
+    private assertBracketSanity;
+    /**
+     * Overlap-freedom within a currency series (FR-015). Assumes the input is
+     * sorted ascending by `minQuantity`.
+     */
+    private assertNoOverlap;
+}
+//# sourceMappingURL=price-list-service.d.ts.map

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

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