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

package/dist/quoteLines.js

@@ -0,0 +1,147 @@
+"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

@@ -0,0 +1 @@
+{"version":3,"file":"quoteLines.js","sourceRoot":"","sources":["../src/quoteLines.ts"],"names":[],"mappings":";;;AAWA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,iBAAiB;IACC;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,QAAQ;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,gFAAgF;IAChF,8EAA8E;IAC9E,yCAAyC;IACzC,KAAK,CAAC,aAAa,CAAC,QAAkB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuC;YAC7D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,OAAe,EACf,KAAwB,EACxB,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YAC3D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,QAAQ;YACvD,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,MAAc,EACd,KAA2B;QAE3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YAC3D,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE;YACrF,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,MAAc;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YAC3D,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAiB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,gBAAgB;YAC/D,IAAI,EAAE,EAAE,OAAO,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,MAAc,EACd,KAAqC,EACrC,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA6C;YACnE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,iBAAiB;YACpG,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,iBAAiB,CACrB,OAAe,EACf,MAAc,EACd,KAAsC,EACtC,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA6C;YACnE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,kBAAkB;YACrG,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;CACF;AA1ID,8CA0IC"}

package/dist/quotes.d.ts

@@ -19,13 +19,18 @@ export declare class QuoteResource {
     get(id: string, options?: GetQuoteOptions): Promise<SingleResponse<Quote>>;
     create(input: CreateQuoteInput, idempotencyKey?: string): Promise<CreateResponse<Quote>>;
     /**
-     * Issue the next `RFQ-YYYY-NNNN` for the caller's tenant — the authoritative
+     * Issue the next `Q-YYYY-NNN` for the caller's tenant — the authoritative
      * quote-number mint (master-data owns the number and enforces `quoteNumber`
      * uniqueness). Atomic per (tenant, year); the first call of a year seeds the
-     * counter above the existing numeric max. Returns `{ quoteNumber }`. CPQ's
-     * createRfq calls this instead of scanning its own list and incrementing —
-     * a scan that wedged at `RFQ-YYYY-10000` once a tenant's yearly sequence
-     * passed four digits.
+     * counter above the existing numeric max, across both prefixes. Returns
+     * `{ quoteNumber }`. Both CPQ and OMSF call this instead of scanning the quote
+     * list and incrementing — scans that wedged at 10000 once a tenant's yearly
+     * sequence passed four digits (CPQ) and raced on concurrent creates (OMSF).
+     *
+     * **The prefix changed from `RFQ-` to `Q-` on 2026-08-06**, because `RFQ-` now
+     * names the customer's request that several competing quotes answer. Quotes
+     * numbered before the change keep their `RFQ-` numbers — treat a quote number
+     * as an opaque string and never parse a prefix out of it.
      */
     nextNumber(): Promise<SingleResponse<{
         quoteNumber: string;

package/dist/quotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quotes.d.ts","sourceRoot":"","sources":["../src/quotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAqB/D,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAY1E,MAAM,CACV,KAAK,EAAE,gBAAgB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOpE;;;;OAIG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,gBAAgB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,0BAA0B,EACjC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD;;;;;;OAMG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAQvE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAOhE;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,qBAAqB,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;CAQlC"}
+{"version":3,"file":"quotes.d.ts","sourceRoot":"","sources":["../src/quotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAqB/D,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAY1E,MAAM,CACV,KAAK,EAAE,gBAAgB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;OAaG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOpE;;;;OAIG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,gBAAgB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,0BAA0B,EACjC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD;;;;;;OAMG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAQvE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAOhE;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,qBAAqB,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IASjC;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;CAQlC"}

package/dist/quotes.js

@@ -68,13 +68,18 @@ class QuoteResource {
         });
     }
     /**
-     * Issue the next `RFQ-YYYY-NNNN` for the caller's tenant — the authoritative
+     * Issue the next `Q-YYYY-NNN` for the caller's tenant — the authoritative
      * quote-number mint (master-data owns the number and enforces `quoteNumber`
      * uniqueness). Atomic per (tenant, year); the first call of a year seeds the
-     * counter above the existing numeric max. Returns `{ quoteNumber }`. CPQ's
-     * createRfq calls this instead of scanning its own list and incrementing —
-     * a scan that wedged at `RFQ-YYYY-10000` once a tenant's yearly sequence
-     * passed four digits.
+     * counter above the existing numeric max, across both prefixes. Returns
+     * `{ quoteNumber }`. Both CPQ and OMSF call this instead of scanning the quote
+     * list and incrementing — scans that wedged at 10000 once a tenant's yearly
+     * sequence passed four digits (CPQ) and raced on concurrent creates (OMSF).
+     *
+     * **The prefix changed from `RFQ-` to `Q-` on 2026-08-06**, because `RFQ-` now
+     * names the customer's request that several competing quotes answer. Quotes
+     * numbered before the change keep their `RFQ-` numbers — treat a quote number
+     * as an opaque string and never parse a prefix out of it.
      */
     async nextNumber() {
         return this.http.request({

package/dist/quotes.js.map

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

package/dist/types.d.ts

@@ -106,7 +106,7 @@ export interface ListProgramsOptions {
 export interface GetProgramOptions {
     include?: ('customerCompany' | 'oemCompany')[];
 }
-export type QuoteStatus = 'draft' | 'costing_requested' | 'costing_in_progress' | 'costing_complete' | 'pricing' | 'routed_for_approval' | 'in_review' | 'approved' | 'submitted' | 'negotiating' | 'awarded' | 'lost';
+export type QuoteStatus = 'draft' | 'costing_requested' | 'costing_in_progress' | 'costing_complete' | 'pricing' | 'routed_for_approval' | 'in_review' | 'approved' | 'submitted' | 'negotiating' | 'awarded' | 'lost' | 'not_taken';
 /**
  * Who is driving the transition. Required on every status update so the
  * server can enforce role-gated transitions. `admin` is the escape hatch
@@ -137,6 +137,23 @@ export interface Quote {
     name: string | null;
     customerCompanyId: string;
     programId: string | null;
+    /**
+     * The OEM request this quote is one competing answer to — see {@link QuoteAsk}.
+     * Null means it competes with nothing and is awardable on its own, which is a
+     * legitimate state, not missing data.
+     */
+    askId: string | null;
+    /**
+     * @deprecated A DERIVED MIRROR of the quote's lines — read `quoteLines.list()`
+     * instead.
+     *
+     * Free text holding a part NUMBER (never a uuid), historically the quote's only
+     * part reference. A quote is multi-part now, and this reflects the FIRST line
+     * only, so it is lossy the moment a quote has more than one. Writes still work
+     * for the whole deprecation window (they transparently maintain the quote's
+     * single line), but new code should not read it as "the quote's part". Dropped
+     * in a later major. See the nextgen ADR `2026-08-05-multi-part-quotes.md`.
+     */
     partId: string | null;
     /**
      * The historical/parent quote this one was copied from. OMSF sets this when
@@ -215,6 +232,24 @@ export interface Quote {
      * column stays the canonical yearly curve.
      */
     effectiveVolumesByYear: EffectiveVolumeByYear[] | null;
+    /**
+     * The VEHICLE stream (added 2026-08-06) — how many vehicles the program
+     * builds, NOT how many parts we sell.
+     *
+     * This is what each {@link QuoteLine} bridges from: `vehicleAnnualVolume ×
+     * takeRate × partsPerVehicle` is that finished good's part volume. One quote
+     * covering four finished goods has ONE vehicle stream and four different part
+     * volumes, which is why the part columns above cannot serve as the input.
+     *
+     * **Null on every quote written before 2026-08-06**, and that is not a gap:
+     * those quotes' lines bridge from the part columns instead, at a 100/1 bridge
+     * that leaves the figure untouched. Read it as "does this quote calculate its
+     * line volumes, or carry them directly?" rather than as missing data.
+     */
+    vehicleAnnualVolume: number | null;
+    /** Per-year vehicle curve, same shape as {@link effectiveVolumesByYear}.
+     *  Bridged year by year onto each line. */
+    vehicleVolumesByYear: EffectiveVolumeByYear[] | null;
     /**
      * Customer-committed PART volume on ARBITRARY periods — the general form of
      * {@link effectiveVolumesByYear}, for deals tracked at a granularity the year
@@ -306,6 +341,230 @@ export interface SetEffectivePriceInput {
     /** Which app is writing — gated to 'omsf' | 'cpq' | 'admin' server-side. */
     callerRole: 'omsf' | 'cpq' | 'admin';
 }
+export type QuoteAskStatus = 'open' | 'resolved' | 'cancelled';
+export interface QuoteAsk {
+    id: string;
+    tenantId: string;
+    /** `ASK-YYYY-NNN`, minted server-side from an atomic per-(tenant, year) counter. */
+    askNumber: string;
+    name: string | null;
+    customerCompanyId: string;
+    /** Reporting only — NEVER used to decide competition. An opportunity spans
+     *  rounds; an ask is one round. */
+    opportunityId: string | null;
+    dueDate: string | null;
+    status: QuoteAskStatus;
+    /** Which quote won. A recorded fact — closing the siblings is a later phase. */
+    resolvedByQuoteId: string | null;
+    resolvedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface QuoteAskSummary extends QuoteAsk {
+    /** How many quotes compete in this ask. Deliberately not a value aggregate. */
+    quoteCount: number;
+}
+/**
+ * A RANGE across the ask's quotes — deliberately not a total.
+ *
+ * The quotes are ALTERNATIVES: three of four lose on every multi-scenario RFQ by
+ * construction, so adding them multiply-counts the same business.
+ */
+export interface QuoteAskRange {
+    quoteCount: number;
+    minValue: number | null;
+    maxValue: number | null;
+    minBlendedMarginPct: number | null;
+    maxBlendedMarginPct: number | null;
+}
+export interface QuoteAskCompetingQuote {
+    id: string;
+    quoteNumber: string;
+    name: string | null;
+    status: QuoteStatus;
+    lines: QuoteLine[];
+    rollUp: QuoteLineRollUp;
+}
+export interface QuoteAskDetail extends QuoteAsk {
+    quotes: QuoteAskCompetingQuote[];
+    range: QuoteAskRange;
+}
+export interface CreateQuoteAskInput {
+    customerCompanyId: string;
+    name?: string | null;
+    opportunityId?: string | null;
+    dueDate?: string | null;
+}
+export interface UpdateQuoteAskInput {
+    name?: string | null;
+    dueDate?: string | null;
+    opportunityId?: string | null;
+    status?: QuoteAskStatus;
+    /** Required when resolving; must be one of this ask's own quotes. */
+    resolvedByQuoteId?: string | null;
+}
+export interface ListQuoteAsksOptions {
+    status?: QuoteAskStatus;
+    customerCompanyId?: string;
+    opportunityId?: string;
+}
+/** A per-year volume point. Same shape the quote header uses. */
+export interface QuoteLineVolumeByYear {
+    year: number;
+    effectiveVolume: number;
+}
+export interface QuoteLine {
+    id: string;
+    tenantId: string;
+    quoteId: string;
+    /** Document order. Also picks the line that supplies the deprecated `Quote.partId`. */
+    sortOrder: number;
+    /**
+     * The canonical master-data {@link Part}. NULL is legal — soft enforcement, so a
+     * part number not yet reconciled into the catalog can still be quoted. Denotes
+     * the BASE part per the part-identity ADR.
+     */
+    partId: string | null;
+    /** Required, denormalised. Carries the line on its own when `partId` is null. */
+    partNumber: string;
+    /** Engineering revision this line is quoted AT, when known. Never identity. */
+    revision: string | null;
+    /**
+     * Vehicle→part bridge, unique per line. At the defaults (100 / 1) the
+     * header→line volume projection is the IDENTITY.
+     */
+    takeRate: number | null;
+    partsPerVehicle: number | null;
+    /** Authored. Null inherits the header through the bridge. */
+    annualVolume: number | null;
+    /** Authored per-year series. Authoritative over `annualVolume` when present. */
+    effectiveVolumesByYear: QuoteLineVolumeByYear[] | null;
+    /** Authored offered price for this line. */
+    unitPrice: string | null;
+    /** Free text against an unhealthy line. Writable during review. */
+    note: string | null;
+    /** DERIVED — published only via `quoteLines.setEffectiveCost`. */
+    effectiveUnitCost: string | null;
+    effectiveCostSource: string | null;
+    effectiveCostBasis: string | null;
+    effectiveCostedAt: string | null;
+    effectiveCostedBy: string | null;
+    effectiveCostBreakdown: unknown | null;
+    /** DERIVED — published only via `quoteLines.setEffectivePrice`. */
+    effectiveUnitPrice: string | null;
+    effectivePriceSource: string | null;
+    effectivePriceBasis: string | null;
+    effectivePricedAt: string | null;
+    effectivePricedBy: string | null;
+    effectivePriceBreakdown: unknown | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Present when the line resolves to a catalog part. */
+    part?: {
+        id: string;
+        partNumber: string;
+        name: string;
+        partTypeId: string | null;
+    } | null;
+    /** Resolved figures — see {@link ResolvedQuoteLineTerms}. */
+    terms: ResolvedQuoteLineTerms;
+}
+/**
+ * A line's resolved terms. The `*Source` / `*FromLine` flags let a caller tell an
+ * authored figure from an inherited one without re-deriving the precedence.
+ */
+export interface ResolvedQuoteLineTerms {
+    annualVolume: number;
+    volumesByYear: QuoteLineVolumeByYear[] | null;
+    unitCost: number | null;
+    unitPrice: number | null;
+    value: number;
+    marginPct: number | null;
+    /**
+     * Which tier the volume came from: the line's own series, the line's own annual
+     * figure, or the quote header bridged through take rate × parts per vehicle.
+     */
+    volumeSource: 'line_years' | 'line_annual' | 'header_bridged';
+    costFromLine: boolean;
+    priceFromLine: boolean;
+}
+/**
+ * Consolidated figures for ONE quote's lines, computed on read.
+ *
+ * `blendedMarginPct` is value-weighted over the lines whose margin is KNOWN, not
+ * over the whole quote value — a blend diluted by parts with no cost yet is a
+ * worse number that is equally false. `linesWithoutMargin` reports that gap.
+ */
+export interface QuoteLineRollUp {
+    lineCount: number;
+    totalAnnualVolume: number;
+    totalValue: number;
+    blendedMarginPct: number | null;
+    linesWithoutMargin: number;
+    /** Lines whose part number isn't reconciled into the catalog yet. */
+    linesWithoutCatalogPart: number;
+}
+export interface QuoteLinesResponse {
+    quoteId: string;
+    quoteNumber: string;
+    lines: QuoteLine[];
+    rollUp: QuoteLineRollUp;
+}
+export interface QuoteLinesWithApprovalFlag extends QuoteLinesResponse {
+    /**
+     * True when the published figure landed on a quote already in approval — the
+     * approver signed off on a different number. Surfaced rather than silently
+     * absorbed; the caller decides whether to void and re-route.
+     */
+    invalidatesApproval: boolean;
+}
+export interface AddQuoteLineInput {
+    partNumber: string;
+    /** Omit to resolve from `partNumber`; pass `null` to pin it null. */
+    partId?: string | null;
+    revision?: string | null;
+    /** Defaults to the end of the list, so a new line can't take over the mirror. */
+    sortOrder?: number;
+    /** Percentage, 0–100. Defaults to 100. */
+    takeRate?: number;
+    /** Defaults to 1. */
+    partsPerVehicle?: number;
+    annualVolume?: number | null;
+    effectiveVolumesByYear?: QuoteLineVolumeByYear[] | null;
+    unitPrice?: number | null;
+    note?: string | null;
+}
+export interface UpdateQuoteLineInput {
+    partNumber?: string;
+    /** Omitted with a changed `partNumber` re-resolves the catalog link. */
+    partId?: string | null;
+    revision?: string | null;
+    sortOrder?: number;
+    takeRate?: number;
+    partsPerVehicle?: number;
+    annualVolume?: number | null;
+    effectiveVolumesByYear?: QuoteLineVolumeByYear[] | null;
+    unitPrice?: number | null;
+    note?: string | null;
+}
+export interface SetQuoteLineEffectiveCostInput {
+    unitCost: number;
+    /** Required — what the figure was costed against. */
+    costBasis: string;
+    /** Declared by the adapter. Defaults to 'cpq'. */
+    source?: string;
+    breakdown?: unknown;
+}
+export interface SetQuoteLineEffectivePriceInput {
+    unitPrice: number;
+    priceBasis: string;
+    source?: string;
+    breakdown?: unknown;
+}
 export interface CreateQuoteInput {
     /**
      * MIGRATION ESCAPE HATCH — do not set this from production code.
@@ -323,6 +582,10 @@ export interface CreateQuoteInput {
     name?: string;
     customerCompanyId: string;
     programId?: string;
+    /** Join the quote to an OEM request ({@link QuoteAsk}). Optional — a quote with
+     *  no ask competes with nothing and is awardable on its own. Validated to exist
+     *  in-tenant AND to belong to the same customer as the quote. */
+    askId?: string | null;
     partId?: string;
     /** Historical/parent quote this one was copied from. Validated to exist
      *  in-tenant on write; no DB FK. */
@@ -342,6 +605,12 @@ export interface CreateQuoteInput {
     eopPrecision?: SopEopPrecision;
     effectiveAnnualVolume?: number;
     effectiveVolumesByYear?: EffectiveVolumeByYear[];
+    /** The VEHICLE stream every line bridges from — vehicles the program builds,
+     *  not parts sold. Each line turns it into its own part volume with its take
+     *  rate and parts-per-vehicle. Omit it and the lines fall back to the part
+     *  columns, which is what pre-2026-08-06 quotes do. (4.12.0) */
+    vehicleAnnualVolume?: number;
+    vehicleVolumesByYear?: EffectiveVolumeByYear[];
     /** Arbitrary-period committed volume. Non-empty makes the two fields above
      *  derived — passing either alongside it is a 422. (4.8.0) */
     effectiveVolumesByPeriod?: EffectiveVolumeByPeriod[];
@@ -372,6 +641,9 @@ export interface UpdateQuoteInput {
     quoteNumber?: string;
     name?: string | null;
     programId?: string | null;
+    /** Join the quote to an OEM request ({@link QuoteAsk}), or `null` to detach it
+     *  (it then competes with nothing). Validated to match the quote's customer. */
+    askId?: string | null;
     partId?: string | null;
     /** Set to a quote id to record provenance, or `null` to clear it. */
     referenceQuoteId?: string | null;
@@ -389,6 +661,11 @@ export interface UpdateQuoteInput {
     eopPrecision?: SopEopPrecision | null;
     effectiveAnnualVolume?: number | null;
     effectiveVolumesByYear?: EffectiveVolumeByYear[] | null;
+    /** The VEHICLE stream. Editing it moves EVERY line's calculated volume at
+     *  once — one program build rate, many finished goods. `null` hands the lines
+     *  back to the part columns. (4.12.0) */
+    vehicleAnnualVolume?: number | null;
+    vehicleVolumesByYear?: EffectiveVolumeByYear[] | null;
     /** Full replace. Non-empty makes the yearly fields derived (writing them is a
      *  422); `null` or `[]` clears the schedule and hands them back. The last
      *  derived values are left in place — clearing stops maintaining them, it
@@ -1790,7 +2067,7 @@ export type SourceApp = 'master-data' | 'erfq' | 'cpq' | 'bom' | 'forecast' | 'o
  *  "Empty" means SQL NULL only — a stored '', 0, false, or 0.0 counts as
  *  populated and will not be overwritten by fill_empty. */
 export type MergePolicy = 'overwrite' | 'fill_empty';
-export type ImportTargetField = 'name' | 'legalName' | 'code' | 'taxId' | 'dunsNumber' | 'website' | 'logoUrl' | 'roles' | 'email' | 'phone' | 'role' | 'type' | 'description' | 'street' | 'city' | 'stateProvince' | 'postalCode' | 'country' | 'category' | 'parent_company_ref' | 'companyCode' | 'locationCode' | 'region' | 'headcount' | 'annualCapacityHours' | 'currentUtilization' | 'riskLevel' | 'numShifts' | 'hoursPerShift' | 'workingDaysPerYear' | 'indirectHeadcountPct' | 'currency' | 'effectiveDate' | 'effectiveTo' | 'libraryCode' | 'kind' | 'plantCode' | 'skillTier' | 'materialCode' | 'regionCode' | 'lane' | 'rate' | 'unit' | 'sourcingMode' | 'indexRef' | 'notes' | 'partNumber' | 'manufacturingPartNumber' | 'customerPartNumber' | 'partType' | 'manufacturer' | 'partCategoryCode' | 'quality' | 'revision' | 'uom' | 'weightPerUnit' | 'recycledPct' | 'pcfPerUnit' | 'releaseStatus' | 'leadTime' | 'customerCompanyCode' | 'customerCompanyName' | 'sopDate' | 'eopDate' | 'displayOrder' | 'label' | 'sortOrder' | 'processFamily' | 'capacityHoursPerYear' | 'cavities' | 'availabilityPct' | 'performancePct' | 'defaultHeadcount' | 'defaultAutomationPct' | 'defaultMachinesPerOperator' | 'defaultSetupCrew' | 'perUsd' | 'effectiveFrom' | 'quoteNumber' | 'programCode' | 'partId' | 'regionName' | 'annualVolume' | 'apw' | 'mpw' | 'targetPrice' | 'dueDate' | 'status' | 'key' | 'dataType' | 'options' | 'group' | 'required' | 'min' | 'max' | 'regex' | 'precision' | 'basis' | 'bindings' | 'perBaseFactor' | 'needsDensity' | 'binding' | 'allowedUoms' | 'defaultUom' | 'escalationDefault' | 'density' | 'densityUnit';
+export type ImportTargetField = 'name' | 'legalName' | 'code' | 'taxId' | 'dunsNumber' | 'website' | 'logoUrl' | 'roles' | 'email' | 'phone' | 'role' | 'type' | 'description' | 'street' | 'city' | 'stateProvince' | 'postalCode' | 'country' | 'category' | 'parent_company_ref' | 'companyCode' | 'companyName' | 'locationCode' | 'region' | 'headcount' | 'annualCapacityHours' | 'currentUtilization' | 'riskLevel' | 'numShifts' | 'hoursPerShift' | 'workingDaysPerYear' | 'indirectHeadcountPct' | 'currency' | 'effectiveDate' | 'effectiveTo' | 'libraryCode' | 'kind' | 'plantCode' | 'skillTier' | 'materialCode' | 'regionCode' | 'lane' | 'rate' | 'unit' | 'sourcingMode' | 'indexRef' | 'notes' | 'partNumber' | 'manufacturingPartNumber' | 'customerPartNumber' | 'partType' | 'manufacturer' | 'partCategoryCode' | 'quality' | 'revision' | 'uom' | 'weightPerUnit' | 'recycledPct' | 'pcfPerUnit' | 'releaseStatus' | 'leadTime' | 'customerCompanyCode' | 'customerCompanyName' | 'sopDate' | 'eopDate' | 'displayOrder' | 'label' | 'sortOrder' | 'processFamily' | 'capacityHoursPerYear' | 'cavities' | 'availabilityPct' | 'performancePct' | 'defaultHeadcount' | 'defaultAutomationPct' | 'defaultMachinesPerOperator' | 'defaultSetupCrew' | 'perUsd' | 'effectiveFrom' | 'quoteNumber' | 'programCode' | 'partId' | 'regionName' | 'annualVolume' | 'apw' | 'mpw' | 'targetPrice' | 'dueDate' | 'status' | 'key' | 'dataType' | 'options' | 'group' | 'required' | 'min' | 'max' | 'regex' | 'precision' | 'basis' | 'bindings' | 'perBaseFactor' | 'needsDensity' | 'binding' | 'allowedUoms' | 'defaultUom' | 'escalationDefault' | 'density' | 'densityUnit';
 export interface ImportSession {
     id: string;
     tenantId: string;
@@ -2066,10 +2343,20 @@ export interface BulkArchiveResult {
         errors: number;
     };
 }
+/** Ownership verdict carried on an *enforced* entity's read/list response
+ *  `meta` (Master Data Ownership Phase 4). Present only for enforced elements
+ *  (Plant today). `readOnly` ⇒ the element is externally owned and Campfire
+ *  edits are rejected server-side; the UI renders read-only + `editHint`. */
+export interface OwnershipMeta {
+    readOnly: boolean;
+    ownerSystem: string;
+    editHint: string | null;
+}
 export interface ApiMeta {
     requestId: string;
     timestamp: string;
     resolvedFrom?: string;
+    ownership?: OwnershipMeta;
 }
 export interface ListMeta extends ApiMeta {
     nextCursor: string | null;
@@ -2083,6 +2370,29 @@ export interface DuplicateWarning {
     matchName: string;
     score: number;
 }
+export type OwnerType = 'campfire' | 'external';
+/** One catalog element merged with its (optional) stored ownership row. The
+ *  GET response fills catalog defaults where a tenant has no row. */
+export interface MasterDataElementOwnership {
+    element: string;
+    label: string;
+    category: string;
+    ownerType: OwnerType;
+    /** Owning system display name; 'Campfire' when Campfire-owned. */
+    systemName: string;
+    syncMethod: string | null;
+    /** Opaque integrations Source id (external only) — traceability, not a FK. */
+    sourceRef: string | null;
+    updatedAt: string | null;
+    updatedBy: string | null;
+}
+export interface SetOwnershipInput {
+    ownerType: OwnerType;
+    /** Required when ownerType is 'external'. */
+    systemName?: string;
+    syncMethod?: string;
+    sourceRef?: string;
+}
 export interface SingleResponse<T> {
     data: T;
     meta: ApiMeta;