@helpway/react 0.13.0 → 0.13.2

package/dist/index.d.ts

@@ -29,6 +29,11 @@ interface HelpwayWidgetProps {
      * Usually sourced from `?hw_conv=` URL param for email CTAs.
      */
     initialConversationId?: string;
+    /**
+     * HMAC-signed token for cross-device visitor identity restoration.
+     * Sourced from `#hw_token=` URL fragment in email deep-links.
+     */
+    deepLinkToken?: string;
     /**
      * Called once after the widget has bootstrapped and exposes
      * the full programmatic API object (also available as `window.Helpway`).
@@ -76,7 +81,7 @@ type HelpwayPublicAPI = HelpwayMethods;
  * `layout.tsx`, or `main.tsx`). Unmounting cleanly tears down the
  * widget and its WebSocket connection — useful for route-scoped mounts.
  */
-declare function HelpwayWidget({ apiKey, apiUrl, locale, initialConversationId, onReady, hideLauncher, customLauncherSelector, onOpen, onClose, onUnreadChange, theme, src, }: HelpwayWidgetProps): react_jsx_runtime.JSX.Element;
+declare function HelpwayWidget({ apiKey, apiUrl, locale, initialConversationId, deepLinkToken, onReady, hideLauncher, customLauncherSelector, onOpen, onClose, onUnreadChange, theme, src, }: HelpwayWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface IdentifyData {
     externalId: string;

package/dist/index.js

@@ -335,7 +335,10 @@ function createWidgetStore() {
         next.set(
           conversationId,
           existing.map(
-            (m) => m.id === oldId ? { ...item, _stableKey: m._stableKey ?? oldId } : m
+            (m) => m.id === oldId ? {
+              ...item,
+              _stableKey: m._stableKey ?? oldId
+            } : m
           )
         );
         return { messages: next };
@@ -369,9 +372,21 @@ function createWidgetStore() {
           merged.push(m);
           if (isAgentMsg(m) && merged.length === 1) keptAgentWelcome = true;
         }
+        const serverVisitorTs = existingItems.find((x) => x.visitorId)?.createdAt;
+        let graftedWelcome = false;
         for (const m of existingItems) {
           if (seen.has(m.id)) continue;
-          if (isAgentMsg(m) && keptAgentWelcome) continue;
+          const isWelcomeEcho = isAgentMsg(m) && keptAgentWelcome && !graftedWelcome && (!serverVisitorTs || m.createdAt <= serverVisitorTs);
+          if (isWelcomeEcho) {
+            const seed = merged[0];
+            merged[0] = {
+              ...m,
+              _stableKey: seed ? seed._stableKey ?? seed.id : m.id
+            };
+            seen.add(m.id);
+            graftedWelcome = true;
+            continue;
+          }
           seen.add(m.id);
           merged.push(m);
         }
@@ -484,9 +499,14 @@ function createWidgetStore() {
             const isAgentAuthored = !!event.item.aiAgentId && !event.item.visitorId && !event.item.userId;
             const existing = state.messages.get(event.conversationId);
             const seedId = existing?.[0]?.id;
-            const isSeedWelcomeEcho = isAgentAuthored && !!existing && existing.length === 1 && typeof seedId === "string" && seedId.startsWith("seed-welcome-") && seedId !== event.item.id;
-            if (isSeedWelcomeEcho) {
-              break;
+            const hasSeedWelcome = typeof seedId === "string" && seedId.startsWith("seed-welcome-");
+            if (isAgentAuthored && hasSeedWelcome) {
+              const firstVisitorTs = existing?.find((m) => m.visitorId)?.createdAt;
+              const isWelcomeEcho = !firstVisitorTs || event.item.createdAt <= firstVisitorTs;
+              if (isWelcomeEcho) {
+                state.replaceMessage(event.conversationId, seedId, event.item);
+                break;
+              }
             }
             state.addMessage(event.conversationId, event.item);
           }
@@ -4954,6 +4974,7 @@ function DefaultWidget({ hideLauncher = false } = {}) {
                       onSelectEntry: (slug) => {
                         setContentDetailSlug(slug);
                         setSubView("content-detail");
+                        markEntrySeen(slug);
                       },
                       onSelectCategory: (cat) => {
                         setContentCategoryName(cat.title);
@@ -5528,6 +5549,7 @@ function HelpwayWidget({
   apiUrl,
   locale,
   initialConversationId,
+  deepLinkToken,
   onReady,
   hideLauncher,
   customLauncherSelector,
@@ -5546,6 +5568,7 @@ function HelpwayWidget({
       apiUrl: resolvedApiUrl,
       locale,
       initialConversationId,
+      deepLinkToken,
       onReady,
       customLauncherSelector,
       onOpen,