@knocklabs/client 0.18.4 → 0.18.6

package/dist/esm/clients/guide/client.mjs

@@ -1,53 +1,96 @@
-var _ = Object.defineProperty;
-var b = (a, e, t) => e in a ? _(a, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[e] = t;
-var d = (a, e, t) => b(a, typeof e != "symbol" ? e + "" : e, t);
+var b = Object.defineProperty;
+var I = (u, e, t) => e in u ? b(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
+var d = (u, e, t) => I(u, typeof e != "symbol" ? e + "" : e, t);
 import { Store as C } from "@tanstack/store";
-import { URLPattern as I } from "urlpattern-polyfill";
-import { byKey as w, mockDefaultGroup as E, formatFilters as g, formatState as p, findDefaultGroup as S, DEFAULT_GROUP_KEY as k, checkIfThrottled as R, formatGroupStage as f, SelectionResult as A, newUrl as L, predicateUrlRules as P, predicateUrlPatterns as $ } from "./helpers.mjs";
-const D = 50, T = 30 * 1e3, O = 3, G = {
+import { URLPattern as E } from "urlpattern-polyfill";
+import { byKey as w, mockDefaultGroup as R, formatFilters as k, formatState as f, findDefaultGroup as v, DEFAULT_GROUP_KEY as S, checkIfThrottled as P, formatGroupStage as G, SelectionResult as A, newUrl as D, predicateUrlRules as K, predicateUrlPatterns as L } from "./helpers.mjs";
+const O = 50, $ = 30 * 1e3, T = 3, g = {
   GUIDE_KEY: "knock_guide_key",
   PREVIEW_SESSION_ID: "knock_preview_session_id"
-}, l = () => {
+}, p = "knock_guide_debug", l = () => {
   if (typeof window < "u")
     return window;
-}, K = (a) => `/v1/users/${a}/guides`, y = () => {
-  const a = l();
-  if (!a)
+}, U = (u) => `/v1/users/${u}/guides`, y = () => {
+  const u = l();
+  if (!u)
     return { forcedGuideKey: null, previewSessionId: null };
-  const e = new URLSearchParams(a.location.search), t = e.get(G.GUIDE_KEY), s = e.get(G.PREVIEW_SESSION_ID);
-  return { forcedGuideKey: t, previewSessionId: s };
-}, m = (a, e = {}) => {
-  const t = new A(), s = S(a.guideGroups);
+  const e = new URLSearchParams(u.location.search), t = e.get(g.GUIDE_KEY), s = e.get(
+    g.PREVIEW_SESSION_ID
+  );
+  if (t || s) {
+    if (u.localStorage)
+      try {
+        const r = {
+          forcedGuideKey: t,
+          previewSessionId: s
+        };
+        u.localStorage.setItem(p, JSON.stringify(r));
+      } catch {
+      }
+    return {
+      forcedGuideKey: t,
+      previewSessionId: s
+    };
+  }
+  let i = null, n = null;
+  if (u.localStorage)
+    try {
+      const r = u.localStorage.getItem(p);
+      if (r) {
+        const o = F(r);
+        i = o.forcedGuideKey, n = o.previewSessionId;
+      }
+    } catch {
+    }
+  return {
+    forcedGuideKey: i,
+    previewSessionId: n
+  };
+}, F = (u) => {
+  try {
+    const e = JSON.parse(u);
+    return {
+      forcedGuideKey: (e == null ? void 0 : e.forcedGuideKey) ?? null,
+      previewSessionId: (e == null ? void 0 : e.previewSessionId) ?? null
+    };
+  } catch {
+    return {
+      forcedGuideKey: null,
+      previewSessionId: null
+    };
+  }
+}, m = (u, e = {}) => {
+  const t = new A(), s = v(u.guideGroups);
   if (!s) return t;
-  const i = [...s.display_sequence], r = a.location;
-  if (a.debug.forcedGuideKey) {
-    const n = i.indexOf(a.debug.forcedGuideKey);
-    n > -1 && i.splice(n, 1), i.unshift(a.debug.forcedGuideKey);
-  }
-  for (const [n, o] of i.entries()) {
-    let u = a.guides[o];
-    a.debug.forcedGuideKey === o && a.previewGuides[o] && (u = a.previewGuides[o]), !(!u || !F(u, {
-      location: r,
+  const i = [...s.display_sequence], n = u.location;
+  if (u.debug.forcedGuideKey) {
+    const r = i.indexOf(u.debug.forcedGuideKey);
+    r > -1 && i.splice(r, 1), i.unshift(u.debug.forcedGuideKey);
+  }
+  for (const [r, o] of i.entries()) {
+    let a = u.guides[o];
+    u.debug.forcedGuideKey === o && u.previewGuides[o] && (a = u.previewGuides[o]), !(!a || !N(a, {
+      location: n,
       filters: e,
-      debug: a.debug
-    })) && t.set(n, u);
+      debug: u.debug
+    })) && t.set(r, a);
   }
   return t.metadata = { guideGroup: s }, t;
-}, F = (a, { location: e, filters: t = {}, debug: s = {} }) => {
-  if (t.type && t.type !== a.type || t.key && t.key !== a.key)
+}, N = (u, { location: e, filters: t = {}, debug: s = {} }) => {
+  if (t.type && t.type !== u.type || t.key && t.key !== u.key)
     return !1;
-  if (s.forcedGuideKey === a.key)
+  if (s.forcedGuideKey === u.key)
     return !0;
-  if (!a.active || a.steps.every((o) => !!o.message.archived_at))
+  if (!u.active || u.steps.every((o) => !!o.message.archived_at))
     return !1;
-  const i = e ? L(e) : void 0, r = a.activation_url_rules || [], n = a.activation_url_patterns || [];
-  if (i && r.length > 0) {
-    if (!P(i, r)) return !1;
-  } else if (i && n.length > 0 && !$(i, n))
+  const i = e ? D(e) : void 0, n = u.activation_url_rules || [], r = u.activation_url_patterns || [];
+  if (i && n.length > 0) {
+    if (!K(i, n)) return !1;
+  } else if (i && r.length > 0 && !L(i, r))
     return !1;
   return !0;
 };
-class x {
+class B {
   constructor(e, t, s = {}, i = {}) {
     d(this, "store");
     // Phoenix channels for real time guide updates over websocket
@@ -88,22 +131,22 @@ class x {
     });
     this.knock = e, this.channelId = t, this.targetParams = s, this.options = i;
     const {
-      trackLocationFromWindow: r = !0,
-      throttleCheckInterval: n = T
-    } = i, o = l(), u = r ? o == null ? void 0 : o.location.href : void 0, h = y();
+      trackLocationFromWindow: n = !0,
+      throttleCheckInterval: r = $
+    } = i, o = l(), a = n ? o == null ? void 0 : o.location.href : void 0, h = y();
     this.store = new C({
       guideGroups: [],
       guideGroupDisplayLogs: {},
       guides: {},
       previewGuides: {},
       queries: {},
-      location: u,
+      location: a,
       // Increment to update the state store and trigger re-selection.
       counter: 0,
       debug: h
     });
     const { socket: c } = this.knock.client();
-    this.socket = c, this.socketChannelTopic = `guides:${t}`, r && this.listenForLocationChangesFromWindow(), n && this.startCounterInterval(n), this.knock.log("[Guide] Initialized a guide client");
+    this.socket = c, this.socketChannelTopic = `guides:${t}`, n && this.listenForLocationChangesFromWindow(), r && this.startCounterInterval(r), this.knock.log("[Guide] Initialized a guide client");
   }
   incrementCounter() {
     this.knock.log("[Guide] Incrementing the counter"), this.store.setState((e) => ({ ...e, counter: e.counter + 1 }));
@@ -124,30 +167,30 @@ class x {
     const t = this.buildQueryParams(e == null ? void 0 : e.filters), s = this.formatQueryKey(t), i = this.store.state.queries[s];
     if (i)
       return i;
-    this.store.setState((n) => ({
-      ...n,
-      queries: { ...n.queries, [s]: { status: "loading" } }
+    this.store.setState((r) => ({
+      ...r,
+      queries: { ...r.queries, [s]: { status: "loading" } }
     }));
-    let r;
+    let n;
     try {
       this.knock.log("[Guide] Fetching all eligible guides");
-      const n = await this.knock.user.getGuides(this.channelId, t);
-      r = { status: "ok" };
-      const { entries: o, guide_groups: u, guide_group_display_logs: h } = n;
+      const r = await this.knock.user.getGuides(this.channelId, t);
+      n = { status: "ok" };
+      const { entries: o, guide_groups: a, guide_group_display_logs: h } = r;
       this.knock.log("[Guide] Loading fetched guides"), this.store.setState((c) => ({
         ...c,
-        guideGroups: (u == null ? void 0 : u.length) > 0 ? u : [E(o)],
+        guideGroups: (a == null ? void 0 : a.length) > 0 ? a : [R(o)],
         guideGroupDisplayLogs: h || {},
-        guides: w(o.map((v) => this.localCopy(v))),
-        queries: { ...c.queries, [s]: r }
+        guides: w(o.map((_) => this.localCopy(_))),
+        queries: { ...c.queries, [s]: n }
       }));
-    } catch (n) {
-      r = { status: "error", error: n }, this.store.setState((o) => ({
+    } catch (r) {
+      n = { status: "error", error: r }, this.store.setState((o) => ({
         ...o,
-        queries: { ...o.queries, [s]: r }
+        queries: { ...o.queries, [s]: n }
       }));
     }
-    return r;
+    return n;
   }
   subscribe() {
     if (!this.socket) return;
@@ -159,7 +202,7 @@ class x {
       preview_session_id: e.previewSessionId || void 0
     }, s = this.socket.channel(this.socketChannelTopic, t);
     for (const i of this.socketEventTypes)
-      s.on(i, (r) => this.handleSocketEvent(r));
+      s.on(i, (n) => this.handleSocketEvent(n));
     ["closed", "errored"].includes(s.state) && (this.subscribeRetryCount = 0, s.join().receive("ok", () => {
       this.knock.log("[Guide] Successfully joined channel");
     }).receive("error", (i) => {
@@ -171,7 +214,7 @@ class x {
     })), this.socketChannel = s;
   }
   handleChannelJoinError() {
-    if (this.subscribeRetryCount >= O) {
+    if (this.subscribeRetryCount >= T) {
       this.knock.log(
         `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`
       ), this.unsubscribe();
@@ -207,8 +250,8 @@ class x {
   }
   setLocation(e, t = {}) {
     this.knock.log(`[Guide] .setLocation (loc=${e})`), this.clearGroupStage(), this.knock.log("[Guide] Updating the tracked location"), this.store.setState((s) => {
-      var r;
-      const i = (r = t == null ? void 0 : t.debug) != null && r.previewSessionId ? s.previewGuides : {};
+      var n;
+      const i = (n = t == null ? void 0 : t.debug) != null && n.previewSessionId ? s.previewGuides : {};
       return {
         ...s,
         ...t,
@@ -217,12 +260,30 @@ class x {
       };
     });
   }
+  exitDebugMode() {
+    this.knock.log("[Guide] Exiting debug mode");
+    const e = l();
+    if (e != null && e.localStorage)
+      try {
+        e.localStorage.removeItem(p);
+      } catch {
+      }
+    if (this.store.setState((t) => ({
+      ...t,
+      debug: { forcedGuideKey: null, previewSessionId: null },
+      previewGuides: {}
+      // Clear preview guides when exiting debug mode
+    })), e) {
+      const t = new URL(e.location.href);
+      (t.searchParams.has(g.GUIDE_KEY) || t.searchParams.has(g.PREVIEW_SESSION_ID)) && (t.searchParams.delete(g.GUIDE_KEY), t.searchParams.delete(g.PREVIEW_SESSION_ID), e.location.href = t.toString());
+    }
+  }
   //
   // Store selector
   //
   selectGuides(e, t = {}) {
     if (this.knock.log(
-      `[Guide] .selectGuides (filters: ${g(t)}; state: ${p(e)})`
+      `[Guide] .selectGuides (filters: ${k(t)}; state: ${f(e)})`
     ), Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0)
       return this.knock.log("[Guide] Exiting selection (no guides)"), [];
     const s = m(e, t);
@@ -230,7 +291,7 @@ class x {
   }
   selectGuide(e, t = {}) {
     if (this.knock.log(
-      `[Guide] .selectGuide (filters: ${g(t)}; state: ${p(e)})`
+      `[Guide] .selectGuide (filters: ${k(t)}; state: ${f(e)})`
     ), Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0) {
       this.knock.log("[Guide] Exiting selection (no guides)");
       return;
@@ -240,43 +301,43 @@ class x {
       this.knock.log("[Guide] Selection found zero result");
       return;
     }
-    const [i, r] = [...s][0];
+    const [i, n] = [...s][0];
     if (this.knock.log(
-      `[Guide] Selection found: \`${r.key}\` (total: ${s.size})`
-    ), r.bypass_global_group_limit)
-      return this.knock.log(`[Guide] Returning the unthrottled guide: ${r.key}`), r;
-    const n = S(e.guideGroups), o = e.guideGroupDisplayLogs[k];
-    if (n && n.display_interval && o && R(
+      `[Guide] Selection found: \`${n.key}\` (total: ${s.size})`
+    ), n.bypass_global_group_limit)
+      return this.knock.log(`[Guide] Returning the unthrottled guide: ${n.key}`), n;
+    const r = v(e.guideGroups), o = e.guideGroupDisplayLogs[S];
+    if (r && r.display_interval && o && P(
       o,
-      n.display_interval
+      r.display_interval
     )) {
-      this.knock.log(`[Guide] Throttling the selected guide: ${r.key}`);
+      this.knock.log(`[Guide] Throttling the selected guide: ${n.key}`);
       return;
     }
     switch (this.stage || (this.stage = this.openGroupStage()), this.stage.status) {
       case "open": {
-        this.knock.log(`[Guide] Addng to the group stage: ${r.key}`), this.stage.ordered[i] = r.key;
+        this.knock.log(`[Guide] Adding to the group stage: ${n.key}`), this.stage.ordered[i] = n.key;
         return;
       }
       case "patch": {
-        this.knock.log(`[Guide] Patching the group stage: ${r.key}`), this.stage.ordered[i] = r.key;
-        const u = this.stage.resolved === r.key ? r : void 0;
+        this.knock.log(`[Guide] Patching the group stage: ${n.key}`), this.stage.ordered[i] = n.key;
+        const a = this.stage.resolved === n.key ? n : void 0;
         return this.knock.log(
-          `[Guide] Returning \`${u == null ? void 0 : u.key}\` (stage: ${f(this.stage)})`
-        ), u;
+          `[Guide] Returning \`${a == null ? void 0 : a.key}\` (stage: ${G(this.stage)})`
+        ), a;
       }
       case "closed": {
-        const u = this.stage.resolved === r.key ? r : void 0;
+        const a = this.stage.resolved === n.key ? n : void 0;
         return this.knock.log(
-          `[Guide] Returning \`${u == null ? void 0 : u.key}\` (stage: ${f(this.stage)})`
-        ), u;
+          `[Guide] Returning \`${a == null ? void 0 : a.key}\` (stage: ${G(this.stage)})`
+        ), a;
       }
     }
   }
   openGroupStage() {
     this.knock.log("[Guide] Opening a new group stage");
     const {
-      orderResolutionDuration: e = D
+      orderResolutionDuration: e = O
     } = this.options, t = setTimeout(() => {
       this.closePendingGroupStage(), this.incrementCounter();
     }, e);
@@ -363,16 +424,16 @@ class x {
     this.knock.log(
       `[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`
     );
-    const i = (/* @__PURE__ */ new Date()).toISOString(), r = this.setStepMessageAttrs(e.key, t.ref, {
+    const i = (/* @__PURE__ */ new Date()).toISOString(), n = this.setStepMessageAttrs(e.key, t.ref, {
       read_at: i,
       interacted_at: i
     });
-    if (!r) return;
-    const n = {
-      ...this.buildEngagementEventBaseParams(e, r),
+    if (!n) return;
+    const r = {
+      ...this.buildEngagementEventBaseParams(e, n),
       metadata: s
     };
-    return this.knock.user.markGuideStepAs("interacted", n), r;
+    return this.knock.user.markGuideStepAs("interacted", r), n;
   }
   async markAsArchived(e, t) {
     if (t.message.archived_at) return;
@@ -403,9 +464,9 @@ class x {
         return t.store.state.debug.forcedGuideKey === this.key ? this.steps[0] : this.steps.find((i) => !i.message.archived_at);
       }
     };
-    return s.getStep = s.getStep.bind(s), s.steps = e.steps.map(({ message: i, ...r }) => {
-      const n = {
-        ...r,
+    return s.getStep = s.getStep.bind(s), s.steps = e.steps.map(({ message: i, ...n }) => {
+      const r = {
+        ...n,
         message: { ...i },
         markAsSeen() {
           if (!this.message.seen_at)
@@ -419,10 +480,10 @@ class x {
             return t.markAsArchived(s, this);
         }
       };
-      return n.markAsSeen = n.markAsSeen.bind(n), n.markAsInteracted = n.markAsInteracted.bind(n), n.markAsArchived = n.markAsArchived.bind(n), n;
+      return r.markAsSeen = r.markAsSeen.bind(r), r.markAsInteracted = r.markAsInteracted.bind(r), r.markAsArchived = r.markAsArchived.bind(r), r;
     }), s.activation_url_patterns = e.activation_url_patterns.map((i) => ({
       ...i,
-      pattern: new I({ pathname: i.pathname })
+      pattern: new E({ pathname: i.pathname })
     })), s;
   }
   buildQueryParams(e = {}) {
@@ -433,34 +494,33 @@ class x {
     this.store.state.debug.forcedGuideKey && (t.force_all_guides = !0);
     let i = Object.fromEntries(
       Object.entries(t).filter(
-        ([r, n]) => n != null
+        ([n, r]) => r != null
       )
     );
     return i = i.data ? { ...i, data: JSON.stringify(i.data) } : i, i;
   }
   formatQueryKey(e) {
     const s = Object.keys(e).sort().map(
-      (r) => `${encodeURIComponent(r)}=${encodeURIComponent(e[r])}`
-    ).join("&"), i = K(this.knock.userId);
+      (n) => `${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`
+    ).join("&"), i = U(this.knock.userId);
     return s ? `${i}?${s}` : i;
   }
   setStepMessageAttrs(e, t, s) {
     let i;
-    return s.archived_at && this.clearGroupStage(), this.store.setState((r) => {
-      const n = r.guides[e];
-      if (!n) return r;
-      const o = n.steps.map((c) => (c.ref !== t || (c.message = { ...c.message, ...s }, i = c), c));
-      n.steps = o;
-      const u = { ...r.guides, [n.key]: n }, h = s.archived_at && !n.bypass_global_group_limit ? {
-        ...r.guideGroupDisplayLogs,
-        [k]: s.archived_at
-      } : r.guideGroupDisplayLogs;
-      return { ...r, guides: u, guideGroupDisplayLogs: h };
+    return s.archived_at && this.clearGroupStage(), this.store.setState((n) => {
+      let r = n.guides[e];
+      if (!r) return n;
+      const o = r.steps.map((c) => (c.ref !== t || (c.message = { ...c.message, ...s }, i = c), c));
+      r = i ? { ...r, steps: o } : r;
+      const a = { ...n.guides, [r.key]: r }, h = s.archived_at && !r.bypass_global_group_limit ? {
+        ...n.guideGroupDisplayLogs,
+        [S]: s.archived_at
+      } : n.guideGroupDisplayLogs;
+      return { ...n, guides: a, guideGroupDisplayLogs: h };
     }), i;
   }
   buildEngagementEventBaseParams(e, t) {
     return {
-      message_id: t.message.id,
       channel_id: e.channel_id,
       guide_key: e.key,
       guide_id: e.id,
@@ -485,17 +545,17 @@ class x {
     data: e
   }) {
     this.patchClosedGroupStage(), this.store.setState((t) => {
-      const s = [e.guide_group], i = e.guide_group.display_sequence_unthrottled || [], r = e.guide_group.display_sequence_throttled || [];
-      let n = t.guides;
-      return n = i.reduce((o, u) => {
-        if (!o[u]) return o;
-        const h = { ...o[u], bypass_global_group_limit: !0 };
-        return { ...o, [u]: h };
-      }, n), n = r.reduce((o, u) => {
-        if (!o[u]) return o;
-        const h = { ...o[u], bypass_global_group_limit: !1 };
-        return { ...o, [u]: h };
-      }, n), { ...t, guides: n, guideGroups: s };
+      const s = [e.guide_group], i = e.guide_group.display_sequence_unthrottled || [], n = e.guide_group.display_sequence_throttled || [];
+      let r = t.guides;
+      return r = i.reduce((o, a) => {
+        if (!o[a]) return o;
+        const h = { ...o[a], bypass_global_group_limit: !0 };
+        return { ...o, [a]: h };
+      }, r), r = n.reduce((o, a) => {
+        if (!o[a]) return o;
+        const h = { ...o[a], bypass_global_group_limit: !1 };
+        return { ...o, [a]: h };
+      }, r), { ...t, guides: r, guideGroups: s };
     });
   }
   updatePreviewGuide({ data: e }) {
@@ -516,14 +576,14 @@ class x {
       e.addEventListener("popstate", this.handleLocationChange), e.addEventListener("hashchange", this.handleLocationChange);
       const t = e.history.pushState, s = e.history.replaceState;
       e.history.pushState = new Proxy(t, {
-        apply: (i, r, n) => {
-          Reflect.apply(i, r, n), setTimeout(() => {
+        apply: (i, n, r) => {
+          Reflect.apply(i, n, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
       }), e.history.replaceState = new Proxy(s, {
-        apply: (i, r, n) => {
-          Reflect.apply(i, r, n), setTimeout(() => {
+        apply: (i, n, r) => {
+          Reflect.apply(i, n, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
@@ -539,8 +599,8 @@ class x {
   }
 }
 export {
-  G as DEBUG_QUERY_PARAMS,
-  x as KnockGuideClient,
-  K as guidesApiRootPath
+  g as DEBUG_QUERY_PARAMS,
+  B as KnockGuideClient,
+  U as guidesApiRootPath
 };
 //# sourceMappingURL=client.mjs.map