@campfire-interactive/bom-client 0.1.1

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { CostBreakdownResource } from './costBreakdown';
+import { RoutingResource } from './routing';
+import type { BomClientConfig } from './types';
+/**
+ * Client for the BOM read contract — the costed and routed view of a part,
+ * resolved from a part reference the caller already has.
+ *
+ *   const bom = new BomClient({
+ *     baseUrl: process.env.BOM_BASE_URL!,
+ *     getToken: () => mintSystemTokenForTenant(tenantId, 'bom'),
+ *   });
+ *   const cost    = await bom.costBreakdown.get({ partNumber, programId });
+ *   const routing = await bom.routing.get({ partNumber, programId });
+ *
+ * The contract's one rule: **a consumer addresses parts, never BOMs.** It has
+ * no bomId, no version, and no notion of the EBOM/CBOM/MBOM lenses; bom
+ * resolves those and reports what it picked in `provenance`. Display that —
+ * resolution is a live guess against the current Active version, so the same
+ * call can answer differently after the next import.
+ *
+ * Consumers: OMSF's quote viewer (read-only display of BOM data beside a
+ * quote), and CPQ once its BOM handling consolidates into the bom app.
+ */
+export declare class BomClient {
+    readonly costBreakdown: CostBreakdownResource;
+    readonly routing: RoutingResource;
+    constructor(config: BomClientConfig);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEtB,MAAM,EAAE,eAAe;CAKpC"}

package/dist/client.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BomClient = void 0;
+const http_1 = require("./http");
+const costBreakdown_1 = require("./costBreakdown");
+const routing_1 = require("./routing");
+/**
+ * Client for the BOM read contract — the costed and routed view of a part,
+ * resolved from a part reference the caller already has.
+ *
+ *   const bom = new BomClient({
+ *     baseUrl: process.env.BOM_BASE_URL!,
+ *     getToken: () => mintSystemTokenForTenant(tenantId, 'bom'),
+ *   });
+ *   const cost    = await bom.costBreakdown.get({ partNumber, programId });
+ *   const routing = await bom.routing.get({ partNumber, programId });
+ *
+ * The contract's one rule: **a consumer addresses parts, never BOMs.** It has
+ * no bomId, no version, and no notion of the EBOM/CBOM/MBOM lenses; bom
+ * resolves those and reports what it picked in `provenance`. Display that —
+ * resolution is a live guess against the current Active version, so the same
+ * call can answer differently after the next import.
+ *
+ * Consumers: OMSF's quote viewer (read-only display of BOM data beside a
+ * quote), and CPQ once its BOM handling consolidates into the bom app.
+ */
+class BomClient {
+    costBreakdown;
+    routing;
+    constructor(config) {
+        const http = new http_1.HttpTransport(config);
+        this.costBreakdown = new costBreakdown_1.CostBreakdownResource(http);
+        this.routing = new routing_1.RoutingResource(http);
+    }
+}
+exports.BomClient = BomClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,iCAAuC;AACvC,mDAAwD;AACxD,uCAA4C;AAG5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,SAAS;IACX,aAAa,CAAwB;IACrC,OAAO,CAAkB;IAElC,YAAY,MAAuB;QACjC,MAAM,IAAI,GAAG,IAAI,oBAAa,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,qCAAqB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAe,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AATD,8BASC"}

package/dist/costBreakdown.d.ts

@@ -0,0 +1,28 @@
+import type { HttpTransport } from './http';
+import type { CostBreakdownResult, PartLookup } from './types';
+/**
+ * The costed view of one part: bom's own `CostModel` document plus the
+ * provenance saying which BOM, version and lens answered.
+ *
+ * This is a READ surface for DISPLAY. It does not produce a quote's cost — if
+ * an app needs a number to commit to a quote, that goes through its costing
+ * engine, not through here.
+ */
+export declare class CostBreakdownResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Resolve a part reference to its cost breakdown.
+     *
+     * Never throws for "no BOM has this part" — that is a `resolved: false`
+     * result a viewer renders as a state. Narrow with `programId` (an OMSF quote
+     * has one) when a part number recurs across projects; without it, such a part
+     * comes back `reason: 'ambiguous'` with the candidate projects listed.
+     *
+     *   const res = await bom.costBreakdown.get({ partNumber, programId });
+     *   if (!res.resolved) return renderEmpty(res.reason);
+     *   renderTabs(res.costModel, res.provenance);
+     */
+    get(lookup: PartLookup): Promise<CostBreakdownResult>;
+}
+//# sourceMappingURL=costBreakdown.d.ts.map

package/dist/costBreakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBreakdown.d.ts","sourceRoot":"","sources":["../src/costBreakdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAe,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG5E;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAS5D"}

package/dist/costBreakdown.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CostBreakdownResource = void 0;
+const internal_1 = require("./internal");
+/**
+ * The costed view of one part: bom's own `CostModel` document plus the
+ * provenance saying which BOM, version and lens answered.
+ *
+ * This is a READ surface for DISPLAY. It does not produce a quote's cost — if
+ * an app needs a number to commit to a quote, that goes through its costing
+ * engine, not through here.
+ */
+class CostBreakdownResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Resolve a part reference to its cost breakdown.
+     *
+     * Never throws for "no BOM has this part" — that is a `resolved: false`
+     * result a viewer renders as a state. Narrow with `programId` (an OMSF quote
+     * has one) when a part number recurs across projects; without it, such a part
+     * comes back `reason: 'ambiguous'` with the candidate projects listed.
+     *
+     *   const res = await bom.costBreakdown.get({ partNumber, programId });
+     *   if (!res.resolved) return renderEmpty(res.reason);
+     *   renderTabs(res.costModel, res.provenance);
+     */
+    async get(lookup) {
+        (0, internal_1.assertPartRef)(lookup);
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/api/v1/cost-breakdown',
+            query: (0, internal_1.lookupQuery)(lookup),
+        });
+        return res.data;
+    }
+}
+exports.CostBreakdownResource = CostBreakdownResource;
+//# sourceMappingURL=costBreakdown.js.map

package/dist/costBreakdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBreakdown.js","sourceRoot":"","sources":["../src/costBreakdown.ts"],"names":[],"mappings":";;;AAEA,yCAAwD;AAExD;;;;;;;GAOG;AACH,MAAa,qBAAqB;IACH;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,MAAkB;QAC1B,IAAA,wBAAa,EAAC,MAAM,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmC;YACpE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,wBAAwB;YAC9B,KAAK,EAAE,IAAA,sBAAW,EAAC,MAAM,CAAC;SAC3B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;CACF;AAxBD,sDAwBC"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class BomError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly requestId: string | undefined;
+    constructor(message: string, statusCode: number, code: string, requestId?: string);
+}
+export declare class NotFoundError extends BomError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class UnauthorizedError extends BomError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class ForbiddenError extends BomError {
+    constructor(message?: string, requestId?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAOlF;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,SAAuB,EAAE,SAAS,CAAC,EAAE,MAAM;CAG/D;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,SAAiB,EAAE,SAAS,CAAC,EAAE,MAAM;CAGzD;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,SAAc,EAAE,SAAS,CAAC,EAAE,MAAM;CAGtD"}

package/dist/errors.js

@@ -0,0 +1,39 @@
+"use strict";
+// =============================================================================
+// Client-side error hierarchy — mirrors bom's AppError shape (and the
+// VI / master-data / dms clients).
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForbiddenError = exports.UnauthorizedError = exports.NotFoundError = exports.BomError = void 0;
+class BomError extends Error {
+    statusCode;
+    code;
+    requestId;
+    constructor(message, statusCode, code, requestId) {
+        super(message);
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.code = code;
+        this.requestId = requestId;
+    }
+}
+exports.BomError = BomError;
+class NotFoundError extends BomError {
+    constructor(message = 'Resource not found', requestId) {
+        super(message, 404, 'NOT_FOUND', requestId);
+    }
+}
+exports.NotFoundError = NotFoundError;
+class UnauthorizedError extends BomError {
+    constructor(message = 'Unauthorized', requestId) {
+        super(message, 401, 'UNAUTHORIZED', requestId);
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+class ForbiddenError extends BomError {
+    constructor(message = 'Forbidden', requestId) {
+        super(message, 403, 'FORBIDDEN', requestId);
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,sEAAsE;AACtE,mCAAmC;AACnC,gFAAgF;;;AAEhF,MAAa,QAAS,SAAQ,KAAK;IACxB,UAAU,CAAS;IACnB,IAAI,CAAS;IACb,SAAS,CAAqB;IAEvC,YAAY,OAAe,EAAE,UAAkB,EAAE,IAAY,EAAE,SAAkB;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAZD,4BAYC;AAED,MAAa,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAO,GAAG,oBAAoB,EAAE,SAAkB;QAC5D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAO,GAAG,cAAc,EAAE,SAAkB;QACtD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;CACF;AAJD,8CAIC;AAED,MAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAO,GAAG,WAAW,EAAE,SAAkB;QACnD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,wCAIC"}

package/dist/http.d.ts

@@ -0,0 +1,25 @@
+import type { BomClientConfig } from './types';
+interface HttpRequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | undefined>;
+}
+/** Auth-aware fetch transport. Mirrors the integrations / VI / master-data
+ *  clients: `{ baseUrl, getToken, timeout }`, bearer injection, timeout via
+ *  AbortController, and status→error mapping. */
+export declare class HttpTransport {
+    private readonly baseUrl;
+    private readonly getToken;
+    private readonly timeout;
+    constructor(config: BomClientConfig);
+    request<T>(options: HttpRequestOptions): Promise<T>;
+    private buildUrl;
+    /** bom's error envelope is `{ error: string, code: string }` (see
+     *  core/apiService.ts) — flatter than the integrations one, and with no
+     *  requestId on the error path. Object-shaped `error` is tolerated in case
+     *  that changes. */
+    private throwForStatus;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,UAAU,kBAAkB;IAC1B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AAED;;iDAEiD;AACjD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,eAAe;IAM7B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAoCzD,OAAO,CAAC,QAAQ;IAUhB;;;wBAGoB;IACpB,OAAO,CAAC,cAAc;CAwBvB"}

package/dist/http.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const errors_1 = require("./errors");
+const DEFAULT_TIMEOUT = 30_000;
+/** Auth-aware fetch transport. Mirrors the integrations / VI / master-data
+ *  clients: `{ baseUrl, getToken, timeout }`, bearer injection, timeout via
+ *  AbortController, and status→error mapping. */
+class HttpTransport {
+    baseUrl;
+    getToken;
+    timeout;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.getToken = config.getToken;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+    }
+    async request(options) {
+        const { method, path, body, query } = options;
+        const url = this.buildUrl(path, query);
+        const token = await this.getToken();
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (error.name === 'AbortError') {
+                throw new errors_1.BomError('Request timed out', 0, 'TIMEOUT');
+            }
+            throw new errors_1.BomError(`Network error: ${error.message}`, 0, 'NETWORK_ERROR');
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        if (response.status === 204)
+            return undefined;
+        const responseBody = await response.json().catch(() => undefined);
+        if (!response.ok)
+            this.throwForStatus(response.status, responseBody);
+        return responseBody;
+    }
+    buildUrl(path, query) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined)
+                    url.searchParams.set(key, value);
+            }
+        }
+        return url.toString();
+    }
+    /** bom's error envelope is `{ error: string, code: string }` (see
+     *  core/apiService.ts) — flatter than the integrations one, and with no
+     *  requestId on the error path. Object-shaped `error` is tolerated in case
+     *  that changes. */
+    throwForStatus(status, body) {
+        const errorBody = body;
+        const rawError = errorBody?.error;
+        const message = typeof rawError === 'string' ? rawError : rawError?.message || `Request failed with status ${status}`;
+        const code = errorBody?.code ||
+            (typeof rawError === 'object' ? rawError?.code : undefined) ||
+            'UNKNOWN_ERROR';
+        const requestId = errorBody?.meta?.requestId;
+        switch (status) {
+            case 404:
+                throw new errors_1.NotFoundError(message, requestId);
+            case 401:
+                throw new errors_1.UnauthorizedError(message, requestId);
+            case 403:
+                throw new errors_1.ForbiddenError(message, requestId);
+            default:
+                throw new errors_1.BomError(message, status, code, requestId);
+        }
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { BomClient } from './client';
+export { MockBomClient } from './mock';
+export { CostBreakdownResource } from './costBreakdown';
+export { RoutingResource } from './routing';
+export { BomError, NotFoundError, UnauthorizedError, ForbiddenError } from './errors';
+export type { BomClientConfig, BomEnvelope, BomTypeName, SourcingType, BomProvenance, AmbiguousProject, PartLookup, MakeBuy, CostSource, CostBasis, RateSet, CostItem, CostCategory, CostModelMeta, CostModel, CostBreakdown, CostBreakdownResult, RoutingStep, Routing, RoutingResult, Unresolved, } from './types';
+export type { MockSeed } from './mock';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtF,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForbiddenError = exports.UnauthorizedError = exports.NotFoundError = exports.BomError = exports.RoutingResource = exports.CostBreakdownResource = exports.MockBomClient = exports.BomClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "BomClient", { enumerable: true, get: function () { return client_1.BomClient; } });
+var mock_1 = require("./mock");
+Object.defineProperty(exports, "MockBomClient", { enumerable: true, get: function () { return mock_1.MockBomClient; } });
+var costBreakdown_1 = require("./costBreakdown");
+Object.defineProperty(exports, "CostBreakdownResource", { enumerable: true, get: function () { return costBreakdown_1.CostBreakdownResource; } });
+var routing_1 = require("./routing");
+Object.defineProperty(exports, "RoutingResource", { enumerable: true, get: function () { return routing_1.RoutingResource; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "BomError", { enumerable: true, get: function () { return errors_1.BomError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return errors_1.UnauthorizedError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return errors_1.ForbiddenError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqC;AAA5B,mGAAA,SAAS,OAAA;AAClB,+BAAuC;AAA9B,qGAAA,aAAa,OAAA;AACtB,iDAAwD;AAA/C,sHAAA,qBAAqB,OAAA;AAC9B,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,mCAAsF;AAA7E,kGAAA,QAAQ,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,wGAAA,cAAc,OAAA"}

package/dist/internal.d.ts

@@ -0,0 +1,15 @@
+import type { PartLookup } from './types';
+/**
+ * Prisma `Decimal` columns serialize as STRINGS. `ManufacturingStep.yieldPct`
+ * is one, so an uncoerced consumer doing `yieldPct * qty` gets a silent
+ * `NaN` — or worse, `"99.8" + 1 === "99.81"`. Coerce at the boundary so the
+ * row types are honest.
+ */
+export declare function toNum(v: unknown): number | null;
+/** Part reference + narrowing → query params. Blank strings are dropped so a
+ *  caller passing `programId: ''` doesn't accidentally filter on empty. */
+export declare function lookupQuery(lookup: PartLookup): Record<string, string | undefined>;
+/** Guard against a caller passing neither identifier — the server answers 400,
+ *  but failing here costs no round trip and gives a better message. */
+export declare function assertPartRef(lookup: PartLookup): void;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI/C;AAED;2EAC2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAWlF;AAED;uEACuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAItD"}

package/dist/internal.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNum = toNum;
+exports.lookupQuery = lookupQuery;
+exports.assertPartRef = assertPartRef;
+/**
+ * Prisma `Decimal` columns serialize as STRINGS. `ManufacturingStep.yieldPct`
+ * is one, so an uncoerced consumer doing `yieldPct * qty` gets a silent
+ * `NaN` — or worse, `"99.8" + 1 === "99.81"`. Coerce at the boundary so the
+ * row types are honest.
+ */
+function toNum(v) {
+    if (v == null)
+        return null;
+    const n = typeof v === 'number' ? v : Number(v);
+    return Number.isFinite(n) ? n : null;
+}
+/** Part reference + narrowing → query params. Blank strings are dropped so a
+ *  caller passing `programId: ''` doesn't accidentally filter on empty. */
+function lookupQuery(lookup) {
+    const clean = (v) => {
+        const t = v?.trim();
+        return t ? t : undefined;
+    };
+    return {
+        partNumber: clean(lookup.partNumber),
+        partRevisionId: clean(lookup.partRevisionId),
+        projectId: clean(lookup.projectId),
+        programId: clean(lookup.programId),
+    };
+}
+/** Guard against a caller passing neither identifier — the server answers 400,
+ *  but failing here costs no round trip and gives a better message. */
+function assertPartRef(lookup) {
+    if (!lookup.partNumber?.trim() && !lookup.partRevisionId?.trim()) {
+        throw new TypeError('bom-client: partNumber or partRevisionId is required');
+    }
+}
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;AAQA,sBAIC;AAID,kCAWC;AAID,sCAIC;AAjCD;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,CAAU;IAC9B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED;2EAC2E;AAC3E,SAAgB,WAAW,CAAC,MAAkB;IAC5C,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;QAC5C,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;QAClC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;KACnC,CAAC;AACJ,CAAC;AAED;uEACuE;AACvE,SAAgB,aAAa,CAAC,MAAkB;IAC9C,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/mock.d.ts

@@ -0,0 +1,42 @@
+import type { CostBreakdown, CostBreakdownResult, PartLookup, Routing, RoutingResult } from './types';
+/** Seed data for the mock client, keyed the way the real API resolves. */
+export interface MockSeed {
+    /** Cost answers. Matched on partNumber (or partRevisionId when the seed row
+     *  is addressed that way — see `partRevisionIds`). */
+    costBreakdowns?: CostBreakdown[];
+    routings?: Routing[];
+    /** partRevisionId → partNumber, so a consumer's test can exercise the
+     *  canonical-part join without restating the seed. */
+    partRevisionIds?: Record<string, string>;
+    /** Part numbers that should answer `ambiguous` unless narrowed by
+     *  projectId/programId — for testing the picker path. */
+    ambiguous?: string[];
+}
+/**
+ * In-memory stand-in mirroring the BomClient surface, for a consumer's tests.
+ *
+ * Reproduces the three answers that matter: resolved, `not-found`, and
+ * `ambiguous`-until-narrowed. A consumer whose tests only ever see the happy
+ * path will ship a viewer that renders nothing for the other two.
+ */
+export declare class MockBomClient {
+    private readonly _cost;
+    private readonly _routing;
+    private readonly _revisions;
+    private readonly _ambiguous;
+    constructor(seed?: MockSeed);
+    readonly costBreakdown: {
+        get: (lookup: PartLookup) => Promise<CostBreakdownResult>;
+    };
+    readonly routing: {
+        get: (lookup: PartLookup & {
+            plantId?: string;
+        }) => Promise<RoutingResult>;
+    };
+    private resolveRef;
+    /** Mirrors the server: ambiguity is only reported when the caller gave
+     *  nothing to narrow by. */
+    private checkUnresolvable;
+    private notFound;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,OAAO,EACP,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACvB;0DACsD;IACtD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB;0DACsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;6DACyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;gBAE7B,IAAI,GAAE,QAAa;IAO/B,QAAQ,CAAC,aAAa;sBACA,UAAU,KAAG,OAAO,CAAC,mBAAmB,CAAC;MAO7D;IAEF,QAAQ,CAAC,OAAO;sBACM,UAAU,GAAG;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,KAAG,OAAO,CAAC,aAAa,CAAC;MAS9E;IAEF,OAAO,CAAC,UAAU;IAMlB;gCAC4B;IAC5B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/mock.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockBomClient = void 0;
+/**
+ * In-memory stand-in mirroring the BomClient surface, for a consumer's tests.
+ *
+ * Reproduces the three answers that matter: resolved, `not-found`, and
+ * `ambiguous`-until-narrowed. A consumer whose tests only ever see the happy
+ * path will ship a viewer that renders nothing for the other two.
+ */
+class MockBomClient {
+    _cost;
+    _routing;
+    _revisions;
+    _ambiguous;
+    constructor(seed = {}) {
+        this._cost = seed.costBreakdowns ?? [];
+        this._routing = seed.routings ?? [];
+        this._revisions = seed.partRevisionIds ?? {};
+        this._ambiguous = new Set(seed.ambiguous ?? []);
+    }
+    costBreakdown = {
+        get: async (lookup) => {
+            const partNumber = this.resolveRef(lookup);
+            const unresolved = this.checkUnresolvable(lookup, partNumber);
+            if (unresolved)
+                return unresolved;
+            const hit = this._cost.find((c) => c.partNumber === partNumber);
+            return hit ?? this.notFound(lookup);
+        },
+    };
+    routing = {
+        get: async (lookup) => {
+            const partNumber = this.resolveRef(lookup);
+            const unresolved = this.checkUnresolvable(lookup, partNumber);
+            if (unresolved)
+                return unresolved;
+            const hit = this._routing.find((r) => r.partNumber === partNumber);
+            if (!hit)
+                return this.notFound(lookup);
+            if (!lookup.plantId)
+                return hit;
+            return { ...hit, steps: hit.steps.filter((s) => s.plantId === lookup.plantId) };
+        },
+    };
+    resolveRef(lookup) {
+        if (lookup.partNumber?.trim())
+            return lookup.partNumber.trim();
+        const rev = lookup.partRevisionId?.trim();
+        return rev ? this._revisions[rev] : undefined;
+    }
+    /** Mirrors the server: ambiguity is only reported when the caller gave
+     *  nothing to narrow by. */
+    checkUnresolvable(lookup, partNumber) {
+        if (!partNumber)
+            return this.notFound(lookup);
+        const narrowed = Boolean(lookup.projectId?.trim() || lookup.programId?.trim());
+        if (this._ambiguous.has(partNumber) && !narrowed) {
+            return {
+                resolved: false,
+                reason: 'ambiguous',
+                partNumber,
+                partRevisionId: lookup.partRevisionId ?? null,
+                candidates: [],
+            };
+        }
+        return null;
+    }
+    notFound(lookup) {
+        return {
+            resolved: false,
+            reason: 'not-found',
+            partNumber: lookup.partNumber ?? null,
+            partRevisionId: lookup.partRevisionId ?? null,
+        };
+    }
+}
+exports.MockBomClient = MockBomClient;
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

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

package/dist/routing.d.ts

@@ -0,0 +1,29 @@
+import type { HttpTransport } from './http';
+import type { RoutingResult, PartLookup } from './types';
+/**
+ * Manufacturing routing for one part — step number, process, cycle time, yield,
+ * equipment, plant.
+ *
+ * Routing has ONE storage home in bom: the Active **MBOM** version. Whatever
+ * lens answered for cost, routing comes from MBOM, so the provenance on this
+ * response can legitimately name a different version than the cost call's.
+ * Show both rather than assuming they match.
+ */
+export declare class RoutingResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Resolve a part reference to its routing steps, ordered by step number.
+     *
+     * `plantId` filters to one plant's steps — a multi-plant part has a routing
+     * per plant. Omit it to get every step bom holds.
+     *
+     * As with cost, an unresolvable part is a `resolved: false` result, not a
+     * throw. A resolved part with no routing is `steps: []` — it is in the MBOM,
+     * nobody has imported routing for it.
+     */
+    get(lookup: PartLookup & {
+        plantId?: string;
+    }): Promise<RoutingResult>;
+}
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAe,aAAa,EAAe,UAAU,EAAE,MAAM,SAAS,CAAC;AAOnF;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;OASG;IACG,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAc7E"}

package/dist/routing.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoutingResource = void 0;
+const internal_1 = require("./internal");
+/**
+ * Manufacturing routing for one part — step number, process, cycle time, yield,
+ * equipment, plant.
+ *
+ * Routing has ONE storage home in bom: the Active **MBOM** version. Whatever
+ * lens answered for cost, routing comes from MBOM, so the provenance on this
+ * response can legitimately name a different version than the cost call's.
+ * Show both rather than assuming they match.
+ */
+class RoutingResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Resolve a part reference to its routing steps, ordered by step number.
+     *
+     * `plantId` filters to one plant's steps — a multi-plant part has a routing
+     * per plant. Omit it to get every step bom holds.
+     *
+     * As with cost, an unresolvable part is a `resolved: false` result, not a
+     * throw. A resolved part with no routing is `steps: []` — it is in the MBOM,
+     * nobody has imported routing for it.
+     */
+    async get(lookup) {
+        (0, internal_1.assertPartRef)(lookup);
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/api/v1/routing',
+            query: { ...(0, internal_1.lookupQuery)(lookup), plantId: lookup.plantId?.trim() || undefined },
+        });
+        const data = res.data;
+        if (!data.resolved)
+            return data;
+        return {
+            ...data,
+            steps: (data.steps ?? []).map((s) => ({ ...s, yieldPct: (0, internal_1.toNum)(s.yieldPct) })),
+        };
+    }
+}
+exports.RoutingResource = RoutingResource;
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":";;;AAEA,yCAA+D;AAM/D;;;;;;;;GAQG;AACH,MAAa,eAAe;IACG;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,CAAC,MAAyC;QACjD,IAAA,wBAAa,EAAC,MAAM,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqD;YACtF,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,EAAE,GAAG,IAAA,sBAAW,EAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,SAAS,EAAE;SAChF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAA,gBAAK,EAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;SACvF,CAAC;IACJ,CAAC;CACF;AA3BD,0CA2BC"}

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+export interface BomClientConfig {
+    /** Base URL of the bom API, e.g. https://bom.dev.campfiresuite.com */
+    baseUrl: string;
+    /** Bearer token provider. For app-to-app calls this is a system token minted
+     *  for the tenant — never an impersonated end user. */
+    getToken: () => string | Promise<string>;
+    /** Request timeout in ms. Default 30_000. */
+    timeout?: number;
+}
+/** bom's response envelope. */
+export interface BomEnvelope<T> {
+    data: T;
+    meta: {
+        requestId: string;
+        timestamp: string;
+    };
+}
+export type BomTypeName = 'EBOM' | 'CBOM' | 'MBOM';
+export type SourcingType = 'make' | 'buy' | 'subcontract';
+/**
+ * Which BOM, version and lens produced this answer.
+ *
+ * Not decoration: resolution is a GUESS bom makes on the caller's behalf (the
+ * latest Active version of the one project that matched), and a consumer is
+ * expected to SHOW this so a reader can check it. Resolution is also live — the
+ * same call can answer differently once a new version is imported, which is
+ * what `resolvedAt` is for.
+ */
+export interface BomProvenance {
+    bomId: string;
+    bomType: BomTypeName;
+    versionId: string;
+    versionNumber: number;
+    versionLabel: string | null;
+    versionState: string | null;
+    projectId: string;
+    projectCode: string;
+    projectName: string;
+    /** Master-data Program UUID, when the project is linked to one. */
+    programId: string | null;
+    nodeId: string;
+    /** ISO timestamp of the lookup itself. */
+    resolvedAt: string;
+}
+/** One project a part number turned up in, when the reference was ambiguous. */
+export interface AmbiguousProject {
+    projectId: string;
+    projectCode: string;
+    projectName: string;
+    programId: string | null;
+    bomType: BomTypeName;
+    versionNumber: number;
+}
+export type MakeBuy = 'make' | 'buy';
+export type CostSource = 'import' | 'reimport' | 'manual';
+/** Why a value is soft: computed from tenant defaults rather than real data.
+ *  A consumer MUST surface this — presenting a defaulted number as a routed one
+ *  is the misuse the field exists to prevent. */
+export type CostBasis = 'default-process' | 'default-rate';
+export interface RateSet {
+    materialRatePerKg: number;
+    scrapPct: number;
+    purchasedScrapPct: number;
+    laborRatePerHr: number;
+    operators: number;
+    setupHrs: number;
+    cycleTimeSec: number;
+    yieldPct: number;
+    machineRatePerHr: number;
+    factoryOhPct: number;
+    materialHandlingPerKg: number;
+    sgaPct: number;
+    packagingPerPc: number;
+    freightPerPc: number;
+}
+export interface CostItem {
+    key: string;
+    name: string;
+    /** e.g. "$/pc" */
+    uom: string;
+    /** Decimal MAJOR units (dollars), never cents. */
+    value: number;
+    formula?: string;
+    /** Present only when the value is a tenant-default estimate. Render it. */
+    basis?: CostBasis;
+}
+export interface CostCategory {
+    /** MAT | PP | LAB | MOH | SGA | FP */
+    code: string;
+    name: string;
+    items: CostItem[];
+    subtotal: number;
+}
+export interface CostModelMeta {
+    computedAt: string;
+    source: CostSource;
+    currency: string;
+    moneyUnit: 'major';
+    ratesAsOf: string;
+    ratesFingerprint: string;
+}
+export interface CostModel {
+    version: 1;
+    meta: CostModelMeta;
+    makeBuy: MakeBuy;
+    /** True when this node's cost is a rollup of its children (assembly). */
+    rolledUp: boolean;
+    inputs: {
+        weightKg: number | null;
+        buyPricePerPc: number | null;
+        qty: number;
+        material: string | null;
+    };
+    rates: RateSet;
+    categories: CostCategory[];
+    pieceCost: number;
+    /** Written for humans and safe to render verbatim. Includes the one that
+     *  matters most to an upload-driven tenant: "buy part X has no unit cost;
+     *  purchased cost = 0" — a silent zero reads as free. */
+    warnings: string[];
+}
+export interface CostBreakdown {
+    resolved: true;
+    partNumber: string;
+    name: string;
+    sourcingType: SourcingType | null;
+    quantity: number;
+    costCents: number | null;
+    /** null when the node exists but was never costed — NOT the same as the part
+     *  being absent from every BOM. */
+    costModel: CostModel | null;
+    provenance: BomProvenance;
+}
+export interface RoutingStep {
+    id: string;
+    stepNumber: number;
+    process: string;
+    cycleTimeSec: number | null;
+    /** Coerced from the wire's Decimal string. */
+    yieldPct: number | null;
+    equipment: string | null;
+    qualityMethod: string | null;
+    plantId: string | null;
+    plantCode: string | null;
+    plantName: string | null;
+}
+export interface Routing {
+    resolved: true;
+    partNumber: string;
+    steps: RoutingStep[];
+    /** Always an MBOM version — routing's single storage home. May be a different
+     *  version (even a different lens) than the cost answer for the same part. */
+    provenance: BomProvenance;
+}
+/** Why a part reference produced no answer. `not-found` = no Active BOM
+ *  anywhere holds it. `ambiguous` = it is in several projects; re-ask with
+ *  `projectId` or `programId`. */
+export interface Unresolved {
+    resolved: false;
+    reason: 'not-found' | 'ambiguous';
+    partNumber: string | null;
+    partRevisionId: string | null;
+    /** Present when reason is 'ambiguous'. */
+    candidates?: AmbiguousProject[];
+}
+export type CostBreakdownResult = CostBreakdown | Unresolved;
+export type RoutingResult = Routing | Unresolved;
+/**
+ * How to address a part. One of `partNumber` / `partRevisionId` is required;
+ * `partRevisionId` (the canonical master-data PartRevision) is the stronger
+ * join where the caller has one.
+ *
+ * `projectId` / `programId` disambiguate a part number that recurs across
+ * projects. An OMSF quote has the program, so pass `programId` by default.
+ */
+export interface PartLookup {
+    partNumber?: string;
+    partRevisionId?: string;
+    projectId?: string;
+    programId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,11 @@
+"use strict";
+// =============================================================================
+// Wire types for the BOM read contract.
+//
+// THE STANDING TRAP: `CostModel` and its sub-types below are a HAND-MIRROR of
+// app/backend/src/modules/costing/costModel.types.ts. Nothing enforces that they
+// agree — the backend is a separate build. Change one, change the other, and
+// publish. (Same discipline as master-data-client's hand-mirrored Prisma enums.)
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,wCAAwC;AACxC,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,6EAA6E;AAC7E,iFAAiF;AACjF,gFAAgF"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@campfire-interactive/bom-client",
+  "version": "0.1.1",
+  "description": "TypeScript client for the BOM read contract — resolved cost breakdowns and routing by part reference",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Campfire-Interactive/packages.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.7"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}