@helpai/elements 0.43.1 → 0.44.0

package/index.d.ts

@@ -1733,8 +1733,9 @@ declare function getAllInstances(): ChatWidgetInstance[];
  * cycles until explicitly unregistered.
  */
 declare function hook(widgetId: string, event: string, listener: HookListener): () => void;
-/** Semver of the published package. */
-declare const version = "0.1.0";
+/** Semver of the published `@<brand>/elements` package — build-injected, also
+ *  sent on every request + analytics hit as `_ev`. */
+declare const version: string;
 /** Compile-time brand constants inlined at build time (name, CDN URL, theme). */
 declare const brand: {
     readonly id: string;

package/index.mjs

@@ -29,6 +29,10 @@ var BRAND = {
   siteUrl: true ? "https://help.ai" : "https://help.ai"
 };
 
+// src/core/version.ts
+var ELEMENTS_VERSION = true ? "0.44.0" : "0.0.0-dev";
+var ELEMENTS_VERSION_PARAM = "_ev";
+
 // src/i18n/strings.ts
 var STRINGS_EN = {
   attach: "Attach files",
@@ -1400,7 +1404,7 @@ var EventBus = class {
 import { h, render as renderPreact } from "preact";
 
 // src/ui/app.tsx
-import { useCallback as useCallback6, useEffect as useEffect17, useMemo as useMemo3, useRef as useRef9, useState as useState13 } from "preact/hooks";
+import { useCallback as useCallback6, useEffect as useEffect16, useMemo as useMemo3, useRef as useRef9, useState as useState13 } from "preact/hooks";
 import { batch, useComputed as useComputed7, useSignal as useSignal2 } from "@preact/signals";
 
 // src/core/handshake-shape.ts
@@ -1790,7 +1794,7 @@ var AgentTransport = class {
   }
   /** Build the per-request envelope from the current transport state. */
   envelope() {
-    const out = {};
+    const out = { [ELEMENTS_VERSION_PARAM]: ELEMENTS_VERSION };
     if (this.visitorId) out.visitorId = this.visitorId;
     if (this.conversationId) out.conversationId = this.conversationId;
     if (this.locale) out.locale = this.locale;
@@ -3302,7 +3306,7 @@ function resolveCalloutPosition(configured, launcherPosition) {
 }
 
 // src/ui/panel.tsx
-import { useCallback as useCallback2, useEffect as useEffect10, useRef as useRef6 } from "preact/hooks";
+import { useCallback as useCallback2, useEffect as useEffect9, useRef as useRef6 } from "preact/hooks";
 
 // src/ui/resize-grip.tsx
 import { useEffect as useEffect2, useRef } from "preact/hooks";
@@ -4334,7 +4338,7 @@ function HeaderActions({ panelProps, variant }) {
 }
 
 // src/ui/message-list.tsx
-import { useEffect as useEffect8, useLayoutEffect, useRef as useRef5, useState as useState6 } from "preact/hooks";
+import { useEffect as useEffect7, useLayoutEffect as useLayoutEffect2, useRef as useRef5, useState as useState6 } from "preact/hooks";
 import { useComputed as useComputed5 } from "@preact/signals";
 
 // src/ui/form/dynamic-form.tsx
@@ -4726,13 +4730,13 @@ function FormDoneMarker({
 import { useComputed as useComputed4 } from "@preact/signals";
 
 // src/ui/markdown.tsx
-import { useEffect as useEffect7, useMemo, useRef as useRef4 } from "preact/hooks";
+import { useLayoutEffect, useMemo, useRef as useRef4 } from "preact/hooks";
 import { effect, signal as signal4 } from "@preact/signals";
 import * as smd from "streaming-markdown";
 import { jsx as jsx12 } from "preact/jsx-runtime";
 function MarkdownView({ textSig, doneSig }) {
   const ref = useRef4(null);
-  useEffect7(() => {
+  useLayoutEffect(() => {
     const el = ref.current;
     if (!el) return;
     el.classList.add(`${BRAND.cssPrefix}-md`);
@@ -5224,7 +5228,7 @@ function MessageList({
     el.scrollTop = el.scrollHeight;
   };
   const firstMessageId = messages.value[0]?.id;
-  useLayoutEffect(() => {
+  useLayoutEffect2(() => {
     const el = ref.current;
     if (!el) return;
     if (messages.value.length === 0) return;
@@ -5247,7 +5251,7 @@ function MessageList({
     };
   }, [firstMessageId]);
   const prevLengthRef = useRef5(0);
-  useEffect8(() => {
+  useEffect7(() => {
     const el = ref.current;
     const list = messages.value;
     const prevLength = prevLengthRef.current;
@@ -5264,7 +5268,7 @@ function MessageList({
     const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;
     if (distanceFromBottom < STICK_THRESHOLD) pinBottom(el);
   }, [messages.value.length]);
-  useEffect8(() => {
+  useEffect7(() => {
     const el = ref.current;
     if (!el) return;
     const last = messages.value.at(-1);
@@ -5285,13 +5289,13 @@ function MessageList({
     return () => obs.disconnect();
   }, [messages.value]);
   const activeFormId = form?.form.id;
-  useLayoutEffect(() => {
+  useLayoutEffect2(() => {
     const el = ref.current;
     if (!el || !activeFormId || detachedRef.current) return;
     if (!messages.value.some((m) => m.role === "user")) return;
     pinBottom(el);
   }, [activeFormId]);
-  useEffect8(() => {
+  useEffect7(() => {
     const el = ref.current;
     if (!el) return;
     const syncJump = () => setShowJump(el.scrollHeight - el.scrollTop - el.clientHeight > STICK_THRESHOLD * 2);
@@ -5461,7 +5465,7 @@ function dayLabel(createdAt, strings) {
 }
 
 // src/ui/conversation-list.tsx
-import { useEffect as useEffect9, useState as useState7 } from "preact/hooks";
+import { useEffect as useEffect8, useState as useState7 } from "preact/hooks";
 
 // src/ui/history-groups.ts
 var HISTORY_BUCKETS = ["today", "yesterday", "lastWeek", "older"];
@@ -5519,7 +5523,7 @@ function ConversationList({
   const seed = transport.peekConversations({ visitorId });
   const [state, setState] = useState7(seed ? "loaded" : "loading");
   const [conversations, setChats] = useState7(seed?.conversations ?? []);
-  useEffect9(() => {
+  useEffect8(() => {
     let cancelled = false;
     transport.listConversations({ visitorId }).then((res) => {
       if (cancelled) return;
@@ -5629,7 +5633,7 @@ function Panel(props2) {
   const { options, onClose } = props2;
   const s = options.strings;
   const containerRef = useRef6(null);
-  useEffect10(() => {
+  useEffect9(() => {
     const el = containerRef.current;
     if (!el) return;
     const dispose = trapFocus(el);
@@ -6101,7 +6105,7 @@ var topScreen = (s) => activeStack(s).at(-1);
 var atTabRoot = (s) => activeStack(s).length === 0;
 
 // src/ui/messenger-home.tsx
-import { useCallback as useCallback4, useEffect as useEffect15, useRef as useRef8 } from "preact/hooks";
+import { useCallback as useCallback4, useEffect as useEffect14, useRef as useRef8 } from "preact/hooks";
 import { useComputed as useComputed6 } from "@preact/signals";
 
 // src/ui/modules/chat.tsx
@@ -6111,7 +6115,7 @@ var chatLayout = {
 };
 
 // src/ui/modules/help.tsx
-import { useEffect as useEffect11, useMemo as useMemo2, useState as useState8 } from "preact/hooks";
+import { useEffect as useEffect10, useMemo as useMemo2, useState as useState8 } from "preact/hooks";
 
 // src/ui/back-header.tsx
 import { jsx as jsx23, jsxs as jsxs19 } from "preact/jsx-runtime";
@@ -6233,7 +6237,7 @@ function HelpRoot({ transport, strings, config, nav, bus, panelProps }) {
   const [items, setItems] = useState8([]);
   const [query, setQuery] = useState8("");
   const [reloadKey, setReloadKey] = useState8(0);
-  useEffect11(() => {
+  useEffect10(() => {
     let cancelled = false;
     setState("loading");
     transport.listContent({ tags, sortBy: "order", limit: 100 }).then((res) => {
@@ -6253,7 +6257,7 @@ function HelpRoot({ transport, strings, config, nav, bus, panelProps }) {
     };
   }, [transport, tags, reloadKey, bus]);
   const results = useMemo2(() => fuzzySearch(items, query), [items, query]);
-  useEffect11(() => {
+  useEffect10(() => {
     const q = query.trim();
     if (!q) return;
     const timer = setTimeout(() => bus.emit("contentSearch", { queryLength: q.length, hitCount: results.length }), 600);
@@ -6286,7 +6290,7 @@ var helpLayout = {
 };
 
 // src/ui/modules/home.tsx
-import { useEffect as useEffect12, useState as useState9 } from "preact/hooks";
+import { useEffect as useEffect11, useState as useState9 } from "preact/hooks";
 
 // src/ui/home-card.tsx
 import { jsx as jsx28 } from "preact/jsx-runtime";
@@ -6317,7 +6321,7 @@ function HomeRoot(props2) {
   const [recent, setRecent] = useState9(null);
   const [content, setContent] = useState9([]);
   const tagsKey = config.contentTags?.join(",");
-  useEffect12(() => {
+  useEffect11(() => {
     if (!config.showRecentConversations) return;
     let cancelled = false;
     transport.listConversations({ limit: 1 }).then((res) => !cancelled && setRecent(res.conversations?.[0] ?? null)).catch((err) => !cancelled && log14.warn("listConversations (home) failed", { err }));
@@ -6325,7 +6329,7 @@ function HomeRoot(props2) {
       cancelled = true;
     };
   }, [transport, config.showRecentConversations]);
-  useEffect12(() => {
+  useEffect11(() => {
     if (!config.contentTags?.length) return;
     let cancelled = false;
     transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => {
@@ -6405,7 +6409,7 @@ var homeLayout = {
 };
 
 // src/ui/modules/news.tsx
-import { useEffect as useEffect13, useState as useState10 } from "preact/hooks";
+import { useEffect as useEffect12, useState as useState10 } from "preact/hooks";
 import { jsx as jsx30, jsxs as jsxs25 } from "preact/jsx-runtime";
 var p26 = BRAND.cssPrefix;
 var log15 = logger.scope("news");
@@ -6415,7 +6419,7 @@ function NewsRoot({ transport, strings, config, nav, bus, panelProps }) {
   const [errorMsg, setErrorMsg] = useState10(strings.errorGeneric);
   const [items, setItems] = useState10([]);
   const [reloadKey, setReloadKey] = useState10(0);
-  useEffect13(() => {
+  useEffect12(() => {
     let cancelled = false;
     setState("loading");
     transport.listContent({ tags, sortBy: "publishedAt", sortOrder: "desc" }).then((res) => {
@@ -6537,7 +6541,7 @@ function IframeView({ url, title, strings, onBack, actions }) {
 }
 
 // src/ui/content-view.tsx
-import { useCallback as useCallback3, useEffect as useEffect14, useState as useState11 } from "preact/hooks";
+import { useCallback as useCallback3, useEffect as useEffect13, useState as useState11 } from "preact/hooks";
 import { jsx as jsx33, jsxs as jsxs28 } from "preact/jsx-runtime";
 var p29 = BRAND.cssPrefix;
 var log16 = logger.scope("content");
@@ -6551,7 +6555,7 @@ function ContentView({ id, title, transport, strings, bus, onBack, actions }) {
     setItem(null);
     setReloadKey((k) => k + 1);
   }, []);
-  useEffect14(() => {
+  useEffect13(() => {
     let cancelled = false;
     transport.listContent({ ids: [id], limit: 1 }).then((res) => {
       if (cancelled) return;
@@ -6569,7 +6573,7 @@ function ContentView({ id, title, transport, strings, bus, onBack, actions }) {
       cancelled = true;
     };
   }, [transport, id, reloadKey, bus]);
-  useEffect14(() => {
+  useEffect13(() => {
     if (!item) return;
     const timer = setTimeout(() => bus.emit("contentRead", { contentId: id }), READ_DWELL_MS);
     return () => clearTimeout(timer);
@@ -6622,7 +6626,7 @@ function MessengerHome({
   const options = panelProps.options;
   const strings = options.strings;
   const containerRef = useRef8(null);
-  useEffect15(() => {
+  useEffect14(() => {
     const el = containerRef.current;
     if (!el) return;
     const dispose = trapFocus(el);
@@ -6647,7 +6651,7 @@ function MessengerHome({
   const isReader = top?.kind === "iframe" || top?.kind === "content";
   const showTabBar = enabledModules.length > 1 && (atTabRoot(navState) || !isReader);
   const savedSize = useRef8(null);
-  useEffect15(() => {
+  useEffect14(() => {
     if (isReader && savedSize.current === null) {
       savedSize.current = panelProps.panelSize;
       if (panelProps.panelSize === "normal") onSetPanelSize("expanded");
@@ -6780,12 +6784,12 @@ function ModulesEmpty({ strings, onClose }) {
 }
 
 // src/ui/use-launcher-callout.ts
-import { useCallback as useCallback5, useEffect as useEffect16, useState as useState12 } from "preact/hooks";
+import { useCallback as useCallback5, useEffect as useEffect15, useState as useState12 } from "preact/hooks";
 function useLauncherCallout({ callout, persistence }) {
   const textKey = callout?.text ?? "";
   const persistent = callout?.persistent ?? true;
   const [dismissed, setDismissed] = useState12(() => persistent ? false : persistence.loadCalloutDismissed(textKey));
-  useEffect16(() => {
+  useEffect15(() => {
     setDismissed(persistent ? false : persistence.loadCalloutDismissed(textKey));
   }, [textKey, persistent, persistence]);
   const dismissCallout = useCallback5(() => {
@@ -6849,7 +6853,7 @@ function App({ options, hostElement, bus }) {
   activatedRef.current = activated;
   const pendingThreadRef = useRef9(false);
   const welcomeRef = useRef9(void 0);
-  useEffect17(() => {
+  useEffect16(() => {
     if (isOpen) setActivated(true);
   }, [isOpen]);
   const initialPanelApplied = useRef9(false);
@@ -6900,20 +6904,20 @@ function App({ options, hostElement, bus }) {
     },
     [persistence, transport]
   );
-  useEffect17(() => {
+  useEffect16(() => {
     if (initialSettings.soundMuted !== void 0) feedback.setMuted(initialSettings.soundMuted);
   }, []);
-  useEffect17(() => {
+  useEffect16(() => {
     hostElement.dataset.theme = activeThemeMode;
   }, [hostElement, activeThemeMode, options]);
-  useEffect17(() => {
+  useEffect16(() => {
     hostElement.dataset.textSize = activeTextSize;
   }, [hostElement, activeTextSize, options]);
-  useEffect17(() => {
+  useEffect16(() => {
     feedback.update(options.sound, options.haptics);
   }, [feedback, options.sound, options.haptics]);
-  useEffect17(() => () => feedback.destroy(), [feedback]);
-  useEffect17(() => {
+  useEffect16(() => () => feedback.destroy(), [feedback]);
+  useEffect16(() => {
     let firstRun = true;
     return feedback.mutedSig.subscribe((muted) => {
       if (firstRun) {
@@ -6923,13 +6927,13 @@ function App({ options, hostElement, bus }) {
       patchAndSync({ soundMuted: muted });
     });
   }, [feedback, patchAndSync]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (initialSizeApplied.current || !options.size.initialSize) return;
     initialSizeApplied.current = true;
     if (persistence.loadPanelSize()) return;
     setPanelSize(pickInitialPanelSize(options.mode, options.size, currentViewportWidth()));
   }, [options.mode, options.size, persistence]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!conversationReady || initialPanelApplied.current) return;
     initialPanelApplied.current = true;
     const state = resolveInitialPanelState(
@@ -6944,7 +6948,7 @@ function App({ options, hostElement, bus }) {
   const homeNavSeeded = useRef9(false);
   const resumeActiveRef = useRef9(false);
   const resumeBubbleRef = useRef9(null);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!conversationReady || homeNavSeeded.current) return;
     homeNavSeeded.current = true;
     if (resumeActiveRef.current) {
@@ -7129,18 +7133,18 @@ function App({ options, hostElement, bus }) {
   const userSig = JSON.stringify(options.userContext ?? null);
   const pageSig = JSON.stringify(options.pageContext ?? null);
   const formCtxSig = JSON.stringify(formContext);
-  useEffect17(() => {
+  useEffect16(() => {
     const merged = Object.keys(formContext).length ? { ...formContext, ...options.userContext } : options.userContext;
     transport.setContext(merged, toWirePageContext(options.pageContext));
   }, [transport, userSig, pageSig, formCtxSig]);
   const effectiveLocale = clampLocale(activeLocale, options.availableLocales, options.defaultLocale);
-  useEffect17(() => {
+  useEffect16(() => {
     transport.setLocale(effectiveLocale);
   }, [transport, effectiveLocale]);
-  useEffect17(() => {
+  useEffect16(() => {
     hostElement.dir = isRtlLocale(effectiveLocale) ? "rtl" : "ltr";
   }, [hostElement, effectiveLocale]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
   const runResume = useCallback6(
@@ -7188,7 +7192,7 @@ function App({ options, hostElement, bus }) {
     [reducer, messagesSig, feedback, bus, options, homeNav]
   );
   const resumeHandleRef = useRef9(null);
-  useEffect17(() => {
+  useEffect16(() => {
     const persistedConversation = conversationIdSig.value;
     if (persistedConversation) transport.primeIdentity(visitorId, persistedConversation);
     void runHandshake({ newConversation: false });
@@ -7197,7 +7201,7 @@ function App({ options, hostElement, bus }) {
       resumeHandleRef.current?.cancel();
     };
   }, []);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!activated) return;
     dataBootRef.current = transport.bootstrap();
     void (async () => {
@@ -7222,7 +7226,7 @@ function App({ options, hostElement, bus }) {
     }
   }, [activated]);
   const formsLocaleRef = useRef9(null);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!activated) return;
     if (formsLocaleRef.current === null) {
       formsLocaleRef.current = effectiveLocale;
@@ -7239,15 +7243,15 @@ function App({ options, hostElement, bus }) {
     };
   }, [activated, effectiveLocale, transport]);
   const lastUserSig = useRef9(userSig);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!conversationReady || lastUserSig.current === userSig) return;
     lastUserSig.current = userSig;
     void runHandshake({ newConversation: false });
   }, [userSig, conversationReady, runHandshake]);
-  useEffect17(() => {
+  useEffect16(() => {
     applyMode(hostElement, computeHostMode(options.mode, panelSize, isOpen));
   }, [hostElement, isOpen, panelSize, options.mode]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (options.mode !== "modal" || !isOpen) return;
     const onClick = (e) => {
       const path = e.composedPath();
@@ -7259,7 +7263,7 @@ function App({ options, hostElement, bus }) {
     hostElement.addEventListener("click", onClick);
     return () => hostElement.removeEventListener("click", onClick);
   }, [hostElement, isOpen, options.mode]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (options.mode !== "drawer" || !isOpen) return;
     const onKey = (e) => {
       if (e.key === "Escape") setIsOpen(false);
@@ -7394,25 +7398,25 @@ function App({ options, hostElement, bus }) {
     }
   });
   const activeForm = useComputed7(() => forms.activeForm.value);
-  useEffect17(() => {
+  useEffect16(() => {
     forms.refresh();
   }, [effectiveForms, forms]);
   const pageArea = options.pageContext?.area ? String(options.pageContext.area) : void 0;
   const msgCount = useComputed7(() => messagesSig.value.length);
-  useEffect17(() => {
+  useEffect16(() => {
     if (conversationReady && formsReady) forms.fire("pre-chat");
   }, [conversationReady, formsReady, forms]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (formsReady && !canSend) forms.fire("conversation-closed");
   }, [formsReady, canSend, forms]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (conversationReady && formsReady && pageArea) forms.fire("page-area");
   }, [conversationReady, formsReady, pageArea, forms]);
   const idleMs = useMemo3(() => {
     const secs = effectiveForms.list.flatMap((f) => f.triggers).filter((t) => t.kind === "idle").map((t) => Number(t.param));
     return secs.length ? Math.min(...secs) * 1e3 : 0;
   }, [effectiveForms]);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!idleMs || !isOpen) return;
     const id = setTimeout(() => forms.fire("idle"), idleMs);
     return () => clearTimeout(id);
@@ -7472,7 +7476,7 @@ function App({ options, hostElement, bus }) {
     }).catch((err) => log17.debug("refreshUnread failed (non-fatal)", { err }));
   }, [transport, options.modules, unreadCountSig]);
   const unreadSeeded = useRef9(false);
-  useEffect17(() => {
+  useEffect16(() => {
     if (!activated || !conversationReady || unreadSeeded.current) return;
     unreadSeeded.current = true;
     refreshUnread();
@@ -7630,12 +7634,12 @@ function App({ options, hostElement, bus }) {
     },
     [formsReady, forms]
   );
-  useEffect17(() => {
+  useEffect16(() => {
     if (!formsReady || !pendingOpenFormRef.current) return;
     forms.fire("manual", pendingOpenFormRef.current);
     pendingOpenFormRef.current = null;
   }, [formsReady, forms]);
-  useEffect17(() => {
+  useEffect16(() => {
     const unsub = bindHostCommands(hostElement, {
       open: handleOpen,
       close: handleClose,
@@ -7902,6 +7906,7 @@ function createTracker(bus, deps) {
     if (++windowHits > MAX_HITS_PER_MINUTE) return;
     const params = new URLSearchParams();
     params.set("v", PROTOCOL_VERSION);
+    params.set(ELEMENTS_VERSION_PARAM, ELEMENTS_VERSION);
     params.set("e", event);
     if (tracking.token) params.set("tk", tracking.token);
     if (publicKey) params.set("pk", publicKey);
@@ -8222,7 +8227,7 @@ function getAllInstances() {
 function hook(widgetId, event, listener) {
   return registerHook(widgetId, event, listener);
 }
-var version = "0.1.0";
+var version = ELEMENTS_VERSION;
 var brand = BRAND;
 export {
   HOOK_WILDCARD,

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.43.1"
+  "version": "0.44.0"
 }