@final-commerce/command-frame 0.1.57 → 0.1.59

package/README.md

@@ -75,7 +75,7 @@ const context = await client.getContext();
 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.
 
 - **[Pub/Sub Documentation](./src/pubsub/README.md)**
-- **Topics:** Cart (8), Customers (8), Orders (4), Payments (2), Products (4), Refunds (4), Print (3), Custom Tables (3), Outlet (2), Station (2), Session (2), Users (2).
+- **Topics:** Cart (9), Customers (8), Orders (4), Payments (2), Products (4), Refunds (4), Print (3), Custom Tables (3), Outlet (2), Station (2), Session (2), Users (2).
 
 ```typescript
 import { topics } from '@final-commerce/command-frame';
@@ -117,7 +117,7 @@ hooks.unregister('my-extension:cart-log');
 ### 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`).
+2. The helper validates `event.source === window.top`, 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`**.

package/dist/actions/set-active-product/mock.js

@@ -1,34 +1,47 @@
+import { MOCK_PRODUCTS, setMockActiveProduct } from "../../demo/database";
 export const mockSetActiveProduct = async (params) => {
     console.log("[Mock] setActiveProduct called", params);
     if (!params?.variantId) {
         throw new Error("Variant ID is required");
     }
-    // Mock product response
+    const { variantId } = params;
+    let matchedProduct;
+    let matchedVariant;
+    for (const product of MOCK_PRODUCTS) {
+        const variant = product.variants.find(v => v._id === variantId);
+        if (variant) {
+            matchedProduct = product;
+            matchedVariant = variant;
+            break;
+        }
+    }
+    const activeProduct = {
+        id: matchedProduct?._id || "mock_product",
+        internalId: `internal_${Date.now()}`,
+        externalId: matchedVariant?.externalId || "mock_external_id",
+        productExternalId: matchedProduct?.externalId || "mock_product_external_id",
+        variantId: matchedVariant?._id || variantId,
+        name: matchedProduct?.name || "Mock Product",
+        sku: matchedVariant?.sku || "mock_sku",
+        price: matchedVariant?.price || 100,
+        images: matchedVariant?.images || matchedProduct?.images || [],
+        taxTableId: matchedProduct?.taxTable || "mock_tax_table_id",
+        quantity: 1,
+        note: undefined,
+        discount: undefined,
+        description: matchedProduct?.description || "Mock Description",
+        barcodeId: matchedVariant?.barcode || "mock_barcode_id",
+        stock: matchedVariant?.inventory?.[0]?.stock ?? 100,
+        allowBackOrder: matchedVariant?.allowBackorder || false,
+        fee: undefined,
+        isUnlimited: !matchedVariant?.manageStock,
+        attributes: matchedVariant?.attributes?.map(a => a.value).join(", ") || "",
+        localQuantity: 1,
+    };
+    setMockActiveProduct(activeProduct);
     return {
         success: true,
-        product: {
-            id: "mock_product",
-            internalId: "mock_internal_id",
-            externalId: "mock_external_id",
-            productExternalId: "mock_product_external_id",
-            variantId: params.variantId,
-            name: "Mock Product",
-            sku: "mock_sku",
-            price: 100,
-            images: [],
-            taxTableId: "mock_tax_table_id",
-            quantity: 1,
-            note: "Mock Note",
-            discount: undefined,
-            description: "Mock Description",
-            barcodeId: "mock_barcode_id",
-            stock: 100,
-            allowBackOrder: false,
-            fee: undefined,
-            isUnlimited: false,
-            attributes: "Mock Attributes",
-            localQuantity: 1,
-        },
+        product: activeProduct,
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/set-active-product-discount/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set active product discount action
+ * Updates the discount on the currently active product (without adding to cart)
+ */
+import type { SetActiveProductDiscount } from "./types";
+export declare const setActiveProductDiscount: SetActiveProductDiscount;

package/dist/actions/set-active-product-discount/action.js

@@ -0,0 +1,8 @@
+/**
+ * Set active product discount action
+ * Updates the discount on the currently active product (without adding to cart)
+ */
+import { commandFrameClient } from "../../client";
+export const setActiveProductDiscount = async (params) => {
+    return await commandFrameClient.call("setActiveProductDiscount", params);
+};

package/dist/actions/set-active-product-discount/mock.d.ts

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

package/dist/actions/set-active-product-discount/mock.js

@@ -0,0 +1,20 @@
+import { MOCK_ACTIVE_PRODUCT, setMockActiveProduct } from "../../demo/database";
+export const mockSetActiveProductDiscount = async (params) => {
+    console.log("[Mock] setActiveProductDiscount called", params);
+    if (!MOCK_ACTIVE_PRODUCT) {
+        throw new Error("No active product. Call setActiveProduct first.");
+    }
+    const discount = {
+        value: params.amount,
+        isPercent: params.isPercent || false,
+        label: params.label || "Discount"
+    };
+    setMockActiveProduct({ ...MOCK_ACTIVE_PRODUCT, discount });
+    return {
+        success: true,
+        amount: params.amount,
+        isPercent: discount.isPercent,
+        label: discount.label,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-product-discount/types.d.ts

@@ -0,0 +1,16 @@
+export interface SetActiveProductDiscountParams {
+    /** The discount amount. If isPercent is true, this is a percentage. */
+    amount: number;
+    /** Defaults to `false`. */
+    isPercent?: boolean;
+    /** Defaults to "Discount". */
+    label?: string;
+}
+export interface SetActiveProductDiscountResponse {
+    success: boolean;
+    amount: number;
+    isPercent: boolean;
+    label: string;
+    timestamp: string;
+}
+export type SetActiveProductDiscount = (params: SetActiveProductDiscountParams) => Promise<SetActiveProductDiscountResponse>;

package/dist/actions/set-active-product-discount/types.js

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

package/dist/actions/set-active-product-fee/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set active product fee action
+ * Updates the fee on the currently active product (without adding to cart)
+ */
+import type { SetActiveProductFee } from "./types";
+export declare const setActiveProductFee: SetActiveProductFee;

package/dist/actions/set-active-product-fee/action.js

@@ -0,0 +1,8 @@
+/**
+ * Set active product fee action
+ * Updates the fee on the currently active product (without adding to cart)
+ */
+import { commandFrameClient } from "../../client";
+export const setActiveProductFee = async (params) => {
+    return await commandFrameClient.call("setActiveProductFee", params);
+};

package/dist/actions/set-active-product-fee/mock.d.ts

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

package/dist/actions/set-active-product-fee/mock.js

@@ -0,0 +1,22 @@
+import { MOCK_ACTIVE_PRODUCT, setMockActiveProduct } from "../../demo/database";
+export const mockSetActiveProductFee = async (params) => {
+    console.log("[Mock] setActiveProductFee called", params);
+    if (!MOCK_ACTIVE_PRODUCT) {
+        throw new Error("No active product. Call setActiveProduct first.");
+    }
+    const fee = {
+        label: params.label || "Fee",
+        amount: params.amount,
+        isPercent: params.isPercent || false,
+        applyTaxes: params.applyTaxes || false
+    };
+    setMockActiveProduct({ ...MOCK_ACTIVE_PRODUCT, fee });
+    return {
+        success: true,
+        amount: params.amount,
+        isPercent: fee.isPercent,
+        label: fee.label,
+        applyTaxes: fee.applyTaxes,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-product-fee/types.d.ts

@@ -0,0 +1,19 @@
+export interface SetActiveProductFeeParams {
+    amount: number;
+    /** Defaults to `false`. */
+    isPercent?: boolean;
+    /** Defaults to "Fee". */
+    label?: string;
+    /** Defaults to `false`. */
+    applyTaxes?: boolean;
+    taxTableId?: string;
+}
+export interface SetActiveProductFeeResponse {
+    success: boolean;
+    amount: number;
+    isPercent: boolean;
+    label: string;
+    applyTaxes: boolean;
+    timestamp: string;
+}
+export type SetActiveProductFee = (params: SetActiveProductFeeParams) => Promise<SetActiveProductFeeResponse>;

package/dist/actions/set-active-product-fee/types.js

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

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

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

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

@@ -2,6 +2,8 @@ import { CFOrder } from "../../CommonTypes";
 export interface TerminalPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
+    /** "Bluetooth" or "Cloud". Defaults to "Cloud". */
+    paymentType?: 'Bluetooth' | 'Cloud';
 }
 export interface TerminalPaymentResponse {
     success: boolean;

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export declare const command: {
     readonly getFinalContext: import("./actions/get-final-context/types").GetFinalContext;
     readonly addProductNote: import("./actions/add-product-note/types").AddProductNote;
     readonly addProductFee: import("./actions/add-product-fee/types").AddProductFee;
+    readonly setActiveProductFee: import("./actions/set-active-product-fee/types").SetActiveProductFee;
+    readonly setActiveProductDiscount: import("./actions/set-active-product-discount/types").SetActiveProductDiscount;
     readonly getActiveProduct: import("./actions/get-active-product/types").GetActiveProduct;
     readonly setActiveProduct: import("./actions/set-active-product/types").SetActiveProduct;
     readonly adjustInventory: import("./actions/adjust-inventory/types").AdjustInventory;
@@ -131,6 +133,8 @@ export type { GetContext, GetContextResponse, GetContextResponseManage, GetConte
 export type { GetFinalContext, GetFinalContextResponse } from "./actions/get-final-context/types";
 export type { AddProductNote, AddProductNoteParams, AddProductNoteResponse } from "./actions/add-product-note/types";
 export type { AddProductFee, AddProductFeeParams, AddProductFeeResponse } from "./actions/add-product-fee/types";
+export type { SetActiveProductFee, SetActiveProductFeeParams, SetActiveProductFeeResponse } from "./actions/set-active-product-fee/types";
+export type { SetActiveProductDiscount, SetActiveProductDiscountParams, SetActiveProductDiscountResponse } from "./actions/set-active-product-discount/types";
 export type { GetActiveProduct, GetActiveProductResponse } from "./actions/get-active-product/types";
 export type { SetActiveProduct, SetActiveProductParams, SetActiveProductResponse } from "./actions/set-active-product/types";
 export type { AdjustInventory, AdjustInventoryParams, AdjustInventoryResponse } from "./actions/adjust-inventory/types";

package/dist/index.js

@@ -19,6 +19,8 @@ import { updateCartItemQuantity } from "./actions/update-cart-item-quantity/acti
 // Product Actions
 import { addProductNote } from "./actions/add-product-note/action";
 import { addProductFee } from "./actions/add-product-fee/action";
+import { setActiveProductFee } from "./actions/set-active-product-fee/action";
+import { setActiveProductDiscount } from "./actions/set-active-product-discount/action";
 import { getActiveProduct } from "./actions/get-active-product/action";
 import { setActiveProduct } from "./actions/set-active-product/action";
 import { adjustInventory } from "./actions/adjust-inventory/action";
@@ -131,6 +133,8 @@ export const command = {
     // Product Actions
     addProductNote,
     addProductFee,
+    setActiveProductFee,
+    setActiveProductDiscount,
     getActiveProduct,
     setActiveProduct,
     adjustInventory,

package/dist/projects/render/mocks.js

@@ -7,6 +7,8 @@ import { mockEditCustomer } from "../../actions/edit-customer/mock";
 import { mockAddOrderNote } from "../../actions/add-order-note/mock";
 import { mockAddProductDiscount } from "../../actions/add-product-discount/mock";
 import { mockAddProductFee } from "../../actions/add-product-fee/mock";
+import { mockSetActiveProductFee } from "../../actions/set-active-product-fee/mock";
+import { mockSetActiveProductDiscount } from "../../actions/set-active-product-discount/mock";
 import { mockGetActiveProduct } from "../../actions/get-active-product/mock";
 import { mockSetActiveProduct } from "../../actions/set-active-product/mock";
 import { mockAddProductNote } from "../../actions/add-product-note/mock";
@@ -91,6 +93,8 @@ export const RENDER_MOCKS = {
     addOrderNote: mockAddOrderNote,
     addProductDiscount: mockAddProductDiscount,
     addProductFee: mockAddProductFee,
+    setActiveProductFee: mockSetActiveProductFee,
+    setActiveProductDiscount: mockSetActiveProductDiscount,
     getActiveProduct: mockGetActiveProduct,
     setActiveProduct: mockSetActiveProduct,
     addProductNote: mockAddProductNote,

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

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetActiveProduct, SetActiveProduct, 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, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, GetActiveRefund, SetActiveRefund } from "../../index";
+import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, 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, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, GetActiveRefund, SetActiveRefund } from "../../index";
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -19,6 +19,8 @@ export interface RenderProviderActions {
     getFinalContext: GetFinalContext;
     addProductNote: AddProductNote;
     addProductFee: AddProductFee;
+    setActiveProductFee: SetActiveProductFee;
+    setActiveProductDiscount: SetActiveProductDiscount;
     getActiveProduct: GetActiveProduct;
     setActiveProduct: SetActiveProduct;
     adjustInventory: AdjustInventory;

package/dist/pubsub/subscriber.js

@@ -13,7 +13,7 @@ export class TopicSubscriber {
         this.debug = options.debug ?? false;
         this.useGlobalDebug = options.debug === undefined;
         // Detect standalone mode (not inside any iframe)
-        if (typeof window !== 'undefined' && (!window.top || window.top === window)) {
+        if (typeof window !== "undefined" && (!window.top || window.top === window)) {
             this.mockMode = true;
             if (this.isDebugEnabled()) {
                 console.log("[TopicSubscriber] Mock Mode enabled (standalone mode detected)");

package/package.json

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