@campfire-interactive/master-data-client 4.12.0 → 4.13.0

package/dist/quoteLines.d.ts

@@ -1,91 +0,0 @@
-import { HttpTransport } from './http';
-import type { QuoteLinesResponse, QuoteLinesWithApprovalFlag, AddQuoteLineInput, UpdateQuoteLineInput, SetQuoteLineEffectiveCostInput, SetQuoteLineEffectivePriceInput, SingleResponse } from './types';
-/**
- * Quote lines — the finished goods on a quote.
- *
- * A quote is MULTI-PART: it is the document the OEM receives and it carries one
- * line per finished good, each with its own volume, cost and price. See the
- * nextgen ADR `2026-08-05-multi-part-quotes.md`.
- *
- * Two things to know before using this:
- *
- * 1. **`Quote.partId` is now a derived mirror** of these lines and is
- *    deprecated. It reflects the FIRST line only, so it is lossy the moment a
- *    quote has more than one. Read `lines` here instead. It keeps working for
- *    the whole deprecation window — including writes, which transparently
- *    maintain the quote's single line — and is dropped in a later major.
- *
- * 2. **Never sum lines across competing quotes.** When an OEM asks for several
- *    competing groupings of the same parts, those are alternatives, not
- *    additions. `rollUp` covers ONE quote; anything aggregating across a round
- *    must dedupe by part.
- *
- * Cost is DERIVED, never authored: it reaches a line only through
- * {@link setEffectiveCost}, published by whichever engine resolved it. There is
- * no authored-cost field, deliberately — the earlier design had one whose only
- * writer was a human, so it could store a per-grouping cost but never produce
- * one, and went stale unnoticed on the next re-cost.
- */
-export declare class QuoteLineResource {
-    private readonly http;
-    constructor(http: HttpTransport);
-    /**
-     * The quote's lines, each with resolved `terms` (volume / cost / price plus
-     * which tier each came from), and the quote-level `rollUp`.
-     */
-    list(quoteId: string): Promise<SingleResponse<QuoteLinesResponse>>;
-    /**
-     * The resolved line sets for MANY quotes, in one round trip.
-     *
-     * Use this instead of looping {@link list} whenever you read volume off a set
-     * of quotes — a per-quote fan-out is slow and, against a hub holding one warm
-     * instance, manufactures cold starts.
-     *
-     * Chunk to 200 ids per call (the server rejects more). Ids that don't exist, or
-     * belong to another tenant, are simply absent from the result — so index the
-     * response by `quoteId` rather than assuming it lines up positionally with the
-     * ids you passed. A quote that exists but has no finished goods comes back with
-     * an empty `lines` array.
-     */
-    listForQuotes(quoteIds: string[]): Promise<SingleResponse<QuoteLinesResponse[]>>;
-    /**
-     * Add a finished good to a quote. Returns the full line set, so a caller never
-     * has to re-fetch to get the new roll-up.
-     *
-     * Omit `partId` to have it resolved from `partNumber` against the parts
-     * catalog; it is left null when nothing matches, which is legal — soft
-     * enforcement, so a part number that hasn't been reconciled into the catalog
-     * can still be quoted. Pass `partId: null` to pin it null explicitly.
-     */
-    add(quoteId: string, input: AddQuoteLineInput, idempotencyKey?: string): Promise<SingleResponse<QuoteLinesResponse>>;
-    /**
-     * Update a line's AUTHORED terms. Derived cost/price are not settable here.
-     *
-     * A `note`-only patch is accepted while the quote is in review — flagging a bad
-     * part is something that happens DURING review. Anything touching the figures
-     * requires a pre-approval status (422 otherwise).
-     */
-    update(quoteId: string, lineId: string, input: UpdateQuoteLineInput): Promise<SingleResponse<QuoteLinesResponse>>;
-    /** Remove a finished good. The last line may be removed. */
-    remove(quoteId: string, lineId: string): Promise<SingleResponse<QuoteLinesResponse>>;
-    /**
-     * Set the document order. `lineIds` must list every line on the quote exactly
-     * once (422 otherwise). Order also decides which line supplies the deprecated
-     * `quote.partId` mirror.
-     */
-    reorder(quoteId: string, lineIds: string[]): Promise<SingleResponse<QuoteLinesResponse>>;
-    /**
-     * Publish a DERIVED per-line cost — the line-scoped mirror of
-     * `quotes.setEffectiveCost`, and the only way a cost reaches a line.
-     *
-     * Deliberately NOT gated on quote status: a re-cost must always be able to
-     * land, or the published number silently diverges from the cost model that
-     * produced it. When the figure lands on a quote already in approval the
-     * response sets `invalidatesApproval` — the caller owns what to do about it
-     * (OMSF voids the collected approvals and re-routes).
-     */
-    setEffectiveCost(quoteId: string, lineId: string, input: SetQuoteLineEffectiveCostInput, idempotencyKey?: string): Promise<SingleResponse<QuoteLinesWithApprovalFlag>>;
-    /** Price-side sibling of {@link setEffectiveCost}. */
-    setEffectivePrice(quoteId: string, lineId: string, input: SetQuoteLineEffectivePriceInput, idempotencyKey?: string): Promise<SingleResponse<QuoteLinesWithApprovalFlag>>;
-}
-//# sourceMappingURL=quoteLines.d.ts.map

package/dist/quoteLines.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"quoteLines.d.ts","sourceRoot":"","sources":["../src/quoteLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,8BAA8B,EAC9B,+BAA+B,EAC/B,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAOxE;;;;;;;;;;;;OAYG;IAIG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAQtF;;;;;;;;OAQG;IACG,GAAG,CACP,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAS9C;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAQ9C,4DAA4D;IACtD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAO1F;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAQ9F;;;;;;;;;OASG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,8BAA8B,EACrC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAStD,sDAAsD;IAChD,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,+BAA+B,EACtC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;CAQvD"}

package/dist/quoteLines.js

@@ -1,147 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QuoteLineResource = void 0;
-/**
- * Quote lines — the finished goods on a quote.
- *
- * A quote is MULTI-PART: it is the document the OEM receives and it carries one
- * line per finished good, each with its own volume, cost and price. See the
- * nextgen ADR `2026-08-05-multi-part-quotes.md`.
- *
- * Two things to know before using this:
- *
- * 1. **`Quote.partId` is now a derived mirror** of these lines and is
- *    deprecated. It reflects the FIRST line only, so it is lossy the moment a
- *    quote has more than one. Read `lines` here instead. It keeps working for
- *    the whole deprecation window — including writes, which transparently
- *    maintain the quote's single line — and is dropped in a later major.
- *
- * 2. **Never sum lines across competing quotes.** When an OEM asks for several
- *    competing groupings of the same parts, those are alternatives, not
- *    additions. `rollUp` covers ONE quote; anything aggregating across a round
- *    must dedupe by part.
- *
- * Cost is DERIVED, never authored: it reaches a line only through
- * {@link setEffectiveCost}, published by whichever engine resolved it. There is
- * no authored-cost field, deliberately — the earlier design had one whose only
- * writer was a human, so it could store a per-grouping cost but never produce
- * one, and went stale unnoticed on the next re-cost.
- */
-class QuoteLineResource {
-    http;
-    constructor(http) {
-        this.http = http;
-    }
-    /**
-     * The quote's lines, each with resolved `terms` (volume / cost / price plus
-     * which tier each came from), and the quote-level `rollUp`.
-     */
-    async list(quoteId) {
-        return this.http.request({
-            method: 'GET',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines`,
-        });
-    }
-    /**
-     * The resolved line sets for MANY quotes, in one round trip.
-     *
-     * Use this instead of looping {@link list} whenever you read volume off a set
-     * of quotes — a per-quote fan-out is slow and, against a hub holding one warm
-     * instance, manufactures cold starts.
-     *
-     * Chunk to 200 ids per call (the server rejects more). Ids that don't exist, or
-     * belong to another tenant, are simply absent from the result — so index the
-     * response by `quoteId` rather than assuming it lines up positionally with the
-     * ids you passed. A quote that exists but has no finished goods comes back with
-     * an empty `lines` array.
-     */
-    // Typed SingleResponse<T[]> rather than ListResponse<T>: this batch read is not
-    // paginated, so it carries no cursor/hasMore meta and claiming ListMeta would
-    // promise fields the server never sends.
-    async listForQuotes(quoteIds) {
-        return this.http.request({
-            method: 'GET',
-            path: '/v1/quote-lines',
-            query: { quoteIds: quoteIds.join(',') },
-        });
-    }
-    /**
-     * Add a finished good to a quote. Returns the full line set, so a caller never
-     * has to re-fetch to get the new roll-up.
-     *
-     * Omit `partId` to have it resolved from `partNumber` against the parts
-     * catalog; it is left null when nothing matches, which is legal — soft
-     * enforcement, so a part number that hasn't been reconciled into the catalog
-     * can still be quoted. Pass `partId: null` to pin it null explicitly.
-     */
-    async add(quoteId, input, idempotencyKey) {
-        return this.http.request({
-            method: 'POST',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines`,
-            body: input,
-            idempotencyKey,
-        });
-    }
-    /**
-     * Update a line's AUTHORED terms. Derived cost/price are not settable here.
-     *
-     * A `note`-only patch is accepted while the quote is in review — flagging a bad
-     * part is something that happens DURING review. Anything touching the figures
-     * requires a pre-approval status (422 otherwise).
-     */
-    async update(quoteId, lineId, input) {
-        return this.http.request({
-            method: 'PATCH',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines/${encodeURIComponent(lineId)}`,
-            body: input,
-        });
-    }
-    /** Remove a finished good. The last line may be removed. */
-    async remove(quoteId, lineId) {
-        return this.http.request({
-            method: 'DELETE',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines/${encodeURIComponent(lineId)}`,
-        });
-    }
-    /**
-     * Set the document order. `lineIds` must list every line on the quote exactly
-     * once (422 otherwise). Order also decides which line supplies the deprecated
-     * `quote.partId` mirror.
-     */
-    async reorder(quoteId, lineIds) {
-        return this.http.request({
-            method: 'PUT',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines/reorder`,
-            body: { lineIds },
-        });
-    }
-    /**
-     * Publish a DERIVED per-line cost — the line-scoped mirror of
-     * `quotes.setEffectiveCost`, and the only way a cost reaches a line.
-     *
-     * Deliberately NOT gated on quote status: a re-cost must always be able to
-     * land, or the published number silently diverges from the cost model that
-     * produced it. When the figure lands on a quote already in approval the
-     * response sets `invalidatesApproval` — the caller owns what to do about it
-     * (OMSF voids the collected approvals and re-routes).
-     */
-    async setEffectiveCost(quoteId, lineId, input, idempotencyKey) {
-        return this.http.request({
-            method: 'PATCH',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines/${encodeURIComponent(lineId)}/effective-cost`,
-            body: input,
-            idempotencyKey,
-        });
-    }
-    /** Price-side sibling of {@link setEffectiveCost}. */
-    async setEffectivePrice(quoteId, lineId, input, idempotencyKey) {
-        return this.http.request({
-            method: 'PATCH',
-            path: `/v1/quotes/${encodeURIComponent(quoteId)}/lines/${encodeURIComponent(lineId)}/effective-price`,
-            body: input,
-            idempotencyKey,
-        });
-    }
-}
-exports.QuoteLineResource = QuoteLineResource;
-//# sourceMappingURL=quoteLines.js.map

package/dist/quoteLines.js.map

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