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

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

@@ -1,20 +0,0 @@
-import type { CFMetadataItem } from '../../CommonTypes';
-export interface SetOrderMetadataParams {
-    /**
-     * Order to update. Omit to target the live cart's order — including a cart
-     * that hasn't become an order yet (the metadata is carried onto the order
-     * when it is created).
-     */
-    orderId?: string;
-    /** Keys to set (string) or remove (null). Keys not listed are left as they are. */
-    metadata: Record<string, string | null>;
-}
-export interface SetOrderMetadataResponse {
-    success: boolean;
-    /** The order that was updated, or null when the live cart has no order yet. */
-    orderId: string | null;
-    /** The full metadata after the update. */
-    metadata: CFMetadataItem[];
-    timestamp: string;
-}
-export type SetOrderMetadata = (params: SetOrderMetadataParams) => Promise<SetOrderMetadataResponse>;

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

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

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-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 {};