@final-commerce/command-frame 0.1.11 → 0.1.13

package/README.md

@@ -31,7 +31,6 @@ The library provides a `command` namespace object containing all available comma
 - **[getCustomers](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-customers/README.md)** - Retrieve a list of customers from the parent application
 - **[getProducts](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-products/README.md)** - Retrieve a list of products from the parent application
 - **[getCategories](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-categories/README.md)** - Retrieve a list of categories from the parent application
-- **[getProductVariants](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-product-variants/README.md)** - Retrieve all variants for a specific product
 - **[getOrders](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-orders/README.md)** - Retrieve a list of orders from the system with optional filtering, sorting, and pagination
 - **[getCurrentCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-current-cart/README.md)** - Retrieve the current cart object with all its contents
 - **[getContext](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-context/README.md)** - Get current environment/context information (user, company, device, station, outlet, build)
@@ -39,9 +38,9 @@ The library provides a `command` namespace object containing all available comma
 
 #### Product Actions
 - **[addProductToCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-to-cart/README.md)** - Add a product to the cart with optional discounts, fees, and notes
-- **[addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)** - Add a discount to a specific product in the cart (using `cartItemId`)
-- **[addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)** - Add a note to a specific product in the cart (using `cartItemId`)
-- **[addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)** - Add a fee to a specific product in the cart (using `cartItemId`)
+- **[addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)** - Add a discount to a specific product in the cart (using `internalId`)
+- **[addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)** - Add a note to a specific product in the cart (using `internalId`)
+- **[addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)** - Add a fee to a specific product in the cart (using `internalId`)
 - **[adjustInventory](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/adjust-inventory/README.md)** - Adjust inventory/stock level for a specific product variant
 
 #### Order Actions
@@ -68,18 +67,13 @@ The library provides a `command` namespace object containing all available comma
 
 #### System Actions
 - **[goToStationHome](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/go-to-station-home/README.md)** - Navigate to the station home page
-- **[goToPage](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/go-to-page/README.md)** - Navigate to a specific page
 - **[openCashDrawer](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/open-cash-drawer/README.md)** - Open the cash drawer
-- **[openPopup](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/open-popup/README.md)** - Open a popup/modal by ID
 - **[showNotification](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/show-notification/README.md)** - Show a notification message
-- **[toggleSlideOut](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/toggle-slide-out/README.md)** - Toggle a slide-out panel
 - **[showConfirmation](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/show-confirmation/README.md)** - Show a confirmation dialog
 - **[authenticateUser](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/authenticate-user/README.md)** - Trigger user authentication for specific roles
-- **[updateCustomerFacingDisplay](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/update-customer-facing-display/README.md)** - Update the customer-facing display to show a specific page
 - **[switchUser](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/switch-user/README.md)** - Switch the current user to a different user
 
 #### Refund Actions
-- **[getLineItemsByOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-line-items-by-order/README.md)** - Retrieve line items and custom sales from an order for refund purposes
 - **[selectAllRefundItems](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/select-all-refund-items/README.md)** - Select all remaining refundable items for a full refund
 - **[resetRefundDetails](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/reset-refund-details/README.md)** - Clear all refund selections
 - **[setRefundStockAction](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/set-refund-stock-action/README.md)** - Set stock handling option (restock/damage) for a refunded item
@@ -110,11 +104,6 @@ const customers = await command.getCustomers();
 // Get categories from parent window
 const categories = await command.getCategories();
 
-// Get variants for a product
-const variants = await command.getProductVariants({
-    productId: '691df9c6c478bada1fb23d31'
-});
-
 // Add product to cart with optional discounts and fees
 const addedProduct = await command.addProductToCart({
     variantId: '691df9c6c478bada1fb23d55',
@@ -129,7 +118,7 @@ const addedProduct = await command.addProductToCart({
 
 // Add a discount to the specific item just added (if you didn't add it during creation)
 await command.addProductDiscount({
-    cartItemId: addedProduct.internalId,
+    internalId: addedProduct.internalId,
     amount: 5,
     isPercent: true,
     label: 'Extra 5% Off'
@@ -176,10 +165,6 @@ Assigns an existing customer to the current active session/cart. The customer mu
 
 Retrieves a list of categories from the parent application's local database. Supports filtering by name, parent ID, and external ID.
 
-### [getProductVariants](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-product-variants/README.md)
-
-Retrieves all variants for a specific product from the parent application's local database. Useful for displaying variant options or selecting a specific variant.
-
 ### [getOrders](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-orders/README.md)
 
 Retrieves a list of orders from the system with optional filtering, sorting, and pagination. Supports filtering by status, customer ID, session ID, and text search.
@@ -198,7 +183,7 @@ Adds a product to the cart. Supports specifying quantity, applying discounts, fe
 
 ### [addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)
 
-Adds a discount to a specific product in the cart (identified by `cartItemId`). Supports both fixed amount and percentage discounts.
+Adds a discount to a specific product in the cart (identified by `internalId`). Supports both fixed amount and percentage discounts.
 
 ### [addCartDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-cart-discount/README.md)
 
@@ -212,11 +197,11 @@ Retrieves the current environment/context information from the parent applicatio
 
 ### [addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)
 
-Adds a note to a specific product in the cart (identified by `cartItemId`).
+Adds a note to a specific product in the cart (identified by `internalId`).
 
 ### [addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)
 
-Adds a fee to a specific product in the cart (identified by `cartItemId`). Supports both fixed amount and percentage-based fees.
+Adds a fee to a specific product in the cart (identified by `internalId`). Supports both fixed amount and percentage-based fees.
 
 ### [adjustInventory](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/adjust-inventory/README.md)
 
@@ -288,26 +273,14 @@ Removes the currently assigned customer from the cart.
 
 Navigates to the station home page.
 
-### [goToPage](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/go-to-page/README.md)
-
-Navigates to a specific page in the application by page ID.
-
 ### [openCashDrawer](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/open-cash-drawer/README.md)
 
 Opens the cash drawer (if connected to a compatible device).
 
-### [openPopup](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/open-popup/README.md)
-
-Opens a popup/modal by ID. If the popup is already open, calling this will close it (toggle behavior).
-
 ### [showNotification](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/show-notification/README.md)
 
 Shows a notification message to the user.
 
-### [toggleSlideOut](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/toggle-slide-out/README.md)
-
-Toggles (opens/closes) a slide-out panel by ID.
-
 ### [showConfirmation](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/show-confirmation/README.md)
 
 Shows a confirmation dialog to the user. The actual promise resolution (accept/decline) is handled by the parent application's handler system.
@@ -316,20 +289,12 @@ Shows a confirmation dialog to the user. The actual promise resolution (accept/d
 
 Triggers user authentication for specific roles. Shows an authentication dialog in the parent application.
 
-### [updateCustomerFacingDisplay](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/update-customer-facing-display/README.md)
-
-Updates the customer-facing display to show a specific page by page ID.
-
 ### [switchUser](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/switch-user/README.md)
 
 Switches the current user to a different user. Supports three modes: dialog (select from all users), role (select from users with specific roles), or specific (switch to a specific user).
 
 ### Refund Actions
 
-### [getLineItemsByOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-line-items-by-order/README.md)
-
-Retrieves line items and custom sales from an order, along with calculated remaining refundable quantities for each item.
-
 ### [selectAllRefundItems](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/select-all-refund-items/README.md)
 
 Selects all remaining refundable items (line items, custom sales, cart fees, and tips) for a full refund.
@@ -455,7 +420,6 @@ import type {
     GetCustomersParams, GetCustomersResponse, GetCustomers,
     GetProductsParams, GetProductsResponse, GetProducts,
     GetCategoriesParams, GetCategoriesResponse, GetCategories,
-    GetProductVariantsParams, GetProductVariantsResponse, GetProductVariants,
     GetOrdersParams, GetOrdersResponse, GetOrders,
     GetContext, GetContextResponse,
     GetFinalContext, GetFinalContextResponse,
@@ -488,17 +452,12 @@ import type {
     RemoveCustomerFromCartResponse, RemoveCustomerFromCart,
     // System Actions
     GoToStationHomeResponse, GoToStationHome,
-    GoToPageParams, GoToPageResponse, GoToPage,
     OpenCashDrawerResponse, OpenCashDrawer,
-    OpenPopupParams, OpenPopupResponse, OpenPopup,
     ShowNotificationParams, ShowNotificationResponse, ShowNotification,
-    ToggleSlideOutParams, ToggleSlideOutResponse, ToggleSlideOut,
     ShowConfirmationParams, ShowConfirmationResponse, ShowConfirmation,
     AuthenticateUserParams, AuthenticateUserResponse, AuthenticateUser,
-    UpdateCustomerFacingDisplayParams, UpdateCustomerFacingDisplayResponse, UpdateCustomerFacingDisplay,
     SwitchUserParams, SwitchUserResponse, SwitchUser,
     // Refund Actions
-    GetLineItemsByOrderParams, GetLineItemsByOrderResponse, GetLineItemsByOrder,
     SelectAllRefundItemsParams, SelectAllRefundItemsResponse, SelectAllRefundItems,
     ResetRefundDetailsResponse, ResetRefundDetails,
     SetRefundStockActionParams, SetRefundStockActionResponse, SetRefundStockAction,

package/dist/actions/add-custom-sale/mock.js

@@ -1,14 +1,34 @@
+import { MOCK_CART } from "../../demo/database";
 export const mockAddCustomSale = async (params) => {
     console.log("[Mock] addCustomSale called", params);
     if (!params)
         throw new Error("Params required");
     // Simple mock ID generation
     const mockId = 'sale_' + Math.random().toString(36).substr(2, 9);
+    const price = Number(params.price);
+    const quantity = 1; // Default to 1 for custom sale usually
+    const customSale = {
+        id: mockId,
+        name: params.label,
+        price: price,
+        quantity: quantity,
+        applyTaxes: params.applyTaxes ?? false,
+        taxTableId: params.taxTableId
+    };
+    if (!MOCK_CART.customSales) {
+        MOCK_CART.customSales = [];
+    }
+    MOCK_CART.customSales.push(customSale);
+    // Update Cart Totals
+    MOCK_CART.subtotal += price * quantity;
+    MOCK_CART.total += price * quantity;
+    MOCK_CART.amountToBeCharged = MOCK_CART.total;
+    MOCK_CART.remainingBalance = MOCK_CART.total;
     return {
         success: true,
         customSaleId: mockId,
         label: params.label,
-        price: Number(params.price),
+        price: price,
         applyTaxes: params.applyTaxes ?? false,
         timestamp: new Date().toISOString()
     };

package/dist/actions/add-custom-sale/types.d.ts

@@ -2,6 +2,7 @@ export interface AddCustomSaleParams {
     label: string;
     price: number | string;
     applyTaxes?: boolean;
+    taxTableId?: string;
 }
 export interface AddCustomSaleResponse {
     success: boolean;

package/dist/actions/add-customer/mock.js

@@ -10,6 +10,7 @@ export const mockAddCustomer = async (params) => {
         updatedAt: new Date().toISOString()
     };
     MOCK_CUSTOMERS.push(newCustomer);
+    window.alert(`Demo: Customer Created!\nName: ${newCustomer.firstName} ${newCustomer.lastName}\nEmail: ${newCustomer.email}`);
     return {
         success: true,
         customer: newCustomer,

package/dist/actions/add-customer-note/mock.js

@@ -1,5 +1,18 @@
+import { MOCK_CUSTOMERS } from "../../demo/database";
 export const mockAddCustomerNote = async (params) => {
     console.log("[Mock] addCustomerNote called", params);
+    if (params?.customerId && params.note) {
+        const customer = MOCK_CUSTOMERS.find(c => c._id === params.customerId);
+        if (customer) {
+            if (!customer.notes) {
+                customer.notes = [];
+            }
+            customer.notes.push({
+                message: params.note,
+                createdAt: new Date().toISOString()
+            });
+        }
+    }
     return {
         success: true,
         customerId: params?.customerId || "",

package/dist/actions/add-order-note/mock.js

@@ -1,5 +1,15 @@
+import { MOCK_CART } from "../../demo/database";
 export const mockAddOrderNote = async (params) => {
     console.log("[Mock] addOrderNote called", params);
+    // In Render, AddOrderNote usually adds a note to the active cart if it's not checked out yet.
+    if (params?.note) {
+        if (MOCK_CART.orderNotes) {
+            MOCK_CART.orderNotes += "\n" + params.note;
+        }
+        else {
+            MOCK_CART.orderNotes = params.note;
+        }
+    }
     return {
         success: true,
         note: params?.note || "",

package/dist/actions/add-product-discount/mock.js

@@ -1,11 +1,30 @@
+import { MOCK_CART } from "../../demo/database";
 export const mockAddProductDiscount = async (params) => {
     console.log("[Mock] addProductDiscount called", params);
+    if (params && (params.amount > 0 || params.amount < 0)) { // Allow 0 to clear discount if logic permits
+        let item = null;
+        if (params.internalId) {
+            item = MOCK_CART.products.find(p => p.internalId === params.internalId);
+        }
+        else if (MOCK_CART.products.length > 0) {
+            item = MOCK_CART.products[MOCK_CART.products.length - 1];
+        }
+        if (item) {
+            item.discount = {
+                value: params.amount,
+                isPercent: params.isPercent || false,
+                label: params.label
+            };
+            // Recalculate cart totals (simplified)
+            // Ideally, this should trigger a full recalculation function
+        }
+    }
     return {
         success: true,
         amount: params?.amount || 0,
         isPercent: params?.isPercent || false,
         label: params?.label || "",
-        cartItemId: params?.cartItemId,
+        internalId: params?.internalId,
         timestamp: new Date().toISOString()
     };
 };

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

@@ -5,14 +5,15 @@ export interface AddProductDiscountParams {
     isPercent?: boolean;
     /** Defaults to "Discount". */
     label?: string;
-    cartItemId?: string;
+    /** The unique identifier for a specific line item in the cart. */
+    internalId?: string;
 }
 export interface AddProductDiscountResponse {
     success: boolean;
     amount: number;
     isPercent: boolean;
     label: string;
-    cartItemId?: string;
+    internalId?: string;
     timestamp: string;
 }
 export type AddProductDiscount = (params?: AddProductDiscountParams) => Promise<AddProductDiscountResponse>;

package/dist/actions/add-product-fee/mock.js

@@ -1,12 +1,30 @@
+import { MOCK_CART } from "../../demo/database";
 export const mockAddProductFee = async (params) => {
     console.log("[Mock] addProductFee called", params);
+    if (params) {
+        let item = null;
+        if (params.internalId) {
+            item = MOCK_CART.products.find(p => p.internalId === params.internalId);
+        }
+        else if (MOCK_CART.products.length > 0) {
+            item = MOCK_CART.products[MOCK_CART.products.length - 1];
+        }
+        if (item) {
+            item.fee = {
+                label: params.label || "Fee",
+                amount: params.amount,
+                isPercent: params.isPercent || false,
+                applyTaxes: params.applyTaxes || false
+            };
+        }
+    }
     return {
         success: true,
         amount: params?.amount || 0,
         isPercent: params?.isPercent || false,
         label: params?.label || "",
         applyTaxes: params?.applyTaxes || false,
-        cartItemId: params?.cartItemId,
+        internalId: params?.internalId,
         timestamp: new Date().toISOString()
     };
 };

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

@@ -7,7 +7,8 @@ export interface AddProductFeeParams {
     /** Defaults to `false`. */
     applyTaxes?: boolean;
     taxTableId?: string;
-    cartItemId?: string;
+    /** The unique identifier for a specific line item in the cart. */
+    internalId?: string;
 }
 export interface AddProductFeeResponse {
     success: boolean;
@@ -15,7 +16,7 @@ export interface AddProductFeeResponse {
     isPercent: boolean;
     label: string;
     applyTaxes: boolean;
-    cartItemId?: string;
+    internalId?: string;
     timestamp: string;
 }
 export type AddProductFee = (params?: AddProductFeeParams) => Promise<AddProductFeeResponse>;

package/dist/actions/add-product-note/mock.js

@@ -1,9 +1,20 @@
+import { MOCK_CART } from "../../demo/database";
 export const mockAddProductNote = async (params) => {
     console.log("[Mock] addProductNote called", params);
+    if (params?.note && params.internalId) {
+        const item = MOCK_CART.products.find(p => p.internalId === params.internalId);
+        if (item) {
+            item.note = params.note;
+        }
+    }
+    else if (params?.note && MOCK_CART.products.length > 0) {
+        // Fallback to last added item if no ID provided (common behavior in some POS flows)
+        MOCK_CART.products[MOCK_CART.products.length - 1].note = params.note;
+    }
     return {
         success: true,
         note: params?.note || "",
-        cartItemId: params?.cartItemId,
+        internalId: params?.internalId,
         timestamp: new Date().toISOString()
     };
 };

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

@@ -1,12 +1,12 @@
 export interface AddProductNoteParams {
     note: string;
-    /** The internalId of the cart item to modify. If not provided, it may attempt to modify the active product context. */
-    cartItemId?: string;
+    /** The unique identifier for a specific line item in the cart. If not provided, it may attempt to modify the active product context. */
+    internalId?: string;
 }
 export interface AddProductNoteResponse {
     success: boolean;
     note: string;
-    cartItemId?: string;
+    internalId?: string;
     timestamp: string;
 }
 export type AddProductNote = (params?: AddProductNoteParams) => Promise<AddProductNoteResponse>;

package/dist/actions/add-product-to-cart/types.d.ts

@@ -16,6 +16,7 @@ export interface AddProductToCartResponse {
     success: boolean;
     productId: string;
     variantId: string;
+    /** The unique identifier for the specific item instance added to the cart. */
     internalId: string;
     name: string;
     quantity: number;

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

@@ -1,13 +1,31 @@
+import { MOCK_PRODUCTS } from "../../demo/database";
 export const mockAdjustInventory = async (params) => {
     console.log("[Mock] adjustInventory called", params);
-    // Simulate updating inventory
-    let newStock = 100;
-    if (params?.stockType === 'add')
-        newStock += Number(params.amount);
-    if (params?.stockType === 'subtract')
-        newStock -= Number(params.amount);
-    if (params?.stockType === 'set')
-        newStock = Number(params.amount);
+    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;
+            }
+        }
+    }
     return {
         success: true,
         amount: params?.amount || "0",

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

@@ -4,6 +4,7 @@ export interface AdjustInventoryParams {
     /** 'add' (increase), 'subtract' (decrease), or 'set' (recount). */
     stockType: 'add' | 'subtract' | 'set';
     variantId?: string;
+    productId?: string;
 }
 export interface AdjustInventoryResponse {
     success: boolean;

package/dist/actions/assign-customer/mock.js

@@ -6,6 +6,7 @@ export const mockAssignCustomer = async (params) => {
         throw new Error("Customer not found in mock DB");
     }
     MOCK_CART.customer = customer;
+    window.alert(`Demo: Customer Assigned to Cart\nName: ${customer.firstName} ${customer.lastName}`);
     return {
         success: true,
         customer,

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

@@ -4,5 +4,9 @@
  */
 import { commandFrameClient } from "../../client";
 export const cashPayment = async (params) => {
-    return await commandFrameClient.call("cashPayment", params);
+    const finalParams = {
+        ...params,
+        openChangeCalculator: params?.openChangeCalculator ?? true
+    };
+    return await commandFrameClient.call("cashPayment", finalParams);
 };

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

@@ -1,12 +1,44 @@
-import { createOrderFromCart } from "../../demo/database";
+import { createOrderFromCart, MOCK_CART } from "../../demo/database";
 export const mockCashPayment = async (params) => {
     console.log("[Mock] cashPayment called", params);
-    const amount = params?.amount || 0;
+    // Default to true to match action behavior
+    const openChangeCalculator = params?.openChangeCalculator ?? true;
+    let amount = params?.amount || MOCK_CART.total;
+    if (openChangeCalculator) {
+        try {
+            const input = window.prompt(`Total Due: $${MOCK_CART.total.toFixed(2)}\nEnter amount tendered:`, amount.toString());
+            if (input === null) {
+                // User cancelled
+                return {
+                    success: false,
+                    amount: 0,
+                    openChangeCalculator,
+                    paymentType: "cash",
+                    order: null,
+                    timestamp: new Date().toISOString()
+                };
+            }
+            const tendered = parseFloat(input);
+            if (!isNaN(tendered)) {
+                amount = tendered;
+                const change = tendered - MOCK_CART.total;
+                if (change >= 0) {
+                    window.alert(`Change Due: $${change.toFixed(2)}`);
+                }
+                else {
+                    window.alert(`Warning: Tendered amount is less than total. Short by: $${Math.abs(change).toFixed(2)}`);
+                }
+            }
+        }
+        catch (e) {
+            console.warn("Could not open prompt/alert (possibly in non-interactive environment)", e);
+        }
+    }
     const order = createOrderFromCart("cash", amount, "cash");
     return {
         success: true,
         amount,
-        openChangeCalculator: params?.openChangeCalculator || false,
+        openChangeCalculator,
         paymentType: "cash",
         order,
         timestamp: new Date().toISOString()

package/dist/actions/delete-parked-order/mock.js

@@ -1,5 +1,12 @@
+import { MOCK_PARKED_ORDERS } from "../../demo/database";
 export const mockDeleteParkedOrder = async (params) => {
     console.log("[Mock] deleteParkedOrder called", params);
+    if (params?.orderId) {
+        const index = MOCK_PARKED_ORDERS.findIndex(o => o._id === params.orderId);
+        if (index !== -1) {
+            MOCK_PARKED_ORDERS.splice(index, 1);
+        }
+    }
     return {
         success: true,
         orderId: params?.orderId || "",

package/dist/actions/initiate-refund/mock.js

@@ -1,5 +1,6 @@
 export const mockInitiateRefund = async (params) => {
     console.log("[Mock] initiateRefund called", params);
+    window.alert(`Demo: Initiating Refund for Order: ${params?.orderId || "Current Active Order"}\n(Refund UI would open here)`);
     return {
         success: true,
         orderId: params?.orderId || "mock_order_id",

package/dist/actions/open-cash-drawer/mock.js

@@ -1,5 +1,6 @@
 export const mockOpenCashDrawer = async () => {
     console.log("[Mock] openCashDrawer called");
+    window.alert("Demo: *Click* Cash Drawer Opened!");
     return {
         success: true,
         timestamp: new Date().toISOString()

package/dist/actions/park-order/mock.js

@@ -1,9 +1,21 @@
-import { MOCK_ORDERS } from "../../demo/database";
+import { MOCK_PARKED_ORDERS, createOrderFromCart, MOCK_ORDERS } from "../../demo/database";
 export const mockParkOrder = async () => {
     console.log("[Mock] parkOrder called");
+    // Create a temporary order to capture cart state
+    // We use createOrderFromCart which resets the cart and pushes to MOCK_ORDERS
+    const tempOrder = createOrderFromCart("none", 0, "none");
+    // Modify to reflect parked status
+    tempOrder.status = "parked";
+    tempOrder.paymentMethods = []; // clear dummy payment
+    // Move from MOCK_ORDERS to MOCK_PARKED_ORDERS
+    const foundIndex = MOCK_ORDERS.findIndex(o => o._id === tempOrder._id);
+    if (foundIndex !== -1) {
+        MOCK_ORDERS.splice(foundIndex, 1);
+    }
+    MOCK_PARKED_ORDERS.push(tempOrder);
     return {
         success: true,
-        order: MOCK_ORDERS[0],
+        order: tempOrder,
         timestamp: new Date().toISOString()
     };
 };

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

@@ -4,5 +4,9 @@
  */
 import { commandFrameClient } from "../../client";
 export const partialPayment = async (params) => {
-    return await commandFrameClient.call("partialPayment", params);
+    const finalParams = {
+        ...params,
+        openUI: params?.openUI ?? true
+    };
+    return await commandFrameClient.call("partialPayment", finalParams);
 };

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

@@ -1,12 +1,17 @@
 import { MOCK_ORDERS } from "../../demo/database";
 export const mockPartialPayment = async (params) => {
     console.log("[Mock] partialPayment called", params);
+    const openUI = params?.openUI ?? true;
+    if (openUI) {
+        // Simulate UI opening
+        window.alert("Demo: Split Payment UI would open here.");
+    }
     return {
         success: true,
         amount: params?.amount,
         isPercent: params?.isPercent || false,
-        openUI: params?.openUI || false,
-        order: params?.openUI ? null : MOCK_ORDERS[0],
+        openUI,
+        order: openUI ? null : MOCK_ORDERS[0],
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/remove-customer-from-cart/mock.js

@@ -1,6 +1,7 @@
 import { MOCK_CART } from "../../demo/database";
 export const mockRemoveCustomerFromCart = async () => {
     console.log("[Mock] removeCustomerFromCart called");
+    // Actually remove the customer from the mock cart
     MOCK_CART.customer = null;
     return {
         success: true,