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

package/dist/loader-CVynp73o.js

@@ -0,0 +1,160 @@
+//#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/loader.ts
+var DEFAULT_CDN_BASE = "https://messaging-assets.ada.support";
+var BRIDGE_ASSET_PATH = "/bridge.js";
+var PINNED_BRIDGE_ENTRY_PATH = "bridge/bridge.js";
+var PINNED_BUILD_SHA_PATTERN = /^[0-9a-f]{40}$/;
+var UNSTAMPED_BUILD_SHA_PATTERN = /^0{40}$/;
+/**
+* Typed failure raised by {@link loadMessagingBridge} and
+* {@link resolveBridgeCdnUrl}. Mirrors the sdk loader's
+* `MessagingSdkLoadError` so both loaders share one error contract.
+*/
+var MessagingBridgeLoadError = class extends Error {
+	constructor(message, code, cause) {
+		super(message);
+		_defineProperty(this, "code", void 0);
+		this.name = "MessagingBridgeLoadError";
+		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 MessagingBridgeLoadError(`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 MessagingBridgeLoadError("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;
+}
+/**
+* Resolve the full bridge asset URL for the given options: trailing slashes
+* are stripped from `cdnBase` and `/bridge.js` is appended — or, with
+* `pinBuildSha`, `/<sha>/bridge/bridge.js` for that build's immutable copy.
+*
+* The runtime this URL serves carries the bridge's security logic (origin
+* derivation, the TOFU origin lock, the hydration TTL), 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.
+*
+* @throws {MessagingBridgeLoadError} with code `invalid_cdn_base` when
+* `cdnBase` does not form a valid URL under that policy, `invalid_build_sha`
+* when `pinBuildSha` is not a full 40-hex git SHA, or `unstamped_build_sha`
+* when it is the unstamped placeholder.
+*/
+function resolveBridgeCdnUrl(options) {
+	const base = (options?.cdnBase ?? DEFAULT_CDN_BASE).trim().replace(/\/+$/, "");
+	const assetPath = options?.pinBuildSha === void 0 ? BRIDGE_ASSET_PATH : `/${resolvePinnedBuildSha(options.pinBuildSha)}/${PINNED_BRIDGE_ENTRY_PATH}`;
+	let url;
+	try {
+		url = new URL(`${base}${assetPath}`);
+	} catch (cause) {
+		throw new MessagingBridgeLoadError(`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 MessagingBridgeLoadError(`The cdnBase option must use https (plain http is allowed only for loopback hosts): "${base}".`, "invalid_cdn_base");
+	return url.toString();
+}
+function isMessagingBridgeModule(value) {
+	return typeof value === "object" && value !== null && typeof value.createBridgeClient === "function";
+}
+async function importBridgeModule(url, importModule) {
+	let loaded;
+	try {
+		loaded = await importModule(url);
+	} catch (cause) {
+		throw new MessagingBridgeLoadError(`The Ada bridge runtime failed to load from ${url}.`, "bridge_import_failed", cause);
+	}
+	if (!isMessagingBridgeModule(loaded)) throw new MessagingBridgeLoadError(`The module at ${url} does not export createBridgeClient; it is not an Ada bridge build.`, "bridge_module_invalid");
+	return loaded;
+}
+/**
+* Load the Ada bridge runtime from the CDN.
+*
+* The returned promise is memoized per resolved URL: concurrent and repeated
+* calls with the same `cdnBase` share one in-flight import. A failed load is
+* evicted from the memo so a later call can retry. Rejections are always
+* {@link MessagingBridgeLoadError}.
+*
+* @example
+* const { createBridgeClient, STATE } = await loadMessagingBridge();
+*/
+function loadMessagingBridge(options = {}) {
+	const importModule = options.importModule ?? defaultImportModule;
+	let url;
+	try {
+		url = resolveBridgeCdnUrl(options);
+	} 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 = importBridgeModule(url, importModule);
+	cache.set(url, pending);
+	pending.catch(() => {
+		if (cache.get(url) === pending) cache.delete(url);
+	});
+	return pending;
+}
+//#endregion
+export { loadMessagingBridge as n, resolveBridgeCdnUrl as r, MessagingBridgeLoadError as t };
+
+//# sourceMappingURL=loader-CVynp73o.js.map

package/dist/loader-CVynp73o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-CVynp73o.js","names":[],"sources":["../src/loader.ts"],"sourcesContent":["import type { BridgeClient, createBridgeClient } from \"./bridge-client\";\nimport type {\n\tfilterDisplayable,\n\tfindFirstUnread,\n\tgroupMessages,\n\tisAgentTyping,\n\tisConnectivityLost,\n\tisHistoricalRow,\n\tmessageKey,\n\tresolveBotName,\n\tselectUnread,\n} from \"./derive\";\nimport type { STATE } from \"./state-keys\";\n\nconst DEFAULT_CDN_BASE = \"https://messaging-assets.ada.support\";\nconst BRIDGE_ASSET_PATH = \"/bridge.js\";\n\n// The CDN pipeline uploads each main commit's bridge runtime as an immutable\n// SHA-rooted copy (`<cdnBase>/<sha>/bridge/bridge.js`); the mutable root\n// `bridge.js` is the loader fence's copy of one of those. A pin bypasses the\n// root asset and imports one immutable copy directly.\nconst PINNED_BRIDGE_ENTRY_PATH = \"bridge/bridge.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 the sdk loader's boundary).\nconst PINNED_BUILD_SHA_PATTERN = /^[0-9a-f]{40}$/;\nconst UNSTAMPED_BUILD_SHA_PATTERN = /^0{40}$/;\n\n/** Why a {@link MessagingBridgeLoadError} was raised. */\nexport type MessagingBridgeLoadErrorCode =\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 asset failed (network, CSP, 404). */\n\t| \"bridge_import_failed\"\n\t/** The imported module does not expose the Ada bridge surface. */\n\t| \"bridge_module_invalid\";\n\n/**\n * Typed failure raised by {@link loadMessagingBridge} and\n * {@link resolveBridgeCdnUrl}. Mirrors the sdk loader's\n * `MessagingSdkLoadError` so both loaders share one error contract.\n */\nexport class MessagingBridgeLoadError extends Error {\n\treadonly code: MessagingBridgeLoadErrorCode;\n\n\tconstructor(\n\t\tmessage: string,\n\t\tcode: MessagingBridgeLoadErrorCode,\n\t\tcause?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MessagingBridgeLoadError\";\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 module shape served at `<cdnBase>/bridge.js`.\n *\n * The npm package never carries this runtime — it always resolves from Ada's\n * CDN so security-bearing logic (origin derivation, the TOFU origin lock, the\n * hydration TTL) stays patchable by Ada without a customer release.\n */\nexport interface MessagingBridgeModule {\n\t/**\n\t * Create a {@link BridgeClient} connected to the parent core frame.\n\t * Declared as `typeof` the runtime symbol so the published type cannot\n\t * drift from the CDN implementation (pinned by types-drift.test.ts).\n\t */\n\tcreateBridgeClient: typeof createBridgeClient;\n\t/** Typed constants for all bridge state keys. */\n\tSTATE: typeof STATE;\n\t// Pure derivation helpers (src/derive.ts) — logic mined from Ada's\n\t// reference app, distributed with the runtime so it stays Ada-patchable.\n\t// Older cached bridge.js builds may predate them: feature-detect before\n\t// depending on one in code that must tolerate a stale CDN cache.\n\t/** Stable message identity across the stream-final and optimistic-durable id swaps. */\n\tmessageKey: typeof messageKey;\n\t/** Whether a row belongs to a conversation the chatter has left. */\n\tisHistoricalRow: typeof isHistoricalRow;\n\t/** First unread bot/agent message past the persisted read watermark. */\n\tfindFirstUnread: typeof findFirstUnread;\n\t/** Unread divider anchor + count derived from state. */\n\tselectUnread: typeof selectUnread;\n\t/** Per-index date-divider and sender-run grouping decisions. */\n\tgroupMessages: typeof groupMessages;\n\t/** The messages a transcript should actually render. */\n\tfilterDisplayable: typeof filterDisplayable;\n\t/** Bot display name: `config.botName`, else `config.handle`, else \"Ada\". */\n\tresolveBotName: typeof resolveBotName;\n\t/** Someone is composing a reply (core's typing verdict + active agent). */\n\tisAgentTyping: typeof isAgentTyping;\n\t/** Core's connectivity verdict — never substitute `navigator.onLine`. */\n\tisConnectivityLost: typeof isConnectivityLost;\n}\n\ntype ImportBridgeModule = (url: string) => Promise<unknown>;\n\n/**\n * Options for {@link loadMessagingBridge}.\n */\nexport interface LoadMessagingBridgeOptions {\n\t/**\n\t * Origin the bridge runtime is loaded from. Must be an `https:` URL;\n\t * plain `http:` is accepted only for loopback hosts (`localhost`,\n\t * `127.0.0.1`, `[::1]`, `*.localhost`) during local development.\n\t * Defaults to Ada's production asset host\n\t * (`https://messaging-assets.ada.support`). Override only for staging\n\t * validation against a non-production asset host.\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 mutable root `bridge.js` and imports that build's\n\t * immutable copy (`<cdnBase>/<sha>/bridge/bridge.js`) directly. Pass the\n\t * package's `CDN_BUILD_SHA` export to pin the build associated with this\n\t * npm version. NOT recommended for production: a pinned runtime misses\n\t * Ada's fixes and the loader-fence rollout, and may predate core/server\n\t * contract changes. Composes 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 asset URL.\n\t */\n\timportModule?: ImportBridgeModule;\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: ImportBridgeModule = (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\tImportBridgeModule,\n\tMap<string, Promise<MessagingBridgeModule>>\n>();\n\n// Mirrors the loopback semantics of the shared `isLoopbackHost` /\n// `validateMessagingEndpoint` (shared/utils/src/url.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 MessagingBridgeLoadError(\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 MessagingBridgeLoadError(\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 * Resolve the full bridge asset URL for the given options: trailing slashes\n * are stripped from `cdnBase` and `/bridge.js` is appended — or, with\n * `pinBuildSha`, `/<sha>/bridge/bridge.js` for that build's immutable copy.\n *\n * The runtime this URL serves carries the bridge's security logic (origin\n * derivation, the TOFU origin lock, the hydration TTL), so a cleartext\n * transport would let an on-path attacker replace it wholesale: `https:` is\n * required, with a loopback-only `http:` exception for local development.\n *\n * @throws {MessagingBridgeLoadError} with code `invalid_cdn_base` when\n * `cdnBase` does not form a valid URL under that policy, `invalid_build_sha`\n * when `pinBuildSha` is not a full 40-hex git SHA, or `unstamped_build_sha`\n * when it is the unstamped placeholder.\n */\nexport function resolveBridgeCdnUrl(\n\toptions?: Pick<LoadMessagingBridgeOptions, \"cdnBase\" | \"pinBuildSha\">,\n): string {\n\tconst base = (options?.cdnBase ?? DEFAULT_CDN_BASE)\n\t\t.trim()\n\t\t.replace(/\\/+$/, \"\");\n\tconst assetPath =\n\t\toptions?.pinBuildSha === undefined\n\t\t\t? BRIDGE_ASSET_PATH\n\t\t\t: `/${resolvePinnedBuildSha(options.pinBuildSha)}/${PINNED_BRIDGE_ENTRY_PATH}`;\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(`${base}${assetPath}`);\n\t} catch (cause) {\n\t\tthrow new MessagingBridgeLoadError(\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 MessagingBridgeLoadError(\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 isMessagingBridgeModule(\n\tvalue: unknown,\n): value is MessagingBridgeModule {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\ttypeof (value as Record<string, unknown>).createBridgeClient === \"function\"\n\t);\n}\n\nasync function importBridgeModule(\n\turl: string,\n\timportModule: ImportBridgeModule,\n): Promise<MessagingBridgeModule> {\n\tlet loaded: unknown;\n\ttry {\n\t\tloaded = await importModule(url);\n\t} catch (cause) {\n\t\tthrow new MessagingBridgeLoadError(\n\t\t\t`The Ada bridge runtime failed to load from ${url}.`,\n\t\t\t\"bridge_import_failed\",\n\t\t\tcause,\n\t\t);\n\t}\n\tif (!isMessagingBridgeModule(loaded)) {\n\t\tthrow new MessagingBridgeLoadError(\n\t\t\t`The module at ${url} does not export createBridgeClient; it is not an Ada bridge build.`,\n\t\t\t\"bridge_module_invalid\",\n\t\t);\n\t}\n\treturn loaded;\n}\n\n/**\n * Load the Ada bridge runtime from the CDN.\n *\n * The returned promise is memoized per resolved URL: concurrent and repeated\n * calls with the same `cdnBase` share one in-flight import. A failed load is\n * evicted from the memo so a later call can retry. Rejections are always\n * {@link MessagingBridgeLoadError}.\n *\n * @example\n * const { createBridgeClient, STATE } = await loadMessagingBridge();\n */\nexport function loadMessagingBridge(\n\toptions: LoadMessagingBridgeOptions = {},\n): Promise<MessagingBridgeModule> {\n\tconst importModule = options.importModule ?? defaultImportModule;\n\tlet url: string;\n\ttry {\n\t\turl = resolveBridgeCdnUrl(options);\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 = importBridgeModule(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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,IAAM,mBAAmB;AACzB,IAAM,oBAAoB;AAM1B,IAAM,2BAA2B;AAIjC,IAAM,2BAA2B;AACjC,IAAM,8BAA8B;;;;;;AA2BpC,IAAa,2BAAb,cAA8C,MAAM;CAGnD,YACC,SACA,MACA,OACC;AACD,QAAM,QAAQ;wBAPf,QAAA,KAAA,EAAS;AAQR,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,MAAI,UAAU,KAAA,EACb,MAAK,QAAQ;;;AAiFhB,IAAM,uBAA2C,QAChD;;;CAAoD;;AAIrD,IAAM,qCAAqB,IAAI,SAG5B;AAKH,IAAM,iBAAiB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAS;CAAM,CAAC;AAE1E,SAAS,mBAAmB,UAA2B;CACtD,MAAM,aAAa,SAAS,MAAM,CAAC,aAAa;AAIhD,QAAO,eAAe,IAAI,WAAW,IAAI,WAAW,SAAS,aAAa;;AAG3E,SAAS,sBAAsB,aAA6B;CAC3D,MAAM,MAAM,YAAY,MAAM,CAAC,aAAa;AAC5C,KAAI,CAAC,yBAAyB,KAAK,IAAI,CACtC,OAAM,IAAI,yBACT,oEAAoE,YAAY,KAChF,oBACA;AAEF,KAAI,4BAA4B,KAAK,IAAI,CACxC,OAAM,IAAI,yBACT,gLACA,sBACA;AAEF,QAAO;;;;;;;;;;;;;;;;;AAkBR,SAAgB,oBACf,SACS;CACT,MAAM,QAAQ,SAAS,WAAW,kBAChC,MAAM,CACN,QAAQ,QAAQ,GAAG;CACrB,MAAM,YACL,SAAS,gBAAgB,KAAA,IACtB,oBACA,IAAI,sBAAsB,QAAQ,YAAY,CAAC,GAAG;CACtD,IAAI;AACJ,KAAI;AACH,QAAM,IAAI,IAAI,GAAG,OAAO,YAAY;UAC5B,OAAO;AACf,QAAM,IAAI,yBACT,2CAA2C,KAAK,KAChD,oBACA,MACA;;CAEF,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,iBACL,IAAI,aAAa,WAAW,mBAAmB,IAAI,SAAS;AAC7D,KAAI,CAAC,WAAW,CAAC,eAChB,OAAM,IAAI,yBACT,uFAAuF,KAAK,KAC5F,mBACA;AAEF,QAAO,IAAI,UAAU;;AAGtB,SAAS,wBACR,OACiC;AACjC,QACC,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAAkC,uBAAuB;;AAInE,eAAe,mBACd,KACA,cACiC;CACjC,IAAI;AACJ,KAAI;AACH,WAAS,MAAM,aAAa,IAAI;UACxB,OAAO;AACf,QAAM,IAAI,yBACT,8CAA8C,IAAI,IAClD,wBACA,MACA;;AAEF,KAAI,CAAC,wBAAwB,OAAO,CACnC,OAAM,IAAI,yBACT,iBAAiB,IAAI,sEACrB,wBACA;AAEF,QAAO;;;;;;;;;;;;;AAcR,SAAgB,oBACf,UAAsC,EAAE,EACP;CACjC,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,IAAI;AACJ,KAAI;AACH,QAAM,oBAAoB,QAAQ;UAC1B,OAAO;AACf,SAAO,QAAQ,OAAO,MAAM;;CAG7B,IAAI,WAAW,mBAAmB,IAAI,aAAa;AACnD,KAAI,CAAC,UAAU;AACd,6BAAW,IAAI,KAAK;AACpB,qBAAmB,IAAI,cAAc,SAAS;;CAE/C,MAAM,WAAW,SAAS,IAAI,IAAI;AAClC,KAAI,SACH,QAAO;CAGR,MAAM,QAAQ;CACd,MAAM,UAAU,mBAAmB,KAAK,aAAa;AACrD,OAAM,IAAI,KAAK,QAAQ;AACvB,SAAQ,YAAY;AACnB,MAAI,MAAM,IAAI,IAAI,KAAK,QACtB,OAAM,OAAO,IAAI;GAEjB;AACF,QAAO"}

package/dist/loader.d.ts

@@ -0,0 +1,125 @@
+import type { createBridgeClient } from "./bridge-client.js";
+import type { filterDisplayable, findFirstUnread, groupMessages, isAgentTyping, isConnectivityLost, isHistoricalRow, messageKey, resolveBotName, selectUnread } from "./derive.js";
+import type { STATE } from "./state-keys.js";
+/** Why a {@link MessagingBridgeLoadError} was raised. */
+export type MessagingBridgeLoadErrorCode = 
+/**
+ * The `cdnBase` option is not a valid `https:` URL (plain `http:` is
+ * allowed only for loopback hosts).
+ */
+"invalid_cdn_base"
+/** The `pinBuildSha` option is not a full 40-character hex git SHA. */
+ | "invalid_build_sha"
+/**
+ * The `pinBuildSha` option is the unstamped 40-zero placeholder: this
+ * copy of the package was built from the repository, not published, so
+ * its `CDN_BUILD_SHA` names no CDN build.
+ */
+ | "unstamped_build_sha"
+/** The dynamic import of the CDN asset failed (network, CSP, 404). */
+ | "bridge_import_failed"
+/** The imported module does not expose the Ada bridge surface. */
+ | "bridge_module_invalid";
+/**
+ * Typed failure raised by {@link loadMessagingBridge} and
+ * {@link resolveBridgeCdnUrl}. Mirrors the sdk loader's
+ * `MessagingSdkLoadError` so both loaders share one error contract.
+ */
+export declare class MessagingBridgeLoadError extends Error {
+    readonly code: MessagingBridgeLoadErrorCode;
+    constructor(message: string, code: MessagingBridgeLoadErrorCode, cause?: unknown);
+}
+/**
+ * The module shape served at `<cdnBase>/bridge.js`.
+ *
+ * The npm package never carries this runtime — it always resolves from Ada's
+ * CDN so security-bearing logic (origin derivation, the TOFU origin lock, the
+ * hydration TTL) stays patchable by Ada without a customer release.
+ */
+export interface MessagingBridgeModule {
+    /**
+     * Create a {@link BridgeClient} connected to the parent core frame.
+     * Declared as `typeof` the runtime symbol so the published type cannot
+     * drift from the CDN implementation (pinned by types-drift.test.ts).
+     */
+    createBridgeClient: typeof createBridgeClient;
+    /** Typed constants for all bridge state keys. */
+    STATE: typeof STATE;
+    /** Stable message identity across the stream-final and optimistic-durable id swaps. */
+    messageKey: typeof messageKey;
+    /** Whether a row belongs to a conversation the chatter has left. */
+    isHistoricalRow: typeof isHistoricalRow;
+    /** First unread bot/agent message past the persisted read watermark. */
+    findFirstUnread: typeof findFirstUnread;
+    /** Unread divider anchor + count derived from state. */
+    selectUnread: typeof selectUnread;
+    /** Per-index date-divider and sender-run grouping decisions. */
+    groupMessages: typeof groupMessages;
+    /** The messages a transcript should actually render. */
+    filterDisplayable: typeof filterDisplayable;
+    /** Bot display name: `config.botName`, else `config.handle`, else "Ada". */
+    resolveBotName: typeof resolveBotName;
+    /** Someone is composing a reply (core's typing verdict + active agent). */
+    isAgentTyping: typeof isAgentTyping;
+    /** Core's connectivity verdict — never substitute `navigator.onLine`. */
+    isConnectivityLost: typeof isConnectivityLost;
+}
+type ImportBridgeModule = (url: string) => Promise<unknown>;
+/**
+ * Options for {@link loadMessagingBridge}.
+ */
+export interface LoadMessagingBridgeOptions {
+    /**
+     * Origin the bridge runtime is loaded from. Must be an `https:` URL;
+     * plain `http:` is accepted only for loopback hosts (`localhost`,
+     * `127.0.0.1`, `[::1]`, `*.localhost`) during local development.
+     * Defaults to Ada's production asset host
+     * (`https://messaging-assets.ada.support`). Override only for staging
+     * validation against a non-production asset host.
+     */
+    cdnBase?: string;
+    /**
+     * Full 40-character git commit SHA of a deployed CDN build. When set, the
+     * loader skips the mutable root `bridge.js` and imports that build's
+     * immutable copy (`<cdnBase>/<sha>/bridge/bridge.js`) directly. Pass the
+     * package's `CDN_BUILD_SHA` export to pin the build associated with this
+     * npm version. NOT recommended for production: a pinned runtime misses
+     * Ada's fixes and the loader-fence rollout, and may predate core/server
+     * contract changes. Composes with `cdnBase` for staged validation.
+     */
+    pinBuildSha?: string;
+    /**
+     * Import seam for unit tests. Defaults to a native dynamic `import()` of
+     * the resolved asset URL.
+     */
+    importModule?: ImportBridgeModule;
+}
+/**
+ * Resolve the full bridge asset URL for the given options: trailing slashes
+ * are stripped from `cdnBase` and `/bridge.js` is appended — or, with
+ * `pinBuildSha`, `/<sha>/bridge/bridge.js` for that build's immutable copy.
+ *
+ * The runtime this URL serves carries the bridge's security logic (origin
+ * derivation, the TOFU origin lock, the hydration TTL), 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.
+ *
+ * @throws {MessagingBridgeLoadError} with code `invalid_cdn_base` when
+ * `cdnBase` does not form a valid URL under that policy, `invalid_build_sha`
+ * when `pinBuildSha` is not a full 40-hex git SHA, or `unstamped_build_sha`
+ * when it is the unstamped placeholder.
+ */
+export declare function resolveBridgeCdnUrl(options?: Pick<LoadMessagingBridgeOptions, "cdnBase" | "pinBuildSha">): string;
+/**
+ * Load the Ada bridge runtime from the CDN.
+ *
+ * The returned promise is memoized per resolved URL: concurrent and repeated
+ * calls with the same `cdnBase` share one in-flight import. A failed load is
+ * evicted from the memo so a later call can retry. Rejections are always
+ * {@link MessagingBridgeLoadError}.
+ *
+ * @example
+ * const { createBridgeClient, STATE } = await loadMessagingBridge();
+ */
+export declare function loadMessagingBridge(options?: LoadMessagingBridgeOptions): Promise<MessagingBridgeModule>;
+export {};

package/dist/npm-index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@ada-cx/messaging-bridge` — published npm entry.
+ *
+ * Carries only TypeScript types and the thin CDN loader. The bridge runtime
+ * (`createBridgeClient`, `STATE`) always resolves from Ada's CDN via
+ * `loadMessagingBridge()` so Ada can patch security-bearing logic without a
+ * customer release. Never add runtime implementation to this entry.
+ */
+export type { FileUploadErrorData, FileUploadErrorReason, } from "./shared-utils/index.js";
+export type { BridgeClient } from "./bridge-client.js";
+export { CDN_BUILD_SHA, isCdnBuildShaStamped } from "./build-info.js";
+export type { MessageGroupingEntry, UnreadSelection } from "./derive.js";
+export type { LoadMessagingBridgeOptions, MessagingBridgeLoadErrorCode, MessagingBridgeModule, } from "./loader.js";
+export { loadMessagingBridge, MessagingBridgeLoadError, resolveBridgeCdnUrl, } from "./loader.js";
+export type { BridgeClientDestroyedError, BridgeOperations, BridgeOperationsHost, CaptureHandle, CsatSubmitHandle, EndChatEligibilityResult, FileUploadHandle, ObserveOptions, OperationResult, SendHandle, SettleOptions, } from "./operations.js";
+export type { StateKey } from "./state-keys.js";
+export type { AppDisplayState, AppEvents, CaptureData, CsatMessage, CsatScaleType, DownloadableMessage, FallbackUiConfig, LinkMessage, ListSelectionData, LiveChatStateData, Message, NotificationPermissionMessage, OptionItem, OptionsMessage, PictureMessage, PresenceMessage, QueueBotBlockMessage, QuickRepliesMessage, QuickReply, SdkPlatform, SeamlessOAuthMessage, SelectableListItem, SelectableListMessage, SignInMessage, TextMessage, VideoMessage, WidgetMessage, } from "./types.js";

package/dist/npm-index.js

@@ -0,0 +1,28 @@
+import { n as loadMessagingBridge, r as resolveBridgeCdnUrl, t as MessagingBridgeLoadError } from "./loader-CVynp73o.js";
+//#region src/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 bridge 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
+export { CDN_BUILD_SHA, MessagingBridgeLoadError, isCdnBuildShaStamped, loadMessagingBridge, resolveBridgeCdnUrl };
+
+//# sourceMappingURL=npm-index.js.map

package/dist/npm-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-index.js","names":[],"sources":["../src/build-info.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 packages/bridge/dist output via\n// scripts/stamp-cdn-build-sha.mjs and verifies the packed tarball before\n// `npm publish`. Keep the placeholder as a single 40-zero string literal:\n// the stamp is a same-length text 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 bridge runtime under an\n * immutable SHA root, so this value names the CDN build associated with this\n * npm version. Pass it as the `pinBuildSha` loader option to load exactly\n * that 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"],"mappings":";;AAMA,IAAM,kBAAkB;AACxB,IAAM,wBAAwB;;;;;;;;;;;;AAa9B,IAAa,gBAAwB;;;;;AAMrC,SAAgB,qBAAqB,MAAc,eAAwB;CAC1E,MAAM,aAAa,IAAI,MAAM,CAAC,aAAa;AAC3C,QACC,gBAAgB,KAAK,WAAW,IAAI,CAAC,sBAAsB,KAAK,WAAW"}

package/dist/npm-react.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@ada-cx/messaging-bridge/react` — published npm entry.
+ *
+ * Trivial delegation only: the provider and hooks accept a `BridgeClient`
+ * created by the CDN-loaded runtime. Never import `createBridgeClient` here —
+ * the security-bearing runtime must not reach the npm tarball.
+ */
+export type { BridgeClient } from "./bridge-client.js";
+export type { LoadedBridgeProviderProps } from "./bridge-react.js";
+export { BridgeProvider, createBridgeProvider, useBridgeClient, useBridgeState, useBridgeStateKey, } from "./bridge-react.js";
+export type { LoadMessagingBridgeOptions, MessagingBridgeLoadErrorCode, MessagingBridgeModule, } from "./loader.js";
+export { loadMessagingBridge, MessagingBridgeLoadError, resolveBridgeCdnUrl, } from "./loader.js";
+export type { AppDisplayState, AppEvents } from "./types.js";

package/dist/npm-react.js

@@ -0,0 +1,113 @@
+import { n as loadMessagingBridge, r as resolveBridgeCdnUrl, t as MessagingBridgeLoadError } from "./loader-CVynp73o.js";
+import { createContext, useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore } from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+//#region src/bridge-react.tsx
+var BridgeContext = createContext(null);
+/**
+* Provide a {@link BridgeClient} to the React tree.
+*
+* Pure delegation: the caller owns the client lifecycle. The provider does not
+* create, initialize, or destroy the client — obtain one from the CDN module
+* returned by `loadMessagingBridge()` (or use {@link createBridgeProvider} to
+* have loading, `app.initialize`, and teardown handled for you).
+*/
+function BridgeProvider({ client, children }) {
+	return /* @__PURE__ */ jsx(BridgeContext.Provider, {
+		value: client,
+		children
+	});
+}
+/** The active {@link BridgeClient}. Throws outside a `BridgeProvider`. */
+function useBridgeClient() {
+	const client = useContext(BridgeContext);
+	if (!client) throw new Error("useBridgeClient must be used within a BridgeProvider");
+	return client;
+}
+/**
+* The full display-state snapshot, or `null` before the first
+* `core.state.update`. Re-renders on every state change.
+*/
+function useBridgeState() {
+	const client = useBridgeClient();
+	const subscribe = useCallback((callback) => client.subscribe(callback), [client]);
+	const getSnapshot = useCallback(() => client.getState(), [client]);
+	return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+/**
+* Returns a single typed value from the bridge state, or `null` when the state
+* is not yet available. Provides full TypeScript autocomplete for the key names
+* and returns the exact type declared in AppDisplayState.
+*
+* Re-renders only when THIS key's value changes (delegating to the client's
+* `subscribeKey`), not on every state update the way `useBridgeState` does.
+*/
+function useBridgeStateKey(key) {
+	const client = useBridgeClient();
+	const subscribe = useCallback((onStoreChange) => typeof client.subscribeKey === "function" ? client.subscribeKey(key, onStoreChange) : client.subscribe(onStoreChange), [client, key]);
+	const getSnapshot = useCallback(() => {
+		const state = client.getState();
+		if (state === null) return null;
+		const value = state[key];
+		return value !== void 0 ? value : null;
+	}, [client, key]);
+	return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+/**
+* Build a provider component that loads the bridge runtime from the CDN,
+* creates a client, sends the required `app.initialize` handshake, and
+* destroys the client on unmount.
+*
+* The returned component renders `fallback` (default: nothing) until the
+* runtime has loaded, then renders `children` inside a {@link BridgeProvider}.
+* When the load fails it renders `errorFallback` (default: `fallback`) and
+* reports the error through `onError` (default: `console.error`).
+*
+* @example
+* const AdaBridgeProvider = createBridgeProvider();
+* root.render(<AdaBridgeProvider><MyChatUi /></AdaBridgeProvider>);
+*/
+function createBridgeProvider(load = loadMessagingBridge) {
+	return function LoadedBridgeProvider({ children, fallback, errorFallback, onError }) {
+		const [client, setClient] = useState(null);
+		const [failed, setFailed] = useState(false);
+		const onErrorRef = useRef(onError);
+		useEffect(() => {
+			onErrorRef.current = onError;
+		});
+		useEffect(() => {
+			let disposed = false;
+			let created = null;
+			load().then((mod) => {
+				if (disposed) return;
+				created = mod.createBridgeClient();
+				created.sendEvent("app.initialize");
+				setClient(created);
+			}).catch((error) => {
+				if (disposed) return;
+				setFailed(true);
+				const handler = onErrorRef.current;
+				if (handler) {
+					handler(error);
+					return;
+				}
+				console.error("[AdaMessaging] Failed to load the bridge runtime:", error);
+			});
+			return () => {
+				disposed = true;
+				created?.destroy();
+			};
+		}, []);
+		if (!client) {
+			if (failed) return /* @__PURE__ */ jsx(Fragment, { children: errorFallback ?? fallback ?? null });
+			return /* @__PURE__ */ jsx(Fragment, { children: fallback ?? null });
+		}
+		return /* @__PURE__ */ jsx(BridgeProvider, {
+			client,
+			children
+		});
+	};
+}
+//#endregion
+export { BridgeProvider, MessagingBridgeLoadError, createBridgeProvider, loadMessagingBridge, resolveBridgeCdnUrl, useBridgeClient, useBridgeState, useBridgeStateKey };
+
+//# sourceMappingURL=npm-react.js.map

package/dist/npm-react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-react.js","names":[],"sources":["../src/bridge-react.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseRef,\n\tuseState,\n\tuseSyncExternalStore,\n} from \"react\";\nimport type { BridgeClient } from \"./bridge-client\";\nimport type { MessagingBridgeModule } from \"./loader\";\nimport { loadMessagingBridge } from \"./loader\";\nimport type { AppDisplayState } from \"./types\";\n\nexport const BridgeContext = createContext<BridgeClient | null>(null);\n\n/**\n * Provide a {@link BridgeClient} to the React tree.\n *\n * Pure delegation: the caller owns the client lifecycle. The provider does not\n * create, initialize, or destroy the client — obtain one from the CDN module\n * returned by `loadMessagingBridge()` (or use {@link createBridgeProvider} to\n * have loading, `app.initialize`, and teardown handled for you).\n */\nexport function BridgeProvider({\n\tclient,\n\tchildren,\n}: {\n\tclient: BridgeClient;\n\tchildren: React.ReactNode;\n}): React.JSX.Element {\n\treturn (\n\t\t<BridgeContext.Provider value={client}>{children}</BridgeContext.Provider>\n\t);\n}\n\n/** The active {@link BridgeClient}. Throws outside a `BridgeProvider`. */\nexport function useBridgeClient(): BridgeClient {\n\tconst client = useContext(BridgeContext);\n\tif (!client) {\n\t\tthrow new Error(\"useBridgeClient must be used within a BridgeProvider\");\n\t}\n\treturn client;\n}\n\n/**\n * The full display-state snapshot, or `null` before the first\n * `core.state.update`. Re-renders on every state change.\n */\nexport function useBridgeState(): AppDisplayState | null {\n\tconst client = useBridgeClient();\n\tconst subscribe = useCallback(\n\t\t(callback: () => void) => client.subscribe(callback),\n\t\t[client],\n\t);\n\tconst getSnapshot = useCallback(() => client.getState(), [client]);\n\n\treturn useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/**\n * Returns a single typed value from the bridge state, or `null` when the state\n * is not yet available. Provides full TypeScript autocomplete for the key names\n * and returns the exact type declared in AppDisplayState.\n *\n * Re-renders only when THIS key's value changes (delegating to the client's\n * `subscribeKey`), not on every state update the way `useBridgeState` does.\n */\nexport function useBridgeStateKey<K extends keyof AppDisplayState>(\n\tkey: K,\n): AppDisplayState[K] | null {\n\tconst client = useBridgeClient();\n\tconst subscribe = useCallback(\n\t\t(onStoreChange: () => void) =>\n\t\t\t// A stale-cached CDN runtime (or a hand-rolled client) may predate\n\t\t\t// subscribeKey; fall back to the full-state subscription — the\n\t\t\t// snapshot comparison below still skips the re-render.\n\t\t\ttypeof client.subscribeKey === \"function\"\n\t\t\t\t? client.subscribeKey(key, onStoreChange)\n\t\t\t\t: client.subscribe(onStoreChange),\n\t\t[client, key],\n\t);\n\tconst getSnapshot = useCallback((): AppDisplayState[K] | null => {\n\t\tconst state = client.getState();\n\t\tif (state === null) {\n\t\t\treturn null;\n\t\t}\n\t\tconst value = state[key];\n\t\treturn value !== undefined ? value : null;\n\t}, [client, key]);\n\n\treturn useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nexport interface LoadedBridgeProviderProps {\n\tchildren: React.ReactNode;\n\t/** Rendered while the bridge runtime is loading. Defaults to nothing. */\n\tfallback?: React.ReactNode;\n\t/**\n\t * Rendered when the runtime fails to load (network, CSP, 404). Defaults\n\t * to `fallback`, so without it a failure looks like loading forever.\n\t */\n\terrorFallback?: React.ReactNode;\n\t/**\n\t * Called when the runtime fails to load, with the rejection — a\n\t * {@link MessagingBridgeLoadError} for every loader-detected failure.\n\t * When omitted, the failure is logged with `console.error`.\n\t */\n\tonError?: (error: unknown) => void;\n}\n\n/**\n * Build a provider component that loads the bridge runtime from the CDN,\n * creates a client, sends the required `app.initialize` handshake, and\n * destroys the client on unmount.\n *\n * The returned component renders `fallback` (default: nothing) until the\n * runtime has loaded, then renders `children` inside a {@link BridgeProvider}.\n * When the load fails it renders `errorFallback` (default: `fallback`) and\n * reports the error through `onError` (default: `console.error`).\n *\n * @example\n * const AdaBridgeProvider = createBridgeProvider();\n * root.render(<AdaBridgeProvider><MyChatUi /></AdaBridgeProvider>);\n */\nexport function createBridgeProvider(\n\tload: () => Promise<MessagingBridgeModule> = loadMessagingBridge,\n): (props: LoadedBridgeProviderProps) => React.JSX.Element {\n\treturn function LoadedBridgeProvider({\n\t\tchildren,\n\t\tfallback,\n\t\terrorFallback,\n\t\tonError,\n\t}: LoadedBridgeProviderProps): React.JSX.Element {\n\t\tconst [client, setClient] = useState<BridgeClient | null>(null);\n\t\tconst [failed, setFailed] = useState(false);\n\t\t// Ref so a new onError identity does not re-trigger the load effect.\n\t\tconst onErrorRef = useRef(onError);\n\t\tuseEffect(() => {\n\t\t\tonErrorRef.current = onError;\n\t\t});\n\n\t\tuseEffect(() => {\n\t\t\tlet disposed = false;\n\t\t\tlet created: BridgeClient | null = null;\n\t\t\tload()\n\t\t\t\t.then((mod) => {\n\t\t\t\t\tif (disposed) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tcreated = mod.createBridgeClient();\n\t\t\t\t\tcreated.sendEvent(\"app.initialize\");\n\t\t\t\t\tsetClient(created);\n\t\t\t\t})\n\t\t\t\t.catch((error) => {\n\t\t\t\t\tif (disposed) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tsetFailed(true);\n\t\t\t\t\tconst handler = onErrorRef.current;\n\t\t\t\t\tif (handler) {\n\t\t\t\t\t\thandler(error);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\"[AdaMessaging] Failed to load the bridge runtime:\",\n\t\t\t\t\t\terror,\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\treturn () => {\n\t\t\t\tdisposed = true;\n\t\t\t\tcreated?.destroy();\n\t\t\t};\n\t\t}, []);\n\n\t\tif (!client) {\n\t\t\tif (failed) {\n\t\t\t\treturn <>{errorFallback ?? fallback ?? null}</>;\n\t\t\t}\n\t\t\treturn <>{fallback ?? null}</>;\n\t\t}\n\t\treturn <BridgeProvider client={client}>{children}</BridgeProvider>;\n\t};\n}\n"],"mappings":";;;;AAcA,IAAa,gBAAgB,cAAmC,KAAK;;;;;;;;;AAUrE,SAAgB,eAAe,EAC9B,QACA,YAIqB;AACrB,QACC,oBAAC,cAAc,UAAf;EAAwB,OAAO;EAAS;EAAkC,CAAA;;;AAK5E,SAAgB,kBAAgC;CAC/C,MAAM,SAAS,WAAW,cAAc;AACxC,KAAI,CAAC,OACJ,OAAM,IAAI,MAAM,uDAAuD;AAExE,QAAO;;;;;;AAOR,SAAgB,iBAAyC;CACxD,MAAM,SAAS,iBAAiB;CAChC,MAAM,YAAY,aAChB,aAAyB,OAAO,UAAU,SAAS,EACpD,CAAC,OAAO,CACR;CACD,MAAM,cAAc,kBAAkB,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC;AAElE,QAAO,qBAAqB,WAAW,aAAa,YAAY;;;;;;;;;;AAWjE,SAAgB,kBACf,KAC4B;CAC5B,MAAM,SAAS,iBAAiB;CAChC,MAAM,YAAY,aAChB,kBAIA,OAAO,OAAO,iBAAiB,aAC5B,OAAO,aAAa,KAAK,cAAc,GACvC,OAAO,UAAU,cAAc,EACnC,CAAC,QAAQ,IAAI,CACb;CACD,MAAM,cAAc,kBAA6C;EAChE,MAAM,QAAQ,OAAO,UAAU;AAC/B,MAAI,UAAU,KACb,QAAO;EAER,MAAM,QAAQ,MAAM;AACpB,SAAO,UAAU,KAAA,IAAY,QAAQ;IACnC,CAAC,QAAQ,IAAI,CAAC;AAEjB,QAAO,qBAAqB,WAAW,aAAa,YAAY;;;;;;;;;;;;;;;;AAkCjE,SAAgB,qBACf,OAA6C,qBACa;AAC1D,QAAO,SAAS,qBAAqB,EACpC,UACA,UACA,eACA,WACgD;EAChD,MAAM,CAAC,QAAQ,aAAa,SAA8B,KAAK;EAC/D,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM;EAE3C,MAAM,aAAa,OAAO,QAAQ;AAClC,kBAAgB;AACf,cAAW,UAAU;IACpB;AAEF,kBAAgB;GACf,IAAI,WAAW;GACf,IAAI,UAA+B;AACnC,SAAM,CACJ,MAAM,QAAQ;AACd,QAAI,SACH;AAED,cAAU,IAAI,oBAAoB;AAClC,YAAQ,UAAU,iBAAiB;AACnC,cAAU,QAAQ;KACjB,CACD,OAAO,UAAU;AACjB,QAAI,SACH;AAED,cAAU,KAAK;IACf,MAAM,UAAU,WAAW;AAC3B,QAAI,SAAS;AACZ,aAAQ,MAAM;AACd;;AAED,YAAQ,MACP,qDACA,MACA;KACA;AACH,gBAAa;AACZ,eAAW;AACX,aAAS,SAAS;;KAEjB,EAAE,CAAC;AAEN,MAAI,CAAC,QAAQ;AACZ,OAAI,OACH,QAAO,oBAAA,UAAA,EAAA,UAAG,iBAAiB,YAAY,MAAQ,CAAA;AAEhD,UAAO,oBAAA,UAAA,EAAA,UAAG,YAAY,MAAQ,CAAA;;AAE/B,SAAO,oBAAC,gBAAD;GAAwB;GAAS;GAA0B,CAAA"}