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

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

@@ -1,36 +1,53 @@
-import { MOCK_PRODUCTS, safeSerialize } from "../../demo/database";
+import { MOCK_PRODUCTS, safeSerialize } from '../../demo/database';
+import { resolveUnit } from '@final-commerce/common';
 export const mockGetProducts = async (params) => {
-    console.log("[Mock] getProducts called", params);
+    console.log('[Mock] getProducts called', params);
     // Simple filter simulation
     let products = MOCK_PRODUCTS;
     const query = params?.query || {};
     if (query.searchValue) {
         const search = String(query.searchValue).toLowerCase();
-        products = products.filter(p => p.name.toLowerCase().includes(search) ||
-            p.sku?.toLowerCase().includes(search));
+        products = products.filter((p) => p.name.toLowerCase().includes(search) || p.sku?.toLowerCase().includes(search));
     }
     if (query.categories) {
         // Handle categories filter: { $in: [...] } or direct string
         const catFilter = query.categories;
         if (typeof catFilter === 'string') {
-            products = products.filter(p => (p.categories || []).some(c => c.name === catFilter));
+            products = products.filter((p) => (p.categories || []).some((c) => c.name === catFilter));
         }
         else if (typeof catFilter === 'object' && '$in' in catFilter) {
             const inList = catFilter.$in;
-            products = products.filter(p => (p.categories || []).some(c => inList.includes(c.name)));
+            products = products.filter((p) => (p.categories || []).some((c) => inList.includes(c.name)));
         }
         else if (typeof catFilter === 'object' && '$contains' in catFilter) {
             const containsVal = catFilter.$contains;
-            products = products.filter(p => (p.categories || []).some(c => c.name.includes(containsVal)));
+            products = products.filter((p) => (p.categories || []).some((c) => c.name.includes(containsVal)));
         }
     }
     const total = products.length;
     const offset = params?.offset ?? 0;
     const limit = params?.limit ?? 100;
     const paged = products.slice(offset, offset + limit);
+    // Mirror the real host's attachUnits: storage carries only `unitId`, the wire shape
+    // adds the RESOLVED unit (abbreviation, ratioToBase, precision) so a card can label
+    // stock and a quantity input can pick its step. Unresolvable ids pass through bare
+    // rather than killing the page — same stance as the host's per-variant catch.
+    const withUnits = safeSerialize(paged).map((product) => ({
+        ...product,
+        variants: (product.variants ?? []).map((variant) => {
+            if (!variant.unitId)
+                return variant;
+            try {
+                return { ...variant, unit: resolveUnit(variant.unitId) };
+            }
+            catch {
+                return variant;
+            }
+        }),
+    }));
     return {
-        products: safeSerialize(paged),
+        products: withUnits,
         total,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     };
 };

package/dist/actions/get-refunds/types.d.ts

@@ -1,4 +1,4 @@
-import { CFRefundItem } from "../../CommonTypes";
+import { CFRefundItem } from '../../CommonTypes';
 export interface GetRefundsParams {
     orderId?: string;
     sessionId?: string;

package/dist/actions/get-remaining-refundable-quantities/action.d.ts

@@ -2,5 +2,5 @@
  * Get remaining refundable quantities action
  * Calls the getRemainingRefundableQuantities action on the parent window
  */
-import type { GetRemainingRefundableQuantities } from "./types";
+import type { GetRemainingRefundableQuantities } from './types';
 export declare const getRemainingRefundableQuantities: GetRemainingRefundableQuantities;

package/dist/actions/get-remaining-refundable-quantities/action.js

@@ -2,7 +2,7 @@
  * Get remaining refundable quantities action
  * Calls the getRemainingRefundableQuantities action on the parent window
  */
-import { commandFrameClient } from "../../client";
+import { commandFrameClient } from '../../client';
 export const getRemainingRefundableQuantities = async (params) => {
-    return await commandFrameClient.call("getRemainingRefundableQuantities", params);
+    return await commandFrameClient.call('getRemainingRefundableQuantities', params);
 };

package/dist/actions/get-remaining-refundable-quantities/mock.d.ts

@@ -1,2 +1,2 @@
-import { GetRemainingRefundableQuantities } from "./types";
+import { GetRemainingRefundableQuantities } from './types';
 export declare const mockGetRemainingRefundableQuantities: GetRemainingRefundableQuantities;

package/dist/actions/get-remaining-refundable-quantities/mock.js

@@ -1,11 +1,11 @@
 export const mockGetRemainingRefundableQuantities = async (_params) => {
-    console.log("[Mock] getRemainingRefundableQuantities called", _params);
+    console.log('[Mock] getRemainingRefundableQuantities called', _params);
     return {
         success: true,
         lineItems: {},
         customSales: {},
         cartFees: {},
         tips: {},
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     };
 };

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

@@ -1,4 +1,4 @@
-import type { ExtensionPaymentResponse } from "../extension-payment/types";
+import type { ExtensionPaymentResponse } from '../extension-payment/types';
 /**
  * Card display fields for an integration payment.
  *

package/dist/actions/park-order/types.d.ts

@@ -1,4 +1,4 @@
-import { CFOrder } from "../../CommonTypes";
+import { CFOrder } from '../../CommonTypes';
 export interface ParkOrderResponse {
     success: boolean;
     order: CFOrder;

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

@@ -1,2 +1,2 @@
-import { PartialPayment } from "./types";
+import { PartialPayment } from './types';
 export declare const mockPartialPayment: PartialPayment;

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

@@ -1,18 +1,18 @@
-import { MOCK_CART, mockPublishEvent } from "../../demo/database";
-import { percentToFraction, requireMinorUnitsInteger } from "../../demo/units";
+import { MOCK_CART, mockPublishEvent } from '../../demo/database';
+import { percentToFraction, requireMinorUnitsInteger } from '../../demo/units';
 export const mockPartialPayment = async (params) => {
-    console.log("[Mock] partialPayment called", params);
+    console.log('[Mock] partialPayment called', params);
     const openUI = params?.openUI ?? true;
     if (openUI) {
         // Split-payment UI is host-owned; nothing to simulate here.
-        window.alert("Demo: Split Payment UI would open here.");
+        window.alert('Demo: Split Payment UI would open here.');
         return {
             success: true,
             amount: params?.amount,
             isPercent: params?.isPercent || false,
             openUI,
             order: null,
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
         };
     }
     // Queue a partial amount as the next tender. The remaining balance is left
@@ -23,15 +23,15 @@ export const mockPartialPayment = async (params) => {
     // directly; a percent is raw 0-100 against the remaining total.
     const charge = params?.isPercent
         ? Math.round(remaining * percentToFraction(raw))
-        : requireMinorUnitsInteger(raw, "Payment amount");
+        : requireMinorUnitsInteger(raw, 'Payment amount');
     MOCK_CART.amountToBeCharged = Math.min(Math.max(0, charge), remaining);
-    mockPublishEvent("cart", "partial-payment-set", { amountToBeCharged: MOCK_CART.amountToBeCharged });
+    mockPublishEvent('cart', 'partial-payment-set', { amountToBeCharged: MOCK_CART.amountToBeCharged });
     return {
         success: true,
         amount: params?.amount,
         isPercent: params?.isPercent || false,
         openUI,
         order: null,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     };
 };

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

@@ -1,4 +1,4 @@
-import { CFOrder } from "../../CommonTypes";
+import { CFOrder } from '../../CommonTypes';
 export interface PartialPaymentParams {
     /** The payment amount in integer MINOR currency units (required if openUI is false). If isPercent is true, this is a percentage (0-100) instead. */
     amount?: number;

package/dist/actions/print/mock.d.ts

@@ -1,2 +1,2 @@
-import { Print } from "./types";
+import { Print } from './types';
 export declare const mockPrint: Print;

package/dist/actions/print/mock.js

@@ -1,25 +1,25 @@
 export const mockPrint = (params) => {
-    console.log("[Mock] print called", params);
+    console.log('[Mock] print called', params);
     if (!params) {
-        throw new Error("Print parameters are required");
+        throw new Error('Print parameters are required');
     }
     // Mock implementation - just log what would be printed
     switch (params.type) {
-        case "image":
-            console.log("[Mock] Would print image:", params.data.image?.substring(0, 50) + "...");
+        case 'image':
+            console.log('[Mock] Would print image:', params.data.image?.substring(0, 50) + '...');
             break;
-        case "html":
+        case 'html':
             console.warn("[Mock] print type 'html' is DEPRECATED — rasterize and use type: 'image'.");
-            console.log("[Mock] Would print HTML:", params.data.html?.substring(0, 100) + "...");
+            console.log('[Mock] Would print HTML:', params.data.html?.substring(0, 100) + '...');
             break;
-        case "receipt":
+        case 'receipt':
             console.warn("[Mock] print type 'receipt' is DEPRECATED — rasterize and use type: 'image'.");
-            console.log("[Mock] Would print receipt for order:", params.data.order);
+            console.log('[Mock] Would print receipt for order:', params.data.order);
             break;
     }
     return Promise.resolve({
         success: true,
         timestamp: new Date().toISOString(),
-        type: params.type
+        type: params.type,
     });
 };

package/dist/actions/print/types.d.ts

@@ -1,14 +1,14 @@
-import type { CFActiveOrder } from "../../CommonTypes";
-export type PrintType = "image" | "html" | "receipt";
+import type { CFActiveOrder } from '../../CommonTypes';
+export type PrintType = 'image' | 'html' | 'receipt';
 export type PrintParams = {
-    type: "image";
+    type: 'image';
     data: {
         image: string;
     };
     options?: PrintOptions;
 } | {
     /** @deprecated Rasterize your HTML and use `type: "image"`. The native path posts raw HTML to the shell (no html2canvas/sanitization) and PrintOptions may be dropped. */
-    type: "html";
+    type: 'html';
     data: {
         html: string;
     };
@@ -19,9 +19,9 @@ export type PrintParams = {
      * The station requires `order` (no active-order fallback), ignores
      * `globalBlockId`, and drops ALL PrintOptions (including tag routing).
      */
-    type: "receipt";
+    type: 'receipt';
     data: {
-        order?: Omit<CFActiveOrder, "_id">;
+        order?: Omit<CFActiveOrder, '_id'>;
         globalBlockId?: string;
     };
     options?: PrintOptions;

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

@@ -1,4 +1,4 @@
-import type { ExtensionPaymentResponse } from "../extension-payment/types";
+import type { ExtensionPaymentResponse } from '../extension-payment/types';
 /**
  * Redeem (e.g. gift card) — always uses paymentType `"redeem"` on the wire.
  * `amount` is required so the persisted payment never silently falls back to the cart

package/dist/actions/remove-cart-fee/mock.d.ts

@@ -1,2 +1,2 @@
-import type { RemoveCartFee } from "./types";
+import type { RemoveCartFee } from './types';
 export declare const mockRemoveCartFee: RemoveCartFee;

package/dist/actions/remove-cart-fee/mock.js

@@ -1,4 +1,4 @@
-import { MOCK_CART, mockPublishEvent } from "../../demo/database";
+import { MOCK_CART, mockPublishEvent } from '../../demo/database';
 function feeContributionToTotal(fee, subtotal) {
     // A percent fee is STORED as a fraction (10% -> 0.1), so it scales the
     // subtotal directly. Dividing by 100 again credited back a hundredth of the
@@ -9,14 +9,14 @@ function feeContributionToTotal(fee, subtotal) {
     return fee.amount;
 }
 export const mockRemoveCartFee = (params) => {
-    console.log("[Mock] removeCartFee called", params);
+    console.log('[Mock] removeCartFee called', params);
     const { index } = params;
-    if (typeof index !== "number" || !Number.isInteger(index) || index < 0) {
-        throw new Error("removeCartFee requires a non-negative integer index");
+    if (typeof index !== 'number' || !Number.isInteger(index) || index < 0) {
+        throw new Error('removeCartFee requires a non-negative integer index');
     }
     const fees = MOCK_CART.customFee;
     if (!fees?.length) {
-        throw new Error("Cart has no fees to remove");
+        throw new Error('Cart has no fees to remove');
     }
     if (index >= fees.length) {
         throw new Error(`Cart fee index ${index} is out of range (0–${fees.length - 1})`);
@@ -30,9 +30,9 @@ export const mockRemoveCartFee = (params) => {
     MOCK_CART.total -= delta;
     MOCK_CART.amountToBeCharged = MOCK_CART.total;
     MOCK_CART.remainingBalance = MOCK_CART.total;
-    mockPublishEvent("cart", "cart-fee-removed", { feeIndex: index });
+    mockPublishEvent('cart', 'cart-fee-removed', { feeIndex: index });
     return Promise.resolve({
         success: true,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     });
 };

package/dist/actions/remove-product-from-cart/mock.d.ts

@@ -1,2 +1,2 @@
-import { RemoveProductFromCart } from "./types";
+import { RemoveProductFromCart } from './types';
 export declare const mockRemoveProductFromCart: RemoveProductFromCart;

package/dist/actions/remove-product-from-cart/mock.js

@@ -1,12 +1,13 @@
-import { MOCK_CART, mockPublishEvent } from "../../demo/database";
+import { MOCK_CART, mockPublishEvent } from '../../demo/database';
+import { extendPrice } from '@final-commerce/common';
 export const mockRemoveProductFromCart = (params) => {
-    console.log("[Mock] removeProductFromCart called", params);
+    console.log('[Mock] removeProductFromCart called', params);
     if (!params?.internalId) {
-        throw new Error("internalId is required");
+        throw new Error('internalId is required');
     }
     const { internalId } = params;
     // Find the product in the cart
-    const productIndex = MOCK_CART.products.findIndex(p => p.internalId === internalId);
+    const productIndex = MOCK_CART.products.findIndex((p) => p.internalId === internalId);
     if (productIndex === -1) {
         throw new Error(`Cart item with internalId ${internalId} not found`);
     }
@@ -14,19 +15,21 @@ export const mockRemoveProductFromCart = (params) => {
     // Remove from cart
     MOCK_CART.products.splice(productIndex, 1);
     // Recalculate totals
-    const lineTotal = product.price * product.quantity;
+    // The same rounded extension the add path put on: subtracting a raw multiply from a
+    // weighed line would leave the cent extendPrice rounded away stuck in the cart total.
+    const lineTotal = extendPrice(product.price, product.quantity);
     MOCK_CART.subtotal -= lineTotal;
     MOCK_CART.total -= lineTotal;
     MOCK_CART.amountToBeCharged = MOCK_CART.total;
     MOCK_CART.remainingBalance = MOCK_CART.total;
     // Publish product-deleted event
-    mockPublishEvent("cart", "product-deleted", {
+    mockPublishEvent('cart', 'product-deleted', {
         product: product,
-        internalId: internalId
+        internalId: internalId,
     });
     return Promise.resolve({
         success: true,
         internalId: internalId,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     });
 };

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

@@ -1,4 +1,4 @@
-import { CFOrder } from "../../CommonTypes";
+import { CFOrder } from '../../CommonTypes';
 export interface ResumeParkedOrderParams {
     orderId: string;
 }

package/dist/actions/select-all-refund-items/action.d.ts

@@ -2,5 +2,5 @@
  * Select all refund items action
  * Calls the selectAllRefundItems action on the parent window
  */
-import type { SelectAllRefundItems } from "./types";
+import type { SelectAllRefundItems } from './types';
 export declare const selectAllRefundItems: SelectAllRefundItems;

package/dist/actions/select-all-refund-items/action.js

@@ -2,7 +2,7 @@
  * Select all refund items action
  * Calls the selectAllRefundItems action on the parent window
  */
-import { commandFrameClient } from "../../client";
+import { commandFrameClient } from '../../client';
 export const selectAllRefundItems = async (params) => {
-    return await commandFrameClient.call("selectAllRefundItems", params);
+    return await commandFrameClient.call('selectAllRefundItems', params);
 };

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

@@ -1,2 +1,2 @@
-import type { SetActiveProduct } from "./types";
+import type { SetActiveProduct } from './types';
 export declare const mockSetActiveProduct: SetActiveProduct;

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

@@ -1,47 +1,52 @@
-import { MOCK_PRODUCTS, setMockActiveProduct } from "../../demo/database";
+import { MOCK_PRODUCTS, setMockActiveProduct } from '../../demo/database';
+import { resolveUnit } from '@final-commerce/common';
 export const mockSetActiveProduct = async (params) => {
-    console.log("[Mock] setActiveProduct called", params);
+    console.log('[Mock] setActiveProduct called', params);
     if (!params?.variantId) {
-        throw new Error("Variant ID is required");
+        throw new Error('Variant ID is required');
     }
     const { variantId } = params;
     let matchedProduct;
     let matchedVariant;
     for (const product of MOCK_PRODUCTS) {
-        const variant = product.variants.find(v => v._id === variantId);
+        const variant = product.variants.find((v) => v._id === variantId);
         if (variant) {
             matchedProduct = product;
             matchedVariant = variant;
             break;
         }
     }
+    // The unit the variant sells in, resolved exactly as the add-to-cart mock does — the
+    // product card reads the ACTIVE product, and without this it cannot label "100" as kg.
+    const unit = matchedVariant?.unitId ? resolveUnit(matchedVariant.unitId) : undefined;
     const activeProduct = {
-        id: matchedProduct?._id || "mock_product",
+        id: matchedProduct?._id || 'mock_product',
         internalId: `internal_${Date.now()}`,
-        externalId: matchedVariant?.externalId || "mock_external_id",
-        productExternalId: matchedProduct?.externalId || "mock_product_external_id",
+        externalId: matchedVariant?.externalId || 'mock_external_id',
+        productExternalId: matchedProduct?.externalId || 'mock_product_external_id',
         variantId: matchedVariant?._id || variantId,
-        name: matchedProduct?.name || "Mock Product",
-        sku: matchedVariant?.sku || "mock_sku",
+        name: matchedProduct?.name || 'Mock Product',
+        sku: matchedVariant?.sku || 'mock_sku',
         price: matchedVariant?.price || 100,
         images: matchedVariant?.images || matchedProduct?.images || [],
-        taxTableId: matchedProduct?.taxTable || "mock_tax_table_id",
+        taxTableId: matchedProduct?.taxTable || 'mock_tax_table_id',
         quantity: 1,
         note: undefined,
         discount: undefined,
-        description: matchedProduct?.description || "Mock Description",
-        barcodeId: matchedVariant?.barcode || "mock_barcode_id",
+        description: matchedProduct?.description || 'Mock Description',
+        barcodeId: matchedVariant?.barcode || 'mock_barcode_id',
         stock: matchedVariant?.inventory?.[0]?.stock ?? 100,
+        ...(unit ? { unit } : {}),
         allowBackOrder: matchedVariant?.allowBackorder || false,
         fee: undefined,
         isUnlimited: !matchedVariant?.manageStock,
-        attributes: matchedVariant?.attributes?.map(a => a.value).join(", ") || "",
+        attributes: matchedVariant?.attributes?.map((a) => a.value).join(', ') || '',
         localQuantity: 1,
     };
     setMockActiveProduct(activeProduct);
     return {
         success: true,
         product: activeProduct,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     };
 };

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

@@ -1,4 +1,4 @@
-import { CFActiveRefundDetails } from "../../CommonTypes";
+import { CFActiveRefundDetails } from '../../CommonTypes';
 export interface SetActiveRefundParams {
     orderId: string;
 }

package/dist/actions/tap-to-pay-payment/mock.d.ts

@@ -1,2 +1,2 @@
-import { TapToPayPayment } from "./types";
+import { TapToPayPayment } from './types';
 export declare const mockTapToPayPayment: TapToPayPayment;

package/dist/actions/tap-to-pay-payment/mock.js

@@ -1,19 +1,19 @@
-import { applyMockPayment, MOCK_CART } from "../../demo/database";
+import { applyMockPayment, MOCK_CART } from '../../demo/database';
 export const mockTapToPayPayment = async (params) => {
-    console.log("[Mock] tapToPayPayment called", params);
+    console.log('[Mock] tapToPayPayment called', params);
     // Simulate Tap to Pay interaction
-    window.alert("Demo: Processing Tap to Pay...\n(Please tap card or device on screen)");
+    window.alert('Demo: Processing Tap to Pay...\n(Please tap card or device on screen)');
     const due = params?.amount ?? MOCK_CART.amountToBeCharged ?? MOCK_CART.total;
-    const order = applyMockPayment(due, "card", "tapToPay");
+    const order = applyMockPayment(due, 'card', 'tapToPay');
     return {
         success: true,
         amount: due,
-        paymentType: "tapToPay",
+        paymentType: 'tapToPay',
         order,
         timestamp: new Date().toISOString(),
         change: 0,
         cashRounding: 0,
         saleFinalized: true,
-        remainingBalance: 0
+        remainingBalance: 0,
     };
 };

package/dist/actions/tap-to-pay-payment/types.d.ts

@@ -1,4 +1,4 @@
-import { CFOrder } from "../../CommonTypes";
+import { CFOrder } from '../../CommonTypes';
 export interface TapToPayPaymentParams {
     /**
      * The amount to pay with this tender, in integer MINOR currency units

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

@@ -1,2 +1,2 @@
-import { TerminalPayment } from "./types";
+import { TerminalPayment } from './types';
 export declare const mockTerminalPayment: TerminalPayment;

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

@@ -1,20 +1,20 @@
-import { applyMockPayment, MOCK_CART } from "../../demo/database";
+import { applyMockPayment, MOCK_CART } from '../../demo/database';
 export const mockTerminalPayment = async (params) => {
-    console.log("[Mock] terminalPayment called", params);
-    const connectionType = params?.paymentType || "Cloud";
+    console.log('[Mock] terminalPayment called', params);
+    const connectionType = params?.paymentType || 'Cloud';
     // Simulate terminal interaction
     window.alert(`Demo: Processing ${connectionType} Terminal Payment...\n(Please tap, insert, or swipe card on terminal)`);
     const due = params?.amount ?? MOCK_CART.amountToBeCharged ?? MOCK_CART.total;
-    const order = applyMockPayment(due, "card", "stripe_terminal");
+    const order = applyMockPayment(due, 'card', 'stripe_terminal');
     return {
         success: true,
         amount: due,
-        paymentType: "terminal",
+        paymentType: 'terminal',
         order,
         timestamp: new Date().toISOString(),
         change: 0,
         cashRounding: 0,
         saleFinalized: true,
-        remainingBalance: 0
+        remainingBalance: 0,
     };
 };

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

@@ -1,4 +1,4 @@
-import { CFOrder } from "../../CommonTypes";
+import { CFOrder } from '../../CommonTypes';
 export interface TerminalPaymentParams {
     /**
      * The amount to pay with this tender, in integer MINOR currency units
@@ -11,7 +11,7 @@ export interface TerminalPaymentParams {
      */
     amount: number;
     /** "Bluetooth" or "Cloud". Only "Cloud" routes to the cloud processor; omitted or "Bluetooth" uses the native card reader. */
-    paymentType?: "Bluetooth" | "Cloud";
+    paymentType?: 'Bluetooth' | 'Cloud';
     /** Override the fulfillment state the order lands in on full payment (validated against the fulfillment state machine; invalid values throw). Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
     checkoutFulfillmentTarget?: string;
 }

package/dist/actions/update-cart-item-quantity/mock.d.ts

@@ -1,2 +1,2 @@
-import { UpdateCartItemQuantity } from "./types";
+import { UpdateCartItemQuantity } from './types';
 export declare const mockUpdateCartItemQuantity: UpdateCartItemQuantity;