@final-commerce/command-frame 0.1.48 → 0.1.50

package/dist/CommonTypes.d.ts

@@ -484,9 +484,10 @@ export interface CFActiveCustomSales {
     discount?: any;
     fee?: any;
 }
-/** Non-revenue cart line (e.g. gift card load) — aligned with Render NonRevenueItem */
+/** Non-revenue cart line (e.g. gift card load) — aligned with Render `NonRevenueItem.externalId` (order line id). */
 export interface CFNonRevenueItem {
-    id: string;
+    /** Unique cart/order line id (Mongo-style id from host). Extension reference is usually `metadata.refId`. */
+    externalId: string;
     amount: number | string;
     label?: string;
     metadata?: Record<string, unknown>;

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

@@ -12,7 +12,7 @@ export const mockAddNonRevenueItem = async (params) => {
         refId
     };
     const row = {
-        id: lineId,
+        externalId: lineId,
         amount,
         applyTaxes: params.applyTaxes === true,
         ...(params.taxTableId ? { taxTableId: params.taxTableId } : {}),
@@ -29,7 +29,7 @@ export const mockAddNonRevenueItem = async (params) => {
     MOCK_CART.subtotal = (MOCK_CART.subtotal ?? 0) + amount;
     return {
         success: true,
-        id: lineId,
+        externalId: lineId,
         refId,
         amount,
         label: params.label,

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

@@ -22,8 +22,8 @@ export interface AddNonRevenueItemParams {
 }
 export interface AddNonRevenueItemResponse {
     success: true;
-    /** Unique cart line id (use for remove / correlation) */
-    id: string;
+    /** Unique cart line id (same as `cart.nonRevenueItems[].externalId`; use for remove / correlation). */
+    externalId: string;
     /** Same as request `id` — extension reference */
     refId: string;
     amount: number;

package/dist/actions/get-outlets/mock.js

@@ -1,24 +1,16 @@
+import { MOCK_OUTLETS, safeSerialize } from "../../demo/database";
 export const mockGetOutlets = async () => {
     console.log("[Mock] getOutlets called");
+    const outlets = safeSerialize(MOCK_OUTLETS).map((o) => ({
+        _id: o._id || o.id,
+        name: o.name || "",
+        address: o.address,
+        city: o.city,
+        state: o.state,
+        country: o.country
+    }));
     return {
-        outlets: [
-            {
-                _id: "mock_outlet_001",
-                name: "Main Store",
-                address: "123 Commerce St",
-                city: "New York",
-                state: "NY",
-                country: "US",
-            },
-            {
-                _id: "mock_outlet_002",
-                name: "Downtown Branch",
-                address: "456 Market Ave",
-                city: "San Francisco",
-                state: "CA",
-                country: "US",
-            },
-        ],
-        timestamp: new Date().toISOString(),
+        outlets,
+        timestamp: new Date().toISOString()
     };
 };

package/dist/actions/get-stations/mock.js

@@ -1,20 +1,9 @@
-export const mockGetStations = async (params) => {
-    console.log("[Mock] getStations called", params);
+import { MOCK_STATIONS, safeSerialize } from "../../demo/database";
+export const mockGetStations = async (_params) => {
+    console.log("[Mock] getStations called", _params);
+    const stations = safeSerialize(MOCK_STATIONS);
     return {
-        stations: [
-            {
-                _id: "mock_station_001",
-                name: "POS Terminal 1",
-                status: "active",
-                sequenceNumber: 1,
-            },
-            {
-                _id: "mock_station_002",
-                name: "POS Terminal 2",
-                status: "active",
-                sequenceNumber: 2,
-            },
-        ],
-        timestamp: new Date().toISOString(),
+        stations,
+        timestamp: new Date().toISOString()
     };
 };

package/dist/demo/database.d.ts

@@ -3,7 +3,19 @@
  * Stores mock data that mimics the Render environment
  */
 import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory } from "../CommonTypes";
-export * from './mocks';
+export * from "./mocks";
+/** Replace mock catalog / context data in place (same array references mock handlers use). */
+export interface MockDatabaseConfig {
+    company?: Partial<CFActiveCompany>;
+    outlets?: CFActiveOutlet[];
+    stations?: CFActiveStation[];
+    users?: CFActiveUser[];
+    customers?: CFCustomer[];
+    categories?: CFCategory[];
+    products?: CFProduct[];
+    orders?: CFActiveOrder[];
+    parkedOrders?: CFActiveOrder[];
+}
 export declare const MOCK_COMPANY: CFActiveCompany;
 export declare const MOCK_OUTLET_MAIN: CFActiveOutlet;
 export declare const MOCK_STATION_1: CFActiveStation;
@@ -44,11 +56,16 @@ export declare const MOCK_CATEGORIES: CFCategory[];
 export declare const MOCK_PRODUCTS: CFProduct[];
 export declare const MOCK_ORDERS: CFActiveOrder[];
 export declare const MOCK_PARKED_ORDERS: CFActiveOrder[];
-export declare const MOCK_USER: CFActiveUser;
-export declare const MOCK_STATION: CFActiveStation;
-export declare const MOCK_OUTLET: CFActiveOutlet;
+export declare let MOCK_USER: CFActiveUser;
+export declare let MOCK_STATION: CFActiveStation;
+export declare let MOCK_OUTLET: CFActiveOutlet;
 export declare let MOCK_CART: CFActiveCart;
 export declare const resetMockCart: () => void;
+/**
+ * Replace in-memory mock data used by default mock handlers. Arrays are mutated in place
+ * so existing imports from this module keep working.
+ */
+export declare function setMockDatabase(config: Partial<MockDatabaseConfig>): void;
 export declare const safeSerialize: <T>(data: T) => T;
 type MockEventCallback = (event: any) => void;
 export declare const mockPublishEvent: (topic: string, eventType: string, data: any) => void;

package/dist/demo/database.js

@@ -3,7 +3,7 @@
  * Stores mock data that mimics the Render environment
  */
 import { CFProductType, CFUserTypes, CurrencyCode, } from "../CommonTypes";
-export * from './mocks';
+export * from "./mocks";
 // Asset Imports - Using Remote URLs to avoid build complexity with asset copying
 const ASSETS_BASE_URL = "https://raw.githubusercontent.com/Final-Commerce/command-frame/refs/heads/main/src/demo/assets";
 const logo = `${ASSETS_BASE_URL}/logo.png`;
@@ -31,7 +31,6 @@ export const MOCK_COMPANY = {
         decimals: { $numberInt: "2" }
     }
 };
-const COMPANY_ID = MOCK_COMPANY.id;
 // --- OUTLETS ---
 export const MOCK_OUTLET_MAIN = {
     id: "outlet_main",
@@ -74,7 +73,7 @@ export const MOCK_USER_MARIO = {
         permissions: []
     },
     outlets: [MOCK_OUTLET_MAIN.id],
-    companies: [COMPANY_ID]
+    companies: [MOCK_COMPANY.id]
 };
 export const MOCK_USER_LUIGI = {
     id: "user_luigi",
@@ -87,12 +86,12 @@ export const MOCK_USER_LUIGI = {
         permissions: []
     },
     outlets: [MOCK_OUTLET_MAIN.id],
-    companies: [COMPANY_ID]
+    companies: [MOCK_COMPANY.id]
 };
 // --- CUSTOMERS ---
 export const MOCK_CUSTOMER_1 = {
     _id: "cust_giuseppe",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     email: "giuseppe@example.com",
     firstName: "Giuseppe",
     lastName: "Verdi",
@@ -110,7 +109,7 @@ export const MOCK_CUSTOMER_1 = {
 };
 export const MOCK_CUSTOMER_2 = {
     _id: "cust_sofia",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     email: "sofia@example.com",
     firstName: "Sofia",
     lastName: "Loren",
@@ -120,7 +119,7 @@ export const MOCK_CUSTOMER_2 = {
 };
 export const MOCK_CUSTOMER_3 = {
     _id: "cust_alessandro",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     email: "alessandro@example.com",
     firstName: "Alessandro",
     lastName: "Volta",
@@ -130,7 +129,7 @@ export const MOCK_CUSTOMER_3 = {
 };
 export const MOCK_CUSTOMER_4 = {
     _id: "cust_isabella",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     email: "isabella@example.com",
     firstName: "Isabella",
     lastName: "Rossellini",
@@ -140,7 +139,7 @@ export const MOCK_CUSTOMER_4 = {
 };
 export const MOCK_CUSTOMER_5 = {
     _id: "cust_leonardo",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     email: "leonardo@example.com",
     firstName: "Leonardo",
     lastName: "Da Vinci",
@@ -153,35 +152,35 @@ export const MOCK_CATEGORY_PASTES = {
     _id: "cat_pastes",
     name: "Pastes",
     externalId: "ext_cat_pastes",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     parentId: null
 };
 export const MOCK_CATEGORY_SPECIALTY = {
     _id: "cat_specialty",
     name: "Specialty",
     externalId: "ext_cat_specialty",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     parentId: "cat_pastes"
 };
 export const MOCK_CATEGORY_BASIC = {
     _id: "cat_basic",
     name: "Basic",
     externalId: "ext_cat_basic",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     parentId: "cat_pastes"
 };
 export const MOCK_CATEGORY_VEGAN = {
     _id: "cat_vegan",
     name: "Vegan",
     externalId: "ext_cat_vegan",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     parentId: null
 };
 export const MOCK_CATEGORY_SPICY = {
     _id: "cat_spicy",
     name: "Spicy",
     externalId: "ext_cat_spicy",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     parentId: null
 };
 // --- PRODUCTS ---
@@ -192,7 +191,7 @@ const createSimpleProduct = (id, name, price, image, categories, description) =>
     return {
         _id: id,
         name,
-        companyId: COMPANY_ID,
+        companyId: MOCK_COMPANY.id,
         externalId: `ext_${id}`,
         sku,
         currency: CurrencyCode.USD,
@@ -227,7 +226,7 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
     return {
         _id: id,
         name,
-        companyId: COMPANY_ID,
+        companyId: MOCK_COMPANY.id,
         externalId: `ext_${id}`,
         sku: skuBase,
         currency: CurrencyCode.USD,
@@ -315,7 +314,7 @@ export const MOCK_ORDER_1 = {
     currency: CurrencyCode.USD,
     minorUnits: 2,
     receiptId: "1001-0001",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
     customer: MOCK_CUSTOMER_1,
@@ -365,7 +364,7 @@ export const MOCK_ORDER_2 = {
     currency: CurrencyCode.USD,
     minorUnits: 2,
     receiptId: "1001-0002",
-    companyId: COMPANY_ID,
+    companyId: MOCK_COMPANY.id,
     externalId: null,
     status: "completed",
     customer: MOCK_CUSTOMER_2,
@@ -445,10 +444,10 @@ export const MOCK_PRODUCTS = [
 ];
 export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2];
 export const MOCK_PARKED_ORDERS = [];
-// Compatibility Exports
-export const MOCK_USER = MOCK_USERS[0];
-export const MOCK_STATION = MOCK_STATIONS[0];
-export const MOCK_OUTLET = MOCK_OUTLETS[0];
+// Compatibility Exports (reassigned by setMockDatabase)
+export let MOCK_USER = MOCK_USERS[0];
+export let MOCK_STATION = MOCK_STATIONS[0];
+export let MOCK_OUTLET = MOCK_OUTLETS[0];
 export let MOCK_CART = {
     total: 0,
     subtotal: 0,
@@ -472,6 +471,62 @@ export const resetMockCart = () => {
         customer: null
     };
 };
+function resolveMockOrderCurrency() {
+    const raw = MOCK_COMPANY.settings?.currency;
+    if (typeof raw === "string" && Object.values(CurrencyCode).includes(raw)) {
+        return raw;
+    }
+    return CurrencyCode.USD;
+}
+/**
+ * Replace in-memory mock data used by default mock handlers. Arrays are mutated in place
+ * so existing imports from this module keep working.
+ */
+export function setMockDatabase(config) {
+    if (config.company !== undefined) {
+        Object.assign(MOCK_COMPANY, config.company);
+    }
+    if (config.outlets !== undefined) {
+        MOCK_OUTLETS.splice(0, MOCK_OUTLETS.length, ...config.outlets);
+    }
+    if (config.stations !== undefined) {
+        MOCK_STATIONS.splice(0, MOCK_STATIONS.length, ...config.stations);
+    }
+    if (config.users !== undefined) {
+        MOCK_USERS.splice(0, MOCK_USERS.length, ...config.users);
+    }
+    if (config.customers !== undefined) {
+        MOCK_CUSTOMERS.splice(0, MOCK_CUSTOMERS.length, ...config.customers);
+    }
+    if (config.categories !== undefined) {
+        MOCK_CATEGORIES.splice(0, MOCK_CATEGORIES.length, ...config.categories);
+    }
+    if (config.products !== undefined) {
+        MOCK_PRODUCTS.splice(0, MOCK_PRODUCTS.length, ...config.products);
+    }
+    if (config.orders !== undefined) {
+        MOCK_ORDERS.splice(0, MOCK_ORDERS.length, ...config.orders);
+    }
+    if (config.parkedOrders !== undefined) {
+        MOCK_PARKED_ORDERS.splice(0, MOCK_PARKED_ORDERS.length, ...config.parkedOrders);
+    }
+    if (MOCK_OUTLETS.length > 0) {
+        Object.assign(MOCK_OUTLET_MAIN, MOCK_OUTLETS[0]);
+        if (MOCK_OUTLET_MAIN.id === undefined && MOCK_OUTLET_MAIN._id !== undefined) {
+            MOCK_OUTLET_MAIN.id = MOCK_OUTLET_MAIN._id;
+        }
+    }
+    if (MOCK_USERS.length > 0) {
+        MOCK_USER = MOCK_USERS[0];
+    }
+    if (MOCK_STATIONS.length > 0) {
+        MOCK_STATION = MOCK_STATIONS[0];
+    }
+    if (MOCK_OUTLETS.length > 0) {
+        MOCK_OUTLET = MOCK_OUTLETS[0];
+    }
+    resetMockCart();
+}
 // Helper to simulate safe JSON serialization
 export const safeSerialize = (data) => {
     return JSON.parse(JSON.stringify(data));
@@ -502,6 +557,10 @@ export const mockSubscribeToTopic = (topic, callback) => {
 };
 // Helper to create order from cart
 export const createOrderFromCart = (paymentType, amount, processor = "cash") => {
+    const primaryOutlet = MOCK_OUTLETS[0] ?? MOCK_OUTLET_MAIN;
+    const primaryStation = MOCK_STATIONS[0] ?? MOCK_STATION;
+    const employeeUser = MOCK_USERS.find(u => u.type === CFUserTypes.CASHIER) ?? MOCK_USERS[0] ?? MOCK_USER;
+    const orderCurrency = resolveMockOrderCurrency();
     // Generate new Order ID
     const orderId = `order_${Date.now()}`;
     const receiptId = `receipt_${Date.now()}`;
@@ -531,10 +590,10 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
     const totalNum = MOCK_CART.total;
     const newOrder = {
         _id: orderId,
-        currency: CurrencyCode.USD,
+        currency: orderCurrency,
         minorUnits: 2,
         receiptId,
-        companyId: COMPANY_ID,
+        companyId: MOCK_COMPANY.id,
         externalId: null,
         status: "completed",
         customer: MOCK_CART.customer ? MOCK_CART.customer : null,
@@ -560,9 +619,9 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
         ],
         source: "pos",
         posData: {
-            outlet: MOCK_OUTLET_MAIN.id,
-            station: MOCK_STATION_1._id,
-            employee: MOCK_USER_LUIGI.id
+            outlet: primaryOutlet.id,
+            station: primaryStation._id,
+            employee: employeeUser.id
         },
         sessionId: `session_${Date.now()}`,
         metadata: [],
@@ -571,9 +630,9 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
         lineItems,
         customSales: [],
         balance: 0,
-        user: MOCK_USER_LUIGI,
-        outlet: MOCK_OUTLET_MAIN,
-        station: MOCK_STATION_1,
+        user: employeeUser,
+        outlet: primaryOutlet,
+        station: primaryStation,
         createdAt: new Date().toISOString()
     };
     MOCK_ORDERS.push(newOrder);

package/dist/index.d.ts

@@ -149,6 +149,8 @@ export type { SetActiveOrder, SetActiveOrderParams, SetActiveOrderResponse } fro
 export type { TriggerWebhook, TriggerWebhookPresetType, TriggerWebhookParams, TriggerWebhookResponse } from "./actions/trigger-webhook/types";
 export type { TriggerZapierWebhook, TriggerZapierWebhookParams, TriggerZapierWebhookResponse } from "./actions/trigger-zapier-webhook/types";
 export * from "./CommonTypes";
+export { setMockDatabase } from "./demo/database";
+export type { MockDatabaseConfig } from "./demo/database";
 export { CommandFrameProvider } from "./provider";
 export type { ActionHandler, ActionHandlers } from "./provider";
 export * from "./projects/render";

package/dist/index.js

@@ -189,6 +189,8 @@ export { EXTENSION_REFUND_REQUEST_ACTION } from "./actions/extension-refund/cons
 export { installExtensionRefundListener } from "./actions/extension-refund/extension-refund-listener";
 // Export Common Types
 export * from "./CommonTypes";
+// Mock database override (standalone / extension dev)
+export { setMockDatabase } from "./demo/database";
 // Export Provider
 export { CommandFrameProvider } from "./provider";
 // Export Render Project

package/dist/projects/manage/client.d.ts

@@ -8,6 +8,7 @@ export declare class ManageClient extends CommandFrameClient {
         origin?: string;
         debug?: boolean;
         mockMode?: boolean;
+        mockRegistry?: Partial<ManageProviderActions>;
     });
 }
 export declare const manageClient: ManageClient;

package/dist/projects/manage/client.js

@@ -2,9 +2,13 @@ import { CommandFrameClient } from "../../client";
 import { MANAGE_MOCKS } from "./mocks";
 export class ManageClient extends CommandFrameClient {
     constructor(options = {}) {
+        const { mockRegistry: mockRegistryOverrides, ...baseOptions } = options;
         super({
-            ...options,
-            mockRegistry: MANAGE_MOCKS
+            ...baseOptions,
+            mockRegistry: {
+                ...MANAGE_MOCKS,
+                ...mockRegistryOverrides
+            }
         });
     }
 }

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

@@ -8,6 +8,7 @@ export declare class RenderClient extends CommandFrameClient {
         origin?: string;
         debug?: boolean;
         mockMode?: boolean;
+        mockRegistry?: Partial<RenderProviderActions>;
     });
 }
 export declare const renderClient: RenderClient;

package/dist/projects/render/client.js

@@ -2,9 +2,13 @@ import { CommandFrameClient } from "../../client";
 import { RENDER_MOCKS } from "./mocks";
 export class RenderClient extends CommandFrameClient {
     constructor(options = {}) {
+        const { mockRegistry: mockRegistryOverrides, ...baseOptions } = options;
         super({
-            ...options,
-            mockRegistry: RENDER_MOCKS
+            ...baseOptions,
+            mockRegistry: {
+                ...RENDER_MOCKS,
+                ...mockRegistryOverrides
+            }
         });
     }
 }

package/package.json

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