@happyvertical/smrt-manufacturing 0.53.3 → 0.53.5

package/dist/models/Assembly.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Assembly — the product that is made, the counterpart to `Material` (the
+ * product that is consumed).
+ *
+ * A single-table-inheritance subtype of `@happyvertical/smrt-products`
+ * `Product`: assembly rows live in the shared `products` table with
+ * `productType: 'assembly'` and `_meta_type:
+ * '@happyvertical/smrt-manufacturing:Assembly'`. Its own fields are
+ * ordinary columns that this package adds to that table.
+ *
+ * Everything else comes from a neighbour and is deliberately not repeated
+ * here:
+ *
+ * - name, description, price, category and tags from `Product`;
+ * - part number, barcode and stock from its `Sku` (`smrt-products`) and the
+ *   stock levels in `smrt-inventory`;
+ * - what it is made of from its {@link BillOfMaterials} and {@link BomLine}s;
+ * - specs, plans and drawings from `ProductAsset` links.
+ *
+ * **Nesting lives in the bill, not on the assembly.** A sub-assembly is a
+ * bill line whose component SKU belongs to another `Assembly`; there is no
+ * children list to keep in sync. Use {@link AssemblyService.resolveComponent}
+ * to tell a sub-assembly from a material or a bought item.
+ *
+ * @packageDocumentation
+ */
+import { Product, type ProductOptions, ProductType } from '@happyvertical/smrt-products/models';
+/**
+ * Options accepted by the {@link Assembly} constructor.
+ */
+export interface AssemblyOptions extends ProductOptions {
+    estimatedLabourMinutes?: number;
+    defaultOperationId?: string | null;
+    partReference?: string;
+}
+export declare class Assembly extends Product {
+    productType: ProductType;
+    /**
+     * Labour to build one unit, in whole minutes. A planning estimate until
+     * routing steps (smrt#3445) provide labour per operation; `0` means not
+     * estimated.
+     */
+    estimatedLabourMinutes: number;
+    /**
+     * The {@link Operation} that work on this assembly is booked to by
+     * default, or `null` for none. `RESTRICT`, like `RoutingStep.operationId`:
+     * operations are retired, never deleted.
+     */
+    defaultOperationId: string | null;
+    /**
+     * The organization's own drawing or part number for this assembly,
+     * alongside (not instead of) the SKU code.
+     */
+    partReference: string;
+    constructor(options?: AssemblyOptions);
+    /**
+     * Refuses a labour estimate that is not a whole number of minutes of zero
+     * or more, on every save (generated REST and collection writes included).
+     */
+    protected validateBeforeSave(): Promise<void>;
+}
+//# sourceMappingURL=Assembly.d.ts.map

package/dist/models/Assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Assembly.d.ts","sourceRoot":"","sources":["../../src/models/Assembly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,WAAW,EACZ,MAAM,qCAAqC,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD,qBAUa,QAAS,SAAQ,OAAO;IAC1B,WAAW,EAAE,WAAW,CAAwB;IAEzD;;;;OAIG;IAEH,sBAAsB,EAAE,MAAM,CAAK;IAEnC;;;;OAIG;IAEH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzC;;;OAGG;IAEH,aAAa,EAAE,MAAM,CAAM;gBAEf,OAAO,GAAE,eAAoB;IAUzC;;;OAGG;cACsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7D"}

package/dist/models/BillOfMaterials.d.ts

@@ -12,8 +12,8 @@
  * other vertical that builds finished goods from components.
  *
  * Cross-package references (`productId`) are plain string ids — never
- * `@foreignKey()` — so this package can be consumed without pulling in the
- * upstream catalog package.
+ * `@foreignKey()` — so the schema does not couple to the catalog package's
+ * table layout. The product is usually an `Assembly`.
  *
  * @packageDocumentation
  */
@@ -37,8 +37,8 @@ export declare class BillOfMaterials extends SmrtObject {
     /**
      * Plain string reference to the upstream product this BOM produces.
      * Typically a `Product.id` (or any STI subtype thereof) from
-     * `@happyvertical/smrt-products`. Cross-package id, intentionally not
-     * a `@foreignKey()`, so this package does not pull in `smrt-products`.
+     * `@happyvertical/smrt-products`, usually an `Assembly`. Cross-package
+     * id, intentionally not a `@foreignKey()`.
      */
     productId: string;
     /**
@@ -74,5 +74,13 @@ export declare class BillOfMaterials extends SmrtObject {
      */
     currency: string;
     constructor(options?: BillOfMaterialsOptions);
+    /**
+     * Refuses saving the bill as `active` when one of its lines would make
+     * its product contain itself, directly or through sub-assemblies' active
+     * bills, with a `BomCycleError` naming the path. Draft and superseded
+     * bills are not part of the structure and are not checked here (their
+     * lines are checked as they are saved).
+     */
+    protected validateBeforeSave(): Promise<void>;
 }
 //# sourceMappingURL=BillOfMaterials.d.ts.map

package/dist/models/BillOfMaterials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BillOfMaterials.d.ts","sourceRoot":"","sources":["../../src/models/BillOfMaterials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAUa,eAAgB,SAAQ,UAAU;IAC7C,6DAA6D;IAE7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;;OAKG;IAEH,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;;OAKG;IAEH,OAAO,EAAE,MAAM,CAAK;IAEpB;;;;OAIG;IACH,aAAa,EAAE,IAAI,GAAG,IAAI,CAAQ;IAElC;;;;;;OAMG;IAEH,MAAM,EAAE,SAAS,CAAW;IAE5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAS;gBAEb,OAAO,GAAE,sBAA2B;CAiBjD"}
+{"version":3,"file":"BillOfMaterials.d.ts","sourceRoot":"","sources":["../../src/models/BillOfMaterials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAUa,eAAgB,SAAQ,UAAU;IAC7C,6DAA6D;IAE7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;;OAKG;IAEH,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;;OAKG;IAEH,OAAO,EAAE,MAAM,CAAK;IAEpB;;;;OAIG;IACH,aAAa,EAAE,IAAI,GAAG,IAAI,CAAQ;IAElC;;;;;;OAMG;IAEH,MAAM,EAAE,SAAS,CAAW;IAE5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAS;gBAEb,OAAO,GAAE,sBAA2B;IAkBhD;;;;;;OAMG;cACsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7D"}

package/dist/models/BomLine.d.ts

@@ -9,11 +9,10 @@
  * material consumed but not incorporated into a finished unit.
  *
  * Cross-package references (`componentSkuId`) are plain string ids — never
- * `@foreignKey()` — so this package can ship without a hard runtime
- * dependency on `@happyvertical/smrt-products` (the `Sku` model lives
- * there) or `@happyvertical/smrt-inventory` (which holds the stock
- * levels / movements addressed by the id) even though all three almost
- * always travel together.
+ * `@foreignKey()`. The `Sku` model lives in `@happyvertical/smrt-products`
+ * and `@happyvertical/smrt-inventory` holds the stock levels and movements
+ * addressed by the id. When the SKU belongs to an `Assembly`, the line is a
+ * sub-assembly: `AssemblyService.resolveComponent` says which.
  *
  * @packageDocumentation
  */
@@ -84,5 +83,12 @@ export declare class BomLine extends SmrtObject {
      * `effectiveQty = qtyPerUnit * (1 + wastePercent / 100)`
      */
     effectiveQtyPerUnit(): number;
+    /**
+     * Refuses a line that would make its bill's product contain itself,
+     * directly or through sub-assemblies' active bills, with a
+     * `BomCycleError` naming the path. Runs on every save, so the generated
+     * REST `create`/`update` routes refuse it too.
+     */
+    protected validateBeforeSave(): Promise<void>;
 }
 //# sourceMappingURL=BomLine.d.ts.map

package/dist/models/BomLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BomLine.d.ts","sourceRoot":"","sources":["../../src/models/BomLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAaa,OAAQ,SAAQ,UAAU;IACrC,8DAA8D;IAE9D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;;;OAMG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;;;OAMG;IAEH,cAAc,EAAE,MAAM,CAAM;IAE5B;;;;OAIG;IAEH,UAAU,EAAE,MAAM,CAAO;IAEzB;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAU;IAErB;;;;;;OAMG;IAEH,YAAY,EAAE,MAAM,CAAO;IAE3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAM;gBAEP,OAAO,GAAE,cAAmB;IAaxC;;;;;OAKG;IACH,mBAAmB,IAAI,MAAM;CAK9B"}
+{"version":3,"file":"BomLine.d.ts","sourceRoot":"","sources":["../../src/models/BomLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAaa,OAAQ,SAAQ,UAAU;IACrC,8DAA8D;IAE9D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;;;OAMG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;;;OAMG;IAEH,cAAc,EAAE,MAAM,CAAM;IAE5B;;;;OAIG;IAEH,UAAU,EAAE,MAAM,CAAO;IAEzB;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAU;IAErB;;;;;;OAMG;IAEH,YAAY,EAAE,MAAM,CAAO;IAE3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAM;gBAEP,OAAO,GAAE,cAAmB;IAaxC;;;;;OAKG;IACH,mBAAmB,IAAI,MAAM;IAM7B;;;;;OAKG;cACsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7D"}

package/dist/models/Operation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Operation — one kind of work done to build something: cut, weld, assemble,
+ * inspect, bake, pack. A managed list per tenant that routing steps point at.
+ *
+ * Retiring an operation (`isActive = false`) keeps it on every routing and
+ * history that already names it and takes it out of pickers; an operation is
+ * never deleted. Time recorded against an operation is not modelled here — it
+ * stays in `@happyvertical/smrt-timesheets` or the application.
+ *
+ * Strictly industry-neutral.
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Options accepted by the {@link Operation} constructor.
+ */
+export interface OperationOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    code?: string;
+    name?: string;
+    category?: string;
+    isActive?: boolean;
+    requiredQualificationId?: string | null;
+}
+export declare class Operation extends SmrtObject {
+    /** Tenant scope. `null` means the operation is a global record. */
+    tenantId: string | null;
+    /**
+     * Short stable code, unique per tenant (`CUT`, `WELD`). Treated as the
+     * operation's identity by {@link OperationService}: it is set when the
+     * operation is defined and is not changed afterwards; rename the `name`.
+     */
+    code: string;
+    /** Human-readable name shown in lists and pickers. */
+    name: string;
+    /**
+     * Free-text grouping for lists (`fabrication`, `finishing`, `quality`).
+     * Empty when the operation is not grouped.
+     */
+    category: string;
+    /**
+     * `false` once the operation is retired. A retired operation stays on the
+     * routings and history that name it and is left out of pickers.
+     */
+    isActive: boolean;
+    /**
+     * Optional id of the qualification definition a worker needs to start this
+     * operation: a `Qualification` from `@happyvertical/smrt-human-resources`.
+     * Declared as a cross-package reference (metadata only: this package takes no
+     * dependency on it and does not validate the id); an application reads it to
+     * decide who may start the operation. `null` when none is required.
+     */
+    requiredQualificationId: string | null;
+    constructor(options?: OperationOptions);
+    /** Operations are retired, never deleted, so history keeps resolving. */
+    delete(): Promise<void>;
+}
+//# sourceMappingURL=Operation.d.ts.map

package/dist/models/Operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../src/models/Operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,qBAWa,SAAU,SAAQ,UAAU;IACvC,mEAAmE;IAEnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;OAIG;IAEH,IAAI,EAAE,MAAM,CAAM;IAElB,sDAAsD;IAEtD,IAAI,EAAE,MAAM,CAAM;IAElB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAQ;IAEzB;;;;;;OAMG;IAIH,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAElC,OAAO,GAAE,gBAAqB;IAW1C,yEAAyE;IAC1D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/models/RoutingStep.d.ts

@@ -0,0 +1,46 @@
+/**
+ * RoutingStep — one operation in the routing of a {@link BillOfMaterials}.
+ *
+ * A routing is the ordered list of steps for building one unit of the bill's
+ * product. It is optional: a bill with no routing steps behaves exactly as a
+ * bill always has. Steps are ordered by `sequence`, unique within the bill.
+ *
+ * Cross-package-style references (`bomId`, `operationId`) are plain string ids,
+ * as elsewhere in this package.
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Options accepted by the {@link RoutingStep} constructor.
+ */
+export interface RoutingStepOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    bomId?: string;
+    operationId?: string;
+    sequence?: number;
+    estimatedMinutes?: number;
+    notes?: string;
+}
+export declare class RoutingStep extends SmrtObject {
+    /** Tenant scope. `null` means the step is a global record. */
+    tenantId: string | null;
+    /**
+     * The owning {@link BillOfMaterials}. Cascade: a routing belongs to its bill.
+     * (`BomLine.bomId` is still a plain string; see AGENTS.md.)
+     */
+    bomId: string;
+    /** The {@link Operation} performed here. Restrict: operations are retired, never deleted. */
+    operationId: string;
+    /** Position in the routing, starting at 1 and without gaps. */
+    sequence: number;
+    /**
+     * Estimated working minutes at this step to build one unit of the bill's
+     * product. Decimal so `7.5` round-trips.
+     */
+    estimatedMinutes: number;
+    /** Optional free-form note for this step. */
+    notes: string;
+    constructor(options?: RoutingStepOptions);
+}
+//# sourceMappingURL=RoutingStep.d.ts.map

package/dist/models/RoutingStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingStep.d.ts","sourceRoot":"","sources":["../../src/models/RoutingStep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAKlC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBASa,WAAY,SAAQ,UAAU;IACzC,8DAA8D;IAE9D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;OAGG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB,6FAA6F;IAE7F,WAAW,EAAE,MAAM,CAAM;IAEzB,+DAA+D;IAE/D,QAAQ,EAAE,MAAM,CAAK;IAErB;;;OAGG;IAEH,gBAAgB,EAAE,MAAM,CAAO;IAE/B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAM;gBAEP,OAAO,GAAE,kBAAuB;CAW7C"}

package/dist/models/index.d.ts

@@ -9,6 +9,9 @@
  * @packageDocumentation
  */
 import '../__smrt-register__.js';
+export { Assembly, type AssemblyOptions } from './Assembly.js';
 export { BillOfMaterials, type BillOfMaterialsOptions, } from './BillOfMaterials.js';
 export { BomLine, type BomLineOptions } from './BomLine.js';
+export { Operation, type OperationOptions } from './Operation.js';
+export { RoutingStep, type RoutingStepOptions } from './RoutingStep.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/operation-types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Types and error classes for operations, routing and the labour estimate.
+ *
+ * Strictly industry-neutral.
+ *
+ * @packageDocumentation
+ */
+import type { Operation } from './models/Operation.js';
+/**
+ * Callback that returns the hourly labour rate for an operation, in the bill's
+ * currency, or `null` / `undefined` when no rate is known. The package holds no
+ * rates: the caller decides where they come from (a price list, a rate class
+ * the application keeps against the operation code, a timesheet rate). Mirrors
+ * `ComponentCostResolver` for materials.
+ */
+export type OperationRateResolver = (operation: Operation) => Promise<number | null | undefined> | number | null | undefined;
+/** One step of {@link LabourEstimate}. */
+export interface RoutingStepEstimate {
+    /** The routing step id. */
+    stepId: string;
+    /** Position in the routing, starting at 1. */
+    sequence: number;
+    /** Plain string id of the operation. */
+    operationId: string;
+    /** Operation code, or `''` if the operation row is missing. */
+    operationCode: string;
+    /** Operation name, or `''` if the operation row is missing. */
+    operationName: string;
+    /** Estimated working minutes per produced unit. */
+    estimatedMinutes: number;
+    /** Hourly rate from the resolver, or `0` when unavailable. */
+    hourlyRate: number;
+    /** `estimatedMinutes / 60 * hourlyRate`; `0` when the rate is unavailable. */
+    stepCost: number;
+    /** `true` when no resolver was supplied or it returned no rate. */
+    rateUnavailable: boolean;
+}
+/**
+ * Estimated labour per produced unit, returned by
+ * `BomService.computeLabourEstimate`. A bill with no routing returns an empty
+ * `steps` array and zero totals.
+ */
+export interface LabourEstimate {
+    /** The bill that was rolled up. */
+    bomId: string;
+    /** `true` when the bill has at least one routing step. */
+    hasRouting: boolean;
+    /** Total estimated working minutes per produced unit. */
+    totalMinutes: number;
+    /** Total estimated labour cost per unit; counts only steps with a rate. */
+    totalCost: number;
+    /** ISO 4217 currency code of the bill. */
+    currency: string;
+    /** Steps in routing order. */
+    steps: RoutingStepEstimate[];
+    /** `true` when a step's rate was unavailable, so `totalCost` is a lower bound. */
+    hasMissingRates: boolean;
+}
+/** One step handed to `RoutingService.replaceRouting`. */
+export interface RoutingStepInput {
+    /** Plain string id of the operation to perform. */
+    operationId: string;
+    /** Estimated working minutes per produced unit; zero or more. */
+    estimatedMinutes: number;
+    /** Optional free-form note. */
+    notes?: string;
+}
+/** Input for `OperationService.define`. */
+export interface DefineOperationInput {
+    /** Unique per tenant; not changed afterwards. */
+    code: string;
+    name: string;
+    category?: string;
+    /** Plain string id of a `smrt-human-resources` qualification definition. */
+    requiredQualificationId?: string;
+}
+/** Thrown when an operation id does not exist. */
+export declare class OperationNotFoundError extends Error {
+    readonly operationId: string;
+    name: string;
+    constructor(operationId: string);
+}
+/** Thrown when defining an operation whose code is already in use. */
+export declare class DuplicateOperationCodeError extends Error {
+    readonly code: string;
+    name: string;
+    constructor(code: string);
+}
+/** Thrown when a routing would newly add a retired operation. */
+export declare class OperationRetiredError extends Error {
+    readonly operationId: string;
+    name: string;
+    constructor(operationId: string);
+}
+/** Thrown for invalid operation or routing input. */
+export declare class InvalidOperationInputError extends Error {
+    name: string;
+}
+//# sourceMappingURL=operation-types.d.ts.map

package/dist/operation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../src/operation-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEpE,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,kFAAkF;IAClF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,kDAAkD;AAClD,qBAAa,sBAAuB,SAAQ,KAAK;aAGnB,WAAW,EAAE,MAAM;IAFtC,IAAI,SAA4B;gBAEb,WAAW,EAAE,MAAM;CAGhD;AAED,sEAAsE;AACtE,qBAAa,2BAA4B,SAAQ,KAAK;aAGxB,IAAI,EAAE,MAAM;IAF/B,IAAI,SAAiC;gBAElB,IAAI,EAAE,MAAM;CAGzC;AAED,iEAAiE;AACjE,qBAAa,qBAAsB,SAAQ,KAAK;aAGlB,WAAW,EAAE,MAAM;IAFtC,IAAI,SAA2B;gBAEZ,WAAW,EAAE,MAAM;CAKhD;AAED,qDAAqD;AACrD,qBAAa,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,SAAgC;CAC9C"}

package/dist/services/AssemblyService.d.ts

@@ -0,0 +1,217 @@
+/**
+ * AssemblyService — the link between a bill line and the thing it names.
+ *
+ * A {@link BomLine} points at a component SKU. That SKU belongs to a
+ * `Product` row in `@happyvertical/smrt-products`, and the row's subtype
+ * decides what the line means:
+ *
+ * | Component SKU belongs to | Kind | Meaning |
+ * |---|---|---|
+ * | an {@link Assembly} | `assembly` | a sub-assembly; it is built from its own active bill, if it has one |
+ * | a `Material` | `material` | a consumed input; the leaf of the structure |
+ * | any other `Product` | `bought` | an item that is bought, not built here |
+ * | nothing (unknown SKU or product) | `missing` | the line points at a record that does not exist |
+ *
+ * {@link AssemblyService.resolveComponent} answers that question for one
+ * SKU, and also returns the assembly's active bill. It is the step a
+ * multi-level explosion repeats: resolve each line's component, recurse into
+ * every `assembly` that has an `activeBom`, stop at everything else.
+ *
+ * The service also owns the **cycle refusal**: an assembly may not contain
+ * itself, directly or through sub-assemblies. {@link BomLine} and
+ * {@link BillOfMaterials} call {@link AssemblyService.assertLineAcyclic} and
+ * {@link AssemblyService.assertBillAcyclic} before every save, so the
+ * generated REST routes refuse a cycle too.
+ *
+ * @packageDocumentation
+ */
+import { type DatabaseConfig, ValidationError } from '@happyvertical/smrt-core';
+import { ProductCollection, SkuCollection } from '@happyvertical/smrt-products/collections';
+import { type Product, type Sku } from '@happyvertical/smrt-products/models';
+import { BillOfMaterialsCollection } from '../collections/BillOfMaterialsCollection.js';
+import { BomLineCollection } from '../collections/BomLineCollection.js';
+import { Assembly } from '../models/Assembly.js';
+import type { BillOfMaterials } from '../models/BillOfMaterials.js';
+import type { BomLine } from '../models/BomLine.js';
+/**
+ * What a component SKU is, as far as building goes. See the table in the
+ * {@link AssemblyService} module documentation.
+ */
+export type ComponentKind = 'assembly' | 'material' | 'bought' | 'missing';
+/**
+ * The answer to "what is this component SKU?" returned by
+ * {@link AssemblyService.resolveComponent}.
+ */
+export interface ResolvedComponent {
+    /** The component SKU id that was resolved. */
+    skuId: string;
+    /** What the SKU is; see {@link ComponentKind}. */
+    kind: ComponentKind;
+    /** The SKU row, or `null` when no SKU has this id. */
+    sku: Sku | null;
+    /**
+     * The product the SKU belongs to (an `Assembly`, a `Material` or a plain
+     * `Product`), or `null` when the SKU or its product does not exist.
+     */
+    product: Product | null;
+    /** The assembly, when {@link kind} is `assembly`; otherwise `null`. */
+    assembly: Assembly | null;
+    /**
+     * The assembly's active bill (the highest active version), or `null` for
+     * an assembly that has no active bill yet and for every other kind.
+     */
+    activeBom: BillOfMaterials | null;
+    /**
+     * `true` only for an assembly with an active bill: the component *can* be
+     * built here. Whether a shortage is built or bought is the application's
+     * decision; this only reports the fact.
+     */
+    buildable: boolean;
+}
+/** One bill line together with the component it resolves to. */
+export interface BillStructureLine {
+    /** The bill line as stored. */
+    line: BomLine;
+    /** The line's component SKU, resolved. */
+    component: ResolvedComponent;
+}
+/**
+ * One level of an assembly's structure, returned by
+ * {@link AssemblyService.getBillStructure}. Sub-assembly lines carry their
+ * own `activeBom`; pass its id back to `getBillStructure` to open the next
+ * level.
+ */
+export interface BillStructure {
+    /** The bill that was read. */
+    bom: BillOfMaterials;
+    /** Its lines in component-SKU order, each resolved. */
+    lines: BillStructureLine[];
+}
+/** One product on a cycle path reported by {@link BomCycleError}. */
+export interface BomCyclePathEntry {
+    /** The product id (an assembly, or the bill's own product). */
+    productId: string;
+    /** The product's name, or its id when it has no name or cannot be read. */
+    name: string;
+}
+/**
+ * Thrown when saving a bill line, or saving a bill as active, would make a
+ * product contain itself. `path` starts and ends with the bill's product,
+ * listing each assembly in between: `Frame → Side panel → Frame`.
+ */
+export declare class BomCycleError extends ValidationError {
+    /** The bill being saved (or the bill of the line being saved). */
+    readonly bomId: string;
+    /** The cycle, from the bill's product back to itself. */
+    readonly path: BomCyclePathEntry[];
+    name: string;
+    constructor(
+    /** The bill being saved (or the bill of the line being saved). */
+    bomId: string, 
+    /** The cycle, from the bill's product back to itself. */
+    path: BomCyclePathEntry[]);
+}
+/** Options for {@link AssemblyService.resolveComponent} and the walks built on it. */
+export interface ResolveComponentOptions {
+    /**
+     * The tenant whose structure is being read. When given (including `null`
+     * for global records), an assembly's active bill is chosen only among
+     * bills with exactly this `tenantId`, and a SKU, product or bill line
+     * belonging to another tenant is treated as missing (global rows stay
+     * visible), whatever tenant context is active. When omitted, the active
+     * tenant context decides what is visible.
+     */
+    tenantId?: string | null;
+}
+/** Options accepted by {@link AssemblyService.create}. */
+export interface AssemblyServiceOptions {
+    /** Database config or live handle shared by every collection. */
+    db: DatabaseConfig;
+}
+/**
+ * Resolves components and refuses cycles. Construct with
+ * {@link AssemblyService.create} or {@link createAssemblyService}.
+ *
+ * @example
+ * ```typescript
+ * const assemblies = await AssemblyService.create({ db });
+ * const component = await assemblies.resolveComponent(line.componentSkuId);
+ * if (component.kind === 'assembly' && component.activeBom) {
+ *   // a sub-assembly that can be built: walk component.activeBom next
+ * }
+ * ```
+ */
+export declare class AssemblyService {
+    /** Every `Product` row, any subtype. */
+    readonly products: ProductCollection;
+    /** The SKU catalog. */
+    readonly skus: SkuCollection;
+    /** Bills of materials. */
+    readonly boms: BillOfMaterialsCollection;
+    /** Bill lines. */
+    readonly lines: BomLineCollection;
+    private constructor();
+    /** Factory — prefer {@link createAssemblyService}. */
+    static create(options: AssemblyServiceOptions): Promise<AssemblyService>;
+    /**
+     * Resolve a component SKU to what it is: an assembly (with its active bill,
+     * or `null` when it has none), a material, a bought item, or missing. Never
+     * throws for an unknown id; it reports `missing` instead.
+     *
+     * This is the documented link a multi-level explosion walks: recurse into
+     * `activeBom` while `kind === 'assembly'`, stop at every other kind. Pass
+     * the parent bill's `tenantId` so a shared assembly resolves to that
+     * tenant's bill, not another tenant's.
+     */
+    resolveComponent(skuId: string, options?: ResolveComponentOptions): Promise<ResolvedComponent>;
+    /**
+     * The highest-version active bill for a product, limited to one tenant's
+     * bills when `options.tenantId` is given.
+     */
+    findActiveBom(productId: string, options?: ResolveComponentOptions): Promise<BillOfMaterials | null>;
+    /** `true` when the SKU belongs to an {@link Assembly}. */
+    isAssembly(skuId: string): Promise<boolean>;
+    /**
+     * Read one bill and resolve every line's component. Sub-assembly lines say
+     * whether they have an active bill of their own (`component.activeBom`);
+     * the caller opens the next level by passing that id back in.
+     *
+     * @throws {BomNotFoundError} when no bill has this id.
+     */
+    getBillStructure(bomId: string): Promise<BillStructure>;
+    /**
+     * Find the path by which adding `componentSkuIds` to a bill for
+     * `productId` would make that product contain itself, or `null` when none
+     * would. The walk follows each sub-assembly's **active** bill only; a
+     * draft or superseded bill is not part of the structure. Pass the bill's
+     * `tenantId` so the walk reads that tenant's structure.
+     */
+    findCycle(productId: string, componentSkuIds: readonly string[], options?: ResolveComponentOptions): Promise<BomCyclePathEntry[] | null>;
+    /**
+     * Refuse a bill line that would make its bill's product contain itself.
+     * A line on a draft bill is checked too, so a cycle is refused when it is
+     * written rather than when the bill is activated. A line whose bill does
+     * not exist is left to the caller.
+     *
+     * @throws {BomCycleError} naming the path.
+     */
+    assertLineAcyclic(line: Pick<BomLine, 'bomId' | 'componentSkuId'>): Promise<void>;
+    /**
+     * Refuse saving a bill as `active` when any of its lines would make its
+     * product contain itself. Bills in any other status are not part of the
+     * structure and pass.
+     *
+     * The lines checked are the bill's own and those of any stored bill with
+     * the same natural key (`productId`, `version`, and the bill's tenant, or
+     * the active tenant when the bill has none yet): saving a new
+     * instance with that key upserts onto the stored bill and activates its
+     * lines, so they are part of what the save makes active.
+     *
+     * @throws {BomCycleError} naming the path.
+     */
+    assertBillAcyclic(bom: Pick<BillOfMaterials, 'id' | 'productId' | 'status' | 'version' | 'tenantId'>): Promise<void>;
+    private resolveCached;
+}
+/** Convenience factory for {@link AssemblyService}. */
+export declare function createAssemblyService(options: AssemblyServiceOptions): Promise<AssemblyService>;
+//# sourceMappingURL=AssemblyService.d.ts.map

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

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