@campfire-interactive/master-data-client 5.0.0 → 5.3.0

package/dist/rates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/F;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAoB/E;;;OAGG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;CASrE"}
+{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EACjE,iBAAiB,EAAE,cAAc,EAClC,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAoB/E;;;OAGG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAUpE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;CAOvF"}

package/dist/rates.js

@@ -54,6 +54,24 @@ class RatesResource {
             query,
         });
     }
+    /**
+     * Cutover maintenance: move `RateElement.plantId` (and the `identityKey`
+     * derived from it) off a consumer's own plant uuids and onto master-data's.
+     * Needed exactly once per tenant, when that consumer stops owning plants.
+     *
+     * **Defaults to a dry run.** Call it without `dryRun:false` first and read
+     * `distinctPlantIds[].classification` — that is how you find out whether an
+     * environment needs the move at all, rather than assuming.
+     *
+     * Requires owner/admin (or a system principal).
+     */
+    async rekeyPlants(input) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rates/rekey-plants',
+            body: input,
+        });
+    }
 }
 exports.RatesResource = RatesResource;
 //# sourceMappingURL=rates.js.map

package/dist/rates.js.map

@@ -1 +1 @@
-{"version":3,"file":"rates.js","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,KAAsB;QACjC,MAAM,KAAK,GAAuC,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,UAAU;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1D,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjD,IAAI,KAAK,CAAC,aAAa;YAAE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QACnE,IAAI,KAAK,CAAC,WAAW;YAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7D,IAAI,KAAK,CAAC,UAAU;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1D,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACvD,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACvD,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmC;YACzD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB;YACxB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAa;QAC1B,MAAM,KAAK,GAAuC,EAAE,CAAC;QACrD,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA+B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB;YAC1B,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AApCD,sCAoCC"}
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":";;;AAMA;;;GAGG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,KAAsB;QACjC,MAAM,KAAK,GAAuC,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,UAAU;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1D,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjD,IAAI,KAAK,CAAC,aAAa;YAAE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QACnE,IAAI,KAAK,CAAC,WAAW;YAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7D,IAAI,KAAK,CAAC,UAAU;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1D,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACvD,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACvD,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmC;YACzD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB;YACxB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAa;QAC1B,MAAM,KAAK,GAAuC,EAAE,CAAC;QACrD,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA+B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB;YAC1B,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoC;YAC1D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;CACF;AAvDD,sCAuDC"}

package/dist/regions.d.ts

@@ -1,5 +1,17 @@
 import { HttpTransport } from './http';
 import type { Region, CreateRegionInput, UpdateRegionInput, SingleResponse, ListResponse, CreateResponse } from './types';
+/**
+ * @deprecated Superseded by `geographicScopes` — the per-tenant catalog with a
+ * per-tenant alias. Do not build new consumers on this.
+ *
+ * Still served, and still correct for one thing only: keeping an existing
+ * `regionId` column fed while every environment catches up. New code that
+ * needs a geography should read `client.geographicScopes` and label it with
+ * `client.scopeDimensionSettings` — one tenant calls it Region, another
+ * Division, another Business Unit, and this list can express none of that.
+ *
+ * Removal is master-data docs/plans/2026-09-16-region-retirement.md phase C.
+ */
 export declare class RegionResource {
     private readonly http;
     constructor(http: HttpTransport);

package/dist/regions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAOrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAOhD,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAS1F,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAS5B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMxC"}
+{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAOrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAOhD,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAS1F,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAS5B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMxC"}

package/dist/regions.js

@@ -1,6 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RegionResource = void 0;
+/**
+ * @deprecated Superseded by `geographicScopes` — the per-tenant catalog with a
+ * per-tenant alias. Do not build new consumers on this.
+ *
+ * Still served, and still correct for one thing only: keeping an existing
+ * `regionId` column fed while every environment catches up. New code that
+ * needs a geography should read `client.geographicScopes` and label it with
+ * `client.scopeDimensionSettings` — one tenant calls it Region, another
+ * Division, another Business Unit, and this list can express none of that.
+ *
+ * Removal is master-data docs/plans/2026-09-16-region-retirement.md phase C.
+ */
 class RegionResource {
     http;
     constructor(http) {

package/dist/regions.js.map

@@ -1 +1 @@
-{"version":3,"file":"regions.js","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":";;;AAUA,MAAa,cAAc;IACI;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAwB,EAAE,cAAuB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAAwB,EACxB,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAC7C,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAY;YACjC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;CACF;AA7CD,wCA6CC"}
+{"version":3,"file":"regions.js","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":";;;AAUA;;;;;;;;;;;GAWG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAwB,EAAE,cAAuB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAAwB,EACxB,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB;YAC/C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAC7C,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAY;YACjC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;CACF;AA7CD,wCA6CC"}

package/dist/standardAttributes.d.ts

@@ -0,0 +1,25 @@
+import { HttpTransport } from './http';
+import type { StandardAttribute, UpdateStandardAttributeInput, StandardAttributeValue, SetStandardAttributeValueInput, SetStandardAttributeValueResult, StandardAttributeHistoryEntry, SingleResponse, ListResponse } from './types';
+export declare class StandardAttributeResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /** This tenant's attribute catalog, in display order. */
+    list(options?: {
+        enabledOnly?: boolean;
+    }): Promise<ListResponse<StandardAttribute>>;
+    /** Rename, reorder, enable or disable one attribute. `key` is immutable. */
+    update(id: string, input: UpdateStandardAttributeInput, idempotencyKey?: string): Promise<SingleResponse<StandardAttribute>>;
+    /** Every stored value on one quote, in catalog order. */
+    listValues(quoteId: string): Promise<ListResponse<StandardAttributeValue>>;
+    /**
+     * Write values on a quote.
+     *
+     * Send the whole set in one call rather than looping: the server writes them
+     * in a single transaction, and `onlyIfBlank` on each input is what makes the
+     * enrichment pass fill blanks without ever overwriting a rep's correction.
+     */
+    setValues(quoteId: string, values: SetStandardAttributeValueInput[], idempotencyKey?: string): Promise<ListResponse<SetStandardAttributeValueResult>>;
+    /** One attribute's timeline on a quote, or the whole quote's when no key. */
+    listHistory(quoteId: string, key?: string): Promise<ListResponse<StandardAttributeHistoryEntry>>;
+}
+//# sourceMappingURL=standardAttributes.d.ts.map

package/dist/standardAttributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardAttributes.d.ts","sourceRoot":"","sources":["../src/standardAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,EAC7B,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AASjB,qBAAa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD,yDAAyD;IACnD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAQzF,4EAA4E;IACtE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,4BAA4B,EACnC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAS7C,yDAAyD;IACnD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAOhF;;;;;;OAMG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,8BAA8B,EAAE,EACxC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;IASzD,6EAA6E;IACvE,WAAW,CACf,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;CAOxD"}

package/dist/standardAttributes.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardAttributeResource = void 0;
+// Standard Attributes: the platform-owned set of vehicle and program facts a
+// quote carries, each with the source it came from and a full change history.
+// See nextgen docs/decisions/2026-09-18-standard-attributes.md.
+//
+// The catalog is landlord-owned and provisioned per tenant, so there is no
+// create and no delete: a tenant renames or disables an attribute, it cannot
+// invent or destroy one.
+class StandardAttributeResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** This tenant's attribute catalog, in display order. */
+    async list(options) {
+        const query = options?.enabledOnly ? '?enabledOnly=true' : '';
+        return this.http.request({
+            method: 'GET',
+            path: `/v1/standard-attributes${query}`,
+        });
+    }
+    /** Rename, reorder, enable or disable one attribute. `key` is immutable. */
+    async update(id, input, idempotencyKey) {
+        return this.http.request({
+            method: 'PATCH',
+            path: `/v1/standard-attributes/${encodeURIComponent(id)}`,
+            body: input,
+            idempotencyKey,
+        });
+    }
+    /** Every stored value on one quote, in catalog order. */
+    async listValues(quoteId) {
+        return this.http.request({
+            method: 'GET',
+            path: `/v1/quotes/${encodeURIComponent(quoteId)}/standard-attributes`,
+        });
+    }
+    /**
+     * Write values on a quote.
+     *
+     * Send the whole set in one call rather than looping: the server writes them
+     * in a single transaction, and `onlyIfBlank` on each input is what makes the
+     * enrichment pass fill blanks without ever overwriting a rep's correction.
+     */
+    async setValues(quoteId, values, idempotencyKey) {
+        return this.http.request({
+            method: 'PUT',
+            path: `/v1/quotes/${encodeURIComponent(quoteId)}/standard-attributes`,
+            body: { values },
+            idempotencyKey,
+        });
+    }
+    /** One attribute's timeline on a quote, or the whole quote's when no key. */
+    async listHistory(quoteId, key) {
+        const query = key ? `?key=${encodeURIComponent(key)}` : '';
+        return this.http.request({
+            method: 'GET',
+            path: `/v1/quotes/${encodeURIComponent(quoteId)}/standard-attributes/history${query}`,
+        });
+    }
+}
+exports.StandardAttributeResource = StandardAttributeResource;
+//# sourceMappingURL=standardAttributes.js.map

package/dist/standardAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardAttributes.js","sourceRoot":"","sources":["../src/standardAttributes.ts"],"names":[],"mappings":";;;AAYA,6EAA6E;AAC7E,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,yBAAyB;AACzB,MAAa,yBAAyB;IACP;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,yDAAyD;IACzD,KAAK,CAAC,IAAI,CAAC,OAAmC;QAC5C,MAAM,KAAK,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkC;YACxD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,0BAA0B,KAAK,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAAmC,EACnC,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoC;YAC1D,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,2BAA2B,kBAAkB,CAAC,EAAE,CAAC,EAAE;YACzD,IAAI,EAAE,KAAK;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuC;YAC7D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,sBAAsB;SACtE,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,OAAe,EACf,MAAwC,EACxC,cAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAgD;YACtE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,sBAAsB;YACrE,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,WAAW,CACf,OAAe,EACf,GAAY;QAEZ,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA8C;YACpE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,+BAA+B,KAAK,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;CACF;AAjED,8DAiEC"}

package/dist/types.d.ts

@@ -1088,10 +1088,17 @@ export interface ListPlantsOptions {
     active?: boolean;
     country?: string;
     region?: string;
+    /** Relations to expand. Only `'equipment'` is supported. Forwarded as
+     *  `?include=` — the backend has honoured it since the plant/equipment
+     *  consolidation; the client simply dropped it until 5.1.0. Expanding
+     *  equipment turns a plant page plus a per-plant equipment call into one
+     *  request. */
+    include?: Array<'equipment'>;
 }
 export interface GetPlantOptions {
-    /** Reserved for future relation expansions; currently no-op. */
-    include?: string[];
+    /** Relations to expand. Only `'equipment'` is supported. Forwarded as
+     *  `?include=` from 5.1.0 — previously declared but never sent. */
+    include?: Array<'equipment'>;
 }
 export type PlantMatchType = 'exact_code' | 'trgm_name';
 export interface PlantMatch {
@@ -1446,6 +1453,58 @@ export interface RateLookupResult {
  * active legacy rate tables — enough to resolve rates in-memory for a whole
  * calc run instead of N×M live `rates.lookup` calls. Decimals are strings.
  */
+/** How a rate element's `plantId` relates to master-data's own plant registry.
+ *  `already-master-data` on every row means the environment is keyed our way
+ *  and a re-key would be a no-op; `unmapped` rows carry a consumer-side uuid
+ *  and are what the cutover has to move. */
+export type PlantKeyClassification = 'already-master-data' | 'unmapped' | 'mapped';
+/** Input for `rates.rekeyPlants` — the one-shot cutover step that moves
+ *  `RateElement.plantId` (and its derived `identityKey`) from a consumer's own
+ *  plant uuids onto master-data's. See the route docs for why it is staged. */
+export interface RekeyPlantsInput {
+    /** 'by-code' lets master-data resolve the target from its own registry, which
+     *  is ALSO how a caller discovers which keying an environment is in.
+     *  'explicit' is for a mapping a human has already reviewed. */
+    mode: 'by-code' | 'explicit';
+    mapping: Array<{
+        fromPlantId: string;
+        code?: string;
+        toPlantId?: string;
+    }>;
+    /** Defaults to 'fail': a collision means the tenant holds the same logical
+     *  rate twice and a person has to choose. */
+    onCollision?: 'fail' | 'keep-target' | 'keep-source';
+    /** Defaults to TRUE — omitting it gives you a dry run, never a write. */
+    dryRun?: boolean;
+}
+export interface RekeyPlantsReport {
+    dryRun: boolean;
+    tenantId: string;
+    distinctPlantIds: Array<{
+        plantId: string;
+        classification: PlantKeyClassification;
+        resolvedCode: string | null;
+        toPlantId: string | null;
+        elementCount: number;
+        legacyEntryCount: number;
+    }>;
+    /** scope='global' elements (`pl:_`), which a re-key never touches. */
+    globalElements: number;
+    collisions: Array<{
+        identityKeyAfter: string;
+        elementIds: string[];
+    }>;
+    wouldRewrite: {
+        elements: number;
+        legacyEntries: number;
+        equipmentIds: number;
+    };
+    applied: {
+        elements: number;
+        legacyEntries: number;
+        equipmentIds: number;
+    };
+}
 export interface RateSnapshot {
     asOf: string;
     books: Array<{
@@ -1519,6 +1578,50 @@ export interface RateSnapshot {
         needsDensity: boolean;
         active: boolean;
     }>;
+    /** Every plant in the tenant, ARCHIVED INCLUDED — an archived plant is still
+     *  referenced by historical routing and must stay resolvable by id. Filter for
+     *  pickers on the consumer side. Added 2026-09-17 for the plant/equipment
+     *  consumer cutover: CPQ resolves plants out of this snapshot (which it
+     *  already fetches once per calc run and caches) instead of reading its own
+     *  plant table, so the cost path costs no extra round-trips and the whole
+     *  reference set shares one invalidation lever. */
+    plants: Array<{
+        id: string;
+        code: string;
+        name: string;
+        location: string | null;
+        country: string | null;
+        region: string | null;
+        headcount: number | null;
+        annualCapacity: number | null;
+        currentUtilization: number | null;
+        laborCostPerHour: number | null;
+        riskLevel: string | null;
+        currency: string;
+        numShifts: number;
+        hoursPerShift: number;
+        workingDaysPerYear: number;
+        indirectHeadcountPct: number;
+        active: boolean;
+    }>;
+    /** Every machine in the tenant, archived included — same reasoning as `plants`.
+     *  Note `equipmentCode` (not id) is what the rate identity key is built from. */
+    equipment: Array<{
+        id: string;
+        plantId: string;
+        code: string;
+        name: string;
+        processFamily: string;
+        capacityHoursPerYear: number;
+        cavities: number;
+        availabilityPct: number;
+        performancePct: number;
+        defaultHeadcount: number;
+        defaultAutomationPct: number;
+        defaultMachinesPerOperator: number;
+        defaultSetupCrew: number;
+        active: boolean;
+    }>;
     legacyRateTables: Array<{
         id: string;
         name: string;
@@ -1864,6 +1967,18 @@ export interface UpdateEquipmentInput {
     defaultSetupCrew?: number;
     active?: boolean;
 }
+/** Outcome of `equipment.batchUpsert`. A bad row is reported, not fatal — a
+ *  migration that names its three failures is more useful than one that rolls
+ *  back 500 rows and says nothing about which. */
+export interface BatchUpsertEquipmentResult {
+    created: number;
+    updated: number;
+    errors: Array<{
+        index: number;
+        code: string;
+        message: string;
+    }>;
+}
 export interface ListEquipmentOptions {
     limit?: number;
     cursor?: string;
@@ -1877,6 +1992,29 @@ export interface ListEquipmentOptions {
      *  existing caller that sets this doesn't hit a type error; has no effect. */
     active?: boolean;
 }
+/** A governed category for `ProcessFamily.category`. Two-tier: `tenantId` null
+ *  is a platform default, shared and read-only to tenants. */
+export interface ProcessFamilyCategory {
+    id: string;
+    tenantId: string | null;
+    code: string;
+    label: string;
+    sortOrder: number;
+    /** System categories can be renamed and archived, never hard-deleted. */
+    isSystem: boolean;
+    active: boolean;
+}
+export interface CreateProcessFamilyCategoryInput {
+    /** `code` is derived from this server-side and is immutable thereafter,
+     *  because stored `ProcessFamily.category` values resolve against it. */
+    label: string;
+    sortOrder?: number;
+}
+export interface UpdateProcessFamilyCategoryInput {
+    label?: string;
+    sortOrder?: number;
+    active?: boolean;
+}
 export interface ProcessFamily {
     id: string;
     tenantId: string | null;
@@ -3484,4 +3622,66 @@ export interface UpdateScopeDimensionSettingInput {
     labelPlural?: string;
     enabled?: boolean;
 }
+/** The five sources a stored value can name. */
+export type StandardAttributeSource = 'customer_rfq' | 'volume_intelligence' | 'master_data' | 'prior_quote' | 'user';
+export interface StandardAttribute {
+    id: string;
+    /** Immutable. The cross-tenant reporting key every stored value references. */
+    key: string;
+    label: string;
+    position: number;
+    /** 'string' | 'date' — matches VI's dimension catalog vocabulary. */
+    dataType: string;
+    /** The VI dimension this resolves through, when it has one. */
+    viCatalogKey: string | null;
+    /** Whether THIS TENANT tracks it. Distinct from the platform lifecycle below. */
+    enabled: boolean;
+    status: 'active' | 'archived';
+    createdAt: string;
+    updatedAt: string;
+}
+/** `key` is absent by design — it is immutable after create. */
+export interface UpdateStandardAttributeInput {
+    label?: string;
+    position?: number;
+    enabled?: boolean;
+    status?: 'active' | 'archived';
+}
+export interface StandardAttributeValue {
+    key: string;
+    value: string;
+    /** Which system supplied it. */
+    source: StandardAttributeSource;
+    /** Why this value — free text, e.g. "Prior quote Q-2026-118". */
+    sourceDetail: string | null;
+    setAt: string;
+    setBy: string;
+}
+export interface SetStandardAttributeValueInput {
+    key: string;
+    value: string;
+    source: StandardAttributeSource;
+    sourceDetail?: string | null;
+    /**
+     * Leave an existing value alone. The enrichment pass sets this; a person
+     * editing the card does not.
+     */
+    onlyIfBlank?: boolean;
+}
+export interface SetStandardAttributeValueResult {
+    key: string;
+    written: boolean;
+    skipped?: 'already-set';
+}
+export interface StandardAttributeHistoryEntry {
+    id: string;
+    quoteId: string;
+    key: string;
+    /** NULL on the first write — no previous value, which is not an empty one. */
+    oldValue: string | null;
+    newValue: string;
+    source: StandardAttributeSource;
+    changedAt: string;
+    changedBy: string;
+}
 //# sourceMappingURL=types.d.ts.map