@final-commerce/command-frame 0.2.0-beta.1 → 0.3.0-beta.3

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

@@ -1,23 +1,32 @@
-import { MOCK_CUSTOMERS } from "../../demo/database";
+import { MOCK_CUSTOMERS, mockPublishEvent } from "../../demo/database";
+function generateNoteId() {
+    return `mock_note_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
 export const mockAddCustomerNote = (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({
-                _id: `mock_note_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`,
-                message: params.note,
-                createdAt: new Date().toISOString()
-            });
-        }
+    if (!params?.note) {
+        throw new Error("addCustomerNote: note is required");
     }
+    const target = params.customerId ? MOCK_CUSTOMERS.find(c => c._id === params.customerId) : MOCK_CUSTOMERS[0];
+    if (!target) {
+        throw new Error("addCustomerNote: no target customer (provide customerId or seed at least one mock customer)");
+    }
+    const noteId = generateNoteId();
+    const note = {
+        _id: noteId,
+        message: params.note,
+        createdAt: new Date().toISOString()
+    };
+    target.notes = [...(target.notes || []), note];
+    mockPublishEvent("customers", "customer-note-added", {
+        customer: target,
+        note
+    });
     return Promise.resolve({
         success: true,
-        customerId: params?.customerId || "",
-        note: params?.note || "",
+        customerId: target._id,
+        noteId,
+        note: params.note,
         timestamp: new Date().toISOString()
     });
 };

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

@@ -1,11 +1,12 @@
 export interface AddCustomerNoteParams {
-    customerId: string;
     note: string;
+    customerId?: string;
 }
 export interface AddCustomerNoteResponse {
     success: boolean;
     customerId: string;
+    noteId: string;
     note: string;
     timestamp: string;
 }
-export type AddCustomerNote = (params?: AddCustomerNoteParams) => Promise<AddCustomerNoteResponse>;
+export type AddCustomerNote = (params: AddCustomerNoteParams) => Promise<AddCustomerNoteResponse>;

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

@@ -1,15 +1,18 @@
 import { CFProductType, CurrencyCode } from "../../CommonTypes";
+// eslint-disable-next-line @typescript-eslint/require-await
 export const mockAddProduct = async (params) => {
     console.log("[Mock] addProduct called", params);
     const hasVariants = params.variants && params.variants.length > 0;
+    const productId = "mock_product_" + Date.now();
     return {
         product: {
-            _id: "mock_product_" + Date.now(),
+            _id: productId,
+            externalId: `ext_${productId}`,
             currency: CurrencyCode.USD,
             minorUnits: 2,
             name: params.name,
             description: params.description,
-            categories: params.categories || [],
+            categories: (params.categories || []).map((c) => ({ name: c, externalId: c })),
             taxTable: params.taxTable || "",
             images: params.images || [],
             status: params.status || "active",
@@ -20,16 +23,19 @@ export const mockAddProduct = async (params) => {
             maxPrice: params.price || 0,
             variants: hasVariants
                 ? params.variants.map((v, i) => ({ ...v, _id: `mock_variant_${Date.now()}_${i}` }))
-                : [{
+                : [
+                    {
                         _id: `mock_variant_${Date.now()}_0`,
+                        externalId: `ext_variant_${Date.now()}_0`,
                         sku: params.sku || "",
                         price: params.price || 0,
                         salePrice: 0,
                         isOnSale: false,
                         manageStock: params.manageStock || false,
-                        attributes: [],
-                    }],
+                        attributes: []
+                    }
+                ]
         },
-        timestamp: new Date().toISOString(),
+        timestamp: new Date().toISOString()
     };
 };

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

@@ -10,11 +10,11 @@ export const mockAddProductDiscount = async (params) => {
             item = MOCK_CART.products[MOCK_CART.products.length - 1];
         }
         if (item) {
-            item.discount = {
-                value: params.amount,
-                isPercent: params.isPercent || false,
-                label: params.label
-            };
+            item.discounts = [{
+                    value: params.amount,
+                    isPercent: params.isPercent || false,
+                    label: params.label
+                }];
             // Recalculate cart totals (simplified)
             // Ideally, this should trigger a full recalculation function
         }

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

@@ -10,12 +10,12 @@ export const mockAddProductFee = async (params) => {
             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
-            };
+            item.fees = [{
+                    label: params.label || "Fee",
+                    amount: params.amount,
+                    isPercent: params.isPercent || false,
+                    applyTaxes: params.applyTaxes || false
+                }];
         }
     }
     return {

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

@@ -1,12 +1,9 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface CashPaymentParams {
     /** If not provided, uses the cart total. */
     amount?: number;
     /** Defaults to false. */
     openChangeCalculator?: boolean;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
-    checkoutFulfillmentTarget?: string;
 }
 export interface CashPaymentResponse {
     success: boolean;
@@ -15,7 +12,5 @@ export interface CashPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type CashPayment = (params?: CashPaymentParams) => Promise<CashPaymentResponse>;

package/dist/actions/delete-parked-order/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface DeleteParkedOrderParams {
     orderId: string;
 }
@@ -6,7 +5,5 @@ export interface DeleteParkedOrderResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type DeleteParkedOrder = (params?: DeleteParkedOrderParams) => Promise<DeleteParkedOrderResponse>;

package/dist/actions/edit-product/mock.js

@@ -1,21 +1,23 @@
 import { CFProductType, CurrencyCode } from "../../CommonTypes";
+// eslint-disable-next-line @typescript-eslint/require-await
 export const mockEditProduct = async (params) => {
     console.log("[Mock] editProduct called", params);
     return {
         product: {
             _id: params.productId,
+            externalId: `ext_${params.productId}`,
             currency: CurrencyCode.USD,
             minorUnits: 2,
             name: params.changes.name || "Updated Product",
             description: params.changes.description,
-            categories: params.changes.categories || [],
+            categories: (params.changes.categories || []).map((c) => ({ name: c, externalId: c })),
             taxTable: params.changes.taxTable || "",
             images: params.changes.images || [],
             status: params.changes.status || "active",
             productType: CFProductType.SIMPLE,
             attributes: [],
-            variants: [],
+            variants: []
         },
-        timestamp: new Date().toISOString(),
+        timestamp: new Date().toISOString()
     };
 };

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

@@ -1,5 +1,4 @@
 import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
 /** Params for extension-initiated payments; host routes by `paymentType`. */
 export interface ExtensionPaymentParams {
     paymentType: string;
@@ -9,8 +8,10 @@ export interface ExtensionPaymentParams {
     referenceId?: string;
     extensionId?: string;
     metadata?: Record<string, unknown>;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
-    checkoutFulfillmentTarget?: string;
+    /** EMV tag string from an integration terminal; forwarded to the order PaymentMethod's `emv`. */
+    emvData?: string;
+    /** Processor fee for an integration payment; forwarded to the order PaymentMethod's `processorFee`. */
+    processorFee?: number;
 }
 export interface ExtensionPaymentResponse {
     success: boolean;
@@ -18,7 +19,5 @@ export interface ExtensionPaymentResponse {
     paymentType: string;
     order: CFOrder | null;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type ExtensionPayment = (params?: ExtensionPaymentParams) => Promise<ExtensionPaymentResponse>;

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

@@ -1,8 +1,8 @@
 import { MOCK_COMPANY, MOCK_OUTLET, MOCK_STATION, MOCK_USER } from "../../demo/database";
 // Mock for Render context (POS terminal)
-export const mockGetContext = async () => {
+export const mockGetContext = () => {
     console.log("[Mock] getContext called (Render)");
-    return {
+    return Promise.resolve({
         userId: MOCK_USER.id || null,
         companyId: MOCK_COMPANY.id || null,
         companyName: MOCK_COMPANY.name || null,
@@ -17,17 +17,23 @@ export const mockGetContext = async () => {
         buildSourceId: "mock_source_id",
         buildIsPremium: true,
         isOffline: false,
+        currency: "USD",
+        currencySymbol: "$",
+        currencyPrefix: "$",
+        currencySuffix: "",
+        thousandSeparator: ",",
+        decimalSeparator: ".",
         user: null,
         company: null,
         station: null,
         outlet: null,
         timestamp: new Date().toISOString()
-    };
+    });
 };
 // Mock for Manage context (Hub/BuilderHub)
-export const mockGetContextManage = async () => {
+export const mockGetContextManage = () => {
     console.log("[Mock] getContext called (Manage)");
-    return {
+    return Promise.resolve({
         user: {
             _id: MOCK_USER.id,
             id: MOCK_USER.id,
@@ -47,5 +53,5 @@ export const mockGetContextManage = async () => {
         extensionId: "mock_extension_id",
         outlets: [MOCK_OUTLET],
         timestamp: new Date().toISOString()
-    };
+    });
 };

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

@@ -13,15 +13,15 @@ export const mockGetProducts = async (params) => {
         // Handle categories filter: { $in: [...] } or direct string
         const catFilter = query.categories;
         if (typeof catFilter === 'string') {
-            products = products.filter(p => (p.categories || []).includes(catFilter));
+            products = products.filter(p => (p.categories || []).some(c => c.name === catFilter));
         }
         else if (typeof catFilter === 'object' && '$in' in catFilter) {
             const inList = catFilter.$in;
-            products = products.filter(p => (p.categories || []).some(c => inList.includes(c)));
+            products = products.filter(p => (p.categories || []).some(c => inList.includes(c.name)));
         }
         else if (typeof catFilter === 'object' && '$contains' in catFilter) {
             const containsVal = catFilter.$contains;
-            products = products.filter(p => (p.categories || []).includes(containsVal));
+            products = products.filter(p => (p.categories || []).some(c => c.name.includes(containsVal)));
         }
     }
     return {

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

@@ -4,61 +4,55 @@ export const mockGetRoles = async (params) => {
         roles: [
             {
                 id: "691df9c6c478bada1fb23d0b",
-                _id: "691df9c6c478bada1fb23d0b",
-                companyId: "691df9c4c478bada1fb23bff",
                 name: "Owner",
                 permissions: [
-                    { category: "hub_access", name: "taxes", value: true, subCategory: "store_management", permissionId: "664759347eefffe8aba84476" },
-                    { category: "hub_access", name: "general", value: true, subCategory: "store_management", permissionId: "6647591d7eefffe8aba84475" },
-                    { category: "hub_access", name: "reports", value: true, subCategory: "store_management", permissionId: "6645f719ee8498efff5c49bb" },
-                    { category: "hub_access", name: "products", value: true, subCategory: "store_management", permissionId: "6645f719f00dc43caaeffe2b" },
-                    { category: "hub_access", name: "users", value: true, subCategory: "store_management", permissionId: "6647555b7eefffe8aba84473" },
-                    { category: "hub_access", name: "outlets", value: true, subCategory: "store_management", permissionId: "664759047eefffe8aba84474" },
-                    { category: "hub_access", name: "builder", value: true, subCategory: "builder_access", permissionId: "664779827eefffe8aba84477" },
-                    { category: "hub_access", name: "global_blocks", value: true, subCategory: "builder_access", permissionId: "6645f719f00dc43caaeffe47" },
-                    { category: "hub_access", name: "images", value: true, subCategory: "builder_access", permissionId: "6645f719ee8498efff5c49dc" },
-                    { category: "hub_access", name: "transactions", value: true, subCategory: "payments_access", permissionId: "6645f719ee8498efff5c4a6b" },
-                    { category: "hub_access", name: "payouts", value: true, subCategory: "payments_access", permissionId: "66477add7eefffe8aba84478" },
-                    { category: "hub_access", name: "terminals", value: true, subCategory: "payments_access", permissionId: "6645f71998735e68b2c45740" },
-                    { category: "hub_access", name: "billing", value: true, subCategory: "payments_access", permissionId: "66bbb00572999149fdd57866" },
-                    { category: "station_access", name: "give_discounts", value: true, subCategory: "pos_actions", permissionId: "6723b146ae5f176f7539d8a6" },
-                    { category: "station_access", name: "issue_refunds", value: true, subCategory: "pos_actions", permissionId: "6645f719ee8498efff5c4ae4" },
-                    { category: "station_access", name: "delete_customers", value: true, subCategory: "pos_actions", permissionId: "6645f71998735e68b2c457df" },
-                    { category: "station_access", name: "version_control", value: true, subCategory: "station_setting", permissionId: "66e050160d69015fbff9758a" },
-                    { category: "station_access", name: "session_reports", value: true, subCategory: "station_home", permissionId: "6723b271ae5f176f7539d8a7" },
-                    { category: "station_access", name: "cash_drawer", value: true, subCategory: "station_home", permissionId: "6723b2aeae5f176f7539d8a8" },
-                    { category: "station_access", name: "station_setting", value: true, subCategory: "station_home", permissionId: "6723b2c5ae5f176f7539d8a9" },
-                    { category: "station_access", name: "station_transactions", value: true, subCategory: "station_home", permissionId: "677eb109d2607a0169fdf7d5" },
+                    { category: "hub_access", label: "taxes", name: "taxes", value: true },
+                    { category: "hub_access", label: "general", name: "general", value: true },
+                    { category: "hub_access", label: "reports", name: "reports", value: true },
+                    { category: "hub_access", label: "products", name: "products", value: true },
+                    { category: "hub_access", label: "users", name: "users", value: true },
+                    { category: "hub_access", label: "outlets", name: "outlets", value: true },
+                    { category: "hub_access", label: "builder", name: "builder", value: true },
+                    { category: "hub_access", label: "global_blocks", name: "global_blocks", value: true },
+                    { category: "hub_access", label: "images", name: "images", value: true },
+                    { category: "hub_access", label: "transactions", name: "transactions", value: true },
+                    { category: "hub_access", label: "payouts", name: "payouts", value: true },
+                    { category: "hub_access", label: "terminals", name: "terminals", value: true },
+                    { category: "hub_access", label: "billing", name: "billing", value: true },
+                    { category: "station_access", label: "give_discounts", name: "give_discounts", value: true },
+                    { category: "station_access", label: "issue_refunds", name: "issue_refunds", value: true },
+                    { category: "station_access", label: "delete_customers", name: "delete_customers", value: true },
+                    { category: "station_access", label: "version_control", name: "version_control", value: true },
+                    { category: "station_access", label: "session_reports", name: "session_reports", value: true },
+                    { category: "station_access", label: "cash_drawer", name: "cash_drawer", value: true },
+                    { category: "station_access", label: "station_setting", name: "station_setting", value: true },
+                    { category: "station_access", label: "station_transactions", name: "station_transactions", value: true },
                 ]
             },
             {
                 id: "691df9c6c478bada1fb23d0c",
-                _id: "691df9c6c478bada1fb23d0c",
-                companyId: "691df9c4c478bada1fb23bff",
                 name: "admin",
                 permissions: [
-                    { category: "hub_access", name: "taxes", value: true, subCategory: "store_management", permissionId: "664759347eefffe8aba84476" },
-                    { category: "hub_access", name: "general", value: true, subCategory: "store_management", permissionId: "6647591d7eefffe8aba84475" },
-                    { category: "hub_access", name: "reports", value: true, subCategory: "store_management", permissionId: "6645f719ee8498efff5c49bb" },
-                    { category: "hub_access", name: "products", value: true, subCategory: "store_management", permissionId: "6645f719f00dc43caaeffe2b" },
-                    { category: "hub_access", name: "users", value: true, subCategory: "store_management", permissionId: "6647555b7eefffe8aba84473" },
-                    { category: "hub_access", name: "transactions", value: true, subCategory: "payments_access", permissionId: "6645f719ee8498efff5c4a6b" },
-                    { category: "station_access", name: "give_discounts", value: true, subCategory: "pos_actions", permissionId: "6723b146ae5f176f7539d8a6" },
-                    { category: "station_access", name: "issue_refunds", value: true, subCategory: "pos_actions", permissionId: "6645f719ee8498efff5c4ae4" },
-                    { category: "station_access", name: "delete_customers", value: true, subCategory: "pos_actions", permissionId: "6645f71998735e68b2c457df" },
+                    { category: "hub_access", label: "taxes", name: "taxes", value: true },
+                    { category: "hub_access", label: "general", name: "general", value: true },
+                    { category: "hub_access", label: "reports", name: "reports", value: true },
+                    { category: "hub_access", label: "products", name: "products", value: true },
+                    { category: "hub_access", label: "users", name: "users", value: true },
+                    { category: "hub_access", label: "transactions", name: "transactions", value: true },
+                    { category: "station_access", label: "give_discounts", name: "give_discounts", value: true },
+                    { category: "station_access", label: "issue_refunds", name: "issue_refunds", value: true },
+                    { category: "station_access", label: "delete_customers", name: "delete_customers", value: true },
                 ]
             },
             {
                 id: "691df9c6c478bada1fb23d0d",
-                _id: "691df9c6c478bada1fb23d0d",
-                companyId: "691df9c4c478bada1fb23bff",
                 name: "cashier",
                 permissions: [
-                    { category: "station_access", name: "give_discounts", value: false, subCategory: "pos_actions", permissionId: "6723b146ae5f176f7539d8a6" },
-                    { category: "station_access", name: "issue_refunds", value: false, subCategory: "pos_actions", permissionId: "6645f719ee8498efff5c4ae4" },
-                    { category: "station_access", name: "delete_customers", value: false, subCategory: "pos_actions", permissionId: "6645f71998735e68b2c457df" },
-                    { category: "station_access", name: "session_reports", value: true, subCategory: "station_home", permissionId: "6723b271ae5f176f7539d8a7" },
-                    { category: "station_access", name: "cash_drawer", value: true, subCategory: "station_home", permissionId: "6723b2aeae5f176f7539d8a8" },
+                    { category: "station_access", label: "give_discounts", name: "give_discounts", value: false },
+                    { category: "station_access", label: "issue_refunds", name: "issue_refunds", value: false },
+                    { category: "station_access", label: "delete_customers", name: "delete_customers", value: false },
+                    { category: "station_access", label: "session_reports", name: "session_reports", value: true },
+                    { category: "station_access", label: "cash_drawer", name: "cash_drawer", value: true },
                 ]
             }
         ],

package/dist/actions/get-smart-grid-layout/action.d.ts

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

package/dist/actions/get-smart-grid-layout/action.js

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

package/dist/actions/get-smart-grid-layout/mock.d.ts

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

package/dist/actions/get-smart-grid-layout/mock.js

@@ -0,0 +1,7 @@
+export const mockGetSmartGridLayout = (params) => {
+    return Promise.resolve({
+        success: true,
+        layout: { gridId: params.gridId, cells: [] },
+        timestamp: new Date().toISOString()
+    });
+};

package/dist/actions/get-smart-grid-layout/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFSmartGridLayout } from "../../CommonTypes";
+/** Fetch a builder SmartGrid layout by `gridId`. */
+export interface GetSmartGridLayoutParams {
+    gridId: string;
+}
+export interface GetSmartGridLayoutResponse {
+    success: boolean;
+    /** The stored layout, or `null` when no layout exists for the grid. */
+    layout: CFSmartGridLayout | null;
+    timestamp: string;
+}
+export type GetSmartGridLayout = (params: GetSmartGridLayoutParams) => Promise<GetSmartGridLayoutResponse>;

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

@@ -5,7 +5,6 @@ export const mockGetUsers = async (params) => {
         users: [
             {
                 id: "691df9c2047bfc55994d703f",
-                _id: "691df9c2047bfc55994d703f",
                 firstName: "Sarah",
                 lastName: "Mitchell",
                 email: "sarah.mitchell@company.com",
@@ -13,25 +12,22 @@ export const mockGetUsers = async (params) => {
                 type: CFUserTypes.ORG_OWNER,
                 role: {
                     id: "691df9c6c478bada1fb23d0b",
-                    _id: "691df9c6c478bada1fb23d0b",
                     name: "Owner",
-                    companyId: "691df9c4c478bada1fb23bff",
                     permissions: [
-                        { category: "hub_access", name: "general", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "products", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "reports", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "users", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "builder", value: true, subCategory: "builder_access" },
-                        { category: "hub_access", name: "billing", value: true, subCategory: "payments_access" },
-                        { category: "station_access", name: "give_discounts", value: true, subCategory: "pos_actions" },
-                        { category: "station_access", name: "issue_refunds", value: true, subCategory: "pos_actions" },
+                        { category: "hub_access", label: "general", name: "general", value: true },
+                        { category: "hub_access", label: "products", name: "products", value: true },
+                        { category: "hub_access", label: "reports", name: "reports", value: true },
+                        { category: "hub_access", label: "users", name: "users", value: true },
+                        { category: "hub_access", label: "builder", name: "builder", value: true },
+                        { category: "hub_access", label: "billing", name: "billing", value: true },
+                        { category: "station_access", label: "give_discounts", name: "give_discounts", value: true },
+                        { category: "station_access", label: "issue_refunds", name: "issue_refunds", value: true },
                     ]
                 },
                 outlets: []
             },
             {
                 id: "692a1b3c4d5e6f7890abcde1",
-                _id: "692a1b3c4d5e6f7890abcde1",
                 firstName: "James",
                 lastName: "Rodriguez",
                 email: "james.rodriguez@company.com",
@@ -39,22 +35,19 @@ export const mockGetUsers = async (params) => {
                 type: CFUserTypes.ADMIN,
                 role: {
                     id: "691df9c6c478bada1fb23d0c",
-                    _id: "691df9c6c478bada1fb23d0c",
                     name: "admin",
-                    companyId: "691df9c4c478bada1fb23bff",
                     permissions: [
-                        { category: "hub_access", name: "general", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "products", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "reports", value: true, subCategory: "store_management" },
-                        { category: "hub_access", name: "users", value: true, subCategory: "store_management" },
-                        { category: "station_access", name: "give_discounts", value: true, subCategory: "pos_actions" },
+                        { category: "hub_access", label: "general", name: "general", value: true },
+                        { category: "hub_access", label: "products", name: "products", value: true },
+                        { category: "hub_access", label: "reports", name: "reports", value: true },
+                        { category: "hub_access", label: "users", name: "users", value: true },
+                        { category: "station_access", label: "give_discounts", name: "give_discounts", value: true },
                     ]
                 },
                 outlets: ["outlet-main", "outlet-downtown"]
             },
             {
                 id: "692a1b3c4d5e6f7890abcde2",
-                _id: "692a1b3c4d5e6f7890abcde2",
                 firstName: "Lisa",
                 lastName: "Chen",
                 email: "lisa.chen@company.com",
@@ -62,13 +55,11 @@ export const mockGetUsers = async (params) => {
                 type: CFUserTypes.CASHIER,
                 role: {
                     id: "691df9c6c478bada1fb23d0d",
-                    _id: "691df9c6c478bada1fb23d0d",
                     name: "cashier",
-                    companyId: "691df9c4c478bada1fb23bff",
                     permissions: [
-                        { category: "station_access", name: "give_discounts", value: false, subCategory: "pos_actions" },
-                        { category: "station_access", name: "issue_refunds", value: false, subCategory: "pos_actions" },
-                        { category: "station_access", name: "session_reports", value: true, subCategory: "station_home" },
+                        { category: "station_access", label: "give_discounts", name: "give_discounts", value: false },
+                        { category: "station_access", label: "issue_refunds", name: "issue_refunds", value: false },
+                        { category: "station_access", label: "session_reports", name: "session_reports", value: true },
                     ]
                 },
                 outlets: ["outlet-main"]

package/dist/actions/initiate-refund/types.d.ts

@@ -1,4 +1,3 @@
-import type { CFTransitionResult } from "../../common-types/order-state";
 export interface InitiateRefundParams {
     /** The ID of the order to refund. If not provided, uses the currently active order. */
     orderId?: string;
@@ -7,7 +6,5 @@ export interface InitiateRefundResponse {
     success: boolean;
     orderId: string;
     timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
 }
 export type InitiateRefund = (params?: InitiateRefundParams) => Promise<InitiateRefundResponse>;

package/dist/actions/integration-payment/action.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Integration payment — thin wrapper over {@link extensionPayment} with `paymentType: "integration"`.
+ */
+import type { IntegrationPayment } from "./types";
+export declare const integrationPayment: IntegrationPayment;

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

@@ -0,0 +1,7 @@
+/**
+ * Integration payment — thin wrapper over {@link extensionPayment} with `paymentType: "integration"`.
+ */
+import { extensionPayment } from "../extension-payment/action";
+export const integrationPayment = async (params) => {
+    return extensionPayment({ ...params, paymentType: "integration" });
+};

package/dist/actions/integration-payment/mock.d.ts

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

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

@@ -0,0 +1,4 @@
+import { mockExtensionPayment } from "../extension-payment/mock";
+export const mockIntegrationPayment = async (params) => {
+    return mockExtensionPayment({ ...params, paymentType: "integration" });
+};

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

@@ -0,0 +1,16 @@
+import type { ExtensionPaymentResponse } from "../extension-payment/types";
+/** Integration (e.g. Stripe-style terminal) payment — always uses paymentType `"integration"` on the wire. */
+export interface IntegrationPaymentParams {
+    amount?: number;
+    processor?: string;
+    label?: string;
+    referenceId?: string;
+    extensionId?: string;
+    metadata?: Record<string, unknown>;
+    /** EMV tag string from the integration terminal; forwarded to the order PaymentMethod's `emv`. */
+    emvData?: string;
+    /** Processor fee for the integration payment; forwarded to the order PaymentMethod's `processorFee`. */
+    processorFee?: number;
+}
+export type IntegrationPaymentResponse = ExtensionPaymentResponse;
+export type IntegrationPayment = (params?: IntegrationPaymentParams) => Promise<IntegrationPaymentResponse>;

package/dist/actions/open-extension-overlay/action.d.ts

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

package/dist/actions/open-extension-overlay/action.js

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

package/dist/actions/open-extension-overlay/mock.d.ts

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

package/dist/actions/open-extension-overlay/mock.js

@@ -0,0 +1 @@
+export const mockOpenExtensionOverlay = () => Promise.resolve(true);