@final-commerce/command-frame 0.1.55 → 0.1.57

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 events), Customers (6), Orders (2), Payments (2), Products (2), Refunds (2), Print (3).
+- **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).
 
 ```typescript
 import { topics } from '@final-commerce/command-frame';
@@ -170,7 +170,3 @@ Alternatively, set the global flag before initialization:
 ```typescript
 (window as any).__POSTMESSAGE_DEBUG__ = true;
 ```
-
-## License
-
-MIT

package/dist/CommonTypes.d.ts

@@ -465,6 +465,39 @@ export interface CFActiveStation {
     updatedAt?: string;
     stripeTerminalId?: string;
 }
+/** Cash register session (station session), aligned with Render `Session`. */
+export interface CFSession {
+    id: string;
+    stationId: string;
+    openingAmount?: number;
+    closingAmount?: number;
+    openedBy?: string;
+    closedBy?: string;
+    notes?: string[];
+    currency?: CurrencyCode;
+    minorUnits?: number;
+}
+/** Refund UI / selection state in POS, aligned with Render `ActiveRefundOrder`. */
+export interface CFRefundProcessingStatus {
+    status: string;
+    isCardPresent?: boolean;
+    message?: string;
+}
+export interface CFActiveRefundDetails {
+    quantities?: Record<string, number>;
+    options?: Record<string, string>;
+    refundAmounts?: Record<string, number>;
+    refundPayments?: CFPaymentMethod[] | null;
+    currentRefundTotal?: number;
+    amountRemaining?: number | null;
+    buttonsDisabled?: Record<string, boolean>;
+    isRefund?: boolean;
+    customSalesQuantities?: Record<string, number>;
+    cartFeesRefunds?: Record<string, number>;
+    tipsRefunds?: Record<string, number>;
+    refundProcessingStatus?: CFRefundProcessingStatus | null;
+    sessionRefundedTotal?: number;
+}
 export interface CFActiveOrder extends CFOrder {
     id?: string;
     internalId?: string;

package/dist/actions/get-active-customer/action.d.ts

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

package/dist/actions/get-active-customer/action.js

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

package/dist/actions/get-active-customer/mock.d.ts

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

package/dist/actions/get-active-customer/mock.js

@@ -0,0 +1,10 @@
+import { MOCK_CUSTOMER_1 } from "../../demo/database";
+export const mockGetActiveCustomer = async () => {
+    console.log("[Mock] getActiveCustomer called");
+    const customer = { ...MOCK_CUSTOMER_1, id: MOCK_CUSTOMER_1._id };
+    return {
+        success: true,
+        customer,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-customer/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveCustomer } from "../../CommonTypes";
+export interface GetActiveCustomerResponse {
+    success: boolean;
+    customer: CFActiveCustomer | null;
+    timestamp: string;
+}
+export type GetActiveCustomer = () => Promise<GetActiveCustomerResponse>;

package/dist/actions/get-active-order/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Get active order action
+ * Calls the getActiveOrder action on the parent window
+ */
+import type { GetActiveOrder } from "./types";
+export declare const getActiveOrder: GetActiveOrder;

package/dist/actions/get-active-order/action.js

@@ -0,0 +1,8 @@
+/**
+ * Get active order action
+ * Calls the getActiveOrder action on the parent window
+ */
+import { commandFrameClient } from "../../client";
+export const getActiveOrder = async () => {
+    return await commandFrameClient.call("getActiveOrder");
+};

package/dist/actions/get-active-order/mock.d.ts

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

package/dist/actions/get-active-order/mock.js

@@ -0,0 +1,11 @@
+import { MOCK_ORDERS, safeSerialize } from "../../demo/database";
+export const mockGetActiveOrder = async () => {
+    console.log("[Mock] getActiveOrder called");
+    const orders = safeSerialize(MOCK_ORDERS);
+    const order = orders.length > 0 ? orders[0] : null;
+    return {
+        success: true,
+        order,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-order/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveOrder } from "../../CommonTypes";
+export interface GetActiveOrderResponse {
+    success: boolean;
+    order: CFActiveOrder | null;
+    timestamp: string;
+}
+export type GetActiveOrder = () => Promise<GetActiveOrderResponse>;

package/dist/actions/get-active-order/types.js

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

package/dist/actions/get-active-outlet/action.d.ts

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

package/dist/actions/get-active-outlet/action.js

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

package/dist/actions/get-active-outlet/mock.d.ts

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

package/dist/actions/get-active-outlet/mock.js

@@ -0,0 +1,9 @@
+import { MOCK_OUTLET_MAIN } from "../../demo/database";
+export const mockGetActiveOutlet = async () => {
+    console.log("[Mock] getActiveOutlet called");
+    return {
+        success: true,
+        outlet: MOCK_OUTLET_MAIN,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-outlet/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveOutlet } from "../../CommonTypes";
+export interface GetActiveOutletResponse {
+    success: boolean;
+    outlet: CFActiveOutlet | null;
+    timestamp: string;
+}
+export type GetActiveOutlet = () => Promise<GetActiveOutletResponse>;

package/dist/actions/get-active-outlet/types.js

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

package/dist/actions/get-active-refund/action.d.ts

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

package/dist/actions/get-active-refund/action.js

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

package/dist/actions/get-active-refund/mock.d.ts

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

package/dist/actions/get-active-refund/mock.js

@@ -0,0 +1,9 @@
+import { MOCK_ACTIVE_REFUND_DETAILS } from "../../demo/database";
+export const mockGetActiveRefund = async () => {
+    console.log("[Mock] getActiveRefund called");
+    return {
+        success: true,
+        refund: MOCK_ACTIVE_REFUND_DETAILS,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-refund/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveRefundDetails } from "../../CommonTypes";
+export interface GetActiveRefundResponse {
+    success: boolean;
+    refund: CFActiveRefundDetails | null;
+    timestamp: string;
+}
+export type GetActiveRefund = () => Promise<GetActiveRefundResponse>;

package/dist/actions/get-active-refund/types.js

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

package/dist/actions/get-active-session/action.d.ts

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

package/dist/actions/get-active-session/action.js

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

package/dist/actions/get-active-session/mock.d.ts

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

package/dist/actions/get-active-session/mock.js

@@ -0,0 +1,9 @@
+import { MOCK_SESSION } from "../../demo/database";
+export const mockGetActiveSession = async () => {
+    console.log("[Mock] getActiveSession called");
+    return {
+        success: true,
+        session: MOCK_SESSION,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-session/types.d.ts

@@ -0,0 +1,7 @@
+import { CFSession } from "../../CommonTypes";
+export interface GetActiveSessionResponse {
+    success: boolean;
+    session: CFSession | null;
+    timestamp: string;
+}
+export type GetActiveSession = () => Promise<GetActiveSessionResponse>;

package/dist/actions/get-active-session/types.js

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

package/dist/actions/get-active-station/action.d.ts

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

package/dist/actions/get-active-station/action.js

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

package/dist/actions/get-active-station/mock.d.ts

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

package/dist/actions/get-active-station/mock.js

@@ -0,0 +1,9 @@
+import { MOCK_STATION_1 } from "../../demo/database";
+export const mockGetActiveStation = async () => {
+    console.log("[Mock] getActiveStation called");
+    return {
+        success: true,
+        station: MOCK_STATION_1,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-station/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveStation } from "../../CommonTypes";
+export interface GetActiveStationResponse {
+    success: boolean;
+    station: CFActiveStation | null;
+    timestamp: string;
+}
+export type GetActiveStation = () => Promise<GetActiveStationResponse>;

package/dist/actions/get-active-station/types.js

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

package/dist/actions/get-active-user/action.d.ts

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

package/dist/actions/get-active-user/action.js

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

package/dist/actions/get-active-user/mock.d.ts

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

package/dist/actions/get-active-user/mock.js

@@ -0,0 +1,9 @@
+import { MOCK_USER_MARIO } from "../../demo/database";
+export const mockGetActiveUser = async () => {
+    console.log("[Mock] getActiveUser called");
+    return {
+        success: true,
+        user: MOCK_USER_MARIO,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-active-user/types.d.ts

@@ -0,0 +1,7 @@
+import { CFActiveUser } from "../../CommonTypes";
+export interface GetActiveUserResponse {
+    success: boolean;
+    user: CFActiveUser | null;
+    timestamp: string;
+}
+export type GetActiveUser = () => Promise<GetActiveUserResponse>;

package/dist/actions/get-active-user/types.js

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

package/dist/actions/set-active-customer/action.d.ts

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

package/dist/actions/set-active-customer/action.js

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

package/dist/actions/set-active-customer/mock.d.ts

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

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

@@ -0,0 +1,16 @@
+import { MOCK_CUSTOMERS } from "../../demo/database";
+export const mockSetActiveCustomer = async (params) => {
+    console.log("[Mock] setActiveCustomer called", params);
+    if (!params?.customerId) {
+        throw new Error("customerId is required");
+    }
+    const found = MOCK_CUSTOMERS.find(c => c._id === params.customerId);
+    if (!found) {
+        throw new Error(`Customer with ID ${params.customerId} not found`);
+    }
+    return {
+        success: true,
+        customer: { ...found, id: found._id },
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-customer/types.d.ts

@@ -0,0 +1,10 @@
+import { CFActiveCustomer } from "../../CommonTypes";
+export interface SetActiveCustomerParams {
+    customerId: string;
+}
+export interface SetActiveCustomerResponse {
+    success: boolean;
+    customer: CFActiveCustomer;
+    timestamp: string;
+}
+export type SetActiveCustomer = (params?: SetActiveCustomerParams) => Promise<SetActiveCustomerResponse>;

package/dist/actions/set-active-customer/types.js

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

package/dist/actions/set-active-outlet/action.d.ts

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

package/dist/actions/set-active-outlet/action.js

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

package/dist/actions/set-active-outlet/mock.d.ts

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

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

@@ -0,0 +1,16 @@
+import { MOCK_OUTLETS } from "../../demo/database";
+export const mockSetActiveOutlet = async (params) => {
+    console.log("[Mock] setActiveOutlet called", params);
+    if (!params?.outletId) {
+        throw new Error("outletId is required");
+    }
+    const found = MOCK_OUTLETS.find(o => o.id === params.outletId || o._id === params.outletId);
+    if (!found) {
+        throw new Error(`Outlet with ID ${params.outletId} not found`);
+    }
+    return {
+        success: true,
+        outlet: found,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-outlet/types.d.ts

@@ -0,0 +1,10 @@
+import { CFActiveOutlet } from "../../CommonTypes";
+export interface SetActiveOutletParams {
+    outletId: string;
+}
+export interface SetActiveOutletResponse {
+    success: boolean;
+    outlet: CFActiveOutlet;
+    timestamp: string;
+}
+export type SetActiveOutlet = (params?: SetActiveOutletParams) => Promise<SetActiveOutletResponse>;

package/dist/actions/set-active-outlet/types.js

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

package/dist/actions/set-active-refund/action.d.ts

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

package/dist/actions/set-active-refund/action.js

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

package/dist/actions/set-active-refund/mock.d.ts

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

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

@@ -0,0 +1,12 @@
+import { MOCK_ACTIVE_REFUND_DETAILS } from "../../demo/database";
+export const mockSetActiveRefund = async (params) => {
+    console.log("[Mock] setActiveRefund called", params);
+    if (!params?.orderId) {
+        throw new Error("orderId is required");
+    }
+    return {
+        success: true,
+        refund: { ...MOCK_ACTIVE_REFUND_DETAILS, isRefund: true },
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-refund/types.d.ts

@@ -0,0 +1,10 @@
+import { CFActiveRefundDetails } from "../../CommonTypes";
+export interface SetActiveRefundParams {
+    orderId: string;
+}
+export interface SetActiveRefundResponse {
+    success: boolean;
+    refund: CFActiveRefundDetails;
+    timestamp: string;
+}
+export type SetActiveRefund = (params?: SetActiveRefundParams) => Promise<SetActiveRefundResponse>;

package/dist/actions/set-active-refund/types.js

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

package/dist/actions/set-active-session/action.d.ts

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

package/dist/actions/set-active-session/action.js

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

package/dist/actions/set-active-session/mock.d.ts

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

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

@@ -0,0 +1,15 @@
+import { MOCK_SESSION } from "../../demo/database";
+export const mockSetActiveSession = async (params) => {
+    console.log("[Mock] setActiveSession called", params);
+    if (!params?.sessionId) {
+        throw new Error("sessionId is required");
+    }
+    if (params.sessionId !== MOCK_SESSION.id) {
+        throw new Error(`Session with ID ${params.sessionId} not found`);
+    }
+    return {
+        success: true,
+        session: MOCK_SESSION,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-session/types.d.ts

@@ -0,0 +1,10 @@
+import { CFSession } from "../../CommonTypes";
+export interface SetActiveSessionParams {
+    sessionId: string;
+}
+export interface SetActiveSessionResponse {
+    success: boolean;
+    session: CFSession;
+    timestamp: string;
+}
+export type SetActiveSession = (params?: SetActiveSessionParams) => Promise<SetActiveSessionResponse>;

package/dist/actions/set-active-session/types.js

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

package/dist/actions/set-active-station/action.d.ts

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

package/dist/actions/set-active-station/action.js

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

package/dist/actions/set-active-station/mock.d.ts

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

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

@@ -0,0 +1,16 @@
+import { MOCK_STATIONS } from "../../demo/database";
+export const mockSetActiveStation = async (params) => {
+    console.log("[Mock] setActiveStation called", params);
+    if (!params?.stationId) {
+        throw new Error("stationId is required");
+    }
+    const found = MOCK_STATIONS.find(s => s._id === params.stationId);
+    if (!found) {
+        throw new Error(`Station with ID ${params.stationId} not found`);
+    }
+    return {
+        success: true,
+        station: found,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-station/types.d.ts

@@ -0,0 +1,10 @@
+import { CFActiveStation } from "../../CommonTypes";
+export interface SetActiveStationParams {
+    stationId: string;
+}
+export interface SetActiveStationResponse {
+    success: boolean;
+    station: CFActiveStation;
+    timestamp: string;
+}
+export type SetActiveStation = (params?: SetActiveStationParams) => Promise<SetActiveStationResponse>;

package/dist/actions/set-active-station/types.js

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

package/dist/actions/set-active-user/action.d.ts

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

package/dist/actions/set-active-user/action.js

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

package/dist/actions/set-active-user/mock.d.ts

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

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

@@ -0,0 +1,16 @@
+import { MOCK_USERS } from "../../demo/database";
+export const mockSetActiveUser = async (params) => {
+    console.log("[Mock] setActiveUser called", params);
+    if (!params?.userId) {
+        throw new Error("userId is required");
+    }
+    const found = MOCK_USERS.find(u => u.id === params.userId);
+    if (!found) {
+        throw new Error(`User with ID ${params.userId} not found`);
+    }
+    return {
+        success: true,
+        user: found,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-active-user/types.d.ts

@@ -0,0 +1,10 @@
+import { CFActiveUser } from "../../CommonTypes";
+export interface SetActiveUserParams {
+    userId: string;
+}
+export interface SetActiveUserResponse {
+    success: boolean;
+    user: CFActiveUser;
+    timestamp: string;
+}
+export type SetActiveUser = (params?: SetActiveUserParams) => Promise<SetActiveUserResponse>;

package/dist/actions/set-active-user/types.js

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