@final-commerce/command-frame 0.1.63 → 0.2.0-beta.1

package/README.md

@@ -10,11 +10,11 @@ Command Frame provides a structured way to build integrations that run inside Fi
 
 The library provides three main capabilities:
 
-| Capability | Purpose | Scope |
-|-----------|---------|-------|
-| **Commands** | Call host functions from the iframe (e.g. get products, open cash drawer) | Request/response per call |
-| **Pub/Sub** | Subscribe to real-time events from the host (e.g. cart changes, payments) | Page-scoped (while iframe is mounted) |
-| **Hooks** | Register business-logic callbacks that persist across all pages | Session-scoped (survives page navigation) |
+| Capability                | Purpose                                                                                         | Scope                                          |
+| ------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| **Commands**              | Call host functions from the iframe (e.g. get products, open cash drawer)                       | Request/response per call                      |
+| **Pub/Sub**               | Subscribe to real-time events from the host (e.g. cart changes, payments)                       | Page-scoped (while iframe is mounted)          |
+| **Hooks**                 | Register business-logic callbacks that persist across all pages                                 | Session-scoped (survives page navigation)      |
 | **Host → iframe refunds** | Render asks the extension to reverse redeem / gift-card payments before completing a POS refund | Parent `postMessage` + `requestId` (see below) |
 
 Domain models (orders, cart, customers, products, and related types) are documented in **[Types reference](./src/types/README.md)**.
@@ -54,7 +54,7 @@ For building applications that run inside the Render Point of Sale interface.
 - **Features:** Order management, Product catalog, Customer management, Payments, Hardware integration (Cash drawer, Printer), Custom tables, Secrets storage.
 
 ```typescript
-import { RenderClient } from '@final-commerce/command-frame';
+import { RenderClient } from "@final-commerce/command-frame";
 
 const client = new RenderClient();
 const products = await client.getProducts();
@@ -68,7 +68,7 @@ For building applications that run inside the Final Commerce Management Dashboar
 - **Features:** Context, catalog, entities, custom tables, secrets, and optional host-specific commands (navigation, media, tax, branding, notifications) when the dashboard implements them.
 
 ```typescript
-import { ManageClient } from '@final-commerce/command-frame';
+import { ManageClient } from "@final-commerce/command-frame";
 
 const client = new ManageClient();
 const context = await client.getContext();
@@ -82,14 +82,14 @@ The pub/sub system allows iframe extensions to subscribe to topics and receive r
 - **Topics:** Cart (16), Customers (8), Orders (4), Payments (2), Products (4), Refunds (4), Print (3), Custom Tables (3), Outlet (2), Station (2), Session (2), Users (2).
 
 ```typescript
-import { topics } from '@final-commerce/command-frame';
+import { topics } from "@final-commerce/command-frame";
 
-const subscriptionId = topics.subscribe('cart', (event) => {
-    console.log('Cart event:', event.type, event.data);
+const subscriptionId = topics.subscribe("cart", event => {
+    console.log("Cart event:", event.type, event.data);
 });
 
 // Unsubscribe when done
-topics.unsubscribe('cart', subscriptionId);
+topics.unsubscribe("cart", subscriptionId);
 ```
 
 ## Hooks
@@ -101,17 +101,21 @@ Hooks are **session-scoped** event callbacks that run in the host (Render) conte
 - A stable `hookId` is required for deduplication (safe on iframe reload).
 
 ```typescript
-import { hooks } from '@final-commerce/command-frame';
-
-hooks.register('cart', async (event, hostCommands) => {
-    await hostCommands.upsertCustomTableData({
-        tableName: 'cart-events-log',
-        data: { eventType: event.type, payload: event.data, timestamp: event.timestamp },
-    });
-}, { hookId: 'my-extension:cart-log' });
+import { hooks } from "@final-commerce/command-frame";
+
+hooks.register(
+    "cart",
+    async (event, hostCommands) => {
+        await hostCommands.upsertCustomTableData({
+            tableName: "cart-events-log",
+            data: { eventType: event.type, payload: event.data, timestamp: event.timestamp }
+        });
+    },
+    { hookId: "my-extension:cart-log" }
+);
 
 // Unregister when no longer needed
-hooks.unregister('my-extension:cart-log');
+hooks.unregister("my-extension:cart-log");
 ```
 
 ## Host-initiated extension refunds (redeem / gift card)
@@ -127,18 +131,12 @@ hooks.unregister('my-extension:cart-log');
 Exported APIs: `installExtensionRefundListener`, `EXTENSION_REFUND_REQUEST_ACTION`, types **`ExtensionRefundParams`** / **`ExtensionRefundResponse`**.
 
 ```typescript
-import {
-    installExtensionRefundListener,
-    type ExtensionRefundParams,
-    type ExtensionRefundResponse
-} from '@final-commerce/command-frame';
+import { installExtensionRefundListener, type ExtensionRefundParams, type ExtensionRefundResponse } from "@final-commerce/command-frame";
 
 const unsubscribe = installExtensionRefundListener(async (params: ExtensionRefundParams): Promise<ExtensionRefundResponse> => {
     // params.paymentType === "redeem", params.amount in major currency units, params.saleId, params.processor, etc.
     const ok = await myGiftCardProvider.refund(params);
-    return ok
-        ? { success: true, extensionTransactionId: ok.providerRefundId }
-        : { success: false, error: 'Refund declined' };
+    return ok ? { success: true, extensionTransactionId: ok.providerRefundId } : { success: false, error: "Refund declined" };
 });
 
 // on teardown (optional)

package/dist/CommonTypes.d.ts

@@ -60,8 +60,7 @@ export declare enum CFUserTypes {
     CASHIER = "cashier",
     RESELLER = "reseller"
 }
-export interface CFActiveEntity {
-}
+export type CFActiveEntity = object;
 export interface CFDiscount {
     value: number;
     label?: string;
@@ -199,7 +198,7 @@ export interface CFActiveProduct extends CFActiveEntity {
 }
 export interface CFCustomer {
     _id: string;
-    companyId: any;
+    companyId: string;
     externalId?: string;
     email: string;
     firstName: string;
@@ -358,8 +357,7 @@ export interface CFRefundedLineItem {
     images?: string[];
     fee: CFFeeLineItem;
 }
-export interface CFRefundedCustomSale extends CFCustomSale {
-}
+export type CFRefundedCustomSale = CFCustomSale;
 export interface CFRefundItem {
     lineItems: CFRefundedLineItem[];
     customSales: CFRefundedCustomSale[];
@@ -382,6 +380,12 @@ export interface CFOrder {
     companyId: string;
     externalId: string | null;
     status: string;
+    /** Financial state (state machine). Undefined on legacy orders pre-backfill. */
+    paymentState?: string;
+    /** Operational state (state machine). Undefined on legacy orders pre-backfill. */
+    fulfillmentState?: string;
+    /** Computed display label from paymentState + fulfillmentState matrix. */
+    displayState?: string;
     customer: Partial<CFActiveCustomer | null>;
     customerNote?: string;
     summary: CFSummary;
@@ -435,7 +439,7 @@ export interface CFActiveUser extends CFActiveEntity {
         _id: string;
     }[];
     type?: CFUserTypes;
-    companies?: any;
+    companies?: unknown;
 }
 export interface CFActiveOutlet extends CFActiveEntity {
     address: string;
@@ -515,8 +519,8 @@ export interface CFActiveCustomSales {
     taxTableId?: string;
     quantity: number;
     price: number;
-    discount?: any;
-    fee?: any;
+    discount?: Record<string, unknown>;
+    fee?: Record<string, unknown>;
 }
 /** Non-revenue cart line (e.g. gift card load) — aligned with Render `NonRevenueItem.externalId` (order line id). */
 export interface CFNonRevenueItem {
@@ -550,7 +554,7 @@ export interface CFActiveCompany extends CFActiveEntity {
     id?: string;
     name?: string;
     logo?: string;
-    settings?: any;
+    settings?: Record<string, unknown>;
 }
 export type CFProjectName = "Render" | "Manage";
 export interface CFContextRender {
@@ -568,10 +572,10 @@ export interface CFContextRender {
     buildSourceId: string | null;
     buildIsPremium: boolean;
     isOffline: boolean;
-    user: Record<string, any> | null;
-    company: Omit<Record<string, any>, 'settings'> | null;
-    station: Record<string, any> | null;
-    outlet: Record<string, any> | null;
+    user: Record<string, unknown> | null;
+    company: Omit<Record<string, unknown>, "settings"> | null;
+    station: Record<string, unknown> | null;
+    outlet: Record<string, unknown> | null;
     timestamp: string;
 }
 export interface CFOutletInfo {
@@ -591,11 +595,11 @@ export interface CFOutletInfo {
     country?: string;
 }
 export interface CFContextManage {
-    user: any;
-    company: any;
-    menuItem?: any;
+    user: unknown;
+    company: unknown;
+    menuItem?: unknown;
     extensionId: string;
-    outlets?: any[];
+    outlets?: unknown[];
     timestamp: string;
 }
 export type CFContext = CFContextRender;

package/dist/actions/add-customer-note/mock.js

@@ -1,5 +1,5 @@
 import { MOCK_CUSTOMERS } from "../../demo/database";
-export const mockAddCustomerNote = async (params) => {
+export const mockAddCustomerNote = (params) => {
     console.log("[Mock] addCustomerNote called", params);
     if (params?.customerId && params.note) {
         const customer = MOCK_CUSTOMERS.find(c => c._id === params.customerId);
@@ -14,10 +14,10 @@ export const mockAddCustomerNote = async (params) => {
             });
         }
     }
-    return {
+    return Promise.resolve({
         success: true,
         customerId: params?.customerId || "",
         note: params?.note || "",
         timestamp: new Date().toISOString()
-    };
+    });
 };

package/dist/actions/can-transition/action.d.ts

@@ -0,0 +1,2 @@
+import type { CanTransition } from "./types";
+export declare const canTransition: CanTransition;

package/dist/actions/can-transition/action.js

@@ -0,0 +1,4 @@
+import { commandFrameClient } from "../../client";
+export const canTransition = async (params) => {
+    return await commandFrameClient.call("canTransition", params);
+};

package/dist/actions/can-transition/mock.d.ts

@@ -0,0 +1,6 @@
+import type { CanTransitionParams, CanTransitionResponse } from "./types";
+/**
+ * Mock implementation: allows all transitions except a few known-invalid ones
+ * so the demo app can show both allowed and blocked responses.
+ */
+export declare const canTransitionMock: (params: CanTransitionParams) => Promise<CanTransitionResponse>;

package/dist/actions/can-transition/mock.js

@@ -0,0 +1,28 @@
+/**
+ * Mock implementation: allows all transitions except a few known-invalid ones
+ * so the demo app can show both allowed and blocked responses.
+ */
+export const canTransitionMock = async (params) => {
+    const to = params.to;
+    if (to.payment === "refunded" && to.fulfillment === "draft") {
+        return {
+            result: {
+                allowed: false,
+                blockedBy: "financial_invariant",
+                guard: "no-refund-in-draft",
+                reason: "Cannot refund an order that is still in draft",
+            },
+        };
+    }
+    if (to.payment === "paid" && to.fulfillment === "cancelled") {
+        return {
+            result: {
+                allowed: false,
+                blockedBy: "cross_axis_rule",
+                guard: "no-pay-cancelled",
+                reason: "Cannot mark a cancelled order as paid",
+            },
+        };
+    }
+    return { result: { allowed: true } };
+};

package/dist/actions/can-transition/types.d.ts

@@ -0,0 +1,11 @@
+import type { CFStatePair, CFTransitionResult } from "../../common-types/order-state";
+export interface CanTransitionParams {
+    /** Order to evaluate. If omitted, evaluates against a new order (from = null). */
+    orderId?: string;
+    /** Target state pair to transition to. */
+    to: CFStatePair;
+}
+export interface CanTransitionResponse {
+    result: CFTransitionResult;
+}
+export type CanTransition = (params: CanTransitionParams) => Promise<CanTransitionResponse>;

package/dist/actions/can-transition/types.js

@@ -0,0 +1 @@
+export {};

package/dist/actions/cash-payment/types.d.ts

@@ -1,9 +1,12 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface CashPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
     /** Defaults to false. */
     openChangeCalculator?: boolean;
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface CashPaymentResponse {
     success: boolean;
@@ -12,5 +15,7 @@ export interface CashPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type CashPayment = (params?: CashPaymentParams) => Promise<CashPaymentResponse>;

package/dist/actions/delete-parked-order/types.d.ts

@@ -1,3 +1,4 @@
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface DeleteParkedOrderParams {
     orderId: string;
 }
@@ -5,5 +6,7 @@ export interface DeleteParkedOrderResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type DeleteParkedOrder = (params?: DeleteParkedOrderParams) => Promise<DeleteParkedOrderResponse>;

package/dist/actions/extension-payment/types.d.ts

@@ -1,4 +1,5 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 /** Params for extension-initiated payments; host routes by `paymentType`. */
 export interface ExtensionPaymentParams {
     paymentType: string;
@@ -8,6 +9,8 @@ export interface ExtensionPaymentParams {
     referenceId?: string;
     extensionId?: string;
     metadata?: Record<string, unknown>;
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface ExtensionPaymentResponse {
     success: boolean;
@@ -15,5 +18,7 @@ export interface ExtensionPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type ExtensionPayment = (params?: ExtensionPaymentParams) => Promise<ExtensionPaymentResponse>;

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

@@ -0,0 +1,2 @@
+import type { GetAvailableTransitions } from "./types";
+export declare const getAvailableTransitions: GetAvailableTransitions;

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

@@ -0,0 +1,4 @@
+import { commandFrameClient } from "../../client";
+export const getAvailableTransitions = async (params) => {
+    return await commandFrameClient.call("getAvailableTransitions", params);
+};

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

@@ -0,0 +1,6 @@
+import type { GetAvailableTransitionsParams, GetAvailableTransitionsResponse } from "./types";
+/**
+ * Mock implementation: returns a fixed set of plausible transitions
+ * so the demo app has data to render.
+ */
+export declare const getAvailableTransitionsMock: (_params: GetAvailableTransitionsParams) => Promise<GetAvailableTransitionsResponse>;

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

@@ -0,0 +1,26 @@
+/**
+ * Mock implementation: returns a fixed set of plausible transitions
+ * so the demo app has data to render.
+ */
+export const getAvailableTransitionsMock = async (_params) => ({
+    transitions: [
+        {
+            to: { payment: "refunded", fulfillment: "returned" },
+            displayLabel: "Full Refund",
+            conditions: [{ met: true, description: "Order is paid" }],
+        },
+        {
+            to: { payment: "partially_refunded", fulfillment: "partially_returned" },
+            displayLabel: "Partial Refund",
+            conditions: [{ met: true, description: "Order is paid" }],
+        },
+        {
+            to: { payment: "voided", fulfillment: "cancelled" },
+            displayLabel: "Void Order",
+            conditions: [
+                { met: true, description: "Order exists" },
+                { met: false, description: "No payments captured (mock: skipped)" },
+            ],
+        },
+    ],
+});

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

@@ -0,0 +1,9 @@
+import type { CFAvailableTransition } from "../../common-types/order-state";
+export interface GetAvailableTransitionsParams {
+    /** Order to evaluate. Required — we need the current state. */
+    orderId: string;
+}
+export interface GetAvailableTransitionsResponse {
+    transitions: CFAvailableTransition[];
+}
+export type GetAvailableTransitions = (params: GetAvailableTransitionsParams) => Promise<GetAvailableTransitionsResponse>;

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

@@ -0,0 +1 @@
+export {};

package/dist/actions/initiate-refund/types.d.ts

@@ -1,3 +1,4 @@
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface InitiateRefundParams {
     /** The ID of the order to refund. If not provided, uses the currently active order. */
     orderId?: string;
@@ -6,5 +7,7 @@ export interface InitiateRefundResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type InitiateRefund = (params?: InitiateRefundParams) => Promise<InitiateRefundResponse>;

package/dist/actions/park-order/types.d.ts

@@ -1,7 +1,10 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ParkOrderResponse {
     success: boolean;
     order: CFOrder;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type ParkOrder = () => Promise<ParkOrderResponse>;

package/dist/actions/partial-payment/types.d.ts

@@ -1,4 +1,5 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface PartialPaymentParams {
     /** The payment amount (required if openUI is false). */
     amount?: number;
@@ -6,6 +7,8 @@ export interface PartialPaymentParams {
     isPercent?: boolean;
     /** If true, opens the split payment UI. */
     openUI?: boolean;
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface PartialPaymentResponse {
     success: boolean;
@@ -14,5 +17,7 @@ export interface PartialPaymentResponse {
     openUI: boolean;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type PartialPayment = (params?: PartialPaymentParams) => Promise<PartialPaymentResponse>;

package/dist/actions/process-partial-refund/types.d.ts

@@ -1,3 +1,4 @@
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ProcessPartialRefundParams {
     /** Optional refund reason. */
     reason?: string;
@@ -15,5 +16,7 @@ export interface ProcessPartialRefundResponse {
     success: boolean;
     refundId: string;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type ProcessPartialRefund = (params?: ProcessPartialRefundParams) => Promise<ProcessPartialRefundResponse>;

package/dist/actions/remove-customer-note/mock.js

@@ -1,13 +1,13 @@
-export const mockRemoveCustomerNote = async (params) => {
+export const mockRemoveCustomerNote = (params) => {
     console.log("[Mock] removeCustomerNote called", params);
     const noteId = params?.noteId ?? "";
     const timestamp = new Date().toISOString();
     if (!noteId) {
-        return { success: false, noteId, timestamp };
+        return Promise.resolve({ success: false, noteId, timestamp });
     }
-    return {
+    return Promise.resolve({
         success: true,
         noteId,
         timestamp
-    };
+    });
 };

package/dist/actions/resume-parked-order/types.d.ts

@@ -1,4 +1,5 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ResumeParkedOrderParams {
     orderId: string;
 }
@@ -6,5 +7,7 @@ export interface ResumeParkedOrderResponse {
     success: boolean;
     order: CFOrder;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type ResumeParkedOrder = (params?: ResumeParkedOrderParams) => Promise<ResumeParkedOrderResponse>;

package/dist/actions/tap-to-pay-payment/types.d.ts

@@ -1,7 +1,10 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface TapToPayPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface TapToPayPaymentResponse {
     success: boolean;
@@ -9,5 +12,7 @@ export interface TapToPayPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type TapToPayPayment = (params?: TapToPayPaymentParams) => Promise<TapToPayPaymentResponse>;

package/dist/actions/terminal-payment/types.d.ts

@@ -1,9 +1,12 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface TerminalPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
     /** "Bluetooth" or "Cloud". Defaults to "Cloud". */
     paymentType?: 'Bluetooth' | 'Cloud';
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface TerminalPaymentResponse {
     success: boolean;
@@ -11,5 +14,7 @@ export interface TerminalPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type TerminalPayment = (params?: TerminalPaymentParams) => Promise<TerminalPaymentResponse>;

package/dist/actions/vendara-payment/types.d.ts

@@ -1,7 +1,10 @@
 import { CFOrder } from "../../CommonTypes";
+import type { CFTransitionResult } from "../../common-types/order-state";
 export interface VendaraPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
+    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface VendaraPaymentResponse {
     success: boolean;
@@ -9,5 +12,7 @@ export interface VendaraPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
+    /** Present when the state machine blocked or forced the transition. */
+    transitionResult?: CFTransitionResult;
 }
 export type VendaraPayment = (params?: VendaraPaymentParams) => Promise<VendaraPaymentResponse>;

package/dist/common-types/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./custom-tables";
 export * from "./custom-extensions";
+export * from "./order-state";

package/dist/common-types/index.js

@@ -1,2 +1,3 @@
 export * from "./custom-tables";
 export * from "./custom-extensions";
+export * from "./order-state";

package/dist/common-types/order-state.d.ts

@@ -0,0 +1,32 @@
+/**
+ * State machine protocol types for the command-frame boundary.
+ * These mirror @final-commerce/common shapes but carry no logic.
+ * command-frame must NOT depend on common.
+ */
+export interface CFStatePair {
+    payment: string;
+    fulfillment: string;
+}
+export type CFBlockedBy = "financial_invariant" | "cross_axis_rule" | "path" | "condition";
+export interface CFTransitionResult {
+    allowed: boolean;
+    blockedBy?: CFBlockedBy;
+    guard?: string;
+    reason?: string;
+    failedConditions?: CFFailedCondition[];
+}
+export interface CFFailedCondition {
+    field: string;
+    operator: string;
+    value: unknown;
+    reason?: string;
+}
+export interface CFConditionStatus {
+    met: boolean;
+    description: string;
+}
+export interface CFAvailableTransition {
+    to: CFStatePair;
+    displayLabel: string;
+    conditions: CFConditionStatus[];
+}

package/dist/common-types/order-state.js

@@ -0,0 +1,6 @@
+/**
+ * State machine protocol types for the command-frame boundary.
+ * These mirror @final-commerce/common shapes but carry no logic.
+ * command-frame must NOT depend on common.
+ */
+export {};

package/dist/common-types/state-fragment.d.ts

@@ -0,0 +1,77 @@
+/**
+ * State config fragment types for the command-frame boundary.
+ * These mirror @final-commerce/common's StateConfigFragment shapes but carry no logic.
+ * command-frame must NOT depend on common.
+ *
+ * Extensions pass a CFStateConfigFragment to Render, which merges it into the
+ * running StoredStateConfig via mergeFragment(). All contributed entries are tagged
+ * with the extension's id (_sourceExtensionId) so they can be cleaned up on unregister.
+ */
+import type { CFStatePair } from "./order-state";
+export type CFConditionOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "isEmpty" | "isNotEmpty";
+export interface CFCondition {
+    /** Dot-path into the OrderContext, e.g. "order.balance" or "computed.totalPaid". */
+    field: string;
+    operator: CFConditionOperator;
+    value: unknown;
+}
+/** All conditions in a group are AND'd together. */
+export interface CFConditionGroup {
+    conditions: CFCondition[];
+}
+/** Groups are OR'd — the first passing group satisfies the set. */
+export interface CFTransitionConditionSet {
+    id: string;
+    label: string;
+    groups: CFConditionGroup[];
+}
+export interface CFPaymentTransitionPath {
+    from: string;
+    to: string;
+    /** References a CFTransitionConditionSet.id in the same fragment. */
+    conditionSetId?: string;
+}
+export interface CFFulfillmentTransitionPath {
+    from: string;
+    to: string;
+    conditionSetId?: string;
+}
+export interface CFCrossAxisRule {
+    id: string;
+    label: string;
+    description?: string;
+    enabled: boolean;
+    /** Which axis + target state(s) activate this rule. */
+    trigger: {
+        axis: "payment" | "fulfillment";
+        to: string[];
+    };
+    /** Which axis + states must be present when the trigger fires. */
+    requires: {
+        axis: "payment" | "fulfillment";
+        states: string[];
+    };
+}
+export interface CFDisplayStateRule {
+    paymentState?: string[];
+    fulfillmentState?: string[];
+    label: string;
+    color?: string;
+    icon?: string;
+}
+/**
+ * Partial config contributed by an extension. Render merges this into the
+ * running StoredStateConfig. All arrays are appended; display rules replace
+ * on key collision.
+ *
+ * IDs (crossAxisRules, transitionConditions) must be unique across the merged
+ * config — prefix them with your extension id to avoid collisions.
+ */
+export interface CFStateConfigFragment {
+    paymentPaths?: CFPaymentTransitionPath[];
+    fulfillmentPaths?: CFFulfillmentTransitionPath[];
+    crossAxisRules?: CFCrossAxisRule[];
+    transitionConditions?: CFTransitionConditionSet[];
+    validInitialStates?: CFStatePair[];
+    displayStateMap?: CFDisplayStateRule[];
+}

package/dist/common-types/state-fragment.js

@@ -0,0 +1,10 @@
+/**
+ * State config fragment types for the command-frame boundary.
+ * These mirror @final-commerce/common's StateConfigFragment shapes but carry no logic.
+ * command-frame must NOT depend on common.
+ *
+ * Extensions pass a CFStateConfigFragment to Render, which merges it into the
+ * running StoredStateConfig via mergeFragment(). All contributed entries are tagged
+ * with the extension's id (_sourceExtensionId) so they can be cleaned up on unregister.
+ */
+export {};

package/dist/demo/database.js

@@ -335,6 +335,9 @@ export const MOCK_ORDER_1 = {
     companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
+    paymentState: "paid",
+    fulfillmentState: "fulfilled",
+    displayState: "Completed",
     customer: MOCK_CUSTOMER_1,
     summary: {
         total: 2100,
@@ -385,6 +388,9 @@ export const MOCK_ORDER_2 = {
     companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
+    paymentState: "paid",
+    fulfillmentState: "fulfilled",
+    displayState: "Completed",
     customer: MOCK_CUSTOMER_2,
     summary: {
         total: 3000,
@@ -618,6 +624,9 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
         companyId: MOCK_COMPANY.id,
         externalId: null,
         status: "completed",
+        paymentState: "paid",
+        fulfillmentState: "fulfilled",
+        displayState: "Completed",
         customer: MOCK_CART.customer ? MOCK_CART.customer : null,
         summary: {
             total: totalNum,

package/dist/fragments/index.d.ts

@@ -0,0 +1 @@
+export { preorderNoDepositFragment } from "./preorder-no-deposit";

package/dist/fragments/index.js

@@ -0,0 +1 @@
+export { preorderNoDepositFragment } from "./preorder-no-deposit";

package/dist/fragments/preorder-no-deposit.d.ts

@@ -0,0 +1,26 @@
+import type { CFStateConfigFragment } from "../common-types/state-fragment";
+/**
+ * Pre-order fragment — no deposit required.
+ *
+ * Mirrors preorder-with-deposit but removes the cross-axis rule that gates
+ * `on_hold` on payment state. An order can be placed on hold while still
+ * `unpaid` — payment is collected later (pay-at-pickup, BOPIS, COD, etc.).
+ *
+ * State flow:
+ *
+ *   unpaid|on_hold  →  (cashier collects payment)  →  paid|on_hold
+ *                                                           ↓
+ *                                              (progress fulfillment)
+ *                                                           ↓
+ *                                                    paid|in_progress
+ *
+ * Key difference from preorder-with-deposit:
+ *   - No cross-axis rule blocking `on_hold` when unpaid. The cashier can
+ *     confirm the pre-order without collecting a deposit first.
+ *   - `unpaid|on_hold` is whitelisted as a valid first-save state pair.
+ *   - `in_progress` still requires at least a partial payment (you must pay
+ *     before the merchant starts fulfilling).
+ *
+ * Prefix all IDs with your extension id before merging to avoid collisions.
+ */
+export declare const preorderNoDepositFragment: CFStateConfigFragment;

package/dist/fragments/preorder-no-deposit.js

@@ -0,0 +1,166 @@
+/**
+ * Pre-order fragment — no deposit required.
+ *
+ * Mirrors preorder-with-deposit but removes the cross-axis rule that gates
+ * `on_hold` on payment state. An order can be placed on hold while still
+ * `unpaid` — payment is collected later (pay-at-pickup, BOPIS, COD, etc.).
+ *
+ * State flow:
+ *
+ *   unpaid|on_hold  →  (cashier collects payment)  →  paid|on_hold
+ *                                                           ↓
+ *                                              (progress fulfillment)
+ *                                                           ↓
+ *                                                    paid|in_progress
+ *
+ * Key difference from preorder-with-deposit:
+ *   - No cross-axis rule blocking `on_hold` when unpaid. The cashier can
+ *     confirm the pre-order without collecting a deposit first.
+ *   - `unpaid|on_hold` is whitelisted as a valid first-save state pair.
+ *   - `in_progress` still requires at least a partial payment (you must pay
+ *     before the merchant starts fulfilling).
+ *
+ * Prefix all IDs with your extension id before merging to avoid collisions.
+ */
+export const preorderNoDepositFragment = {
+    paymentPaths: [
+        {
+            from: "unpaid",
+            to: "partially_paid",
+            conditionSetId: "require-payment-recorded"
+        },
+        {
+            from: "unpaid",
+            to: "paid",
+            conditionSetId: "require-full-payment"
+        },
+        {
+            from: "partially_paid",
+            to: "paid",
+            conditionSetId: "require-full-payment"
+        }
+    ],
+    fulfillmentPaths: [
+        {
+            from: "draft",
+            to: "on_hold",
+            conditionSetId: "preorder-no-deposit-require-items"
+        },
+        {
+            from: "on_hold",
+            to: "cancelled",
+            conditionSetId: "preorder-no-deposit-cancel-before-progress"
+        }
+    ],
+    transitionConditions: [
+        {
+            id: "preorder-no-deposit-require-items",
+            label: "Require at least one item to place pre-order",
+            groups: [
+                {
+                    conditions: [
+                        {
+                            field: "computed.itemCount",
+                            operator: "gte",
+                            value: 1
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            id: "preorder-no-deposit-cancel-before-progress",
+            label: "Can only cancel pre-order before fulfillment begins",
+            groups: [
+                {
+                    conditions: [
+                        {
+                            field: "computed.fulfilledItemCount",
+                            operator: "eq",
+                            value: 0
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            id: "require-payment-recorded",
+            label: "Require at least one payment before marking partially paid",
+            groups: [
+                {
+                    conditions: [
+                        {
+                            field: "computed.totalPaid",
+                            operator: "gt",
+                            value: 0
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            id: "require-full-payment",
+            label: "Require full payment before marking as paid",
+            groups: [
+                {
+                    conditions: [
+                        {
+                            field: "computed.totalPaid",
+                            operator: "gte",
+                            value: 1
+                        },
+                        {
+                            field: "computed.balance",
+                            operator: "lte",
+                            value: 0
+                        }
+                    ]
+                }
+            ]
+        }
+    ],
+    crossAxisRules: [
+        {
+            id: "preorder-no-deposit-require-payment-before-confirm",
+            label: "Require payment before starting fulfillment",
+            description: "Fulfillment cannot move to in_progress unless at least a partial payment has been made",
+            enabled: true,
+            trigger: {
+                axis: "fulfillment",
+                to: ["in_progress"]
+            },
+            requires: {
+                axis: "payment",
+                states: ["partially_paid", "paid"]
+            }
+        }
+    ],
+    validInitialStates: [
+        { payment: "unpaid", fulfillment: "on_hold" },
+        { payment: "partially_paid", fulfillment: "on_hold" },
+        { payment: "paid", fulfillment: "on_hold" }
+    ],
+    displayStateMap: [
+        {
+            paymentState: ["unpaid"],
+            fulfillmentState: ["on_hold"],
+            label: "Pre-Order",
+            color: "#6366f1",
+            icon: "clock"
+        },
+        {
+            paymentState: ["partially_paid"],
+            fulfillmentState: ["on_hold"],
+            label: "Pre-Order (Deposit Received)",
+            color: "#f59e0b",
+            icon: "clock"
+        },
+        {
+            paymentState: ["paid"],
+            fulfillmentState: ["on_hold"],
+            label: "Pre-Order (Fully Paid)",
+            color: "#22c55e",
+            icon: "check-circle"
+        }
+    ]
+};

package/dist/index.d.ts

@@ -104,6 +104,8 @@ export declare const command: {
     readonly uploadMedia: import("./actions/upload-media/types").UploadMedia;
     readonly getTaxTables: import("./actions/get-tax-tables/types").GetTaxTables;
     readonly getBranding: import("./actions/get-branding/types").GetBranding;
+    readonly canTransition: import("./actions/can-transition/types").CanTransition;
+    readonly getAvailableTransitions: import("./actions/get-available-transitions/types").GetAvailableTransitions;
 };
 export type { ExampleFunction, ExampleFunctionParams, ExampleFunctionResponse } from "./actions/example-function/types";
 export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } from "./actions/generate-api-key/types";
@@ -227,7 +229,7 @@ export { stationTopic } from "./pubsub/topics/station";
 export { sessionTopic } from "./pubsub/topics/session";
 export { usersTopic } from "./pubsub/topics/users";
 export type { CustomerCreatedPayload, CustomerUpdatedPayload, CustomerNoteAddedPayload, CustomerNoteDeletedPayload, CustomerAssignedPayload, CustomerUnassignedPayload, CustomerActiveSetPayload, CustomerActiveGetPayload, CustomerCreatedEvent, CustomerUpdatedEvent, CustomerNoteAddedEvent, CustomerNoteDeletedEvent, CustomerAssignedEvent, CustomerUnassignedEvent, CustomerActiveSetEvent, CustomerActiveGetEvent, CustomersEventType, CustomersEventPayload } from "./pubsub/topics/customers/types";
-export type { OrderCreatedPayload, OrderUpdatedPayload, OrderActiveSetPayload, OrderActiveGetPayload, OrderCreatedEvent, OrderUpdatedEvent, OrderActiveSetEvent, OrderActiveGetEvent, OrdersEventType, OrdersEventPayload } from "./pubsub/topics/orders/types";
+export type { OrderCreatedPayload, OrderUpdatedPayload, OrderActiveSetPayload, OrderActiveGetPayload, OrderCreatedEvent, OrderUpdatedEvent, OrderActiveSetEvent, OrderActiveGetEvent, OrderStateTransitionCompletedPayload, OrderStateTransitionBlockedPayload, OrderStateTransitionCompletedEvent, OrderStateTransitionBlockedEvent, OrdersEventType, OrdersEventPayload } from "./pubsub/topics/orders/types";
 export type { RefundCreatedPayload, RefundUpdatedPayload, RefundActiveSetPayload, RefundActiveGetPayload, RefundCreatedEvent, RefundUpdatedEvent, RefundActiveSetEvent, RefundActiveGetEvent, RefundsEventType, RefundsEventPayload } from "./pubsub/topics/refunds/types";
 export type { ProductCreatedPayload, ProductUpdatedPayload, ProductSetActivePayload, ProductGetActivePayload, ProductCreatedEvent, ProductUpdatedEvent, ProductSetActiveEvent, ProductGetActiveEvent, ProductsEventType, ProductsEventPayload } from "./pubsub/topics/products/types";
 export type { OutletActiveSetPayload, OutletActiveGetPayload, OutletActiveSetEvent, OutletActiveGetEvent, OutletEventType, OutletEventPayload } from "./pubsub/topics/outlet/types";
@@ -253,3 +255,8 @@ export type { GetSecretVal, GetSecretValParams, GetSecretValResponse } from "./a
 export type { SetSecretVal, SetSecretValParams, SetSecretValResponse } from "./actions/set-secret-val/types";
 export type { GetUsers, GetUsersParams, GetUsersResponse } from "./actions/get-users/types";
 export type { GetRoles, GetRolesParams, GetRolesResponse } from "./actions/get-roles/types";
+export type { CFBlockedBy, CFStatePair, CFTransitionResult, CFFailedCondition, CFConditionStatus, CFAvailableTransition } from "./common-types/order-state";
+export type { CFConditionOperator, CFCondition, CFConditionGroup, CFTransitionConditionSet, CFPaymentTransitionPath, CFFulfillmentTransitionPath, CFCrossAxisRule, CFDisplayStateRule, CFStateConfigFragment } from "./common-types/state-fragment";
+export type { CanTransition, CanTransitionParams, CanTransitionResponse } from "./actions/can-transition/types";
+export type { GetAvailableTransitions, GetAvailableTransitionsParams, GetAvailableTransitionsResponse } from "./actions/get-available-transitions/types";
+export { preorderNoDepositFragment } from "./fragments";

package/dist/index.js

@@ -102,6 +102,9 @@ import { getSecretsKeys } from "./actions/get-secrets-keys/action";
 import { getSecretVal } from "./actions/get-secret-val/action";
 import { setSecretVal } from "./actions/set-secret-val/action";
 import { generateAPIKey } from "./actions/generate-api-key/action";
+// State Machine Query Actions
+import { canTransition } from "./actions/can-transition/action";
+import { getAvailableTransitions } from "./actions/get-available-transitions/action";
 // Product CRUD Actions
 import { addProduct } from "./actions/add-product/action";
 import { editProduct } from "./actions/edit-product/action";
@@ -238,6 +241,9 @@ export const command = {
     uploadMedia,
     getTaxTables,
     getBranding,
+    // State Machine Queries
+    canTransition,
+    getAvailableTransitions
 };
 export { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/constants";
 export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
@@ -272,3 +278,5 @@ export { sessionTopic } from "./pubsub/topics/session";
 export { usersTopic } from "./pubsub/topics/users";
 // Export Custom Tables Types
 export { AttributeType } from "./common-types/attribute-type";
+// State Machine Fragments
+export { preorderNoDepositFragment } from "./fragments";

package/dist/projects/render/mocks.js

@@ -85,6 +85,8 @@ import { mockSetActiveSession } from "../../actions/set-active-session/mock";
 import { mockGetActiveUser } from "../../actions/get-active-user/mock";
 import { mockSetActiveUser } from "../../actions/set-active-user/mock";
 import { mockSetActiveRefund } from "../../actions/set-active-refund/mock";
+import { canTransitionMock } from "../../actions/can-transition/mock";
+import { getAvailableTransitionsMock } from "../../actions/get-available-transitions/mock";
 export const RENDER_MOCKS = {
     addCartDiscount: mockAddCartDiscount,
     addCartFee: mockAddCartFee,
@@ -178,5 +180,7 @@ export const RENDER_MOCKS = {
     removeCartFee: mockRemoveCartFee,
     removeOrderNote: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
     removeCustomSale: params => Promise.resolve({ success: true, id: params.id, timestamp: new Date().toISOString() }),
-    removeNonRevenueItem: params => Promise.resolve({ success: true, externalId: params.externalId, timestamp: new Date().toISOString() })
+    removeNonRevenueItem: params => Promise.resolve({ success: true, externalId: params.externalId, timestamp: new Date().toISOString() }),
+    canTransition: canTransitionMock,
+    getAvailableTransitions: getAvailableTransitionsMock
 };

package/dist/projects/render/types.d.ts

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem } from "../../index";
+import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions } from "../../index";
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -93,4 +93,6 @@ export interface RenderProviderActions {
     removeOrderNote: RemoveOrderNote;
     removeCustomSale: RemoveCustomSale;
     removeNonRevenueItem: RemoveNonRevenueItem;
+    canTransition: CanTransition;
+    getAvailableTransitions: GetAvailableTransitions;
 }

package/dist/pubsub/topics/orders/index.js

@@ -26,6 +26,16 @@ export const ordersTopic = {
             id: "get-active-order",
             name: "Get Active Order",
             description: "Published when the active order is retrieved for listeners"
+        },
+        {
+            id: "state-transition-completed",
+            name: "State Transition Completed",
+            description: "Published when an order state transition completes successfully"
+        },
+        {
+            id: "state-transition-blocked",
+            name: "State Transition Blocked",
+            description: "Published when an order state transition is blocked by the state machine"
         }
     ]
 };

package/dist/pubsub/topics/orders/state-transition-blocked/types.d.ts

@@ -0,0 +1,16 @@
+import type { TopicEvent } from "../../../types";
+import type { CFBlockedBy } from "../../../../common-types/order-state";
+export interface OrderStateTransitionBlockedPayload {
+    orderId: string;
+    from: {
+        payment: string;
+        fulfillment: string;
+    };
+    to: {
+        payment: string;
+        fulfillment: string;
+    };
+    blockedBy: CFBlockedBy;
+    reason?: string;
+}
+export type OrderStateTransitionBlockedEvent = TopicEvent<OrderStateTransitionBlockedPayload>;

package/dist/pubsub/topics/orders/state-transition-blocked/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/orders/state-transition-completed/types.d.ts

@@ -0,0 +1,15 @@
+import type { TopicEvent } from "../../../types";
+export interface OrderStateTransitionCompletedPayload {
+    orderId: string;
+    from: {
+        payment: string;
+        fulfillment: string;
+    };
+    to: {
+        payment: string;
+        fulfillment: string;
+    };
+    displayState: string;
+    forced?: boolean;
+}
+export type OrderStateTransitionCompletedEvent = TopicEvent<OrderStateTransitionCompletedPayload>;

package/dist/pubsub/topics/orders/state-transition-completed/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/orders/types.d.ts

@@ -6,9 +6,13 @@ export * from "./order-created/types";
 export * from "./order-updated/types";
 export * from "./set-active-order/types";
 export * from "./get-active-order/types";
+export * from "./state-transition-completed/types";
+export * from "./state-transition-blocked/types";
 import type { OrderCreatedPayload } from "./order-created/types";
 import type { OrderUpdatedPayload } from "./order-updated/types";
 import type { OrderActiveSetPayload } from "./set-active-order/types";
 import type { OrderActiveGetPayload } from "./get-active-order/types";
-export type OrdersEventPayload = OrderCreatedPayload | OrderUpdatedPayload | OrderActiveSetPayload | OrderActiveGetPayload;
-export type OrdersEventType = "order-created" | "order-updated" | "set-active-order" | "get-active-order";
+import type { OrderStateTransitionCompletedPayload } from "./state-transition-completed/types";
+import type { OrderStateTransitionBlockedPayload } from "./state-transition-blocked/types";
+export type OrdersEventPayload = OrderCreatedPayload | OrderUpdatedPayload | OrderActiveSetPayload | OrderActiveGetPayload | OrderStateTransitionCompletedPayload | OrderStateTransitionBlockedPayload;
+export type OrdersEventType = "order-created" | "order-updated" | "set-active-order" | "get-active-order" | "state-transition-completed" | "state-transition-blocked";

package/dist/pubsub/topics/orders/types.js

@@ -7,3 +7,5 @@ export * from "./order-created/types";
 export * from "./order-updated/types";
 export * from "./set-active-order/types";
 export * from "./get-active-order/types";
+export * from "./state-transition-completed/types";
+export * from "./state-transition-blocked/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.1.63",
+  "version": "0.2.0-beta.1",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",