@ada-support/embed2 1.14.6 → 1.14.9

package/dist/npm-entry/index.js

@@ -16125,7 +16125,7 @@ const client = new BrowserClient({
     return event;
   },
   environment: "production",
-  release: "1.14.6-f90a8e1",
+  release: "1.14.9-791d3a3",
   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}/${"f90a8e1"}/index.html`;
+  return `${host}/embed/${frameName}/${"791d3a3"}/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.6",
+      version: "1.14.9",
       isNpm: true,
-      commitHash: "f90a8e1"
+      commitHash: "791d3a3"
     }))
   });
 }
@@ -18685,6 +18685,44 @@ function proactiveShownWithinFrequency(proactiveConversationKey, frequency, hand
       return false;
   }
 }
+
+// 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
+// datetime gating: the start is after-inclusive and the end is before-exclusive,
+// evaluated through the shared trigger-condition evaluator so the semantics stay
+// identical across both surfaces.
+function isWithinSchedule(scheduleStart, scheduleEnd) {
+  const now = new Date();
+  const buildCondition = (operator, datetime) => ({
+    type: "datetime",
+    // Bounds are absolute UTC instants (the stored datetime carries a `Z`
+    // offset). `timezone` is metadata the evaluator doesn't consult, but label
+    // it UTC to match the data and stay correct if the evaluator ever honors it.
+    timezone: "UTC",
+    condition: {
+      operator,
+      datetime
+    }
+  });
+  if (scheduleStart && !evalDatetimeTriggerCondition(buildCondition("after-inclusive", scheduleStart), now)) {
+    return false;
+  }
+  if (scheduleEnd && !evalDatetimeTriggerCondition(buildCondition("before-exclusive", scheduleEnd), now)) {
+    return false;
+  }
+  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;
 }
@@ -18731,7 +18769,7 @@ function extractRichContent(proactiveConversation, language) {
     } : undefined
   };
 }
-function proactiveTriggerImpl(_ref) {
+function proactiveTriggerImpl(_ref3) {
   let {
     proactiveConversation,
     triggerMethod,
@@ -18740,7 +18778,7 @@ function proactiveTriggerImpl(_ref) {
     language,
     setRecentProactiveConversationConfig,
     clearProactiveConversation
-  } = _ref;
+  } = _ref3;
   const {
     handle
   } = adaSettings;
@@ -18754,13 +18792,19 @@ function proactiveTriggerImpl(_ref) {
     duration,
     delay,
     frequency,
-    active
+    active,
+    schedule_start: scheduleStart,
+    schedule_end: scheduleEnd
   } = proactiveConversation.modality_config.chat;
   let proactiveMessage = proactiveConversation.messages[language][0];
   if (!active) {
     warn("Proactive message is not active");
     return;
   }
+  if (!isWithinSchedule(scheduleStart, scheduleEnd)) {
+    warn("Proactive message is outside its scheduled window");
+    return;
+  }
   if (isTemplate) {
     if (Object.keys(params).length === 0) {
       warn("Proactive message is a template but no parameters were provided");
@@ -18820,6 +18864,34 @@ 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, only the highest priority (lowest `order`)
+// fires; otherwise every match fires, the pre-ranking behavior.
+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;
+  }
+  const top = pickHighestPriorityMatch(matches);
+  return top ? [top] : [];
+}
 ;// ./src/services/chat-versioning/manifest.ts
 
 
@@ -20206,7 +20278,7 @@ class ChatFrame extends d {
     log("Chat frame mount", {
       handle,
       chatUrl: this.url,
-      embedVersion: "f90a8e1".slice(0, 7),
+      embedVersion: "791d3a3".slice(0, 7),
       embedSettings: adaSettings
     });
 
@@ -20294,7 +20366,7 @@ class ChatFrame extends d {
     const hostPageUrlParams = new URL(window.location.href).searchParams;
     const smsToken = hostPageUrlParams.get("adaSMSToken");
     const queryParams = {
-      embedVersion: "f90a8e1".slice(0, 7),
+      embedVersion: "791d3a3".slice(0, 7),
       greeting,
       language,
       skipGreeting,
@@ -21772,7 +21844,8 @@ class Container extends d {
   }
   evaluateProactiveConversationConditions() {
     const {
-      client
+      client,
+      adaSettings
     } = this.props;
     if (!client) {
       throw new AdaEmbedError("`client` is not defined");
@@ -21782,15 +21855,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 && 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,6 +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;
@@ -11,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

@@ -19,6 +19,8 @@ export interface ProactiveConversation {
             delay: number;
             duration: number;
             frequency: ProactiveConversationFrequency;
+            schedule_start?: string | null;
+            schedule_end?: string | null;
         };
     };
     is_template: boolean;
@@ -28,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.6",
+  "version": "1.14.9",
   "description": "",
   "main": "dist/npm-entry",
   "typings": "dist/npm-entry/index-npm.d.ts",