@happyvertical/smrt-manufacturing 0.53.4 → 0.53.6

package/dist/services/RoutingService.d.ts

@@ -0,0 +1,50 @@
+/**
+ * RoutingService — read and replace the routing of a bill of materials.
+ *
+ * A routing is the ordered list of {@link RoutingStep} rows for one bill.
+ * It is optional; a bill with none is valid. `replaceRouting` swaps the whole
+ * list in one transaction, so reordering, inserting and removing steps are one
+ * operation and a bill never shows a half-written routing.
+ *
+ * @packageDocumentation
+ */
+import { type DatabaseConfig } from '@happyvertical/smrt-core';
+import { BillOfMaterialsCollection } from '../collections/BillOfMaterialsCollection.js';
+import { OperationCollection } from '../collections/OperationCollection.js';
+import { RoutingStepCollection } from '../collections/RoutingStepCollection.js';
+import type { RoutingStep } from '../models/RoutingStep.js';
+import { type RoutingStepInput } from '../operation-types.js';
+/** Options accepted by {@link RoutingService.create}. */
+export interface RoutingServiceOptions {
+    db: DatabaseConfig;
+}
+export declare class RoutingService {
+    private readonly db;
+    readonly boms: BillOfMaterialsCollection;
+    readonly operations: OperationCollection;
+    readonly steps: RoutingStepCollection;
+    private constructor();
+    /** Factory — prefer {@link createRoutingService}. */
+    static create(options: RoutingServiceOptions): Promise<RoutingService>;
+    /** The routing of a bill in step order; empty when it has none. */
+    list(bomId: string): Promise<RoutingStep[]>;
+    /**
+     * Check `inputs` against the routing about to be replaced: durations,
+     * operations, and that a retired operation is not added beyond the
+     * occurrences `current` already has.
+     */
+    private validate;
+    /**
+     * Replace the bill's routing with `inputs`, numbered 1..n in the order given.
+     * An empty list removes the routing.
+     *
+     * Throws {@link BomNotFoundError}, {@link OperationNotFoundError},
+     * {@link OperationRetiredError} (a retired operation may stay on a routing
+     * that already has it but cannot be newly added), or
+     * {@link InvalidOperationInputError} for a negative or non-finite duration.
+     */
+    replaceRouting(bomId: string, inputs: readonly RoutingStepInput[]): Promise<RoutingStep[]>;
+}
+/** Convenience factory. */
+export declare function createRoutingService(options: RoutingServiceOptions): Promise<RoutingService>;
+//# sourceMappingURL=RoutingService.d.ts.map

package/dist/services/RoutingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingService.d.ts","sourceRoot":"","sources":["../../src/services/RoutingService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,cAAc,CAAC;CACpB;AAMD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,EAAE;aACH,IAAI,EAAE,yBAAyB;aAC/B,UAAU,EAAE,mBAAmB;aAC/B,KAAK,EAAE,qBAAqB;IAJ9C,OAAO;IAOP,qDAAqD;WACxC,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAU5E,mEAAmE;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIjD;;;;OAIG;YACW,QAAQ;IAyBtB;;;;;;;;OAQG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,OAAO,CAAC,WAAW,EAAE,CAAC;CAoD1B;AAiBD,2BAA2B;AAC3B,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAEzB"}

package/dist/services/index.d.ts

@@ -3,7 +3,12 @@
  *
  * @packageDocumentation
  */
+export { AssemblyService, type AssemblyServiceOptions, type BillStructure, type BillStructureLine, BomCycleError, type BomCyclePathEntry, type ComponentKind, createAssemblyService, type ResolveComponentOptions, type ResolvedComponent, } from './AssemblyService.js';
 export { BomService, type BomServiceOptions, type ComponentCostResolver, createBomService, } from './BomService.js';
 export { type InstalledManufacturingDispatchHandlers, type InstallManufacturingDispatchHandlersOptions, installManufacturingDispatchHandlers, type ProductionOrderCompletedPayload, type ProductionOrderPostedPayload, } from './dispatch-handlers.js';
+export { createOperationService, OperationService, type OperationServiceOptions, } from './OperationService.js';
+export { createProductionRunService, ProductionRunService, type ProductionRunServiceOptions, } from './ProductionRunService.js';
 export { type ConsumeMaterialsOptions, type ConsumeResult, createProductionService, type ProduceFinishedGoodsOptions, type ProduceResult, type ProductionOrderRef, ProductionService, type ProductionServiceOptions, } from './ProductionService.js';
+export { createRoutingService, RoutingService, type RoutingServiceOptions, } from './RoutingService.js';
+export { BomStructureCycleError } from './structure-walk.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,sCAAsC,EAC3C,KAAK,2CAA2C,EAChD,oCAAoC,EACpC,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,sCAAsC,EAC3C,KAAK,2CAA2C,EAChD,oCAAoC,EACpC,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/services/structure-walk.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The shared step of every multi-level walk in {@link BomService}: read a
+ * bill's lines, resolve each component, and decide whether to open a
+ * sub-assembly's active bill. Explosion, planning, cost and labour all walk
+ * the same way through this class, so they agree on what is opened.
+ *
+ * A walk is bounded three ways: by the caller's `levels`, by
+ * {@link MAX_EXPLOSION_DEPTH} and {@link MAX_EXPLOSION_LINES}, and by the path
+ * of products above the current line, which turns a cycle already present in
+ * stored data into a {@link BomStructureCycleError} instead of a loop.
+ *
+ * @internal
+ * @packageDocumentation
+ */
+import type { BillOfMaterials } from '../models/BillOfMaterials.js';
+import type { BomLine } from '../models/BomLine.js';
+import { type ExplosionLevels, type ExplosionPathEntry } from '../types.js';
+import { type AssemblyService, BomCycleError, type BomCyclePathEntry, type ResolvedComponent } from './AssemblyService.js';
+/**
+ * Thrown when a multi-level walk meets a product that already contains
+ * itself in stored data (a loop saved before cycle refusal existed, or
+ * written around it). Carries the loop as `path`, like the
+ * {@link BomCycleError} it extends.
+ */
+export declare class BomStructureCycleError extends BomCycleError {
+    name: string;
+    constructor(bomId: string, path: BomCyclePathEntry[]);
+}
+/**
+ * The deepest level a walk may open for `levels`. Throws for anything that is
+ * not a whole number from 1 to {@link MAX_EXPLOSION_DEPTH} or `'all'`.
+ */
+export declare function maxLevelFor(levels: ExplosionLevels | undefined): number;
+/** `true` when the caller asked for a walk rather than the single-level form. */
+export declare function isMultiLevel(levels: ExplosionLevels | undefined): boolean;
+/** One walk from one top bill; caches what it reads for the walk's lifetime. */
+export declare class StructureWalk {
+    private readonly assemblies;
+    /** The bill the walk starts from. */
+    readonly top: BillOfMaterials;
+    /** The caller's `levels`. */
+    readonly levels: ExplosionLevels;
+    private readonly components;
+    private readonly bills;
+    private lineCount;
+    /** The deepest level whose lines the walk reads. */
+    readonly maxLevel: number;
+    constructor(assemblies: AssemblyService, 
+    /** The bill the walk starts from. */
+    top: BillOfMaterials, 
+    /** The caller's `levels`. */
+    levels: ExplosionLevels);
+    /**
+     * Resolve a component SKU, reading assemblies' active bills in the top
+     * bill's tenant so a shared assembly opens that tenant's bill.
+     */
+    resolve(skuId: string): Promise<ResolvedComponent>;
+    /**
+     * A bill's lines in the top bill's tenant (and global lines), counted
+     * against {@link MAX_EXPLOSION_LINES} every time the walk visits them (a
+     * shared sub-assembly counts once per use).
+     */
+    linesOf(bomId: string): Promise<BomLine[]>;
+    /** The path entry for the top bill. */
+    root(): Promise<ExplosionPathEntry>;
+    /**
+     * The bill to open below a line at `level`, or `null` when the component
+     * is not a sub-assembly with an active bill or `levels` stops here.
+     *
+     * @throws {BomStructureCycleError} when the sub-assembly is already on
+     *   `path` (it would contain itself).
+     * @throws {BomExplosionLimitError} when `levels: 'all'` would go deeper
+     *   than {@link MAX_EXPLOSION_DEPTH}.
+     */
+    open(component: ResolvedComponent, level: number, path: readonly ExplosionPathEntry[]): ExplosionPathEntry | null;
+}
+//# sourceMappingURL=structure-walk.d.ts.map

package/dist/services/structure-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-walk.d.ts","sourceRoot":"","sources":["../../src/services/structure-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IAC9C,IAAI,SAA4B;gBAE7B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE;CAMrD;AAKD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAQvE;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED,gFAAgF;AAChF,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,eAAe;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe;IAXlC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;IAC5E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;IAC/D,OAAO,CAAC,SAAS,CAAK;IACtB,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGP,UAAU,EAAE,eAAe;IAC5C,qCAAqC;IAC5B,GAAG,EAAE,eAAe;IAC7B,6BAA6B;IACpB,MAAM,EAAE,eAAe;IAKlC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWlD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBhD,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAczC;;;;;;;;OAQG;IACH,IAAI,CACF,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAClC,kBAAkB,GAAG,IAAI;CAoB7B"}