@helpai/elements 0.29.0 → 0.29.1

package/index.mjs

@@ -6225,7 +6225,7 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, children: [
       item.image ? /* @__PURE__ */ jsx33("img", { class: `${p29}-content-hero`, src: item.image, alt: "", loading: "lazy" }) : null,
       item.description ? /* @__PURE__ */ jsx33("p", { class: `${p29}-content-subtitle`, children: item.description }) : null,
-      item.tags && item.tags.length > 0 ? /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tags`, children: item.tags.map((t) => /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tag`, children: t }, t)) }) : null,
+      item.tags?.length ? /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tags`, children: item.tags.map((t) => /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tag`, children: t }, t)) }) : null,
       /* @__PURE__ */ jsx33(StaticMarkdown, { text: item.content ?? "" })
     ] });
   }
@@ -7606,7 +7606,9 @@ function createTracker(bus, deps) {
     if (url.length > MAX_URL_LENGTH) return;
     const img = new Image(1, 1);
     inflight.add(img);
-    img.onload = img.onerror = () => inflight.delete(img);
+    const settle = () => inflight.delete(img);
+    img.addEventListener("load", settle, { once: true });
+    img.addEventListener("error", settle, { once: true });
     img.src = url;
   };
   const offs = Object.keys(TRACKED).map(

package/package.json

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

package/web-component.mjs

@@ -6280,7 +6280,7 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, children: [
       item.image ? /* @__PURE__ */ jsx33("img", { class: `${p29}-content-hero`, src: item.image, alt: "", loading: "lazy" }) : null,
       item.description ? /* @__PURE__ */ jsx33("p", { class: `${p29}-content-subtitle`, children: item.description }) : null,
-      item.tags && item.tags.length > 0 ? /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tags`, children: item.tags.map((t) => /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tag`, children: t }, t)) }) : null,
+      item.tags?.length ? /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tags`, children: item.tags.map((t) => /* @__PURE__ */ jsx33("span", { class: `${p29}-news-tag`, children: t }, t)) }) : null,
       /* @__PURE__ */ jsx33(StaticMarkdown, { text: item.content ?? "" })
     ] });
   }
@@ -7494,6 +7494,121 @@ var EventBus = class {
   }
 };
 
+// src/core/tracking.ts
+var PROTOCOL_VERSION = "1";
+var MAX_HITS_PER_MINUTE = 60;
+var MAX_URL_LENGTH = 2e3;
+var TRACKED = {
+  // Panel lifecycle — the owner's "is the widget used at all" funnel.
+  open: () => void 0,
+  close: () => void 0,
+  expand: (on) => ({ on }),
+  fullscreen: (on) => ({ on }),
+  popOut: () => void 0,
+  // Conversation funnel. `send` is the key conversion; text never rides.
+  send: (p33) => ({ attachments: p33.attachmentCount }),
+  message: (p33) => ({ role: p33.role }),
+  stop: () => void 0,
+  clear: () => void 0,
+  suggestion: () => void 0,
+  toggleHistory: (p33) => ({ view: p33.view }),
+  handshake: () => void 0,
+  // Forms + human-in-the-loop — ids and outcomes, never values.
+  formSubmit: (p33) => ({ formId: p33.formId, skipped: p33.skipped }),
+  toolResult: () => void 0,
+  toolDecision: (p33) => ({ approved: p33.approved }),
+  // Composer / attachments / voice.
+  attach: (p33) => ({ count: p33.count, bytes: p33.totalBytes }),
+  voiceStart: () => void 0,
+  voiceStop: (p33) => ({ ms: p33.durationMs }),
+  voiceCancel: () => void 0,
+  // Preferences — how visitors tune the surface.
+  localeChange: (locale) => ({ locale }),
+  themeChange: (theme) => ({ theme }),
+  textSizeChange: (size) => ({ size }),
+  soundToggle: (p33) => ({ muted: p33.muted }),
+  sidebarToggle: (p33) => ({ collapsed: p33.collapsed }),
+  calloutDismiss: () => void 0,
+  // Health signal only — the error object itself never leaves the page.
+  error: () => void 0
+};
+function privacySignalsOff() {
+  const nav = navigator;
+  return nav.globalPrivacyControl === true || nav.doNotTrack === "1";
+}
+function pageUrl() {
+  return location.origin + location.pathname;
+}
+function referrerOrigin() {
+  try {
+    return document.referrer ? new URL(document.referrer).origin : "";
+  } catch {
+    return "";
+  }
+}
+function createTracker(bus, deps) {
+  const sampleRoll = Math.random();
+  let windowStart = 0;
+  let windowHits = 0;
+  const inflight = /* @__PURE__ */ new Set();
+  const hit = (event, dims) => {
+    const { tracking, publicKey, aiAgentDeploymentId, mode, themeMode } = deps.getOptions();
+    if (!tracking.enabled || privacySignalsOff()) return;
+    if (sampleRoll >= tracking.sampleRate) return;
+    const now = performance.now();
+    if (now - windowStart > 6e4) {
+      windowStart = now;
+      windowHits = 0;
+    }
+    if (++windowHits > MAX_HITS_PER_MINUTE) return;
+    const params = new URLSearchParams();
+    params.set("v", PROTOCOL_VERSION);
+    params.set("e", event);
+    if (tracking.token) params.set("tk", tracking.token);
+    if (publicKey) params.set("pk", publicKey);
+    if (aiAgentDeploymentId) params.set("dep", aiAgentDeploymentId);
+    params.set("vid", deps.getVisitorId());
+    const cid = deps.getConversationId();
+    if (cid) params.set("cid", cid);
+    params.set("url", pageUrl());
+    const ref = referrerOrigin();
+    if (ref) params.set("ref", ref);
+    params.set("sw", String(screen.width));
+    params.set("sh", String(screen.height));
+    params.set("vw", String(innerWidth));
+    params.set("vh", String(innerHeight));
+    params.set("dpr", String(devicePixelRatio));
+    params.set("lang", navigator.language);
+    try {
+      params.set("tz", Intl.DateTimeFormat().resolvedOptions().timeZone);
+    } catch {
+    }
+    params.set("m", mode);
+    params.set("th", themeMode);
+    if (dims) {
+      for (const [k, val] of Object.entries(dims)) {
+        if (val !== void 0) params.set(k, String(val));
+      }
+    }
+    params.set("ts", String(Date.now()));
+    const url = `${tracking.endpoint}?${params}`;
+    if (url.length > MAX_URL_LENGTH) return;
+    const img = new Image(1, 1);
+    inflight.add(img);
+    const settle = () => inflight.delete(img);
+    img.addEventListener("load", settle, { once: true });
+    img.addEventListener("error", settle, { once: true });
+    img.src = url;
+  };
+  const offs = Object.keys(TRACKED).map(
+    (event) => bus.on(event, (payload) => hit(event, TRACKED[event]?.(payload)))
+  );
+  return () => {
+    for (const off of offs) off();
+    inflight.clear();
+  };
+}
+
 // src/core/hooks.ts
 var log19 = logger.scope("hooks");
 
@@ -7527,6 +7642,19 @@ var ChatElement = class extends HTMLElement {
      * same user-wins-per-field merge policy.
      */
     __publicField(this, "rawOptions", {});
+    /**
+     * Latest resolved options — refreshed every `renderApp()` so the usage
+     * tracker (created once in `boot`) reads live, post-handshake-merge
+     * values (`tracking.enabled` / `endpoint` / `token`).
+     *
+     * This path is independent of `mount()` (it supports N elements per page
+     * without a shared `widgetId` registry), so anything `mount()` wires onto
+     * the bus must be wired here too — the tracker is the current example;
+     * keep them in lockstep.
+     */
+    __publicField(this, "resolved", null);
+    /** Tracker unsubscribe — released on disconnect. */
+    __publicField(this, "untrack", null);
   }
   static get observedAttributes() {
     return REACTIVE_ATTRS;
@@ -7536,6 +7664,8 @@ var ChatElement = class extends HTMLElement {
   }
   disconnectedCallback() {
     if (!this.mountResult) return;
+    this.untrack?.();
+    this.untrack = null;
     render2(null, this.mountResult.appRoot);
     this.bus.clear();
   }
@@ -7555,6 +7685,12 @@ var ChatElement = class extends HTMLElement {
         this.rawOptions = mergeServerConfig(this.rawOptions, response.config);
         this.renderApp();
       });
+      const persistence = createPersistence(resolved.widgetId, resolved.storage);
+      this.untrack = createTracker(this.bus, {
+        getOptions: () => this.resolved ?? resolved,
+        getVisitorId: () => persistence.getVisitorId(),
+        getConversationId: () => persistence.loadConversationId()
+      });
     }
     this.renderApp();
   }
@@ -7565,6 +7701,7 @@ var ChatElement = class extends HTMLElement {
   renderApp() {
     if (!this.mountResult) return;
     const resolved = resolveOptions(this.rawOptions);
+    this.resolved = resolved;
     const host = this.mountResult.hostElement;
     applyHostPosition(host, hostPositionForMode(resolved.mode));
     const cachedThemeMode = createPersistence(resolved.widgetId, resolved.storage).loadUserPrefs().themeMode;