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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/actions/trigger-webhook/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Trigger webhook action
- * Calls the triggerWebhook action on the parent window
- */
-import type { TriggerWebhook } from "./types";
-export declare const triggerWebhook: TriggerWebhook;

package/dist/actions/trigger-webhook/action.js

@@ -1,8 +0,0 @@
-/**
- * Trigger webhook action
- * Calls the triggerWebhook action on the parent window
- */
-import { commandFrameClient } from "../../client";
-export const triggerWebhook = async (params) => {
-    return await commandFrameClient.call("triggerWebhook", params);
-};

package/dist/actions/trigger-webhook/mock.d.ts

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

package/dist/actions/trigger-webhook/mock.js

@@ -1,8 +0,0 @@
-export const mockTriggerWebhook = async (params) => {
-    console.log("[Mock] triggerWebhook called", params);
-    return {
-        success: true,
-        webhookUrl: params?.webhookUrl || "",
-        timestamp: new Date().toISOString()
-    };
-};

package/dist/actions/trigger-webhook/types.d.ts

@@ -1,21 +0,0 @@
-export type TriggerWebhookPresetType = 'product' | 'cart' | 'order' | 'customer';
-export interface TriggerWebhookParams {
-    webhookUrl: string;
-    /** Public key for authentication. */
-    publicKey?: string;
-    /** Defaults to false. */
-    presetData?: boolean;
-    presetType?: TriggerWebhookPresetType;
-    /** Defaults to false. */
-    isCustomHook?: boolean;
-    customHookData?: string;
-    /** 'json' or 'form-urlencoded'. Defaults to 'json'. */
-    payloadType?: string;
-    dynamicDataFields?: unknown[];
-}
-export interface TriggerWebhookResponse {
-    success: boolean;
-    webhookUrl: string;
-    timestamp: string;
-}
-export type TriggerWebhook = (params?: TriggerWebhookParams) => Promise<TriggerWebhookResponse>;

package/dist/actions/trigger-webhook/types.js

@@ -1,2 +0,0 @@
-// Trigger Webhook Types
-export {};

package/dist/actions/trigger-zapier-webhook/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Trigger Zapier webhook action
- * Calls the triggerZapierWebhook action on the parent window
- */
-import type { TriggerZapierWebhook } from "./types";
-export declare const triggerZapierWebhook: TriggerZapierWebhook;

package/dist/actions/trigger-zapier-webhook/action.js

@@ -1,8 +0,0 @@
-/**
- * Trigger Zapier webhook action
- * Calls the triggerZapierWebhook action on the parent window
- */
-import { commandFrameClient } from "../../client";
-export const triggerZapierWebhook = async (params) => {
-    return await commandFrameClient.call("triggerZapierWebhook", params);
-};

package/dist/actions/trigger-zapier-webhook/mock.d.ts

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

package/dist/actions/trigger-zapier-webhook/mock.js

@@ -1,8 +0,0 @@
-export const mockTriggerZapierWebhook = async (params) => {
-    console.log("[Mock] triggerZapierWebhook called", params);
-    return {
-        success: true,
-        triggerUrl: params?.triggerUrl || "",
-        timestamp: new Date().toISOString()
-    };
-};

package/dist/actions/trigger-zapier-webhook/types.d.ts

@@ -1,9 +0,0 @@
-export interface TriggerZapierWebhookParams {
-    triggerUrl: string;
-}
-export interface TriggerZapierWebhookResponse {
-    success: boolean;
-    triggerUrl: string;
-    timestamp: string;
-}
-export type TriggerZapierWebhook = (params?: TriggerZapierWebhookParams) => Promise<TriggerZapierWebhookResponse>;

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

@@ -1,32 +0,0 @@
-/**
- * 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

@@ -1,6 +0,0 @@
-/**
- * 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

@@ -1,77 +0,0 @@
-/**
- * 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

@@ -1,10 +0,0 @@
-/**
- * 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/fragments/index.d.ts

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

package/dist/fragments/index.js

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

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

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

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

@@ -1,166 +0,0 @@
-/**
- * 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/pubsub/topics/orders/state-transition-blocked/types.d.ts

@@ -1,16 +0,0 @@
-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-completed/types.d.ts

@@ -1,15 +0,0 @@
-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>;