@final-commerce/command-frame 0.11.1-online.1 → 0.12.0-staging.1

package/dist/actions/set-order-status/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Set order status action
- * Calls the setOrderStatus action on the parent window
- */
-import type { SetOrderStatus } from './types';
-export declare const setOrderStatus: SetOrderStatus;

package/dist/actions/set-order-status/action.js

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

package/dist/actions/set-order-status/mock.d.ts

@@ -1,3 +0,0 @@
-import type { SetOrderStatus } from './types';
-/** Best-effort mock: no state-machine guards beyond the status's payment requirement. */
-export declare const mockSetOrderStatus: SetOrderStatus;

package/dist/actions/set-order-status/mock.js

@@ -1,44 +0,0 @@
-import { MOCK_ORDERS, MOCK_ORDER_STATUSES, MOCK_PARKED_ORDERS, mockPublishEvent } from '../../demo/database';
-/** Best-effort mock: no state-machine guards beyond the status's payment requirement. */
-export const mockSetOrderStatus = async (params) => {
-    console.log('[Mock] setOrderStatus called', params);
-    if (!params?.orderId) {
-        throw new Error('setOrderStatus: the demo has no live-cart order — pass an orderId');
-    }
-    const order = [...MOCK_ORDERS, ...MOCK_PARKED_ORDERS].find((o) => o._id === params.orderId);
-    if (!order) {
-        throw new Error(`Order with ID ${params.orderId} not found`);
-    }
-    const from = { payment: order.paymentState ?? 'unpaid', fulfillment: order.fulfillmentState ?? 'draft' };
-    const requested = params.key !== undefined ? params.key : params.statusId;
-    if (requested === undefined) {
-        throw new Error('setOrderStatus: pass a status key, or null to clear the status');
-    }
-    if (requested === null) {
-        order.customStatus = null;
-    }
-    else {
-        const def = MOCK_ORDER_STATUSES.find((s) => s.key === requested) ??
-            (params.key === undefined ? MOCK_ORDER_STATUSES.find((s) => s.id === requested) : undefined);
-        if (!def) {
-            throw new Error(`setOrderStatus: unknown status "${requested}"`);
-        }
-        if (def.requiresPaymentState && !def.requiresPaymentState.includes(from.payment)) {
-            throw new Error(`setOrderStatus: "${def.label}" requires payment state ${def.requiresPaymentState.join(' or ')} (order is ${from.payment})`);
-        }
-        if (def.fulfillmentState)
-            order.fulfillmentState = def.fulfillmentState;
-        order.customStatus = { id: def.id, key: def.key, label: def.label, setAt: new Date().toISOString(), setBy: null };
-    }
-    mockPublishEvent('orders', 'order-updated', { order });
-    const to = { payment: order.paymentState ?? 'unpaid', fulfillment: order.fulfillmentState ?? 'draft' };
-    return {
-        success: true,
-        orderId: order._id,
-        customStatus: order.customStatus ?? null,
-        from,
-        to,
-        order,
-        timestamp: new Date().toISOString(),
-    };
-};

package/dist/actions/set-order-status/types.d.ts

@@ -1,25 +0,0 @@
-import type { CFOrder, CFOrderCustomStatus } from '../../CommonTypes';
-import type { CFStatePair } from '../../common-types/order-state';
-export interface SetOrderStatusParams {
-    /** Order to set the status on. Omit for the live cart's order. */
-    orderId?: string;
-    /** Key of one of the flow's statuses (see getOrderStatuses), or null to clear the status. */
-    key?: string | null;
-    /**
-     * @deprecated Use `key`. Kept for flows written before keys: matched against a status's
-     * key, then its id. Ignored when `key` is given.
-     */
-    statusId?: string | null;
-}
-export interface SetOrderStatusResponse {
-    success: boolean;
-    orderId: string;
-    /** The order's status after the call; null when cleared. */
-    customStatus: CFOrderCustomStatus | null;
-    /** State before and after — they differ only when the status is bound to a fulfillment state the order wasn't in. */
-    from: CFStatePair | null;
-    to: CFStatePair | null;
-    order: CFOrder;
-    timestamp: string;
-}
-export type SetOrderStatus = (params: SetOrderStatusParams) => Promise<SetOrderStatusResponse>;

package/dist/actions/set-order-status/types.js

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

package/dist/actions/set-order-type/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Set order type action
- * Calls the setOrderType action on the parent window
- */
-import type { SetOrderType } from './types';
-export declare const setOrderType: SetOrderType;

package/dist/actions/set-order-type/action.js

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

package/dist/actions/set-order-type/mock.d.ts

@@ -1,3 +0,0 @@
-import type { SetOrderType } from './types';
-export declare const normalizeOrderType: (value: unknown) => string | null;
-export declare const mockSetOrderType: SetOrderType;

package/dist/actions/set-order-type/mock.js

@@ -1,27 +0,0 @@
-import { MOCK_ORDERS, MOCK_PARKED_ORDERS, mockPublishEvent } from '../../demo/database';
-/** Type for the demo's live cart, which has no order until it is paid or parked. */
-let mockCartOrderType = null;
-export const normalizeOrderType = (value) => {
-    if (value === null)
-        return null;
-    if (typeof value !== 'string' || !value.trim()) {
-        throw new Error('setOrderType: orderType must be a non-empty string or null');
-    }
-    return value.trim();
-};
-export const mockSetOrderType = async (params) => {
-    console.log('[Mock] setOrderType called', params);
-    const orderType = normalizeOrderType(params?.orderType);
-    const timestamp = new Date().toISOString();
-    if (!params.orderId) {
-        mockCartOrderType = orderType;
-        return { success: true, orderId: null, orderType: mockCartOrderType, timestamp };
-    }
-    const order = [...MOCK_ORDERS, ...MOCK_PARKED_ORDERS].find((o) => o._id === params.orderId);
-    if (!order) {
-        throw new Error(`Order with ID ${params.orderId} not found`);
-    }
-    order.orderType = orderType;
-    mockPublishEvent('orders', 'order-updated', { order });
-    return { success: true, orderId: order._id, orderType, timestamp };
-};

package/dist/actions/set-order-type/types.d.ts

@@ -1,17 +0,0 @@
-export interface SetOrderTypeParams {
-    /**
-     * Order to label. Omit to target the live cart — including a cart that isn't an
-     * order yet; the type is carried onto the order when it's created.
-     */
-    orderId?: string;
-    /** Any non-empty label (e.g. 'takeout', 'pickup', 'delivery'), or null to clear it. */
-    orderType: string | null;
-}
-export interface SetOrderTypeResponse {
-    success: boolean;
-    /** The order that was updated, or null when the live cart has no order yet. */
-    orderId: string | null;
-    orderType: string | null;
-    timestamp: string;
-}
-export type SetOrderType = (params: SetOrderTypeParams) => Promise<SetOrderTypeResponse>;

package/dist/actions/set-order-type/types.js

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

package/dist/actions/set-outlet/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Set Outlet action
- * Calls the setOutlet action on the parent window
- */
-import type { SetOutlet } from './types';
-export declare const setOutlet: SetOutlet;

package/dist/actions/set-outlet/action.js

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

package/dist/actions/set-outlet/mock.d.ts

@@ -1,13 +0,0 @@
-import type { SetOutlet } from './types';
-/**
- * Standalone mock of switching location.
- *
- * It mirrors the two REFUSALS the real command makes — a missing id, and an
- * outlet that cannot take a payment — because those are the mistakes a builder
- * actually hits. A mock that accepted anything would let a location picker look
- * finished and then strand a shopper at a dead payment step on the real site.
- *
- * The unconnected id comes from the `getOutlets` mock rather than being repeated
- * here, so the two cannot drift into telling different stories.
- */
-export declare const mockSetOutlet: SetOutlet;

package/dist/actions/set-outlet/mock.js

@@ -1,24 +0,0 @@
-import { MOCK_UNCONNECTED_OUTLET_ID } from '../get-outlets/mock';
-/**
- * Standalone mock of switching location.
- *
- * It mirrors the two REFUSALS the real command makes — a missing id, and an
- * outlet that cannot take a payment — because those are the mistakes a builder
- * actually hits. A mock that accepted anything would let a location picker look
- * finished and then strand a shopper at a dead payment step on the real site.
- *
- * The unconnected id comes from the `getOutlets` mock rather than being repeated
- * here, so the two cannot drift into telling different stories.
- */
-export const mockSetOutlet = async (params) => {
-    console.log('[Mock] setOutlet called', params);
-    if (!params)
-        throw new Error('Params required');
-    if (!params.outletId || !params.outletId.trim()) {
-        throw new Error('setOutlet: outletId is required');
-    }
-    if (params.outletId === MOCK_UNCONNECTED_OUTLET_ID) {
-        throw new Error(`setOutlet: outlet ${params.outletId} cannot take an online payment — offer only outlets with connected: true`);
-    }
-    return { outletId: params.outletId, rehydrated: true, timestamp: new Date().toISOString() };
-};

package/dist/actions/set-outlet/types.d.ts

@@ -1,31 +0,0 @@
-export interface SetOutletParams {
-    /** An `id` from `getOutlets`. */
-    outletId: string;
-}
-export interface SetOutletResponse {
-    /** The location now in effect. */
-    outletId: string;
-    /**
-     * `true` when the catalog and tax tables were re-pulled for this location.
-     *
-     * `false` means the switch took effect but the refresh could not reach the
-     * server — the shop is running on what it already had cached. Totals may be
-     * the previous location's until the next refresh pass lands, so a flow can
-     * tell the shopper to try again rather than quietly showing stale tax.
-     */
-    rehydrated: boolean;
-    timestamp: string;
-}
-/**
- * Switch the shop to another of the company's locations.
- *
- * REFUSES AN OUTLET THAT CANNOT TAKE A PAYMENT, and one that does not belong to
- * this company, rather than letting either fail later at the payment step. Check
- * `connected` from `getOutlets` and do not offer those, so this refusal is a
- * backstop rather than something a shopper ever sees.
- *
- * The cart survives the switch. Its lines are kept and re-priced; a line that is
- * not purchasable at the new location is not silently dropped here, it is
- * reported when the checkout is next priced.
- */
-export type SetOutlet = (params: SetOutletParams) => Promise<SetOutletResponse>;

package/dist/actions/set-outlet/types.js

@@ -1,21 +0,0 @@
-// Set Outlet Types
-//
-// Choose which of the company's locations this shop is ordering from.
-//
-// WHAT IT ACTUALLY CHANGES. An outlet decides three things, and a shop that lets
-// a shopper pick one has to move all three together:
-//
-//   tax           rates follow the outlet's own address, so the total moves
-//   availability  stock is counted per location, and a product can be hidden at one
-//   fulfilment    the order records where the goods come from, so the right
-//                 location's stock is the one that is drawn down
-//
-// So this is not a display preference. It re-pulls the catalog for the new
-// location, re-hydrates the tax tables, and re-prices the cart. The totals a
-// flow reads afterwards are the new location's.
-//
-// SAFE MID-CHECKOUT. Checkout starts when a shopper ARRIVES, so by the time
-// anyone changes their mind an order usually already exists. That order is
-// re-priced and moved to the new outlet in place, keeping its id and its receipt
-// id, rather than being abandoned and replaced.
-export {};

package/dist/actions/set-scheduled-for/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Set scheduled-for action
- * Calls the setScheduledFor action on the parent window
- */
-import type { SetScheduledFor } from './types';
-export declare const setScheduledFor: SetScheduledFor;

package/dist/actions/set-scheduled-for/action.js

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

package/dist/actions/set-scheduled-for/mock.d.ts

@@ -1,4 +0,0 @@
-import type { SetScheduledFor } from './types';
-/** ISO 8601 in, UTC ISO 8601 out; null stays null (as soon as possible). */
-export declare const normalizeScheduledFor: (value: unknown) => string | null;
-export declare const mockSetScheduledFor: SetScheduledFor;

package/dist/actions/set-scheduled-for/mock.js

@@ -1,45 +0,0 @@
-import { MOCK_ORDERS, MOCK_PARKED_ORDERS, mockPublishEvent } from '../../demo/database';
-/** Time for the demo's live cart, which has no order until it is paid or parked. */
-let mockCartScheduledFor = null;
-/**
- * An ISO 8601 date-time WITH a zone — 'Z' or an offset. A zoneless time ('2026-10-13T19:00') is
- * refused: it would mean a different moment on every device. Date.parse alone is too lenient
- * (it accepts strings like "tomorrow at 7"), so the shape is checked first.
- */
-const ISO_DATE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:?\d{2})$/;
-/** The YYYY-MM-DD part is a real day — Date.parse quietly rolls "Feb 30" over to March 2. */
-const isCalendarDate = (text) => {
-    const [y, m, d] = text.slice(0, 10).split('-').map(Number);
-    const day = new Date(Date.UTC(y, m - 1, d));
-    return day.getUTCFullYear() === y && day.getUTCMonth() === m - 1 && day.getUTCDate() === d;
-};
-/** ISO 8601 in, UTC ISO 8601 out; null stays null (as soon as possible). */
-export const normalizeScheduledFor = (value) => {
-    if (value === null)
-        return null;
-    if (typeof value !== 'string' || !value.trim()) {
-        throw new Error('setScheduledFor: scheduledFor must be an ISO 8601 date-time or null');
-    }
-    const text = value.trim();
-    const ms = ISO_DATE_TIME.test(text) && isCalendarDate(text) ? Date.parse(text) : NaN;
-    if (Number.isNaN(ms)) {
-        throw new Error(`setScheduledFor: "${value}" is not an ISO 8601 date-time with Z or an offset`);
-    }
-    return new Date(ms).toISOString();
-};
-export const mockSetScheduledFor = async (params) => {
-    console.log('[Mock] setScheduledFor called', params);
-    const scheduledFor = normalizeScheduledFor(params?.scheduledFor);
-    const timestamp = new Date().toISOString();
-    if (!params.orderId) {
-        mockCartScheduledFor = scheduledFor;
-        return { success: true, orderId: null, scheduledFor: mockCartScheduledFor, timestamp };
-    }
-    const order = [...MOCK_ORDERS, ...MOCK_PARKED_ORDERS].find((o) => o._id === params.orderId);
-    if (!order) {
-        throw new Error(`Order with ID ${params.orderId} not found`);
-    }
-    order.scheduledFor = scheduledFor;
-    mockPublishEvent('orders', 'order-updated', { order });
-    return { success: true, orderId: order._id, scheduledFor, timestamp };
-};

package/dist/actions/set-scheduled-for/types.d.ts

@@ -1,22 +0,0 @@
-export interface SetScheduledForParams {
-    /**
-     * Order to schedule. Omit to target the live cart — including a cart that isn't an
-     * order yet; the time is carried onto the order when it's created.
-     */
-    orderId?: string;
-    /**
-     * When the customer wants the order, as an ISO 8601 date-time with Z or an offset (e.g.
-     * '2026-10-13T23:00:00.000Z' or '2026-10-13T19:00:00-04:00'), or null for as soon as possible.
-     * Stored in UTC.
-     */
-    scheduledFor: string | null;
-}
-export interface SetScheduledForResponse {
-    success: boolean;
-    /** The order that was updated, or null when the live cart has no order yet. */
-    orderId: string | null;
-    /** The time after the call, normalised to UTC ISO 8601 — or null (as soon as possible). */
-    scheduledFor: string | null;
-    timestamp: string;
-}
-export type SetScheduledFor = (params: SetScheduledForParams) => Promise<SetScheduledForResponse>;

package/dist/actions/set-scheduled-for/types.js

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

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

@@ -1,6 +0,0 @@
-/**
- * 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

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1,16 +0,0 @@
-import { StartCheckout } from './types';
-/**
- * Standalone mock of the storefront checkout.
- *
- * It mirrors the REFUSALS of the real command (empty cart,
- * 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

@@ -1,80 +0,0 @@
-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,
- * 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');
-    // No email check: contact is optional now, because checkout starts on arrival.
-    // Refusing here would make "start on arrival" fail in PREVIEW while working on
-    // the published site, which is the worst way for this to be wrong.
-    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

@@ -1,90 +0,0 @@
-/**
- * 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 {
-    /**
-     * OPTIONAL, because checkout starts when the shopper ARRIVES rather than when
-     * they submit a form. The card fields cannot render without a payment session,
-     * a session needs a server-priced amount, and an amount needs an order — so the
-     * order has to exist before they have typed anything.
-     *
-     * Supply it afterwards with `attachCheckoutContact`, which re-sends the same
-     * idempotency key and so reaches the SAME order.
-     */
-    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

@@ -1,10 +0,0 @@
-// 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/shipping.d.ts

@@ -1,8 +0,0 @@
-import { type ShippingZoneRule } from '@final-commerce/common';
-import type { ShippingOptionView } from '../actions/get-shipping-options/types';
-export declare const MOCK_SHIPPING_ZONES: ShippingZoneRule[];
-/** The demo cart's options, shaped like the runtime's answer. The mock runs as the website. */
-export declare function mockShippingOptions(): {
-    resolution: import("@final-commerce/common").ShippingResolution;
-    options: ShippingOptionView[];
-};