@campfire-interactive/volume-intelligence-client 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import { ProgramsResource } from './programs';
+import type { VolumeIntelligenceClientConfig } from './types';
+/**
+ * Client for Volume Intelligence — the platform's canonical volume data plane
+ * (2026-06-11 data-plane ADR). Consumers (OMSF first; cashflow/capex later)
+ * read volume through this rather than keeping their own copies.
+ *
+ *   const vi = new VolumeIntelligenceClient({
+ *     baseUrl: process.env.FORECAST_BASE_URL!,
+ *     getToken: () => getSystemTokenForTenant(tenantId, 'forecast'),
+ *   });
+ *   const programs = await vi.programs.listActive({ minForwardAnnual: 1000 });
+ */
+export declare class VolumeIntelligenceClient {
+    readonly programs: ProgramsResource;
+    constructor(config: VolumeIntelligenceClientConfig);
+}
+//# 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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAExB,MAAM,EAAE,8BAA8B;CAInD"}

package/dist/client.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeIntelligenceClient = void 0;
+const http_1 = require("./http");
+const programs_1 = require("./programs");
+/**
+ * Client for Volume Intelligence — the platform's canonical volume data plane
+ * (2026-06-11 data-plane ADR). Consumers (OMSF first; cashflow/capex later)
+ * read volume through this rather than keeping their own copies.
+ *
+ *   const vi = new VolumeIntelligenceClient({
+ *     baseUrl: process.env.FORECAST_BASE_URL!,
+ *     getToken: () => getSystemTokenForTenant(tenantId, 'forecast'),
+ *   });
+ *   const programs = await vi.programs.listActive({ minForwardAnnual: 1000 });
+ */
+class VolumeIntelligenceClient {
+    programs;
+    constructor(config) {
+        const http = new http_1.HttpTransport(config);
+        this.programs = new programs_1.ProgramsResource(http);
+    }
+}
+exports.VolumeIntelligenceClient = VolumeIntelligenceClient;
+//# 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,yCAA8C;AAG9C;;;;;;;;;;GAUG;AACH,MAAa,wBAAwB;IAC1B,QAAQ,CAAmB;IAEpC,YAAY,MAAsC;QAChD,MAAM,IAAI,GAAG,IAAI,oBAAa,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAgB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AAPD,4DAOC"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class VolumeIntelligenceError 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 VolumeIntelligenceError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class UnauthorizedError extends VolumeIntelligenceError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class ForbiddenError extends VolumeIntelligenceError {
+    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":"AAIA,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,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,uBAAuB;gBAC5C,OAAO,SAAuB,EAAE,SAAS,CAAC,EAAE,MAAM;CAG/D;AAED,qBAAa,iBAAkB,SAAQ,uBAAuB;gBAChD,OAAO,SAAiB,EAAE,SAAS,CAAC,EAAE,MAAM;CAGzD;AAED,qBAAa,cAAe,SAAQ,uBAAuB;gBAC7C,OAAO,SAAc,EAAE,SAAS,CAAC,EAAE,MAAM;CAGtD"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+"use strict";
+// =============================================================================
+// Client-side error hierarchy — mirrors the backend's AppError shape.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForbiddenError = exports.UnauthorizedError = exports.NotFoundError = exports.VolumeIntelligenceError = void 0;
+class VolumeIntelligenceError 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.VolumeIntelligenceError = VolumeIntelligenceError;
+class NotFoundError extends VolumeIntelligenceError {
+    constructor(message = 'Resource not found', requestId) {
+        super(message, 404, 'NOT_FOUND', requestId);
+    }
+}
+exports.NotFoundError = NotFoundError;
+class UnauthorizedError extends VolumeIntelligenceError {
+    constructor(message = 'Unauthorized', requestId) {
+        super(message, 401, 'UNAUTHORIZED', requestId);
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+class ForbiddenError extends VolumeIntelligenceError {
+    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,gFAAgF;;;AAEhF,MAAa,uBAAwB,SAAQ,KAAK;IACvC,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,0DAYC;AAED,MAAa,aAAc,SAAQ,uBAAuB;IACxD,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,uBAAuB;IAC5D,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,uBAAuB;IACzD,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,21 @@
+import type { VolumeIntelligenceClientConfig } from './types';
+interface HttpRequestOptions {
+    method: 'GET' | 'POST';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | undefined>;
+}
+/** Auth-aware fetch transport. Mirrors master-data-client / cfi-ai-hub-client:
+ *  `{ baseUrl, getToken, timeout }`, bearer-token injection, timeout via
+ *  AbortController, and status→error mapping. Read-focused for v0.1. */
+export declare class HttpTransport {
+    private readonly baseUrl;
+    private readonly getToken;
+    private readonly timeout;
+    constructor(config: VolumeIntelligenceClientConfig);
+    request<T>(options: HttpRequestOptions): Promise<T>;
+    private buildUrl;
+    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,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAK9D,UAAU,kBAAkB;IAC1B,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,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;;wEAEwE;AACxE,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,8BAA8B;IAM5C,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IA2CzD,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/http.js

@@ -0,0 +1,83 @@
+"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 master-data-client / cfi-ai-hub-client:
+ *  `{ baseUrl, getToken, timeout }`, bearer-token injection, timeout via
+ *  AbortController, and status→error mapping. Read-focused for v0.1. */
+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 = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        };
+        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.VolumeIntelligenceError('Request timed out', 0, 'TIMEOUT');
+            }
+            throw new errors_1.VolumeIntelligenceError(`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();
+    }
+    throwForStatus(status, body) {
+        const errorBody = body;
+        const rawError = errorBody?.error;
+        const message = typeof rawError === 'string' ? rawError : rawError?.message || `Request failed with status ${status}`;
+        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.VolumeIntelligenceError(message, status, typeof rawError === 'object' ? rawError?.code || 'UNKNOWN_ERROR' : 'UNKNOWN_ERROR', 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,6 @@
+export { VolumeIntelligenceClient } from './client';
+export { MockVolumeIntelligenceClient } from './mock';
+export { ProgramsResource } from './programs';
+export { VolumeIntelligenceError, NotFoundError, UnauthorizedError, ForbiddenError, } from './errors';
+export type { VolumeIntelligenceClientConfig, ProgramView, ProgramWithVolumes, MonthlyVolume, ListActiveProgramsOptions, ListProgramsForMatchingOptions, ProgramListResponse, } from './types';
+//# 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,wBAAwB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,8BAA8B,EAC9B,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,yBAAyB,EACzB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForbiddenError = exports.UnauthorizedError = exports.NotFoundError = exports.VolumeIntelligenceError = exports.ProgramsResource = exports.MockVolumeIntelligenceClient = exports.VolumeIntelligenceClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "VolumeIntelligenceClient", { enumerable: true, get: function () { return client_1.VolumeIntelligenceClient; } });
+var mock_1 = require("./mock");
+Object.defineProperty(exports, "MockVolumeIntelligenceClient", { enumerable: true, get: function () { return mock_1.MockVolumeIntelligenceClient; } });
+var programs_1 = require("./programs");
+Object.defineProperty(exports, "ProgramsResource", { enumerable: true, get: function () { return programs_1.ProgramsResource; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "VolumeIntelligenceError", { enumerable: true, get: function () { return errors_1.VolumeIntelligenceError; } });
+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,mCAAoD;AAA3C,kHAAA,wBAAwB,OAAA;AACjC,+BAAsD;AAA7C,oHAAA,4BAA4B,OAAA;AACrC,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AACzB,mCAKkB;AAJhB,iHAAA,uBAAuB,OAAA;AACvB,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA;AACjB,wGAAA,cAAc,OAAA"}

package/dist/mock.d.ts

@@ -0,0 +1,16 @@
+import type { ProgramView, ProgramWithVolumes, ListActiveProgramsOptions, ListProgramsForMatchingOptions } from './types';
+declare class MockProgramsResource {
+    private programs;
+    constructor(programs: ProgramWithVolumes[]);
+    seed(programs: ProgramWithVolumes[]): void;
+    getAll(): ProgramWithVolumes[];
+    listActive(options?: ListActiveProgramsOptions): Promise<ProgramView[]>;
+    listForMatching(options?: ListProgramsForMatchingOptions): Promise<ProgramWithVolumes[]>;
+}
+export declare class MockVolumeIntelligenceClient {
+    readonly programs: MockProgramsResource;
+    constructor(seed?: ProgramWithVolumes[]);
+    reset(): void;
+}
+export {};
+//# 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,WAAW,EACX,kBAAkB,EAElB,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AA+BjB,cAAM,oBAAoB;IACZ,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,kBAAkB,EAAE;IAElD,IAAI,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAI1C,MAAM,IAAI,kBAAkB,EAAE;IAIxB,UAAU,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWvE,eAAe,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAS/F;AAED,qBAAa,4BAA4B;IACvC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAE5B,IAAI,CAAC,EAAE,kBAAkB,EAAE;IAIvC,KAAK,IAAI,IAAI;CAGd"}

package/dist/mock.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockVolumeIntelligenceClient = void 0;
+/**
+ * In-memory mock for consumer unit tests (mirrors MockMasterDataClient /
+ * MockPriceIndexClient). Seed it with `ProgramWithVolumes` fixtures; the
+ * `ProgramView` projection (active filter + forward-annual) is derived the same
+ * way the real backend derives it.
+ */
+function thisMonth() {
+    const now = new Date();
+    return { year: now.getFullYear(), month: now.getMonth() + 1 };
+}
+function forwardAnnual(volumes) {
+    const start = thisMonth();
+    const startYM = start.year * 12 + (start.month - 1);
+    const endYM = startYM + 12;
+    return volumes
+        .filter((v) => {
+        const ym = v.year * 12 + (v.month - 1);
+        return ym >= startYM && ym < endYM;
+    })
+        .reduce((s, v) => s + v.volume, 0);
+}
+function isActive(eop) {
+    if (!eop)
+        return true;
+    return eop >= new Date().toISOString().slice(0, 10);
+}
+class MockProgramsResource {
+    programs;
+    constructor(programs) {
+        this.programs = programs;
+    }
+    seed(programs) {
+        this.programs = programs;
+    }
+    getAll() {
+        return this.programs;
+    }
+    async listActive(options) {
+        const min = options?.minForwardAnnual ?? 0;
+        return this.programs
+            .filter((p) => isActive(p.eop))
+            .map((p) => {
+            const { monthlyVolumes, ...rest } = p;
+            return { ...rest, forwardAnnualVolume: forwardAnnual(monthlyVolumes) };
+        })
+            .filter((p) => p.forwardAnnualVolume >= min);
+    }
+    async listForMatching(options) {
+        const nameplate = options?.nameplate?.toLowerCase();
+        const oem = options?.oem?.toLowerCase();
+        return this.programs.filter((p) => {
+            if (nameplate && !p.nameplate.toLowerCase().includes(nameplate))
+                return false;
+            if (oem && !p.oem.toLowerCase().includes(oem) && !p.manufacturerGroup.toLowerCase().includes(oem))
+                return false;
+            return true;
+        });
+    }
+}
+class MockVolumeIntelligenceClient {
+    programs;
+    constructor(seed) {
+        this.programs = new MockProgramsResource(seed ?? []);
+    }
+    reset() {
+        this.programs.seed([]);
+    }
+}
+exports.MockVolumeIntelligenceClient = MockVolumeIntelligenceClient;
+//# 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/programs.d.ts

@@ -0,0 +1,18 @@
+import type { HttpTransport } from './http';
+import type { ProgramView, ProgramWithVolumes, ListActiveProgramsOptions, ListProgramsForMatchingOptions } from './types';
+/**
+ * Program reads. The projection turns VI's internal weekly/criteria model into
+ * the program-shaped, monthly view consumers expect (see the backend
+ * programViewService). Tenant scope comes from the caller's token.
+ */
+export declare class ProgramsResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /** Active programs (EOP null or future) with their 12-month forward-annual
+     *  volume. Bulk read for OMSF's unengaged-opportunity sync. */
+    listActive(options?: ListActiveProgramsOptions): Promise<ProgramView[]>;
+    /** Candidate programs + monthly curves for consumer-side matching (e.g.
+     *  OMSF's per-quote forecast). `nameplate`/`oem` coarse-filter the payload. */
+    listForMatching(options?: ListProgramsForMatchingOptions): Promise<ProgramWithVolumes[]>;
+}
+//# sourceMappingURL=programs.d.ts.map

package/dist/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../src/programs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,8BAA8B,EAE/B,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;mEAC+D;IACzD,UAAU,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAa7E;mFAC+E;IACzE,eAAe,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAY/F"}

package/dist/programs.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgramsResource = void 0;
+/**
+ * Program reads. The projection turns VI's internal weekly/criteria model into
+ * the program-shaped, monthly view consumers expect (see the backend
+ * programViewService). Tenant scope comes from the caller's token.
+ */
+class ProgramsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Active programs (EOP null or future) with their 12-month forward-annual
+     *  volume. Bulk read for OMSF's unengaged-opportunity sync. */
+    async listActive(options) {
+        const query = { activeOnly: 'true' };
+        if (options?.minForwardAnnual !== undefined) {
+            query.minForwardAnnual = String(options.minForwardAnnual);
+        }
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/v1/programs',
+            query,
+        });
+        return res.items;
+    }
+    /** Candidate programs + monthly curves for consumer-side matching (e.g.
+     *  OMSF's per-quote forecast). `nameplate`/`oem` coarse-filter the payload. */
+    async listForMatching(options) {
+        const query = {
+            nameplate: options?.nameplate,
+            oem: options?.oem,
+        };
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/v1/programs/candidates',
+            query,
+        });
+        return res.items;
+    }
+}
+exports.ProgramsResource = ProgramsResource;
+//# sourceMappingURL=programs.js.map

package/dist/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../src/programs.ts"],"names":[],"mappings":";;;AASA;;;;GAIG;AACH,MAAa,gBAAgB;IACE;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;mEAC+D;IAC/D,KAAK,CAAC,UAAU,CAAC,OAAmC;QAClD,MAAM,KAAK,GAAuC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACzE,IAAI,OAAO,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC5C,KAAK,CAAC,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmC;YACpE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc;YACpB,KAAK;SACN,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED;mFAC+E;IAC/E,KAAK,CAAC,eAAe,CAAC,OAAwC;QAC5D,MAAM,KAAK,GAAuC;YAChD,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,GAAG,EAAE,OAAO,EAAE,GAAG;SAClB,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAA0C;YAC3E,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB;YAC/B,KAAK;SACN,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;CACF;AAhCD,4CAgCC"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export interface VolumeIntelligenceClientConfig {
+    /** Full base URL of the Volume Intelligence (forecast) API, e.g.
+     *  `https://api.forecast.campfiresuite.com`. */
+    baseUrl: string;
+    /** Async or sync provider returning a platform-identity JWT. Backends pass a
+     *  system token minted for the tenant (audience `forecast`); browsers pass a
+     *  BrowserAuth token. */
+    getToken: () => string | Promise<string>;
+    /** Request timeout in milliseconds. Defaults to 30_000. */
+    timeout?: number;
+}
+export interface MonthlyVolume {
+    year: number;
+    month: number;
+    volume: number;
+}
+/**
+ * A production program projected for bulk consumers (OMSF's unengaged-opp
+ * sync). `programKey` is a stable identifier — consumers may key derived
+ * records (e.g. opportunity numbers) off it, so it is stable across reads.
+ * `forwardAnnualVolume` is the sum of the next 12 months of the adjusted
+ * (campfire + analyst-edited) curve.
+ */
+export interface ProgramView {
+    programKey: string;
+    oem: string;
+    manufacturerGroup: string;
+    programName: string;
+    nameplate: string;
+    plant: string;
+    city: string;
+    region: string;
+    sop: string | null;
+    eop: string | null;
+    forwardAnnualVolume: number;
+}
+/**
+ * A program plus its full monthly volume curve. Consumers that run their own
+ * matching (e.g. OMSF's per-quote forecast) read these candidates and score
+ * them client-side.
+ */
+export interface ProgramWithVolumes {
+    programKey: string;
+    oem: string;
+    manufacturerGroup: string;
+    programName: string;
+    nameplate: string;
+    plant: string;
+    city: string;
+    region: string;
+    sop: string | null;
+    eop: string | null;
+    monthlyVolumes: MonthlyVolume[];
+}
+export interface ListActiveProgramsOptions {
+    /** Only return programs whose 12-month forward volume is at least this. */
+    minForwardAnnual?: number;
+}
+export interface ListProgramsForMatchingOptions {
+    /** Coarse server-side pre-filters to bound payload. Consumers still apply
+     *  their own match logic over the returned candidates. */
+    nameplate?: string;
+    oem?: string;
+}
+/** List envelope returned by the program reads. */
+export interface ProgramListResponse<T> {
+    items: T[];
+}
+//# 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":"AAAA,MAAM,WAAW,8BAA8B;IAC7C;oDACgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB;;6BAEyB;IACzB,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C;8DAC0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+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":""}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@campfire-interactive/volume-intelligence-client",
+  "version": "0.1.0",
+  "description": "TypeScript client for Volume Intelligence (the platform's volume data plane)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "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"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}