@final-commerce/command-frame 0.5.1 → 0.6.0-staging.4

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;

package/dist/actions/update-cart-item-quantity/mock.js

@@ -1,60 +1,68 @@
-import { MOCK_CART, mockPublishEvent } from "../../demo/database";
+import { MOCK_CART, mockPublishEvent } from '../../demo/database';
+import { extendPrice, isValidQuantity } from '@final-commerce/common';
 export const mockUpdateCartItemQuantity = (params) => {
-    console.log("[Mock] updateCartItemQuantity called", params);
+    console.log('[Mock] updateCartItemQuantity called', params);
     if (!params?.internalId) {
-        throw new Error("internalId is required");
+        throw new Error('internalId is required');
     }
     if (params.quantity === undefined || params.quantity === null) {
-        throw new Error("quantity is required");
+        throw new Error('quantity is required');
     }
     const { internalId, quantity } = 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`);
     }
     const product = MOCK_CART.products[productIndex];
     const previousQuantity = product.quantity;
+    // The line resolved its unit when it was added; a piece-sold line has none and stays whole.
+    if (quantity !== 0 &&
+        !isValidQuantity(quantity, (product.unit ?? { unitId: 'piece', ratioToBase: 1, precision: 0 }))) {
+        throw new Error(product.unit
+            ? `${quantity} is finer than ${product.unit.abbreviation} can express (${product.unit.precision} decimals)`
+            : `${product.name} is sold by the piece, so ${quantity} is not a quantity it can sell in`);
+    }
     // If quantity is 0, remove the item
     if (quantity === 0) {
         MOCK_CART.products.splice(productIndex, 1);
         // Recalculate totals
-        const lineTotal = product.price * previousQuantity;
+        const lineTotal = extendPrice(product.price, previousQuantity);
         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,
             quantity: 0,
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
         });
     }
     // Update quantity
-    const quantityDelta = quantity - previousQuantity;
     product.quantity = quantity;
-    // Recalculate totals
-    const lineTotalDelta = product.price * quantityDelta;
+    // Difference of the two ROUNDED extensions — rounding the delta itself would let the
+    // line's running total drift from what extendPrice(price, quantity) says it is.
+    const lineTotalDelta = extendPrice(product.price, quantity) - extendPrice(product.price, previousQuantity);
     MOCK_CART.subtotal += lineTotalDelta;
     MOCK_CART.total += lineTotalDelta;
     MOCK_CART.amountToBeCharged = MOCK_CART.total;
     MOCK_CART.remainingBalance = MOCK_CART.total;
     // Publish product-updated event
-    mockPublishEvent("cart", "product-updated", {
+    mockPublishEvent('cart', 'product-updated', {
         product: product,
         previousQuantity: previousQuantity,
-        newQuantity: quantity
+        newQuantity: quantity,
     });
     return Promise.resolve({
         success: true,
         internalId: internalId,
         quantity: quantity,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     });
 };

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

@@ -1,7 +1,14 @@
 export interface UpdateCartItemQuantityParams {
     /** The unique identifier for the specific cart item to update. */
     internalId: string;
-    /** The new quantity. If set to 0, the item will be removed from the cart. */
+    /**
+     * The new quantity. If set to 0, the item will be removed from the cart.
+     *
+     * **May be fractional** for a variant sold by measure; the number of decimals allowed comes
+     * from `variant.unit.precision`. The engine refuses anything finer and names the unit in the
+     * error. Do not round or clamp before sending — a silently altered quantity is charged and
+     * deducted differently than the one the cashier typed.
+     */
     quantity: number;
 }
 export interface UpdateCartItemQuantityResponse {

package/dist/actions/upsert-custom-table-data/mock.d.ts

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

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

@@ -1,5 +1,5 @@
 export const mockUpsertCustomTableData = async (params) => {
-    console.log("[Mock] upsertCustomTableData called", params);
+    console.log('[Mock] upsertCustomTableData called', params);
     const data = params?.data;
     const now = new Date().toISOString();
     // Return the data with _id and timestamps added
@@ -7,11 +7,11 @@ export const mockUpsertCustomTableData = async (params) => {
         ...data,
         _id: data?._id || `mock_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
         createdAt: data?.createdAt || now,
-        updatedAt: now
+        updatedAt: now,
     };
     return {
         success: true,
         data: resultData,
-        timestamp: now
+        timestamp: now,
     };
 };