@ada-cx/messaging-sdk 1.0.0-setup.0

package/dist/frame-channel/frame-channel.d.ts

@@ -0,0 +1,64 @@
+import type { FrameMessage } from "./types.js";
+type MessageHandler = (message: FrameMessage) => void;
+/**
+ * Type-safe postMessage wrapper for cross-iframe communication.
+ *
+ * Each FrameChannel instance manages communication with a single
+ * iframe, tracking its origin for secure message targeting and
+ * supporting request/response correlation via UUIDs.
+ */
+export declare class FrameChannel {
+    private _name;
+    private _target;
+    private _targetOrigin;
+    private _expectedIncomingName;
+    private _pendingMessages;
+    private _handlers;
+    private _pendingRequests;
+    private _boundListener;
+    private _lastOverflowEventMs;
+    constructor(name: string);
+    private _normalizeMessageName;
+    /**
+     * Connect to a target window (the iframe's contentWindow)
+     * and begin listening for incoming messages.
+     */
+    connect(target: Window, targetOrigin?: string, expectedIncomingName?: string): void;
+    /**
+     * Stop listening and release the target reference.
+     */
+    disconnect(): void;
+    /**
+     * Update the target origin for secure message delivery.
+     * Call this once the iframe reports its actual origin.
+     */
+    setTargetOrigin(origin: string): void;
+    /**
+     * Send a message to the connected iframe.
+     * Uses structured clone (native objects) instead of JSON serialization.
+     */
+    send<T = unknown>(type: string, payload?: T): void;
+    /**
+     * Send a request and wait for a correlated response.
+     *
+     * Returns a Promise that resolves when a message with a matching
+     * `id` is received, or rejects after `timeoutMs`.
+     */
+    request<TReq = unknown, TRes = unknown>(requestType: string, responseType: string, payload?: TReq, timeoutMs?: number): Promise<FrameMessage<TRes>>;
+    /**
+     * Register a handler for a specific message type.
+     */
+    on(type: string, handler: MessageHandler): void;
+    /**
+     * Remove a specific handler for a message type.
+     */
+    off(type: string, handler: MessageHandler): void;
+    /**
+     * Register a one-time handler that auto-removes after first invocation.
+     */
+    once(type: string, handler: MessageHandler): void;
+    private _handleMessage;
+    private _queuePendingMessage;
+    private _flushPendingMessages;
+}
+export {};

package/dist/frame-channel/frame-child.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Lightweight frame-side helper for child iframes to communicate
+ * with the parent SDK via postMessage.
+ *
+ * This is used by frame-side TypeScript entry points and keeps
+ * origin normalization aligned with the shared utility package.
+ */
+interface FrameMessage<T = unknown> {
+    name: string;
+    type: string;
+    payload: T;
+    id?: string;
+}
+type MessageHandler = (message: FrameMessage) => void;
+export declare class FrameChild {
+    private _name;
+    private _parentOrigin;
+    private _expectedParentName;
+    private _handlers;
+    private _boundListener;
+    private _pendingMessages;
+    constructor(name: string, expectedParentName?: string | null);
+    /** Report our origin to the parent SDK */
+    reportOrigin(): void;
+    /** Signal to the parent SDK that this frame is ready */
+    signalReady(): void;
+    /** Report an error to the parent SDK */
+    reportError(error: string): void;
+    /** Send a message to the parent window using structured clone */
+    send<T = unknown>(type: string, payload?: T, id?: string): void;
+    /** Reply to a specific request by echoing its id */
+    reply<T = unknown>(originalMessage: FrameMessage, type: string, payload?: T): void;
+    /** Register a handler for a specific message type */
+    on(type: string, handler: MessageHandler): void;
+    /** Remove a handler */
+    off(type: string, handler: MessageHandler): void;
+    /** Set the allowed parent origin for outgoing messages */
+    setParentOrigin(origin: string): void;
+    private static _normalizeName;
+    /** Remove the message listener and clean up handlers */
+    destroy(): void;
+    private _flushPendingMessages;
+    private _handleMessage;
+}
+export {};

package/dist/frame-channel/index.d.ts

@@ -0,0 +1,3 @@
+export { FrameChannel } from "./frame-channel.js";
+export { FrameChild } from "./frame-child.js";
+export type { ClearPersistenceAckResponseType, FrameMessage, FrameName, FrameRegistry, FrameToSdkEvents, SdkToFrameEvents, StartupConfig, StartupConfigFallbackUi, StartupConfigIntro, StartupConfigProactiveConversation, } from "./types.js";