@final-commerce/command-frame 0.1.73 → 0.1.75

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

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

package/dist/actions/terminal-payment/mock.js

@@ -1,15 +1,14 @@
-import { createOrderFromCart, MOCK_CART } from "../../demo/database";
+import { applyMockPayment, MOCK_CART } from "../../demo/database";
 export const mockTerminalPayment = async (params) => {
     console.log("[Mock] terminalPayment called", params);
     const connectionType = params?.paymentType || "Cloud";
     // Simulate terminal interaction
     window.alert(`Demo: Processing ${connectionType} Terminal Payment...\n(Please tap, insert, or swipe card on terminal)`);
-    const amount = params?.amount || MOCK_CART.total;
-    // Mocking terminal payment success immediately
-    const order = createOrderFromCart("card", amount, "stripe_terminal");
+    const due = params?.amount ?? MOCK_CART.amountToBeCharged ?? MOCK_CART.total;
+    const order = applyMockPayment(due, "card", "stripe_terminal");
     return {
         success: true,
-        amount: amount,
+        amount: due,
         paymentType: "terminal",
         order,
         timestamp: new Date().toISOString()

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

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

package/dist/actions/update-cart-item-quantity/mock.js

@@ -1,11 +1,11 @@
 import { MOCK_CART, mockPublishEvent } from "../../demo/database";
-export const mockUpdateCartItemQuantity = async (params) => {
+export const mockUpdateCartItemQuantity = (params) => {
     console.log("[Mock] updateCartItemQuantity called", params);
     if (!params?.internalId) {
-        throw new Error('internalId is required');
+        throw new Error("internalId is required");
     }
     if (params.quantity === undefined || params.quantity === null) {
-        throw new Error('quantity is required');
+        throw new Error("quantity is required");
     }
     const { internalId, quantity } = params;
     // Find the product in the cart
@@ -25,16 +25,16 @@ export const mockUpdateCartItemQuantity = async (params) => {
         MOCK_CART.amountToBeCharged = MOCK_CART.total;
         MOCK_CART.remainingBalance = MOCK_CART.total;
         // Publish product-deleted event
-        mockPublishEvent('cart', 'product-deleted', {
+        mockPublishEvent("cart", "product-deleted", {
             product: product,
             internalId: internalId
         });
-        return {
+        return Promise.resolve({
             success: true,
             internalId: internalId,
             quantity: 0,
             timestamp: new Date().toISOString()
-        };
+        });
     }
     // Update quantity
     const quantityDelta = quantity - previousQuantity;
@@ -46,15 +46,15 @@ export const mockUpdateCartItemQuantity = async (params) => {
     MOCK_CART.amountToBeCharged = MOCK_CART.total;
     MOCK_CART.remainingBalance = MOCK_CART.total;
     // Publish product-updated event
-    mockPublishEvent('cart', 'product-updated', {
+    mockPublishEvent("cart", "product-updated", {
         product: product,
         previousQuantity: previousQuantity,
         newQuantity: quantity
     });
-    return {
+    return Promise.resolve({
         success: true,
         internalId: internalId,
         quantity: quantity,
         timestamp: new Date().toISOString()
-    };
+    });
 };

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

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

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

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

package/dist/common-types/index.js

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

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

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

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

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

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

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

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

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

package/dist/demo/database.d.ts

@@ -50,6 +50,9 @@ export declare const MOCK_PRODUCT_HABANERO: CFProduct;
 export declare const MOCK_PRODUCT_BLACK_GARLIC: CFProduct;
 export declare const MOCK_ORDER_1: CFActiveOrder;
 export declare const MOCK_ORDER_2: CFActiveOrder;
+export declare const MOCK_ORDER_3: CFActiveOrder;
+export declare const MOCK_PARKED_ORDER_1: CFActiveOrder;
+export declare const MOCK_PARKED_ORDER_2: CFActiveOrder;
 export declare const MOCK_USERS: CFActiveUser[];
 export declare const MOCK_STATIONS: CFActiveStation[];
 export declare const MOCK_OUTLETS: CFActiveOutlet[];
@@ -76,3 +79,10 @@ type MockEventCallback = (event: any) => void;
 export declare const mockPublishEvent: (topic: string, eventType: string, data: any) => void;
 export declare const mockSubscribeToTopic: (topic: string, callback: MockEventCallback) => void;
 export declare const createOrderFromCart: (paymentType: string, amount: number, processor?: string) => CFActiveOrder;
+/**
+ * Apply a (possibly partial) payment of `amount` minor units to the active cart.
+ * Decrements the remaining balance; when it reaches zero the sale completes
+ * (creates the order, resets the cart, returns it). Otherwise the cart stays
+ * open with `amountToBeCharged` reset to what's left, and returns null.
+ */
+export declare const applyMockPayment: (amount: number, paymentType: string, processor?: string) => CFActiveOrder | null;

package/dist/demo/database.js

@@ -6,7 +6,7 @@ import { CFProductType, CFUserTypes, CurrencyCode } from "../CommonTypes";
 export * from "./mocks";
 // Asset Imports - Using Remote URLs to avoid build complexity with asset copying
 const ASSETS_BASE_URL = "https://raw.githubusercontent.com/Final-Commerce/command-frame/refs/heads/main/src/demo/assets";
-const logo = `${ASSETS_BASE_URL}/logo.png`;
+const logo = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA5OCAxMDQiIGZpbGw9Im5vbmUiPjxwYXRoIGQ9Ik01NS4yOTk4IDUwLjE2NjJMMzcuNzQyMiA0MC4wMjkzTDMxLjcyNzQgNTAuNDQ3MkwzOC45MjQyIDU0LjYwMjJMNTUuMjk5OCA1MC4xNjYyWiIgZmlsbD0iI0E1NjhCQyIvPjxwYXRoIGQ9Ik0zMS45OTYzIDcwLjQ1MDZMNDkuNTU2OCA4MC41ODkxTDU1LjU3MTUgNzAuMTcxM0w0OC4zNzE4IDY2LjAxNDVMMzEuOTk2MyA3MC40NTA2WiIgZmlsbD0iI0E1NjhCQyIvPjxwYXRoIGQ9Ik0zNi4zNTQyIDM0LjI1NzJDMzYuMzU0MiAzNC4yNTcyIDM2LjM1ODMgMzQuMjYzNSAzNi4zNTY3IDM0LjI2NjRDMzcuMTg2OSAzNC4wNjk3IDM4LjA5MTkgMzQuMTU5NiAzOC44ODUxIDM0LjYxNzVMNjIuNjQ4NiA0OC4zMzc0TDU0LjE3MjkgMjkuOTA0OUwzNi4zNDk2IDM0LjI1ODRMMzYuMzU0MiAzNC4yNTcyWiIgZmlsbD0iI0ZDODc1MyIvPjxwYXRoIGQ9Ik0zMy4wOTg4IDE4Ljk1MDdMMzYuMzc3MiAzNC4yNDczTDE4Ljc1MjUgMzkuMzM3M0wyOC45MzcxIDIxLjY5N0MyOS44NDUzIDIwLjEyMzkgMzEuNDE1MiAxOS4xNzYxIDMzLjA5ODggMTguOTUwN1oiIGZpbGw9IiM0MkQzQTkiLz48cGF0aCBkPSJNMTguNzUzMiAzOS4zNDA2TDIwLjY4MjQgNTkuNTE3MUw0LjU3NjA3IDYzLjg5NjJMMTguNzUzMiAzOS4zNDA2WiIgZmlsbD0iIzI3OTdFOCIvPjxwYXRoIGQ9Ik0zNi4zNzc5IDM0LjI0MDNDMzYuMzc3OSAzNC4yNDAzIDM2LjM3NzQgMzQuMjQ3OCAzNi4zODAzIDM0LjI0OTVDMzUuNTYyNCAzNC40OTE5IDM0LjgyMzkgMzUuMDE5NiAzNC4zNjczIDM1LjgxMDVMMjAuNjg2OSA1OS41MDU2TDE4Ljc1NzcgMzkuMzI5MUwzNi4zODI0IDM0LjIzOTFMMzYuMzc3OSAzNC4yNDAzWiIgZmlsbD0iIzFEQkFDQiIvPjxwYXRoIGQ9Ik01NS45MzUyIDEwMS41NDNMNTEuMDgxOSA4Ni42NjU5TDMzLjI1ODcgOTEuMDE5NEw1MC45NDk5IDEwMS4yMzNDNTIuNTI3NiAxMDIuMTQ0IDU0LjM2MzggMTAyLjE4NSA1NS45MzUyIDEwMS41NDNaIiBmaWxsPSIjRkQ1MjYzIi8+PHBhdGggZD0iTTMzLjI1NDkgOTEuMDE0TDI0Ljc4MjEgNzIuNTgzMkw4LjYzMTM1IDc2Ljc5NzVMMzMuMjU0OSA5MS4wMTRaIiBmaWxsPSIjRkZDRjIzIi8+PHBhdGggZD0iTTUxLjA3OSA4Ni42NjM5QzUxLjA3OSA4Ni42NjM5IDUxLjA3NDkgODYuNjU3NiA1MS4wNzY2IDg2LjY1NDdDNTAuMjQ2NCA4Ni44NTE0IDQ5LjM0MTQgODYuNzYxNSA0OC41NDgyIDg2LjMwMzZMMjQuNzg0NiA3Mi41ODM3TDMzLjI2MDQgOTEuMDE2MUw1MS4wODM2IDg2LjY2MjdMNTEuMDc5IDg2LjY2MzlaIiBmaWxsPSIjRkM4NzUzIi8+PHBhdGggZD0iTTU0LjMzNDIgMTAxLjk2OUw1MS4wNTU4IDg2LjY3MjRMNjguNjgwNSA4MS41ODI0TDU4LjQ5NTkgOTkuMjIyN0M1Ny41ODc3IDEwMC43OTYgNTYuMDE3OCAxMDEuNzQ0IDU0LjMzNDIgMTAxLjk2OVoiIGZpbGw9IiM0MkQzQTkiLz48cGF0aCBkPSJNNjguNjgwMSA4MS41ODk5TDY2Ljc0OTMgNjEuNDE2Mkw4Mi44NTU2IDU3LjAzNzJMNjguNjgwMSA4MS41ODk5WiIgZmlsbD0iIzI3OTdFOCIvPjxwYXRoIGQ9Ik01MS4wNTU3IDg2LjY3ODZDNTEuMDU1NyA4Ni42Nzg2IDUxLjA1NjIgODYuNjcxMSA1MS4wNTMyIDg2LjY2OTVDNTEuODcxMSA4Ni40MjcxIDUyLjYwOTcgODUuODk5NCA1My4wNjYzIDg1LjEwODVMNjYuNzQ2NyA2MS40MTMzTDY4LjY3NTkgODEuNTg5OEw1MS4wNTExIDg2LjY3OThMNTEuMDU1NyA4Ni42Nzg2WiIgZmlsbD0iIzFEQkFDQiIvPjxwYXRoIGQ9Ik00Ny44OTQ5IDI2LjI3NjhDNDcuODc4IDI2LjM1OTcgNDcuODUyIDI2LjQ0NTEgNDcuODA2OCAyNi41MjM0TDQ3LjYyNzggMjYuODMzM0M0Ni43ODY1IDI4LjI5MDYgNDQuOTIzMiAyOC43ODY5IDQzLjQ2MTggMjcuOTQzMkM0Mi4wMDA0IDI3LjA5OTQgNDEuNDk4NiAyNS4yMzc2IDQyLjMzOTkgMjMuNzgwNEw0Mi41MTg5IDIzLjQ3MDRDNDIuNTY0MSAyMy4zOTIyIDQyLjYyNSAyMy4zMjY5IDQyLjY4ODQgMjMuMjcwOEwzNi40ODUzIDE5LjY4OTRDMzQuOTA3NiAxOC43Nzg2IDMzLjA3MTQgMTguNzM4MiAzMS41IDE5LjM3OTlMMzYuMzUzMyAzNC4yNTY5TDU0LjE3NjUgMjkuOTAzNUw0Ny44OTQ5IDI2LjI3NjhaIiBmaWxsPSIjRkQ1MjYzIi8+PHBhdGggZD0iTTc1LjYzODYgNDIuMzAyN0M3NS42MjE3IDQyLjM4NTcgNzUuNTk1NiA0Mi40NzExIDc1LjU1MDUgNDIuNTQ5M0w3NS4zNzE1IDQyLjg1OTNDNzQuNTMwMiA0NC4zMTY1IDcyLjY2NjkgNDQuODEyOSA3MS4yMDU0IDQzLjk2OTFDNjkuNzQ0IDQzLjEyNTQgNjkuMjQyMyA0MS4yNjM2IDcwLjA4MzYgMzkuODA2M0w3MC4yNjI2IDM5LjQ5NjNDNzAuMzA3NyAzOS40MTgxIDcwLjM2ODYgMzkuMzUyOSA3MC40MzIgMzkuMjk2N0w1NC4xNzYxIDI5LjkxMTRMNjIuNjUxOSA0OC4zNDM5TDc4LjgwMjYgNDQuMTI5NUw3NS42NDE1IDQyLjMwNDRMNzUuNjM4NiA0Mi4zMDI3WiIgZmlsbD0iI0ZGQ0YyMyIvPjxwYXRoIGQ9Ik03NS42MDU4IDQwLjgyMTlMNzUuNjQ0MiA0MC43NTUyQzc4LjE0ODEgMzYuNDE4MyA3OC42NDY1IDMxLjQ0ODggNzcuNDMwOSAyNi45MzgzQzc2LjIxNTMgMjIuNDI3OCA3My4yODQ3IDE4LjM3MTggNjguOTM1MiAxNS44NjA3QzY0LjU4NTggMTMuMzQ5NSA1OS42MDc5IDEyLjgzOTUgNTUuMDkzOSAxNC4wNDJDNTAuNTc5OSAxNS4yNDQ2IDQ2LjUyNTMgMTguMTYwOSA0NC4wMjE0IDIyLjQ5NzhMNDIuOTkxMSAyNC4yODI0QzQyLjM3MzkgMjUuMzUxNCA0Mi43NDQyIDI2LjcxNjMgNDMuODEzNCAyNy4zMzM2QzQ0Ljg4MjYgMjcuOTUwOSA0Ni4yNTE0IDI3LjU4NjIgNDYuODY2OSAyNi41MjAxTDQ3Ljg5NzMgMjQuNzM1NUM0OS43ODU3IDIxLjQ2NDcgNTIuODQ0MSAxOS4yNjczIDU2LjI1NDggMTguMzU4N0M1OS42NjU0IDE3LjQ1MDEgNjMuNDE5MSAxNy44MzI3IDY2LjY5OTQgMTkuNzI2NkM2OS45Nzk2IDIxLjYyMDQgNzIuMTg3OSAyNC42Nzk5IDczLjEwNjMgMjguMDg3OUM3NC4wMjQ4IDMxLjQ5NiA3My42NTEgMzUuMjQzNCA3MS43NjI2IDM4LjUxNDFMNzEuNzI0MSAzOC41ODA4TDcwLjczMzkgNDAuMjk1OEM3MC4xMTY3IDQxLjM2NDkgNzAuNDg3IDQyLjcyOTcgNzEuNTU2MiA0My4zNDdDNzIuNjI1NCA0My45NjQ0IDczLjk5NDIgNDMuNTk5NyA3NC42MDk4IDQyLjUzMzZMNzUuNTk5OSA0MC44MTg1TDc1LjYwNTggNDAuODIxOVoiIGZpbGw9IiMzRDRDNjYiLz48L3N2Zz4="; // crisp vector mark (was logo.png — pixelated when scaled)
 const basilAlmondImg = `${ASSETS_BASE_URL}/basil-almond-paste.png`;
 const beerImg = `${ASSETS_BASE_URL}/beer-paste.png`;
 const beetImg = `${ASSETS_BASE_URL}/beet-paste.png`;
@@ -335,6 +335,9 @@ export const MOCK_ORDER_1 = {
     companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
+    paymentState: "paid",
+    fulfillmentState: "fulfilled",
+    displayState: "Completed",
     customer: MOCK_CUSTOMER_1,
     summary: {
         total: 2100,
@@ -382,6 +385,9 @@ export const MOCK_ORDER_2 = {
     companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
+    paymentState: "paid",
+    fulfillmentState: "fulfilled",
+    displayState: "Completed",
     customer: MOCK_CUSTOMER_2,
     summary: {
         total: 3000,
@@ -421,6 +427,140 @@ export const MOCK_ORDER_2 = {
     station: MOCK_STATION_2,
     createdAt: new Date(Date.now() - 3600000).toISOString()
 };
+export const MOCK_ORDER_3 = {
+    _id: "order_1003",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "1001-0003",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "refunded",
+    paymentState: "refunded",
+    fulfillmentState: "fulfilled",
+    displayState: "Refunded",
+    customer: MOCK_CUSTOMER_3,
+    summary: {
+        total: 1500,
+        subTotal: 1500,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [
+        {
+            transactionId: "trans_card_2",
+            paymentType: "credit_card",
+            amount: 1500,
+            timestamp: new Date(Date.now() - 7200000).toISOString(),
+            processor: "stripe"
+        }
+    ],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_1._id,
+        employee: MOCK_USER_MARIO.id
+    },
+    sessionId: "sess_3",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_BEET, 0, 1)],
+    customSales: [],
+    balance: 0,
+    user: MOCK_USER_MARIO,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_1,
+    createdAt: new Date(Date.now() - 7200000).toISOString()
+};
+export const MOCK_PARKED_ORDER_1 = {
+    _id: "parked_2001",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "PARK-0001",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "parked",
+    paymentState: "unpaid",
+    fulfillmentState: "unfulfilled",
+    displayState: "Parked",
+    customer: MOCK_CUSTOMER_4,
+    summary: {
+        total: 2100,
+        subTotal: 2100,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_1._id,
+        employee: MOCK_USER_LUIGI.id
+    },
+    sessionId: "sess_park_1",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_LEMON, 0, 2)],
+    customSales: [],
+    balance: 2100,
+    user: MOCK_USER_LUIGI,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_1,
+    createdAt: new Date(Date.now() - 1800000).toISOString()
+};
+export const MOCK_PARKED_ORDER_2 = {
+    _id: "parked_2002",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "PARK-0002",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "parked",
+    paymentState: "unpaid",
+    fulfillmentState: "unfulfilled",
+    displayState: "Parked",
+    customer: null,
+    summary: {
+        total: 2500,
+        subTotal: 2500,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_2._id,
+        employee: MOCK_USER_MARIO.id
+    },
+    sessionId: "sess_park_2",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_CARAMELIZED, 0, 1), createLineItem(MOCK_PRODUCT_GINGER_LIME, 0, 1)],
+    customSales: [],
+    balance: 2500,
+    user: MOCK_USER_MARIO,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_2,
+    createdAt: new Date(Date.now() - 900000).toISOString()
+};
 // --- EXPORT COLLECTIONS ---
 export const MOCK_USERS = [MOCK_USER_MARIO, MOCK_USER_LUIGI];
 export const MOCK_STATIONS = [MOCK_STATION_1, MOCK_STATION_2];
@@ -443,8 +583,8 @@ export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_HABANERO,
     MOCK_PRODUCT_BLACK_GARLIC
 ];
-export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2];
-export const MOCK_PARKED_ORDERS = [];
+export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2, MOCK_ORDER_3];
+export const MOCK_PARKED_ORDERS = [MOCK_PARKED_ORDER_1, MOCK_PARKED_ORDER_2];
 // Compatibility Exports (reassigned by setMockDatabase)
 export let MOCK_USER = MOCK_USERS[0];
 export let MOCK_STATION = MOCK_STATIONS[0];
@@ -607,6 +747,9 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
         companyId: MOCK_COMPANY.id,
         externalId: null,
         status: "completed",
+        paymentState: "paid",
+        fulfillmentState: "fulfilled",
+        displayState: "Completed",
         customer: MOCK_CART.customer ? MOCK_CART.customer : null,
         summary: {
             total: totalNum,
@@ -652,3 +795,26 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
     mockPublishEvent("cart", "cart-created", {});
     return newOrder;
 };
+/**
+ * Apply a (possibly partial) payment of `amount` minor units to the active cart.
+ * Decrements the remaining balance; when it reaches zero the sale completes
+ * (creates the order, resets the cart, returns it). Otherwise the cart stays
+ * open with `amountToBeCharged` reset to what's left, and returns null.
+ */
+export const applyMockPayment = (amount, paymentType, processor = "cash") => {
+    const remainingBefore = MOCK_CART.remainingBalance ?? MOCK_CART.total;
+    const charge = Math.min(Math.max(0, amount || remainingBefore), remainingBefore);
+    const remainingAfter = Math.max(0, remainingBefore - charge);
+    if (remainingAfter > 0) {
+        // Partial payment — keep the cart open, queue the rest for the next tender.
+        MOCK_CART.remainingBalance = remainingAfter;
+        MOCK_CART.amountToBeCharged = remainingAfter;
+        mockPublishEvent("cart", "partial-payment-applied", { charged: charge, remaining: remainingAfter });
+        return null;
+    }
+    // Fully paid — create the completed order (this also resets the cart).
+    const orderTotal = MOCK_CART.total;
+    const order = createOrderFromCart(paymentType, orderTotal, processor);
+    mockPublishEvent("payments", "payment-done", { order });
+    return order;
+};

package/dist/fragments/index.d.ts

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

package/dist/fragments/index.js

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

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

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