@final-commerce/command-frame 0.14.1-online.3 → 0.15.0-staging.2

package/dist/actions/upsert-custom-table-data/mock.js

@@ -1,17 +1,33 @@
+import { MOCK_CUSTOM_TABLE_DATA } from '../../demo/mocks/custom-tables';
+import { assertMockCustomTableWriteNotDeclined, mockPublishEvent } from '../../demo/database';
+import { generateMongoID } from '@final-commerce/common';
+/**
+ * The host's upsert (kaching upsert-custom-table-data/handler.ts, customTables.ts:120-271): an `_id` of an existing row
+ * updates it, anything else inserts (a given `_id` kept as-is); `createdAt`/`updatedAt` are the host's; the row is
+ * stored, so getCustomTableData reads it back. Not modelled: the table's field schema — the host drops keys that are
+ * not fields of the table and refuses an unknown table; the mock stores every key.
+ */
 export const mockUpsertCustomTableData = async (params) => {
+    var _a;
     console.log('[Mock] upsertCustomTableData called', params);
-    const data = params?.data;
+    if (!params?.tableName)
+        throw new Error('tableName is required');
+    assertMockCustomTableWriteNotDeclined(params.tableName);
+    const { _id: givenId, ...fields } = (params.data ?? {});
+    delete fields.createdAt;
+    delete fields.updatedAt;
+    const rows = (MOCK_CUSTOM_TABLE_DATA[_a = params.tableName] ?? (MOCK_CUSTOM_TABLE_DATA[_a] = []));
     const now = new Date().toISOString();
-    // Return the data with _id and timestamps added
-    const resultData = {
-        ...data,
-        _id: data?._id || `mock_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
-        createdAt: data?.createdAt || now,
-        updatedAt: now,
-    };
+    const existing = typeof givenId === 'string' ? rows.find((row) => row._id === givenId) : undefined;
+    const row = existing
+        ? Object.assign(existing, fields, { updatedAt: now })
+        : { _id: typeof givenId === 'string' ? givenId : generateMongoID(), ...fields, createdAt: now, updatedAt: now };
+    if (!existing)
+        rows.push(row);
+    mockPublishEvent('custom-tables', existing ? 'row-updated' : 'row-created', { tableName: params.tableName, ...row });
     return {
         success: true,
-        data: resultData,
+        data: { ...row },
         timestamp: now,
     };
 };

package/dist/demo/database.d.ts

@@ -23,6 +23,17 @@ export interface MockDatabaseConfig {
     orderStatuses?: CFOrderStatusDefinition[];
     /** Products hidden at an outlet (the host's `catalog-visibility`, product-level rows). Empty = sold everywhere. */
     catalogVisibility?: MockCatalogVisibility[];
+    /** MOCK ONLY — the switch a test flips to make the host refuse. Absent = everything succeeds. */
+    declines?: MockDeclines;
+}
+/** MOCK ONLY: what the mock host refuses, so a test can see how a flow treats a failure. A real till never reads this. */
+export interface MockDeclines {
+    /** Card payments that are declined: `terminalPayment` (cloud or reader) and `tapToPayPayment`. Cash never declines. */
+    payments?: ('terminal' | 'tapToPay')[];
+    /** Every `processPartialRefund` fails. */
+    refunds?: boolean;
+    /** Every `upsertCustomTableData` / `deleteCustomTableData` rejects with the till's only refusal text for a table write. */
+    customTableWrites?: boolean;
 }
 export interface MockCatalogVisibility {
     productId: string;
@@ -124,6 +135,11 @@ export declare const MOCK_ORDER_STATUSES: CFOrderStatusDefinition[];
 export declare function setMockDatabase(config: Partial<MockDatabaseConfig>): void;
 export declare const safeSerialize: <T>(data: T) => T;
 type MockEventCallback = (event: any) => void;
+export declare let MOCK_DECLINES: MockDeclines;
+/** MOCK ONLY: the dataset's `declines.payments` switch, failing with the till processor's text (kaching `dispatchPay.ts:208-220`). */
+export declare const assertMockPaymentNotDeclined: (paymentType: "terminal" | "tapToPay", cloud: boolean) => void;
+/** MOCK ONLY: the dataset's `declines.customTableWrites` switch, refusing with the till's text (kaching `customTables.ts:131,291`). */
+export declare const assertMockCustomTableWriteNotDeclined: (tableName: string) => void;
 export declare const mockPublishEvent: (topic: string, eventType: string, data: any) => void;
 export declare const mockSubscribeToTopic: (topic: string, callback: MockEventCallback) => void;
 export declare const createOrderFromCart: (paymentType: string, amount: number, processor?: string) => CFActiveOrder;

package/dist/demo/database.js

@@ -4,7 +4,7 @@
  */
 import { CFProductType, CFUserTypes, CurrencyCode, } from '../CommonTypes';
 import { cheapestCompositeItem, cheapestCompositePrice, extendPrice, resolveUnit, toBase, } from '@final-commerce/common';
-import { BookingRatePeriod, BookingResourceKind, BookingType, ReservationStatus } from '@final-commerce/common';
+import { BookingRatePeriod, BookingResourceKind, ReservationStatus } from '@final-commerce/common';
 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';
@@ -1006,6 +1006,8 @@ export function setMockDatabase(config) {
     if (config.catalogVisibility !== undefined) {
         MOCK_CATALOG_VISIBILITY.splice(0, MOCK_CATALOG_VISIBILITY.length, ...config.catalogVisibility);
     }
+    if (config.declines !== undefined)
+        MOCK_DECLINES = config.declines;
     if (MOCK_OUTLETS.length > 0) {
         Object.assign(MOCK_OUTLET_MAIN, MOCK_OUTLETS[0]);
         if (MOCK_OUTLET_MAIN.id === undefined && MOCK_OUTLET_MAIN._id !== undefined) {
@@ -1028,6 +1030,21 @@ export const safeSerialize = (data) => {
     return JSON.parse(JSON.stringify(data));
 };
 const mockTopicSubscribers = {};
+export let MOCK_DECLINES = {};
+/** MOCK ONLY: the dataset's `declines.payments` switch, failing with the till processor's text (kaching `dispatchPay.ts:208-220`). */
+export const assertMockPaymentNotDeclined = (paymentType, cloud) => {
+    if (!MOCK_DECLINES.payments?.includes(paymentType))
+        return;
+    console.warn(`[Mock] ${paymentType}Payment declined — the mock dataset sets declines.payments`);
+    throw new Error(`${cloud ? 'CLOUD_PAYMENT_FAILED' : 'NATIVE_PAYMENT_FAILED'}: Card declined`);
+};
+/** MOCK ONLY: the dataset's `declines.customTableWrites` switch, refusing with the till's text (kaching `customTables.ts:131,291`). */
+export const assertMockCustomTableWriteNotDeclined = (tableName) => {
+    if (!MOCK_DECLINES.customTableWrites)
+        return;
+    console.warn('[Mock] custom table write refused — the mock dataset sets declines.customTableWrites');
+    throw new Error(`Table "${tableName}" not found`);
+};
 export const mockPublishEvent = (topic, eventType, data) => {
     const subscribers = mockTopicSubscribers[topic] || [];
     const event = {
@@ -1338,7 +1355,6 @@ export const mockBookingAvailability = (productId, from, to, resourceId) => {
     return {
         productId,
         bookingRulesId: MOCK_BOOKING_RULES_ID,
-        bookingType: BookingType.APPOINTMENT,
         ratePeriod: BookingRatePeriod.SLOT,
         slots,
         timeZone: MOCK_SHOP_TIME_ZONE,

package/dist/demo/mocks/custom-tables.d.ts

@@ -10,5 +10,8 @@ export interface CustomTableDataRow {
     createdAt: string;
     updatedAt: string;
 }
-export declare const MOCK_CUSTOM_TABLE_DATA: Record<string, CustomTableDataRow[]>;
+/** Rows by table name — what getCustomTableData reads and upsertCustomTableData writes. */
+export declare const MOCK_CUSTOM_TABLE_DATA: Record<string, (Record<string, unknown> & {
+    _id: string;
+})[]>;
 export declare const MOCK_CUSTOM_EXTENSIONS: CustomExtension[];

package/dist/demo/mocks/custom-tables.js

@@ -133,6 +133,7 @@ export const MOCK_CUSTOM_TABLE_FIELDS = [
         updatedAt: "2024-01-03T09:00:00.000Z"
     }
 ];
+/** Rows by table name — what getCustomTableData reads and upsertCustomTableData writes. */
 export const MOCK_CUSTOM_TABLE_DATA = {
     users: [
         {

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export declare const command: {
     readonly getProducts: import(".").GetProducts;
     readonly getBookingResources: import(".").GetBookingResources;
     readonly getBookingAvailability: import(".").GetBookingAvailability;
+    readonly getBookingRentalEnds: import(".").GetBookingRentalEnds;
     readonly getBookings: import(".").GetBookings;
     readonly holdBooking: import(".").HoldBooking;
     readonly addBookingToCart: import(".").AddBookingToCart;
@@ -58,6 +59,8 @@ export declare const command: {
     readonly cashPayment: import(".").CashPayment;
     readonly recordExternalPayment: import(".").RecordExternalPayment;
     readonly getCashRoundingAmount: import(".").GetCashRoundingAmount;
+    readonly getCashChange: import(".").GetCashChange;
+    readonly getOrdersSummary: import(".").GetOrdersSummary;
     readonly tapToPayPayment: import(".").TapToPayPayment;
     readonly terminalPayment: import(".").TerminalPayment;
     readonly extensionPayment: import(".").ExtensionPayment;
@@ -68,20 +71,12 @@ export declare const command: {
     readonly startCheckout: import(".").StartCheckout;
     readonly attachCheckoutContact: import(".").AttachCheckoutContact;
     readonly getAddressOptions: import(".").GetAddressOptions;
-    readonly searchAddresses: import(".").SearchAddresses;
-    readonly getAddressDetails: import(".").GetAddressDetails;
     readonly setOrderAddress: import(".").SetOrderAddress;
     readonly getShippingOptions: import(".").GetShippingOptions;
     readonly selectShippingOption: import(".").SelectShippingOption;
     readonly setOutlet: import(".").SetOutlet;
     readonly resumeCheckout: import(".").ResumeCheckout;
     readonly getCheckoutStatus: import(".").GetCheckoutStatus;
-    readonly getShopperAccount: import(".").GetShopperAccount;
-    readonly requestShopperCode: import(".").RequestShopperCode;
-    readonly signInShopper: import(".").SignInShopper;
-    readonly signOutShopper: import(".").SignOutShopper;
-    readonly getShopperOrders: import(".").GetShopperOrders;
-    readonly getShopperOrder: import(".").GetShopperOrder;
     readonly getMotoConfig: import(".").GetMotoConfig;
     readonly addCustomerNote: import(".").AddCustomerNote;
     readonly removeCustomerNote: import(".").RemoveCustomerNote;
@@ -161,6 +156,7 @@ export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } fro
 export type { GetProducts, GetProductsParams, GetProductsResponse } from './actions/get-products/types';
 export type { GetBookingResources, GetBookingResourcesParams, GetBookingResourcesResponse, } from './actions/get-booking-resources/types';
 export type { GetBookingAvailability, GetBookingAvailabilityParams, GetBookingAvailabilityResponse, } from './actions/get-booking-availability/types';
+export type { GetBookingRentalEnds, GetBookingRentalEndsParams, GetBookingRentalEndsResponse, } from './actions/get-booking-rental-ends/types';
 export type { GetBookings, GetBookingsParams, GetBookingsResponse } from './actions/get-bookings/types';
 export type { HoldBooking, HoldBookingParams, HoldBookingResponse } from './actions/hold-booking/types';
 export type { AddBookingToCart, AddBookingToCartParams, AddBookingToCartResponse, } from './actions/add-booking-to-cart/types';
@@ -233,6 +229,8 @@ export type { VoidOrder, VoidOrderParams, VoidOrderResponse, VoidOrderOutcome }
 export type { CashPayment, CashPaymentParams, CashPaymentResponse } from './actions/cash-payment/types';
 export type { RecordExternalPayment, RecordExternalPaymentParams, RecordExternalPaymentResponse, RecordExternalPaymentTip, } from './actions/record-external-payment/types';
 export type { GetCashRoundingAmount, GetCashRoundingAmountParams, GetCashRoundingAmountResponse, } from './actions/get-cash-rounding-amount/types';
+export type { GetCashChange, GetCashChangeParams, GetCashChangeResponse } from './actions/get-cash-change/types';
+export type { GetOrdersSummary, GetOrdersSummaryParams, GetOrdersSummaryResponse, } from './actions/get-orders-summary/types';
 export type { TapToPayPayment, TapToPayPaymentParams, TapToPayPaymentResponse, } from './actions/tap-to-pay-payment/types';
 export type { TerminalPayment, TerminalPaymentParams, TerminalPaymentResponse } from './actions/terminal-payment/types';
 export type { ExtensionPayment, ExtensionPaymentParams, ExtensionPaymentResponse, } from './actions/extension-payment/types';
@@ -249,14 +247,6 @@ export type { SelectShippingOption, SelectShippingOptionParams, SelectShippingOp
 export type { SetOutlet, SetOutletParams, SetOutletResponse } from './actions/set-outlet/types';
 export type { ResumeCheckout, ResumeCheckoutParams, ResumeCheckoutResponse, ResumeCheckoutResult, } from './actions/resume-checkout/types';
 export type { GetCheckoutStatus, GetCheckoutStatusParams, GetCheckoutStatusResponse, CheckoutOrderStatus, CheckoutCancelReason, } from './actions/get-checkout-status/types';
-export type { GetShopperAccount, GetShopperAccountParams, GetShopperAccountResponse, ShopperCheckoutBox, ShopperAccountView, ShopperAddressView, } from './actions/get-shopper-account/types';
-export type { RequestShopperCode, RequestShopperCodeParams, RequestShopperCodeResponse, } from './actions/request-shopper-code/types';
-export type { SignInShopper, SignInShopperParams, SignInShopperResponse } from './actions/sign-in-shopper/types';
-export type { SignOutShopper, SignOutShopperParams, SignOutShopperResponse } from './actions/sign-out-shopper/types';
-export type { SearchAddresses, SearchAddressesParams, SearchAddressesResponse, AddressSuggestion, } from './actions/search-addresses/types';
-export type { GetAddressDetails, GetAddressDetailsParams, GetAddressDetailsResponse, AddressDetails, } from './actions/get-address-details/types';
-export type { GetShopperOrders, GetShopperOrdersParams, GetShopperOrdersResponse, ShopperOrderView, } from './actions/get-shopper-orders/types';
-export type { GetShopperOrder, GetShopperOrderParams, GetShopperOrderResponse, ShopperOrderDetailView, ShopperOrderItemView, } from './actions/get-shopper-order/types';
 export type { GetMotoConfig, GetMotoConfigResponse, MotoUnavailableReason } from './actions/get-moto-config/types';
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse, } from './actions/add-customer-note/types';
 export type { RemoveCustomerNote, RemoveCustomerNoteParams, RemoveCustomerNoteResponse, } from './actions/remove-customer-note/types';

package/dist/index.js

@@ -3,6 +3,7 @@ import { exampleFunction } from './actions/example-function/action';
 import { getProducts } from './actions/get-products/action';
 import { getBookingResources } from './actions/get-booking-resources/action';
 import { getBookingAvailability } from './actions/get-booking-availability/action';
+import { getBookingRentalEnds } from './actions/get-booking-rental-ends/action';
 import { getBookings } from './actions/get-bookings/action';
 import { holdBooking } from './actions/hold-booking/action';
 import { addBookingToCart } from './actions/add-booking-to-cart/action';
@@ -58,6 +59,8 @@ import { voidOrder } from './actions/void-order/action';
 import { cashPayment } from './actions/cash-payment/action';
 import { recordExternalPayment } from './actions/record-external-payment/action';
 import { getCashRoundingAmount } from './actions/get-cash-rounding-amount/action';
+import { getCashChange } from './actions/get-cash-change/action';
+import { getOrdersSummary } from './actions/get-orders-summary/action';
 import { tapToPayPayment } from './actions/tap-to-pay-payment/action';
 import { terminalPayment } from './actions/terminal-payment/action';
 import { extensionPayment } from './actions/extension-payment/action';
@@ -68,21 +71,12 @@ import { chargeMoto } from './actions/charge-moto/action';
 import { startCheckout } from './actions/start-checkout/action';
 import { attachCheckoutContact } from './actions/attach-checkout-contact/action';
 import { getAddressOptions } from './actions/get-address-options/action';
-import { searchAddresses } from './actions/search-addresses/action';
-import { getAddressDetails } from './actions/get-address-details/action';
 import { setOrderAddress } from './actions/set-order-address/action';
 import { getShippingOptions } from './actions/get-shipping-options/action';
 import { selectShippingOption } from './actions/select-shipping-option/action';
 import { setOutlet } from './actions/set-outlet/action';
 import { resumeCheckout } from './actions/resume-checkout/action';
 import { getCheckoutStatus } from './actions/get-checkout-status/action';
-// Shopper account (store websites)
-import { getShopperAccount } from './actions/get-shopper-account/action';
-import { requestShopperCode } from './actions/request-shopper-code/action';
-import { signInShopper } from './actions/sign-in-shopper/action';
-import { signOutShopper } from './actions/sign-out-shopper/action';
-import { getShopperOrders } from './actions/get-shopper-orders/action';
-import { getShopperOrder } from './actions/get-shopper-order/action';
 import { getMotoConfig } from './actions/get-moto-config/action';
 // Customer Actions
 import { addCustomerNote } from './actions/add-customer-note/action';
@@ -180,6 +174,7 @@ export const command = {
     getProducts,
     getBookingResources,
     getBookingAvailability,
+    getBookingRentalEnds,
     getBookings,
     holdBooking,
     addBookingToCart,
@@ -236,6 +231,8 @@ export const command = {
     cashPayment,
     recordExternalPayment,
     getCashRoundingAmount,
+    getCashChange,
+    getOrdersSummary,
     tapToPayPayment,
     terminalPayment,
     extensionPayment,
@@ -246,20 +243,12 @@ export const command = {
     startCheckout,
     attachCheckoutContact,
     getAddressOptions,
-    searchAddresses,
-    getAddressDetails,
     setOrderAddress,
     getShippingOptions,
     selectShippingOption,
     setOutlet,
     resumeCheckout,
     getCheckoutStatus,
-    getShopperAccount,
-    requestShopperCode,
-    signInShopper,
-    signOutShopper,
-    getShopperOrders,
-    getShopperOrder,
     getMotoConfig,
     // Customer Actions
     addCustomerNote,

package/dist/projects/render/mocks.js

@@ -36,6 +36,8 @@ import { mockCalculateRefundTotal } from '../../actions/calculate-refund-total/m
 import { mockCashPayment } from '../../actions/cash-payment/mock';
 import { mockRecordExternalPayment } from '../../actions/record-external-payment/mock';
 import { mockGetCashRoundingAmount } from '../../actions/get-cash-rounding-amount/mock';
+import { mockGetCashChange } from '../../actions/get-cash-change/mock';
+import { mockGetOrdersSummary } from '../../actions/get-orders-summary/mock';
 import { mockCreatePaymentLink } from '../../actions/create-payment-link/mock';
 import { mockChargeMoto } from '../../actions/charge-moto/mock';
 import { mockStartCheckout } from '../../actions/start-checkout/mock';
@@ -48,14 +50,6 @@ import { mockGetOutlets } from '../../actions/get-outlets/mock';
 import { mockSetOutlet } from '../../actions/set-outlet/mock';
 import { mockResumeCheckout } from '../../actions/resume-checkout/mock';
 import { mockGetCheckoutStatus } from '../../actions/get-checkout-status/mock';
-import { mockGetShopperAccount } from '../../actions/get-shopper-account/mock';
-import { mockRequestShopperCode } from '../../actions/request-shopper-code/mock';
-import { mockSignInShopper } from '../../actions/sign-in-shopper/mock';
-import { mockSignOutShopper } from '../../actions/sign-out-shopper/mock';
-import { mockGetShopperOrders } from '../../actions/get-shopper-orders/mock';
-import { mockSearchAddresses } from '../../actions/search-addresses/mock';
-import { mockGetAddressDetails } from '../../actions/get-address-details/mock';
-import { mockGetShopperOrder } from '../../actions/get-shopper-order/mock';
 import { mockGetMotoConfig } from '../../actions/get-moto-config/mock';
 import { mockGetTimeClockStatus } from '../../actions/get-time-clock-status/mock';
 import { mockClearCart } from '../../actions/clear-cart/mock';
@@ -70,6 +64,7 @@ import { mockGetOrders } from '../../actions/get-orders/mock';
 import { mockGetProducts } from '../../actions/get-products/mock';
 import { mockGetBookingResources } from '../../actions/get-booking-resources/mock';
 import { mockGetBookingAvailability } from '../../actions/get-booking-availability/mock';
+import { mockGetBookingRentalEnds } from '../../actions/get-booking-rental-ends/mock';
 import { mockGetBookings } from '../../actions/get-bookings/mock';
 import { mockHoldBooking } from '../../actions/hold-booking/mock';
 import { mockAddBookingToCart } from '../../actions/add-booking-to-cart/mock';
@@ -174,13 +169,13 @@ export const RENDER_MOCKS = {
     cashPayment: mockCashPayment,
     recordExternalPayment: mockRecordExternalPayment,
     getCashRoundingAmount: mockGetCashRoundingAmount,
+    getCashChange: mockGetCashChange,
+    getOrdersSummary: mockGetOrdersSummary,
     createPaymentLink: mockCreatePaymentLink,
     chargeMoto: mockChargeMoto,
     startCheckout: mockStartCheckout,
     attachCheckoutContact: mockAttachCheckoutContact,
     getAddressOptions: mockGetAddressOptions,
-    searchAddresses: mockSearchAddresses,
-    getAddressDetails: mockGetAddressDetails,
     setOrderAddress: mockSetOrderAddress,
     getShippingOptions: mockGetShippingOptions,
     selectShippingOption: mockSelectShippingOption,
@@ -188,12 +183,6 @@ export const RENDER_MOCKS = {
     setOutlet: mockSetOutlet,
     resumeCheckout: mockResumeCheckout,
     getCheckoutStatus: mockGetCheckoutStatus,
-    getShopperAccount: mockGetShopperAccount,
-    requestShopperCode: mockRequestShopperCode,
-    signInShopper: mockSignInShopper,
-    signOutShopper: mockSignOutShopper,
-    getShopperOrders: mockGetShopperOrders,
-    getShopperOrder: mockGetShopperOrder,
     getMotoConfig: mockGetMotoConfig,
     clearCart: mockClearCart,
     deleteParkedOrder: mockDeleteParkedOrder,
@@ -207,6 +196,7 @@ export const RENDER_MOCKS = {
     getProducts: mockGetProducts,
     getBookingResources: mockGetBookingResources,
     getBookingAvailability: mockGetBookingAvailability,
+    getBookingRentalEnds: mockGetBookingRentalEnds,
     getBookings: mockGetBookings,
     holdBooking: mockHoldBooking,
     addBookingToCart: mockAddBookingToCart,

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

@@ -1,9 +1,10 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, GetCustomStockActions, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, GetCompositePrice, GetCompositeAvailability, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, SetVariantUnavailable, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, ResumeOrder, SetOrderMetadata, AssignOrderUser, ReleaseFromCart, SetOrderType, SetScheduledFor, SetOrderStatus, GetOrderStatuses, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, RecordExternalPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, GetActiveStation, GetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms, GetBookingResources, GetBookingAvailability, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, CreatePaymentLink, ChargeMoto, StartCheckout, AttachCheckoutContact, GetAddressOptions, SetOrderAddress, GetShippingOptions, SelectShippingOption, GetOutlets, SetOutlet, ResumeCheckout, GetCheckoutStatus, GetShopperAccount, RequestShopperCode, SignInShopper, SignOutShopper, GetShopperOrders, GetShopperOrder, SearchAddresses, GetAddressDetails, GetMotoConfig, GetTimeClockStatus } from '../../index';
+import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, GetCustomStockActions, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, GetCompositePrice, GetCompositeAvailability, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, SetVariantUnavailable, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, ResumeOrder, SetOrderMetadata, AssignOrderUser, ReleaseFromCart, SetOrderType, SetScheduledFor, SetOrderStatus, GetOrderStatuses, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, RecordExternalPayment, GetCashRoundingAmount, GetCashChange, GetOrdersSummary, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, GetActiveStation, GetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms, GetBookingResources, GetBookingAvailability, GetBookingRentalEnds, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, CreatePaymentLink, ChargeMoto, StartCheckout, AttachCheckoutContact, GetAddressOptions, SetOrderAddress, GetShippingOptions, SelectShippingOption, GetOutlets, SetOutlet, ResumeCheckout, GetCheckoutStatus, GetMotoConfig, GetTimeClockStatus } from '../../index';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
     getBookingResources: GetBookingResources;
     getBookingAvailability: GetBookingAvailability;
+    getBookingRentalEnds: GetBookingRentalEnds;
     getBookings: GetBookings;
     holdBooking: HoldBooking;
     addBookingToCart: AddBookingToCart;
@@ -58,6 +59,8 @@ export interface RenderProviderActions {
     cashPayment: CashPayment;
     recordExternalPayment: RecordExternalPayment;
     getCashRoundingAmount: GetCashRoundingAmount;
+    getCashChange: GetCashChange;
+    getOrdersSummary: GetOrdersSummary;
     tapToPayPayment: TapToPayPayment;
     terminalPayment: TerminalPayment;
     extensionPayment: ExtensionPayment;
@@ -74,8 +77,6 @@ export interface RenderProviderActions {
     attachCheckoutContact: AttachCheckoutContact;
     /** Shipping, on the till (ship-to) and the website alike. The runtime prices; the flow renders. */
     getAddressOptions: GetAddressOptions;
-    searchAddresses: SearchAddresses;
-    getAddressDetails: GetAddressDetails;
     setOrderAddress: SetOrderAddress;
     getShippingOptions: GetShippingOptions;
     selectShippingOption: SelectShippingOption;
@@ -89,13 +90,6 @@ export interface RenderProviderActions {
     resumeCheckout: ResumeCheckout;
     /** Where an online order stands now, by its order password. Storefront-only. */
     getCheckoutStatus: GetCheckoutStatus;
-    /** The shopper account on a store's website (sign in, this store's orders). Storefront-only. */
-    getShopperAccount: GetShopperAccount;
-    requestShopperCode: RequestShopperCode;
-    signInShopper: SignInShopper;
-    signOutShopper: SignOutShopper;
-    getShopperOrders: GetShopperOrders;
-    getShopperOrder: GetShopperOrder;
     getMotoConfig: GetMotoConfig;
     addNonRevenueItem: AddNonRevenueItem;
     addCustomerNote: AddCustomerNote;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.14.1-online.3",
+  "version": "0.15.0-staging.2",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,7 @@
     "ignoreBranchesMissingTickets": true
   },
   "dependencies": {
-    "@final-commerce/common": "2.11.1-online.3"
+    "@final-commerce/common": "2.12.0-staging.2"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.0.0",

package/dist/actions/get-address-details/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * getAddressDetails action
- * Calls the getAddressDetails action on the parent window
- */
-import type { GetAddressDetails } from './types';
-export declare const getAddressDetails: GetAddressDetails;

package/dist/actions/get-address-details/action.js

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

package/dist/actions/get-address-details/mock.d.ts

@@ -1,2 +0,0 @@
-import type { GetAddressDetails } from './types';
-export declare const mockGetAddressDetails: GetAddressDetails;

package/dist/actions/get-address-details/mock.js

@@ -1,7 +0,0 @@
-export const mockGetAddressDetails = async (params) => {
-    console.log('[Mock] getAddressDetails called', params);
-    return {
-        success: true,
-        address: { address1: '12 Water St', city: "St. John's", state: 'NL', postCode: 'A1C 1A1', country: 'CA' },
-    };
-};

package/dist/actions/get-address-details/types.d.ts

@@ -1,22 +0,0 @@
-/** In the cart's shape: country ISO 3166-1 alpha-2, province or state as its code. */
-export interface AddressDetails {
-    address1: string;
-    address2?: string;
-    city?: string;
-    state?: string;
-    postCode?: string;
-    country: string;
-}
-export interface GetAddressDetailsParams {
-    /** A suggestion's `id`, from searchAddresses. */
-    id: string;
-    language?: string;
-}
-export interface GetAddressDetailsResponse {
-    success: boolean;
-    /** Ready for setOrderAddress. Add the shopper's name; keep anything they edit afterwards. */
-    address?: AddressDetails;
-    reason?: string;
-}
-/** The picked suggestion as a full address. Ends the lookup session the searches opened. */
-export type GetAddressDetails = (params: GetAddressDetailsParams) => Promise<GetAddressDetailsResponse>;

package/dist/actions/get-address-details/types.js

@@ -1,3 +0,0 @@
-// The second half of address autocomplete: the suggestion the shopper picked, as a full address.
-// Served ONLY by the storefront runtime. Failures resolve with `success: false`; never throws.
-export {};

package/dist/actions/get-shopper-account/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * getShopperAccount action
- * Calls the getShopperAccount action on the parent window
- */
-import type { GetShopperAccount } from './types';
-export declare const getShopperAccount: GetShopperAccount;

package/dist/actions/get-shopper-account/action.js

@@ -1,8 +0,0 @@
-/**
- * getShopperAccount action
- * Calls the getShopperAccount action on the parent window
- */
-import { commandFrameClient } from '../../client';
-export const getShopperAccount = async (params) => {
-    return await commandFrameClient.call('getShopperAccount', params ?? {});
-};

package/dist/actions/get-shopper-account/mock.d.ts

@@ -1,3 +0,0 @@
-import type { GetShopperAccount } from './types';
-/** Standalone mock: a guest, with the two checkout boxes. */
-export declare const mockGetShopperAccount: GetShopperAccount;

package/dist/actions/get-shopper-account/mock.js

@@ -1,12 +0,0 @@
-/** Standalone mock: a guest, with the two checkout boxes. */
-export const mockGetShopperAccount = async () => {
-    console.log('[Mock] getShopperAccount called');
-    return {
-        success: true,
-        signedIn: false,
-        boxes: [
-            { id: 'accountOptIn', label: 'Track this order and check out faster next time', checked: false },
-            { id: 'marketingOptIn', label: 'Email me news and offers from this store', checked: false },
-        ],
-    };
-};

package/dist/actions/get-shopper-account/types.d.ts

@@ -1,46 +0,0 @@
-/** A checkbox the checkout shows, with its wording and default. */
-export interface ShopperCheckoutBox {
-    /** `saveAddress` is offered to a signed-in shopper only; send it with the shipping address step's contact. */
-    id: 'accountOptIn' | 'marketingOptIn' | 'saveAddress';
-    label: string;
-    checked: boolean;
-}
-export interface ShopperAccountView {
-    name: string;
-    /** null for an account made with a phone that has not added an email yet. */
-    email: string | null;
-    phone: string | null;
-}
-/** A saved address, as stored, plus one line to show it by. */
-export interface ShopperAddressView {
-    id: string;
-    label: string | null;
-    /** "12 Water St, St. John's, NL A1C 1A1" */
-    line: string;
-    isDefault: boolean;
-    firstName?: string;
-    lastName?: string;
-    address1?: string;
-    address2?: string;
-    city?: string;
-    state?: string;
-    postCode?: string;
-    country?: string;
-}
-export type GetShopperAccountParams = Record<string, never>;
-export interface GetShopperAccountResponse {
-    success: boolean;
-    signedIn: boolean;
-    /** Present when signed in. */
-    shopper?: ShopperAccountView;
-    /** Signed in only: the saved addresses, the default first. The checkout prefills the default itself. */
-    addresses?: ShopperAddressView[];
-    /**
-     * The account boxes for the checkout's contact step. A guest gets "Track this order" and the news
-     * box; a signed-in shopper gets the news box and "Save this address" (ticked).
-     */
-    boxes: ShopperCheckoutBox[];
-    reason?: string;
-}
-/** Who is signed in at this store, their saved addresses, and the checkout boxes to show. */
-export type GetShopperAccount = (params?: GetShopperAccountParams) => Promise<GetShopperAccountResponse>;

package/dist/actions/get-shopper-account/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};

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

@@ -1,6 +0,0 @@
-/**
- * getShopperOrder action
- * Calls the getShopperOrder action on the parent window
- */
-import type { GetShopperOrder } from './types';
-export declare const getShopperOrder: GetShopperOrder;

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

@@ -1,8 +0,0 @@
-/**
- * getShopperOrder action
- * Calls the getShopperOrder action on the parent window
- */
-import { commandFrameClient } from '../../client';
-export const getShopperOrder = async (params) => {
-    return await commandFrameClient.call('getShopperOrder', params ?? {});
-};

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

@@ -1,2 +0,0 @@
-import type { GetShopperOrder } from './types';
-export declare const mockGetShopperOrder: GetShopperOrder;

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

@@ -1,24 +0,0 @@
-export const mockGetShopperOrder = async (params) => {
-    console.log('[Mock] getShopperOrder called', params);
-    return {
-        success: true,
-        order: {
-            orderId: params.orderId,
-            receiptId: '#1042',
-            placedAtLabel: 'Nov 1, 2026',
-            status: 'paid',
-            statusLabel: 'Paid',
-            totalLabel: '$42.50',
-            itemsLabel: '2 items',
-            items: [{ name: 'Harbour mug', variant: 'Slate', quantity: 2, totalLabel: '$40.00' }],
-            totals: [
-                { label: 'Subtotal', amountLabel: '$40.00' },
-                { label: 'Tax', amountLabel: '$2.50' },
-                { label: 'Total', amountLabel: '$42.50' },
-            ],
-            paidWithLabel: 'Visa •••• 4242',
-            deliveryLabel: 'Pickup at Water St.',
-            returnLabel: null,
-        },
-    };
-};