@braze/web-sdk 6.4.0 → 6.6.0

package/src/DUST/dust-provider.js

@@ -1,120 +1,259 @@
 import t from "../common/base-provider.js";
 import r from "../managers/braze-instance.js";
 import { STORAGE_KEYS as s } from "../managers/storage-manager.js";
-import u from "../managers/subscription-manager.js";
-import a from "../util/net.js";
+import m from "../managers/subscription-manager.js";
+import l from "../util/net.js";
 import h from "../util/request-header-utils.js";
 import { logger as E } from "../../shared-lib/index.js";
+import {
+  REQUEST_BACKOFF_MAX_SLEEP_MS_DEFAULT as u,
+  REQUEST_BACKOFF_MIN_SLEEP_MS_DEFAULT as c,
+  REQUEST_BACKOFF_SCALE_FACTOR_DEFAULT as d,
+} from "../common/constants.js";
+import { randomInclusive as a } from "../util/math.js";
+import {
+  MAX_RETRIES as ii,
+  buildSseUrl as ti,
+} from "./dust-connection-core.js";
+import {
+  DustWorkerBridge as si,
+  isSharedWorkerSupported as ei,
+} from "./dust-worker-bridge.js";
 export default class tr extends t {
-  constructor(i, t, s) {
+  constructor(i, t, s, e, n = !0) {
     super(),
-      (this.B = i),
-      (this.j = t),
-      (this.B = i),
-      (this.j = t),
+      (this.j = i),
+      (this.B = t),
+      (this.h = s),
+      (this.j = i),
+      (this.B = t),
+      (this.h = s),
       (this.mite = null),
+      (this.ki = null),
       (this.yi = null),
-      (this.$i = s || null),
-      (this.Ri = null),
+      (this.$i = null),
+      (this.Ri = e || null),
+      (this.Mi = null),
+      (this.xi = null),
       (this.D = null),
-      (this.Mi = 0),
-      (this.ji = 5),
+      (this.ji = 0),
+      (this.Wi = ii),
       (this.Fi = null),
-      (this.Ui = !0),
-      (this.xi = null),
+      (this.Ui = null),
+      (this.zi = !0),
+      (this.Bi = null),
+      (this.Gi = null),
       (this.Pi = null),
-      (this.ki = null),
-      (this.Bi = !1),
+      (this.qi = null),
+      (this.Hi = !1),
       (this.Ji = new Map()),
-      this.Oi();
+      (this.Li = null),
+      (this.Oi = null),
+      (this.Ki = null),
+      (this.Qi = this.Vi(n)),
+      (this.Xi = !1),
+      (this.Yi = 0),
+      this.Zi();
+  }
+  Vi(i) {
+    return i
+      ? ei()
+        ? "sharedworker"
+        : (E.info(
+            "SharedWorker not supported, using direct EventSource (multi-tab will gracefully degrade)",
+          ),
+          "direct")
+      : (E.info("Shared connection disabled, using direct EventSource"),
+        "direct");
+  }
+  _i() {
+    this.Ki = new si({
+      Se: (i) => {
+        this.ke(i);
+      },
+      ye: () => {
+        this.Re();
+      },
+      Me: () => {},
+      De: (i) => {
+        E.error(`Real-time messaging SharedWorker error: ${i}`);
+      },
+    });
+    this.Ki.initialize() ||
+      (E.info(
+        "SharedWorker initialization failed, falling back to direct EventSource",
+      ),
+      (this.Qi = "direct"),
+      (this.Ki = null));
+  }
+  Re() {
+    (this.ji = 0),
+      (this.Bi = null),
+      (this.zi = !0),
+      (this.Xi = !1),
+      (this.Yi = 0);
+  }
+  ke(i) {
+    if (!i.type)
+      return void E.warn(
+        `Received real-time message without type: ${JSON.stringify(i)}`,
+      );
+    const t = "sharedworker" === this.Qi ? "SharedWorker" : "Direct";
+    E.info(`Received real-time message of type '${i.type}' via ${t}`);
+    const s = this.Ji.get(i.type);
+    if (s && s.We() > 0)
+      try {
+        s.L(i);
+      } catch (t) {
+        E.error(
+          `Error invoking subscription for message type '${i.type}': ${t}`,
+        );
+      }
+    else E.info(`No subscribers for real-time message type '${i.type}'`);
+  }
+  Fe() {
+    return "sharedworker" === this.Qi;
   }
-  Oi() {
-    if (this.j) {
-      const i = this.j.lt(s.ct.qi),
-        t = this.j.lt(s.ct.zi);
+  Ue() {
+    return this.Qi;
+  }
+  Zi() {
+    if (this.B) {
+      const i = this.B.dt(s.ft.Ne),
+        t = this.B.dt(s.ft.Te),
+        e = this.B.dt(s.ft.ze),
+        n = this.B.dt(s.ft.Ae);
       i && t
         ? ((this.mite = i),
-          (this.yi = t),
-          E.info("Restored DUST configuration from storage"))
+          (this.ki = t),
+          (this.yi = e),
+          (this.$i = n),
+          E.info("Restored real-time messaging configuration from storage"))
         : (i || t) &&
-          (E.warn("Incomplete DUST configuration in storage, clearing"),
-          this.j.Nt(s.ct.qi),
-          this.j.Nt(s.ct.zi));
+          (E.warn(
+            "Incomplete real-time messaging configuration in storage, clearing",
+          ),
+          this.Be());
     }
   }
-  Hi() {
-    this.xi ||
+  Hr() {
+    this.Li ||
+      this.Oi ||
+      ((this.Li = this.Ge("ddr", (i) => {
+        if (!i.body || "number" != typeof i.body.Pe) return;
+        const t = Math.random() * i.body.Pe * 0.3,
+          s = Math.round(i.body.Pe + t),
+          e = i.body.e ? ` (${i.body.e})` : "";
+        E.info(`Admin requested disconnect${e}, reconnecting in ${s}ms`),
+          this.qe(),
+          setTimeout(() => this.He(), s);
+      })),
+      (this.Oi = this.Ge("ttl", (i) => {
+        if (!i.body || "number" != typeof i.body.Je) return;
+        const t = i.body.Je;
+        E.info(`Time to live set to ${t}ms, will reconnect when expired`),
+          "sharedworker" !== this.Qi &&
+            ("string" == typeof i.body.Le && (this.Mi = i.body.Le),
+            null !== this.Ui && window.clearTimeout(this.Ui),
+            (this.Ui = window.setTimeout(() => {
+              (this.Ui = null),
+                E.info("Time to live expired, performing gapless reconnection"),
+                this.Oe();
+            }, t)));
+      })));
+  }
+  Ie() {
+    this.Gi ||
       this.Pi ||
-      ((this.ki = () => {
-        (this.Bi = !0), (this.Ui = !1);
+      ((this.qi = () => {
+        (this.Hi = !0), (this.zi = !1);
       }),
-      window.addEventListener("beforeunload", this.ki),
-      (this.xi = () => {
-        (this.Bi = !0),
-          this.Ri &&
-            (E.info("Page unloading, closing real-time connection gracefully"),
-            (this.Ui = !1),
-            this.Li());
+      window.addEventListener("beforeunload", this.qi),
+      (this.Gi = () => {
+        var i;
+        this.Hi = !0;
+        (this.xi ||
+          (null === (i = this.Ki) || void 0 === i ? void 0 : i.Ke())) &&
+          (E.info("Page unloading, closing real-time connection gracefully"),
+          (this.zi = !1),
+          this.qe());
       }),
-      window.addEventListener("pagehide", this.xi),
+      window.addEventListener("pagehide", this.Gi),
       (this.Pi = (i) => {
+        var t;
+        const s =
+          this.xi || (null === (t = this.Ki) || void 0 === t ? void 0 : t.Ke());
         i.persisted &&
-          this.Wi() &&
-          !this.Ri &&
+          this.Qe() &&
+          !s &&
           (E.info("Page restored from bfcache, reconnecting"),
-          (this.Bi = !1),
-          (this.Ui = !0),
-          (this.Mi = 0),
-          this.Gi());
+          (this.Hi = !1),
+          this.Re(),
+          this.He());
       }),
       window.addEventListener("pageshow", this.Pi));
   }
-  jt() {
+  St() {
     return this.D;
   }
-  yt(i) {
+  wt(i) {
     this.D = i;
   }
-  Ki(i, t) {
+  Ge(i, t) {
     if ("function" != typeof t) return null;
     let s = this.Ji.get(i);
-    return s || ((s = new u()), this.Ji.set(i, s), r.q(s)), s.wt(t);
+    return s || ((s = new m()), this.Ji.set(i, s), r.q(s)), s.Rt(t);
   }
-  Qi(i, t) {
+  Ve(i, t) {
     const s = this.Ji.get(i);
     s && s.removeSubscription(t);
   }
-  Wi() {
-    return Boolean(this.mite && this.yi);
+  Qe() {
+    return Boolean(this.mite && this.ki);
+  }
+  Xe() {
+    if (!this.$i) return !1;
+    return Math.floor(new Date().valueOf() / 1e3) >= this.$i;
+  }
+  Be() {
+    (this.mite = null),
+      (this.ki = null),
+      (this.yi = null),
+      (this.$i = null),
+      (this.Mi = null),
+      this.B &&
+        (this.B.zt(s.ft.Ne),
+        this.B.zt(s.ft.Te),
+        this.B.zt(s.ft.ze),
+        this.B.zt(s.ft.Ae));
   }
-  Vi(i, t) {
+  Ye(i, t) {
     const e = () => {
         "function" == typeof t && t();
       },
-      n = this.B,
-      o = this.j;
-    if (!n || !o)
+      n = this.j,
+      r = this.B;
+    if (!n || !r)
       return (
         E.error("NetworkManager or StorageManager not available"), void e()
       );
-    const l = r.l();
-    if (l && !l.Xi())
+    if (!this.h || !this.h.Ze())
       return (
         E.info("Real-time messaging is not enabled, skipping refresh"), void e()
       );
-    this.Wi()
+    this.Qe()
       ? E.info("Refreshing real-time messaging configuration")
       : E.info("Fetching initial real-time messaging configuration");
-    const g = n.$({}, !0),
-      c = n.A(g, h.H.Yi, !1),
-      u = new Date().valueOf();
-    h.K(o, h.H.Yi, u),
-      a.O({
+    const o = n.$({}, !0),
+      a = n.A(o, h.H._e, !1),
+      c = new Date().valueOf();
+    h.K(r, h.H._e, c),
+      l.O({
         url: `${n.V()}/dust/config`,
-        headers: c,
-        data: g,
+        headers: a,
+        data: o,
         W: (t) => {
-          if (!n.Y(g, t, c))
+          if (!n.Y(o, t, a))
             return (
               E.error(
                 "Failed to validate server response for real-time messaging configuration",
@@ -124,17 +263,22 @@ export default class tr extends t {
           n.Z(),
             t.mite && t.host
               ? ((this.mite = t.mite),
-                (this.yi = t.host),
+                (this.ki = t.host),
+                (this.yi = t.auth || null),
+                (this.$i = t.expiration || null),
                 E.info(
                   "Received real-time messaging configuration from server",
                 ),
-                o.ft(s.ct.qi, t.mite),
-                o.ft(s.ct.zi, t.host),
-                this.Gi(),
+                r.bt(s.ft.Ne, t.mite),
+                r.bt(s.ft.Te, t.host),
+                t.auth ? r.bt(s.ft.ze, t.auth) : r.zt(s.ft.ze),
+                t.expiration ? r.bt(s.ft.Ae, t.expiration) : r.zt(s.ft.Ae),
+                this.He(),
                 "function" == typeof i && i())
-              : (t.mite ||
-                  E.error("Missing messaging identifier in server response"),
-                t.host || E.error("Missing messaging host in server response"),
+              : (E.info(
+                  "Real-time messaging configuration not available - this SDK version may not be supported",
+                ),
+                this.Be(),
                 e());
         },
         error: (i) => {
@@ -142,96 +286,195 @@ export default class tr extends t {
         },
       });
   }
-  Gi() {
-    const i = r.l();
-    if (i && !i.Xi())
-      return void E.info(
-        "Real-time messaging is not enabled, skipping connection",
-      );
-    if (!this.Wi())
+  He() {
+    if (!this.h || !this.h.Ze()) return;
+    if (!this.Qe())
       return void E.error(
         "Cannot start real-time subscription without configuration",
       );
-    this.Ri &&
+    if (this.Xe())
+      return (
+        E.info(
+          "Real-time messaging auth token has expired, refreshing configuration",
+        ),
+        void this.Ye(
+          () => {
+            this.He();
+          },
+          () => {
+            E.error(
+              "Failed to refresh expired real-time messaging configuration",
+            );
+          },
+        )
+      );
+    const i = this.mite,
+      t = this.Ri || this.ki;
+    if (i && t)
+      switch (this.Qi) {
+        case "sharedworker":
+          this.sn(i, t);
+          break;
+        case "direct":
+          this.xi &&
+            (E.info(
+              "Real-time connection already exists, closing before starting new subscription",
+            ),
+            this.qe()),
+            this.en();
+      }
+  }
+  on() {
+    const i = this.mite,
+      t = this.Ri || this.ki;
+    return i && t
+      ? ti(t, i, this.ji, this.yi || void 0, this.Mi || void 0)
+      : null;
+  }
+  sn(i, t) {
+    var s, e, n;
+    if ((this.Ki || this._i(), !this.Ki))
+      return (
+        E.info(
+          "SharedWorker initialization failed, falling back to direct EventSource",
+        ),
+        (this.Qi = "direct"),
+        void this.hn()
+      );
+    this.Ri && E.info(`Using custom real-time messaging host: ${this.Ri}`),
+      E.info("Starting real-time subscription via SharedWorker");
+    const r = (null === (s = this.h) || void 0 === s ? void 0 : s.st()) || c,
+      o = (null === (e = this.h) || void 0 === e ? void 0 : e.nt()) || u,
+      h = (null === (n = this.h) || void 0 === n ? void 0 : n.it()) || d;
+    this.Ki.connect({
+      mite: i,
+      ki: t,
+      auth: this.yi || void 0,
+      an: { ln: r, cn: o, un: h },
+    });
+  }
+  hn() {
+    this.xi &&
       (E.info(
         "Real-time connection already exists, closing before starting new subscription",
       ),
-      this.Li());
-    const t = this.mite,
-      s = this.$i || this.yi;
-    if (!t || !s) return;
-    const e = `${
-      /^https?:\/\//i.test(s) ? s : `https://${s}`
-    }/sse?mite=${encodeURIComponent(t)}&attempts=${this.Mi}`;
-    this.$i && E.info(`Using custom real-time messaging host: ${this.$i}`);
-    try {
-      (this.Ri = new EventSource(e)),
-        (this.Ri.onopen = () => {
-          E.info("Real-time messaging connection established"),
-            (this.Mi = 0),
-            (this.Ui = !0);
-        }),
-        this.Ri.addEventListener("msg", (i) => {
-          this.Zi(i.data);
+      this.dn()),
+      this.en();
+  }
+  en(i) {
+    const t = this.on();
+    if (t) {
+      this.Ri && E.info(`Using custom real-time messaging host: ${this.Ri}`);
+      try {
+        const s = new EventSource(t);
+        (s.onopen = () => {
+          i
+            ? (E.info(
+                "Gapless reconnection: new connection established, closing old connection",
+              ),
+              i.close())
+            : E.info("Real-time messaging connection established"),
+            (this.xi = s),
+            (this.ji = 0),
+            (this.Bi = null),
+            (this.zi = !0),
+            (this.Xi = !0);
         }),
-        (this.Ri.onerror = (i) => {
-          var t;
-          const s =
-            null === (t = this.Ri) || void 0 === t ? void 0 : t.readyState;
-          this.Bi ||
-            E.error(
-              `Real-time messaging connection error (readyState: ${s}, eventPhase: ${
-                null == i ? void 0 : i.eventPhase
-              })`,
-            ),
-            this.Li(),
-            this.Ui && this.Mi < this.ji
-              ? this._i()
-              : (this.Mi >= this.ji &&
-                  E.error(
-                    `Max retry attempts (${this.ji}) reached for real-time messaging, giving up for current session`,
+          s.addEventListener("msg", (i) => {
+            this.gn(i.data);
+          }),
+          (s.onerror = () => {
+            const t = s.readyState;
+            return (
+              this.Hi ||
+                (0 === t
+                  ? E.info("Real-time messaging failed to connect")
+                  : E.info("Real-time messaging connection lost")),
+              i && this.xi !== s
+                ? (E.info(
+                    "Gapless reconnection failed, keeping old connection",
                   ),
-                (this.Ui = !1));
-        });
-    } catch (i) {
-      E.error(
-        `Failed to create real-time messaging connection: ${
-          i instanceof Error ? i.message : String(i)
-        }`,
-      );
+                  s.close(),
+                  void (this.zi && this.ji < this.Wi && this.mn()))
+                : (this.dn(),
+                  this.Xi && (this.Yi++, this.Yi > 1)
+                    ? (E.info(
+                        "Real-time messaging connection lost twice after successful connect (likely multi-tab conflict), yielding to other tab",
+                      ),
+                      void (this.zi = !1))
+                    : void (this.zi && this.ji < this.Wi
+                        ? this.mn()
+                        : (this.ji >= this.Wi &&
+                            E.error(
+                              `Max retry attempts (${this.Wi}) reached for real-time messaging, giving up for current session`,
+                            ),
+                          (this.zi = !1))))
+            );
+          });
+      } catch (i) {
+        E.error(
+          `Failed to create real-time messaging connection: ${
+            i instanceof Error ? i.message : String(i)
+          }`,
+        );
+      }
     }
   }
-  _i() {
-    this.Mi++;
-    const i = Math.min(1e3 * Math.pow(2, this.Mi), 6e4);
-    E.info(
-      `Retrying real-time messaging connection in ${i}ms (attempt ${this.Mi}/${this.ji})`,
-    ),
+  mn() {
+    var i, t, s;
+    this.ji++;
+    const e = (null === (i = this.h) || void 0 === i ? void 0 : i.st()) || c,
+      n = (null === (t = this.h) || void 0 === t ? void 0 : t.it()) || d,
+      r = (null === (s = this.h) || void 0 === s ? void 0 : s.nt()) || u;
+    let o = this.Bi;
+    (null == o || o < e) && (o = e);
+    const h = Math.min(r, a(e, o * n));
+    (this.Bi = h),
+      E.info(
+        `Retrying real-time messaging connection in ${h}ms (attempt ${this.ji}/${this.Wi})`,
+      ),
       (this.Fi = window.setTimeout(() => {
-        (this.Fi = null), this.Gi();
-      }, i));
+        (this.Fi = null), this.He();
+      }, h));
+  }
+  Oe() {
+    if (this.Qe()) {
+      if (this.Xe())
+        return (
+          E.info(
+            "Auth token expired during gapless reconnection, falling back to regular reconnection",
+          ),
+          this.qe(),
+          void this.He()
+        );
+      null !== this.Ui && (window.clearTimeout(this.Ui), (this.Ui = null)),
+        this.en(this.xi || void 0);
+    } else E.error("Cannot perform gapless reconnection without configuration");
   }
-  Li() {
+  qe() {
+    var i;
+    switch (this.Qi) {
+      case "sharedworker":
+        null === (i = this.Ki) || void 0 === i || i.disconnect();
+        break;
+      case "direct":
+        this.dn();
+    }
+  }
+  dn() {
     null !== this.Fi && (window.clearTimeout(this.Fi), (this.Fi = null)),
-      this.Ri &&
-        (this.Ri.close(),
-        (this.Ri = null),
+      null !== this.Ui && (window.clearTimeout(this.Ui), (this.Ui = null)),
+      this.xi &&
+        (this.xi.close(),
+        (this.xi = null),
         E.info("Real-time messaging connection closed"));
   }
-  Zi(i) {
+  gn(i) {
     try {
       const t = JSON.parse(i);
-      if (!t.type)
-        return void E.error(
-          `Received real-time message without type: ${JSON.stringify(t)}`,
-        );
-      E.info(`Received real-time message of type '${t.type}'`);
-      const s = this.Ji.get(t.type);
-      s && s.he() > 0
-        ? s.L(t)
-        : E.info(`No subscribers for real-time message type '${t.type}'`);
+      this.ke(t);
     } catch (i) {
-      E.error(
+      E.warn(
         `Failed to parse real-time message: ${
           i instanceof Error ? i.message : String(i)
         }`,
@@ -239,48 +482,37 @@ export default class tr extends t {
     }
   }
   changeUser(i = !1) {
-    this.Li(),
-      !i && this.j
-        ? (this.Wi() &&
-            E.info(
-              "Clearing cached real-time messaging configuration for user change",
-            ),
-          this.j.Nt(s.ct.qi),
-          this.j.Nt(s.ct.zi),
-          (this.mite = null),
-          (this.yi = null))
-        : i &&
-          this.Wi() &&
+    this.qe(),
+      i ||
+        (this.Qe() &&
           E.info(
-            "Preserving cached real-time messaging configuration for anonymous->identified user transition",
+            "Clearing cached real-time messaging configuration for user change",
           ),
-      (this.Mi = 0),
-      (this.Ui = !0);
+        this.Be()),
+      this.Re();
   }
   clearData(i = !1) {
-    (this.Ui = !1),
-      this.Li(),
+    (this.zi = !1),
+      this.qe(),
       i &&
-        this.j &&
-        (this.Wi() &&
+        (this.Qe() &&
           E.info(
             "Clearing cached real-time messaging configuration (wipeData)",
           ),
-        this.j.Nt(s.ct.qi),
-        this.j.Nt(s.ct.zi),
-        (this.mite = null),
-        (this.yi = null)),
-      (this.Mi = 0);
+        this.Be()),
+      this.Re();
   }
   destroy() {
-    (this.Ui = !1),
-      this.Li(),
-      (this.mite = null),
-      (this.Mi = 0),
-      this.ki &&
-        (window.removeEventListener("beforeunload", this.ki), (this.ki = null)),
-      this.xi &&
-        (window.removeEventListener("pagehide", this.xi), (this.xi = null)),
+    (this.zi = !1),
+      this.qe(),
+      this.Be(),
+      this.Ki && (this.Ki.destroy(), (this.Ki = null)),
+      this.Li && (this.Ve("ddr", this.Li), (this.Li = null)),
+      this.Oi && (this.Ve("ttl", this.Oi), (this.Oi = null)),
+      this.qi &&
+        (window.removeEventListener("beforeunload", this.qi), (this.qi = null)),
+      this.Gi &&
+        (window.removeEventListener("pagehide", this.Gi), (this.Gi = null)),
       this.Pi &&
         (window.removeEventListener("pageshow", this.Pi), (this.Pi = null)),
       this.D && (r.removeSubscription(this.D), (this.D = null));