@final-commerce/command-frame 0.1.72 → 0.1.73

package/dist/CommonTypes.d.ts

@@ -715,3 +715,22 @@ export interface CFContextManage {
     timestamp: string;
 }
 export type CFContext = CFContextRender;
+export type CFTileType = "empty" | "product" | "action" | "category" | "folder" | "back";
+export interface CFTileCell {
+    index: number;
+    type: CFTileType;
+    entityId?: string;
+    entityData?: Record<string, unknown>;
+}
+export interface CFSmartGridLayout {
+    gridId: string;
+    cells: CFTileCell[];
+    /** Operator-editable display name for this grid. When absent, consumers
+     *  should fall back to a placeholder (e.g. "Smart Grid"). */
+    name?: string;
+    /** Cells inside operator-created folders, keyed by the folder tile's
+     *  entityId. Each folder owns its own dense cell array (indices 0..N-1)
+     *  and may contain further folder tiles for arbitrary nesting. Absent or
+     *  empty when no folders exist. */
+    folders?: Record<string, CFTileCell[]>;
+}

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 { GetSmartGridLayout } from "./types";
+export declare const mockGetSmartGridLayout: GetSmartGridLayout;

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

@@ -0,0 +1,9 @@
+import { MOCK_SMART_GRID_LAYOUTS } from "../../demo/database";
+export const mockGetSmartGridLayout = (params) => {
+    console.log("[Mock] getSmartGridLayout called", params);
+    return Promise.resolve({
+        success: true,
+        layout: MOCK_SMART_GRID_LAYOUTS[params.gridId] ?? null,
+        timestamp: new Date().toISOString()
+    });
+};

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

@@ -0,0 +1,10 @@
+import { CFSmartGridLayout } from "../../CommonTypes";
+export interface GetSmartGridLayoutParams {
+    gridId: string;
+}
+export interface GetSmartGridLayoutResponse {
+    success: boolean;
+    layout: CFSmartGridLayout | null;
+    timestamp: string;
+}
+export type GetSmartGridLayout = (params: GetSmartGridLayoutParams) => Promise<GetSmartGridLayoutResponse>;

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,10 @@
+import { MOCK_SMART_GRID_LAYOUTS } from "../../demo/database";
+export const mockSaveSmartGridLayout = (params) => {
+    console.log("[Mock] saveSmartGridLayout called", params);
+    MOCK_SMART_GRID_LAYOUTS[params.layout.gridId] = params.layout;
+    return Promise.resolve({
+        success: true,
+        gridId: params.layout.gridId,
+        timestamp: new Date().toISOString()
+    });
+};

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

@@ -0,0 +1,10 @@
+import { CFSmartGridLayout } from "../../CommonTypes";
+export interface SaveSmartGridLayoutParams {
+    layout: CFSmartGridLayout;
+}
+export interface SaveSmartGridLayoutResponse {
+    success: boolean;
+    gridId: string;
+    timestamp: string;
+}
+export type SaveSmartGridLayout = (params: SaveSmartGridLayoutParams) => Promise<SaveSmartGridLayoutResponse>;

package/dist/actions/save-smart-grid-layout/types.js

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

package/dist/demo/database.d.ts

@@ -2,7 +2,7 @@
  * Mock Database for Standalone/Demo Mode
  * Stores mock data that mimics the Render environment
  */
-import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails } from "../CommonTypes";
+import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout } from "../CommonTypes";
 export * from "./mocks";
 /** Replace mock catalog / context data in place (same array references mock handlers use). */
 export interface MockDatabaseConfig {
@@ -64,6 +64,7 @@ export declare let MOCK_OUTLET: CFActiveOutlet;
 export declare let MOCK_CART: CFActiveCart;
 export declare let MOCK_ACTIVE_PRODUCT: CFActiveProduct;
 export declare const setMockActiveProduct: (activeProduct: CFActiveProduct) => void;
+export declare const MOCK_SMART_GRID_LAYOUTS: Record<string, CFSmartGridLayout>;
 export declare const resetMockCart: () => void;
 /**
  * Replace in-memory mock data used by default mock handlers. Arrays are mutated in place

package/dist/demo/database.js

@@ -463,6 +463,10 @@ export let MOCK_ACTIVE_PRODUCT;
 export const setMockActiveProduct = (activeProduct) => {
     MOCK_ACTIVE_PRODUCT = activeProduct;
 };
+// In-memory smart-grid layouts keyed by gridId. Used by mockGetSmartGridLayout /
+// mockSaveSmartGridLayout so the standalone builder (no command-frame host) can
+// round-trip layouts within a session.
+export const MOCK_SMART_GRID_LAYOUTS = {};
 // Helper to reset cart
 export const resetMockCart = () => {
     MOCK_CART = {

package/dist/index.d.ts

@@ -86,6 +86,8 @@ export declare const command: {
     readonly deleteProduct: import("./actions/delete-product/types").DeleteProduct;
     readonly getOutlets: import("./actions/get-outlets/types").GetOutlets;
     readonly getStations: import("./actions/get-stations/types").GetStations;
+    readonly getSmartGridLayout: import("./actions/get-smart-grid-layout/types").GetSmartGridLayout;
+    readonly saveSmartGridLayout: import("./actions/save-smart-grid-layout/types").SaveSmartGridLayout;
     readonly getCustomTables: import("./actions/get-custom-tables/types").GetCustomTables;
     readonly getCustomTableFields: import("./actions/get-custom-table-fields/types").GetCustomTableFields;
     readonly getCustomTableData: import("./actions/get-custom-table-data/types").GetCustomTableData;
@@ -122,6 +124,8 @@ export type { EditProductVariants, EditProductVariantsParams, EditProductVariant
 export type { DeleteProduct, DeleteProductParams, DeleteProductResponse } from "./actions/delete-product/types";
 export type { GetOutlets, GetOutletsResponse } from "./actions/get-outlets/types";
 export type { GetStations, GetStationsParams, GetStationsResponse } from "./actions/get-stations/types";
+export type { GetSmartGridLayout, GetSmartGridLayoutParams, GetSmartGridLayoutResponse } from "./actions/get-smart-grid-layout/types";
+export type { SaveSmartGridLayout, SaveSmartGridLayoutParams, SaveSmartGridLayoutResponse } from "./actions/save-smart-grid-layout/types";
 export type { GetOrders, GetOrdersParams, GetOrdersResponse } from "./actions/get-orders/types";
 export type { GetRefunds, GetRefundsParams, GetRefundsResponse } from "./actions/get-refunds/types";
 export type { SetRefundStockAction, SetRefundStockActionParams, SetRefundStockActionResponse } from "./actions/set-refund-stock-action/types";

package/dist/index.js

@@ -111,6 +111,9 @@ import { deleteProduct } from "./actions/delete-product/action";
 // Entity Actions
 import { getOutlets } from "./actions/get-outlets/action";
 import { getStations } from "./actions/get-stations/action";
+// SmartGrid Actions
+import { getSmartGridLayout } from "./actions/get-smart-grid-layout/action";
+import { saveSmartGridLayout } from "./actions/save-smart-grid-layout/action";
 // Manage extension actions (optional hosts: Deerlake, etc.)
 import { navigateTo } from "./actions/navigate-to/action";
 import { refreshResource } from "./actions/refresh-resource/action";
@@ -216,6 +219,9 @@ export const command = {
     // Entity Actions
     getOutlets,
     getStations,
+    // SmartGrid Actions
+    getSmartGridLayout,
+    saveSmartGridLayout,
     // Custom Tables Actions
     getCustomTables,
     getCustomTableFields,

package/dist/projects/render/mocks.js

@@ -86,6 +86,8 @@ import { mockSetActiveSession } from "../../actions/set-active-session/mock";
 import { mockGetActiveUser } from "../../actions/get-active-user/mock";
 import { mockSetActiveUser } from "../../actions/set-active-user/mock";
 import { mockSetActiveRefund } from "../../actions/set-active-refund/mock";
+import { mockGetSmartGridLayout } from "../../actions/get-smart-grid-layout/mock";
+import { mockSaveSmartGridLayout } from "../../actions/save-smart-grid-layout/mock";
 export const RENDER_MOCKS = {
     addCartDiscount: mockAddCartDiscount,
     addCartFee: mockAddCartFee,
@@ -180,5 +182,7 @@ export const RENDER_MOCKS = {
     removeCartFee: mockRemoveCartFee,
     removeOrderNote: () => Promise.resolve({ success: true, timestamp: new Date().toISOString() }),
     removeCustomSale: params => Promise.resolve({ success: true, id: params.id, timestamp: new Date().toISOString() }),
-    removeNonRevenueItem: params => Promise.resolve({ success: true, externalId: params.externalId, timestamp: new Date().toISOString() })
+    removeNonRevenueItem: params => Promise.resolve({ success: true, externalId: params.externalId, timestamp: new Date().toISOString() }),
+    getSmartGridLayout: mockGetSmartGridLayout,
+    saveSmartGridLayout: mockSaveSmartGridLayout
 };

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

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, IntegrationPayment } from "../../index";
+import type { ExampleFunction, GetProducts, AddCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, InitiateRefund, CashPayment, TapToPayPayment, TerminalPayment, VendaraPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, TriggerWebhook, TriggerZapierWebhook, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, SetActiveOutlet, GetActiveStation, SetActiveStation, GetActiveSession, SetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout } from "../../index";
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -94,4 +94,6 @@ export interface RenderProviderActions {
     removeOrderNote: RemoveOrderNote;
     removeCustomSale: RemoveCustomSale;
     removeNonRevenueItem: RemoveNonRevenueItem;
+    getSmartGridLayout: GetSmartGridLayout;
+    saveSmartGridLayout: SaveSmartGridLayout;
 }

package/package.json

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