@final-commerce/command-frame 0.1.72 → 0.1.74

package/README.md

@@ -10,11 +10,12 @@ 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)      |
+| **Interceptors**          | Gate POS flows (approve / modify / block) at named points                                       | Blocking; host waits for your response         |
 | **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 +55,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 +69,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 +83,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 +102,44 @@ 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");
+```
+
+## Interceptors
+
+Interceptors let an extension **gate a POS flow** (approve / modify / block) at a named point — the host waits for your interceptor and acts on what it returns. Unlike hooks, interceptors are **blocking**.
+
+- **[Interceptors Documentation](./src/interceptors/README.md)**
+- The callback is serialized and reconstructed on the host; it must be **self-contained** (no closures, no imports).
+- A stable `interceptorId` is required for deduplication (safe on iframe reload).
+
+```typescript
+import { interceptors } from '@final-commerce/command-frame';
+
+interceptors.register(
+    'refund_start',
+    async (payload, cmds) => {
+        if (payload.paymentTypes.includes('redeem')) {
+            return cmds.openExtensionOverlay({ point: 'refund_start', payload });
+        }
+        return true; // nothing for us to do
+    },
+    { interceptorId: 'my-extension:refund-guard' }
+);
 ```
 
 ## Host-initiated extension refunds (redeem / gift card)
@@ -127,18 +155,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

@@ -27,6 +27,107 @@ export declare enum CurrencyCode {
     ILS = "ILS",
     TRY = "TRY",
     RUB = "RUB",
+    HTG = "HTG",
+    BND = "BND",
+    CRC = "CRC",
+    BDT = "BDT",
+    UAH = "UAH",
+    NGN = "NGN",
+    AFN = "AFN",
+    ALL = "ALL",
+    AMD = "AMD",
+    ANG = "ANG",
+    AOA = "AOA",
+    ARS = "ARS",
+    AWG = "AWG",
+    AZN = "AZN",
+    BAM = "BAM",
+    BBD = "BBD",
+    BGN = "BGN",
+    BMD = "BMD",
+    BOB = "BOB",
+    BSD = "BSD",
+    BTN = "BTN",
+    BWP = "BWP",
+    BYN = "BYN",
+    BZD = "BZD",
+    COP = "COP",
+    CZK = "CZK",
+    DOP = "DOP",
+    DZD = "DZD",
+    EGP = "EGP",
+    ETB = "ETB",
+    FJD = "FJD",
+    GEL = "GEL",
+    GHS = "GHS",
+    GTQ = "GTQ",
+    GYD = "GYD",
+    HNL = "HNL",
+    IRR = "IRR",
+    JMD = "JMD",
+    KES = "KES",
+    KGS = "KGS",
+    KHR = "KHR",
+    KYD = "KYD",
+    KZT = "KZT",
+    LAK = "LAK",
+    LBP = "LBP",
+    LKR = "LKR",
+    MAD = "MAD",
+    MDL = "MDL",
+    MKD = "MKD",
+    MMK = "MMK",
+    MNT = "MNT",
+    MOP = "MOP",
+    MUR = "MUR",
+    MVR = "MVR",
+    MZN = "MZN",
+    NAD = "NAD",
+    NIO = "NIO",
+    NPR = "NPR",
+    PAB = "PAB",
+    PEN = "PEN",
+    PGK = "PGK",
+    PKR = "PKR",
+    QAR = "QAR",
+    RON = "RON",
+    RSD = "RSD",
+    SBD = "SBD",
+    SRD = "SRD",
+    SYP = "SYP",
+    TJS = "TJS",
+    TMT = "TMT",
+    TOP = "TOP",
+    TTD = "TTD",
+    TZS = "TZS",
+    UYU = "UYU",
+    UZS = "UZS",
+    VES = "VES",
+    WST = "WST",
+    XCD = "XCD",
+    YER = "YER",
+    ZMW = "ZMW",
+    CDF = "CDF",
+    CUP = "CUP",
+    ERN = "ERN",
+    FKP = "FKP",
+    GIP = "GIP",
+    GMD = "GMD",
+    KPW = "KPW",
+    LRD = "LRD",
+    LSL = "LSL",
+    MGA = "MGA",
+    MWK = "MWK",
+    SCR = "SCR",
+    SDG = "SDG",
+    SHP = "SHP",
+    SLE = "SLE",
+    SOS = "SOS",
+    SSP = "SSP",
+    STN = "STN",
+    SZL = "SZL",
+    VED = "VED",
+    XCG = "XCG",
     JPY = "JPY",
     KRW = "KRW",
     VND = "VND",
@@ -34,6 +135,17 @@ export declare enum CurrencyCode {
     ISK = "ISK",
     HUF = "HUF",
     TWD = "TWD",
+    GNF = "GNF",
+    BIF = "BIF",
+    DJF = "DJF",
+    KMF = "KMF",
+    PYG = "PYG",
+    RWF = "RWF",
+    UGX = "UGX",
+    VUV = "VUV",
+    XAF = "XAF",
+    XOF = "XOF",
+    XPF = "XPF",
     KWD = "KWD",
     BHD = "BHD",
     OMR = "OMR",
@@ -255,7 +367,7 @@ export interface CFActiveProduct extends CFActiveEntity {
 }
 export interface CFCustomer {
     _id: string;
-    companyId: any;
+    companyId: string;
     externalId?: string;
     email: string;
     firstName: string;
@@ -440,8 +552,7 @@ export interface CFRefundedLineItem {
     images?: string[];
     fee: CFFeeLineItem;
 }
-export interface CFRefundedCustomSale extends CFCustomSale {
-}
+export type CFRefundedCustomSale = CFCustomSale;
 export interface CFRefundItem {
     lineItems: CFRefundedLineItem[];
     customSales: CFRefundedCustomSale[];
@@ -464,6 +575,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;
@@ -521,7 +638,7 @@ export interface CFActiveUser extends CFActiveEntity {
         _id: string;
     }[];
     type?: CFUserTypes;
-    companies?: any;
+    companies?: unknown;
 }
 export interface CFActiveOutlet extends CFActiveEntity {
     address: string;
@@ -607,8 +724,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 {
@@ -660,7 +777,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 {
@@ -715,3 +832,22 @@ export interface CFContextManage {
     timestamp: string;
 }
 export type CFContext = CFContextRender;
+export type CFTileType = "empty" | "product" | "action" | "category" | "folder" | "back";
+export interface CFTileCell {
+    index: number;
+    type: CFTileType;
+    entityId?: string;
+    entityData?: Record<string, unknown>;
+}
+export interface CFSmartGridLayout {
+    gridId: string;
+    cells: CFTileCell[];
+    /** Operator-editable display name for this grid. When absent, consumers
+     *  should fall back to a placeholder (e.g. "Smart Grid"). */
+    name?: string;
+    /** Cells inside operator-created folders, keyed by the folder tile's
+     *  entityId. Each folder owns its own dense cell array (indices 0..N-1)
+     *  and may contain further folder tiles for arbitrary nesting. Absent or
+     *  empty when no folders exist. */
+    folders?: Record<string, CFTileCell[]>;
+}

package/dist/CommonTypes.js

@@ -28,6 +28,107 @@ export var CurrencyCode;
     CurrencyCode["ILS"] = "ILS";
     CurrencyCode["TRY"] = "TRY";
     CurrencyCode["RUB"] = "RUB";
+    CurrencyCode["HTG"] = "HTG";
+    CurrencyCode["BND"] = "BND";
+    CurrencyCode["CRC"] = "CRC";
+    CurrencyCode["BDT"] = "BDT";
+    CurrencyCode["UAH"] = "UAH";
+    CurrencyCode["NGN"] = "NGN";
+    CurrencyCode["AFN"] = "AFN";
+    CurrencyCode["ALL"] = "ALL";
+    CurrencyCode["AMD"] = "AMD";
+    CurrencyCode["ANG"] = "ANG";
+    CurrencyCode["AOA"] = "AOA";
+    CurrencyCode["ARS"] = "ARS";
+    CurrencyCode["AWG"] = "AWG";
+    CurrencyCode["AZN"] = "AZN";
+    CurrencyCode["BAM"] = "BAM";
+    CurrencyCode["BBD"] = "BBD";
+    CurrencyCode["BGN"] = "BGN";
+    CurrencyCode["BMD"] = "BMD";
+    CurrencyCode["BOB"] = "BOB";
+    CurrencyCode["BSD"] = "BSD";
+    CurrencyCode["BTN"] = "BTN";
+    CurrencyCode["BWP"] = "BWP";
+    CurrencyCode["BYN"] = "BYN";
+    CurrencyCode["BZD"] = "BZD";
+    CurrencyCode["COP"] = "COP";
+    CurrencyCode["CZK"] = "CZK";
+    CurrencyCode["DOP"] = "DOP";
+    CurrencyCode["DZD"] = "DZD";
+    CurrencyCode["EGP"] = "EGP";
+    CurrencyCode["ETB"] = "ETB";
+    CurrencyCode["FJD"] = "FJD";
+    CurrencyCode["GEL"] = "GEL";
+    CurrencyCode["GHS"] = "GHS";
+    CurrencyCode["GTQ"] = "GTQ";
+    CurrencyCode["GYD"] = "GYD";
+    CurrencyCode["HNL"] = "HNL";
+    CurrencyCode["IRR"] = "IRR";
+    CurrencyCode["JMD"] = "JMD";
+    CurrencyCode["KES"] = "KES";
+    CurrencyCode["KGS"] = "KGS";
+    CurrencyCode["KHR"] = "KHR";
+    CurrencyCode["KYD"] = "KYD";
+    CurrencyCode["KZT"] = "KZT";
+    CurrencyCode["LAK"] = "LAK";
+    CurrencyCode["LBP"] = "LBP";
+    CurrencyCode["LKR"] = "LKR";
+    CurrencyCode["MAD"] = "MAD";
+    CurrencyCode["MDL"] = "MDL";
+    CurrencyCode["MKD"] = "MKD";
+    CurrencyCode["MMK"] = "MMK";
+    CurrencyCode["MNT"] = "MNT";
+    CurrencyCode["MOP"] = "MOP";
+    CurrencyCode["MUR"] = "MUR";
+    CurrencyCode["MVR"] = "MVR";
+    CurrencyCode["MZN"] = "MZN";
+    CurrencyCode["NAD"] = "NAD";
+    CurrencyCode["NIO"] = "NIO";
+    CurrencyCode["NPR"] = "NPR";
+    CurrencyCode["PAB"] = "PAB";
+    CurrencyCode["PEN"] = "PEN";
+    CurrencyCode["PGK"] = "PGK";
+    CurrencyCode["PKR"] = "PKR";
+    CurrencyCode["QAR"] = "QAR";
+    CurrencyCode["RON"] = "RON";
+    CurrencyCode["RSD"] = "RSD";
+    CurrencyCode["SBD"] = "SBD";
+    CurrencyCode["SRD"] = "SRD";
+    CurrencyCode["SYP"] = "SYP";
+    CurrencyCode["TJS"] = "TJS";
+    CurrencyCode["TMT"] = "TMT";
+    CurrencyCode["TOP"] = "TOP";
+    CurrencyCode["TTD"] = "TTD";
+    CurrencyCode["TZS"] = "TZS";
+    CurrencyCode["UYU"] = "UYU";
+    CurrencyCode["UZS"] = "UZS";
+    CurrencyCode["VES"] = "VES";
+    CurrencyCode["WST"] = "WST";
+    CurrencyCode["XCD"] = "XCD";
+    CurrencyCode["YER"] = "YER";
+    CurrencyCode["ZMW"] = "ZMW";
+    CurrencyCode["CDF"] = "CDF";
+    CurrencyCode["CUP"] = "CUP";
+    CurrencyCode["ERN"] = "ERN";
+    CurrencyCode["FKP"] = "FKP";
+    CurrencyCode["GIP"] = "GIP";
+    CurrencyCode["GMD"] = "GMD";
+    CurrencyCode["KPW"] = "KPW";
+    CurrencyCode["LRD"] = "LRD";
+    CurrencyCode["LSL"] = "LSL";
+    CurrencyCode["MGA"] = "MGA";
+    CurrencyCode["MWK"] = "MWK";
+    CurrencyCode["SCR"] = "SCR";
+    CurrencyCode["SDG"] = "SDG";
+    CurrencyCode["SHP"] = "SHP";
+    CurrencyCode["SLE"] = "SLE";
+    CurrencyCode["SOS"] = "SOS";
+    CurrencyCode["SSP"] = "SSP";
+    CurrencyCode["STN"] = "STN";
+    CurrencyCode["SZL"] = "SZL";
+    CurrencyCode["VED"] = "VED";
+    CurrencyCode["XCG"] = "XCG";
     CurrencyCode["JPY"] = "JPY";
     CurrencyCode["KRW"] = "KRW";
     CurrencyCode["VND"] = "VND";
@@ -35,6 +136,17 @@ export var CurrencyCode;
     CurrencyCode["ISK"] = "ISK";
     CurrencyCode["HUF"] = "HUF";
     CurrencyCode["TWD"] = "TWD";
+    CurrencyCode["GNF"] = "GNF";
+    CurrencyCode["BIF"] = "BIF";
+    CurrencyCode["DJF"] = "DJF";
+    CurrencyCode["KMF"] = "KMF";
+    CurrencyCode["PYG"] = "PYG";
+    CurrencyCode["RWF"] = "RWF";
+    CurrencyCode["UGX"] = "UGX";
+    CurrencyCode["VUV"] = "VUV";
+    CurrencyCode["XAF"] = "XAF";
+    CurrencyCode["XOF"] = "XOF";
+    CurrencyCode["XPF"] = "XPF";
     CurrencyCode["KWD"] = "KWD";
     CurrencyCode["BHD"] = "BHD";
     CurrencyCode["OMR"] = "OMR";

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

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

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

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

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Mock implementation: applies all transitions except a few known-invalid ones
+ * so the demo app can show both successful and blocked responses.
+ */
+export const applyTransitionMock = (params) => {
+    const { to } = params;
+    if (to.payment === "refunded" && to.fulfillment === "draft") {
+        return Promise.resolve({
+            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 Promise.resolve({
+            result: {
+                allowed: false,
+                blockedBy: "cross_axis_rule",
+                guard: "no-pay-cancelled",
+                reason: "Cannot mark a cancelled order as paid"
+            }
+        });
+    }
+    return Promise.resolve({
+        result: { allowed: true },
+        from: { payment: "unpaid", fulfillment: "draft" },
+        to,
+        displayState: `${to.payment} / ${to.fulfillment}`
+    });
+};

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

@@ -0,0 +1,17 @@
+import type { CFStatePair, CFTransitionResult } from "../../common-types/order-state";
+export interface ApplyTransitionParams {
+    /** Order to transition. */
+    orderId: string;
+    /** Target state pair. */
+    to: CFStatePair;
+}
+export interface ApplyTransitionResponse {
+    result: CFTransitionResult;
+    /** Previous state — present only when the transition was applied. */
+    from?: CFStatePair;
+    /** New state — present only when the transition was applied. */
+    to?: CFStatePair;
+    /** Computed display label — present only when the transition was applied. */
+    displayState?: string;
+}
+export type ApplyTransition = (params: ApplyTransitionParams) => Promise<ApplyTransitionResponse>;

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

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

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;
     /** EMV data when the underlying payment carries one (typed as `IntegrationEmvData` by the integration wrapper). */
     emvData?: unknown;
     /** Processor fee in minor units; recorded on the order's paymentMethod.processorFee. */
@@ -19,5 +22,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);
+};