@final-commerce/command-frame 0.1.73 → 0.1.75

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

@@ -107,6 +107,9 @@ 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;
+    readonly applyTransition: import("./actions/apply-transition/types").ApplyTransition;
 };
 export type { ExampleFunction, ExampleFunctionParams, ExampleFunctionResponse } from "./actions/example-function/types";
 export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } from "./actions/generate-api-key/types";
@@ -135,6 +138,8 @@ export type { CalculateRefundTotal, CalculateRefundTotalParams, CalculateRefundT
 export type { GetRemainingRefundableQuantities, GetRemainingRefundableQuantitiesParams, GetRemainingRefundableQuantitiesResponse } from "./actions/get-remaining-refundable-quantities/types";
 export type { ProcessPartialRefund, ProcessPartialRefundParams, ProcessPartialRefundResponse } from "./actions/process-partial-refund/types";
 export type { InitiateRefund, InitiateRefundParams, InitiateRefundResponse } from "./actions/initiate-refund/types";
+export type { OpenExtensionOverlay, OpenExtensionOverlayParams, OpenExtensionOverlayResponse } from "./actions/open-extension-overlay/types";
+export type { ResolveExtensionOverlay, ResolveExtensionOverlayParams, ResolveExtensionOverlayResponse } from "./actions/resolve-extension-overlay/types";
 export type { GetCurrentCart, GetCurrentCartResponse } from "./actions/get-current-cart/types";
 export type { AddProductDiscount, AddProductDiscountParams, AddProductDiscountResponse } from "./actions/add-product-discount/types";
 export type { AddProductToCart, AddProductToCartParams, AddProductToCartResponse } from "./actions/add-product-to-cart/types";
@@ -163,9 +168,6 @@ export type { VendaraPayment, VendaraPaymentParams, VendaraPaymentResponse } fro
 export type { ExtensionPayment, ExtensionPaymentParams, ExtensionPaymentResponse } from "./actions/extension-payment/types";
 export type { RedeemPayment, RedeemPaymentParams, RedeemPaymentResponse } from "./actions/redeem-payment/types";
 export type { IntegrationPayment, IntegrationPaymentParams, IntegrationPaymentResponse, IntegrationEmvData } from "./actions/integration-payment/types";
-export { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/constants";
-export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
-export type { ExtensionRefundParams, ExtensionRefundResponse } from "./actions/extension-refund/types";
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse } from "./actions/add-customer-note/types";
 export type { RemoveCustomerNote, RemoveCustomerNoteParams, RemoveCustomerNoteResponse } from "./actions/remove-customer-note/types";
 export type { RemoveCustomerFromCart, RemoveCustomerFromCartResponse } from "./actions/remove-customer-from-cart/types";
@@ -220,6 +222,8 @@ export type { TopicDefinition, TopicEvent, TopicEventType, TopicSubscriptionCall
 export type { TopicEventPayloadMap } from "./pubsub/topics/types";
 export { hooks } from "./hooks";
 export type { HookFunction, HookRegisterOptions } from "./hooks";
+export { interceptors } from "./interceptors";
+export type { InterceptorFunction, InterceptorPoint, InterceptorRegisterOptions, InterceptorReturn, InterceptorOverlayContext, InterceptorHostCommands } from "./interceptors";
 export { customersTopic } from "./pubsub/topics/customers";
 export { ordersTopic } from "./pubsub/topics/orders";
 export { refundsTopic } from "./pubsub/topics/refunds";
@@ -238,7 +242,7 @@ export { transactionsTopic } from "./pubsub/topics/transactions";
 export { categoriesTopic } from "./pubsub/topics/categories";
 export { attributesTopic } from "./pubsub/topics/attributes";
 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";
@@ -269,3 +273,9 @@ 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 type { ApplyTransition, ApplyTransitionParams, ApplyTransitionResponse } from "./actions/apply-transition/types";
+export { preorderNoDepositFragment } from "./fragments";

package/dist/index.js

@@ -103,6 +103,10 @@ 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";
+import { applyTransition } from "./actions/apply-transition/action";
 // Product CRUD Actions
 import { addProduct } from "./actions/add-product/action";
 import { editProduct } from "./actions/edit-product/action";
@@ -245,10 +249,12 @@ export const command = {
     getMedia,
     uploadMedia,
     getTaxTables,
-    getBranding
+    getBranding,
+    // State Machine Queries
+    canTransition,
+    getAvailableTransitions,
+    applyTransition
 };
-export { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/constants";
-export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
 // Export Common Types
 export * from "./CommonTypes";
 // Mock database override (standalone / extension dev)
@@ -265,6 +271,8 @@ export { commandFrameClient, CommandFrameClient } from "./client";
 export { topics } from "./pubsub/topics";
 // Export Hooks (extension iframe API for session-scoped event callbacks)
 export { hooks } from "./hooks";
+// Export Interceptors (extension iframe API for gating host flows)
+export { interceptors } from "./interceptors";
 // Export Pub/Sub Topics
 export { customersTopic } from "./pubsub/topics/customers";
 export { ordersTopic } from "./pubsub/topics/orders";
@@ -285,3 +293,5 @@ export { categoriesTopic } from "./pubsub/topics/categories";
 export { attributesTopic } from "./pubsub/topics/attributes";
 // Export Custom Tables Types
 export { AttributeType } from "./common-types/attribute-type";
+// State Machine Fragments
+export { preorderNoDepositFragment } from "./fragments";

package/dist/interceptors/index.d.ts

@@ -0,0 +1,21 @@
+import type { InterceptorFunction, InterceptorPoint, InterceptorRegisterOptions, InterceptorOverlayContext } from "./types";
+/** Register a session-scoped interceptor for a named point. Callback is serialized to the host. */
+declare function register(point: InterceptorPoint, callback: InterceptorFunction, options: InterceptorRegisterOptions): string;
+declare function unregister(interceptorId: string): void;
+/** Register a handler invoked when this iframe is opened as an overlay by the host. */
+declare function onOverlay(handler: (ctx: InterceptorOverlayContext) => void): void;
+/** Continue the gated flow, merging `data` into the flow payload. */
+declare function resolve(data: Record<string, any>): Promise<void>;
+/** Continue the gated flow with no data. */
+declare function proceed(): Promise<void>;
+/** Stop the gated flow. */
+declare function cancel(): Promise<void>;
+export declare const interceptors: {
+    register: typeof register;
+    unregister: typeof unregister;
+    onOverlay: typeof onOverlay;
+    resolve: typeof resolve;
+    proceed: typeof proceed;
+    cancel: typeof cancel;
+};
+export type { InterceptorFunction, InterceptorPoint, InterceptorRegisterOptions, InterceptorReturn, InterceptorOverlayContext, InterceptorHostCommands } from "./types";

package/dist/interceptors/index.js

@@ -0,0 +1,53 @@
+import { commandFrameClient } from "../client";
+const DEFAULT_ORIGIN = "*";
+function getOrigin() {
+    return typeof window !== "undefined" ? window.__COMMAND_FRAME_ORIGIN__ ?? DEFAULT_ORIGIN : DEFAULT_ORIGIN;
+}
+let overlayId = null;
+let overlayContext = null;
+let overlayHandler = null;
+if (typeof window !== "undefined") {
+    window.addEventListener("message", (event) => {
+        const data = event.data;
+        if (data && data.type === "interceptor-overlay-init" && typeof data.overlayId === "string") {
+            overlayId = data.overlayId;
+            overlayContext = { point: data.point, payload: data.payload };
+            if (overlayHandler)
+                overlayHandler(overlayContext);
+        }
+    });
+}
+/** Register a session-scoped interceptor for a named point. Callback is serialized to the host. */
+function register(point, callback, options) {
+    const interceptorId = options.interceptorId;
+    const functionBody = callback.toString();
+    if (typeof window !== "undefined" && window.top && window.top !== window) {
+        window.top.postMessage({ type: "interceptor-register", point, functionBody, interceptorId, timeoutMs: options.timeoutMs }, getOrigin());
+    }
+    return interceptorId;
+}
+function unregister(interceptorId) {
+    if (typeof window !== "undefined" && window.top && window.top !== window) {
+        window.top.postMessage({ type: "interceptor-unregister", interceptorId }, getOrigin());
+    }
+}
+/** Register a handler invoked when this iframe is opened as an overlay by the host. */
+function onOverlay(handler) {
+    overlayHandler = handler;
+    if (overlayContext)
+        handler(overlayContext);
+}
+async function report(result) {
+    if (!overlayId) {
+        console.warn("[interceptors] report called outside an overlay context — ignored");
+        return;
+    }
+    await commandFrameClient.call("resolveExtensionOverlay", { overlayId, result });
+}
+/** Continue the gated flow, merging `data` into the flow payload. */
+function resolve(data) { return report(data); }
+/** Continue the gated flow with no data. */
+function proceed() { return report(true); }
+/** Stop the gated flow. */
+function cancel() { return report(false); }
+export const interceptors = { register, unregister, onOverlay, resolve, proceed, cancel };

package/dist/interceptors/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interceptors let an installed extension gate a host flow at a named point.
+ * Registration mirrors hooks: the callback is serialized and reconstructed on the host,
+ * so it must be self-contained (use only its payload arg and the injected host commands).
+ */
+export type InterceptorPoint = "refund_start";
+/** false = stop the flow; true = continue, no data; object = continue and merge into the flow payload. */
+export type InterceptorReturn<T extends Record<string, any> = Record<string, any>> = boolean | T;
+export interface InterceptorHostCommands {
+    openExtensionOverlay: (params: {
+        point: InterceptorPoint;
+        payload?: any;
+    }) => Promise<InterceptorReturn>;
+    [command: string]: (params?: any) => Promise<any>;
+}
+export type InterceptorFunction = (payload: any, cmds: InterceptorHostCommands, callCommand: (action: string, params?: any) => Promise<any>) => InterceptorReturn | Promise<InterceptorReturn>;
+export interface InterceptorRegisterOptions {
+    /** Stable id; re-registering with the same id replaces the previous one. */
+    interceptorId: string;
+    /** Per-interceptor timeout override (ms). */
+    timeoutMs?: number;
+}
+export interface InterceptorOverlayContext {
+    point: InterceptorPoint;
+    payload: any;
+}

package/dist/interceptors/types.js

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

package/dist/projects/render/mocks.js

@@ -2,13 +2,17 @@ import { mockAddCartDiscount } from "../../actions/add-cart-discount/mock";
 import { mockAddCartFee } from "../../actions/add-cart-fee/mock";
 import { mockRemoveCartFee } from "../../actions/remove-cart-fee/mock";
 import { mockAddCustomSale } from "../../actions/add-custom-sale/mock";
+import { mockRemoveCustomSale } from "../../actions/remove-custom-sale/mock";
 import { mockAddCustomer } from "../../actions/add-customer/mock";
 import { mockAddCustomerNote } from "../../actions/add-customer-note/mock";
 import { mockRemoveCustomerNote } from "../../actions/remove-customer-note/mock";
 import { mockEditCustomer } from "../../actions/edit-customer/mock";
 import { mockAddOrderNote } from "../../actions/add-order-note/mock";
+import { mockRemoveOrderNote } from "../../actions/remove-order-note/mock";
 import { mockAddProductDiscount } from "../../actions/add-product-discount/mock";
 import { mockAddProductFee } from "../../actions/add-product-fee/mock";
+import { mockRemoveProductDiscount } from "../../actions/remove-product-discount/mock";
+import { mockRemoveProductFee } from "../../actions/remove-product-fee/mock";
 import { mockSetActiveProductFee } from "../../actions/set-active-product-fee/mock";
 import { mockSetActiveProductDiscount } from "../../actions/set-active-product-discount/mock";
 import { mockGetActiveProduct } from "../../actions/get-active-product/mock";
@@ -37,6 +41,8 @@ import { mockGetTaxTables } from "../../actions/get-tax-tables/mock";
 import { mockGetRemainingRefundableQuantities } from "../../actions/get-remaining-refundable-quantities/mock";
 import { mockGoToStationHome } from "../../actions/go-to-station-home/mock";
 import { mockInitiateRefund } from "../../actions/initiate-refund/mock";
+import { mockOpenExtensionOverlay } from "../../actions/open-extension-overlay/mock";
+import { mockResolveExtensionOverlay } from "../../actions/resolve-extension-overlay/mock";
 import { mockOpenCashDrawer } from "../../actions/open-cash-drawer/mock";
 import { mockParkOrder } from "../../actions/park-order/mock";
 import { mockPartialPayment } from "../../actions/partial-payment/mock";
@@ -86,6 +92,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";
 import { mockGetSmartGridLayout } from "../../actions/get-smart-grid-layout/mock";
 import { mockSaveSmartGridLayout } from "../../actions/save-smart-grid-layout/mock";
 export const RENDER_MOCKS = {
@@ -126,6 +134,8 @@ export const RENDER_MOCKS = {
     getRemainingRefundableQuantities: mockGetRemainingRefundableQuantities,
     goToStationHome: mockGoToStationHome,
     initiateRefund: mockInitiateRefund,
+    openExtensionOverlay: mockOpenExtensionOverlay,
+    resolveExtensionOverlay: mockResolveExtensionOverlay,
     openCashDrawer: mockOpenCashDrawer,
     parkOrder: mockParkOrder,
     partialPayment: mockPartialPayment,
@@ -176,13 +186,15 @@ export const RENDER_MOCKS = {
     getActiveUser: mockGetActiveUser,
     setActiveUser: mockSetActiveUser,
     setActiveRefund: mockSetActiveRefund,
-    removeProductDiscount: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
-    removeProductFee: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
+    removeProductDiscount: mockRemoveProductDiscount,
+    removeProductFee: mockRemoveProductFee,
     removeProductNote: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
     removeCartFee: mockRemoveCartFee,
-    removeOrderNote: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
-    removeCustomSale: params => Promise.resolve({ success: true, id: params.id, timestamp: new Date().toISOString() }),
+    removeOrderNote: mockRemoveOrderNote,
+    removeCustomSale: mockRemoveCustomSale,
     removeNonRevenueItem: params => Promise.resolve({ success: true, externalId: params.externalId, timestamp: new Date().toISOString() }),
+    canTransition: canTransitionMock,
+    getAvailableTransitions: getAvailableTransitionsMock,
     getSmartGridLayout: mockGetSmartGridLayout,
     saveSmartGridLayout: mockSaveSmartGridLayout
 };

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

@@ -1,4 +1,6 @@
-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, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout } 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, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout } from "../../index";
+import type { OpenExtensionOverlay } from "../../actions/open-extension-overlay/types";
+import type { ResolveExtensionOverlay } from "../../actions/resolve-extension-overlay/types";
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -32,6 +34,8 @@ export interface RenderProviderActions {
     resumeParkedOrder: ResumeParkedOrder;
     deleteParkedOrder: DeleteParkedOrder;
     initiateRefund: InitiateRefund;
+    openExtensionOverlay: OpenExtensionOverlay;
+    resolveExtensionOverlay: ResolveExtensionOverlay;
     cashPayment: CashPayment;
     tapToPayPayment: TapToPayPayment;
     terminalPayment: TerminalPayment;
@@ -94,6 +98,8 @@ export interface RenderProviderActions {
     removeOrderNote: RemoveOrderNote;
     removeCustomSale: RemoveCustomSale;
     removeNonRevenueItem: RemoveNonRevenueItem;
+    canTransition: CanTransition;
+    getAvailableTransitions: GetAvailableTransitions;
     getSmartGridLayout: GetSmartGridLayout;
     saveSmartGridLayout: SaveSmartGridLayout;
 }

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.73",
+  "version": "0.1.75",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/actions/extension-refund/constants.d.ts

@@ -1,2 +0,0 @@
-/** postMessage `action` for host → iframe extension refund requests. */
-export declare const EXTENSION_REFUND_REQUEST_ACTION = "extensionRefundRequest";

package/dist/actions/extension-refund/constants.js

@@ -1,2 +0,0 @@
-/** postMessage `action` for host → iframe extension refund requests. */
-export const EXTENSION_REFUND_REQUEST_ACTION = "extensionRefundRequest";

package/dist/actions/extension-refund/extension-refund-listener.d.ts

@@ -1,11 +0,0 @@
-import type { ExtensionRefundParams, ExtensionRefundResponse } from "./types";
-/**
- * Install a message listener in the **extension iframe** so the host can request refunds.
- * Validates `event.source === window.top` before handling.
- *
- * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the host.
- *
- * @param handler - Perform the extension-side refund (API call, etc.)
- * @returns Unsubscribe function
- */
-export declare function installExtensionRefundListener(handler: (params: ExtensionRefundParams) => Promise<ExtensionRefundResponse>): () => void;

package/dist/actions/extension-refund/extension-refund-listener.js

@@ -1,60 +0,0 @@
-import { EXTENSION_REFUND_REQUEST_ACTION } from "./constants";
-function isRecord(value) {
-    return typeof value === "object" && value !== null;
-}
-/**
- * Install a message listener in the **extension iframe** so the host can request refunds.
- * Validates `event.source === window.top` before handling.
- *
- * Replies with {@link PostMessageResponse}, using `event.origin` as the target origin when posting back to the host.
- *
- * @param handler - Perform the extension-side refund (API call, etc.)
- * @returns Unsubscribe function
- */
-export function installExtensionRefundListener(handler) {
-    const onMessage = async (event) => {
-        const raw = event.data;
-        if (!isRecord(raw) || raw.action !== EXTENSION_REFUND_REQUEST_ACTION) {
-            return;
-        }
-        const requestId = raw.requestId;
-        if (typeof requestId !== "string") {
-            return;
-        }
-        if (event.source !== window.top || !event.source) {
-            return;
-        }
-        const source = event.source;
-        const replyOrigin = typeof event.origin === "string" ? event.origin : "*";
-        const params = raw.params;
-        try {
-            if (!params || typeof params.paymentType !== "string" || typeof params.amount !== "number" || typeof params.saleId !== "string") {
-                const errPayload = {
-                    requestId,
-                    success: false,
-                    error: "Invalid extension refund params"
-                };
-                source.postMessage(errPayload, replyOrigin);
-                return;
-            }
-            const result = await handler(params);
-            const payload = {
-                requestId,
-                success: true,
-                data: result
-            };
-            source.postMessage(payload, replyOrigin);
-        }
-        catch (e) {
-            const message = e instanceof Error ? e.message : String(e);
-            const errPayload = {
-                requestId,
-                success: false,
-                error: message
-            };
-            source.postMessage(errPayload, replyOrigin);
-        }
-    };
-    window.addEventListener("message", onMessage);
-    return () => window.removeEventListener("message", onMessage);
-}