@customerhero/js 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -75,6 +75,8 @@ var en = {
   attach_menu_open: "Add attachment",
   attach_photo: "Choose file",
   drop_files_here: "Drop files here",
+  incident_dismiss: "Dismiss",
+  incident_default_link_label: "Learn more",
   attachment_unsupported_type: "Unsupported file type"
 };
 
@@ -104,6 +106,8 @@ var es = {
   attach_menu_open: "A\xF1adir adjunto",
   attach_photo: "Elegir archivo",
   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"
 };
 
@@ -133,6 +137,8 @@ var ptBR = {
   attach_menu_open: "Adicionar anexo",
   attach_photo: "Escolher arquivo",
   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"
 };
 
@@ -162,6 +168,8 @@ var ptPT = {
   attach_menu_open: "Adicionar anexo",
   attach_photo: "Escolher ficheiro",
   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"
 };
 
@@ -191,6 +199,8 @@ var fr = {
   attach_menu_open: "Ajouter une pi\xE8ce jointe",
   attach_photo: "Choisir un fichier",
   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"
 };
 
@@ -220,6 +230,8 @@ var de = {
   attach_menu_open: "Anhang hinzuf\xFCgen",
   attach_photo: "Datei ausw\xE4hlen",
   drop_files_here: "Dateien hier ablegen",
+  incident_dismiss: "Schlie\xDFen",
+  incident_default_link_label: "Mehr erfahren",
   attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt"
 };
 
@@ -249,6 +261,8 @@ var it = {
   attach_menu_open: "Aggiungi allegato",
   attach_photo: "Scegli file",
   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"
 };
 
@@ -278,6 +292,8 @@ var nl = {
   attach_menu_open: "Bijlage toevoegen",
   attach_photo: "Bestand kiezen",
   drop_files_here: "Sleep bestanden hier",
+  incident_dismiss: "Sluiten",
+  incident_default_link_label: "Meer informatie",
   attachment_unsupported_type: "Bestandstype niet ondersteund"
 };
 
@@ -307,6 +323,8 @@ var pl = {
   attach_menu_open: "Dodaj za\u0142\u0105cznik",
   attach_photo: "Wybierz plik",
   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"
 };
 
@@ -336,6 +354,8 @@ var tr = {
   attach_menu_open: "Ek ekle",
   attach_photo: "Dosya se\xE7",
   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"
 };
 
@@ -365,6 +385,8 @@ var ar = {
   attach_menu_open: "\u0625\u0636\u0627\u0641\u0629 \u0645\u0631\u0641\u0642",
   attach_photo: "\u0627\u062E\u062A\u0631 \u0645\u0644\u0641\u064B\u0627",
   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"
 };
 
@@ -394,6 +416,8 @@ var ja = {
   attach_menu_open: "\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u8FFD\u52A0",
   attach_photo: "\u30D5\u30A1\u30A4\u30EB\u3092\u9078\u629E",
   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"
 };
 
@@ -423,6 +447,8 @@ var ko = {
   attach_menu_open: "\uCCA8\uBD80 \uD30C\uC77C \uCD94\uAC00",
   attach_photo: "\uD30C\uC77C \uC120\uD0DD",
   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"
 };
 
@@ -452,6 +478,8 @@ var zhCN = {
   attach_menu_open: "\u6DFB\u52A0\u9644\u4EF6",
   attach_photo: "\u9009\u62E9\u6587\u4EF6",
   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"
 };
 
@@ -481,6 +509,8 @@ var zhTW = {
   attach_menu_open: "\u65B0\u589E\u9644\u4EF6",
   attach_photo: "\u9078\u64C7\u6A94\u6848",
   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"
 };
 
@@ -1000,9 +1030,50 @@ function resolveConfig(userConfig, fetched) {
     stringOverrides: fetched?.stringOverrides
   };
 }
+function sanitizeIncidentBanner(input) {
+  if (!input || typeof input !== "object") return null;
+  const raw = input;
+  const sev = raw.severity;
+  if (sev !== "info" && sev !== "warning" && sev !== "outage") return null;
+  if (typeof raw.title !== "string" || raw.title.length === 0) return null;
+  if (typeof raw.expiresAt === "string") {
+    const t = Date.parse(raw.expiresAt);
+    if (!Number.isNaN(t) && t <= Date.now()) return null;
+  }
+  const out = { severity: sev, title: raw.title };
+  if (typeof raw.body === "string") out.body = raw.body;
+  if (typeof raw.eta === "string") out.eta = raw.eta;
+  if (raw.link && typeof raw.link === "object") {
+    const link = raw.link;
+    if (typeof link.url === "string") {
+      out.link = { url: link.url };
+      if (typeof link.label === "string") out.link.label = link.label;
+    }
+  }
+  if (typeof raw.expiresAt === "string") out.expiresAt = raw.expiresAt;
+  return out;
+}
+function bannerKey(banner) {
+  if (!banner) return null;
+  return JSON.stringify([
+    banner.severity,
+    banner.title,
+    banner.body ?? "",
+    banner.eta ?? "",
+    banner.link?.url ?? "",
+    banner.link?.label ?? "",
+    banner.expiresAt ?? ""
+  ]);
+}
 function getStorage() {
   try {
-    return typeof window !== "undefined" ? window.localStorage : null;
+    if (typeof window !== "undefined" && window.localStorage)
+      return window.localStorage;
+    if (typeof globalThis !== "undefined") {
+      const ls = globalThis.localStorage;
+      if (ls) return ls;
+    }
+    return null;
   } catch {
     return null;
   }
@@ -1044,7 +1115,9 @@ var CustomerHeroChat = class {
       preChatSubmission: null,
       consent: this.readStoredConsent(),
       pendingTriggerId: null,
-      pendingPrefill: null
+      pendingPrefill: null,
+      incidentBanner: null,
+      incidentBannerDismissed: false
     };
   }
   // ── Proactive engagement state ─────────────────────────────────────
@@ -1123,11 +1196,18 @@ var CustomerHeroChat = class {
       const resolved = resolveConfig(this.userConfig, fetched);
       const triggers = Array.isArray(fetched.triggers) ? fetched.triggers : [];
       const preChatForm = fetched.preChatForm ?? null;
+      const incidentBanner = sanitizeIncidentBanner(fetched.incidentBanner);
+      const prevBannerKey = bannerKey(this.state.incidentBanner);
+      const nextBannerKey = bannerKey(incidentBanner);
+      const dismissedFromStorage = nextBannerKey && nextBannerKey === this.readStoredBannerDismissal();
+      const incidentBannerDismissed = nextBannerKey === prevBannerKey ? this.state.incidentBannerDismissed || !!dismissedFromStorage : !!dismissedFromStorage;
       this.setState({
         config: resolved,
         configLoaded: true,
         triggers,
-        preChatForm
+        preChatForm,
+        incidentBanner,
+        incidentBannerDismissed
       });
       if (resolved.stringOverrides) this.rebuildTranslator();
       this.startTriggersRuntimeIfPossible();
@@ -1552,6 +1632,34 @@ var CustomerHeroChat = class {
   setTraits(traits) {
     this.triggersRuntime?.setTraits(traits);
   }
+  /** Hide the active incident banner for this visitor. Persisted in
+   *  localStorage so a refresh keeps it dismissed; resets automatically
+   *  when the operator changes the banner content. No-op when no banner
+   *  is showing. */
+  dismissIncidentBanner() {
+    const key = bannerKey(this.state.incidentBanner);
+    if (!key) return;
+    this.writeStoredBannerDismissal(key);
+    this.setState({ incidentBannerDismissed: true });
+  }
+  readStoredBannerDismissal() {
+    try {
+      return this.storage?.getItem(
+        `ch_incident_dismissed_${this.userConfig.chatbotId}`
+      ) ?? null;
+    } catch {
+      return null;
+    }
+  }
+  writeStoredBannerDismissal(key) {
+    try {
+      this.storage?.setItem(
+        `ch_incident_dismissed_${this.userConfig.chatbotId}`,
+        key
+      );
+    } catch {
+    }
+  }
   /** Submit pre-chat form answers. Synthesizes a customer record server-side
    *  on the next sendMessage. Resumes any pending message that was deferred
    *  while the form was open. */

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";
+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 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"];
@@ -244,6 +244,20 @@ interface PreChatSubmission {
     /** Keyed answers from text/textarea/select/consent fields. */
     properties?: Record<string, string | number | boolean>;
 }
+interface IncidentBanner {
+    severity: "info" | "warning" | "outage";
+    title: string;
+    body?: string;
+    /** Free-text human ETA, e.g. "Back online by 14:00 UTC". */
+    eta?: string;
+    /** Optional CTA — typically a status-page incident URL. */
+    link?: {
+        url: string;
+        label?: string;
+    };
+    /** ISO 8601 UTC. After this time the widget hides the banner. */
+    expiresAt?: string;
+}
 interface ConsentSettings {
     /** When true, all condition kinds are evaluated. When false (default), only
      *  direct launcher clicks fire — URL/time/scroll/exit-intent/trait
@@ -284,6 +298,11 @@ interface ChatState {
     /** When set, the host should preload this text into the input. Cleared
      *  once the host consumes it (or when the conversation starts). */
     pendingPrefill: string | null;
+    /** Operator-controlled incident banner. `null` when none is active. */
+    incidentBanner: IncidentBanner | null;
+    /** True when the visitor has dismissed the active banner this session.
+     *  Reset whenever a new banner (different content) lands. */
+    incidentBannerDismissed: boolean;
 }
 
 type Listener = (state: ChatState) => void;
@@ -339,6 +358,13 @@ declare class CustomerHeroChat {
      *  values are kept in memory (not persisted) so the integrator decides
      *  the source of truth. */
     setTraits(traits: Record<string, string | number | boolean>): void;
+    /** Hide the active incident banner for this visitor. Persisted in
+     *  localStorage so a refresh keeps it dismissed; resets automatically
+     *  when the operator changes the banner content. No-op when no banner
+     *  is showing. */
+    dismissIncidentBanner(): void;
+    private readStoredBannerDismissal;
+    private writeStoredBannerDismissal;
     /** Submit pre-chat form answers. Synthesizes a customer record server-side
      *  on the next sendMessage. Resumes any pending message that was deferred
      *  while the form was open. */
@@ -438,4 +464,4 @@ interface StartTriggersRuntimeOptions {
 }
 declare function startTriggersRuntime(options: StartTriggersRuntimeOptions): TriggersRuntimeHandle;
 
-export { type ActionConfirmationBlock, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type IdentifyPayload, type IdentityData, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, 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, evaluate, isRtlLocale, pickFire, resolveLocale, startTriggersRuntime };
+export { type ActionConfirmationBlock, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, 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, 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, evaluate, isRtlLocale, pickFire, resolveLocale, 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";
+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 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"];
@@ -244,6 +244,20 @@ interface PreChatSubmission {
     /** Keyed answers from text/textarea/select/consent fields. */
     properties?: Record<string, string | number | boolean>;
 }
+interface IncidentBanner {
+    severity: "info" | "warning" | "outage";
+    title: string;
+    body?: string;
+    /** Free-text human ETA, e.g. "Back online by 14:00 UTC". */
+    eta?: string;
+    /** Optional CTA — typically a status-page incident URL. */
+    link?: {
+        url: string;
+        label?: string;
+    };
+    /** ISO 8601 UTC. After this time the widget hides the banner. */
+    expiresAt?: string;
+}
 interface ConsentSettings {
     /** When true, all condition kinds are evaluated. When false (default), only
      *  direct launcher clicks fire — URL/time/scroll/exit-intent/trait
@@ -284,6 +298,11 @@ interface ChatState {
     /** When set, the host should preload this text into the input. Cleared
      *  once the host consumes it (or when the conversation starts). */
     pendingPrefill: string | null;
+    /** Operator-controlled incident banner. `null` when none is active. */
+    incidentBanner: IncidentBanner | null;
+    /** True when the visitor has dismissed the active banner this session.
+     *  Reset whenever a new banner (different content) lands. */
+    incidentBannerDismissed: boolean;
 }
 
 type Listener = (state: ChatState) => void;
@@ -339,6 +358,13 @@ declare class CustomerHeroChat {
      *  values are kept in memory (not persisted) so the integrator decides
      *  the source of truth. */
     setTraits(traits: Record<string, string | number | boolean>): void;
+    /** Hide the active incident banner for this visitor. Persisted in
+     *  localStorage so a refresh keeps it dismissed; resets automatically
+     *  when the operator changes the banner content. No-op when no banner
+     *  is showing. */
+    dismissIncidentBanner(): void;
+    private readStoredBannerDismissal;
+    private writeStoredBannerDismissal;
     /** Submit pre-chat form answers. Synthesizes a customer record server-side
      *  on the next sendMessage. Resumes any pending message that was deferred
      *  while the form was open. */
@@ -438,4 +464,4 @@ interface StartTriggersRuntimeOptions {
 }
 declare function startTriggersRuntime(options: StartTriggersRuntimeOptions): TriggersRuntimeHandle;
 
-export { type ActionConfirmationBlock, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, type IdentifyPayload, type IdentityData, type MessageBlock, type MessageRating, type MessageSource, type MessageStatus, type PreChatField, type PreChatFieldKind, type PreChatFormConfig, type PreChatSubmission, type QuickRepliesBlock, type ResolvedConfig, 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, evaluate, isRtlLocale, pickFire, resolveLocale, startTriggersRuntime };
+export { type ActionConfirmationBlock, type ChatMessage, type ChatState, type ConsentSettings, CustomerHeroChat, type CustomerHeroChatConfig, DEFAULTS, 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, 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, evaluate, isRtlLocale, pickFire, resolveLocale, startTriggersRuntime };

package/dist/index.js

@@ -36,6 +36,8 @@ var en = {
   attach_menu_open: "Add attachment",
   attach_photo: "Choose file",
   drop_files_here: "Drop files here",
+  incident_dismiss: "Dismiss",
+  incident_default_link_label: "Learn more",
   attachment_unsupported_type: "Unsupported file type"
 };
 
@@ -65,6 +67,8 @@ var es = {
   attach_menu_open: "A\xF1adir adjunto",
   attach_photo: "Elegir archivo",
   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"
 };
 
@@ -94,6 +98,8 @@ var ptBR = {
   attach_menu_open: "Adicionar anexo",
   attach_photo: "Escolher arquivo",
   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"
 };
 
@@ -123,6 +129,8 @@ var ptPT = {
   attach_menu_open: "Adicionar anexo",
   attach_photo: "Escolher ficheiro",
   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"
 };
 
@@ -152,6 +160,8 @@ var fr = {
   attach_menu_open: "Ajouter une pi\xE8ce jointe",
   attach_photo: "Choisir un fichier",
   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"
 };
 
@@ -181,6 +191,8 @@ var de = {
   attach_menu_open: "Anhang hinzuf\xFCgen",
   attach_photo: "Datei ausw\xE4hlen",
   drop_files_here: "Dateien hier ablegen",
+  incident_dismiss: "Schlie\xDFen",
+  incident_default_link_label: "Mehr erfahren",
   attachment_unsupported_type: "Dateityp nicht unterst\xFCtzt"
 };
 
@@ -210,6 +222,8 @@ var it = {
   attach_menu_open: "Aggiungi allegato",
   attach_photo: "Scegli file",
   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"
 };
 
@@ -239,6 +253,8 @@ var nl = {
   attach_menu_open: "Bijlage toevoegen",
   attach_photo: "Bestand kiezen",
   drop_files_here: "Sleep bestanden hier",
+  incident_dismiss: "Sluiten",
+  incident_default_link_label: "Meer informatie",
   attachment_unsupported_type: "Bestandstype niet ondersteund"
 };
 
@@ -268,6 +284,8 @@ var pl = {
   attach_menu_open: "Dodaj za\u0142\u0105cznik",
   attach_photo: "Wybierz plik",
   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"
 };
 
@@ -297,6 +315,8 @@ var tr = {
   attach_menu_open: "Ek ekle",
   attach_photo: "Dosya se\xE7",
   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"
 };
 
@@ -326,6 +346,8 @@ var ar = {
   attach_menu_open: "\u0625\u0636\u0627\u0641\u0629 \u0645\u0631\u0641\u0642",
   attach_photo: "\u0627\u062E\u062A\u0631 \u0645\u0644\u0641\u064B\u0627",
   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"
 };
 
@@ -355,6 +377,8 @@ var ja = {
   attach_menu_open: "\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u8FFD\u52A0",
   attach_photo: "\u30D5\u30A1\u30A4\u30EB\u3092\u9078\u629E",
   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"
 };
 
@@ -384,6 +408,8 @@ var ko = {
   attach_menu_open: "\uCCA8\uBD80 \uD30C\uC77C \uCD94\uAC00",
   attach_photo: "\uD30C\uC77C \uC120\uD0DD",
   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"
 };
 
@@ -413,6 +439,8 @@ var zhCN = {
   attach_menu_open: "\u6DFB\u52A0\u9644\u4EF6",
   attach_photo: "\u9009\u62E9\u6587\u4EF6",
   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"
 };
 
@@ -442,6 +470,8 @@ var zhTW = {
   attach_menu_open: "\u65B0\u589E\u9644\u4EF6",
   attach_photo: "\u9078\u64C7\u6A94\u6848",
   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"
 };
 
@@ -961,9 +991,50 @@ function resolveConfig(userConfig, fetched) {
     stringOverrides: fetched?.stringOverrides
   };
 }
+function sanitizeIncidentBanner(input) {
+  if (!input || typeof input !== "object") return null;
+  const raw = input;
+  const sev = raw.severity;
+  if (sev !== "info" && sev !== "warning" && sev !== "outage") return null;
+  if (typeof raw.title !== "string" || raw.title.length === 0) return null;
+  if (typeof raw.expiresAt === "string") {
+    const t = Date.parse(raw.expiresAt);
+    if (!Number.isNaN(t) && t <= Date.now()) return null;
+  }
+  const out = { severity: sev, title: raw.title };
+  if (typeof raw.body === "string") out.body = raw.body;
+  if (typeof raw.eta === "string") out.eta = raw.eta;
+  if (raw.link && typeof raw.link === "object") {
+    const link = raw.link;
+    if (typeof link.url === "string") {
+      out.link = { url: link.url };
+      if (typeof link.label === "string") out.link.label = link.label;
+    }
+  }
+  if (typeof raw.expiresAt === "string") out.expiresAt = raw.expiresAt;
+  return out;
+}
+function bannerKey(banner) {
+  if (!banner) return null;
+  return JSON.stringify([
+    banner.severity,
+    banner.title,
+    banner.body ?? "",
+    banner.eta ?? "",
+    banner.link?.url ?? "",
+    banner.link?.label ?? "",
+    banner.expiresAt ?? ""
+  ]);
+}
 function getStorage() {
   try {
-    return typeof window !== "undefined" ? window.localStorage : null;
+    if (typeof window !== "undefined" && window.localStorage)
+      return window.localStorage;
+    if (typeof globalThis !== "undefined") {
+      const ls = globalThis.localStorage;
+      if (ls) return ls;
+    }
+    return null;
   } catch {
     return null;
   }
@@ -1005,7 +1076,9 @@ var CustomerHeroChat = class {
       preChatSubmission: null,
       consent: this.readStoredConsent(),
       pendingTriggerId: null,
-      pendingPrefill: null
+      pendingPrefill: null,
+      incidentBanner: null,
+      incidentBannerDismissed: false
     };
   }
   // ── Proactive engagement state ─────────────────────────────────────
@@ -1084,11 +1157,18 @@ var CustomerHeroChat = class {
       const resolved = resolveConfig(this.userConfig, fetched);
       const triggers = Array.isArray(fetched.triggers) ? fetched.triggers : [];
       const preChatForm = fetched.preChatForm ?? null;
+      const incidentBanner = sanitizeIncidentBanner(fetched.incidentBanner);
+      const prevBannerKey = bannerKey(this.state.incidentBanner);
+      const nextBannerKey = bannerKey(incidentBanner);
+      const dismissedFromStorage = nextBannerKey && nextBannerKey === this.readStoredBannerDismissal();
+      const incidentBannerDismissed = nextBannerKey === prevBannerKey ? this.state.incidentBannerDismissed || !!dismissedFromStorage : !!dismissedFromStorage;
       this.setState({
         config: resolved,
         configLoaded: true,
         triggers,
-        preChatForm
+        preChatForm,
+        incidentBanner,
+        incidentBannerDismissed
       });
       if (resolved.stringOverrides) this.rebuildTranslator();
       this.startTriggersRuntimeIfPossible();
@@ -1513,6 +1593,34 @@ var CustomerHeroChat = class {
   setTraits(traits) {
     this.triggersRuntime?.setTraits(traits);
   }
+  /** Hide the active incident banner for this visitor. Persisted in
+   *  localStorage so a refresh keeps it dismissed; resets automatically
+   *  when the operator changes the banner content. No-op when no banner
+   *  is showing. */
+  dismissIncidentBanner() {
+    const key = bannerKey(this.state.incidentBanner);
+    if (!key) return;
+    this.writeStoredBannerDismissal(key);
+    this.setState({ incidentBannerDismissed: true });
+  }
+  readStoredBannerDismissal() {
+    try {
+      return this.storage?.getItem(
+        `ch_incident_dismissed_${this.userConfig.chatbotId}`
+      ) ?? null;
+    } catch {
+      return null;
+    }
+  }
+  writeStoredBannerDismissal(key) {
+    try {
+      this.storage?.setItem(
+        `ch_incident_dismissed_${this.userConfig.chatbotId}`,
+        key
+      );
+    } catch {
+    }
+  }
   /** Submit pre-chat form answers. Synthesizes a customer record server-side
    *  on the next sendMessage. Resumes any pending message that was deferred
    *  while the form was open. */

package/package.json

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