@happyvertical/smrt-manufacturing 0.53.4 → 0.53.6

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/ProductionRun.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ProductionRun — a build of some quantity of a product against one
+ * {@link BillOfMaterials}, reported as it happens: "25 to build, 12 done".
+ *
+ * The run pins the bill it was started against, carries the target and the
+ * completed quantity, and moves through `planned` → `in_progress` → `done`,
+ * or to `cancelled`. Each report of finished units is a dated
+ * {@link ProductionRunCompletion}; `completedQty` is their sum.
+ *
+ * Writes go through `ProductionRunService`, which keeps `completedQty` equal
+ * to the completions under concurrent reporting and enforces the status
+ * transitions. The generated REST/MCP/CLI surfaces are read-only for that
+ * reason.
+ *
+ * This is the shop-floor record of building. It is not the commercial
+ * instruction to make goods (`ProductionOrder` in `@happyvertical/smrt-commerce`,
+ * which carries terms and money); several runs may serve one order, or none
+ * (make to stock). An application that has both links them itself.
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Where a {@link ProductionRun} is:
+ *
+ * - `planned` — created, nothing reported yet.
+ * - `in_progress` — started, or at least one completion reported.
+ * - `done` — the target was reached, or the run was finished short.
+ * - `cancelled` — stopped; completions already reported stay.
+ */
+export type ProductionRunStatus = 'planned' | 'in_progress' | 'done' | 'cancelled';
+/** Every {@link ProductionRunStatus}, in lifecycle order. */
+export declare const PRODUCTION_RUN_STATUSES: readonly ProductionRunStatus[];
+/**
+ * Options accepted by the {@link ProductionRun} constructor.
+ */
+export interface ProductionRunOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    bomId?: string;
+    targetQty?: number;
+    completedQty?: number;
+    status?: ProductionRunStatus;
+}
+export declare class ProductionRun extends SmrtObject {
+    /** Tenant scope. `null` means the run is a global record. */
+    tenantId: string | null;
+    /**
+     * The bill the run builds against, pinned when the run is created.
+     * Restrict: a bill with runs is history and is not deleted.
+     */
+    bomId: string;
+    /** Units of the bill's product to build. Decimal; greater than zero. */
+    targetQty: number;
+    /** Units reported done so far: the sum of the run's completions. */
+    completedQty: number;
+    /** Lifecycle status; see {@link ProductionRunStatus}. */
+    status: ProductionRunStatus;
+    constructor(options?: ProductionRunOptions);
+    /**
+     * Units still to build, at the six-decimal quantity precision; `0` once
+     * the target is reached.
+     */
+    remainingQty(): number;
+    /** Refuses a status outside the lifecycle and impossible quantities. */
+    protected validateBeforeSave(): Promise<void>;
+}
+//# sourceMappingURL=ProductionRun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProductionRun.d.ts","sourceRoot":"","sources":["../../src/models/ProductionRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAGvB,MAAM,0BAA0B,CAAC;AAKlC;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,aAAa,GACb,MAAM,GACN,WAAW,CAAC;AAEhB,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAKjE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,qBASa,aAAc,SAAQ,UAAU;IAC3C,6DAA6D;IAE7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;OAGG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB,wEAAwE;IAExE,SAAS,EAAE,MAAM,CAAO;IAExB,oEAAoE;IAEpE,YAAY,EAAE,MAAM,CAAO;IAE3B,yDAAyD;IAEzD,MAAM,EAAE,mBAAmB,CAAa;gBAE5B,OAAO,GAAE,oBAAyB;IAU9C;;;OAGG;IACH,YAAY,IAAI,MAAM;IAOtB,wEAAwE;cAC/C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7D"}

package/dist/models/ProductionRunCompletion.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ProductionRunCompletion — one dated report of finished units on a
+ * {@link ProductionRun} ("12 done on Tuesday").
+ *
+ * Written only by `ProductionRunService.recordCompletion`, in the same
+ * transaction that adds `qty` to the run's `completedQty` and, when the
+ * caller asks, posts the stock movements; those movements carry
+ * `sourceType: 'ProductionRunCompletion'` and this row's id. Read-only over
+ * the generated surfaces.
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Options accepted by the {@link ProductionRunCompletion} constructor.
+ */
+export interface ProductionRunCompletionOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    runId?: string;
+    qty?: number;
+    completedAt?: Date | string;
+}
+export declare class ProductionRunCompletion extends SmrtObject {
+    /** Tenant scope. `null` means a global record. */
+    tenantId: string | null;
+    /** The run the units were built on. Cascade: completions belong to their run. */
+    runId: string;
+    /** Units finished in this report. Decimal; greater than zero. */
+    qty: number;
+    /** When the units were finished (defaults to when the report was made). */
+    completedAt: Date;
+    constructor(options?: ProductionRunCompletionOptions);
+    /** Refuses a report of zero, negative or non-finite units. */
+    protected validateBeforeSave(): Promise<void>;
+}
+//# sourceMappingURL=ProductionRunCompletion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProductionRunCompletion.d.ts","sourceRoot":"","sources":["../../src/models/ProductionRunCompletion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAGvB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,iBAAiB;IACvE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC7B;AAED,qBAQa,uBAAwB,SAAQ,UAAU;IACrD,kDAAkD;IAElD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,iFAAiF;IAEjF,KAAK,EAAE,MAAM,CAAM;IAEnB,iEAAiE;IAEjE,GAAG,EAAE,MAAM,CAAO;IAElB,2EAA2E;IAC3E,WAAW,EAAE,IAAI,CAAc;gBAEnB,OAAO,GAAE,8BAAmC;IAYxD,8DAA8D;cACrC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7D"}

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,11 @@
  * @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 { PRODUCTION_RUN_STATUSES, ProductionRun, type ProductionRunOptions, type ProductionRunStatus, } from './ProductionRun.js';
+export { ProductionRunCompletion, type ProductionRunCompletionOptions, } from './ProductionRunCompletion.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,EACL,uBAAuB,EACvB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/operation-types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Types and error classes for operations, routing and the labour estimate.
+ *
+ * Strictly industry-neutral.
+ *
+ * @packageDocumentation
+ */
+import type { Operation } from './models/Operation.js';
+import type { SubAssemblyLabour } from './types.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;
+    /**
+     * Multi-level only (`{ levels }` above 1): every sub-assembly the walk
+     * opened, at any depth, with its own routing estimate and how many units of
+     * it one unit of this bill's product needs. `totalMinutes`, `totalCost`,
+     * `hasRouting` and `hasMissingRates` then cover them too; `steps` stays this
+     * bill's own routing.
+     */
+    subAssemblies?: SubAssemblyLabour[];
+}
+/** 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;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;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;IACzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;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/production-run-types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Inputs, results and errors for `ProductionRunService`.
+ *
+ * @packageDocumentation
+ */
+import type { ProductionRun } from './models/ProductionRun.js';
+import type { ProductionRunCompletion } from './models/ProductionRunCompletion.js';
+import type { ConsumeResult, ProduceResult } from './services/ProductionService.js';
+/** Input for `ProductionRunService.createRun`. Give `bomId`, or `productId` for its active bill. */
+export interface CreateProductionRunInput {
+    /** The bill to build against. Wins over `productId`. */
+    bomId?: string;
+    /** A product (usually an `Assembly`) whose active bill the run pins. */
+    productId?: string;
+    /** Units to build; greater than zero. */
+    targetQty: number;
+}
+/** Stock to consume when a completion is recorded: the run's bill, for the completed units. */
+export interface CompletionConsumeOptions {
+    /** Location the components are taken from. */
+    locationId: string;
+    /** Optional free-form note on each movement. */
+    note?: string;
+}
+/** Finished goods to receive when a completion is recorded. */
+export interface CompletionProduceOptions {
+    /** Location the finished units are received into. */
+    locationId: string;
+    /** The SKU of the bill's product that was built. */
+    finishedSkuId: string;
+    /** Optional free-form note on the movement. */
+    note?: string;
+}
+/** Input for `ProductionRunService.recordCompletion`. */
+export interface RecordCompletionInput {
+    /** Units finished; greater than zero and no more than the run has left. */
+    qty: number;
+    /** When they were finished. Defaults to now. */
+    completedAt?: Date | string;
+    /**
+     * Consume the run's bill for `qty` units, in the same transaction. Omit
+     * (the default) to record progress without touching stock.
+     */
+    consume?: CompletionConsumeOptions;
+    /**
+     * Receive `qty` finished units, in the same transaction. Omit (the
+     * default) to record progress without touching stock.
+     */
+    produce?: CompletionProduceOptions;
+}
+/** Result of `ProductionRunService.recordCompletion`. */
+export interface RecordCompletionResult {
+    /** The run after the completion. */
+    run: ProductionRun;
+    /** The completion that was recorded. */
+    completion: ProductionRunCompletion;
+    /** Components consumed; empty unless `consume` was given. */
+    consumed: ConsumeResult[];
+    /** Finished goods received; `null` unless `produce` was given. */
+    produced: ProduceResult | null;
+}
+/** Thrown when a production run id does not exist. */
+export declare class ProductionRunNotFoundError extends Error {
+    readonly runId: string;
+    name: string;
+    constructor(runId: string);
+}
+/** Thrown when an action is not allowed in the run's current status. */
+export declare class ProductionRunStateError extends Error {
+    readonly runId: string;
+    /** The run's status when the action was refused. */
+    readonly status: string;
+    /** What was attempted: `start`, `complete`, `finish`, `cancel`, `retarget`. */
+    readonly action: string;
+    name: string;
+    constructor(runId: string, 
+    /** The run's status when the action was refused. */
+    status: string, 
+    /** What was attempted: `start`, `complete`, `finish`, `cancel`, `retarget`. */
+    action: string);
+}
+/** Thrown when a completion would take the run past its target. */
+export declare class ProductionRunOverCompletionError extends Error {
+    readonly runId: string;
+    /** The quantity reported. */
+    readonly qty: number;
+    /** What the run had left to build. */
+    readonly remaining: number;
+    name: string;
+    constructor(runId: string, 
+    /** The quantity reported. */
+    qty: number, 
+    /** What the run had left to build. */
+    remaining: number);
+}
+/** Thrown for invalid production run input (quantities, dates, bill). */
+export declare class InvalidProductionRunInputError extends Error {
+    name: string;
+}
+//# sourceMappingURL=production-run-types.d.ts.map

package/dist/production-run-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-run-types.d.ts","sourceRoot":"","sources":["../src/production-run-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,iCAAiC,CAAC;AAEzC,oGAAoG;AACpG,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+FAA+F;AAC/F,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAED,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,GAAG,EAAE,aAAa,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,uBAAuB,CAAC;IACpC,6DAA6D;IAC7D,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAED,sDAAsD;AACtD,qBAAa,0BAA2B,SAAQ,KAAK;aAGvB,KAAK,EAAE,MAAM;IAFhC,IAAI,SAAgC;gBAEjB,KAAK,EAAE,MAAM;CAG1C;AAED,wEAAwE;AACxE,qBAAa,uBAAwB,SAAQ,KAAK;aAI9B,KAAK,EAAE,MAAM;IAC7B,oDAAoD;aACpC,MAAM,EAAE,MAAM;IAC9B,+EAA+E;aAC/D,MAAM,EAAE,MAAM;IAPvB,IAAI,SAA6B;gBAGxB,KAAK,EAAE,MAAM;IAC7B,oDAAoD;IACpC,MAAM,EAAE,MAAM;IAC9B,+EAA+E;IAC/D,MAAM,EAAE,MAAM;CAIjC;AAED,mEAAmE;AACnE,qBAAa,gCAAiC,SAAQ,KAAK;aAIvC,KAAK,EAAE,MAAM;IAC7B,6BAA6B;aACb,GAAG,EAAE,MAAM;IAC3B,sCAAsC;aACtB,SAAS,EAAE,MAAM;IAP1B,IAAI,SAAsC;gBAGjC,KAAK,EAAE,MAAM;IAC7B,6BAA6B;IACb,GAAG,EAAE,MAAM;IAC3B,sCAAsC;IACtB,SAAS,EAAE,MAAM;CAMpC;AAED,yEAAyE;AACzE,qBAAa,8BAA+B,SAAQ,KAAK;IAC9C,IAAI,SAAoC;CAClD"}

package/dist/quantity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Quantity precision for planning and production runs.
+ *
+ * Quantities are decimals held in binary floating point, so sums such as
+ * `0.1 + 0.2` and products such as `2.2 * 100` carry rounding noise. Rather
+ * than compare with a tolerance (which must grow with the value and so
+ * eventually hides a whole unit), quantities are kept to
+ * {@link QUANTITY_DECIMALS} decimal places: rounded through their decimal
+ * representation, and summed and compared exactly as whole millionths.
+ *
+ * @packageDocumentation
+ */
+/** Decimal places a quantity is kept to: a millionth of a unit. */
+export declare const QUANTITY_DECIMALS = 6;
+/**
+ * The largest quantity a production run accepts (target or report): every
+ * value up to it with {@link QUANTITY_DECIMALS} places has at most 15
+ * significant digits, so it survives a round trip through a double exactly
+ * and sums of them stay exact.
+ */
+export declare const MAX_QUANTITY = 999999999;
+/**
+ * `value` rounded to {@link QUANTITY_DECIMALS} decimal places (correctly
+ * rounded through its decimal representation, so `0.1 + 0.2` becomes
+ * exactly `0.3`).
+ */
+export declare function roundQuantity(value: number): number;
+/**
+ * `value` as a whole number of millionths, exactly (read from its decimal
+ * representation, not multiplied). Exact for any value up to
+ * {@link MAX_QUANTITY}.
+ */
+export declare function toMillionths(value: number): number;
+/** A whole number of millionths back as a quantity. */
+export declare function fromMillionths(millionths: number): number;
+//# sourceMappingURL=quantity.d.ts.map