@ada-cx/messaging-sdk 1.9.5 → 1.10.1

package/dist/client/client-channel-handlers.d.ts

@@ -1,5 +1,6 @@
 import type { CustomAppFrameStyles } from "../shared-utils/index.js";
 import type { FrameChannel, FrameName, FrameRegistry, FrameToSdkEvents, StartupConfig } from "../frame-channel/index.js";
+import type { IframeEmbedHost } from "../helpers/iframe-embed-mode.js";
 import type { AdaMessagingClientConfig, AdaSdkEventCallback, WindowInfo } from "./client-types.js";
 interface BaseChannelDependencies {
     channels: Map<FrameName, FrameChannel>;
@@ -19,6 +20,8 @@ export interface ProactiveDisplayRequest {
 export interface CoreChannelDependencies extends BaseChannelDependencies {
     channel: FrameChannel;
     openHostNavigationInNewWindow?: boolean;
+    iframeEmbedMode?: boolean;
+    embedHost?: IframeEmbedHost;
     config: {
         handle: string;
         language?: string;

package/dist/client/client-host-runtime.d.ts

@@ -39,6 +39,11 @@ export interface DeliverConfigRuntimeOptions {
     testMode?: boolean;
     privateMode?: boolean;
     isParentElementMode?: boolean;
+    isIframeEmbed?: boolean;
+    iframeEmbedNavigation?: boolean;
+    embedHostOrigin?: string;
+    embedMode?: "inline" | "floating";
+    shimVersion?: string;
     headless?: boolean;
     isMobileViewport?: boolean;
     hideDefaultHeader?: boolean;
@@ -56,6 +61,7 @@ export interface DeliverConfigRuntimeOptions {
     initialURL?: string | null;
     /** Internal (EXP-1082): the mobile webview runtime mirrors session state natively. */
     nativeSessionMirror?: boolean;
+    embedEngagement?: boolean;
 }
 /** Send the client configuration to a frame. */
 export declare function deliverConfigRuntime(channel: FrameChannel, config: DeliverConfigRuntimeOptions): void;

package/dist/client/client-types.d.ts

@@ -165,6 +165,7 @@ export interface AdaMessagingSettings {
     adaReadyCallback?: (params: AdaReadyCallbackParams) => void;
     /** Legacy callback fired when a chatter token becomes available. */
     chatterTokenCallback?: (chatterToken: string) => void;
+    analyticsCallback?: AdaSdkEventCallback;
     /** Legacy callback fired when the conversation ends. */
     conversationEndCallback?: (event?: Record<string, unknown>) => void;
     /** Legacy callback fired when the drawer opens or closes. */

package/dist/client/client.d.ts

@@ -133,6 +133,7 @@ declare class AdaMessagingClient {
     /** An acknowledgement that landed before the chatter token existed to send it. */
     private _pendingUnreadAcknowledgement;
     private _isChatOpen;
+    private _isChatOpenPending;
     private _runtimeGeneration;
     private _resetGeneration;
     private _visibilityGeneration;
@@ -146,6 +147,7 @@ declare class AdaMessagingClient {
     /** Explicit host/user engagement, distinct from a hidden background resume. */
     private _hasExplicitlyEngaged;
     private _nativeViewVisible;
+    private _embedVisibilityObserver;
     private _nativeVisibilityReported;
     private _sessionPreparationSent;
     /** Resolved HTMLElement when parentElement config is active, null otherwise */
@@ -172,6 +174,7 @@ declare class AdaMessagingClient {
     private _pendingHostCallbackErrors;
     private readonly _hostCallbackErrorSink;
     private _cleanupCoreChannelHandlers;
+    private _hasConnectedCore;
     private _restoreStandaloneDocument;
     private _cleanupServiceWorkerNotificationClick;
     private _activationId;
@@ -227,6 +230,7 @@ declare class AdaMessagingClient {
     private _shownCampaign;
     private _openedCampaignSeq;
     private _introSurfaceSeq;
+    private _reportedPageUrl;
     private _currentIntroSurface;
     private _internalHostTelemetry?;
     private _isStandaloneChatPage;
@@ -325,6 +329,9 @@ declare class AdaMessagingClient {
     private _warnAboutLegacySettings;
     private get _isLegacyLoader();
     private _createContainer;
+    private _cancelLauncherExposureRetry;
+    private _launcherExposureRetryAttempt;
+    private _retryLauncherExposure;
     /**
      * Give a height-less inline (`parentElement`) host a 720px floor so the
      * absolutely-filled chat frame is visible instead of collapsing to 0.
@@ -616,6 +623,8 @@ declare class AdaMessagingClient {
      * @deprecated Messaging supports only generative features; scripted/declarative campaigns are ignored.
      */
     evaluateCampaignConditions(..._args: unknown[]): void;
+    /** Report an absolute HTTP(S) page URL on load and navigation. Embed URLs must match the parent origin. */
+    setPageUrl(url: string): void;
     /** Close the currently displayed proactive or campaign bubble. */
     closeCampaign(): void;
     /**
@@ -634,8 +643,8 @@ declare class AdaMessagingClient {
      * Use with {@link AdaMessagingClientConfig.lazy} = `true` to defer initialization
      * until an explicit user action, then call `start()` to mount.
      * Optional settings overrides are applied before first initialization.
-     * Headless and capable native hosts restore at start and create on engagement.
-     * Web parentElement hosts activate through the document visibility wait.
+     * Headless, observer-capable iframe embeds, and capable native hosts restore at start and create on engagement.
+     * Other web parentElement hosts activate through the document visibility wait.
      *
      * @example
      * // Defer loading until consent granted:
@@ -745,6 +754,7 @@ declare class AdaMessagingClient {
     private _ensureIntroFrame;
     private _showOrQueueEmojiDisplay;
     private _drainPendingEmojiDisplay;
+    private _displayIntroWithLayout;
     private _drainPendingIntroDisplay;
     private _clearPendingIntroDisplay;
     private _dropPendingIntroDisplay;
@@ -896,6 +906,7 @@ declare class AdaMessagingClient {
     private _setChatterToken;
     private _scheduleCandidateDiscovery;
     private _setPersistedChatterCandidate;
+    private get _usesEmbedVisibility();
     private get _waitsForEngagement();
     private _reportNativeViewVisibility;
     private _beginExplicitEngagement;
@@ -942,6 +953,7 @@ declare class AdaMessagingClient {
     /** Patch only the current chatter when an accepted proactive is removed. */
     private _markProactiveIntroShown;
     /**
+     * Iframe embeds cannot observe the host page URL.
      * Standalone URLs can carry credentials and metadata.
      * The SDK suppresses URLs for marked asset documents and HTTPS `/chat[/]` pages without ports
      * on a strict subdomain of the configured cluster domain.
@@ -949,6 +961,7 @@ declare class AdaMessagingClient {
      * Host-supplied markers or endpoint overrides cannot establish either document origin.
      */
     private _initialUrlMetaField;
+    private _pageUrl;
     /**
      * Where this build loads its own frames from. Preserves any path prefix (e.g.
      * "/messaging" on the static.ada.support root) so frame URLs don't 404 there;
@@ -971,6 +984,7 @@ declare class AdaMessagingClient {
     private _scheduleRuntimeMetaSync;
     /** Called on every SPA navigation. Re-evaluates intro and proactive conditions. */
     private _onLocationChange;
+    private _cancelPendingChatOpen;
     /**
      * Evaluate URL-triggered proactive conversations for the current page,
      * without the intro-greeting scheduling that `_onLocationChange` also does.

package/dist/client/config-helpers.d.ts

@@ -1,21 +1,12 @@
 import { CSAT_INTEGRATION_ID, CSAT_SUBMIT_ACTION, normalizeCsatSubmitAction, VALID_ADA_CLUSTERS } from "../shared-utils/index.js";
 import type { MetaFieldCounts } from "../frame-channel/types.js";
 import type { AdaMessagingBranding, MetaFieldValue } from "./client-types.js";
+export { buildApiEndpoint, deriveLocalhostApiProxyBase, LOCAL_ASSETS_HOSTNAME, LOCAL_BOT_API_PORT, LOCALHOST_API_PROXY_BASE, LOOPBACK_API_PROXY_PORT, validateEndpointOverride, } from "../helpers/api-endpoint.js";
 export declare const LOCALHOST_CLUSTER = "localhost";
 export declare const DEFAULT_ADA_DOMAIN = "ada";
 export { VALID_ADA_CLUSTERS };
 export declare const KNOWN_ADA_BASE_DOMAINS: Set<string>;
 export declare const HANDLE_PATTERN: RegExp;
-export declare const LOCALHOST_API_PROXY_BASE = "https://messaging-demo.net:5040/api";
-export declare const LOOPBACK_API_PROXY_PORT = 5040;
-/** Hostname of the local messaging asset server (the /etc/hosts alias serving the SDK
- * on :4900). When the SDK loads from here the demo-server proxy (:5040) is running
- * too, so the bot API is reached through it — not the direct-bot fallback. */
-export declare const LOCAL_ASSETS_HOSTNAME = "messaging-assets.net";
-/** The api's default local `APP_PORT`. A `<handle>.localhost` host page (e.g. the
- * app dashboard's Test Chat) talks to its bot api directly on this port. */
-export declare const LOCAL_BOT_API_PORT = 8000;
-export declare function deriveLocalhostApiProxyBase(sdkUrl: string, pageHost?: string): string;
 export declare function normalizeIdentityToken(value: unknown): string | undefined;
 export declare function normalizeCrossWindowPersistence(value: unknown): boolean | undefined;
 /**
@@ -74,13 +65,6 @@ export interface TrackedIntegrationCommand {
     requestId?: string;
     zendeskOperationSeq?: number;
 }
-/**
- * Normalize and validate a customer-provided endpoint override.
- * Throws on invalid input so the constructor surfaces config errors early.
- */
-export declare function validateEndpointOverride(endpoint: string): string;
-/** Append `/api/` to a base URL, avoiding double-appending if already present. */
-export declare function buildApiEndpoint(apiBase: string): string;
 export declare function normalizeClusterInput(value: string | null | undefined): string | null;
 export declare function validateCluster(cluster: string, label: string): string;
 /**

package/dist/client/embed-interface.d.ts

@@ -146,6 +146,8 @@ export interface AdaEmbedInterface {
     evaluateCampaignConditions: (options?: Record<string, unknown>) => Promise<void>;
     /** Close the currently displayed proactive or campaign bubble. */
     closeCampaign: () => Promise<void>;
+    /** Set the page URL used for targeting and SDK metadata on load and navigation. */
+    setPageUrl: (url: string) => Promise<void>;
     /** Trigger a generative Answer by its response id. */
     triggerAnswer: (answerId: string) => Promise<void>;
     /** Trigger a proactive message by key, with optional template params. */

package/dist/client/frame-styles.d.ts

@@ -114,7 +114,7 @@ export declare function isMobileContentLayout(): boolean;
  * {@link isMobileViewport}.
  */
 export declare function prefersReducedMotion(): boolean;
-export declare function syncFrameViewportHeight(element: HTMLElement): () => void;
+export declare function syncFrameViewportHeight(element: HTMLElement, followVisualViewport?: boolean): () => void;
 /**
  * CSS styles for the button launcher iframe.
  *

package/dist/client/frame-visibility.d.ts

@@ -38,6 +38,7 @@ export declare function hasMeasuredSize(frame: HTMLElement | null | undefined):
  * cannot override a hidden ancestor and so reads as an opt-back-in it can never be.
  */
 export declare function setFrameHidden(frame: HTMLElement | null | undefined, hidden: boolean): void;
+export declare function hideFrameUntilLayoutApplied(frame: HTMLElement): void;
 /**
  * Write a frame's style block and bring its accessibility exposure with it.
  *

package/dist/client/proactive/proactive-channel.d.ts

@@ -28,6 +28,7 @@ export interface IntroChannelDependencies {
     /** Open a proactive bubble's branded CTA URL from the host-page context. The
      *  intro frame is sandboxed without allow-popups, so it cannot navigate itself;
      *  it delegates the open to the SDK running on the host page. */
+    retireLayoutSurface?: () => void;
     openCtaUrl?: (url: string, openInNewTab: boolean) => void;
 }
 /** Wire all message handlers for the intro (proactive messages + greeting) frame. */

package/dist/client/proactive/proactive-runtime.d.ts

@@ -3,6 +3,7 @@ export type IntroShowingState = "greeting" | "proactive" | null;
 export type IntroDisplayKind = "greeting" | "proactive";
 export interface ProactiveRuntimeDependencies {
     handle: string;
+    getPageUrl?: () => string | null;
     language?: string;
     parentElement: HTMLElement | null;
     /** Whether the resolved host layout currently permits launcher/intro chrome. */

package/dist/embed-host/bridge.d.ts

@@ -0,0 +1,17 @@
+export interface ConnectInbox {
+    drain(receive: (event: MessageEvent) => void): void;
+    close(): void;
+}
+export declare function createConnectInbox(win: Window): ConnectInbox;
+export declare function validConnect(data: Record<string, unknown>): boolean;
+export declare function createEmbedHostBridge(options: {
+    window: Window;
+    documentId: string;
+    handle: string;
+    cluster: string;
+    parentElement: HTMLElement;
+    inbox?: ConnectInbox;
+}): {
+    configure: (config: unknown) => boolean;
+    destroy: () => void;
+};

package/dist/embed-host/controller-origin.d.ts

@@ -0,0 +1,3 @@
+export declare function controllerConfigValid(config: unknown): boolean;
+export declare function embedControllerAllowed(origin: string, config: unknown): boolean;
+export declare function ancestorsAllowed(win: Window, config: unknown): boolean;

package/dist/embed-host/index.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectInbox } from "./bridge.js";
+export declare function mountIframeEmbed(parentElement: HTMLElement, inbox?: ConnectInbox): Promise<boolean>;

package/dist/embed-host/layout.d.ts

@@ -0,0 +1,16 @@
+import type { DrawnRegions, HostEnvironment } from "../helpers/host-environment.js";
+export declare function drawnRegion(element: HTMLElement): DrawnRegions;
+export declare function covers(cover: DrawnRegions, required: DrawnRegions): boolean;
+export declare function createLayoutChannel(options: {
+    window: Window;
+    send(kind: string, fields: Record<string, unknown>): void;
+    generation(): number;
+    restart(): void;
+    failure(): void;
+}): {
+    environment: HostEnvironment;
+    receive: (data: Record<string, unknown>) => boolean;
+    resync: () => void;
+    restarted(): void;
+    destroy(): void;
+};

package/dist/embed-host/registry.d.ts

@@ -0,0 +1,220 @@
+export declare const METHOD_CLASSIFICATION: {
+    readonly open: "exposed";
+    readonly close: "exposed";
+    readonly reset: "exposed";
+    readonly toggle: "exposed";
+    readonly getInfo: "exposed";
+    readonly isOpen: "exposed";
+    readonly getMetaFields: "exposed";
+    readonly getConversation: "exposed";
+    readonly getMessages: "exposed";
+    readonly setComposerText: "exposed";
+    readonly setDelegate: "exposed";
+    readonly deleteHistory: "exposed";
+    readonly setLanguage: "exposed";
+    readonly setTheme: "exposed";
+    readonly setMetaFields: "exposed";
+    readonly setSensitiveMetaFields: "exposed";
+    readonly setDeviceToken: "exposed";
+    readonly sendMessage: "exposed";
+    readonly triggerPlaybook: "exposed";
+    readonly selectQuickReply: "exposed";
+    readonly trackEvent: "exposed";
+    readonly subscribeEvent: "exposed";
+    readonly unsubscribeEvent: "exposed";
+    readonly subscribeAll: "exposed";
+    readonly triggerProactive: "exposed";
+    readonly triggerProactiveConversation: "exposed";
+    readonly createProactive: "exposed";
+    readonly triggerCampaign: "exposed";
+    readonly evaluateCampaignConditions: "exposed";
+    readonly closeCampaign: "exposed";
+    readonly setPageUrl: "exposed";
+    readonly triggerAnswer: "exposed";
+    readonly start: "exposed";
+    readonly stop: "exposed";
+    readonly triggerGreeting: "exposed";
+    readonly destroy: "exposed";
+    readonly requestNotifications: "exposed";
+    readonly handleNotification: "exposed";
+    readonly setTestModeBanner: "internal";
+    readonly acknowledgeSessionMirrorClear: "internal";
+    readonly deliverSessionMirrorSeed: "internal";
+};
+export declare const CONFIG_CLASSIFICATION: {
+    readonly handle: "fixed";
+    readonly cluster: "fixed";
+    readonly domain: "fixed";
+    readonly endpoint: "fixed";
+    readonly rolloutOverride: "fixed";
+    readonly parentElement: "embed_owned";
+    readonly align: "embed_owned";
+    readonly hideMask: "embed_owned";
+    readonly lazy: "embed_owned";
+    readonly toggleCallback: "embed_owned";
+    readonly onAdaEmbedLoaded: "embed_owned";
+    readonly deviceToken: "passthrough";
+    readonly language: "passthrough";
+    readonly greeting: "passthrough";
+    readonly skipGreeting: "passthrough";
+    readonly identityToken: "passthrough";
+    readonly appUrl: "passthrough";
+    readonly appUrlFallback: "passthrough";
+    readonly metaFields: "passthrough";
+    readonly allowMetaFieldsInReset: "passthrough";
+    readonly enableProgrammaticControl: "passthrough";
+    readonly styles: "passthrough";
+    readonly branding: "passthrough";
+    readonly hideDefaultHeader: "passthrough";
+    readonly privateMode: "passthrough";
+    readonly testMode: "passthrough";
+    readonly headless: "passthrough";
+    readonly showFallbackOnTimeout: "passthrough";
+    readonly sensitiveMetaFields: "passthrough";
+    readonly eventCallbacks: "passthrough";
+    readonly crossWindowPersistence: "passthrough";
+    readonly theme: "passthrough";
+    readonly adaReadyCallback: "passthrough";
+    readonly chatterTokenCallback: "passthrough";
+    readonly conversationEndCallback: "passthrough";
+    readonly zdChatterAuthCallback: "passthrough";
+    readonly analyticsCallback: "passthrough";
+};
+export declare const FLOATING_CONFIG_CLASSIFICATION: {
+    readonly align: "passthrough";
+    readonly hideMask: "passthrough";
+    readonly toggleCallback: "passthrough";
+    readonly handle: "fixed";
+    readonly cluster: "fixed";
+    readonly domain: "fixed";
+    readonly endpoint: "fixed";
+    readonly rolloutOverride: "fixed";
+    readonly parentElement: "embed_owned";
+    readonly lazy: "embed_owned";
+    readonly onAdaEmbedLoaded: "embed_owned";
+    readonly deviceToken: "passthrough";
+    readonly language: "passthrough";
+    readonly greeting: "passthrough";
+    readonly skipGreeting: "passthrough";
+    readonly identityToken: "passthrough";
+    readonly appUrl: "passthrough";
+    readonly appUrlFallback: "passthrough";
+    readonly metaFields: "passthrough";
+    readonly allowMetaFieldsInReset: "passthrough";
+    readonly enableProgrammaticControl: "passthrough";
+    readonly styles: "passthrough";
+    readonly branding: "passthrough";
+    readonly hideDefaultHeader: "passthrough";
+    readonly privateMode: "passthrough";
+    readonly testMode: "passthrough";
+    readonly headless: "passthrough";
+    readonly showFallbackOnTimeout: "passthrough";
+    readonly sensitiveMetaFields: "passthrough";
+    readonly eventCallbacks: "passthrough";
+    readonly crossWindowPersistence: "passthrough";
+    readonly theme: "passthrough";
+    readonly adaReadyCallback: "passthrough";
+    readonly chatterTokenCallback: "passthrough";
+    readonly conversationEndCallback: "passthrough";
+    readonly zdChatterAuthCallback: "passthrough";
+    readonly analyticsCallback: "passthrough";
+};
+export declare const CONFIG_CLASSIFICATION_BY_MODE: {
+    readonly inline: {
+        readonly handle: "fixed";
+        readonly cluster: "fixed";
+        readonly domain: "fixed";
+        readonly endpoint: "fixed";
+        readonly rolloutOverride: "fixed";
+        readonly parentElement: "embed_owned";
+        readonly align: "embed_owned";
+        readonly hideMask: "embed_owned";
+        readonly lazy: "embed_owned";
+        readonly toggleCallback: "embed_owned";
+        readonly onAdaEmbedLoaded: "embed_owned";
+        readonly deviceToken: "passthrough";
+        readonly language: "passthrough";
+        readonly greeting: "passthrough";
+        readonly skipGreeting: "passthrough";
+        readonly identityToken: "passthrough";
+        readonly appUrl: "passthrough";
+        readonly appUrlFallback: "passthrough";
+        readonly metaFields: "passthrough";
+        readonly allowMetaFieldsInReset: "passthrough";
+        readonly enableProgrammaticControl: "passthrough";
+        readonly styles: "passthrough";
+        readonly branding: "passthrough";
+        readonly hideDefaultHeader: "passthrough";
+        readonly privateMode: "passthrough";
+        readonly testMode: "passthrough";
+        readonly headless: "passthrough";
+        readonly showFallbackOnTimeout: "passthrough";
+        readonly sensitiveMetaFields: "passthrough";
+        readonly eventCallbacks: "passthrough";
+        readonly crossWindowPersistence: "passthrough";
+        readonly theme: "passthrough";
+        readonly adaReadyCallback: "passthrough";
+        readonly chatterTokenCallback: "passthrough";
+        readonly conversationEndCallback: "passthrough";
+        readonly zdChatterAuthCallback: "passthrough";
+        readonly analyticsCallback: "passthrough";
+    };
+    readonly floating: {
+        readonly align: "passthrough";
+        readonly hideMask: "passthrough";
+        readonly toggleCallback: "passthrough";
+        readonly handle: "fixed";
+        readonly cluster: "fixed";
+        readonly domain: "fixed";
+        readonly endpoint: "fixed";
+        readonly rolloutOverride: "fixed";
+        readonly parentElement: "embed_owned";
+        readonly lazy: "embed_owned";
+        readonly onAdaEmbedLoaded: "embed_owned";
+        readonly deviceToken: "passthrough";
+        readonly language: "passthrough";
+        readonly greeting: "passthrough";
+        readonly skipGreeting: "passthrough";
+        readonly identityToken: "passthrough";
+        readonly appUrl: "passthrough";
+        readonly appUrlFallback: "passthrough";
+        readonly metaFields: "passthrough";
+        readonly allowMetaFieldsInReset: "passthrough";
+        readonly enableProgrammaticControl: "passthrough";
+        readonly styles: "passthrough";
+        readonly branding: "passthrough";
+        readonly hideDefaultHeader: "passthrough";
+        readonly privateMode: "passthrough";
+        readonly testMode: "passthrough";
+        readonly headless: "passthrough";
+        readonly showFallbackOnTimeout: "passthrough";
+        readonly sensitiveMetaFields: "passthrough";
+        readonly eventCallbacks: "passthrough";
+        readonly crossWindowPersistence: "passthrough";
+        readonly theme: "passthrough";
+        readonly adaReadyCallback: "passthrough";
+        readonly chatterTokenCallback: "passthrough";
+        readonly conversationEndCallback: "passthrough";
+        readonly zdChatterAuthCallback: "passthrough";
+        readonly analyticsCallback: "passthrough";
+    };
+};
+export declare const WINDOW_EVENTS: readonly ["ada:error", "ada:integration:event"];
+export declare const ENVELOPE_KINDS: readonly ["connect", "connected", "already_connected", "connect_rejected", "layout.clip", "layout.applied", "layout.reset", "layout.heartbeat", "host.viewport", "host.scroll_lock", "host.escape_listen", "host.key", "host.resume", "host.navigate", "host.navigate_result", "host.notification_state", "host.notification", "host.notification_click", "request", "response", "callback", "callback_result", "release_callbacks", "release_request", "disconnect", "window_event"];
+export declare const ERROR_CODES: readonly ["unsupported", "invalid_params", "not_started", "disconnected", "timeout", "limit_exceeded", "sdk_error", "internal"];
+export declare const ID_LENGTH: {
+    readonly min: 1;
+    readonly max: 128;
+};
+export declare const RANDOM_ID_PATTERN = "^[A-Za-z0-9_-]{22}$";
+export declare const LIMITS: {
+    readonly depth: 32;
+    readonly nodes: 50000;
+    readonly bytes: number;
+    readonly registrations: 256;
+    readonly callbacks: 64;
+    readonly requests: 64;
+};
+export declare function callbackSlot(method: string, path: readonly (string | number)[], mode?: "inline" | "floating"): "event" | "beforeSend" | "zendesk" | undefined;
+export declare const EMBED_CAPABILITIES: readonly ["layout.v1", "notifications.v1", "navigate.v1"];
+export declare const CONNECT_FIELDS: readonly ["protocol", "v", "kind", "nonce", "pageUrl", "mode", "capabilities", "shimVersion"];

package/dist/embed-host/window-events.d.ts

@@ -0,0 +1,2 @@
+import type { EmbedWindowEvent } from "../embed-protocol.js";
+export declare function projectWindowEvent(name: string, value: unknown): Pick<EmbedWindowEvent, "name" | "detail"> | undefined;

package/dist/embed-host/wire.d.ts

@@ -0,0 +1,13 @@
+import type { EmbedError, EmbedErrorCode } from "../embed-protocol.js";
+export declare class ProtocolError extends Error {
+    readonly code: EmbedErrorCode;
+    constructor(code: EmbedErrorCode);
+}
+export declare function normalizeError(error: unknown): EmbedError;
+export declare function record(value: unknown): Record<string, unknown> | undefined;
+export declare function copyWire(value: unknown, marker?: (value: Record<string, unknown>, path: (string | number)[]) => unknown): unknown;
+export declare function envelope(kind: string, fields?: Record<string, unknown>): {
+    protocol: string;
+    v: number;
+    kind: string;
+};