@final-commerce/command-frame 0.6.2-staging3.1 → 0.7.0-staging.10

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

@@ -0,0 +1,26 @@
+import { MOCK_BOOKINGS, MOCK_CART, mockPublishEvent } from '../../demo/database';
+export const mockRemoveBookingFromCart = async (params) => {
+    console.log('[Mock] removeBookingFromCart called', params);
+    const reservations = MOCK_CART.reservations ?? [];
+    const cartIndex = reservations.findIndex(({ internalId }) => internalId === params.reservationInternalId);
+    const [removed] = cartIndex >= 0 ? reservations.splice(cartIndex, 1) : [];
+    if (removed) {
+        const line = removed.total || removed.price * (removed.quantity ?? 1);
+        MOCK_CART.subtotal -= line;
+        MOCK_CART.total -= line;
+        MOCK_CART.amountToBeCharged = MOCK_CART.total;
+        MOCK_CART.remainingBalance = MOCK_CART.total;
+        mockPublishEvent('cart', 'reservation-removed', { reservation: removed });
+    }
+    // The hold has to go back, or the mock is a trap: `addBookingToCart` pushes into the very list
+    // availability reads, so add → remove → add the same slot used to refuse forever with "that
+    // window has just been taken". The reservation id is `res_<booking.id>`, the link back to the row.
+    const bookingId = removed?.bookingId ?? params.reservationInternalId.replace(/^res_/, '');
+    const index = MOCK_BOOKINGS.findIndex(({ id }) => id === bookingId);
+    const [released] = index >= 0 ? MOCK_BOOKINGS.splice(index, 1) : [];
+    return {
+        reservationInternalId: params.reservationInternalId,
+        booking: released,
+        timestamp: new Date().toISOString(),
+    };
+};

package/dist/actions/remove-booking-from-cart/types.d.ts

@@ -0,0 +1,12 @@
+import { CFBooking } from '../../CommonTypes';
+export interface RemoveBookingFromCartParams {
+    /** The reservation's own id, as `addBookingToCart` returned it. */
+    reservationInternalId: string;
+}
+export interface RemoveBookingFromCartResponse {
+    reservationInternalId: string;
+    /** The released hold, so the caller can see it is no longer held. */
+    booking?: CFBooking;
+    timestamp: string;
+}
+export type RemoveBookingFromCart = (params: RemoveBookingFromCartParams) => Promise<RemoveBookingFromCartResponse>;

package/dist/actions/remove-booking-from-cart/types.js

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

package/dist/demo/database.d.ts

@@ -2,7 +2,7 @@
  * Mock Database for Standalone/Demo Mode
  * Stores mock data that mimics the Render environment
  */
-import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout, CFCartLineModifier, CFProdModifierBreakdown, CFModifierSelection, CFResolvedModifier } from '../CommonTypes';
+import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout, CFBooking, CFBookingAvailability, CFBookingResource } from '../CommonTypes';
 export * from './mocks';
 /** Replace mock catalog / context data in place (same array references mock handlers use). */
 export interface MockDatabaseConfig {
@@ -15,6 +15,10 @@ export interface MockDatabaseConfig {
     products?: CFProduct[];
     orders?: CFActiveOrder[];
     parkedOrders?: CFActiveOrder[];
+    /** Who is scarce: the staff, rooms or machines the dataset's services are booked against. */
+    bookingResources?: CFBookingResource[];
+    /** Windows already taken when the dataset loads, so a calendar does not open empty. */
+    bookings?: CFBooking[];
 }
 export declare const MOCK_COMPANY: CFActiveCompany;
 export declare const MOCK_OUTLET_MAIN: CFActiveOutlet;
@@ -59,6 +63,7 @@ export declare const MOCK_STATIONS: import("@final-commerce/common/pos-types").A
 export declare const MOCK_OUTLETS: import("@final-commerce/common/pos-types").ActiveOutlet[];
 export declare const MOCK_CUSTOMERS: import("@final-commerce/common/pos-types").ActiveCustomer[];
 export declare const MOCK_CATEGORIES: import("@final-commerce/common/pos-types").Category[];
+export declare const MOCK_PRODUCT_HAIRCUT: CFProduct;
 export declare const MOCK_PRODUCTS: import("@final-commerce/common/pos-types").FullProduct[];
 export declare const MOCK_ORDERS: import("@final-commerce/common/pos-types").ActiveOrder[];
 export declare const MOCK_PARKED_ORDERS: CFActiveOrder[];
@@ -87,26 +92,9 @@ export declare const createOrderFromCart: (paymentType: string, amount: number,
  * open with `amountToBeCharged` reset to what's left, and returns null.
  */
 export declare const applyMockPayment: (amount: number, paymentType: string, processor?: string) => CFActiveOrder | null;
-/**
- * Price the cashier's raw modifier answers into the rows a CART line carries (FT-0010).
- *
- * Here rather than in an action folder because two mocks need it — addProductToCart and
- * setProductModifierSelections — and this module is already where the shared mock helpers
- * live (`safeSerialize`, `resetMockCart`, `mockPublishEvent`).
- *
- * Note the two shapes that share the name `modifiers` and are NOT interchangeable:
- * `FullProduct.modifiers` is `ResolvedModifier[]` (the menu — question + every choice),
- * `ActiveProduct.modifiers` is `CartLineModifier[]` (one row per CHOSEN choice). The mock
- * builds a cart line by spreading the product, so the menu must be stripped off the line
- * before anything reads it, or every surface renders the catalogue as if it were picked.
- *
- * Names and unitPrice are snapshotted, as the real host does — a later rename never
- * rewrites an open cart. No `total`: a cart row is per line UNIT, and the host extends it.
- * Rule validation (required/min/max) is deliberately not mocked; the real host owns it.
- */
-/** Extend a line's priced modifier rows by the line quantity. Mirrors kaching's `buildProdModifiers`. */
-export declare const buildModifierRows: (modifiers: CFCartLineModifier[] | undefined, lineQuantity: number | undefined) => {
-    rows: CFProdModifierBreakdown[];
-    modifiersTotal: number;
-};
-export declare const buildCartLineModifiers: (menu: CFResolvedModifier[] | undefined, selections: CFModifierSelection[] | undefined, productTaxTableId?: string) => CFCartLineModifier[];
+export declare const MOCK_BOOKING_RULES_ID = "rule_salon_30";
+export declare const MOCK_BOOKING_RESOURCES: CFBookingResource[];
+export declare const MOCK_BOOKINGS: CFBooking[];
+/** Live = confirmed, or held and not yet expired. An expired hold occupies nothing. */
+export declare const mockLiveBookings: () => CFBooking[];
+export declare const mockBookingAvailability: (productId: string, from: Date, to: Date, resourceId?: string) => CFBookingAvailability;

package/dist/demo/database.js

@@ -4,6 +4,7 @@
  */
 import { CFProductType, CFUserTypes, CurrencyCode, } from '../CommonTypes';
 import { 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
 const ASSETS_BASE_URL = 'https://raw.githubusercontent.com/Final-Commerce/command-frame/refs/heads/main/src/demo/assets';
@@ -649,6 +650,14 @@ export const MOCK_CATEGORIES = [
     MOCK_CATEGORY_VEGAN,
     MOCK_CATEGORY_SPICY,
 ];
+// A service, not a thing on a shelf: no stock, sold as a slot of somebody's time.
+// `bookingRulesId` is what tells a catalogue screen to ask for slots instead of stock.
+export const MOCK_PRODUCT_HAIRCUT = {
+    ...createSimpleProduct('prod_haircut', 'Haircut', 4500, '', [MOCK_CATEGORY_SPECIALTY], 'Cut and finish, 30 minutes.'),
+    images: [],
+    productType: CFProductType.BOOKING,
+    bookingRulesId: 'rule_salon_30',
+};
 export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_BASIL_ALMOND,
     MOCK_PRODUCT_BEER,
@@ -664,6 +673,7 @@ export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_CHILI_GARLIC,
     MOCK_PRODUCT_HABANERO,
     MOCK_PRODUCT_BLACK_GARLIC,
+    MOCK_PRODUCT_HAIRCUT,
 ];
 export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2, MOCK_ORDER_3, MOCK_ORDER_4];
 export const MOCK_PARKED_ORDERS = [MOCK_PARKED_ORDER_1, MOCK_PARKED_ORDER_2];
@@ -678,6 +688,7 @@ export let MOCK_CART = {
     remainingBalance: 0,
     products: [],
     customSales: [],
+    reservations: [],
     nonRevenueItems: [],
     customer: null,
 };
@@ -698,6 +709,7 @@ export const resetMockCart = () => {
         remainingBalance: 0,
         products: [],
         customSales: [],
+        reservations: [],
         nonRevenueItems: [],
         customer: null,
     };
@@ -742,6 +754,12 @@ export function setMockDatabase(config) {
     if (config.parkedOrders !== undefined) {
         MOCK_PARKED_ORDERS.splice(0, MOCK_PARKED_ORDERS.length, ...config.parkedOrders);
     }
+    if (config.bookingResources !== undefined) {
+        MOCK_BOOKING_RESOURCES.splice(0, MOCK_BOOKING_RESOURCES.length, ...config.bookingResources);
+    }
+    if (config.bookings !== undefined) {
+        MOCK_BOOKINGS.splice(0, MOCK_BOOKINGS.length, ...config.bookings);
+    }
     if (MOCK_OUTLETS.length > 0) {
         Object.assign(MOCK_OUTLET_MAIN, MOCK_OUTLETS[0]);
         if (MOCK_OUTLET_MAIN.id === undefined && MOCK_OUTLET_MAIN._id !== undefined) {
@@ -878,6 +896,30 @@ export const createOrderFromCart = (paymentType, amount, processor = 'cash') =>
         billing: MOCK_CART.customer?.billing || null,
         shipping: MOCK_CART.customer?.shipping || null,
         lineItems,
+        // A paid booking is a sale: it belongs on the order (and thus the receipt),
+        // in its own array rather than among the line items, and CONFIRMED — payment
+        // is what turns a held window into a kept appointment.
+        reservations: (MOCK_CART.reservations ?? []).map((reservation) => ({
+            internalId: reservation.internalId,
+            bookingId: reservation.bookingId,
+            productId: reservation.productId,
+            variantId: reservation.variantId,
+            resourceId: reservation.resourceId,
+            name: reservation.name,
+            resourceName: reservation.resourceName,
+            price: reservation.price,
+            quantity: reservation.quantity,
+            total: reservation.total,
+            taxTableId: reservation.taxTableId,
+            startAt: reservation.startAt,
+            endAt: reservation.endAt,
+            bufferEndAt: reservation.bufferEndAt,
+            // The mock computes no tax anywhere — line items ship `taxes: []` too.
+            taxes: [],
+            // Neither `expiresAt` nor a status comes along: a booking's state lives on its own
+            // row — which is what `getBookings` reads — and a copy frozen on the order would be
+            // wrong from the next moment on.
+        })),
         customSales: [],
         balance: 0,
         user: employeeUser,
@@ -914,71 +956,88 @@ export const applyMockPayment = (amount, paymentType, processor = 'cash') => {
     mockPublishEvent('payments', 'payment-done', { order });
     return order;
 };
-/**
- * Price the cashier's raw modifier answers into the rows a CART line carries (FT-0010).
- *
- * Here rather than in an action folder because two mocks need it — addProductToCart and
- * setProductModifierSelections — and this module is already where the shared mock helpers
- * live (`safeSerialize`, `resetMockCart`, `mockPublishEvent`).
- *
- * Note the two shapes that share the name `modifiers` and are NOT interchangeable:
- * `FullProduct.modifiers` is `ResolvedModifier[]` (the menu — question + every choice),
- * `ActiveProduct.modifiers` is `CartLineModifier[]` (one row per CHOSEN choice). The mock
- * builds a cart line by spreading the product, so the menu must be stripped off the line
- * before anything reads it, or every surface renders the catalogue as if it were picked.
- *
- * Names and unitPrice are snapshotted, as the real host does — a later rename never
- * rewrites an open cart. No `total`: a cart row is per line UNIT, and the host extends it.
- * Rule validation (required/min/max) is deliberately not mocked; the real host owns it.
- */
-/** Extend a line's priced modifier rows by the line quantity. Mirrors kaching's `buildProdModifiers`. */
-export const buildModifierRows = (modifiers, lineQuantity) => {
-    const quantity = lineQuantity ?? 1;
-    const rows = (modifiers ?? []).map((modifier) => ({
-        modifierId: modifier.modifierId,
-        modifierName: modifier.modifierName,
-        choiceId: modifier.choiceId,
-        choiceName: modifier.choiceName,
-        label: modifier.label ?? `${modifier.modifierName} - ${modifier.choiceName}`,
-        unitPrice: modifier.unitPrice,
-        quantity: modifier.quantity,
-        // extendPrice, not a raw multiply: a fractional line quantity (1.5 kg) must not
-        // leave fractional minor units on the row.
-        amount: extendPrice(modifier.unitPrice * modifier.quantity, quantity),
-        tax: 0,
-        ...(modifier.taxTableId ? { taxTableId: modifier.taxTableId } : {}),
-        ...(modifier.taxRateId ? { taxRateId: modifier.taxRateId } : {})
-    }));
-    return { rows, modifiersTotal: rows.reduce((sum, row) => sum + row.amount, 0) };
-};
-export const buildCartLineModifiers = (menu, selections, productTaxTableId) => {
-    if (!menu?.length || !selections?.length)
-        return [];
-    const byModifier = new Map(menu.map((modifier) => [modifier._id, modifier]));
-    const rows = [];
-    for (const selection of selections) {
-        const modifier = byModifier.get(selection.modifierId);
-        if (!modifier)
+// ── Booking (FT-0064) ────────────────────────────────────────────────────────────
+// A salon: one service, two people who can perform it, a 30-minute slot with a
+// 5-minute turnaround, open 9–18. Enough to click through a booking screen with no
+// server. Availability here is COMPUTED, exactly as the host computes it — a mock
+// that returned a fixed list of slots would hide the one behaviour that matters:
+// a slot disappears once somebody takes it.
+export const MOCK_BOOKING_RULES_ID = 'rule_salon_30';
+const SLOT_MINUTES = 30;
+const BUFFER_MINUTES = 5;
+const OPEN_HOUR = 9;
+const CLOSE_HOUR = 18;
+// Rooms, not people: a resource is whatever is scarce, and a room is the case that
+// reads the same in every vertical a dataset might describe.
+export const MOCK_BOOKING_RESOURCES = [
+    { id: 'res_room_1', name: 'Room 1', kind: BookingResourceKind.ROOM },
+    { id: 'res_room_2', name: 'Room 2', kind: BookingResourceKind.ROOM },
+];
+const at = (dayOffset, hour, minute = 0) => {
+    const date = new Date();
+    date.setDate(date.getDate() + dayOffset);
+    date.setHours(hour, minute, 0, 0);
+    return date;
+};
+const booking = (id, resourceId, start, status, customerName) => ({
+    id,
+    productId: MOCK_PRODUCT_HAIRCUT._id,
+    resourceId,
+    startAt: start.toISOString(),
+    endAt: new Date(start.getTime() + SLOT_MINUTES * 60000).toISOString(),
+    bufferEndAt: new Date(start.getTime() + (SLOT_MINUTES + BUFFER_MINUTES) * 60000).toISOString(),
+    status,
+    productName: MOCK_PRODUCT_HAIRCUT.name,
+    resourceName: MOCK_BOOKING_RESOURCES.find((resource) => resource.id === resourceId)?.name,
+    customerName,
+});
+export const MOCK_BOOKINGS = [
+    booking('bk_1', 'res_room_1', at(0, 10), ReservationStatus.CONFIRMED, 'Alex Green'),
+    booking('bk_2', 'res_room_2', at(0, 11, 30), ReservationStatus.CONFIRMED, 'Dana White'),
+    booking('bk_3', 'res_room_1', at(1, 9, 30), ReservationStatus.CONFIRMED, 'Sam Blue'),
+];
+/** Live = confirmed, or held and not yet expired. An expired hold occupies nothing. */
+export const mockLiveBookings = () => MOCK_BOOKINGS.filter(({ status, expiresAt }) => status === ReservationStatus.CONFIRMED ||
+    (status === ReservationStatus.HELD && (!expiresAt || new Date(expiresAt) > new Date())));
+const takenBy = (resourceId, startAt, bufferEndAt) => mockLiveBookings().some((entry) => entry.resourceId === resourceId && new Date(entry.startAt) < bufferEndAt && new Date(entry.bufferEndAt) > startAt);
+export const mockBookingAvailability = (productId, from, to, resourceId) => {
+    const serving = resourceId
+        ? MOCK_BOOKING_RESOURCES.filter((resource) => resource.id === resourceId)
+        : MOCK_BOOKING_RESOURCES;
+    const slots = [];
+    const step = (SLOT_MINUTES + BUFFER_MINUTES) * 60000;
+    for (let day = 0; day < 14; day += 1) {
+        const open = at(day, OPEN_HOUR);
+        if (open < from || open > to)
             continue;
-        const byChoice = new Map(modifier.choices.map((choice) => [choice._id, choice]));
-        for (const picked of selection.choices ?? []) {
-            const choice = byChoice.get(picked.choiceId);
-            // `quantity` is units per ONE line unit; 0 means "not chosen" and carries no row.
-            if (!choice || !(picked.quantity > 0))
+        const close = at(day, CLOSE_HOUR);
+        for (let start = open.getTime(); start + SLOT_MINUTES * 60000 <= close.getTime(); start += step) {
+            const startAt = new Date(start);
+            const endAt = new Date(start + SLOT_MINUTES * 60000);
+            const bufferEndAt = new Date(start + (SLOT_MINUTES + BUFFER_MINUTES) * 60000);
+            if (bufferEndAt < new Date())
                 continue;
-            rows.push({
-                modifierId: modifier._id,
-                modifierName: modifier.name,
-                choiceId: choice._id,
-                choiceName: choice.name,
-                // The cart's display label, like CustomFee.label — "Toppings - Avocado".
-                label: `${modifier.name} - ${choice.name}`,
-                unitPrice: choice.price,
-                quantity: picked.quantity,
-                // Modifier tax follows the parent product's table, as a fee's does.
-                ...(productTaxTableId ? { taxTableId: productTaxTableId } : {}),
+            const resources = serving.map((resource) => {
+                const free = takenBy(resource.id, startAt, bufferEndAt) ? 0 : 1;
+                return { resourceId: resource.id, name: resource.name, capacity: 1, booked: 1 - free, free };
+            });
+            slots.push({
+                startAt: startAt.toISOString(),
+                endAt: endAt.toISOString(),
+                bufferEndAt: bufferEndAt.toISOString(),
+                canStart: true,
+                capacity: resources.length,
+                booked: resources.reduce((sum, entry) => sum + entry.booked, 0),
+                free: resources.reduce((sum, entry) => sum + entry.free, 0),
+                resources,
             });
         }
     }
-    return rows;
+    return {
+        productId,
+        bookingRulesId: MOCK_BOOKING_RULES_ID,
+        bookingType: BookingType.APPOINTMENT,
+        ratePeriod: BookingRatePeriod.SLOT,
+        slots,
+    };
 };

package/dist/index.d.ts

@@ -2,6 +2,13 @@ export declare const command: {
     readonly exampleFunction: import(".").ExampleFunction;
     readonly generateAPIKey: import(".").GenerateAPIKey;
     readonly getProducts: import(".").GetProducts;
+    readonly getBookingResources: import(".").GetBookingResources;
+    readonly getBookingAvailability: import(".").GetBookingAvailability;
+    readonly getBookings: import(".").GetBookings;
+    readonly holdBooking: import(".").HoldBooking;
+    readonly addBookingToCart: import(".").AddBookingToCart;
+    readonly removeBookingFromCart: import(".").RemoveBookingFromCart;
+    readonly cancelBooking: import(".").CancelBooking;
     readonly addCustomSale: import(".").AddCustomSale;
     readonly editCustomSale: import(".").EditCustomSale;
     readonly addNonRevenueItem: import(".").AddNonRevenueItem;
@@ -21,8 +28,6 @@ export declare const command: {
     readonly getFinalContext: import(".").GetFinalContext;
     readonly addProductNote: import(".").AddProductNote;
     readonly addProductFee: import(".").AddProductFee;
-    readonly getProductModifierSelections: import(".").GetProductModifierSelections;
-    readonly setProductModifierSelections: import(".").SetProductModifierSelections;
     readonly setActiveProductFee: import(".").SetActiveProductFee;
     readonly setActiveProductDiscount: import(".").SetActiveProductDiscount;
     readonly getActiveProduct: import(".").GetActiveProduct;
@@ -121,6 +126,13 @@ export declare const command: {
 export type { ExampleFunction, ExampleFunctionParams, ExampleFunctionResponse } from './actions/example-function/types';
 export type { GenerateAPIKey, GenerateAPIKeyParams, GenerateAPIKeyResponse } from './actions/generate-api-key/types';
 export type { GetProducts, GetProductsParams, GetProductsResponse } from './actions/get-products/types';
+export type { GetBookingResources, GetBookingResourcesParams, GetBookingResourcesResponse, } from './actions/get-booking-resources/types';
+export type { GetBookingAvailability, GetBookingAvailabilityParams, GetBookingAvailabilityResponse, } from './actions/get-booking-availability/types';
+export type { GetBookings, GetBookingsParams, GetBookingsResponse } from './actions/get-bookings/types';
+export type { HoldBooking, HoldBookingParams, HoldBookingResponse } from './actions/hold-booking/types';
+export type { AddBookingToCart, AddBookingToCartParams, AddBookingToCartResponse, } from './actions/add-booking-to-cart/types';
+export type { RemoveBookingFromCart, RemoveBookingFromCartParams, RemoveBookingFromCartResponse, } from './actions/remove-booking-from-cart/types';
+export type { CancelBooking, CancelBookingParams, CancelBookingResponse } from './actions/cancel-booking/types';
 export type { AddCustomSale, AddCustomSaleParams, AddCustomSaleResponse } from './actions/add-custom-sale/types';
 export type { EditCustomSale, EditCustomSaleParams, EditCustomSaleResponse } from './actions/edit-custom-sale/types';
 export type { AddNonRevenueItem, AddNonRevenueItemParams, AddNonRevenueItemResponse, } from './actions/add-non-revenue-item/types';
@@ -159,8 +171,6 @@ export type { GetContext, GetContextResponse, GetContextResponseManage, GetConte
 export type { GetFinalContext, GetFinalContextResponse } from './actions/get-final-context/types';
 export type { AddProductNote, AddProductNoteParams, AddProductNoteResponse } from './actions/add-product-note/types';
 export type { AddProductFee, AddProductFeeParams, AddProductFeeResponse } from './actions/add-product-fee/types';
-export type { GetProductModifierSelections, GetProductModifierSelectionsParams, GetProductModifierSelectionsResponse, ModifierSelection, ModifierChoiceSelection, } from './actions/get-product-modifier-selections/types';
-export type { SetProductModifierSelections, SetProductModifierSelectionsParams, SetProductModifierSelectionsResponse, } from './actions/set-product-modifier-selections/types';
 export type { SetActiveProductFee, SetActiveProductFeeParams, SetActiveProductFeeResponse, } from './actions/set-active-product-fee/types';
 export type { SetActiveProductDiscount, SetActiveProductDiscountParams, SetActiveProductDiscountResponse, } from './actions/set-active-product-discount/types';
 export type { GetActiveProduct, GetActiveProductResponse } from './actions/get-active-product/types';
@@ -249,6 +259,7 @@ export { variantsTopic } from './pubsub/topics/variants';
 export { transactionsTopic } from './pubsub/topics/transactions';
 export { categoriesTopic } from './pubsub/topics/categories';
 export { attributesTopic } from './pubsub/topics/attributes';
+export { bookingsTopic } from './pubsub/topics/bookings';
 export type { CustomerCreatedPayload, CustomerUpdatedPayload, CustomerNoteAddedPayload, CustomerNoteDeletedPayload, CustomerAssignedPayload, CustomerUnassignedPayload, CustomerActiveSetPayload, CustomerActiveGetPayload, CustomerCreatedEvent, CustomerUpdatedEvent, CustomerNoteAddedEvent, CustomerNoteDeletedEvent, CustomerAssignedEvent, CustomerUnassignedEvent, CustomerActiveSetEvent, CustomerActiveGetEvent, CustomersEventType, CustomersEventPayload, } from './pubsub/topics/customers/types';
 export type { OrderCreatedPayload, OrderUpdatedPayload, OrderVoidedPayload, OrderActiveSetPayload, OrderActiveGetPayload, OrderCreatedEvent, OrderUpdatedEvent, OrderVoidedEvent, OrderActiveSetEvent, OrderActiveGetEvent, OrderStateTransitionCompletedPayload, OrderStateTransitionBlockedPayload, OrderStateTransitionCompletedEvent, OrderStateTransitionBlockedEvent, OrdersEventType, OrdersEventPayload, } from './pubsub/topics/orders/types';
 export type { RefundCreatedPayload, RefundUpdatedPayload, RefundActiveSetPayload, RefundActiveGetPayload, RefundCreatedEvent, RefundUpdatedEvent, RefundActiveSetEvent, RefundActiveGetEvent, RefundsEventType, RefundsEventPayload, } from './pubsub/topics/refunds/types';
@@ -259,6 +270,7 @@ export type { SessionActiveSetPayload, SessionActiveGetPayload, SessionActiveSet
 export type { UserActiveSetPayload, UserActiveGetPayload, UserActiveSetEvent, UserActiveGetEvent, UserCreatedPayload, UserCreatedEvent, UserUpdatedPayload, UserUpdatedEvent, UsersEventType, UsersEventPayload, } from './pubsub/topics/users/types';
 export type { VariantCreatedPayload, VariantCreatedEvent, VariantUpdatedPayload, VariantUpdatedEvent, VariantsEventType, VariantsEventPayload, } from './pubsub/topics/variants/types';
 export type { TransactionCreatedPayload, TransactionCreatedEvent, TransactionUpdatedPayload, TransactionUpdatedEvent, TransactionsEventType, TransactionsEventPayload, } from './pubsub/topics/transactions/types';
+export type { BookingCreatedPayload, BookingCreatedEvent, BookingUpdatedPayload, BookingUpdatedEvent, BookingSetupChangedPayload, BookingSetupChangedEvent, BookingsEventType, BookingsEventPayload, } from './pubsub/topics/bookings/types';
 export type { CategoryCreatedPayload, CategoryCreatedEvent, CategoryUpdatedPayload, CategoryUpdatedEvent, CategoriesEventType, CategoriesEventPayload, } from './pubsub/topics/categories/types';
 export type { AttributeCreatedPayload, AttributeCreatedEvent, AttributeUpdatedPayload, AttributeUpdatedEvent, AttributesEventType, AttributesEventPayload, } from './pubsub/topics/attributes/types';
 export type { CartCreatedPayload, CartCustomerAssignedPayload, ProductAddedPayload, ProductDeletedPayload, CartDiscountAddedPayload, CartDiscountRemovedPayload, CartFeeAddedPayload, CartFeeRemovedPayload, ProductDiscountAddedPayload, ProductDiscountRemovedPayload, ProductFeeAddedPayload, ProductFeeRemovedPayload, ProductNoteAddedPayload, ProductNoteRemovedPayload, CartCreatedEvent, CartCustomerAssignedEvent, ProductAddedEvent, ProductDeletedEvent, CartDiscountAddedEvent, CartDiscountRemovedEvent, CartFeeAddedEvent, CartFeeRemovedEvent, ProductDiscountAddedEvent, ProductDiscountRemovedEvent, ProductFeeAddedEvent, ProductFeeRemovedEvent, ProductNoteAddedEvent, ProductNoteRemovedEvent, CartEventType, CartEventPayload, } from './pubsub/topics/cart/types';

package/dist/index.js

@@ -1,6 +1,13 @@
 // Import actions from new folder structure
 import { exampleFunction } from './actions/example-function/action';
 import { getProducts } from './actions/get-products/action';
+import { getBookingResources } from './actions/get-booking-resources/action';
+import { getBookingAvailability } from './actions/get-booking-availability/action';
+import { getBookings } from './actions/get-bookings/action';
+import { holdBooking } from './actions/hold-booking/action';
+import { addBookingToCart } from './actions/add-booking-to-cart/action';
+import { removeBookingFromCart } from './actions/remove-booking-from-cart/action';
+import { cancelBooking } from './actions/cancel-booking/action';
 import { addCustomSale } from './actions/add-custom-sale/action';
 import { editCustomSale } from './actions/edit-custom-sale/action';
 import { addNonRevenueItem } from './actions/add-non-revenue-item/action';
@@ -20,8 +27,6 @@ import { updateCartItemQuantity } from './actions/update-cart-item-quantity/acti
 // Product Actions
 import { addProductNote } from './actions/add-product-note/action';
 import { addProductFee } from './actions/add-product-fee/action';
-import { getProductModifierSelections } from './actions/get-product-modifier-selections/action';
-import { setProductModifierSelections } from './actions/set-product-modifier-selections/action';
 import { setActiveProductFee } from './actions/set-active-product-fee/action';
 import { setActiveProductDiscount } from './actions/set-active-product-discount/action';
 import { getActiveProduct } from './actions/get-active-product/action';
@@ -139,6 +144,13 @@ export const command = {
     exampleFunction,
     generateAPIKey,
     getProducts,
+    getBookingResources,
+    getBookingAvailability,
+    getBookings,
+    holdBooking,
+    addBookingToCart,
+    removeBookingFromCart,
+    cancelBooking,
     addCustomSale,
     editCustomSale,
     addNonRevenueItem,
@@ -159,8 +171,6 @@ export const command = {
     // Product Actions
     addProductNote,
     addProductFee,
-    getProductModifierSelections,
-    setProductModifierSelections,
     setActiveProductFee,
     setActiveProductDiscount,
     getActiveProduct,
@@ -305,6 +315,7 @@ export { variantsTopic } from './pubsub/topics/variants';
 export { transactionsTopic } from './pubsub/topics/transactions';
 export { categoriesTopic } from './pubsub/topics/categories';
 export { attributesTopic } from './pubsub/topics/attributes';
+export { bookingsTopic } from './pubsub/topics/bookings';
 // Export Custom Tables Types
 export { AttributeType } from './common-types/attribute-type';
 // State Machine Fragments

package/dist/projects/render/mocks.js

@@ -12,8 +12,6 @@ import { mockAddOrderNote } from '../../actions/add-order-note/mock';
 import { mockRemoveOrderNote } from '../../actions/remove-order-note/mock';
 import { mockAddProductDiscount } from '../../actions/add-product-discount/mock';
 import { mockAddProductFee } from '../../actions/add-product-fee/mock';
-import { mockGetProductModifierSelections } from '../../actions/get-product-modifier-selections/mock';
-import { mockSetProductModifierSelections } from '../../actions/set-product-modifier-selections/mock';
 import { mockRemoveProductDiscount } from '../../actions/remove-product-discount/mock';
 import { mockRemoveProductFee } from '../../actions/remove-product-fee/mock';
 import { mockSetActiveProductFee } from '../../actions/set-active-product-fee/mock';
@@ -44,6 +42,13 @@ import { mockGetCurrentCart } from '../../actions/get-current-cart/mock';
 import { mockGetCustomers } from '../../actions/get-customers/mock';
 import { mockGetOrders } from '../../actions/get-orders/mock';
 import { mockGetProducts } from '../../actions/get-products/mock';
+import { mockGetBookingResources } from '../../actions/get-booking-resources/mock';
+import { mockGetBookingAvailability } from '../../actions/get-booking-availability/mock';
+import { mockGetBookings } from '../../actions/get-bookings/mock';
+import { mockHoldBooking } from '../../actions/hold-booking/mock';
+import { mockAddBookingToCart } from '../../actions/add-booking-to-cart/mock';
+import { mockRemoveBookingFromCart } from '../../actions/remove-booking-from-cart/mock';
+import { mockCancelBooking } from '../../actions/cancel-booking/mock';
 import { mockGetRefunds } from '../../actions/get-refunds/mock';
 import { mockGetTaxTables } from '../../actions/get-tax-tables/mock';
 import { mockGetRemainingRefundableQuantities } from '../../actions/get-remaining-refundable-quantities/mock';
@@ -114,8 +119,6 @@ export const RENDER_MOCKS = {
     addOrderNote: mockAddOrderNote,
     addProductDiscount: mockAddProductDiscount,
     addProductFee: mockAddProductFee,
-    getProductModifierSelections: mockGetProductModifierSelections,
-    setProductModifierSelections: mockSetProductModifierSelections,
     setActiveProductFee: mockSetActiveProductFee,
     setActiveProductDiscount: mockSetActiveProductDiscount,
     getActiveProduct: mockGetActiveProduct,
@@ -142,6 +145,13 @@ export const RENDER_MOCKS = {
     getCustomers: mockGetCustomers,
     getOrders: mockGetOrders,
     getProducts: mockGetProducts,
+    getBookingResources: mockGetBookingResources,
+    getBookingAvailability: mockGetBookingAvailability,
+    getBookings: mockGetBookings,
+    holdBooking: mockHoldBooking,
+    addBookingToCart: mockAddBookingToCart,
+    removeBookingFromCart: mockRemoveBookingFromCart,
+    cancelBooking: mockCancelBooking,
     getRefunds: mockGetRefunds,
     getTaxTables: mockGetTaxTables,
     getRemainingRefundableQuantities: mockGetRemainingRefundableQuantities,

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

@@ -1,7 +1,14 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, GetActiveStation, GetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms, 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, 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';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
+    getBookingResources: GetBookingResources;
+    getBookingAvailability: GetBookingAvailability;
+    getBookings: GetBookings;
+    holdBooking: HoldBooking;
+    addBookingToCart: AddBookingToCart;
+    removeBookingFromCart: RemoveBookingFromCart;
+    cancelBooking: CancelBooking;
     addCustomSale: AddCustomSale;
     editCustomSale: EditCustomSale;
     getCustomers: GetCustomers;
@@ -21,8 +28,6 @@ export interface RenderProviderActions {
     getFinalContext: GetFinalContext;
     addProductNote: AddProductNote;
     addProductFee: AddProductFee;
-    getProductModifierSelections: GetProductModifierSelections;
-    setProductModifierSelections: SetProductModifierSelections;
     setActiveProductFee: SetActiveProductFee;
     setActiveProductDiscount: SetActiveProductDiscount;
     getActiveProduct: GetActiveProduct;

package/dist/pubsub/topics/bookings/booking-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFBooking } from '../../../../CommonTypes';
+import type { TopicEvent } from '../../../types';
+export interface BookingCreatedPayload {
+    booking: CFBooking;
+}
+export type BookingCreatedEvent = TopicEvent<BookingCreatedPayload>;

package/dist/pubsub/topics/bookings/booking-created/types.js

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

package/dist/pubsub/topics/bookings/booking-setup-changed/types.d.ts

@@ -0,0 +1,15 @@
+import type { TopicEvent } from '../../../types';
+/**
+ * What a booking can be MADE of changed — a rule set, a resource, who serves a product, or where
+ * a resource works. Occupancy is untouched.
+ *
+ * Deliberately carries no row: the change can span several collections at once (a rule set edited
+ * AND a product↔resource link removed), and a subscriber cannot act on a partial picture anyway.
+ * The only correct reaction is to re-ask `getBookingResources` and `getBookingAvailability`,
+ * because both previous answers were computed from the old setup.
+ */
+export interface BookingSetupChangedPayload {
+    /** Which collection moved, when the host knows: `booking-rules`, `booking-resources`, … */
+    collection?: string;
+}
+export type BookingSetupChangedEvent = TopicEvent<BookingSetupChangedPayload>;

package/dist/pubsub/topics/bookings/booking-setup-changed/types.js

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

package/dist/pubsub/topics/bookings/booking-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFBooking } from '../../../../CommonTypes';
+import type { TopicEvent } from '../../../types';
+export interface BookingUpdatedPayload {
+    booking: CFBooking;
+}
+export type BookingUpdatedEvent = TopicEvent<BookingUpdatedPayload>;

package/dist/pubsub/topics/bookings/booking-updated/types.js

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

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

@@ -0,0 +1,3 @@
+import type { TopicDefinition } from '../../types';
+export declare const bookingsTopic: TopicDefinition;
+export * from './types';

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

@@ -0,0 +1,27 @@
+export const bookingsTopic = {
+    id: 'bookings',
+    name: 'Bookings',
+    description: 'Topic for bookings synced from the database. A booking IS the occupancy, so this is the ' +
+        'signal that somebody else took (or freed) a window: re-ask getBookingAvailability when it ' +
+        'fires instead of polling the server on a timer.',
+    eventTypes: [
+        {
+            id: 'booking-created',
+            name: 'Booking Created',
+            description: 'Published when a booking made elsewhere — another till, the back office — is synced in',
+        },
+        {
+            id: 'booking-updated',
+            name: 'Booking Updated',
+            description: 'Published when a synced booking changes: confirmed after payment, cancelled, or expired',
+        },
+        {
+            id: 'booking-setup-changed',
+            name: 'Booking Setup Changed',
+            description: 'Published when what a booking can be MADE of changes: a rule set, a resource, who serves ' +
+                'a product, or where a resource works. Occupancy is untouched — re-ask getBookingResources ' +
+                'and getBookingAvailability, because both answers were computed from the old setup.',
+        },
+    ],
+};
+export * from './types';