@campfire-interactive/master-data-client 3.1.2 → 3.5.1

package/dist/types.d.ts

@@ -407,105 +407,89 @@ export interface ListMaterialsOptions {
     quality?: 'draft' | 'verified';
     category?: string;
 }
-export type PlantStatus = 'active' | 'archived';
 export interface Plant {
     id: string;
     tenantId: string;
-    companyId: string | null;
-    locationId: string | null;
     code: string;
     name: string;
-    description: string | null;
-    /** Denormalised; useful even when locationId is null. */
+    location: string | null;
+    /** Denormalised country. */
     country: string | null;
-    /** Free-text in v1; may FK to Region later. */
+    /** Free-text region. */
     region: string | null;
     headcount: number | null;
-    annualCapacityHours: number | null;
-    /** Annual throughput capacity in units (distinct from annualCapacityHours). */
-    annualCapacityUnits: number | null;
+    /** Annual throughput capacity (units). */
+    annualCapacity: number | null;
     /** 0..1. */
     currentUtilization: number | null;
+    /** $/hr fully-loaded labor cost. Decimal-ish; carried as number. */
+    laborCostPerHour: number | null;
     riskLevel: string | null;
-    /** Plant operating currency (ISO 4217). Ergonomic default for rate entry;
-     *  rate values carry their own authoritative currency. Defaults to "USD". */
+    /** Plant operating currency (ISO 4217). Defaults to "USD". */
     currency: string;
     numShifts: number;
     hoursPerShift: number;
     workingDaysPerYear: number;
     /** 0..1; defaults to 0.15. */
     indirectHeadcountPct: number;
-    status: PlantStatus;
-    quality: 'draft' | 'verified';
-    createdBy: string;
-    updatedBy: string;
+    active: boolean;
     createdAt: string;
     updatedAt: string;
-    company?: Company;
-    location?: Location;
 }
 export interface CreatePlantInput {
     code: string;
     name: string;
-    description?: string;
-    companyId?: string | null;
-    locationId?: string | null;
+    location?: string;
     country?: string;
     region?: string;
     headcount?: number;
-    annualCapacityHours?: number;
-    annualCapacityUnits?: number;
+    annualCapacity?: number;
     currentUtilization?: number;
+    laborCostPerHour?: number;
     riskLevel?: string;
     currency?: string;
     numShifts?: number;
     hoursPerShift?: number;
     workingDaysPerYear?: number;
     indirectHeadcountPct?: number;
-    quality?: 'draft' | 'verified';
+    active?: boolean;
 }
 export interface UpdatePlantInput {
     code?: string;
     name?: string;
-    description?: string | null;
-    companyId?: string | null;
-    locationId?: string | null;
+    location?: string | null;
     country?: string | null;
     region?: string | null;
     headcount?: number | null;
-    annualCapacityHours?: number | null;
-    annualCapacityUnits?: number | null;
+    annualCapacity?: number | null;
     currentUtilization?: number | null;
+    laborCostPerHour?: number | null;
     riskLevel?: string | null;
     currency?: string;
     numShifts?: number;
     hoursPerShift?: number;
     workingDaysPerYear?: number;
     indirectHeadcountPct?: number;
-    quality?: 'draft' | 'verified';
+    active?: boolean;
 }
 export interface ListPlantsOptions {
     limit?: number;
     cursor?: string;
     sort?: string;
     q?: string;
-    status?: PlantStatus | 'all';
-    quality?: 'draft' | 'verified';
-    companyId?: string;
-    locationId?: string;
+    active?: boolean;
     country?: string;
     region?: string;
-    include?: ('company' | 'location')[];
 }
 export interface GetPlantOptions {
-    include?: ('company' | 'location')[];
+    /** Reserved for future relation expansions; currently no-op. */
+    include?: string[];
 }
 export type PlantMatchType = 'exact_code' | 'trgm_name';
 export interface PlantMatch {
     id: string;
     name: string;
     code: string;
-    companyId: string | null;
     country: string | null;
     region: string | null;
     /** 1.0 for exact-code match; pg_trgm similarity in (threshold..1] otherwise. */
@@ -514,8 +498,6 @@ export interface PlantMatch {
 }
 export interface PlantMatchQuery {
     name: string;
-    /** When set, restricts both exact and fuzzy matches to plants of this company. */
-    companyId?: string;
     /** When present, an exact match on (tenantId, code) is unioned at score=1.0. */
     code?: string;
 }
@@ -542,233 +524,309 @@ export interface MergePlantsRequest {
     survivorId: string;
     mergedIds: string[];
 }
-export type RateLibraryStatus = 'draft' | 'active' | 'archived';
-export type RateEntryKind = 'labor' | 'machine' | 'overhead' | 'material' | 'freight';
 export type RateSourcingMode = 'fixed' | 'indexed';
 export type RateRollForwardMode = 'carry_forward_flagged' | 'blank_force_entry';
 export type RateValueOrigin = 'entered' | 'escalated' | 'overridden' | 'carried_forward';
-export interface RateLibrary {
+/** Legacy alias retained for the v0 rate-table entries + the lookup `kind` param. */
+export type RateEntryKind = 'labor' | 'machine' | 'overhead' | 'material' | 'freight';
+export interface RateBook {
     id: string;
     tenantId: string;
     name: string;
-    code: string;
-    description: string | null;
-    currency: string;
+    year: number;
+    status: string;
     effectiveDate: string;
-    effectiveTo: string | null;
-    /** Multi-year projection horizon (calendar years) + book-level escalation
-     *  and roll-forward policy. Carried over from CPQ's RateBook. Null horizon
-     *  = single-window library. Added in the 2026-07-02 rate superset. */
-    horizonStart: number | null;
-    horizonEnd: number | null;
+    currency: string;
+    horizonStart: number;
+    horizonEnd: number;
     escalationPct: number;
     rollForwardMode: RateRollForwardMode;
-    status: RateLibraryStatus;
-    quality: 'draft' | 'verified';
-    version: number;
     publishedAt: string | null;
-    publishedBy: string | null;
-    archivedAt: string | null;
-    archivedBy: string | null;
-    createdBy: string;
-    updatedBy: string;
     createdAt: string;
     updatedAt: string;
-    entries?: RateEntry[];
-    /** Which app most-recently wrote any field on this row. Derived from
-     *  `FieldProvenance` server-side. Defaults to `'master-data'` for rows
-     *  without provenance entries. Added in 2.15.0. */
-    lastEditedBy?: SourceApp;
 }
-export interface RateEntry {
+export interface CreateRateBookInput {
+    name: string;
+    year: number;
+    effectiveDate: string;
+    currency?: string;
+    horizonStart?: number;
+    horizonEnd?: number;
+    escalationPct?: number;
+    rollForwardMode?: RateRollForwardMode;
+}
+export interface UpdateRateBookInput {
+    name?: string;
+    year?: number;
+    effectiveDate?: string;
+    currency?: string;
+    horizonStart?: number;
+    horizonEnd?: number;
+    escalationPct?: number;
+    rollForwardMode?: RateRollForwardMode;
+}
+export interface ListRateBooksOptions {
+    limit?: number;
+    cursor?: string;
+    sort?: string;
+    q?: string;
+    status?: string;
+    year?: number;
+    currency?: string;
+}
+export interface RateElement {
     id: string;
     tenantId: string;
-    rateLibraryId: string;
-    kind: RateEntryKind;
+    scope: string;
     plantId: string | null;
-    /** Equipment scope for machine-burden rates (superset). */
-    equipmentId: string | null;
-    equipmentCode: string | null;
-    skillTier: string | null;
-    materialId: string | null;
-    /** Material grade code — resolves to a RateGrade for density. */
+    rateLineId: string | null;
     gradeCode: string | null;
-    regionId: string | null;
+    equipmentCode: string | null;
+    equipmentId: string | null;
+    skillClass: string | null;
     lane: string | null;
-    /** Freight mode + packaging container qualifiers. */
     mode: string | null;
     container: string | null;
+    /** Computed server-side from the element's dimensions. */
+    identityKey: string;
+    escalationPct: number | null;
+    externalRef: string | null;
+    sourceSystem: string | null;
+    createdAt: string;
+    updatedAt: string;
+    values?: RateValue[];
+}
+export interface CreateRateElementInput {
+    scope: string;
+    plantId?: string | null;
+    rateLineId?: string | null;
+    gradeCode?: string | null;
+    equipmentCode?: string | null;
+    equipmentId?: string | null;
+    skillClass?: string | null;
+    lane?: string | null;
+    mode?: string | null;
+    container?: string | null;
+    escalationPct?: number | null;
+    externalRef?: string | null;
+    sourceSystem?: string | null;
+}
+export interface ListRateElementsOptions {
+    limit?: number;
+    cursor?: string;
+    sort?: string;
+    scope?: string;
+    plantId?: string;
+    rateLineId?: string;
+    equipmentCode?: string;
+    equipmentId?: string;
+    gradeCode?: string;
+}
+export interface RateValue {
+    id: string;
+    tenantId: string;
+    elementId: string;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    origin: RateValueOrigin;
     /** Decimal serialized as string to preserve precision across the wire. */
     rate: string;
-    /** Canonical mass-basis cost (Decimal string), derived for material rates. */
-    ratePerKg: string | null;
-    unit: string;
     currency: string;
-    /** Per-year projection window (null = inherits the library window). */
-    effectiveFrom: string | null;
-    effectiveTo: string | null;
-    /** Per-row escalation override (null = inherit the library default). */
-    escalationPct: number | null;
-    origin: RateValueOrigin;
+    uom: string;
+    ratePerKg: string | null;
     sourcingMode: RateSourcingMode;
-    indexRef: string | null;
-    lastSyncedAt: string | null;
     sourceSystem: string | null;
-    externalRef: string | null;
-    notes: string | null;
-    createdBy: string;
-    updatedBy: string;
+    priceIndexId: string | null;
+    indexRefLegacy: string | null;
+    bookId: string;
     createdAt: string;
     updatedAt: string;
 }
-export interface CreateRateLibraryInput {
-    name: string;
-    code: string;
-    description?: string;
+export interface CreateRateValueInput {
+    effectiveFrom: string;
+    effectiveTo?: string | null;
+    origin?: RateValueOrigin;
+    /** Number accepted; string preferred for precision. */
+    rate: number | string;
     currency?: string;
+    uom: string;
+    ratePerKg?: number | string | null;
+    sourcingMode?: RateSourcingMode;
+    sourceSystem?: string | null;
+    priceIndexId?: string | null;
+    indexRefLegacy?: string | null;
+    bookId: string;
+}
+export interface ListRateValuesOptions {
+    bookId?: string;
+    asOf?: string;
+}
+export interface RateTable {
+    id: string;
+    tenantId: string;
+    name: string;
+    effectiveDate: string;
+    effectiveTo: string | null;
+    status: string;
+    year: number;
+    currency: string;
+    version: number;
+    publishedAt: string | null;
+    publishedById: string | null;
+    archivedAt: string | null;
+    archivedById: string | null;
+    createdAt: string;
+    updatedAt: string;
+    entries?: RateEntry[];
+}
+export interface CreateRateTableInput {
+    name: string;
     effectiveDate: string;
     effectiveTo?: string | null;
-    horizonStart?: number | null;
-    horizonEnd?: number | null;
-    escalationPct?: number;
-    rollForwardMode?: RateRollForwardMode;
+    year: number;
+    currency?: string;
 }
-export interface UpdateRateLibraryInput {
+export interface UpdateRateTableInput {
     name?: string;
-    description?: string | null;
-    currency?: string;
     effectiveDate?: string;
     effectiveTo?: string | null;
-    quality?: 'draft' | 'verified';
-    horizonStart?: number | null;
-    horizonEnd?: number | null;
-    escalationPct?: number;
-    rollForwardMode?: RateRollForwardMode;
-}
-export interface RollForwardResult {
-    libraryId: string;
-    horizonStart: number;
-    horizonEnd: number;
-    mode: RateRollForwardMode;
-    seedsProjected: number;
-    rowsCreated: number;
-    rowsReplaced: number;
+    year?: number;
+    currency?: string;
 }
-export interface ListRateLibrariesOptions {
+export interface ListRateTablesOptions {
     limit?: number;
     cursor?: string;
     sort?: string;
     q?: string;
-    status?: RateLibraryStatus | 'all';
-    /** Filter to libraries effective on this date (effectiveDate <= asOf, effectiveTo null or > asOf). */
-    asOf?: string;
-    code?: string;
+    status?: string;
+    year?: number;
     currency?: string;
 }
-export interface GetRateLibraryOptions {
-    include?: 'entries'[];
+export interface RateEntry {
+    id: string;
+    tenantId: string;
+    rateTableId: string;
+    category: string;
+    subcategory: string;
+    region: string | null;
+    /** Decimal serialized as string to preserve precision across the wire. */
+    rate: string;
+    unit: string;
+    effectiveDate: string;
+    notes: string | null;
+    key: string | null;
+    alias: string | null;
+    type: string | null;
+    plantId: string | null;
+    plantSubtype: string | null;
+    skillTier: string | null;
+    lane: string | null;
+    mode: string | null;
+    sourcingMode: string | null;
+    indexRef: string | null;
+    source: string | null;
+    lastSyncedAt: string | null;
+    syncStatus: string | null;
+    confidence: number | null;
+    entryVersion: number;
+    currency: string | null;
+    density: number | null;
+    densityUnit: string | null;
+    ratePerKg: string | null;
+    createdAt: string;
+    updatedAt: string;
 }
 export interface CreateRateEntryInput {
-    kind: RateEntryKind;
-    plantId?: string | null;
-    equipmentId?: string | null;
-    equipmentCode?: string | null;
-    skillTier?: string | null;
-    materialId?: string | null;
-    gradeCode?: string | null;
-    regionId?: string | null;
-    lane?: string | null;
-    mode?: string | null;
-    container?: string | null;
+    category: string;
+    subcategory: string;
+    region?: string | null;
     /** Number accepted; string preferred for precision. */
     rate: number | string;
-    ratePerKg?: number | string | null;
     unit: string;
-    currency?: string;
-    effectiveFrom?: string | null;
-    effectiveTo?: string | null;
-    escalationPct?: number | null;
-    origin?: RateValueOrigin;
-    sourcingMode?: RateSourcingMode;
-    indexRef?: string | null;
-    sourceSystem?: string | null;
-    externalRef?: string | null;
+    effectiveDate: string;
     notes?: string | null;
-}
-export interface UpdateRateEntryInput {
+    key?: string | null;
+    alias?: string | null;
+    type?: string | null;
     plantId?: string | null;
-    equipmentId?: string | null;
-    equipmentCode?: string | null;
+    plantSubtype?: string | null;
     skillTier?: string | null;
-    materialId?: string | null;
-    gradeCode?: string | null;
-    regionId?: string | null;
     lane?: string | null;
     mode?: string | null;
-    container?: string | null;
-    rate?: number | string;
+    sourcingMode?: string | null;
+    indexRef?: string | null;
+    source?: string | null;
+    currency?: string | null;
+    density?: number | null;
+    densityUnit?: string | null;
     ratePerKg?: number | string | null;
+}
+export interface UpdateRateEntryInput {
+    category?: string;
+    subcategory?: string;
+    region?: string | null;
+    rate?: number | string;
     unit?: string;
-    currency?: string;
-    effectiveFrom?: string | null;
-    effectiveTo?: string | null;
-    escalationPct?: number | null;
-    origin?: RateValueOrigin;
-    sourcingMode?: RateSourcingMode;
-    indexRef?: string | null;
-    sourceSystem?: string | null;
-    externalRef?: string | null;
+    effectiveDate?: string;
     notes?: string | null;
-}
-export interface ListRateEntriesOptions {
-    kind?: RateEntryKind;
-}
-export interface RateLookupInput {
-    kind: RateEntryKind;
+    key?: string | null;
+    alias?: string | null;
+    type?: string | null;
     plantId?: string | null;
-    equipmentId?: string | null;
-    equipmentCode?: string | null;
+    plantSubtype?: string | null;
     skillTier?: string | null;
-    materialId?: string | null;
-    gradeCode?: string | null;
-    regionId?: string | null;
     lane?: string | null;
     mode?: string | null;
-    container?: string | null;
+    sourcingMode?: string | null;
+    indexRef?: string | null;
+    source?: string | null;
+    currency?: string | null;
+    density?: number | null;
+    densityUnit?: string | null;
+    ratePerKg?: number | string | null;
+}
+export interface RateLookupInput {
+    rateLineId?: string;
+    /** Legacy alias for rateLineId; accepted server-side for back-compat. */
+    kind?: string;
+    plantId?: string;
+    equipmentCode?: string;
+    equipmentId?: string;
+    skillClass?: string;
+    gradeCode?: string;
+    lane?: string;
+    mode?: string;
+    container?: string;
     /** ISO date (YYYY-MM-DD). Defaults to today. */
     asOf?: string;
 }
 export interface RateLookupResult {
-    libraryId: string;
-    libraryCode: string;
-    libraryVersion: number;
-    entryId: string;
-    kind: RateEntryKind;
+    elementId: string;
+    bookId: string;
+    identityKey: string;
     /** Decimal serialized as string. */
     rate: string;
     /** Decimal serialized as string; null when not a mass-basis material rate. */
     ratePerKg: string | null;
-    unit: string;
+    uom: string;
     currency: string;
     sourcingMode: RateSourcingMode;
-    indexRef: string | null;
     /** Echoes the asOf the server resolved against (YYYY-MM-DD). */
     asOf: string;
-    /** Echoes the dimensions on the matched entry — handy for consumer audit logging. */
+    /** Echoes the dimensions on the matched element — handy for consumer audit logging. */
     resolvedFrom: {
+        rateLineId: string | null;
         plantId: string | null;
-        equipmentId: string | null;
         equipmentCode: string | null;
-        skillTier: string | null;
-        materialId: string | null;
+        equipmentId: string | null;
+        skillClass: string | null;
         gradeCode: string | null;
-        regionId: string | null;
         lane: string | null;
         mode: string | null;
         container: string | null;
     };
 }
-export interface PlantEquipment {
+export interface Equipment {
     id: string;
     tenantId: string;
     plantId: string;
@@ -786,13 +844,9 @@ export interface PlantEquipment {
     defaultAutomationPct: number;
     defaultMachinesPerOperator: number;
     defaultSetupCrew: number;
-    status: PlantStatus;
-    quality: 'draft' | 'verified';
-    createdBy: string;
-    updatedBy: string;
+    active: boolean;
     createdAt: string;
     updatedAt: string;
-    plant?: Plant;
 }
 export interface CreateEquipmentInput {
     plantId: string;
@@ -807,7 +861,7 @@ export interface CreateEquipmentInput {
     defaultAutomationPct?: number;
     defaultMachinesPerOperator?: number;
     defaultSetupCrew?: number;
-    quality?: 'draft' | 'verified';
+    active?: boolean;
 }
 export interface UpdateEquipmentInput {
     code?: string;
@@ -821,122 +875,133 @@ export interface UpdateEquipmentInput {
     defaultAutomationPct?: number;
     defaultMachinesPerOperator?: number;
     defaultSetupCrew?: number;
-    quality?: 'draft' | 'verified';
+    active?: boolean;
 }
 export interface ListEquipmentOptions {
     limit?: number;
     cursor?: string;
     sort?: string;
     q?: string;
-    status?: PlantStatus | 'all';
-    quality?: 'draft' | 'verified';
     plantId?: string;
     processFamily?: string;
-    include?: 'plant'[];
-}
-export interface GetEquipmentOptions {
-    include?: 'plant'[];
+    active?: boolean;
 }
 export interface ProcessFamily {
     id: string;
-    tenantId: string;
+    tenantId: string | null;
     code: string;
-    name: string;
-    description: string | null;
+    label: string;
+    category: string;
     sortOrder: number;
-    status: PlantStatus;
-    createdBy: string;
-    updatedBy: string;
+    active: boolean;
+    isDefault: boolean;
     createdAt: string;
     updatedAt: string;
 }
 export interface CreateProcessFamilyInput {
     code: string;
-    name: string;
-    description?: string;
+    label: string;
+    category: string;
     sortOrder?: number;
+    active?: boolean;
+    isDefault?: boolean;
 }
 export interface UpdateProcessFamilyInput {
-    name?: string;
-    description?: string | null;
+    label?: string;
+    category?: string;
     sortOrder?: number;
-    status?: 'active' | 'archived';
+    active?: boolean;
+    isDefault?: boolean;
 }
 export interface Uom {
     id: string;
-    tenantId: string;
+    tenantId: string | null;
     code: string;
-    name: string;
-    dimension: string | null;
-    createdBy: string;
-    updatedBy: string;
+    label: string;
+    bindings: string[];
+    basis: string;
+    perBaseFactor: number | null;
+    needsDensity: boolean;
+    active: boolean;
     createdAt: string;
     updatedAt: string;
 }
 export interface CreateUomInput {
     code: string;
-    name: string;
-    dimension?: string;
+    label: string;
+    bindings?: string[];
+    basis: string;
+    perBaseFactor?: number | null;
+    needsDensity?: boolean;
+    active?: boolean;
 }
 export interface UpdateUomInput {
-    name?: string;
-    dimension?: string | null;
+    label?: string;
+    bindings?: string[];
+    basis?: string;
+    perBaseFactor?: number | null;
+    needsDensity?: boolean;
+    active?: boolean;
 }
 export interface RateLine {
     id: string;
     tenantId: string;
     code: string;
-    name: string;
-    kind: RateEntryKind;
+    label: string;
+    binding: string;
     allowedUoms: string[];
-    description: string | null;
-    sortOrder: number;
-    status: PlantStatus;
-    createdBy: string;
-    updatedBy: string;
+    defaultUom: string | null;
+    escalationDefault: number | null;
+    active: boolean;
     createdAt: string;
     updatedAt: string;
 }
 export interface CreateRateLineInput {
     code: string;
-    name: string;
-    kind: RateEntryKind;
+    label: string;
+    binding: string;
     allowedUoms?: string[];
-    description?: string;
-    sortOrder?: number;
+    defaultUom?: string | null;
+    escalationDefault?: number | null;
+    active?: boolean;
 }
 export interface UpdateRateLineInput {
-    name?: string;
-    kind?: RateEntryKind;
+    label?: string;
+    binding?: string;
     allowedUoms?: string[];
-    description?: string | null;
-    sortOrder?: number;
-    status?: 'active' | 'archived';
+    defaultUom?: string | null;
+    escalationDefault?: number | null;
+    active?: boolean;
 }
 export interface RateGrade {
     id: string;
     tenantId: string;
     code: string;
-    name: string;
-    materialId: string | null;
+    label: string;
+    allowedUoms: string[];
+    defaultUom: string;
     density: number | null;
-    status: PlantStatus;
-    createdBy: string;
-    updatedBy: string;
+    densityUnit: string | null;
+    active: boolean;
     createdAt: string;
     updatedAt: string;
 }
 export interface CreateRateGradeInput {
     code: string;
-    name: string;
-    materialId?: string | null;
+    label: string;
+    allowedUoms?: string[];
+    defaultUom: string;
     density?: number | null;
+    densityUnit?: string | null;
+    active?: boolean;
 }
 export interface UpdateRateGradeInput {
-    name?: string;
-    materialId?: string | null;
+    label?: string;
+    allowedUoms?: string[];
+    defaultUom?: string;
     density?: number | null;
-    status?: 'active' | 'archived';
+    densityUnit?: string | null;
+    active?: boolean;
 }
 export type ExchangeRateStatus = 'draft' | 'active' | 'archived';
 export type ExchangeRateScope = 'tenant' | 'global';
@@ -1039,8 +1104,15 @@ export interface Part {
     partNumber: string;
     /** Supplier's own number; nullable for customer-numbered parts. */
     manufacturingPartNumber: string | null;
+    /** Customer's own cross-reference number for this part. Additive alias only —
+     *  never an identity key; canonical key stays partNumber (Decision C). */
+    customerPartNumber: string | null;
     name: string;
     description: string | null;
+    /** Part-level (rev-invariant) attribute bag, governed by the tenant's
+     *  part-level attribute dictionary (Decision G). Rev-specific values are on
+     *  PartRevision.attributes. */
+    attributes: Record<string, unknown> | null;
     /** @deprecated free-text; use partTypeId (governed PartType catalog). */
     partType: string | null;
     /** The per-tenant PartType this part is classified as. */
@@ -1080,15 +1152,38 @@ export interface PartRevision {
     releaseStatus: string | null;
     leadTime: number | null;
     attributes: Record<string, unknown> | null;
+    /** Latest costed price per unit (string-serialized Decimal). */
+    latestUnitCost: string | null;
+    /** ISO 4217 currency of latestUnitCost. */
+    latestCostCurrency: string | null;
+    /** Opaque ref to the source CPQ quote (cross-app; not FK-validated). */
+    latestCostSourceQuoteId: string | null;
+    latestCostedAt: string | null;
+    latestCostContext: Record<string, unknown> | null;
     status: PartStatus;
     createdBy: string;
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
 }
+/** Input for `parts.setLatestCost` — the cost-owner-only snapshot write path
+ *  (Decision F). Mirrors the server's SetLatestCostInput. */
+export interface SetLatestCostInput {
+    /** Costed price per unit. Required, must be >= 0. */
+    unitCost: number;
+    /** ISO 4217 currency of unitCost (e.g. "USD"). */
+    currency?: string | null;
+    /** Opaque ref to the source CPQ quote (cross-app; not FK-validated). */
+    sourceQuoteId?: string | null;
+    /** When the cost was struck (ISO string). Defaults to now server-side. */
+    costedAt?: string | null;
+    /** Lossless extras about the costing (quote line id, volume band, etc.). */
+    context?: Record<string, unknown> | null;
+}
 export interface CreatePartInput {
     partNumber: string;
     manufacturingPartNumber?: string | null;
+    customerPartNumber?: string | null;
     name: string;
     description?: string | null;
     /** @deprecated free-text; use partTypeId. */
@@ -1097,10 +1192,14 @@ export interface CreatePartInput {
     partCategoryId?: string | null;
     manufacturer?: string | null;
     quality?: 'draft' | 'verified';
+    /** Part-level attribute bag; validated against the tenant's part-level
+     *  attribute dictionary (Decision G). */
+    attributes?: Record<string, unknown> | null;
 }
 export interface UpdatePartInput {
     partNumber?: string;
     manufacturingPartNumber?: string | null;
+    customerPartNumber?: string | null;
     name?: string;
     description?: string | null;
     /** @deprecated free-text; use partTypeId. */
@@ -1109,6 +1208,9 @@ export interface UpdatePartInput {
     partCategoryId?: string | null;
     manufacturer?: string | null;
     quality?: 'draft' | 'verified';
+    /** Part-level attribute bag; merged key-level (overwrite) into the existing
+     *  bag and validated against the tenant's part-level dictionary (Decision G). */
+    attributes?: Record<string, unknown> | null;
 }
 export interface CreatePartRevisionInput {
     revision: string;
@@ -1147,6 +1249,7 @@ export interface BatchUpsertPartInput {
     partNumber: string;
     name?: string;
     manufacturingPartNumber?: string | null;
+    customerPartNumber?: string | null;
     description?: string | null;
     partType?: string | null;
     partCategoryId?: string | null;
@@ -1162,7 +1265,12 @@ export interface BatchUpsertPartInput {
     pcfPerUnit?: number | null;
     releaseStatus?: string | null;
     leadTime?: number | null;
+    /** Revision-level (rev-specific) attribute bag; key-merged into the revision. */
     attributes?: Record<string, unknown> | null;
+    /** Part-level (rev-invariant) attribute bag; key-merged into Part.attributes.
+     *  Both bags are validated against the tenant's attribute dictionary by level
+     *  (Decision G) — a no-op while the dictionary is empty. */
+    partAttributes?: Record<string, unknown> | null;
 }
 export interface BatchUpsertPartsOptions {
     /** Which app is pushing these parts; recorded in FieldProvenance. Defaults to
@@ -1176,7 +1284,10 @@ export interface BatchUpsertPartsOptions {
 }
 /** Per-row outcome from a parts batch upsert. 'mergedFields' / 'untouched' only
  *  occur under mergePolicy='fill_empty'. `revisionCreated` is true when the row
- *  carried a `revision` that didn't already exist on the part. */
+ *  carried a `revision` that didn't already exist on the part. `filledFields`
+ *  are Part-header columns filled/overwritten; `mergedAttributeKeys` are
+ *  top-level `PartRevision.attributes` keys merged on an EXISTING revision
+ *  (Decision D — key-level attributes merge). */
 export interface BatchPartItemResult {
     index: number;
     status: 'created' | 'mergedFields' | 'untouched' | 'error';
@@ -1185,6 +1296,9 @@ export interface BatchPartItemResult {
     code?: string;
     filledFields?: string[];
     revisionCreated?: boolean;
+    /** Top-level attribute keys merged on an existing part/revision bag (Decision D
+     *  rev-level + Decision G part-level). Part-level keys are prefixed `part:`. */
+    mergedAttributeKeys?: string[];
 }
 export interface BatchUpsertPartsResult {
     results: BatchPartItemResult[];
@@ -1294,6 +1408,70 @@ export interface ListPartTypesOptions {
     /** When true, request only active types (drops archived). */
     activeOnly?: boolean;
 }
+export type AttributeDataType = 'text' | 'number' | 'boolean' | 'enum' | 'date';
+export type AttributeLevel = 'part' | 'revision';
+export type AttributeStatus = 'active' | 'archived';
+/** Typed rules stored per definition and enforced by the server on every
+ *  attribute write. `min`/`max` are value bounds for `number` and length bounds
+ *  for `text`; `regex` applies to `text`; `precision` is max decimal places for
+ *  `number`. `required` (v1) means "non-empty if present". */
+export interface AttributeValidation {
+    required?: boolean;
+    min?: number;
+    max?: number;
+    regex?: string;
+    precision?: number;
+}
+export interface PartAttributeDefinition {
+    id: string;
+    tenantId: string;
+    /** Stable machine key; joins to a JSON key in the value bag. Immutable. */
+    key: string;
+    label: string;
+    dataType: AttributeDataType;
+    level: AttributeLevel;
+    unit: string | null;
+    /** Allowed values when `dataType='enum'`; null otherwise. */
+    options: string[] | null;
+    group: string | null;
+    validation: AttributeValidation | null;
+    status: AttributeStatus;
+    sortOrder: number;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePartAttributeInput {
+    key: string;
+    label: string;
+    dataType: AttributeDataType;
+    level: AttributeLevel;
+    unit?: string | null;
+    options?: string[] | null;
+    group?: string | null;
+    validation?: AttributeValidation | null;
+    sortOrder?: number;
+}
+/** `key` is intentionally omitted — it's immutable once created. dataType/level
+ *  may be changed but only govern future writes (existing values aren't migrated). */
+export interface UpdatePartAttributeInput {
+    label?: string;
+    dataType?: AttributeDataType;
+    level?: AttributeLevel;
+    unit?: string | null;
+    options?: string[] | null;
+    group?: string | null;
+    validation?: AttributeValidation | null;
+    sortOrder?: number;
+    status?: AttributeStatus;
+}
+export interface ListPartAttributesOptions {
+    /** When true, request only active definitions (drops archived). */
+    activeOnly?: boolean;
+    /** Filter to one level (part | revision). */
+    level?: AttributeLevel;
+}
 export interface AuditLogEntry {
     id: string;
     tenantId: string | null;