@happyvertical/smrt-inventory 0.51.31 → 0.51.33

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/InventoryLocationCollection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * InventoryLocationCollection — query helpers for {@link InventoryLocation}.
+ *
+ * @packageDocumentation
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { InventoryLocation } from '../models/InventoryLocation.js';
+import type { InventoryLocationKind } from '../types.js';
+export declare class InventoryLocationCollection extends SmrtCollection<InventoryLocation> {
+    static readonly _itemClass: typeof InventoryLocation;
+    /**
+     * Look up a location by its tenant-scoped `code`. Returns `null` when
+     * no row matches.
+     */
+    findByCode(code: string): Promise<InventoryLocation | null>;
+    /**
+     * Find every location classified as the given kind (`'warehouse'`,
+     * `'factory'`, `'retail'`, `'in_transit'`, …).
+     */
+    findByKind(kind: InventoryLocationKind): Promise<InventoryLocation[]>;
+    /**
+     * Find every location linked to a particular `Place.id` from
+     * `@happyvertical/smrt-places`. Returns an empty array when no row
+     * references the place.
+     */
+    findByPlace(placeId: string): Promise<InventoryLocation[]>;
+    /** Find every active location, optionally narrowed by kind. */
+    findActive(kind?: InventoryLocationKind): Promise<InventoryLocation[]>;
+}
+//# sourceMappingURL=InventoryLocationCollection.d.ts.map

package/dist/collections/InventoryLocationCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InventoryLocationCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InventoryLocationCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKjE;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI3E;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKhE,+DAA+D;IACzD,UAAU,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAK7E"}

package/dist/collections/StockLevelCollection.d.ts

@@ -0,0 +1,45 @@
+/**
+ * StockLevelCollection — read helpers and balance aggregations.
+ *
+ * Mutations live in {@link StockService}. The collection here is for
+ * reading the materialized view only; callers that want to change
+ * `qty` must go through the service so the StockMovement audit row is
+ * also written.
+ *
+ * @packageDocumentation
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { StockLevel } from '../models/StockLevel.js';
+import type { StockState } from '../types.js';
+export declare class StockLevelCollection extends SmrtCollection<StockLevel> {
+    static readonly _itemClass: typeof StockLevel;
+    /**
+     * Fetch the level row for a `(skuId, locationId, state)` tuple, or
+     * `null` when the row has never been written. State defaults to
+     * `'available'` because that is the common case (selling / picking
+     * decisions are driven by available stock).
+     */
+    getLevel(skuId: string, locationId: string, state?: StockState): Promise<StockLevel | null>;
+    /**
+     * Return every level row for the given SKU across all locations and
+     * states. Useful for "where is this SKU?" admin screens.
+     */
+    findBySku(skuId: string): Promise<StockLevel[]>;
+    /**
+     * Return every level row at the given location. Useful for "what is
+     * in this warehouse?" reports.
+     */
+    findByLocation(locationId: string): Promise<StockLevel[]>;
+    /**
+     * Sum `qty` across all level rows for the given SKU. Pass `state` to
+     * narrow the sum to one logical state (e.g. only `available`);
+     * omit it for grand total across all states.
+     */
+    totalForSku(skuId: string, state?: StockState): Promise<number>;
+    /**
+     * Sum `qty` across all level rows at the given location, optionally
+     * narrowed by state.
+     */
+    totalForLocation(locationId: string, state?: StockState): Promise<number>;
+}
+//# sourceMappingURL=StockLevelCollection.d.ts.map

package/dist/collections/StockLevelCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StockLevelCollection.d.ts","sourceRoot":"","sources":["../../src/collections/StockLevelCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClE,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IAExC;;;;;OAKG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,UAAwB,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ7B;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIrD;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI/D;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrE;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;CAMnB"}

package/dist/collections/StockMovementCollection.d.ts

@@ -0,0 +1,38 @@
+/**
+ * StockMovementCollection — read-only access to the append-only audit log.
+ *
+ * Treat this collection as a ledger. The `StockService` is the only
+ * sanctioned writer; query helpers here exist so reporting code, audit
+ * UIs, and cycle-count tooling can reconstruct history.
+ *
+ * @packageDocumentation
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { StockMovement } from '../models/StockMovement.js';
+import type { StockMovementReason } from '../types.js';
+export declare class StockMovementCollection extends SmrtCollection<StockMovement> {
+    static readonly _itemClass: typeof StockMovement;
+    /**
+     * Return every movement for the given SKU, newest first. Useful for a
+     * per-SKU audit trail.
+     */
+    findBySku(skuId: string): Promise<StockMovement[]>;
+    /**
+     * Return every movement at the given location, newest first. Useful
+     * for a per-warehouse audit trail.
+     */
+    findByLocation(locationId: string): Promise<StockMovement[]>;
+    /**
+     * Return every movement attributed to the given upstream source — for
+     * example `findBySource('Contract', contract.id)` returns every
+     * movement caused by the reservation/fulfilment/release of that
+     * contract. Newest first.
+     */
+    findBySource(sourceType: string, sourceId: string): Promise<StockMovement[]>;
+    /**
+     * Return every movement with the given reason code (`'receipt'`,
+     * `'reservation'`, `'adjustment'`, …). Newest first.
+     */
+    findByReason(reasonCode: StockMovementReason): Promise<StockMovement[]>;
+}
+//# sourceMappingURL=StockMovementCollection.d.ts.map

package/dist/collections/StockMovementCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StockMovementCollection.d.ts","sourceRoot":"","sources":["../../src/collections/StockMovementCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAiB;IAE3C;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIxD;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAOlE;;;;;OAKG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC;IAO3B;;;OAGG;IACG,YAAY,CAChB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC;CAM5B"}

package/dist/collections/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Collection exports for `@happyvertical/smrt-inventory`.
+ *
+ * Importing this barrel triggers `__smrt-register__.ts` first so the
+ * package's build-time manifest is published before any class module
+ * (transitively) imported by a collection touches the registry. See
+ * `__smrt-register__.ts` and issue #1132 for the full background.
+ *
+ * @packageDocumentation
+ */
+import '../__smrt-register__.js';
+export { InventoryLocationCollection } from './InventoryLocationCollection.js';
+export { StockLevelCollection } from './StockLevelCollection.js';
+export { StockMovementCollection } from './StockMovementCollection.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}