@final-commerce/command-frame 0.0.1 → 0.0.4

package/README.md

@@ -1,6 +1,6 @@
 # @final-commerce/command-frame
 
-A TypeScript library for communication between iframes and their parent windows using postMessage with type safety and error handling.
+A TypeScript library for communication between iframes and their parent windows using postMessage with type safety and error handling. test.
 
 ## Installation
 
@@ -31,7 +31,10 @@ The library provides a `command` namespace object containing all available actio
 - **[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)
+- **[getFinalContext](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-final-context/README.md)** - Get final context information (project name)
 
 #### Product Actions
 - **[setProductActive](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/set-product-active/README.md)** - Set a product variant as the active product
@@ -50,7 +53,6 @@ The library provides a `command` namespace object containing all available actio
 - **[parkOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/park-order/README.md)** - Park (save) the current order for later retrieval
 - **[resumeParkedOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/resume-parked-order/README.md)** - Resume a previously parked order
 - **[deleteParkedOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/delete-parked-order/README.md)** - Delete a parked order
-- **[reorderActiveOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/reorder-active-order/README.md)** - Reorder items from the currently active order into the cart
 - **[initiateRefund](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/initiate-refund/README.md)** - Open the refund UI for an order
 - **[cashPayment](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/cash-payment/README.md)** - Initiate a cash payment
 - **[tapToPayPayment](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/tap-to-pay-payment/README.md)** - Initiate a tap-to-pay payment
@@ -76,6 +78,15 @@ The library provides a `command` namespace object containing all available actio
 - **[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
+- **[calculateRefundTotal](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/calculate-refund-total/README.md)** - Calculate refund total based on current selections
+- **[processPartialRefund](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/process-partial-refund/README.md)** - Process a partial refund based on current selections
+- **[getRemainingRefundableQuantities](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-remaining-refundable-quantities/README.md)** - Get remaining refundable quantities for items in the active order
+
 #### Integration Actions
 - **[triggerWebhook](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/trigger-webhook/README.md)** - Trigger a webhook with the specified configuration
 - **[triggerZapierWebhook](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/trigger-zapier-webhook/README.md)** - Trigger a Zapier webhook with the current context data
@@ -163,6 +174,14 @@ Retrieves a list of categories from the parent application's local database. Sup
 
 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.
+
+### [getCurrentCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-current-cart/README.md)
+
+Retrieves the current cart object with all its contents including products, custom sales, discounts, fees, totals, and customer information.
+
 ### [addCustomSale](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-custom-sale/README.md)
 
 Adds a custom sale item to the cart in the parent window. Useful for adding non-product items like service fees, discounts, or custom charges.
@@ -227,10 +246,6 @@ Resumes a previously parked order by loading it back into the cart.
 
 Deletes a parked order from the system.
 
-### [reorderActiveOrder](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/reorder-active-order/README.md)
-
-Reorders the items from the currently active order into the cart. Products that are out of stock will not be added.
-
 ### [initiateRefund](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/initiate-refund/README.md)
 
 Opens the refund UI for the specified order or the currently active order.
@@ -307,6 +322,36 @@ Updates the customer-facing display to show a specific page by page ID.
 
 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.
+
+### [resetRefundDetails](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/reset-refund-details/README.md)
+
+Clears all refund selections (quantities, custom sales, cart fees, tips, and stock actions).
+
+### [setRefundStockAction](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/set-refund-stock-action/README.md)
+
+Sets the stock handling option for a refunded line item (restock or mark as damaged).
+
+### [calculateRefundTotal](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/calculate-refund-total/README.md)
+
+Calculates and returns a preview of the refund total based on current refund selections, without processing the refund.
+
+### [processPartialRefund](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/process-partial-refund/README.md)
+
+Processes a partial refund based on the current refund selections in the refund details state.
+
+### [getRemainingRefundableQuantities](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-remaining-refundable-quantities/README.md)
+
+Gets the remaining refundable quantities for all line items and custom sales in the active order.
+
 ### Integration Actions
 
 ### [triggerWebhook](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/trigger-webhook/README.md)
@@ -361,7 +406,10 @@ import type {
     GetProductsParams, GetProductsResponse, GetProducts,
     GetCategoriesParams, GetCategoriesResponse, GetCategories,
     GetProductVariantsParams, GetProductVariantsResponse, GetProductVariants,
+    GetOrdersParams, GetOrdersResponse, GetOrders,
     GetContext, GetContextResponse,
+    GetFinalContext, GetFinalContextResponse,
+    GetCurrentCart, GetCurrentCartResponse,
     // Product Actions
     SetProductActiveParams, SetProductActiveResponse, SetProductActive,
     AddProductDiscountParams, AddProductDiscountResponse, AddProductDiscount,
@@ -378,7 +426,6 @@ import type {
     ParkOrderResponse, ParkOrder,
     ResumeParkedOrderParams, ResumeParkedOrderResponse, ResumeParkedOrder,
     DeleteParkedOrderParams, DeleteParkedOrderResponse, DeleteParkedOrder,
-    ReorderActiveOrderResponse, ReorderActiveOrder,
     InitiateRefundParams, InitiateRefundResponse, InitiateRefund,
     CashPaymentParams, CashPaymentResponse, CashPayment,
     TapToPayPaymentParams, TapToPayPaymentResponse, TapToPayPayment,
@@ -401,6 +448,14 @@ import type {
     AuthenticateUserParams, AuthenticateUserResponse, AuthenticateUser,
     UpdateCustomerFacingDisplayParams, UpdateCustomerFacingDisplayResponse, UpdateCustomerFacingDisplay,
     SwitchUserParams, SwitchUserResponse, SwitchUser,
+    // Refund Actions
+    GetLineItemsByOrderParams, GetLineItemsByOrderResponse, GetLineItemsByOrder,
+    SelectAllRefundItemsResponse, SelectAllRefundItems,
+    ResetRefundDetailsResponse, ResetRefundDetails,
+    SetRefundStockActionParams, SetRefundStockActionResponse, SetRefundStockAction,
+    CalculateRefundTotalResponse, CalculateRefundTotal,
+    ProcessPartialRefundParams, ProcessPartialRefundResponse, ProcessPartialRefund,
+    GetRemainingRefundableQuantitiesResponse, GetRemainingRefundableQuantities,
     // Integration Actions
     TriggerWebhookParams, TriggerWebhookResponse, TriggerWebhook,
     TriggerZapierWebhookParams, TriggerZapierWebhookResponse, TriggerZapierWebhook,

package/dist/CommonTypes.d.ts

@@ -0,0 +1,469 @@
+export declare enum CFProductType {
+    SIMPLE = "simple",
+    VARIABLE = "variable"
+}
+export declare enum CFUserTypes {
+    OWNER = "owner",
+    ORG_USER = "organization_user",
+    ORG_OWNER = "organization_owner",
+    FINAL_USER = "final_user",
+    FINAL_OWNER = "final_owner",
+    EMPLOYEE = "employee",
+    SUPER_ADMIN = "super_admin",
+    MANAGER = "manager",
+    ADMIN = "admin",
+    ASSISTANT_MANAGER = "assistant",
+    CASHIER = "cashier",
+    RESELLER = "reseller"
+}
+export interface CFActiveEntity {
+}
+export interface CFDiscount {
+    value: number;
+    label?: string;
+    isPercent?: boolean;
+}
+export interface CFCustomFee {
+    label: string;
+    amount: number;
+    isPercent: boolean;
+    applyTaxes: boolean;
+    taxTableId?: string;
+}
+export interface CFAddress {
+    firstName: string;
+    lastName: string;
+    company?: string | null;
+    city: string;
+    postCode: string;
+    province?: string;
+    state?: string;
+    country?: string;
+    address1: string;
+    address2: string;
+}
+export interface CFMetadataItem {
+    key: string;
+    value: string;
+}
+export interface CFTax {
+    id: string;
+    name: string;
+    percentage: number;
+    amount: string;
+    taxTableName: string;
+    taxTableId: string;
+}
+export interface CFInventory {
+    warehouse: string;
+    outletId: string;
+    stock?: number | null;
+}
+export interface CFCustomerNote {
+    createdAt: string;
+    message: string;
+}
+export interface CFOrderNote {
+    externalId?: string;
+    author?: string;
+    note?: string;
+    customerNote?: boolean;
+    addedByUser?: string;
+    dateCreated?: string;
+}
+export interface CFCategory {
+    _id: string;
+    companyId: string;
+    externalId: string;
+    name: string;
+    parentId: null | string;
+    __v?: number;
+}
+export interface CFProductVariant {
+    sku: string;
+    price: string;
+    salePrice: string;
+    isOnSale: boolean;
+    barcode?: string;
+    costPrice?: string;
+    manageStock: boolean;
+    externalId: string;
+    inventory?: CFInventory[];
+    allowBackorder?: boolean;
+    images?: string[];
+    attributes: {
+        name: string;
+        value?: string;
+    }[];
+    metadata?: {
+        key: string;
+        value: string;
+    }[];
+    _id: string;
+}
+export interface CFProduct {
+    _id: string;
+    companyId?: string;
+    externalId: string;
+    taxTable: string;
+    name: string;
+    description?: string;
+    shortDescription?: string;
+    images?: string[];
+    categories: {
+        name: string;
+        externalId: string;
+    };
+    attributes: {
+        name: string;
+        values: string[];
+    }[];
+    tags?: string[];
+    supplier?: string;
+    sku?: string;
+    productType: CFProductType;
+    variants: CFProductVariant[];
+    minPrice?: string;
+    maxPrice?: string;
+    price?: string;
+    status?: string;
+    isDeleted?: boolean;
+}
+export interface CFActiveProduct extends CFActiveEntity {
+    id: string;
+    internalId: string;
+    externalId: string;
+    productExternalId: string;
+    variantId: string;
+    name: string;
+    sku: string;
+    price: number;
+    images: string[];
+    taxTableId: string;
+    quantity: number;
+    note?: string;
+    discount?: CFDiscount;
+    description?: string;
+    longDescription?: string;
+    shortDescription?: string;
+    barcodeId?: string;
+    stock: number;
+    allowBackOrder?: boolean;
+    fee?: CFCustomFee;
+    isUnlimited?: boolean;
+    attributes?: string;
+    localQuantity?: number;
+}
+export interface CFCustomer {
+    _id: string;
+    companyId: any;
+    externalId?: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    fromOliver?: boolean;
+    phone?: string;
+    tags?: string[];
+    metadata?: Record<string, string>[];
+    notes?: CFCustomerNote[];
+    billing: CFAddress | null;
+    shipping: CFAddress | null;
+}
+export interface CFActiveCustomer extends CFCustomer {
+    id?: string;
+}
+export interface CFTip {
+    amount: string;
+    percentage: number;
+}
+export interface CFSummary {
+    discountTotal: string;
+    shippingTotal?: string | null;
+    total: string;
+    totalTaxes: string;
+    subTotal: string;
+    taxes: CFTax[];
+    tip?: CFTip | null;
+    isTaxInclusive: boolean;
+}
+export interface CFCartDiscountItem {
+    label: string;
+    amount: string;
+    percentage: number;
+}
+export interface CFCartFeeItem {
+    id: string;
+    label: string;
+    amount: string;
+    percentage: number;
+    taxTableId?: string;
+    tax?: string;
+    taxName: string;
+}
+export interface CFTipPayment {
+    amount: string;
+    tipTo: string;
+    percentage: number;
+}
+export interface CFRefundedTipPayment {
+    amount: string;
+    percentage: number;
+    transactionId: string;
+    tipTo: string;
+}
+export interface CFPaymentMethod {
+    transactionId: string;
+    paymentType: string;
+    amount: string;
+    timestamp: string;
+    processor: string;
+    saleId?: string;
+    change?: string | null;
+    tip?: CFTipPayment | null;
+    cashRounding?: number;
+    emv?: string | null;
+}
+export interface CFPosDataItem {
+    outlet: string;
+    station: string;
+    employee: string | {
+        _id?: string;
+        firstName: string;
+        lastName: string;
+    };
+}
+export interface CFDiscountDetail {
+    percentage: number;
+    amount: string;
+}
+export interface CFFeeDetail {
+    percentage: number;
+    amount: string;
+    tax: string;
+    taxTableId: string;
+}
+export interface CFDiscountLineItem {
+    itemDiscount: CFDiscountDetail;
+    cartDiscount: CFDiscountDetail;
+}
+export interface CFFeeLineItem {
+    itemFee: CFFeeDetail;
+    cartFee?: CFFeeDetail;
+}
+export interface CFLineItem {
+    productId: string;
+    variantExternalId?: string;
+    productExternalId?: string;
+    internalId?: string;
+    name: string;
+    quantity: number;
+    price: string;
+    taxes: CFTax[];
+    discount: CFDiscountLineItem;
+    fee: CFFeeLineItem;
+    totalTax: string;
+    total: string;
+    metadata: CFMetadataItem[];
+    image: string;
+    sku: string;
+    stock: number;
+    note?: string;
+    description?: string;
+    variantId: string;
+    images?: string[];
+    attributes?: string;
+}
+export interface CFCustomSale {
+    customSaleId: string;
+    name: string;
+    price: string;
+    quantity: number;
+    applyTaxes: boolean;
+    total: string;
+    totalTax: string;
+    taxes: CFTax[];
+    discount: {
+        cartDiscount: CFDiscountDetail;
+    };
+    fee: {
+        cartFee: {
+            amount: string;
+            label: string;
+            percentage: number;
+            tax: string;
+            taxTableId: string;
+        };
+    };
+}
+export interface CFRefundedLineItem {
+    productId: string;
+    variantId: string;
+    variantExternalId?: string;
+    productExternalId?: string;
+    internalId?: string;
+    name: string;
+    quantity: number;
+    price: string;
+    taxes: CFTax[];
+    discount: CFDiscountLineItem;
+    totalTax: string;
+    total: string;
+    image: string;
+    sku: string;
+    note?: string;
+    description?: string;
+    images?: string[];
+    fee: CFFeeLineItem;
+}
+export interface CFRefundedCustomSale extends CFCustomSale {
+}
+export interface CFRefundItem {
+    lineItems: CFRefundedLineItem[];
+    customSales: CFRefundedCustomSale[];
+    cartFees: CFCartFeeItem[];
+    tips: CFRefundedTipPayment[];
+    refundedBy: string;
+    timestamp: string | undefined;
+    summary?: CFSummary;
+    refundPayment: CFPaymentMethod[];
+    balance?: string;
+    receiptId?: string;
+    currency?: string;
+}
+export interface CFOrder {
+    _id: string;
+    receiptId?: string;
+    companyId: string;
+    externalId: string | null;
+    status: string;
+    customer: Partial<CFActiveCustomer | null>;
+    customerNote?: string;
+    summary: CFSummary;
+    cartDiscount: CFCartDiscountItem | null;
+    cartFees: CFCartFeeItem[] | null;
+    updatedAt?: string;
+    createdAt?: string;
+    paymentMethods: CFPaymentMethod[];
+    source: string;
+    posData: CFPosDataItem | null;
+    sessionId: string;
+    metadata: CFMetadataItem[];
+    notes?: CFOrderNote[] | null;
+    billing: CFAddress | null;
+    shipping: CFAddress | null;
+    lineItems: CFLineItem[];
+    customSales: CFCustomSale[];
+    refund?: CFRefundItem[];
+    balance: string;
+    signature?: string | null;
+}
+export interface CFActiveUserRole {
+    id?: string;
+    name: string;
+    permissions: {
+        category: string;
+        label: string;
+        name: string;
+        value: boolean;
+    }[];
+}
+export interface CFActiveUser extends CFActiveEntity {
+    firstName?: string;
+    lastName?: string;
+    role: CFActiveUserRole;
+    id: string;
+    outlets?: string[];
+    type?: CFUserTypes;
+    companies?: any;
+}
+export interface CFActiveOutlet extends CFActiveEntity {
+    address: string;
+    address2: string;
+    city: string;
+    state: string;
+    country?: string;
+    taxId: string;
+    postCode?: string;
+    name?: string;
+    stripe?: {
+        locationId: string;
+    };
+    id: string;
+    sequenceNumber: number;
+    _id?: string;
+    stripeAccountId: string;
+}
+export interface CFActiveStation {
+    _id: string;
+    sequenceNumber?: number;
+    name: string;
+    status: string;
+    buildSrcId?: string;
+    buildVersion?: string;
+    publishBuildId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    stripeTerminalId?: string;
+}
+export interface CFActiveOrder extends CFOrder {
+    id?: string;
+    internalId?: string;
+    user?: CFActiveUser;
+    outlet?: CFActiveOutlet;
+    isDeleted?: boolean;
+    newOrder?: boolean;
+    currency?: string;
+    station?: CFActiveStation;
+}
+export interface CFActiveCustomSales {
+    id: string;
+    name: string;
+    applyTaxes: boolean;
+    taxTableId?: string;
+    quantity: number;
+    price: number;
+    discount?: any;
+    fee?: any;
+}
+export interface CFActiveCart extends CFActiveEntity {
+    tax?: number;
+    total: number;
+    subtotal: number;
+    discount?: CFDiscount;
+    customFee?: CFCustomFee[];
+    products: CFActiveProduct[];
+    customSales?: CFActiveCustomSales[];
+    remainingBalance?: number;
+    amountToBeCharged: number;
+    customer?: Partial<CFCustomer | null> | null;
+    orderNotes?: string;
+    cartTotal?: number;
+    orderTotal?: number;
+    orderId?: string;
+}
+export interface CFActiveCompany extends CFActiveEntity {
+    id?: string;
+    name?: string;
+    logo?: string;
+    settings?: any;
+}
+export interface CFContext {
+    userId: string | null;
+    companyId: string | null;
+    companyName: string | null;
+    deviceId: string | null;
+    stationId: string | null;
+    stationName: string | null;
+    outletId: string | null;
+    outletName: string | null;
+    buildId: string | null;
+    buildName: string | null;
+    buildVersion: string | null;
+    buildSourceId: string | null;
+    buildIsPremium: boolean;
+    user: Record<string, any> | null;
+    company: Omit<Record<string, any>, 'settings'> | null;
+    station: Record<string, any> | null;
+    outlet: Record<string, any> | null;
+    timestamp: string;
+}

package/dist/CommonTypes.js

@@ -0,0 +1,21 @@
+// Enums
+export var CFProductType;
+(function (CFProductType) {
+    CFProductType["SIMPLE"] = "simple";
+    CFProductType["VARIABLE"] = "variable";
+})(CFProductType || (CFProductType = {}));
+export var CFUserTypes;
+(function (CFUserTypes) {
+    CFUserTypes["OWNER"] = "owner";
+    CFUserTypes["ORG_USER"] = "organization_user";
+    CFUserTypes["ORG_OWNER"] = "organization_owner";
+    CFUserTypes["FINAL_USER"] = "final_user";
+    CFUserTypes["FINAL_OWNER"] = "final_owner";
+    CFUserTypes["EMPLOYEE"] = "employee";
+    CFUserTypes["SUPER_ADMIN"] = "super_admin";
+    CFUserTypes["MANAGER"] = "manager";
+    CFUserTypes["ADMIN"] = "admin";
+    CFUserTypes["ASSISTANT_MANAGER"] = "assistant";
+    CFUserTypes["CASHIER"] = "cashier";
+    CFUserTypes["RESELLER"] = "reseller";
+})(CFUserTypes || (CFUserTypes = {}));

package/dist/actions/add-cart-discount/mock.d.ts

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

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

@@ -0,0 +1,27 @@
+import { MOCK_CART } from "../../demo/database";
+export const mockAddCartDiscount = async (params) => {
+    console.log("[Mock] addCartDiscount called", params);
+    if (params) {
+        MOCK_CART.discount = {
+            value: params.amount,
+            isPercent: params.isPercent,
+            label: params.label
+        };
+        // Simple mock calc (not real logic)
+        if (params.isPercent) {
+            MOCK_CART.total = MOCK_CART.subtotal * (1 - params.amount / 100);
+        }
+        else {
+            MOCK_CART.total = MOCK_CART.subtotal - params.amount;
+        }
+        MOCK_CART.amountToBeCharged = MOCK_CART.total;
+        MOCK_CART.remainingBalance = MOCK_CART.total;
+    }
+    return {
+        success: true,
+        amount: params?.amount || 0,
+        isPercent: params?.isPercent || false,
+        label: params?.label || "",
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/add-cart-fee/mock.d.ts

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

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

@@ -0,0 +1,31 @@
+import { MOCK_CART } from "../../demo/database";
+export const mockAddCartFee = async (params) => {
+    console.log("[Mock] addCartFee called", params);
+    if (params) {
+        if (!MOCK_CART.customFee)
+            MOCK_CART.customFee = [];
+        MOCK_CART.customFee.push({
+            label: params.label || "Fee",
+            amount: params.amount,
+            isPercent: params.isPercent || false,
+            applyTaxes: params.applyTaxes || false,
+            taxTableId: params.taxTableId
+        });
+        // Simple calc
+        let feeAmount = params.amount;
+        if (params.isPercent) {
+            feeAmount = MOCK_CART.subtotal * (params.amount / 100);
+        }
+        MOCK_CART.total += feeAmount;
+        MOCK_CART.amountToBeCharged = MOCK_CART.total;
+        MOCK_CART.remainingBalance = MOCK_CART.total;
+    }
+    return {
+        success: true,
+        amount: params?.amount || 0,
+        isPercent: params?.isPercent || false,
+        label: params?.label || "",
+        applyTaxes: params?.applyTaxes || false,
+        timestamp: new Date().toISOString()
+    };
+};