@spinekit/purchase 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
-## 0.1.0 - 2026-08-21
+## 0.2.0 - 2026-08-23
+
+### Changed
+
+- **`PurchaseStockReceiptDeps.skuRef` now accepts `string | Promise<string>`** — the correct key is the variant's stamped `skuRef` on the product document; a host resolving it must be allowed a read. Sync legacy derivations remain assignable — no existing host breaks. `createPurchaseStockReceipt` now `await`s the call.
+
+## 0.1.1 - 2026-08-21
 
 ### Changed
 - **License:** relicensed from MIT to the **Classytic Source-Available License**

package/dist/receipt/purchase-stock-receipt.mjs

@@ -64,7 +64,7 @@ async receive({ purchase, supplierName }) {
 				resolved.push({
 					productId,
 					variantSku,
-					skuRef: deps.skuRef(productId, variantSku),
+					skuRef: await deps.skuRef(productId, variantSku),
 					quantity: Number(item.quantity ?? 0),
 					costMinor: Number(item.costPrice ?? 0),
 					destinationLocationCode

package/dist/receipt/purchase-stock-receipt.types.d.mts

@@ -147,8 +147,15 @@ interface PurchaseStockReceiptDeps<TCtx extends PurchaseReceiptScope = PurchaseR
    * implementation for a deployment that provisions ahead of time.
    */
   ensureBranchReady(organizationId: string): Promise<void>;
-  /** The host's `productId` (+ variant) → `skuRef` convention. */
-  skuRef(productId: string, variantSku: string | null): string;
+  /**
+   * The host's `productId` (+ variant) -> `skuRef` resolution.
+   *
+   * May be async: the correct key is the variant's STAMPED `skuRef` (ADR
+   * `spine/docs/stock-identity-and-product-variants.md`), which lives on the
+   * product DOC — a host resolving it must be allowed a read. A sync legacy
+   * derivation remains assignable, so no existing host breaks.
+   */
+  skuRef(productId: string, variantSku: string | null): string | Promise<string>;
   /** Counterparty location goods arrive FROM — unbounded by design. */
   vendorLocationId: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spinekit/purchase",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Arc module for @classytic/purchase — supplier purchase orders (draft→approve→receive with CAS + compensation + pendingStockReceipt crash heal) composed into arc apps. Paisa money wire; catalog/stockReceipt/sequence kernel ports injected; accounting posting + approval stay host seams.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -74,13 +74,6 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
-  },
   "peerDependencies": {
     "@classytic/arc": ">=2.34.0",
     "@spinekit/kit": ">=0.1.0",
@@ -92,7 +85,6 @@
   },
   "devDependencies": {
     "@classytic/arc": "^2.34.0",
-    "@spinekit/kit": "workspace:*",
     "@classytic/arc-testkit": "^0.4.0",
     "@classytic/mongokit": ">=3.34.0",
     "@classytic/primitives": ">=0.23.0",
@@ -104,7 +96,8 @@
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^3.2.4",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@spinekit/kit": "0.1.1"
   },
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@spinekit/purchase",
@@ -125,5 +118,11 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
   }
-}
+}