@knocklabs/client 0.21.2 → 0.21.4

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

@@ -1,44 +1,44 @@
-var I = Object.defineProperty;
-var C = (u, e, t) => e in u ? I(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
-var l = (u, e, t) => C(u, typeof e != "symbol" ? e + "" : e, t);
-import { Store as E } from "@tanstack/store";
-import { URLPattern as w } from "urlpattern-polyfill";
-import { byKey as y, mockDefaultGroup as R, formatFilters as G, formatState as S, checkStateIfThrottled as m, formatGroupStage as v, DEFAULT_GROUP_KEY as P, newUrl as D, predicateUrlRules as A, predicateUrlPatterns as L, findDefaultGroup as T } from "./helpers.mjs";
-import { SelectionResult as $ } from "./types.mjs";
-const K = 50, O = 30 * 1e3, U = 3, p = {
+var E = Object.defineProperty;
+var w = (u, e, s) => e in u ? E(u, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : u[e] = s;
+var h = (u, e, s) => w(u, typeof e != "symbol" ? e + "" : e, s);
+import { Store as R } from "@tanstack/store";
+import { URLPattern as A } from "urlpattern-polyfill";
+import { byKey as m, mockDefaultGroup as P, formatFilters as v, formatState as b, checkStateIfThrottled as _, formatGroupStage as y, DEFAULT_GROUP_KEY as D, newUrl as K, predicateUrlRules as L, predicateUrlPatterns as $, findDefaultGroup as T } from "./helpers.mjs";
+import { SelectionResult as O } from "./types.mjs";
+const F = 50, U = 30 * 1e3, q = 3, f = {
   GUIDE_KEY: "knock_guide_key",
   PREVIEW_SESSION_ID: "knock_preview_session_id"
-}, f = "knock_guide_debug", k = () => {
+}, G = "knock_guide_debug", p = () => {
   if (typeof window < "u")
     return window;
-}, F = (u) => `/v1/users/${u}/guides`, b = () => {
-  const u = k();
+}, N = (u) => `/v1/users/${u}/guides`, I = () => {
+  const u = p();
   if (!u || !u.location)
     return { forcedGuideKey: null, previewSessionId: null };
-  const e = new URLSearchParams(u.location.search), t = e.get(p.GUIDE_KEY), s = e.get(
-    p.PREVIEW_SESSION_ID
+  const e = new URLSearchParams(u.location.search), s = e.get(f.GUIDE_KEY), t = e.get(
+    f.PREVIEW_SESSION_ID
   );
-  if (t || s) {
+  if (s || t) {
     if (u.localStorage)
       try {
         const r = {
-          forcedGuideKey: t,
-          previewSessionId: s
+          forcedGuideKey: s,
+          previewSessionId: t
         };
-        u.localStorage.setItem(f, JSON.stringify(r));
+        u.localStorage.setItem(G, JSON.stringify(r));
       } catch {
       }
     return {
-      forcedGuideKey: t,
-      previewSessionId: s
+      forcedGuideKey: s,
+      previewSessionId: t
     };
   }
   let i = null, n = null;
   if (u.localStorage)
     try {
-      const r = u.localStorage.getItem(f);
+      const r = u.localStorage.getItem(G);
       if (r) {
-        const a = q(r);
+        const a = j(r);
         i = a.forcedGuideKey, n = a.previewSessionId;
       }
     } catch {
@@ -47,7 +47,7 @@ const K = 50, O = 30 * 1e3, U = 3, p = {
     forcedGuideKey: i,
     previewSessionId: n
   };
-}, q = (u) => {
+}, j = (u) => {
   try {
     const e = JSON.parse(u);
     return {
@@ -60,35 +60,35 @@ const K = 50, O = 30 * 1e3, U = 3, p = {
       previewSessionId: null
     };
   }
-}, _ = (u, e, t) => {
-  const s = new $(), i = T(u.guideGroups);
-  if (!i) return s;
+}, C = (u, e, s) => {
+  const t = new O(), i = T(u.guideGroups);
+  if (!i) return t;
   const n = i.display_sequence, r = u.location;
   for (const [a, o] of n.entries()) {
     const c = u.previewGuides[o] || u.guides[o];
-    !c || !N(c, e, {
+    !c || !B(c, e, {
       location: r,
       ineligibleGuides: u.ineligibleGuides,
       debug: u.debug
-    }) || s.set(a, c);
-  }
-  return s.metadata = { guideGroup: i, filters: e, ...t }, s;
-}, N = (u, e, { location: t, ineligibleGuides: s = {}, debug: i = {} }) => e.type && e.type !== u.type || e.key && e.key !== u.key ? !1 : i.forcedGuideKey ? i.forcedGuideKey === u.key : s[u.key] || !u.active || u.steps.every((r) => !!r.message.archived_at) ? !1 : j(u, t), j = (u, e) => {
-  const t = e ? D(e) : void 0, s = u.activation_url_rules || [], i = u.activation_url_patterns || [];
-  if (t && s.length > 0) {
-    if (!A(t, s)) return !1;
-  } else if (t && i.length > 0 && !L(t, i))
+    }) || t.set(a, c);
+  }
+  return t.metadata = { guideGroup: i, filters: e, ...s }, t;
+}, B = (u, e, { location: s, ineligibleGuides: t = {}, debug: i = {} }) => e.type && e.type !== u.type || e.key && e.key !== u.key ? !1 : i.focusedGuideKeys && Object.keys(i.focusedGuideKeys).length > 0 ? !!i.focusedGuideKeys[u.key] : i.forcedGuideKey ? i.forcedGuideKey === u.key : t[u.key] || !u.active || u.steps.every((r) => !!r.message.archived_at) ? !1 : M(u, s), M = (u, e) => {
+  const s = e ? K(e) : void 0, t = u.activation_url_rules || [], i = u.activation_url_patterns || [];
+  if (s && t.length > 0) {
+    if (!L(s, t)) return !1;
+  } else if (s && i.length > 0 && !$(s, i))
     return !1;
   return !0;
 };
-class W {
-  constructor(e, t, s = {}, i = {}) {
-    l(this, "store");
+class V {
+  constructor(e, s, t = {}, i = {}) {
+    h(this, "store");
     // Phoenix channels for real time guide updates over websocket
-    l(this, "socket");
-    l(this, "socketChannel");
-    l(this, "socketChannelTopic");
-    l(this, "socketEventTypes", [
+    h(this, "socket");
+    h(this, "socketChannel");
+    h(this, "socketChannelTopic");
+    h(this, "socketEventTypes", [
       "guide.added",
       "guide.updated",
       "guide.removed",
@@ -96,44 +96,44 @@ class W {
       "guide_group.updated",
       "guide.live_preview_updated"
     ]);
-    l(this, "subscribeRetryCount", 0);
+    h(this, "subscribeRetryCount", 0);
     // Original history methods to monkey patch, or restore in cleanups.
-    l(this, "pushStateFn");
-    l(this, "replaceStateFn");
+    h(this, "pushStateFn");
+    h(this, "replaceStateFn");
     // Guides that are competing to render are "staged" first without rendering
     // and ranked based on its relative order in the group over a duration of time
     // to resolve and render the prevailing one.
-    l(this, "stage");
-    l(this, "counterIntervalId");
+    h(this, "stage");
+    h(this, "counterIntervalId");
     // Define as an arrow func property to always bind this to the class instance.
-    l(this, "handleLocationChange", () => {
+    h(this, "handleLocationChange", () => {
       this.knock.log("[Guide] .handleLocationChange");
-      const e = k();
+      const e = p();
       if (!(e != null && e.location)) return;
-      const t = e.location.href;
-      if (this.store.state.location === t) return;
-      if (this.knock.log(`[Guide] Detected a location change: ${t}`), !this.options.trackDebugParams) {
-        this.setLocation(t);
+      const s = e.location.href;
+      if (this.store.state.location === s) return;
+      if (this.knock.log(`[Guide] Detected a location change: ${s}`), !this.options.trackDebugParams) {
+        this.setLocation(s);
         return;
       }
-      const s = this.store.state.debug || {}, i = b();
-      this.setLocation(t, { debug: i }), this.checkDebugStateChanged(
-        s,
+      const t = this.store.state.debug || {}, i = I();
+      this.setLocation(s, { debug: i }), this.checkDebugStateChanged(
+        t,
         i
       ) && (this.knock.log(
         "[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"
       ), this.fetch(), this.subscribe());
     });
     var g;
-    this.knock = e, this.channelId = t, this.targetParams = s, this.options = i;
+    this.knock = e, this.channelId = s, this.targetParams = t, this.options = i;
     const {
       trackLocationFromWindow: n = !0,
       // TODO(KNO-11523): Remove once we ship guide toolbar v2, and offload as
       // much debugging specific logic and responsibilities to toolbar.
       trackDebugParams: r = !1,
-      throttleCheckInterval: a = O
-    } = i, o = k(), c = n ? (g = o == null ? void 0 : o.location) == null ? void 0 : g.href : void 0, d = r ? b() : void 0;
-    this.store = new E({
+      throttleCheckInterval: a = U
+    } = i, o = p(), c = n ? (g = o == null ? void 0 : o.location) == null ? void 0 : g.href : void 0, d = r ? I() : void 0;
+    this.store = new R({
       guideGroups: [],
       guideGroupDisplayLogs: {},
       guides: {},
@@ -145,8 +145,8 @@ class W {
       counter: 0,
       debug: d
     });
-    const { socket: h } = this.knock.client();
-    this.socket = h, this.socketChannelTopic = `guides:${t}`, n && this.listenForLocationChangesFromWindow(), a && this.startCounterInterval(a), this.knock.log("[Guide] Initialized a guide client");
+    const { socket: l } = this.knock.client();
+    this.socket = l, this.socketChannelTopic = `guides:${s}`, n && this.listenForLocationChangesFromWindow(), a && this.startCounterInterval(a), 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 }));
@@ -164,17 +164,17 @@ class W {
   }
   async fetch(e) {
     this.knock.log("[Guide] .fetch"), this.knock.failIfNotAuthenticated();
-    const t = this.buildQueryParams(e == null ? void 0 : e.filters), s = this.formatQueryKey(t), i = this.store.state.queries[s];
+    const s = this.buildQueryParams(e == null ? void 0 : e.filters), t = this.formatQueryKey(s), i = this.store.state.queries[t];
     if (i)
       return i;
     this.store.setState((r) => ({
       ...r,
-      queries: { ...r.queries, [s]: { status: "loading" } }
+      queries: { ...r.queries, [t]: { status: "loading" } }
     }));
     let n;
     try {
       this.knock.log("[Guide] Fetching all eligible guides");
-      const r = await this.knock.user.getGuides(this.channelId, t);
+      const r = await this.knock.user.getGuides(this.channelId, s);
       n = { status: "ok" };
       const {
         entries: a,
@@ -182,18 +182,18 @@ class W {
         guide_group_display_logs: c,
         ineligible_guides: d
       } = r;
-      this.knock.log("[Guide] Loading fetched guides"), this.store.setState((h) => ({
-        ...h,
-        guideGroups: (o == null ? void 0 : o.length) > 0 ? o : [R(a)],
+      this.knock.log("[Guide] Loading fetched guides"), this.store.setState((l) => ({
+        ...l,
+        guideGroups: (o == null ? void 0 : o.length) > 0 ? o : [P(a)],
         guideGroupDisplayLogs: c || {},
-        guides: y(a.map((g) => this.localCopy(g))),
-        ineligibleGuides: y(d || []),
-        queries: { ...h.queries, [s]: n }
+        guides: m(a.map((g) => this.localCopy(g))),
+        ineligibleGuides: m(d || []),
+        queries: { ...l.queries, [t]: n }
       }));
     } catch (r) {
       n = { status: "error", error: r }, this.store.setState((a) => ({
         ...a,
-        queries: { ...a.queries, [s]: n }
+        queries: { ...a.queries, [t]: n }
       }));
     }
     return n;
@@ -201,15 +201,15 @@ class W {
   subscribe() {
     if (!this.socket) return;
     this.knock.failIfNotAuthenticated(), this.knock.log("[Guide] Subscribing to real time updates"), this.socket.isConnected() || this.socket.connect(), this.socketChannel && this.unsubscribe();
-    const e = this.store.state.debug, t = {
+    const e = this.store.state.debug, s = {
       ...this.targetParams,
       user_id: this.knock.userId,
       force_all_guides: e != null && e.forcedGuideKey || e != null && e.debugging ? !0 : void 0,
       preview_session_id: (e == null ? void 0 : e.previewSessionId) || void 0
-    }, s = this.socket.channel(this.socketChannelTopic, t);
+    }, t = this.socket.channel(this.socketChannelTopic, s);
     for (const i of this.socketEventTypes)
-      s.on(i, (n) => this.handleSocketEvent(n));
-    ["closed", "errored"].includes(s.state) && (this.subscribeRetryCount = 0, s.join().receive("ok", () => {
+      t.on(i, (n) => this.handleSocketEvent(n));
+    ["closed", "errored"].includes(t.state) && (this.subscribeRetryCount = 0, t.join().receive("ok", () => {
       this.knock.log("[Guide] Successfully joined channel");
     }).receive("error", (i) => {
       this.knock.log(
@@ -217,10 +217,10 @@ class W {
       ), this.handleChannelJoinError();
     }).receive("timeout", () => {
       this.knock.log("[Guide] Channel join timed out"), this.handleChannelJoinError();
-    })), this.socketChannel = s;
+    })), this.socketChannel = t;
   }
   handleChannelJoinError() {
-    if (this.subscribeRetryCount >= U) {
+    if (this.subscribeRetryCount >= q) {
       this.knock.log(
         `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`
       ), this.unsubscribe();
@@ -237,12 +237,12 @@ class W {
     }
   }
   handleSocketEvent(e) {
-    const { event: t, data: s } = e;
-    switch (t) {
+    const { event: s, data: t } = e;
+    switch (s) {
       case "guide.added":
         return this.addOrReplaceGuide(e);
       case "guide.updated":
-        return s.eligible ? this.addOrReplaceGuide(e) : this.removeGuide(e);
+        return t.eligible ? this.addOrReplaceGuide(e) : this.removeGuide(e);
       case "guide.removed":
         return this.removeGuide(e);
       case "guide_group.added":
@@ -254,13 +254,13 @@ class W {
         return;
     }
   }
-  setLocation(e, t = {}) {
-    this.knock.log(`[Guide] .setLocation (loc=${e})`), this.clearGroupStage(), this.knock.log("[Guide] Updating the tracked location"), this.store.setState((s) => {
+  setLocation(e, s = {}) {
+    this.knock.log(`[Guide] .setLocation (loc=${e})`), this.clearGroupStage(), this.knock.log("[Guide] Updating the tracked location"), this.store.setState((t) => {
       var n;
-      const i = (n = t == null ? void 0 : t.debug) != null && n.previewSessionId ? s.previewGuides : {};
+      const i = (n = s == null ? void 0 : s.debug) != null && n.previewSessionId ? t.previewGuides : {};
       return {
-        ...s,
         ...t,
+        ...s,
         previewGuides: i,
         location: e
       };
@@ -268,83 +268,93 @@ class W {
   }
   exitDebugMode() {
     this.knock.log("[Guide] Exiting debug mode");
-    const e = k();
+    const e = p();
     if (e != null && e.localStorage)
       try {
-        e.localStorage.removeItem(f);
+        e.localStorage.removeItem(G);
       } catch {
       }
-    if (this.store.setState((t) => ({
-      ...t,
-      debug: { forcedGuideKey: null, previewSessionId: null },
+    if (this.store.setState((s) => ({
+      ...s,
+      debug: {
+        forcedGuideKey: null,
+        previewSessionId: null,
+        focusedGuideKeys: {}
+      },
       previewGuides: {}
       // Clear preview guides when exiting debug mode
     })), e != null && e.location) {
-      const t = new URL(e.location.href);
-      (t.searchParams.has(p.GUIDE_KEY) || t.searchParams.has(p.PREVIEW_SESSION_ID)) && (t.searchParams.delete(p.GUIDE_KEY), t.searchParams.delete(p.PREVIEW_SESSION_ID), e.location.href = t.toString());
+      const s = new URL(e.location.href);
+      (s.searchParams.has(f.GUIDE_KEY) || s.searchParams.has(f.PREVIEW_SESSION_ID)) && (s.searchParams.delete(f.GUIDE_KEY), s.searchParams.delete(f.PREVIEW_SESSION_ID), e.location.href = s.toString());
     }
   }
   setDebug(e) {
-    var s;
+    var t;
     this.knock.log("[Guide] .setDebug()");
-    const t = !((s = this.store.state.debug) != null && s.debugging);
-    this.store.setState((i) => ({
+    const s = !((t = this.store.state.debug) != null && t.debugging);
+    this.clearGroupStage(), this.store.setState((i) => ({
       ...i,
-      debug: { ...e, debugging: !0 }
-    })), t && (this.knock.log(
+      debug: {
+        skipEngagementTracking: !0,
+        ignoreDisplayInterval: !0,
+        focusedGuideKeys: {},
+        ...e,
+        debugging: !0
+      }
+    })), s && (this.knock.log(
       "[Guide] Start debugging, refetching guides and resubscribing to the websocket channel"
     ), this.fetch(), this.subscribe());
   }
   unsetDebug() {
-    var t;
+    var s;
     this.knock.log("[Guide] .unsetDebug()");
-    const e = (t = this.store.state.debug) == null ? void 0 : t.debugging;
-    this.store.setState((s) => ({ ...s, debug: void 0 })), e && (this.knock.log(
+    const e = (s = this.store.state.debug) == null ? void 0 : s.debugging;
+    this.clearGroupStage(), this.store.setState((t) => ({ ...t, debug: void 0 })), e && (this.knock.log(
       "[Guide] Stop debugging, refetching guides and resubscribing to the websocket channel"
     ), this.fetch(), this.subscribe());
   }
   //
   // Store selector
   //
-  selectGuides(e, t = {}, s = {}) {
+  selectGuides(e, s = {}, t = {}) {
     var c;
     this.knock.log(
-      `[Guide] .selectGuides (filters: ${G(t)}; state: ${S(e)})`
+      `[Guide] .selectGuides (filters: ${v(s)}; state: ${b(e)})`
     );
-    const i = this.selectGuide(e, t, {
-      ...s,
+    const i = this.selectGuide(e, s, {
+      ...t,
       // Don't record this result, not the actual query result we need.
       recordSelectQuery: !1
-    }), { recordSelectQuery: n = !!((c = e.debug) != null && c.debugging) } = s, r = {
+    }), { recordSelectQuery: n = !!((c = e.debug) != null && c.debugging) } = t, r = {
       limit: "all",
-      opts: { ...s, recordSelectQuery: n }
-    }, a = _(e, t, r);
-    if (this.maybeRecordSelectResult(a), !i && !s.includeThrottled)
+      opts: { ...t, recordSelectQuery: n }
+    }, a = C(e, s, r);
+    if (this.maybeRecordSelectResult(a), !i && !t.includeThrottled)
       return [];
     const o = [...a.values()];
-    if (!s.includeThrottled && m(e)) {
+    if (!t.includeThrottled && _(e)) {
       const d = o.filter(
         (g) => g.bypass_global_group_limit
-      ), h = o.length - d.length;
+      ), l = o.length - d.length;
       return this.knock.log(
-        `[Guide] Throttling ${h} guides from selection, and returning ${d.length} guides`
+        `[Guide] Throttling ${l} guides from selection, and returning ${d.length} guides`
       ), d;
     }
     return this.knock.log(`[Guide] Returning ${o.length} guides from selection`), o;
   }
-  selectGuide(e, t = {}, s = {}) {
-    var d;
+  selectGuide(e, s = {}, t = {}) {
+    var l, g, S;
     if (this.knock.log(
-      `[Guide] .selectGuide (filters: ${G(t)}; state: ${S(e)})`
+      `[Guide] .selectGuide (filters: ${v(s)}; state: ${b(e)})`
     ), Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0) {
       this.knock.log("[Guide] Exiting selection (no guides)");
       return;
     }
     this.stage || (this.stage = this.openGroupStage());
-    const { recordSelectQuery: i = !!((d = e.debug) != null && d.debugging) } = s, n = {
+    const { recordSelectQuery: i = !!((l = e.debug) != null && l.debugging) } = t, n = {
       limit: "one",
-      opts: { ...s, recordSelectQuery: i }
-    }, r = _(e, t, n);
+      opts: { ...t, recordSelectQuery: i }
+    }, r = C(e, s, n);
     if (this.maybeRecordSelectResult(r), r.size === 0) {
       this.knock.log("[Guide] Selection found zero result");
       return;
@@ -354,31 +364,39 @@ class W {
       `[Guide] Selection found: \`${o.key}\` (total: ${r.size})`
     ), o.bypass_global_group_limit)
       return this.knock.log(`[Guide] Returning the unthrottled guide: ${o.key}`), o;
-    const c = !s.includeThrottled && m(e);
+    const c = (S = (g = e.debug) == null ? void 0 : g.focusedGuideKeys) == null ? void 0 : S[o.key], d = !t.includeThrottled && _(e);
     switch (this.stage.status) {
       case "open": {
         this.knock.log(`[Guide] Adding to the group stage: ${o.key}`), this.stage.ordered[a] = o.key;
         return;
       }
       case "patch": {
-        if (this.knock.log(`[Guide] Patching the group stage: ${o.key}`), this.stage.ordered[a] = o.key, c) {
+        if (this.knock.log(`[Guide] Patching the group stage: ${o.key}`), this.stage.ordered[a] = o.key, c)
+          return this.knock.log(
+            `[Guide] Focused to return \`${o.key}\` (stage: ${y(this.stage)})`
+          ), o;
+        if (d) {
           this.knock.log(`[Guide] Throttling the selected guide: ${o.key}`);
           return;
         }
-        const h = this.stage.resolved === o.key ? o : void 0;
+        const k = this.stage.resolved === o.key ? o : void 0;
         return this.knock.log(
-          `[Guide] Returning \`${h == null ? void 0 : h.key}\` (stage: ${v(this.stage)})`
-        ), h;
+          `[Guide] Returning \`${k == null ? void 0 : k.key}\` (stage: ${y(this.stage)})`
+        ), k;
       }
       case "closed": {
-        if (c) {
+        if (c)
+          return this.knock.log(
+            `[Guide] Focused to return \`${o.key}\` (stage: ${y(this.stage)})`
+          ), o;
+        if (d) {
           this.knock.log(`[Guide] Throttling the selected guide: ${o.key}`);
           return;
         }
-        const h = this.stage.resolved === o.key ? o : void 0;
+        const k = this.stage.resolved === o.key ? o : void 0;
         return this.knock.log(
-          `[Guide] Returning \`${h == null ? void 0 : h.key}\` (stage: ${v(this.stage)})`
-        ), h;
+          `[Guide] Returning \`${k == null ? void 0 : k.key}\` (stage: ${y(this.stage)})`
+        ), k;
       }
     }
   }
@@ -386,16 +404,16 @@ class W {
   // and then 2) "one" or "all".
   maybeRecordSelectResult(e) {
     if (!e.metadata) return;
-    const { opts: t, filters: s, limit: i } = e.metadata;
-    if (!t.recordSelectQuery || !s.key && !s.type || !this.stage || this.stage.status === "closed") return;
+    const { opts: s, filters: t, limit: i } = e.metadata;
+    if (!s.recordSelectQuery || !t.key && !t.type || !this.stage || this.stage.status === "closed") return;
     const n = this.stage.results.key || {};
-    s.key && (n[s.key] = {
-      ...n[s.key] || {},
+    t.key && (n[t.key] = {
+      ...n[t.key] || {},
       [i]: e
     });
     const r = this.stage.results.type || {};
-    s.type && (r[s.type] = {
-      ...r[s.type] || {},
+    t.type && (r[t.type] = {
+      ...r[t.type] || {},
       [i]: e
     }), this.stage = {
       ...this.stage,
@@ -408,15 +426,15 @@ class W {
   openGroupStage() {
     this.knock.log("[Guide] Opening a new group stage");
     const {
-      orderResolutionDuration: e = K
-    } = this.options, t = setTimeout(() => {
+      orderResolutionDuration: e = F
+    } = this.options, s = setTimeout(() => {
       this.closePendingGroupStage(), this.incrementCounter();
     }, e);
     return this.stage = {
       status: "open",
       ordered: [],
       results: {},
-      timeoutId: t
+      timeoutId: s
     }, this.stage;
   }
   // Close the current non-closed stage to resolve the prevailing guide up next
@@ -424,7 +442,7 @@ class W {
   closePendingGroupStage() {
     if (this.knock.log("[Guide] .closePendingGroupStage"), !this.stage || this.stage.status === "closed") return;
     this.ensureClearTimeout();
-    const e = this.stage.ordered.find((t) => t !== void 0);
+    const e = this.stage.ordered.find((s) => s !== void 0);
     return this.knock.log(
       `[Guide] Closing the current group stage: resolved=${e}`
     ), this.stage = {
@@ -440,16 +458,16 @@ class W {
   // rendered until we are ready to resolve the updated stage and re-render.
   // Note, must be called ahead of updating the state store.
   patchClosedGroupStage() {
-    var s;
-    if (this.knock.log("[Guide] .patchClosedGroupStage"), ((s = this.stage) == null ? void 0 : s.status) !== "closed") return;
-    const { orderResolutionDuration: e = 0 } = this.options, t = setTimeout(() => {
+    var t;
+    if (this.knock.log("[Guide] .patchClosedGroupStage"), ((t = this.stage) == null ? void 0 : t.status) !== "closed") return;
+    const { orderResolutionDuration: e = 0 } = this.options, s = setTimeout(() => {
       this.closePendingGroupStage(), this.incrementCounter();
     }, e);
     return this.ensureClearTimeout(), this.knock.log("[Guide] Patching the current group stage"), this.stage = {
       ...this.stage,
       status: "patch",
       ordered: [],
-      timeoutId: t
+      timeoutId: s
     }, this.stage;
   }
   clearGroupStage() {
@@ -461,11 +479,11 @@ class W {
   }
   // Test helpers to open and close the group stage to return the select result
   // immediately.
-  _selectGuide(e, t = {}, s = {}) {
-    return this.openGroupStage(), this.selectGuide(e, t, s), this.closePendingGroupStage(), this.selectGuide(e, t, s);
+  _selectGuide(e, s = {}, t = {}) {
+    return this.openGroupStage(), this.selectGuide(e, s, t), this.closePendingGroupStage(), this.selectGuide(e, s, t);
   }
-  _selectGuides(e, t = {}, s = {}) {
-    return this.openGroupStage(), this.selectGuides(e, t, s), this.closePendingGroupStage(), this.selectGuides(e, t, s);
+  _selectGuides(e, s = {}, t = {}) {
+    return this.openGroupStage(), this.selectGuides(e, s, t), this.closePendingGroupStage(), this.selectGuides(e, s, t);
   }
   //
   // Engagement event handlers
@@ -473,156 +491,172 @@ class W {
   // Make an optimistic update on the client side first, then send an engagement
   // event to the backend.
   //
-  async markAsSeen(e, t) {
-    if (t.message.seen_at) return;
+  async markAsSeen(e, s) {
+    if (s.message.seen_at) return;
     this.knock.log(
-      `[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${t.ref})`
+      `[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${s.ref})`
     );
-    const s = this.setStepMessageAttrs(e.key, t.ref, {
+    const t = this.setStepMessageAttrs(e.key, s.ref, {
       seen_at: (/* @__PURE__ */ new Date()).toISOString()
     });
-    if (!s) return;
+    if (!t) return;
+    if (this.shouldSkipEngagementApi())
+      return this.knock.log(
+        "[Guide] Skipping engagement API call for markAsSeen (debug mode)"
+      ), t;
     const i = {
-      ...this.buildEngagementEventBaseParams(e, s),
-      content: s.content,
+      ...this.buildEngagementEventBaseParams(e, t),
+      content: t.content,
       data: this.targetParams.data
     };
     return this.knock.user.markGuideStepAs(
       "seen",
       i
-    ), s;
+    ), t;
   }
-  async markAsInteracted(e, t, s) {
+  async markAsInteracted(e, s, t) {
     this.knock.log(
-      `[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`
+      `[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${s.ref})`
     );
-    const i = (/* @__PURE__ */ new Date()).toISOString(), n = this.setStepMessageAttrs(e.key, t.ref, {
+    const i = (/* @__PURE__ */ new Date()).toISOString(), n = this.setStepMessageAttrs(e.key, s.ref, {
       read_at: i,
       interacted_at: i
     });
     if (!n) return;
+    if (this.shouldSkipEngagementApi())
+      return this.knock.log(
+        "[Guide] Skipping engagement API call for markAsInteracted (debug mode)"
+      ), n;
     const r = {
       ...this.buildEngagementEventBaseParams(e, n),
-      metadata: s
+      metadata: t
     };
     return this.knock.user.markGuideStepAs("interacted", r), n;
   }
-  async markAsArchived(e, t) {
-    if (t.message.archived_at) return;
+  async markAsArchived(e, s) {
+    if (s.message.archived_at) return;
     this.knock.log(
-      `[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${t.ref})`
+      `[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${s.ref})`
     );
-    const s = this.setStepMessageAttrs(e.key, t.ref, {
+    const t = this.setStepMessageAttrs(e.key, s.ref, {
       archived_at: (/* @__PURE__ */ new Date()).toISOString()
     });
-    if (!s) return;
-    const i = this.buildEngagementEventBaseParams(e, s);
+    if (!t) return;
+    if (this.shouldSkipEngagementApi())
+      return this.knock.log(
+        "[Guide] Skipping engagement API call for markAsArchived (debug mode)"
+      ), t;
+    const i = this.buildEngagementEventBaseParams(e, t);
     return this.knock.user.markGuideStepAs(
       "archived",
       {
         ...i,
         unthrottled: e.bypass_global_group_limit
       }
-    ), s;
+    ), t;
+  }
+  shouldSkipEngagementApi() {
+    var e;
+    return !!((e = this.store.state.debug) != null && e.skipEngagementTracking);
   }
   //
   // Helpers
   //
   localCopy(e) {
-    const t = this, s = {
+    const s = this, t = {
       ...e,
       // Get the next unarchived step.
       getStep() {
-        var i;
-        return ((i = t.store.state.debug) == null ? void 0 : i.forcedGuideKey) === this.key ? this.steps[0] : this.steps.find((n) => !n.message.archived_at);
+        var i, n, r;
+        return ((i = s.store.state.debug) == null ? void 0 : i.forcedGuideKey) === this.key || (r = (n = s.store.state.debug) == null ? void 0 : n.focusedGuideKeys) != null && r[this.key] ? this.steps[0] : this.steps.find((a) => !a.message.archived_at);
       }
     };
-    return s.getStep = s.getStep.bind(s), s.steps = e.steps.map(({ message: i, ...n }) => {
+    return t.getStep = t.getStep.bind(t), t.steps = e.steps.map(({ message: i, ...n }) => {
       const r = {
         ...n,
         message: { ...i },
         markAsSeen() {
-          return t.markAsSeen(s, this);
+          return s.markAsSeen(t, this);
         },
         markAsInteracted({ metadata: a } = {}) {
-          return t.markAsInteracted(s, this, a);
+          return s.markAsInteracted(t, this, a);
         },
         markAsArchived() {
-          return t.markAsArchived(s, this);
+          return s.markAsArchived(t, this);
         }
       };
       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) => ({
+    }), t.activation_url_patterns = e.activation_url_patterns.map((i) => ({
       ...i,
-      pattern: new w({
+      pattern: new A({
         pathname: i.pathname ?? void 0,
         search: i.search ?? void 0
       })
-    })), s;
+    })), t;
   }
   buildQueryParams(e = {}) {
-    const t = {
+    const s = {
       ...this.targetParams,
       ...e
-    }, s = this.store.state.debug;
-    (s != null && s.forcedGuideKey || s != null && s.debugging) && (t.force_all_guides = !0);
+    }, t = this.store.state.debug;
+    (t != null && t.forcedGuideKey || t != null && t.debugging) && (s.force_all_guides = !0);
     let i = Object.fromEntries(
-      Object.entries(t).filter(
+      Object.entries(s).filter(
         ([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(
+    const t = Object.keys(e).sort().map(
       (n) => `${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`
-    ).join("&"), i = F(this.knock.userId);
-    return s ? `${i}?${s}` : i;
+    ).join("&"), i = N(this.knock.userId);
+    return t ? `${i}?${t}` : i;
   }
-  setStepMessageAttrs(e, t, s) {
+  setStepMessageAttrs(e, s, t) {
     let i;
-    return s.archived_at && this.clearGroupStage(), this.store.setState((n) => {
+    return t.archived_at && this.clearGroupStage(), this.store.setState((n) => {
       let r = n.guides[e];
       if (!r) return n;
-      const a = r.steps.map((d) => (d.ref !== t || (d.message = { ...d.message, ...s }, i = d), d));
+      const a = r.steps.map((d) => (d.ref !== s || (d.message = { ...d.message, ...t }, i = d), d));
       r = i ? { ...r, steps: a } : r;
-      const o = { ...n.guides, [r.key]: r }, c = s.archived_at && !r.bypass_global_group_limit ? {
+      const o = { ...n.guides, [r.key]: r }, c = t.archived_at && !r.bypass_global_group_limit ? {
         ...n.guideGroupDisplayLogs,
-        [P]: s.archived_at
+        [D]: t.archived_at
       } : n.guideGroupDisplayLogs;
       return { ...n, guides: o, guideGroupDisplayLogs: c };
     }), i;
   }
-  buildEngagementEventBaseParams(e, t) {
+  buildEngagementEventBaseParams(e, s) {
     return {
       channel_id: e.channel_id,
       guide_key: e.key,
       guide_id: e.id,
-      guide_step_ref: t.ref,
+      guide_step_ref: s.ref,
       // Can be used for scoping guide messages.
       tenant: this.targetParams.tenant
     };
   }
   addOrReplaceGuide({ data: e }) {
     this.patchClosedGroupStage();
-    const t = this.localCopy(e.guide);
-    this.store.setState((s) => {
-      const i = { ...s.guides, [t.key]: t };
-      return { ...s, guides: i };
+    const s = this.localCopy(e.guide);
+    this.store.setState((t) => {
+      const i = { ...t.guides, [s.key]: s };
+      return { ...t, guides: i };
     });
   }
   removeGuide({ data: e }) {
-    this.patchClosedGroupStage(), this.store.setState((t) => {
-      const { [e.guide.key]: s, ...i } = t.guides;
-      return { ...t, guides: i };
+    this.patchClosedGroupStage(), this.store.setState((s) => {
+      const { [e.guide.key]: t, ...i } = s.guides;
+      return { ...s, guides: i };
     });
   }
   addOrReplaceGuideGroup({
     data: e
   }) {
-    this.patchClosedGroupStage(), this.store.setState((t) => {
-      const s = [e.guide_group], i = e.guide_group.display_sequence_unthrottled || [], n = e.guide_group.display_sequence_throttled || [];
-      let r = t.guides;
+    this.patchClosedGroupStage(), this.store.setState((s) => {
+      const t = [e.guide_group], i = e.guide_group.display_sequence_unthrottled || [], n = e.guide_group.display_sequence_throttled || [];
+      let r = s.guides;
       return r = i.reduce((a, o) => {
         if (!a[o]) return a;
         const c = { ...a[o], bypass_global_group_limit: !0 };
@@ -631,53 +665,53 @@ class W {
         if (!a[o]) return a;
         const c = { ...a[o], bypass_global_group_limit: !1 };
         return { ...a, [o]: c };
-      }, r), { ...t, guides: r, guideGroups: s };
+      }, r), { ...s, guides: r, guideGroups: t };
     });
   }
   updatePreviewGuide({ data: e }) {
-    const t = this.localCopy(e.guide);
-    this.store.setState((s) => {
-      const i = { ...s.previewGuides, [t.key]: t };
-      return { ...s, previewGuides: i };
+    const s = this.localCopy(e.guide);
+    this.store.setState((t) => {
+      const i = { ...t.previewGuides, [s.key]: s };
+      return { ...t, previewGuides: i };
     });
   }
   // Returns whether debug params have changed. For guide key, we only check
   // presence since the exact value has no impact on fetch/subscribe
-  checkDebugStateChanged(e, t) {
-    return !!e.forcedGuideKey != !!t.forcedGuideKey || e.previewSessionId !== t.previewSessionId;
+  checkDebugStateChanged(e, s) {
+    return !!e.forcedGuideKey != !!s.forcedGuideKey || e.previewSessionId !== s.previewSessionId;
   }
   listenForLocationChangesFromWindow() {
-    const e = k();
+    const e = p();
     if (e != null && e.history && (e != null && e.addEventListener)) {
       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, {
+      const s = e.history.pushState, t = e.history.replaceState;
+      e.history.pushState = new Proxy(s, {
         apply: (i, n, r) => {
           Reflect.apply(i, n, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
-      }), e.history.replaceState = new Proxy(s, {
+      }), e.history.replaceState = new Proxy(t, {
         apply: (i, n, r) => {
           Reflect.apply(i, n, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
-      }), this.pushStateFn = t, this.replaceStateFn = s;
+      }), this.pushStateFn = s, this.replaceStateFn = t;
     } else
       this.knock.log(
         "[Guide] Unable to access the `window.history` object to detect location changes"
       );
   }
   removeLocationChangeEventListeners() {
-    const e = k();
+    const e = p();
     !(e != null && e.history) || !(e != null && e.removeEventListener) || (e.removeEventListener("popstate", this.handleLocationChange), e.removeEventListener("hashchange", this.handleLocationChange), this.pushStateFn && (e.history.pushState = this.pushStateFn, this.pushStateFn = void 0), this.replaceStateFn && (e.history.replaceState = this.replaceStateFn, this.replaceStateFn = void 0));
   }
 }
 export {
-  p as DEBUG_QUERY_PARAMS,
-  W as KnockGuideClient,
-  j as checkActivatable,
-  F as guidesApiRootPath
+  f as DEBUG_QUERY_PARAMS,
+  V as KnockGuideClient,
+  M as checkActivatable,
+  N as guidesApiRootPath
 };
 //# sourceMappingURL=client.mjs.map