@final-commerce/command-frame 0.6.0-staging.5 → 0.6.0-staging3.1

package/README.md

@@ -18,6 +18,8 @@ The library provides three main capabilities:
 
 Domain models (orders, cart, customers, products, and related types) are documented in **[Types reference](./src/types/README.md)**.
 
+The order lifecycle — payment × fulfillment state pairs, display labels, the transition guard chain, and the financial invariants — is documented in **[Order state machine reference](./docs/order-state-machine.md)**. Read it before building anything that reads or moves order state (`canTransition`, `getAvailableTransitions`, `applyTransition`, park/void/resume, payments, refunds).
+
 ## Installation
 
 ### From npm (public registry)

package/dist/CommonTypes.d.ts

@@ -1,5 +1,5 @@
 export * from './common-types';
-import type { Tax, Tip, Address, MetadataItem, PosDataItem, CartFeeTaxEntry, CartFeeItem, CartDiscountItem, OrderNote, NonRevenueItem, DiscountDetail, FeeDetail, DiscountLineItem, FeeLineItem, LineItem, TipPayment, RefundedTipPayment, PaymentMethod, Discount, CustomFee, Summary, CustomSale, RefundedCustomSale, RefundItem, RefundedLineItem, ActiveStation, ActiveSession, ActiveOutlet, ActiveUser, ActiveUserRole, ActiveOrder, ActiveCart, ActivePark, ActiveCompany, ActiveCustomSales, ActiveProduct, ActiveCustomer, FullProduct, ProductVariant, Inventory, CustomerNote, Attribute, AttributeOption, Category, Transaction, ActiveSplitPayment } from '@final-commerce/common/pos-types';
+import type { Tax, Tip, Address, MetadataItem, PosDataItem, CartFeeTaxEntry, CartFeeItem, CartDiscountItem, OrderNote, NonRevenueItem, DiscountDetail, FeeDetail, DiscountLineItem, FeeLineItem, LineItem, TipPayment, RefundedTipPayment, PaymentMethod, Discount, CustomFee, Summary, CustomSale, RefundedCustomSale, RefundItem, RefundedLineItem, ActiveStation, ActiveSession, ActiveOutlet, ActiveUser, ActiveUserRole, ActiveOrder, ActiveCart, ActivePark, ActiveCompany, ActiveCustomSales, ActiveProduct, ActiveCustomer, FullProduct, ProductVariant, Inventory, ResolvedModifier, ResolvedModifierChoice, ModifierSelectionType, ModifierSelection, ModifierChoiceSelection, OrderLineItemModifier, CustomerNote, Attribute, AttributeOption, Category, Transaction, ActiveSplitPayment } from '@final-commerce/common/pos-types';
 export { CurrencyCode, ProductType as CFProductType, UserTypes as CFUserTypes } from '@final-commerce/common';
 /** Open record used as a base for active entities. */
 export type CFActiveEntity = Record<string, unknown>;
@@ -18,6 +18,15 @@ export type CFTransaction = Transaction;
 export type CFCategory = Category;
 export type CFProductVariant = ProductVariant;
 export type CFProduct = FullProduct;
+/** Modifier (the till question) resolved onto a product — `CFProduct.modifiers`. */
+export type CFResolvedModifier = ResolvedModifier;
+export type CFResolvedModifierChoice = ResolvedModifierChoice;
+export type CFModifierSelectionType = ModifierSelectionType;
+/** One selected modifier choice on an order line item (wire shape). */
+export type CFOrderLineItemModifier = OrderLineItemModifier;
+/** Cart-line modifier answer (pre-pricing) — `CFActiveProduct.modifierSelections`. */
+export type CFModifierSelection = ModifierSelection;
+export type CFModifierChoiceSelection = ModifierChoiceSelection;
 export type CFActiveProduct = ActiveProduct;
 export type CFCustomer = ActiveCustomer;
 export type CFActiveCustomer = ActiveCustomer;

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

@@ -53,6 +53,12 @@ export const mockAddProductToCart = async (params) => {
         note: note,
         // discount/fee could be added here to mock object if CFActiveProduct supports it
     };
+    // Mock modifier handling: echo selections onto the line; a real host resolves the
+    // product's modifiers, validates required/min/max in units, and prices each choice
+    // (fee-level money: not in grossSales, not reduced by the product discount).
+    if (params?.modifiers?.length) {
+        activeProduct.modifierSelections = params.modifiers;
+    }
     MOCK_CART.products.push(activeProduct);
     // Recalculate totals. extendPrice, not a raw multiply: a fractional quantity times an
     // integer-minor price leaves fractional cents, which no order may carry.

package/dist/actions/add-product-to-cart/types.d.ts

@@ -1,5 +1,11 @@
-import type { AddProductDiscountParams } from "../add-product-discount/types";
-import type { AddProductFeeParams } from "../add-product-fee/types";
+import type { AddProductDiscountParams } from '../add-product-discount/types';
+import type { AddProductFeeParams } from '../add-product-fee/types';
+import type { ModifierSelection } from '../get-product-modifier-selections/types';
+/**
+ * One modifier answer passed at ring-time. Same shape as the
+ * get-product-modifier-selections `ModifierSelection` (single source of truth).
+ */
+export type AddProductToCartModifierParams = ModifierSelection;
 export interface AddProductToCartParams {
     /** ID of the variant to add. */
     variantId: string;
@@ -21,11 +27,15 @@ export interface AddProductToCartParams {
     discounts?: AddProductDiscountParams[];
     /** Array of fees to apply immediately. */
     fees?: AddProductFeeParams[];
+    /** Modifier selections to apply immediately. */
+    modifiers?: AddProductToCartModifierParams[];
     /** Note or array of notes to add immediately. */
     notes?: string | string[];
 }
 export interface AddProductToCartResponse {
     success: boolean;
+    /** Set when the add was rejected (e.g. a required modifier is unanswered). */
+    reason?: string;
     productId: string;
     variantId: string;
     /** The unique identifier for the specific item instance added to the cart. */

package/dist/actions/get-available-transitions/mock.d.ts

@@ -2,7 +2,12 @@ import type { GetAvailableTransitions } from './types';
 /**
  * Mock implementation: returns a fixed set of plausible transitions
  * so the demo app has data to render. Mirrors an UNPAID order under the
- * default (empty cross-axis rules) config: fulfillment can advance without
- * payment (FI-6383), plus the classic park/void moves.
+ * default (empty cross-axis rules) config.
+ *
+ * FULFILLMENT-AXIS ONLY (common 2.1.4 contract): the payment axis never
+ * appears as an available transition — it moves exclusively through the
+ * money operations (pay / refund / void), which derive their own landing
+ * pairs. Every row keeps `to.payment` equal to the order's current payment
+ * state, exactly like the host's `getAvailableTransitions`.
  */
 export declare const getAvailableTransitionsMock: GetAvailableTransitions;

package/dist/actions/get-available-transitions/mock.js

@@ -1,8 +1,13 @@
 /**
  * Mock implementation: returns a fixed set of plausible transitions
  * so the demo app has data to render. Mirrors an UNPAID order under the
- * default (empty cross-axis rules) config: fulfillment can advance without
- * payment (FI-6383), plus the classic park/void moves.
+ * default (empty cross-axis rules) config.
+ *
+ * FULFILLMENT-AXIS ONLY (common 2.1.4 contract): the payment axis never
+ * appears as an available transition — it moves exclusively through the
+ * money operations (pay / refund / void), which derive their own landing
+ * pairs. Every row keeps `to.payment` equal to the order's current payment
+ * state, exactly like the host's `getAvailableTransitions`.
  */
 export const getAvailableTransitionsMock = () => Promise.resolve({
     transitions: [
@@ -22,13 +27,8 @@ export const getAvailableTransitionsMock = () => Promise.resolve({
             conditions: [{ met: true, description: 'Order is open' }],
         },
         {
-            to: { payment: 'paid', fulfillment: 'fulfilled' },
-            displayLabel: 'Complete Payment',
-            conditions: [{ met: true, description: 'Balance due > 0' }],
-        },
-        {
-            to: { payment: 'voided', fulfillment: 'cancelled' },
-            displayLabel: 'Void Order',
+            to: { payment: 'unpaid', fulfillment: 'cancelled' },
+            displayLabel: 'Cancel Order',
             conditions: [
                 { met: true, description: 'Order exists' },
                 { met: false, description: 'No payments captured (mock: skipped)' },

package/dist/actions/get-product-modifier-selections/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Get product modifier selections action (read-only)
+ * Calls the getProductModifierSelections action on the parent window
+ */
+import type { GetProductModifierSelections } from "./types";
+export declare const getProductModifierSelections: GetProductModifierSelections;

package/dist/actions/get-product-modifier-selections/action.js

@@ -0,0 +1,8 @@
+/**
+ * Get product modifier selections action (read-only)
+ * Calls the getProductModifierSelections action on the parent window
+ */
+import { commandFrameClient } from "../../client";
+export const getProductModifierSelections = async (params) => {
+    return await commandFrameClient.call("getProductModifierSelections", params);
+};

package/dist/actions/get-product-modifier-selections/mock.d.ts

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

package/dist/actions/get-product-modifier-selections/mock.js

@@ -0,0 +1,23 @@
+import { MOCK_CART } from "../../demo/database";
+export const mockGetProductModifierSelections = async (params) => {
+    console.log("[Mock] getProductModifierSelections called", params);
+    // Read the line's stored selections from the mock cart (last line when no internalId).
+    const line = params?.internalId
+        ? MOCK_CART.products.find((p) => p.internalId === params.internalId)
+        : MOCK_CART.products[MOCK_CART.products.length - 1];
+    if (!line) {
+        return {
+            success: false,
+            reason: "No matching cart line",
+            internalId: params?.internalId,
+            selections: [],
+            timestamp: new Date().toISOString()
+        };
+    }
+    return {
+        success: true,
+        internalId: line.internalId,
+        selections: line.modifierSelections ?? [],
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/get-product-modifier-selections/types.d.ts

@@ -0,0 +1,30 @@
+/** One chosen choice: `quantity` is units PER LINE-ITEM UNIT (1 unless the control is a stepper). */
+export interface ModifierChoiceSelection {
+    choiceId: string;
+    quantity: number;
+}
+/** The cashier's answer to one modifier. */
+export interface ModifierSelection {
+    modifierId: string;
+    choices: ModifierChoiceSelection[];
+}
+export interface GetProductModifierSelectionsParams {
+    /** The cart line to read. Defaults to the active product's line. */
+    internalId?: string;
+}
+export interface GetProductModifierSelectionsResponse {
+    success: boolean;
+    /** Set when the read failed (e.g. no such line, no active product). */
+    reason?: string;
+    internalId?: string;
+    /**
+     * The line's current modifier selections. Supplied at creation via
+     * `addProductToCart({ modifiers })`; edit them with
+     * `setProductModifierSelections` (full replacement, re-validated).
+     * Modifier DEFINITIONS remain read-only — they flow one-way from
+     * station-sync into the till.
+     */
+    selections: ModifierSelection[];
+    timestamp: string;
+}
+export type GetProductModifierSelections = (params?: GetProductModifierSelectionsParams) => Promise<GetProductModifierSelectionsResponse>;

package/dist/actions/get-product-modifier-selections/types.js

@@ -0,0 +1,2 @@
+// Get Product Modifier Selections Types
+export {};

package/dist/actions/set-product-modifier-selections/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set product modifier selections action
+ * Calls the setProductModifierSelections action on the parent window
+ */
+import type { SetProductModifierSelections } from "./types";
+export declare const setProductModifierSelections: SetProductModifierSelections;

package/dist/actions/set-product-modifier-selections/action.js

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

package/dist/actions/set-product-modifier-selections/mock.d.ts

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

package/dist/actions/set-product-modifier-selections/mock.js

@@ -0,0 +1,34 @@
+import { MOCK_CART } from "../../demo/database";
+export const mockSetProductModifierSelections = async (params) => {
+    console.log("[Mock] setProductModifierSelections called", params);
+    if (!params?.selections) {
+        return {
+            success: false,
+            reason: "selections is required (pass [] to clear)",
+            internalId: params?.internalId,
+            selections: [],
+            timestamp: new Date().toISOString()
+        };
+    }
+    // Write the selections onto the mock cart line (last line when no internalId).
+    // The mock does not re-run rule validation or repricing — the real host does.
+    const line = params.internalId
+        ? MOCK_CART.products.find((p) => p.internalId === params.internalId)
+        : MOCK_CART.products[MOCK_CART.products.length - 1];
+    if (!line) {
+        return {
+            success: false,
+            reason: "No matching cart line",
+            internalId: params.internalId,
+            selections: [],
+            timestamp: new Date().toISOString()
+        };
+    }
+    line.modifierSelections = params.selections;
+    return {
+        success: true,
+        internalId: line.internalId,
+        selections: params.selections,
+        timestamp: new Date().toISOString()
+    };
+};

package/dist/actions/set-product-modifier-selections/types.d.ts

@@ -0,0 +1,22 @@
+import type { ModifierSelection } from "../get-product-modifier-selections/types";
+export interface SetProductModifierSelectionsParams {
+    /** The cart line to edit. Defaults to the active product's line. */
+    internalId?: string;
+    /**
+     * The line's COMPLETE new answers — replaces every existing selection on the
+     * line (send [] to clear all optional modifiers). Validated against the
+     * product's category-modifier rules exactly like addProductToCart({ modifiers }):
+     * a selection that breaks a rule rejects the edit and the line is unchanged.
+     */
+    selections: ModifierSelection[];
+}
+export interface SetProductModifierSelectionsResponse {
+    success: boolean;
+    /** Set when the edit was rejected (rule violation) — the line is unchanged. */
+    reason?: string;
+    internalId?: string;
+    /** The selections now on the line (the new ones on success, the old ones on rejection). */
+    selections: ModifierSelection[];
+    timestamp: string;
+}
+export type SetProductModifierSelections = (params?: SetProductModifierSelectionsParams) => Promise<SetProductModifierSelectionsResponse>;

package/dist/index.d.ts

@@ -21,6 +21,8 @@ export declare const command: {
     readonly getFinalContext: import(".").GetFinalContext;
     readonly addProductNote: import(".").AddProductNote;
     readonly addProductFee: import(".").AddProductFee;
+    readonly getProductModifierSelections: import(".").GetProductModifierSelections;
+    readonly setProductModifierSelections: import(".").SetProductModifierSelections;
     readonly setActiveProductFee: import(".").SetActiveProductFee;
     readonly setActiveProductDiscount: import(".").SetActiveProductDiscount;
     readonly getActiveProduct: import(".").GetActiveProduct;
@@ -41,8 +43,6 @@ export declare const command: {
     readonly extensionPayment: import(".").ExtensionPayment;
     readonly redeemPayment: import(".").RedeemPayment;
     readonly integrationPayment: import(".").IntegrationPayment;
-    readonly createPaymentLink: import(".").CreatePaymentLink;
-    readonly chargeMoto: import(".").ChargeMoto;
     readonly addCustomerNote: import(".").AddCustomerNote;
     readonly removeCustomerNote: import(".").RemoveCustomerNote;
     readonly removeCustomerFromCart: import(".").RemoveCustomerFromCart;
@@ -111,7 +111,6 @@ export declare const command: {
     readonly uploadMedia: import(".").UploadMedia;
     readonly getTaxTables: import(".").GetTaxTables;
     readonly getBranding: import(".").GetBranding;
-    readonly getTimeClockStatus: import(".").GetTimeClockStatus;
     readonly canTransition: import(".").CanTransition;
     readonly getAvailableTransitions: import(".").GetAvailableTransitions;
     readonly applyTransition: import(".").ApplyTransition;
@@ -149,7 +148,7 @@ export type { CheckPermission, CheckPermissionParams, CheckPermissionResponse }
 export type { InitiateRefund, InitiateRefundParams, InitiateRefundResponse } from './actions/initiate-refund/types';
 export type { GetCurrentCart, GetCurrentCartResponse } from './actions/get-current-cart/types';
 export type { AddProductDiscount, AddProductDiscountParams, AddProductDiscountResponse, } from './actions/add-product-discount/types';
-export type { AddProductToCart, AddProductToCartParams, AddProductToCartResponse, } from './actions/add-product-to-cart/types';
+export type { AddProductToCart, AddProductToCartParams, AddProductToCartModifierParams, AddProductToCartResponse, } from './actions/add-product-to-cart/types';
 export type { RemoveProductFromCart, RemoveProductFromCartParams, RemoveProductFromCartResponse, } from './actions/remove-product-from-cart/types';
 export type { UpdateCartItemQuantity, UpdateCartItemQuantityParams, UpdateCartItemQuantityResponse, } from './actions/update-cart-item-quantity/types';
 export type { AddCartDiscount, AddCartDiscountParams, AddCartDiscountResponse, } from './actions/add-cart-discount/types';
@@ -157,6 +156,8 @@ export type { GetContext, GetContextResponse, GetContextResponseManage, GetConte
 export type { GetFinalContext, GetFinalContextResponse } from './actions/get-final-context/types';
 export type { AddProductNote, AddProductNoteParams, AddProductNoteResponse } from './actions/add-product-note/types';
 export type { AddProductFee, AddProductFeeParams, AddProductFeeResponse } from './actions/add-product-fee/types';
+export type { GetProductModifierSelections, GetProductModifierSelectionsParams, GetProductModifierSelectionsResponse, ModifierSelection, ModifierChoiceSelection, } from './actions/get-product-modifier-selections/types';
+export type { SetProductModifierSelections, SetProductModifierSelectionsParams, SetProductModifierSelectionsResponse, } from './actions/set-product-modifier-selections/types';
 export type { SetActiveProductFee, SetActiveProductFeeParams, SetActiveProductFeeResponse, } from './actions/set-active-product-fee/types';
 export type { SetActiveProductDiscount, SetActiveProductDiscountParams, SetActiveProductDiscountResponse, } from './actions/set-active-product-discount/types';
 export type { GetActiveProduct, GetActiveProductResponse } from './actions/get-active-product/types';
@@ -176,8 +177,6 @@ export type { TerminalPayment, TerminalPaymentParams, TerminalPaymentResponse }
 export type { ExtensionPayment, ExtensionPaymentParams, ExtensionPaymentResponse, } from './actions/extension-payment/types';
 export type { RedeemPayment, RedeemPaymentParams, RedeemPaymentResponse } from './actions/redeem-payment/types';
 export type { IntegrationPayment, IntegrationPaymentParams, IntegrationPaymentResponse, IntegrationEmvData, } from './actions/integration-payment/types';
-export type { CreatePaymentLink, CreatePaymentLinkParams, CreatePaymentLinkResponse, } from './actions/create-payment-link/types';
-export type { ChargeMoto, ChargeMotoParams, ChargeMotoResponse, ChargeMotoCardFields, } from './actions/charge-moto/types';
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse, } from './actions/add-customer-note/types';
 export type { RemoveCustomerNote, RemoveCustomerNoteParams, RemoveCustomerNoteResponse, } from './actions/remove-customer-note/types';
 export type { RemoveCustomerFromCart, RemoveCustomerFromCartResponse } from './actions/remove-customer-from-cart/types';
@@ -191,7 +190,6 @@ export type { GetMedia, GetMediaParams, GetMediaResponse, MediaItemPayload } fro
 export type { UploadMedia, UploadMediaParams, UploadMediaResponse } from './actions/upload-media/types';
 export type { GetTaxTables, GetTaxTablesResponse, TaxRatePayload, TaxTablePayload, } from './actions/get-tax-tables/types';
 export type { BorderRadiusPreset, GetBranding, GetBrandingResponse } from './actions/get-branding/types';
-export type { GetTimeClockStatus, GetTimeClockStatusResponse, TimeClockEntry, } from './actions/get-time-clock-status/types';
 export type { ShowConfirmation, ShowConfirmationParams, ShowConfirmationResponse, } from './actions/show-confirmation/types';
 export type { AuthenticateUser, AuthenticateUserParams, AuthenticateUserResponse, } from './actions/authenticate-user/types';
 export type { PartialPayment, PartialPaymentParams, PartialPaymentResponse } from './actions/partial-payment/types';

package/dist/index.js

@@ -20,6 +20,8 @@ import { updateCartItemQuantity } from './actions/update-cart-item-quantity/acti
 // Product Actions
 import { addProductNote } from './actions/add-product-note/action';
 import { addProductFee } from './actions/add-product-fee/action';
+import { getProductModifierSelections } from './actions/get-product-modifier-selections/action';
+import { setProductModifierSelections } from './actions/set-product-modifier-selections/action';
 import { setActiveProductFee } from './actions/set-active-product-fee/action';
 import { setActiveProductDiscount } from './actions/set-active-product-discount/action';
 import { getActiveProduct } from './actions/get-active-product/action';
@@ -41,8 +43,6 @@ import { terminalPayment } from './actions/terminal-payment/action';
 import { extensionPayment } from './actions/extension-payment/action';
 import { redeemPayment } from './actions/redeem-payment/action';
 import { integrationPayment } from './actions/integration-payment/action';
-import { createPaymentLink } from './actions/create-payment-link/action';
-import { chargeMoto } from './actions/charge-moto/action';
 // Customer Actions
 import { addCustomerNote } from './actions/add-customer-note/action';
 import { removeCustomerNote } from './actions/remove-customer-note/action';
@@ -130,8 +130,6 @@ import { getMedia } from './actions/get-media/action';
 import { uploadMedia } from './actions/upload-media/action';
 import { getTaxTables } from './actions/get-tax-tables/action';
 import { getBranding } from './actions/get-branding/action';
-// Time Clock Actions
-import { getTimeClockStatus } from './actions/get-time-clock-status/action';
 // Export actions as command object
 export const command = {
     exampleFunction,
@@ -157,6 +155,8 @@ export const command = {
     // Product Actions
     addProductNote,
     addProductFee,
+    getProductModifierSelections,
+    setProductModifierSelections,
     setActiveProductFee,
     setActiveProductDiscount,
     getActiveProduct,
@@ -178,8 +178,6 @@ export const command = {
     extensionPayment,
     redeemPayment,
     integrationPayment,
-    createPaymentLink,
-    chargeMoto,
     // Customer Actions
     addCustomerNote,
     removeCustomerNote,
@@ -262,8 +260,6 @@ export const command = {
     uploadMedia,
     getTaxTables,
     getBranding,
-    // Time Clock Actions
-    getTimeClockStatus,
     // State Machine Queries
     canTransition,
     getAvailableTransitions,

package/dist/projects/render/mocks.js

@@ -12,6 +12,8 @@ import { mockAddOrderNote } from '../../actions/add-order-note/mock';
 import { mockRemoveOrderNote } from '../../actions/remove-order-note/mock';
 import { mockAddProductDiscount } from '../../actions/add-product-discount/mock';
 import { mockAddProductFee } from '../../actions/add-product-fee/mock';
+import { mockGetProductModifierSelections } from '../../actions/get-product-modifier-selections/mock';
+import { mockSetProductModifierSelections } from '../../actions/set-product-modifier-selections/mock';
 import { mockRemoveProductDiscount } from '../../actions/remove-product-discount/mock';
 import { mockRemoveProductFee } from '../../actions/remove-product-fee/mock';
 import { mockSetActiveProductFee } from '../../actions/set-active-product-fee/mock';
@@ -29,9 +31,6 @@ import { mockAuthenticateUser } from '../../actions/authenticate-user/mock';
 import { mockCalculateRefundTotal } from '../../actions/calculate-refund-total/mock';
 import { mockCashPayment } from '../../actions/cash-payment/mock';
 import { mockGetCashRoundingAmount } from '../../actions/get-cash-rounding-amount/mock';
-import { mockCreatePaymentLink } from '../../actions/create-payment-link/mock';
-import { mockChargeMoto } from '../../actions/charge-moto/mock';
-import { mockGetTimeClockStatus } from '../../actions/get-time-clock-status/mock';
 import { mockClearCart } from '../../actions/clear-cart/mock';
 import { mockDeleteParkedOrder } from '../../actions/delete-parked-order/mock';
 import { mockVoidOrder } from '../../actions/void-order/mock';
@@ -112,6 +111,8 @@ export const RENDER_MOCKS = {
     addOrderNote: mockAddOrderNote,
     addProductDiscount: mockAddProductDiscount,
     addProductFee: mockAddProductFee,
+    getProductModifierSelections: mockGetProductModifierSelections,
+    setProductModifierSelections: mockSetProductModifierSelections,
     setActiveProductFee: mockSetActiveProductFee,
     setActiveProductDiscount: mockSetActiveProductDiscount,
     getActiveProduct: mockGetActiveProduct,
@@ -126,8 +127,6 @@ export const RENDER_MOCKS = {
     calculateRefundTotal: mockCalculateRefundTotal,
     cashPayment: mockCashPayment,
     getCashRoundingAmount: mockGetCashRoundingAmount,
-    createPaymentLink: mockCreatePaymentLink,
-    chargeMoto: mockChargeMoto,
     clearCart: mockClearCart,
     deleteParkedOrder: mockDeleteParkedOrder,
     voidOrder: mockVoidOrder,
@@ -204,5 +203,4 @@ export const RENDER_MOCKS = {
     saveSmartGridLayout: mockSaveSmartGridLayout,
     sendEmail: mockSendEmail,
     sendSms: mockSendSms,
-    getTimeClockStatus: mockGetTimeClockStatus,
 };

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

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, 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, VoidOrder, InitiateRefund, CashPayment, 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, CreatePaymentLink, ChargeMoto, GetTimeClockStatus } from '../../index';
+import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, 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 } from '../../index';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -21,6 +21,8 @@ export interface RenderProviderActions {
     getFinalContext: GetFinalContext;
     addProductNote: AddProductNote;
     addProductFee: AddProductFee;
+    getProductModifierSelections: GetProductModifierSelections;
+    setProductModifierSelections: SetProductModifierSelections;
     setActiveProductFee: SetActiveProductFee;
     setActiveProductDiscount: SetActiveProductDiscount;
     getActiveProduct: GetActiveProduct;
@@ -41,8 +43,6 @@ export interface RenderProviderActions {
     extensionPayment: ExtensionPayment;
     redeemPayment: RedeemPayment;
     integrationPayment: IntegrationPayment;
-    createPaymentLink: CreatePaymentLink;
-    chargeMoto: ChargeMoto;
     addNonRevenueItem: AddNonRevenueItem;
     addCustomerNote: AddCustomerNote;
     removeCustomerNote: RemoveCustomerNote;
@@ -103,5 +103,4 @@ export interface RenderProviderActions {
     saveSmartGridLayout: SaveSmartGridLayout;
     sendEmail: SendEmail;
     sendSms: SendSms;
-    getTimeClockStatus: GetTimeClockStatus;
 }

package/dist/pubsub/topics/cart/product-modifiers-updated/types.d.ts

@@ -0,0 +1,16 @@
+import type { CFActiveProduct, CFModifierSelection } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for product-modifiers-updated event (FT-0010) — fired when a cart
+ * line's modifier selections are replaced via setProductModifierSelections.
+ */
+export interface ProductModifiersUpdatedPayload {
+    product: CFActiveProduct;
+    internalId?: string;
+    /** The line's complete new answers (full replacement). */
+    selections: CFModifierSelection[];
+}
+/**
+ * Typed event for product-modifiers-updated
+ */
+export type ProductModifiersUpdatedEvent = TopicEvent<ProductModifiersUpdatedPayload>;

package/dist/pubsub/topics/cart/product-modifiers-updated/types.js

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

package/dist/pubsub/topics/cart/types.d.ts

@@ -17,6 +17,7 @@ export * from "./product-fee-added/types";
 export * from "./product-fee-removed/types";
 export * from "./product-note-added/types";
 export * from "./product-note-removed/types";
+export * from "./product-modifiers-updated/types";
 import type { CartCreatedPayload } from "./cart-created/types";
 import type { CartCustomerAssignedPayload } from "./customer-assigned/types";
 import type { ProductAddedPayload } from "./product-added/types";
@@ -32,5 +33,6 @@ import type { ProductFeeAddedPayload } from "./product-fee-added/types";
 import type { ProductFeeRemovedPayload } from "./product-fee-removed/types";
 import type { ProductNoteAddedPayload } from "./product-note-added/types";
 import type { ProductNoteRemovedPayload } from "./product-note-removed/types";
-export type CartEventPayload = CartCreatedPayload | CartCustomerAssignedPayload | ProductAddedPayload | ProductDeletedPayload | CartProductUpdatedPayload | CartDiscountAddedPayload | CartDiscountRemovedPayload | CartFeeAddedPayload | CartFeeRemovedPayload | ProductDiscountAddedPayload | ProductDiscountRemovedPayload | ProductFeeAddedPayload | ProductFeeRemovedPayload | ProductNoteAddedPayload | ProductNoteRemovedPayload;
-export type CartEventType = "cart-created" | "customer-assigned" | "customer-unassigned" | "product-added" | "product-deleted" | "product-updated" | "cart-discount-added" | "cart-discount-removed" | "cart-fee-added" | "cart-fee-removed" | "product-discount-added" | "product-discount-removed" | "product-fee-added" | "product-fee-removed" | "product-note-added" | "product-note-removed";
+import type { ProductModifiersUpdatedPayload } from "./product-modifiers-updated/types";
+export type CartEventPayload = CartCreatedPayload | CartCustomerAssignedPayload | ProductAddedPayload | ProductDeletedPayload | CartProductUpdatedPayload | CartDiscountAddedPayload | CartDiscountRemovedPayload | CartFeeAddedPayload | CartFeeRemovedPayload | ProductDiscountAddedPayload | ProductDiscountRemovedPayload | ProductFeeAddedPayload | ProductFeeRemovedPayload | ProductNoteAddedPayload | ProductNoteRemovedPayload | ProductModifiersUpdatedPayload;
+export type CartEventType = "cart-created" | "customer-assigned" | "customer-unassigned" | "product-added" | "product-deleted" | "product-updated" | "cart-discount-added" | "cart-discount-removed" | "cart-fee-added" | "cart-fee-removed" | "product-discount-added" | "product-discount-removed" | "product-fee-added" | "product-fee-removed" | "product-note-added" | "product-note-removed" | "product-modifiers-updated";

package/dist/pubsub/topics/cart/types.js

@@ -18,3 +18,4 @@ export * from "./product-fee-added/types";
 export * from "./product-fee-removed/types";
 export * from "./product-note-added/types";
 export * from "./product-note-removed/types";
+export * from "./product-modifiers-updated/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.6.0-staging.5",
+  "version": "0.6.0-staging3.1",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,7 @@
     "ignoreBranchesMissingTickets": true
   },
   "dependencies": {
-    "@final-commerce/common": "2.2.0-staging.4"
+    "@final-commerce/common": "2.2.3-staging3.1"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.0.0",

package/dist/actions/charge-moto/action.d.ts

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

package/dist/actions/charge-moto/action.js

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

package/dist/actions/charge-moto/mock.d.ts

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

package/dist/actions/charge-moto/mock.js

@@ -1,47 +0,0 @@
-import { applyMockPayment, MOCK_CART } from '../../demo/database';
-/** Mirrors kaching's `MOTO_MIN_AMOUNT_MINOR` — the processors' floor. */
-const MOTO_MIN_AMOUNT_MINOR = 50;
-/** The card fields that must be present and non-empty on every keyed charge. */
-const REQUIRED_CARD_FIELDS = [
-    'encryptedCardNumber',
-    'encryptedExpiryMonth',
-    'encryptedExpiryYear',
-    'encryptedSecurityCode',
-];
-export const mockChargeMoto = async (params) => {
-    console.log('[Mock] chargeMoto called', params);
-    if (!params)
-        throw new Error('Params required');
-    if (!Number.isInteger(params.amount)) {
-        throw new Error('amount must be an integer number of minor units');
-    }
-    if (params.amount < MOTO_MIN_AMOUNT_MINOR) {
-        throw new Error(`amount must be at least ${MOTO_MIN_AMOUNT_MINOR} minor units`);
-    }
-    for (const field of REQUIRED_CARD_FIELDS) {
-        const value = params.card?.[field];
-        if (!value || !value.trim()) {
-            throw new Error(`card.${field} is required`);
-        }
-    }
-    if (!params.idempotencyKey || !params.idempotencyKey.trim()) {
-        throw new Error('idempotencyKey is required so a retry replays instead of recharging');
-    }
-    const balanceDue = MOCK_CART.amountToBeCharged ?? MOCK_CART.total;
-    if (params.amount > balanceDue) {
-        throw new Error(`amount ${params.amount} exceeds balance due ${balanceDue}`);
-    }
-    // The mock always completes the sale in one leg — it does not model
-    // kaching's real partial-leg (`saleFinalized: false`) path.
-    const order = applyMockPayment(balanceDue, 'card', 'adyen');
-    if (!order) {
-        throw new Error('MOCK_CHARGE_MOTO_PARTIAL_UNSUPPORTED: the mock only supports charging the full balance due');
-    }
-    return {
-        success: true,
-        timestamp: new Date().toISOString(),
-        order,
-        saleFinalized: true,
-        remainingBalance: 0,
-    };
-};

package/dist/actions/charge-moto/types.d.ts

@@ -1,53 +0,0 @@
-import { CFOrder } from '../../CommonTypes';
-/**
- * Provider-encrypted card fields, opaque to this library — mirrors kaching's
- * `MotoCardFields` field for field. Never a raw PAN: these are the CSE blobs
- * the provider's own client-side encrypter produces.
- */
-export interface ChargeMotoCardFields {
-    encryptedCardNumber: string;
-    encryptedExpiryMonth: string;
-    encryptedExpiryYear: string;
-    encryptedSecurityCode: string;
-    /** Optional AVS postal code the operator entered. */
-    postalCode?: string;
-    /** Provider-side `reference` for this payment. Defaults to the idempotency key server-side. */
-    reference?: string;
-}
-export interface ChargeMotoParams {
-    /**
-     * Total to charge, base + tip, in integer MINOR currency units. Minimum 50
-     * minor units (the processors' floor). This is the leg amount: a value
-     * below the cart's balance due records a partial payment.
-     */
-    amount: number;
-    /** Tip portion of `amount`, already collected by the caller's own UI. Defaults to 0. */
-    tipAmount?: number;
-    /**
-     * ISO 4217 code. Optional — the active company's currency is authoritative.
-     * When supplied it must match, or the charge is rejected before anything is sent.
-     */
-    currency?: string;
-    card: ChargeMotoCardFields;
-    /**
-     * Idempotency key for this charge, HELD BY THE CALLER across retries. A
-     * retried charge must carry the SAME key so the charge is replayed instead
-     * of doubled; use a NEW key after changing the amount.
-     */
-    idempotencyKey: string;
-    /** Optional tender label recorded on the payment method. */
-    paymentName?: string;
-    /** Fulfillment state to land on after full payment (default: auto-fulfill). */
-    targetFulfillmentState?: string;
-}
-export interface ChargeMotoResponse {
-    success: boolean;
-    timestamp: string;
-    /** The persisted order the charge landed on. */
-    order: CFOrder;
-    /** True only when this charge completed the sale (`paymentState === 'paid'`). */
-    saleFinalized: boolean;
-    /** Balance still due after this charge, in integer minor units. 0 when finalized. */
-    remainingBalance: number;
-}
-export type ChargeMoto = (params: ChargeMotoParams) => Promise<ChargeMotoResponse>;

package/dist/actions/create-payment-link/action.d.ts

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

package/dist/actions/create-payment-link/action.js

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

package/dist/actions/create-payment-link/mock.d.ts

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

package/dist/actions/create-payment-link/mock.js

@@ -1,35 +0,0 @@
-import { MOCK_CART, mockPublishEvent, resetMockCart } from '../../demo/database';
-export const mockCreatePaymentLink = async (params) => {
-    console.log('[Mock] createPaymentLink called', params);
-    if (!params)
-        throw new Error('Params required');
-    const email = params.email?.trim() ? params.email : undefined;
-    const phone = params.phone?.trim() ? params.phone : undefined;
-    if (email && phone) {
-        throw new Error('exactly one of email or phone delivers a payment link, not both');
-    }
-    if (!email && !phone) {
-        throw new Error('exactly one of email or phone is required to deliver the payment link');
-    }
-    const hasCart = MOCK_CART.products.length > 0 ||
-        (MOCK_CART.customSales?.length ?? 0) > 0 ||
-        (MOCK_CART.nonRevenueItems?.length ?? 0) > 0;
-    if (!hasCart || MOCK_CART.total <= 0) {
-        throw new Error('ring the sale up before creating a payment link: the cart is empty');
-    }
-    const mockOrderId = 'order_' + Date.now();
-    const mockLinkId = 'link_' + Math.random().toString(36).substr(2, 9);
-    // Marks the cart consumed, same as a successful send in kaching — the order
-    // now owns the line.
-    resetMockCart();
-    mockPublishEvent('cart', 'cart-created', {});
-    return {
-        success: true,
-        timestamp: new Date().toISOString(),
-        orderId: mockOrderId,
-        url: `https://mock.finalpos.dev/pay/${mockLinkId}`,
-        id: mockLinkId,
-        expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
-        delivery: email ? { email: 'sent' } : { sms: 'sent' },
-    };
-};

package/dist/actions/create-payment-link/types.d.ts

@@ -1,27 +0,0 @@
-export interface CreatePaymentLinkParams {
-    /** Address to email the link to. Exactly one of `email`/`phone` is required. */
-    email?: string;
-    /** Phone number to text the link to, E.164 (e.g. "+15555550123"). Exactly one of `email`/`phone` is required. */
-    phone?: string;
-}
-export interface CreatePaymentLinkResponse {
-    success: boolean;
-    timestamp: string;
-    /** Client `_id` of the order the station created for this link (charges the CURRENT CART). */
-    orderId: string;
-    /** Hosted payment page to send the shopper. */
-    url: string;
-    /** The provider's payment-link id. */
-    id: string;
-    /** When the link stops accepting payment (ISO date string). */
-    expiresAt: string;
-    /**
-     * Per-channel delivery outcome. OPTIONAL: an older hub omits it entirely,
-     * which reads as "delivered" — treat absence as success, not as a failure.
-     */
-    delivery?: {
-        email?: 'sent' | 'failed';
-        sms?: 'sent' | 'failed';
-    };
-}
-export type CreatePaymentLink = (params: CreatePaymentLinkParams) => Promise<CreatePaymentLinkResponse>;

package/dist/actions/create-payment-link/types.js

@@ -1,12 +0,0 @@
-// Create Payment Link Types
-//
-// Creates a hosted payment link FOR THE CURRENT CART (station-v2 D-decisions,
-// payment-link addendum). Mirrors kaching's `createPaymentLinkFromCart` input
-// (`CreatePaymentLinkFromCartInput`) and result (`PaymentLinkFromCartResult`,
-// which extends the provider's `PaymentLinkResponse` with the local `orderId`).
-//
-// The station creates the order (client `_id`, `unpaid × in_progress`) BEFORE
-// the link is requested — only that id travels on the wire. On success the
-// cart is cleared; on a failed send the order is voided and the cart is kept
-// so the cashier can retry. Adyen-only today.
-export {};

package/dist/actions/get-time-clock-status/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Get time clock status action
- * Calls the getTimeClockStatus action on the parent window
- */
-import type { GetTimeClockStatus } from './types';
-export declare const getTimeClockStatus: GetTimeClockStatus;

package/dist/actions/get-time-clock-status/action.js

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

package/dist/actions/get-time-clock-status/mock.d.ts

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

package/dist/actions/get-time-clock-status/mock.js

@@ -1,17 +0,0 @@
-/** Fixed shift start used by the mock — a clocked-in snapshot with no break taken. */
-const MOCK_CLOCK_IN_TIME = new Date(Date.now() - 2 * 60 * 60 * 1000).toISOString();
-export const mockGetTimeClockStatus = async (params) => {
-    console.log('[Mock] getTimeClockStatus called', params);
-    const workedMs = Date.now() - new Date(MOCK_CLOCK_IN_TIME).getTime();
-    return {
-        success: true,
-        timestamp: new Date().toISOString(),
-        status: 'clocked-in',
-        entry: {
-            clockInTime: MOCK_CLOCK_IN_TIME,
-            breakStartedAt: null,
-            totalBreakMinutes: 0,
-            workedMs,
-        },
-    };
-};

package/dist/actions/get-time-clock-status/types.d.ts

@@ -1,18 +0,0 @@
-export interface TimeClockEntry {
-    /** ISO date string of when the current shift started. */
-    clockInTime: string;
-    /** ISO date string of when the current break started, or `null` when not on break. */
-    breakStartedAt: string | null;
-    /** Total break time accumulated on this shift so far, in minutes. */
-    totalBreakMinutes: number;
-    /** Milliseconds worked so far on this shift, as of when this response was generated. */
-    workedMs: number;
-}
-export interface GetTimeClockStatusResponse {
-    success: boolean;
-    timestamp: string;
-    status: 'out' | 'clocked-in' | 'on-break';
-    /** `null` when `status` is `'out'`. */
-    entry: TimeClockEntry | null;
-}
-export type GetTimeClockStatus = (params?: Record<string, never>) => Promise<GetTimeClockStatusResponse>;

package/dist/actions/get-time-clock-status/types.js

@@ -1,7 +0,0 @@
-// Get Time Clock Status Types
-//
-// READ-ONLY query: is the active employee clocked out, clocked in, or on
-// break, and since when? There are no clock-in/clock-out commands — this
-// action only reports the current state; `workedMs` is a snapshot at call
-// time and flows are expected to tick it client-side from `clockInTime`.
-export {};