@final-commerce/command-frame 0.14.1-online.3 → 0.15.0-staging.2

package/dist/actions/get-shopper-order/types.d.ts

@@ -1,32 +0,0 @@
-import type { ShopperOrderView } from '../get-shopper-orders/types';
-export interface ShopperOrderItemView {
-    name: string;
-    /** e.g. "Slate", or null */
-    variant: string | null;
-    quantity: number;
-    totalLabel: string;
-}
-export interface ShopperOrderDetailView extends ShopperOrderView {
-    items: ShopperOrderItemView[];
-    /** Subtotal, Discount, Tax, Shipping, Refunded, Total: only the ones that apply. */
-    totals: {
-        label: string;
-        amountLabel: string;
-    }[];
-    /** "Visa •••• 4242", or null */
-    paidWithLabel: string | null;
-    /** "Pickup at Water St.", "Shipping", or null */
-    deliveryLabel: string | null;
-    /** "Return requested Nov 3, 2026", or null */
-    returnLabel: string | null;
-}
-export interface GetShopperOrderParams {
-    orderId: string;
-}
-export interface GetShopperOrderResponse {
-    success: boolean;
-    order?: ShopperOrderDetailView;
-    reason?: string;
-}
-/** One of the shopper's orders at this store. */
-export type GetShopperOrder = (params: GetShopperOrderParams) => Promise<GetShopperOrderResponse>;

package/dist/actions/get-shopper-order/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};

package/dist/actions/get-shopper-orders/action.d.ts

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

package/dist/actions/get-shopper-orders/action.js

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

package/dist/actions/get-shopper-orders/mock.d.ts

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

package/dist/actions/get-shopper-orders/mock.js

@@ -1,18 +0,0 @@
-export const mockGetShopperOrders = async () => {
-    console.log('[Mock] getShopperOrders called');
-    return {
-        success: true,
-        orders: [
-            {
-                orderId: '6a2f1c7b1e35f9a4c67a1010',
-                receiptId: '#1042',
-                placedAtLabel: 'Nov 1, 2026',
-                status: 'paid',
-                statusLabel: 'Paid',
-                totalLabel: '$42.50',
-                itemsLabel: '3 items',
-            },
-        ],
-        nextCursor: null,
-    };
-};

package/dist/actions/get-shopper-orders/types.d.ts

@@ -1,29 +0,0 @@
-import type { ShopperOrderStatus } from '@final-commerce/common';
-/** One order row, ready to display. */
-export interface ShopperOrderView {
-    orderId: string;
-    receiptId: string;
-    /** e.g. "Nov 1, 2026" */
-    placedAtLabel: string;
-    /** For styling only: the label is what the shopper reads. */
-    status: ShopperOrderStatus;
-    /** "Paid", "Refunded", "Partially refunded", "Cancelled" */
-    statusLabel: string;
-    /** "$42.50" */
-    totalLabel: string;
-    /** "3 items" */
-    itemsLabel: string;
-}
-export interface GetShopperOrdersParams {
-    /** From the previous page's `nextCursor`. */
-    cursor?: string;
-}
-export interface GetShopperOrdersResponse {
-    success: boolean;
-    /** This store's orders placed with the shopper's verified emails, newest first. */
-    orders: ShopperOrderView[];
-    nextCursor: string | null;
-    reason?: string;
-}
-/** The signed-in shopper's orders at this store. */
-export type GetShopperOrders = (params?: GetShopperOrdersParams) => Promise<GetShopperOrdersResponse>;

package/dist/actions/get-shopper-orders/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};

package/dist/actions/request-shopper-code/action.d.ts

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

package/dist/actions/request-shopper-code/action.js

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

package/dist/actions/request-shopper-code/mock.d.ts

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

package/dist/actions/request-shopper-code/mock.js

@@ -1,4 +0,0 @@
-export const mockRequestShopperCode = async (params) => {
-    console.log('[Mock] requestShopperCode called', params);
-    return { success: true, message: `We sent a 6-digit code to ${params.email ?? params.phone ?? 'your email'}` };
-};

package/dist/actions/request-shopper-code/types.d.ts

@@ -1,17 +0,0 @@
-/**
- * Where the code goes: an `email`, or a `phone` (a text message; any common spelling, the runtime
- * makes it E.164 with +1 when no country is given). Give one, not both. Give neither right after a
- * guest checkout to send it to the email that checkout used ("Email me a code" on the confirmation).
- */
-export interface RequestShopperCodeParams {
-    email?: string;
-    phone?: string;
-}
-export interface RequestShopperCodeResponse {
-    success: boolean;
-    /** "We sent a 6-digit code to s…@example.com" (or "…by text to ••• 0101"). Never says who has an account. */
-    message?: string;
-    reason?: string;
-}
-/** Send a 6-digit sign-in code by email or text. It works at this store only. Signing up is the same step. */
-export type RequestShopperCode = (params: RequestShopperCodeParams) => Promise<RequestShopperCodeResponse>;

package/dist/actions/request-shopper-code/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};

package/dist/actions/search-addresses/action.d.ts

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

package/dist/actions/search-addresses/action.js

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

package/dist/actions/search-addresses/mock.d.ts

@@ -1,3 +0,0 @@
-import type { SearchAddresses } from './types';
-/** Standalone mock: two Water Street addresses for anything typed. */
-export declare const mockSearchAddresses: SearchAddresses;

package/dist/actions/search-addresses/mock.js

@@ -1,24 +0,0 @@
-/** Standalone mock: two Water Street addresses for anything typed. */
-export const mockSearchAddresses = async (params) => {
-    console.log('[Mock] searchAddresses called', params);
-    if (params.query.trim().length < 3)
-        return { success: true, available: true, suggestions: [] };
-    return {
-        success: true,
-        available: true,
-        suggestions: [
-            {
-                id: 'mock-place-1',
-                label: "12 Water St, St. John's, NL, Canada",
-                main: '12 Water St',
-                secondary: "St. John's, NL, Canada",
-            },
-            {
-                id: 'mock-place-2',
-                label: "120 Water St, St. John's, NL, Canada",
-                main: '120 Water St',
-                secondary: "St. John's, NL, Canada",
-            },
-        ],
-    };
-};

package/dist/actions/search-addresses/types.d.ts

@@ -1,31 +0,0 @@
-/** One line to show in the dropdown. Pass its `id` to getAddressDetails when the shopper picks it. */
-export interface AddressSuggestion {
-    id: string;
-    /** The whole line: "12 Water St, St. John's, NL, Canada". */
-    label: string;
-    /** The street part, for a two-line row: "12 Water St". */
-    main: string;
-    /** The rest: "St. John's, NL, Canada". */
-    secondary: string;
-}
-export interface SearchAddressesParams {
-    /** What the shopper typed so far. Under 3 characters answers no suggestions without a lookup. */
-    query: string;
-    /** ISO 3166-1 alpha-2. Defaults to the store's own country. */
-    country?: string;
-    /** Language of the suggestions, e.g. `fr`. */
-    language?: string;
-}
-export interface SearchAddressesResponse {
-    success: boolean;
-    suggestions: AddressSuggestion[];
-    /** false when this site has no address lookup: keep the plain fields and stop asking. */
-    available: boolean;
-    reason?: string;
-}
-/**
- * Addresses matching what the shopper typed, for an autocomplete dropdown. Call it as they type
- * (wait ~250 ms after the last keystroke); the runtime groups the searches and the pick into one
- * lookup session itself.
- */
-export type SearchAddresses = (params: SearchAddressesParams) => Promise<SearchAddressesResponse>;

package/dist/actions/search-addresses/types.js

@@ -1,5 +0,0 @@
-// Address autocomplete for a store website's checkout: what the shopper typed in, matching
-// addresses out, then the picked one as a full address (getAddressDetails). Served ONLY by the
-// storefront runtime. Failures resolve with `success: false` and a `reason`; these never throw, and
-// when lookup is not available the flow simply keeps its plain address fields.
-export {};

package/dist/actions/sign-in-shopper/action.d.ts

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

package/dist/actions/sign-in-shopper/action.js

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

package/dist/actions/sign-in-shopper/mock.d.ts

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

package/dist/actions/sign-in-shopper/mock.js

@@ -1,7 +0,0 @@
-export const mockSignInShopper = async (params) => {
-    console.log('[Mock] signInShopper called', params);
-    const email = params.email ?? null;
-    return params.code === '000000'
-        ? { success: false, reason: 'That code is wrong' }
-        : { success: true, shopper: { name: email?.split('@')[0] ?? '', email, phone: params.phone ?? null } };
-};

package/dist/actions/sign-in-shopper/types.d.ts

@@ -1,19 +0,0 @@
-import type { ShopperAccountView } from '../get-shopper-account/types';
-/** The same `email` or `phone` the code was sent to (or neither, after a guest checkout), and the code. */
-export interface SignInShopperParams {
-    email?: string;
-    phone?: string;
-    code: string;
-}
-export interface SignInShopperResponse {
-    success: boolean;
-    shopper?: ShopperAccountView;
-    /** "That code is wrong", "Too many tries, get a new code", ... */
-    reason?: string;
-}
-/**
- * Sign in (or up) with the code. The session is kept for this store only. Signing in fills the
- * checkout's contact and default address when they are empty, and the payment step then offers the
- * shopper's saved cards.
- */
-export type SignInShopper = (params: SignInShopperParams) => Promise<SignInShopperResponse>;

package/dist/actions/sign-in-shopper/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};

package/dist/actions/sign-out-shopper/action.d.ts

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

package/dist/actions/sign-out-shopper/action.js

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

package/dist/actions/sign-out-shopper/mock.d.ts

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

package/dist/actions/sign-out-shopper/mock.js

@@ -1,4 +0,0 @@
-export const mockSignOutShopper = async () => {
-    console.log('[Mock] signOutShopper called');
-    return { success: true };
-};

package/dist/actions/sign-out-shopper/types.d.ts

@@ -1,7 +0,0 @@
-export type SignOutShopperParams = Record<string, never>;
-export interface SignOutShopperResponse {
-    success: boolean;
-    reason?: string;
-}
-/** Ends this store's session on this device. */
-export type SignOutShopper = (params?: SignOutShopperParams) => Promise<SignOutShopperResponse>;

package/dist/actions/sign-out-shopper/types.js

@@ -1,6 +0,0 @@
-// The shopper account on a store's website (My Account's store-scoped twin): sign in or sign up
-// with a code by email or text, see this store's orders. Served ONLY by the storefront runtime; on a
-// register it does not exist. Every value comes back READY TO DISPLAY (the runtime formats money,
-// dates and labels), so a flow shows it as it is and computes nothing. Failures resolve with
-// `success: false` and a `reason` written for the shopper; these never throw.
-export {};