@knocklabs/client 0.18.5 → 0.18.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.18.6
+
+### Patch Changes
+
+- 49df373: update guide as a new object ref when updating its step
+
 ## 0.18.5
 
 ### Patch Changes

package/dist/cjs/api.js

@@ -1,2 +1,2 @@
-"use strict";var a=Object.defineProperty;var n=(t,e,s)=>e in t?a(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var r=(t,e,s)=>n(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("axios"),l=require("axios-retry"),c=require("phoenix"),i=t=>t&&typeof t=="object"&&"default"in t?t:{default:t},d=i(u),o=i(l);class h{constructor(e){r(this,"host");r(this,"apiKey");r(this,"userToken");r(this,"axiosClient");r(this,"socket");this.host=e.host,this.apiKey=e.apiKey,this.userToken=e.userToken||null,this.axiosClient=d.default.create({baseURL:this.host,headers:{Accept:"application/json","Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,"X-Knock-User-Token":this.userToken,"X-Knock-Client":this.getKnockClientHeader()}}),typeof window<"u"&&(this.socket=new c.Socket(`${this.host.replace("http","ws")}/ws/v1`,{params:{user_token:this.userToken,api_key:this.apiKey}})),o.default(this.axiosClient,{retries:3,retryCondition:this.canRetryRequest,retryDelay:o.default.exponentialDelay})}async makeRequest(e){try{const s=await this.axiosClient(e);return{statusCode:s.status<300?"ok":"error",body:s.data,error:void 0,status:s.status}}catch(s){return console.error(s),{statusCode:"error",status:500,body:void 0,error:s}}}canRetryRequest(e){return o.default.isNetworkError(e)?!0:e.response?e.response.status>=500&&e.response.status<=599||e.response.status===429:!1}getKnockClientHeader(){return"Knock/ClientJS 0.18.5"}}exports.default=h;
+"use strict";var a=Object.defineProperty;var n=(t,e,s)=>e in t?a(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var r=(t,e,s)=>n(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("axios"),l=require("axios-retry"),c=require("phoenix"),i=t=>t&&typeof t=="object"&&"default"in t?t:{default:t},d=i(u),o=i(l);class h{constructor(e){r(this,"host");r(this,"apiKey");r(this,"userToken");r(this,"axiosClient");r(this,"socket");this.host=e.host,this.apiKey=e.apiKey,this.userToken=e.userToken||null,this.axiosClient=d.default.create({baseURL:this.host,headers:{Accept:"application/json","Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,"X-Knock-User-Token":this.userToken,"X-Knock-Client":this.getKnockClientHeader()}}),typeof window<"u"&&(this.socket=new c.Socket(`${this.host.replace("http","ws")}/ws/v1`,{params:{user_token:this.userToken,api_key:this.apiKey}})),o.default(this.axiosClient,{retries:3,retryCondition:this.canRetryRequest,retryDelay:o.default.exponentialDelay})}async makeRequest(e){try{const s=await this.axiosClient(e);return{statusCode:s.status<300?"ok":"error",body:s.data,error:void 0,status:s.status}}catch(s){return console.error(s),{statusCode:"error",status:500,body:void 0,error:s}}}canRetryRequest(e){return o.default.isNetworkError(e)?!0:e.response?e.response.status>=500&&e.response.status<=599||e.response.status===429:!1}getKnockClientHeader(){return"Knock/ClientJS 0.18.6"}}exports.default=h;
 //# sourceMappingURL=api.js.map

package/dist/cjs/clients/guide/client.js

@@ -1,2 +1,2 @@
-"use strict";var m=Object.defineProperty;var v=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>v(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("@tanstack/store"),b=require("urlpattern-polyfill"),d=require("./helpers.js"),I=50,C=30*1e3,E=3,g={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},k="knock_guide_debug",p=()=>{if(typeof window<"u")return window},G=u=>`/v1/users/${u}/guides`,f=()=>{const u=p();if(!u)return{forcedGuideKey:null,previewSessionId:null};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 n={forcedGuideKey:t,previewSessionId:s};u.localStorage.setItem(k,JSON.stringify(n))}catch{}return{forcedGuideKey:t,previewSessionId:s}}let i=null,r=null;if(u.localStorage)try{const n=u.localStorage.getItem(k);if(n){const o=w(n);i=o.forcedGuideKey,r=o.previewSessionId}}catch{}return{forcedGuideKey:i,previewSessionId:r}},w=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}}},S=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;const i=[...s.display_sequence],r=u.location;if(u.debug.forcedGuideKey){const n=i.indexOf(u.debug.forcedGuideKey);n>-1&&i.splice(n,1),i.unshift(u.debug.forcedGuideKey)}for(const[n,o]of i.entries()){let a=u.guides[o];u.debug.forcedGuideKey===o&&u.previewGuides[o]&&(a=u.previewGuides[o]),!(!a||!R(a,{location:r,filters:e,debug:u.debug}))&&t.set(n,a)}return t.metadata={guideGroup:s},t},R=(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===u.key)return!0;if(!u.active||u.steps.every(o=>!!o.message.archived_at))return!1;const i=e?d.newUrl(e):void 0,r=u.activation_url_rules||[],n=u.activation_url_patterns||[];if(i&&r.length>0){if(!d.predicateUrlRules(i,r))return!1}else if(i&&n.length>0&&!d.predicateUrlPatterns(i,n))return!1;return!0};class P{constructor(e,t,s={},i={}){c(this,"store");c(this,"socket");c(this,"socketChannel");c(this,"socketChannelTopic");c(this,"socketEventTypes",["guide.added","guide.updated","guide.removed","guide_group.added","guide_group.updated","guide.live_preview_updated"]);c(this,"subscribeRetryCount",0);c(this,"pushStateFn");c(this,"replaceStateFn");c(this,"stage");c(this,"counterIntervalId");c(this,"handleLocationChange",()=>{const e=p();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Detected a location change: ${t}`);const s=this.store.state.debug,i=f();this.setLocation(t,{debug:i}),this.checkDebugStateChanged(s,i)&&(this.knock.log("[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"),this.fetch(),this.subscribe())});this.knock=e,this.channelId=t,this.targetParams=s,this.options=i;const{trackLocationFromWindow:r=!0,throttleCheckInterval:n=C}=i,o=p(),a=r?o==null?void 0:o.location.href:void 0,l=f();this.store=new _.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:a,counter:0,debug:l});const{socket:h}=this.knock.client();this.socket=h,this.socketChannelTopic=`guides:${t}`,r&&this.listenForLocationChangesFromWindow(),n&&this.startCounterInterval(n),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}))}startCounterInterval(e){this.counterIntervalId=setInterval(()=>{this.knock.log("[Guide] Counter interval tick"),!(this.stage&&this.stage.status!=="closed")&&this.incrementCounter()},e)}clearCounterInterval(){this.counterIntervalId&&(clearInterval(this.counterIntervalId),this.counterIntervalId=void 0)}cleanup(){this.unsubscribe(),this.removeEventListeners(),this.clearGroupStage(),this.clearCounterInterval()}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];if(i)return i;this.store.setState(n=>({...n,queries:{...n.queries,[s]:{status:"loading"}}}));let r;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:a,guide_group_display_logs:l}=n;this.knock.log("[Guide] Loading fetched guides"),this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:d.byKey(o.map(y=>this.localCopy(y))),queries:{...h.queries,[s]:r}}))}catch(n){r={status:"error",error:n},this.store.setState(o=>({...o,queries:{...o.queries,[s]:r}}))}return r}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={...this.targetParams,user_id:this.knock.userId,force_all_guides:e.forcedGuideKey?!0:void 0,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));["closed","errored"].includes(s.state)&&(this.subscribeRetryCount=0,s.join().receive("ok",()=>{this.knock.log("[Guide] Successfully joined channel")}).receive("error",i=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(i)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=E){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default: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=>{var r;const i=(r=t==null?void 0:t.debug)!=null&&r.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:i,location:e}})}exitDebugMode(){this.knock.log("[Guide] Exiting debug mode");const e=p();if(e!=null&&e.localStorage)try{e.localStorage.removeItem(k)}catch{}if(this.store.setState(t=>({...t,debug:{forcedGuideKey:null,previewSessionId:null},previewGuides:{}})),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())}}selectGuides(e,t={}){if(this.knock.log(`[Guide] .selectGuides (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0)return this.knock.log("[Guide] Exiting selection (no guides)"),[];const s=S(e,t);return s.size===0?(this.knock.log("[Guide] Selection returned zero result"),[]):[...s.values()]}selectGuide(e,t={}){if(this.knock.log(`[Guide] .selectGuide (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0){this.knock.log("[Guide] Exiting selection (no guides)");return}const s=S(e,t);if(s.size===0){this.knock.log("[Guide] Selection found zero result");return}const[i,r]=[...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=d.findDefaultGroup(e.guideGroups),o=e.guideGroupDisplayLogs[d.DEFAULT_GROUP_KEY];if(n&&n.display_interval&&o&&d.checkIfThrottled(o,n.display_interval)){this.knock.log(`[Guide] Throttling the selected guide: ${r.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;return}case"patch":{this.knock.log(`[Guide] Patching the group stage: ${r.key}`),this.stage.ordered[i]=r.key;const a=this.stage.resolved===r.key?r:void 0;return this.knock.log(`[Guide] Returning \`${a==null?void 0:a.key}\` (stage: ${d.formatGroupStage(this.stage)})`),a}case"closed":{const a=this.stage.resolved===r.key?r:void 0;return this.knock.log(`[Guide] Returning \`${a==null?void 0:a.key}\` (stage: ${d.formatGroupStage(this.stage)})`),a}}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=I}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(this.knock.log("[Guide] .closePendingGroupStage"),!this.stage||this.stage.status==="closed")return;this.ensureClearTimeout();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.knock.log(`[Guide] Closing the current group stage: resolved=${e}`),this.stage={...this.stage,status:"closed",resolved:e,timeoutId:null},this.stage}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(()=>{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},this.stage}clearGroupStage(){this.knock.log("[Guide] .clearGroupStage"),this.stage&&(this.knock.log("[Guide] Clearing the current group stage"),this.ensureClearTimeout(),this.stage=void 0)}ensureClearTimeout(){var e;(e=this.stage)!=null&&e.timeoutId&&clearTimeout(this.stage.timeoutId)}_selectGuide(e,t={}){return this.openGroupStage(),this.selectGuide(e,t),this.closePendingGroupStage(),this.selectGuide(e,t)}async markAsSeen(e,t){if(t.message.seen_at)return;this.knock.log(`[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{seen_at:new Date().toISOString()});if(!s)return;const i={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",i),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`);const i=new Date().toISOString(),r=this.setStepMessageAttrs(e.key,t.ref,{read_at:i,interacted_at:i});if(!r)return;const n={...this.buildEngagementEventBaseParams(e,r),metadata:s};return this.knock.user.markGuideStepAs("interacted",n),r}async markAsArchived(e,t){if(t.message.archived_at)return;this.knock.log(`[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{archived_at:new Date().toISOString()});if(!s)return;const i=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...i,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){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,message:{...i},markAsSeen(){if(!this.message.seen_at)return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){if(!this.message.archived_at)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}),s.activation_url_patterns=e.activation_url_patterns.map(i=>({...i,pattern:new b.URLPattern({pathname:i.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let i=Object.fromEntries(Object.entries(t).filter(([r,n])=>n!=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=G(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(h=>(h.ref!==t||(h.message={...h.message,...s},i=h),h));n.steps=o;const a={...r.guides,[n.key]:n},l=s.archived_at&&!n.bypass_global_group_limit?{...r.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:r.guideGroupDisplayLogs;return{...r,guides:a,guideGroupDisplayLogs:l}}),i}buildEngagementEventBaseParams(e,t){return{channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref}}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}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...i}=t.guides;return{...t,guides:i}})}addOrReplaceGuideGroup({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,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},n),n=r.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!1};return{...o,[a]:l}},n),{...t,guides:n,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.previewGuides,[t.key]:t};return{...s,previewGuides:i}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=p();if(e!=null&&e.history){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(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(i,r,n)=>{Reflect.apply(i,r,n),setTimeout(()=>{this.handleLocationChange()},0)}}),this.pushStateFn=t,this.replaceStateFn=s}else this.knock.log("[Guide] Unable to access the `window.history` object to detect location changes")}removeEventListeners(){const e=p();e!=null&&e.history&&(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))}}exports.DEBUG_QUERY_PARAMS=g;exports.KnockGuideClient=P;exports.guidesApiRootPath=G;
+"use strict";var m=Object.defineProperty;var v=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>v(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("@tanstack/store"),b=require("urlpattern-polyfill"),d=require("./helpers.js"),I=50,C=30*1e3,E=3,g={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},k="knock_guide_debug",p=()=>{if(typeof window<"u")return window},G=u=>`/v1/users/${u}/guides`,f=()=>{const u=p();if(!u)return{forcedGuideKey:null,previewSessionId:null};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(k,JSON.stringify(r))}catch{}return{forcedGuideKey:t,previewSessionId:s}}let i=null,n=null;if(u.localStorage)try{const r=u.localStorage.getItem(k);if(r){const o=w(r);i=o.forcedGuideKey,n=o.previewSessionId}}catch{}return{forcedGuideKey:i,previewSessionId:n}},w=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}}},S=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;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||!R(a,{location:n,filters:e,debug:u.debug}))&&t.set(r,a)}return t.metadata={guideGroup:s},t},R=(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===u.key)return!0;if(!u.active||u.steps.every(o=>!!o.message.archived_at))return!1;const i=e?d.newUrl(e):void 0,n=u.activation_url_rules||[],r=u.activation_url_patterns||[];if(i&&n.length>0){if(!d.predicateUrlRules(i,n))return!1}else if(i&&r.length>0&&!d.predicateUrlPatterns(i,r))return!1;return!0};class P{constructor(e,t,s={},i={}){c(this,"store");c(this,"socket");c(this,"socketChannel");c(this,"socketChannelTopic");c(this,"socketEventTypes",["guide.added","guide.updated","guide.removed","guide_group.added","guide_group.updated","guide.live_preview_updated"]);c(this,"subscribeRetryCount",0);c(this,"pushStateFn");c(this,"replaceStateFn");c(this,"stage");c(this,"counterIntervalId");c(this,"handleLocationChange",()=>{const e=p();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Detected a location change: ${t}`);const s=this.store.state.debug,i=f();this.setLocation(t,{debug:i}),this.checkDebugStateChanged(s,i)&&(this.knock.log("[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"),this.fetch(),this.subscribe())});this.knock=e,this.channelId=t,this.targetParams=s,this.options=i;const{trackLocationFromWindow:n=!0,throttleCheckInterval:r=C}=i,o=p(),a=n?o==null?void 0:o.location.href:void 0,l=f();this.store=new _.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:a,counter:0,debug:l});const{socket:h}=this.knock.client();this.socket=h,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}))}startCounterInterval(e){this.counterIntervalId=setInterval(()=>{this.knock.log("[Guide] Counter interval tick"),!(this.stage&&this.stage.status!=="closed")&&this.incrementCounter()},e)}clearCounterInterval(){this.counterIntervalId&&(clearInterval(this.counterIntervalId),this.counterIntervalId=void 0)}cleanup(){this.unsubscribe(),this.removeEventListeners(),this.clearGroupStage(),this.clearCounterInterval()}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];if(i)return i;this.store.setState(r=>({...r,queries:{...r.queries,[s]:{status:"loading"}}}));let n;try{this.knock.log("[Guide] Fetching all eligible guides");const r=await this.knock.user.getGuides(this.channelId,t);n={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:l}=r;this.knock.log("[Guide] Loading fetched guides"),this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:d.byKey(o.map(y=>this.localCopy(y))),queries:{...h.queries,[s]:n}}))}catch(r){n={status:"error",error:r},this.store.setState(o=>({...o,queries:{...o.queries,[s]:n}}))}return n}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={...this.targetParams,user_id:this.knock.userId,force_all_guides:e.forcedGuideKey?!0:void 0,preview_session_id:e.previewSessionId||void 0},s=this.socket.channel(this.socketChannelTopic,t);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",()=>{this.knock.log("[Guide] Successfully joined channel")}).receive("error",i=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(i)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=E){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default: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=>{var n;const i=(n=t==null?void 0:t.debug)!=null&&n.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:i,location:e}})}exitDebugMode(){this.knock.log("[Guide] Exiting debug mode");const e=p();if(e!=null&&e.localStorage)try{e.localStorage.removeItem(k)}catch{}if(this.store.setState(t=>({...t,debug:{forcedGuideKey:null,previewSessionId:null},previewGuides:{}})),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())}}selectGuides(e,t={}){if(this.knock.log(`[Guide] .selectGuides (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0)return this.knock.log("[Guide] Exiting selection (no guides)"),[];const s=S(e,t);return s.size===0?(this.knock.log("[Guide] Selection returned zero result"),[]):[...s.values()]}selectGuide(e,t={}){if(this.knock.log(`[Guide] .selectGuide (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0){this.knock.log("[Guide] Exiting selection (no guides)");return}const s=S(e,t);if(s.size===0){this.knock.log("[Guide] Selection found zero result");return}const[i,n]=[...s][0];if(this.knock.log(`[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=d.findDefaultGroup(e.guideGroups),o=e.guideGroupDisplayLogs[d.DEFAULT_GROUP_KEY];if(r&&r.display_interval&&o&&d.checkIfThrottled(o,r.display_interval)){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] Adding to the group stage: ${n.key}`),this.stage.ordered[i]=n.key;return}case"patch":{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 \`${a==null?void 0:a.key}\` (stage: ${d.formatGroupStage(this.stage)})`),a}case"closed":{const a=this.stage.resolved===n.key?n:void 0;return this.knock.log(`[Guide] Returning \`${a==null?void 0:a.key}\` (stage: ${d.formatGroupStage(this.stage)})`),a}}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=I}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(this.knock.log("[Guide] .closePendingGroupStage"),!this.stage||this.stage.status==="closed")return;this.ensureClearTimeout();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.knock.log(`[Guide] Closing the current group stage: resolved=${e}`),this.stage={...this.stage,status:"closed",resolved:e,timeoutId:null},this.stage}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(()=>{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},this.stage}clearGroupStage(){this.knock.log("[Guide] .clearGroupStage"),this.stage&&(this.knock.log("[Guide] Clearing the current group stage"),this.ensureClearTimeout(),this.stage=void 0)}ensureClearTimeout(){var e;(e=this.stage)!=null&&e.timeoutId&&clearTimeout(this.stage.timeoutId)}_selectGuide(e,t={}){return this.openGroupStage(),this.selectGuide(e,t),this.closePendingGroupStage(),this.selectGuide(e,t)}async markAsSeen(e,t){if(t.message.seen_at)return;this.knock.log(`[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{seen_at:new Date().toISOString()});if(!s)return;const i={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",i),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`);const i=new Date().toISOString(),n=this.setStepMessageAttrs(e.key,t.ref,{read_at:i,interacted_at:i});if(!n)return;const r={...this.buildEngagementEventBaseParams(e,n),metadata:s};return this.knock.user.markGuideStepAs("interacted",r),n}async markAsArchived(e,t){if(t.message.archived_at)return;this.knock.log(`[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{archived_at:new Date().toISOString()});if(!s)return;const i=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...i,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){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,...n})=>{const r={...n,message:{...i},markAsSeen(){if(!this.message.seen_at)return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){if(!this.message.archived_at)return t.markAsArchived(s,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=>({...i,pattern:new b.URLPattern({pathname:i.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let i=Object.fromEntries(Object.entries(t).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(n=>`${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`).join("&"),i=G(this.knock.userId);return s?`${i}?${s}`:i}setStepMessageAttrs(e,t,s){let i;return s.archived_at&&this.clearGroupStage(),this.store.setState(n=>{let r=n.guides[e];if(!r)return n;const o=r.steps.map(h=>(h.ref!==t||(h.message={...h.message,...s},i=h),h));r=i?{...r,steps:o}:r;const a={...n.guides,[r.key]:r},l=s.archived_at&&!r.bypass_global_group_limit?{...n.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:n.guideGroupDisplayLogs;return{...n,guides:a,guideGroupDisplayLogs:l}}),i}buildEngagementEventBaseParams(e,t){return{channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref}}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}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...i}=t.guides;return{...t,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;return r=i.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},r),r=n.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!1};return{...o,[a]:l}},r),{...t,guides:r,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.previewGuides,[t.key]:t};return{...s,previewGuides:i}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=p();if(e!=null&&e.history){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,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(i,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),this.pushStateFn=t,this.replaceStateFn=s}else this.knock.log("[Guide] Unable to access the `window.history` object to detect location changes")}removeEventListeners(){const e=p();e!=null&&e.history&&(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))}}exports.DEBUG_QUERY_PARAMS=g;exports.KnockGuideClient=P;exports.guidesApiRootPath=G;
 //# sourceMappingURL=client.js.map

package/dist/cjs/clients/guide/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  formatGroupStage,\n  formatState,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const urlPreviewSessionId = urlParams.get(\n    DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n  );\n\n  // If URL params exist, persist them to localStorage and return them\n  if (urlGuideKey || urlPreviewSessionId) {\n    if (win.localStorage) {\n      try {\n        const debugState = {\n          forcedGuideKey: urlGuideKey,\n          previewSessionId: urlPreviewSessionId,\n        };\n        win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n    return {\n      forcedGuideKey: urlGuideKey,\n      previewSessionId: urlPreviewSessionId,\n    };\n  }\n\n  // Check local storage if no URL params\n  let storedGuideKey = null;\n  let storedPreviewSessionId = null;\n\n  if (win.localStorage) {\n    try {\n      const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n      if (storedDebugState) {\n        const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n        storedGuideKey = parsedDebugState.forcedGuideKey;\n        storedPreviewSessionId = parsedDebugState.previewSessionId;\n      }\n    } catch {\n      // Silently fail in privacy mode\n    }\n  }\n\n  return {\n    forcedGuideKey: storedGuideKey,\n    previewSessionId: storedPreviewSessionId,\n  };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n  try {\n    const parsed = JSON.parse(value);\n    return {\n      forcedGuideKey: parsed?.forcedGuideKey ?? null,\n      previewSessionId: parsed?.previewSessionId ?? null,\n    };\n  } catch {\n    return {\n      forcedGuideKey: null,\n      previewSessionId: null,\n    };\n  }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const {\n      trackLocationFromWindow = true,\n      throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    if (throttleCheckInterval) {\n      // Start the counter loop to increment at an interval.\n      this.startCounterInterval(throttleCheckInterval);\n    }\n\n    this.knock.log(\"[Guide] Initialized a guide client\");\n  }\n\n  private incrementCounter() {\n    this.knock.log(\"[Guide] Incrementing the counter\");\n    this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n  }\n\n  private startCounterInterval(delay: number) {\n    this.counterIntervalId = setInterval(() => {\n      this.knock.log(\"[Guide] Counter interval tick\");\n      if (this.stage && this.stage.status !== \"closed\") return;\n\n      this.incrementCounter();\n    }, delay);\n  }\n\n  private clearCounterInterval() {\n    if (this.counterIntervalId) {\n      clearInterval(this.counterIntervalId);\n      this.counterIntervalId = undefined;\n    }\n  }\n\n  cleanup() {\n    this.unsubscribe();\n    this.removeEventListeners();\n    this.clearGroupStage();\n    this.clearCounterInterval();\n  }\n\n  async fetch(opts?: { filters?: QueryFilterParams }) {\n    this.knock.log(\"[Guide] .fetch\");\n    this.knock.failIfNotAuthenticated();\n\n    const queryParams = this.buildQueryParams(opts?.filters);\n    const queryKey = this.formatQueryKey(queryParams);\n\n    // If already fetched before, then noop.\n    const maybeQueryStatus = this.store.state.queries[queryKey];\n    if (maybeQueryStatus) {\n      return maybeQueryStatus;\n    }\n\n    // Mark this query status as loading.\n    this.store.setState((state) => ({\n      ...state,\n      queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n    }));\n\n    let queryStatus: QueryStatus;\n    try {\n      this.knock.log(\"[Guide] Fetching all eligible guides\");\n      const data = await this.knock.user.getGuides<\n        GetGuidesQueryParams,\n        GetGuidesResponse\n      >(this.channelId, queryParams);\n      queryStatus = { status: \"ok\" };\n\n      const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n      this.knock.log(\"[Guide] Loading fetched guides\");\n      this.store.setState((state) => ({\n        ...state,\n        guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n        guideGroupDisplayLogs: guide_group_display_logs || {},\n        guides: byKey(entries.map((g) => this.localCopy(g))),\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    } catch (e) {\n      queryStatus = { status: \"error\", error: e as Error };\n\n      this.store.setState((state) => ({\n        ...state,\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    }\n\n    return queryStatus;\n  }\n\n  subscribe() {\n    if (!this.socket) return;\n    this.knock.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n    // Ensure a live socket connection if not yet connected.\n    if (!this.socket.isConnected()) {\n      this.socket.connect();\n    }\n\n    // If there's an existing connected channel, then disconnect.\n    if (this.socketChannel) {\n      this.unsubscribe();\n    }\n\n    // Join the channel topic and subscribe to supported events.\n    const debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.knock.log(\"[Guide] Updating the tracked location\");\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  exitDebugMode() {\n    this.knock.log(\"[Guide] Exiting debug mode\");\n\n    // Clear localStorage debug params\n    const win = checkForWindow();\n    if (win?.localStorage) {\n      try {\n        win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n\n    // Clear debug state from store\n    this.store.setState((state) => ({\n      ...state,\n      debug: { forcedGuideKey: null, previewSessionId: null },\n      previewGuides: {}, // Clear preview guides when exiting debug mode\n    }));\n\n    // Remove URL query params if present\n    // Only update the URL if params need to be cleared to avoid unnecessary navigations\n    if (win) {\n      const url = new URL(win.location.href);\n      if (\n        url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n        url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n      ) {\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n        win.location.href = url.toString();\n      }\n    }\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    this.knock.log(\n      `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return [];\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return [];\n    }\n\n    // Return all selected guides, since we cannot apply the one-at-a-time limit\n    // or throttle settings, but rather defer to the caller to decide which ones\n    // to render. Note\n    return [...result.values()];\n  }\n\n  selectGuide<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    this.knock.log(\n      `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return undefined;\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection found zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n    this.knock.log(\n      `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n    );\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\n      this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n      return guide;\n    }\n\n    // Check if inside the throttle window (i.e. throttled) and if so stop and\n    // return undefined.\n    const defaultGroup = findDefaultGroup(state.guideGroups);\n    const throttleWindowStartedAt =\n      state.guideGroupDisplayLogs[DEFAULT_GROUP_KEY];\n\n    if (\n      defaultGroup &&\n      defaultGroup.display_interval &&\n      throttleWindowStartedAt\n    ) {\n      const throttled = checkIfThrottled(\n        throttleWindowStartedAt,\n        defaultGroup.display_interval,\n      );\n      if (throttled) {\n        this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n        return undefined;\n      }\n    }\n\n    // Starting here to the end of this method represents the core logic of how\n    // \"group stage\" works. It provides a mechanism for 1) figuring out which\n    // guide components are about to render on a page, 2) determining which\n    // among them ranks highest in the configured display sequence, and 3)\n    // returning only the prevailing guide to render at a time.\n    //\n    // Imagine N number of components that use the `useGuide()` hook which\n    // calls this `selectGuide()` method, and the logic works like this:\n    // * The first time this method is called, we don't have an \"open\" group\n    //   stage, so we open one (this occurs when a new page/route is rendering).\n    //   * While it is open, we record which guide was selected and its order\n    //     index from each call, but we do NOT return any guide to render yet.\n    //   * When a group stage opens, it schedules a timer to close itself. How\n    //     long this timer waits is configurable. Note, `setTimeout` with 0\n    //     delay seems to work well for React apps, where we \"yield\" to React\n    //     for one render cycle and close the group right after.\n    // * When a group stage closes, we evaluate which guides were selected and\n    //   recorded, then determine the winning guide (i.e. the one with the\n    //   lowest order index value).\n    //   * Then increment the internal counter to trigger a store state update,\n    //     which allows `useGuide()` and `selectGuide()` to re-run. This second\n    //     round of `selectGuide()` calls, occurring when the group stage is\n    //     closed, results in returning the prevailing guide.\n    // * Whenever a user navigates to a new page, we repeat the same process\n    //   above.\n    // * There's a third status called \"patch,\" which is for handling real-time\n    //   updates received from the API. It's similar to the \"open\" to \"closed\"\n    //   flow, except we keep the resolved guide in place while we recalculate.\n    //   This is done so that we don't cause flickers or CLS.\n    if (!this.stage) {\n      this.stage = this.openGroupStage(); // Assign here to make tsc happy\n    }\n\n    switch (this.stage.status) {\n      case \"open\": {\n        this.knock.log(`[Guide] Addng to the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n        return undefined;\n      }\n\n      case \"patch\": {\n        this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n\n      case \"closed\": {\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n    }\n  }\n\n  private openGroupStage() {\n    this.knock.log(\"[Guide] Opening a new group stage\");\n\n    const {\n      orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n    } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    this.stage = {\n      status: \"open\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  // Close the current non-closed stage to resolve the prevailing guide up next\n  // for display amongst the ones that have been staged.\n  private closePendingGroupStage() {\n    this.knock.log(\"[Guide] .closePendingGroupStage\");\n    if (!this.stage || this.stage.status === \"closed\") return;\n\n    // Should have been cleared already since this method should be called as a\n    // callback to a setTimeout, but just to be safe.\n    this.ensureClearTimeout();\n\n    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.knock.log(\n      `[Guide] Closing the current group stage: resolved=${resolved}`,\n    );\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    this.knock.log(\"[Guide] .patchClosedGroupStage\");\n    if (this.stage?.status !== \"closed\") return;\n\n    const { orderResolutionDuration: delay = 0 } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    // Just to be safe.\n    this.ensureClearTimeout();\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\n\n    this.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    this.knock.log(\"[Guide] .clearGroupStage\");\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n    this.ensureClearTimeout();\n    this.stage = undefined;\n  }\n\n  private ensureClearTimeout() {\n    if (this.stage?.timeoutId) {\n      clearTimeout(this.stage.timeoutId);\n    }\n  }\n\n  // Test helper that opens and closes the group stage to return the select\n  // result immediately.\n  private _selectGuide(state: StoreState, filters: SelectFilterParams = {}) {\n    this.openGroupStage();\n\n    this.selectGuide(state, filters);\n    this.closePendingGroupStage();\n\n    return this.selectGuide(state, filters);\n  }\n\n  //\n  // Engagement event handlers\n  //\n  // Make an optimistic update on the client side first, then send an engagement\n  // event to the backend.\n  //\n\n  async markAsSeen(guide: GuideData, step: GuideStepData) {\n    if (step.message.seen_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as seen (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      seen_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      content: updatedStep.content,\n      data: this.targetParams.data,\n      tenant: this.targetParams.tenant,\n    };\n\n    this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n      \"seen\",\n      params,\n    );\n\n    return updatedStep;\n  }\n\n  async markAsInteracted(\n    guide: GuideData,\n    step: GuideStepData,\n    metadata?: GenericData,\n  ) {\n    this.knock.log(\n      `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n    );\n\n    const ts = new Date().toISOString();\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      read_at: ts,\n      interacted_at: ts,\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      metadata,\n    };\n\n    this.knock.user.markGuideStepAs<\n      MarkAsInteractedParams,\n      MarkGuideAsResponse\n    >(\"interacted\", params);\n\n    return updatedStep;\n  }\n\n  async markAsArchived(guide: GuideData, step: GuideStepData) {\n    if (step.message.archived_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      archived_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n    this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n      \"archived\",\n      {\n        ...params,\n        unthrottled: guide.bypass_global_group_limit,\n      },\n    );\n\n    return updatedStep;\n  }\n\n  //\n  // Helpers\n  //\n\n  private localCopy(remoteGuide: GuideData) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n\n    // Build a local copy with helper methods added.\n    const localGuide = {\n      ...remoteGuide,\n      // Get the next unarchived step.\n      getStep() {\n        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      channel_id: guide.channel_id,\n      guide_key: guide.key,\n      guide_id: guide.id,\n      guide_step_ref: step.ref,\n    };\n  }\n\n  private addOrReplaceGuide({ data }: GuideAddedEvent | GuideUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      return { ...state, guides };\n    });\n  }\n\n  private removeGuide({ data }: GuideUpdatedEvent | GuideRemovedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      const { [data.guide.key]: _, ...rest } = state.guides;\n      return { ...state, guides: rest };\n    });\n  }\n\n  private addOrReplaceGuideGroup({\n    data,\n  }: GuideGroupAddedEvent | GuideGroupUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      // Currently we only support a single default global group, so we can just\n      // update the list with the added/updated group.\n      const guideGroups = [data.guide_group];\n\n      // A guide group event can include lists of unthrottled vs throttled guide\n      // keys which we can use to bulk update the guides in the store already.\n      const unthrottled = data.guide_group.display_sequence_unthrottled || [];\n      const throttled = data.guide_group.display_sequence_throttled || [];\n\n      let guides = state.guides;\n\n      guides = unthrottled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: true };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      guides = throttled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: false };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      return { ...state, guides, guideGroups };\n    });\n  }\n\n  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  formatGroupStage,\n  formatState,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const urlPreviewSessionId = urlParams.get(\n    DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n  );\n\n  // If URL params exist, persist them to localStorage and return them\n  if (urlGuideKey || urlPreviewSessionId) {\n    if (win.localStorage) {\n      try {\n        const debugState = {\n          forcedGuideKey: urlGuideKey,\n          previewSessionId: urlPreviewSessionId,\n        };\n        win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n    return {\n      forcedGuideKey: urlGuideKey,\n      previewSessionId: urlPreviewSessionId,\n    };\n  }\n\n  // Check local storage if no URL params\n  let storedGuideKey = null;\n  let storedPreviewSessionId = null;\n\n  if (win.localStorage) {\n    try {\n      const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n      if (storedDebugState) {\n        const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n        storedGuideKey = parsedDebugState.forcedGuideKey;\n        storedPreviewSessionId = parsedDebugState.previewSessionId;\n      }\n    } catch {\n      // Silently fail in privacy mode\n    }\n  }\n\n  return {\n    forcedGuideKey: storedGuideKey,\n    previewSessionId: storedPreviewSessionId,\n  };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n  try {\n    const parsed = JSON.parse(value);\n    return {\n      forcedGuideKey: parsed?.forcedGuideKey ?? null,\n      previewSessionId: parsed?.previewSessionId ?? null,\n    };\n  } catch {\n    return {\n      forcedGuideKey: null,\n      previewSessionId: null,\n    };\n  }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const {\n      trackLocationFromWindow = true,\n      throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    if (throttleCheckInterval) {\n      // Start the counter loop to increment at an interval.\n      this.startCounterInterval(throttleCheckInterval);\n    }\n\n    this.knock.log(\"[Guide] Initialized a guide client\");\n  }\n\n  private incrementCounter() {\n    this.knock.log(\"[Guide] Incrementing the counter\");\n    this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n  }\n\n  private startCounterInterval(delay: number) {\n    this.counterIntervalId = setInterval(() => {\n      this.knock.log(\"[Guide] Counter interval tick\");\n      if (this.stage && this.stage.status !== \"closed\") return;\n\n      this.incrementCounter();\n    }, delay);\n  }\n\n  private clearCounterInterval() {\n    if (this.counterIntervalId) {\n      clearInterval(this.counterIntervalId);\n      this.counterIntervalId = undefined;\n    }\n  }\n\n  cleanup() {\n    this.unsubscribe();\n    this.removeEventListeners();\n    this.clearGroupStage();\n    this.clearCounterInterval();\n  }\n\n  async fetch(opts?: { filters?: QueryFilterParams }) {\n    this.knock.log(\"[Guide] .fetch\");\n    this.knock.failIfNotAuthenticated();\n\n    const queryParams = this.buildQueryParams(opts?.filters);\n    const queryKey = this.formatQueryKey(queryParams);\n\n    // If already fetched before, then noop.\n    const maybeQueryStatus = this.store.state.queries[queryKey];\n    if (maybeQueryStatus) {\n      return maybeQueryStatus;\n    }\n\n    // Mark this query status as loading.\n    this.store.setState((state) => ({\n      ...state,\n      queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n    }));\n\n    let queryStatus: QueryStatus;\n    try {\n      this.knock.log(\"[Guide] Fetching all eligible guides\");\n      const data = await this.knock.user.getGuides<\n        GetGuidesQueryParams,\n        GetGuidesResponse\n      >(this.channelId, queryParams);\n      queryStatus = { status: \"ok\" };\n\n      const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n      this.knock.log(\"[Guide] Loading fetched guides\");\n      this.store.setState((state) => ({\n        ...state,\n        guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n        guideGroupDisplayLogs: guide_group_display_logs || {},\n        guides: byKey(entries.map((g) => this.localCopy(g))),\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    } catch (e) {\n      queryStatus = { status: \"error\", error: e as Error };\n\n      this.store.setState((state) => ({\n        ...state,\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    }\n\n    return queryStatus;\n  }\n\n  subscribe() {\n    if (!this.socket) return;\n    this.knock.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n    // Ensure a live socket connection if not yet connected.\n    if (!this.socket.isConnected()) {\n      this.socket.connect();\n    }\n\n    // If there's an existing connected channel, then disconnect.\n    if (this.socketChannel) {\n      this.unsubscribe();\n    }\n\n    // Join the channel topic and subscribe to supported events.\n    const debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.knock.log(\"[Guide] Updating the tracked location\");\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  exitDebugMode() {\n    this.knock.log(\"[Guide] Exiting debug mode\");\n\n    // Clear localStorage debug params\n    const win = checkForWindow();\n    if (win?.localStorage) {\n      try {\n        win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n\n    // Clear debug state from store\n    this.store.setState((state) => ({\n      ...state,\n      debug: { forcedGuideKey: null, previewSessionId: null },\n      previewGuides: {}, // Clear preview guides when exiting debug mode\n    }));\n\n    // Remove URL query params if present\n    // Only update the URL if params need to be cleared to avoid unnecessary navigations\n    if (win) {\n      const url = new URL(win.location.href);\n      if (\n        url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n        url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n      ) {\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n        win.location.href = url.toString();\n      }\n    }\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    this.knock.log(\n      `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return [];\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return [];\n    }\n\n    // Return all selected guides, since we cannot apply the one-at-a-time limit\n    // or throttle settings, but rather defer to the caller to decide which ones\n    // to render. Note\n    return [...result.values()];\n  }\n\n  selectGuide<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    this.knock.log(\n      `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return undefined;\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection found zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n    this.knock.log(\n      `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n    );\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\n      this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n      return guide;\n    }\n\n    // Check if inside the throttle window (i.e. throttled) and if so stop and\n    // return undefined.\n    const defaultGroup = findDefaultGroup(state.guideGroups);\n    const throttleWindowStartedAt =\n      state.guideGroupDisplayLogs[DEFAULT_GROUP_KEY];\n\n    if (\n      defaultGroup &&\n      defaultGroup.display_interval &&\n      throttleWindowStartedAt\n    ) {\n      const throttled = checkIfThrottled(\n        throttleWindowStartedAt,\n        defaultGroup.display_interval,\n      );\n      if (throttled) {\n        this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n        return undefined;\n      }\n    }\n\n    // Starting here to the end of this method represents the core logic of how\n    // \"group stage\" works. It provides a mechanism for 1) figuring out which\n    // guide components are about to render on a page, 2) determining which\n    // among them ranks highest in the configured display sequence, and 3)\n    // returning only the prevailing guide to render at a time.\n    //\n    // Imagine N number of components that use the `useGuide()` hook which\n    // calls this `selectGuide()` method, and the logic works like this:\n    // * The first time this method is called, we don't have an \"open\" group\n    //   stage, so we open one (this occurs when a new page/route is rendering).\n    //   * While it is open, we record which guide was selected and its order\n    //     index from each call, but we do NOT return any guide to render yet.\n    //   * When a group stage opens, it schedules a timer to close itself. How\n    //     long this timer waits is configurable. Note, `setTimeout` with 0\n    //     delay seems to work well for React apps, where we \"yield\" to React\n    //     for one render cycle and close the group right after.\n    // * When a group stage closes, we evaluate which guides were selected and\n    //   recorded, then determine the winning guide (i.e. the one with the\n    //   lowest order index value).\n    //   * Then increment the internal counter to trigger a store state update,\n    //     which allows `useGuide()` and `selectGuide()` to re-run. This second\n    //     round of `selectGuide()` calls, occurring when the group stage is\n    //     closed, results in returning the prevailing guide.\n    // * Whenever a user navigates to a new page, we repeat the same process\n    //   above.\n    // * There's a third status called \"patch,\" which is for handling real-time\n    //   updates received from the API. It's similar to the \"open\" to \"closed\"\n    //   flow, except we keep the resolved guide in place while we recalculate.\n    //   This is done so that we don't cause flickers or CLS.\n    if (!this.stage) {\n      this.stage = this.openGroupStage(); // Assign here to make tsc happy\n    }\n\n    switch (this.stage.status) {\n      case \"open\": {\n        this.knock.log(`[Guide] Adding to the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n        return undefined;\n      }\n\n      case \"patch\": {\n        this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n\n      case \"closed\": {\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n    }\n  }\n\n  private openGroupStage() {\n    this.knock.log(\"[Guide] Opening a new group stage\");\n\n    const {\n      orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n    } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    this.stage = {\n      status: \"open\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  // Close the current non-closed stage to resolve the prevailing guide up next\n  // for display amongst the ones that have been staged.\n  private closePendingGroupStage() {\n    this.knock.log(\"[Guide] .closePendingGroupStage\");\n    if (!this.stage || this.stage.status === \"closed\") return;\n\n    // Should have been cleared already since this method should be called as a\n    // callback to a setTimeout, but just to be safe.\n    this.ensureClearTimeout();\n\n    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.knock.log(\n      `[Guide] Closing the current group stage: resolved=${resolved}`,\n    );\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    this.knock.log(\"[Guide] .patchClosedGroupStage\");\n    if (this.stage?.status !== \"closed\") return;\n\n    const { orderResolutionDuration: delay = 0 } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    // Just to be safe.\n    this.ensureClearTimeout();\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\n\n    this.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    this.knock.log(\"[Guide] .clearGroupStage\");\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n    this.ensureClearTimeout();\n    this.stage = undefined;\n  }\n\n  private ensureClearTimeout() {\n    if (this.stage?.timeoutId) {\n      clearTimeout(this.stage.timeoutId);\n    }\n  }\n\n  // Test helper that opens and closes the group stage to return the select\n  // result immediately.\n  private _selectGuide(state: StoreState, filters: SelectFilterParams = {}) {\n    this.openGroupStage();\n\n    this.selectGuide(state, filters);\n    this.closePendingGroupStage();\n\n    return this.selectGuide(state, filters);\n  }\n\n  //\n  // Engagement event handlers\n  //\n  // Make an optimistic update on the client side first, then send an engagement\n  // event to the backend.\n  //\n\n  async markAsSeen(guide: GuideData, step: GuideStepData) {\n    if (step.message.seen_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as seen (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      seen_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      content: updatedStep.content,\n      data: this.targetParams.data,\n      tenant: this.targetParams.tenant,\n    };\n\n    this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n      \"seen\",\n      params,\n    );\n\n    return updatedStep;\n  }\n\n  async markAsInteracted(\n    guide: GuideData,\n    step: GuideStepData,\n    metadata?: GenericData,\n  ) {\n    this.knock.log(\n      `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n    );\n\n    const ts = new Date().toISOString();\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      read_at: ts,\n      interacted_at: ts,\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      metadata,\n    };\n\n    this.knock.user.markGuideStepAs<\n      MarkAsInteractedParams,\n      MarkGuideAsResponse\n    >(\"interacted\", params);\n\n    return updatedStep;\n  }\n\n  async markAsArchived(guide: GuideData, step: GuideStepData) {\n    if (step.message.archived_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      archived_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n    this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n      \"archived\",\n      {\n        ...params,\n        unthrottled: guide.bypass_global_group_limit,\n      },\n    );\n\n    return updatedStep;\n  }\n\n  //\n  // Helpers\n  //\n\n  private localCopy(remoteGuide: GuideData) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n\n    // Build a local copy with helper methods added.\n    const localGuide = {\n      ...remoteGuide,\n      // Get the next unarchived step.\n      getStep() {\n        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      let guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // If updated, return the guide as a new object so useStore can trigger.\n      guide = updatedStep ? { ...guide, steps } : guide;\n\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      channel_id: guide.channel_id,\n      guide_key: guide.key,\n      guide_id: guide.id,\n      guide_step_ref: step.ref,\n    };\n  }\n\n  private addOrReplaceGuide({ data }: GuideAddedEvent | GuideUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      return { ...state, guides };\n    });\n  }\n\n  private removeGuide({ data }: GuideUpdatedEvent | GuideRemovedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      const { [data.guide.key]: _, ...rest } = state.guides;\n      return { ...state, guides: rest };\n    });\n  }\n\n  private addOrReplaceGuideGroup({\n    data,\n  }: GuideGroupAddedEvent | GuideGroupUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      // Currently we only support a single default global group, so we can just\n      // update the list with the added/updated group.\n      const guideGroups = [data.guide_group];\n\n      // A guide group event can include lists of unthrottled vs throttled guide\n      // keys which we can use to bulk update the guides in the store already.\n      const unthrottled = data.guide_group.display_sequence_unthrottled || [];\n      const throttled = data.guide_group.display_sequence_throttled || [];\n\n      let guides = state.guides;\n\n      guides = unthrottled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: true };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      guides = throttled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: false };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      return { ...state, guides, guideGroups };\n    });\n  }\n\n  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}

package/dist/esm/api.mjs

@@ -53,7 +53,7 @@ class k {
     return o.isNetworkError(e) ? !0 : e.response ? e.response.status >= 500 && e.response.status <= 599 || e.response.status === 429 : !1;
   }
   getKnockClientHeader() {
-    return "Knock/ClientJS 0.18.5";
+    return "Knock/ClientJS 0.18.6";
   }
 }
 export {

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

@@ -20,11 +20,11 @@ const O = 50, $ = 30 * 1e3, T = 3, g = {
   if (t || s) {
     if (u.localStorage)
       try {
-        const n = {
+        const r = {
           forcedGuideKey: t,
           previewSessionId: s
         };
-        u.localStorage.setItem(p, JSON.stringify(n));
+        u.localStorage.setItem(p, JSON.stringify(r));
       } catch {
       }
     return {
@@ -32,19 +32,19 @@ const O = 50, $ = 30 * 1e3, T = 3, g = {
       previewSessionId: s
     };
   }
-  let i = null, r = null;
+  let i = null, n = null;
   if (u.localStorage)
     try {
-      const n = u.localStorage.getItem(p);
-      if (n) {
-        const o = F(n);
-        i = o.forcedGuideKey, r = o.previewSessionId;
+      const r = u.localStorage.getItem(p);
+      if (r) {
+        const o = F(r);
+        i = o.forcedGuideKey, n = o.previewSessionId;
       }
     } catch {
     }
   return {
     forcedGuideKey: i,
-    previewSessionId: r
+    previewSessionId: n
   };
 }, F = (u) => {
   try {
@@ -62,18 +62,18 @@ const O = 50, $ = 30 * 1e3, T = 3, g = {
 }, m = (u, e = {}) => {
   const t = new A(), s = v(u.guideGroups);
   if (!s) return t;
-  const i = [...s.display_sequence], r = u.location;
+  const i = [...s.display_sequence], n = u.location;
   if (u.debug.forcedGuideKey) {
-    const n = i.indexOf(u.debug.forcedGuideKey);
-    n > -1 && i.splice(n, 1), i.unshift(u.debug.forcedGuideKey);
+    const r = i.indexOf(u.debug.forcedGuideKey);
+    r > -1 && i.splice(r, 1), i.unshift(u.debug.forcedGuideKey);
   }
-  for (const [n, o] of i.entries()) {
+  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: r,
+      location: n,
       filters: e,
       debug: u.debug
-    })) && t.set(n, a);
+    })) && t.set(r, a);
   }
   return t.metadata = { guideGroup: s }, t;
 }, N = (u, { location: e, filters: t = {}, debug: s = {} }) => {
@@ -83,10 +83,10 @@ const O = 50, $ = 30 * 1e3, T = 3, g = {
     return !0;
   if (!u.active || u.steps.every((o) => !!o.message.archived_at))
     return !1;
-  const i = e ? D(e) : void 0, r = u.activation_url_rules || [], n = u.activation_url_patterns || [];
-  if (i && r.length > 0) {
-    if (!K(i, r)) return !1;
-  } else if (i && n.length > 0 && !L(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;
 };
@@ -131,9 +131,9 @@ class B {
     });
     this.knock = e, this.channelId = t, this.targetParams = s, this.options = i;
     const {
-      trackLocationFromWindow: r = !0,
-      throttleCheckInterval: n = $
-    } = i, o = l(), a = 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: {},
@@ -146,7 +146,7 @@ class B {
       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 }));
@@ -167,30 +167,30 @@ class B {
     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: a, 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: (a == null ? void 0 : a.length) > 0 ? a : [R(o)],
         guideGroupDisplayLogs: h || {},
         guides: w(o.map((_) => this.localCopy(_))),
-        queries: { ...c.queries, [s]: r }
+        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;
@@ -202,7 +202,7 @@ class B {
       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) => {
@@ -250,8 +250,8 @@ class B {
   }
   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,
@@ -301,33 +301,33 @@ class B {
       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 = v(e.guideGroups), o = e.guideGroupDisplayLogs[S];
-    if (n && n.display_interval && o && P(
+      `[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 a = 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 \`${a == null ? void 0 : a.key}\` (stage: ${G(this.stage)})`
         ), a;
       }
       case "closed": {
-        const a = this.stage.resolved === r.key ? r : void 0;
+        const a = this.stage.resolved === n.key ? n : void 0;
         return this.knock.log(
           `[Guide] Returning \`${a == null ? void 0 : a.key}\` (stage: ${G(this.stage)})`
         ), a;
@@ -424,16 +424,16 @@ class B {
     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;
@@ -464,9 +464,9 @@ class B {
         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)
@@ -480,7 +480,7 @@ class B {
             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 E({ pathname: i.pathname })
@@ -494,29 +494,29 @@ class B {
     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])}`
+      (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 a = { ...r.guides, [n.key]: n }, h = s.archived_at && !n.bypass_global_group_limit ? {
-        ...r.guideGroupDisplayLogs,
+    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
-      } : r.guideGroupDisplayLogs;
-      return { ...r, guides: a, guideGroupDisplayLogs: h };
+      } : n.guideGroupDisplayLogs;
+      return { ...n, guides: a, guideGroupDisplayLogs: h };
     }), i;
   }
   buildEngagementEventBaseParams(e, t) {
@@ -545,17 +545,17 @@ class B {
     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, a) => {
+      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 };
-      }, n), n = r.reduce((o, a) => {
+      }, r), r = n.reduce((o, a) => {
         if (!o[a]) return o;
         const h = { ...o[a], bypass_global_group_limit: !1 };
         return { ...o, [a]: h };
-      }, n), { ...t, guides: n, guideGroups: s };
+      }, r), { ...t, guides: r, guideGroups: s };
     });
   }
   updatePreviewGuide({ data: e }) {
@@ -576,14 +576,14 @@ class B {
       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);
         }

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

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  formatGroupStage,\n  formatState,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const urlPreviewSessionId = urlParams.get(\n    DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n  );\n\n  // If URL params exist, persist them to localStorage and return them\n  if (urlGuideKey || urlPreviewSessionId) {\n    if (win.localStorage) {\n      try {\n        const debugState = {\n          forcedGuideKey: urlGuideKey,\n          previewSessionId: urlPreviewSessionId,\n        };\n        win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n    return {\n      forcedGuideKey: urlGuideKey,\n      previewSessionId: urlPreviewSessionId,\n    };\n  }\n\n  // Check local storage if no URL params\n  let storedGuideKey = null;\n  let storedPreviewSessionId = null;\n\n  if (win.localStorage) {\n    try {\n      const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n      if (storedDebugState) {\n        const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n        storedGuideKey = parsedDebugState.forcedGuideKey;\n        storedPreviewSessionId = parsedDebugState.previewSessionId;\n      }\n    } catch {\n      // Silently fail in privacy mode\n    }\n  }\n\n  return {\n    forcedGuideKey: storedGuideKey,\n    previewSessionId: storedPreviewSessionId,\n  };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n  try {\n    const parsed = JSON.parse(value);\n    return {\n      forcedGuideKey: parsed?.forcedGuideKey ?? null,\n      previewSessionId: parsed?.previewSessionId ?? null,\n    };\n  } catch {\n    return {\n      forcedGuideKey: null,\n      previewSessionId: null,\n    };\n  }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const {\n      trackLocationFromWindow = true,\n      throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    if (throttleCheckInterval) {\n      // Start the counter loop to increment at an interval.\n      this.startCounterInterval(throttleCheckInterval);\n    }\n\n    this.knock.log(\"[Guide] Initialized a guide client\");\n  }\n\n  private incrementCounter() {\n    this.knock.log(\"[Guide] Incrementing the counter\");\n    this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n  }\n\n  private startCounterInterval(delay: number) {\n    this.counterIntervalId = setInterval(() => {\n      this.knock.log(\"[Guide] Counter interval tick\");\n      if (this.stage && this.stage.status !== \"closed\") return;\n\n      this.incrementCounter();\n    }, delay);\n  }\n\n  private clearCounterInterval() {\n    if (this.counterIntervalId) {\n      clearInterval(this.counterIntervalId);\n      this.counterIntervalId = undefined;\n    }\n  }\n\n  cleanup() {\n    this.unsubscribe();\n    this.removeEventListeners();\n    this.clearGroupStage();\n    this.clearCounterInterval();\n  }\n\n  async fetch(opts?: { filters?: QueryFilterParams }) {\n    this.knock.log(\"[Guide] .fetch\");\n    this.knock.failIfNotAuthenticated();\n\n    const queryParams = this.buildQueryParams(opts?.filters);\n    const queryKey = this.formatQueryKey(queryParams);\n\n    // If already fetched before, then noop.\n    const maybeQueryStatus = this.store.state.queries[queryKey];\n    if (maybeQueryStatus) {\n      return maybeQueryStatus;\n    }\n\n    // Mark this query status as loading.\n    this.store.setState((state) => ({\n      ...state,\n      queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n    }));\n\n    let queryStatus: QueryStatus;\n    try {\n      this.knock.log(\"[Guide] Fetching all eligible guides\");\n      const data = await this.knock.user.getGuides<\n        GetGuidesQueryParams,\n        GetGuidesResponse\n      >(this.channelId, queryParams);\n      queryStatus = { status: \"ok\" };\n\n      const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n      this.knock.log(\"[Guide] Loading fetched guides\");\n      this.store.setState((state) => ({\n        ...state,\n        guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n        guideGroupDisplayLogs: guide_group_display_logs || {},\n        guides: byKey(entries.map((g) => this.localCopy(g))),\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    } catch (e) {\n      queryStatus = { status: \"error\", error: e as Error };\n\n      this.store.setState((state) => ({\n        ...state,\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    }\n\n    return queryStatus;\n  }\n\n  subscribe() {\n    if (!this.socket) return;\n    this.knock.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n    // Ensure a live socket connection if not yet connected.\n    if (!this.socket.isConnected()) {\n      this.socket.connect();\n    }\n\n    // If there's an existing connected channel, then disconnect.\n    if (this.socketChannel) {\n      this.unsubscribe();\n    }\n\n    // Join the channel topic and subscribe to supported events.\n    const debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.knock.log(\"[Guide] Updating the tracked location\");\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  exitDebugMode() {\n    this.knock.log(\"[Guide] Exiting debug mode\");\n\n    // Clear localStorage debug params\n    const win = checkForWindow();\n    if (win?.localStorage) {\n      try {\n        win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n\n    // Clear debug state from store\n    this.store.setState((state) => ({\n      ...state,\n      debug: { forcedGuideKey: null, previewSessionId: null },\n      previewGuides: {}, // Clear preview guides when exiting debug mode\n    }));\n\n    // Remove URL query params if present\n    // Only update the URL if params need to be cleared to avoid unnecessary navigations\n    if (win) {\n      const url = new URL(win.location.href);\n      if (\n        url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n        url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n      ) {\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n        win.location.href = url.toString();\n      }\n    }\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    this.knock.log(\n      `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return [];\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return [];\n    }\n\n    // Return all selected guides, since we cannot apply the one-at-a-time limit\n    // or throttle settings, but rather defer to the caller to decide which ones\n    // to render. Note\n    return [...result.values()];\n  }\n\n  selectGuide<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    this.knock.log(\n      `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return undefined;\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection found zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n    this.knock.log(\n      `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n    );\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\n      this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n      return guide;\n    }\n\n    // Check if inside the throttle window (i.e. throttled) and if so stop and\n    // return undefined.\n    const defaultGroup = findDefaultGroup(state.guideGroups);\n    const throttleWindowStartedAt =\n      state.guideGroupDisplayLogs[DEFAULT_GROUP_KEY];\n\n    if (\n      defaultGroup &&\n      defaultGroup.display_interval &&\n      throttleWindowStartedAt\n    ) {\n      const throttled = checkIfThrottled(\n        throttleWindowStartedAt,\n        defaultGroup.display_interval,\n      );\n      if (throttled) {\n        this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n        return undefined;\n      }\n    }\n\n    // Starting here to the end of this method represents the core logic of how\n    // \"group stage\" works. It provides a mechanism for 1) figuring out which\n    // guide components are about to render on a page, 2) determining which\n    // among them ranks highest in the configured display sequence, and 3)\n    // returning only the prevailing guide to render at a time.\n    //\n    // Imagine N number of components that use the `useGuide()` hook which\n    // calls this `selectGuide()` method, and the logic works like this:\n    // * The first time this method is called, we don't have an \"open\" group\n    //   stage, so we open one (this occurs when a new page/route is rendering).\n    //   * While it is open, we record which guide was selected and its order\n    //     index from each call, but we do NOT return any guide to render yet.\n    //   * When a group stage opens, it schedules a timer to close itself. How\n    //     long this timer waits is configurable. Note, `setTimeout` with 0\n    //     delay seems to work well for React apps, where we \"yield\" to React\n    //     for one render cycle and close the group right after.\n    // * When a group stage closes, we evaluate which guides were selected and\n    //   recorded, then determine the winning guide (i.e. the one with the\n    //   lowest order index value).\n    //   * Then increment the internal counter to trigger a store state update,\n    //     which allows `useGuide()` and `selectGuide()` to re-run. This second\n    //     round of `selectGuide()` calls, occurring when the group stage is\n    //     closed, results in returning the prevailing guide.\n    // * Whenever a user navigates to a new page, we repeat the same process\n    //   above.\n    // * There's a third status called \"patch,\" which is for handling real-time\n    //   updates received from the API. It's similar to the \"open\" to \"closed\"\n    //   flow, except we keep the resolved guide in place while we recalculate.\n    //   This is done so that we don't cause flickers or CLS.\n    if (!this.stage) {\n      this.stage = this.openGroupStage(); // Assign here to make tsc happy\n    }\n\n    switch (this.stage.status) {\n      case \"open\": {\n        this.knock.log(`[Guide] Addng to the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n        return undefined;\n      }\n\n      case \"patch\": {\n        this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n\n      case \"closed\": {\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n    }\n  }\n\n  private openGroupStage() {\n    this.knock.log(\"[Guide] Opening a new group stage\");\n\n    const {\n      orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n    } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    this.stage = {\n      status: \"open\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  // Close the current non-closed stage to resolve the prevailing guide up next\n  // for display amongst the ones that have been staged.\n  private closePendingGroupStage() {\n    this.knock.log(\"[Guide] .closePendingGroupStage\");\n    if (!this.stage || this.stage.status === \"closed\") return;\n\n    // Should have been cleared already since this method should be called as a\n    // callback to a setTimeout, but just to be safe.\n    this.ensureClearTimeout();\n\n    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.knock.log(\n      `[Guide] Closing the current group stage: resolved=${resolved}`,\n    );\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    this.knock.log(\"[Guide] .patchClosedGroupStage\");\n    if (this.stage?.status !== \"closed\") return;\n\n    const { orderResolutionDuration: delay = 0 } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    // Just to be safe.\n    this.ensureClearTimeout();\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\n\n    this.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    this.knock.log(\"[Guide] .clearGroupStage\");\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n    this.ensureClearTimeout();\n    this.stage = undefined;\n  }\n\n  private ensureClearTimeout() {\n    if (this.stage?.timeoutId) {\n      clearTimeout(this.stage.timeoutId);\n    }\n  }\n\n  // Test helper that opens and closes the group stage to return the select\n  // result immediately.\n  private _selectGuide(state: StoreState, filters: SelectFilterParams = {}) {\n    this.openGroupStage();\n\n    this.selectGuide(state, filters);\n    this.closePendingGroupStage();\n\n    return this.selectGuide(state, filters);\n  }\n\n  //\n  // Engagement event handlers\n  //\n  // Make an optimistic update on the client side first, then send an engagement\n  // event to the backend.\n  //\n\n  async markAsSeen(guide: GuideData, step: GuideStepData) {\n    if (step.message.seen_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as seen (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      seen_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      content: updatedStep.content,\n      data: this.targetParams.data,\n      tenant: this.targetParams.tenant,\n    };\n\n    this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n      \"seen\",\n      params,\n    );\n\n    return updatedStep;\n  }\n\n  async markAsInteracted(\n    guide: GuideData,\n    step: GuideStepData,\n    metadata?: GenericData,\n  ) {\n    this.knock.log(\n      `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n    );\n\n    const ts = new Date().toISOString();\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      read_at: ts,\n      interacted_at: ts,\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      metadata,\n    };\n\n    this.knock.user.markGuideStepAs<\n      MarkAsInteractedParams,\n      MarkGuideAsResponse\n    >(\"interacted\", params);\n\n    return updatedStep;\n  }\n\n  async markAsArchived(guide: GuideData, step: GuideStepData) {\n    if (step.message.archived_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      archived_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n    this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n      \"archived\",\n      {\n        ...params,\n        unthrottled: guide.bypass_global_group_limit,\n      },\n    );\n\n    return updatedStep;\n  }\n\n  //\n  // Helpers\n  //\n\n  private localCopy(remoteGuide: GuideData) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n\n    // Build a local copy with helper methods added.\n    const localGuide = {\n      ...remoteGuide,\n      // Get the next unarchived step.\n      getStep() {\n        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      channel_id: guide.channel_id,\n      guide_key: guide.key,\n      guide_id: guide.id,\n      guide_step_ref: step.ref,\n    };\n  }\n\n  private addOrReplaceGuide({ data }: GuideAddedEvent | GuideUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      return { ...state, guides };\n    });\n  }\n\n  private removeGuide({ data }: GuideUpdatedEvent | GuideRemovedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      const { [data.guide.key]: _, ...rest } = state.guides;\n      return { ...state, guides: rest };\n    });\n  }\n\n  private addOrReplaceGuideGroup({\n    data,\n  }: GuideGroupAddedEvent | GuideGroupUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      // Currently we only support a single default global group, so we can just\n      // update the list with the added/updated group.\n      const guideGroups = [data.guide_group];\n\n      // A guide group event can include lists of unthrottled vs throttled guide\n      // keys which we can use to bulk update the guides in the store already.\n      const unthrottled = data.guide_group.display_sequence_unthrottled || [];\n      const throttled = data.guide_group.display_sequence_throttled || [];\n\n      let guides = state.guides;\n\n      guides = unthrottled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: true };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      guides = throttled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: false };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      return { ...state, guides, guideGroups };\n    });\n  }\n\n  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
+{"version":3,"file":"client.mjs","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  formatGroupStage,\n  formatState,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const urlPreviewSessionId = urlParams.get(\n    DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n  );\n\n  // If URL params exist, persist them to localStorage and return them\n  if (urlGuideKey || urlPreviewSessionId) {\n    if (win.localStorage) {\n      try {\n        const debugState = {\n          forcedGuideKey: urlGuideKey,\n          previewSessionId: urlPreviewSessionId,\n        };\n        win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n    return {\n      forcedGuideKey: urlGuideKey,\n      previewSessionId: urlPreviewSessionId,\n    };\n  }\n\n  // Check local storage if no URL params\n  let storedGuideKey = null;\n  let storedPreviewSessionId = null;\n\n  if (win.localStorage) {\n    try {\n      const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n      if (storedDebugState) {\n        const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n        storedGuideKey = parsedDebugState.forcedGuideKey;\n        storedPreviewSessionId = parsedDebugState.previewSessionId;\n      }\n    } catch {\n      // Silently fail in privacy mode\n    }\n  }\n\n  return {\n    forcedGuideKey: storedGuideKey,\n    previewSessionId: storedPreviewSessionId,\n  };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n  try {\n    const parsed = JSON.parse(value);\n    return {\n      forcedGuideKey: parsed?.forcedGuideKey ?? null,\n      previewSessionId: parsed?.previewSessionId ?? null,\n    };\n  } catch {\n    return {\n      forcedGuideKey: null,\n      previewSessionId: null,\n    };\n  }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const {\n      trackLocationFromWindow = true,\n      throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    if (throttleCheckInterval) {\n      // Start the counter loop to increment at an interval.\n      this.startCounterInterval(throttleCheckInterval);\n    }\n\n    this.knock.log(\"[Guide] Initialized a guide client\");\n  }\n\n  private incrementCounter() {\n    this.knock.log(\"[Guide] Incrementing the counter\");\n    this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n  }\n\n  private startCounterInterval(delay: number) {\n    this.counterIntervalId = setInterval(() => {\n      this.knock.log(\"[Guide] Counter interval tick\");\n      if (this.stage && this.stage.status !== \"closed\") return;\n\n      this.incrementCounter();\n    }, delay);\n  }\n\n  private clearCounterInterval() {\n    if (this.counterIntervalId) {\n      clearInterval(this.counterIntervalId);\n      this.counterIntervalId = undefined;\n    }\n  }\n\n  cleanup() {\n    this.unsubscribe();\n    this.removeEventListeners();\n    this.clearGroupStage();\n    this.clearCounterInterval();\n  }\n\n  async fetch(opts?: { filters?: QueryFilterParams }) {\n    this.knock.log(\"[Guide] .fetch\");\n    this.knock.failIfNotAuthenticated();\n\n    const queryParams = this.buildQueryParams(opts?.filters);\n    const queryKey = this.formatQueryKey(queryParams);\n\n    // If already fetched before, then noop.\n    const maybeQueryStatus = this.store.state.queries[queryKey];\n    if (maybeQueryStatus) {\n      return maybeQueryStatus;\n    }\n\n    // Mark this query status as loading.\n    this.store.setState((state) => ({\n      ...state,\n      queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n    }));\n\n    let queryStatus: QueryStatus;\n    try {\n      this.knock.log(\"[Guide] Fetching all eligible guides\");\n      const data = await this.knock.user.getGuides<\n        GetGuidesQueryParams,\n        GetGuidesResponse\n      >(this.channelId, queryParams);\n      queryStatus = { status: \"ok\" };\n\n      const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n      this.knock.log(\"[Guide] Loading fetched guides\");\n      this.store.setState((state) => ({\n        ...state,\n        guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n        guideGroupDisplayLogs: guide_group_display_logs || {},\n        guides: byKey(entries.map((g) => this.localCopy(g))),\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    } catch (e) {\n      queryStatus = { status: \"error\", error: e as Error };\n\n      this.store.setState((state) => ({\n        ...state,\n        queries: { ...state.queries, [queryKey]: queryStatus },\n      }));\n    }\n\n    return queryStatus;\n  }\n\n  subscribe() {\n    if (!this.socket) return;\n    this.knock.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n    // Ensure a live socket connection if not yet connected.\n    if (!this.socket.isConnected()) {\n      this.socket.connect();\n    }\n\n    // If there's an existing connected channel, then disconnect.\n    if (this.socketChannel) {\n      this.unsubscribe();\n    }\n\n    // Join the channel topic and subscribe to supported events.\n    const debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.knock.log(\"[Guide] Updating the tracked location\");\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  exitDebugMode() {\n    this.knock.log(\"[Guide] Exiting debug mode\");\n\n    // Clear localStorage debug params\n    const win = checkForWindow();\n    if (win?.localStorage) {\n      try {\n        win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n      } catch {\n        // Silently fail in privacy mode\n      }\n    }\n\n    // Clear debug state from store\n    this.store.setState((state) => ({\n      ...state,\n      debug: { forcedGuideKey: null, previewSessionId: null },\n      previewGuides: {}, // Clear preview guides when exiting debug mode\n    }));\n\n    // Remove URL query params if present\n    // Only update the URL if params need to be cleared to avoid unnecessary navigations\n    if (win) {\n      const url = new URL(win.location.href);\n      if (\n        url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n        url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n      ) {\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n        url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n        win.location.href = url.toString();\n      }\n    }\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    this.knock.log(\n      `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return [];\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return [];\n    }\n\n    // Return all selected guides, since we cannot apply the one-at-a-time limit\n    // or throttle settings, but rather defer to the caller to decide which ones\n    // to render. Note\n    return [...result.values()];\n  }\n\n  selectGuide<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    this.knock.log(\n      `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n    );\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\n      this.knock.log(\"[Guide] Exiting selection (no guides)\");\n      return undefined;\n    }\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection found zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n    this.knock.log(\n      `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n    );\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\n      this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n      return guide;\n    }\n\n    // Check if inside the throttle window (i.e. throttled) and if so stop and\n    // return undefined.\n    const defaultGroup = findDefaultGroup(state.guideGroups);\n    const throttleWindowStartedAt =\n      state.guideGroupDisplayLogs[DEFAULT_GROUP_KEY];\n\n    if (\n      defaultGroup &&\n      defaultGroup.display_interval &&\n      throttleWindowStartedAt\n    ) {\n      const throttled = checkIfThrottled(\n        throttleWindowStartedAt,\n        defaultGroup.display_interval,\n      );\n      if (throttled) {\n        this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n        return undefined;\n      }\n    }\n\n    // Starting here to the end of this method represents the core logic of how\n    // \"group stage\" works. It provides a mechanism for 1) figuring out which\n    // guide components are about to render on a page, 2) determining which\n    // among them ranks highest in the configured display sequence, and 3)\n    // returning only the prevailing guide to render at a time.\n    //\n    // Imagine N number of components that use the `useGuide()` hook which\n    // calls this `selectGuide()` method, and the logic works like this:\n    // * The first time this method is called, we don't have an \"open\" group\n    //   stage, so we open one (this occurs when a new page/route is rendering).\n    //   * While it is open, we record which guide was selected and its order\n    //     index from each call, but we do NOT return any guide to render yet.\n    //   * When a group stage opens, it schedules a timer to close itself. How\n    //     long this timer waits is configurable. Note, `setTimeout` with 0\n    //     delay seems to work well for React apps, where we \"yield\" to React\n    //     for one render cycle and close the group right after.\n    // * When a group stage closes, we evaluate which guides were selected and\n    //   recorded, then determine the winning guide (i.e. the one with the\n    //   lowest order index value).\n    //   * Then increment the internal counter to trigger a store state update,\n    //     which allows `useGuide()` and `selectGuide()` to re-run. This second\n    //     round of `selectGuide()` calls, occurring when the group stage is\n    //     closed, results in returning the prevailing guide.\n    // * Whenever a user navigates to a new page, we repeat the same process\n    //   above.\n    // * There's a third status called \"patch,\" which is for handling real-time\n    //   updates received from the API. It's similar to the \"open\" to \"closed\"\n    //   flow, except we keep the resolved guide in place while we recalculate.\n    //   This is done so that we don't cause flickers or CLS.\n    if (!this.stage) {\n      this.stage = this.openGroupStage(); // Assign here to make tsc happy\n    }\n\n    switch (this.stage.status) {\n      case \"open\": {\n        this.knock.log(`[Guide] Adding to the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n        return undefined;\n      }\n\n      case \"patch\": {\n        this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n        this.stage.ordered[index] = guide.key;\n\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n\n      case \"closed\": {\n        const ret = this.stage.resolved === guide.key ? guide : undefined;\n        this.knock.log(\n          `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n        );\n        return ret;\n      }\n    }\n  }\n\n  private openGroupStage() {\n    this.knock.log(\"[Guide] Opening a new group stage\");\n\n    const {\n      orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n    } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    this.stage = {\n      status: \"open\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  // Close the current non-closed stage to resolve the prevailing guide up next\n  // for display amongst the ones that have been staged.\n  private closePendingGroupStage() {\n    this.knock.log(\"[Guide] .closePendingGroupStage\");\n    if (!this.stage || this.stage.status === \"closed\") return;\n\n    // Should have been cleared already since this method should be called as a\n    // callback to a setTimeout, but just to be safe.\n    this.ensureClearTimeout();\n\n    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.knock.log(\n      `[Guide] Closing the current group stage: resolved=${resolved}`,\n    );\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    this.knock.log(\"[Guide] .patchClosedGroupStage\");\n    if (this.stage?.status !== \"closed\") return;\n\n    const { orderResolutionDuration: delay = 0 } = this.options;\n\n    const timeoutId = setTimeout(() => {\n      this.closePendingGroupStage();\n      this.incrementCounter();\n    }, delay);\n\n    // Just to be safe.\n    this.ensureClearTimeout();\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\n\n    this.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    this.knock.log(\"[Guide] .clearGroupStage\");\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n    this.ensureClearTimeout();\n    this.stage = undefined;\n  }\n\n  private ensureClearTimeout() {\n    if (this.stage?.timeoutId) {\n      clearTimeout(this.stage.timeoutId);\n    }\n  }\n\n  // Test helper that opens and closes the group stage to return the select\n  // result immediately.\n  private _selectGuide(state: StoreState, filters: SelectFilterParams = {}) {\n    this.openGroupStage();\n\n    this.selectGuide(state, filters);\n    this.closePendingGroupStage();\n\n    return this.selectGuide(state, filters);\n  }\n\n  //\n  // Engagement event handlers\n  //\n  // Make an optimistic update on the client side first, then send an engagement\n  // event to the backend.\n  //\n\n  async markAsSeen(guide: GuideData, step: GuideStepData) {\n    if (step.message.seen_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as seen (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      seen_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      content: updatedStep.content,\n      data: this.targetParams.data,\n      tenant: this.targetParams.tenant,\n    };\n\n    this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n      \"seen\",\n      params,\n    );\n\n    return updatedStep;\n  }\n\n  async markAsInteracted(\n    guide: GuideData,\n    step: GuideStepData,\n    metadata?: GenericData,\n  ) {\n    this.knock.log(\n      `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n    );\n\n    const ts = new Date().toISOString();\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      read_at: ts,\n      interacted_at: ts,\n    });\n    if (!updatedStep) return;\n\n    const params = {\n      ...this.buildEngagementEventBaseParams(guide, updatedStep),\n      metadata,\n    };\n\n    this.knock.user.markGuideStepAs<\n      MarkAsInteractedParams,\n      MarkGuideAsResponse\n    >(\"interacted\", params);\n\n    return updatedStep;\n  }\n\n  async markAsArchived(guide: GuideData, step: GuideStepData) {\n    if (step.message.archived_at) return;\n\n    this.knock.log(\n      `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n    );\n\n    const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n      archived_at: new Date().toISOString(),\n    });\n    if (!updatedStep) return;\n\n    const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n    this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n      \"archived\",\n      {\n        ...params,\n        unthrottled: guide.bypass_global_group_limit,\n      },\n    );\n\n    return updatedStep;\n  }\n\n  //\n  // Helpers\n  //\n\n  private localCopy(remoteGuide: GuideData) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n\n    // Build a local copy with helper methods added.\n    const localGuide = {\n      ...remoteGuide,\n      // Get the next unarchived step.\n      getStep() {\n        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      let guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // If updated, return the guide as a new object so useStore can trigger.\n      guide = updatedStep ? { ...guide, steps } : guide;\n\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      channel_id: guide.channel_id,\n      guide_key: guide.key,\n      guide_id: guide.id,\n      guide_step_ref: step.ref,\n    };\n  }\n\n  private addOrReplaceGuide({ data }: GuideAddedEvent | GuideUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      return { ...state, guides };\n    });\n  }\n\n  private removeGuide({ data }: GuideUpdatedEvent | GuideRemovedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      const { [data.guide.key]: _, ...rest } = state.guides;\n      return { ...state, guides: rest };\n    });\n  }\n\n  private addOrReplaceGuideGroup({\n    data,\n  }: GuideGroupAddedEvent | GuideGroupUpdatedEvent) {\n    this.patchClosedGroupStage();\n\n    this.store.setState((state) => {\n      // Currently we only support a single default global group, so we can just\n      // update the list with the added/updated group.\n      const guideGroups = [data.guide_group];\n\n      // A guide group event can include lists of unthrottled vs throttled guide\n      // keys which we can use to bulk update the guides in the store already.\n      const unthrottled = data.guide_group.display_sequence_unthrottled || [];\n      const throttled = data.guide_group.display_sequence_throttled || [];\n\n      let guides = state.guides;\n\n      guides = unthrottled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: true };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      guides = throttled.reduce((acc, key) => {\n        if (!acc[key]) return acc;\n        const guide = { ...acc[key], bypass_global_group_limit: false };\n        return { ...acc, [key]: guide };\n      }, guides);\n\n      return { ...state, guides, guideGroups };\n    });\n  }\n\n  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}

package/dist/types/clients/guide/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/client",
-  "version": "0.18.5",
+  "version": "0.18.6",
   "description": "The clientside library for interacting with Knock",
   "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
   "author": "@knocklabs",

package/src/clients/guide/client.ts

@@ -685,7 +685,7 @@ export class KnockGuideClient {
 
     switch (this.stage.status) {
       case "open": {
-        this.knock.log(`[Guide] Addng to the group stage: ${guide.key}`);
+        this.knock.log(`[Guide] Adding to the group stage: ${guide.key}`);
         this.stage.ordered[index] = guide.key;
         return undefined;
       }
@@ -1033,7 +1033,7 @@ export class KnockGuideClient {
     }
 
     this.store.setState((state) => {
-      const guide = state.guides[guideKey];
+      let guide = state.guides[guideKey];
       if (!guide) return state;
 
       const steps = guide.steps.map((step) => {
@@ -1046,8 +1046,9 @@ export class KnockGuideClient {
 
         return step;
       });
-      // Mutate in place and maintain the same obj ref.
-      guide.steps = steps;
+      // If updated, return the guide as a new object so useStore can trigger.
+      guide = updatedStep ? { ...guide, steps } : guide;
+
       const guides = { ...state.guides, [guide.key]: guide };
 
       // If the guide is subject to throttled settings and we are marking as