@campfire-interactive/master-data-client 5.19.0 → 5.22.0

package/dist/tenantPrograms.d.ts

@@ -2,9 +2,9 @@ import { HttpTransport } from './http';
 import type { TenantProgram, ListTenantProgramsOptions, GetTenantProgramOptions, CreateTenantProgramInput, UpdateTenantProgramInput, TenantProgramFinishedGood, AddTenantProgramFinishedGoodsInput, UpdateTenantProgramFinishedGoodInput, TenantProgramFinishedGoodHolder, AvailableAwardedLine, ListAvailableAwardedLinesOptions, AuditLogEntry, SingleResponse, ListResponse, CreateResponse } from './types';
 /**
  * The tenant's own programs ("Campfire Programs") at /v1/tenant-programs.
- * `client.programs` is the LEGACY program and is unchanged; these take the
- * plain name once legacy is gone (nextgen plan
- * 2026-10-08-tenant-programs-pm-first.md).
+ * Every legacy program became one of these under its own id; the legacy
+ * `client.programs` was removed in 5.19.0 (nextgen plan
+ * 2026-10-09-legacy-program-swap.md).
  */
 export declare class TenantProgramResource {
     private readonly http;

package/dist/tenantPrograms.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TenantProgramResource = void 0;
 /**
  * The tenant's own programs ("Campfire Programs") at /v1/tenant-programs.
- * `client.programs` is the LEGACY program and is unchanged; these take the
- * plain name once legacy is gone (nextgen plan
- * 2026-10-08-tenant-programs-pm-first.md).
+ * Every legacy program became one of these under its own id; the legacy
+ * `client.programs` was removed in 5.19.0 (nextgen plan
+ * 2026-10-09-legacy-program-swap.md).
  */
 class TenantProgramResource {
     http;

package/dist/types.d.ts

@@ -48,86 +48,6 @@ export interface Location {
     createdAt: string;
     updatedAt: string;
 }
-/** LEGACY: the old program (master-data table `programs_legacy`), in practice
- *  an OEM's vehicle program scoped to one customer. Unchanged on the wire for
- *  the apps still on it; the tenant's own program is {@link TenantProgram}
- *  (`client.tenantPrograms`). */
-export interface Program {
-    id: string;
-    tenantId: string;
-    customerCompanyId: string;
-    /** @deprecated Use customerCompanyId. Removed in the next major. Mirrors customerCompanyId during the additive-deprecate window. */
-    oemCompanyId: string;
-    name: string;
-    code: string;
-    description: string | null;
-    sopDate: string | null;
-    eopDate: string | null;
-    status: 'active' | 'archived';
-    quality: 'draft' | 'verified';
-    createdBy: string;
-    updatedBy: string;
-    createdAt: string;
-    updatedAt: string;
-    /** The scope dimensions this program belongs to. Null means NOT SET, which is
-     *  legal and is where every record starts — resolve the id through
-     *  `geographicScopes` / `productScopes`, and label the field with the
-     *  tenant's alias from `scopeDimensionSettings`, never "Region". */
-    geographicScopeId: string | null;
-    productScopeId: string | null;
-    customerCompany?: Company;
-    /** @deprecated Use customerCompany. Removed in the next major. Mirrors customerCompany. */
-    oemCompany?: Company;
-}
-export interface CreateProgramInput {
-    customerCompanyId?: string;
-    /** @deprecated Use customerCompanyId. Removed in the next major. Server rejects when both are set to differing values. */
-    oemCompanyId?: string;
-    name: string;
-    code: string;
-    description?: string;
-    sopDate?: string;
-    eopDate?: string;
-    /** Must name an ACTIVE scope in this tenant, or the server 400s naming the
-     *  field. Omit (or send null) to leave it unset. */
-    geographicScopeId?: string | null;
-    productScopeId?: string | null;
-}
-export interface UpdateProgramInput {
-    name?: string;
-    code?: string;
-    description?: string;
-    sopDate?: string | null;
-    eopDate?: string | null;
-    quality?: 'draft' | 'verified';
-    /** Set, change, or clear with null. Must name an ACTIVE scope. */
-    geographicScopeId?: string | null;
-    productScopeId?: string | null;
-}
-export interface ListProgramsOptions {
-    limit?: number;
-    cursor?: string;
-    sort?: string;
-    q?: string;
-    status?: 'active' | 'archived' | 'all';
-    quality?: 'draft' | 'verified';
-    customerCompanyId?: string;
-    /** @deprecated Use customerCompanyId. Removed in the next major. */
-    oemCompanyId?: string;
-    /** Batch-get a specific set of programs by id — returns them regardless of
-     *  status. Comma-joined server-side; cap ~100/call for URL length and chunk
-     *  larger sets. The server bumps the page size to cover the ids. */
-    ids?: string[];
-    include?: ('customerCompany' | 'oemCompany')[];
-    /** Filter to one scope, or pass `'none'` for programs with NO scope set —
-     *  the bucket every tenant starts in, and how you ask "what still needs a
-     *  scope?". */
-    geographicScopeId?: string;
-    productScopeId?: string;
-}
-export interface GetProgramOptions {
-    include?: ('customerCompany' | 'oemCompany')[];
-}
 export interface TenantProgram {
     id: string;
     tenantId: string;
@@ -151,6 +71,10 @@ export interface TenantProgram {
     createdAt: string;
     updatedAt: string;
 }
+/** A quote's program as `include=program` embeds it: the tenant program's own
+ *  fields, without the derived customers or the attribute values, which
+ *  `client.tenantPrograms.get` serves. */
+export type QuoteProgram = Pick<TenantProgram, 'id' | 'tenantId' | 'code' | 'name' | 'description' | 'status' | 'geographicScopeId' | 'productScopeId' | 'createdBy' | 'updatedBy' | 'createdAt' | 'updatedAt'>;
 export interface ListTenantProgramsOptions {
     limit?: number;
     cursor?: string;
@@ -497,7 +421,8 @@ export interface Quote {
     createdAt: string;
     updatedAt: string;
     customerCompany?: Company;
-    program?: Program;
+    /** The quote's tenant program, present when the read includes `program`. */
+    program?: QuoteProgram | null;
     /** Expanded region — present only when the read includes the relation. */
     region?: Region;
 }
@@ -1352,7 +1277,7 @@ export interface PlantMatchBatchInput {
     limit?: number;
 }
 /** Parallel arrays — `data[i]` is the matches for `queries[i]`. Failed
- *  per-query lookups surface as empty arrays (mirrors Program match batch). */
+ *  per-query lookups surface as empty arrays. */
 export interface PlantMatchBatchResponse {
     data: PlantMatch[][];
     meta: ApiMeta;
@@ -3140,8 +3065,9 @@ export interface AttributeDefinitionImportRow {
     dataType: string;
     group: string | null;
     valueCount: number;
-    /** ready / error before a commit; created / failed after one. */
-    status: 'ready' | 'error' | 'created' | 'failed';
+    /** ready / error / skipped before a commit; created / failed (or still skipped) after one.
+     *  `skipped`: the key already exists in the registry, so the row is left alone (since 5.21.0). */
+    status: 'ready' | 'error' | 'skipped' | 'created' | 'failed';
     errors: string[];
     warnings: string[];
 }
@@ -3160,6 +3086,7 @@ export interface AttributeDefinitionImportReport {
         total: number;
         ready: number;
         errors: number;
+        skipped: number;
         created: number;
         failed: number;
     };
@@ -3904,51 +3831,6 @@ export interface MatchBatchResponse {
     data: Record<string, CompanyMatch[]>;
     meta: ApiMeta;
 }
-/** Discriminates the high-confidence (exact (tenantId, customerCompanyId,
- *  code) match) from the fuzzy pg_trgm-on-name match. Callers can auto-resolve
- *  `exact_code` without re-scoring; `trgm_name` typically requires operator
- *  confirmation. */
-export type ProgramMatchType = 'exact_code' | 'trgm_name';
-export interface ProgramMatch {
-    id: string;
-    name: string;
-    code: string;
-    customerCompanyId: string;
-    /** @deprecated Use customerCompanyId. Removed in the next major. Mirrors customerCompanyId. */
-    oemCompanyId?: string;
-    /** 1.0 for exact-code match; pg_trgm similarity in (threshold..1] otherwise. */
-    score: number;
-    matchType: ProgramMatchType;
-}
-export interface ProgramMatchQuery {
-    name: string;
-    customerCompanyId?: string;
-    /** @deprecated Use customerCompanyId. Removed in the next major. Server rejects when both are set to differing values. */
-    oemCompanyId?: string;
-    /** When present, an exact match on (tenantId, customerCompanyId, code) is
-     *  unioned at score=1.0 ahead of fuzzy matches. */
-    code?: string;
-}
-export interface ProgramMatchByNameInput extends ProgramMatchQuery {
-    /** Similarity floor, 0.05..0.95 (clamped server-side). Default 0.3. */
-    threshold?: number;
-    /** Max trgm matches returned, 1..25 (clamped). Default 5. An exact-code
-     *  hit is returned in addition to the trgm matches. */
-    limit?: number;
-}
-export interface ProgramMatchBatchInput {
-    /** Non-empty; max 500 queries per request. */
-    queries: ProgramMatchQuery[];
-    threshold?: number;
-    limit?: number;
-}
-/** Response shape for the batch endpoint — parallel arrays. `data[i]` is
- *  the matches for `queries[i]`. Failed queries surface as empty arrays
- *  (per-query failures don't fail the batch, mirroring Company match). */
-export interface ProgramMatchBatchResponse {
-    data: ProgramMatch[][];
-    meta: ApiMeta;
-}
 export interface ListLocationsOptions {
     type?: LocationType;
 }
@@ -4119,102 +4001,6 @@ 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;
-}
-/**
- * The PLATFORM-wide catalog row a tenant's copy is seeded from.
- *
- * No `enabled` and no `status`: those are a tenant's answer about a tenant's
- * copy. The default is simply the definition.
- */
-export interface StandardAttributeDefault {
-    id: string;
-    /** Immutable, and the key every tenant copy and stored value carries. */
-    key: string;
-    label: string;
-    position: number;
-    dataType: string;
-    viCatalogKey: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Creating one. `key` is an identifier: lower snake_case, immutable after
- *  create, and what every stored value references. */
-export interface CreateStandardAttributeInput {
-    key: string;
-    label: string;
-    position?: number;
-    dataType?: string;
-    viCatalogKey?: string | null;
-}
-/** Same shape for the platform catalog. */
-export type CreateStandardAttributeDefaultInput = CreateStandardAttributeInput;
-/** Label and position only. The catalog is code-seeded, so there is no create,
- *  no delete, and `key` is immutable. */
-export interface UpdateStandardAttributeDefaultInput {
-    label?: string;
-    position?: number;
-}
-/** `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;
-}
 /** The settings a call resolves to. Never partial - every field has a value. */
 export interface AiLlmSettings {
     provider: string;