@customerhero/js 2.3.0 → 2.4.1

package/dist/index.cjs

@@ -105,7 +105,10 @@ var en = {
   drop_files_here: "Drop files here",
   incident_dismiss: "Dismiss",
   incident_default_link_label: "Learn more",
-  attachment_unsupported_type: "Unsupported file type"
+  attachment_unsupported_type: "Unsupported file type",
+  attachment_open: "Open attachment",
+  attachment_image_alt: "Image attachment",
+  attachment_location: "Shared location"
 };
 
 // src/i18n/locales/es.ts
@@ -136,7 +139,10 @@ var es = {
   drop_files_here: "Suelta los archivos aqu\xED",
   incident_dismiss: "Descartar",
   incident_default_link_label: "M\xE1s informaci\xF3n",
-  attachment_unsupported_type: "Tipo de archivo no admitido"
+  attachment_unsupported_type: "Tipo de archivo no admitido",
+  attachment_open: "Abrir adjunto",
+  attachment_image_alt: "Imagen adjunta",
+  attachment_location: "Ubicaci\xF3n compartida"
 };
 
 // src/i18n/locales/pt-BR.ts
@@ -167,7 +173,10 @@ var ptBR = {
   drop_files_here: "Solte os arquivos aqui",
   incident_dismiss: "Dispensar",
   incident_default_link_label: "Saiba mais",
-  attachment_unsupported_type: "Tipo de arquivo n\xE3o suportado"
+  attachment_unsupported_type: "Tipo de arquivo n\xE3o suportado",
+  attachment_open: "Abrir anexo",
+  attachment_image_alt: "Imagem anexada",
+  attachment_location: "Localiza\xE7\xE3o compartilhada"
 };
 
 // src/i18n/locales/pt-PT.ts
@@ -198,7 +207,10 @@ var ptPT = {
   drop_files_here: "Largue os ficheiros aqui",
   incident_dismiss: "Dispensar",
   incident_default_link_label: "Saiba mais",
-  attachment_unsupported_type: "Tipo de ficheiro n\xE3o suportado"
+  attachment_unsupported_type: "Tipo de ficheiro n\xE3o suportado",
+  attachment_open: "Abrir anexo",
+  attachment_image_alt: "Imagem anexa",
+  attachment_location: "Localiza\xE7\xE3o partilhada"
 };
 
 // src/i18n/locales/fr.ts
@@ -229,7 +241,10 @@ var fr = {
   drop_files_here: "D\xE9posez les fichiers ici",
   incident_dismiss: "Ignorer",
   incident_default_link_label: "En savoir plus",
-  attachment_unsupported_type: "Type de fichier non pris en charge"
+  attachment_unsupported_type: "Type de fichier non pris en charge",
+  attachment_open: "Ouvrir la pi\xE8ce jointe",
+  attachment_image_alt: "Pi\xE8ce jointe (image)",
+  attachment_location: "Position partag\xE9e"
 };
 
 // src/i18n/locales/de.ts
@@ -260,7 +275,10 @@ var de = {
   drop_files_here: "Dateien hier ablegen",
   incident_dismiss: "Schlie\xDFen",
   incident_default_link_label: "Mehr erfahren",
-  attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt"
+  attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt",
+  attachment_open: "Anhang \xF6ffnen",
+  attachment_image_alt: "Bildanhang",
+  attachment_location: "Geteilter Standort"
 };
 
 // src/i18n/locales/it.ts
@@ -291,7 +309,10 @@ var it = {
   drop_files_here: "Trascina qui i file",
   incident_dismiss: "Chiudi",
   incident_default_link_label: "Scopri di pi\xF9",
-  attachment_unsupported_type: "Tipo di file non supportato"
+  attachment_unsupported_type: "Tipo di file non supportato",
+  attachment_open: "Apri allegato",
+  attachment_image_alt: "Allegato immagine",
+  attachment_location: "Posizione condivisa"
 };
 
 // src/i18n/locales/nl.ts
@@ -322,7 +343,10 @@ var nl = {
   drop_files_here: "Sleep bestanden hier",
   incident_dismiss: "Sluiten",
   incident_default_link_label: "Meer informatie",
-  attachment_unsupported_type: "Bestandstype niet ondersteund"
+  attachment_unsupported_type: "Bestandstype niet ondersteund",
+  attachment_open: "Bijlage openen",
+  attachment_image_alt: "Afbeeldingsbijlage",
+  attachment_location: "Gedeelde locatie"
 };
 
 // src/i18n/locales/pl.ts
@@ -353,7 +377,10 @@ var pl = {
   drop_files_here: "Upu\u015B\u0107 pliki tutaj",
   incident_dismiss: "Zamknij",
   incident_default_link_label: "Dowiedz si\u0119 wi\u0119cej",
-  attachment_unsupported_type: "Nieobs\u0142ugiwany typ pliku"
+  attachment_unsupported_type: "Nieobs\u0142ugiwany typ pliku",
+  attachment_open: "Otw\xF3rz za\u0142\u0105cznik",
+  attachment_image_alt: "Za\u0142\u0105cznik obrazu",
+  attachment_location: "Udost\u0119pniona lokalizacja"
 };
 
 // src/i18n/locales/tr.ts
@@ -384,7 +411,10 @@ var tr = {
   drop_files_here: "Dosyalar\u0131 buraya b\u0131rak",
   incident_dismiss: "Kapat",
   incident_default_link_label: "Daha fazla bilgi",
-  attachment_unsupported_type: "Desteklenmeyen dosya t\xFCr\xFC"
+  attachment_unsupported_type: "Desteklenmeyen dosya t\xFCr\xFC",
+  attachment_open: "Eki a\xE7",
+  attachment_image_alt: "Resim eki",
+  attachment_location: "Payla\u015F\u0131lan konum"
 };
 
 // src/i18n/locales/ar.ts
@@ -415,7 +445,10 @@ var ar = {
   drop_files_here: "\u0623\u0641\u0644\u062A \u0627\u0644\u0645\u0644\u0641\u0627\u062A \u0647\u0646\u0627",
   incident_dismiss: "\u0625\u063A\u0644\u0627\u0642",
   incident_default_link_label: "\u0627\u0639\u0631\u0641 \u0627\u0644\u0645\u0632\u064A\u062F",
-  attachment_unsupported_type: "\u0646\u0648\u0639 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u062F\u0639\u0648\u0645"
+  attachment_unsupported_type: "\u0646\u0648\u0639 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u062F\u0639\u0648\u0645",
+  attachment_open: "\u0641\u062A\u062D \u0627\u0644\u0645\u0631\u0641\u0642",
+  attachment_image_alt: "\u0635\u0648\u0631\u0629 \u0645\u0631\u0641\u0642\u0629",
+  attachment_location: "\u0645\u0648\u0642\u0639 \u0645\u0634\u062A\u0631\u0643"
 };
 
 // src/i18n/locales/ja.ts
@@ -446,7 +479,10 @@ var ja = {
   drop_files_here: "\u30D5\u30A1\u30A4\u30EB\u3092\u3053\u3053\u306B\u30C9\u30ED\u30C3\u30D7",
   incident_dismiss: "\u9589\u3058\u308B",
   incident_default_link_label: "\u8A73\u7D30\u3092\u898B\u308B",
-  attachment_unsupported_type: "\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F"
+  attachment_unsupported_type: "\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F",
+  attachment_open: "\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u304F",
+  attachment_image_alt: "\u753B\u50CF\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB",
+  attachment_location: "\u5171\u6709\u3055\u308C\u305F\u4F4D\u7F6E\u60C5\u5831"
 };
 
 // src/i18n/locales/ko.ts
@@ -477,7 +513,10 @@ var ko = {
   drop_files_here: "\uD30C\uC77C\uC744 \uC5EC\uAE30\uC5D0 \uB193\uAE30",
   incident_dismiss: "\uB2EB\uAE30",
   incident_default_link_label: "\uC790\uC138\uD788 \uC54C\uC544\uBCF4\uAE30",
-  attachment_unsupported_type: "\uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD"
+  attachment_unsupported_type: "\uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD",
+  attachment_open: "\uCCA8\uBD80 \uD30C\uC77C \uC5F4\uAE30",
+  attachment_image_alt: "\uC774\uBBF8\uC9C0 \uCCA8\uBD80 \uD30C\uC77C",
+  attachment_location: "\uACF5\uC720\uB41C \uC704\uCE58"
 };
 
 // src/i18n/locales/zh-CN.ts
@@ -508,7 +547,10 @@ var zhCN = {
   drop_files_here: "\u5C06\u6587\u4EF6\u62D6\u653E\u5230\u6B64\u5904",
   incident_dismiss: "\u5173\u95ED",
   incident_default_link_label: "\u4E86\u89E3\u66F4\u591A",
-  attachment_unsupported_type: "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B"
+  attachment_unsupported_type: "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B",
+  attachment_open: "\u6253\u5F00\u9644\u4EF6",
+  attachment_image_alt: "\u56FE\u7247\u9644\u4EF6",
+  attachment_location: "\u5171\u4EAB\u7684\u4F4D\u7F6E"
 };
 
 // src/i18n/locales/zh-TW.ts
@@ -539,7 +581,10 @@ var zhTW = {
   drop_files_here: "\u5C07\u6A94\u6848\u62D6\u653E\u5230\u6B64\u8655",
   incident_dismiss: "\u95DC\u9589",
   incident_default_link_label: "\u77AD\u89E3\u66F4\u591A",
-  attachment_unsupported_type: "\u4E0D\u652F\u63F4\u7684\u6A94\u6848\u985E\u578B"
+  attachment_unsupported_type: "\u4E0D\u652F\u63F4\u7684\u6A94\u6848\u985E\u578B",
+  attachment_open: "\u958B\u555F\u9644\u4EF6",
+  attachment_image_alt: "\u5716\u7247\u9644\u4EF6",
+  attachment_location: "\u5171\u4EAB\u7684\u4F4D\u7F6E"
 };
 
 // src/i18n/index.ts
@@ -1319,12 +1364,15 @@ var CustomerHeroChat = class {
     const { chatbotId, apiBase } = this.state.config;
     const { conversationId } = this.state;
     if (!conversationId) return;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const messagesUrl = `${apiBase}/api/chat/${chatbotId}/messages/${conversationId}`;
     try {
       const response = await fetch(
-        `${apiBase}/api/chat/${chatbotId}/messages/${conversationId}`
+        readToken ? `${messagesUrl}?t=${encodeURIComponent(readToken)}` : messagesUrl
       );
       if (!response.ok) {
         this.storage?.removeItem(`ch_conv_${chatbotId}`);
+        this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
         this.setState({ conversationId: null });
         return;
       }
@@ -1336,7 +1384,8 @@ var CustomerHeroChat = class {
         content: m.content,
         ...m.sources ? { sources: m.sources } : {},
         ...m.blocks ? { blocks: m.blocks } : {},
-        ...m.suggestions ? { suggestions: m.suggestions } : {}
+        ...m.suggestions ? { suggestions: m.suggestions } : {},
+        ...m.attachments?.length ? { attachments: m.attachments } : {}
       }));
       const lastBotIndex = findLastIndex(
         messages,
@@ -1389,12 +1438,14 @@ var CustomerHeroChat = class {
     });
     const { chatbotId, apiBase } = this.state.config;
     let botMessageCreated = false;
+    const continuationReadToken = this.state.conversationId ? this.storage?.getItem(`ch_conv_token_${chatbotId}`) : null;
     try {
       const response = await fetch(`${apiBase}/api/chat/${chatbotId}`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          Accept: "text/event-stream"
+          Accept: "text/event-stream",
+          ...continuationReadToken ? { "X-CH-Read-Token": continuationReadToken } : {}
         },
         body: JSON.stringify({
           message: trimmed,
@@ -1440,6 +1491,16 @@ var CustomerHeroChat = class {
             }
             break;
           }
+          case "read-token": {
+            const tok = safeParse(evt.data);
+            if (tok?.readToken) {
+              this.storage?.setItem(
+                `ch_conv_token_${chatbotId}`,
+                tok.readToken
+              );
+            }
+            break;
+          }
           case "token": {
             const tok = safeParse(evt.data);
             const text = tok?.text ?? "";
@@ -1552,6 +1613,9 @@ var CustomerHeroChat = class {
       await this.loadHistory();
       return;
     }
+    const decisionBlock = this.state.messages[targetIndex].blocks?.find(
+      (b) => b.type === "action_confirmation" && b.pendingToolCallId === pendingId
+    );
     const messages = this.state.messages.slice();
     const original = messages[targetIndex];
     messages[targetIndex] = {
@@ -1560,7 +1624,10 @@ var CustomerHeroChat = class {
     };
     this.setState({ messages, error: null });
     const { chatbotId, apiBase } = this.state.config;
-    const url = `${apiBase}/api/chat/${chatbotId}/tool-calls/${pendingId}/decision`;
+    const href = decision === "approve" ? decisionBlock?.approveHref : decisionBlock?.cancelHref;
+    const baseUrl = href ? `${apiBase}${href}` : `${apiBase}/api/chat/${chatbotId}/tool-calls/${pendingId}/decision`;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const url = readToken ? `${baseUrl}${baseUrl.includes("?") ? "&" : "?"}t=${encodeURIComponent(readToken)}` : baseUrl;
     try {
       const response = await fetch(url, {
         method: "POST",
@@ -1592,6 +1659,16 @@ var CustomerHeroChat = class {
             }
             break;
           }
+          case "read-token": {
+            const tok = safeParse(evt.data);
+            if (tok?.readToken) {
+              this.storage?.setItem(
+                `ch_conv_token_${chatbotId}`,
+                tok.readToken
+              );
+            }
+            break;
+          }
           case "token": {
             const tok = safeParse(evt.data);
             const text = tok?.text ?? "";
@@ -1668,8 +1745,10 @@ var CustomerHeroChat = class {
     const { chatbotId, apiBase } = this.state.config;
     const { conversationId } = this.state;
     if (!conversationId) return;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const url = readToken ? `${apiBase}/api/chat/${chatbotId}/feedback?t=${encodeURIComponent(readToken)}` : `${apiBase}/api/chat/${chatbotId}/feedback`;
     try {
-      await fetch(`${apiBase}/api/chat/${chatbotId}/rate`, {
+      await fetch(url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ conversationId, messageId, rating })
@@ -1698,6 +1777,7 @@ var CustomerHeroChat = class {
   reset() {
     const { chatbotId, welcomeMessage } = this.state.config;
     this.storage?.removeItem(`ch_conv_${chatbotId}`);
+    this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
     this.setState({
       messages: welcomeMessage ? [{ role: "bot", content: welcomeMessage }] : [],
       conversationId: null,
@@ -1865,6 +1945,7 @@ var CustomerHeroChat = class {
     };
     const { chatbotId, welcomeMessage } = this.state.config;
     this.storage?.removeItem(`ch_conv_${chatbotId}`);
+    this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
     this.setState({
       messages: welcomeMessage ? [{ role: "bot", content: welcomeMessage }] : [],
       conversationId: null,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-type TranslationKey = "online" | "typing" | "unable_to_load" | "powered_by" | "new_conversation" | "open_chat" | "close_chat" | "send_message" | "helpful" | "not_helpful" | "menu" | "action_approve" | "action_cancel" | "action_what_will_happen" | "action_already_resolved" | "action_failed" | "status_sending" | "status_sent" | "status_failed" | "screenshot_capture" | "attachment_remove" | "attach_menu_open" | "attach_photo" | "drop_files_here" | "attachment_unsupported_type" | "incident_dismiss" | "incident_default_link_label";
+type TranslationKey = "online" | "typing" | "unable_to_load" | "powered_by" | "new_conversation" | "open_chat" | "close_chat" | "send_message" | "helpful" | "not_helpful" | "menu" | "action_approve" | "action_cancel" | "action_what_will_happen" | "action_already_resolved" | "action_failed" | "status_sending" | "status_sent" | "status_failed" | "screenshot_capture" | "attachment_remove" | "attach_menu_open" | "attach_photo" | "drop_files_here" | "attachment_unsupported_type" | "attachment_open" | "attachment_image_alt" | "attachment_location" | "incident_dismiss" | "incident_default_link_label";
 type Translations = Record<TranslationKey, string>;
 
 declare const SUPPORTED_LOCALES: readonly ["en", "es", "pt-BR", "pt-PT", "fr", "de", "it", "nl", "pl", "tr", "ar", "ja", "ko", "zh-CN", "zh-TW"];
@@ -137,6 +137,27 @@ type ActionConfirmationBlock = {
 };
 type MessageBlock = QuickRepliesBlock | ActionConfirmationBlock;
 type MessageStatus = "sending" | "sent" | "failed";
+/**
+ * Attachment hung off a historical message. The widget only ever uploads
+ * `image` and `document` kinds, but inbox agents can attach `audio` /
+ * `video` / `location` from the dashboard, and the history endpoint returns
+ * everything the conversation has accumulated.
+ */
+interface MessageAttachment {
+    id: string;
+    kind: "image" | "document" | "audio" | "video" | "location";
+    mimeType: string | null;
+    filename: string | null;
+    sizeBytes: number | null;
+    /** Public R2 URL. Null for `location` attachments (use `location` instead). */
+    url: string | null;
+    /** Geo payload for `location` attachments. */
+    location: {
+        label?: string | null;
+        latitude: number;
+        longitude: number;
+    } | null;
+}
 interface ChatMessage {
     /** Message ID from the API (only present for bot messages) */
     id?: string;
@@ -151,6 +172,11 @@ interface ChatMessage {
      * tappable chips under the most recent bot message only.
      */
     suggestions?: string[];
+    /**
+     * Files / screenshots / locations attached to this message. Populated from
+     * the history endpoint on conversation reload.
+     */
+    attachments?: MessageAttachment[];
     /** True while this message is still receiving streaming tokens. */
     streaming?: boolean;
     /**
@@ -617,4 +643,4 @@ interface StartTriggersRuntimeOptions {
 }
 declare function startTriggersRuntime(options: StartTriggersRuntimeOptions): TriggersRuntimeHandle;
 
-export { type ActionConfirmationBlock, CORNER_RADIUS, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type EffectiveScheme, type IdentifyPayload, type IdentityData, type IncidentBanner, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, SIZE_PRESETS, SUPPORTED_LOCALES, ScreenshotCancelled, ScreenshotUnavailable, type StringOverrides, type SupportedLocale, type TranslateFn, type TranslationKey, type Translations, type TriggerAction, type TriggerConditionLeaf, type TriggerConditionNode, type TriggerDefinition, type TriggerFrequency, type TriggersRuntimeHandle, type VisitorContext, canCaptureScreenshot, captureScreenshot, createTranslator, detectLocale, effectiveColors, evaluate, isRtlLocale, panelRadius, pickFire, resolveLocale, resolveScheme, sizePreset, startTriggersRuntime };
+export { type ActionConfirmationBlock, CORNER_RADIUS, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type EffectiveScheme, type IdentifyPayload, type IdentityData, type IncidentBanner, type MessageAttachment, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, SIZE_PRESETS, SUPPORTED_LOCALES, ScreenshotCancelled, ScreenshotUnavailable, type StringOverrides, type SupportedLocale, type TranslateFn, type TranslationKey, type Translations, type TriggerAction, type TriggerConditionLeaf, type TriggerConditionNode, type TriggerDefinition, type TriggerFrequency, type TriggersRuntimeHandle, type VisitorContext, canCaptureScreenshot, captureScreenshot, createTranslator, detectLocale, effectiveColors, evaluate, isRtlLocale, panelRadius, pickFire, resolveLocale, resolveScheme, sizePreset, startTriggersRuntime };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type TranslationKey = "online" | "typing" | "unable_to_load" | "powered_by" | "new_conversation" | "open_chat" | "close_chat" | "send_message" | "helpful" | "not_helpful" | "menu" | "action_approve" | "action_cancel" | "action_what_will_happen" | "action_already_resolved" | "action_failed" | "status_sending" | "status_sent" | "status_failed" | "screenshot_capture" | "attachment_remove" | "attach_menu_open" | "attach_photo" | "drop_files_here" | "attachment_unsupported_type" | "incident_dismiss" | "incident_default_link_label";
+type TranslationKey = "online" | "typing" | "unable_to_load" | "powered_by" | "new_conversation" | "open_chat" | "close_chat" | "send_message" | "helpful" | "not_helpful" | "menu" | "action_approve" | "action_cancel" | "action_what_will_happen" | "action_already_resolved" | "action_failed" | "status_sending" | "status_sent" | "status_failed" | "screenshot_capture" | "attachment_remove" | "attach_menu_open" | "attach_photo" | "drop_files_here" | "attachment_unsupported_type" | "attachment_open" | "attachment_image_alt" | "attachment_location" | "incident_dismiss" | "incident_default_link_label";
 type Translations = Record<TranslationKey, string>;
 
 declare const SUPPORTED_LOCALES: readonly ["en", "es", "pt-BR", "pt-PT", "fr", "de", "it", "nl", "pl", "tr", "ar", "ja", "ko", "zh-CN", "zh-TW"];
@@ -137,6 +137,27 @@ type ActionConfirmationBlock = {
 };
 type MessageBlock = QuickRepliesBlock | ActionConfirmationBlock;
 type MessageStatus = "sending" | "sent" | "failed";
+/**
+ * Attachment hung off a historical message. The widget only ever uploads
+ * `image` and `document` kinds, but inbox agents can attach `audio` /
+ * `video` / `location` from the dashboard, and the history endpoint returns
+ * everything the conversation has accumulated.
+ */
+interface MessageAttachment {
+    id: string;
+    kind: "image" | "document" | "audio" | "video" | "location";
+    mimeType: string | null;
+    filename: string | null;
+    sizeBytes: number | null;
+    /** Public R2 URL. Null for `location` attachments (use `location` instead). */
+    url: string | null;
+    /** Geo payload for `location` attachments. */
+    location: {
+        label?: string | null;
+        latitude: number;
+        longitude: number;
+    } | null;
+}
 interface ChatMessage {
     /** Message ID from the API (only present for bot messages) */
     id?: string;
@@ -151,6 +172,11 @@ interface ChatMessage {
      * tappable chips under the most recent bot message only.
      */
     suggestions?: string[];
+    /**
+     * Files / screenshots / locations attached to this message. Populated from
+     * the history endpoint on conversation reload.
+     */
+    attachments?: MessageAttachment[];
     /** True while this message is still receiving streaming tokens. */
     streaming?: boolean;
     /**
@@ -617,4 +643,4 @@ interface StartTriggersRuntimeOptions {
 }
 declare function startTriggersRuntime(options: StartTriggersRuntimeOptions): TriggersRuntimeHandle;
 
-export { type ActionConfirmationBlock, CORNER_RADIUS, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type EffectiveScheme, type IdentifyPayload, type IdentityData, type IncidentBanner, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, SIZE_PRESETS, SUPPORTED_LOCALES, ScreenshotCancelled, ScreenshotUnavailable, type StringOverrides, type SupportedLocale, type TranslateFn, type TranslationKey, type Translations, type TriggerAction, type TriggerConditionLeaf, type TriggerConditionNode, type TriggerDefinition, type TriggerFrequency, type TriggersRuntimeHandle, type VisitorContext, canCaptureScreenshot, captureScreenshot, createTranslator, detectLocale, effectiveColors, evaluate, isRtlLocale, panelRadius, pickFire, resolveLocale, resolveScheme, sizePreset, startTriggersRuntime };
+export { type ActionConfirmationBlock, CORNER_RADIUS, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type EffectiveScheme, type IdentifyPayload, type IdentityData, type IncidentBanner, type MessageAttachment, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, SIZE_PRESETS, SUPPORTED_LOCALES, ScreenshotCancelled, ScreenshotUnavailable, type StringOverrides, type SupportedLocale, type TranslateFn, type TranslationKey, type Translations, type TriggerAction, type TriggerConditionLeaf, type TriggerConditionNode, type TriggerDefinition, type TriggerFrequency, type TriggersRuntimeHandle, type VisitorContext, canCaptureScreenshot, captureScreenshot, createTranslator, detectLocale, effectiveColors, evaluate, isRtlLocale, panelRadius, pickFire, resolveLocale, resolveScheme, sizePreset, startTriggersRuntime };

package/dist/index.js

@@ -60,7 +60,10 @@ var en = {
   drop_files_here: "Drop files here",
   incident_dismiss: "Dismiss",
   incident_default_link_label: "Learn more",
-  attachment_unsupported_type: "Unsupported file type"
+  attachment_unsupported_type: "Unsupported file type",
+  attachment_open: "Open attachment",
+  attachment_image_alt: "Image attachment",
+  attachment_location: "Shared location"
 };
 
 // src/i18n/locales/es.ts
@@ -91,7 +94,10 @@ var es = {
   drop_files_here: "Suelta los archivos aqu\xED",
   incident_dismiss: "Descartar",
   incident_default_link_label: "M\xE1s informaci\xF3n",
-  attachment_unsupported_type: "Tipo de archivo no admitido"
+  attachment_unsupported_type: "Tipo de archivo no admitido",
+  attachment_open: "Abrir adjunto",
+  attachment_image_alt: "Imagen adjunta",
+  attachment_location: "Ubicaci\xF3n compartida"
 };
 
 // src/i18n/locales/pt-BR.ts
@@ -122,7 +128,10 @@ var ptBR = {
   drop_files_here: "Solte os arquivos aqui",
   incident_dismiss: "Dispensar",
   incident_default_link_label: "Saiba mais",
-  attachment_unsupported_type: "Tipo de arquivo n\xE3o suportado"
+  attachment_unsupported_type: "Tipo de arquivo n\xE3o suportado",
+  attachment_open: "Abrir anexo",
+  attachment_image_alt: "Imagem anexada",
+  attachment_location: "Localiza\xE7\xE3o compartilhada"
 };
 
 // src/i18n/locales/pt-PT.ts
@@ -153,7 +162,10 @@ var ptPT = {
   drop_files_here: "Largue os ficheiros aqui",
   incident_dismiss: "Dispensar",
   incident_default_link_label: "Saiba mais",
-  attachment_unsupported_type: "Tipo de ficheiro n\xE3o suportado"
+  attachment_unsupported_type: "Tipo de ficheiro n\xE3o suportado",
+  attachment_open: "Abrir anexo",
+  attachment_image_alt: "Imagem anexa",
+  attachment_location: "Localiza\xE7\xE3o partilhada"
 };
 
 // src/i18n/locales/fr.ts
@@ -184,7 +196,10 @@ var fr = {
   drop_files_here: "D\xE9posez les fichiers ici",
   incident_dismiss: "Ignorer",
   incident_default_link_label: "En savoir plus",
-  attachment_unsupported_type: "Type de fichier non pris en charge"
+  attachment_unsupported_type: "Type de fichier non pris en charge",
+  attachment_open: "Ouvrir la pi\xE8ce jointe",
+  attachment_image_alt: "Pi\xE8ce jointe (image)",
+  attachment_location: "Position partag\xE9e"
 };
 
 // src/i18n/locales/de.ts
@@ -215,7 +230,10 @@ var de = {
   drop_files_here: "Dateien hier ablegen",
   incident_dismiss: "Schlie\xDFen",
   incident_default_link_label: "Mehr erfahren",
-  attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt"
+  attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt",
+  attachment_open: "Anhang \xF6ffnen",
+  attachment_image_alt: "Bildanhang",
+  attachment_location: "Geteilter Standort"
 };
 
 // src/i18n/locales/it.ts
@@ -246,7 +264,10 @@ var it = {
   drop_files_here: "Trascina qui i file",
   incident_dismiss: "Chiudi",
   incident_default_link_label: "Scopri di pi\xF9",
-  attachment_unsupported_type: "Tipo di file non supportato"
+  attachment_unsupported_type: "Tipo di file non supportato",
+  attachment_open: "Apri allegato",
+  attachment_image_alt: "Allegato immagine",
+  attachment_location: "Posizione condivisa"
 };
 
 // src/i18n/locales/nl.ts
@@ -277,7 +298,10 @@ var nl = {
   drop_files_here: "Sleep bestanden hier",
   incident_dismiss: "Sluiten",
   incident_default_link_label: "Meer informatie",
-  attachment_unsupported_type: "Bestandstype niet ondersteund"
+  attachment_unsupported_type: "Bestandstype niet ondersteund",
+  attachment_open: "Bijlage openen",
+  attachment_image_alt: "Afbeeldingsbijlage",
+  attachment_location: "Gedeelde locatie"
 };
 
 // src/i18n/locales/pl.ts
@@ -308,7 +332,10 @@ var pl = {
   drop_files_here: "Upu\u015B\u0107 pliki tutaj",
   incident_dismiss: "Zamknij",
   incident_default_link_label: "Dowiedz si\u0119 wi\u0119cej",
-  attachment_unsupported_type: "Nieobs\u0142ugiwany typ pliku"
+  attachment_unsupported_type: "Nieobs\u0142ugiwany typ pliku",
+  attachment_open: "Otw\xF3rz za\u0142\u0105cznik",
+  attachment_image_alt: "Za\u0142\u0105cznik obrazu",
+  attachment_location: "Udost\u0119pniona lokalizacja"
 };
 
 // src/i18n/locales/tr.ts
@@ -339,7 +366,10 @@ var tr = {
   drop_files_here: "Dosyalar\u0131 buraya b\u0131rak",
   incident_dismiss: "Kapat",
   incident_default_link_label: "Daha fazla bilgi",
-  attachment_unsupported_type: "Desteklenmeyen dosya t\xFCr\xFC"
+  attachment_unsupported_type: "Desteklenmeyen dosya t\xFCr\xFC",
+  attachment_open: "Eki a\xE7",
+  attachment_image_alt: "Resim eki",
+  attachment_location: "Payla\u015F\u0131lan konum"
 };
 
 // src/i18n/locales/ar.ts
@@ -370,7 +400,10 @@ var ar = {
   drop_files_here: "\u0623\u0641\u0644\u062A \u0627\u0644\u0645\u0644\u0641\u0627\u062A \u0647\u0646\u0627",
   incident_dismiss: "\u0625\u063A\u0644\u0627\u0642",
   incident_default_link_label: "\u0627\u0639\u0631\u0641 \u0627\u0644\u0645\u0632\u064A\u062F",
-  attachment_unsupported_type: "\u0646\u0648\u0639 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u062F\u0639\u0648\u0645"
+  attachment_unsupported_type: "\u0646\u0648\u0639 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u062F\u0639\u0648\u0645",
+  attachment_open: "\u0641\u062A\u062D \u0627\u0644\u0645\u0631\u0641\u0642",
+  attachment_image_alt: "\u0635\u0648\u0631\u0629 \u0645\u0631\u0641\u0642\u0629",
+  attachment_location: "\u0645\u0648\u0642\u0639 \u0645\u0634\u062A\u0631\u0643"
 };
 
 // src/i18n/locales/ja.ts
@@ -401,7 +434,10 @@ var ja = {
   drop_files_here: "\u30D5\u30A1\u30A4\u30EB\u3092\u3053\u3053\u306B\u30C9\u30ED\u30C3\u30D7",
   incident_dismiss: "\u9589\u3058\u308B",
   incident_default_link_label: "\u8A73\u7D30\u3092\u898B\u308B",
-  attachment_unsupported_type: "\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F"
+  attachment_unsupported_type: "\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F",
+  attachment_open: "\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u304F",
+  attachment_image_alt: "\u753B\u50CF\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB",
+  attachment_location: "\u5171\u6709\u3055\u308C\u305F\u4F4D\u7F6E\u60C5\u5831"
 };
 
 // src/i18n/locales/ko.ts
@@ -432,7 +468,10 @@ var ko = {
   drop_files_here: "\uD30C\uC77C\uC744 \uC5EC\uAE30\uC5D0 \uB193\uAE30",
   incident_dismiss: "\uB2EB\uAE30",
   incident_default_link_label: "\uC790\uC138\uD788 \uC54C\uC544\uBCF4\uAE30",
-  attachment_unsupported_type: "\uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD"
+  attachment_unsupported_type: "\uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD",
+  attachment_open: "\uCCA8\uBD80 \uD30C\uC77C \uC5F4\uAE30",
+  attachment_image_alt: "\uC774\uBBF8\uC9C0 \uCCA8\uBD80 \uD30C\uC77C",
+  attachment_location: "\uACF5\uC720\uB41C \uC704\uCE58"
 };
 
 // src/i18n/locales/zh-CN.ts
@@ -463,7 +502,10 @@ var zhCN = {
   drop_files_here: "\u5C06\u6587\u4EF6\u62D6\u653E\u5230\u6B64\u5904",
   incident_dismiss: "\u5173\u95ED",
   incident_default_link_label: "\u4E86\u89E3\u66F4\u591A",
-  attachment_unsupported_type: "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B"
+  attachment_unsupported_type: "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B",
+  attachment_open: "\u6253\u5F00\u9644\u4EF6",
+  attachment_image_alt: "\u56FE\u7247\u9644\u4EF6",
+  attachment_location: "\u5171\u4EAB\u7684\u4F4D\u7F6E"
 };
 
 // src/i18n/locales/zh-TW.ts
@@ -494,7 +536,10 @@ var zhTW = {
   drop_files_here: "\u5C07\u6A94\u6848\u62D6\u653E\u5230\u6B64\u8655",
   incident_dismiss: "\u95DC\u9589",
   incident_default_link_label: "\u77AD\u89E3\u66F4\u591A",
-  attachment_unsupported_type: "\u4E0D\u652F\u63F4\u7684\u6A94\u6848\u985E\u578B"
+  attachment_unsupported_type: "\u4E0D\u652F\u63F4\u7684\u6A94\u6848\u985E\u578B",
+  attachment_open: "\u958B\u555F\u9644\u4EF6",
+  attachment_image_alt: "\u5716\u7247\u9644\u4EF6",
+  attachment_location: "\u5171\u4EAB\u7684\u4F4D\u7F6E"
 };
 
 // src/i18n/index.ts
@@ -1274,12 +1319,15 @@ var CustomerHeroChat = class {
     const { chatbotId, apiBase } = this.state.config;
     const { conversationId } = this.state;
     if (!conversationId) return;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const messagesUrl = `${apiBase}/api/chat/${chatbotId}/messages/${conversationId}`;
     try {
       const response = await fetch(
-        `${apiBase}/api/chat/${chatbotId}/messages/${conversationId}`
+        readToken ? `${messagesUrl}?t=${encodeURIComponent(readToken)}` : messagesUrl
       );
       if (!response.ok) {
         this.storage?.removeItem(`ch_conv_${chatbotId}`);
+        this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
         this.setState({ conversationId: null });
         return;
       }
@@ -1291,7 +1339,8 @@ var CustomerHeroChat = class {
         content: m.content,
         ...m.sources ? { sources: m.sources } : {},
         ...m.blocks ? { blocks: m.blocks } : {},
-        ...m.suggestions ? { suggestions: m.suggestions } : {}
+        ...m.suggestions ? { suggestions: m.suggestions } : {},
+        ...m.attachments?.length ? { attachments: m.attachments } : {}
       }));
       const lastBotIndex = findLastIndex(
         messages,
@@ -1344,12 +1393,14 @@ var CustomerHeroChat = class {
     });
     const { chatbotId, apiBase } = this.state.config;
     let botMessageCreated = false;
+    const continuationReadToken = this.state.conversationId ? this.storage?.getItem(`ch_conv_token_${chatbotId}`) : null;
     try {
       const response = await fetch(`${apiBase}/api/chat/${chatbotId}`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          Accept: "text/event-stream"
+          Accept: "text/event-stream",
+          ...continuationReadToken ? { "X-CH-Read-Token": continuationReadToken } : {}
         },
         body: JSON.stringify({
           message: trimmed,
@@ -1395,6 +1446,16 @@ var CustomerHeroChat = class {
             }
             break;
           }
+          case "read-token": {
+            const tok = safeParse(evt.data);
+            if (tok?.readToken) {
+              this.storage?.setItem(
+                `ch_conv_token_${chatbotId}`,
+                tok.readToken
+              );
+            }
+            break;
+          }
           case "token": {
             const tok = safeParse(evt.data);
             const text = tok?.text ?? "";
@@ -1507,6 +1568,9 @@ var CustomerHeroChat = class {
       await this.loadHistory();
       return;
     }
+    const decisionBlock = this.state.messages[targetIndex].blocks?.find(
+      (b) => b.type === "action_confirmation" && b.pendingToolCallId === pendingId
+    );
     const messages = this.state.messages.slice();
     const original = messages[targetIndex];
     messages[targetIndex] = {
@@ -1515,7 +1579,10 @@ var CustomerHeroChat = class {
     };
     this.setState({ messages, error: null });
     const { chatbotId, apiBase } = this.state.config;
-    const url = `${apiBase}/api/chat/${chatbotId}/tool-calls/${pendingId}/decision`;
+    const href = decision === "approve" ? decisionBlock?.approveHref : decisionBlock?.cancelHref;
+    const baseUrl = href ? `${apiBase}${href}` : `${apiBase}/api/chat/${chatbotId}/tool-calls/${pendingId}/decision`;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const url = readToken ? `${baseUrl}${baseUrl.includes("?") ? "&" : "?"}t=${encodeURIComponent(readToken)}` : baseUrl;
     try {
       const response = await fetch(url, {
         method: "POST",
@@ -1547,6 +1614,16 @@ var CustomerHeroChat = class {
             }
             break;
           }
+          case "read-token": {
+            const tok = safeParse(evt.data);
+            if (tok?.readToken) {
+              this.storage?.setItem(
+                `ch_conv_token_${chatbotId}`,
+                tok.readToken
+              );
+            }
+            break;
+          }
           case "token": {
             const tok = safeParse(evt.data);
             const text = tok?.text ?? "";
@@ -1623,8 +1700,10 @@ var CustomerHeroChat = class {
     const { chatbotId, apiBase } = this.state.config;
     const { conversationId } = this.state;
     if (!conversationId) return;
+    const readToken = this.storage?.getItem(`ch_conv_token_${chatbotId}`);
+    const url = readToken ? `${apiBase}/api/chat/${chatbotId}/feedback?t=${encodeURIComponent(readToken)}` : `${apiBase}/api/chat/${chatbotId}/feedback`;
     try {
-      await fetch(`${apiBase}/api/chat/${chatbotId}/rate`, {
+      await fetch(url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ conversationId, messageId, rating })
@@ -1653,6 +1732,7 @@ var CustomerHeroChat = class {
   reset() {
     const { chatbotId, welcomeMessage } = this.state.config;
     this.storage?.removeItem(`ch_conv_${chatbotId}`);
+    this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
     this.setState({
       messages: welcomeMessage ? [{ role: "bot", content: welcomeMessage }] : [],
       conversationId: null,
@@ -1820,6 +1900,7 @@ var CustomerHeroChat = class {
     };
     const { chatbotId, welcomeMessage } = this.state.config;
     this.storage?.removeItem(`ch_conv_${chatbotId}`);
+    this.storage?.removeItem(`ch_conv_token_${chatbotId}`);
     this.setState({
       messages: welcomeMessage ? [{ role: "bot", content: welcomeMessage }] : [],
       conversationId: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@customerhero/js",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "private": false,
   "description": "Framework-agnostic JavaScript client for the CustomerHero chat widget.",
   "keywords": [