@smooai/chat-widget 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -190,6 +190,45 @@ declare function mountChatWidget(config: ChatWidgetConfig, target?: HTMLElement)
  */
 declare function mountFullPageChat(config: Omit<ChatWidgetConfig, 'mode'>, target?: HTMLElement): SmoothAgentChatElement;
 //#endregion
+//#region src/loader-core.d.ts
+/**
+ * Tiny, dependency-free deferred loader for `@smooai/chat-widget`.
+ *
+ * The recommended embed: a host includes this *small* script eagerly, and it
+ * defers injecting the real (heavier) `chat-widget.global.js` module until the
+ * page is past its critical render — so the widget never competes with the host
+ * page's LCP/TBT. It triggers the real load on the **first** of:
+ *
+ *   - `window` `load` → `requestIdleCallback` (idle time), or
+ *   - user intent (`pointerdown` / `keydown` / `scroll`), or
+ *   - an 8s fallback.
+ *
+ * After the module loads (which registers `<smooth-agent-chat>` and exposes
+ * `window.SmoothAgentChat`), it mounts the widget with the host's config.
+ *
+ * Deliberately imports nothing from the widget itself — this file must stay a
+ * few hundred bytes so including it eagerly is free.
+ *
+ * ## Config
+ * Set a global before/with the loader (any `ChatWidgetConfig`, plus an optional
+ * `src` pointing at the module bundle):
+ *
+ * ```html
+ * <script>window.SmoothAgentChatConfig = { endpoint: 'wss://…/ws', agentId: '…' };</script>
+ * <script src="https://cdn/…/chat-widget-loader.global.js" async></script>
+ * ```
+ *
+ * Or, for the simplest installs, `data-*` attributes on the loader's own tag
+ * (`data-endpoint`, `data-agent-id`, `data-primary`, `data-mode`, `data-src`).
+ * If no config is found, the module is still loaded (registering the element) so
+ * a `<smooth-agent-chat …>` placed directly in markup upgrades itself.
+ */
+/**
+ * Install the deferred loader. Idempotent per call; the IIFE entry
+ * (`loader.ts`) invokes it once on script execution.
+ */
+declare function initChatWidgetLoader(): void;
+//#endregion
 //#region src/conversation.d.ts
 type Role = 'user' | 'assistant';
 interface ChatMessage {
@@ -283,5 +322,5 @@ declare class ConversationController {
   disconnect(): void;
 }
 //#endregion
-export { type ChatMessage, type ChatWidgetConfig, type ChatWidgetMode, type ChatWidgetTheme, type Citation, type ConnectionStatus, ConversationController, type ConversationEvents, ELEMENT_TAG, type Role, SmoothAgentChatElement, defineChatWidget, mountChatWidget, mountFullPageChat };
+export { type ChatMessage, type ChatWidgetConfig, type ChatWidgetMode, type ChatWidgetTheme, type Citation, type ConnectionStatus, ConversationController, type ConversationEvents, ELEMENT_TAG, type Role, SmoothAgentChatElement, defineChatWidget, initChatWidgetLoader, mountChatWidget, mountFullPageChat };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/config.ts","../src/element.ts","../src/conversation.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/config.ts","../src/element.ts","../src/loader-core.ts","../src/conversation.ts"],"mappings":";;;;;;AAOA;;;;UAAiB,eAAA;EAIb;EAFA,IAAA;EAMA;EAJA,UAAA;EAQA;EANA,OAAA;EAUA;EARA,WAAA;EAYA;EAVA,SAAA;EAkBA;EAhBA,eAAA;EAoBA;EAlBA,mBAAA;EAkBsB;EAhBtB,UAAA;EA2BsB;EAzBtB,cAAA;EAyBsB;EAvBtB,MAAA;EAyBa;EAnBb,iBAAA;;EAEA,qBAAA;EAsBA;EApBA,kBAAA;EAyBO;EAvBP,sBAAA;AAAA;;;;;;;;;KAWQ,cAAA;AAAA,UAEK,gBAAA;EAuCb;;;;EAlCA,QAAA;EAyCuB;;;;EApCvB,IAAA,GAAO,cAAA;ECxCa;ED0CpB,OAAA;EC1CoB;ED4CpB,SAAA;ECAS;EDET,QAAA;;EAEA,SAAA;ECmDkB;EDjDlB,SAAA;ECNmD;EDQnD,WAAA;ECRwC;EDUxC,QAAA;ECLiB;EDOjB,sBAAA;ECLQ;EDOR,SAAA;ECLQ;;;;EDUR,cAAA;ECFQ;EDIR,WAAA;ECDQ;EDGR,YAAA;ECCQ;EDCR,YAAA;ECCQ;;;;EDIR,cAAA;ECMA;EDJA,KAAA,GAAQ,eAAe;AAAA;;;cC5Ed,WAAA;AAAA,cA4CA,sBAAA,SAA+B,WAAA;EAAA,WAC7B,kBAAA;EAAA,iBAIM,IAAA;EAAA,QACT,UAAA;EAAA,QACA,SAAA;EAAA,QACA,IAAA;EAAA,QACA,QAAA;EAAA,QACA,MAAA;EAAA,QACA,OAAA;EDTR;EAAA,QCWQ,iBAAA;EDPR;EAAA,QCSQ,OAAA;EDLR;EAAA,QCOQ,cAAA;EDHR;EAAA,QCKQ,SAAA;EAAA,QACA,WAAA;EAAA,QAGA,OAAA;EAAA,QACA,UAAA;EAAA,QACA,UAAA;EAAA,QACA,QAAA;EAAA,QACA,KAAA;EAAA,QACA,OAAA;EAAA,QACA,OAAA;;EAOR,iBAAA;EAKA,oBAAA;EAMA,wBAAA;EA3FoB;;;AAAA;EAmGpB,SAAA,CAAU,MAAA,EAAQ,OAAA,CAAQ,gBAAA;EAvDM;EAgEhC,QAAA;EAT0B;EAgB1B,SAAA;EAAA,QAOQ,UAAA;EAAA,QA+BA,MAAA;EA7G2C;;;;;EAAA,QAiQ3C,eAAA;EAzPA;EAAA,QAqVA,mBAAA;EAnVA;EAAA,QA8VA,YAAA;EAAA,QAMA,aAAA;EA/VA;EAAA,QA2WA,QAAA;EAAA,QAOA,cAAA;EA7WA;EAAA,QA6ZA,QAAA;EAAA,QAaA,cAAA;EAAA,QAOA,SAAA;EA3aA;;;;;;EAAA,QAqbA,aAAA;EAAA,QA0DA,YAAA;EAAA,QAgBA,mBAAA;EAAA,QAMA,MAAA;AAAA;;iBA6BI,gBAAA;;;;;iBAUA,eAAA,CAAgB,MAAA,EAAQ,gBAAA,EAAkB,MAAA,GAAQ,WAAA,GAA8B,sBAAA;;;;;;;;;;;;;AAvC9E;AA6BlB;iBAgCgB,iBAAA,CAAkB,MAAA,EAAQ,IAAA,CAAK,gBAAA,WAA2B,MAAA,GAAQ,WAAA,GAA8B,sBAAA;;;;;;ADvpBhH;;;;;;;;;;;;;;;;;;;AAgC0B;AAW1B;;;;AAA0B;AAE1B;;;;;;;;iBEqCgB,oBAAA;;;KCnEJ,IAAA;AAAA,UAEK,WAAA;EACb,EAAA;EACA,IAAA,EAAM,IAAA;EHwBgB;EGtBtB,IAAA;EHsBsB;EGpBtB,SAAA;EHsBa;;;;;;EGfb,SAAA,GAAY,QAAQ;AAAA;AAAA,KAGZ,gBAAA;;;;;;;;;KAUA,SAAA;EAEF,IAAA;EACA,MAAA;EACA,iBAAA;EACA,iBAAA,uBH2CE;EGzCF,IAAA;IAAS,OAAA;IAAkB,iBAAA;EAAA;EAE3B,KAAA;EACA,iBAAA;AAAA;EAEF,IAAA;EAAiB,MAAA;EAAiB,iBAAA;AAAA;AAAA,UAEzB,QAAA;EACb,IAAA;EACA,KAAA;EACA,KAAA;AAAA;AAAA,UAGa,kBAAA;EFJ2B;EEMxC,UAAA,GAAa,QAAA,EAAU,WAAA;EFDN;EEGjB,QAAA,GAAW,MAAA,EAAQ,gBAAA,EAAkB,MAAA;EFD7B;EEGR,WAAA,IAAe,SAAA,EAAW,SAAA;AAAA;AAAA,cAyCjB,sBAAA;EAAA,iBACQ,MAAA;EAAA,iBACA,MAAA;EAAA,QACT,MAAA;EAAA,QACA,SAAA;EAAA,iBACS,QAAA;EAAA,QACT,MAAA;EAAA,QACA,GAAA;EFlCA;EAAA,QEoCA,QAAA;EFlCA;EAAA,QEoCA,eAAA;EAAA,QACA,SAAA;cAEI,MAAA,EAAQ,gBAAA,EAAkB,MAAA,EAAQ,kBAAA;EAAA,IAM1C,gBAAA,IAAoB,gBAAA;EFnCxB;EEwCA,WAAA,CAAY,IAAA,EAAM,QAAA;EAAA,QAIV,YAAA;EFzBR;EE+BA,SAAA,CAAU,IAAA;EF/BgB;EEqC1B,WAAA,CAAY,QAAA;EAAA,QAMJ,MAAA;EAAA,QAKA,SAAA;EAAA,QAKA,YAAA;EFCA;EEKF,OAAA,IAAW,OAAA;EF2OT;;;;EElNF,IAAA,CAAK,IAAA,WAAe,OAAA;EFsSlB;EAAA,QElOA,eAAA;EFsPA;EE/MR,UAAA;AAAA"}

package/dist/index.js

@@ -1452,6 +1452,142 @@ function mountFullPageChat(config, target = document.body) {
 	}, target);
 }
 //#endregion
-export { ConversationController, ELEMENT_TAG, SmoothAgentChatElement, defineChatWidget, mountChatWidget, mountFullPageChat };
+//#region src/loader-core.ts
+/**
+* Tiny, dependency-free deferred loader for `@smooai/chat-widget`.
+*
+* The recommended embed: a host includes this *small* script eagerly, and it
+* defers injecting the real (heavier) `chat-widget.global.js` module until the
+* page is past its critical render — so the widget never competes with the host
+* page's LCP/TBT. It triggers the real load on the **first** of:
+*
+*   - `window` `load` → `requestIdleCallback` (idle time), or
+*   - user intent (`pointerdown` / `keydown` / `scroll`), or
+*   - an 8s fallback.
+*
+* After the module loads (which registers `<smooth-agent-chat>` and exposes
+* `window.SmoothAgentChat`), it mounts the widget with the host's config.
+*
+* Deliberately imports nothing from the widget itself — this file must stay a
+* few hundred bytes so including it eagerly is free.
+*
+* ## Config
+* Set a global before/with the loader (any `ChatWidgetConfig`, plus an optional
+* `src` pointing at the module bundle):
+*
+* ```html
+* <script>window.SmoothAgentChatConfig = { endpoint: 'wss://…/ws', agentId: '…' };<\/script>
+* <script src="https://cdn/…/chat-widget-loader.global.js" async><\/script>
+* ```
+*
+* Or, for the simplest installs, `data-*` attributes on the loader's own tag
+* (`data-endpoint`, `data-agent-id`, `data-primary`, `data-mode`, `data-src`).
+* If no config is found, the module is still loaded (registering the element) so
+* a `<smooth-agent-chat …>` placed directly in markup upgrades itself.
+*/
+/** Must match `ELEMENT_TAG` in `element.ts`; inlined to avoid importing it. */
+const ELEMENT_TAG$1 = "smooth-agent-chat";
+/** Default module filename, resolved as a sibling of the loader script. */
+const DEFAULT_MODULE = "chat-widget.global.js";
+/**
+* Resolve the module URL: explicit `src` (config or `data-src`) wins, else a
+* sibling of the loader script, else the bare default filename.
+*/
+function resolveModuleSrc(win, script) {
+	const fromConfig = win.SmoothAgentChatConfig?.src;
+	if (fromConfig) return fromConfig;
+	const fromAttr = script?.getAttribute("data-src");
+	if (fromAttr) return fromAttr;
+	const selfSrc = script?.src;
+	if (selfSrc) return selfSrc.replace(/[^/]*$/, DEFAULT_MODULE);
+	return DEFAULT_MODULE;
+}
+/**
+* The widget mount config: the `SmoothAgentChatConfig` global (minus the
+* loader-only `src`), or `data-*` attributes. `undefined` ⇒ no programmatic
+* mount (a markup element will upgrade itself once the module registers it).
+*/
+function resolveMountConfig(win, script) {
+	if (win.SmoothAgentChatConfig) {
+		const { src: _src, ...config } = win.SmoothAgentChatConfig;
+		return Object.keys(config).length > 0 ? config : void 0;
+	}
+	if (!script) return void 0;
+	const endpoint = script.getAttribute("data-endpoint");
+	const agentId = script.getAttribute("data-agent-id");
+	if (!endpoint && !agentId) return void 0;
+	const config = {};
+	if (endpoint) config.endpoint = endpoint;
+	if (agentId) config.agentId = agentId;
+	const primary = script.getAttribute("data-primary");
+	if (primary) config.theme = { primary };
+	const mode = script.getAttribute("data-mode");
+	if (mode) config.mode = mode;
+	return config;
+}
+/**
+* Install the deferred loader. Idempotent per call; the IIFE entry
+* (`loader.ts`) invokes it once on script execution.
+*/
+function initChatWidgetLoader() {
+	const win = window;
+	const script = document.currentScript ?? null;
+	const moduleSrc = resolveModuleSrc(win, script);
+	let loaded = false;
+	let idleId;
+	let fallbackId;
+	function mountWhenReady() {
+		const config = resolveMountConfig(win, script);
+		if (!config) return;
+		const apply = () => {
+			try {
+				win.SmoothAgentChat?.mount(config);
+			} catch (error) {
+				console.error("[chat-widget loader] mount failed", error);
+			}
+		};
+		if (win.SmoothAgentChat) apply();
+		else if (window.customElements?.whenDefined) window.customElements.whenDefined(ELEMENT_TAG$1).then(apply, apply);
+		else apply();
+	}
+	function teardown() {
+		if (idleId !== void 0) {
+			window.cancelIdleCallback?.(idleId);
+			window.clearTimeout(idleId);
+		}
+		if (fallbackId !== void 0) window.clearTimeout(fallbackId);
+		window.removeEventListener("pointerdown", load);
+		window.removeEventListener("keydown", load);
+		window.removeEventListener("scroll", load);
+	}
+	function load() {
+		if (loaded) return;
+		loaded = true;
+		teardown();
+		const tag = document.createElement("script");
+		tag.src = moduleSrc;
+		tag.onload = mountWhenReady;
+		tag.onerror = () => console.error("[chat-widget loader] failed to load", moduleSrc);
+		document.head.appendChild(tag);
+	}
+	function schedule() {
+		if (window.requestIdleCallback) idleId = window.requestIdleCallback(() => load(), { timeout: 5e3 });
+		else idleId = window.setTimeout(load, 2500);
+		fallbackId = window.setTimeout(load, 8e3);
+	}
+	window.addEventListener("pointerdown", load, {
+		once: true,
+		passive: true
+	});
+	window.addEventListener("keydown", load, { once: true });
+	window.addEventListener("scroll", load, {
+		once: true,
+		passive: true
+	});
+	if (document.readyState === "complete") schedule();
+	else window.addEventListener("load", schedule, { once: true });
+}
+//#endregion
+export { ConversationController, ELEMENT_TAG, SmoothAgentChatElement, defineChatWidget, initChatWidgetLoader, mountChatWidget, mountFullPageChat };
 
 //# sourceMappingURL=index.js.map