@final-commerce/command-frame 0.4.2-preprod.1 → 0.5.0-preprod.10

package/dist/actions/open-extension-overlay/types.d.ts

@@ -1,9 +0,0 @@
-import type { InterceptorPoint, InterceptorReturn } from "../../interceptors/types";
-export interface OpenExtensionOverlayParams {
-    point: InterceptorPoint;
-    payload?: any;
-    /** Owning extension id. Injected by the host for interceptor-originated calls; optional for direct calls. */
-    extensionId?: string;
-}
-export type OpenExtensionOverlayResponse = InterceptorReturn;
-export type OpenExtensionOverlay = (params: OpenExtensionOverlayParams) => Promise<OpenExtensionOverlayResponse>;

package/dist/actions/open-extension-overlay/types.js

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

package/dist/actions/resolve-extension-overlay/action.d.ts

@@ -1,2 +0,0 @@
-import type { ResolveExtensionOverlay } from "./types";
-export declare const resolveExtensionOverlay: ResolveExtensionOverlay;

package/dist/actions/resolve-extension-overlay/action.js

@@ -1,4 +0,0 @@
-import { commandFrameClient } from "../../client";
-export const resolveExtensionOverlay = async (params) => {
-    return await commandFrameClient.call("resolveExtensionOverlay", params);
-};

package/dist/actions/resolve-extension-overlay/mock.d.ts

@@ -1,2 +0,0 @@
-import type { ResolveExtensionOverlay } from "./types";
-export declare const mockResolveExtensionOverlay: ResolveExtensionOverlay;

package/dist/actions/resolve-extension-overlay/mock.js

@@ -1 +0,0 @@
-export const mockResolveExtensionOverlay = async (_params) => ({ success: true });

package/dist/actions/resolve-extension-overlay/types.d.ts

@@ -1,9 +0,0 @@
-import type { InterceptorReturn } from "../../interceptors/types";
-export interface ResolveExtensionOverlayParams {
-    overlayId: string;
-    result: InterceptorReturn;
-}
-export interface ResolveExtensionOverlayResponse {
-    success: boolean;
-}
-export type ResolveExtensionOverlay = (params: ResolveExtensionOverlayParams) => Promise<ResolveExtensionOverlayResponse>;

package/dist/actions/resolve-extension-overlay/types.js

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

package/dist/actions/vendara-payment/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Vendara payment action
- * Calls the vendaraPayment action on the parent window
- */
-import type { VendaraPayment } from "./types";
-export declare const vendaraPayment: VendaraPayment;

package/dist/actions/vendara-payment/action.js

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

package/dist/actions/vendara-payment/mock.d.ts

@@ -1,2 +0,0 @@
-import { VendaraPayment } from "./types";
-export declare const mockVendaraPayment: VendaraPayment;

package/dist/actions/vendara-payment/mock.js

@@ -1,11 +0,0 @@
-import { MOCK_ORDERS } from "../../demo/database";
-export const mockVendaraPayment = async (params) => {
-    console.log("[Mock] vendaraPayment called", params);
-    return {
-        success: true,
-        amount: params?.amount || null,
-        paymentType: "vendara",
-        order: MOCK_ORDERS[0],
-        timestamp: new Date().toISOString()
-    };
-};

package/dist/actions/vendara-payment/types.d.ts

@@ -1,26 +0,0 @@
-import { CFOrder } from "../../CommonTypes";
-import type { CFTransitionResult } from "../../common-types/order-state";
-export interface VendaraPaymentParams {
-    /**
-     * The amount to pay with this tender, in integer MINOR currency units
-     * (e.g. 1575 = $15.75). Required. Semantics against the cart's balance due:
-     *   - missing            → error
-     *   - less than balance  → partial payment (the POS enters a fixed
-     *                          split-payment leg for this amount)
-     *   - equal to balance   → full payment
-     *   - more than balance  → error
-     */
-    amount: number;
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
-    checkoutFulfillmentTarget?: string;
-}
-export interface VendaraPaymentResponse {
-    success: boolean;
-    amount: number | null;
-    paymentType: string;
-    order: CFOrder | null;
-    timestamp: string;
-    /** Present when the state machine blocked or forced the transition. */
-    transitionResult?: CFTransitionResult;
-}
-export type VendaraPayment = (params?: VendaraPaymentParams) => Promise<VendaraPaymentResponse>;

package/dist/actions/vendara-payment/types.js

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

package/dist/hooks/index.d.ts

@@ -1,17 +0,0 @@
-import type { HookFunction, HookRegisterOptions } from "./types";
-/**
- * Register a session-scoped hook. The callback is serialized and sent to the host (Render);
- * once registered, it runs in the host context even when the extension iframe is not on the current page.
- * The callback must be self-contained (only use event, hostCommands, callCommand).
- * Uses options.hookId as a stable dedup key: re-registering with the same hookId replaces the previous hook.
- */
-declare function register(topic: string, callback: HookFunction, options: HookRegisterOptions): string;
-/**
- * Unregister a hook by ID. Sends a message to the host to remove the hook.
- */
-declare function unregister(hookId: string): void;
-export declare const hooks: {
-    register: typeof register;
-    unregister: typeof unregister;
-};
-export type { HookFunction, HookRegisterOptions } from "./types";

package/dist/hooks/index.js

@@ -1,39 +0,0 @@
-const DEFAULT_ORIGIN = "*";
-function getOrigin() {
-    return typeof window !== "undefined" ? window.__COMMAND_FRAME_ORIGIN__ ?? DEFAULT_ORIGIN : DEFAULT_ORIGIN;
-}
-/**
- * Register a session-scoped hook. The callback is serialized and sent to the host (Render);
- * once registered, it runs in the host context even when the extension iframe is not on the current page.
- * The callback must be self-contained (only use event, hostCommands, callCommand).
- * Uses options.hookId as a stable dedup key: re-registering with the same hookId replaces the previous hook.
- */
-function register(topic, callback, options) {
-    const hookId = options.hookId;
-    const functionBody = callback.toString();
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({
-            type: "hook-register",
-            topic,
-            functionBody,
-            eventTypes: options.eventTypes,
-            hookId
-        }, getOrigin());
-    }
-    return hookId;
-}
-/**
- * Unregister a hook by ID. Sends a message to the host to remove the hook.
- */
-function unregister(hookId) {
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({
-            type: "hook-unregister",
-            hookId
-        }, getOrigin());
-    }
-}
-export const hooks = {
-    register,
-    unregister
-};

package/dist/hooks/types.d.ts

@@ -1,15 +0,0 @@
-import type { TopicEvent } from "../pubsub/types";
-/**
- * Function signature for extension hook callbacks.
- * The function is serialized and sent to the host; it receives event and hostCommands when executed.
- */
-export type HookFunction = (event: TopicEvent, hostCommands: Record<string, (params?: any) => Promise<any>>, callCommand: (action: string, params?: any) => Promise<any>) => void | Promise<void>;
-/**
- * Options when registering a hook from the extension iframe.
- */
-export interface HookRegisterOptions {
-    /** Stable identifier for this hook. Used to deduplicate on reload. Must be unique per hook. */
-    hookId: string;
-    /** Only fire for these event types; omit to receive all events for the topic */
-    eventTypes?: string[];
-}

package/dist/hooks/types.js

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

package/dist/interceptors/index.d.ts

@@ -1,21 +0,0 @@
-import type { InterceptorFunction, InterceptorPoint, InterceptorRegisterOptions, InterceptorOverlayContext } from "./types";
-/** Register a session-scoped interceptor for a named point. Callback is serialized to the host. */
-declare function register(point: InterceptorPoint, callback: InterceptorFunction, options: InterceptorRegisterOptions): string;
-declare function unregister(interceptorId: string): void;
-/** Register a handler invoked when this iframe is opened as an overlay by the host. */
-declare function onOverlay(handler: (ctx: InterceptorOverlayContext) => void): void;
-/** Continue the gated flow, merging `data` into the flow payload. */
-declare function resolve(data: Record<string, any>): Promise<void>;
-/** Continue the gated flow with no data. */
-declare function proceed(): Promise<void>;
-/** Stop the gated flow. */
-declare function cancel(): Promise<void>;
-export declare const interceptors: {
-    register: typeof register;
-    unregister: typeof unregister;
-    onOverlay: typeof onOverlay;
-    resolve: typeof resolve;
-    proceed: typeof proceed;
-    cancel: typeof cancel;
-};
-export type { InterceptorFunction, InterceptorPoint, InterceptorRegisterOptions, InterceptorReturn, InterceptorOverlayContext, InterceptorHostCommands } from "./types";

package/dist/interceptors/index.js

@@ -1,53 +0,0 @@
-import { commandFrameClient } from "../client";
-const DEFAULT_ORIGIN = "*";
-function getOrigin() {
-    return typeof window !== "undefined" ? window.__COMMAND_FRAME_ORIGIN__ ?? DEFAULT_ORIGIN : DEFAULT_ORIGIN;
-}
-let overlayId = null;
-let overlayContext = null;
-let overlayHandler = null;
-if (typeof window !== "undefined") {
-    window.addEventListener("message", (event) => {
-        const data = event.data;
-        if (data && data.type === "interceptor-overlay-init" && typeof data.overlayId === "string") {
-            overlayId = data.overlayId;
-            overlayContext = { point: data.point, payload: data.payload };
-            if (overlayHandler)
-                overlayHandler(overlayContext);
-        }
-    });
-}
-/** Register a session-scoped interceptor for a named point. Callback is serialized to the host. */
-function register(point, callback, options) {
-    const interceptorId = options.interceptorId;
-    const functionBody = callback.toString();
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({ type: "interceptor-register", point, functionBody, interceptorId, timeoutMs: options.timeoutMs }, getOrigin());
-    }
-    return interceptorId;
-}
-function unregister(interceptorId) {
-    if (typeof window !== "undefined" && window.top && window.top !== window) {
-        window.top.postMessage({ type: "interceptor-unregister", interceptorId }, getOrigin());
-    }
-}
-/** Register a handler invoked when this iframe is opened as an overlay by the host. */
-function onOverlay(handler) {
-    overlayHandler = handler;
-    if (overlayContext)
-        handler(overlayContext);
-}
-async function report(result) {
-    if (!overlayId) {
-        console.warn("[interceptors] report called outside an overlay context — ignored");
-        return;
-    }
-    await commandFrameClient.call("resolveExtensionOverlay", { overlayId, result });
-}
-/** Continue the gated flow, merging `data` into the flow payload. */
-function resolve(data) { return report(data); }
-/** Continue the gated flow with no data. */
-function proceed() { return report(true); }
-/** Stop the gated flow. */
-function cancel() { return report(false); }
-export const interceptors = { register, unregister, onOverlay, resolve, proceed, cancel };

package/dist/interceptors/types.d.ts

@@ -1,26 +0,0 @@
-/**
- * Interceptors let an installed extension gate a host flow at a named point.
- * Registration mirrors hooks: the callback is serialized and reconstructed on the host,
- * so it must be self-contained (use only its payload arg and the injected host commands).
- */
-export type InterceptorPoint = "refund_start";
-/** false = stop the flow; true = continue, no data; object = continue and merge into the flow payload. */
-export type InterceptorReturn<T extends Record<string, any> = Record<string, any>> = boolean | T;
-export interface InterceptorHostCommands {
-    openExtensionOverlay: (params: {
-        point: InterceptorPoint;
-        payload?: any;
-    }) => Promise<InterceptorReturn>;
-    [command: string]: (params?: any) => Promise<any>;
-}
-export type InterceptorFunction = (payload: any, cmds: InterceptorHostCommands, callCommand: (action: string, params?: any) => Promise<any>) => InterceptorReturn | Promise<InterceptorReturn>;
-export interface InterceptorRegisterOptions {
-    /** Stable id; re-registering with the same id replaces the previous one. */
-    interceptorId: string;
-    /** Per-interceptor timeout override (ms). */
-    timeoutMs?: number;
-}
-export interface InterceptorOverlayContext {
-    point: InterceptorPoint;
-    payload: any;
-}

package/dist/interceptors/types.js

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