@helpway/react 0.12.1 → 0.13.1

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import * as react from 'react';
-import react__default, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _helpway_widget_core from '@helpway/widget-core';
 import { HelpwayMethods, WidgetTheme, WidgetStore } from '@helpway/widget-core';
 export { ConversationSummary, HelpwayAPI, RealtimeEvent, TimelineItem, WidgetEventName, WidgetEvents, WidgetPosition, WidgetState, WidgetStore, WidgetTheme, clearVisitorId, formatRelativeTime, formatTime, getInitials, getOrCreateVisitorId } from '@helpway/widget-core';
+import * as react from 'react';
+import react__default, { ReactNode } from 'react';
 import * as _helpway_types from '@helpway/types';
 import { TimelineItem, RealtimeEvent, TimelineItemPart, TimelineItemMetadata } from '@helpway/types';
 
@@ -28,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`).
@@ -75,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.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;
@@ -93,6 +99,7 @@ interface SupportProviderProps {
     apiUrl?: string;
     locale?: string;
     initialConversationId?: string;
+    deepLinkToken?: string;
     onReady?: (api: HelpwayMethods) => void;
     customLauncherSelector?: string;
     onOpen?: () => void;
@@ -118,7 +125,7 @@ interface SupportProviderProps {
  * Visitor identity is managed via server-side cookies (hw_visitor).
  * No localStorage or client-side ID management needed.
  */
-declare function SupportProvider({ apiKey, apiUrl, locale, initialConversationId, onReady, customLauncherSelector, onOpen, onClose, onUnreadChange, theme, children, }: SupportProviderProps): react.JSX.Element;
+declare function SupportProvider({ apiKey, apiUrl, locale, initialConversationId, deepLinkToken, onReady, customLauncherSelector, onOpen, onClose, onUnreadChange, theme, children, }: SupportProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Core widget state — connection status, visitor identity, website info.
@@ -264,14 +271,14 @@ declare function useRealtime(handler: (event: RealtimeEvent) => void): void;
 declare function WidgetLogo({ className, forceAgent, }: {
     className?: string;
     forceAgent?: boolean;
-}): react.JSX.Element;
+}): react_jsx_runtime.JSX.Element;
 /**
  * Unified support widget — Intercom-style with tab navigation.
  * Two tabs: Home + Messages. Sub-views: conversation + new conversation.
  */
 declare function DefaultWidget({ hideLauncher }?: {
     hideLauncher?: boolean;
-}): react.JSX.Element;
+}): react_jsx_runtime.JSX.Element;
 
 interface MessageBubbleProps {
     text: string;
@@ -285,7 +292,7 @@ interface MessageBubbleProps {
     onQuickReplyTap?: (optionId: string, stepId: string) => void;
 }
 /** Single message bubble — Intercom-style, renders text + image/file parts */
-declare function MessageBubble({ text, sender, senderName, parts, timestamp, metadata, onQuickReplyTap, }: MessageBubbleProps): react.JSX.Element;
+declare function MessageBubble({ text, sender, senderName, parts, timestamp, metadata, onQuickReplyTap, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListProps {
     items: TimelineItem[];
@@ -300,7 +307,7 @@ interface MessageListProps {
     renderAfterMessages?: react__default.ReactNode;
 }
 /** Timeline with date separators, typing indicator, infinite scroll, and AI processing state */
-declare function MessageList({ items, visitorName, isTyping, isAiProcessing, streamingText, hasMore, isLoadingMore, onLoadMore, renderAfterMessages, }: MessageListProps): react__default.JSX.Element;
+declare function MessageList({ items, visitorName, isTyping, isAiProcessing, streamingText, hasMore, isLoadingMore, onLoadMore, renderAfterMessages, }: MessageListProps): react_jsx_runtime.JSX.Element;
 
 interface ComposerProps {
     text: string;
@@ -321,7 +328,7 @@ interface ComposerProps {
     disabled?: boolean;
 }
 /** Widget composer — auto-resize, Enter-to-send, paste/drop attachments */
-declare function Composer({ text, onTextChange, onSubmit, onTyping, isSubmitting, placeholder, compact, attachments, onAddFiles, onRemoveAttachment, disabled, }: ComposerProps): react.JSX.Element;
+declare function Composer({ text, onTextChange, onSubmit, onTyping, isSubmitting, placeholder, compact, attachments, onAddFiles, onRemoveAttachment, disabled, }: ComposerProps): react_jsx_runtime.JSX.Element;
 
 /** Where the preview is anchored — controls only the outer positioning. */
 type MessagePreviewPlacement = "launcher" | "anchored";
@@ -372,7 +379,7 @@ interface MessagePreviewProps {
  *
  * Must be rendered inside `<SupportProvider>`.
  */
-declare function MessagePreview({ onOpen, avatar, placement, autoDismissMs, footer, }: MessagePreviewProps): react.JSX.Element | null;
+declare function MessagePreview({ onOpen, avatar, placement, autoDismissMs, footer, }: MessagePreviewProps): react_jsx_runtime.JSX.Element | null;
 
 /** Placement of the announcement stack — mirrors `MessagePreviewPlacement`. */
 type AnnouncementPreviewsPlacement = "launcher" | "anchored";
@@ -425,7 +432,7 @@ interface AnnouncementPreviewsProps {
  *
  * Must be rendered inside `<SupportProvider>`.
  */
-declare function AnnouncementPreviews({ onOpen, avatar, placement, footer, }: AnnouncementPreviewsProps): react.JSX.Element | null;
+declare function AnnouncementPreviews({ onOpen, avatar, placement, footer, }: AnnouncementPreviewsProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Lightweight Markdown → HTML renderer.
@@ -453,6 +460,6 @@ declare function MarkdownContent({ bodyHtml, bodyMarkdown, className, }: {
     bodyHtml?: string | null;
     bodyMarkdown?: string | null;
     className?: string;
-}): react.JSX.Element | null;
+}): react_jsx_runtime.JSX.Element | null;
 
 export { type AnnouncementPreviewEntry, AnnouncementPreviews, type AnnouncementPreviewsPlacement, type AnnouncementPreviewsProps, Composer, DefaultWidget, type HelpwayPublicAPI, HelpwayWidget, type HelpwayWidgetProps, type IdentifyData, MarkdownContent, MessageBubble, MessageList, MessagePreview, type MessagePreviewPlacement, type MessagePreviewProps, SupportProvider, WidgetLogo, linkifyText, renderMarkdown, useComposer, useConversations, useIdentify, usePresence, useRealtime, useTimeline, useUnread, useWidget, useWidgetStore };

package/dist/index.js

@@ -1030,6 +1030,7 @@ function SupportProvider({
   apiUrl,
   locale,
   initialConversationId,
+  deepLinkToken,
   onReady,
   customLauncherSelector,
   onOpen,
@@ -1159,8 +1160,29 @@ function SupportProvider({
           });
         }
         if (initialConversationId && !cancelled) {
-          store.getState().setActiveConversation(initialConversationId);
-          store.getState().setOpen(true);
+          if (deepLinkToken) {
+            try {
+              const redeemed = await client.widget.redeemDeepLink.mutate({ token: deepLinkToken });
+              if (!cancelled && redeemed?.visitorId && redeemed.visitorId !== data.visitor?.id) {
+                syncVisitorId(apiKey, redeemed.visitorId);
+                const freshData = await client.widget.bootstrap.query();
+                if (!cancelled) {
+                  store.getState().setReady(freshData.visitor, freshData.website, freshData.agentConfig);
+                  const freshConvs = await client.widget.listConversations.query();
+                  if (!cancelled) {
+                    store.getState().setConversations(
+                      freshConvs.conversations.map(mapConversation)
+                    );
+                  }
+                }
+              }
+            } catch {
+            }
+          }
+          if (!cancelled) {
+            store.getState().setActiveConversation(initialConversationId);
+            store.getState().setOpen(true);
+          }
         }
         emitter.emit("ready");
         onReady?.(initRef.current.api);
@@ -5506,6 +5528,7 @@ function HelpwayWidget({
   apiUrl,
   locale,
   initialConversationId,
+  deepLinkToken,
   onReady,
   hideLauncher,
   customLauncherSelector,
@@ -5524,6 +5547,7 @@ function HelpwayWidget({
       apiUrl: resolvedApiUrl,
       locale,
       initialConversationId,
+      deepLinkToken,
       onReady,
       customLauncherSelector,
       onOpen,