@happyvertical/smrt-inventory 0.54.2 → 0.54.4

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-inventory",
-  "packageVersion": "0.54.2",
+  "packageVersion": "0.54.4",
   "objects": {
     "@happyvertical/smrt-inventory:InventoryLocationCollection": {
       "name": "inventorylocationcollection",
@@ -234,6 +234,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "findBelowReorderPoint": {
+          "name": "findBelowReorderPoint",
+          "async": true,
+          "parameters": [
+            {
+              "name": "locationId",
+              "type": "string",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<StockLevel[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "totalForSku": {
           "name": "totalForSku",
           "async": true,
@@ -282,7 +296,7 @@
       "collectionExportName": "StockLevelCollectionCollection",
       "schema": {
         "tableName": "inventory_stock_levels",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_levels\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"state\" TEXT NOT NULL DEFAULT 'available',\n  \"qty\" REAL\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_levels\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"state\" TEXT NOT NULL DEFAULT 'available',\n  \"qty\" REAL,\n  \"reorder_point\" REAL,\n  \"reorder_quantity\" REAL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -337,6 +351,16 @@
             "type": "REAL",
             "notNull": false,
             "unique": false
+          },
+          "reorder_point": {
+            "type": "REAL",
+            "notNull": false,
+            "unique": false
+          },
+          "reorder_quantity": {
+            "type": "REAL",
+            "notNull": false,
+            "unique": false
           }
         },
         "indexes": [
@@ -366,7 +390,7 @@
             ]
           }
         ],
-        "version": "7b08362b"
+        "version": "02387935"
       },
       "importPath": "@happyvertical/smrt-inventory"
     },
@@ -450,7 +474,7 @@
       "collectionExportName": "StockMovementCollectionCollection",
       "schema": {
         "tableName": "inventory_stock_movements",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_movements\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"from_state\" TEXT,\n  \"to_state\" TEXT,\n  \"qty\" REAL,\n  \"reason_code\" TEXT NOT NULL DEFAULT 'adjustment',\n  \"source_type\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"note\" TEXT DEFAULT '',\n  \"occurred_at\" TIMESTAMP\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_movements\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"from_state\" TEXT,\n  \"to_state\" TEXT,\n  \"qty\" REAL,\n  \"reason_code\" TEXT NOT NULL DEFAULT 'adjustment',\n  \"source_type\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"actor_profile_id\" UUID,\n  \"note\" TEXT DEFAULT '',\n  \"occurred_at\" TIMESTAMP\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -528,6 +552,12 @@
             "unique": false,
             "default": ""
           },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
           "note": {
             "type": "TEXT",
             "notNull": false,
@@ -554,9 +584,15 @@
               "tenant_id",
               "created_at"
             ]
+          },
+          {
+            "name": "inventory_stock_movements_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
           }
         ],
-        "version": "3c5a0445"
+        "version": "eff1027e"
       },
       "importPath": "@happyvertical/smrt-inventory"
     },
@@ -800,6 +836,20 @@
           "type": "decimal",
           "required": false,
           "_meta": {}
+        },
+        "reorderPoint": {
+          "type": "decimal",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "reorderQuantity": {
+          "type": "decimal",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
         }
       },
       "methods": {},
@@ -855,7 +905,7 @@
       ],
       "schema": {
         "tableName": "inventory_stock_levels",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_levels\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"state\" TEXT NOT NULL DEFAULT 'available',\n  \"qty\" REAL\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_levels\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"state\" TEXT NOT NULL DEFAULT 'available',\n  \"qty\" REAL,\n  \"reorder_point\" REAL,\n  \"reorder_quantity\" REAL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -910,6 +960,16 @@
             "type": "REAL",
             "notNull": false,
             "unique": false
+          },
+          "reorder_point": {
+            "type": "REAL",
+            "notNull": false,
+            "unique": false
+          },
+          "reorder_quantity": {
+            "type": "REAL",
+            "notNull": false,
+            "unique": false
           }
         },
         "indexes": [
@@ -939,7 +999,7 @@
             ]
           }
         ],
-        "version": "7b08362b"
+        "version": "02387935"
       },
       "importPath": "@happyvertical/smrt-inventory"
     },
@@ -1016,6 +1076,11 @@
           "required": false,
           "default": ""
         },
+        "actorProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        },
         "note": {
           "type": "text",
           "required": false,
@@ -1076,7 +1141,7 @@
       ],
       "schema": {
         "tableName": "inventory_stock_movements",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_movements\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"from_state\" TEXT,\n  \"to_state\" TEXT,\n  \"qty\" REAL,\n  \"reason_code\" TEXT NOT NULL DEFAULT 'adjustment',\n  \"source_type\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"note\" TEXT DEFAULT '',\n  \"occurred_at\" TIMESTAMP\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"inventory_stock_movements\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"sku_id\" TEXT NOT NULL DEFAULT '',\n  \"location_id\" TEXT NOT NULL DEFAULT '',\n  \"from_state\" TEXT,\n  \"to_state\" TEXT,\n  \"qty\" REAL,\n  \"reason_code\" TEXT NOT NULL DEFAULT 'adjustment',\n  \"source_type\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"actor_profile_id\" UUID,\n  \"note\" TEXT DEFAULT '',\n  \"occurred_at\" TIMESTAMP\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -1154,6 +1219,12 @@
             "unique": false,
             "default": ""
           },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
           "note": {
             "type": "TEXT",
             "notNull": false,
@@ -1180,9 +1251,15 @@
               "tenant_id",
               "created_at"
             ]
+          },
+          {
+            "name": "inventory_stock_movements_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
           }
         ],
-        "version": "3c5a0445"
+        "version": "eff1027e"
       },
       "importPath": "@happyvertical/smrt-inventory"
     }
@@ -1191,5 +1268,6 @@
   "smrtDependencies": [
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-tenancy"
-  ]
+  ],
+  "stampsConstructors": true
 }

package/dist/models/StockLevel.d.ts

@@ -26,6 +26,8 @@ export interface StockLevelOptions extends SmrtObjectOptions {
     locationId?: string;
     state?: StockState;
     qty?: number;
+    reorderPoint?: number | null;
+    reorderQuantity?: number | null;
 }
 export declare class StockLevel extends SmrtObject {
     /** Tenant scope. `null` means the level row is global. */
@@ -42,6 +44,10 @@ export declare class StockLevel extends SmrtObject {
      * (kilograms, litres, metres).
      */
     qty: number;
+    /** Available-stock threshold; null disables reorder monitoring. */
+    reorderPoint: number | null;
+    /** Optional suggested replenishment quantity, independent of stock balance. */
+    reorderQuantity: number | null;
     constructor(options?: StockLevelOptions);
 }
 //# sourceMappingURL=StockLevel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StockLevel.d.ts","sourceRoot":"","sources":["../../src/models/StockLevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAgBa,UAAW,SAAQ,UAAU;IACxC,0DAA0D;IAE1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,iEAAiE;IAEjE,KAAK,EAAE,MAAM,CAAM;IAEnB,+EAA+E;IAE/E,UAAU,EAAE,MAAM,CAAM;IAExB,6EAA6E;IAE7E,KAAK,EAAE,UAAU,CAAe;IAEhC;;;;OAIG;IAEH,GAAG,EAAE,MAAM,CAAO;gBAEN,OAAO,GAAE,iBAAsB;CAQ5C"}
+{"version":3,"file":"StockLevel.d.ts","sourceRoot":"","sources":["../../src/models/StockLevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,qBAgBa,UAAW,SAAQ,UAAU;IACxC,0DAA0D;IAE1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,iEAAiE;IAEjE,KAAK,EAAE,MAAM,CAAM;IAEnB,+EAA+E;IAE/E,UAAU,EAAE,MAAM,CAAM;IAExB,6EAA6E;IAE7E,KAAK,EAAE,UAAU,CAAe;IAEhC;;;;OAIG;IAEH,GAAG,EAAE,MAAM,CAAO;IAElB,mEAAmE;IAEnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC,+EAA+E;IAE/E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAE1B,OAAO,GAAE,iBAAsB;CAY5C"}

package/dist/models/StockMovement.d.ts

@@ -35,6 +35,7 @@ export interface StockMovementOptions extends SmrtObjectOptions {
     reasonCode?: StockMovementReason;
     sourceType?: string;
     sourceId?: string;
+    actorProfileId?: string | null;
     note?: string;
     occurredAt?: Date | string;
 }
@@ -76,6 +77,8 @@ export declare class StockMovement extends SmrtObject {
      * the framework never dereferences it.
      */
     sourceId: string;
+    /** Profile responsible for this movement; null for unattributed automation. */
+    actorProfileId: string | null;
     /** Optional free-form note shown in audit UIs. */
     note: string;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"StockMovement.d.ts","sourceRoot":"","sources":["../../src/models/StockMovement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC5B;AAED,qBAmBa,aAAc,SAAQ,UAAU;IAC3C,yDAAyD;IAEzD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,6DAA6D;IAE7D,KAAK,EAAE,MAAM,CAAM;IAEnB,6EAA6E;IAE7E,UAAU,EAAE,MAAM,CAAM;IAExB;;;;OAIG;IACH,SAAS,EAAE,UAAU,GAAG,IAAI,CAAQ;IAEpC;;;OAGG;IACH,OAAO,EAAE,UAAU,GAAG,IAAI,CAAQ;IAElC,4EAA4E;IAE5E,GAAG,EAAE,MAAM,CAAO;IAElB;;;;OAIG;IAEH,UAAU,EAAE,mBAAmB,CAAgB;IAE/C;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAM;IAElB;;;OAGG;IACH,UAAU,EAAE,IAAI,CAAc;gBAElB,OAAO,GAAE,oBAAyB;CAmB/C"}
+{"version":3,"file":"StockMovement.d.ts","sourceRoot":"","sources":["../../src/models/StockMovement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC5B;AAED,qBAmBa,aAAc,SAAQ,UAAU;IAC3C,yDAAyD;IAEzD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,6DAA6D;IAE7D,KAAK,EAAE,MAAM,CAAM;IAEnB,6EAA6E;IAE7E,UAAU,EAAE,MAAM,CAAM;IAExB;;;;OAIG;IACH,SAAS,EAAE,UAAU,GAAG,IAAI,CAAQ;IAEpC;;;OAGG;IACH,OAAO,EAAE,UAAU,GAAG,IAAI,CAAQ;IAElC,4EAA4E;IAE5E,GAAG,EAAE,MAAM,CAAO;IAElB;;;;OAIG;IAEH,UAAU,EAAE,mBAAmB,CAAgB;IAE/C;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB,+EAA+E;IAE/E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAErC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAM;IAElB;;;OAGG;IACH,UAAU,EAAE,IAAI,CAAc;gBAElB,OAAO,GAAE,oBAAyB;CAqB/C"}

package/dist/services/StockService.d.ts

@@ -41,6 +41,7 @@
  */
 import { type DatabaseConfig } from '@happyvertical/smrt-core';
 import { InventoryLocationCollection, StockLevelCollection, StockMovementCollection } from '../collections/index.js';
+import type { StockLevel } from '../models/StockLevel.js';
 import type { StockMovementReason, StockState } from '../types.js';
 /**
  * Thrown by {@link StockService.reserve} (and {@link StockService.fulfill},
@@ -68,6 +69,8 @@ export interface StockMutationOptions {
     sourceType?: string;
     /** Cross-package id of the row that caused this mutation. */
     sourceId?: string;
+    /** Trusted actor attribution; null for unattended or legacy callers. */
+    actorProfileId?: string | null;
     /** Free-form note shown in audit UIs. */
     note?: string;
     /**
@@ -205,6 +208,12 @@ export declare class StockService {
      * credited).
      */
     transfer(skuId: string, fromLocationId: string, toLocationId: string, qty: number, options?: StockMutationOptions): Promise<void>;
+    /**
+     * Configure replenishment for the available row at a SKU/location.
+     * Null disables the threshold. Metadata changes never fabricate movements.
+     * The optional quantity is replaced (omitting it clears the suggestion).
+     */
+    setReorderPolicy(skuId: string, locationId: string, reorderPoint: number | null, reorderQuantity?: number | null): Promise<StockLevel>;
     /**
      * Apply a positive or negative `delta` to a level row. Used for cycle
      * counts and one-off corrections; `delta=+5` adds five units,

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

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

package/dist/smrt-knowledge.json

@@ -3,33 +3,40 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-inventory",
-  "packageVersion": "0.54.2",
+  "packageVersion": "0.54.4",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "ea75aa33b762ee763560831b671611281a1221c68dd0906bebb08e37fbc54da0",
-    "packageJson": "1fc98eac777920ec1a3281abe3f8c95c5fdd04eeecc23f1d4240a8ad40f600d6",
-    "agents": "a771bf16d21cabbe43a77d5cb87ca7dedbf2e68d1928cf804cf4fefaad7a765f"
+    "manifest": "874078a8386fdd561db1706030671d467922244377177102c365aca39bf704ec",
+    "packageJson": "f5479a5e62c6d20d01833b1585a64932b41c4e9b619722727277b31511eaddef",
+    "agents": "f1e6618e492c2726dee29c3e3fb203c03a64de184c7992407a1025b12618625d"
   },
   "exports": [
     ".",
     "./manifest",
-    "./manifest.json"
+    "./manifest.json",
+    "./svelte"
   ],
   "dependencies": {
     "@happyvertical/logger": "catalog:",
     "@happyvertical/smrt-core": "workspace:*",
     "@happyvertical/smrt-tenancy": "workspace:*",
     "@happyvertical/sql": "catalog:",
+    "@happyvertical/smrt-ui": "workspace:*",
     "@happyvertical/smrt-vitest": "workspace:*",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",
-    "vitest": "4.1.10"
+    "vitest": "4.1.10",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "svelte": "^5.57.0",
+    "svelte-check": "^4.7.6"
   },
   "smrtDependencies": [
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-ui",
     "@happyvertical/smrt-vitest"
   ],
   "sdkDependencies": [
@@ -47,6 +54,7 @@
     "warehouse"
   ],
   "risks": [
+    "cross-package-refs:1",
     "sensitive-fields-excluded"
   ],
   "objects": [
@@ -197,6 +205,7 @@
       "fields": [],
       "relationships": [],
       "methods": [
+        "findBelowReorderPoint",
         "findByLocation",
         "findBySku",
         "getLevel",
@@ -204,6 +213,14 @@
         "totalForSku"
       ],
       "methodSignatures": [
+        {
+          "name": "findBelowReorderPoint",
+          "async": true,
+          "params": [
+            "locationId?: string"
+          ],
+          "returns": "Promise<StockLevel[]>"
+        },
         {
           "name": "findByLocation",
           "async": true,
@@ -274,6 +291,14 @@
           "path": "/stocklevels/findByLocation",
           "method": "POST"
         },
+        {
+          "kind": "api",
+          "name": "stocklevels.findBelowReorderPoint",
+          "operation": "findBelowReorderPoint",
+          "objectName": "@happyvertical/smrt-inventory:StockLevelCollection",
+          "path": "/stocklevels/findBelowReorderPoint",
+          "method": "POST"
+        },
         {
           "kind": "api",
           "name": "stocklevels.totalForSku",
@@ -308,6 +333,12 @@
           "operation": "findByLocation",
           "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
         },
+        {
+          "kind": "cli",
+          "name": "stocklevelcollection_findBelowReorderPoint",
+          "operation": "findBelowReorderPoint",
+          "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
+        },
         {
           "kind": "cli",
           "name": "stocklevelcollection_totalForSku",
@@ -338,6 +369,12 @@
           "operation": "findByLocation",
           "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
         },
+        {
+          "kind": "mcp",
+          "name": "stocklevelcollection_findbelowreorderpoint",
+          "operation": "findBelowReorderPoint",
+          "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
+        },
         {
           "kind": "mcp",
           "name": "stocklevelcollection_totalforsku",
@@ -678,6 +715,18 @@
           "type": "decimal",
           "required": false,
           "columnType": "REAL"
+        },
+        {
+          "name": "reorderPoint",
+          "type": "decimal",
+          "required": false,
+          "columnType": "REAL"
+        },
+        {
+          "name": "reorderQuantity",
+          "type": "decimal",
+          "required": false,
+          "columnType": "REAL"
         }
       ],
       "relationships": [],
@@ -808,6 +857,13 @@
           "columnType": "TEXT",
           "default": ""
         },
+        {
+          "name": "actorProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
         {
           "name": "note",
           "type": "text",
@@ -822,7 +878,15 @@
           "columnType": "TIMESTAMP"
         }
       ],
-      "relationships": [],
+      "relationships": [
+        {
+          "name": "actorProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        }
+      ],
       "methods": [],
       "tenant": {
         "scoped": true,
@@ -875,6 +939,7 @@
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "uuidColumns"
       ],
       "tags": [],
@@ -986,6 +1051,14 @@
       "path": "/stocklevels/findByLocation",
       "method": "POST"
     },
+    {
+      "kind": "api",
+      "name": "stocklevels.findBelowReorderPoint",
+      "operation": "findBelowReorderPoint",
+      "objectName": "@happyvertical/smrt-inventory:StockLevelCollection",
+      "path": "/stocklevels/findBelowReorderPoint",
+      "method": "POST"
+    },
     {
       "kind": "api",
       "name": "stocklevels.totalForSku",
@@ -1020,6 +1093,12 @@
       "operation": "findByLocation",
       "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
     },
+    {
+      "kind": "cli",
+      "name": "stocklevelcollection_findBelowReorderPoint",
+      "operation": "findBelowReorderPoint",
+      "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
+    },
     {
       "kind": "cli",
       "name": "stocklevelcollection_totalForSku",
@@ -1050,6 +1129,12 @@
       "operation": "findByLocation",
       "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
     },
+    {
+      "kind": "mcp",
+      "name": "stocklevelcollection_findbelowreorderpoint",
+      "operation": "findBelowReorderPoint",
+      "objectName": "@happyvertical/smrt-inventory:StockLevelCollection"
+    },
     {
       "kind": "mcp",
       "name": "stocklevelcollection_totalforsku",
@@ -1300,11 +1385,11 @@
   "prompts": [],
   "relationshipsV2": {
     "foreignKeyFields": 0,
-    "crossPackageRefFields": 0,
+    "crossPackageRefFields": 1,
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 12
+    "uuidColumns": 14
   },
-  "agentDoc": "# @happyvertical/smrt-inventory\n\nMulti-location stock tracking. Strictly industry-neutral — the same primitives serve apparel, furniture, automotive, CPG, electronics, and any other vertical that counts discrete units across locations.\n\n## Models\n\n| Model | Purpose |\n|---|---|\n| _(catalog shapes — `Product`, `Material`, `ProductVariant`, `Sku` — live in `@happyvertical/smrt-products`)_ | Sku is the smallest sellable / countable unit; its `attributes` JSON carries axis-value pins. ProductVariant is the per-product axis declaration. Import either from `@happyvertical/smrt-products` directly. |\n| `InventoryLocation` | Warehouse / factory / retail / in-transit / virtual. Open-ended `kind` string. Optional `placeId` references `@happyvertical/smrt-places`. `conflictColumns: ['code', 'tenant_id']`. |\n| `StockLevel` | Materialized `qty` for a `(skuId, locationId, state)` tuple. Upserted in place. **Mutated only by `StockService`.** States: `available`, `allocated`, `wip`, `qc_hold`, `damaged`. |\n| `StockMovement` | Append-only audit log. Every `StockService` mutation writes one (or two for `transfer`). `sourceType` + `sourceId` carry cross-package attribution. |\n\nAll three inventory models (`InventoryLocation`, `StockLevel`, `StockMovement`) use `@TenantScoped({ mode: 'optional' })` + nullable `tenantId` so they can be used either tenant-scoped or globally. The catalog shapes (`Product`, `Material`, `ProductVariant`, `Sku`) live in `@happyvertical/smrt-products` and carry their own tenant decoration there.\n\n## StockService — the only sanctioned way to mutate stock\n\n```typescript\nimport { createStockService } from '@happyvertical/smrt-inventory';\n\nconst service = await createStockService({ db });\nawait service.receive(skuId, locationId, qty, { sourceType, sourceId });\nawait service.reserve(skuId, locationId, qty, { sourceType, sourceId });\nawait service.release(skuId, locationId, qty, { sourceType, sourceId });\nawait service.fulfill(skuId, locationId, qty, { sourceType, sourceId });\nawait service.transfer(skuId, fromLocId, toLocId, qty, { sourceType, sourceId });\nawait service.adjust(skuId, locationId, delta, { sourceType, sourceId });\n```\n\n| Method | Behavior | Movement reason |\n|---|---|---|\n| `receive` | +qty available — purchase receipt, return, production produce | `receipt` |\n| `reserve` | available → allocated. Throws `InsufficientStockError` on overdraw | `reservation` |\n| `release` | allocated → available (order cancel) | `release` |\n| `fulfill` | -qty allocated. Stock leaves the building | `fulfillment` |\n| `transfer` | move stock between locations (writes two movements) | `transfer_out`, `transfer_in` |\n| `adjust` | signed delta — cycle counts and one-off corrections | `adjustment` |\n\nAll methods reject zero / negative / non-finite quantities except `adjust`, which accepts non-zero signed deltas. Negative deltas that would drive a state below zero throw `InsufficientStockError`.\n\n## Opt-in DispatchBus hooks\n\nOff by default. Wire them up explicitly in the application's `smrt.ts`:\n\n```typescript\nimport { installInventoryDispatchHandlers } from '@happyvertical/smrt-inventory';\n\nconst handlers = await installInventoryDispatchHandlers({\n  dispatchBus: bus,\n  db, // or stockService: existingService\n});\n```\n\nThis subscribes to:\n- `contract:created` → calls `service.reserve()` for every line inside one `stockService.withTransaction(...)`, attributed to `('Contract', payload.contractId)`\n- `fulfillment:shipped` → calls `service.fulfill()` for every line inside one `stockService.withTransaction(...)`, attributed to `('Fulfillment', payload.fulfillmentId)`\n\nBoth handlers are atomic across lines: a shortfall on line N rolls back lines 1..N-1 so the event is all-or-nothing. Without this guarantee, `DispatchBus` would only log the async handler error and a partially-reserved (or partially-fulfilled) contract would have no compensating event to fix it.\n\nPer-handler toggles: `installContractReserved`, `installFulfillmentShipped`. The `production_order:posted` hook is deliberately not installed here — it depends on the BOM model and ships in `@happyvertical/smrt-manufacturing` (issue #1250).\n\n## Schema migration (Phase 1 release)\n\nThe `Sku` model moved out of this package and into `@happyvertical/smrt-products`. Previously it lived in this package's `inventory_skus` table; it now lives in `product_skus` over there.\n\n**Upgrade procedure** for deployed consumers:\n\n1. **Let the framework create the destination table first.** Boot the new version once with `@happyvertical/smrt-products` registered in your `SmrtClassOptions`; the lazy `syncSchema` path will create `product_skus` with the right primary key, NOT NULL, UNIQUE (`code`, `tenant_id`), and indexes — they're derived from the `Sku` model decorators and would be stripped by a raw `CREATE TABLE AS SELECT`.\n\n2. **Idempotently copy rows across.** SQLite + Postgres:\n\n   ```sql\n   BEGIN;\n   INSERT INTO product_skus (\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   )\n   SELECT\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   FROM inventory_skus\n   WHERE NOT EXISTS (\n     SELECT 1 FROM product_skus p WHERE p.id = inventory_skus.id\n   );\n   COMMIT;\n   ```\n\n3. **Drop the legacy table** once you've verified row counts match:\n\n   ```sql\n   DROP TABLE IF EXISTS inventory_skus;\n   ```\n\n`StockLevel.skuId` and `StockMovement.skuId` carry plain string ids that still resolve to the same rows after the rename, so no inventory data has to move.\n\n## Gotchas\n\n- **Movements are append-only.** The materialized `StockLevel` row is derived state; the `StockMovement` ledger is the source of truth. Never let CRUD UIs expose update/delete on the movement table. If you find yourself wanting to \"fix\" a movement row, write a compensating `adjust()` call instead.\n- **Never call `StockLevel.create()` or `save()` directly.** Going around `StockService` silently desyncs the audit log and breaks cycle counts.\n- **Cross-industry constraint.** This package's vocabulary stays generic: `InventoryLocation`, `StockLevel`, `StockMovement`. Apparel-specific concepts (`Style`, `Makeup`, `Colorway`, fashion `Season`, tech-pack metadata) and their analogues in furniture / automotive / CPG live in the relevant template package, never here. PRs that introduce industry vocabulary should be rejected.\n- **Cross-package references are plain strings.** `skuId`, `placeId`, `sourceId` — all plain string ids, never `@foreignKey()`. Inventory's stock-motion logic only ever reads StockLevel/StockMovement; it doesn't follow `skuId` back to the catalog's Sku table, so the layering stays loose.\n- **`conflictColumns` include `tenant_id`** on `InventoryLocation` and `StockLevel`. NULL-matching semantics (`(code, NULL) IS NOT DISTINCT FROM (code, NULL)`) are handled by `@happyvertical/sql >= 0.74.0` natively, so two saves with the same `(code, NULL)` tuple correctly merge in place. Pass `nullsDistinct: true` at the sql layer to opt back into NULL-distinct semantics.\n- **Atomic per-method, transactional across composition.** Each `StockService` mutation (`receive` / `reserve` / `release` / `fulfill` / `transfer` / `adjust`) wraps every write in a single `db.transaction(...)` (via `@happyvertical/sql >= 0.74.0`). Partial failure rolls the whole call back — level writes and the matching `StockMovement` audit row commit together or not at all. `transfer` writes both legs (source decrement, destination increment, and both audit rows) inside one tx, so a failure mid-`transfer` is fully reverted.\n  Callers composing multiple `StockService` calls into one logical unit (e.g. consuming materials line-by-line for a production order) should wrap them in `await stockService.withTransaction(async (tx) => { ... })` — `tx` is a tx-bound `StockService` with the same public API; mutation calls inside the callback share one transaction and either all commit or all roll back.\n  If the underlying SQL adapter does not expose `transaction()` (extremely rare — all four built-in `@happyvertical/sql >= 0.74.0` adapters implement it), the service degrades to non-atomic serial writes and emits a one-time `console.warn`.\n- **Concurrent reservations: tightened, not bulletproof.** `@happyvertical/sql >= 0.74.0` serialises null-aware *upserts* via a per-key in-process lock (SQLite) or advisory lock (Postgres). That lock fixed the row-creation race (issue #1246) — two concurrent `create()` calls on the same conflict-column tuple no longer race the underlying `INSERT ... ON CONFLICT`. It does NOT serialise the read-modify-write compound that `reserve` / `fulfill` / `transfer` / `adjust` perform on an existing row: each method reads the current level (`SELECT`), computes the new value in JS, then writes it back (`UPDATE` via `save()` on the loaded row). The whole compound is inside one `db.transaction(...)` from round-3, so the level write and audit row commit together — but two concurrent transactions on the same `(skuId, locationId)` can each see the same starting balance, compute the same decrement, and double-spend. Awaited (serial) calls always behave correctly. Use a job queue (e.g. `@happyvertical/smrt-jobs`) or your own mutex when you need hard atomicity across concurrent callers. The full fix is `SELECT ... FOR UPDATE` inside the same transaction (Postgres) or upgrading the journal mode (SQLite); deferred until we see a real high-contention workload that warrants it.\n\n## Source attribution\n\nEvery `StockMovement` carries `sourceType` + `sourceId` so downstream queries can reconstruct \"what caused this movement\". Conventions used by the built-in dispatch handlers:\n\n| sourceType | Emitter | Note |\n|---|---|---|\n| `Contract` | `smrt-commerce` `contract:created` | All reservation/release/fulfilment legs caused by a contract |\n| `Fulfillment` | `smrt-commerce` `fulfillment:shipped` | Outbound shipment |\n| `PurchaseOrder` | (your code) | Inbound receipt |\n| `CycleCount` | (your code) | Adjustments from physical counts |\n| `TransferOrder` | (your code) | Both legs of a transfer |\n| `ProductionOrder` | `smrt-manufacturing` (issue #1250) | Materials consumed + finished goods produced |\n"
+  "agentDoc": "# @happyvertical/smrt-inventory\n\nMulti-location stock tracking. Strictly industry-neutral — the same primitives serve apparel, furniture, automotive, CPG, electronics, and any other vertical that counts discrete units across locations.\n\n## Models\n\n| Model | Purpose |\n|---|---|\n| _(catalog shapes — `Product`, `Material`, `ProductVariant`, `Sku` — live in `@happyvertical/smrt-products`)_ | Sku is the smallest sellable / countable unit; its `attributes` JSON carries axis-value pins. ProductVariant is the per-product axis declaration. Import either from `@happyvertical/smrt-products` directly. |\n| `InventoryLocation` | Warehouse / factory / retail / in-transit / virtual. Open-ended `kind` string. Optional `placeId` references `@happyvertical/smrt-places`. `conflictColumns: ['code', 'tenant_id']`. |\n| `StockLevel` | Materialized `qty` for a `(skuId, locationId, state)` tuple. Upserted in place. **Mutated only by `StockService`.** States: `available`, `allocated`, `wip`, `qc_hold`, `damaged`. |\n| `StockMovement` | Append-only audit log. Every `StockService` mutation writes one (or two for `transfer`). `sourceType` + `sourceId` carry cross-package attribution. |\n\nAll three inventory models (`InventoryLocation`, `StockLevel`, `StockMovement`) use `@TenantScoped({ mode: 'optional' })` + nullable `tenantId` so they can be used either tenant-scoped or globally. The catalog shapes (`Product`, `Material`, `ProductVariant`, `Sku`) live in `@happyvertical/smrt-products` and carry their own tenant decoration there.\n\n## StockService — the only sanctioned way to mutate stock\n\n```typescript\nimport { createStockService } from '@happyvertical/smrt-inventory';\n\nconst service = await createStockService({ db });\nawait service.receive(skuId, locationId, qty, { sourceType, sourceId });\nawait service.reserve(skuId, locationId, qty, { sourceType, sourceId });\nawait service.release(skuId, locationId, qty, { sourceType, sourceId });\nawait service.fulfill(skuId, locationId, qty, { sourceType, sourceId });\nawait service.transfer(skuId, fromLocId, toLocId, qty, { sourceType, sourceId });\nawait service.adjust(skuId, locationId, delta, { sourceType, sourceId });\n```\n\n| Method | Behavior | Movement reason |\n|---|---|---|\n| `receive` | +qty available — purchase receipt, return, production produce | `receipt` |\n| `reserve` | available → allocated. Throws `InsufficientStockError` on overdraw | `reservation` |\n| `release` | allocated → available (order cancel) | `release` |\n| `fulfill` | -qty allocated. Stock leaves the building | `fulfillment` |\n| `transfer` | move stock between locations (writes two movements) | `transfer_out`, `transfer_in` |\n| `adjust` | signed delta — cycle counts and one-off corrections | `adjustment` |\n\nAll methods reject zero / negative / non-finite quantities except `adjust`, which accepts non-zero signed deltas. Negative deltas that would drive a state below zero throw `InsufficientStockError`.\n\n## Opt-in DispatchBus hooks\n\nOff by default. Wire them up explicitly in the application's `smrt.ts`:\n\n```typescript\nimport { installInventoryDispatchHandlers } from '@happyvertical/smrt-inventory';\n\nconst handlers = await installInventoryDispatchHandlers({\n  dispatchBus: bus,\n  db, // or stockService: existingService\n});\n```\n\nThis subscribes to:\n- `contract:created` → calls `service.reserve()` for every line inside one `stockService.withTransaction(...)`, attributed to `('Contract', payload.contractId)`\n- `fulfillment:shipped` → calls `service.fulfill()` for every line inside one `stockService.withTransaction(...)`, attributed to `('Fulfillment', payload.fulfillmentId)`\n\nBoth handlers are atomic across lines: a shortfall on line N rolls back lines 1..N-1 so the event is all-or-nothing. Without this guarantee, `DispatchBus` would only log the async handler error and a partially-reserved (or partially-fulfilled) contract would have no compensating event to fix it.\n\nPer-handler toggles: `installContractReserved`, `installFulfillmentShipped`. The `production_order:posted` hook is deliberately not installed here — it depends on the BOM model and ships in `@happyvertical/smrt-manufacturing` (issue #1250).\n\n## Schema migration (Phase 1 release)\n\nThe `Sku` model moved out of this package and into `@happyvertical/smrt-products`. Previously it lived in this package's `inventory_skus` table; it now lives in `product_skus` over there.\n\n**Upgrade procedure** for deployed consumers:\n\n1. **Let the framework create the destination table first.** Boot the new version once with `@happyvertical/smrt-products` registered in your `SmrtClassOptions`; the lazy `syncSchema` path will create `product_skus` with the right primary key, NOT NULL, UNIQUE (`code`, `tenant_id`), and indexes — they're derived from the `Sku` model decorators and would be stripped by a raw `CREATE TABLE AS SELECT`.\n\n2. **Idempotently copy rows across.** SQLite + Postgres:\n\n   ```sql\n   BEGIN;\n   INSERT INTO product_skus (\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   )\n   SELECT\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   FROM inventory_skus\n   WHERE NOT EXISTS (\n     SELECT 1 FROM product_skus p WHERE p.id = inventory_skus.id\n   );\n   COMMIT;\n   ```\n\n3. **Drop the legacy table** once you've verified row counts match:\n\n   ```sql\n   DROP TABLE IF EXISTS inventory_skus;\n   ```\n\n`StockLevel.skuId` and `StockMovement.skuId` carry plain string ids that still resolve to the same rows after the rename, so no inventory data has to move.\n\n## Gotchas\n\n- **Movements are append-only.** The materialized `StockLevel` row is derived state; the `StockMovement` ledger is the source of truth. Never let CRUD UIs expose update/delete on the movement table. If you find yourself wanting to \"fix\" a movement row, write a compensating `adjust()` call instead.\n- **Never call `StockLevel.create()` or `save()` directly.** Going around `StockService` silently desyncs the audit log and breaks cycle counts.\n- **Cross-industry constraint.** This package's vocabulary stays generic: `InventoryLocation`, `StockLevel`, `StockMovement`. Apparel-specific concepts (`Style`, `Makeup`, `Colorway`, fashion `Season`, tech-pack metadata) and their analogues in furniture / automotive / CPG live in the relevant template package, never here. PRs that introduce industry vocabulary should be rejected.\n- **Cross-package references are plain strings.** `skuId`, `placeId`, `sourceId` — all plain string ids, never `@foreignKey()`. Inventory's stock-motion logic only ever reads StockLevel/StockMovement; it doesn't follow `skuId` back to the catalog's Sku table, so the layering stays loose.\n- **`conflictColumns` include `tenant_id`** on `InventoryLocation` and `StockLevel`. NULL-matching semantics (`(code, NULL) IS NOT DISTINCT FROM (code, NULL)`) are handled by `@happyvertical/sql >= 0.74.0` natively, so two saves with the same `(code, NULL)` tuple correctly merge in place. Pass `nullsDistinct: true` at the sql layer to opt back into NULL-distinct semantics.\n- **Atomic per-method, transactional across composition.** Each `StockService` mutation (`receive` / `reserve` / `release` / `fulfill` / `transfer` / `adjust`) wraps every write in a single `db.transaction(...)` (via `@happyvertical/sql >= 0.74.0`). Partial failure rolls the whole call back — level writes and the matching `StockMovement` audit row commit together or not at all. `transfer` writes both legs (source decrement, destination increment, and both audit rows) inside one tx, so a failure mid-`transfer` is fully reverted.\n  Callers composing multiple `StockService` calls into one logical unit (e.g. consuming materials line-by-line for a production order) should wrap them in `await stockService.withTransaction(async (tx) => { ... })` — `tx` is a tx-bound `StockService` with the same public API; mutation calls inside the callback share one transaction and either all commit or all roll back.\n  If the underlying SQL adapter does not expose `transaction()` (extremely rare — all four built-in `@happyvertical/sql >= 0.74.0` adapters implement it), the service degrades to non-atomic serial writes and emits a one-time `console.warn`.\n- **Concurrent reservations: tightened, not bulletproof.** `@happyvertical/sql >= 0.74.0` serialises null-aware *upserts* via a per-key in-process lock (SQLite) or advisory lock (Postgres). That lock fixed the row-creation race (issue #1246) — two concurrent `create()` calls on the same conflict-column tuple no longer race the underlying `INSERT ... ON CONFLICT`. It does NOT serialise the read-modify-write compound that `reserve` / `fulfill` / `transfer` / `adjust` perform on an existing row: each method reads the current level (`SELECT`), computes the new value in JS, then writes it back (`UPDATE` via `save()` on the loaded row). The whole compound is inside one `db.transaction(...)` from round-3, so the level write and audit row commit together — but two concurrent transactions on the same `(skuId, locationId)` can each see the same starting balance, compute the same decrement, and double-spend. Awaited (serial) calls always behave correctly. Use a job queue (e.g. `@happyvertical/smrt-jobs`) or your own mutex when you need hard atomicity across concurrent callers. The full fix is `SELECT ... FOR UPDATE` inside the same transaction (Postgres) or upgrading the journal mode (SQLite); deferred until we see a real high-contention workload that warrants it.\n\n## Source attribution\n\nEvery `StockMovement` carries `sourceType` + `sourceId` so downstream queries can reconstruct \"what caused this movement\". Conventions used by the built-in dispatch handlers:\n\n| sourceType | Emitter | Note |\n|---|---|---|\n| `Contract` | `smrt-commerce` `contract:created` | All reservation/release/fulfilment legs caused by a contract |\n| `Fulfillment` | `smrt-commerce` `fulfillment:shipped` | Outbound shipment |\n| `PurchaseOrder` | (your code) | Inbound receipt |\n| `CycleCount` | (your code) | Adjustments from physical counts |\n| `TransferOrder` | (your code) | Both legs of a transfer |\n| `ProductionOrder` | `smrt-manufacturing` (issue #1250) | Materials consumed + finished goods produced |\n\n## Replenishment and browser components\n\n`StockService.setReorderPolicy()` is the sanctioned metadata writer for nullable\n`StockLevel.reorderPoint` / `reorderQuantity` on the available SKU/location row.\nIt does not change quantity or emit a movement. `findBelowReorderPoint()` uses\npublic tenant-filtered collection reads and strict less-than semantics.\n`StockMutationOptions.actorProfileId` propagates to every movement, including\nboth transfer legs; null retains compatibility for automation. It is a qualified\ncross-package profile reference, not an authorization decision.\n\n`src/svelte/` exports data-driven components through `./svelte`. Server callers\nown authentication and persistence callbacks; never import backend models into\nthis entry or expose ledger mutations as CRUD. Package `typecheck` includes\nSvelte checks and `test` includes DOM component tests. See README for the public\nprops, service contracts, and additive schema upgrade requirements.\n"
 }

package/dist/svelte/AdjustStockForm.svelte

@@ -0,0 +1,59 @@
+<script lang="ts">
+import { Form, FormGroup, Input } from '@happyvertical/smrt-ui/forms';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import type { StockAdjustmentInput } from './types.js';
+export interface Props {
+  skuId: string;
+  locationId: string;
+  onsubmit: (input: StockAdjustmentInput) => Promise<void> | void;
+  disabled?: boolean;
+}
+const { skuId, locationId, onsubmit, disabled = false }: Props = $props();
+let delta = $state<string | number>('');
+let reasonCode = $state('adjustment');
+let note = $state('');
+let pending = $state(false);
+let error = $state('');
+let saved = $state(false);
+async function submit(event: SubmitEvent) {
+  event.preventDefault();
+  if (pending || disabled) return;
+  error = '';
+  saved = false;
+  const quantity = Number(delta);
+  if (
+    !skuId.trim() ||
+    !locationId.trim() ||
+    !Number.isFinite(quantity) ||
+    quantity === 0 ||
+    !reasonCode.trim()
+  ) {
+    error = 'Choose a SKU and location, a non-zero quantity, and a reason.';
+    return;
+  }
+  pending = true;
+  try {
+    await onsubmit({
+      skuId,
+      locationId,
+      delta: quantity,
+      reasonCode: reasonCode.trim(),
+      note,
+    });
+    saved = true;
+  } catch (cause) {
+    error = cause instanceof Error ? cause.message : 'Unable to adjust stock.';
+  } finally {
+    pending = false;
+  }
+}
+</script>
+<Form onsubmit={submit} aria-label="Adjust stock">
+  <p>SKU: {skuId} · Location: {locationId}</p>
+  <FormGroup label="Quantity adjustment"><Input type="number" step="any" bind:value={delta} required disabled={disabled || pending} /></FormGroup>
+  <FormGroup label="Reason"><Input bind:value={reasonCode} required disabled={disabled || pending} /></FormGroup>
+  <FormGroup label="Note"><Input bind:value={note} disabled={disabled || pending} /></FormGroup>
+  {#if error}<p role="alert">{error}</p>{/if}
+  {#if saved}<p role="status">Stock adjusted</p>{/if}
+  <Button type="submit" disabled={disabled || pending}>{pending ? 'Saving…' : 'Adjust stock'}</Button>
+</Form>