@final-commerce/command-frame 0.6.0-staging.4 → 0.6.0

package/README.md

@@ -18,6 +18,8 @@ The library provides three main capabilities:
 
 Domain models (orders, cart, customers, products, and related types) are documented in **[Types reference](./src/types/README.md)**.
 
+The order lifecycle — payment × fulfillment state pairs, display labels, the transition guard chain, and the financial invariants — is documented in **[Order state machine reference](./docs/order-state-machine.md)**. Read it before building anything that reads or moves order state (`canTransition`, `getAvailableTransitions`, `applyTransition`, park/void/resume, payments, refunds).
+
 ## Installation
 
 ### From npm (public registry)

package/dist/actions/add-product-to-cart/types.d.ts

@@ -1,5 +1,5 @@
-import type { AddProductDiscountParams } from "../add-product-discount/types";
-import type { AddProductFeeParams } from "../add-product-fee/types";
+import type { AddProductDiscountParams } from '../add-product-discount/types';
+import type { AddProductFeeParams } from '../add-product-fee/types';
 export interface AddProductToCartParams {
     /** ID of the variant to add. */
     variantId: string;

package/dist/actions/get-available-transitions/mock.d.ts

@@ -2,7 +2,12 @@ import type { GetAvailableTransitions } from './types';
 /**
  * Mock implementation: returns a fixed set of plausible transitions
  * so the demo app has data to render. Mirrors an UNPAID order under the
- * default (empty cross-axis rules) config: fulfillment can advance without
- * payment (FI-6383), plus the classic park/void moves.
+ * default (empty cross-axis rules) config.
+ *
+ * FULFILLMENT-AXIS ONLY (common 2.1.4 contract): the payment axis never
+ * appears as an available transition — it moves exclusively through the
+ * money operations (pay / refund / void), which derive their own landing
+ * pairs. Every row keeps `to.payment` equal to the order's current payment
+ * state, exactly like the host's `getAvailableTransitions`.
  */
 export declare const getAvailableTransitionsMock: GetAvailableTransitions;

package/dist/actions/get-available-transitions/mock.js

@@ -1,8 +1,13 @@
 /**
  * Mock implementation: returns a fixed set of plausible transitions
  * so the demo app has data to render. Mirrors an UNPAID order under the
- * default (empty cross-axis rules) config: fulfillment can advance without
- * payment (FI-6383), plus the classic park/void moves.
+ * default (empty cross-axis rules) config.
+ *
+ * FULFILLMENT-AXIS ONLY (common 2.1.4 contract): the payment axis never
+ * appears as an available transition — it moves exclusively through the
+ * money operations (pay / refund / void), which derive their own landing
+ * pairs. Every row keeps `to.payment` equal to the order's current payment
+ * state, exactly like the host's `getAvailableTransitions`.
  */
 export const getAvailableTransitionsMock = () => Promise.resolve({
     transitions: [
@@ -22,13 +27,8 @@ export const getAvailableTransitionsMock = () => Promise.resolve({
             conditions: [{ met: true, description: 'Order is open' }],
         },
         {
-            to: { payment: 'paid', fulfillment: 'fulfilled' },
-            displayLabel: 'Complete Payment',
-            conditions: [{ met: true, description: 'Balance due > 0' }],
-        },
-        {
-            to: { payment: 'voided', fulfillment: 'cancelled' },
-            displayLabel: 'Void Order',
+            to: { payment: 'unpaid', fulfillment: 'cancelled' },
+            displayLabel: 'Cancel Order',
             conditions: [
                 { met: true, description: 'Order exists' },
                 { met: false, description: 'No payments captured (mock: skipped)' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.6.0-staging.4",
+  "version": "0.6.0",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,7 @@
     "ignoreBranchesMissingTickets": true
   },
   "dependencies": {
-    "@final-commerce/common": "2.2.0-staging.4"
+    "@final-commerce/common": "2.2.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.0.0",