@knocklabs/client 0.17.1 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.18.0
+
+### Minor Changes
+
+- 5fc0af9: feat: adds `identificationStrategy` option for user identification control
+
+## 0.17.2
+
+### Patch Changes
+
+- 23b7057: fix: return preview guides even if no other guides are present
+- 1c24f68: fix: filter out inactive guides in preview mode
+
 ## 0.17.1
 
 ### 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.17.1"}}exports.default=h;
+"use strict";var a=Object.defineProperty;var n=(t,e,s)=>e in t?a(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var r=(t,e,s)=>n(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("axios"),l=require("axios-retry"),c=require("phoenix"),i=t=>t&&typeof t=="object"&&"default"in t?t:{default:t},d=i(u),o=i(l);class h{constructor(e){r(this,"host");r(this,"apiKey");r(this,"userToken");r(this,"axiosClient");r(this,"socket");this.host=e.host,this.apiKey=e.apiKey,this.userToken=e.userToken||null,this.axiosClient=d.default.create({baseURL:this.host,headers:{Accept:"application/json","Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,"X-Knock-User-Token":this.userToken,"X-Knock-Client":this.getKnockClientHeader()}}),typeof window<"u"&&(this.socket=new c.Socket(`${this.host.replace("http","ws")}/ws/v1`,{params:{user_token:this.userToken,api_key:this.apiKey}})),o.default(this.axiosClient,{retries:3,retryCondition:this.canRetryRequest,retryDelay:o.default.exponentialDelay})}async makeRequest(e){try{const s=await this.axiosClient(e);return{statusCode:s.status<300?"ok":"error",body:s.data,error:void 0,status:s.status}}catch(s){return console.error(s),{statusCode:"error",status:500,body:void 0,error:s}}}canRetryRequest(e){return o.default.isNetworkError(e)?!0:e.response?e.response.status>=500&&e.response.status<=599||e.response.status===429:!1}getKnockClientHeader(){return"Knock/ClientJS 0.18.0"}}exports.default=h;
 //# sourceMappingURL=api.js.map

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

@@ -1,2 +1,2 @@
-"use strict";var m=Object.defineProperty;var v=(a,e,t)=>e in a?m(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var c=(a,e,t)=>v(a,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const G=require("@tanstack/store"),_=require("urlpattern-polyfill"),d=require("./helpers.js"),b=50,C=30*1e3,I=3,p={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},g=()=>{if(typeof window<"u")return window},y=a=>`/v1/users/${a}/guides`,k=()=>{const a=g();if(!a)return{forcedGuideKey:null,previewSessionId:null};const e=new URLSearchParams(a.location.search),t=e.get(p.GUIDE_KEY),s=e.get(p.PREVIEW_SESSION_ID);return{forcedGuideKey:t,previewSessionId:s}},f=(a,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(a.guideGroups);if(!s)return t;const i=[...s.display_sequence],n=a.location;if(a.debug.forcedGuideKey){const r=i.indexOf(a.debug.forcedGuideKey);r>-1&&i.splice(r,1),i.unshift(a.debug.forcedGuideKey)}for(const[r,o]of i.entries()){let u=a.guides[o];a.debug.forcedGuideKey===o&&a.previewGuides[o]&&(u=a.previewGuides[o]),!(!u||!E(u,{location:n,filters:e,debug:a.debug}))&&t.set(r,u)}return t.metadata={guideGroup:s},t},E=(a,{location:e,filters:t={},debug:s={}})=>{if(t.type&&t.type!==a.type||t.key&&t.key!==a.key)return!1;if(s.forcedGuideKey===a.key)return!0;if(a.steps.every(o=>!!o.message.archived_at))return!1;const i=e?d.newUrl(e):void 0,n=a.activation_url_rules||[],r=a.activation_url_patterns||[];if(i&&n.length>0){if(!d.predicateUrlRules(i,n))return!1}else if(i&&r.length>0&&!d.predicateUrlPatterns(i,r))return!1;return!0};class w{constructor(e,t,s={},i={}){c(this,"store");c(this,"socket");c(this,"socketChannel");c(this,"socketChannelTopic");c(this,"socketEventTypes",["guide.added","guide.updated","guide.removed","guide_group.added","guide_group.updated","guide.live_preview_updated"]);c(this,"subscribeRetryCount",0);c(this,"pushStateFn");c(this,"replaceStateFn");c(this,"stage");c(this,"counterIntervalId");c(this,"handleLocationChange",()=>{const e=g();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Handle Location change: ${t}`);const s=this.store.state.debug,i=k();this.setLocation(t,{debug:i}),this.checkDebugStateChanged(s,i)&&(this.knock.log("[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"),this.fetch(),this.subscribe())});this.knock=e,this.channelId=t,this.targetParams=s,this.options=i;const{trackLocationFromWindow:n=!0}=i,r=g(),o=n?r==null?void 0:r.location.href:void 0,u=k();this.store=new G.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:o,counter:0,debug:u});const{socket:h}=this.knock.client();this.socket=h,this.socketChannelTopic=`guides:${t}`,n&&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=C}=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),i=this.store.state.queries[s];if(i)return i;this.store.setState(r=>({...r,queries:{...r.queries,[s]:{status:"loading"}}}));let n;try{const r=await this.knock.user.getGuides(this.channelId,t);n={status:"ok"};const{entries:o,guide_groups:u,guide_group_display_logs:h}=r;this.store.setState(l=>({...l,guideGroups:(u==null?void 0:u.length)>0?u:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:h||{},guides:d.byKey(o.map(S=>this.localCopy(S))),queries:{...l.queries,[s]:n}}))}catch(r){n={status:"error",error:r},this.store.setState(o=>({...o,queries:{...o.queries,[s]:n}}))}return n}subscribe(){if(!this.socket)return;this.knock.failIfNotAuthenticated(),this.knock.log("[Guide] Subscribing to real time updates"),this.socket.isConnected()||this.socket.connect(),this.socketChannel&&this.unsubscribe();const e=this.store.state.debug,t={...this.targetParams,user_id:this.knock.userId,force_all_guides:e.forcedGuideKey?!0:void 0,preview_session_id:e.previewSessionId||void 0},s=this.socket.channel(this.socketChannelTopic,t);for(const i of this.socketEventTypes)s.on(i,n=>this.handleSocketEvent(n));["closed","errored"].includes(s.state)&&(this.subscribeRetryCount=0,s.join().receive("ok",()=>{this.knock.log("[Guide] Successfully joined channel")}).receive("error",i=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(i)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=I){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default:return}}setLocation(e,t={}){this.clearGroupStage(),this.store.setState(s=>{var n;const i=(n=t==null?void 0:t.debug)!=null&&n.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:i,location:e}})}selectGuides(e,t={}){if(Object.keys(e.guides).length===0)return[];this.knock.log(`[Guide] Selecting guides for: ${d.formatFilters(t)}`);const s=f(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=f(e,t);if(s.size===0){this.knock.log("[Guide] Selection returned zero result");return}const[i,n]=[...s][0];if(n.bypass_global_group_limit)return n;const r=d.findDefaultGroup(e.guideGroups),o=e.guideGroupDisplayLogs[d.DEFAULT_GROUP_KEY];if(!(r&&r.display_interval&&o&&d.checkIfThrottled(o,r.display_interval)))switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Addng to the group stage: ${n.key}`),this.stage.ordered[i]=n.key;return}case"patch":return this.knock.log(`[Guide] Patching the group stage: ${n.key}`),this.stage.ordered[i]=n.key,this.stage.resolved===n.key?n:void 0;case"closed":return this.stage.resolved===n.key?n:void 0}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=b}=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();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.stage={...this.stage,status:"closed",resolved:e,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 i={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",i),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}, Step ref:${t.ref})`);const i=new Date().toISOString(),n=this.setStepMessageAttrs(e.key,t.ref,{read_at:i,interacted_at:i});if(!n)return;const r={...this.buildEngagementEventBaseParams(e,n),metadata:s};return this.knock.user.markGuideStepAs("interacted",r),n}async markAsArchived(e,t){if(t.message.archived_at)return;this.knock.log(`[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{archived_at:new Date().toISOString()});if(!s)return;const i=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...i,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return t.store.state.debug.forcedGuideKey===this.key?this.steps[0]:this.steps.find(i=>!i.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:i,...n})=>{const r={...n,message:{...i},markAsSeen(){if(!this.message.seen_at)return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){if(!this.message.archived_at)return t.markAsArchived(s,this)}};return r.markAsSeen=r.markAsSeen.bind(r),r.markAsInteracted=r.markAsInteracted.bind(r),r.markAsArchived=r.markAsArchived.bind(r),r}),s.activation_url_patterns=e.activation_url_patterns.map(i=>({...i,pattern:new _.URLPattern({pathname:i.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let i=Object.fromEntries(Object.entries(t).filter(([n,r])=>r!=null));return i=i.data?{...i,data:JSON.stringify(i.data)}:i,i}formatQueryKey(e){const s=Object.keys(e).sort().map(n=>`${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`).join("&"),i=y(this.knock.userId);return s?`${i}?${s}`:i}setStepMessageAttrs(e,t,s){let i;return s.archived_at&&this.clearGroupStage(),this.store.setState(n=>{const r=n.guides[e];if(!r)return n;const o=r.steps.map(l=>(l.ref!==t||(l.message={...l.message,...s},i=l),l));r.steps=o;const u={...n.guides,[r.key]:r},h=s.archived_at&&!r.bypass_global_group_limit?{...n.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:n.guideGroupDisplayLogs;return{...n,guides:u,guideGroupDisplayLogs:h}}),i}buildEngagementEventBaseParams(e,t){return{message_id:t.message.id,channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref}}addOrReplaceGuide({data:e}){this.patchClosedGroupStage();const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.guides,[t.key]:t};return{...s,guides:i}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...i}=t.guides;return{...t,guides:i}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],i=e.guide_group.display_sequence_unthrottled||[],n=e.guide_group.display_sequence_throttled||[];let r=t.guides;return r=i.reduce((o,u)=>{if(!o[u])return o;const h={...o[u],bypass_global_group_limit:!0};return{...o,[u]:h}},r),r=n.reduce((o,u)=>{if(!o[u])return o;const h={...o[u],bypass_global_group_limit:!1};return{...o,[u]:h}},r),{...t,guides:r,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.previewGuides,[t.key]:t};return{...s,previewGuides:i}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=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:(i,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(i,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),this.pushStateFn=t,this.replaceStateFn=s}else this.knock.log("[Guide] Unable to access the `window.history` object to detect location changes")}removeEventListeners(){const e=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.DEBUG_QUERY_PARAMS=p;exports.KnockGuideClient=w;exports.guidesApiRootPath=y;
+"use strict";var m=Object.defineProperty;var v=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>v(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const G=require("@tanstack/store"),_=require("urlpattern-polyfill"),d=require("./helpers.js"),b=50,C=30*1e3,I=3,p={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},g=()=>{if(typeof window<"u")return window},y=u=>`/v1/users/${u}/guides`,k=()=>{const u=g();if(!u)return{forcedGuideKey:null,previewSessionId:null};const e=new URLSearchParams(u.location.search),t=e.get(p.GUIDE_KEY),s=e.get(p.PREVIEW_SESSION_ID);return{forcedGuideKey:t,previewSessionId:s}},f=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;const i=[...s.display_sequence],n=u.location;if(u.debug.forcedGuideKey){const r=i.indexOf(u.debug.forcedGuideKey);r>-1&&i.splice(r,1),i.unshift(u.debug.forcedGuideKey)}for(const[r,o]of i.entries()){let a=u.guides[o];u.debug.forcedGuideKey===o&&u.previewGuides[o]&&(a=u.previewGuides[o]),!(!a||!E(a,{location:n,filters:e,debug:u.debug}))&&t.set(r,a)}return t.metadata={guideGroup:s},t},E=(u,{location:e,filters:t={},debug:s={}})=>{if(t.type&&t.type!==u.type||t.key&&t.key!==u.key)return!1;if(s.forcedGuideKey===u.key)return!0;if(!u.active||u.steps.every(o=>!!o.message.archived_at))return!1;const i=e?d.newUrl(e):void 0,n=u.activation_url_rules||[],r=u.activation_url_patterns||[];if(i&&n.length>0){if(!d.predicateUrlRules(i,n))return!1}else if(i&&r.length>0&&!d.predicateUrlPatterns(i,r))return!1;return!0};class w{constructor(e,t,s={},i={}){c(this,"store");c(this,"socket");c(this,"socketChannel");c(this,"socketChannelTopic");c(this,"socketEventTypes",["guide.added","guide.updated","guide.removed","guide_group.added","guide_group.updated","guide.live_preview_updated"]);c(this,"subscribeRetryCount",0);c(this,"pushStateFn");c(this,"replaceStateFn");c(this,"stage");c(this,"counterIntervalId");c(this,"handleLocationChange",()=>{const e=g();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Handle Location change: ${t}`);const s=this.store.state.debug,i=k();this.setLocation(t,{debug:i}),this.checkDebugStateChanged(s,i)&&(this.knock.log("[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"),this.fetch(),this.subscribe())});this.knock=e,this.channelId=t,this.targetParams=s,this.options=i;const{trackLocationFromWindow:n=!0}=i,r=g(),o=n?r==null?void 0:r.location.href:void 0,a=k();this.store=new G.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:o,counter:0,debug:a});const{socket:h}=this.knock.client();this.socket=h,this.socketChannelTopic=`guides:${t}`,n&&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=C}=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),i=this.store.state.queries[s];if(i)return i;this.store.setState(r=>({...r,queries:{...r.queries,[s]:{status:"loading"}}}));let n;try{const r=await this.knock.user.getGuides(this.channelId,t);n={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:h}=r;this.store.setState(l=>({...l,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:h||{},guides:d.byKey(o.map(S=>this.localCopy(S))),queries:{...l.queries,[s]:n}}))}catch(r){n={status:"error",error:r},this.store.setState(o=>({...o,queries:{...o.queries,[s]:n}}))}return n}subscribe(){if(!this.socket)return;this.knock.failIfNotAuthenticated(),this.knock.log("[Guide] Subscribing to real time updates"),this.socket.isConnected()||this.socket.connect(),this.socketChannel&&this.unsubscribe();const e=this.store.state.debug,t={...this.targetParams,user_id:this.knock.userId,force_all_guides:e.forcedGuideKey?!0:void 0,preview_session_id:e.previewSessionId||void 0},s=this.socket.channel(this.socketChannelTopic,t);for(const i of this.socketEventTypes)s.on(i,n=>this.handleSocketEvent(n));["closed","errored"].includes(s.state)&&(this.subscribeRetryCount=0,s.join().receive("ok",()=>{this.knock.log("[Guide] Successfully joined channel")}).receive("error",i=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(i)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=I){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default:return}}setLocation(e,t={}){this.clearGroupStage(),this.store.setState(s=>{var n;const i=(n=t==null?void 0:t.debug)!=null&&n.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:i,location:e}})}selectGuides(e,t={}){if(Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0)return[];this.knock.log(`[Guide] Selecting guides for: ${d.formatFilters(t)}`);const s=f(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&&Object.keys(e.previewGuides).length===0)return;this.knock.log(`[Guide] Selecting a guide for: ${d.formatFilters(t)}`);const s=f(e,t);if(s.size===0){this.knock.log("[Guide] Selection returned zero result");return}const[i,n]=[...s][0];if(n.bypass_global_group_limit)return n;const r=d.findDefaultGroup(e.guideGroups),o=e.guideGroupDisplayLogs[d.DEFAULT_GROUP_KEY];if(!(r&&r.display_interval&&o&&d.checkIfThrottled(o,r.display_interval)))switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Addng to the group stage: ${n.key}`),this.stage.ordered[i]=n.key;return}case"patch":return this.knock.log(`[Guide] Patching the group stage: ${n.key}`),this.stage.ordered[i]=n.key,this.stage.resolved===n.key?n:void 0;case"closed":return this.stage.resolved===n.key?n:void 0}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=b}=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();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.stage={...this.stage,status:"closed",resolved:e,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 i={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data,tenant:this.targetParams.tenant};return this.knock.user.markGuideStepAs("seen",i),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}, Step ref:${t.ref})`);const i=new Date().toISOString(),n=this.setStepMessageAttrs(e.key,t.ref,{read_at:i,interacted_at:i});if(!n)return;const r={...this.buildEngagementEventBaseParams(e,n),metadata:s};return this.knock.user.markGuideStepAs("interacted",r),n}async markAsArchived(e,t){if(t.message.archived_at)return;this.knock.log(`[Guide] Marking as archived (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{archived_at:new Date().toISOString()});if(!s)return;const i=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...i,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return t.store.state.debug.forcedGuideKey===this.key?this.steps[0]:this.steps.find(i=>!i.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:i,...n})=>{const r={...n,message:{...i},markAsSeen(){if(!this.message.seen_at)return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){if(!this.message.archived_at)return t.markAsArchived(s,this)}};return r.markAsSeen=r.markAsSeen.bind(r),r.markAsInteracted=r.markAsInteracted.bind(r),r.markAsArchived=r.markAsArchived.bind(r),r}),s.activation_url_patterns=e.activation_url_patterns.map(i=>({...i,pattern:new _.URLPattern({pathname:i.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let i=Object.fromEntries(Object.entries(t).filter(([n,r])=>r!=null));return i=i.data?{...i,data:JSON.stringify(i.data)}:i,i}formatQueryKey(e){const s=Object.keys(e).sort().map(n=>`${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`).join("&"),i=y(this.knock.userId);return s?`${i}?${s}`:i}setStepMessageAttrs(e,t,s){let i;return s.archived_at&&this.clearGroupStage(),this.store.setState(n=>{const r=n.guides[e];if(!r)return n;const o=r.steps.map(l=>(l.ref!==t||(l.message={...l.message,...s},i=l),l));r.steps=o;const a={...n.guides,[r.key]:r},h=s.archived_at&&!r.bypass_global_group_limit?{...n.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:n.guideGroupDisplayLogs;return{...n,guides:a,guideGroupDisplayLogs:h}}),i}buildEngagementEventBaseParams(e,t){return{message_id:t.message.id,channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref}}addOrReplaceGuide({data:e}){this.patchClosedGroupStage();const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.guides,[t.key]:t};return{...s,guides:i}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...i}=t.guides;return{...t,guides:i}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],i=e.guide_group.display_sequence_unthrottled||[],n=e.guide_group.display_sequence_throttled||[];let r=t.guides;return r=i.reduce((o,a)=>{if(!o[a])return o;const h={...o[a],bypass_global_group_limit:!0};return{...o,[a]:h}},r),r=n.reduce((o,a)=>{if(!o[a])return o;const h={...o[a],bypass_global_group_limit:!1};return{...o,[a]:h}},r),{...t,guides:r,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const i={...s.previewGuides,[t.key]:t};return{...s,previewGuides:i}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=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:(i,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(i,n,r)=>{Reflect.apply(i,n,r),setTimeout(()=>{this.handleLocationChange()},0)}}),this.pushStateFn=t,this.replaceStateFn=s}else this.knock.log("[Guide] Unable to access the `window.history` object to detect location changes")}removeEventListeners(){const e=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.DEBUG_QUERY_PARAMS=p;exports.KnockGuideClient=w;exports.guidesApiRootPath=y;
 //# 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  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params like \"knock_guide_key\" from URL.\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const forcedGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const previewSessionId = urlParams.get(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n\n  return { forcedGuideKey, previewSessionId };\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    // 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 debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\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<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\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    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    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        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      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  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","forcedGuideKey","previewSessionId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","debugState","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params like \"knock_guide_key\" from URL.\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const forcedGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const previewSessionId = urlParams.get(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n\n  return { forcedGuideKey, previewSessionId };\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    // 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 debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\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<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\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    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    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        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      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  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","forcedGuideKey","previewSessionId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","debugState","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}

package/dist/cjs/knock.js

@@ -1,2 +1,2 @@
-"use strict";var h=Object.defineProperty;var r=(s,e,t)=>e in s?h(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t;var i=(s,e,t)=>r(s,typeof e!="symbol"?e+"":e,t);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const d=require("jwt-decode"),f=require("./api.js"),k=require("./clients/feed/index.js"),T=require("./clients/messages/index.js"),g=require("./clients/ms-teams/index.js"),w=require("./clients/objects/index.js"),p=require("./clients/preferences/index.js"),x=require("./clients/slack/index.js"),y=require("./clients/users/index.js"),m="https://api.knock.app";class C{constructor(e,t={}){i(this,"host");i(this,"apiClient",null);i(this,"userId");i(this,"userToken");i(this,"logLevel");i(this,"tokenExpirationTimer",null);i(this,"feeds",new k.default(this));i(this,"objects",new w.default(this));i(this,"preferences",new p.default(this));i(this,"slack",new x.default(this));i(this,"msTeams",new g.default(this));i(this,"user",new y.default(this));i(this,"messages",new T.default(this));if(this.apiKey=e,this.host=t.host||m,this.logLevel=t.logLevel,this.log("Initialized Knock instance"),this.apiKey&&this.apiKey.startsWith("sk_"))throw new Error("[Knock] You are using your secret API key on the client. Please use the public key.")}client(){return this.apiClient||(this.apiClient=this.createApiClient()),this.apiClient}authenticate(e,t,n){let o=!1;const c=this.apiClient,a=this.getUserId(e);if(c&&(this.userId!==a||this.userToken!==t)&&(this.log("userId or userToken changed; reinitializing connections"),this.feeds.teardownInstances(),this.teardown(),o=!0),this.userId=a,this.userToken=t,this.log(`Authenticated with userId ${a}`),this.userToken&&(n==null?void 0:n.onUserTokenExpiring)instanceof Function&&this.maybeScheduleUserTokenExpiration(n.onUserTokenExpiring,n.timeBeforeExpirationInMs),o&&(this.apiClient=this.createApiClient(),this.feeds.reinitializeInstances(),this.log("Reinitialized real-time connections")),typeof e=="object"&&(e!=null&&e.id)){const{id:l,...u}=e;this.user.identify(u)}}failIfNotAuthenticated(){if(!this.isAuthenticated())throw new Error("Not authenticated. Please call `authenticate` first.")}isAuthenticated(e=!1){return e?!!(this.userId&&this.userToken):!!this.userId}teardown(){var e;this.tokenExpirationTimer&&clearTimeout(this.tokenExpirationTimer),(e=this.apiClient)!=null&&e.socket&&this.apiClient.socket.isConnected()&&this.apiClient.socket.disconnect()}log(e,t=!1){(this.logLevel==="debug"||t)&&console.log(`[Knock] ${e}`)}createApiClient(){return new f.default({apiKey:this.apiKey,host:this.host,userToken:this.userToken})}async maybeScheduleUserTokenExpiration(e,t=3e4){if(!this.userToken)return;const n=d.jwtDecode(this.userToken),o=(n.exp??0)*1e3,c=Date.now();if(o&&o>c){const a=o-t-c;this.tokenExpirationTimer=setTimeout(async()=>{const l=await e(this.userToken,n);typeof l=="string"&&this.authenticate(this.userId,l,{onUserTokenExpiring:e,timeBeforeExpirationInMs:t})},a)}}getUserId(e){if(typeof e=="string"||!e)return e;if(e!=null&&e.id)return e.id;throw new Error("`user` object must contain an `id` property")}}exports.default=C;
+"use strict";var h=Object.defineProperty;var d=(s,e,i)=>e in s?h(s,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):s[e]=i;var t=(s,e,i)=>d(s,typeof e!="symbol"?e+"":e,i);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("jwt-decode"),f=require("./api.js"),k=require("./clients/feed/index.js"),g=require("./clients/messages/index.js"),T=require("./clients/ms-teams/index.js"),w=require("./clients/objects/index.js"),y=require("./clients/preferences/index.js"),p=require("./clients/slack/index.js"),x=require("./clients/users/index.js"),m="https://api.knock.app";class C{constructor(e,i={}){t(this,"host");t(this,"apiClient",null);t(this,"userId");t(this,"userToken");t(this,"logLevel");t(this,"tokenExpirationTimer",null);t(this,"feeds",new k.default(this));t(this,"objects",new w.default(this));t(this,"preferences",new y.default(this));t(this,"slack",new p.default(this));t(this,"msTeams",new T.default(this));t(this,"user",new x.default(this));t(this,"messages",new g.default(this));if(this.apiKey=e,this.host=i.host||m,this.logLevel=i.logLevel,this.log("Initialized Knock instance"),this.apiKey&&this.apiKey.startsWith("sk_"))throw new Error("[Knock] You are using your secret API key on the client. Please use the public key.")}client(){return this.apiClient||(this.apiClient=this.createApiClient()),this.apiClient}authenticate(e,i,n){let a=!1;const l=this.apiClient,o=this.getUserId(e),c=(n==null?void 0:n.identificationStrategy)||"inline";if(l&&(this.userId!==o||this.userToken!==i)&&(this.log("userId or userToken changed; reinitializing connections"),this.feeds.teardownInstances(),this.teardown(),a=!0),this.userId=o,this.userToken=i,this.log(`Authenticated with userId ${o}`),this.userToken&&(n==null?void 0:n.onUserTokenExpiring)instanceof Function&&this.maybeScheduleUserTokenExpiration(n.onUserTokenExpiring,n.timeBeforeExpirationInMs),a&&(this.apiClient=this.createApiClient(),this.feeds.reinitializeInstances(),this.log("Reinitialized real-time connections")),c==="skip"){this.log("Skipping inline user identification");return}if(c==="inline"&&typeof e=="object"&&(e!=null&&e.id)){this.log(`Identifying user ${e.id} inline`);const{id:E,...u}=e;this.user.identify(u)}}failIfNotAuthenticated(){if(!this.isAuthenticated())throw new Error("Not authenticated. Please call `authenticate` first.")}isAuthenticated(e=!1){return e?!!(this.userId&&this.userToken):!!this.userId}teardown(){var e;this.tokenExpirationTimer&&clearTimeout(this.tokenExpirationTimer),(e=this.apiClient)!=null&&e.socket&&this.apiClient.socket.isConnected()&&this.apiClient.socket.disconnect()}log(e,i=!1){(this.logLevel==="debug"||i)&&console.log(`[Knock] ${e}`)}createApiClient(){return new f.default({apiKey:this.apiKey,host:this.host,userToken:this.userToken})}async maybeScheduleUserTokenExpiration(e,i=3e4){if(!this.userToken)return;const n=r.jwtDecode(this.userToken),a=(n.exp??0)*1e3,l=Date.now();if(a&&a>l){const o=a-i-l;this.tokenExpirationTimer=setTimeout(async()=>{const c=await e(this.userToken,n);typeof c=="string"&&this.authenticate(this.userId,c,{onUserTokenExpiring:e,timeBeforeExpirationInMs:i})},o)}}getUserId(e){if(typeof e=="string"||!e)return e;if(e!=null&&e.id)return e.id;throw new Error("`user` object must contain an `id` property")}}exports.default=C;
 //# sourceMappingURL=knock.js.map

package/dist/cjs/knock.js.map

@@ -1 +1 @@
-{"version":3,"file":"knock.js","sources":["../../src/knock.ts"],"sourcesContent":["import { jwtDecode } from \"jwt-decode\";\n\nimport ApiClient from \"./api\";\nimport FeedClient from \"./clients/feed\";\nimport MessageClient from \"./clients/messages\";\nimport MsTeamsClient from \"./clients/ms-teams\";\nimport ObjectClient from \"./clients/objects\";\nimport Preferences from \"./clients/preferences\";\nimport SlackClient from \"./clients/slack\";\nimport UserClient from \"./clients/users\";\nimport {\n  AuthenticateOptions,\n  KnockOptions,\n  LogLevel,\n  UserId,\n  UserIdOrUserWithProperties,\n  UserTokenExpiringCallback,\n} from \"./interfaces\";\n\nconst DEFAULT_HOST = \"https://api.knock.app\";\n\nclass Knock {\n  public host: string;\n  private apiClient: ApiClient | null = null;\n  public userId: string | undefined | null;\n  public userToken?: string;\n  public logLevel?: LogLevel;\n  private tokenExpirationTimer: ReturnType<typeof setTimeout> | null = null;\n  readonly feeds = new FeedClient(this);\n  readonly objects = new ObjectClient(this);\n  readonly preferences = new Preferences(this);\n  readonly slack = new SlackClient(this);\n  readonly msTeams = new MsTeamsClient(this);\n  readonly user = new UserClient(this);\n  readonly messages = new MessageClient(this);\n\n  constructor(\n    readonly apiKey: string,\n    options: KnockOptions = {},\n  ) {\n    this.host = options.host || DEFAULT_HOST;\n    this.logLevel = options.logLevel;\n\n    this.log(\"Initialized Knock instance\");\n\n    // Fail loudly if we're using the wrong API key\n    if (this.apiKey && this.apiKey.startsWith(\"sk_\")) {\n      throw new Error(\n        \"[Knock] You are using your secret API key on the client. Please use the public key.\",\n      );\n    }\n  }\n\n  client() {\n    // Initiate a new API client if we don't have one yet\n    if (!this.apiClient) {\n      this.apiClient = this.createApiClient();\n    }\n\n    return this.apiClient;\n  }\n\n  /**\n   * @deprecated Passing `userId` as a `string` is deprecated and will be removed in a future version.\n   * Please pass a `user` object instead containing an `id` value.\n   * example:\n   * ```ts\n   * knock.authenticate({ id: \"user_123\" });\n   * ```\n   */\n  authenticate(\n    userIdOrUserWithProperties: UserId,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): never;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): void;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ) {\n    let reinitializeApi = false;\n    const currentApiClient = this.apiClient;\n    const userId = this.getUserId(userIdOrUserWithProperties);\n\n    // If we've previously been initialized and the values have now changed, then we\n    // need to reinitialize any stateful connections we have\n    if (\n      currentApiClient &&\n      (this.userId !== userId || this.userToken !== userToken)\n    ) {\n      this.log(\"userId or userToken changed; reinitializing connections\");\n      this.feeds.teardownInstances();\n      this.teardown();\n      reinitializeApi = true;\n    }\n\n    this.userId = userId;\n    this.userToken = userToken;\n\n    this.log(`Authenticated with userId ${userId}`);\n\n    if (this.userToken && options?.onUserTokenExpiring instanceof Function) {\n      this.maybeScheduleUserTokenExpiration(\n        options.onUserTokenExpiring,\n        options.timeBeforeExpirationInMs,\n      );\n    }\n\n    // If we get the signal to reinitialize the api client, then we want to create a new client\n    // and the reinitialize any existing feed real-time connections we have so everything continues\n    // to work with the new credentials we've been given\n    if (reinitializeApi) {\n      this.apiClient = this.createApiClient();\n      this.feeds.reinitializeInstances();\n      this.log(\"Reinitialized real-time connections\");\n    }\n\n    // Inline identify the user if we've been given an object with an id.\n    if (\n      typeof userIdOrUserWithProperties === \"object\" &&\n      userIdOrUserWithProperties?.id\n    ) {\n      const { id, ...properties } = userIdOrUserWithProperties;\n      this.user.identify(properties);\n    }\n\n    return;\n  }\n\n  failIfNotAuthenticated() {\n    if (!this.isAuthenticated()) {\n      throw new Error(\"Not authenticated. Please call `authenticate` first.\");\n    }\n  }\n\n  /*\n    Returns whether or this Knock instance is authenticated. Passing `true` will check the presence\n    of the userToken as well.\n  */\n  isAuthenticated(checkUserToken = false) {\n    return checkUserToken ? !!(this.userId && this.userToken) : !!this.userId;\n  }\n\n  // Used to teardown any connected instances\n  teardown() {\n    if (this.tokenExpirationTimer) {\n      clearTimeout(this.tokenExpirationTimer);\n    }\n    if (this.apiClient?.socket && this.apiClient.socket.isConnected()) {\n      this.apiClient.socket.disconnect();\n    }\n  }\n\n  log(message: string, force = false) {\n    if (this.logLevel === \"debug\" || force) {\n      console.log(`[Knock] ${message}`);\n    }\n  }\n\n  /**\n   * Initiates an API client\n   */\n  private createApiClient() {\n    return new ApiClient({\n      apiKey: this.apiKey,\n      host: this.host,\n      userToken: this.userToken,\n    });\n  }\n\n  private async maybeScheduleUserTokenExpiration(\n    callbackFn: UserTokenExpiringCallback,\n    timeBeforeExpirationInMs: number = 30_000,\n  ) {\n    if (!this.userToken) return;\n\n    const decoded = jwtDecode(this.userToken);\n    const expiresAtMs = (decoded.exp ?? 0) * 1000;\n    const nowMs = Date.now();\n\n    // Expiration is in the future\n    if (expiresAtMs && expiresAtMs > nowMs) {\n      // Check how long until the token should be regenerated\n      // | ----------------- | ----------------------- |\n      // ^ now               ^ expiration offset       ^ expires at\n      const msInFuture = expiresAtMs - timeBeforeExpirationInMs - nowMs;\n\n      this.tokenExpirationTimer = setTimeout(async () => {\n        const newToken = await callbackFn(this.userToken as string, decoded);\n\n        // Reauthenticate which will handle reinitializing sockets\n        if (typeof newToken === \"string\") {\n          this.authenticate(this.userId!, newToken, {\n            onUserTokenExpiring: callbackFn,\n            timeBeforeExpirationInMs: timeBeforeExpirationInMs,\n          });\n        }\n      }, msInFuture);\n    }\n  }\n\n  /**\n   * Returns the user id from the given userIdOrUserWithProperties\n   * @param userIdOrUserWithProperties - The user id or user object\n   * @returns The user id\n   * @throws {Error} If the user object does not contain an `id` property\n   */\n  private getUserId(userIdOrUserWithProperties: UserIdOrUserWithProperties) {\n    if (\n      typeof userIdOrUserWithProperties === \"string\" ||\n      !userIdOrUserWithProperties\n    ) {\n      return userIdOrUserWithProperties;\n    }\n\n    if (userIdOrUserWithProperties?.id) {\n      return userIdOrUserWithProperties.id;\n    }\n\n    throw new Error(\"`user` object must contain an `id` property\");\n  }\n}\n\nexport default Knock;\n"],"names":["DEFAULT_HOST","Knock","apiKey","options","__publicField","FeedClient","ObjectClient","Preferences","SlackClient","MsTeamsClient","UserClient","MessageClient","userIdOrUserWithProperties","userToken","reinitializeApi","currentApiClient","userId","id","properties","checkUserToken","_a","message","force","ApiClient","callbackFn","timeBeforeExpirationInMs","decoded","jwtDecode","expiresAtMs","nowMs","msInFuture","newToken"],"mappings":"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"}
+{"version":3,"file":"knock.js","sources":["../../src/knock.ts"],"sourcesContent":["import { jwtDecode } from \"jwt-decode\";\n\nimport ApiClient from \"./api\";\nimport FeedClient from \"./clients/feed\";\nimport MessageClient from \"./clients/messages\";\nimport MsTeamsClient from \"./clients/ms-teams\";\nimport ObjectClient from \"./clients/objects\";\nimport Preferences from \"./clients/preferences\";\nimport SlackClient from \"./clients/slack\";\nimport UserClient from \"./clients/users\";\nimport {\n  AuthenticateOptions,\n  KnockOptions,\n  LogLevel,\n  UserId,\n  UserIdOrUserWithProperties,\n  UserTokenExpiringCallback,\n} from \"./interfaces\";\n\nconst DEFAULT_HOST = \"https://api.knock.app\";\n\nclass Knock {\n  public host: string;\n  private apiClient: ApiClient | null = null;\n  public userId: string | undefined | null;\n  public userToken?: string;\n  public logLevel?: LogLevel;\n  private tokenExpirationTimer: ReturnType<typeof setTimeout> | null = null;\n  readonly feeds = new FeedClient(this);\n  readonly objects = new ObjectClient(this);\n  readonly preferences = new Preferences(this);\n  readonly slack = new SlackClient(this);\n  readonly msTeams = new MsTeamsClient(this);\n  readonly user = new UserClient(this);\n  readonly messages = new MessageClient(this);\n\n  constructor(\n    readonly apiKey: string,\n    options: KnockOptions = {},\n  ) {\n    this.host = options.host || DEFAULT_HOST;\n    this.logLevel = options.logLevel;\n\n    this.log(\"Initialized Knock instance\");\n\n    // Fail loudly if we're using the wrong API key\n    if (this.apiKey && this.apiKey.startsWith(\"sk_\")) {\n      throw new Error(\n        \"[Knock] You are using your secret API key on the client. Please use the public key.\",\n      );\n    }\n  }\n\n  client() {\n    // Initiate a new API client if we don't have one yet\n    if (!this.apiClient) {\n      this.apiClient = this.createApiClient();\n    }\n\n    return this.apiClient;\n  }\n\n  /**\n   * @deprecated Passing `userId` as a `string` is deprecated and will be removed in a future version.\n   * Please pass a `user` object instead containing an `id` value.\n   * example:\n   * ```ts\n   * knock.authenticate({ id: \"user_123\" });\n   * ```\n   */\n  authenticate(\n    userIdOrUserWithProperties: UserId,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): never;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): void;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ) {\n    let reinitializeApi = false;\n    const currentApiClient = this.apiClient;\n    const userId = this.getUserId(userIdOrUserWithProperties);\n    const identificationStrategy = options?.identificationStrategy || \"inline\";\n\n    // If we've previously been initialized and the values have now changed, then we\n    // need to reinitialize any stateful connections we have\n    if (\n      currentApiClient &&\n      (this.userId !== userId || this.userToken !== userToken)\n    ) {\n      this.log(\"userId or userToken changed; reinitializing connections\");\n      this.feeds.teardownInstances();\n      this.teardown();\n      reinitializeApi = true;\n    }\n\n    this.userId = userId;\n    this.userToken = userToken;\n\n    this.log(`Authenticated with userId ${userId}`);\n\n    if (this.userToken && options?.onUserTokenExpiring instanceof Function) {\n      this.maybeScheduleUserTokenExpiration(\n        options.onUserTokenExpiring,\n        options.timeBeforeExpirationInMs,\n      );\n    }\n\n    // If we get the signal to reinitialize the api client, then we want to create a new client\n    // and the reinitialize any existing feed real-time connections we have so everything continues\n    // to work with the new credentials we've been given\n    if (reinitializeApi) {\n      this.apiClient = this.createApiClient();\n      this.feeds.reinitializeInstances();\n      this.log(\"Reinitialized real-time connections\");\n    }\n\n    // We explicitly skip the inline identification if the strategy is set to \"skip\"\n    if (identificationStrategy === \"skip\") {\n      this.log(\"Skipping inline user identification\");\n      return;\n    }\n\n    // Inline identify the user if we've been given an object with an id\n    // and the strategy is set to \"inline\".\n    if (\n      identificationStrategy === \"inline\" &&\n      typeof userIdOrUserWithProperties === \"object\" &&\n      userIdOrUserWithProperties?.id\n    ) {\n      this.log(`Identifying user ${userIdOrUserWithProperties.id} inline`);\n      const { id, ...properties } = userIdOrUserWithProperties;\n      this.user.identify(properties);\n    }\n\n    return;\n  }\n\n  failIfNotAuthenticated() {\n    if (!this.isAuthenticated()) {\n      throw new Error(\"Not authenticated. Please call `authenticate` first.\");\n    }\n  }\n\n  /*\n    Returns whether or this Knock instance is authenticated. Passing `true` will check the presence\n    of the userToken as well.\n  */\n  isAuthenticated(checkUserToken = false) {\n    return checkUserToken ? !!(this.userId && this.userToken) : !!this.userId;\n  }\n\n  // Used to teardown any connected instances\n  teardown() {\n    if (this.tokenExpirationTimer) {\n      clearTimeout(this.tokenExpirationTimer);\n    }\n    if (this.apiClient?.socket && this.apiClient.socket.isConnected()) {\n      this.apiClient.socket.disconnect();\n    }\n  }\n\n  log(message: string, force = false) {\n    if (this.logLevel === \"debug\" || force) {\n      console.log(`[Knock] ${message}`);\n    }\n  }\n\n  /**\n   * Initiates an API client\n   */\n  private createApiClient() {\n    return new ApiClient({\n      apiKey: this.apiKey,\n      host: this.host,\n      userToken: this.userToken,\n    });\n  }\n\n  private async maybeScheduleUserTokenExpiration(\n    callbackFn: UserTokenExpiringCallback,\n    timeBeforeExpirationInMs: number = 30_000,\n  ) {\n    if (!this.userToken) return;\n\n    const decoded = jwtDecode(this.userToken);\n    const expiresAtMs = (decoded.exp ?? 0) * 1000;\n    const nowMs = Date.now();\n\n    // Expiration is in the future\n    if (expiresAtMs && expiresAtMs > nowMs) {\n      // Check how long until the token should be regenerated\n      // | ----------------- | ----------------------- |\n      // ^ now               ^ expiration offset       ^ expires at\n      const msInFuture = expiresAtMs - timeBeforeExpirationInMs - nowMs;\n\n      this.tokenExpirationTimer = setTimeout(async () => {\n        const newToken = await callbackFn(this.userToken as string, decoded);\n\n        // Reauthenticate which will handle reinitializing sockets\n        if (typeof newToken === \"string\") {\n          this.authenticate(this.userId!, newToken, {\n            onUserTokenExpiring: callbackFn,\n            timeBeforeExpirationInMs: timeBeforeExpirationInMs,\n          });\n        }\n      }, msInFuture);\n    }\n  }\n\n  /**\n   * Returns the user id from the given userIdOrUserWithProperties\n   * @param userIdOrUserWithProperties - The user id or user object\n   * @returns The user id\n   * @throws {Error} If the user object does not contain an `id` property\n   */\n  private getUserId(userIdOrUserWithProperties: UserIdOrUserWithProperties) {\n    if (\n      typeof userIdOrUserWithProperties === \"string\" ||\n      !userIdOrUserWithProperties\n    ) {\n      return userIdOrUserWithProperties;\n    }\n\n    if (userIdOrUserWithProperties?.id) {\n      return userIdOrUserWithProperties.id;\n    }\n\n    throw new Error(\"`user` object must contain an `id` property\");\n  }\n}\n\nexport default Knock;\n"],"names":["DEFAULT_HOST","Knock","apiKey","options","__publicField","FeedClient","ObjectClient","Preferences","SlackClient","MsTeamsClient","UserClient","MessageClient","userIdOrUserWithProperties","userToken","reinitializeApi","currentApiClient","userId","identificationStrategy","id","properties","checkUserToken","_a","message","force","ApiClient","callbackFn","timeBeforeExpirationInMs","decoded","jwtDecode","expiresAtMs","nowMs","msInFuture","newToken"],"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.17.1";
+    return "Knock/ClientJS 0.18.0";
   }
 }
 export {

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

@@ -3,21 +3,21 @@ var G = (a, e, t) => e in a ? v(a, e, { enumerable: !0, configurable: !0, writab
 var d = (a, e, t) => G(a, typeof e != "symbol" ? e + "" : e, t);
 import { Store as _ } from "@tanstack/store";
 import { URLPattern as b } from "urlpattern-polyfill";
-import { byKey as C, mockDefaultGroup as I, formatFilters as g, findDefaultGroup as y, DEFAULT_GROUP_KEY as p, checkIfThrottled as w, SelectionResult as E, newUrl as A, predicateUrlRules as R, predicateUrlPatterns as L } from "./helpers.mjs";
+import { byKey as C, mockDefaultGroup as I, formatFilters as g, findDefaultGroup as m, DEFAULT_GROUP_KEY as p, checkIfThrottled as w, SelectionResult as E, newUrl as A, predicateUrlRules as R, predicateUrlPatterns as L } from "./helpers.mjs";
 const P = 50, D = 30 * 1e3, T = 3, k = {
   GUIDE_KEY: "knock_guide_key",
   PREVIEW_SESSION_ID: "knock_preview_session_id"
 }, l = () => {
   if (typeof window < "u")
     return window;
-}, K = (a) => `/v1/users/${a}/guides`, f = () => {
+}, O = (a) => `/v1/users/${a}/guides`, f = () => {
   const a = l();
   if (!a)
     return { forcedGuideKey: null, previewSessionId: null };
   const e = new URLSearchParams(a.location.search), t = e.get(k.GUIDE_KEY), s = e.get(k.PREVIEW_SESSION_ID);
   return { forcedGuideKey: t, previewSessionId: s };
-}, m = (a, e = {}) => {
-  const t = new E(), s = y(a.guideGroups);
+}, y = (a, e = {}) => {
+  const t = new E(), s = m(a.guideGroups);
   if (!s) return t;
   const i = [...s.display_sequence], n = a.location;
   if (a.debug.forcedGuideKey) {
@@ -26,19 +26,19 @@ const P = 50, D = 30 * 1e3, T = 3, k = {
   }
   for (const [r, o] of i.entries()) {
     let u = a.guides[o];
-    a.debug.forcedGuideKey === o && a.previewGuides[o] && (u = a.previewGuides[o]), !(!u || !O(u, {
+    a.debug.forcedGuideKey === o && a.previewGuides[o] && (u = a.previewGuides[o]), !(!u || !K(u, {
       location: n,
       filters: e,
       debug: a.debug
     })) && t.set(r, u);
   }
   return t.metadata = { guideGroup: s }, t;
-}, O = (a, { location: e, filters: t = {}, debug: s = {} }) => {
+}, K = (a, { location: e, filters: t = {}, debug: s = {} }) => {
   if (t.type && t.type !== a.type || t.key && t.key !== a.key)
     return !1;
   if (s.forcedGuideKey === a.key)
     return !0;
-  if (a.steps.every((o) => !!o.message.archived_at))
+  if (!a.active || a.steps.every((o) => !!o.message.archived_at))
     return !1;
   const i = e ? A(e) : void 0, n = a.activation_url_rules || [], r = a.activation_url_patterns || [];
   if (i && n.length > 0) {
@@ -220,17 +220,17 @@ class j {
   // Store selector
   //
   selectGuides(e, t = {}) {
-    if (Object.keys(e.guides).length === 0)
+    if (Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0)
       return [];
     this.knock.log(`[Guide] Selecting guides for: ${g(t)}`);
-    const s = m(e, t);
+    const s = y(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)
+    if (Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0)
       return;
     this.knock.log(`[Guide] Selecting a guide for: ${g(t)}`);
-    const s = m(e, t);
+    const s = y(e, t);
     if (s.size === 0) {
       this.knock.log("[Guide] Selection returned zero result");
       return;
@@ -238,7 +238,7 @@ class j {
     const [i, n] = [...s][0];
     if (n.bypass_global_group_limit)
       return n;
-    const r = y(e.guideGroups), o = e.guideGroupDisplayLogs[p];
+    const r = m(e.guideGroups), o = e.guideGroupDisplayLogs[p];
     if (!(r && r.display_interval && o && w(
       o,
       r.display_interval
@@ -421,7 +421,7 @@ class j {
   formatQueryKey(e) {
     const s = Object.keys(e).sort().map(
       (n) => `${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`
-    ).join("&"), i = K(this.knock.userId);
+    ).join("&"), i = O(this.knock.userId);
     return s ? `${i}?${s}` : i;
   }
   setStepMessageAttrs(e, t, s) {
@@ -521,6 +521,6 @@ class j {
 export {
   k as DEBUG_QUERY_PARAMS,
   j as KnockGuideClient,
-  K as guidesApiRootPath
+  O 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  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params like \"knock_guide_key\" from URL.\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const forcedGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const previewSessionId = urlParams.get(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n\n  return { forcedGuideKey, previewSessionId };\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    // 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 debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\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<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\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    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    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        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      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  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","forcedGuideKey","previewSessionId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","debugState","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
+{"version":3,"file":"client.mjs","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  checkIfThrottled,\n  findDefaultGroup,\n  formatFilters,\n  mockDefaultGroup,\n  newUrl,\n  predicateUrlPatterns,\n  predicateUrlRules,\n} from \"./helpers\";\nimport {\n  Any,\n  ConstructorOpts,\n  DebugState,\n  GetGuidesQueryParams,\n  GetGuidesResponse,\n  GroupStage,\n  GuideAddedEvent,\n  GuideData,\n  GuideGroupAddedEvent,\n  GuideGroupUpdatedEvent,\n  GuideLivePreviewUpdatedEvent,\n  GuideRemovedEvent,\n  GuideSocketEvent,\n  GuideStepData,\n  GuideUpdatedEvent,\n  KnockGuide,\n  KnockGuideStep,\n  MarkAsArchivedParams,\n  MarkAsInteractedParams,\n  MarkAsSeenParams,\n  MarkGuideAsResponse,\n  QueryFilterParams,\n  QueryStatus,\n  SelectFilterParams,\n  StepMessageState,\n  StoreState,\n  TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n  GUIDE_KEY: \"knock_guide_key\",\n  PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n  `/v1/users/${userId}/guides`;\n\n// Detect debug params like \"knock_guide_key\" from URL.\nconst detectDebugParams = (): DebugState => {\n  const win = checkForWindow();\n  if (!win) {\n    return { forcedGuideKey: null, previewSessionId: null };\n  }\n\n  const urlParams = new URLSearchParams(win.location.search);\n  const forcedGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n  const previewSessionId = urlParams.get(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n\n  return { forcedGuideKey, previewSessionId };\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n  // A map of selected guides as values, with its order index as keys.\n  const result = new SelectionResult();\n\n  const defaultGroup = findDefaultGroup(state.guideGroups);\n  if (!defaultGroup) return result;\n\n  const displaySequence = [...defaultGroup.display_sequence];\n  const location = state.location;\n\n  // If in debug mode, put the forced guide at the beginning of the display sequence.\n  if (state.debug.forcedGuideKey) {\n    const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n    if (forcedKeyIndex > -1) {\n      displaySequence.splice(forcedKeyIndex, 1);\n    }\n    displaySequence.unshift(state.debug.forcedGuideKey);\n  }\n\n  for (const [index, guideKey] of displaySequence.entries()) {\n    let guide = state.guides[guideKey];\n\n    // Use preview guide if it exists and matches the forced guide key\n    if (\n      state.debug.forcedGuideKey === guideKey &&\n      state.previewGuides[guideKey]\n    ) {\n      guide = state.previewGuides[guideKey];\n    }\n\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, {\n      location,\n      filters,\n      debug: state.debug,\n    });\n\n    if (!affirmed) continue;\n\n    result.set(index, guide);\n  }\n\n  result.metadata = { guideGroup: defaultGroup };\n  return result;\n};\n\ntype PredicateOpts = {\n  location?: string | undefined;\n  filters?: SelectFilterParams | undefined;\n  debug: DebugState;\n};\n\nconst predicate = (\n  guide: KnockGuide,\n  { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n  if (filters.type && filters.type !== guide.type) {\n    return false;\n  }\n\n  if (filters.key && filters.key !== guide.key) {\n    return false;\n  }\n\n  // Bypass filtering if the debugged guide matches the given filters.\n  // This should always run AFTER checking the filters but BEFORE\n  // checking archived status and location rules.\n  if (debug.forcedGuideKey === guide.key) {\n    return true;\n  }\n\n  if (!guide.active) {\n    return false;\n  }\n\n  if (guide.steps.every((s) => !!s.message.archived_at)) {\n    return false;\n  }\n\n  const url = location ? newUrl(location) : undefined;\n\n  const urlRules = guide.activation_url_rules || [];\n  const urlPatterns = guide.activation_url_patterns || [];\n\n  // A guide can have either activation url rules XOR url patterns, but not both.\n  if (url && urlRules.length > 0) {\n    const allowed = predicateUrlRules(url, urlRules);\n    if (!allowed) return false;\n  } else if (url && urlPatterns.length > 0) {\n    const allowed = predicateUrlPatterns(url, urlPatterns);\n    if (!allowed) return false;\n  }\n\n  return true;\n};\n\nexport class KnockGuideClient {\n  public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n  // Phoenix channels for real time guide updates over websocket\n  private socket: Socket | undefined;\n  private socketChannel: Channel | undefined;\n  private socketChannelTopic: string;\n  private socketEventTypes = [\n    \"guide.added\",\n    \"guide.updated\",\n    \"guide.removed\",\n    \"guide_group.added\",\n    \"guide_group.updated\",\n    \"guide.live_preview_updated\",\n  ];\n  private subscribeRetryCount = 0;\n\n  // Original history methods to monkey patch, or restore in cleanups.\n  private pushStateFn: History[\"pushState\"] | undefined;\n  private replaceStateFn: History[\"replaceState\"] | undefined;\n\n  // Guides that are competing to render are \"staged\" first without rendering\n  // and ranked based on its relative order in the group over a duration of time\n  // to resolve and render the prevailing one.\n  private stage: GroupStage | undefined;\n\n  private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n  constructor(\n    readonly knock: Knock,\n    readonly channelId: string,\n    readonly targetParams: TargetParams = {},\n    readonly options: ConstructorOpts = {},\n  ) {\n    const { trackLocationFromWindow = true } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n    const debug = detectDebugParams();\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      previewGuides: {},\n      queries: {},\n      location,\n      // Increment to update the state store and trigger re-selection.\n      counter: 0,\n      debug,\n    });\n\n    // In server environments we might not have a socket connection.\n    const { socket: maybeSocket } = this.knock.client();\n    this.socket = maybeSocket;\n    this.socketChannelTopic = `guides:${channelId}`;\n\n    if (trackLocationFromWindow) {\n      this.listenForLocationChangesFromWindow();\n    }\n\n    // 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 debugState = this.store.state.debug;\n    const params = {\n      ...this.targetParams,\n      user_id: this.knock.userId,\n      force_all_guides: debugState.forcedGuideKey ? true : undefined,\n      preview_session_id: debugState.previewSessionId || undefined,\n    };\n\n    const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n    for (const eventType of this.socketEventTypes) {\n      newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n    }\n\n    if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n      // Reset retry count for new subscription attempt\n      this.subscribeRetryCount = 0;\n\n      newChannel\n        .join()\n        .receive(\"ok\", () => {\n          this.knock.log(\"[Guide] Successfully joined channel\");\n        })\n        .receive(\"error\", (resp) => {\n          this.knock.log(\n            `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n          );\n          this.handleChannelJoinError();\n        })\n        .receive(\"timeout\", () => {\n          this.knock.log(\"[Guide] Channel join timed out\");\n          this.handleChannelJoinError();\n        });\n    }\n\n    // Track the joined channel.\n    this.socketChannel = newChannel;\n  }\n\n  private handleChannelJoinError() {\n    // Prevent phx channel from retrying forever in case of either network or\n    // other errors (e.g. auth error, invalid channel etc)\n    if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n      this.knock.log(\n        `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n      );\n      this.unsubscribe();\n      return;\n    }\n\n    this.subscribeRetryCount++;\n  }\n\n  unsubscribe() {\n    if (!this.socketChannel) return;\n    this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n    // Unsubscribe from the socket events and leave the channel.\n    for (const eventType of this.socketEventTypes) {\n      this.socketChannel.off(eventType);\n    }\n    this.socketChannel.leave();\n\n    // Unset the channel.\n    this.socketChannel = undefined;\n  }\n\n  private handleSocketEvent(payload: GuideSocketEvent) {\n    const { event, data } = payload;\n\n    switch (event) {\n      case \"guide.added\":\n        return this.addOrReplaceGuide(payload);\n\n      case \"guide.updated\":\n        return data.eligible\n          ? this.addOrReplaceGuide(payload)\n          : this.removeGuide(payload);\n\n      case \"guide.removed\":\n        return this.removeGuide(payload);\n\n      case \"guide_group.added\":\n      case \"guide_group.updated\":\n        return this.addOrReplaceGuideGroup(payload);\n\n      case \"guide.live_preview_updated\":\n        return this.updatePreviewGuide(payload);\n\n      default:\n        return;\n    }\n  }\n\n  setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n    // Make sure to clear out the stage.\n    this.clearGroupStage();\n\n    this.store.setState((state) => {\n      // Clear preview guides if no longer in preview mode\n      const previewGuides = additionalParams?.debug?.previewSessionId\n        ? state.previewGuides\n        : {};\n\n      return {\n        ...state,\n        ...additionalParams,\n        previewGuides,\n        location: href,\n      };\n    });\n  }\n\n  //\n  // Store selector\n  //\n\n  selectGuides<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C>[] {\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\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<C = Any>(\n    state: StoreState,\n    filters: SelectFilterParams = {},\n  ): KnockGuide<C> | undefined {\n    if (\n      Object.keys(state.guides).length === 0 &&\n      Object.keys(state.previewGuides).length === 0\n    ) {\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    // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n    let resolved = undefined;\n    if (this.store.state.debug.forcedGuideKey) {\n      resolved = this.stage.ordered.find(\n        (x) => x === this.store.state.debug.forcedGuideKey,\n      );\n    }\n\n    if (!resolved) {\n      resolved = this.stage.ordered.find((x) => x !== undefined);\n    }\n\n    this.stage = {\n      ...this.stage,\n      status: \"closed\",\n      resolved,\n      timeoutId: null,\n    };\n\n    return this.stage;\n  }\n\n  // Set the current closed stage status to \"patch\" to allow re-running\n  // selections and re-building a group stage with the latest/updated state,\n  // while keeping the currently resolved guide in place so that it stays\n  // rendered until we are ready to resolve the updated stage and re-render.\n  // Note, must be called ahead of updating the state store.\n  private patchClosedGroupStage() {\n    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        // If debugging this guide, return the first step regardless of archive status\n        if (self.store.state.debug.forcedGuideKey === this.key) {\n          return this.steps[0];\n        }\n\n        return this.steps.find((s) => !s.message.archived_at);\n      },\n    } as KnockGuide;\n\n    localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n    localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n      const localStep = {\n        ...rest,\n        message: { ...message },\n        markAsSeen() {\n          // Send a seen event if it has not been previously seen.\n          if (this.message.seen_at) return;\n          return self.markAsSeen(localGuide, this);\n        },\n        markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n          // Always send an interaction event through.\n          return self.markAsInteracted(localGuide, this, metadata);\n        },\n        markAsArchived() {\n          // Send an archived event if it has not been previously archived.\n          if (this.message.archived_at) return;\n          return self.markAsArchived(localGuide, this);\n        },\n      };\n\n      // Bind all engagement action handler methods to the local step object so\n      // they can operate on itself.\n      localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n      localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n      localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n      return localStep;\n    });\n\n    localGuide.activation_url_patterns =\n      remoteGuide.activation_url_patterns.map((rule) => {\n        return {\n          ...rule,\n          pattern: new URLPattern({ pathname: rule.pathname }),\n        };\n      });\n\n    return localGuide;\n  }\n\n  private buildQueryParams(filterParams: QueryFilterParams = {}) {\n    // Combine the target params with the given filter params.\n    const combinedParams: GenericData = {\n      ...this.targetParams,\n      ...filterParams,\n    };\n\n    // Append debug params\n    const debugState = this.store.state.debug;\n    if (debugState.forcedGuideKey) {\n      combinedParams.force_all_guides = true;\n    }\n\n    // Prune out any keys that have an undefined or null value.\n    let params = Object.fromEntries(\n      Object.entries(combinedParams).filter(\n        ([_k, v]) => v !== undefined && v !== null,\n      ),\n    );\n\n    // Encode target data as a JSON string, if provided.\n    params = params.data\n      ? { ...params, data: JSON.stringify(params.data) }\n      : params;\n\n    return params as GetGuidesQueryParams;\n  }\n\n  private formatQueryKey(queryParams: GenericData) {\n    const sortedKeys = Object.keys(queryParams).sort();\n\n    const queryStr = sortedKeys\n      .map(\n        (key) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n      )\n      .join(\"&\");\n\n    const basePath = guidesApiRootPath(this.knock.userId);\n    return queryStr ? `${basePath}?${queryStr}` : basePath;\n  }\n\n  private setStepMessageAttrs(\n    guideKey: string,\n    stepRef: string,\n    attrs: Partial<StepMessageState>,\n  ) {\n    let updatedStep: KnockGuideStep | undefined;\n\n    // If we are marking as archived, clear the group stage so we can render\n    // the next guide in the group.\n    if (attrs.archived_at) {\n      this.clearGroupStage();\n    }\n\n    this.store.setState((state) => {\n      const guide = state.guides[guideKey];\n      if (!guide) return state;\n\n      const steps = guide.steps.map((step) => {\n        if (step.ref !== stepRef) return step;\n\n        // Mutate in place and maintain the same obj ref so to make it easier\n        // to use in hook deps.\n        step.message = { ...step.message, ...attrs };\n        updatedStep = step;\n\n        return step;\n      });\n      // Mutate in place and maintain the same obj ref.\n      guide.steps = steps;\n      const guides = { ...state.guides, [guide.key]: guide };\n\n      // If the guide is subject to throttled settings and we are marking as\n      // archived, then update the display logs to start a new throttle window.\n      const guideGroupDisplayLogs =\n        attrs.archived_at && !guide.bypass_global_group_limit\n          ? {\n              ...state.guideGroupDisplayLogs,\n              [DEFAULT_GROUP_KEY]: attrs.archived_at,\n            }\n          : state.guideGroupDisplayLogs;\n\n      return { ...state, guides, guideGroupDisplayLogs };\n    });\n\n    return updatedStep;\n  }\n\n  private buildEngagementEventBaseParams(\n    guide: GuideData,\n    step: GuideStepData,\n  ) {\n    return {\n      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  private updatePreviewGuide({ data }: GuideLivePreviewUpdatedEvent) {\n    const guide = this.localCopy(data.guide);\n\n    this.store.setState((state) => {\n      const previewGuides = { ...state.previewGuides, [guide.key]: guide };\n      return { ...state, previewGuides };\n    });\n  }\n\n  // Define as an arrow func property to always bind this to the class instance.\n  private handleLocationChange = () => {\n    const win = checkForWindow();\n    if (!win?.location) return;\n\n    const href = win.location.href;\n    if (this.store.state.location === href) return;\n\n    this.knock.log(`[Guide] Handle Location change: ${href}`);\n\n    // If entering debug mode, fetch all guides.\n    const currentDebugParams = this.store.state.debug;\n    const newDebugParams = detectDebugParams();\n    this.setLocation(href, { debug: newDebugParams });\n\n    // If debug state has changed, refetch guides and resubscribe to the websocket channel\n    const debugStateChanged = this.checkDebugStateChanged(\n      currentDebugParams,\n      newDebugParams,\n    );\n\n    if (debugStateChanged) {\n      this.knock.log(\n        `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  };\n\n  // Returns whether debug params have changed. For guide key, we only check\n  // presence since the exact value has no impact on fetch/subscribe\n  private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n    return (\n      Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n      a.previewSessionId !== b.previewSessionId\n    );\n  }\n\n  private listenForLocationChangesFromWindow() {\n    const win = checkForWindow();\n    if (win?.history) {\n      // 1. Listen for browser back/forward button clicks.\n      win.addEventListener(\"popstate\", this.handleLocationChange);\n\n      // 2. Listen for hash changes in case it's used for routing.\n      win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n      // 3. Monkey-patch history methods to catch programmatic navigation.\n      const pushStateFn = win.history.pushState;\n      const replaceStateFn = win.history.replaceState;\n\n      // Use setTimeout to allow the browser state to potentially settle.\n      win.history.pushState = new Proxy(pushStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n      win.history.replaceState = new Proxy(replaceStateFn, {\n        apply: (target, history, args) => {\n          Reflect.apply(target, history, args);\n          setTimeout(() => {\n            this.handleLocationChange();\n          }, 0);\n        },\n      });\n\n      // 4. Keep refs to the original handlers so we can restore during cleanup.\n      this.pushStateFn = pushStateFn;\n      this.replaceStateFn = replaceStateFn;\n    } else {\n      this.knock.log(\n        \"[Guide] Unable to access the `window.history` object to detect location changes\",\n      );\n    }\n  }\n\n  private removeEventListeners() {\n    const win = checkForWindow();\n    if (!win?.history) return;\n\n    win.removeEventListener(\"popstate\", this.handleLocationChange);\n    win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n    if (this.pushStateFn) {\n      win.history.pushState = this.pushStateFn;\n      this.pushStateFn = undefined;\n    }\n    if (this.replaceStateFn) {\n      win.history.replaceState = this.replaceStateFn;\n      this.replaceStateFn = undefined;\n    }\n  }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","forcedGuideKey","previewSessionId","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","debugState","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","throttleWindowStartedAt","DEFAULT_GROUP_KEY","checkIfThrottled","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guides","guideGroupDisplayLogs","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}

package/dist/esm/knock.mjs

@@ -1,32 +1,32 @@
 var r = Object.defineProperty;
-var u = (s, e, t) => e in s ? r(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var i = (s, e, t) => u(s, typeof e != "symbol" ? e + "" : e, t);
-import { jwtDecode as f } from "jwt-decode";
+var f = (s, i, e) => i in s ? r(s, i, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[i] = e;
+var t = (s, i, e) => f(s, typeof i != "symbol" ? i + "" : i, e);
+import { jwtDecode as u } from "jwt-decode";
 import k from "./api.mjs";
 import m from "./clients/feed/index.mjs";
-import p from "./clients/messages/index.mjs";
-import d from "./clients/ms-teams/index.mjs";
-import T from "./clients/objects/index.mjs";
-import g from "./clients/preferences/index.mjs";
+import d from "./clients/messages/index.mjs";
+import g from "./clients/ms-teams/index.mjs";
+import p from "./clients/objects/index.mjs";
+import T from "./clients/preferences/index.mjs";
 import w from "./clients/slack/index.mjs";
 import C from "./clients/users/index.mjs";
 const y = "https://api.knock.app";
-class S {
-  constructor(e, t = {}) {
-    i(this, "host");
-    i(this, "apiClient", null);
-    i(this, "userId");
-    i(this, "userToken");
-    i(this, "logLevel");
-    i(this, "tokenExpirationTimer", null);
-    i(this, "feeds", new m(this));
-    i(this, "objects", new T(this));
-    i(this, "preferences", new g(this));
-    i(this, "slack", new w(this));
-    i(this, "msTeams", new d(this));
-    i(this, "user", new C(this));
-    i(this, "messages", new p(this));
-    if (this.apiKey = e, this.host = t.host || y, this.logLevel = t.logLevel, this.log("Initialized Knock instance"), this.apiKey && this.apiKey.startsWith("sk_"))
+class D {
+  constructor(i, e = {}) {
+    t(this, "host");
+    t(this, "apiClient", null);
+    t(this, "userId");
+    t(this, "userToken");
+    t(this, "logLevel");
+    t(this, "tokenExpirationTimer", null);
+    t(this, "feeds", new m(this));
+    t(this, "objects", new p(this));
+    t(this, "preferences", new T(this));
+    t(this, "slack", new w(this));
+    t(this, "msTeams", new g(this));
+    t(this, "user", new C(this));
+    t(this, "messages", new d(this));
+    if (this.apiKey = i, this.host = e.host || y, this.logLevel = e.logLevel, this.log("Initialized Knock instance"), this.apiKey && this.apiKey.startsWith("sk_"))
       throw new Error(
         "[Knock] You are using your secret API key on the client. Please use the public key."
       );
@@ -34,15 +34,20 @@ class S {
   client() {
     return this.apiClient || (this.apiClient = this.createApiClient()), this.apiClient;
   }
-  authenticate(e, t, n) {
+  authenticate(i, e, n) {
     let o = !1;
-    const c = this.apiClient, a = this.getUserId(e);
-    if (c && (this.userId !== a || this.userToken !== t) && (this.log("userId or userToken changed; reinitializing connections"), this.feeds.teardownInstances(), this.teardown(), o = !0), this.userId = a, this.userToken = t, this.log(`Authenticated with userId ${a}`), this.userToken && (n == null ? void 0 : n.onUserTokenExpiring) instanceof Function && this.maybeScheduleUserTokenExpiration(
+    const l = this.apiClient, a = this.getUserId(i), c = (n == null ? void 0 : n.identificationStrategy) || "inline";
+    if (l && (this.userId !== a || this.userToken !== e) && (this.log("userId or userToken changed; reinitializing connections"), this.feeds.teardownInstances(), this.teardown(), o = !0), this.userId = a, this.userToken = e, this.log(`Authenticated with userId ${a}`), this.userToken && (n == null ? void 0 : n.onUserTokenExpiring) instanceof Function && this.maybeScheduleUserTokenExpiration(
       n.onUserTokenExpiring,
       n.timeBeforeExpirationInMs
-    ), o && (this.apiClient = this.createApiClient(), this.feeds.reinitializeInstances(), this.log("Reinitialized real-time connections")), typeof e == "object" && (e != null && e.id)) {
-      const { id: h, ...l } = e;
-      this.user.identify(l);
+    ), o && (this.apiClient = this.createApiClient(), this.feeds.reinitializeInstances(), this.log("Reinitialized real-time connections")), c === "skip") {
+      this.log("Skipping inline user identification");
+      return;
+    }
+    if (c === "inline" && typeof i == "object" && (i != null && i.id)) {
+      this.log(`Identifying user ${i.id} inline`);
+      const { id: A, ...h } = i;
+      this.user.identify(h);
     }
   }
   failIfNotAuthenticated() {
@@ -53,16 +58,16 @@ class S {
     Returns whether or this Knock instance is authenticated. Passing `true` will check the presence
     of the userToken as well.
   */
-  isAuthenticated(e = !1) {
-    return e ? !!(this.userId && this.userToken) : !!this.userId;
+  isAuthenticated(i = !1) {
+    return i ? !!(this.userId && this.userToken) : !!this.userId;
   }
   // Used to teardown any connected instances
   teardown() {
-    var e;
-    this.tokenExpirationTimer && clearTimeout(this.tokenExpirationTimer), (e = this.apiClient) != null && e.socket && this.apiClient.socket.isConnected() && this.apiClient.socket.disconnect();
+    var i;
+    this.tokenExpirationTimer && clearTimeout(this.tokenExpirationTimer), (i = this.apiClient) != null && i.socket && this.apiClient.socket.isConnected() && this.apiClient.socket.disconnect();
   }
-  log(e, t = !1) {
-    (this.logLevel === "debug" || t) && console.log(`[Knock] ${e}`);
+  log(i, e = !1) {
+    (this.logLevel === "debug" || e) && console.log(`[Knock] ${i}`);
   }
   /**
    * Initiates an API client
@@ -74,16 +79,16 @@ class S {
       userToken: this.userToken
     });
   }
-  async maybeScheduleUserTokenExpiration(e, t = 3e4) {
+  async maybeScheduleUserTokenExpiration(i, e = 3e4) {
     if (!this.userToken) return;
-    const n = f(this.userToken), o = (n.exp ?? 0) * 1e3, c = Date.now();
-    if (o && o > c) {
-      const a = o - t - c;
+    const n = u(this.userToken), o = (n.exp ?? 0) * 1e3, l = Date.now();
+    if (o && o > l) {
+      const a = o - e - l;
       this.tokenExpirationTimer = setTimeout(async () => {
-        const h = await e(this.userToken, n);
-        typeof h == "string" && this.authenticate(this.userId, h, {
-          onUserTokenExpiring: e,
-          timeBeforeExpirationInMs: t
+        const c = await i(this.userToken, n);
+        typeof c == "string" && this.authenticate(this.userId, c, {
+          onUserTokenExpiring: i,
+          timeBeforeExpirationInMs: e
         });
       }, a);
     }
@@ -94,15 +99,15 @@ class S {
    * @returns The user id
    * @throws {Error} If the user object does not contain an `id` property
    */
-  getUserId(e) {
-    if (typeof e == "string" || !e)
-      return e;
-    if (e != null && e.id)
-      return e.id;
+  getUserId(i) {
+    if (typeof i == "string" || !i)
+      return i;
+    if (i != null && i.id)
+      return i.id;
     throw new Error("`user` object must contain an `id` property");
   }
 }
 export {
-  S as default
+  D as default
 };
 //# sourceMappingURL=knock.mjs.map

package/dist/esm/knock.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"knock.mjs","sources":["../../src/knock.ts"],"sourcesContent":["import { jwtDecode } from \"jwt-decode\";\n\nimport ApiClient from \"./api\";\nimport FeedClient from \"./clients/feed\";\nimport MessageClient from \"./clients/messages\";\nimport MsTeamsClient from \"./clients/ms-teams\";\nimport ObjectClient from \"./clients/objects\";\nimport Preferences from \"./clients/preferences\";\nimport SlackClient from \"./clients/slack\";\nimport UserClient from \"./clients/users\";\nimport {\n  AuthenticateOptions,\n  KnockOptions,\n  LogLevel,\n  UserId,\n  UserIdOrUserWithProperties,\n  UserTokenExpiringCallback,\n} from \"./interfaces\";\n\nconst DEFAULT_HOST = \"https://api.knock.app\";\n\nclass Knock {\n  public host: string;\n  private apiClient: ApiClient | null = null;\n  public userId: string | undefined | null;\n  public userToken?: string;\n  public logLevel?: LogLevel;\n  private tokenExpirationTimer: ReturnType<typeof setTimeout> | null = null;\n  readonly feeds = new FeedClient(this);\n  readonly objects = new ObjectClient(this);\n  readonly preferences = new Preferences(this);\n  readonly slack = new SlackClient(this);\n  readonly msTeams = new MsTeamsClient(this);\n  readonly user = new UserClient(this);\n  readonly messages = new MessageClient(this);\n\n  constructor(\n    readonly apiKey: string,\n    options: KnockOptions = {},\n  ) {\n    this.host = options.host || DEFAULT_HOST;\n    this.logLevel = options.logLevel;\n\n    this.log(\"Initialized Knock instance\");\n\n    // Fail loudly if we're using the wrong API key\n    if (this.apiKey && this.apiKey.startsWith(\"sk_\")) {\n      throw new Error(\n        \"[Knock] You are using your secret API key on the client. Please use the public key.\",\n      );\n    }\n  }\n\n  client() {\n    // Initiate a new API client if we don't have one yet\n    if (!this.apiClient) {\n      this.apiClient = this.createApiClient();\n    }\n\n    return this.apiClient;\n  }\n\n  /**\n   * @deprecated Passing `userId` as a `string` is deprecated and will be removed in a future version.\n   * Please pass a `user` object instead containing an `id` value.\n   * example:\n   * ```ts\n   * knock.authenticate({ id: \"user_123\" });\n   * ```\n   */\n  authenticate(\n    userIdOrUserWithProperties: UserId,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): never;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): void;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ) {\n    let reinitializeApi = false;\n    const currentApiClient = this.apiClient;\n    const userId = this.getUserId(userIdOrUserWithProperties);\n\n    // If we've previously been initialized and the values have now changed, then we\n    // need to reinitialize any stateful connections we have\n    if (\n      currentApiClient &&\n      (this.userId !== userId || this.userToken !== userToken)\n    ) {\n      this.log(\"userId or userToken changed; reinitializing connections\");\n      this.feeds.teardownInstances();\n      this.teardown();\n      reinitializeApi = true;\n    }\n\n    this.userId = userId;\n    this.userToken = userToken;\n\n    this.log(`Authenticated with userId ${userId}`);\n\n    if (this.userToken && options?.onUserTokenExpiring instanceof Function) {\n      this.maybeScheduleUserTokenExpiration(\n        options.onUserTokenExpiring,\n        options.timeBeforeExpirationInMs,\n      );\n    }\n\n    // If we get the signal to reinitialize the api client, then we want to create a new client\n    // and the reinitialize any existing feed real-time connections we have so everything continues\n    // to work with the new credentials we've been given\n    if (reinitializeApi) {\n      this.apiClient = this.createApiClient();\n      this.feeds.reinitializeInstances();\n      this.log(\"Reinitialized real-time connections\");\n    }\n\n    // Inline identify the user if we've been given an object with an id.\n    if (\n      typeof userIdOrUserWithProperties === \"object\" &&\n      userIdOrUserWithProperties?.id\n    ) {\n      const { id, ...properties } = userIdOrUserWithProperties;\n      this.user.identify(properties);\n    }\n\n    return;\n  }\n\n  failIfNotAuthenticated() {\n    if (!this.isAuthenticated()) {\n      throw new Error(\"Not authenticated. Please call `authenticate` first.\");\n    }\n  }\n\n  /*\n    Returns whether or this Knock instance is authenticated. Passing `true` will check the presence\n    of the userToken as well.\n  */\n  isAuthenticated(checkUserToken = false) {\n    return checkUserToken ? !!(this.userId && this.userToken) : !!this.userId;\n  }\n\n  // Used to teardown any connected instances\n  teardown() {\n    if (this.tokenExpirationTimer) {\n      clearTimeout(this.tokenExpirationTimer);\n    }\n    if (this.apiClient?.socket && this.apiClient.socket.isConnected()) {\n      this.apiClient.socket.disconnect();\n    }\n  }\n\n  log(message: string, force = false) {\n    if (this.logLevel === \"debug\" || force) {\n      console.log(`[Knock] ${message}`);\n    }\n  }\n\n  /**\n   * Initiates an API client\n   */\n  private createApiClient() {\n    return new ApiClient({\n      apiKey: this.apiKey,\n      host: this.host,\n      userToken: this.userToken,\n    });\n  }\n\n  private async maybeScheduleUserTokenExpiration(\n    callbackFn: UserTokenExpiringCallback,\n    timeBeforeExpirationInMs: number = 30_000,\n  ) {\n    if (!this.userToken) return;\n\n    const decoded = jwtDecode(this.userToken);\n    const expiresAtMs = (decoded.exp ?? 0) * 1000;\n    const nowMs = Date.now();\n\n    // Expiration is in the future\n    if (expiresAtMs && expiresAtMs > nowMs) {\n      // Check how long until the token should be regenerated\n      // | ----------------- | ----------------------- |\n      // ^ now               ^ expiration offset       ^ expires at\n      const msInFuture = expiresAtMs - timeBeforeExpirationInMs - nowMs;\n\n      this.tokenExpirationTimer = setTimeout(async () => {\n        const newToken = await callbackFn(this.userToken as string, decoded);\n\n        // Reauthenticate which will handle reinitializing sockets\n        if (typeof newToken === \"string\") {\n          this.authenticate(this.userId!, newToken, {\n            onUserTokenExpiring: callbackFn,\n            timeBeforeExpirationInMs: timeBeforeExpirationInMs,\n          });\n        }\n      }, msInFuture);\n    }\n  }\n\n  /**\n   * Returns the user id from the given userIdOrUserWithProperties\n   * @param userIdOrUserWithProperties - The user id or user object\n   * @returns The user id\n   * @throws {Error} If the user object does not contain an `id` property\n   */\n  private getUserId(userIdOrUserWithProperties: UserIdOrUserWithProperties) {\n    if (\n      typeof userIdOrUserWithProperties === \"string\" ||\n      !userIdOrUserWithProperties\n    ) {\n      return userIdOrUserWithProperties;\n    }\n\n    if (userIdOrUserWithProperties?.id) {\n      return userIdOrUserWithProperties.id;\n    }\n\n    throw new Error(\"`user` object must contain an `id` property\");\n  }\n}\n\nexport default Knock;\n"],"names":["DEFAULT_HOST","Knock","apiKey","options","__publicField","FeedClient","ObjectClient","Preferences","SlackClient","MsTeamsClient","UserClient","MessageClient","userIdOrUserWithProperties","userToken","reinitializeApi","currentApiClient","userId","id","properties","checkUserToken","_a","message","force","ApiClient","callbackFn","timeBeforeExpirationInMs","decoded","jwtDecode","expiresAtMs","nowMs","msInFuture","newToken"],"mappings":"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"}
+{"version":3,"file":"knock.mjs","sources":["../../src/knock.ts"],"sourcesContent":["import { jwtDecode } from \"jwt-decode\";\n\nimport ApiClient from \"./api\";\nimport FeedClient from \"./clients/feed\";\nimport MessageClient from \"./clients/messages\";\nimport MsTeamsClient from \"./clients/ms-teams\";\nimport ObjectClient from \"./clients/objects\";\nimport Preferences from \"./clients/preferences\";\nimport SlackClient from \"./clients/slack\";\nimport UserClient from \"./clients/users\";\nimport {\n  AuthenticateOptions,\n  KnockOptions,\n  LogLevel,\n  UserId,\n  UserIdOrUserWithProperties,\n  UserTokenExpiringCallback,\n} from \"./interfaces\";\n\nconst DEFAULT_HOST = \"https://api.knock.app\";\n\nclass Knock {\n  public host: string;\n  private apiClient: ApiClient | null = null;\n  public userId: string | undefined | null;\n  public userToken?: string;\n  public logLevel?: LogLevel;\n  private tokenExpirationTimer: ReturnType<typeof setTimeout> | null = null;\n  readonly feeds = new FeedClient(this);\n  readonly objects = new ObjectClient(this);\n  readonly preferences = new Preferences(this);\n  readonly slack = new SlackClient(this);\n  readonly msTeams = new MsTeamsClient(this);\n  readonly user = new UserClient(this);\n  readonly messages = new MessageClient(this);\n\n  constructor(\n    readonly apiKey: string,\n    options: KnockOptions = {},\n  ) {\n    this.host = options.host || DEFAULT_HOST;\n    this.logLevel = options.logLevel;\n\n    this.log(\"Initialized Knock instance\");\n\n    // Fail loudly if we're using the wrong API key\n    if (this.apiKey && this.apiKey.startsWith(\"sk_\")) {\n      throw new Error(\n        \"[Knock] You are using your secret API key on the client. Please use the public key.\",\n      );\n    }\n  }\n\n  client() {\n    // Initiate a new API client if we don't have one yet\n    if (!this.apiClient) {\n      this.apiClient = this.createApiClient();\n    }\n\n    return this.apiClient;\n  }\n\n  /**\n   * @deprecated Passing `userId` as a `string` is deprecated and will be removed in a future version.\n   * Please pass a `user` object instead containing an `id` value.\n   * example:\n   * ```ts\n   * knock.authenticate({ id: \"user_123\" });\n   * ```\n   */\n  authenticate(\n    userIdOrUserWithProperties: UserId,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): never;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ): void;\n  authenticate(\n    userIdOrUserWithProperties: UserIdOrUserWithProperties,\n    userToken?: Knock[\"userToken\"],\n    options?: AuthenticateOptions,\n  ) {\n    let reinitializeApi = false;\n    const currentApiClient = this.apiClient;\n    const userId = this.getUserId(userIdOrUserWithProperties);\n    const identificationStrategy = options?.identificationStrategy || \"inline\";\n\n    // If we've previously been initialized and the values have now changed, then we\n    // need to reinitialize any stateful connections we have\n    if (\n      currentApiClient &&\n      (this.userId !== userId || this.userToken !== userToken)\n    ) {\n      this.log(\"userId or userToken changed; reinitializing connections\");\n      this.feeds.teardownInstances();\n      this.teardown();\n      reinitializeApi = true;\n    }\n\n    this.userId = userId;\n    this.userToken = userToken;\n\n    this.log(`Authenticated with userId ${userId}`);\n\n    if (this.userToken && options?.onUserTokenExpiring instanceof Function) {\n      this.maybeScheduleUserTokenExpiration(\n        options.onUserTokenExpiring,\n        options.timeBeforeExpirationInMs,\n      );\n    }\n\n    // If we get the signal to reinitialize the api client, then we want to create a new client\n    // and the reinitialize any existing feed real-time connections we have so everything continues\n    // to work with the new credentials we've been given\n    if (reinitializeApi) {\n      this.apiClient = this.createApiClient();\n      this.feeds.reinitializeInstances();\n      this.log(\"Reinitialized real-time connections\");\n    }\n\n    // We explicitly skip the inline identification if the strategy is set to \"skip\"\n    if (identificationStrategy === \"skip\") {\n      this.log(\"Skipping inline user identification\");\n      return;\n    }\n\n    // Inline identify the user if we've been given an object with an id\n    // and the strategy is set to \"inline\".\n    if (\n      identificationStrategy === \"inline\" &&\n      typeof userIdOrUserWithProperties === \"object\" &&\n      userIdOrUserWithProperties?.id\n    ) {\n      this.log(`Identifying user ${userIdOrUserWithProperties.id} inline`);\n      const { id, ...properties } = userIdOrUserWithProperties;\n      this.user.identify(properties);\n    }\n\n    return;\n  }\n\n  failIfNotAuthenticated() {\n    if (!this.isAuthenticated()) {\n      throw new Error(\"Not authenticated. Please call `authenticate` first.\");\n    }\n  }\n\n  /*\n    Returns whether or this Knock instance is authenticated. Passing `true` will check the presence\n    of the userToken as well.\n  */\n  isAuthenticated(checkUserToken = false) {\n    return checkUserToken ? !!(this.userId && this.userToken) : !!this.userId;\n  }\n\n  // Used to teardown any connected instances\n  teardown() {\n    if (this.tokenExpirationTimer) {\n      clearTimeout(this.tokenExpirationTimer);\n    }\n    if (this.apiClient?.socket && this.apiClient.socket.isConnected()) {\n      this.apiClient.socket.disconnect();\n    }\n  }\n\n  log(message: string, force = false) {\n    if (this.logLevel === \"debug\" || force) {\n      console.log(`[Knock] ${message}`);\n    }\n  }\n\n  /**\n   * Initiates an API client\n   */\n  private createApiClient() {\n    return new ApiClient({\n      apiKey: this.apiKey,\n      host: this.host,\n      userToken: this.userToken,\n    });\n  }\n\n  private async maybeScheduleUserTokenExpiration(\n    callbackFn: UserTokenExpiringCallback,\n    timeBeforeExpirationInMs: number = 30_000,\n  ) {\n    if (!this.userToken) return;\n\n    const decoded = jwtDecode(this.userToken);\n    const expiresAtMs = (decoded.exp ?? 0) * 1000;\n    const nowMs = Date.now();\n\n    // Expiration is in the future\n    if (expiresAtMs && expiresAtMs > nowMs) {\n      // Check how long until the token should be regenerated\n      // | ----------------- | ----------------------- |\n      // ^ now               ^ expiration offset       ^ expires at\n      const msInFuture = expiresAtMs - timeBeforeExpirationInMs - nowMs;\n\n      this.tokenExpirationTimer = setTimeout(async () => {\n        const newToken = await callbackFn(this.userToken as string, decoded);\n\n        // Reauthenticate which will handle reinitializing sockets\n        if (typeof newToken === \"string\") {\n          this.authenticate(this.userId!, newToken, {\n            onUserTokenExpiring: callbackFn,\n            timeBeforeExpirationInMs: timeBeforeExpirationInMs,\n          });\n        }\n      }, msInFuture);\n    }\n  }\n\n  /**\n   * Returns the user id from the given userIdOrUserWithProperties\n   * @param userIdOrUserWithProperties - The user id or user object\n   * @returns The user id\n   * @throws {Error} If the user object does not contain an `id` property\n   */\n  private getUserId(userIdOrUserWithProperties: UserIdOrUserWithProperties) {\n    if (\n      typeof userIdOrUserWithProperties === \"string\" ||\n      !userIdOrUserWithProperties\n    ) {\n      return userIdOrUserWithProperties;\n    }\n\n    if (userIdOrUserWithProperties?.id) {\n      return userIdOrUserWithProperties.id;\n    }\n\n    throw new Error(\"`user` object must contain an `id` property\");\n  }\n}\n\nexport default Knock;\n"],"names":["DEFAULT_HOST","Knock","apiKey","options","__publicField","FeedClient","ObjectClient","Preferences","SlackClient","MsTeamsClient","UserClient","MessageClient","userIdOrUserWithProperties","userToken","reinitializeApi","currentApiClient","userId","identificationStrategy","id","properties","checkUserToken","_a","message","force","ApiClient","callbackFn","timeBeforeExpirationInMs","decoded","jwtDecode","expiresAtMs","nowMs","msInFuture","newToken"],"mappings":"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"}

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

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

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

@@ -33,6 +33,7 @@ export interface GuideData<TContent = Any> {
     key: string;
     type: string;
     semver: string;
+    active: boolean;
     steps: GuideStepData<TContent>[];
     activation_url_rules: GuideActivationUrlRuleData[];
     activation_url_patterns: GuideActivationUrlPatternData[];

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

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

package/dist/types/interfaces.d.ts

@@ -43,6 +43,7 @@ export type UserTokenExpiringCallback = (currentToken: string, decodedToken: Jwt
 export interface AuthenticateOptions {
     onUserTokenExpiring?: UserTokenExpiringCallback;
     timeBeforeExpirationInMs?: number;
+    identificationStrategy?: "inline" | "skip";
 }
 export interface BulkOperation {
     id: string;

package/dist/types/interfaces.d.ts.map

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

package/dist/types/knock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knock.d.ts","sourceRoot":"","sources":["../../src/knock.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,0BAA0B,EAE3B,MAAM,cAAc,CAAC;AAItB,cAAM,KAAK;IAgBP,QAAQ,CAAC,MAAM,EAAE,MAAM;IAflB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,SAAS,CAA0B;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC3B,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,QAAQ,CAAC,KAAK,aAAwB;IACtC,QAAQ,CAAC,OAAO,eAA0B;IAC1C,QAAQ,CAAC,WAAW,cAAyB;IAC7C,QAAQ,CAAC,KAAK,cAAyB;IACvC,QAAQ,CAAC,OAAO,gBAA2B;IAC3C,QAAQ,CAAC,IAAI,aAAwB;IACrC,QAAQ,CAAC,QAAQ,gBAA2B;gBAGjC,MAAM,EAAE,MAAM,EACvB,OAAO,GAAE,YAAiB;IAe5B,MAAM;IASN;;;;;;;OAOG;IACH,YAAY,CACV,0BAA0B,EAAE,MAAM,EAClC,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,KAAK;IACR,YAAY,CACV,0BAA0B,EAAE,0BAA0B,EACtD,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI;IAuDP,sBAAsB;IAUtB,eAAe,CAAC,cAAc,UAAQ;IAKtC,QAAQ;IASR,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ;IAMlC;;OAEG;IACH,OAAO,CAAC,eAAe;YAQT,gCAAgC;IA+B9C;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAclB;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"knock.d.ts","sourceRoot":"","sources":["../../src/knock.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,0BAA0B,EAE3B,MAAM,cAAc,CAAC;AAItB,cAAM,KAAK;IAgBP,QAAQ,CAAC,MAAM,EAAE,MAAM;IAflB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,SAAS,CAA0B;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC3B,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,QAAQ,CAAC,KAAK,aAAwB;IACtC,QAAQ,CAAC,OAAO,eAA0B;IAC1C,QAAQ,CAAC,WAAW,cAAyB;IAC7C,QAAQ,CAAC,KAAK,cAAyB;IACvC,QAAQ,CAAC,OAAO,gBAA2B;IAC3C,QAAQ,CAAC,IAAI,aAAwB;IACrC,QAAQ,CAAC,QAAQ,gBAA2B;gBAGjC,MAAM,EAAE,MAAM,EACvB,OAAO,GAAE,YAAiB;IAe5B,MAAM;IASN;;;;;;;OAOG;IACH,YAAY,CACV,0BAA0B,EAAE,MAAM,EAClC,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,KAAK;IACR,YAAY,CACV,0BAA0B,EAAE,0BAA0B,EACtD,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI;IAiEP,sBAAsB;IAUtB,eAAe,CAAC,cAAc,UAAQ;IAKtC,QAAQ;IASR,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ;IAMlC;;OAEG;IACH,OAAO,CAAC,eAAe;YAQT,gCAAgC;IA+B9C;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAclB;AAED,eAAe,KAAK,CAAC"}

package/package.json

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

package/src/clients/guide/client.ts

@@ -160,6 +160,10 @@ const predicate = (
     return true;
   }
 
+  if (!guide.active) {
+    return false;
+  }
+
   if (guide.steps.every((s) => !!s.message.archived_at)) {
     return false;
   }
@@ -466,7 +470,10 @@ export class KnockGuideClient {
     state: StoreState,
     filters: SelectFilterParams = {},
   ): KnockGuide<C>[] {
-    if (Object.keys(state.guides).length === 0) {
+    if (
+      Object.keys(state.guides).length === 0 &&
+      Object.keys(state.previewGuides).length === 0
+    ) {
       return [];
     }
     this.knock.log(`[Guide] Selecting guides for: ${formatFilters(filters)}`);
@@ -488,7 +495,10 @@ export class KnockGuideClient {
     state: StoreState,
     filters: SelectFilterParams = {},
   ): KnockGuide<C> | undefined {
-    if (Object.keys(state.guides).length === 0) {
+    if (
+      Object.keys(state.guides).length === 0 &&
+      Object.keys(state.previewGuides).length === 0
+    ) {
       return undefined;
     }
     this.knock.log(`[Guide] Selecting a guide for: ${formatFilters(filters)}`);

package/src/clients/guide/types.ts

@@ -44,6 +44,7 @@ export interface GuideData<TContent = Any> {
   key: string;
   type: string;
   semver: string;
+  active: boolean;
   steps: GuideStepData<TContent>[];
   activation_url_rules: GuideActivationUrlRuleData[];
   activation_url_patterns: GuideActivationUrlPatternData[];

package/src/interfaces.ts

@@ -54,6 +54,7 @@ export type UserTokenExpiringCallback = (
 export interface AuthenticateOptions {
   onUserTokenExpiring?: UserTokenExpiringCallback;
   timeBeforeExpirationInMs?: number;
+  identificationStrategy?: "inline" | "skip";
 }
 
 export interface BulkOperation {

package/src/knock.ts

@@ -86,6 +86,7 @@ class Knock {
     let reinitializeApi = false;
     const currentApiClient = this.apiClient;
     const userId = this.getUserId(userIdOrUserWithProperties);
+    const identificationStrategy = options?.identificationStrategy || "inline";
 
     // If we've previously been initialized and the values have now changed, then we
     // need to reinitialize any stateful connections we have
@@ -120,11 +121,20 @@ class Knock {
       this.log("Reinitialized real-time connections");
     }
 
-    // Inline identify the user if we've been given an object with an id.
+    // We explicitly skip the inline identification if the strategy is set to "skip"
+    if (identificationStrategy === "skip") {
+      this.log("Skipping inline user identification");
+      return;
+    }
+
+    // Inline identify the user if we've been given an object with an id
+    // and the strategy is set to "inline".
     if (
+      identificationStrategy === "inline" &&
       typeof userIdOrUserWithProperties === "object" &&
       userIdOrUserWithProperties?.id
     ) {
+      this.log(`Identifying user ${userIdOrUserWithProperties.id} inline`);
       const { id, ...properties } = userIdOrUserWithProperties;
       this.user.identify(properties);
     }