@final-commerce/command-frame 0.4.2-preprod.1 → 0.5.0-preprod.2

package/README.md

@@ -4,7 +4,7 @@ A TypeScript library for type-safe communication between iframes and their paren
 
 ## Overview
 
-Command Frame provides a structured way to build integrations that run inside Final Commerce applications (like Render POS or Manage Dashboard). It handles the underlying `postMessage` communication while enforcing strict type safety for both the host application (Provider) and the embedded app (Client).
+Command Frame provides a structured way to build integrations that run inside Final Commerce applications (the kaching POS runtime or the Manage Dashboard). It handles the underlying `postMessage` communication while enforcing strict type safety for both the host application (Provider) and the embedded app (Client).
 
 `RenderClient` and `ManageClient` extend `CommandFrameClient`: dynamic methods such as `getProducts()` map to `postMessage` actions named after the method (camelCase), with typed params and responses per project.
 
@@ -14,8 +14,6 @@ The library provides three main capabilities:
 | ------------------- | ------------------------------------------------------------------------- | ----------------------------------------- |
 | **Commands**        | Call host functions from the iframe (e.g. get products, open cash drawer) | Request/response per call                 |
 | **Pub/Sub**         | Subscribe to real-time events from the host (e.g. cart changes, payments) | Page-scoped (while iframe is mounted)     |
-| **Hooks**           | Register business-logic callbacks that persist across all pages           | Session-scoped (survives page navigation) |
-| **Interceptors**    | Gate POS flows (approve / modify / block) at named points                 | Blocking; host waits for your response    |
 | **Refund commands** | Refund payments to gift cards or redeem tenders via `redeemRefund`, or mixed-destination legs on `processPartialRefund`; query engine capacity with `getRefundPlan`; pre-gate UI with `checkPermission` (`issue_refunds` is enforced runtime-side) | Request/response per call                 |
 
 Domain models (orders, cart, customers, products, and related types) are documented in **[Types reference](./src/types/README.md)**.
@@ -65,7 +63,7 @@ true` → `amount` is `0–100`), and quantities.
 
 ### Render (POS System)
 
-For building applications that run inside the Render Point of Sale interface.
+For building applications that run inside the Final Commerce POS (the kaching runtime).
 
 - **[Render Documentation](./src/projects/render/README.md)**
 - **Features:** Order management, Product catalog, Customer management, Payments, Hardware integration (Cash drawer, Printer), Custom tables, Secrets storage.
@@ -93,10 +91,10 @@ const context = await client.getContext();
 
 ## Pub/Sub
 
-The pub/sub system allows iframe extensions to subscribe to topics and receive real-time events published by the host (Render). Subscriptions are **page-scoped** -- they fire only while the iframe is mounted on the current page.
+The pub/sub system allows iframe extensions to subscribe to topics and receive real-time events published by the POS host (kaching). Subscriptions are **page-scoped** -- they fire only while the iframe is mounted on the current page.
 
 - **[Pub/Sub Documentation](./src/pubsub/README.md)**
-- **Topics:** Cart (16), Customers (8), Orders (5), Payments (2), Products (4), Refunds (4), Print (3), Custom Tables (3), Outlet (2), Station (2), Session (2), Users (2).
+- **Topics:** Cart (16), Customers (8), Orders (7), Payments (2), Products (4), Refunds (4), Print (3), Custom Tables (3), Outlet (2), Station (2), Session (2), Users (4), Variants (2), Transactions (2), Categories (2), Attributes (2), Split Payments (1).
 
 ```typescript
 import { topics } from '@final-commerce/command-frame';
@@ -109,55 +107,6 @@ const subscriptionId = topics.subscribe('cart', (event) => {
 topics.unsubscribe('cart', subscriptionId);
 ```
 
-## Hooks
-
-Hooks are **session-scoped** event callbacks that run in the host (Render) context and persist across all page navigations -- even when the extension iframe is no longer on the current page. Use hooks for business logic that must run on every event (e.g. logging to custom tables, triggering webhooks).
-
-- **[Hooks Documentation](./src/hooks/README.md)**
-- The callback is serialized and sent to the host; it must be **self-contained** (no closures, no imports).
-- A stable `hookId` is required for deduplication (safe on iframe reload).
-
-```typescript
-import { hooks } from '@final-commerce/command-frame';
-
-hooks.register(
-  'cart',
-  async (event, hostCommands) => {
-    await hostCommands.upsertCustomTableData({
-      tableName: 'cart-events-log',
-      data: { eventType: event.type, payload: event.data, timestamp: event.timestamp },
-    });
-  },
-  { hookId: 'my-extension:cart-log' },
-);
-
-// Unregister when no longer needed
-hooks.unregister('my-extension:cart-log');
-```
-
-## Interceptors
-
-Interceptors let an extension **gate a POS flow** (approve / modify / block) at a named point — the host waits for your interceptor and acts on what it returns. Unlike hooks, interceptors are **blocking**.
-
-- **[Interceptors Documentation](./src/interceptors/README.md)**
-- The callback is serialized and reconstructed on the host; it must be **self-contained** (no closures, no imports).
-- A stable `interceptorId` is required for deduplication (safe on iframe reload).
-
-```typescript
-import { interceptors } from '@final-commerce/command-frame';
-
-interceptors.register(
-  'refund_start',
-  async (payload, cmds) => {
-    if (payload.paymentTypes.includes('redeem')) {
-      return cmds.openExtensionOverlay({ point: 'refund_start', payload });
-    }
-    return true; // nothing for us to do
-  },
-  { interceptorId: 'my-extension:refund-guard' },
-);
-```
-
 ## Refunding redeem / extension payments
 
 When staff refund an order that was paid with `paymentType: "redeem"` (via `redeemPayment` or `extensionPayment`), use the **`redeemRefund`** command to refund the amount onto a gift card or redeem tender.

package/dist/CommonTypes.d.ts

@@ -96,7 +96,7 @@ export interface CFActiveRefundDetails {
     refundProcessingStatus?: CFRefundProcessingStatus | null;
     sessionRefundedTotal?: number;
 }
-export type CFProjectName = "Render" | "Manage";
+export type CFProjectName = "kaching" | "Manage";
 export interface CFContextRender {
     userId: string | null;
     companyId: string | null;

package/dist/actions/add-product-fee/types.d.ts

@@ -5,9 +5,8 @@ export interface AddProductFeeParams {
     isPercent?: boolean;
     /** Defaults to "Fee". */
     label?: string;
-    /** Defaults to `false`. */
+    /** Defaults to `false`. When true, the fee inherits the target cart line's own tax table (a caller-supplied tax table is not honored). */
     applyTaxes?: boolean;
-    taxTableId?: string;
     /** The unique identifier for a specific line item in the cart. */
     internalId?: string;
 }

package/dist/actions/adjust-inventory/mock.js

@@ -2,29 +2,33 @@ import { MOCK_PRODUCTS } from "../../demo/database";
 export const mockAdjustInventory = async (params) => {
     console.log("[Mock] adjustInventory called", params);
     let newStock = 0;
-    if (params && params.productId) {
-        const product = MOCK_PRODUCTS.find(p => p._id === params.productId);
-        if (product) {
-            // Find variant
-            const variant = params.variantId
-                ? product.variants.find(v => v._id === params.variantId)
-                : product.variants[0];
-            if (variant && variant.inventory && variant.inventory.length > 0) {
-                const currentStock = variant.inventory[0].stock || 0;
-                const changeAmount = Number(params.amount);
-                if (params.stockType === 'add') {
-                    newStock = currentStock + changeAmount;
-                }
-                else if (params.stockType === 'subtract') {
-                    newStock = currentStock - changeAmount;
-                }
-                else {
-                    newStock = changeAmount;
-                }
-                // Update mock DB
-                variant.inventory[0].stock = newStock;
+    // Real handler keys off variantId (falling back to the active product's
+    // variant); mirror that here by finding the owning product for the variant.
+    if (params && params.variantId) {
+        const variantId = params.variantId;
+        let variant;
+        for (const product of MOCK_PRODUCTS) {
+            const match = product.variants.find(v => v._id === variantId);
+            if (match) {
+                variant = match;
+                break;
             }
         }
+        if (variant && variant.inventory && variant.inventory.length > 0) {
+            const currentStock = variant.inventory[0].stock || 0;
+            const changeAmount = Number(params.amount);
+            if (params.stockType === 'add') {
+                newStock = currentStock + changeAmount;
+            }
+            else if (params.stockType === 'subtract') {
+                newStock = currentStock - changeAmount;
+            }
+            else {
+                newStock = changeAmount;
+            }
+            // Update mock DB
+            variant.inventory[0].stock = newStock;
+        }
     }
     return {
         success: true,

package/dist/actions/adjust-inventory/types.d.ts

@@ -3,8 +3,8 @@ export interface AdjustInventoryParams {
     amount: string;
     /** 'add' (increase), 'subtract' (decrease), or 'set' (recount). */
     stockType: 'add' | 'subtract' | 'set';
+    /** Variant to adjust. Omit to use the active product's selected variant. */
     variantId?: string;
-    productId?: string;
 }
 export interface AdjustInventoryResponse {
     success: boolean;

package/dist/actions/authenticate-user/mock.js

@@ -1,5 +1,9 @@
 export const mockAuthenticateUser = async (params) => {
     console.log("[Mock] authenticateUser called", params);
+    // Headless path requires both userId and pin together (mirrors the handler guard).
+    if ((params?.userId || params?.pin) && !(params?.userId && params?.pin)) {
+        throw new Error("userId and pin must be provided together");
+    }
     return {
         success: true,
         roleIds: params?.roleIds || [],

package/dist/actions/authenticate-user/types.d.ts

@@ -1,5 +1,18 @@
 export interface AuthenticateUserParams {
+    /** Role IDs authorized for the gated action. The authenticating user must hold one of these. */
     roleIds: string[];
+    /**
+     * Headless validation: the id of the user whose PIN to verify. Provide together
+     * with `pin` to validate the credentials in-process and return success/failure
+     * WITHOUT showing kaching's PIN modal (the flow owns its own PIN UI). When
+     * omitted, the modal flow is used. Must be paired with `pin`.
+     */
+    userId?: string;
+    /**
+     * Headless validation: the PIN to check against `userId`'s stored pincode.
+     * Must be paired with `userId`. The user must also hold one of `roleIds`.
+     */
+    pin?: string;
 }
 export interface AuthenticateUserResponse {
     success: boolean;

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

@@ -11,7 +11,9 @@ export const mockCashPayment = async (params) => {
             cashRounding: 0,
             paymentType: "cash",
             order: null,
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
+            saleFinalized: false,
+            remainingBalance: 0
         };
     };
     // Contract: `amount` is required, integer MINOR currency units — same
@@ -55,6 +57,8 @@ export const mockCashPayment = async (params) => {
         cashRounding: 0,
         paymentType: "cash",
         order,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
+        saleFinalized: true,
+        remainingBalance: 0
     };
 };

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface CashPaymentParams {
     /**
      * The amount to pay with this tender, in integer MINOR currency units
@@ -29,7 +28,7 @@ export interface CashPaymentParams {
      * POS still opens its legacy change-calculator modal.
      */
     openChangeCalculator?: boolean;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    /** Override the fulfillment state after full payment. kaching resolves the cascade. */
     checkoutFulfillmentTarget?: string;
 }
 export interface CashPaymentResponse {
@@ -56,7 +55,9 @@ export interface CashPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
+    /** True when this tender settled the cart's remaining balance (the sale completed). */
+    saleFinalized: boolean;
+    /** Balance still due after this tender, in integer MINOR currency units (0 once the sale is finalized). */
+    remainingBalance: number;
 }
 export type CashPayment = (params: CashPaymentParams) => Promise<CashPaymentResponse>;

package/dist/actions/delete-parked-order/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface DeleteParkedOrderParams {
     orderId: string;
 }
@@ -6,7 +5,5 @@ export interface DeleteParkedOrderResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type DeleteParkedOrder = (params?: DeleteParkedOrderParams) => Promise<DeleteParkedOrderResponse>;

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

@@ -6,6 +6,10 @@ export const mockExtensionPayment = async (params) => {
         amount: params?.amount ?? null,
         paymentType,
         order: MOCK_ORDERS[0],
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
+        change: 0,
+        cashRounding: 0,
+        saleFinalized: true,
+        remainingBalance: 0
     };
 };

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 /** Params for extension-initiated payments; host routes by `paymentType`. */
 export interface ExtensionPaymentParams {
     paymentType: string;
@@ -15,8 +14,8 @@ export interface ExtensionPaymentParams {
     referenceId?: string;
     extensionId?: string;
     metadata?: Record<string, unknown>;
-    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
-    targetFulfillmentState?: string;
+    /** Override the fulfillment state the order lands in on full payment (validated against the fulfillment state machine; invalid values throw). Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
+    checkoutFulfillmentTarget?: string;
     /** EMV data when the underlying payment carries one (typed as `IntegrationEmvData` by the integration wrapper). */
     emvData?: unknown;
     /** Processor fee in integer MINOR currency units; recorded on the order's paymentMethod.processorFee. */
@@ -28,7 +27,13 @@ export interface ExtensionPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
+    /** Change due back to the customer in integer MINOR currency units (0 for non-cash tenders). */
+    change: number;
+    /** Signed cash-rounding delta applied to the charge, in integer MINOR currency units (positive = rounded up); 0 when the company has no cash-rounding setting. */
+    cashRounding: number;
+    /** True when this tender settled the cart's remaining balance (the sale completed). */
+    saleFinalized: boolean;
+    /** Balance still due after this tender, in integer MINOR currency units (0 once the sale is finalized). */
+    remainingBalance: number;
 }
 export type ExtensionPayment = (params?: ExtensionPaymentParams) => Promise<ExtensionPaymentResponse>;

package/dist/actions/get-custom-table-data/types.d.ts

@@ -4,10 +4,8 @@ export interface GetCustomTableDataResponse<T = any> {
     timestamp: string;
 }
 export interface GetCustomTableDataParams {
-    /** Table name (kebab-case). Required if tableId is not provided. */
-    tableName?: string;
-    /** Table ID. Required if tableName is not provided. */
-    tableId?: string;
+    /** Table name (kebab-case). Required — the handler throws if it is absent. */
+    tableName: string;
     /** Optional query filter */
     query?: any;
     /** Pagination offset */

package/dist/actions/get-final-context/mock.js

@@ -1,6 +1,6 @@
 export const mockGetFinalContext = async () => {
     console.log("[Mock] getFinalContext called");
     return {
-        projectName: "Render"
+        projectName: "kaching"
     };
 };

package/dist/actions/get-remaining-refundable-quantities/mock.js

@@ -4,6 +4,8 @@ export const mockGetRemainingRefundableQuantities = async (_params) => {
         success: true,
         lineItems: {},
         customSales: {},
+        cartFees: {},
+        tips: {},
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/get-remaining-refundable-quantities/types.d.ts

@@ -5,6 +5,19 @@ export interface GetRemainingRefundableQuantitiesResponse {
     success: boolean;
     lineItems: Record<string, number>;
     customSales: Record<string, number>;
+    /**
+     * Remaining refundable cart fees, keyed by `order.cartFees[].id` —
+     * the same key `processPartialRefund` takes for `type: 'fee'` items.
+     * 0/1 semantics: `1` = still refundable, `0` = already refunded.
+     */
+    cartFees: Record<string, number>;
+    /**
+     * Remaining refundable tips, keyed by the paying method's
+     * `transactionId` — the same key `processPartialRefund` takes for
+     * `type: 'tip'` items. Only payment methods that carry a tip appear.
+     * 0/1 semantics: `1` = still refundable, `0` = already refunded.
+     */
+    tips: Record<string, number>;
     timestamp: string;
 }
 export type GetRemainingRefundableQuantities = (params?: GetRemainingRefundableQuantitiesParams) => Promise<GetRemainingRefundableQuantitiesResponse>;

package/dist/actions/initiate-refund/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface InitiateRefundParams {
     /** The ID of the order to refund. If not provided, uses the currently active order. */
     orderId?: string;
@@ -7,7 +6,5 @@ export interface InitiateRefundResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type InitiateRefund = (params?: InitiateRefundParams) => Promise<InitiateRefundResponse>;

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

@@ -2,7 +2,7 @@ import type { ExtensionPaymentResponse } from "../extension-payment/types";
 /**
  * Card display fields for an integration payment.
  *
- * Render JSON-serializes this object onto the order's `paymentMethod.emv` field;
+ * kaching JSON-serializes this object onto the order's `paymentMethod.emv` field;
  * the transactions list, split-payment refund modal, and receipt mapper parse it
  * back. Field names are translated to the platform's canonical EMV keys ("Brand",
  * "Cardholder Name", "Card Number", etc.) on the host before serialization — your
@@ -24,13 +24,13 @@ export interface IntegrationEmvData {
     expiryDate?: string;
     /** Issuer / bank name. → "Issuer" */
     issuer?: string;
-    /** Last 4 digits of the card. Render masks to "**** **** **** XXXX" before display. → "Card Number" */
+    /** Last 4 digits of the card. kaching masks to "**** **** **** XXXX" before display. → "Card Number" */
     cardNumberLast4?: string;
 }
 /**
  * Integration payment (e.g. Stripe-like) — always uses paymentType `"integration"` on the wire.
  * The extension processes the payment with its own provider, then reports the result here so
- * Render can record the transaction + order.
+ * kaching can record the transaction + order.
  *
  * Required fields (compile-time enforced by TS, runtime-enforced by the host handler):
  *   - `amount` — integer MINOR currency units of the captured amount (e.g. 1575 = $15.75)
@@ -51,8 +51,8 @@ export interface IntegrationPaymentParams {
     metadata?: Record<string, unknown>;
     /** Provider fee in integer MINOR currency units — stored on paymentMethod.processorFee. */
     processorFee?: number;
-    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
-    targetFulfillmentState?: string;
+    /** Override the fulfillment state the order lands in on full payment (validated against the fulfillment state machine; invalid values throw). Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
+    checkoutFulfillmentTarget?: string;
 }
 export type IntegrationPaymentResponse = ExtensionPaymentResponse;
 export type IntegrationPayment = (params: IntegrationPaymentParams) => Promise<IntegrationPaymentResponse>;

package/dist/actions/park-order/types.d.ts

@@ -1,10 +1,7 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ParkOrderResponse {
     success: boolean;
     order: CFOrder;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type ParkOrder = () => Promise<ParkOrderResponse>;

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface PartialPaymentParams {
     /** The payment amount in integer MINOR currency units (required if openUI is false). If isPercent is true, this is a percentage (0-100) instead. */
     amount?: number;
@@ -7,8 +6,6 @@ export interface PartialPaymentParams {
     isPercent?: boolean;
     /** If true, opens the split payment UI. */
     openUI?: boolean;
-    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
-    targetFulfillmentState?: string;
 }
 export interface PartialPaymentResponse {
     success: boolean;
@@ -17,7 +14,5 @@ export interface PartialPaymentResponse {
     openUI: boolean;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type PartialPayment = (params?: PartialPaymentParams) => Promise<PartialPaymentResponse>;

package/dist/actions/print/mock.js

@@ -9,9 +9,11 @@ export const mockPrint = (params) => {
             console.log("[Mock] Would print image:", params.data.image?.substring(0, 50) + "...");
             break;
         case "html":
+            console.warn("[Mock] print type 'html' is DEPRECATED — rasterize and use type: 'image'.");
             console.log("[Mock] Would print HTML:", params.data.html?.substring(0, 100) + "...");
             break;
         case "receipt":
+            console.warn("[Mock] print type 'receipt' is DEPRECATED — rasterize and use type: 'image'.");
             console.log("[Mock] Would print receipt for order:", params.data.order);
             break;
     }

package/dist/actions/print/types.d.ts

@@ -7,12 +7,18 @@ export type PrintParams = {
     };
     options?: PrintOptions;
 } | {
+    /** @deprecated Rasterize your HTML and use `type: "image"`. The native path posts raw HTML to the shell (no html2canvas/sanitization) and PrintOptions may be dropped. */
     type: "html";
     data: {
         html: string;
     };
     options?: PrintOptions;
 } | {
+    /**
+     * @deprecated Compose + rasterize your receipt and use `type: "image"`.
+     * The station requires `order` (no active-order fallback), ignores
+     * `globalBlockId`, and drops ALL PrintOptions (including tag routing).
+     */
     type: "receipt";
     data: {
         order?: Omit<CFActiveOrder, "_id">;
@@ -27,6 +33,7 @@ export interface PrintOptions {
         bottom?: number;
         left?: number;
     };
+    /** @deprecated Not consumed by the runtime — paper size comes from the station's per-printer settings. */
     paperSize?: string;
     width?: string;
     /**

package/dist/actions/process-partial-refund/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ProcessPartialRefundParams {
     /**
      * Optional refund reason.
@@ -114,7 +113,5 @@ export interface ProcessPartialRefundResponse {
     success: boolean;
     refundId: string;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type ProcessPartialRefund = (params?: ProcessPartialRefundParams) => Promise<ProcessPartialRefundResponse>;

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

@@ -12,8 +12,8 @@ export interface RedeemPaymentParams {
     processor?: string;
     referenceId?: string;
     metadata?: Record<string, unknown>;
-    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
-    targetFulfillmentState?: string;
+    /** Override the fulfillment state the order lands in on full payment (validated against the fulfillment state machine; invalid values throw). Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
+    checkoutFulfillmentTarget?: string;
 }
 export type RedeemPaymentResponse = ExtensionPaymentResponse;
 export type RedeemPayment = (params: RedeemPaymentParams) => Promise<RedeemPaymentResponse>;

package/dist/actions/resume-parked-order/types.d.ts

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface ResumeParkedOrderParams {
     orderId: string;
 }
@@ -7,7 +6,5 @@ export interface ResumeParkedOrderResponse {
     success: boolean;
     order: CFOrder;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type ResumeParkedOrder = (params?: ResumeParkedOrderParams) => Promise<ResumeParkedOrderResponse>;

package/dist/actions/tap-to-pay-payment/mock.js

@@ -10,6 +10,10 @@ export const mockTapToPayPayment = async (params) => {
         amount: due,
         paymentType: "tapToPay",
         order,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
+        change: 0,
+        cashRounding: 0,
+        saleFinalized: true,
+        remainingBalance: 0
     };
 };

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface TapToPayPaymentParams {
     /**
      * The amount to pay with this tender, in integer MINOR currency units
@@ -11,7 +10,7 @@ export interface TapToPayPaymentParams {
      *   - more than balance  → error
      */
     amount: number;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
+    /** Override the fulfillment state after full payment. kaching resolves the cascade. */
     checkoutFulfillmentTarget?: string;
 }
 export interface TapToPayPaymentResponse {
@@ -20,7 +19,13 @@ export interface TapToPayPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
+    /** Change due back to the customer in integer MINOR currency units (0 for non-cash tenders). */
+    change: number;
+    /** Signed cash-rounding delta applied to the charge, in integer MINOR currency units (positive = rounded up); 0 when the company has no cash-rounding setting. */
+    cashRounding: number;
+    /** True when this tender settled the cart's remaining balance (the sale completed). */
+    saleFinalized: boolean;
+    /** Balance still due after this tender, in integer MINOR currency units (0 once the sale is finalized). */
+    remainingBalance: number;
 }
 export type TapToPayPayment = (params?: TapToPayPaymentParams) => Promise<TapToPayPaymentResponse>;

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

@@ -11,6 +11,10 @@ export const mockTerminalPayment = async (params) => {
         amount: due,
         paymentType: "terminal",
         order,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
+        change: 0,
+        cashRounding: 0,
+        saleFinalized: true,
+        remainingBalance: 0
     };
 };

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface TerminalPaymentParams {
     /**
      * The amount to pay with this tender, in integer MINOR currency units
@@ -11,10 +10,10 @@ export interface TerminalPaymentParams {
      *   - more than balance  → error
      */
     amount: number;
-    /** "Bluetooth" or "Cloud". Defaults to "Cloud". */
+    /** "Bluetooth" or "Cloud". Only "Cloud" routes to the cloud processor; omitted or "Bluetooth" uses the native card reader. */
     paymentType?: "Bluetooth" | "Cloud";
-    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
-    targetFulfillmentState?: string;
+    /** Override the fulfillment state the order lands in on full payment (validated against the fulfillment state machine; invalid values throw). Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
+    checkoutFulfillmentTarget?: string;
 }
 export interface TerminalPaymentResponse {
     success: boolean;
@@ -22,7 +21,13 @@ export interface TerminalPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
+    /** Change due back to the customer in integer MINOR currency units (0 for non-cash tenders). */
+    change: number;
+    /** Signed cash-rounding delta applied to the charge, in integer MINOR currency units (positive = rounded up); 0 when the company has no cash-rounding setting. */
+    cashRounding: number;
+    /** True when this tender settled the cart's remaining balance (the sale completed). */
+    saleFinalized: boolean;
+    /** Balance still due after this tender, in integer MINOR currency units (0 once the sale is finalized). */
+    remainingBalance: number;
 }
 export type TerminalPayment = (params?: TerminalPaymentParams) => Promise<TerminalPaymentResponse>;

package/dist/actions/upsert-custom-table-data/types.d.ts

@@ -1,6 +1,16 @@
+/** The persisted custom-table row: your `data` fields plus the platform-generated identity. */
+export type UpsertedCustomTableRow<T = any> = T & {
+    /** Generated row id (present on both insert and update). */
+    _id: string;
+    /** ISO timestamp; present on insert. */
+    createdAt?: string;
+    /** ISO timestamp; set on every upsert. */
+    updatedAt?: string;
+};
 export interface UpsertCustomTableDataResponse<T = any> {
     success: boolean;
-    data: T;
+    /** The PERSISTED row (with the generated `_id`/timestamps), not a bare echo of the input. */
+    data: UpsertedCustomTableRow<T>;
     timestamp: string;
 }
 export interface UpsertCustomTableDataParams<T = any> {

package/dist/actions/void-order/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from '../../common-types/order-state';
 export type VoidOrderOutcome = 'voided' | 'refunded';
 export interface VoidOrderParams {
     /** Order to void; defaults to the active order. */
@@ -21,7 +20,5 @@ export interface VoidOrderResponse {
      */
     outcome: VoidOrderOutcome;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type VoidOrder = (params?: VoidOrderParams) => Promise<VoidOrderResponse>;

package/dist/index.d.ts

@@ -38,7 +38,6 @@ export declare const command: {
     readonly getCashRoundingAmount: import(".").GetCashRoundingAmount;
     readonly tapToPayPayment: import(".").TapToPayPayment;
     readonly terminalPayment: import(".").TerminalPayment;
-    readonly vendaraPayment: import(".").VendaraPayment;
     readonly extensionPayment: import(".").ExtensionPayment;
     readonly redeemPayment: import(".").RedeemPayment;
     readonly integrationPayment: import(".").IntegrationPayment;
@@ -145,8 +144,6 @@ export type { RedeemRefund, RedeemRefundParams, RedeemRefundResponse } from './a
 export type { GetRefundPlan, GetRefundPlanParams, GetRefundPlanResponse, RefundPlanSource, } from './actions/get-refund-plan/types';
 export type { CheckPermission, CheckPermissionParams, CheckPermissionResponse, } from './actions/check-permission/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';
@@ -173,7 +170,6 @@ export type { CashPayment, CashPaymentParams, CashPaymentResponse } from './acti
 export type { GetCashRoundingAmount, GetCashRoundingAmountParams, GetCashRoundingAmountResponse, } from './actions/get-cash-rounding-amount/types';
 export type { TapToPayPayment, TapToPayPaymentParams, TapToPayPaymentResponse, } from './actions/tap-to-pay-payment/types';
 export type { TerminalPayment, TerminalPaymentParams, TerminalPaymentResponse } from './actions/terminal-payment/types';
-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, IntegrationEmvData, } from './actions/integration-payment/types';
@@ -226,10 +222,6 @@ export type { PostMessageRequest, PostMessageResponse } from './client';
 export { topics } from './pubsub/topics';
 export type { TopicDefinition, TopicEvent, TopicEventType, TopicSubscriptionCallback, TopicSubscription, HookCallback, HookOptions, HookRegistration, } from './pubsub/types';
 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';

package/dist/index.js

@@ -38,7 +38,6 @@ import { cashPayment } from './actions/cash-payment/action';
 import { getCashRoundingAmount } from './actions/get-cash-rounding-amount/action';
 import { tapToPayPayment } from './actions/tap-to-pay-payment/action';
 import { terminalPayment } from './actions/terminal-payment/action';
-import { vendaraPayment } from './actions/vendara-payment/action';
 import { extensionPayment } from './actions/extension-payment/action';
 import { redeemPayment } from './actions/redeem-payment/action';
 import { integrationPayment } from './actions/integration-payment/action';
@@ -172,7 +171,6 @@ export const command = {
     getCashRoundingAmount,
     tapToPayPayment,
     terminalPayment,
-    vendaraPayment,
     extensionPayment,
     redeemPayment,
     integrationPayment,
@@ -277,10 +275,6 @@ export * from './projects/manage';
 export { commandFrameClient, CommandFrameClient } from './client';
 // Export Pub/Sub
 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';

package/dist/projects/render/mocks.js

@@ -44,8 +44,6 @@ 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';
@@ -63,7 +61,6 @@ import { mockShowNotification } from '../../actions/show-notification/mock';
 import { mockSwitchUser } from '../../actions/switch-user/mock';
 import { mockTapToPayPayment } from '../../actions/tap-to-pay-payment/mock';
 import { mockTerminalPayment } from '../../actions/terminal-payment/mock';
-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';
@@ -141,8 +138,6 @@ export const RENDER_MOCKS = {
     getRemainingRefundableQuantities: mockGetRemainingRefundableQuantities,
     goToStationHome: mockGoToStationHome,
     initiateRefund: mockInitiateRefund,
-    openExtensionOverlay: mockOpenExtensionOverlay,
-    resolveExtensionOverlay: mockResolveExtensionOverlay,
     openCashDrawer: mockOpenCashDrawer,
     parkOrder: mockParkOrder,
     partialPayment: mockPartialPayment,
@@ -161,7 +156,6 @@ export const RENDER_MOCKS = {
     switchUser: mockSwitchUser,
     tapToPayPayment: mockTapToPayPayment,
     terminalPayment: mockTerminalPayment,
-    vendaraPayment: mockVendaraPayment,
     extensionPayment: mockExtensionPayment,
     redeemPayment: mockRedeemPayment,
     integrationPayment: mockIntegrationPayment,

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

@@ -1,6 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, 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, VoidOrder, InitiateRefund, CashPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, 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, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms } from '../../index';
-import type { OpenExtensionOverlay } from '../../actions/open-extension-overlay/types';
-import type { ResolveExtensionOverlay } from '../../actions/resolve-extension-overlay/types';
+import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, 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, VoidOrder, InitiateRefund, CashPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, 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, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms } from '../../index';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -36,13 +34,10 @@ export interface RenderProviderActions {
     deleteParkedOrder: DeleteParkedOrder;
     voidOrder: VoidOrder;
     initiateRefund: InitiateRefund;
-    openExtensionOverlay: OpenExtensionOverlay;
-    resolveExtensionOverlay: ResolveExtensionOverlay;
     cashPayment: CashPayment;
     getCashRoundingAmount: GetCashRoundingAmount;
     tapToPayPayment: TapToPayPayment;
     terminalPayment: TerminalPayment;
-    vendaraPayment: VendaraPayment;
     extensionPayment: ExtensionPayment;
     redeemPayment: RedeemPayment;
     integrationPayment: IntegrationPayment;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.4.2-preprod.1",
+  "version": "0.5.0-preprod.2",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/actions/open-extension-overlay/action.d.ts

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

package/dist/actions/open-extension-overlay/action.js

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

package/dist/actions/open-extension-overlay/mock.d.ts

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

package/dist/actions/open-extension-overlay/mock.js

@@ -1 +0,0 @@
-export const mockOpenExtensionOverlay = async (_params) => true;

package/dist/actions/open-extension-overlay/types.d.ts

@@ -1,9 +0,0 @@
-import type { InterceptorPoint, InterceptorReturn } from "../../interceptors/types";
-export interface OpenExtensionOverlayParams {
-    point: InterceptorPoint;
-    payload?: any;
-    /** Owning extension id. Injected by the host for interceptor-originated calls; optional for direct calls. */
-    extensionId?: string;
-}
-export type OpenExtensionOverlayResponse = InterceptorReturn;
-export type OpenExtensionOverlay = (params: OpenExtensionOverlayParams) => Promise<OpenExtensionOverlayResponse>;

package/dist/actions/open-extension-overlay/types.js

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

package/dist/actions/resolve-extension-overlay/action.d.ts

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

package/dist/actions/resolve-extension-overlay/action.js

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

package/dist/actions/resolve-extension-overlay/mock.d.ts

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

package/dist/actions/resolve-extension-overlay/mock.js

@@ -1 +0,0 @@
-export const mockResolveExtensionOverlay = async (_params) => ({ success: true });

package/dist/actions/resolve-extension-overlay/types.d.ts

@@ -1,9 +0,0 @@
-import type { InterceptorReturn } from "../../interceptors/types";
-export interface ResolveExtensionOverlayParams {
-    overlayId: string;
-    result: InterceptorReturn;
-}
-export interface ResolveExtensionOverlayResponse {
-    success: boolean;
-}
-export type ResolveExtensionOverlay = (params: ResolveExtensionOverlayParams) => Promise<ResolveExtensionOverlayResponse>;

package/dist/actions/resolve-extension-overlay/types.js

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

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

@@ -1,6 +0,0 @@
-/**
- * Vendara payment action
- * Calls the vendaraPayment action on the parent window
- */
-import type { VendaraPayment } from "./types";
-export declare const vendaraPayment: VendaraPayment;

package/dist/actions/vendara-payment/action.js

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

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

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

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

@@ -1,11 +0,0 @@
-import { MOCK_ORDERS } from "../../demo/database";
-export const mockVendaraPayment = async (params) => {
-    console.log("[Mock] vendaraPayment called", params);
-    return {
-        success: true,
-        amount: params?.amount || null,
-        paymentType: "vendara",
-        order: MOCK_ORDERS[0],
-        timestamp: new Date().toISOString()
-    };
-};

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

@@ -1,26 +0,0 @@
-import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
-export interface VendaraPaymentParams {
-    /**
-     * The amount to pay with this tender, in integer MINOR currency units
-     * (e.g. 1575 = $15.75). Required. Semantics against the cart's balance due:
-     *   - missing            → error
-     *   - less than balance  → partial payment (the POS enters a fixed
-     *                          split-payment leg for this amount)
-     *   - equal to balance   → full payment
-     *   - more than balance  → error
-     */
-    amount: number;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
-    checkoutFulfillmentTarget?: string;
-}
-export interface VendaraPaymentResponse {
-    success: boolean;
-    amount: number | null;
-    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/actions/vendara-payment/types.js

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

package/dist/hooks/index.d.ts

@@ -1,17 +0,0 @@
-import type { HookFunction, HookRegisterOptions } from "./types";
-/**
- * Register a session-scoped hook. The callback is serialized and sent to the host (Render);
- * once registered, it runs in the host context even when the extension iframe is not on the current page.
- * The callback must be self-contained (only use event, hostCommands, callCommand).
- * Uses options.hookId as a stable dedup key: re-registering with the same hookId replaces the previous hook.
- */
-declare function register(topic: string, callback: HookFunction, options: HookRegisterOptions): string;
-/**
- * Unregister a hook by ID. Sends a message to the host to remove the hook.
- */
-declare function unregister(hookId: string): void;
-export declare const hooks: {
-    register: typeof register;
-    unregister: typeof unregister;
-};
-export type { HookFunction, HookRegisterOptions } from "./types";

package/dist/hooks/index.js

@@ -1,39 +0,0 @@
-const DEFAULT_ORIGIN = "*";
-function getOrigin() {
-    return typeof window !== "undefined" ? window.__COMMAND_FRAME_ORIGIN__ ?? DEFAULT_ORIGIN : DEFAULT_ORIGIN;
-}
-/**
- * Register a session-scoped hook. The callback is serialized and sent to the host (Render);
- * once registered, it runs in the host context even when the extension iframe is not on the current page.
- * The callback must be self-contained (only use event, hostCommands, callCommand).
- * Uses options.hookId as a stable dedup key: re-registering with the same hookId replaces the previous hook.
- */
-function register(topic, callback, options) {
-    const hookId = options.hookId;
-    const functionBody = callback.toString();
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({
-            type: "hook-register",
-            topic,
-            functionBody,
-            eventTypes: options.eventTypes,
-            hookId
-        }, getOrigin());
-    }
-    return hookId;
-}
-/**
- * Unregister a hook by ID. Sends a message to the host to remove the hook.
- */
-function unregister(hookId) {
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({
-            type: "hook-unregister",
-            hookId
-        }, getOrigin());
-    }
-}
-export const hooks = {
-    register,
-    unregister
-};

package/dist/hooks/types.d.ts

@@ -1,15 +0,0 @@
-import type { TopicEvent } from "../pubsub/types";
-/**
- * Function signature for extension hook callbacks.
- * The function is serialized and sent to the host; it receives event and hostCommands when executed.
- */
-export type HookFunction = (event: TopicEvent, hostCommands: Record<string, (params?: any) => Promise<any>>, callCommand: (action: string, params?: any) => Promise<any>) => void | Promise<void>;
-/**
- * Options when registering a hook from the extension iframe.
- */
-export interface HookRegisterOptions {
-    /** Stable identifier for this hook. Used to deduplicate on reload. Must be unique per hook. */
-    hookId: string;
-    /** Only fire for these event types; omit to receive all events for the topic */
-    eventTypes?: string[];
-}

package/dist/hooks/types.js

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

package/dist/interceptors/index.d.ts

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

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

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

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