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

package/dist/helpers/rollout.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Determine whether this visitor should see the chat widget for the given rollout percentage.
+ *
+ * - `rollout == null` → always show (100%)
+ * - Non-finite values (NaN, ±Infinity) → fail open (always show)
+ * - `rollout >= 1` → always show (100%)
+ * - `rollout <= 0` → never show (0%)
+ * - Otherwise, persist a stable draw in [0,1) for the visitor and show whenever
+ *   `draw < rollout`.
+ *
+ * Persisting the draw rather than the resulting group is what makes ramping monotone:
+ * raising the percentage only ever adds visitors and lowering it only ever removes them,
+ * so an already-assigned visitor is never re-bucketed by a percentage change. This mirrors
+ * the CDN version rollout in `scripts/sdk.js` (`selectAssignment` / `readStoredAssignment`).
+ *
+ * Fails open (returns true) if localStorage is unavailable (private browsing, storage blocked).
+ */
+export declare function isInRollout(handle: string, rollout: number | null | undefined): boolean;

package/dist/host-telemetry.d.ts

@@ -0,0 +1,15 @@
+import type { HostTelemetryContext, HostTelemetryPlatform, HostTelemetrySurface, HostTelemetryWebSdkOrigin } from "./shared-utils/index.js";
+export type { HostTelemetryContext, HostTelemetryMobileShell, HostTelemetryPlatform, HostTelemetrySurface, HostTelemetryWebSdkOrigin, } from "./shared-utils/index.js";
+export declare const HOST_TELEMETRY_QUERY_PARAM = "ada_host_telemetry";
+interface HostTelemetryCarrier {
+    hostTelemetry?: unknown;
+}
+export declare function normalizeHostTelemetry(value: unknown): HostTelemetryContext | undefined;
+export declare function attachInternalHostTelemetry<T extends object>(target: T, hostTelemetry?: HostTelemetryContext): T;
+export declare function readInternalHostTelemetry(value: unknown): HostTelemetryContext | undefined;
+export declare function stripPublicHostTelemetry<T extends object>(value: T): T;
+export declare function resolveHostTelemetry(carrier: HostTelemetryCarrier, { defaultOrigin, defaultSurface, defaultPlatform, }: {
+    defaultOrigin: HostTelemetryWebSdkOrigin;
+    defaultSurface: HostTelemetrySurface;
+    defaultPlatform?: HostTelemetryPlatform;
+}): HostTelemetryContext;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AdaMessagingClient } from "./client/client.js";
+export type { AdaMessagingClientConfig, AdaMessagingSettings, AdaMessagingStartOptions, AdaReadyCallbackParams, AdaSdkEventCallback, AdaSdkEventContext, AdaSdkEventKey, BeforeSend, ConversationInfo, Delegate, MetaFieldValue, PublicAgentInfo, PublicMessage, ResetParams, SendMessageResult, WindowInfo, } from "./client/client-types.js";
+export { type ChatHtmlConfig, resolveChatHtmlConfig, } from "./client/config-helpers.js";
+export type { AdaEmbedInterface, LoaderQueueAction, LoaderQueueActionOutcome, LoaderQueueActionOutcomeHandler, } from "./client/embed-interface.js";
+export { createAdaEmbedInterface, dispatchEmbedLoaderInitialActionQueue, dispatchEmbedLoaderInitialActionQueueForAtomicHandoff, } from "./client/embed-interface.js";
+export type { FrameMessage, FrameName, FrameToSdkEvents, SdkToFrameEvents, } from "./frame-channel/index.js";
+export { FrameChannel, FrameChild } from "./frame-channel/index.js";
+export { mountAdaWebViewRuntime, resolveAdaWebViewRuntimeAssets, } from "./mobile-webview-runtime.js";

package/dist/logger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Host-page logger.
+ *
+ * The SDK runs directly on the customer's page, so its console output lands in
+ * *their* root window console. Anything written unconditionally is noise a
+ * customer cannot turn off and cannot attribute.
+ *
+ * The gate is deliberately asymmetric:
+ *
+ * - **`warn` / `debug` are gated.** These fire on ordinary page loads —
+ *   deprecated-method calls, lifecycle diagnostics, a slow frame origin report.
+ *   None of them mean anything is broken, so production is silent by default.
+ * - **`error` is never gated.** The remaining `logger.error` sites are all
+ *   caught exceptions from host-supplied code — an `adaEmbed` subscriber, a
+ *   window callback, custom JS — plus frame origin mismatches. Because the throw
+ *   is caught, nothing else reports it: `setupSdkErrorReporter` only sees
+ *   `window.onerror`, `unhandledrejection`, and `ada:error`. Suppressing those
+ *   removed observability rather than noise.
+ *
+ * - **`dataLoss` is never gated.** This is the warning channel for a host value
+ *   the SDK accepted but then had to drop or truncate. A production integration
+ *   must not need a debug opt-in to learn that its configuration changed.
+ *
+ *   Timeout and queued-loader-rejection sites are deliberately `warn`, not
+ *   `error`, even though they signal a failure: they fire on slow connections
+ *   where nothing is actually broken, so an ungated `error` there would be the
+ *   timing-dependent noise this gate exists to remove. Demoting them costs Ada
+ *   no telemetry either way — the SDK has no Sentry or Datadog on the host page,
+ *   so a host-page `console.error` was only ever read by the integrator.
+ *
+ * Enabling the gated levels on a live site, in order of precedence:
+ *   1. `window.adaSettings.debug: true` (host page)
+ *   2. `localStorage.setItem("ada.debug", "1")` — the support path, usable from
+ *      devtools on a page you cannot edit
+ *
+ * `dev` and `test` builds emit every level with no opt-in.
+ */
+/**
+ * Read the host-page opt-in. Never throws — `window.adaSettings` can be a
+ * throwing getter and storage access is denied outright in some embed contexts.
+ *
+ * Deliberately not memoized: a host or support engineer may set the flag after
+ * the SDK has already logged something, and a cached `false` would suppress
+ * every later diagnostic until reload. Both reads are cheap, and they only run
+ * on a gated call that is about to be dropped anyway.
+ */
+export declare function readDebugOptIn(): boolean;
+/**
+ * Whether a gated level should emit. Takes the mode explicitly so it is
+ * testable — `__RUNTIME_MODE__` is a compile-time constant and cannot be
+ * stubbed.
+ */
+export declare function resolveEnabled(mode: string, optIn?: () => boolean): boolean;
+export declare const logger: {
+    debug: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    dataLoss: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};

package/dist/mobile-webview-runtime.d.ts

@@ -0,0 +1,122 @@
+import type { MetaFieldValue } from "./client/client-types.js";
+import type { HostTelemetryContext } from "./host-telemetry.js";
+/** Which web runtime the webview mounts: the Messaging SDK or legacy embed2/Chat. */
+export type AdaWebSdkMode = "messaging" | "legacy";
+/**
+ * Configuration for {@link mountAdaWebViewRuntime}, assembled by
+ * `webview.html` from its URL query parameters on behalf of the native
+ * iOS/Android/React Native wrappers.
+ *
+ * Sensitive values are never carried here or in query parameters: native
+ * hosts inject `identityToken` (and `appUrl`) at
+ * document-start as the one-shot `window.__ADA_WEBVIEW_CONFIG__` global,
+ * which the runtime reads and deletes during mount — see
+ * {@link AdaInjectedWebViewConfig}.
+ */
+export interface AdaWebViewRuntimeConfig {
+    /** Bot handle to mount. Required; surrounding whitespace is trimmed and an empty handle rejects the mount. */
+    handle: string;
+    /** Ada cluster host, e.g. `"ada.support"`, `"ada-dev2.support"`, or `"localhost"`. Invalid values fall back to the production assets. */
+    cluster?: string;
+    /** ISO language code forwarded to the web SDK. */
+    language?: string;
+    /** Greeting response ID forwarded to the web SDK. */
+    greeting?: string;
+    /** Suppress the default launcher/intro/drawer UI so the native host renders its own (Messaging mode). */
+    headless?: boolean;
+    /** Unlock the transcript-bearing programmatic APIs and gated `ada:message:*` events. */
+    enableProgrammaticControl?: boolean;
+    /** Initial non-sensitive meta fields for the chatter. */
+    metaFields?: Record<string, MetaFieldValue>;
+    /** Theme style overrides passed through to the web SDK, which applies its supported theme keys only (currently `tintColor`). */
+    styles?: Record<string, string>;
+    /** Internal host attribution metadata; defaults derive per web SDK mode with surface `"mobile"`. */
+    hostTelemetry?: HostTelemetryContext;
+    /** Element the runtime mounts into (`webview.html` supplies `#ada-root`). */
+    parentElement: HTMLElement;
+    /** Native bridge sink; receives `sdk.ready`, `sdk.event`, `sdk.state.cache`, and `sdk.error` messages. */
+    postToNative?: (message: Record<string, unknown>) => void;
+    /** Which web runtime to mount: `"messaging"` (default) or `"legacy"`. */
+    webSdk?: AdaWebSdkMode;
+}
+/**
+ * Shape of the one-shot `window.__ADA_WEBVIEW_CONFIG__` global that native
+ * hosts inject at document-start. String values only; unknown keys are
+ * ignored. {@link mountAdaWebViewRuntime} reads the global exactly once and
+ * deletes it immediately, so the identity token never persists on `window`
+ * and never appears in a URL. Applied to the Messaging runtime only — the
+ * legacy web SDK has no identity-token or custom-app-URL support.
+ */
+export interface AdaInjectedWebViewConfig {
+    /** One-shot Messaging identity token, merged into `adaEmbed.start()` as `identityToken`. */
+    identityToken?: string;
+    /** Custom app frame URL, merged into `adaEmbed.start()` as `appUrl`. Ada must allowlist the app origin for the handle. */
+    appUrl?: string;
+}
+/**
+ * sessionStorage key recording that an injected `identityToken` was consumed
+ * by a mount in this webview session. Native document-start scripts re-run on
+ * every main-frame document, so they check this marker and withhold the
+ * (spent, single-use) token from later documents — per the identity contract,
+ * an exchange attempt consumes the token even when it fails downstream, and
+ * re-supplying it forces the runtime through the failed-exchange storage
+ * wipe. The stored value is the non-sensitive `injectionId` the native host
+ * paired with the token (or `"1"` for hosts that sent none), so a NEW token
+ * (new id) still gets delivered after an old one was consumed. Never holds
+ * token material.
+ */
+export declare const IDENTITY_TOKEN_CONSUMED_STORAGE_KEY = "__ada_identity_token_consumed__";
+type AdaWebViewRuntimeAssetConfig = Pick<AdaWebViewRuntimeConfig, "cluster" | "greeting" | "handle" | "hostTelemetry" | "language" | "metaFields" | "webSdk">;
+export interface ResolvedAdaWebViewRuntimeAssets {
+    webSdk: AdaWebSdkMode;
+    scriptUrl?: string;
+    iframeUrl?: string;
+    metadataUrl?: string;
+    legacyRuntime?: "embed2" | "chat-iframe";
+}
+interface LegacyAdaEmbed {
+    start?: (config: Record<string, unknown>) => unknown;
+    reset?: (payload?: unknown) => unknown;
+    setLanguage?: (language: string) => unknown;
+    sendMessage?: (body: string) => unknown;
+    setMetaFields?: (fields: Record<string, unknown>) => unknown;
+    setSensitiveMetaFields?: (fields: Record<string, unknown>) => unknown;
+    setDeviceToken?: (token: string) => unknown;
+    deleteHistory?: () => unknown;
+    subscribeAll?: (callback: (key: string, payload: unknown) => void) => (() => void) | undefined;
+    subscribeEvent?: (key: string, callback: (payload: unknown) => void) => number | Promise<number>;
+}
+declare global {
+    interface Window {
+        __ADA_BRIDGE_DISPATCH__?: (jsonCommand: string) => void;
+        __ADA_WEBVIEW_CONFIG__?: unknown;
+        __ADA_ZD_AUTH_RESOLVER__?: (token: string | null) => void;
+        adaEmbed?: LegacyAdaEmbed;
+        adaSettings?: Record<string, unknown>;
+    }
+}
+/**
+ * Resolve which web runtime assets a native wrapper should load for the given
+ * webview config: the Messaging SDK bundle URL for the requested cluster, the
+ * static embed2 script for non-local legacy, or the local Chat iframe assets
+ * for localhost legacy development.
+ */
+export declare function resolveAdaWebViewRuntimeAssets(config: AdaWebViewRuntimeAssetConfig): ResolvedAdaWebViewRuntimeAssets;
+/**
+ * Mount the Ada web runtime inside a native mobile webview (iOS, Android,
+ * React Native). Loads the Messaging SDK (or the legacy embed2/Chat runtime),
+ * starts it with the supplied config, and wires the native bridge:
+ * `window.__ADA_BRIDGE_DISPATCH__` for native → SDK commands and
+ * `config.postToNative` for SDK → native `sdk.ready`/`sdk.event`/
+ * `sdk.state.cache`/`sdk.error` messages.
+ *
+ * Consumes the one-shot `window.__ADA_WEBVIEW_CONFIG__` global
+ * ({@link AdaInjectedWebViewConfig}) exactly once per call — the global is
+ * deleted immediately after the read, even when the mount fails. In Messaging
+ * mode its `identityToken` and `appUrl` merge into the `adaEmbed.start()`
+ * config; the legacy runtime does not support them and injected values are
+ * reported to native as ignored. An `identityToken` supplied as a query
+ * parameter is never accepted and is reported via `sdk.error`.
+ */
+export declare function mountAdaWebViewRuntime(config: AdaWebViewRuntimeConfig): Promise<void>;
+export {};

package/dist/npm/build-info.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Git commit SHA of the monorepo commit this npm version was published from.
+ * The CDN pipeline deploys each main commit's runtime under an immutable
+ * SHA root, so this value names the CDN build associated with this npm
+ * version. Pass it as the `pinBuildSha` loader option to load exactly that
+ * runtime build — not recommended for production (see the README).
+ *
+ * In the repository, and in any locally built copy, the value is the
+ * unstamped 40-zero placeholder ({@link isCdnBuildShaStamped} returns
+ * `false`); only published tarballs carry a real SHA.
+ */
+export declare const CDN_BUILD_SHA: string;
+/**
+ * Whether `sha` (default {@link CDN_BUILD_SHA}) is a stamped full git commit
+ * SHA rather than the unstamped repo placeholder.
+ */
+export declare function isCdnBuildShaStamped(sha?: string): boolean;

package/dist/npm/build-info.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Git commit SHA of the monorepo commit this npm version was published from.
+ * The CDN pipeline deploys each main commit's runtime under an immutable
+ * SHA root, so this value names the CDN build associated with this npm
+ * version. Pass it as the `pinBuildSha` loader option to load exactly that
+ * runtime build — not recommended for production (see the README).
+ *
+ * In the repository, and in any locally built copy, the value is the
+ * unstamped 40-zero placeholder ({@link isCdnBuildShaStamped} returns
+ * `false`); only published tarballs carry a real SHA.
+ */
+export declare const CDN_BUILD_SHA: string;
+/**
+ * Whether `sha` (default {@link CDN_BUILD_SHA}) is a stamped full git commit
+ * SHA rather than the unstamped repo placeholder.
+ */
+export declare function isCdnBuildShaStamped(sha?: string): boolean;

package/dist/npm/index.cjs

@@ -0,0 +1,276 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/npm/build-info.ts
+var GIT_SHA_PATTERN = /^[0-9a-f]{40}$/;
+var UNSTAMPED_SHA_PATTERN = /^0{40}$/;
+/**
+* Git commit SHA of the monorepo commit this npm version was published from.
+* The CDN pipeline deploys each main commit's runtime under an immutable
+* SHA root, so this value names the CDN build associated with this npm
+* version. Pass it as the `pinBuildSha` loader option to load exactly that
+* runtime build — not recommended for production (see the README).
+*
+* In the repository, and in any locally built copy, the value is the
+* unstamped 40-zero placeholder ({@link isCdnBuildShaStamped} returns
+* `false`); only published tarballs carry a real SHA.
+*/
+var CDN_BUILD_SHA = "0000000000000000000000000000000000000000";
+/**
+* Whether `sha` (default {@link CDN_BUILD_SHA}) is a stamped full git commit
+* SHA rather than the unstamped repo placeholder.
+*/
+function isCdnBuildShaStamped(sha = CDN_BUILD_SHA) {
+	const normalized = sha.trim().toLowerCase();
+	return GIT_SHA_PATTERN.test(normalized) && !UNSTAMPED_SHA_PATTERN.test(normalized);
+}
+//#endregion
+//#region src/client/embed-lifecycle.ts
+/**
+* Lifecycle channel between `createAdaEmbedInterface` and the npm loader's
+* memo: a non-enumerable getter over closure state, so the loader never
+* mutates the public surface and `Object.freeze` on the facade still works.
+* `Symbol.for` because the loader and the CDN runtime are separate builds;
+* a runtime that predates the getter yields `undefined` — degrade gracefully.
+*/
+var EMBED_LIFECYCLE_STOPPED = Symbol.for("ada-cx/messaging-sdk/embed-stopped");
+/** Read the facade's stopped flag; `undefined` when the runtime predates it. */
+function readEmbedStoppedFlag(ada) {
+	const value = ada[EMBED_LIFECYCLE_STOPPED];
+	return typeof value === "boolean" ? value : void 0;
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.122.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.122.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.122.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.122.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
+//#region src/npm/loader.ts
+/**
+* Production CDN root the loader resolves the SDK bootstrap from when no
+* `cdnBase` override is given. The npm package never pins a runtime version;
+* the bootstrap at this root resolves the current rollout at load time.
+*/
+var DEFAULT_MESSAGING_CDN_BASE = "https://messaging-assets.ada.support/";
+var SDK_BOOTSTRAP_FILENAME = "sdk.js";
+var PINNED_SDK_ENTRY_PATH = "sdk/index.js";
+var PINNED_BUILD_SHA_PATTERN = /^[0-9a-f]{40}$/;
+var UNSTAMPED_BUILD_SHA_PATTERN = /^0{40}$/;
+/** Typed failure raised by {@link loadMessagingSdk} and {@link loadAdaMessaging}. */
+var MessagingSdkLoadError = class extends Error {
+	constructor(message, code, cause) {
+		super(message);
+		_defineProperty(this, "code", void 0);
+		this.name = "MessagingSdkLoadError";
+		this.code = code;
+		if (cause !== void 0) this.cause = cause;
+	}
+};
+var defaultImportModule = (url) => import(
+	/* webpackIgnore: true */
+	/* @vite-ignore */
+	url
+);
+var inFlightByImporter = /* @__PURE__ */ new WeakMap();
+var LOOPBACK_HOSTS = new Set([
+	"localhost",
+	"127.0.0.1",
+	"[::1]",
+	"::1"
+]);
+function isLoopbackHostname(hostname) {
+	const normalized = hostname.trim().toLowerCase();
+	return LOOPBACK_HOSTS.has(normalized) || normalized.endsWith(".localhost");
+}
+function resolvePinnedBuildSha(pinBuildSha) {
+	const sha = pinBuildSha.trim().toLowerCase();
+	if (!PINNED_BUILD_SHA_PATTERN.test(sha)) throw new MessagingSdkLoadError(`The pinBuildSha option must be a full 40-character hex git SHA: "${pinBuildSha}".`, "invalid_build_sha");
+	if (UNSTAMPED_BUILD_SHA_PATTERN.test(sha)) throw new MessagingSdkLoadError("The pinBuildSha option is the unstamped CDN_BUILD_SHA placeholder. Only the published npm package carries a stamped SHA; a repository or local build cannot pin a CDN build.", "unstamped_build_sha");
+	return sha;
+}
+/**
+* The runtime this URL serves carries the SDK's security logic (endpoint
+* validation, session handling, the origin checks), so a cleartext transport
+* would let an on-path attacker replace it wholesale: `https:` is required,
+* with a loopback-only `http:` exception for local development.
+*/
+function resolveSdkBootstrapUrl(cdnBase, pinBuildSha) {
+	const base = (cdnBase ?? "https://messaging-assets.ada.support/").trim();
+	const normalizedBase = base.endsWith("/") ? base : `${base}/`;
+	const entryPath = pinBuildSha === void 0 ? SDK_BOOTSTRAP_FILENAME : `${resolvePinnedBuildSha(pinBuildSha)}/${PINNED_SDK_ENTRY_PATH}`;
+	let url;
+	try {
+		url = new URL(entryPath, normalizedBase);
+	} catch (cause) {
+		throw new MessagingSdkLoadError(`The cdnBase option is not a valid URL: "${base}".`, "invalid_cdn_base", cause);
+	}
+	const isHttps = url.protocol === "https:";
+	const isLoopbackHttp = url.protocol === "http:" && isLoopbackHostname(url.hostname);
+	if (!isHttps && !isLoopbackHttp) throw new MessagingSdkLoadError(`The cdnBase option must use https (plain http is allowed only for loopback hosts): "${base}".`, "invalid_cdn_base");
+	return url.toString();
+}
+function isMessagingSdkModule(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	return typeof candidate.createAdaEmbedInterface === "function" && typeof candidate.AdaMessagingClient === "function";
+}
+async function importSdkModule(url, importModule) {
+	let loaded;
+	try {
+		loaded = await importModule(url);
+	} catch (cause) {
+		throw new MessagingSdkLoadError(`The Ada Messaging SDK failed to load from ${url}.`, "sdk_import_failed", cause);
+	}
+	if (!isMessagingSdkModule(loaded)) throw new MessagingSdkLoadError(`The module at ${url} does not expose the Ada Messaging SDK interface.`, "sdk_module_invalid");
+	return loaded;
+}
+/**
+* Load the Ada Messaging SDK module from Ada's CDN.
+*
+* The returned promise is memoized per resolved URL: concurrent and repeated
+* calls share one in-flight import. A failed load clears the memo so a later
+* call retries. Rejections are always {@link MessagingSdkLoadError}.
+*
+* @example
+* const { createAdaEmbedInterface } = await loadMessagingSdk();
+*/
+function loadMessagingSdk(options = {}) {
+	const importModule = options.importModule ?? defaultImportModule;
+	let url;
+	try {
+		url = resolveSdkBootstrapUrl(options.cdnBase, options.pinBuildSha);
+	} catch (error) {
+		return Promise.reject(error);
+	}
+	let inFlight = inFlightByImporter.get(importModule);
+	if (!inFlight) {
+		inFlight = /* @__PURE__ */ new Map();
+		inFlightByImporter.set(importModule, inFlight);
+	}
+	const existing = inFlight.get(url);
+	if (existing) return existing;
+	const cache = inFlight;
+	const pending = importSdkModule(url, importModule);
+	cache.set(url, pending);
+	pending.catch(() => {
+		if (cache.get(url) === pending) cache.delete(url);
+	});
+	return pending;
+}
+var startedInterfaceByImporter = /* @__PURE__ */ new WeakMap();
+function warnHost(message) {
+	try {
+		console.warn(`[Ada] ${message}`);
+	} catch {}
+}
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+function settingsEqual(a, b) {
+	if (Object.is(a, b)) return true;
+	if (typeof a === "function" && typeof b === "function") return true;
+	if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((item, index) => settingsEqual(item, b[index]));
+	if (isPlainObject(a) && isPlainObject(b)) {
+		const aKeys = Object.keys(a);
+		const bKeys = new Set(Object.keys(b));
+		return aKeys.length === bKeys.size && aKeys.every((key) => bKeys.has(key) && settingsEqual(a[key], b[key]));
+	}
+	return false;
+}
+function isInterfaceStopped(ada) {
+	return readEmbedStoppedFlag(ada) === true;
+}
+async function startAdaMessaging(settings, options) {
+	const ada = (await loadMessagingSdk(options)).createAdaEmbedInterface();
+	await ada.start(settings);
+	return ada;
+}
+/**
+* Load the SDK, create the messaging interface, and start the widget —
+* the npm-first equivalent of the script-tag + `window.adaSettings` setup.
+*
+* One widget per page: the returned promise is memoized, so repeated and
+* concurrent calls resolve to the same started interface and the first
+* call's settings win. A failed load or start clears the memo so a later
+* call retries. Manage the running widget through the returned interface:
+* `stop()` tears it down and a later `start(settings)` on the same interface
+* runs again. Calling {@link loadAdaMessaging} after `stop()` returns the
+* same stopped interface without restarting it. Both memo outcomes log a
+* console warning: ignored differing settings, and a resolved interface
+* whose widget was stopped.
+*
+* Never assigns the interface to `window` or any other global: the returned
+* reference is the only handle, so hold it in module scope. A reference in
+* module scope is reachable only by your own code, never by other scripts on
+* the page.
+*
+* @example
+* // module scope: your code keeps the only reference
+* const ada = await loadAdaMessaging({
+*   handle: "my-bot",
+*   enableProgrammaticControl: true,
+* });
+* await ada.sendMessage("Hello");
+*/
+function loadAdaMessaging(settings, options = {}) {
+	const importModule = options.importModule ?? defaultImportModule;
+	const existing = startedInterfaceByImporter.get(importModule);
+	if (existing) {
+		if (!settingsEqual(settings, existing.settings)) warnHost("loadAdaMessaging() was already called: the new settings are ignored and the existing interface is returned. To apply new settings, call stop() then start(settings) on it.");
+		if (existing.ada && isInterfaceStopped(existing.ada)) warnHost("loadAdaMessaging() resolved an interface whose widget was stopped and never restarts it. Call start(settings) on it to run the widget again.");
+		return existing.promise;
+	}
+	const memo = {
+		promise: startAdaMessaging(settings, options),
+		settings
+	};
+	startedInterfaceByImporter.set(importModule, memo);
+	memo.promise.then((ada) => {
+		memo.ada = ada;
+	}, () => {
+		if (startedInterfaceByImporter.get(importModule) === memo) startedInterfaceByImporter.delete(importModule);
+	});
+	return memo.promise;
+}
+//#endregion
+exports.CDN_BUILD_SHA = CDN_BUILD_SHA;
+exports.DEFAULT_MESSAGING_CDN_BASE = DEFAULT_MESSAGING_CDN_BASE;
+exports.MessagingSdkLoadError = MessagingSdkLoadError;
+exports.isCdnBuildShaStamped = isCdnBuildShaStamped;
+exports.loadAdaMessaging = loadAdaMessaging;
+exports.loadMessagingSdk = loadMessagingSdk;
+
+//# sourceMappingURL=index.cjs.map

package/dist/npm/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/npm/build-info.ts","../../src/client/embed-lifecycle.ts","../../src/npm/loader.ts"],"sourcesContent":["// The repo copy carries the 40-zero placeholder; the publish workflow\n// (.github/workflows/messaging-publish-web-packages.yml) stamps the real\n// commit SHA into the built output via scripts/stamp-cdn-build-sha.mjs and\n// verifies the packed tarball before `npm publish`. Keep the placeholder as\n// a single 40-zero string literal: the stamp is a same-length text\n// replacement, so source maps stay valid.\nconst GIT_SHA_PATTERN = /^[0-9a-f]{40}$/;\nconst UNSTAMPED_SHA_PATTERN = /^0{40}$/;\n\n/**\n * Git commit SHA of the monorepo commit this npm version was published from.\n * The CDN pipeline deploys each main commit's runtime under an immutable\n * SHA root, so this value names the CDN build associated with this npm\n * version. Pass it as the `pinBuildSha` loader option to load exactly that\n * runtime build — not recommended for production (see the README).\n *\n * In the repository, and in any locally built copy, the value is the\n * unstamped 40-zero placeholder ({@link isCdnBuildShaStamped} returns\n * `false`); only published tarballs carry a real SHA.\n */\nexport const CDN_BUILD_SHA: string = \"0000000000000000000000000000000000000000\";\n\n/**\n * Whether `sha` (default {@link CDN_BUILD_SHA}) is a stamped full git commit\n * SHA rather than the unstamped repo placeholder.\n */\nexport function isCdnBuildShaStamped(sha: string = CDN_BUILD_SHA): boolean {\n\tconst normalized = sha.trim().toLowerCase();\n\treturn (\n\t\tGIT_SHA_PATTERN.test(normalized) && !UNSTAMPED_SHA_PATTERN.test(normalized)\n\t);\n}\n","/**\n * Lifecycle channel between `createAdaEmbedInterface` and the npm loader's\n * memo: a non-enumerable getter over closure state, so the loader never\n * mutates the public surface and `Object.freeze` on the facade still works.\n * `Symbol.for` because the loader and the CDN runtime are separate builds;\n * a runtime that predates the getter yields `undefined` — degrade gracefully.\n */\nexport const EMBED_LIFECYCLE_STOPPED = Symbol.for(\n\t\"ada-cx/messaging-sdk/embed-stopped\",\n);\n\n/** Read the facade's stopped flag; `undefined` when the runtime predates it. */\nexport function readEmbedStoppedFlag(ada: object): boolean | undefined {\n\tconst value = (ada as Record<symbol, unknown>)[EMBED_LIFECYCLE_STOPPED];\n\treturn typeof value === \"boolean\" ? value : undefined;\n}\n\n/** Define the getter at facade creation time, before any host freeze. */\nexport function defineEmbedStoppedFlag(\n\tada: object,\n\treadStopped: () => boolean,\n): void {\n\tObject.defineProperty(ada, EMBED_LIFECYCLE_STOPPED, {\n\t\tget: readStopped,\n\t\tenumerable: false,\n\t\tconfigurable: false,\n\t});\n}\n","import type { AdaMessagingClient } from \"../client/client\";\nimport type { AdaMessagingStartOptions } from \"../client/client-types\";\nimport type {\n\tAdaEmbedInterface,\n\tcreateAdaEmbedInterface,\n\tdispatchEmbedLoaderInitialActionQueue,\n\tdispatchEmbedLoaderInitialActionQueueForAtomicHandoff,\n} from \"../client/embed-interface\";\nimport { readEmbedStoppedFlag } from \"../client/embed-lifecycle\";\nimport type {\n\tmountAdaWebViewRuntime,\n\tresolveAdaWebViewRuntimeAssets,\n} from \"../mobile-webview-runtime\";\n\n/**\n * Production CDN root the loader resolves the SDK bootstrap from when no\n * `cdnBase` override is given. The npm package never pins a runtime version;\n * the bootstrap at this root resolves the current rollout at load time.\n */\nexport const DEFAULT_MESSAGING_CDN_BASE =\n\t\"https://messaging-assets.ada.support/\";\n\nconst SDK_BOOTSTRAP_FILENAME = \"sdk.js\";\n\n// The CDN pipeline deploys each main commit's runtime as an immutable\n// SHA-rooted entry (`<cdnBase>/<sha>/sdk/index.js`); the mutable `sdk.js`\n// bootstrap resolves the current rollout to one of those roots at load time.\n// A pin bypasses the bootstrap and imports one root directly.\nconst PINNED_SDK_ENTRY_PATH = \"sdk/index.js\";\n\n// Strict on purpose: the pin is interpolated into a CDN path, so only a full\n// lowercase 40-hex git SHA may pass (mirrors scripts/sdk.js's\n// VERSION_OVERRIDE_PATTERN security boundary, minus the short-SHA and pr-N\n// forms — the npm surface pins exactly what CDN_BUILD_SHA carries).\nconst PINNED_BUILD_SHA_PATTERN = /^[0-9a-f]{40}$/;\nconst UNSTAMPED_BUILD_SHA_PATTERN = /^0{40}$/;\n\n/** Why a {@link MessagingSdkLoadError} was raised. */\nexport type MessagingSdkLoadErrorCode =\n\t/**\n\t * The `cdnBase` option is not a valid `https:` URL (plain `http:` is\n\t * allowed only for loopback hosts).\n\t */\n\t| \"invalid_cdn_base\"\n\t/** The `pinBuildSha` option is not a full 40-character hex git SHA. */\n\t| \"invalid_build_sha\"\n\t/**\n\t * The `pinBuildSha` option is the unstamped 40-zero placeholder: this\n\t * copy of the package was built from the repository, not published, so\n\t * its `CDN_BUILD_SHA` names no CDN build.\n\t */\n\t| \"unstamped_build_sha\"\n\t/** The dynamic import of the CDN bootstrap failed (network, CSP, 404). */\n\t| \"sdk_import_failed\"\n\t/** The imported module does not expose the Ada Messaging SDK surface. */\n\t| \"sdk_module_invalid\";\n\n/** Typed failure raised by {@link loadMessagingSdk} and {@link loadAdaMessaging}. */\nexport class MessagingSdkLoadError extends Error {\n\treadonly code: MessagingSdkLoadErrorCode;\n\n\tconstructor(\n\t\tmessage: string,\n\t\tcode: MessagingSdkLoadErrorCode,\n\t\tcause?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MessagingSdkLoadError\";\n\t\tthis.code = code;\n\t\tif (cause !== undefined) {\n\t\t\tthis.cause = cause;\n\t\t}\n\t}\n}\n\n/**\n * The programmatic messaging interface {@link loadAdaMessaging} resolves. An\n * alias of the runtime's `AdaEmbedInterface`, which keeps that name because it\n * is also the legacy `window.adaEmbed` compat facade.\n */\nexport type AdaMessagingInterface = AdaEmbedInterface;\n\n/**\n * The public surface of the CDN-resolved SDK module, as loaded from\n * `<cdnBase>/sdk.js`. Types only — the implementation always comes from the\n * CDN at load time and is never part of this npm package.\n */\nexport interface MessagingSdkModule {\n\tAdaMessagingClient: typeof AdaMessagingClient;\n\tcreateAdaEmbedInterface: typeof createAdaEmbedInterface;\n\tdispatchEmbedLoaderInitialActionQueue: typeof dispatchEmbedLoaderInitialActionQueue;\n\tdispatchEmbedLoaderInitialActionQueueForAtomicHandoff: typeof dispatchEmbedLoaderInitialActionQueueForAtomicHandoff;\n\tmountAdaWebViewRuntime: typeof mountAdaWebViewRuntime;\n\tresolveAdaWebViewRuntimeAssets: typeof resolveAdaWebViewRuntimeAssets;\n}\n\ntype ImportSdkModule = (url: string) => Promise<unknown>;\n\nexport interface LoadMessagingSdkOptions {\n\t/**\n\t * CDN root to resolve `sdk.js` from. Must be an `https:` URL; plain\n\t * `http:` is accepted only for loopback hosts (`localhost`, `127.0.0.1`,\n\t * `[::1]`, `*.localhost`) during local development. Defaults to the\n\t * production root ({@link DEFAULT_MESSAGING_CDN_BASE}). Override it with\n\t * the Ada-provided asset host for a staging validation window only;\n\t * production pages must keep the default.\n\t */\n\tcdnBase?: string;\n\t/**\n\t * Full 40-character git commit SHA of a deployed CDN build. When set, the\n\t * loader skips the rollout bootstrap and imports that build's immutable\n\t * entry (`<cdnBase>/<sha>/sdk/index.js`) directly. Pass the package's\n\t * `CDN_BUILD_SHA` export to pin the build associated with this npm\n\t * version. NOT recommended for production: a pinned runtime misses Ada's\n\t * fixes and rollouts, and may predate server contract changes. Composes\n\t * with `cdnBase` for staged validation.\n\t */\n\tpinBuildSha?: string;\n\t/**\n\t * Import seam for unit tests. Defaults to a native dynamic `import()` of\n\t * the resolved bootstrap URL.\n\t */\n\timportModule?: ImportSdkModule;\n}\n\n// Both annotations are load-bearing: bundlers rewrite bare dynamic imports,\n// and this specifier must reach the browser untouched so the runtime always\n// resolves from Ada's CDN. The npm build for this entry is unminified so the\n// annotations survive into the published output.\nconst defaultImportModule: ImportSdkModule = (url) =>\n\timport(/* webpackIgnore: true */ /* @vite-ignore */ url);\n\n// Keyed by import seam so production memoizes on the module-level default\n// while each injected test seam gets an isolated cache.\nconst inFlightByImporter = new WeakMap<\n\tImportSdkModule,\n\tMap<string, Promise<MessagingSdkModule>>\n>();\n\n// Mirrors the loopback semantics of the shared `isLoopbackHost` /\n// `validateMessagingEndpoint` (shared/utils/src/url.ts) and the bridge\n// loader's copy (packages/bridge/src/loader.ts). Inlined because the\n// published loader must stay dependency-free; keep the host set in sync.\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\", \"::1\"]);\n\nfunction isLoopbackHostname(hostname: string): boolean {\n\tconst normalized = hostname.trim().toLowerCase();\n\t// `*.localhost` resolves to the loopback interface and is \"potentially\n\t// trustworthy\" per the Secure Contexts spec; no production host ends in\n\t// `.localhost`.\n\treturn LOOPBACK_HOSTS.has(normalized) || normalized.endsWith(\".localhost\");\n}\n\nfunction resolvePinnedBuildSha(pinBuildSha: string): string {\n\tconst sha = pinBuildSha.trim().toLowerCase();\n\tif (!PINNED_BUILD_SHA_PATTERN.test(sha)) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t`The pinBuildSha option must be a full 40-character hex git SHA: \"${pinBuildSha}\".`,\n\t\t\t\"invalid_build_sha\",\n\t\t);\n\t}\n\tif (UNSTAMPED_BUILD_SHA_PATTERN.test(sha)) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t\"The pinBuildSha option is the unstamped CDN_BUILD_SHA placeholder. Only the published npm package carries a stamped SHA; a repository or local build cannot pin a CDN build.\",\n\t\t\t\"unstamped_build_sha\",\n\t\t);\n\t}\n\treturn sha;\n}\n\n/**\n * The runtime this URL serves carries the SDK's security logic (endpoint\n * validation, session handling, the origin checks), so a cleartext transport\n * would let an on-path attacker replace it wholesale: `https:` is required,\n * with a loopback-only `http:` exception for local development.\n */\nfunction resolveSdkBootstrapUrl(\n\tcdnBase: string | undefined,\n\tpinBuildSha: string | undefined,\n): string {\n\tconst base = (cdnBase ?? DEFAULT_MESSAGING_CDN_BASE).trim();\n\t// Resolving against a base without a trailing slash would drop its last\n\t// path segment, so normalize before building the bootstrap URL.\n\tconst normalizedBase = base.endsWith(\"/\") ? base : `${base}/`;\n\tconst entryPath =\n\t\tpinBuildSha === undefined\n\t\t\t? SDK_BOOTSTRAP_FILENAME\n\t\t\t: `${resolvePinnedBuildSha(pinBuildSha)}/${PINNED_SDK_ENTRY_PATH}`;\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(entryPath, normalizedBase);\n\t} catch (cause) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t`The cdnBase option is not a valid URL: \"${base}\".`,\n\t\t\t\"invalid_cdn_base\",\n\t\t\tcause,\n\t\t);\n\t}\n\tconst isHttps = url.protocol === \"https:\";\n\tconst isLoopbackHttp =\n\t\turl.protocol === \"http:\" && isLoopbackHostname(url.hostname);\n\tif (!isHttps && !isLoopbackHttp) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t`The cdnBase option must use https (plain http is allowed only for loopback hosts): \"${base}\".`,\n\t\t\t\"invalid_cdn_base\",\n\t\t);\n\t}\n\treturn url.toString();\n}\n\nfunction isMessagingSdkModule(value: unknown): value is MessagingSdkModule {\n\tif (typeof value !== \"object\" || value === null) {\n\t\treturn false;\n\t}\n\tconst candidate = value as Record<string, unknown>;\n\treturn (\n\t\ttypeof candidate.createAdaEmbedInterface === \"function\" &&\n\t\ttypeof candidate.AdaMessagingClient === \"function\"\n\t);\n}\n\nasync function importSdkModule(\n\turl: string,\n\timportModule: ImportSdkModule,\n): Promise<MessagingSdkModule> {\n\tlet loaded: unknown;\n\ttry {\n\t\tloaded = await importModule(url);\n\t} catch (cause) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t`The Ada Messaging SDK failed to load from ${url}.`,\n\t\t\t\"sdk_import_failed\",\n\t\t\tcause,\n\t\t);\n\t}\n\tif (!isMessagingSdkModule(loaded)) {\n\t\tthrow new MessagingSdkLoadError(\n\t\t\t`The module at ${url} does not expose the Ada Messaging SDK interface.`,\n\t\t\t\"sdk_module_invalid\",\n\t\t);\n\t}\n\treturn loaded;\n}\n\n/**\n * Load the Ada Messaging SDK module from Ada's CDN.\n *\n * The returned promise is memoized per resolved URL: concurrent and repeated\n * calls share one in-flight import. A failed load clears the memo so a later\n * call retries. Rejections are always {@link MessagingSdkLoadError}.\n *\n * @example\n * const { createAdaEmbedInterface } = await loadMessagingSdk();\n */\nexport function loadMessagingSdk(\n\toptions: LoadMessagingSdkOptions = {},\n): Promise<MessagingSdkModule> {\n\tconst importModule = options.importModule ?? defaultImportModule;\n\tlet url: string;\n\ttry {\n\t\turl = resolveSdkBootstrapUrl(options.cdnBase, options.pinBuildSha);\n\t} catch (error) {\n\t\treturn Promise.reject(error);\n\t}\n\n\tlet inFlight = inFlightByImporter.get(importModule);\n\tif (!inFlight) {\n\t\tinFlight = new Map();\n\t\tinFlightByImporter.set(importModule, inFlight);\n\t}\n\tconst existing = inFlight.get(url);\n\tif (existing) {\n\t\treturn existing;\n\t}\n\n\tconst cache = inFlight;\n\tconst pending = importSdkModule(url, importModule);\n\tcache.set(url, pending);\n\tpending.catch(() => {\n\t\tif (cache.get(url) === pending) {\n\t\t\tcache.delete(url);\n\t\t}\n\t});\n\treturn pending;\n}\n\n// Keyed by import seam like the module memo above: production memoizes on\n// the module-level default while each injected test seam gets an isolated\n// cache. `ada` is set when the promise resolves, so the stopped-interface\n// diagnostic can consult the resolved facade without wrapping it.\ninterface StartedInterfaceMemo {\n\tpromise: Promise<AdaMessagingInterface>;\n\tsettings: AdaMessagingStartOptions;\n\tada?: AdaMessagingInterface;\n}\n\nconst startedInterfaceByImporter = new WeakMap<\n\tImportSdkModule,\n\tStartedInterfaceMemo\n>();\n\n// Ungated like the runtime logger's dropped-host-value channel: both call\n// sites fire only on host misuse, never on an ordinary page load.\nfunction warnHost(message: string): void {\n\ttry {\n\t\t// biome-ignore lint/suspicious/noConsole: the loader's sanctioned host-page diagnostic sink\n\t\tconsole.warn(`[Ada] ${message}`);\n\t} catch {\n\t\t// A host may replace console methods; diagnostics must not throw.\n\t}\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null) {\n\t\treturn false;\n\t}\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\n// Structural equality over the settings surface. Two functions compare equal:\n// fresh inline callbacks on a re-run (React Strict Mode effects) are not a\n// settings change worth a warning. Exotic objects compare by reference.\nfunction settingsEqual(a: unknown, b: unknown): boolean {\n\tif (Object.is(a, b)) {\n\t\treturn true;\n\t}\n\tif (typeof a === \"function\" && typeof b === \"function\") {\n\t\treturn true;\n\t}\n\tif (Array.isArray(a) && Array.isArray(b)) {\n\t\treturn (\n\t\t\ta.length === b.length &&\n\t\t\ta.every((item, index) => settingsEqual(item, b[index]))\n\t\t);\n\t}\n\tif (isPlainObject(a) && isPlainObject(b)) {\n\t\tconst aKeys = Object.keys(a);\n\t\tconst bKeys = new Set(Object.keys(b));\n\t\treturn (\n\t\t\taKeys.length === bKeys.size &&\n\t\t\taKeys.every((key) => bKeys.has(key) && settingsEqual(a[key], b[key]))\n\t\t);\n\t}\n\treturn false;\n}\n\n// Observes the facade's symbol-keyed lifecycle getter (embed-lifecycle.ts)\n// instead of wrapping stop/start, so the customer's interface is never\n// mutated; a pinned runtime that predates the getter yields no flag and the\n// stopped-interface diagnostic is skipped rather than guessed.\nfunction isInterfaceStopped(ada: AdaMessagingInterface): boolean {\n\treturn readEmbedStoppedFlag(ada) === true;\n}\n\nasync function startAdaMessaging(\n\tsettings: AdaMessagingStartOptions,\n\toptions: LoadMessagingSdkOptions,\n): Promise<AdaMessagingInterface> {\n\tconst sdkModule = await loadMessagingSdk(options);\n\tconst ada = sdkModule.createAdaEmbedInterface();\n\tawait ada.start(settings);\n\treturn ada;\n}\n\n/**\n * Load the SDK, create the messaging interface, and start the widget —\n * the npm-first equivalent of the script-tag + `window.adaSettings` setup.\n *\n * One widget per page: the returned promise is memoized, so repeated and\n * concurrent calls resolve to the same started interface and the first\n * call's settings win. A failed load or start clears the memo so a later\n * call retries. Manage the running widget through the returned interface:\n * `stop()` tears it down and a later `start(settings)` on the same interface\n * runs again. Calling {@link loadAdaMessaging} after `stop()` returns the\n * same stopped interface without restarting it. Both memo outcomes log a\n * console warning: ignored differing settings, and a resolved interface\n * whose widget was stopped.\n *\n * Never assigns the interface to `window` or any other global: the returned\n * reference is the only handle, so hold it in module scope. A reference in\n * module scope is reachable only by your own code, never by other scripts on\n * the page.\n *\n * @example\n * // module scope: your code keeps the only reference\n * const ada = await loadAdaMessaging({\n *   handle: \"my-bot\",\n *   enableProgrammaticControl: true,\n * });\n * await ada.sendMessage(\"Hello\");\n */\nexport function loadAdaMessaging(\n\tsettings: AdaMessagingStartOptions,\n\toptions: LoadMessagingSdkOptions = {},\n): Promise<AdaMessagingInterface> {\n\tconst importModule = options.importModule ?? defaultImportModule;\n\tconst existing = startedInterfaceByImporter.get(importModule);\n\tif (existing) {\n\t\tif (!settingsEqual(settings, existing.settings)) {\n\t\t\twarnHost(\n\t\t\t\t\"loadAdaMessaging() was already called: the new settings are ignored and the existing interface is returned. To apply new settings, call stop() then start(settings) on it.\",\n\t\t\t);\n\t\t}\n\t\tif (existing.ada && isInterfaceStopped(existing.ada)) {\n\t\t\twarnHost(\n\t\t\t\t\"loadAdaMessaging() resolved an interface whose widget was stopped and never restarts it. Call start(settings) on it to run the widget again.\",\n\t\t\t);\n\t\t}\n\t\treturn existing.promise;\n\t}\n\tconst memo: StartedInterfaceMemo = {\n\t\tpromise: startAdaMessaging(settings, options),\n\t\tsettings,\n\t};\n\tstartedInterfaceByImporter.set(importModule, memo);\n\tmemo.promise.then(\n\t\t(ada) => {\n\t\t\tmemo.ada = ada;\n\t\t},\n\t\t() => {\n\t\t\tif (startedInterfaceByImporter.get(importModule) === memo) {\n\t\t\t\tstartedInterfaceByImporter.delete(importModule);\n\t\t\t}\n\t\t},\n\t);\n\treturn memo.promise;\n}\n"],"mappings":"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"}

package/dist/npm/index.d.cts

@@ -0,0 +1,15 @@
+import type { AdaMessagingClient } from "../client/client.js" with { "resolution-mode": "import" };
+export type { AdaMessagingClient };
+import type { AdaMessagingClientConfig, AdaMessagingSettings, AdaMessagingStartOptions, AdaReadyCallbackParams, AdaSdkEventCallback, AdaSdkEventContext, AdaSdkEventKey, BeforeSend, ConversationInfo, Delegate, MetaFieldValue, PublicAgentInfo, PublicMessage, ResetParams, SendMessageResult, WindowInfo, } from "../client/client-types.js" with { "resolution-mode": "import" };
+export type { AdaMessagingClientConfig, AdaMessagingSettings, AdaMessagingStartOptions, AdaReadyCallbackParams, AdaSdkEventCallback, AdaSdkEventContext, AdaSdkEventKey, BeforeSend, ConversationInfo, Delegate, MetaFieldValue, PublicAgentInfo, PublicMessage, ResetParams, SendMessageResult, WindowInfo };
+import type { ChatHtmlConfig, resolveChatHtmlConfig, } from "../client/config-helpers.js" with { "resolution-mode": "import" };
+export type { ChatHtmlConfig, resolveChatHtmlConfig };
+import type { AdaEmbedInterface, createAdaEmbedInterface, dispatchEmbedLoaderInitialActionQueue, dispatchEmbedLoaderInitialActionQueueForAtomicHandoff, LoaderQueueAction, LoaderQueueActionOutcome, LoaderQueueActionOutcomeHandler, } from "../client/embed-interface.js" with { "resolution-mode": "import" };
+export type { AdaEmbedInterface, createAdaEmbedInterface, dispatchEmbedLoaderInitialActionQueue, dispatchEmbedLoaderInitialActionQueueForAtomicHandoff, LoaderQueueAction, LoaderQueueActionOutcome, LoaderQueueActionOutcomeHandler };
+import type { FrameChannel, FrameChild, FrameMessage, FrameName, FrameToSdkEvents, SdkToFrameEvents, } from "../frame-channel/index.js" with { "resolution-mode": "import" };
+export type { FrameChannel, FrameChild, FrameMessage, FrameName, FrameToSdkEvents, SdkToFrameEvents };
+import type { mountAdaWebViewRuntime, resolveAdaWebViewRuntimeAssets, } from "../mobile-webview-runtime.js" with { "resolution-mode": "import" };
+export type { mountAdaWebViewRuntime, resolveAdaWebViewRuntimeAssets };
+export { CDN_BUILD_SHA, isCdnBuildShaStamped } from "./build-info.cjs";
+export type { AdaMessagingInterface, LoadMessagingSdkOptions, MessagingSdkLoadErrorCode, MessagingSdkModule, } from "./loader.cjs";
+export { DEFAULT_MESSAGING_CDN_BASE, loadAdaMessaging, loadMessagingSdk, MessagingSdkLoadError, } from "./loader.cjs";

package/dist/npm/index.d.ts

@@ -0,0 +1,9 @@
+export type { AdaMessagingClient } from "../client/client.js";
+export type { AdaMessagingClientConfig, AdaMessagingSettings, AdaMessagingStartOptions, AdaReadyCallbackParams, AdaSdkEventCallback, AdaSdkEventContext, AdaSdkEventKey, BeforeSend, ConversationInfo, Delegate, MetaFieldValue, PublicAgentInfo, PublicMessage, ResetParams, SendMessageResult, WindowInfo, } from "../client/client-types.js";
+export type { ChatHtmlConfig, resolveChatHtmlConfig, } from "../client/config-helpers.js";
+export type { AdaEmbedInterface, createAdaEmbedInterface, dispatchEmbedLoaderInitialActionQueue, dispatchEmbedLoaderInitialActionQueueForAtomicHandoff, LoaderQueueAction, LoaderQueueActionOutcome, LoaderQueueActionOutcomeHandler, } from "../client/embed-interface.js";
+export type { FrameChannel, FrameChild, FrameMessage, FrameName, FrameToSdkEvents, SdkToFrameEvents, } from "../frame-channel/index.js";
+export type { mountAdaWebViewRuntime, resolveAdaWebViewRuntimeAssets, } from "../mobile-webview-runtime.js";
+export { CDN_BUILD_SHA, isCdnBuildShaStamped } from "./build-info.js";
+export type { AdaMessagingInterface, LoadMessagingSdkOptions, MessagingSdkLoadErrorCode, MessagingSdkModule, } from "./loader.js";
+export { DEFAULT_MESSAGING_CDN_BASE, loadAdaMessaging, loadMessagingSdk, MessagingSdkLoadError, } from "./loader.js";