@knocklabs/client 0.16.3 → 0.16.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.16.5
+
+### Patch Changes
+
+- dc84f25: chore: limit retries for guide client real time subscription
+
+## 0.16.4
+
+### Patch Changes
+
+- 49f791b: fix: guard against undefined window object in ssr
+
 ## 0.16.3
 
 ### 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.16.3"}}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.16.5"}}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 f=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var d=(u,e,t)=>f(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("@tanstack/store"),S=require("urlpattern-polyfill"),c=require("./helpers.js"),v=50,G=30*1e3,p=u=>`/v1/users/${u}/guides`,g=(u,e={})=>{const t=new c.SelectionResult,s=c.findDefaultGroup(u.guideGroups);if(!s)return t;const r=s.display_sequence,i=u.location;for(const[n,o]of r.entries()){const a=u.guides[o];!a||!_(a,{location:i,filters:e})||t.set(n,a)}return t.metadata={guideGroup:s},t},_=(u,{location:e,filters:t={}})=>{if(t.type&&t.type!==u.type||t.key&&t.key!==u.key||u.steps.every(r=>!!r.message.archived_at))return!1;const s=u.activation_location_rules||[];return!(s.length>0&&e&&!s.reduce((i,n)=>{if(i===!1)return!1;switch(n.directive){case"allow":return i===!0||n.pattern.test(e)?!0:void 0;case"block":return n.pattern.test(e)?!1:i}},void 0))};class C{constructor(e,t,s={},r={}){d(this,"store");d(this,"socket");d(this,"socketChannel");d(this,"socketChannelTopic");d(this,"socketEventTypes",["guide.added","guide.updated","guide.removed","guide_group.added","guide_group.updated"]);d(this,"pushStateFn");d(this,"replaceStateFn");d(this,"stage");d(this,"counterIntervalId");d(this,"handleLocationChange",()=>{const e=window.location.href;this.store.state.location!==e&&(this.knock.log(`[Guide] Handle Location change: ${e}`),this.setLocation(e))});this.knock=e,this.channelId=t,this.targetParams=s,this.options=r;const{trackLocationFromWindow:i=!0}=r,n=i?window==null?void 0:window.location.href:void 0;this.store=new y.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},queries:{},location:n,counter:0});const{socket:o}=this.knock.client();this.socket=o,this.socketChannelTopic=`guides:${t}`,i&&this.listenForLocationChangesFromWindow(),this.startCounterInterval(),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(){const{throttleCheckInterval:e=G}=this.options;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.failIfNotAuthenticated(),this.knock.log("[Guide] Loading all eligible guides");const t=this.buildQueryParams(e==null?void 0:e.filters),s=this.formatQueryKey(t),r=this.store.state.queries[s];if(r)return r;this.store.setState(n=>({...n,queries:{...n.queries,[s]:{status:"loading"}}}));let i;try{const n=await this.knock.user.getGuides(this.channelId,t);i={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:l}=n;this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[c.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:c.byKey(o.map(k=>this.localCopy(k))),queries:{...h.queries,[s]:i}}))}catch(n){i={status:"error",error:n},this.store.setState(o=>({...o,queries:{...o.queries,[s]:i}}))}return i}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.targetParams,user_id:this.knock.userId},t=this.socket.channel(this.socketChannelTopic,e);for(const s of this.socketEventTypes)t.on(s,r=>this.handleSocketEvent(r));["closed","errored"].includes(t.state)&&t.join(),this.socketChannel=t}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);default:return}}setLocation(e){this.clearGroupStage(),this.store.setState(t=>({...t,location:e}))}selectGuides(e,t={}){if(Object.keys(e.guides).length===0)return[];this.knock.log(`[Guide] Selecting guides for: ${c.formatFilters(t)}`);const s=g(e,t);return s.size===0?(this.knock.log("[Guide] Selection returned zero result"),[]):[...s.values()]}selectGuide(e,t={}){if(Object.keys(e.guides).length===0)return;this.knock.log(`[Guide] Selecting a guide for: ${c.formatFilters(t)}`);const s=g(e,t);if(s.size===0){this.knock.log("[Guide] Selection returned zero result");return}const[r,i]=[...s][0];if(i.bypass_global_group_limit)return i;const n=c.findDefaultGroup(e.guideGroups),o=e.guideGroupDisplayLogs[c.DEFAULT_GROUP_KEY];if(!(n&&n.display_interval&&o&&c.checkIfThrottled(o,n.display_interval)))switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Addng to the group stage: ${i.key}`),this.stage.ordered[r]=i.key;return}case"patch":return this.knock.log(`[Guide] Patching the group stage: ${i.key}`),this.stage.ordered[r]=i.key,this.stage.resolved===i.key?i:void 0;case"closed":return this.stage.resolved===i.key?i:void 0}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=v}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(!(!this.stage||this.stage.status==="closed"))return this.knock.log("[Guide] Closing the current group stage"),this.ensureClearTimeout(),this.stage={...this.stage,status:"closed",resolved:this.stage.ordered.find(e=>e!==void 0),timeoutId:null},this.stage}patchClosedGroupStage(){var s;if(((s=this.stage)==null?void 0:s.status)!=="closed")return;this.knock.log("[Guide] Patching the current group stage");const{orderResolutionDuration:e=0}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.ensureClearTimeout(),this.stage={...this.stage,status:"patch",ordered:[],timeoutId:t},this.stage}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 r={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",r),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}, Step ref:${t.ref})`);const r=new Date().toISOString(),i=this.setStepMessageAttrs(e.key,t.ref,{read_at:r,interacted_at:r});if(!i)return;const n={...this.buildEngagementEventBaseParams(e,i),metadata:s};return this.knock.user.markGuideStepAs("interacted",n),i}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 r=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...r,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return this.steps.find(r=>!r.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:r,...i})=>{const n={...i,message:{...r},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_location_rules=e.activation_location_rules.map(r=>({...r,pattern:new S.URLPattern({pathname:r.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};let s=Object.fromEntries(Object.entries(t).filter(([r,i])=>i!=null));return s=s.data?{...s,data:JSON.stringify(s.data)}:s,s}formatQueryKey(e){const s=Object.keys(e).sort().map(i=>`${encodeURIComponent(i)}=${encodeURIComponent(e[i])}`).join("&"),r=p(this.knock.userId);return s?`${r}?${s}`:r}setStepMessageAttrs(e,t,s){let r;return s.archived_at&&this.clearGroupStage(),this.store.setState(i=>{const n=i.guides[e];if(!n)return i;const o=n.steps.map(h=>(h.ref!==t||(h.message={...h.message,...s},r=h),h));n.steps=o;const a={...i.guides,[n.key]:n},l=s.archived_at&&!n.bypass_global_group_limit?{...i.guideGroupDisplayLogs,[c.DEFAULT_GROUP_KEY]:s.archived_at}:i.guideGroupDisplayLogs;return{...i,guides:a,guideGroupDisplayLogs:l}}),r}buildEngagementEventBaseParams(e,t){return{message_id:t.message.id,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 r={...s.guides,[t.key]:t};return{...s,guides:r}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...r}=t.guides;return{...t,guides:r}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],r=e.guide_group.display_sequence_unthrottled||[],i=e.guide_group.display_sequence_throttled||[];let n=t.guides;return n=r.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},n),n=i.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}})}listenForLocationChangesFromWindow(){if(window!=null&&window.history){window.addEventListener("popstate",this.handleLocationChange),window.addEventListener("hashchange",this.handleLocationChange);const e=window.history.pushState,t=window.history.replaceState;window.history.pushState=new Proxy(e,{apply:(s,r,i)=>{Reflect.apply(s,r,i),setTimeout(()=>{this.handleLocationChange()},0)}}),window.history.replaceState=new Proxy(t,{apply:(s,r,i)=>{Reflect.apply(s,r,i),setTimeout(()=>{this.handleLocationChange()},0)}}),this.pushStateFn=e,this.replaceStateFn=t}else this.knock.log("[Guide] Unable to access the `window.history` object to detect location changes")}removeEventListeners(){window.removeEventListener("popstate",this.handleLocationChange),window.removeEventListener("hashchange",this.handleLocationChange),this.pushStateFn&&(window.history.pushState=this.pushStateFn,this.pushStateFn=void 0),this.replaceStateFn&&(window.history.replaceState=this.replaceStateFn,this.replaceStateFn=void 0)}}exports.KnockGuideClient=C;exports.guidesApiRootPath=p;
+"use strict";var f=Object.defineProperty;var y=(u,e,t)=>e in u?f(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>y(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("@tanstack/store"),v=require("urlpattern-polyfill"),d=require("./helpers.js"),G=50,_=30*1e3,b=3,g=()=>{if(typeof window<"u")return window},k=u=>`/v1/users/${u}/guides`,p=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;const n=s.display_sequence,i=u.location;for(const[r,o]of n.entries()){const a=u.guides[o];!a||!C(a,{location:i,filters:e})||t.set(r,a)}return t.metadata={guideGroup:s},t},C=(u,{location:e,filters:t={}})=>{if(t.type&&t.type!==u.type||t.key&&t.key!==u.key||u.steps.every(n=>!!n.message.archived_at))return!1;const s=u.activation_location_rules||[];return!(s.length>0&&e&&!s.reduce((i,r)=>{if(i===!1)return!1;switch(r.directive){case"allow":return i===!0||r.pattern.test(e)?!0:void 0;case"block":return r.pattern.test(e)?!1:i}},void 0))};class I{constructor(e,t,s={},n={}){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"]);c(this,"subscribeRetryCount",0);c(this,"pushStateFn");c(this,"replaceStateFn");c(this,"stage");c(this,"counterIntervalId");c(this,"handleLocationChange",()=>{const e=g();if(!(e!=null&&e.location))return;const t=e.location.href;this.store.state.location!==t&&(this.knock.log(`[Guide] Handle Location change: ${t}`),this.setLocation(t))});this.knock=e,this.channelId=t,this.targetParams=s,this.options=n;const{trackLocationFromWindow:i=!0}=n,r=g(),o=i?r==null?void 0:r.location.href:void 0;this.store=new S.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},queries:{},location:o,counter:0});const{socket:a}=this.knock.client();this.socket=a,this.socketChannelTopic=`guides:${t}`,i&&this.listenForLocationChangesFromWindow(),this.startCounterInterval(),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(){const{throttleCheckInterval:e=_}=this.options;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.failIfNotAuthenticated(),this.knock.log("[Guide] Loading all eligible guides");const t=this.buildQueryParams(e==null?void 0:e.filters),s=this.formatQueryKey(t),n=this.store.state.queries[s];if(n)return n;this.store.setState(r=>({...r,queries:{...r.queries,[s]:{status:"loading"}}}));let i;try{const r=await this.knock.user.getGuides(this.channelId,t);i={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:l}=r;this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:d.byKey(o.map(m=>this.localCopy(m))),queries:{...h.queries,[s]:i}}))}catch(r){i={status:"error",error:r},this.store.setState(o=>({...o,queries:{...o.queries,[s]:i}}))}return i}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.targetParams,user_id:this.knock.userId},t=this.socket.channel(this.socketChannelTopic,e);for(const s of this.socketEventTypes)t.on(s,n=>this.handleSocketEvent(n));["closed","errored"].includes(t.state)&&(this.subscribeRetryCount=0,t.join().receive("ok",()=>{this.knock.log("[Guide] Successfully joined channel")}).receive("error",s=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(s)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=t}handleChannelJoinError(){if(this.subscribeRetryCount>=b){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);default:return}}setLocation(e){this.clearGroupStage(),this.store.setState(t=>({...t,location:e}))}selectGuides(e,t={}){if(Object.keys(e.guides).length===0)return[];this.knock.log(`[Guide] Selecting guides for: ${d.formatFilters(t)}`);const s=p(e,t);return s.size===0?(this.knock.log("[Guide] Selection returned zero result"),[]):[...s.values()]}selectGuide(e,t={}){if(Object.keys(e.guides).length===0)return;this.knock.log(`[Guide] Selecting a guide for: ${d.formatFilters(t)}`);const s=p(e,t);if(s.size===0){this.knock.log("[Guide] Selection returned zero result");return}const[n,i]=[...s][0];if(i.bypass_global_group_limit)return i;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)))switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Addng to the group stage: ${i.key}`),this.stage.ordered[n]=i.key;return}case"patch":return this.knock.log(`[Guide] Patching the group stage: ${i.key}`),this.stage.ordered[n]=i.key,this.stage.resolved===i.key?i:void 0;case"closed":return this.stage.resolved===i.key?i:void 0}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=G}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(!(!this.stage||this.stage.status==="closed"))return this.knock.log("[Guide] Closing the current group stage"),this.ensureClearTimeout(),this.stage={...this.stage,status:"closed",resolved:this.stage.ordered.find(e=>e!==void 0),timeoutId:null},this.stage}patchClosedGroupStage(){var s;if(((s=this.stage)==null?void 0:s.status)!=="closed")return;this.knock.log("[Guide] Patching the current group stage");const{orderResolutionDuration:e=0}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.ensureClearTimeout(),this.stage={...this.stage,status:"patch",ordered:[],timeoutId:t},this.stage}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 n={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",n),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}, Step ref:${t.ref})`);const n=new Date().toISOString(),i=this.setStepMessageAttrs(e.key,t.ref,{read_at:n,interacted_at:n});if(!i)return;const r={...this.buildEngagementEventBaseParams(e,i),metadata:s};return this.knock.user.markGuideStepAs("interacted",r),i}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 n=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...n,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return this.steps.find(n=>!n.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:n,...i})=>{const r={...i,message:{...n},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_location_rules=e.activation_location_rules.map(n=>({...n,pattern:new v.URLPattern({pathname:n.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};let s=Object.fromEntries(Object.entries(t).filter(([n,i])=>i!=null));return s=s.data?{...s,data:JSON.stringify(s.data)}:s,s}formatQueryKey(e){const s=Object.keys(e).sort().map(i=>`${encodeURIComponent(i)}=${encodeURIComponent(e[i])}`).join("&"),n=k(this.knock.userId);return s?`${n}?${s}`:n}setStepMessageAttrs(e,t,s){let n;return s.archived_at&&this.clearGroupStage(),this.store.setState(i=>{const r=i.guides[e];if(!r)return i;const o=r.steps.map(h=>(h.ref!==t||(h.message={...h.message,...s},n=h),h));r.steps=o;const a={...i.guides,[r.key]:r},l=s.archived_at&&!r.bypass_global_group_limit?{...i.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:i.guideGroupDisplayLogs;return{...i,guides:a,guideGroupDisplayLogs:l}}),n}buildEngagementEventBaseParams(e,t){return{message_id:t.message.id,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 n={...s.guides,[t.key]:t};return{...s,guides:n}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...n}=t.guides;return{...t,guides:n}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],n=e.guide_group.display_sequence_unthrottled||[],i=e.guide_group.display_sequence_throttled||[];let r=t.guides;return r=n.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},r),r=i.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}})}listenForLocationChangesFromWindow(){const e=g();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:(n,i,r)=>{Reflect.apply(n,i,r),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(n,i,r)=>{Reflect.apply(n,i,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=g();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.KnockGuideClient=I;exports.guidesApiRootPath=k;
 //# 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  mockDefaultGroup,\n} from \"./helpers\";\nimport {\n  ConstructorOpts,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\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\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\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  for (const [index, guideKey] of displaySequence.entries()) {\n    const guide = state.guides[guideKey];\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, { location, filters });\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};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {} }: 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  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const locationRules = guide.activation_location_rules || [];\n\n  if (locationRules.length > 0 && location) {\n    const allowed = locationRules.reduce<boolean | undefined>((acc, rule) => {\n      // Any matched block rule prevails so no need to evaluate further\n      // as soon as there is one.\n      if (acc === false) return false;\n\n      // At this point we either have a matched allow rule (acc is true),\n      // or no matched rule found yet (acc is undefined).\n\n      switch (rule.directive) {\n        case \"allow\": {\n          // No need to evaluate more allow rules once we matched one\n          // since any matched allowed rule means allow.\n          if (acc === true) return true;\n\n          const matched = rule.pattern.test(location);\n          return matched ? true : undefined;\n        }\n\n        case \"block\": {\n          // Always test block rules (unless already matched to block)\n          // because they'd prevail over matched allow rules.\n          const matched = rule.pattern.test(location);\n          return matched ? false : acc;\n        }\n      }\n    }, undefined);\n\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  ];\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 { trackLocationFromWindow = true } = options;\n\n    const location = trackLocationFromWindow\n      ? window?.location.href\n      : undefined;\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\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    // Start the counter loop to increment at an interval.\n    this.startCounterInterval();\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() {\n    const {\n      throttleCheckInterval: delay = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = this.options;\n\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.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Loading all eligible guides\");\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      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.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 params = { ...this.targetParams, user_id: this.knock.userId };\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      newChannel.join();\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\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      default:\n        return;\n    }\n  }\n\n  setLocation(href: string) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => ({ ...state, location: href }));\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return [];\n    }\n    this.knock.log(`[Guide] Selecting guides for: ${formatFilters(filters)}`);\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(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return undefined;\n    }\n    this.knock.log(`[Guide] Selecting a guide for: ${formatFilters(filters)}`);\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\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) return undefined;\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        return this.stage.resolved === guide.key ? guide : undefined;\n      }\n\n      case \"closed\": {\n        return this.stage.resolved === guide.key ? guide : undefined;\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    if (!this.stage || this.stage.status === \"closed\") return;\n\n    this.knock.log(\"[Guide] Closing the current group stage\");\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    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved: this.stage.ordered.find((x) => x !== undefined),\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    if (this.stage?.status !== \"closed\") return;\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\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.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n\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        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_location_rules =\n      remoteGuide.activation_location_rules.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 = { ...this.targetParams, ...filterParams };\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      message_id: step.message.id,\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  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const href = window.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n    this.setLocation(href);\n  };\n\n  private listenForLocationChangesFromWindow() {\n    if (window?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      window.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      window.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = window.history.pushState;\n      const replaceStateFn = window.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      window.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      window.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    window.removeEventListener(\"popstate\", this.handleLocationChange);\n    window.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      window.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      window.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","guidesApiRootPath","userId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","index","guideKey","guide","predicate","s","locationRules","acc","rule","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","event","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","x","_a","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","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  mockDefaultGroup,\n} from \"./helpers\";\nimport {\n  ConstructorOpts,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\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// 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\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  for (const [index, guideKey] of displaySequence.entries()) {\n    const guide = state.guides[guideKey];\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, { location, filters });\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};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {} }: 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  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const locationRules = guide.activation_location_rules || [];\n\n  if (locationRules.length > 0 && location) {\n    const allowed = locationRules.reduce<boolean | undefined>((acc, rule) => {\n      // Any matched block rule prevails so no need to evaluate further\n      // as soon as there is one.\n      if (acc === false) return false;\n\n      // At this point we either have a matched allow rule (acc is true),\n      // or no matched rule found yet (acc is undefined).\n\n      switch (rule.directive) {\n        case \"allow\": {\n          // No need to evaluate more allow rules once we matched one\n          // since any matched allowed rule means allow.\n          if (acc === true) return true;\n\n          const matched = rule.pattern.test(location);\n          return matched ? true : undefined;\n        }\n\n        case \"block\": {\n          // Always test block rules (unless already matched to block)\n          // because they'd prevail over matched allow rules.\n          const matched = rule.pattern.test(location);\n          return matched ? false : acc;\n        }\n      }\n    }, undefined);\n\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  ];\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 { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\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    // Start the counter loop to increment at an interval.\n    this.startCounterInterval();\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() {\n    const {\n      throttleCheckInterval: delay = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = this.options;\n\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.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Loading all eligible guides\");\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      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.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 params = { ...this.targetParams, user_id: this.knock.userId };\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      default:\n        return;\n    }\n  }\n\n  setLocation(href: string) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => ({ ...state, location: href }));\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return [];\n    }\n    this.knock.log(`[Guide] Selecting guides for: ${formatFilters(filters)}`);\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(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return undefined;\n    }\n    this.knock.log(`[Guide] Selecting a guide for: ${formatFilters(filters)}`);\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\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) return undefined;\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        return this.stage.resolved === guide.key ? guide : undefined;\n      }\n\n      case \"closed\": {\n        return this.stage.resolved === guide.key ? guide : undefined;\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    if (!this.stage || this.stage.status === \"closed\") return;\n\n    this.knock.log(\"[Guide] Closing the current group stage\");\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    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved: this.stage.ordered.find((x) => x !== undefined),\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    if (this.stage?.status !== \"closed\") return;\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\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.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n\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        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_location_rules =\n      remoteGuide.activation_location_rules.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 = { ...this.targetParams, ...filterParams };\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      message_id: step.message.id,\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  // 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] Handle Location change: ${href}`);\n    this.setLocation(href);\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","checkForWindow","guidesApiRootPath","userId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","index","guideKey","guide","predicate","s","locationRules","acc","rule","KnockGuideClient","knock","channelId","targetParams","options","__publicField","win","href","trackLocationFromWindow","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","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","x","_a","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","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.16.3";
+    return "Knock/ClientJS 0.16.5";
   }
 }
 export {

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

@@ -1,79 +1,85 @@
-var f = Object.defineProperty;
-var S = (u, e, t) => e in u ? f(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
-var d = (u, e, t) => S(u, typeof e != "symbol" ? e + "" : e, t);
-import { Store as y } from "@tanstack/store";
-import { URLPattern as v } from "urlpattern-polyfill";
-import { byKey as G, mockDefaultGroup as _, formatFilters as l, findDefaultGroup as k, DEFAULT_GROUP_KEY as g, checkIfThrottled as w, SelectionResult as C } from "./helpers.mjs";
-const b = 50, I = 30 * 1e3, A = (u) => `/v1/users/${u}/guides`, p = (u, e = {}) => {
-  const t = new C(), s = k(u.guideGroups);
+var y = Object.defineProperty;
+var S = (u, e, t) => e in u ? y(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
+var c = (u, e, t) => S(u, typeof e != "symbol" ? e + "" : e, t);
+import { Store as v } from "@tanstack/store";
+import { URLPattern as G } from "urlpattern-polyfill";
+import { byKey as _, mockDefaultGroup as C, formatFilters as g, findDefaultGroup as m, DEFAULT_GROUP_KEY as p, checkIfThrottled as b, SelectionResult as I } from "./helpers.mjs";
+const A = 50, E = 30 * 1e3, L = 3, l = () => {
+  if (typeof window < "u")
+    return window;
+}, R = (u) => `/v1/users/${u}/guides`, k = (u, e = {}) => {
+  const t = new I(), s = m(u.guideGroups);
   if (!s) return t;
-  const r = s.display_sequence, i = u.location;
-  for (const [n, o] of r.entries()) {
+  const n = s.display_sequence, i = u.location;
+  for (const [r, o] of n.entries()) {
     const a = u.guides[o];
-    !a || !L(a, { location: i, filters: e }) || t.set(n, a);
+    !a || !T(a, { location: i, filters: e }) || t.set(r, a);
   }
   return t.metadata = { guideGroup: s }, t;
-}, L = (u, { location: e, filters: t = {} }) => {
-  if (t.type && t.type !== u.type || t.key && t.key !== u.key || u.steps.every((r) => !!r.message.archived_at))
+}, T = (u, { location: e, filters: t = {} }) => {
+  if (t.type && t.type !== u.type || t.key && t.key !== u.key || u.steps.every((n) => !!n.message.archived_at))
     return !1;
   const s = u.activation_location_rules || [];
-  return !(s.length > 0 && e && !s.reduce((i, n) => {
+  return !(s.length > 0 && e && !s.reduce((i, r) => {
     if (i === !1) return !1;
-    switch (n.directive) {
+    switch (r.directive) {
       case "allow":
-        return i === !0 || n.pattern.test(e) ? !0 : void 0;
+        return i === !0 || r.pattern.test(e) ? !0 : void 0;
       case "block":
-        return n.pattern.test(e) ? !1 : i;
+        return r.pattern.test(e) ? !1 : i;
     }
   }, void 0));
 };
-class F {
-  constructor(e, t, s = {}, r = {}) {
-    d(this, "store");
+class $ {
+  constructor(e, t, s = {}, n = {}) {
+    c(this, "store");
     // Phoenix channels for real time guide updates over websocket
-    d(this, "socket");
-    d(this, "socketChannel");
-    d(this, "socketChannelTopic");
-    d(this, "socketEventTypes", [
+    c(this, "socket");
+    c(this, "socketChannel");
+    c(this, "socketChannelTopic");
+    c(this, "socketEventTypes", [
       "guide.added",
       "guide.updated",
       "guide.removed",
       "guide_group.added",
       "guide_group.updated"
     ]);
+    c(this, "subscribeRetryCount", 0);
     // Original history methods to monkey patch, or restore in cleanups.
-    d(this, "pushStateFn");
-    d(this, "replaceStateFn");
+    c(this, "pushStateFn");
+    c(this, "replaceStateFn");
     // Guides that are competing to render are "staged" first without rendering
     // and ranked based on its relative order in the group over a duration of time
     // to resolve and render the prevailing one.
-    d(this, "stage");
-    d(this, "counterIntervalId");
+    c(this, "stage");
+    c(this, "counterIntervalId");
     // Define as an arrow func property to always bind this to the class instance.
-    d(this, "handleLocationChange", () => {
-      const e = window.location.href;
-      this.store.state.location !== e && (this.knock.log(`[Guide] Handle Location change: ${e}`), this.setLocation(e));
+    c(this, "handleLocationChange", () => {
+      const e = l();
+      if (!(e != null && e.location)) return;
+      const t = e.location.href;
+      this.store.state.location !== t && (this.knock.log(`[Guide] Handle Location change: ${t}`), this.setLocation(t));
     });
-    this.knock = e, this.channelId = t, this.targetParams = s, this.options = r;
-    const { trackLocationFromWindow: i = !0 } = r, n = i ? window == null ? void 0 : window.location.href : void 0;
-    this.store = new y({
+    this.knock = e, this.channelId = t, this.targetParams = s, this.options = n;
+    const { trackLocationFromWindow: i = !0 } = n, r = l(), o = i ? r == null ? void 0 : r.location.href : void 0;
+    this.store = new v({
       guideGroups: [],
       guideGroupDisplayLogs: {},
       guides: {},
       queries: {},
-      location: n,
+      location: o,
       // Increment to update the state store and trigger re-selection.
       counter: 0
     });
-    const { socket: o } = this.knock.client();
-    this.socket = o, this.socketChannelTopic = `guides:${t}`, i && this.listenForLocationChangesFromWindow(), this.startCounterInterval(), this.knock.log("[Guide] Initialized a guide client");
+    const { socket: a } = this.knock.client();
+    this.socket = a, this.socketChannelTopic = `guides:${t}`, i && this.listenForLocationChangesFromWindow(), this.startCounterInterval(), 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() {
     const {
-      throttleCheckInterval: e = I
+      throttleCheckInterval: e = E
     } = this.options;
     this.counterIntervalId = setInterval(() => {
       this.knock.log("[Guide] Counter interval tick"), !(this.stage && this.stage.status !== "closed") && this.incrementCounter();
@@ -87,27 +93,27 @@ class F {
   }
   async fetch(e) {
     this.knock.failIfNotAuthenticated(), this.knock.log("[Guide] Loading all eligible guides");
-    const t = this.buildQueryParams(e == null ? void 0 : e.filters), s = this.formatQueryKey(t), r = this.store.state.queries[s];
-    if (r)
-      return r;
-    this.store.setState((n) => ({
-      ...n,
-      queries: { ...n.queries, [s]: { status: "loading" } }
+    const t = this.buildQueryParams(e == null ? void 0 : e.filters), s = this.formatQueryKey(t), n = this.store.state.queries[s];
+    if (n)
+      return n;
+    this.store.setState((r) => ({
+      ...r,
+      queries: { ...r.queries, [s]: { status: "loading" } }
     }));
     let i;
     try {
-      const n = await this.knock.user.getGuides(this.channelId, t);
+      const r = await this.knock.user.getGuides(this.channelId, t);
       i = { status: "ok" };
-      const { entries: o, guide_groups: a, guide_group_display_logs: h } = n;
-      this.store.setState((c) => ({
-        ...c,
-        guideGroups: (a == null ? void 0 : a.length) > 0 ? a : [_(o)],
+      const { entries: o, guide_groups: a, guide_group_display_logs: h } = r;
+      this.store.setState((d) => ({
+        ...d,
+        guideGroups: (a == null ? void 0 : a.length) > 0 ? a : [C(o)],
         guideGroupDisplayLogs: h || {},
-        guides: G(o.map((m) => this.localCopy(m))),
-        queries: { ...c.queries, [s]: i }
+        guides: _(o.map((f) => this.localCopy(f))),
+        queries: { ...d.queries, [s]: i }
       }));
-    } catch (n) {
-      i = { status: "error", error: n }, this.store.setState((o) => ({
+    } catch (r) {
+      i = { status: "error", error: r }, this.store.setState((o) => ({
         ...o,
         queries: { ...o.queries, [s]: i }
       }));
@@ -119,8 +125,25 @@ class F {
     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.targetParams, user_id: this.knock.userId }, t = this.socket.channel(this.socketChannelTopic, e);
     for (const s of this.socketEventTypes)
-      t.on(s, (r) => this.handleSocketEvent(r));
-    ["closed", "errored"].includes(t.state) && t.join(), this.socketChannel = t;
+      t.on(s, (n) => this.handleSocketEvent(n));
+    ["closed", "errored"].includes(t.state) && (this.subscribeRetryCount = 0, t.join().receive("ok", () => {
+      this.knock.log("[Guide] Successfully joined channel");
+    }).receive("error", (s) => {
+      this.knock.log(
+        `[Guide] Failed to join channel: ${JSON.stringify(s)}`
+      ), this.handleChannelJoinError();
+    }).receive("timeout", () => {
+      this.knock.log("[Guide] Channel join timed out"), this.handleChannelJoinError();
+    })), this.socketChannel = t;
+  }
+  handleChannelJoinError() {
+    if (this.subscribeRetryCount >= L) {
+      this.knock.log(
+        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`
+      ), this.unsubscribe();
+      return;
+    }
+    this.subscribeRetryCount++;
   }
   unsubscribe() {
     if (this.socketChannel) {
@@ -155,34 +178,34 @@ class F {
   selectGuides(e, t = {}) {
     if (Object.keys(e.guides).length === 0)
       return [];
-    this.knock.log(`[Guide] Selecting guides for: ${l(t)}`);
-    const s = p(e, t);
+    this.knock.log(`[Guide] Selecting guides for: ${g(t)}`);
+    const s = k(e, t);
     return s.size === 0 ? (this.knock.log("[Guide] Selection returned zero result"), []) : [...s.values()];
   }
   selectGuide(e, t = {}) {
     if (Object.keys(e.guides).length === 0)
       return;
-    this.knock.log(`[Guide] Selecting a guide for: ${l(t)}`);
-    const s = p(e, t);
+    this.knock.log(`[Guide] Selecting a guide for: ${g(t)}`);
+    const s = k(e, t);
     if (s.size === 0) {
       this.knock.log("[Guide] Selection returned zero result");
       return;
     }
-    const [r, i] = [...s][0];
+    const [n, i] = [...s][0];
     if (i.bypass_global_group_limit)
       return i;
-    const n = k(e.guideGroups), o = e.guideGroupDisplayLogs[g];
-    if (!(n && n.display_interval && o && w(
+    const r = m(e.guideGroups), o = e.guideGroupDisplayLogs[p];
+    if (!(r && r.display_interval && o && b(
       o,
-      n.display_interval
+      r.display_interval
     )))
       switch (this.stage || (this.stage = this.openGroupStage()), this.stage.status) {
         case "open": {
-          this.knock.log(`[Guide] Addng to the group stage: ${i.key}`), this.stage.ordered[r] = i.key;
+          this.knock.log(`[Guide] Addng to the group stage: ${i.key}`), this.stage.ordered[n] = i.key;
           return;
         }
         case "patch":
-          return this.knock.log(`[Guide] Patching the group stage: ${i.key}`), this.stage.ordered[r] = i.key, this.stage.resolved === i.key ? i : void 0;
+          return this.knock.log(`[Guide] Patching the group stage: ${i.key}`), this.stage.ordered[n] = i.key, this.stage.resolved === i.key ? i : void 0;
         case "closed":
           return this.stage.resolved === i.key ? i : void 0;
       }
@@ -190,7 +213,7 @@ class F {
   openGroupStage() {
     this.knock.log("[Guide] Opening a new group stage");
     const {
-      orderResolutionDuration: e = b
+      orderResolutionDuration: e = A
     } = this.options, t = setTimeout(() => {
       this.closePendingGroupStage(), this.incrementCounter();
     }, e);
@@ -257,7 +280,7 @@ class F {
       seen_at: (/* @__PURE__ */ new Date()).toISOString()
     });
     if (!s) return;
-    const r = {
+    const n = {
       ...this.buildEngagementEventBaseParams(e, s),
       content: s.content,
       data: this.targetParams.data,
@@ -265,23 +288,23 @@ class F {
     };
     return this.knock.user.markGuideStepAs(
       "seen",
-      r
+      n
     ), s;
   }
   async markAsInteracted(e, t, s) {
     this.knock.log(
       `[Guide] Marking as interacted (Guide key: ${e.key}, Step ref:${t.ref})`
     );
-    const r = (/* @__PURE__ */ new Date()).toISOString(), i = this.setStepMessageAttrs(e.key, t.ref, {
-      read_at: r,
-      interacted_at: r
+    const n = (/* @__PURE__ */ new Date()).toISOString(), i = this.setStepMessageAttrs(e.key, t.ref, {
+      read_at: n,
+      interacted_at: n
     });
     if (!i) return;
-    const n = {
+    const r = {
       ...this.buildEngagementEventBaseParams(e, i),
       metadata: s
     };
-    return this.knock.user.markGuideStepAs("interacted", n), i;
+    return this.knock.user.markGuideStepAs("interacted", r), i;
   }
   async markAsArchived(e, t) {
     if (t.message.archived_at) return;
@@ -292,11 +315,11 @@ class F {
       archived_at: (/* @__PURE__ */ new Date()).toISOString()
     });
     if (!s) return;
-    const r = this.buildEngagementEventBaseParams(e, s);
+    const n = this.buildEngagementEventBaseParams(e, s);
     return this.knock.user.markGuideStepAs(
       "archived",
       {
-        ...r,
+        ...n,
         unthrottled: e.bypass_global_group_limit
       }
     ), s;
@@ -309,13 +332,13 @@ class F {
       ...e,
       // Get the next unarchived step.
       getStep() {
-        return this.steps.find((r) => !r.message.archived_at);
+        return this.steps.find((n) => !n.message.archived_at);
       }
     };
-    return s.getStep = s.getStep.bind(s), s.steps = e.steps.map(({ message: r, ...i }) => {
-      const n = {
+    return s.getStep = s.getStep.bind(s), s.steps = e.steps.map(({ message: n, ...i }) => {
+      const r = {
         ...i,
-        message: { ...r },
+        message: { ...n },
         markAsSeen() {
           if (!this.message.seen_at)
             return t.markAsSeen(s, this);
@@ -328,17 +351,17 @@ class F {
             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_location_rules = e.activation_location_rules.map((r) => ({
-      ...r,
-      pattern: new v({ pathname: r.pathname })
+      return r.markAsSeen = r.markAsSeen.bind(r), r.markAsInteracted = r.markAsInteracted.bind(r), r.markAsArchived = r.markAsArchived.bind(r), r;
+    }), s.activation_location_rules = e.activation_location_rules.map((n) => ({
+      ...n,
+      pattern: new G({ pathname: n.pathname })
     })), s;
   }
   buildQueryParams(e = {}) {
     const t = { ...this.targetParams, ...e };
     let s = Object.fromEntries(
       Object.entries(t).filter(
-        ([r, i]) => i != null
+        ([n, i]) => i != null
       )
     );
     return s = s.data ? { ...s, data: JSON.stringify(s.data) } : s, s;
@@ -346,22 +369,22 @@ class F {
   formatQueryKey(e) {
     const s = Object.keys(e).sort().map(
       (i) => `${encodeURIComponent(i)}=${encodeURIComponent(e[i])}`
-    ).join("&"), r = A(this.knock.userId);
-    return s ? `${r}?${s}` : r;
+    ).join("&"), n = R(this.knock.userId);
+    return s ? `${n}?${s}` : n;
   }
   setStepMessageAttrs(e, t, s) {
-    let r;
+    let n;
     return s.archived_at && this.clearGroupStage(), this.store.setState((i) => {
-      const n = i.guides[e];
-      if (!n) return i;
-      const o = n.steps.map((c) => (c.ref !== t || (c.message = { ...c.message, ...s }, r = c), c));
-      n.steps = o;
-      const a = { ...i.guides, [n.key]: n }, h = s.archived_at && !n.bypass_global_group_limit ? {
+      const r = i.guides[e];
+      if (!r) return i;
+      const o = r.steps.map((d) => (d.ref !== t || (d.message = { ...d.message, ...s }, n = d), d));
+      r.steps = o;
+      const a = { ...i.guides, [r.key]: r }, h = s.archived_at && !r.bypass_global_group_limit ? {
         ...i.guideGroupDisplayLogs,
-        [g]: s.archived_at
+        [p]: s.archived_at
       } : i.guideGroupDisplayLogs;
       return { ...i, guides: a, guideGroupDisplayLogs: h };
-    }), r;
+    }), n;
   }
   buildEngagementEventBaseParams(e, t) {
     return {
@@ -376,61 +399,63 @@ class F {
     this.patchClosedGroupStage();
     const t = this.localCopy(e.guide);
     this.store.setState((s) => {
-      const r = { ...s.guides, [t.key]: t };
-      return { ...s, guides: r };
+      const n = { ...s.guides, [t.key]: t };
+      return { ...s, guides: n };
     });
   }
   removeGuide({ data: e }) {
     this.patchClosedGroupStage(), this.store.setState((t) => {
-      const { [e.guide.key]: s, ...r } = t.guides;
-      return { ...t, guides: r };
+      const { [e.guide.key]: s, ...n } = t.guides;
+      return { ...t, guides: n };
     });
   }
   addOrReplaceGuideGroup({
     data: e
   }) {
     this.patchClosedGroupStage(), this.store.setState((t) => {
-      const s = [e.guide_group], r = e.guide_group.display_sequence_unthrottled || [], i = e.guide_group.display_sequence_throttled || [];
-      let n = t.guides;
-      return n = r.reduce((o, a) => {
+      const s = [e.guide_group], n = e.guide_group.display_sequence_unthrottled || [], i = e.guide_group.display_sequence_throttled || [];
+      let r = t.guides;
+      return r = n.reduce((o, a) => {
         if (!o[a]) return o;
         const h = { ...o[a], bypass_global_group_limit: !0 };
         return { ...o, [a]: h };
-      }, n), n = i.reduce((o, a) => {
+      }, r), r = i.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 };
     });
   }
   listenForLocationChangesFromWindow() {
-    if (window != null && window.history) {
-      window.addEventListener("popstate", this.handleLocationChange), window.addEventListener("hashchange", this.handleLocationChange);
-      const e = window.history.pushState, t = window.history.replaceState;
-      window.history.pushState = new Proxy(e, {
-        apply: (s, r, i) => {
-          Reflect.apply(s, r, i), setTimeout(() => {
+    const e = l();
+    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: (n, i, r) => {
+          Reflect.apply(n, i, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
-      }), window.history.replaceState = new Proxy(t, {
-        apply: (s, r, i) => {
-          Reflect.apply(s, r, i), setTimeout(() => {
+      }), e.history.replaceState = new Proxy(s, {
+        apply: (n, i, r) => {
+          Reflect.apply(n, i, r), setTimeout(() => {
             this.handleLocationChange();
           }, 0);
         }
-      }), this.pushStateFn = e, this.replaceStateFn = t;
+      }), this.pushStateFn = t, this.replaceStateFn = s;
     } else
       this.knock.log(
         "[Guide] Unable to access the `window.history` object to detect location changes"
       );
   }
   removeEventListeners() {
-    window.removeEventListener("popstate", this.handleLocationChange), window.removeEventListener("hashchange", this.handleLocationChange), this.pushStateFn && (window.history.pushState = this.pushStateFn, this.pushStateFn = void 0), this.replaceStateFn && (window.history.replaceState = this.replaceStateFn, this.replaceStateFn = void 0);
+    const e = l();
+    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));
   }
 }
 export {
-  F as KnockGuideClient,
-  A as guidesApiRootPath
+  $ as KnockGuideClient,
+  R as guidesApiRootPath
 };
 //# sourceMappingURL=client.mjs.map

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  mockDefaultGroup,\n} from \"./helpers\";\nimport {\n  ConstructorOpts,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\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\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\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  for (const [index, guideKey] of displaySequence.entries()) {\n    const guide = state.guides[guideKey];\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, { location, filters });\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};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {} }: 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  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const locationRules = guide.activation_location_rules || [];\n\n  if (locationRules.length > 0 && location) {\n    const allowed = locationRules.reduce<boolean | undefined>((acc, rule) => {\n      // Any matched block rule prevails so no need to evaluate further\n      // as soon as there is one.\n      if (acc === false) return false;\n\n      // At this point we either have a matched allow rule (acc is true),\n      // or no matched rule found yet (acc is undefined).\n\n      switch (rule.directive) {\n        case \"allow\": {\n          // No need to evaluate more allow rules once we matched one\n          // since any matched allowed rule means allow.\n          if (acc === true) return true;\n\n          const matched = rule.pattern.test(location);\n          return matched ? true : undefined;\n        }\n\n        case \"block\": {\n          // Always test block rules (unless already matched to block)\n          // because they'd prevail over matched allow rules.\n          const matched = rule.pattern.test(location);\n          return matched ? false : acc;\n        }\n      }\n    }, undefined);\n\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  ];\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 { trackLocationFromWindow = true } = options;\n\n    const location = trackLocationFromWindow\n      ? window?.location.href\n      : undefined;\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\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    // Start the counter loop to increment at an interval.\n    this.startCounterInterval();\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() {\n    const {\n      throttleCheckInterval: delay = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = this.options;\n\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.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Loading all eligible guides\");\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      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.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 params = { ...this.targetParams, user_id: this.knock.userId };\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      newChannel.join();\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\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      default:\n        return;\n    }\n  }\n\n  setLocation(href: string) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => ({ ...state, location: href }));\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return [];\n    }\n    this.knock.log(`[Guide] Selecting guides for: ${formatFilters(filters)}`);\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(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return undefined;\n    }\n    this.knock.log(`[Guide] Selecting a guide for: ${formatFilters(filters)}`);\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\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) return undefined;\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        return this.stage.resolved === guide.key ? guide : undefined;\n      }\n\n      case \"closed\": {\n        return this.stage.resolved === guide.key ? guide : undefined;\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    if (!this.stage || this.stage.status === \"closed\") return;\n\n    this.knock.log(\"[Guide] Closing the current group stage\");\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    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved: this.stage.ordered.find((x) => x !== undefined),\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    if (this.stage?.status !== \"closed\") return;\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\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.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n\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        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_location_rules =\n      remoteGuide.activation_location_rules.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 = { ...this.targetParams, ...filterParams };\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      message_id: step.message.id,\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  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const href = window.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n    this.setLocation(href);\n  };\n\n  private listenForLocationChangesFromWindow() {\n    if (window?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      window.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      window.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = window.history.pushState;\n      const replaceStateFn = window.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      window.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      window.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    window.removeEventListener(\"popstate\", this.handleLocationChange);\n    window.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      window.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      window.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","guidesApiRootPath","userId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","index","guideKey","guide","predicate","s","locationRules","acc","rule","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","event","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","x","_a","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","pushStateFn","replaceStateFn","target","history","args"],"mappings":";;;;;;AA6CA,MAAMA,IAAoC,IAIpCC,IAAqC,KAAK,KAEnCC,IAAoB,CAACC,MAChC,aAAaA,CAAM,WAEfC,IAAS,CAACC,GAAmBC,IAA8B,OAAO;AAEhE,QAAAC,IAAS,IAAIC,EAAgB,GAE7BC,IAAeC,EAAiBL,EAAM,WAAW;AACnD,MAAA,CAACI,EAAqB,QAAAF;AAE1B,QAAMI,IAAkBF,EAAa,kBAC/BG,IAAWP,EAAM;AAEvB,aAAW,CAACQ,GAAOC,CAAQ,KAAKH,EAAgB,WAAW;AACnD,UAAAI,IAAQV,EAAM,OAAOS,CAAQ;AAInC,IAHI,CAACC,KAGD,CADaC,EAAUD,GAAO,EAAE,UAAAH,GAAU,SAAAN,GAAS,KAGhDC,EAAA,IAAIM,GAAOE,CAAK;AAAA,EAAA;AAGlB,SAAAR,EAAA,WAAW,EAAE,YAAYE,EAAa,GACtCF;AACT,GAOMS,IAAY,CAChBD,GACA,EAAE,UAAAH,GAAU,SAAAN,IAAU,SACnB;AASC,MARAA,EAAQ,QAAQA,EAAQ,SAASS,EAAM,QAIvCT,EAAQ,OAAOA,EAAQ,QAAQS,EAAM,OAIrCA,EAAM,MAAM,MAAM,CAACE,MAAM,CAAC,CAACA,EAAE,QAAQ,WAAW;AAC3C,WAAA;AAGH,QAAAC,IAAgBH,EAAM,6BAA6B,CAAC;AAEtD,SAAA,EAAAG,EAAc,SAAS,KAAKN,KA4B1B,CA3BYM,EAAc,OAA4B,CAACC,GAAKC,MAAS;AAGnE,QAAAD,MAAQ,GAAc,QAAA;AAK1B,YAAQC,EAAK,WAAW;AAAA,MACtB,KAAK;AAGC,eAAAD,MAAQ,MAEIC,EAAK,QAAQ,KAAKR,CAAQ,IAFjB,KAGD;AAAA,MAG1B,KAAK;AAIH,eADgBQ,EAAK,QAAQ,KAAKR,CAAQ,IACzB,KAAQO;AAAA,IAC3B;AAAA,KAED,MAAS;AAMhB;AAEO,MAAME,EAAiB;AAAA,EA0B5B,YACWC,GACAC,GACAC,IAA6B,CAC7B,GAAAC,IAA2B,IACpC;AA9BK,IAAAC,EAAA;AAGC;AAAA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA,0BAAmB;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGQ;AAAA,IAAAA,EAAA;AACA,IAAAA,EAAA;AAKA;AAAA;AAAA;AAAA,IAAAA,EAAA;AAEA,IAAAA,EAAA;AA8rBA;AAAA,IAAAA,EAAA,8BAAuB,MAAM;AAC7B,YAAAC,IAAO,OAAO,SAAS;AAC7B,MAAI,KAAK,MAAM,MAAM,aAAaA,MAElC,KAAK,MAAM,IAAI,mCAAmCA,CAAI,EAAE,GACxD,KAAK,YAAYA,CAAI;AAAA,IACvB;AAjsBW,SAAA,QAAAL,GACA,KAAA,YAAAC,GACA,KAAA,eAAAC,GACA,KAAA,UAAAC;AAEH,UAAA,EAAE,yBAAAG,IAA0B,GAAA,IAASH,GAErCb,IAAWgB,IACb,iCAAQ,SAAS,OACjB;AAEC,SAAA,QAAQ,IAAIC,EAAkB;AAAA,MACjC,aAAa,CAAC;AAAA,MACd,uBAAuB,CAAC;AAAA,MACxB,QAAQ,CAAC;AAAA,MACT,SAAS,CAAC;AAAA,MACV,UAAAjB;AAAA;AAAA,MAEA,SAAS;AAAA,IAAA,CACV;AAGD,UAAM,EAAE,QAAQkB,EAAA,IAAgB,KAAK,MAAM,OAAO;AAClD,SAAK,SAASA,GACT,KAAA,qBAAqB,UAAUP,CAAS,IAEzCK,KACF,KAAK,mCAAmC,GAI1C,KAAK,qBAAqB,GAErB,KAAA,MAAM,IAAI,oCAAoC;AAAA,EAAA;AAAA,EAG7C,mBAAmB;AACpB,SAAA,MAAM,IAAI,kCAAkC,GAC5C,KAAA,MAAM,SAAS,CAACvB,OAAW,EAAE,GAAGA,GAAO,SAASA,EAAM,UAAU,EAAI,EAAA;AAAA,EAAA;AAAA,EAGnE,uBAAuB;AACvB,UAAA;AAAA,MACJ,uBAAuB0B,IAAQ9B;AAAA,QAC7B,KAAK;AAEJ,SAAA,oBAAoB,YAAY,MAAM;AAEzC,MADK,KAAA,MAAM,IAAI,+BAA+B,GAC1C,OAAK,SAAS,KAAK,MAAM,WAAW,aAExC,KAAK,iBAAiB;AAAA,OACrB8B,CAAK;AAAA,EAAA;AAAA,EAGF,uBAAuB;AAC7B,IAAI,KAAK,sBACP,cAAc,KAAK,iBAAiB,GACpC,KAAK,oBAAoB;AAAA,EAC3B;AAAA,EAGF,UAAU;AACR,SAAK,YAAY,GACjB,KAAK,qBAAqB,GAC1B,KAAK,gBAAgB,GACrB,KAAK,qBAAqB;AAAA,EAAA;AAAA,EAG5B,MAAM,MAAMC,GAAwC;AAClD,SAAK,MAAM,uBAAuB,GAC7B,KAAA,MAAM,IAAI,qCAAqC;AAEpD,UAAMC,IAAc,KAAK,iBAAiBD,KAAA,gBAAAA,EAAM,OAAO,GACjDE,IAAW,KAAK,eAAeD,CAAW,GAG1CE,IAAmB,KAAK,MAAM,MAAM,QAAQD,CAAQ;AAC1D,QAAIC;AACK,aAAAA;AAIJ,SAAA,MAAM,SAAS,CAAC9B,OAAW;AAAA,MAC9B,GAAGA;AAAA,MACH,SAAS,EAAE,GAAGA,EAAM,SAAS,CAAC6B,CAAQ,GAAG,EAAE,QAAQ,UAAY,EAAA;AAAA,IAAA,EAC/D;AAEE,QAAAE;AACA,QAAA;AACI,YAAAC,IAAO,MAAM,KAAK,MAAM,KAAK,UAGjC,KAAK,WAAWJ,CAAW;AACf,MAAAG,IAAA,EAAE,QAAQ,KAAK;AAE7B,YAAM,EAAE,SAAAE,GAAS,cAAcC,GAAQ,0BAAAC,EAA6B,IAAAH;AAE/D,WAAA,MAAM,SAAS,CAAChC,OAAW;AAAA,QAC9B,GAAGA;AAAA,QACH,cAAakC,KAAA,gBAAAA,EAAQ,UAAS,IAAIA,IAAS,CAACE,EAAiBH,CAAO,CAAC;AAAA,QACrE,uBAAuBE,KAA4B,CAAC;AAAA,QACpD,QAAQE,EAAMJ,EAAQ,IAAI,CAACK,MAAM,KAAK,UAAUA,CAAC,CAAC,CAAC;AAAA,QACnD,SAAS,EAAE,GAAGtC,EAAM,SAAS,CAAC6B,CAAQ,GAAGE,EAAY;AAAA,MAAA,EACrD;AAAA,aACKQ,GAAG;AACV,MAAAR,IAAc,EAAE,QAAQ,SAAS,OAAOQ,EAAW,GAE9C,KAAA,MAAM,SAAS,CAACvC,OAAW;AAAA,QAC9B,GAAGA;AAAA,QACH,SAAS,EAAE,GAAGA,EAAM,SAAS,CAAC6B,CAAQ,GAAGE,EAAY;AAAA,MAAA,EACrD;AAAA,IAAA;AAGG,WAAAA;AAAA,EAAA;AAAA,EAGT,YAAY;AACN,QAAA,CAAC,KAAK,OAAQ;AAClB,SAAK,MAAM,uBAAuB,GAC7B,KAAA,MAAM,IAAI,0CAA0C,GAGpD,KAAK,OAAO,iBACf,KAAK,OAAO,QAAQ,GAIlB,KAAK,iBACP,KAAK,YAAY;AAIb,UAAAS,IAAS,EAAE,GAAG,KAAK,cAAc,SAAS,KAAK,MAAM,OAAO,GAC5DC,IAAa,KAAK,OAAO,QAAQ,KAAK,oBAAoBD,CAAM;AAE3D,eAAAE,KAAa,KAAK;AAC3B,MAAAD,EAAW,GAAGC,GAAW,CAACC,MAAY,KAAK,kBAAkBA,CAAO,CAAC;AAGvE,IAAI,CAAC,UAAU,SAAS,EAAE,SAASF,EAAW,KAAK,KACjDA,EAAW,KAAK,GAIlB,KAAK,gBAAgBA;AAAA,EAAA;AAAA,EAGvB,cAAc;AACR,QAAC,KAAK,eACL;AAAA,WAAA,MAAM,IAAI,8CAA8C;AAGlD,iBAAAC,KAAa,KAAK;AACtB,aAAA,cAAc,IAAIA,CAAS;AAElC,WAAK,cAAc,MAAM,GAGzB,KAAK,gBAAgB;AAAA;AAAA,EAAA;AAAA,EAGf,kBAAkBC,GAA2B;AAC7C,UAAA,EAAE,OAAAC,GAAO,MAAAZ,EAAA,IAASW;AAExB,YAAQC,GAAO;AAAA,MACb,KAAK;AACI,eAAA,KAAK,kBAAkBD,CAAO;AAAA,MAEvC,KAAK;AACI,eAAAX,EAAK,WACR,KAAK,kBAAkBW,CAAO,IAC9B,KAAK,YAAYA,CAAO;AAAA,MAE9B,KAAK;AACI,eAAA,KAAK,YAAYA,CAAO;AAAA,MAEjC,KAAK;AAAA,MACL,KAAK;AACI,eAAA,KAAK,uBAAuBA,CAAO;AAAA,MAE5C;AACE;AAAA,IAAA;AAAA,EACJ;AAAA,EAGF,YAAYrB,GAAc;AAExB,SAAK,gBAAgB,GAEhB,KAAA,MAAM,SAAS,CAACtB,OAAW,EAAE,GAAGA,GAAO,UAAUsB,EAAA,EAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAO/D,aAAatB,GAAmBC,IAA8B,IAAI;AAChE,QAAI,OAAO,KAAKD,EAAM,MAAM,EAAE,WAAW;AACvC,aAAO,CAAC;AAEV,SAAK,MAAM,IAAI,iCAAiC6C,EAAc5C,CAAO,CAAC,EAAE;AAElE,UAAAC,IAASH,EAAOC,GAAOC,CAAO;AAEhC,WAAAC,EAAO,SAAS,KACb,KAAA,MAAM,IAAI,wCAAwC,GAChD,CAAC,KAMH,CAAC,GAAGA,EAAO,QAAQ;AAAA,EAAA;AAAA,EAG5B,YAAYF,GAAmBC,IAA8B,IAAI;AAC/D,QAAI,OAAO,KAAKD,EAAM,MAAM,EAAE,WAAW;AAChC;AAET,SAAK,MAAM,IAAI,kCAAkC6C,EAAc5C,CAAO,CAAC,EAAE;AAEnE,UAAAC,IAASH,EAAOC,GAAOC,CAAO;AAEhC,QAAAC,EAAO,SAAS,GAAG;AAChB,WAAA,MAAM,IAAI,wCAAwC;AAChD;AAAA,IAAA;AAGH,UAAA,CAACM,GAAOE,CAAK,IAAI,CAAC,GAAGR,CAAM,EAAE,CAAC;AAIpC,QAAIQ,EAAM;AACD,aAAAA;AAKH,UAAAN,IAAeC,EAAiBL,EAAM,WAAW,GACjD8C,IACJ9C,EAAM,sBAAsB+C,CAAiB;AAG7C,QAAA,EAAA3C,KACAA,EAAa,oBACb0C,KAEkBE;AAAA,MAChBF;AAAA,MACA1C,EAAa;AAAA,IACf;AAqCM,cAJH,KAAK,UACH,KAAA,QAAQ,KAAK,eAAe,IAG3B,KAAK,MAAM,QAAQ;AAAA,QACzB,KAAK,QAAQ;AACX,eAAK,MAAM,IAAI,qCAAqCM,EAAM,GAAG,EAAE,GAC/D,KAAK,MAAM,QAAQF,CAAK,IAAIE,EAAM;AAC3B;AAAA,QAAA;AAAA,QAGT,KAAK;AACH,sBAAK,MAAM,IAAI,qCAAqCA,EAAM,GAAG,EAAE,GAC/D,KAAK,MAAM,QAAQF,CAAK,IAAIE,EAAM,KAC3B,KAAK,MAAM,aAAaA,EAAM,MAAMA,IAAQ;AAAA,QAGrD,KAAK;AACH,iBAAO,KAAK,MAAM,aAAaA,EAAM,MAAMA,IAAQ;AAAA,MACrD;AAAA,EACF;AAAA,EAGM,iBAAiB;AAClB,SAAA,MAAM,IAAI,mCAAmC;AAE5C,UAAA;AAAA,MACJ,yBAAyBgB,IAAQ/B;AAAA,QAC/B,KAAK,SAEHsD,IAAY,WAAW,MAAM;AACjC,WAAK,uBAAuB,GAC5B,KAAK,iBAAiB;AAAA,OACrBvB,CAAK;AAER,gBAAK,QAAQ;AAAA,MACX,QAAQ;AAAA,MACR,SAAS,CAAC;AAAA,MACV,WAAAuB;AAAA,IACF,GAEO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA,EAKN,yBAAyB;AAC/B,QAAI,GAAC,KAAK,SAAS,KAAK,MAAM,WAAW;AAEpC,kBAAA,MAAM,IAAI,yCAAyC,GAIxD,KAAK,mBAAmB,GAExB,KAAK,QAAQ;AAAA,QACX,GAAG,KAAK;AAAA,QACR,QAAQ;AAAA,QACR,UAAU,KAAK,MAAM,QAAQ,KAAK,CAACC,MAAMA,MAAM,MAAS;AAAA,QACxD,WAAW;AAAA,MACb,GAEO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQN,wBAAwB;;AAC1B,UAAAC,IAAA,KAAK,UAAL,gBAAAA,EAAY,YAAW,SAAU;AAEhC,SAAA,MAAM,IAAI,0CAA0C;AAEzD,UAAM,EAAE,yBAAyBzB,IAAQ,MAAM,KAAK,SAE9CuB,IAAY,WAAW,MAAM;AACjC,WAAK,uBAAuB,GAC5B,KAAK,iBAAiB;AAAA,OACrBvB,CAAK;AAGR,gBAAK,mBAAmB,GAExB,KAAK,QAAQ;AAAA,MACX,GAAG,KAAK;AAAA,MACR,QAAQ;AAAA,MACR,SAAS,CAAC;AAAA,MACV,WAAAuB;AAAA,IACF,GAEO,KAAK;AAAA,EAAA;AAAA,EAGN,kBAAkB;AACpB,IAAC,KAAK,UAEL,KAAA,MAAM,IAAI,0CAA0C,GAEzD,KAAK,mBAAmB,GACxB,KAAK,QAAQ;AAAA,EAAA;AAAA,EAGP,qBAAqB;;AACvB,KAAAE,IAAA,KAAK,UAAL,QAAAA,EAAY,aACD,aAAA,KAAK,MAAM,SAAS;AAAA,EACnC;AAAA;AAAA;AAAA,EAKM,aAAanD,GAAmBC,IAA8B,IAAI;AACxE,gBAAK,eAAe,GAEf,KAAA,YAAYD,GAAOC,CAAO,GAC/B,KAAK,uBAAuB,GAErB,KAAK,YAAYD,GAAOC,CAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUxC,MAAM,WAAWS,GAAkB0C,GAAqB;AAClD,QAAAA,EAAK,QAAQ,QAAS;AAE1B,SAAK,MAAM;AAAA,MACT,uCAAuC1C,EAAM,GAAG,cAAc0C,EAAK,GAAG;AAAA,IACxE;AAEA,UAAMC,IAAc,KAAK,oBAAoB3C,EAAM,KAAK0C,EAAK,KAAK;AAAA,MAChE,UAAS,oBAAI,KAAK,GAAE,YAAY;AAAA,IAAA,CACjC;AACD,QAAI,CAACC,EAAa;AAElB,UAAMb,IAAS;AAAA,MACb,GAAG,KAAK,+BAA+B9B,GAAO2C,CAAW;AAAA,MACzD,SAASA,EAAY;AAAA,MACrB,MAAM,KAAK,aAAa;AAAA,MACxB,QAAQ,KAAK,aAAa;AAAA,IAC5B;AAEA,gBAAK,MAAM,KAAK;AAAA,MACd;AAAA,MACAb;AAAA,IACF,GAEOa;AAAA,EAAA;AAAA,EAGT,MAAM,iBACJ3C,GACA0C,GACAE,GACA;AACA,SAAK,MAAM;AAAA,MACT,6CAA6C5C,EAAM,GAAG,cAAc0C,EAAK,GAAG;AAAA,IAC9E;AAEA,UAAMG,KAAK,oBAAI,KAAK,GAAE,YAAY,GAC5BF,IAAc,KAAK,oBAAoB3C,EAAM,KAAK0C,EAAK,KAAK;AAAA,MAChE,SAASG;AAAA,MACT,eAAeA;AAAA,IAAA,CAChB;AACD,QAAI,CAACF,EAAa;AAElB,UAAMb,IAAS;AAAA,MACb,GAAG,KAAK,+BAA+B9B,GAAO2C,CAAW;AAAA,MACzD,UAAAC;AAAA,IACF;AAEA,gBAAK,MAAM,KAAK,gBAGd,cAAcd,CAAM,GAEfa;AAAA,EAAA;AAAA,EAGT,MAAM,eAAe3C,GAAkB0C,GAAqB;AACtD,QAAAA,EAAK,QAAQ,YAAa;AAE9B,SAAK,MAAM;AAAA,MACT,2CAA2C1C,EAAM,GAAG,cAAc0C,EAAK,GAAG;AAAA,IAC5E;AAEA,UAAMC,IAAc,KAAK,oBAAoB3C,EAAM,KAAK0C,EAAK,KAAK;AAAA,MAChE,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IAAA,CACrC;AACD,QAAI,CAACC,EAAa;AAElB,UAAMb,IAAS,KAAK,+BAA+B9B,GAAO2C,CAAW;AAErE,gBAAK,MAAM,KAAK;AAAA,MACd;AAAA,MACA;AAAA,QACE,GAAGb;AAAA,QACH,aAAa9B,EAAM;AAAA,MAAA;AAAA,IAEvB,GAEO2C;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAOD,UAAUG,GAAwB;AAExC,UAAMC,IAAO,MAGPC,IAAa;AAAA,MACjB,GAAGF;AAAA;AAAA,MAEH,UAAU;AACD,eAAA,KAAK,MAAM,KAAK,CAAC5C,MAAM,CAACA,EAAE,QAAQ,WAAW;AAAA,MAAA;AAAA,IAExD;AAEA,WAAA8C,EAAW,UAAUA,EAAW,QAAQ,KAAKA,CAAU,GAE5CA,EAAA,QAAQF,EAAY,MAAM,IAAI,CAAC,EAAE,SAAAG,GAAS,GAAGC,QAAW;AACjE,YAAMC,IAAY;AAAA,QAChB,GAAGD;AAAA,QACH,SAAS,EAAE,GAAGD,EAAQ;AAAA,QACtB,aAAa;AAEP,cAAA,MAAK,QAAQ;AACV,mBAAAF,EAAK,WAAWC,GAAY,IAAI;AAAA,QACzC;AAAA,QACA,iBAAiB,EAAE,UAAAJ,EAAS,IAAgC,IAAI;AAE9D,iBAAOG,EAAK,iBAAiBC,GAAY,MAAMJ,CAAQ;AAAA,QACzD;AAAA,QACA,iBAAiB;AAEX,cAAA,MAAK,QAAQ;AACV,mBAAAG,EAAK,eAAeC,GAAY,IAAI;AAAA,QAAA;AAAA,MAE/C;AAIA,aAAAG,EAAU,aAAaA,EAAU,WAAW,KAAKA,CAAS,GAC1DA,EAAU,mBAAmBA,EAAU,iBAAiB,KAAKA,CAAS,GACtEA,EAAU,iBAAiBA,EAAU,eAAe,KAAKA,CAAS,GAE3DA;AAAA,IAAA,CACR,GAEDH,EAAW,4BACTF,EAAY,0BAA0B,IAAI,CAACzC,OAClC;AAAA,MACL,GAAGA;AAAA,MACH,SAAS,IAAI+C,EAAW,EAAE,UAAU/C,EAAK,SAAU,CAAA;AAAA,IACrD,EACD,GAEI2C;AAAA,EAAA;AAAA,EAGD,iBAAiBK,IAAkC,IAAI;AAE7D,UAAMC,IAAiB,EAAE,GAAG,KAAK,cAAc,GAAGD,EAAa;AAG/D,QAAIvB,IAAS,OAAO;AAAA,MAClB,OAAO,QAAQwB,CAAc,EAAE;AAAA,QAC7B,CAAC,CAACC,GAAIC,CAAC,MAAyBA,KAAM;AAAA,MAAA;AAAA,IAE1C;AAGS,WAAA1B,IAAAA,EAAO,OACZ,EAAE,GAAGA,GAAQ,MAAM,KAAK,UAAUA,EAAO,IAAI,EAC7C,IAAAA,GAEGA;AAAA,EAAA;AAAA,EAGD,eAAeZ,GAA0B;AAG/C,UAAMuC,IAFa,OAAO,KAAKvC,CAAW,EAAE,KAAK,EAG9C;AAAA,MACC,CAACwC,MACC,GAAG,mBAAmBA,CAAG,CAAC,IAAI,mBAAmBxC,EAAYwC,CAAG,CAAC,CAAC;AAAA,IAAA,EAErE,KAAK,GAAG,GAELC,IAAWxE,EAAkB,KAAK,MAAM,MAAM;AACpD,WAAOsE,IAAW,GAAGE,CAAQ,IAAIF,CAAQ,KAAKE;AAAA,EAAA;AAAA,EAGxC,oBACN5D,GACA6D,GACAC,GACA;AACI,QAAAlB;AAIJ,WAAIkB,EAAM,eACR,KAAK,gBAAgB,GAGlB,KAAA,MAAM,SAAS,CAACvE,MAAU;AACvB,YAAAU,IAAQV,EAAM,OAAOS,CAAQ;AAC/B,UAAA,CAACC,EAAc,QAAAV;AAEnB,YAAMwE,IAAQ9D,EAAM,MAAM,IAAI,CAAC0C,OACzBA,EAAK,QAAQkB,MAIjBlB,EAAK,UAAU,EAAE,GAAGA,EAAK,SAAS,GAAGmB,EAAM,GAC7BlB,IAAAD,IAEPA,EACR;AAED,MAAA1C,EAAM,QAAQ8D;AACR,YAAAC,IAAS,EAAE,GAAGzE,EAAM,QAAQ,CAACU,EAAM,GAAG,GAAGA,EAAM,GAI/CgE,IACJH,EAAM,eAAe,CAAC7D,EAAM,4BACxB;AAAA,QACE,GAAGV,EAAM;AAAA,QACT,CAAC+C,CAAiB,GAAGwB,EAAM;AAAA,UAE7BvE,EAAM;AAEZ,aAAO,EAAE,GAAGA,GAAO,QAAAyE,GAAQ,uBAAAC,EAAsB;AAAA,IAAA,CAClD,GAEMrB;AAAA,EAAA;AAAA,EAGD,+BACN3C,GACA0C,GACA;AACO,WAAA;AAAA,MACL,YAAYA,EAAK,QAAQ;AAAA,MACzB,YAAY1C,EAAM;AAAA,MAClB,WAAWA,EAAM;AAAA,MACjB,UAAUA,EAAM;AAAA,MAChB,gBAAgB0C,EAAK;AAAA,IACvB;AAAA,EAAA;AAAA,EAGM,kBAAkB,EAAE,MAAApB,KAA6C;AACvE,SAAK,sBAAsB;AAE3B,UAAMtB,IAAQ,KAAK,UAAUsB,EAAK,KAAK;AAElC,SAAA,MAAM,SAAS,CAAChC,MAAU;AACvB,YAAAyE,IAAS,EAAE,GAAGzE,EAAM,QAAQ,CAACU,EAAM,GAAG,GAAGA,EAAM;AAE9C,aAAA,EAAE,GAAGV,GAAO,QAAAyE,EAAO;AAAA,IAAA,CAC3B;AAAA,EAAA;AAAA,EAGK,YAAY,EAAE,MAAAzC,KAA+C;AACnE,SAAK,sBAAsB,GAEtB,KAAA,MAAM,SAAS,CAAChC,MAAU;AACvB,YAAA,EAAE,CAACgC,EAAK,MAAM,GAAG,GAAG2C,GAAG,GAAGf,MAAS5D,EAAM;AAC/C,aAAO,EAAE,GAAGA,GAAO,QAAQ4D,EAAK;AAAA,IAAA,CACjC;AAAA,EAAA;AAAA,EAGK,uBAAuB;AAAA,IAC7B,MAAA5B;AAAA,EAAA,GACgD;AAChD,SAAK,sBAAsB,GAEtB,KAAA,MAAM,SAAS,CAAChC,MAAU;AAGvB,YAAA4E,IAAc,CAAC5C,EAAK,WAAW,GAI/B6C,IAAc7C,EAAK,YAAY,gCAAgC,CAAC,GAChE8C,IAAY9C,EAAK,YAAY,8BAA8B,CAAC;AAElE,UAAIyC,IAASzE,EAAM;AAEnB,aAAAyE,IAASI,EAAY,OAAO,CAAC/D,GAAKsD,MAAQ;AACxC,YAAI,CAACtD,EAAIsD,CAAG,EAAU,QAAAtD;AACtB,cAAMJ,IAAQ,EAAE,GAAGI,EAAIsD,CAAG,GAAG,2BAA2B,GAAK;AAC7D,eAAO,EAAE,GAAGtD,GAAK,CAACsD,CAAG,GAAG1D,EAAM;AAAA,SAC7B+D,CAAM,GAETA,IAASK,EAAU,OAAO,CAAChE,GAAKsD,MAAQ;AACtC,YAAI,CAACtD,EAAIsD,CAAG,EAAU,QAAAtD;AACtB,cAAMJ,IAAQ,EAAE,GAAGI,EAAIsD,CAAG,GAAG,2BAA2B,GAAM;AAC9D,eAAO,EAAE,GAAGtD,GAAK,CAACsD,CAAG,GAAG1D,EAAM;AAAA,SAC7B+D,CAAM,GAEF,EAAE,GAAGzE,GAAO,QAAAyE,GAAQ,aAAAG,EAAY;AAAA,IAAA,CACxC;AAAA,EAAA;AAAA,EAYK,qCAAqC;AAC3C,QAAI,yBAAQ,SAAS;AAEZ,aAAA,iBAAiB,YAAY,KAAK,oBAAoB,GAGtD,OAAA,iBAAiB,cAAc,KAAK,oBAAoB;AAGzD,YAAAG,IAAc,OAAO,QAAQ,WAC7BC,IAAiB,OAAO,QAAQ;AAGtC,aAAO,QAAQ,YAAY,IAAI,MAAMD,GAAa;AAAA,QAChD,OAAO,CAACE,GAAQC,GAASC,MAAS;AACxB,kBAAA,MAAMF,GAAQC,GAASC,CAAI,GACnC,WAAW,MAAM;AACf,iBAAK,qBAAqB;AAAA,aACzB,CAAC;AAAA,QAAA;AAAA,MACN,CACD,GACD,OAAO,QAAQ,eAAe,IAAI,MAAMH,GAAgB;AAAA,QACtD,OAAO,CAACC,GAAQC,GAASC,MAAS;AACxB,kBAAA,MAAMF,GAAQC,GAASC,CAAI,GACnC,WAAW,MAAM;AACf,iBAAK,qBAAqB;AAAA,aACzB,CAAC;AAAA,QAAA;AAAA,MACN,CACD,GAGD,KAAK,cAAcJ,GACnB,KAAK,iBAAiBC;AAAA,IAAA;AAEtB,WAAK,MAAM;AAAA,QACT;AAAA,MACF;AAAA,EACF;AAAA,EAGM,uBAAuB;AACtB,WAAA,oBAAoB,YAAY,KAAK,oBAAoB,GACzD,OAAA,oBAAoB,cAAc,KAAK,oBAAoB,GAE9D,KAAK,gBACA,OAAA,QAAQ,YAAY,KAAK,aAChC,KAAK,cAAc,SAEjB,KAAK,mBACA,OAAA,QAAQ,eAAe,KAAK,gBACnC,KAAK,iBAAiB;AAAA,EACxB;AAEJ;"}
+{"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  mockDefaultGroup,\n} from \"./helpers\";\nimport {\n  ConstructorOpts,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\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// 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\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  for (const [index, guideKey] of displaySequence.entries()) {\n    const guide = state.guides[guideKey];\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, { location, filters });\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};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {} }: 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  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const locationRules = guide.activation_location_rules || [];\n\n  if (locationRules.length > 0 && location) {\n    const allowed = locationRules.reduce<boolean | undefined>((acc, rule) => {\n      // Any matched block rule prevails so no need to evaluate further\n      // as soon as there is one.\n      if (acc === false) return false;\n\n      // At this point we either have a matched allow rule (acc is true),\n      // or no matched rule found yet (acc is undefined).\n\n      switch (rule.directive) {\n        case \"allow\": {\n          // No need to evaluate more allow rules once we matched one\n          // since any matched allowed rule means allow.\n          if (acc === true) return true;\n\n          const matched = rule.pattern.test(location);\n          return matched ? true : undefined;\n        }\n\n        case \"block\": {\n          // Always test block rules (unless already matched to block)\n          // because they'd prevail over matched allow rules.\n          const matched = rule.pattern.test(location);\n          return matched ? false : acc;\n        }\n      }\n    }, undefined);\n\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  ];\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 { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\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    // Start the counter loop to increment at an interval.\n    this.startCounterInterval();\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() {\n    const {\n      throttleCheckInterval: delay = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = this.options;\n\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.failIfNotAuthenticated();\n    this.knock.log(\"[Guide] Loading all eligible guides\");\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      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.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 params = { ...this.targetParams, user_id: this.knock.userId };\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      default:\n        return;\n    }\n  }\n\n  setLocation(href: string) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => ({ ...state, location: href }));\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return [];\n    }\n    this.knock.log(`[Guide] Selecting guides for: ${formatFilters(filters)}`);\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(state: StoreState, filters: SelectFilterParams = {}) {\n    if (Object.keys(state.guides).length === 0) {\n      return undefined;\n    }\n    this.knock.log(`[Guide] Selecting a guide for: ${formatFilters(filters)}`);\n\n    const result = select(state, filters);\n\n    if (result.size === 0) {\n      this.knock.log(\"[Guide] Selection returned zero result\");\n      return undefined;\n    }\n\n    const [index, guide] = [...result][0]!;\n\n    // If a guide ignores the group limit, then return immediately to render\n    // always.\n    if (guide.bypass_global_group_limit) {\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) return undefined;\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        return this.stage.resolved === guide.key ? guide : undefined;\n      }\n\n      case \"closed\": {\n        return this.stage.resolved === guide.key ? guide : undefined;\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    if (!this.stage || this.stage.status === \"closed\") return;\n\n    this.knock.log(\"[Guide] Closing the current group stage\");\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    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved: this.stage.ordered.find((x) => x !== undefined),\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    if (this.stage?.status !== \"closed\") return;\n\n    this.knock.log(\"[Guide] Patching the current group stage\");\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.stage = {\n      ...this.stage,\n      status: \"patch\",\n      ordered: [],\n      timeoutId,\n    };\n\n    return this.stage;\n  }\n\n  private clearGroupStage() {\n    if (!this.stage) return;\n\n    this.knock.log(\"[Guide] Clearing the current group stage\");\n\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        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_location_rules =\n      remoteGuide.activation_location_rules.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 = { ...this.targetParams, ...filterParams };\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      message_id: step.message.id,\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  // 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] Handle Location change: ${href}`);\n    this.setLocation(href);\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","checkForWindow","guidesApiRootPath","userId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","index","guideKey","guide","predicate","s","locationRules","acc","rule","KnockGuideClient","knock","channelId","targetParams","options","__publicField","win","href","trackLocationFromWindow","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","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","x","_a","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}

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

@@ -13,6 +13,7 @@ export declare class KnockGuideClient {
     private socketChannel;
     private socketChannelTopic;
     private socketEventTypes;
+    private subscribeRetryCount;
     private pushStateFn;
     private replaceStateFn;
     private stage;
@@ -26,6 +27,7 @@ export declare class KnockGuideClient {
         filters?: QueryFilterParams;
     }): Promise<QueryStatus>;
     subscribe(): void;
+    private handleChannelJoinError;
     unsubscribe(): void;
     private handleSocketEvent;
     setLocation(href: string): void;

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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,OAAO,KAAK,MAAM,aAAa,CAAC;AAWhC,OAAO,EACL,eAAe,EAKf,SAAS,EAKT,aAAa,EAEb,UAAU,EACV,cAAc,EAKd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAElB,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAUjB,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI,WACrC,CAAC;AAmF/B,qBAAa,gBAAgB;IA2BzB,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe;IA7B5B,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC;IAGnE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAMtB;IAGF,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,cAAc,CAAsC;IAK5D,OAAO,CAAC,KAAK,CAAyB;IAEtC,OAAO,CAAC,iBAAiB,CAA6C;gBAG3D,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,YAAiB,EAC/B,OAAO,GAAE,eAAoB;IAiCxC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO;IAOD,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAgDlD,SAAS;IA+BT,WAAW;IAcX,OAAO,CAAC,iBAAiB;IAwBzB,WAAW,CAAC,IAAI,EAAE,MAAM;IAWxB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB;IAmBhE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB;IA2F/D,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,YAAY;IAgBd,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA2BhD,gBAAgB,CACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,WAAW;IA0BlB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA6B1D,OAAO,CAAC,SAAS;IAuDjB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,8BAA8B;IAatC,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,oBAAoB,CAM1B;IAEF,OAAO,CAAC,kCAAkC;IAwC1C,OAAO,CAAC,oBAAoB;CAa7B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,OAAO,KAAK,MAAM,aAAa,CAAC;AAWhC,OAAO,EACL,eAAe,EAKf,SAAS,EAKT,aAAa,EAEb,UAAU,EACV,cAAc,EAKd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAElB,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAoBjB,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI,WACrC,CAAC;AAmF/B,qBAAa,gBAAgB;IA4BzB,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe;IA9B5B,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC;IAGnE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAMtB;IACF,OAAO,CAAC,mBAAmB,CAAK;IAGhC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,cAAc,CAAsC;IAK5D,OAAO,CAAC,KAAK,CAAyB;IAEtC,OAAO,CAAC,iBAAiB,CAA6C;gBAG3D,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,YAAiB,EAC/B,OAAO,GAAE,eAAoB;IAgCxC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO;IAOD,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAgDlD,SAAS;IAgDT,OAAO,CAAC,sBAAsB;IAc9B,WAAW;IAcX,OAAO,CAAC,iBAAiB;IAwBzB,WAAW,CAAC,IAAI,EAAE,MAAM;IAWxB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB;IAmBhE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB;IA2F/D,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,YAAY;IAgBd,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA2BhD,gBAAgB,CACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,WAAW;IA0BlB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA6B1D,OAAO,CAAC,SAAS;IAuDjB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,8BAA8B;IAatC,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,oBAAoB,CAS1B;IAEF,OAAO,CAAC,kCAAkC;IAyC1C,OAAO,CAAC,oBAAoB;CAgB7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/client",
-  "version": "0.16.3",
+  "version": "0.16.5",
   "description": "The clientside library for interacting with Knock",
   "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
   "author": "@knocklabs",
@@ -50,12 +50,12 @@
     "@babel/plugin-proposal-class-properties": "^7.16.7",
     "@babel/plugin-proposal-object-rest-spread": "^7.16.7",
     "@babel/plugin-transform-runtime": "^7.28.0",
-    "@babel/preset-env": "^7.27.1",
+    "@babel/preset-env": "^7.28.3",
     "@babel/preset-typescript": "^7.27.0",
     "@codecov/vite-plugin": "^1.9.1",
     "@types/jsonwebtoken": "^9.0.10",
     "@typescript-eslint/eslint-plugin": "^8.32.0",
-    "@typescript-eslint/parser": "^8.32.1",
+    "@typescript-eslint/parser": "^8.39.1",
     "cross-env": "^7.0.3",
     "crypto": "^1.0.1",
     "eslint": "^8.56.0",
@@ -70,7 +70,7 @@
   "dependencies": {
     "@babel/runtime": "^7.27.1",
     "@knocklabs/types": "^0.1.5",
-    "@tanstack/store": "^0.7.1",
+    "@tanstack/store": "^0.7.2",
     "@types/phoenix": "^1.6.6",
     "axios": "^1.11.0",
     "axios-retry": "^4.5.0",

package/src/clients/guide/client.ts

@@ -49,6 +49,16 @@ const DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds
 // trigger subscribed callbacks.
 const DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds
 
+// Maximum number of retry attempts for channel subscription
+const SUBSCRIBE_RETRY_LIMIT = 3;
+
+// Return the global window object if defined, so to safely guard against SSR.
+const checkForWindow = () => {
+  if (typeof window !== "undefined") {
+    return window;
+  }
+};
+
 export const guidesApiRootPath = (userId: string | undefined | null) =>
   `/v1/users/${userId}/guides`;
 
@@ -147,6 +157,7 @@ export class KnockGuideClient {
     "guide_group.added",
     "guide_group.updated",
   ];
+  private subscribeRetryCount = 0;
 
   // Original history methods to monkey patch, or restore in cleanups.
   private pushStateFn: History["pushState"] | undefined;
@@ -166,10 +177,9 @@ export class KnockGuideClient {
     readonly options: ConstructorOpts = {},
   ) {
     const { trackLocationFromWindow = true } = options;
+    const win = checkForWindow();
 
-    const location = trackLocationFromWindow
-      ? window?.location.href
-      : undefined;
+    const location = trackLocationFromWindow ? win?.location.href : undefined;
 
     this.store = new Store<StoreState>({
       guideGroups: [],
@@ -300,13 +310,44 @@ export class KnockGuideClient {
     }
 
     if (["closed", "errored"].includes(newChannel.state)) {
-      newChannel.join();
+      // Reset retry count for new subscription attempt
+      this.subscribeRetryCount = 0;
+
+      newChannel
+        .join()
+        .receive("ok", () => {
+          this.knock.log("[Guide] Successfully joined channel");
+        })
+        .receive("error", (resp) => {
+          this.knock.log(
+            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,
+          );
+          this.handleChannelJoinError();
+        })
+        .receive("timeout", () => {
+          this.knock.log("[Guide] Channel join timed out");
+          this.handleChannelJoinError();
+        });
     }
 
     // Track the joined channel.
     this.socketChannel = newChannel;
   }
 
+  private handleChannelJoinError() {
+    // Prevent phx channel from retrying forever in case of either network or
+    // other errors (e.g. auth error, invalid channel etc)
+    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {
+      this.knock.log(
+        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,
+      );
+      this.unsubscribe();
+      return;
+    }
+
+    this.subscribeRetryCount++;
+  }
+
   unsubscribe() {
     if (!this.socketChannel) return;
     this.knock.log("[Guide] Unsubscribing from real time updates");
@@ -860,7 +901,10 @@ export class KnockGuideClient {
 
   // Define as an arrow func property to always bind this to the class instance.
   private handleLocationChange = () => {
-    const href = window.location.href;
+    const win = checkForWindow();
+    if (!win?.location) return;
+
+    const href = win.location.href;
     if (this.store.state.location === href) return;
 
     this.knock.log(`[Guide] Handle Location change: ${href}`);
@@ -868,19 +912,20 @@ export class KnockGuideClient {
   };
 
   private listenForLocationChangesFromWindow() {
-    if (window?.history) {
+    const win = checkForWindow();
+    if (win?.history) {
       // 1. Listen for browser back/forward button clicks.
-      window.addEventListener("popstate", this.handleLocationChange);
+      win.addEventListener("popstate", this.handleLocationChange);
 
       // 2. Listen for hash changes in case it's used for routing.
-      window.addEventListener("hashchange", this.handleLocationChange);
+      win.addEventListener("hashchange", this.handleLocationChange);
 
       // 3. Monkey-patch history methods to catch programmatic navigation.
-      const pushStateFn = window.history.pushState;
-      const replaceStateFn = window.history.replaceState;
+      const pushStateFn = win.history.pushState;
+      const replaceStateFn = win.history.replaceState;
 
       // Use setTimeout to allow the browser state to potentially settle.
-      window.history.pushState = new Proxy(pushStateFn, {
+      win.history.pushState = new Proxy(pushStateFn, {
         apply: (target, history, args) => {
           Reflect.apply(target, history, args);
           setTimeout(() => {
@@ -888,7 +933,7 @@ export class KnockGuideClient {
           }, 0);
         },
       });
-      window.history.replaceState = new Proxy(replaceStateFn, {
+      win.history.replaceState = new Proxy(replaceStateFn, {
         apply: (target, history, args) => {
           Reflect.apply(target, history, args);
           setTimeout(() => {
@@ -908,15 +953,18 @@ export class KnockGuideClient {
   }
 
   private removeEventListeners() {
-    window.removeEventListener("popstate", this.handleLocationChange);
-    window.removeEventListener("hashchange", this.handleLocationChange);
+    const win = checkForWindow();
+    if (!win?.history) return;
+
+    win.removeEventListener("popstate", this.handleLocationChange);
+    win.removeEventListener("hashchange", this.handleLocationChange);
 
     if (this.pushStateFn) {
-      window.history.pushState = this.pushStateFn;
+      win.history.pushState = this.pushStateFn;
       this.pushStateFn = undefined;
     }
     if (this.replaceStateFn) {
-      window.history.replaceState = this.replaceStateFn;
+      win.history.replaceState = this.replaceStateFn;
       this.replaceStateFn = undefined;
     }
   }