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

package/dist/types.d.ts

@@ -111,7 +111,7 @@ export type QuoteStatus = 'draft' | 'costing_requested' | 'costing_in_progress'
  */
 export type QuoteCallerRole = 'omsf' | 'cpq' | 'admin';
 /**
- * Quote type discriminator (added 3.1.0). `rfq` = new-business quote (the
+ * Quote type discriminator (added 3.0.2). `rfq` = new-business quote (the
  * default and the only kind before 2026-07). `eco` = Engineering Change
  * Order quote — a change against an already-awarded quote's assembly,
  * priced and approved as its own quote. Immutable post-create. When 'eco',
@@ -204,13 +204,13 @@ export interface Quote {
      */
     effectiveVolumesByYear: EffectiveVolumeByYear[] | null;
     status: QuoteStatus;
-    /** rfq | eco — see {@link QuoteType}. Immutable post-create. (3.1.0) */
+    /** rfq | eco — see {@link QuoteType}. Immutable post-create. (3.0.2) */
     quoteType: QuoteType;
     /**
      * ECO-only: the source quote's as-awarded unit price/cost, frozen at ECO
      * creation. The stored operands for delta reporting — readers compute
      * delta = effective − baseline; the delta itself is never stored. Always
-     * null on rfq-type quotes. Decimal-as-string like targetPrice. (3.1.0)
+     * null on rfq-type quotes. Decimal-as-string like targetPrice. (3.0.2)
      */
     baselineUnitPrice: string | null;
     baselineUnitCost: string | null;
@@ -288,13 +288,13 @@ export interface CreateQuoteInput {
     /**
      * Quote type — defaults to 'rfq'. Immutable post-create. When 'eco',
      * `referenceQuoteId` becomes REQUIRED and must point to an in-tenant,
-     * AWARDED, non-eco quote (server-validated). (3.1.0)
+     * AWARDED, non-eco quote (server-validated). (3.0.2)
      */
     quoteType?: QuoteType;
     /** ECO-only (422 otherwise): frozen as-awarded unit price of the source
-     *  quote. Decimal as number or string; string preferred. (3.1.0) */
+     *  quote. Decimal as number or string; string preferred. (3.0.2) */
     baselineUnitPrice?: number | string;
-    /** ECO-only (422 otherwise): frozen as-awarded unit cost. (3.1.0) */
+    /** ECO-only (422 otherwise): frozen as-awarded unit cost. (3.0.2) */
     baselineUnitCost?: number | string;
 }
 /**
@@ -356,7 +356,7 @@ export interface ListQuotesOptions {
     quality?: 'draft' | 'verified';
     customerCompanyId?: string;
     programId?: string;
-    /** Filter by quote type. Omitting returns both kinds. (3.1.0) */
+    /** Filter by quote type. Omitting returns both kinds. (3.0.2) */
     quoteType?: QuoteType;
     include?: ('customerCompany' | 'program')[];
 }
@@ -407,96 +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 (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). 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;
+    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;
+    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. */
@@ -505,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;
 }
@@ -533,152 +524,485 @@ 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 interface RateLibrary {
+export type RateRollForwardMode = 'carry_forward_flagged' | 'blank_force_entry';
+export type RateValueOrigin = 'entered' | 'escalated' | 'overridden' | 'carried_forward';
+/** 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;
-    status: RateLibraryStatus;
-    quality: 'draft' | 'verified';
-    version: number;
+    currency: string;
+    horizonStart: number;
+    horizonEnd: number;
+    escalationPct: number;
+    rollForwardMode: RateRollForwardMode;
     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;
-    skillTier: string | null;
-    materialId: string | null;
-    regionId: 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;
+    /** 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;
-    unit: string;
     currency: string;
+    uom: string;
+    ratePerKg: string | null;
     sourcingMode: RateSourcingMode;
-    indexRef: string | null;
-    lastSyncedAt: string | null;
-    notes: string | null;
-    createdBy: string;
-    updatedBy: string;
+    sourceSystem: string | null;
+    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;
+    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';
+    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;
-    skillTier?: string | null;
-    materialId?: string | null;
-    regionId?: string | null;
-    lane?: string | null;
+    category: string;
+    subcategory: string;
+    region?: string | null;
     /** Number accepted; string preferred for precision. */
     rate: number | string;
     unit: string;
-    currency?: string;
-    sourcingMode?: RateSourcingMode;
-    indexRef?: string | null;
+    effectiveDate: string;
     notes?: string | null;
-}
-export interface UpdateRateEntryInput {
+    key?: string | null;
+    alias?: string | null;
+    type?: string | null;
     plantId?: string | null;
+    plantSubtype?: string | null;
     skillTier?: string | null;
-    materialId?: string | null;
-    regionId?: string | null;
     lane?: string | null;
+    mode?: 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 UpdateRateEntryInput {
+    category?: string;
+    subcategory?: string;
+    region?: string | null;
     rate?: number | string;
     unit?: string;
-    currency?: string;
-    sourcingMode?: RateSourcingMode;
-    indexRef?: 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;
+    plantSubtype?: string | null;
     skillTier?: string | null;
-    materialId?: string | null;
-    regionId?: string | null;
     lane?: string | null;
+    mode?: 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;
-    unit: string;
+    /** Decimal serialized as string; null when not a mass-basis material rate. */
+    ratePerKg: string | null;
+    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;
-        skillTier: string | null;
-        materialId: string | null;
-        regionId: string | null;
+        equipmentCode: string | null;
+        equipmentId: string | null;
+        skillClass: string | null;
+        gradeCode: string | null;
         lane: string | null;
+        mode: string | null;
+        container: string | null;
     };
 }
+export interface Equipment {
+    id: string;
+    tenantId: string;
+    plantId: string;
+    code: string;
+    name: string;
+    processFamily: string;
+    capacityHoursPerYear: number;
+    cavities: number;
+    /** OEE availability factor (0..1). */
+    availabilityPct: number;
+    /** OEE performance factor (0..1). */
+    performancePct: number;
+    /** CPQ-authored operational defaults — advisory metadata for non-CPQ apps. */
+    defaultHeadcount: number;
+    defaultAutomationPct: number;
+    defaultMachinesPerOperator: number;
+    defaultSetupCrew: number;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateEquipmentInput {
+    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;
+}
+export interface UpdateEquipmentInput {
+    code?: string;
+    name?: string;
+    processFamily?: string;
+    capacityHoursPerYear?: number;
+    cavities?: number;
+    availabilityPct?: number;
+    performancePct?: number;
+    defaultHeadcount?: number;
+    defaultAutomationPct?: number;
+    defaultMachinesPerOperator?: number;
+    defaultSetupCrew?: number;
+    active?: boolean;
+}
+export interface ListEquipmentOptions {
+    limit?: number;
+    cursor?: string;
+    sort?: string;
+    q?: string;
+    plantId?: string;
+    processFamily?: string;
+    active?: boolean;
+}
+export interface ProcessFamily {
+    id: string;
+    tenantId: string | null;
+    code: string;
+    label: string;
+    category: string;
+    sortOrder: number;
+    active: boolean;
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateProcessFamilyInput {
+    code: string;
+    label: string;
+    category: string;
+    sortOrder?: number;
+    active?: boolean;
+    isDefault?: boolean;
+}
+export interface UpdateProcessFamilyInput {
+    label?: string;
+    category?: string;
+    sortOrder?: number;
+    active?: boolean;
+    isDefault?: boolean;
+}
+export interface Uom {
+    id: string;
+    tenantId: string | null;
+    code: string;
+    label: string;
+    bindings: string[];
+    basis: string;
+    perBaseFactor: number | null;
+    needsDensity: boolean;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateUomInput {
+    code: string;
+    label: string;
+    bindings?: string[];
+    basis: string;
+    perBaseFactor?: number | null;
+    needsDensity?: boolean;
+    active?: boolean;
+}
+export interface UpdateUomInput {
+    label?: string;
+    bindings?: string[];
+    basis?: string;
+    perBaseFactor?: number | null;
+    needsDensity?: boolean;
+    active?: boolean;
+}
+export interface RateLine {
+    id: string;
+    tenantId: string;
+    code: string;
+    label: string;
+    binding: string;
+    allowedUoms: string[];
+    defaultUom: string | null;
+    escalationDefault: number | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateRateLineInput {
+    code: string;
+    label: string;
+    binding: string;
+    allowedUoms?: string[];
+    defaultUom?: string | null;
+    escalationDefault?: number | null;
+    active?: boolean;
+}
+export interface UpdateRateLineInput {
+    label?: string;
+    binding?: string;
+    allowedUoms?: string[];
+    defaultUom?: string | null;
+    escalationDefault?: number | null;
+    active?: boolean;
+}
+export interface RateGrade {
+    id: string;
+    tenantId: string;
+    code: string;
+    label: string;
+    allowedUoms: string[];
+    defaultUom: string;
+    density: number | null;
+    densityUnit: string | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateRateGradeInput {
+    code: string;
+    label: string;
+    allowedUoms?: string[];
+    defaultUom: string;
+    density?: number | null;
+    densityUnit?: string | null;
+    active?: boolean;
+}
+export interface UpdateRateGradeInput {
+    label?: string;
+    allowedUoms?: string[];
+    defaultUom?: string;
+    density?: number | null;
+    densityUnit?: string | null;
+    active?: boolean;
+}
 export type ExchangeRateStatus = 'draft' | 'active' | 'archived';
 export type ExchangeRateScope = 'tenant' | 'global';
 export interface ExchangeRate {
@@ -780,9 +1104,19 @@ 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. */
+    partTypeId: string | null;
     /** The per-tenant PartCategory this part belongs to. */
     partCategoryId: string | null;
     manufacturer: string | null;
@@ -795,6 +1129,9 @@ export interface Part {
     createdAt: string;
     updatedAt: string;
     partCategory?: PartCategory;
+    /** Resolved PartType (?include=partType). Named partTypeRef server-side during
+     *  the additive window; exposed here as the resolved catalog row. */
+    partTypeRef?: PartType;
     currentRevision?: PartRevision;
     revisions?: PartRevision[];
     /** Which app most-recently wrote any field on this row (provenance). */
@@ -815,31 +1152,65 @@ 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. */
     partType?: string | null;
+    partTypeId?: string | null;
     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. */
     partType?: string | null;
+    partTypeId?: string | null;
     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;
@@ -862,6 +1233,7 @@ export interface ListPartsOptions {
     status?: PartStatus | 'all';
     quality?: 'draft' | 'verified';
     partCategoryId?: string;
+    partTypeId?: string;
     partType?: string;
     manufacturer?: string;
     include?: string[];
@@ -877,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;
@@ -892,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
@@ -906,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';
@@ -915,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[];
@@ -974,6 +1358,120 @@ export interface ListPartCategoriesOptions {
     /** When true, request only active categories (drops archived). */
     activeOnly?: boolean;
 }
+export interface PartTypeDefault {
+    id: string;
+    code: string;
+    name: string;
+    displayOrder: number;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePartTypeDefaultInput {
+    code: string;
+    name: string;
+    displayOrder?: number;
+}
+export interface UpdatePartTypeDefaultInput {
+    code?: string;
+    name?: string;
+    displayOrder?: number;
+}
+export type PartTypeStatus = 'active' | 'archived';
+export interface PartType {
+    id: string;
+    tenantId: string;
+    code: string;
+    name: string;
+    displayOrder: number;
+    status: PartTypeStatus;
+    /** True for tool-seeded defaults: protected (no delete/archive/code-change). */
+    isDefault: boolean;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePartTypeInput {
+    code: string;
+    name: string;
+    displayOrder?: number;
+}
+export interface UpdatePartTypeInput {
+    code?: string;
+    name?: string;
+    displayOrder?: number;
+    status?: PartTypeStatus;
+}
+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;