@final-commerce/command-frame 0.1.42 → 0.1.44

package/README.md

@@ -13,6 +13,7 @@ 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) |
+| **Host → iframe refunds** | Render asks the extension to reverse redeem / gift-card payments before completing a POS refund | Parent `postMessage` + `requestId` (see below) |
 
 ## Installation
 
@@ -109,6 +110,39 @@ hooks.register('cart', async (event, hostCommands) => {
 hooks.unregister('my-extension:cart-log');
 ```
 
+## Host-initiated extension refunds (redeem / gift card)
+
+**Extensions that accept redeem / extension payments must implement a refund listener.** When staff refund an order paid with `paymentType: "redeem"`, Render (host) `postMessage`s into your iframe **before** it records the refund locally. If your app does not handle this message, redeem refunds will time out or fail.
+
+### What you should do
+
+1. **Recommended:** call **`installExtensionRefundListener`** once when your extension boots (e.g. next to your `RenderClient` setup). Pass an `async` handler that calls your provider (gift card API, wallet, etc.) and returns an **`ExtensionRefundResponse`** (`success`, optional `error`, optional `extensionTransactionId` for receipts / support).
+2. The helper validates `event.source === window.parent`, parses params, and replies with the same **`PostMessageResponse`** envelope as the rest of Command Frame (`requestId`, `success`, `data` / `error`).
+3. **Alternative:** implement a `window` `message` listener yourself using the same contract (action name: **`extensionRefundRequest`**, or import **`EXTENSION_REFUND_REQUEST_ACTION`** from this package).
+
+Exported APIs: `installExtensionRefundListener`, `EXTENSION_REFUND_REQUEST_ACTION`, types **`ExtensionRefundParams`** / **`ExtensionRefundResponse`**.
+
+```typescript
+import {
+    installExtensionRefundListener,
+    type ExtensionRefundParams,
+    type ExtensionRefundResponse
+} from '@final-commerce/command-frame';
+
+const unsubscribe = installExtensionRefundListener(async (params: ExtensionRefundParams): Promise<ExtensionRefundResponse> => {
+    // params.paymentType === "redeem", params.amount in major currency units, params.saleId, params.processor, etc.
+    const ok = await myGiftCardProvider.refund(params);
+    return ok
+        ? { success: true, extensionTransactionId: ok.providerRefundId }
+        : { success: false, error: 'Refund declined' };
+});
+
+// on teardown (optional)
+// unsubscribe();
+```
+
+**Full protocol, edge cases, and manual handling:** **[Extension refund documentation](./src/actions/extension-refund/README.md)**.
+
 ## Development & Testing
 
 ### Demo Mode / Mocking

package/dist/CommonTypes.d.ts

@@ -184,6 +184,8 @@ export interface CFSummary {
     taxes: CFTax[];
     tip?: CFTip | null;
     isTaxInclusive: boolean;
+    /** Portion of order total that is non-revenue (e.g. gift card load), same string money format as `total` */
+    nonRevenueTotal?: string;
 }
 export interface CFCartDiscountItem {
     label: string;
@@ -234,13 +236,14 @@ export interface CFPosDataItem {
 export interface CFDiscountDetail {
     percentage: number;
     amount: string;
-    const?: string;
+    label?: string;
 }
 export interface CFFeeDetail {
     percentage: number;
     amount: string;
     tax: string;
     taxTableId: string;
+    label?: string;
 }
 export interface CFDiscountLineItem {
     itemDiscount: CFDiscountDetail;
@@ -286,13 +289,7 @@ export interface CFCustomSale {
         cartDiscount: CFDiscountDetail;
     };
     fee: {
-        cartFee: {
-            amount: string;
-            label: string;
-            percentage: number;
-            tax: string;
-            taxTableId: string;
-        };
+        cartFee: CFFeeDetail;
     };
 }
 export interface CFRefundedLineItem {
@@ -353,6 +350,8 @@ export interface CFOrder {
     shipping: CFAddress | null;
     lineItems: CFLineItem[];
     customSales: CFCustomSale[];
+    /** Gift card / liability purchase lines (not product revenue) */
+    nonRevenueItems?: CFNonRevenueItem[];
     refund?: CFRefundItem[];
     balance: string;
     signature?: string | null;
@@ -438,6 +437,15 @@ export interface CFActiveCustomSales {
     discount?: any;
     fee?: any;
 }
+/** Non-revenue cart line (e.g. gift card load) — aligned with Render NonRevenueItem */
+export interface CFNonRevenueItem {
+    id: string;
+    amount: number | string;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    applyTaxes?: boolean;
+    taxTableId?: string;
+}
 export interface CFActiveCart extends CFActiveEntity {
     tax?: number;
     total: number;
@@ -446,6 +454,8 @@ export interface CFActiveCart extends CFActiveEntity {
     customFee?: CFCustomFee[];
     products: CFActiveProduct[];
     customSales?: CFActiveCustomSales[];
+    /** Gift card / liability lines — included in cart total */
+    nonRevenueItems?: CFNonRevenueItem[];
     remainingBalance?: number;
     amountToBeCharged: number;
     customer?: Partial<CFCustomer | null> | null;

package/dist/actions/add-non-revenue-item/action.d.ts

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

package/dist/actions/add-non-revenue-item/action.js

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

package/dist/actions/add-non-revenue-item/mock.d.ts

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

package/dist/actions/add-non-revenue-item/mock.js

@@ -0,0 +1,41 @@
+import { MOCK_CART } from "../../demo/database";
+export const mockAddNonRevenueItem = async (params) => {
+    console.log("[Mock] addNonRevenueItem called", params);
+    const amount = Number(params.amount);
+    if (!Number.isFinite(amount) || amount <= 0) {
+        throw new Error("amount must be a positive number");
+    }
+    const lineId = `nr-mock-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    const refId = params.id;
+    const metadata = {
+        ...(params.metadata ?? {}),
+        refId
+    };
+    const row = {
+        id: lineId,
+        amount,
+        applyTaxes: params.applyTaxes === true,
+        ...(params.taxTableId ? { taxTableId: params.taxTableId } : {}),
+        ...(params.label !== undefined ? { label: params.label } : {}),
+        metadata
+    };
+    if (!MOCK_CART.nonRevenueItems) {
+        MOCK_CART.nonRevenueItems = [];
+    }
+    MOCK_CART.nonRevenueItems.push(row);
+    MOCK_CART.total += amount;
+    MOCK_CART.amountToBeCharged = MOCK_CART.total;
+    MOCK_CART.remainingBalance = MOCK_CART.total;
+    MOCK_CART.subtotal = (MOCK_CART.subtotal ?? 0) + amount;
+    return {
+        success: true,
+        id: lineId,
+        refId,
+        amount,
+        label: params.label,
+        metadata,
+        ...(params.applyTaxes === true ? { applyTaxes: true } : {}),
+        ...(params.taxTableId ? { taxTableId: params.taxTableId } : {}),
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/add-non-revenue-item/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Add a non-revenue line to the host cart (e.g. gift card liability / load).
+ * Extensions send id, amount, and optional label/metadata; host sums into cart total.
+ */
+export interface AddNonRevenueItemParams {
+    /**
+     * Reference id from the extension (e.g. product/sku key). Stored in cart line metadata as refId.
+     * The cart uses a separate unique line id per add so multiple lines can share the same refId.
+     */
+    id: string;
+    /** Amount in major currency units (e.g. dollars), same as cart totals */
+    amount: number;
+    /** Short label for receipts/UI */
+    label?: string;
+    /** Extra fields (customTableId, cardCode, etc.) */
+    metadata?: Record<string, unknown>;
+    /**
+     * When true, line may be taxed (requires taxTableId when taxing is implemented). Default false — e.g. gift card load is typically not taxed.
+     */
+    applyTaxes?: boolean;
+    taxTableId?: string;
+}
+export interface AddNonRevenueItemResponse {
+    success: true;
+    /** Unique cart line id (use for remove / correlation) */
+    id: string;
+    /** Same as request `id` — extension reference */
+    refId: string;
+    amount: number;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    applyTaxes?: boolean;
+    taxTableId?: string;
+    timestamp: string;
+}
+export type AddNonRevenueItem = (params: AddNonRevenueItemParams) => Promise<AddNonRevenueItemResponse>;

package/dist/actions/add-non-revenue-item/types.js

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

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

@@ -0,0 +1,5 @@
+/**
+ * Generic extension payment — host handles wire action `extensionPayment` and routes by `paymentType`.
+ */
+import type { ExtensionPayment } from "./types";
+export declare const extensionPayment: ExtensionPayment;

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

@@ -0,0 +1,7 @@
+/**
+ * Generic extension payment — host handles wire action `extensionPayment` and routes by `paymentType`.
+ */
+import { commandFrameClient } from "../../client";
+export const extensionPayment = async (params) => {
+    return await commandFrameClient.call("extensionPayment", params);
+};

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

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

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

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

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

@@ -0,0 +1,19 @@
+import { CFOrder } from "../../CommonTypes";
+/** Params for extension-initiated payments; host routes by `paymentType`. */
+export interface ExtensionPaymentParams {
+    paymentType: string;
+    processor?: string;
+    amount?: number;
+    label?: string;
+    referenceId?: string;
+    extensionId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ExtensionPaymentResponse {
+    success: boolean;
+    amount: number | null;
+    paymentType: string;
+    order: CFOrder | null;
+    timestamp: string;
+}
+export type ExtensionPayment = (params?: ExtensionPaymentParams) => Promise<ExtensionPaymentResponse>;

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Host-initiated refund request for extension-controlled payments (e.g. redeem / gift card).
+ * The host (Render) postMessages the iframe; the extension performs the provider refund and replies.
+ */
+/**
+ * Parameters sent from host to extension for a refund.
+ *
+ * **`amount` uses major currency units** (e.g. dollars), consistent with the string amount
+ * passed through `sendRefundPaymentRequest` in Render (parsed with `parseFloat` / `+amount`).
+ */
+export interface ExtensionRefundParams {
+    /** e.g. `"redeem"` — matches order paymentMethods[].paymentType */
+    paymentType: string;
+    processor?: string;
+    /** Major currency units (same as refund flow amount string, not cents). */
+    amount: number;
+    /** Local sale transaction id (Mongo-style id from paymentMethods[].transactionId). */
+    saleId: string;
+    orderId?: string;
+    referenceId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Business result from the extension after attempting the refund.
+ * Transport success/failure uses {@link import("../../client").PostMessageResponse}.
+ */
+export interface ExtensionRefundResponse {
+    success: boolean;
+    error?: string;
+    /** Provider/extension reference for the refund transaction, stored in local DB paymentData when present. */
+    extensionTransactionId?: string;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * Host-initiated refund request for extension-controlled payments (e.g. redeem / gift card).
+ * The host (Render) postMessages the iframe; the extension performs the provider refund and replies.
+ */
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * Redeem payment — thin wrapper over {@link extensionPayment} with `paymentType: "redeem"`.
+ */
+import type { RedeemPayment } from "./types";
+export declare const redeemPayment: RedeemPayment;

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

@@ -0,0 +1,7 @@
+/**
+ * Redeem payment — thin wrapper over {@link extensionPayment} with `paymentType: "redeem"`.
+ */
+import { extensionPayment } from "../extension-payment/action";
+export const redeemPayment = async (params) => {
+    return extensionPayment({ ...params, paymentType: "redeem" });
+};

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

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

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

@@ -0,0 +1,4 @@
+import { mockExtensionPayment } from "../extension-payment/mock";
+export const mockRedeemPayment = async (params) => {
+    return mockExtensionPayment({ ...params, paymentType: "redeem" });
+};

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

@@ -0,0 +1,12 @@
+import type { ExtensionPaymentResponse } from "../extension-payment/types";
+/** Redeem (e.g. gift card) — always uses paymentType `"redeem"` on the wire. */
+export interface RedeemPaymentParams {
+    amount?: number;
+    processor?: string;
+    label?: string;
+    referenceId?: string;
+    extensionId?: string;
+    metadata?: Record<string, unknown>;
+}
+export type RedeemPaymentResponse = ExtensionPaymentResponse;
+export type RedeemPayment = (params?: RedeemPaymentParams) => Promise<RedeemPaymentResponse>;

package/dist/actions/redeem-payment/types.js

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

package/dist/demo/database.js

@@ -450,6 +450,7 @@ export let MOCK_CART = {
     remainingBalance: 0,
     products: [],
     customSales: [],
+    nonRevenueItems: [],
     customer: null
 };
 // Helper to reset cart
@@ -461,6 +462,7 @@ export const resetMockCart = () => {
         remainingBalance: 0,
         products: [],
         customSales: [],
+        nonRevenueItems: [],
         customer: null
     };
 };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export declare const command: {
     readonly generateAPIKey: import("./actions/generate-api-key/types").GenerateAPIKey;
     readonly getProducts: import("./actions/get-products/types").GetProducts;
     readonly addCustomSale: import("./actions/add-custom-sale/types").AddCustomSale;
+    readonly addNonRevenueItem: import("./actions/add-non-revenue-item/types").AddNonRevenueItem;
     readonly getCustomers: import("./actions/get-customers/types").GetCustomers;
     readonly assignCustomer: import("./actions/assign-customer/types").AssignCustomer;
     readonly addCustomer: import("./actions/add-customer/types").AddCustomer;
@@ -30,6 +31,8 @@ export declare const command: {
     readonly tapToPayPayment: import("./actions/tap-to-pay-payment/types").TapToPayPayment;
     readonly terminalPayment: import("./actions/terminal-payment/types").TerminalPayment;
     readonly vendaraPayment: import("./actions/vendara-payment/types").VendaraPayment;
+    readonly extensionPayment: import("./actions/extension-payment/types").ExtensionPayment;
+    readonly redeemPayment: import("./actions/redeem-payment/types").RedeemPayment;
     readonly addCustomerNote: import("./actions/add-customer-note/types").AddCustomerNote;
     readonly removeCustomerFromCart: import("./actions/remove-customer-from-cart/types").RemoveCustomerFromCart;
     readonly goToStationHome: import("./actions/go-to-station-home/types").GoToStationHome;
@@ -74,6 +77,7 @@ export type { ExampleFunction, ExampleFunctionParams, ExampleFunctionResponse }
 export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } from "./actions/generate-api-key/types";
 export type { GetProducts, GetProductsParams, GetProductsResponse } from "./actions/get-products/types";
 export type { AddCustomSale, AddCustomSaleParams, AddCustomSaleResponse } from "./actions/add-custom-sale/types";
+export type { AddNonRevenueItem, AddNonRevenueItemParams, AddNonRevenueItemResponse } from "./actions/add-non-revenue-item/types";
 export type { GetCustomers, GetCustomersParams, GetCustomersResponse } from "./actions/get-customers/types";
 export type { AssignCustomer, AssignCustomerParams, AssignCustomerResponse } from "./actions/assign-customer/types";
 export type { AddCustomer, AddCustomerParams, AddCustomerResponse } from "./actions/add-customer/types";
@@ -114,6 +118,11 @@ export type { CashPayment, CashPaymentParams, CashPaymentResponse } from "./acti
 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 { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/constants";
+export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
+export type { ExtensionRefundParams, ExtensionRefundResponse } from "./actions/extension-refund/types";
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse } from "./actions/add-customer-note/types";
 export type { RemoveCustomerFromCart, RemoveCustomerFromCartResponse } from "./actions/remove-customer-from-cart/types";
 export type { GoToStationHome, GoToStationHomeResponse } from "./actions/go-to-station-home/types";

package/dist/index.js

@@ -2,6 +2,7 @@
 import { exampleFunction } from "./actions/example-function/action";
 import { getProducts } from "./actions/get-products/action";
 import { addCustomSale } from "./actions/add-custom-sale/action";
+import { addNonRevenueItem } from "./actions/add-non-revenue-item/action";
 import { getCustomers } from "./actions/get-customers/action";
 import { assignCustomer } from "./actions/assign-customer/action";
 import { addCustomer } from "./actions/add-customer/action";
@@ -30,6 +31,8 @@ import { cashPayment } from "./actions/cash-payment/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";
 // Customer Actions
 import { addCustomerNote } from "./actions/add-customer-note/action";
 import { removeCustomerFromCart } from "./actions/remove-customer-from-cart/action";
@@ -86,6 +89,7 @@ export const command = {
     generateAPIKey,
     getProducts,
     addCustomSale,
+    addNonRevenueItem,
     getCustomers,
     assignCustomer,
     addCustomer,
@@ -115,6 +119,8 @@ export const command = {
     tapToPayPayment,
     terminalPayment,
     vendaraPayment,
+    extensionPayment,
+    redeemPayment,
     // Customer Actions
     addCustomerNote,
     removeCustomerFromCart,
@@ -165,6 +171,8 @@ export const command = {
     getSecretVal,
     setSecretVal,
 };
+export { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/constants";
+export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
 // Export Common Types
 export * from "./CommonTypes";
 // Export Provider

package/dist/projects/render/mocks.js

@@ -45,6 +45,9 @@ import { mockTerminalPayment } from "../../actions/terminal-payment/mock";
 import { mockTriggerWebhook } from "../../actions/trigger-webhook/mock";
 import { mockTriggerZapierWebhook } from "../../actions/trigger-zapier-webhook/mock";
 import { mockVendaraPayment } from "../../actions/vendara-payment/mock";
+import { mockExtensionPayment } from "../../actions/extension-payment/mock";
+import { mockRedeemPayment } from "../../actions/redeem-payment/mock";
+import { mockAddNonRevenueItem } from "../../actions/add-non-revenue-item/mock";
 import { mockGetFinalContext } from "../../actions/get-final-context/mock";
 import { mockPrint } from "../../actions/print/mock";
 import { mockSetActiveOrder } from "../../actions/set-active-order/mock";
@@ -109,6 +112,9 @@ export const RENDER_MOCKS = {
     triggerWebhook: mockTriggerWebhook,
     triggerZapierWebhook: mockTriggerZapierWebhook,
     vendaraPayment: mockVendaraPayment,
+    extensionPayment: mockExtensionPayment,
+    redeemPayment: mockRedeemPayment,
+    addNonRevenueItem: mockAddNonRevenueItem,
     getFinalContext: mockGetFinalContext,
     print: mockPrint,
     setActiveOrder: mockSetActiveOrder,

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

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, GetCategories, GetOrders, GetRefunds, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, AddCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles } from "../../index";
+import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, GetCategories, GetOrders, GetRefunds, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles } from "../../index";
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -30,6 +30,9 @@ export interface RenderProviderActions {
     tapToPayPayment: TapToPayPayment;
     terminalPayment: TerminalPayment;
     vendaraPayment: VendaraPayment;
+    extensionPayment: ExtensionPayment;
+    redeemPayment: RedeemPayment;
+    addNonRevenueItem: AddNonRevenueItem;
     addCustomerNote: AddCustomerNote;
     removeCustomerFromCart: RemoveCustomerFromCart;
     goToStationHome: GoToStationHome;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@final-commerce/command-frame",
-    "version": "0.1.42",
+    "version": "0.1.44",
     "description": "Commands Frame library",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -14,6 +14,8 @@
         "build": "tsc",
         "build:clean": "rm -rf dist && npm run build",
         "dev": "tsc --watch",
+        "test": "vitest",
+        "test:run": "vitest run",
         "prepublishOnly": "npm run build",
         "prepare": "npm run build",
         "format": "prettier --write .",
@@ -43,6 +45,7 @@
         "@typescript-eslint/eslint-plugin": "^8.48.0",
         "@typescript-eslint/parser": "^8.48.0",
         "prettier": "^3.7.1",
-        "typescript": "^5.0.0"
+        "typescript": "^5.0.0",
+        "vitest": "^3.0.5"
     }
 }