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

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,
     };
 };

package/dist/demo/database.js

@@ -3,6 +3,7 @@
  * Stores mock data that mimics the Render environment
  */
 import { CFProductType, CFUserTypes, CurrencyCode, } from '../CommonTypes';
+import { extendPrice, resolveUnit, toBase } from '@final-commerce/common';
 export * from './mocks';
 // Asset Imports - Using Remote URLs to avoid build complexity with asset copying
 const ASSETS_BASE_URL = 'https://raw.githubusercontent.com/Final-Commerce/command-frame/refs/heads/main/src/demo/assets';
@@ -314,12 +315,25 @@ export const MOCK_PRODUCT_BLACK_GARLIC = createSimpleProduct('prod_black_garlic'
 // Helper to create line item
 const createLineItem = (product, variantIndex = 0, quantity = 1) => {
     const variant = product.variants[variantIndex];
+    // Same contract as a real order line: the unit is FROZEN on the line (a re-rated unit must
+    // not restate old orders), and the money is extendPrice — price × quantity may carry a
+    // fractional quantity, and the raw multiply would put fractional cents on the order.
+    const unit = variant.unitId ? resolveUnit(variant.unitId) : undefined;
+    const total = extendPrice(variant.price, quantity);
     return {
         productId: product._id,
         variantId: variant._id,
         name: product.name,
         quantity,
         price: variant.price,
+        ...(unit
+            ? {
+                unitId: unit.unitId,
+                unitAbbreviation: unit.abbreviation,
+                unitRatioToBase: unit.ratioToBase,
+                stockQuantity: toBase(quantity, unit),
+            }
+            : {}),
         taxes: [],
         discount: {
             itemDiscounts: [],
@@ -327,8 +341,8 @@ const createLineItem = (product, variantIndex = 0, quantity = 1) => {
         },
         fee: { itemFees: [] },
         totalTax: 0,
-        total: variant.price * quantity,
-        lineNetWithFees: variant.price * quantity,
+        total,
+        lineNetWithFees: total,
         metadata: [],
         image: product.images?.[0] || '',
         sku: variant.sku,
@@ -784,12 +798,24 @@ export const createOrderFromCart = (paymentType, amount, processor = 'cash') =>
     const receiptId = `receipt_${Date.now()}`;
     // Map cart products to line items
     const lineItems = MOCK_CART.products.map((p) => {
+        // The cart line resolved its unit when it was added; the ORDER line freezes it, exactly
+        // as production does. extendPrice for the same reason as everywhere: fractional
+        // quantities must not leave fractional cents on an order.
+        const lineTotal = extendPrice(p.price, p.quantity);
         return {
             productId: p.id,
             variantId: p.variantId,
             name: p.name,
             quantity: p.quantity,
             price: p.price,
+            ...(p.unit
+                ? {
+                    unitId: p.unit.unitId,
+                    unitAbbreviation: p.unit.abbreviation,
+                    unitRatioToBase: p.unit.ratioToBase,
+                    stockQuantity: toBase(p.quantity, p.unit),
+                }
+                : {}),
             taxes: [],
             discount: {
                 itemDiscounts: [],
@@ -797,8 +823,8 @@ export const createOrderFromCart = (paymentType, amount, processor = 'cash') =>
             },
             fee: { itemFees: [] },
             totalTax: 0,
-            total: p.price * p.quantity,
-            lineNetWithFees: p.price * p.quantity,
+            total: lineTotal,
+            lineNetWithFees: lineTotal,
             metadata: [],
             image: p.images?.[0] || '',
             sku: p.sku || '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.5.0",
+  "version": "0.6.0-staging.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.0.2"
+    "@final-commerce/common": "2.2.0-staging.2"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.0.0",