@final-commerce/command-frame 0.8.0-online.4 → 0.8.0-preprod.1

package/dist/actions/hold-booking/mock.js

@@ -0,0 +1,37 @@
+import { MOCK_BOOKINGS, MOCK_BOOKING_RESOURCES, mockLiveBookings } from '../../demo/database';
+import { ReservationStatus } from '@final-commerce/common';
+const BUFFER_MINUTES = 5;
+const HOLD_MINUTES = 10;
+let held = 0;
+export const mockHoldBooking = async (params) => {
+    console.log('[Mock] holdBooking called', params);
+    const startAt = new Date(params.startAt);
+    const endAt = new Date(params.endAt);
+    const bufferEndAt = new Date(endAt.getTime() + BUFFER_MINUTES * 60000);
+    // The mock refuses a taken window like the host does. A mock that always said yes would
+    // let a booking screen ship without ever handling the one error it will actually meet.
+    const clash = mockLiveBookings().some((entry) => entry.resourceId === params.resourceId &&
+        new Date(entry.startAt) < bufferEndAt &&
+        new Date(entry.bufferEndAt) > startAt);
+    if (clash) {
+        return { success: false, reason: 'That window has just been taken — pick another slot.', timestamp: new Date().toISOString() };
+    }
+    const booking = {
+        // A counter, not a clock: two holds in the same millisecond used to share an id, and cancel
+        // or remove then acted on the wrong row. Scripted tests hit that routinely.
+        id: `bk_mock_${(held += 1)}`,
+        productId: params.productId,
+        resourceId: params.resourceId,
+        variantId: params.variantId,
+        startAt: startAt.toISOString(),
+        endAt: endAt.toISOString(),
+        bufferEndAt: bufferEndAt.toISOString(),
+        customerId: params.customerId,
+        status: ReservationStatus.HELD,
+        expiresAt: new Date(Date.now() + HOLD_MINUTES * 60000).toISOString(),
+        resourceName: MOCK_BOOKING_RESOURCES.find(({ id }) => id === params.resourceId)?.name,
+    };
+    // Held in the same list availability reads, so the slot really does disappear.
+    MOCK_BOOKINGS.push(booking);
+    return { success: true, booking, timestamp: new Date().toISOString() };
+};

package/dist/actions/hold-booking/types.d.ts

@@ -0,0 +1,28 @@
+import { CFBooking } from '../../CommonTypes';
+export interface HoldBookingParams {
+    productId: string;
+    /** Which resource serves it: a member of staff, a room, a scooter. */
+    resourceId: string;
+    /** Must be the START of a slot the host offered, ISO 8601. */
+    startAt: string;
+    /**
+     * End of the window — the `endAt` of the slot you picked, or of the last slot in a stay.
+     * Required: a window that cannot be lined up with the grid is refused, and the till
+     * has no local copy of the rules to derive it from.
+     */
+    endAt: string;
+    /** The variant being sold, when the flow already knows which one. */
+    variantId?: string;
+    /** Whom the booking is for. Omit for a walk-in. */
+    customerId?: string;
+}
+export interface HoldBookingResponse {
+    /** False when the command was refused — a taken window, a rule, a booking that is not yours. */
+    success: boolean;
+    /** Why it was refused, in words a cashier can act on. Absent on success. */
+    reason?: string;
+    /** The claim. `expiresAt` says how long it survives unpaid; `id` is what you confirm or cancel. */
+    booking?: CFBooking;
+    timestamp: string;
+}
+export type HoldBooking = (params: HoldBookingParams) => Promise<HoldBookingResponse>;

package/dist/actions/hold-booking/types.js

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

package/dist/actions/process-partial-refund/types.d.ts

@@ -131,10 +131,10 @@ export interface ProcessPartialRefundParams {
     };
     /** Optional items to refund. */
     items?: {
-        /** internalId or variantId or customSaleId. */
+        /** internalId or variantId, customSaleId, or a booking's own internalId. */
         itemKey: string;
         quantity: number;
-        type?: 'product' | 'customSale' | 'fee' | 'tip';
+        type?: 'product' | 'customSale' | 'fee' | 'tip' | 'reservation';
         /**
          * Per-item stock disposition for a refunded **product** line — the
          * headless equivalent of the old refund popup's per-row restock/damaged

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

@@ -0,0 +1,6 @@
+/**
+ * Remove booking from cart action
+ * Calls the removeBookingFromCart action on the parent window
+ */
+import type { RemoveBookingFromCart } from './types';
+export declare const removeBookingFromCart: RemoveBookingFromCart;

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

@@ -0,0 +1,8 @@
+/**
+ * Remove booking from cart action
+ * Calls the removeBookingFromCart action on the parent window
+ */
+import { commandFrameClient } from '../../client';
+export const removeBookingFromCart = async (params) => {
+    return await commandFrameClient.call('removeBookingFromCart', params);
+};

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

@@ -0,0 +1,2 @@
+import { RemoveBookingFromCart } from './types';
+export declare const mockRemoveBookingFromCart: RemoveBookingFromCart;

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

@@ -0,0 +1,40 @@
+import { ReservationStatus } from '@final-commerce/common';
+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', 'cart-created', { cart: MOCK_CART });
+    }
+    // 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_/, '');
+    // CANCELLED, not deleted — the host releases a window by moving the row, and a mock that
+    // erased it hid both the trail and the fact that a released booking is still a booking.
+    const released = MOCK_BOOKINGS.find(({ id }) => id === bookingId);
+    if (released)
+        released.status = ReservationStatus.CANCELLED;
+    // An id the cart does not have is a refusal, as it is on the host — resolving with an empty
+    // booking made a failed remove look like a successful one.
+    if (!removed) {
+        return {
+            success: false,
+            reason: `Reservation ${params.reservationInternalId} is not in the cart`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    return {
+        success: true,
+        reservationInternalId: params.reservationInternalId,
+        booking: released,
+        timestamp: new Date().toISOString(),
+    };
+};

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

@@ -0,0 +1,16 @@
+import { CFBooking } from '../../CommonTypes';
+export interface RemoveBookingFromCartParams {
+    /** The reservation's own id, as `addBookingToCart` returned it. */
+    reservationInternalId: string;
+}
+export interface RemoveBookingFromCartResponse {
+    /** False when the command was refused — a taken window, a rule, a booking that is not yours. */
+    success: boolean;
+    /** Why it was refused, in words a cashier can act on. Absent on success. */
+    reason?: string;
+    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/actions/set-product-modifier-selections/action.d.ts

@@ -2,5 +2,5 @@
  * Set product modifier selections action
  * Calls the setProductModifierSelections action on the parent window
  */
-import type { SetProductModifierSelections } from "./types";
+import type { SetProductModifierSelections } from './types';
 export declare const setProductModifierSelections: SetProductModifierSelections;

package/dist/actions/set-product-modifier-selections/action.js

@@ -2,7 +2,7 @@
  * Set product modifier selections action
  * Calls the setProductModifierSelections action on the parent window
  */
-import { commandFrameClient } from "../../client";
+import { commandFrameClient } from '../../client';
 export const setProductModifierSelections = async (params) => {
-    return await commandFrameClient.call("setProductModifierSelections", params);
+    return await commandFrameClient.call('setProductModifierSelections', params);
 };

package/dist/actions/set-product-modifier-selections/mock.d.ts

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

package/dist/actions/set-product-modifier-selections/mock.js

@@ -1,15 +1,15 @@
-import { MOCK_CART, MOCK_PRODUCTS, buildCartLineModifiers, buildModifierRows } from "../../demo/database";
+import { MOCK_CART, MOCK_PRODUCTS, buildCartLineModifiers, buildModifierRows } from '../../demo/database';
 export const mockSetProductModifierSelections = async (params) => {
-    console.log("[Mock] setProductModifierSelections called", params);
+    console.log('[Mock] setProductModifierSelections called', params);
     if (!params?.selections) {
         return {
             success: false,
-            reason: "selections is required (pass [] to clear)",
+            reason: 'selections is required (pass [] to clear)',
             internalId: params?.internalId,
             selections: [],
             rows: [],
             modifiersTotal: 0,
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
         };
     }
     // Write the selections onto the mock cart line (last line when no internalId).
@@ -22,12 +22,12 @@ export const mockSetProductModifierSelections = async (params) => {
     if (!line) {
         return {
             success: false,
-            reason: "No matching cart line",
+            reason: 'No matching cart line',
             internalId: params.internalId,
             selections: [],
             rows: [],
             modifiersTotal: 0,
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
         };
     }
     // Full replacement — passing [] clears the rows. The line drops the product's resolved
@@ -44,6 +44,6 @@ export const mockSetProductModifierSelections = async (params) => {
         selections: params.selections,
         rows,
         modifiersTotal,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
     };
 };

package/dist/actions/set-product-modifier-selections/types.d.ts

@@ -1,5 +1,5 @@
-import type { ModifierSelection } from "../get-product-modifier-selections/types";
-import type { CFProdModifierBreakdown } from "../../CommonTypes";
+import type { ModifierSelection } from '../get-product-modifier-selections/types';
+import type { CFProdModifierBreakdown } from '../../CommonTypes';
 export interface SetProductModifierSelectionsParams {
     /** The cart line to edit. Defaults to the active product's line. */
     internalId?: string;

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, CFCartLineModifier, CFProdModifierBreakdown, CFModifierSelection, CFResolvedModifier } 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,6 +92,18 @@ 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;
+export declare const MOCK_BOOKING_RULES_ID = "rule_salon_30";
+export declare const MOCK_BOOKING_RESOURCES: CFBookingResource[];
+/**
+ * The clock this mock shop keeps — the same one `getContext` reports. They used to disagree: the
+ * slot hours were built with `setHours`, which is the MACHINE's clock, while the context claimed
+ * Vancouver. On a machine in Paris a correct screen showed a salon open from midnight to nine.
+ */
+export declare const MOCK_SHOP_TIME_ZONE = "America/Vancouver";
+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;
 /**
  * Price the cashier's raw modifier answers into the rows a CART line carries (FT-0010).
  *

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,
@@ -886,6 +928,18 @@ export const createOrderFromCart = (paymentType, amount, processor = 'cash') =>
         createdAt: new Date().toISOString(),
     };
     MOCK_ORDERS.push(newOrder);
+    // Payment is what turns a held window into a kept appointment, so the ROW moves too — the
+    // comment above said CONFIRMED while nothing set it. Left held, a paid appointment dropped out
+    // of `getBookings` when its deadline passed and the window could be taken again, which is the
+    // one transition a booking screen most needs to be able to test.
+    for (const reservation of newOrder.reservations ?? []) {
+        const row = MOCK_BOOKINGS.find(({ id }) => id === reservation.bookingId);
+        if (row) {
+            row.status = ReservationStatus.CONFIRMED;
+            row.orderId = newOrder._id;
+            row.expiresAt = undefined;
+        }
+    }
     resetMockCart();
     // Publish cart-created event after cart is reset (simulates new empty cart)
     mockPublishEvent('cart', 'cart-created', {});
@@ -914,6 +968,135 @@ export const applyMockPayment = (amount, paymentType, processor = 'cash') => {
     mockPublishEvent('payments', 'payment-done', { order });
     return order;
 };
+// ── 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 },
+];
+/**
+ * The clock this mock shop keeps — the same one `getContext` reports. They used to disagree: the
+ * slot hours were built with `setHours`, which is the MACHINE's clock, while the context claimed
+ * Vancouver. On a machine in Paris a correct screen showed a salon open from midnight to nine.
+ */
+export const MOCK_SHOP_TIME_ZONE = 'America/Vancouver';
+const at = (dayOffset, hour, minute = 0) => {
+    // The shop's wall clock, not this machine's. Two passes, because the offset is a function of
+    // the instant and the instant is what we are solving for.
+    const naive = Date.UTC(new Date().getUTCFullYear(), new Date().getUTCMonth(), new Date().getUTCDate() + dayOffset, hour, minute);
+    const offsetAt = (instant) => {
+        const parts = {};
+        for (const part of new Intl.DateTimeFormat('en-US', {
+            timeZone: MOCK_SHOP_TIME_ZONE,
+            hour12: false,
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+        }).formatToParts(new Date(instant))) {
+            parts[part.type] = part.value;
+        }
+        const asUtc = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour) % 24, Number(parts.minute));
+        return asUtc - instant;
+    };
+    return new Date(naive - offsetAt(naive - offsetAt(naive)));
+};
+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);
+/** The mock's shop day for an instant, `YYYY-MM-DD`, built from parts so it never reads as D/M/Y. */
+const shopDayOf = (instant) => {
+    const parts = {};
+    for (const part of new Intl.DateTimeFormat('en-CA', {
+        timeZone: MOCK_SHOP_TIME_ZONE,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    }).formatToParts(instant)) {
+        parts[part.type] = part.value;
+    }
+    return `${parts.year}-${parts.month}-${parts.day}`;
+};
+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);
+        const close = at(day, CLOSE_HOUR);
+        // Overlap, not containment. Asking from noon used to return nothing for today, because the
+        // day's opening hour lay before the range start — so an afternoon question got an empty
+        // calendar and read as "fully booked".
+        if (close <= from || open >= to)
+            continue;
+        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;
+            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,
+                // The shop day, as the real host stamps it. The mock keeps one shop on the machine's
+                // own clock, so here that is the machine's day — the point is that the FIELD is there,
+                // so a screen built against the mock never learns to work the day out for itself.
+                dayKey: shopDayOf(startAt),
+            });
+        }
+    }
+    return {
+        productId,
+        bookingRulesId: MOCK_BOOKING_RULES_ID,
+        bookingType: BookingType.APPOINTMENT,
+        ratePeriod: BookingRatePeriod.SLOT,
+        slots,
+        timeZone: MOCK_SHOP_TIME_ZONE,
+        days: [...new Set(slots.map((slot) => slot.dayKey))],
+    };
+};
 /**
  * Price the cashier's raw modifier answers into the rows a CART line carries (FT-0010).
  *

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;
@@ -45,8 +52,6 @@ export declare const command: {
     readonly integrationPayment: import(".").IntegrationPayment;
     readonly createPaymentLink: import(".").CreatePaymentLink;
     readonly chargeMoto: import(".").ChargeMoto;
-    readonly startCheckout: import(".").StartCheckout;
-    readonly resumeCheckout: import(".").ResumeCheckout;
     readonly addCustomerNote: import(".").AddCustomerNote;
     readonly removeCustomerNote: import(".").RemoveCustomerNote;
     readonly removeCustomerFromCart: import(".").RemoveCustomerFromCart;
@@ -123,6 +128,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';
@@ -184,8 +196,6 @@ export type { RedeemPayment, RedeemPaymentParams, RedeemPaymentResponse } from '
 export type { IntegrationPayment, IntegrationPaymentParams, IntegrationPaymentResponse, IntegrationEmvData, } from './actions/integration-payment/types';
 export type { CreatePaymentLink, CreatePaymentLinkParams, CreatePaymentLinkResponse, } from './actions/create-payment-link/types';
 export type { ChargeMoto, ChargeMotoParams, ChargeMotoResponse, ChargeMotoCardFields, } from './actions/charge-moto/types';
-export type { StartCheckout, StartCheckoutParams, StartCheckoutResponse, StartCheckoutContact, StartCheckoutOrder, } from './actions/start-checkout/types';
-export type { ResumeCheckout, ResumeCheckoutParams, ResumeCheckoutResponse, ResumeCheckoutResult, } from './actions/resume-checkout/types';
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse, } from './actions/add-customer-note/types';
 export type { RemoveCustomerNote, RemoveCustomerNoteParams, RemoveCustomerNoteResponse, } from './actions/remove-customer-note/types';
 export type { RemoveCustomerFromCart, RemoveCustomerFromCartResponse } from './actions/remove-customer-from-cart/types';
@@ -242,7 +252,6 @@ export { refundsTopic } from './pubsub/topics/refunds';
 export { productsTopic } from './pubsub/topics/products';
 export { cartTopic } from './pubsub/topics/cart';
 export { paymentsTopic } from './pubsub/topics/payments';
-export { checkoutTopic } from './pubsub/topics/checkout';
 export { splitPaymentsTopic } from './pubsub/topics/split-payments';
 export { customTablesTopic } from './pubsub/topics/custom-tables';
 export { printTopic } from './pubsub/topics/print';
@@ -254,6 +263,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';
@@ -264,11 +274,11 @@ 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';
 export type { PaymentDonePayload, PaymentErrPayload, PaymentDoneEvent, PaymentErrEvent, PaymentsEventType, PaymentsEventPayload, } from './pubsub/topics/payments/types';
-export type { CheckoutStartedPayload, PaymentCompletedPayload, PaymentFailedPayload, CheckoutStartedEvent, PaymentCompletedEvent, PaymentFailedEvent, CheckoutEventType, CheckoutEventPayload, } from './pubsub/topics/checkout/types';
 export type { SplitPaymentUpdatedPayload, SplitPaymentUpdatedEvent, SplitPaymentsEventType, SplitPaymentsEventPayload, } from './pubsub/topics/split-payments/types';
 export type { RowCreatedPayload, RowUpdatedPayload, RowDeletedPayload, RowCreatedEvent, RowUpdatedEvent, RowDeletedEvent, CustomTablesEventType, CustomTablesEventPayload, } from './pubsub/topics/custom-tables/types';
 export type { PrintStartedPayload, PrintCompletedPayload, PrintErrorPayload, PrintStartedEvent, PrintCompletedEvent, PrintErrorEvent, PrintEventType, PrintEventPayload, } from './pubsub/topics/print/types';