@campfire-interactive/master-data-client 4.3.0 → 4.8.0

package/dist/rateCatalog.js

@@ -6,10 +6,14 @@ class UomResource {
     constructor(http) {
         this.http = http;
     }
+    /** Bug fix: this previously sent an `active` boolean param the backend
+     *  never read (listUoms had no status concept at all) — the Archived/All
+     *  filter silently no-opped. Now sends `status`, matching every other
+     *  entity's convention, paired with Uom's newly-added soft archive. */
     async list(options) {
         const query = {};
-        if (options?.active !== undefined)
-            query.active = String(options.active);
+        if (options?.status)
+            query.status = options.status;
         return this.http.request({
             method: 'GET',
             path: '/v1/rate-catalog/uoms',
@@ -30,24 +34,46 @@ class UomResource {
             body: input,
         });
     }
+    /** Hard delete. Prefer {@link batchArchive} for reversible removal. */
     async remove(id) {
         await this.http.request({
             method: 'DELETE',
             path: `/v1/rate-catalog/uoms/${encodeURIComponent(id)}`,
         });
     }
+    /** Archive many UoMs in one call (soft, flips `active`; distinct from the
+     *  hard {@link remove} above — new capability). Reversible via
+     *  {@link batchRestore}. */
+    async batchArchive(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/uoms/batch-archive',
+            body: { ids },
+        });
+    }
+    /** Restore (un-archive) many UoMs in one call. */
+    async batchRestore(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/uoms/batch-restore',
+            body: { ids },
+        });
+    }
 }
 class RateLineResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    /** Bug fix: this previously sent an `active` boolean param the backend
+     *  never read (it reads `status`) — the Archived/All filter silently
+     *  no-opped. Now sends `status`, matching every other entity. */
     async list(options) {
         const query = {};
         if (options?.binding)
             query.binding = options.binding;
-        if (options?.active !== undefined)
-            query.active = String(options.active);
+        if (options?.status)
+            query.status = options.status;
         return this.http.request({
             method: 'GET',
             path: '/v1/rate-catalog/lines',
@@ -68,22 +94,44 @@ class RateLineResource {
             body: input,
         });
     }
+    /** Hard delete. 2026-07-24: previously soft-archived (matched Archive), which made
+     *  the two indistinguishable; now really deletes. Prefer {@link batchArchive}
+     *  for reversible removal. */
     async remove(id) {
         await this.http.request({
             method: 'DELETE',
             path: `/v1/rate-catalog/lines/${encodeURIComponent(id)}`,
         });
     }
+    /** Archive many rate lines in one call. Reversible via {@link batchRestore}. */
+    async batchArchive(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/lines/batch-archive',
+            body: { ids },
+        });
+    }
+    /** Restore (un-archive) many rate lines in one call. */
+    async batchRestore(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/lines/batch-restore',
+            body: { ids },
+        });
+    }
 }
 class RateGradeResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    /** Bug fix: this previously sent an `active` boolean param the backend
+     *  never read (it reads `status`) — the Archived/All filter silently
+     *  no-opped. Now sends `status`, matching every other entity. */
     async list(options) {
         const query = {};
-        if (options?.active !== undefined)
-            query.active = String(options.active);
+        if (options?.status)
+            query.status = options.status;
         return this.http.request({
             method: 'GET',
             path: '/v1/rate-catalog/grades',
@@ -104,12 +152,31 @@ class RateGradeResource {
             body: input,
         });
     }
+    /** Hard delete. 2026-07-24: previously soft-archived (matched Archive), which made
+     *  the two indistinguishable; now really deletes. Prefer {@link batchArchive}
+     *  for reversible removal. */
     async remove(id) {
         await this.http.request({
             method: 'DELETE',
             path: `/v1/rate-catalog/grades/${encodeURIComponent(id)}`,
         });
     }
+    /** Archive many rate grades in one call. Reversible via {@link batchRestore}. */
+    async batchArchive(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/grades/batch-archive',
+            body: { ids },
+        });
+    }
+    /** Restore (un-archive) many rate grades in one call. */
+    async batchRestore(ids) {
+        return this.http.request({
+            method: 'POST',
+            path: '/v1/rate-catalog/grades/batch-restore',
+            body: { ids },
+        });
+    }
 }
 /**
  * Rate reference catalogs (UoM / RateLine / RateGrade) — the vocabulary a rate

package/dist/rateCatalog.js.map

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

package/dist/schedulePeriods.d.ts

@@ -0,0 +1,16 @@
+import type { SchedulePeriod } from './types';
+/** The recognisable shapes a span can take. `custom` = anything else. */
+export type SchedulePeriodGranularity = 'year' | 'quarter' | 'month' | 'fiscal-year' | 'custom';
+/**
+ * Classify a span by its shape. A period is only a `year` / `quarter` / `month`
+ * if it covers exactly that unit — a stretch that merely starts on Jan 1 but
+ * ends in November is `custom`, not a year, because calling it "2027" would
+ * overstate what the customer committed to.
+ */
+export declare function schedulePeriodGranularity(period: SchedulePeriod): SchedulePeriodGranularity;
+/**
+ * Human label for a span: `2027`, `Q2 2027`, `Mar 2027`, `FY 2026-27`, or a raw
+ * `2027-03-15 – 2027-04-28` range when the span matches no convention.
+ */
+export declare function formatSchedulePeriod(period: SchedulePeriod): string;
+//# sourceMappingURL=schedulePeriods.d.ts.map

package/dist/schedulePeriods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedulePeriods.d.ts","sourceRoot":"","sources":["../src/schedulePeriods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoB9C,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;AAmBhG;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,yBAAyB,CAmB3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAiBnE"}

package/dist/schedulePeriods.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schedulePeriodGranularity = schedulePeriodGranularity;
+exports.formatSchedulePeriod = formatSchedulePeriod;
+/**
+ * Display helpers for arbitrary-period schedules (`effectiveVolumesByPeriod` /
+ * `effectivePricesByPeriod`).
+ *
+ * Granularity is NOT stored on a schedule point — it's derivable from the span,
+ * and a stored label can contradict the dates. It lives here rather than in each
+ * consumer so every app labels the same span identically.
+ *
+ * Note there is deliberately no rollup helper here: the yearly rollup CPQ costs
+ * against is computed server-side at write time, so there is exactly one
+ * implementation of it and clients can't disagree with the stored column.
+ */
+const MONTHS = [
+    'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+    'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
+];
+function parts(iso) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(iso);
+    if (!m)
+        return null;
+    return { year: Number(m[1]), month: Number(m[2]), day: Number(m[3]) };
+}
+function lastDayOfMonth(year, month) {
+    return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+/**
+ * Classify a span by its shape. A period is only a `year` / `quarter` / `month`
+ * if it covers exactly that unit — a stretch that merely starts on Jan 1 but
+ * ends in November is `custom`, not a year, because calling it "2027" would
+ * overstate what the customer committed to.
+ */
+function schedulePeriodGranularity(period) {
+    const start = parts(period.periodStart);
+    const end = parts(period.periodEnd);
+    if (!start || !end)
+        return 'custom';
+    const endsMonth = end.day === lastDayOfMonth(end.year, end.month);
+    if (start.day !== 1 || !endsMonth)
+        return 'custom';
+    if (start.year === end.year) {
+        if (start.month === 1 && end.month === 12)
+            return 'year';
+        if (start.month === end.month)
+            return 'month';
+        // Calendar quarters only — Feb-Apr is a 3-month custom block, not "Q1".
+        if (end.month - start.month === 2 && (start.month - 1) % 3 === 0)
+            return 'quarter';
+        return 'custom';
+    }
+    // A 12-month span crossing exactly one year boundary reads as a fiscal year.
+    if (end.year === start.year + 1 && end.month === start.month - 1)
+        return 'fiscal-year';
+    return 'custom';
+}
+/**
+ * Human label for a span: `2027`, `Q2 2027`, `Mar 2027`, `FY 2026-27`, or a raw
+ * `2027-03-15 – 2027-04-28` range when the span matches no convention.
+ */
+function formatSchedulePeriod(period) {
+    const start = parts(period.periodStart);
+    const end = parts(period.periodEnd);
+    if (!start || !end)
+        return `${period.periodStart} – ${period.periodEnd}`;
+    switch (schedulePeriodGranularity(period)) {
+        case 'year':
+            return String(start.year);
+        case 'quarter':
+            return `Q${Math.floor((start.month - 1) / 3) + 1} ${start.year}`;
+        case 'month':
+            return `${MONTHS[start.month - 1]} ${start.year}`;
+        case 'fiscal-year':
+            return `FY ${start.year}-${String(end.year % 100).padStart(2, '0')}`;
+        default:
+            return `${period.periodStart} – ${period.periodEnd}`;
+    }
+}
+//# sourceMappingURL=schedulePeriods.js.map

package/dist/schedulePeriods.js.map

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

package/dist/types.d.ts

@@ -194,6 +194,9 @@ export interface Quote {
      * — the figure CPQ costs against. Seeded from OMSF's vehicle→part conversion
      * (VI vehicle × take rate), then the rep's edit over it. Independent of
      * {@link effectiveVolumesByYear}; neither is auto-derived from the other.
+     *
+     * **Unless {@link effectiveVolumesByPeriod} is set**, in which case this is
+     * DERIVED from it (the mean of the rolled-up years) and writing it is a 422.
      */
     effectiveAnnualVolume: number | null;
     /**
@@ -201,8 +204,36 @@ export interface Quote {
      * NOT vehicle/program) — the primary figure CPQ costs against. Stored as
      * JSONB; shape pinned here and at the API boundary. Seeded from OMSF's
      * vehicle→part conversion at quote creation, then refined by the rep.
+     *
+     * **Unless {@link effectiveVolumesByPeriod} is set**, in which case this is
+     * DERIVED from it at write time (day-count pro-rated for spans that straddle a
+     * year) and writing it is a 422. Readers need no change either way — this
+     * column stays the canonical yearly curve.
      */
     effectiveVolumesByYear: EffectiveVolumeByYear[] | null;
+    /**
+     * Customer-committed PART volume on ARBITRARY periods — the general form of
+     * {@link effectiveVolumesByYear}, for deals tracked at a granularity the year
+     * key can't express (monthly launch ramp with annual out-years, fiscal years,
+     * irregular blocks). When non-empty it is AUTHORITATIVE and the two fields
+     * above are derived from it.
+     *
+     * Independent of {@link effectivePricesByPeriod}: no point pairs with a price
+     * point, either may exist alone, and the two period grids may disagree.
+     * Overlapping periods within this series are rejected (422). (4.8.0)
+     */
+    effectiveVolumesByPeriod: EffectiveVolumeByPeriod[] | null;
+    /**
+     * Customer-committed unit price on ARBITRARY periods — the price walk / LTA
+     * step-down the customer agreed to.
+     *
+     * **Derives nothing.** {@link effectiveUnitPrice} keeps its adapter-written
+     * provenance (`effectivePriceSource` / `effectivePricedAt` / …) and is
+     * untouched by this field, so no margin figure moves when a schedule is
+     * imported. Readers wanting one headline number from this series must decide
+     * how to weight it (volume-weighted, not a mean). (4.8.0)
+     */
+    effectivePricesByPeriod: EffectivePriceByPeriod[] | null;
     status: QuoteStatus;
     /** rfq | eco — see {@link QuoteType}. Immutable post-create. (3.0.2) */
     quoteType: QuoteType;
@@ -231,6 +262,28 @@ export interface EffectiveVolumeByYear {
     year: number;
     effectiveVolume: number;
 }
+/**
+ * One inclusive period in an arbitrary-period schedule. Every granularity is a
+ * span, so yearly (`2027-01-01`→`2027-12-31`), quarterly, monthly, fiscal
+ * (`2026-07-01`→`2027-06-30`) and irregular stretches are all the same shape,
+ * and a single quote may mix them. Granularity is deliberately not stored —
+ * derive it from the span (see `formatSchedulePeriod`). (4.8.0)
+ */
+export interface SchedulePeriod {
+    /** ISO date, inclusive. */
+    periodStart: string;
+    /** ISO date, inclusive. */
+    periodEnd: string;
+}
+/** Row inside {@link Quote.effectiveVolumesByPeriod}. (4.8.0) */
+export interface EffectiveVolumeByPeriod extends SchedulePeriod {
+    effectiveVolume: number;
+}
+/** Row inside {@link Quote.effectivePricesByPeriod}. Decimal-as-string, like
+ *  {@link Quote.targetPrice}. (4.8.0) */
+export interface EffectivePriceByPeriod extends SchedulePeriod {
+    effectiveUnitPrice: string;
+}
 export interface SetEffectiveCostInput {
     unitCost: number;
     /** 'cpq' | 'manual' | 'external' — declared by the adapter. */
@@ -285,6 +338,11 @@ export interface CreateQuoteInput {
     eopPrecision?: SopEopPrecision;
     effectiveAnnualVolume?: number;
     effectiveVolumesByYear?: EffectiveVolumeByYear[];
+    /** Arbitrary-period committed volume. Non-empty makes the two fields above
+     *  derived — passing either alongside it is a 422. (4.8.0) */
+    effectiveVolumesByPeriod?: EffectiveVolumeByPeriod[];
+    /** Arbitrary-period committed unit price. Storage only. (4.8.0) */
+    effectivePricesByPeriod?: EffectivePriceByPeriod[];
     /**
      * Quote type — defaults to 'rfq'. Immutable post-create. When 'eco',
      * `referenceQuoteId` becomes REQUIRED and must point to an in-tenant,
@@ -296,6 +354,8 @@ export interface CreateQuoteInput {
     baselineUnitPrice?: number | string;
     /** ECO-only (422 otherwise): frozen as-awarded unit cost. (3.0.2) */
     baselineUnitCost?: number | string;
+    /** Defaults to 'draft' (the model default) if omitted. */
+    quality?: 'draft' | 'verified';
 }
 /**
  * Non-status fields only. Status changes go through `transitionStatus(...)`
@@ -325,6 +385,13 @@ export interface UpdateQuoteInput {
     eopPrecision?: SopEopPrecision | null;
     effectiveAnnualVolume?: number | null;
     effectiveVolumesByYear?: EffectiveVolumeByYear[] | null;
+    /** Full replace. Non-empty makes the yearly fields derived (writing them is a
+     *  422); `null` or `[]` clears the schedule and hands them back. The last
+     *  derived values are left in place — clearing stops maintaining them, it
+     *  doesn't wipe the curve. (4.8.0) */
+    effectiveVolumesByPeriod?: EffectiveVolumeByPeriod[] | null;
+    /** Full replace. Storage only, independent of the volume schedule. (4.8.0) */
+    effectivePricesByPeriod?: EffectivePriceByPeriod[] | null;
     quality?: 'draft' | 'verified';
 }
 export interface TransitionQuoteStatusInput {
@@ -374,8 +441,48 @@ export interface GetQuoteOptions {
 export type EcStatus = 'requested' | 'triaged' | 'converted' | 'partially_applied' | 'applied' | 'cancelled';
 /** Engineering-change driver taxonomy — mirrors CPQ's EcChangeDriver (F6). */
 export type EcChangeDriver = 'material' | 'routing' | 'capital' | 'other';
-/** Which app is writing — gated per-endpoint server-side. */
-export type EcCallerRole = 'omsf' | 'cpq' | 'admin';
+/** Which app is writing — gated per-endpoint server-side. `bom` and `omsf` are
+ *  create-only intake sources; convert + status are `cpq`/`admin`. */
+export type EcCallerRole = 'omsf' | 'bom' | 'cpq' | 'admin';
+/** A part/assembly reference inside {@link EngineeringChangeDetail}. */
+export interface EngineeringChangeDetailPartRef {
+    partId: string;
+    partNumber: string;
+    name: string;
+}
+/** Per-BOM impact inside {@link EngineeringChangeDetail}. */
+export interface EngineeringChangeDetailBomImpact {
+    bomType: string;
+    bomVersionId: string;
+    partsAffectedCount: number;
+    costDeltaCents: number;
+    marginDeltaBps: number | null;
+    annualImpactCents: number;
+    summary: string;
+}
+/**
+ * Structured change detail authored by a rich intake source (BOM) so the EC is
+ * self-describing for CPQ + Program Management without reaching back into the
+ * originating app. Discriminated by `source`; validated server-side on write.
+ * Absent (null) for thin intake (OMSF sends free-text `description` only). See
+ * the BOM cutover plan bom/docs/plans/2026-07-23-bom-raises-engineering-change.md (D6).
+ */
+export interface EngineeringChangeDetail {
+    /** The only rich shape defined in v1. */
+    source: 'bom';
+    changeType: string;
+    fromValue: string | null;
+    toValue: string | null;
+    reason: string | null;
+    affectedParts: EngineeringChangeDetailPartRef[];
+    affectedAssemblies: EngineeringChangeDetailPartRef[];
+    affectedBoms: EngineeringChangeDetailBomImpact[];
+    totals: {
+        partsAffectedCount: number;
+        subassembliesAffectedCount: number;
+        totalCostDeltaCents: number;
+    };
+}
 /**
  * An engineering change — the grouping entity correlating the N member ECO
  * quotes one change fans out to. master-data owns this identity; OMSF and CPQ
@@ -404,6 +511,10 @@ export interface EngineeringChange {
     /** Stored, inert in v1 — effectivity semantics (phasing, per-part) are not
      *  yet decided, so no consumer may compute off this. Date serialized as string. */
     effectiveDate: string | null;
+    /** Structured change detail (D6) authored by a rich intake source (BOM).
+     *  Null for thin intake (OMSF). Descriptive metadata — not structural
+     *  membership (that stays quote-grain via {@link memberQuoteIds}). */
+    changeDetail: EngineeringChangeDetail | null;
     createdAt: string;
     updatedAt: string;
     /** Member ECO quote ids (quote-grain membership). Populated on {@link get}. */
@@ -415,8 +526,11 @@ export interface CreateEngineeringChangeInput {
     description: string;
     requestedById: string;
     requestedByName: string;
-    /** Gated server-side to 'omsf' | 'cpq'. */
+    /** Gated server-side to 'omsf' | 'bom' | 'cpq' | 'admin' (create is intake). */
     callerRole: EcCallerRole;
+    /** Optional structured change detail (D6). Validated server-side against the
+     *  {@link EngineeringChangeDetail} shape; omit for thin intake (OMSF). */
+    changeDetail?: EngineeringChangeDetail;
 }
 /** Fan-out conversion — CPQ stamps number, title, driver, and members. */
 export interface ConvertEngineeringChangeInput {
@@ -558,6 +672,11 @@ export interface ListPlantsOptions {
     cursor?: string;
     sort?: string;
     q?: string;
+    status?: 'active' | 'archived' | 'all';
+    /** @deprecated Never actually reached the backend filter (it reads
+     *  `status`, not `active`) — use `status` instead. Kept only so any
+     *  existing caller that sets this doesn't hit a type error; has no
+     *  effect. */
     active?: boolean;
     country?: string;
     region?: string;
@@ -965,6 +1084,10 @@ export interface ListEquipmentOptions {
     q?: string;
     plantId?: string;
     processFamily?: string;
+    status?: 'active' | 'archived' | 'all';
+    /** @deprecated Never actually reached the backend filter (it reads
+     *  `status`, not `active`) — use `status` instead. Kept only so any
+     *  existing caller that sets this doesn't hit a type error; has no effect. */
     active?: boolean;
 }
 export interface ProcessFamily {
@@ -1640,7 +1763,7 @@ export interface UpdateLocationInput {
     country?: string;
 }
 export type ImportStatus = 'pending_upload' | 'pending_parse' | 'pending_mapping' | 'pending_validation' | 'validated' | 'committed' | 'failed';
-export type ImportEntityType = 'company' | 'contact' | 'location' | 'plant' | 'material' | 'rate_library' | 'rate_entries';
+export type ImportEntityType = 'company' | 'contact' | 'location' | 'plant' | 'material' | 'part' | 'part_category' | 'program' | 'rate_library' | 'rate_entries' | 'equipment' | 'process_family' | 'part_type' | 'exchange_rate' | 'quote' | 'part_attribute' | 'uom' | 'rate_line' | 'rate_grade';
 export type ImportSheetAssignment = ImportEntityType | 'skip';
 /** Identifies which app initiated an import session. Cross-app callers
  *  (anything other than 'master-data') are limited to a subset of entity
@@ -1657,7 +1780,7 @@ export type SourceApp = 'master-data' | 'erfq' | 'cpq' | 'bom' | 'forecast' | 'o
  *  "Empty" means SQL NULL only — a stored '', 0, false, or 0.0 counts as
  *  populated and will not be overwritten by fill_empty. */
 export type MergePolicy = 'overwrite' | 'fill_empty';
-export type ImportTargetField = 'name' | 'legalName' | 'code' | 'taxId' | 'dunsNumber' | 'website' | 'logoUrl' | 'roles' | 'email' | 'phone' | 'role' | 'type' | 'description' | 'street' | 'city' | 'stateProvince' | 'postalCode' | 'country' | 'category' | 'parent_company_ref' | 'companyCode' | 'locationCode' | 'region' | 'headcount' | 'annualCapacityHours' | 'currentUtilization' | 'riskLevel' | 'numShifts' | 'hoursPerShift' | 'workingDaysPerYear' | 'indirectHeadcountPct' | 'currency' | 'effectiveDate' | 'effectiveTo' | 'libraryCode' | 'kind' | 'plantCode' | 'skillTier' | 'materialCode' | 'regionCode' | 'lane' | 'rate' | 'unit' | 'sourcingMode' | 'indexRef' | 'notes';
+export type ImportTargetField = 'name' | 'legalName' | 'code' | 'taxId' | 'dunsNumber' | 'website' | 'logoUrl' | 'roles' | 'email' | 'phone' | 'role' | 'type' | 'description' | 'street' | 'city' | 'stateProvince' | 'postalCode' | 'country' | 'category' | 'parent_company_ref' | 'companyCode' | 'locationCode' | 'region' | 'headcount' | 'annualCapacityHours' | 'currentUtilization' | 'riskLevel' | 'numShifts' | 'hoursPerShift' | 'workingDaysPerYear' | 'indirectHeadcountPct' | 'currency' | 'effectiveDate' | 'effectiveTo' | 'libraryCode' | 'kind' | 'plantCode' | 'skillTier' | 'materialCode' | 'regionCode' | 'lane' | 'rate' | 'unit' | 'sourcingMode' | 'indexRef' | 'notes' | 'partNumber' | 'manufacturingPartNumber' | 'customerPartNumber' | 'partType' | 'manufacturer' | 'partCategoryCode' | 'quality' | 'revision' | 'uom' | 'weightPerUnit' | 'recycledPct' | 'pcfPerUnit' | 'releaseStatus' | 'leadTime' | 'customerCompanyCode' | 'customerCompanyName' | 'sopDate' | 'eopDate' | 'displayOrder' | 'label' | 'sortOrder' | 'processFamily' | 'capacityHoursPerYear' | 'cavities' | 'availabilityPct' | 'performancePct' | 'defaultHeadcount' | 'defaultAutomationPct' | 'defaultMachinesPerOperator' | 'defaultSetupCrew' | 'perUsd' | 'effectiveFrom' | 'quoteNumber' | 'programCode' | 'partId' | 'regionName' | 'annualVolume' | 'apw' | 'mpw' | 'targetPrice' | 'dueDate' | 'key' | 'dataType' | 'options' | 'group' | 'required' | 'min' | 'max' | 'regex' | 'precision' | 'basis' | 'bindings' | 'perBaseFactor' | 'needsDensity' | 'binding' | 'allowedUoms' | 'defaultUom' | 'escalationDefault' | 'density' | 'densityUnit';
 export interface ImportSession {
     id: string;
     tenantId: string;
@@ -1682,7 +1805,7 @@ export interface CreateImportInput {
     filename: string;
     /** Session root entity type. The workbook may contain other entity types in
      *  additional sheets, but this names the "primary" import. */
-    entityType: 'company' | 'plant' | 'material' | 'rate_library';
+    entityType: 'company' | 'plant' | 'material' | 'part' | 'part_category' | 'program' | 'rate_library' | 'equipment' | 'process_family' | 'part_type' | 'exchange_rate' | 'quote' | 'part_attribute' | 'uom';
     /** Which app is initiating this upload. Cross-app callers (non-'master-data')
      *  are gated to a subset of entity types via the server's allowlist. Default
      *  is 'master-data'. */
@@ -1895,6 +2018,10 @@ export interface ImportCommitResult {
     locations?: BatchCreateChildResult;
     plants?: BatchCreateChildResult;
     materials?: BatchCreateMaterialsResult;
+    /** Parts share the material-style extended summary (mergedFields/untouched). */
+    parts?: BatchCreateMaterialsResult;
+    programs?: BatchCreateChildResult;
+    partCategories?: BatchCreateChildResult;
     rateLibraries?: BatchCreateChildResult;
     rateEntries?: BatchCreateChildResult;
     /** Child rows skipped because their parent failed to commit (contacts /
@@ -1903,6 +2030,32 @@ export interface ImportCommitResult {
      *  materialCode/regionCode didn't resolve). */
     orphansSkipped: number;
 }
+/** Downloadable blank import template. Served inline as base64 (no storage
+ *  round-trip; works identically in local dev and prod). The client decodes
+ *  `contentBase64` → Blob and triggers a browser download. */
+export interface TemplateDownload {
+    filename: string;
+    mimeType: string;
+    contentBase64: string;
+}
+/** Result envelope for bulk archive / restore. `ok` counts rows whose status
+ *  flipped (or were already in the target state — idempotent). */
+export interface BulkArchiveResult {
+    results: Array<{
+        id: string;
+        status: 'ok';
+    } | {
+        id: string;
+        status: 'error';
+        error: string;
+        code: string;
+    }>;
+    summary: {
+        total: number;
+        ok: number;
+        errors: number;
+    };
+}
 export interface ApiMeta {
     requestId: string;
     timestamp: string;