@final-commerce/command-frame 0.3.0-beta.3 → 0.3.0-beta.6

package/dist/index.d.ts

@@ -56,11 +56,8 @@ export declare const command: {
     readonly getActiveCustomer: import(".").GetActiveCustomer;
     readonly setActiveCustomer: import(".").SetActiveCustomer;
     readonly getActiveOutlet: import(".").GetActiveOutlet;
-    readonly setActiveOutlet: import(".").SetActiveOutlet;
     readonly getActiveStation: import(".").GetActiveStation;
-    readonly setActiveStation: import(".").SetActiveStation;
     readonly getActiveSession: import(".").GetActiveSession;
-    readonly setActiveSession: import(".").SetActiveSession;
     readonly getActiveUser: import(".").GetActiveUser;
     readonly setActiveUser: import(".").SetActiveUser;
     readonly setActiveRefund: import(".").SetActiveRefund;
@@ -71,10 +68,6 @@ export declare const command: {
     readonly removeOrderNote: import(".").RemoveOrderNote;
     readonly removeCustomSale: import(".").RemoveCustomSale;
     readonly removeNonRevenueItem: import(".").RemoveNonRevenueItem;
-    readonly getSmartGridLayout: import(".").GetSmartGridLayout;
-    readonly saveSmartGridLayout: import(".").SaveSmartGridLayout;
-    readonly openExtensionOverlay: import(".").OpenExtensionOverlay;
-    readonly resolveExtensionOverlay: import(".").ResolveExtensionOverlay;
     readonly initiateRefund: import(".").InitiateRefund;
     readonly setRefundStockAction: import(".").SetRefundStockAction;
     readonly selectAllRefundItems: import(".").SelectAllRefundItems;
@@ -88,6 +81,8 @@ export declare const command: {
     readonly deleteProduct: import(".").DeleteProduct;
     readonly getOutlets: import(".").GetOutlets;
     readonly getStations: import(".").GetStations;
+    readonly getSmartGridLayout: import(".").GetSmartGridLayout;
+    readonly saveSmartGridLayout: import(".").SaveSmartGridLayout;
     readonly getCustomTables: import(".").GetCustomTables;
     readonly getCustomTableFields: import(".").GetCustomTableFields;
     readonly getCustomTableData: import(".").GetCustomTableData;
@@ -107,6 +102,9 @@ export declare const command: {
     readonly uploadMedia: import(".").UploadMedia;
     readonly getTaxTables: import(".").GetTaxTables;
     readonly getBranding: import(".").GetBranding;
+    readonly canTransition: import(".").CanTransition;
+    readonly getAvailableTransitions: import(".").GetAvailableTransitions;
+    readonly applyTransition: import(".").ApplyTransition;
 };
 export type { ExampleFunction, ExampleFunctionParams, ExampleFunctionResponse } from "./actions/example-function/types";
 export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } from "./actions/generate-api-key/types";
@@ -124,6 +122,8 @@ export type { EditProductVariants, EditProductVariantsParams, EditProductVariant
 export type { DeleteProduct, DeleteProductParams, DeleteProductResponse } from "./actions/delete-product/types";
 export type { GetOutlets, GetOutletsResponse } from "./actions/get-outlets/types";
 export type { GetStations, GetStationsParams, GetStationsResponse } from "./actions/get-stations/types";
+export type { GetSmartGridLayout, GetSmartGridLayoutParams, GetSmartGridLayoutResponse } from "./actions/get-smart-grid-layout/types";
+export type { SaveSmartGridLayout, SaveSmartGridLayoutParams, SaveSmartGridLayoutResponse } from "./actions/save-smart-grid-layout/types";
 export type { GetOrders, GetOrdersParams, GetOrdersResponse } from "./actions/get-orders/types";
 export type { GetRefunds, GetRefundsParams, GetRefundsResponse } from "./actions/get-refunds/types";
 export type { SetRefundStockAction, SetRefundStockActionParams, SetRefundStockActionResponse } from "./actions/set-refund-stock-action/types";
@@ -133,6 +133,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";
@@ -160,10 +162,7 @@ export type { TerminalPayment, TerminalPaymentParams, TerminalPaymentResponse }
 export type { VendaraPayment, VendaraPaymentParams, VendaraPaymentResponse } from "./actions/vendara-payment/types";
 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 } 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 { IntegrationPayment, IntegrationPaymentParams, IntegrationPaymentResponse, IntegrationEmvData } from "./actions/integration-payment/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";
@@ -187,11 +186,8 @@ export type { GetActiveOrder, GetActiveOrderResponse } from "./actions/get-activ
 export type { GetActiveCustomer, GetActiveCustomerResponse } from "./actions/get-active-customer/types";
 export type { SetActiveCustomer, SetActiveCustomerParams, SetActiveCustomerResponse } from "./actions/set-active-customer/types";
 export type { GetActiveOutlet, GetActiveOutletResponse } from "./actions/get-active-outlet/types";
-export type { SetActiveOutlet, SetActiveOutletParams, SetActiveOutletResponse } from "./actions/set-active-outlet/types";
 export type { GetActiveStation, GetActiveStationResponse } from "./actions/get-active-station/types";
-export type { SetActiveStation, SetActiveStationParams, SetActiveStationResponse } from "./actions/set-active-station/types";
 export type { GetActiveSession, GetActiveSessionResponse } from "./actions/get-active-session/types";
-export type { SetActiveSession, SetActiveSessionParams, SetActiveSessionResponse } from "./actions/set-active-session/types";
 export type { GetActiveUser, GetActiveUserResponse } from "./actions/get-active-user/types";
 export type { SetActiveUser, SetActiveUserParams, SetActiveUserResponse } from "./actions/set-active-user/types";
 export type { SetActiveRefund, SetActiveRefundParams, SetActiveRefundResponse } from "./actions/set-active-refund/types";
@@ -202,11 +198,6 @@ export type { RemoveCartFee, RemoveCartFeeParams, RemoveCartFeeResponse } from "
 export type { RemoveOrderNote, RemoveOrderNoteResponse } from "./actions/remove-order-note/types";
 export type { RemoveCustomSale, RemoveCustomSaleParams, RemoveCustomSaleResponse } from "./actions/remove-custom-sale/types";
 export type { RemoveNonRevenueItem, RemoveNonRevenueItemParams, RemoveNonRevenueItemResponse } from "./actions/remove-non-revenue-item/types";
-export type { GetSmartGridLayout, GetSmartGridLayoutParams, GetSmartGridLayoutResponse } from "./actions/get-smart-grid-layout/types";
-export type { SaveSmartGridLayout, SaveSmartGridLayoutParams, SaveSmartGridLayoutResponse } from "./actions/save-smart-grid-layout/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 { InterceptorPoint, InterceptorReturn, InterceptorFunction, InterceptorHostCommands, InterceptorRegisterOptions, InterceptorOverlayContext } from "./interceptors/types";
 export * from "./CommonTypes";
 export { setMockDatabase, setMockActiveProduct } from "./demo/database";
 export type { MockDatabaseConfig } from "./demo/database";
@@ -221,12 +212,15 @@ 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";
 export { productsTopic } from "./pubsub/topics/products";
 export { cartTopic } from "./pubsub/topics/cart";
 export { paymentsTopic } from "./pubsub/topics/payments";
+export { splitPaymentsTopic } from "./pubsub/topics/split-payments";
 export { customTablesTopic } from "./pubsub/topics/custom-tables";
 export { printTopic } from "./pubsub/topics/print";
 export { outletTopic } from "./pubsub/topics/outlet";
@@ -238,7 +232,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";
@@ -251,6 +245,7 @@ export type { CategoryCreatedPayload, CategoryCreatedEvent, CategoryUpdatedPaylo
 export type { AttributeCreatedPayload, AttributeCreatedEvent, AttributeUpdatedPayload, AttributeUpdatedEvent, AttributesEventType, AttributesEventPayload } from "./pubsub/topics/attributes/types";
 export type { CartCreatedPayload, CartCustomerAssignedPayload, ProductAddedPayload, ProductDeletedPayload, CartDiscountAddedPayload, CartDiscountRemovedPayload, CartFeeAddedPayload, CartFeeRemovedPayload, ProductDiscountAddedPayload, ProductDiscountRemovedPayload, ProductFeeAddedPayload, ProductFeeRemovedPayload, ProductNoteAddedPayload, ProductNoteRemovedPayload, CartCreatedEvent, CartCustomerAssignedEvent, ProductAddedEvent, ProductDeletedEvent, CartDiscountAddedEvent, CartDiscountRemovedEvent, CartFeeAddedEvent, CartFeeRemovedEvent, ProductDiscountAddedEvent, ProductDiscountRemovedEvent, ProductFeeAddedEvent, ProductFeeRemovedEvent, ProductNoteAddedEvent, ProductNoteRemovedEvent, CartEventType, CartEventPayload } from "./pubsub/topics/cart/types";
 export type { PaymentDonePayload, PaymentErrPayload, PaymentDoneEvent, PaymentErrEvent, PaymentsEventType, PaymentsEventPayload } from "./pubsub/topics/payments/types";
+export type { SplitPaymentUpdatedPayload, SplitPaymentUpdatedEvent, SplitPaymentsEventType, SplitPaymentsEventPayload } from "./pubsub/topics/split-payments/types";
 export type { RowCreatedPayload, RowUpdatedPayload, RowDeletedPayload, RowCreatedEvent, RowUpdatedEvent, RowDeletedEvent, CustomTablesEventType, CustomTablesEventPayload } from "./pubsub/topics/custom-tables/types";
 export type { PrintStartedPayload, PrintCompletedPayload, PrintErrorPayload, PrintStartedEvent, PrintCompletedEvent, PrintErrorEvent, PrintEventType, PrintEventPayload } from "./pubsub/topics/print/types";
 export { AttributeType } from "./common-types/attribute-type";
@@ -268,3 +263,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

@@ -58,11 +58,8 @@ import { getActiveOrder } from "./actions/get-active-order/action";
 import { getActiveCustomer } from "./actions/get-active-customer/action";
 import { setActiveCustomer } from "./actions/set-active-customer/action";
 import { getActiveOutlet } from "./actions/get-active-outlet/action";
-import { setActiveOutlet } from "./actions/set-active-outlet/action";
 import { getActiveStation } from "./actions/get-active-station/action";
-import { setActiveStation } from "./actions/set-active-station/action";
 import { getActiveSession } from "./actions/get-active-session/action";
-import { setActiveSession } from "./actions/set-active-session/action";
 import { getActiveUser } from "./actions/get-active-user/action";
 import { setActiveUser } from "./actions/set-active-user/action";
 import { setActiveRefund } from "./actions/set-active-refund/action";
@@ -74,12 +71,7 @@ import { removeCartFee } from "./actions/remove-cart-fee/action";
 import { removeOrderNote } from "./actions/remove-order-note/action";
 import { removeCustomSale } from "./actions/remove-custom-sale/action";
 import { removeNonRevenueItem } from "./actions/remove-non-revenue-item/action";
-// SmartGrid Actions
-import { getSmartGridLayout } from "./actions/get-smart-grid-layout/action";
-import { saveSmartGridLayout } from "./actions/save-smart-grid-layout/action";
-// Extension Overlay / Interceptor Actions
-import { openExtensionOverlay } from "./actions/open-extension-overlay/action";
-import { resolveExtensionOverlay } from "./actions/resolve-extension-overlay/action";
+// Integration Actions
 // Refund Actions
 import { getRefunds } from "./actions/get-refunds/action";
 import { initiateRefund } from "./actions/initiate-refund/action";
@@ -106,6 +98,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";
@@ -114,6 +110,9 @@ import { deleteProduct } from "./actions/delete-product/action";
 // Entity Actions
 import { getOutlets } from "./actions/get-outlets/action";
 import { getStations } from "./actions/get-stations/action";
+// SmartGrid Actions
+import { getSmartGridLayout } from "./actions/get-smart-grid-layout/action";
+import { saveSmartGridLayout } from "./actions/save-smart-grid-layout/action";
 // Manage extension actions (optional hosts: Deerlake, etc.)
 import { navigateTo } from "./actions/navigate-to/action";
 import { refreshResource } from "./actions/refresh-resource/action";
@@ -184,11 +183,8 @@ export const command = {
     getActiveCustomer,
     setActiveCustomer,
     getActiveOutlet,
-    setActiveOutlet,
     getActiveStation,
-    setActiveStation,
     getActiveSession,
-    setActiveSession,
     getActiveUser,
     setActiveUser,
     setActiveRefund,
@@ -200,12 +196,7 @@ export const command = {
     removeOrderNote,
     removeCustomSale,
     removeNonRevenueItem,
-    // SmartGrid Actions
-    getSmartGridLayout,
-    saveSmartGridLayout,
-    // Extension Overlay / Interceptor Actions
-    openExtensionOverlay,
-    resolveExtensionOverlay,
+    // Integration Actions
     // Refund Actions
     initiateRefund,
     setRefundStockAction,
@@ -222,6 +213,9 @@ export const command = {
     // Entity Actions
     getOutlets,
     getStations,
+    // SmartGrid Actions
+    getSmartGridLayout,
+    saveSmartGridLayout,
     // Custom Tables Actions
     getCustomTables,
     getCustomTableFields,
@@ -245,10 +239,13 @@ 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";
+// Integration Actions
 // Export Common Types
 export * from "./CommonTypes";
 // Mock database override (standalone / extension dev)
@@ -265,6 +262,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";
@@ -272,6 +271,7 @@ export { refundsTopic } from "./pubsub/topics/refunds";
 export { productsTopic } from "./pubsub/topics/products";
 export { cartTopic } from "./pubsub/topics/cart";
 export { paymentsTopic } from "./pubsub/topics/payments";
+export { splitPaymentsTopic } from "./pubsub/topics/split-payments";
 export { customTablesTopic } from "./pubsub/topics/custom-tables";
 export { printTopic } from "./pubsub/topics/print";
 export { outletTopic } from "./pubsub/topics/outlet";
@@ -284,3 +284,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

@@ -5,23 +5,15 @@
  */
 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, unknown> = Record<string, unknown>> = boolean | T;
-/** Params accepted by the host-injected `openExtensionOverlay` command. */
-export interface OpenExtensionOverlayCommandParams {
-    point: InterceptorPoint;
-    payload?: unknown;
-}
-/**
- * Host commands injected into an interceptor callback. `openExtensionOverlay` is the one
- * always-present command; additional host commands are dispatched through the same shape.
- * Heterogeneous command payloads are sent via the separate `callCommand` arg of
- * `InterceptorFunction`, so the indexed entries here share the overlay command's param type.
- */
+export type InterceptorReturn<T extends Record<string, any> = Record<string, any>> = boolean | T;
 export interface InterceptorHostCommands {
-    openExtensionOverlay: (params: OpenExtensionOverlayCommandParams) => Promise<InterceptorReturn>;
-    [command: string]: (params: OpenExtensionOverlayCommandParams) => Promise<InterceptorReturn>;
+    openExtensionOverlay: (params: {
+        point: InterceptorPoint;
+        payload?: any;
+    }) => Promise<InterceptorReturn>;
+    [command: string]: (params?: any) => Promise<any>;
 }
-export type InterceptorFunction = (payload: unknown, cmds: InterceptorHostCommands, callCommand: (action: string, params?: unknown) => Promise<unknown>) => InterceptorReturn | Promise<InterceptorReturn>;
+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;
@@ -30,5 +22,5 @@ export interface InterceptorRegisterOptions {
 }
 export interface InterceptorOverlayContext {
     point: InterceptorPoint;
-    payload: unknown;
+    payload: any;
 }

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";
@@ -55,10 +61,6 @@ import { mockVendaraPayment } from "../../actions/vendara-payment/mock";
 import { mockExtensionPayment } from "../../actions/extension-payment/mock";
 import { mockRedeemPayment } from "../../actions/redeem-payment/mock";
 import { mockIntegrationPayment } from "../../actions/integration-payment/mock";
-import { mockGetSmartGridLayout } from "../../actions/get-smart-grid-layout/mock";
-import { mockSaveSmartGridLayout } from "../../actions/save-smart-grid-layout/mock";
-import { mockOpenExtensionOverlay } from "../../actions/open-extension-overlay/mock";
-import { mockResolveExtensionOverlay } from "../../actions/resolve-extension-overlay/mock";
 import { mockAddNonRevenueItem } from "../../actions/add-non-revenue-item/mock";
 import { mockGetFinalContext } from "../../actions/get-final-context/mock";
 import { mockPrint } from "../../actions/print/mock";
@@ -80,14 +82,15 @@ import { mockGetActiveOrder } from "../../actions/get-active-order/mock";
 import { mockGetActiveCustomer } from "../../actions/get-active-customer/mock";
 import { mockSetActiveCustomer } from "../../actions/set-active-customer/mock";
 import { mockGetActiveOutlet } from "../../actions/get-active-outlet/mock";
-import { mockSetActiveOutlet } from "../../actions/set-active-outlet/mock";
 import { mockGetActiveStation } from "../../actions/get-active-station/mock";
-import { mockSetActiveStation } from "../../actions/set-active-station/mock";
 import { mockGetActiveSession } from "../../actions/get-active-session/mock";
-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 = {
     addCartDiscount: mockAddCartDiscount,
     addCartFee: mockAddCartFee,
@@ -126,6 +129,8 @@ export const RENDER_MOCKS = {
     getRemainingRefundableQuantities: mockGetRemainingRefundableQuantities,
     goToStationHome: mockGoToStationHome,
     initiateRefund: mockInitiateRefund,
+    openExtensionOverlay: mockOpenExtensionOverlay,
+    resolveExtensionOverlay: mockResolveExtensionOverlay,
     openCashDrawer: mockOpenCashDrawer,
     parkOrder: mockParkOrder,
     partialPayment: mockPartialPayment,
@@ -166,23 +171,20 @@ export const RENDER_MOCKS = {
     getActiveCustomer: mockGetActiveCustomer,
     setActiveCustomer: mockSetActiveCustomer,
     getActiveOutlet: mockGetActiveOutlet,
-    setActiveOutlet: mockSetActiveOutlet,
     getActiveStation: mockGetActiveStation,
-    setActiveStation: mockSetActiveStation,
     getActiveSession: mockGetActiveSession,
-    setActiveSession: mockSetActiveSession,
     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,
-    openExtensionOverlay: mockOpenExtensionOverlay,
-    resolveExtensionOverlay: mockResolveExtensionOverlay
+    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, 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, OpenExtensionOverlay, ResolveExtensionOverlay } 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, 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, GetActiveStation, GetActiveSession, 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;
@@ -77,11 +81,8 @@ export interface RenderProviderActions {
     getActiveCustomer: GetActiveCustomer;
     setActiveCustomer: SetActiveCustomer;
     getActiveOutlet: GetActiveOutlet;
-    setActiveOutlet: SetActiveOutlet;
     getActiveStation: GetActiveStation;
-    setActiveStation: SetActiveStation;
     getActiveSession: GetActiveSession;
-    setActiveSession: SetActiveSession;
     getActiveUser: GetActiveUser;
     setActiveUser: SetActiveUser;
     setActiveRefund: SetActiveRefund;
@@ -92,8 +93,8 @@ export interface RenderProviderActions {
     removeOrderNote: RemoveOrderNote;
     removeCustomSale: RemoveCustomSale;
     removeNonRevenueItem: RemoveNonRevenueItem;
+    canTransition: CanTransition;
+    getAvailableTransitions: GetAvailableTransitions;
     getSmartGridLayout: GetSmartGridLayout;
     saveSmartGridLayout: SaveSmartGridLayout;
-    openExtensionOverlay: OpenExtensionOverlay;
-    resolveExtensionOverlay: ResolveExtensionOverlay;
 }

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/dist/pubsub/topics/split-payments/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Split Payments Topic Definition
+ * Defines the split-payments topic and its available event types.
+ *
+ * This topic mirrors render's `activeEntities.splitPayment` Redux slice. The
+ * host (render) publishes the full current `CFSplitPayment` (or `null` when
+ * reset) on every mutation and on the command-frame handshake so consumers
+ * stay in sync without owning the underlying state.
+ */
+import type { TopicDefinition } from "../../types";
+export declare const splitPaymentsTopic: TopicDefinition;
+export * from "./types";