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

package/dist/actions/record-external-payment/mock.js

@@ -1,36 +0,0 @@
-import { isFulfillmentState } from '@final-commerce/common';
-import { applyMockPayment, MOCK_CART } from '../../demo/database';
-export const mockRecordExternalPayment = async (params) => {
-    console.log('[Mock] recordExternalPayment called', params);
-    const label = typeof params?.label === 'string' ? params.label.trim() : '';
-    if (!label) {
-        throw new Error('recordExternalPayment: label is required');
-    }
-    const balanceDue = MOCK_CART.amountToBeCharged ?? MOCK_CART.total;
-    const amount = params.amount ?? balanceDue;
-    // Same rule as the host: positive, except on a zero-balance checkout.
-    if (!Number.isFinite(amount) || amount < 0 || (amount === 0 && balanceDue > 0)) {
-        throw new Error('recordExternalPayment: amount must be a positive integer (minor units)');
-    }
-    const target = params.checkoutFulfillmentTarget;
-    if (target !== undefined && !isFulfillmentState(target)) {
-        throw new Error(`recordExternalPayment: invalid checkoutFulfillmentTarget "${String(target)}"`);
-    }
-    if (amount > balanceDue) {
-        throw new Error(`recordExternalPayment: amount ${amount} exceeds the balance due ${balanceDue}`);
-    }
-    const order = applyMockPayment(amount, 'external', label);
-    const remainingBalance = MOCK_CART.remainingBalance ?? 0;
-    return {
-        success: true,
-        amount,
-        label,
-        paymentType: 'external',
-        change: 0,
-        cashRounding: 0,
-        order,
-        saleFinalized: !!order,
-        remainingBalance: order ? 0 : remainingBalance,
-        timestamp: new Date().toISOString(),
-    };
-};

package/dist/actions/record-external-payment/types.d.ts

@@ -1,37 +0,0 @@
-import { CFOrder } from '../../CommonTypes';
-export interface RecordExternalPaymentParams {
-    /**
-     * What the payment was — shown on the order and in reports, e.g. 'Paid online',
-     * 'Uber Eats', 'Voucher'. Required; trimmed. Not checked against a list, so keep
-     * labels consistent across flows.
-     */
-    label: string;
-    /**
-     * Amount to record, in integer MINOR currency units. Omit to record the full balance
-     * due (completing the order). Below the balance due it records a partial payment —
-     * the rest can be taken with any other tender. Above the balance due is an error.
-     */
-    amount?: number;
-    /** Fulfillment state to land on after full payment, e.g. 'pending' to keep the order going to the kitchen. */
-    checkoutFulfillmentTarget?: string;
-}
-export interface RecordExternalPaymentResponse {
-    success: boolean;
-    /** The amount recorded, in integer MINOR currency units. */
-    amount: number;
-    /** The label, as recorded. */
-    label: string;
-    paymentType: 'external';
-    /** Always 0 — no money changes hands at the terminal. */
-    change: number;
-    /** Always 0 — cash rounding applies to cash only. */
-    cashRounding: number;
-    /** The order once the sale completes; null for a partial (split) leg. */
-    order: CFOrder | null;
-    /** True when this payment settled the remaining balance. */
-    saleFinalized: boolean;
-    /** Balance still due after this payment, in integer MINOR currency units. */
-    remainingBalance: number;
-    timestamp: string;
-}
-export type RecordExternalPayment = (params: RecordExternalPaymentParams) => Promise<RecordExternalPaymentResponse>;

package/dist/actions/record-external-payment/types.js

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

package/dist/actions/release-from-cart/action.d.ts

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

package/dist/actions/release-from-cart/action.js

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

package/dist/actions/release-from-cart/mock.d.ts

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

package/dist/actions/release-from-cart/mock.js

@@ -1,26 +0,0 @@
-import { MOCK_CART, MOCK_ORDERS, resetMockCart, mockPublishEvent } from '../../demo/database';
-export const mockReleaseFromCart = async () => {
-    console.log('[Mock] releaseFromCart called');
-    if (!MOCK_CART.products.length) {
-        throw new Error('releaseFromCart: the cart is empty');
-    }
-    const now = new Date().toISOString();
-    // Best-effort: the demo has no live-cart order, so the cart becomes a new unpaid draft.
-    const order = {
-        _id: `order_released_${Date.now()}`,
-        receiptId: `REL-${MOCK_ORDERS.length + 1}`,
-        status: 'in-cart',
-        paymentState: 'unpaid',
-        fulfillmentState: 'draft',
-        inCart: { active: false, stationId: null, since: now },
-        lineItems: [],
-        customSales: [],
-        paymentMethods: [],
-        summary: { total: MOCK_CART.total },
-        createdAt: now,
-    };
-    MOCK_ORDERS.push(order);
-    resetMockCart();
-    mockPublishEvent('orders', 'order-updated', { order });
-    return { success: true, order, timestamp: now };
-};

package/dist/actions/release-from-cart/types.d.ts

@@ -1,8 +0,0 @@
-import type { CFOrder } from '../../CommonTypes';
-export interface ReleaseFromCartResponse {
-    success: boolean;
-    /** The order that left the cart, as saved — its state is unchanged and `inCart.active` is false. */
-    order: CFOrder;
-    timestamp: string;
-}
-export type ReleaseFromCart = () => Promise<ReleaseFromCartResponse>;

package/dist/actions/release-from-cart/types.js

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

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

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

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

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

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

@@ -1,16 +0,0 @@
-import { ResumeCheckout } from './types';
-/**
- * Standalone mock of the checkout return leg.
- *
- * It reads the SAME query parameters the real provider sends a shopper back
- * with, so a builder can exercise the redirect path in preview by appending
- * them by hand:
- *
- *   ?sessionId=CS_MOCK&redirectResult=MOCK
- *
- * Without them it answers `{ resumed: false }` and does nothing, which is what
- * the real command does on an ordinary page load. That is the branch a
- * checkout screen hits on every normal visit, so it is the one worth getting
- * right in a mock.
- */
-export declare const mockResumeCheckout: ResumeCheckout;

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

@@ -1,51 +0,0 @@
-import { mockPublishEvent } from '../../demo/database';
-/**
- * Standalone mock of the checkout return leg.
- *
- * It reads the SAME query parameters the real provider sends a shopper back
- * with, so a builder can exercise the redirect path in preview by appending
- * them by hand:
- *
- *   ?sessionId=CS_MOCK&redirectResult=MOCK
- *
- * Without them it answers `{ resumed: false }` and does nothing, which is what
- * the real command does on an ordinary page load. That is the branch a
- * checkout screen hits on every normal visit, so it is the one worth getting
- * right in a mock.
- */
-export const mockResumeCheckout = async (params) => {
-    console.log('[Mock] resumeCheckout called', params);
-    const href = params?.url ?? (typeof window === 'undefined' ? '' : window.location.href);
-    let redirectResult = null;
-    try {
-        redirectResult = new URL(href).searchParams.get('redirectResult');
-    }
-    catch {
-        redirectResult = null;
-    }
-    if (!redirectResult) {
-        return {
-            success: true,
-            timestamp: new Date().toISOString(),
-            checkout: { resumed: false },
-        };
-    }
-    const suffix = String(Date.now()).slice(-6);
-    const checkout = {
-        resumed: true,
-        orderId: `mock-order-${suffix}`,
-        receiptId: `ON-001-${suffix}`,
-        // `Authorised` is what the real provider reports for a completed redirect.
-        // It is NOT settlement — see the checkout topic docs.
-        resultCode: 'Authorised',
-        sessionResult: `mock-session-result-${suffix}`,
-        orderPassword: `mock-pw-${suffix}`,
-    };
-    mockPublishEvent('checkout', 'payment-completed', {
-        orderId: checkout.orderId,
-        receiptId: checkout.receiptId,
-        resultCode: checkout.resultCode,
-        sessionResult: checkout.sessionResult,
-    });
-    return { success: true, timestamp: new Date().toISOString(), checkout };
-};

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

@@ -1,59 +0,0 @@
-export interface ResumeCheckoutParams {
-    /**
-     * Where to read the provider's return data from. Defaults to the current
-     * page URL, which is where the shopper has just landed.
-     *
-     * Only override this if you moved the query string somewhere else before
-     * calling — for example if your router strips it on mount.
-     */
-    url?: string;
-}
-/**
- * What the return leg produced. Every field past `resumed` is absent when
- * `resumed` is `false`.
- */
-export interface ResumeCheckoutResult {
-    /**
-     * `false` means THIS WAS AN ORDINARY PAGE LOAD — no provider return data was
-     * in the URL, so there was nothing to finish and nothing happened. It is not
-     * an error, and it is the answer on every normal visit to the page. Call this
-     * unconditionally when your checkout or confirmation screen mounts and branch
-     * on this field.
-     */
-    resumed: boolean;
-    orderId?: string;
-    receiptId?: string;
-    /**
-     * The provider's result code for the completed attempt, e.g. `Authorised` or
-     * `Refused`. As everywhere else in this topic, `Authorised` is an
-     * authorisation and NOT a settlement.
-     */
-    resultCode?: string;
-    /** Opaque proof of the payment — see `PaymentCompletedPayload.sessionResult`. */
-    sessionResult?: string;
-    /**
-     * The one-time order password from the original checkout, recovered from
-     * browser storage. The page that held it in memory is gone, so this is the
-     * only way back to the order's status after a redirect.
-     */
-    orderPassword?: string;
-}
-export interface ResumeCheckoutResponse {
-    success: boolean;
-    timestamp: string;
-    checkout: ResumeCheckoutResult;
-}
-/**
- * Finish a checkout the shopper was redirected away from.
- *
- * SAFE TO CALL ON EVERY PAGE LOAD, and that is how it is meant to be used: on
- * an ordinary visit it finds no return data and answers `{ resumed: false }`
- * without touching the network. Calling it twice for one return is also safe —
- * the return data is consumed the first time.
- *
- * The outcome is ALSO published on the `checkout` topic (`payment-completed` or
- * `payment-failed`), exactly as it would have been had the shopper never left,
- * so a page that already subscribes needs no second code path. Subscribe first,
- * then call this, or the event fires before you are listening.
- */
-export type ResumeCheckout = (params?: ResumeCheckoutParams) => Promise<ResumeCheckoutResponse>;

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

@@ -1,13 +0,0 @@
-// Resume Checkout Types
-//
-// The RETURN LEG of an online checkout. Some payment methods — and 3-D Secure
-// on a card — take the shopper away to their bank or wallet and send them back
-// to `returnUrl` on a FRESH PAGE LOAD. The payment is not finished at that
-// point: the provider hands the browser a one-time result in the URL, and it
-// has to be handed back to the provider to complete the charge.
-//
-// `startCheckout` cannot do this. It ran in the page that is now gone.
-//
-// Served ONLY by the storefront runtime (a published website), like
-// `startCheckout`. On a register it does not exist.
-export {};

package/dist/actions/resume-order/action.d.ts

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

package/dist/actions/resume-order/action.js

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

package/dist/actions/resume-order/mock.d.ts

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

package/dist/actions/resume-order/mock.js

@@ -1,55 +0,0 @@
-import { MOCK_ORDERS, MOCK_PARKED_ORDERS, mockPublishEvent } from '../../demo/database';
-import { restoreMockCartFromOrder } from '../resume-parked-order/mock';
-// Mirrors the host's rule (see README): anything not already in a cart and not finished.
-const BLOCKED_PAYMENT = new Set(['refunded', 'partially_refunded', 'voided', 'payment_pending']);
-const FINISHED_FULFILLMENT = new Set(['cancelled', 'returned', 'partially_returned']);
-export const mockResumeOrder = async (params) => {
-    console.log('[Mock] resumeOrder called', params);
-    const orderId = params?.orderId;
-    if (!orderId) {
-        throw new Error('Order ID is required');
-    }
-    const order = [...MOCK_PARKED_ORDERS, ...MOCK_ORDERS].find((o) => o._id === orderId);
-    if (!order) {
-        throw new Error(`Order with ID ${orderId} not found`);
-    }
-    const from = { payment: order.paymentState ?? 'unpaid', fulfillment: order.fulfillmentState ?? 'draft' };
-    const inCart = order.inCart != null ? order.inCart.active : from.fulfillment === 'draft';
-    if (inCart) {
-        throw new Error(`Order ${orderId} is already in a cart`);
-    }
-    if (BLOCKED_PAYMENT.has(from.payment) ||
-        FINISHED_FULFILLMENT.has(from.fulfillment) ||
-        (from.payment === 'paid' && from.fulfillment === 'fulfilled')) {
-        throw new Error(`Order ${orderId} cannot be resumed from ${from.payment} × ${from.fulfillment}`);
-    }
-    // Keeps the state; only parked (on_hold) / draft move.
-    const leavesParked = from.fulfillment === 'on_hold' || from.fulfillment === 'draft';
-    const to = {
-        payment: from.payment,
-        fulfillment: !leavesParked ? from.fulfillment : from.payment === 'unpaid' ? 'draft' : 'in_progress',
-    };
-    restoreMockCartFromOrder(order);
-    const parkedIndex = MOCK_PARKED_ORDERS.findIndex((o) => o._id === orderId);
-    if (parkedIndex !== -1)
-        MOCK_PARKED_ORDERS.splice(parkedIndex, 1);
-    mockPublishEvent('cart', 'cart-created', { orderId });
-    mockPublishEvent('order-state', 'state-transition-completed', {
-        orderId,
-        from,
-        to,
-        timestamp: new Date().toISOString(),
-    });
-    return {
-        success: true,
-        order: {
-            ...order,
-            paymentState: to.payment,
-            fulfillmentState: to.fulfillment,
-            inCart: { active: true, stationId: null, since: new Date().toISOString() },
-        },
-        from,
-        to,
-        timestamp: new Date().toISOString(),
-    };
-};

package/dist/actions/resume-order/types.d.ts

@@ -1,17 +0,0 @@
-import { CFOrder } from '../../CommonTypes';
-import type { CFStatePair } from '../../common-types/order-state';
-export interface ResumeOrderParams {
-    /** The order to load back into the cart. Must be open — see the README for which states resume. */
-    orderId: string;
-}
-export interface ResumeOrderResponse {
-    success: boolean;
-    /** The resumed order, re-read after the transition. */
-    order: CFOrder;
-    /** State before resuming. */
-    from: CFStatePair;
-    /** State after resuming — `draft` when nothing was paid, otherwise the order stays out of the cart states. */
-    to: CFStatePair;
-    timestamp: string;
-}
-export type ResumeOrder = (params: ResumeOrderParams) => Promise<ResumeOrderResponse>;

package/dist/actions/resume-order/types.js

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

package/dist/actions/select-shipping-option/action.d.ts

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

package/dist/actions/select-shipping-option/action.js

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

package/dist/actions/select-shipping-option/mock.d.ts

@@ -1,3 +0,0 @@
-import type { SelectShippingOption } from './types';
-/** Standalone mock: refuses an option the cart isn't offered, like the runtime does. */
-export declare const mockSelectShippingOption: SelectShippingOption;

package/dist/actions/select-shipping-option/mock.js

@@ -1,31 +0,0 @@
-import { MOCK_CART, mockPublishEvent } from '../../demo/database';
-import { mockShippingOptions } from '../../demo/shipping';
-/** Standalone mock: refuses an option the cart isn't offered, like the runtime does. */
-export const mockSelectShippingOption = async (params) => {
-    console.log('[Mock] selectShippingOption called', params);
-    if (!params)
-        throw new Error('Params required');
-    const previous = MOCK_CART.shippingTotal ?? 0;
-    if (params.optionId === null) {
-        MOCK_CART.shipping = null;
-    }
-    else {
-        const option = mockShippingOptions().resolution.options.find((o) => o.optionId === params.optionId);
-        if (!option)
-            throw new Error('selectShippingOption: this option is not offered for this cart');
-        MOCK_CART.shipping = {
-            zoneId: option.zoneId,
-            optionId: option.optionId,
-            type: option.type,
-            name: option.name,
-            amount: option.amount,
-            minDays: option.minDays,
-            maxDays: option.maxDays,
-            outletId: option.outletId,
-        };
-    }
-    MOCK_CART.shippingTotal = MOCK_CART.shipping?.amount ?? 0;
-    MOCK_CART.total += MOCK_CART.shippingTotal - previous;
-    mockPublishEvent('cart', 'cart-updated', { shipping: MOCK_CART.shipping });
-    return { shipping: MOCK_CART.shipping, cart: MOCK_CART, timestamp: new Date().toISOString() };
-};

package/dist/actions/select-shipping-option/types.d.ts

@@ -1,15 +0,0 @@
-import type { CFActiveCart, CFCartShipping } from '../../CommonTypes';
-export interface SelectShippingOptionParams {
-    /** An `optionId` from `getShippingOptions`. `null` takes shipping off the cart. */
-    optionId: string | null;
-}
-export interface SelectShippingOptionResponse {
-    shipping: CFCartShipping | null;
-    cart: CFActiveCart;
-    timestamp: string;
-}
-/**
- * THROWS for an option this cart isn't offered: one from another address, a
- * website-only option at the till, or one the store has since removed.
- */
-export type SelectShippingOption = (params: SelectShippingOptionParams) => Promise<SelectShippingOptionResponse>;

package/dist/actions/select-shipping-option/types.js

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

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

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

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

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

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

@@ -1,7 +0,0 @@
-import type { SetOrderAddress } from './types';
-/**
- * Standalone mock of putting an address on the cart. It refuses what the runtime refuses (no
- * country, an unreadable one, a shipping address without street and city) so a checkout form
- * that looks finished in preview doesn't lose orders on the published site.
- */
-export declare const mockSetOrderAddress: SetOrderAddress;

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

@@ -1,29 +0,0 @@
-import { normalizeAddress } from '@final-commerce/common';
-import { MOCK_CART, mockPublishEvent } from '../../demo/database';
-/**
- * Standalone mock of putting an address on the cart. It refuses what the runtime refuses (no
- * country, an unreadable one, a shipping address without street and city) so a checkout form
- * that looks finished in preview doesn't lose orders on the published site.
- */
-export const mockSetOrderAddress = async (params) => {
-    console.log('[Mock] setOrderAddress called', params);
-    if (!params || (params.type !== 'shipping' && params.type !== 'billing')) {
-        throw new Error("setOrderAddress: type must be 'shipping' or 'billing'");
-    }
-    const key = params.type === 'shipping' ? 'shippingAddress' : 'billingAddress';
-    let address = params.address;
-    if (address) {
-        const read = normalizeAddress(address);
-        if (!read.country)
-            throw new Error('setOrderAddress: choose a country');
-        if (params.type === 'shipping' && (!address.address1?.trim() || !address.city?.trim())) {
-            throw new Error('setOrderAddress: a shipping address needs a street and a city');
-        }
-        address = { ...address, country: read.country, state: read.province ?? address.state, fromCustomer: false };
-    }
-    MOCK_CART[key] = address;
-    if (params.type === 'shipping')
-        MOCK_CART.shipping = null;
-    mockPublishEvent('cart', 'cart-updated', { [key]: address });
-    return { address, cart: MOCK_CART, timestamp: new Date().toISOString() };
-};

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

@@ -1,19 +0,0 @@
-import type { CFActiveCart, CFCartAddress } from '../../CommonTypes';
-export type OrderAddressType = 'shipping' | 'billing';
-export interface SetOrderAddressParams {
-    type: OrderAddressType;
-    /** `null` clears it. Country and province may be codes or names; the runtime stores codes. */
-    address: CFCartAddress | null;
-}
-export interface SetOrderAddressResponse {
-    /** As stored: country as ISO-2, province as its code, postal code tidied. */
-    address: CFCartAddress | null;
-    /** The cart after the change. A new shipping address re-checks the chosen shipping option. */
-    cart: CFActiveCart;
-    timestamp: string;
-}
-/**
- * THROWS when the address can't be used: no country, a country we can't read, or a
- * shipping address without a street and city. The message says which, for the form.
- */
-export type SetOrderAddress = (params: SetOrderAddressParams) => Promise<SetOrderAddressResponse>;

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

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

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

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

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

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

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

@@ -1,5 +0,0 @@
-import type { CFMetadataItem } from '../../CommonTypes';
-import type { SetOrderMetadata } from './types';
-/** Set/remove keys; untouched items (and extra fields such as `externalId`) are kept as-is. */
-export declare const mergeMetadata: <T extends CFMetadataItem>(current: T[] | undefined, changes: Record<string, string | null>) => T[];
-export declare const mockSetOrderMetadata: SetOrderMetadata;

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

@@ -1,38 +0,0 @@
-import { MOCK_ORDERS, MOCK_PARKED_ORDERS, mockPublishEvent } from '../../demo/database';
-/** Metadata for the demo's live cart, which has no order until it is paid or parked. */
-let mockCartMetadata = [];
-/** Set/remove keys; untouched items (and extra fields such as `externalId`) are kept as-is. */
-export const mergeMetadata = (current, changes) => {
-    const byKey = new Map((current ?? []).map((m) => [m.key, m]));
-    for (const [key, value] of Object.entries(changes)) {
-        if (value === null)
-            byKey.delete(key);
-        else
-            byKey.set(key, { ...byKey.get(key), key, value });
-    }
-    return [...byKey.values()];
-};
-export const mockSetOrderMetadata = async (params) => {
-    console.log('[Mock] setOrderMetadata called', params);
-    if (!params?.metadata || Object.keys(params.metadata).length === 0) {
-        throw new Error('setOrderMetadata: metadata must set or remove at least one key');
-    }
-    for (const [key, value] of Object.entries(params.metadata)) {
-        if (!key.trim())
-            throw new Error('setOrderMetadata: metadata keys must be non-empty');
-        if (value !== null && typeof value !== 'string') {
-            throw new Error(`setOrderMetadata: value for "${key}" must be a string or null`);
-        }
-    }
-    if (!params.orderId) {
-        mockCartMetadata = mergeMetadata(mockCartMetadata, params.metadata);
-        return { success: true, orderId: null, metadata: mockCartMetadata, timestamp: new Date().toISOString() };
-    }
-    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.metadata = mergeMetadata(order.metadata, params.metadata);
-    mockPublishEvent('orders', 'order-updated', { order });
-    return { success: true, orderId: order._id, metadata: order.metadata, timestamp: new Date().toISOString() };
-};

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