@campfire-interactive/volume-intelligence-client 0.1.1 → 0.4.0

package/dist/sources.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentsResource = exports.SourcesResource = void 0;
+const http_1 = require("./http");
+/**
+ * Volume-source admin reads/writes — the source list, source detail, the
+ * template catalogue, and the per-source data-clear. Mirrors forecast's
+ * `/v1/admin/sources*` REST 1:1. Tenant scope comes from the caller's token.
+ *
+ * NOTE: `detectSegments` (multipart) and the human upload live on
+ * `UploadsResource` / a Phase-2 multipart path, not here.
+ */
+class SourcesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list() {
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/v1/admin/sources',
+        });
+        return res.data;
+    }
+    async get(id) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/admin/sources/${id}`,
+        });
+        return res.data;
+    }
+    async create(data) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: '/v1/admin/sources',
+            body: data,
+        });
+        return res.data;
+    }
+    async update(id, data) {
+        const res = await this.http.request({
+            method: 'PUT',
+            path: `/v1/admin/sources/${id}`,
+            body: data,
+        });
+        return res.data;
+    }
+    /** Make this the tenant's active base source. Wipes prior base data when the
+     *  backend deems it necessary — `wiped` reports whether it did. */
+    async activate(id) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: `/v1/admin/sources/${id}/activate`,
+        });
+        return res.data;
+    }
+    // ── Templates ──────────────────────────────────────────────────────────────
+    async listTemplates() {
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/v1/admin/sources/templates',
+        });
+        return res.data;
+    }
+    async createFromTemplate(templateCode) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: '/v1/admin/sources/from-template',
+            body: { templateCode },
+        });
+        return res.data;
+    }
+    // ── Data clear (typed-confirm gate; backend 400s unless confirm === 'DELETE') ─
+    async clearData(sourceId, confirm) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: `/v1/admin/sources/${sourceId}/clear-data`,
+            body: { confirm },
+        });
+        return res.data;
+    }
+}
+exports.SourcesResource = SourcesResource;
+/**
+ * Source segment (column) admin — list / create / delete / detect.
+ */
+class SegmentsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list(sourceId) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/admin/sources/${sourceId}/segments`,
+        });
+        return res.data;
+    }
+    /** Auto-detect a source's columns from a sample workbook (multipart). Reads
+     *  the source's configured header row; reports how many segments were added
+     *  vs. already present. */
+    async detectSegments(sourceId, file) {
+        const { blob, fileName } = (0, http_1.toFilePart)(file);
+        const form = new FormData();
+        form.append('file', blob, fileName);
+        const res = await this.http.requestMultipart({
+            path: `/v1/admin/sources/${sourceId}/detect-segments`,
+            form,
+        });
+        return res.data;
+    }
+    async create(sourceId, input) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: `/v1/admin/sources/${sourceId}/segments`,
+            body: input,
+        });
+        return res.data;
+    }
+    async delete(segmentId) {
+        await this.http.request({
+            method: 'DELETE',
+            path: `/v1/admin/segments/${segmentId}`,
+        });
+    }
+}
+exports.SegmentsResource = SegmentsResource;
+//# sourceMappingURL=sources.js.map

package/dist/sources.js.map

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

package/dist/types.d.ts

@@ -55,12 +55,21 @@ export interface ProgramWithVolumes {
 export interface ListActiveProgramsOptions {
     /** Only return programs whose 12-month forward volume is at least this. */
     minForwardAnnual?: number;
+    /** When `false`, return the RAW source projection — programs straight from the
+     *  active base source's uploaded volume + level/automotive-field identity, with
+     *  no cfi-ai-hub binding and no prediction (campfire) dependency. Defaults to
+     *  `true` (the analytical, reconciled projection). Consumers that only need
+     *  "production programs + volume + OEM/nameplate" (e.g. OMSF's unengaged-opp
+     *  sync) pass `false` so the read works without the analytical layer. */
+    reconciled?: boolean;
 }
 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;
+    /** See `ListActiveProgramsOptions.reconciled`. Defaults to `true`. */
+    reconciled?: boolean;
 }
 /** Forecast wraps every handler return in `{ data, meta }`. */
 export interface ForecastEnvelope<T> {

package/dist/types.d.ts.map

@@ -1 +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,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ"}
+{"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;IAC1B;;;;;6EAKyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C;8DAC0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ"}

package/dist/uploads.d.ts

@@ -0,0 +1,27 @@
+import type { HttpTransport, UploadFileInput } from './http';
+import type { Upload, CreateUploadInput, UploadListParams, UploadListResponse, UploadWithErrors, UploadErrorListParams, UploadErrorListResponse } from './adminTypes';
+/**
+ * Uploads — create (multipart human upload), reads, reprocess, download.
+ * Mirrors forecast's `/v1/uploads*` REST. The programmatic API import
+ * (`POST /v1/uploads/api` presign flow) is `import()` (Phase 2b).
+ */
+export declare class UploadsResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /** Upload a workbook for ingestion (`POST /v1/uploads`, multipart). Returns
+     *  the created `Upload` (status `pending`); poll `get(id)` for progress.
+     *  A consumer backend proxy passes the received file buffer as
+     *  `{ data: req.file.buffer, fileName: req.file.originalname }`. */
+    create(file: UploadFileInput, input: CreateUploadInput): Promise<Upload>;
+    list(params?: UploadListParams): Promise<UploadListResponse>;
+    /** A single upload with its errors inlined (the detail view). */
+    get(id: string): Promise<UploadWithErrors>;
+    errors(id: string, params?: UploadErrorListParams): Promise<UploadErrorListResponse>;
+    reprocess(id: string): Promise<{
+        id: string;
+        status: string;
+    }>;
+    /** A short-lived presigned URL to download the originally-uploaded file. */
+    downloadUrl(id: string): Promise<string>;
+}
+//# sourceMappingURL=uploads.d.ts.map

package/dist/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG7D,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;wEAGoE;IAC9D,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBxE,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgBlE,iEAAiE;IAC3D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ1C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAapF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQpE,4EAA4E;IACtE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAO/C"}

package/dist/uploads.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadsResource = void 0;
+const http_1 = require("./http");
+/**
+ * Uploads — create (multipart human upload), reads, reprocess, download.
+ * Mirrors forecast's `/v1/uploads*` REST. The programmatic API import
+ * (`POST /v1/uploads/api` presign flow) is `import()` (Phase 2b).
+ */
+class UploadsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Upload a workbook for ingestion (`POST /v1/uploads`, multipart). Returns
+     *  the created `Upload` (status `pending`); poll `get(id)` for progress.
+     *  A consumer backend proxy passes the received file buffer as
+     *  `{ data: req.file.buffer, fileName: req.file.originalname }`. */
+    async create(file, input) {
+        const { blob, fileName } = (0, http_1.toFilePart)(file);
+        const form = new FormData();
+        form.append('file', blob, fileName);
+        form.append('sourceId', input.sourceId);
+        if (input.uploadYear !== undefined)
+            form.append('uploadYear', String(input.uploadYear));
+        if (input.uploadMonth !== undefined)
+            form.append('uploadMonth', String(input.uploadMonth));
+        if (input.actualsLagMonths !== undefined) {
+            form.append('actualsLagMonths', String(input.actualsLagMonths));
+        }
+        const res = await this.http.requestMultipart({
+            path: '/v1/uploads',
+            form,
+        });
+        return res.data;
+    }
+    async list(params) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: '/v1/uploads',
+            query: {
+                limit: params?.limit !== undefined ? String(params.limit) : undefined,
+                offset: params?.offset !== undefined ? String(params.offset) : undefined,
+                status: params?.status,
+                sourceId: params?.sourceId,
+                year: params?.year !== undefined ? String(params.year) : undefined,
+                month: params?.month !== undefined ? String(params.month) : undefined,
+            },
+        });
+        return res.data;
+    }
+    /** A single upload with its errors inlined (the detail view). */
+    async get(id) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/uploads/${id}`,
+        });
+        return res.data;
+    }
+    async errors(id, params) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/uploads/${id}/errors`,
+            query: {
+                limit: params?.limit !== undefined ? String(params.limit) : undefined,
+                offset: params?.offset !== undefined ? String(params.offset) : undefined,
+                errorType: params?.errorType,
+            },
+        });
+        return res.data;
+    }
+    async reprocess(id) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: `/v1/uploads/${id}/reprocess`,
+        });
+        return res.data;
+    }
+    /** A short-lived presigned URL to download the originally-uploaded file. */
+    async downloadUrl(id) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/uploads/${id}/download`,
+        });
+        return res.data.url;
+    }
+}
+exports.UploadsResource = UploadsResource;
+//# sourceMappingURL=uploads.js.map

package/dist/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":";;;AACA,iCAAoC;AAYpC;;;;GAIG;AACH,MAAa,eAAe;IACG;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;wEAGoE;IACpE,KAAK,CAAC,MAAM,CAAC,IAAqB,EAAE,KAAwB;QAC1D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAA,iBAAU,EAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACxF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3F,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAA2B;YACrE,IAAI,EAAE,aAAa;YACnB,IAAI;SACL,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuC;YACxE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE;gBACL,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBACrE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxE,MAAM,EAAE,MAAM,EAAE,MAAM;gBACtB,QAAQ,EAAE,MAAM,EAAE,QAAQ;gBAC1B,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAClE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;aACtE;SACF,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqC;YACtE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,EAAE,EAAE;SAC1B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA8B;QACrD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAA4C;YAC7E,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,EAAE,SAAS;YAChC,KAAK,EAAE;gBACL,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBACrE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxE,SAAS,EAAE,MAAM,EAAE,SAAS;aAC7B;SACF,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmD;YACpF,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,EAAE,YAAY;SACpC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoC;YACrE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,EAAE,WAAW;SACnC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;IACtB,CAAC;CACF;AA9ED,0CA8EC"}

package/dist/valueAliases.d.ts

@@ -0,0 +1,21 @@
+import type { HttpTransport } from './http';
+import type { SourceValueAlias, ValueAliasEntry, RelinkResult } from './adminTypes';
+/**
+ * Per-source, per-level value normalisation (raw → canonical) plus the
+ * overlay→base relink. Mirrors forecast's `/v1/admin/sources/:id/value-aliases*`
+ * and `/relink` REST.
+ */
+export declare class ValueAliasesResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    list(sourceId: string): Promise<SourceValueAlias[]>;
+    /** Bulk-replace every alias at a level for the source — send the full desired
+     *  set; the backend wipes that level's rows and inserts the new ones in one
+     *  transaction. */
+    replaceLevel(sourceId: string, level: number, entries: ValueAliasEntry[]): Promise<SourceValueAlias[]>;
+    delete(aliasId: string): Promise<void>;
+    /** Re-run overlay→base link resolution against the tenant's current active
+     *  base without a re-upload (e.g. after editing aliases). Idempotent. */
+    relink(sourceId: string): Promise<RelinkResult>;
+}
+//# sourceMappingURL=valueAliases.d.ts.map

package/dist/valueAliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueAliases.d.ts","sourceRoot":"","sources":["../src/valueAliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQzD;;uBAEmB;IACb,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IASxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;6EACyE;IACnE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAOtD"}

package/dist/valueAliases.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueAliasesResource = void 0;
+/**
+ * Per-source, per-level value normalisation (raw → canonical) plus the
+ * overlay→base relink. Mirrors forecast's `/v1/admin/sources/:id/value-aliases*`
+ * and `/relink` REST.
+ */
+class ValueAliasesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list(sourceId) {
+        const res = await this.http.request({
+            method: 'GET',
+            path: `/v1/admin/sources/${sourceId}/value-aliases`,
+        });
+        return res.data.items;
+    }
+    /** Bulk-replace every alias at a level for the source — send the full desired
+     *  set; the backend wipes that level's rows and inserts the new ones in one
+     *  transaction. */
+    async replaceLevel(sourceId, level, entries) {
+        const res = await this.http.request({
+            method: 'PUT',
+            path: `/v1/admin/sources/${sourceId}/value-aliases/${level}`,
+            body: { entries },
+        });
+        return res.data.items;
+    }
+    async delete(aliasId) {
+        await this.http.request({
+            method: 'DELETE',
+            path: `/v1/admin/value-aliases/${aliasId}`,
+        });
+    }
+    /** Re-run overlay→base link resolution against the tenant's current active
+     *  base without a re-upload (e.g. after editing aliases). Idempotent. */
+    async relink(sourceId) {
+        const res = await this.http.request({
+            method: 'POST',
+            path: `/v1/admin/sources/${sourceId}/relink`,
+        });
+        return res.data;
+    }
+}
+exports.ValueAliasesResource = ValueAliasesResource;
+//# sourceMappingURL=valueAliases.js.map

package/dist/valueAliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueAliases.js","sourceRoot":"","sources":["../src/valueAliases.ts"],"names":[],"mappings":";;;AAQA;;;;GAIG;AACH,MAAa,oBAAoB;IACF;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkD;YACnF,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB,QAAQ,gBAAgB;SACpD,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;IACxB,CAAC;IAED;;uBAEmB;IACnB,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,KAAa,EACb,OAA0B;QAE1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkD;YACnF,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB,QAAQ,kBAAkB,KAAK,EAAE;YAC5D,IAAI,EAAE,EAAE,OAAO,EAAE;SAClB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAO;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,2BAA2B,OAAO,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;IAED;6EACyE;IACzE,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiC;YAClE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,qBAAqB,QAAQ,SAAS;SAC7C,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;CACF;AA3CD,oDA2CC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campfire-interactive/volume-intelligence-client",
-  "version": "0.1.1",
+  "version": "0.4.0",
   "description": "TypeScript client for Volume Intelligence (the platform's volume data plane)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",