@ada-support/embed2 1.14.7 → 1.14.10

package/dist/npm-entry/index.js

@@ -16125,7 +16125,7 @@ const client = new BrowserClient({
     return event;
   },
   environment: "production",
-  release: "1.14.7-4506c4f",
+  release: "1.14.10-df84716",
   sampleRate: 0.25,
   autoSessionTracking: false,
   // Integrations don't seem to work with Sentry: https://github.com/getsentry/sentry-javascript/issues/2541
@@ -16751,7 +16751,7 @@ function getEmbedURL(_ref) {
   } else {
     host = `http://${handle}.localhost:${ports.localhost.default}`;
   }
-  return `${host}/embed/${frameName}/${"4506c4f"}/index.html`;
+  return `${host}/embed/${frameName}/${"df84716"}/index.html`;
 }
 function constructQueryString(query) {
   return Object.keys(query).map(key => {
@@ -17538,9 +17538,9 @@ async function log(message, extra, options) {
       service: "embed",
       env: "production",
       embedVersion: 2,
-      version: "1.14.7",
+      version: "1.14.10",
       isNpm: true,
-      commitHash: "4506c4f"
+      commitHash: "df84716"
     }))
   });
 }
@@ -18686,6 +18686,29 @@ function proactiveShownWithinFrequency(proactiveConversationKey, frequency, hand
   }
 }
 
+// Ranking advances across visits: once a proactive fires it's remembered so a
+// later visit surfaces the next-highest priority instead of repeating it. This
+// "shown" set persists in localStorage (across visits, unlike the per-session
+// frequency record above) under the same disclosed `proactive_conversations_shown`
+// key, scoped by handle.
+function getRankedShownKeys(handle) {
+  const storageValue = dist/* adaLocalStorage */.BB.getFnItem("proactive_conversations_shown");
+  const stored = storageValue ? storageValue[handle] : undefined;
+  return stored ? stored.split(",") : [];
+}
+function setRankedShownKeys(handle, keys) {
+  const storageValue = dist/* adaLocalStorage */.BB.getFnItem("proactive_conversations_shown") || {};
+  dist/* adaLocalStorage */.BB.setFnItem("proactive_conversations_shown", proactiveConversation_objectSpread(proactiveConversation_objectSpread({}, storageValue), {}, {
+    [handle]: keys.join(",")
+  }));
+}
+function recordRankedShown(handle, proactiveConversationKey) {
+  const keys = getRankedShownKeys(handle);
+  if (!keys.includes(proactiveConversationKey)) {
+    setRankedShownKeys(handle, [...keys, proactiveConversationKey]);
+  }
+}
+
 // A proactive only fires when `now` is within its optional scheduling window.
 // Bounds are absolute ISO 8601 UTC instants authored in the dashboard; either
 // may be unset for an open-ended window. This mirrors the declarative campaign
@@ -18713,6 +18736,16 @@ function isWithinSchedule(scheduleStart, scheduleEnd) {
   }
   return true;
 }
+
+// When several active proactives match the same URL, only the highest priority
+// fires: the lowest `order` wins, and any explicit rank beats an unranked one.
+function pickHighestPriorityMatch(matches) {
+  return [...matches].sort((_ref, _ref2) => {
+    let [, a] = _ref;
+    let [, b] = _ref2;
+    return (a.order ?? Infinity) - (b.order ?? Infinity);
+  })[0];
+}
 function addProactiveToStorageString(oldStorageValue, proactiveConversationId) {
   return oldStorageValue ? `${oldStorageValue},${proactiveConversationId}` : proactiveConversationId;
 }
@@ -18759,7 +18792,7 @@ function extractRichContent(proactiveConversation, language) {
     } : undefined
   };
 }
-function proactiveTriggerImpl(_ref) {
+function proactiveTriggerImpl(_ref3) {
   let {
     proactiveConversation,
     triggerMethod,
@@ -18768,7 +18801,7 @@ function proactiveTriggerImpl(_ref) {
     language,
     setRecentProactiveConversationConfig,
     clearProactiveConversation
-  } = _ref;
+  } = _ref3;
   const {
     handle
   } = adaSettings;
@@ -18824,6 +18857,14 @@ function proactiveTriggerImpl(_ref) {
 
   // Record the proactive message as being shown
   recordProactiveTrigger(messageKey, frequency, handle);
+
+  // Remember URL-triggered shows so ranking advances to the next proactive on
+  // the next visit. Recording every URL trigger (not just ranked ones) is safe:
+  // the unranked fire-all path never reads this set, and the loop-reset in
+  // `selectProactivesToTriggerForUrl` clears any stale keys.
+  if (triggerMethod === "url") {
+    recordRankedShown(handle, messageKey);
+  }
   setRecentProactiveConversationConfig({
     key: messageKey,
     params
@@ -18854,6 +18895,55 @@ function evaluateUrlTriggerConditions(conditions, url) {
   }
   return evalUrlMatchTriggerCondition(conditions, url);
 }
+
+// The proactives to fire for the current URL, among the active, non-template
+// ones whose schedule + URL conditions match and that haven't been suppressed
+// by their frequency this session (filtering frequency here, not just in
+// `proactiveTriggerImpl`, lets a lower-priority proactive still fire when the
+// top one has already been shown).
+//
+// Prioritization is configured only by clients on the
+// `proactive-messaging-image-support` flag — the only ones who can rank in the
+// dashboard. Embed has no flag access, so the presence of an `order` is the
+// signal: when any match is ranked, exactly one fires and successive visits
+// advance down the ranking (the highest priority that hasn't been shown yet,
+// looping back to the top once all have), rather than firing every match — the
+// pre-ranking behavior kept for unranked clients.
+function selectProactivesToTriggerForUrl(proactiveConversations, url, handle) {
+  const matches = Object.entries(proactiveConversations).filter(_ref4 => {
+    let [key, conversation] = _ref4;
+    const chatConfig = conversation.modality_config.chat;
+    return chatConfig.active && !conversation.is_template && isWithinSchedule(chatConfig.schedule_start, chatConfig.schedule_end) && evaluateUrlTriggerConditions(chatConfig.url_trigger_conditions, url) && !proactiveShownWithinFrequency(key, chatConfig.frequency, handle);
+  });
+  const isRankingConfigured = matches.some(_ref5 => {
+    let [, conversation] = _ref5;
+    return typeof conversation.order === "number";
+  });
+  if (!isRankingConfigured) {
+    return matches;
+  }
+
+  // Ranking fires one proactive per visit and advances down the list: matches
+  // already shown on previous visits are skipped so the next-highest priority
+  // fires. Once every current match has been shown, clear their records so the
+  // cycle loops back to the top.
+  const shownKeys = getRankedShownKeys(handle);
+  const unshown = matches.filter(_ref6 => {
+    let [key] = _ref6;
+    return !shownKeys.includes(key);
+  });
+  if (unshown.length === 0) {
+    const matchKeys = matches.map(_ref7 => {
+      let [key] = _ref7;
+      return key;
+    });
+    setRankedShownKeys(handle, shownKeys.filter(key => !matchKeys.includes(key)));
+    const top = pickHighestPriorityMatch(matches);
+    return top ? [top] : [];
+  }
+  const top = pickHighestPriorityMatch(unshown);
+  return top ? [top] : [];
+}
 ;// ./src/services/chat-versioning/manifest.ts
 
 
@@ -20240,7 +20330,7 @@ class ChatFrame extends d {
     log("Chat frame mount", {
       handle,
       chatUrl: this.url,
-      embedVersion: "4506c4f".slice(0, 7),
+      embedVersion: "df84716".slice(0, 7),
       embedSettings: adaSettings
     });
 
@@ -20328,7 +20418,7 @@ class ChatFrame extends d {
     const hostPageUrlParams = new URL(window.location.href).searchParams;
     const smsToken = hostPageUrlParams.get("adaSMSToken");
     const queryParams = {
-      embedVersion: "4506c4f".slice(0, 7),
+      embedVersion: "df84716".slice(0, 7),
       greeting,
       language,
       skipGreeting,
@@ -21806,7 +21896,8 @@ class Container extends d {
   }
   evaluateProactiveConversationConditions() {
     const {
-      client
+      client,
+      adaSettings
     } = this.props;
     if (!client) {
       throw new AdaEmbedError("`client` is not defined");
@@ -21816,15 +21907,15 @@ class Container extends d {
       return;
     }
     const currentUrl = window.location.href;
-    Object.entries(proactiveConversations).forEach(_ref => {
+
+    // When ranking is configured (any matching proactive has an `order`, which
+    // only flag-enabled clients can set), a single highest-priority proactive
+    // fires; otherwise every matching proactive fires.
+    selectProactivesToTriggerForUrl(proactiveConversations, currentUrl, adaSettings.handle).forEach(_ref => {
       let [key, conversation] = _ref;
-      const chatConfig = conversation.modality_config.chat;
-      const isTemplate = conversation.is_template;
-      if (chatConfig.active && !isTemplate && isWithinSchedule(chatConfig.schedule_start, chatConfig.schedule_end) && evaluateUrlTriggerConditions(chatConfig.url_trigger_conditions, currentUrl)) {
-        this.handleProactiveTrigger(Container_objectSpread({
-          key
-        }, conversation), "url");
-      }
+      this.handleProactiveTrigger(Container_objectSpread({
+        key
+      }, conversation), "url");
     });
   }
   async handleSettingDeviceToken(localChannel, payload, id) {

package/dist/npm-entry/proactiveConversations/proactiveConversation.d.ts

@@ -1,7 +1,8 @@
 import type { StartOptions } from "@ada-support/embed-types";
 import type { MessageService } from "client/lib/message-service";
-import type { ProactiveConversation, ProactiveConversationTriggerMethod, ProactiveConversationUrlTriggerConditions, RecentProactiveConversationConfig } from "./types";
+import type { ProactiveConversation, ProactiveConversationTriggerMethod, ProactiveConversationUrlTriggerConditions, ProactiveConversations, RecentProactiveConversationConfig } from "./types";
 export declare function isWithinSchedule(scheduleStart?: string | null, scheduleEnd?: string | null): boolean;
+export declare function pickHighestPriorityMatch(matches: Array<[string, ProactiveConversation]>): [string, ProactiveConversation] | undefined;
 export declare function proactiveTriggerImpl({ proactiveConversation, triggerMethod, adaSettings, messageService, language, setRecentProactiveConversationConfig, clearProactiveConversation, }: {
     proactiveConversation: ProactiveConversation;
     triggerMethod: ProactiveConversationTriggerMethod | null;
@@ -12,3 +13,4 @@ export declare function proactiveTriggerImpl({ proactiveConversation, triggerMet
     clearProactiveConversation: () => void;
 }): void;
 export declare function evaluateUrlTriggerConditions(conditions: ProactiveConversationUrlTriggerConditions, url: string): boolean;
+export declare function selectProactivesToTriggerForUrl(proactiveConversations: ProactiveConversations, url: string, handle: string): Array<[string, ProactiveConversation]>;

package/dist/npm-entry/proactiveConversations/types.d.ts

@@ -30,6 +30,7 @@ export interface ProactiveConversation {
         [language: string]: ProactiveConversationImage[];
     };
     ctas?: ProactiveConversationCta[];
+    order?: number | null;
 }
 export interface ProactiveConversations {
     [messageKey: string]: ProactiveConversation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-support/embed2",
-  "version": "1.14.7",
+  "version": "1.14.10",
   "description": "",
   "main": "dist/npm-entry",
   "typings": "dist/npm-entry/index-npm.d.ts",