@final-commerce/command-frame 0.7.0-staging.3 → 0.8.0-online.1

package/dist/CommonTypes.d.ts

@@ -1,5 +1,5 @@
 export * from './common-types';
-import type { Tax, Tip, Address, MetadataItem, PosDataItem, CartFeeTaxEntry, CartFeeItem, CartDiscountItem, OrderNote, NonRevenueItem, DiscountDetail, FeeDetail, DiscountLineItem, FeeLineItem, LineItem, TipPayment, RefundedTipPayment, PaymentMethod, Discount, CustomFee, Summary, CustomSale, RefundedCustomSale, RefundItem, RefundedLineItem, ActiveStation, ActiveSession, ActiveOutlet, ActiveUser, ActiveUserRole, ActiveOrder, ActiveCart, ActivePark, ActiveCompany, ActiveCustomSales, ActiveProduct, ActiveCustomer, FullProduct, ProductVariant, Inventory, CustomerNote, Attribute, AttributeOption, Category, Transaction, ActiveSplitPayment, BookingAvailability, BookingSlot, BookingSlotResource, BookingResource, Booking, CartReservation, OrderReservation } from '@final-commerce/common/pos-types';
+import type { Tax, Tip, Address, MetadataItem, PosDataItem, CartFeeTaxEntry, CartFeeItem, CartDiscountItem, OrderNote, NonRevenueItem, DiscountDetail, FeeDetail, DiscountLineItem, FeeLineItem, LineItem, TipPayment, RefundedTipPayment, PaymentMethod, Discount, CustomFee, Summary, CustomSale, RefundedCustomSale, RefundItem, RefundedLineItem, ActiveStation, ActiveSession, ActiveOutlet, ActiveUser, ActiveUserRole, ActiveOrder, ActiveCart, ActivePark, ActiveCompany, ActiveCustomSales, ActiveProduct, ActiveCustomer, FullProduct, ProductVariant, Inventory, CustomerNote, Attribute, AttributeOption, Category, Transaction, ActiveSplitPayment } from '@final-commerce/common/pos-types';
 export { CurrencyCode, ProductType as CFProductType, UserTypes as CFUserTypes } from '@final-commerce/common';
 /** Open record used as a base for active entities. */
 export type CFActiveEntity = Record<string, unknown>;
@@ -18,16 +18,6 @@ export type CFTransaction = Transaction;
 export type CFCategory = Category;
 export type CFProductVariant = ProductVariant;
 export type CFProduct = FullProduct;
-export type CFBookingAvailability = BookingAvailability;
-export type CFBookingSlot = BookingSlot;
-export type CFBookingSlotResource = BookingSlotResource;
-export type CFBookingResource = BookingResource;
-export type CFBooking = Booking;
-/** A service sitting in the cart, and the same sale once it is on an order. A flow that draws a
- *  cart or a receipt needs both by name — reaching into the package's dist for them is not an
- *  interface. */
-export type CFCartReservation = CartReservation;
-export type CFOrderReservation = OrderReservation;
 export type CFActiveProduct = ActiveProduct;
 export type CFCustomer = ActiveCustomer;
 export type CFActiveCustomer = ActiveCustomer;

package/dist/actions/start-checkout/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Start Checkout action
+ * Calls the startCheckout action on the parent window
+ */
+import type { StartCheckout } from './types';
+export declare const startCheckout: StartCheckout;

package/dist/actions/start-checkout/action.js

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

package/dist/actions/start-checkout/mock.d.ts

@@ -0,0 +1,16 @@
+import { StartCheckout } from './types';
+/**
+ * Standalone mock of the storefront checkout.
+ *
+ * It mirrors the REFUSALS of the real command (empty cart, missing email,
+ * container not on the page) in the same order, because those are what a
+ * builder actually hits first — a mock that accepted anything would let a
+ * checkout screen look finished and fail on the published site.
+ *
+ * The mounted box is deliberately labelled as a mock. The real command mounts
+ * the provider's hosted card fields (iframes owned by the payment provider);
+ * nothing here takes a card number, and the placeholder must never look like
+ * it does. Its button publishes `payment-completed` so a flow's subscriber —
+ * the only way the outcome ever arrives — can be exercised in preview.
+ */
+export declare const mockStartCheckout: StartCheckout;

package/dist/actions/start-checkout/mock.js

@@ -0,0 +1,80 @@
+import { MOCK_CART, MOCK_COMPANY, mockPublishEvent } from '../../demo/database';
+/**
+ * Standalone mock of the storefront checkout.
+ *
+ * It mirrors the REFUSALS of the real command (empty cart, missing email,
+ * container not on the page) in the same order, because those are what a
+ * builder actually hits first — a mock that accepted anything would let a
+ * checkout screen look finished and fail on the published site.
+ *
+ * The mounted box is deliberately labelled as a mock. The real command mounts
+ * the provider's hosted card fields (iframes owned by the payment provider);
+ * nothing here takes a card number, and the placeholder must never look like
+ * it does. Its button publishes `payment-completed` so a flow's subscriber —
+ * the only way the outcome ever arrives — can be exercised in preview.
+ */
+export const mockStartCheckout = async (params) => {
+    console.log('[Mock] startCheckout called', params);
+    if (!params)
+        throw new Error('Params required');
+    if (!params.contact?.email || !params.contact.email.trim()) {
+        throw new Error('startCheckout: contact.email is required — it is where the receipt goes');
+    }
+    if (!params.container || typeof params.container !== 'string') {
+        throw new Error('startCheckout: container must be a CSS selector string (e.g. "#card-fields") — a DOM element cannot cross the command boundary');
+    }
+    const lineCount = (MOCK_CART.products?.length ?? 0) + (MOCK_CART.customSales?.length ?? 0);
+    if (!lineCount) {
+        throw new Error('startCheckout: cannot check out an empty cart');
+    }
+    // Resolved BEFORE the order is "created", exactly as the real command does:
+    // finding out the selector is wrong after an order exists would leave an
+    // unpaid order behind for a typo that cost nothing to catch first.
+    const container = typeof document === 'undefined' ? null : document.querySelector(params.container);
+    if (!container) {
+        throw new Error(`startCheckout: checkout container "${params.container}" was not found on the page`);
+    }
+    const serverTotal = Math.round(MOCK_CART.amountToBeCharged || MOCK_CART.total);
+    const currency = MOCK_COMPANY.settings?.currency ?? 'USD';
+    const suffix = String(Date.now()).slice(-6);
+    const order = {
+        orderId: `mock-order-${suffix}`,
+        receiptId: `ON-001-${suffix}`,
+        serverTotal,
+        currency,
+        paymentStatus: 'ready',
+        orderPassword: `mock-pw-${suffix}`,
+    };
+    mockPublishEvent('checkout', 'checkout-started', { ...order });
+    container.replaceChildren();
+    const box = document.createElement('div');
+    box.setAttribute('data-mock-checkout', 'true');
+    box.style.cssText =
+        'border:1px dashed #9aa;border-radius:8px;padding:16px;font:14px system-ui,sans-serif;text-align:center;color:#334';
+    const label = document.createElement('div');
+    label.textContent = 'Mock payment fields — the published site shows the real hosted card fields here.';
+    label.style.cssText = 'margin-bottom:12px;opacity:.75';
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.textContent = `Simulate paying ${(serverTotal / 100).toFixed(2)} ${currency}`;
+    button.style.cssText =
+        'padding:10px 16px;border:0;border-radius:6px;background:#111;color:#fff;font-size:14px;cursor:pointer';
+    button.addEventListener('click', () => {
+        button.disabled = true;
+        // `Authorised` is what the real provider reports for a successful card
+        // entry. It is NOT settlement — see the checkout topic docs.
+        mockPublishEvent('checkout', 'payment-completed', {
+            orderId: order.orderId,
+            receiptId: order.receiptId,
+            resultCode: 'Authorised',
+        });
+    });
+    box.appendChild(label);
+    box.appendChild(button);
+    container.appendChild(box);
+    return {
+        success: true,
+        timestamp: new Date().toISOString(),
+        order,
+    };
+};

package/dist/actions/start-checkout/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Guest contact for the order. There is no shopper account, so this is the only
+ * way to reach them — `email` is where the receipt goes and is required.
+ */
+export interface StartCheckoutContact {
+    email: string;
+    name?: string;
+    phone?: string;
+}
+export interface StartCheckoutParams {
+    contact: StartCheckoutContact;
+    /**
+     * CSS SELECTOR for the element the payment fields mount into, e.g.
+     * `'#card-fields'`. The element must already be in the DOM when this is
+     * called.
+     *
+     * A SELECTOR, NOT AN ELEMENT — and this is not a style preference. Command
+     * params cross a `postMessage` boundary, which serializes them with the
+     * structured clone algorithm; a DOM node is not cloneable, so passing
+     * `ref.current` throws `DataCloneError: HTMLDivElement object could not be
+     * cloned` before the command is ever sent. The string is resolved on the
+     * runtime's side against the same document the page rendered.
+     */
+    container: string;
+    /**
+     * Where the provider returns the shopper after a redirect payment method
+     * (bank apps, wallets). Defaults to the current URL.
+     *
+     * Must be HTTPS and on the SAME ORIGIN the storefront token was minted for;
+     * the server rejects anything else, since this URL is handed to a payment
+     * provider and an open redirect on a checkout is a phishing primitive.
+     */
+    returnUrl?: string;
+    /**
+     * Overrides the cart-derived idempotency key. Leave unset: the default is
+     * derived from the cart, which is what makes a shopper's double-tap on "Pay"
+     * return the SAME order instead of creating a second, abandoned one.
+     */
+    idempotencyKey?: string;
+    /** Defaults to the outlet the storefront booted against. */
+    outletId?: string;
+    /** Forwarded verbatim to the provider's Drop-in (`showPayButton`, `locale`, field styling, …). */
+    dropinConfiguration?: Record<string, unknown>;
+}
+/**
+ * The created order. Deliberately says nothing about money having moved — see
+ * `paymentStatus` and the `checkout` topic.
+ */
+export interface StartCheckoutOrder {
+    orderId: string;
+    receiptId: string;
+    /** The SERVER-computed total in integer minor units — the only total that matters. */
+    serverTotal: number;
+    currency: string;
+    /**
+     * `ready` — the payment fields are mounted and the shopper can pay.
+     * `unavailable` — THE ORDER EXISTS but no payment could be started, so the
+     * shopper has NOT been charged. Never report this as a failed order.
+     */
+    paymentStatus: 'ready' | 'unavailable';
+    /**
+     * One-time password for reading this order back, returned only on the first
+     * create. It is the ONLY route to this order's status — the guest token
+     * grants order creation and deliberately not order reads — so a caller that
+     * drops it cannot check whether the payment settled.
+     */
+    orderPassword?: string;
+}
+export interface StartCheckoutResponse {
+    success: boolean;
+    timestamp: string;
+    order: StartCheckoutOrder;
+}
+/**
+ * Creates the server-priced order and mounts the provider's hosted card fields.
+ *
+ * RESOLVES WHEN THE SHOPPER *CAN* PAY, NOT WHEN THEY HAVE. The shopper has not
+ * typed a card yet when this returns. The outcome arrives on the `checkout`
+ * topic instead.
+ */
+export type StartCheckout = (params: StartCheckoutParams) => Promise<StartCheckoutResponse>;

package/dist/actions/start-checkout/types.js

@@ -0,0 +1,10 @@
+// Start Checkout Types
+//
+// The ONLINE counterpart of the POS tenders: a shopper on a published website
+// pays for the current cart with their own card. Mirrors kaching's storefront
+// `startCheckout` input and result. All money is integer MINOR currency units.
+//
+// This command is served ONLY by the storefront runtime (a published website).
+// On a register it does not exist, exactly as the till tenders (`cashPayment`,
+// `terminalPayment`, `tapToPayPayment`, `chargeMoto`) do not exist online.
+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, CFBooking, CFBookingAvailability, CFBookingResource } from '../CommonTypes';
+import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout } from '../CommonTypes';
 export * from './mocks';
 /** Replace mock catalog / context data in place (same array references mock handlers use). */
 export interface MockDatabaseConfig {
@@ -59,7 +59,6 @@ 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[];
@@ -88,9 +87,3 @@ 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[];
-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,7 +4,6 @@
  */
 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';
@@ -650,14 +649,6 @@ 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,
@@ -673,7 +664,6 @@ 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];
@@ -924,86 +914,3 @@ 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;
-export const MOCK_BOOKING_RESOURCES = [
-    { id: 'res_marco', name: 'Marco', kind: BookingResourceKind.STAFF },
-    { id: 'res_jessica', name: 'Jessica', kind: BookingResourceKind.STAFF },
-];
-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_marco', at(0, 10), ReservationStatus.CONFIRMED, 'Alex Green'),
-    booking('bk_2', 'res_jessica', at(0, 11, 30), ReservationStatus.CONFIRMED, 'Dana White'),
-    booking('bk_3', 'res_marco', 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 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;
-            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 {
-        productId,
-        bookingRulesId: MOCK_BOOKING_RULES_ID,
-        bookingType: BookingType.APPOINTMENT,
-        ratePeriod: BookingRatePeriod.SLOT,
-        slots,
-    };
-};

package/dist/index.d.ts

@@ -2,13 +2,6 @@ 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;
@@ -50,6 +43,7 @@ export declare const command: {
     readonly integrationPayment: import(".").IntegrationPayment;
     readonly createPaymentLink: import(".").CreatePaymentLink;
     readonly chargeMoto: import(".").ChargeMoto;
+    readonly startCheckout: import(".").StartCheckout;
     readonly addCustomerNote: import(".").AddCustomerNote;
     readonly removeCustomerNote: import(".").RemoveCustomerNote;
     readonly removeCustomerFromCart: import(".").RemoveCustomerFromCart;
@@ -126,13 +120,6 @@ 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';
@@ -192,6 +179,7 @@ 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 { 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';
@@ -248,6 +236,7 @@ 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';
@@ -259,7 +248,6 @@ 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';
@@ -270,11 +258,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';

package/dist/index.js

@@ -1,13 +1,6 @@
 // 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';
@@ -50,6 +43,7 @@ import { redeemPayment } from './actions/redeem-payment/action';
 import { integrationPayment } from './actions/integration-payment/action';
 import { createPaymentLink } from './actions/create-payment-link/action';
 import { chargeMoto } from './actions/charge-moto/action';
+import { startCheckout } from './actions/start-checkout/action';
 // Customer Actions
 import { addCustomerNote } from './actions/add-customer-note/action';
 import { removeCustomerNote } from './actions/remove-customer-note/action';
@@ -144,13 +138,6 @@ export const command = {
     exampleFunction,
     generateAPIKey,
     getProducts,
-    getBookingResources,
-    getBookingAvailability,
-    getBookings,
-    holdBooking,
-    addBookingToCart,
-    removeBookingFromCart,
-    cancelBooking,
     addCustomSale,
     editCustomSale,
     addNonRevenueItem,
@@ -194,6 +181,7 @@ export const command = {
     integrationPayment,
     createPaymentLink,
     chargeMoto,
+    startCheckout,
     // Customer Actions
     addCustomerNote,
     removeCustomerNote,
@@ -304,6 +292,7 @@ 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';
@@ -315,7 +304,6 @@ 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

@@ -31,6 +31,7 @@ import { mockCashPayment } from '../../actions/cash-payment/mock';
 import { mockGetCashRoundingAmount } from '../../actions/get-cash-rounding-amount/mock';
 import { mockCreatePaymentLink } from '../../actions/create-payment-link/mock';
 import { mockChargeMoto } from '../../actions/charge-moto/mock';
+import { mockStartCheckout } from '../../actions/start-checkout/mock';
 import { mockGetTimeClockStatus } from '../../actions/get-time-clock-status/mock';
 import { mockClearCart } from '../../actions/clear-cart/mock';
 import { mockDeleteParkedOrder } from '../../actions/delete-parked-order/mock';
@@ -42,13 +43,6 @@ 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';
@@ -135,6 +129,7 @@ export const RENDER_MOCKS = {
     getCashRoundingAmount: mockGetCashRoundingAmount,
     createPaymentLink: mockCreatePaymentLink,
     chargeMoto: mockChargeMoto,
+    startCheckout: mockStartCheckout,
     clearCart: mockClearCart,
     deleteParkedOrder: mockDeleteParkedOrder,
     voidOrder: mockVoidOrder,
@@ -145,13 +140,6 @@ 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,14 +1,7 @@
-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';
+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, CreatePaymentLink, ChargeMoto, StartCheckout, 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;
@@ -50,6 +43,12 @@ export interface RenderProviderActions {
     integrationPayment: IntegrationPayment;
     createPaymentLink: CreatePaymentLink;
     chargeMoto: ChargeMoto;
+    /**
+     * ONLINE checkout — served only by the storefront runtime (a published
+     * website). The till tenders above are refused there, and this is refused on
+     * a register, because the two declare different things to the card networks.
+     */
+    startCheckout: StartCheckout;
     addNonRevenueItem: AddNonRevenueItem;
     addCustomerNote: AddCustomerNote;
     removeCustomerNote: RemoveCustomerNote;

package/dist/pubsub/topics/checkout/checkout-started/types.d.ts

@@ -0,0 +1,26 @@
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for checkout-started event
+ *
+ * The order EXISTS and is unpaid. `serverTotal` is the server's own price for
+ * the cart, in integer minor units — the browser never sends a price, so this
+ * is the first and only authoritative total.
+ */
+export interface CheckoutStartedPayload {
+    orderId: string;
+    receiptId: string;
+    serverTotal: number;
+    currency: string;
+    /**
+     * `ready` — the payment fields are mounted and the shopper can pay.
+     * `unavailable` — the order exists but no payment could be started, so the
+     * shopper has NOT been charged.
+     */
+    paymentStatus: "ready" | "unavailable";
+    /** One-time password for reading this order back. Returned only on the first create. */
+    orderPassword?: string;
+}
+/**
+ * Typed event for checkout-started
+ */
+export type CheckoutStartedEvent = TopicEvent<CheckoutStartedPayload>;

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

@@ -0,0 +1,7 @@
+/**
+ * Checkout Topic Definition
+ * Defines the checkout topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const checkoutTopic: TopicDefinition;
+export * from "./types";