@final-commerce/command-frame 0.9.0 → 0.10.0-staging.2

package/dist/demo/database.js

@@ -3,7 +3,7 @@
  * Stores mock data that mimics the Render environment
  */
 import { CFProductType, CFUserTypes, CurrencyCode, } from '../CommonTypes';
-import { extendPrice, resolveUnit, toBase } from '@final-commerce/common';
+import { cheapestCompositeItem, cheapestCompositePrice, extendPrice, resolveUnit, toBase, } from '@final-commerce/common';
 import { BookingRatePeriod, BookingResourceKind, BookingType, ReservationStatus } from '@final-commerce/common';
 export * from './mocks';
 // Asset Imports - Using Remote URLs to avoid build complexity with asset copying
@@ -228,6 +228,7 @@ const createSimpleProduct = (id, name, price, image, categories, description) =>
         maxPrice: price,
         status: 'active',
         productType: CFProductType.SIMPLE,
+        composite: null,
         taxTable: 'tax_standard',
         description,
         images: [image],
@@ -241,6 +242,7 @@ const createSimpleProduct = (id, name, price, image, categories, description) =>
                 salePrice: 0,
                 isOnSale: false,
                 manageStock: true,
+                unavailable: false,
                 externalId: `ext_${id}_var`,
                 attributes: [],
                 inventory: createInventory(100),
@@ -263,6 +265,7 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
         maxPrice: largePrice,
         status: 'active',
         productType: CFProductType.VARIABLE,
+        composite: null,
         taxTable: 'tax_standard',
         description,
         images: [image],
@@ -276,6 +279,7 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
                 salePrice: 0,
                 isOnSale: false,
                 manageStock: true,
+                unavailable: false,
                 externalId: `ext_${id}_var_s`,
                 attributes: [{ name: 'Size', value: 'Small' }],
                 inventory: createInventory(50),
@@ -287,6 +291,7 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
                 salePrice: 0,
                 isOnSale: false,
                 manageStock: true,
+                unavailable: false,
                 externalId: `ext_${id}_var_l`,
                 attributes: [{ name: 'Size', value: 'Large' }],
                 inventory: createInventory(30),
@@ -296,6 +301,8 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
 };
 export const MOCK_PRODUCT_BASIL_ALMOND = createSimpleProduct('prod_basil_almond', 'Basil Almond Paste', 1200, basilAlmondImg, [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_SPECIALTY, MOCK_CATEGORY_VEGAN], 'A rich blend of fresh basil and roasted almonds.');
 export const MOCK_PRODUCT_BEER = createVariableProduct('prod_beer', 'Beer Paste', 1500, 2500, beerImg, [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_SPECIALTY], 'Unique paste infused with dark lager.');
+// Demo of `setVariantUnavailable`: the large jar is marked unavailable at the outlet, so `addProductToCart` refuses it.
+MOCK_PRODUCT_BEER.variants[1].unavailable = true;
 export const MOCK_PRODUCT_BEET = createSimpleProduct('prod_beet', 'Beet Paste', 1000, beetImg, [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_BASIC, MOCK_CATEGORY_VEGAN], 'Earthy and sweet beet paste, perfect for salads.');
 export const MOCK_PRODUCT_CARAMELIZED = createVariableProduct('prod_caramelized', 'Caramelized Paste', 1400, 2200, caramelizedImg, [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_SPECIALTY, MOCK_CATEGORY_VEGAN], 'Slow-cooked caramelized onion paste.');
 export const MOCK_PRODUCT_GARLIC_ONION = createVariableProduct('prod_garlic_onion', 'Garlic Onion Paste', 1100, 1800, garlicOnionImg, [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_BASIC, MOCK_CATEGORY_VEGAN], 'Classic savory base for any dish.');
@@ -658,7 +665,106 @@ export const MOCK_PRODUCT_HAIRCUT = {
     productType: CFProductType.BOOKING,
     bookingRulesId: 'rule_salon_30',
 };
+// A composite (FT-83) as the host serves it: the merchant's price 27.00, items add only their upcharges (B31); each item
+// keeps its own tax (`taxTable` empty). One item points at a deleted variant (unavailable), one is a whole category.
+export const MOCK_PRODUCT_PASTE_TRIO = {
+    ...createSimpleProduct('prod_paste_trio', 'Paste Trio', 2700, basilAlmondImg, [MOCK_CATEGORY_PASTES], 'Pick a paste and a spicy one.'),
+    productType: CFProductType.COMPOSITE,
+    taxTable: '',
+    // B43: a composite has no modifiers of its own; its items carry theirs.
+    modifiers: [],
+    composite: {
+        available: true,
+        basePrice: 2700,
+        fromPrice: 2800,
+        parts: [
+            {
+                _id: 'part_paste',
+                name: 'Paste',
+                required: true,
+                min: 1,
+                max: 1,
+                defaultPick: { itemId: 'item_basil', variantId: 'prod_basil_almond_var_main' },
+                items: [
+                    {
+                        _id: 'item_basil',
+                        variantId: 'prod_basil_almond_var_main',
+                        categoryId: null,
+                        name: 'Basil Almond Paste',
+                        extraCharge: 0,
+                        quantity: 1,
+                        cost: 0,
+                        unavailable: null,
+                        choices: [
+                            {
+                                productId: 'prod_basil_almond',
+                                variantId: 'prod_basil_almond_var_main',
+                                name: 'Basil Almond Paste',
+                                attributes: [],
+                                // The picked product's own modifiers (B28): taxed at its table, sent in the pick.
+                                modifiers: [
+                                    {
+                                        _id: 'mod_texture',
+                                        name: 'Texture',
+                                        selectionType: 'single',
+                                        required: false,
+                                        sortOrder: 0,
+                                        choices: [
+                                            { _id: 'choice_smooth', name: 'Smooth', price: 0, sortOrder: 0 },
+                                            { _id: 'choice_chunky', name: 'Chunky', price: 50, sortOrder: 1 },
+                                        ],
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                    {
+                        _id: 'item_gone',
+                        variantId: 'prod_gone_var_main',
+                        categoryId: null,
+                        name: '',
+                        extraCharge: 0,
+                        quantity: 1,
+                        cost: 0,
+                        unavailable: 'deleted',
+                        choices: [],
+                    },
+                ],
+            },
+            {
+                _id: 'part_spicy',
+                name: null,
+                required: true,
+                min: 1,
+                max: 2,
+                // "Pick up to 2": no preselected pick (B29 = D36) — the till shows how many are still needed.
+                defaultPick: null,
+                items: [
+                    {
+                        _id: 'item_spicy',
+                        variantId: null,
+                        categoryId: MOCK_CATEGORY_SPICY.id,
+                        name: 'Spicy',
+                        extraCharge: 100,
+                        quantity: 1,
+                        cost: 100,
+                        unavailable: null,
+                        choices: [
+                            {
+                                productId: 'prod_habanero',
+                                variantId: 'prod_habanero_var_main',
+                                name: 'Habanero Paste',
+                                attributes: [],
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+    },
+};
 export const MOCK_PRODUCTS = [
+    MOCK_PRODUCT_PASTE_TRIO,
     MOCK_PRODUCT_BASIL_ALMOND,
     MOCK_PRODUCT_BEER,
     MOCK_PRODUCT_BEET,
@@ -676,6 +782,114 @@ export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_HAIRCUT,
 ];
 export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2, MOCK_ORDER_3, MOCK_ORDER_4];
+/** Nothing hidden by default; `setMockDatabase({ catalogVisibility })` hides products at an outlet. */
+export const MOCK_CATALOG_VISIBILITY = [];
+/**
+ * The host's cart stock check for composites (kaching `compositeStockRefusal`), over the demo shelves — a copy: what the
+ * cart takes of each component's variant (plain lines and components × their line quantity) against its shelf here.
+ * The demo has no pools or units, so it counts per variant; untracked and backordered variants are never short.
+ */
+export function mockCompositeStockRefusal(products) {
+    const components = products.flatMap((product) => product.components ?? []);
+    const demand = new Map();
+    for (const product of products) {
+        if (product.components)
+            for (const component of product.components)
+                demand.set(component.variantId, (demand.get(component.variantId) ?? 0) + component.quantity * product.quantity);
+        else
+            demand.set(product.variantId, (demand.get(product.variantId) ?? 0) + product.quantity);
+    }
+    for (const component of components) {
+        const variant = MOCK_PRODUCTS.flatMap((product) => product.variants).find((candidate) => candidate._id === component.variantId);
+        if (!variant?.manageStock || variant.allowBackorder)
+            continue;
+        const left = variant.inventory?.find((row) => row.outletId === MOCK_OUTLET.id)?.stock ?? 0;
+        if ((demand.get(component.variantId) ?? 0) > left)
+            return `${component.name}: only ${left} left`;
+    }
+    return null;
+}
+/** Product ids hidden at the demo's active outlet. */
+export const mockHiddenProductIds = () => new Set(MOCK_CATALOG_VISIBILITY.filter((row) => row.outletId === MOCK_OUTLET.id).map((row) => row.productId));
+/**
+ * The host's outlet rules for a composite (kaching `resolveComposite`), over the demo's static view — a copy, change both
+ * in one step: an item whose product is hidden here is left out, a category item keeps only products sold here (none →
+ * `'empty'`), an Optional part with nothing to pick is not offered, a required one with nothing makes it unavailable,
+ * and the D36 default and "from" price are read off what is left.
+ */
+/** B41: the seats a bookable demo product has free in the slot starting at `startAt` — as the host reads them. */
+export function mockBookableWindow(productId, startAt) {
+    const at = new Date(startAt);
+    const slot = mockBookingAvailability(productId, at, new Date(+at + 86400000)).slots.find((candidate) => +new Date(candidate.startAt) === +at && candidate.canStart) ?? null;
+    return { free: slot?.free ?? 0, slot };
+}
+export const mockIsBookable = (productId) => MOCK_PRODUCTS.find((product) => product._id === productId)?.productType === CFProductType.BOOKING;
+export function mockCompositeAtOutlet(composite, hidden = mockHiddenProductIds(), 
+/** B41: the window bookable items are judged in; absent = `by_date`. */
+slot) {
+    // B41: a bookable item is judged by seats in the window, never by stock; with no window it waits for a date.
+    const bookable = (item) => !!item.variantId && item.choices.some((choice) => mockIsBookable(choice.productId));
+    const seatsFor = (item) => !slot
+        ? 'by_date'
+        : mockBookableWindow(item.choices[0].productId, slot.startAt).free >= item.quantity
+            ? null
+            : 'fully_booked';
+    const offered = (item) => !item.unavailable || item.unavailable === 'by_date';
+    // B35: a tracked variant without `quantity` on the demo shelf here (and no backorder) is sold out.
+    const soldOut = (variantId, quantity) => {
+        const variant = MOCK_PRODUCTS.flatMap((product) => product.variants).find((candidate) => candidate._id === variantId);
+        if (!variant?.manageStock || variant.allowBackorder)
+            return false;
+        return (variant.inventory?.find((row) => row.outletId === MOCK_OUTLET.id)?.stock ?? 0) < quantity;
+    };
+    // B36e: "N left" on a unit-sold tracked choice — the demo shelf already reads in the variant's own unit.
+    const withStockLeft = (choice) => {
+        const variant = MOCK_PRODUCTS.flatMap((product) => product.variants).find((candidate) => candidate._id === choice.variantId);
+        const onHand = variant?.inventory?.find((row) => row.outletId === MOCK_OUTLET.id)?.stock;
+        return variant?.unitId && variant.manageStock && typeof onHand === 'number'
+            ? { ...choice, stockLeft: onHand }
+            : choice;
+    };
+    const upcharge = (item) => ({
+        extraCharge: item.extraCharge,
+        quantity: item.quantity,
+        available: offered(item),
+    });
+    const parts = composite.parts
+        .map((part) => {
+        const items = part.items.flatMap((item) => {
+            if (item.variantId) {
+                if (item.choices.some((choice) => hidden.has(choice.productId)))
+                    return [];
+                if (!item.unavailable && bookable(item))
+                    return [{ ...item, unavailable: seatsFor(item) }];
+                return item.unavailable || !soldOut(item.variantId, item.quantity)
+                    ? [{ ...item, choices: item.choices.map(withStockLeft) }]
+                    : [{ ...item, unavailable: 'out_of_stock', choices: [] }];
+            }
+            const sold = item.choices.filter((choice) => !hidden.has(choice.productId));
+            const choices = sold.filter((choice) => !soldOut(choice.variantId, item.quantity));
+            const unavailable = item.unavailable ?? (!sold.length ? 'empty' : !choices.length ? 'out_of_stock' : null);
+            return [{ ...item, choices: unavailable ? [] : choices.map(withStockLeft), unavailable }];
+        });
+        const index = part.min === 1 && part.max === 1 ? cheapestCompositeItem(items.map(upcharge)) : undefined;
+        const cheapest = index === undefined ? undefined : items[index];
+        return {
+            ...part,
+            items,
+            defaultPick: cheapest?.variantId ? { itemId: cheapest._id, variantId: cheapest.variantId } : null,
+        };
+    })
+        .filter((part) => part.min > 0 || part.items.some(offered));
+    const cheapest = cheapestCompositePrice(parts.map((part) => ({ min: part.min, items: part.items.map(upcharge) })));
+    return {
+        ...composite,
+        available: composite.available && parts.every((part) => part.min === 0 || part.items.some(offered)),
+        needsDate: parts.some((part) => part.items.some(bookable)),
+        fromPrice: composite.basePrice === null || cheapest === undefined ? null : composite.basePrice + cheapest,
+        parts,
+    };
+}
 export const MOCK_PARKED_ORDERS = [MOCK_PARKED_ORDER_1, MOCK_PARKED_ORDER_2];
 // Compatibility Exports (reassigned by setMockDatabase)
 export let MOCK_USER = MOCK_USERS[0];
@@ -760,6 +974,9 @@ export function setMockDatabase(config) {
     if (config.bookings !== undefined) {
         MOCK_BOOKINGS.splice(0, MOCK_BOOKINGS.length, ...config.bookings);
     }
+    if (config.catalogVisibility !== undefined) {
+        MOCK_CATALOG_VISIBILITY.splice(0, MOCK_CATALOG_VISIBILITY.length, ...config.catalogVisibility);
+    }
     if (MOCK_OUTLETS.length > 0) {
         Object.assign(MOCK_OUTLET_MAIN, MOCK_OUTLETS[0]);
         if (MOCK_OUTLET_MAIN.id === undefined && MOCK_OUTLET_MAIN._id !== undefined) {
@@ -1132,6 +1349,7 @@ export const buildModifierRows = (modifiers, lineQuantity) => {
         amount: extendPrice(modifier.unitPrice * modifier.quantity, quantity),
         tax: 0,
         ...(modifier.taxTableId ? { taxTableId: modifier.taxTableId } : {}),
+        ...(modifier.componentIndex !== undefined ? { componentIndex: modifier.componentIndex } : {}),
     }));
     return { rows, modifiersTotal: rows.reduce((sum, row) => sum + row.amount, 0) };
 };

package/dist/index.d.ts

@@ -29,13 +29,15 @@ export declare const command: {
     readonly addProductNote: import(".").AddProductNote;
     readonly addProductFee: import(".").AddProductFee;
     readonly getProductModifierSelections: import(".").GetProductModifierSelections;
+    readonly getCompositePrice: import(".").GetCompositePrice;
+    readonly getCompositeAvailability: import(".").GetCompositeAvailability;
     readonly setProductModifierSelections: import(".").SetProductModifierSelections;
     readonly setActiveProductFee: import(".").SetActiveProductFee;
     readonly setActiveProductDiscount: import(".").SetActiveProductDiscount;
     readonly getActiveProduct: import(".").GetActiveProduct;
     readonly setActiveProduct: import(".").SetActiveProduct;
     readonly adjustInventory: import(".").AdjustInventory;
-    readonly getCustomStockActions: import(".").GetCustomStockActions;
+    readonly setVariantUnavailable: import(".").SetVariantUnavailable;
     readonly addOrderNote: import(".").AddOrderNote;
     readonly addCartFee: import(".").AddCartFee;
     readonly getCurrentCart: import(".").GetCurrentCart;
@@ -175,13 +177,15 @@ export type { GetFinalContext, GetFinalContextResponse } from './actions/get-fin
 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 { GetCompositePrice, GetCompositePriceParams, GetCompositePriceResponse, } from './actions/get-composite-price/types';
+export type { GetCompositeAvailability, GetCompositeAvailabilityParams, GetCompositeAvailabilityResponse, CFCompositeSlot, } from './actions/get-composite-availability/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';
 export type { SetActiveProduct, SetActiveProductParams, SetActiveProductResponse, } from './actions/set-active-product/types';
-export type { AdjustInventory, AdjustInventoryParams, AdjustInventoryResponse, ManualStockReason, } from './actions/adjust-inventory/types';
-export type { CustomStockActionPayload, GetCustomStockActions, GetCustomStockActionsResponse, } from './actions/get-custom-stock-actions/types';
+export type { AdjustInventory, AdjustInventoryParams, AdjustInventoryResponse } from './actions/adjust-inventory/types';
+export type { SetVariantUnavailable, SetVariantUnavailableParams, SetVariantUnavailableResponse, } from './actions/set-variant-unavailable/types';
 export type { AddOrderNote, AddOrderNoteParams, AddOrderNoteResponse } from './actions/add-order-note/types';
 export type { AddCartFee, AddCartFeeParams, AddCartFeeResponse } from './actions/add-cart-fee/types';
 export type { ClearCart, ClearCartResponse } from './actions/clear-cart/types';

package/dist/index.js

@@ -28,13 +28,15 @@ import { updateCartItemQuantity } from './actions/update-cart-item-quantity/acti
 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 { getCompositePrice } from './actions/get-composite-price/action';
+import { getCompositeAvailability } from './actions/get-composite-availability/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';
 import { setActiveProduct } from './actions/set-active-product/action';
 import { adjustInventory } from './actions/adjust-inventory/action';
-import { getCustomStockActions } from './actions/get-custom-stock-actions/action';
+import { setVariantUnavailable } from './actions/set-variant-unavailable/action';
 // Order Actions
 import { addOrderNote } from './actions/add-order-note/action';
 import { addCartFee } from './actions/add-cart-fee/action';
@@ -175,13 +177,15 @@ export const command = {
     addProductNote,
     addProductFee,
     getProductModifierSelections,
+    getCompositePrice,
+    getCompositeAvailability,
     setProductModifierSelections,
     setActiveProductFee,
     setActiveProductDiscount,
     getActiveProduct,
     setActiveProduct,
     adjustInventory,
-    getCustomStockActions,
+    setVariantUnavailable,
     // Order Actions
     addOrderNote,
     addCartFee,

package/dist/projects/render/mocks.js

@@ -13,6 +13,8 @@ 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 { mockGetCompositePrice } from '../../actions/get-composite-price/mock';
+import { mockGetCompositeAvailability } from '../../actions/get-composite-availability/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';
@@ -26,7 +28,7 @@ import { mockRemoveProductFromCart } from '../../actions/remove-product-from-car
 import { mockRemoveCartDiscount } from '../../actions/remove-cart-discount/mock';
 import { mockUpdateCartItemQuantity } from '../../actions/update-cart-item-quantity/mock';
 import { mockAdjustInventory } from '../../actions/adjust-inventory/mock';
-import { mockGetCustomStockActions } from '../../actions/get-custom-stock-actions/mock';
+import { mockSetVariantUnavailable } from '../../actions/set-variant-unavailable/mock';
 import { mockAssignCustomer } from '../../actions/assign-customer/mock';
 import { mockAuthenticateUser } from '../../actions/authenticate-user/mock';
 import { mockCalculateRefundTotal } from '../../actions/calculate-refund-total/mock';
@@ -123,6 +125,8 @@ export const RENDER_MOCKS = {
     addProductDiscount: mockAddProductDiscount,
     addProductFee: mockAddProductFee,
     getProductModifierSelections: mockGetProductModifierSelections,
+    getCompositePrice: mockGetCompositePrice,
+    getCompositeAvailability: mockGetCompositeAvailability,
     setProductModifierSelections: mockSetProductModifierSelections,
     setActiveProductFee: mockSetActiveProductFee,
     setActiveProductDiscount: mockSetActiveProductDiscount,
@@ -133,7 +137,7 @@ export const RENDER_MOCKS = {
     removeProductFromCart: mockRemoveProductFromCart,
     updateCartItemQuantity: mockUpdateCartItemQuantity,
     adjustInventory: mockAdjustInventory,
-    getCustomStockActions: mockGetCustomStockActions,
+    setVariantUnavailable: mockSetVariantUnavailable,
     assignCustomer: mockAssignCustomer,
     authenticateUser: mockAuthenticateUser,
     calculateRefundTotal: mockCalculateRefundTotal,

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, GetCustomStockActions, 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, GetBookingResources, GetBookingAvailability, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, 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, GetCompositePrice, GetCompositeAvailability, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, SetVariantUnavailable, 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, GetBookingResources, GetBookingAvailability, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, CreatePaymentLink, ChargeMoto, GetTimeClockStatus } from '../../index';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -29,13 +29,15 @@ export interface RenderProviderActions {
     addProductNote: AddProductNote;
     addProductFee: AddProductFee;
     getProductModifierSelections: GetProductModifierSelections;
+    getCompositePrice: GetCompositePrice;
+    getCompositeAvailability: GetCompositeAvailability;
     setProductModifierSelections: SetProductModifierSelections;
     setActiveProductFee: SetActiveProductFee;
     setActiveProductDiscount: SetActiveProductDiscount;
     getActiveProduct: GetActiveProduct;
     setActiveProduct: SetActiveProduct;
     adjustInventory: AdjustInventory;
-    getCustomStockActions: GetCustomStockActions;
+    setVariantUnavailable: SetVariantUnavailable;
     addOrderNote: AddOrderNote;
     addCartFee: AddCartFee;
     clearCart: ClearCart;

package/dist/pubsub/topics/products/catalog-visibility-changed/types.d.ts

@@ -0,0 +1,17 @@
+import type { TopicEvent } from '../../../types';
+/**
+ * Payload for catalog-visibility-changed: a product was hidden or shown at an outlet. `getProducts` leaves hidden
+ * products out and a composite offers only items sold at the till's outlet — debounce, then re-ask `getProducts`.
+ */
+export interface CatalogVisibilityChangedPayload {
+    visibility: {
+        _id: string;
+        productId: string;
+        outletId: string;
+        isDeleted?: boolean;
+    };
+}
+/**
+ * Typed event for catalog-visibility-changed
+ */
+export type CatalogVisibilityChangedEvent = TopicEvent<CatalogVisibilityChangedPayload>;

package/dist/pubsub/topics/products/catalog-visibility-changed/types.js

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

package/dist/pubsub/topics/products/composite-changed/types.d.ts

@@ -0,0 +1,17 @@
+import type { TopicEvent } from '../../../types';
+/**
+ * Payload for composite-changed (FT-83): a part or item of a composite arrived. A save replaces all of a composite's
+ * parts and items at once (old rows come as `isDeleted: true`, new ones with new ids), so one save fires this many
+ * times — debounce, then re-ask `getProducts`; never patch `product.composite` from the row.
+ */
+export interface CompositeChangedPayload {
+    compositeRow: {
+        _id: string;
+        compositeProductId: string;
+        isDeleted?: boolean;
+    };
+}
+/**
+ * Typed event for composite-changed
+ */
+export type CompositeChangedEvent = TopicEvent<CompositeChangedPayload>;

package/dist/pubsub/topics/products/composite-changed/types.js

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

package/dist/pubsub/topics/products/index.d.ts

@@ -2,6 +2,6 @@
  * Products Topic Definition
  * Defines the products topic and its available event types
  */
-import type { TopicDefinition } from "../../types";
+import type { TopicDefinition } from '../../types';
 export declare const productsTopic: TopicDefinition;
-export * from "./types";
+export * from './types';

package/dist/pubsub/topics/products/index.js

@@ -3,31 +3,46 @@
  * Defines the products topic and its available event types
  */
 export const productsTopic = {
-    id: "products",
-    name: "Products",
-    description: "Topic for product-related events",
+    id: 'products',
+    name: 'Products',
+    description: 'Topic for product-related events',
     eventTypes: [
         {
-            id: "product-created",
-            name: "Product Created",
-            description: "Published when a new product is synced/created"
+            id: 'product-created',
+            name: 'Product Created',
+            description: 'Published when a new product is synced/created',
         },
         {
-            id: "product-updated",
-            name: "Product Updated",
-            description: "Published when a product is synced/updated"
+            id: 'product-updated',
+            name: 'Product Updated',
+            description: 'Published when a product is synced/updated',
         },
         {
-            id: "set-active-product",
-            name: "Set Active Product",
-            description: "Published when a product is set as the active product"
+            id: 'composite-changed',
+            name: 'Composite Changed',
+            description: "Published when a composite's part or item is synced; re-ask getProducts",
         },
         {
-            id: "get-active-product",
-            name: "Get Active Product",
-            description: "Published when a product is retrieved as the active product"
-        }
-    ]
+            id: 'catalog-visibility-changed',
+            name: 'Catalog Visibility Changed',
+            description: 'Published when a product is hidden or shown at an outlet; re-ask getProducts',
+        },
+        {
+            id: 'inventory-changed',
+            name: 'Inventory Changed',
+            description: "Published when a variant's stock at an outlet syncs; re-ask getProducts",
+        },
+        {
+            id: 'set-active-product',
+            name: 'Set Active Product',
+            description: 'Published when a product is set as the active product',
+        },
+        {
+            id: 'get-active-product',
+            name: 'Get Active Product',
+            description: 'Published when a product is retrieved as the active product',
+        },
+    ],
 };
 // Re-export types
-export * from "./types";
+export * from './types';

package/dist/pubsub/topics/products/inventory-changed/types.d.ts

@@ -0,0 +1,18 @@
+import type { TopicEvent } from '../../../types';
+/**
+ * Payload for inventory-changed (B35): a variant's stock at an outlet moved. A composite may turn Sold out or
+ * Unavailable by its components' shelves — debounce, then re-ask `getProducts`.
+ */
+export interface InventoryChangedPayload {
+    inventory: {
+        _id: string;
+        variantId: string;
+        outletId: string;
+        quantity?: number | null;
+        manageStock?: boolean;
+    };
+}
+/**
+ * Typed event for inventory-changed
+ */
+export type InventoryChangedEvent = TopicEvent<InventoryChangedPayload>;

package/dist/pubsub/topics/products/inventory-changed/types.js

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

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

@@ -2,13 +2,19 @@
  * Products Topic Types
  * Aggregated types for all product-related events
  */
-export * from "./product-created/types";
-export * from "./product-updated/types";
-export * from "./product-set-active/types";
-export * from "./product-get-active/types";
-import type { ProductCreatedPayload } from "./product-created/types";
-import type { ProductUpdatedPayload } from "./product-updated/types";
-import type { ProductSetActivePayload } from "./product-set-active/types";
-import type { ProductGetActivePayload } from "./product-get-active/types";
-export type ProductsEventPayload = ProductCreatedPayload | ProductUpdatedPayload | ProductSetActivePayload | ProductGetActivePayload;
-export type ProductsEventType = "product-created" | "product-updated" | "set-active-product" | "get-active-product";
+export * from './product-created/types';
+export * from './product-updated/types';
+export * from './composite-changed/types';
+export * from './catalog-visibility-changed/types';
+export * from './inventory-changed/types';
+export * from './product-set-active/types';
+export * from './product-get-active/types';
+import type { ProductCreatedPayload } from './product-created/types';
+import type { ProductUpdatedPayload } from './product-updated/types';
+import type { CompositeChangedPayload } from './composite-changed/types';
+import type { CatalogVisibilityChangedPayload } from './catalog-visibility-changed/types';
+import type { InventoryChangedPayload } from './inventory-changed/types';
+import type { ProductSetActivePayload } from './product-set-active/types';
+import type { ProductGetActivePayload } from './product-get-active/types';
+export type ProductsEventPayload = ProductCreatedPayload | ProductUpdatedPayload | CompositeChangedPayload | CatalogVisibilityChangedPayload | InventoryChangedPayload | ProductSetActivePayload | ProductGetActivePayload;
+export type ProductsEventType = 'product-created' | 'product-updated' | 'composite-changed' | 'catalog-visibility-changed' | 'inventory-changed' | 'set-active-product' | 'get-active-product';

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

@@ -3,7 +3,10 @@
  * Aggregated types for all product-related events
  */
 // Re-export all event types
-export * from "./product-created/types";
-export * from "./product-updated/types";
-export * from "./product-set-active/types";
-export * from "./product-get-active/types";
+export * from './product-created/types';
+export * from './product-updated/types';
+export * from './composite-changed/types';
+export * from './catalog-visibility-changed/types';
+export * from './inventory-changed/types';
+export * from './product-set-active/types';
+export * from './product-get-active/types';

package/package.json

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