@knocklabs/client 0.20.1 → 0.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.20.3
4
+
5
+ ### Patch Changes
6
+
7
+ - cf04e5f: [guides] check window properties in browser specific code paths for react native
8
+
9
+ ## 0.20.2
10
+
11
+ ### Patch Changes
12
+
13
+ - 09c11a3: [guides] fix: KnockGuideStep type definition to return a promise from async methods
14
+
3
15
  ## 0.20.1
4
16
 
5
17
  ### Patch Changes
package/dist/cjs/api.js CHANGED
@@ -1,2 +1,2 @@
1
- "use strict";var i=Object.defineProperty;var o=(t,e,s)=>e in t?i(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var r=(t,e,s)=>o(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("axios"),c=require("axios-retry"),l=require("phoenix"),n=t=>t&&typeof t=="object"&&"default"in t?t:{default:t},h=n(u),a=n(c);class d{constructor(e){r(this,"host");r(this,"apiKey");r(this,"userToken");r(this,"branch");r(this,"axiosClient");r(this,"socket");this.host=e.host,this.apiKey=e.apiKey,this.userToken=e.userToken||null,this.branch=e.branch||null,this.axiosClient=h.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(),"X-Knock-Branch":this.branch}}),typeof window<"u"&&(this.socket=new l.Socket(`${this.host.replace("http","ws")}/ws/v1`,{params:{user_token:this.userToken,api_key:this.apiKey,branch_slug:this.branch}})),a.default(this.axiosClient,{retries:3,retryCondition:this.canRetryRequest,retryDelay:a.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 a.default.isNetworkError(e)?!0:e.response?e.response.status>=500&&e.response.status<=599||e.response.status===429:!1}getKnockClientHeader(){return"Knock/ClientJS 0.20.1"}}exports.default=d;
1
+ "use strict";var i=Object.defineProperty;var o=(t,e,s)=>e in t?i(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var r=(t,e,s)=>o(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("axios"),c=require("axios-retry"),l=require("phoenix"),n=t=>t&&typeof t=="object"&&"default"in t?t:{default:t},h=n(u),a=n(c);class d{constructor(e){r(this,"host");r(this,"apiKey");r(this,"userToken");r(this,"branch");r(this,"axiosClient");r(this,"socket");this.host=e.host,this.apiKey=e.apiKey,this.userToken=e.userToken||null,this.branch=e.branch||null,this.axiosClient=h.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(),"X-Knock-Branch":this.branch}}),typeof window<"u"&&(this.socket=new l.Socket(`${this.host.replace("http","ws")}/ws/v1`,{params:{user_token:this.userToken,api_key:this.apiKey,branch_slug:this.branch}})),a.default(this.axiosClient,{retries:3,retryCondition:this.canRetryRequest,retryDelay:a.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 a.default.isNetworkError(e)?!0:e.response?e.response.status>=500&&e.response.status<=599||e.response.status===429:!1}getKnockClientHeader(){return"Knock/ClientJS 0.20.3"}}exports.default=d;
2
2
  //# sourceMappingURL=api.js.map
@@ -1,2 +1,2 @@
1
- "use strict";var m=Object.defineProperty;var v=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>v(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("@tanstack/store"),b=require("urlpattern-polyfill"),d=require("./helpers.js"),I=50,C=30*1e3,E=3,g={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},k="knock_guide_debug",p=()=>{if(typeof window<"u")return window},G=u=>`/v1/users/${u}/guides`,f=()=>{const u=p();if(!u)return{forcedGuideKey:null,previewSessionId:null};const e=new URLSearchParams(u.location.search),t=e.get(g.GUIDE_KEY),s=e.get(g.PREVIEW_SESSION_ID);if(t||s){if(u.localStorage)try{const i={forcedGuideKey:t,previewSessionId:s};u.localStorage.setItem(k,JSON.stringify(i))}catch{}return{forcedGuideKey:t,previewSessionId:s}}let r=null,n=null;if(u.localStorage)try{const i=u.localStorage.getItem(k);if(i){const o=w(i);r=o.forcedGuideKey,n=o.previewSessionId}}catch{}return{forcedGuideKey:r,previewSessionId:n}},w=u=>{try{const e=JSON.parse(u);return{forcedGuideKey:(e==null?void 0:e.forcedGuideKey)??null,previewSessionId:(e==null?void 0:e.previewSessionId)??null}}catch{return{forcedGuideKey:null,previewSessionId:null}}},S=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;const r=[...s.display_sequence],n=u.location;if(u.debug.forcedGuideKey){const i=r.indexOf(u.debug.forcedGuideKey);i>-1&&r.splice(i,1),r.unshift(u.debug.forcedGuideKey)}for(const[i,o]of r.entries()){let a=u.guides[o];u.debug.forcedGuideKey===o&&u.previewGuides[o]&&(a=u.previewGuides[o]),!(!a||!R(a,{location:n,filters:e,debug:u.debug}))&&t.set(i,a)}return t.metadata={guideGroup:s},t},R=(u,{location:e,filters:t={},debug:s={}})=>{if(t.type&&t.type!==u.type||t.key&&t.key!==u.key)return!1;if(s.forcedGuideKey===u.key)return!0;if(!u.active||u.steps.every(o=>!!o.message.archived_at))return!1;const r=e?d.newUrl(e):void 0,n=u.activation_url_rules||[],i=u.activation_url_patterns||[];if(r&&n.length>0){if(!d.predicateUrlRules(r,n))return!1}else if(r&&i.length>0&&!d.predicateUrlPatterns(r,i))return!1;return!0};class P{constructor(e,t,s={},r={}){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",()=>{this.knock.log("[Guide] .handleLocationChange");const e=p();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Detected a location change: ${t}`);const s=this.store.state.debug,r=f();this.setLocation(t,{debug:r}),this.checkDebugStateChanged(s,r)&&(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=r;const{trackLocationFromWindow:n=!0,throttleCheckInterval:i=C}=r,o=p(),a=n?o==null?void 0:o.location.href:void 0,l=f();this.store=new _.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:a,counter:0,debug:l});const{socket:h}=this.knock.client();this.socket=h,this.socketChannelTopic=`guides:${t}`,n&&this.listenForLocationChangesFromWindow(),i&&this.startCounterInterval(i),this.knock.log("[Guide] Initialized a guide client")}incrementCounter(){this.knock.log("[Guide] Incrementing the counter"),this.store.setState(e=>({...e,counter:e.counter+1}))}startCounterInterval(e){this.counterIntervalId=setInterval(()=>{this.knock.log("[Guide] Counter interval tick"),!(this.stage&&this.stage.status!=="closed")&&this.incrementCounter()},e)}clearCounterInterval(){this.counterIntervalId&&(clearInterval(this.counterIntervalId),this.counterIntervalId=void 0)}cleanup(){this.unsubscribe(),this.removeLocationChangeEventListeners(),this.clearGroupStage(),this.clearCounterInterval()}async fetch(e){this.knock.log("[Guide] .fetch"),this.knock.failIfNotAuthenticated();const t=this.buildQueryParams(e==null?void 0:e.filters),s=this.formatQueryKey(t),r=this.store.state.queries[s];if(r)return r;this.store.setState(i=>({...i,queries:{...i.queries,[s]:{status:"loading"}}}));let n;try{this.knock.log("[Guide] Fetching all eligible guides");const i=await this.knock.user.getGuides(this.channelId,t);n={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:l}=i;this.knock.log("[Guide] Loading fetched guides"),this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:d.byKey(o.map(y=>this.localCopy(y))),queries:{...h.queries,[s]:n}}))}catch(i){n={status:"error",error:i},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 r of this.socketEventTypes)s.on(r,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",r=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(r)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=E){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default:return}}setLocation(e,t={}){this.knock.log(`[Guide] .setLocation (loc=${e})`),this.clearGroupStage(),this.knock.log("[Guide] Updating the tracked location"),this.store.setState(s=>{var n;const r=(n=t==null?void 0:t.debug)!=null&&n.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:r,location:e}})}exitDebugMode(){this.knock.log("[Guide] Exiting debug mode");const e=p();if(e!=null&&e.localStorage)try{e.localStorage.removeItem(k)}catch{}if(this.store.setState(t=>({...t,debug:{forcedGuideKey:null,previewSessionId:null},previewGuides:{}})),e){const t=new URL(e.location.href);(t.searchParams.has(g.GUIDE_KEY)||t.searchParams.has(g.PREVIEW_SESSION_ID))&&(t.searchParams.delete(g.GUIDE_KEY),t.searchParams.delete(g.PREVIEW_SESSION_ID),e.location.href=t.toString())}}selectGuides(e,t={},s={}){if(this.knock.log(`[Guide] .selectGuides (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),!this.selectGuide(e,t,s))return[];const n=[...S(e,t).values()];if(!s.includeThrottled&&d.checkStateIfThrottled(e)){const i=n.filter(a=>a.bypass_global_group_limit),o=n.length-i.length;return this.knock.log(`[Guide] Throttling ${o} guides from selection, and returning ${i.length} guides`),i}return this.knock.log(`[Guide] Returning ${n.length} guides from selection`),n}selectGuide(e,t={},s={}){if(this.knock.log(`[Guide] .selectGuide (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0){this.knock.log("[Guide] Exiting selection (no guides)");return}const r=S(e,t);if(r.size===0){this.knock.log("[Guide] Selection found zero result");return}const[n,i]=[...r][0];if(this.knock.log(`[Guide] Selection found: \`${i.key}\` (total: ${r.size})`),i.bypass_global_group_limit)return this.knock.log(`[Guide] Returning the unthrottled guide: ${i.key}`),i;if(!s.includeThrottled&&d.checkStateIfThrottled(e)){this.knock.log(`[Guide] Throttling the selected guide: ${i.key}`);return}switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Adding to the group stage: ${i.key}`),this.stage.ordered[n]=i.key;return}case"patch":{this.knock.log(`[Guide] Patching the group stage: ${i.key}`),this.stage.ordered[n]=i.key;const o=this.stage.resolved===i.key?i:void 0;return this.knock.log(`[Guide] Returning \`${o==null?void 0:o.key}\` (stage: ${d.formatGroupStage(this.stage)})`),o}case"closed":{const o=this.stage.resolved===i.key?i:void 0;return this.knock.log(`[Guide] Returning \`${o==null?void 0:o.key}\` (stage: ${d.formatGroupStage(this.stage)})`),o}}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=I}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(this.knock.log("[Guide] .closePendingGroupStage"),!this.stage||this.stage.status==="closed")return;this.ensureClearTimeout();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.knock.log(`[Guide] Closing the current group stage: resolved=${e}`),this.stage={...this.stage,status:"closed",resolved:e,timeoutId:null},this.stage}patchClosedGroupStage(){var s;if(this.knock.log("[Guide] .patchClosedGroupStage"),((s=this.stage)==null?void 0:s.status)!=="closed")return;const{orderResolutionDuration:e=0}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.ensureClearTimeout(),this.knock.log("[Guide] Patching the current group stage"),this.stage={...this.stage,status:"patch",ordered:[],timeoutId:t},this.stage}clearGroupStage(){this.knock.log("[Guide] .clearGroupStage"),this.stage&&(this.knock.log("[Guide] Clearing the current group stage"),this.ensureClearTimeout(),this.stage=void 0)}ensureClearTimeout(){var e;(e=this.stage)!=null&&e.timeoutId&&clearTimeout(this.stage.timeoutId)}_selectGuide(e,t={},s={}){return this.openGroupStage(),this.selectGuide(e,t,s),this.closePendingGroupStage(),this.selectGuide(e,t,s)}_selectGuides(e,t={},s={}){return this.openGroupStage(),this.selectGuides(e,t,s),this.closePendingGroupStage(),this.selectGuides(e,t,s)}async markAsSeen(e,t){if(t.message.seen_at)return;this.knock.log(`[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{seen_at:new Date().toISOString()});if(!s)return;const r={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data};return this.knock.user.markGuideStepAs("seen",r),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`);const r=new Date().toISOString(),n=this.setStepMessageAttrs(e.key,t.ref,{read_at:r,interacted_at:r});if(!n)return;const i={...this.buildEngagementEventBaseParams(e,n),metadata:s};return this.knock.user.markGuideStepAs("interacted",i),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 r=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...r,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return t.store.state.debug.forcedGuideKey===this.key?this.steps[0]:this.steps.find(r=>!r.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:r,...n})=>{const i={...n,message:{...r},markAsSeen(){if(!this.message.seen_at)return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){if(!this.message.archived_at)return t.markAsArchived(s,this)}};return i.markAsSeen=i.markAsSeen.bind(i),i.markAsInteracted=i.markAsInteracted.bind(i),i.markAsArchived=i.markAsArchived.bind(i),i}),s.activation_url_patterns=e.activation_url_patterns.map(r=>({...r,pattern:new b.URLPattern({pathname:r.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let r=Object.fromEntries(Object.entries(t).filter(([n,i])=>i!=null));return r=r.data?{...r,data:JSON.stringify(r.data)}:r,r}formatQueryKey(e){const s=Object.keys(e).sort().map(n=>`${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`).join("&"),r=G(this.knock.userId);return s?`${r}?${s}`:r}setStepMessageAttrs(e,t,s){let r;return s.archived_at&&this.clearGroupStage(),this.store.setState(n=>{let i=n.guides[e];if(!i)return n;const o=i.steps.map(h=>(h.ref!==t||(h.message={...h.message,...s},r=h),h));i=r?{...i,steps:o}:i;const a={...n.guides,[i.key]:i},l=s.archived_at&&!i.bypass_global_group_limit?{...n.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:n.guideGroupDisplayLogs;return{...n,guides:a,guideGroupDisplayLogs:l}}),r}buildEngagementEventBaseParams(e,t){return{channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref,tenant:this.targetParams.tenant}}addOrReplaceGuide({data:e}){this.patchClosedGroupStage();const t=this.localCopy(e.guide);this.store.setState(s=>{const r={...s.guides,[t.key]:t};return{...s,guides:r}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...r}=t.guides;return{...t,guides:r}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],r=e.guide_group.display_sequence_unthrottled||[],n=e.guide_group.display_sequence_throttled||[];let i=t.guides;return i=r.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},i),i=n.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!1};return{...o,[a]:l}},i),{...t,guides:i,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const r={...s.previewGuides,[t.key]:t};return{...s,previewGuides:r}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=p();if(e!=null&&e.history){e.addEventListener("popstate",this.handleLocationChange),e.addEventListener("hashchange",this.handleLocationChange);const t=e.history.pushState,s=e.history.replaceState;e.history.pushState=new Proxy(t,{apply:(r,n,i)=>{Reflect.apply(r,n,i),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(r,n,i)=>{Reflect.apply(r,n,i),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")}removeLocationChangeEventListeners(){const e=p();e!=null&&e.history&&(e.removeEventListener("popstate",this.handleLocationChange),e.removeEventListener("hashchange",this.handleLocationChange),this.pushStateFn&&(e.history.pushState=this.pushStateFn,this.pushStateFn=void 0),this.replaceStateFn&&(e.history.replaceState=this.replaceStateFn,this.replaceStateFn=void 0))}}exports.DEBUG_QUERY_PARAMS=g;exports.KnockGuideClient=P;exports.guidesApiRootPath=G;
1
+ "use strict";var m=Object.defineProperty;var v=(u,e,t)=>e in u?m(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>v(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("@tanstack/store"),b=require("urlpattern-polyfill"),d=require("./helpers.js"),I=50,C=30*1e3,E=3,g={GUIDE_KEY:"knock_guide_key",PREVIEW_SESSION_ID:"knock_preview_session_id"},f="knock_guide_debug",p=()=>{if(typeof window<"u")return window},y=u=>`/v1/users/${u}/guides`,S=()=>{const u=p();if(!u||!u.location)return{forcedGuideKey:null,previewSessionId:null};const e=new URLSearchParams(u.location.search),t=e.get(g.GUIDE_KEY),s=e.get(g.PREVIEW_SESSION_ID);if(t||s){if(u.localStorage)try{const i={forcedGuideKey:t,previewSessionId:s};u.localStorage.setItem(f,JSON.stringify(i))}catch{}return{forcedGuideKey:t,previewSessionId:s}}let r=null,n=null;if(u.localStorage)try{const i=u.localStorage.getItem(f);if(i){const o=w(i);r=o.forcedGuideKey,n=o.previewSessionId}}catch{}return{forcedGuideKey:r,previewSessionId:n}},w=u=>{try{const e=JSON.parse(u);return{forcedGuideKey:(e==null?void 0:e.forcedGuideKey)??null,previewSessionId:(e==null?void 0:e.previewSessionId)??null}}catch{return{forcedGuideKey:null,previewSessionId:null}}},G=(u,e={})=>{const t=new d.SelectionResult,s=d.findDefaultGroup(u.guideGroups);if(!s)return t;const r=[...s.display_sequence],n=u.location;if(u.debug.forcedGuideKey){const i=r.indexOf(u.debug.forcedGuideKey);i>-1&&r.splice(i,1),r.unshift(u.debug.forcedGuideKey)}for(const[i,o]of r.entries()){let a=u.guides[o];u.debug.forcedGuideKey===o&&u.previewGuides[o]&&(a=u.previewGuides[o]),!(!a||!R(a,{location:n,filters:e,debug:u.debug}))&&t.set(i,a)}return t.metadata={guideGroup:s},t},R=(u,{location:e,filters:t={},debug:s={}})=>{if(t.type&&t.type!==u.type||t.key&&t.key!==u.key)return!1;if(s.forcedGuideKey===u.key)return!0;if(!u.active||u.steps.every(o=>!!o.message.archived_at))return!1;const r=e?d.newUrl(e):void 0,n=u.activation_url_rules||[],i=u.activation_url_patterns||[];if(r&&n.length>0){if(!d.predicateUrlRules(r,n))return!1}else if(r&&i.length>0&&!d.predicateUrlPatterns(r,i))return!1;return!0};class P{constructor(e,t,s={},r={}){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",()=>{this.knock.log("[Guide] .handleLocationChange");const e=p();if(!(e!=null&&e.location))return;const t=e.location.href;if(this.store.state.location===t)return;this.knock.log(`[Guide] Detected a location change: ${t}`);const s=this.store.state.debug,r=S();this.setLocation(t,{debug:r}),this.checkDebugStateChanged(s,r)&&(this.knock.log("[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"),this.fetch(),this.subscribe())});var k;this.knock=e,this.channelId=t,this.targetParams=s,this.options=r;const{trackLocationFromWindow:n=!0,throttleCheckInterval:i=C}=r,o=p(),a=n?(k=o==null?void 0:o.location)==null?void 0:k.href:void 0,l=S();this.store=new _.Store({guideGroups:[],guideGroupDisplayLogs:{},guides:{},previewGuides:{},queries:{},location:a,counter:0,debug:l});const{socket:h}=this.knock.client();this.socket=h,this.socketChannelTopic=`guides:${t}`,n&&this.listenForLocationChangesFromWindow(),i&&this.startCounterInterval(i),this.knock.log("[Guide] Initialized a guide client")}incrementCounter(){this.knock.log("[Guide] Incrementing the counter"),this.store.setState(e=>({...e,counter:e.counter+1}))}startCounterInterval(e){this.counterIntervalId=setInterval(()=>{this.knock.log("[Guide] Counter interval tick"),!(this.stage&&this.stage.status!=="closed")&&this.incrementCounter()},e)}clearCounterInterval(){this.counterIntervalId&&(clearInterval(this.counterIntervalId),this.counterIntervalId=void 0)}cleanup(){this.unsubscribe(),this.removeLocationChangeEventListeners(),this.clearGroupStage(),this.clearCounterInterval()}async fetch(e){this.knock.log("[Guide] .fetch"),this.knock.failIfNotAuthenticated();const t=this.buildQueryParams(e==null?void 0:e.filters),s=this.formatQueryKey(t),r=this.store.state.queries[s];if(r)return r;this.store.setState(i=>({...i,queries:{...i.queries,[s]:{status:"loading"}}}));let n;try{this.knock.log("[Guide] Fetching all eligible guides");const i=await this.knock.user.getGuides(this.channelId,t);n={status:"ok"};const{entries:o,guide_groups:a,guide_group_display_logs:l}=i;this.knock.log("[Guide] Loading fetched guides"),this.store.setState(h=>({...h,guideGroups:(a==null?void 0:a.length)>0?a:[d.mockDefaultGroup(o)],guideGroupDisplayLogs:l||{},guides:d.byKey(o.map(k=>this.localCopy(k))),queries:{...h.queries,[s]:n}}))}catch(i){n={status:"error",error:i},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 r of this.socketEventTypes)s.on(r,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",r=>{this.knock.log(`[Guide] Failed to join channel: ${JSON.stringify(r)}`),this.handleChannelJoinError()}).receive("timeout",()=>{this.knock.log("[Guide] Channel join timed out"),this.handleChannelJoinError()})),this.socketChannel=s}handleChannelJoinError(){if(this.subscribeRetryCount>=E){this.knock.log(`[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`),this.unsubscribe();return}this.subscribeRetryCount++}unsubscribe(){if(this.socketChannel){this.knock.log("[Guide] Unsubscribing from real time updates");for(const e of this.socketEventTypes)this.socketChannel.off(e);this.socketChannel.leave(),this.socketChannel=void 0}}handleSocketEvent(e){const{event:t,data:s}=e;switch(t){case"guide.added":return this.addOrReplaceGuide(e);case"guide.updated":return s.eligible?this.addOrReplaceGuide(e):this.removeGuide(e);case"guide.removed":return this.removeGuide(e);case"guide_group.added":case"guide_group.updated":return this.addOrReplaceGuideGroup(e);case"guide.live_preview_updated":return this.updatePreviewGuide(e);default:return}}setLocation(e,t={}){this.knock.log(`[Guide] .setLocation (loc=${e})`),this.clearGroupStage(),this.knock.log("[Guide] Updating the tracked location"),this.store.setState(s=>{var n;const r=(n=t==null?void 0:t.debug)!=null&&n.previewSessionId?s.previewGuides:{};return{...s,...t,previewGuides:r,location:e}})}exitDebugMode(){this.knock.log("[Guide] Exiting debug mode");const e=p();if(e!=null&&e.localStorage)try{e.localStorage.removeItem(f)}catch{}if(this.store.setState(t=>({...t,debug:{forcedGuideKey:null,previewSessionId:null},previewGuides:{}})),e!=null&&e.location){const t=new URL(e.location.href);(t.searchParams.has(g.GUIDE_KEY)||t.searchParams.has(g.PREVIEW_SESSION_ID))&&(t.searchParams.delete(g.GUIDE_KEY),t.searchParams.delete(g.PREVIEW_SESSION_ID),e.location.href=t.toString())}}selectGuides(e,t={},s={}){if(this.knock.log(`[Guide] .selectGuides (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),!this.selectGuide(e,t,s))return[];const n=[...G(e,t).values()];if(!s.includeThrottled&&d.checkStateIfThrottled(e)){const i=n.filter(a=>a.bypass_global_group_limit),o=n.length-i.length;return this.knock.log(`[Guide] Throttling ${o} guides from selection, and returning ${i.length} guides`),i}return this.knock.log(`[Guide] Returning ${n.length} guides from selection`),n}selectGuide(e,t={},s={}){if(this.knock.log(`[Guide] .selectGuide (filters: ${d.formatFilters(t)}; state: ${d.formatState(e)})`),Object.keys(e.guides).length===0&&Object.keys(e.previewGuides).length===0){this.knock.log("[Guide] Exiting selection (no guides)");return}const r=G(e,t);if(r.size===0){this.knock.log("[Guide] Selection found zero result");return}const[n,i]=[...r][0];if(this.knock.log(`[Guide] Selection found: \`${i.key}\` (total: ${r.size})`),i.bypass_global_group_limit)return this.knock.log(`[Guide] Returning the unthrottled guide: ${i.key}`),i;if(!s.includeThrottled&&d.checkStateIfThrottled(e)){this.knock.log(`[Guide] Throttling the selected guide: ${i.key}`);return}switch(this.stage||(this.stage=this.openGroupStage()),this.stage.status){case"open":{this.knock.log(`[Guide] Adding to the group stage: ${i.key}`),this.stage.ordered[n]=i.key;return}case"patch":{this.knock.log(`[Guide] Patching the group stage: ${i.key}`),this.stage.ordered[n]=i.key;const o=this.stage.resolved===i.key?i:void 0;return this.knock.log(`[Guide] Returning \`${o==null?void 0:o.key}\` (stage: ${d.formatGroupStage(this.stage)})`),o}case"closed":{const o=this.stage.resolved===i.key?i:void 0;return this.knock.log(`[Guide] Returning \`${o==null?void 0:o.key}\` (stage: ${d.formatGroupStage(this.stage)})`),o}}}openGroupStage(){this.knock.log("[Guide] Opening a new group stage");const{orderResolutionDuration:e=I}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.stage={status:"open",ordered:[],timeoutId:t},this.stage}closePendingGroupStage(){if(this.knock.log("[Guide] .closePendingGroupStage"),!this.stage||this.stage.status==="closed")return;this.ensureClearTimeout();let e;return this.store.state.debug.forcedGuideKey&&(e=this.stage.ordered.find(t=>t===this.store.state.debug.forcedGuideKey)),e||(e=this.stage.ordered.find(t=>t!==void 0)),this.knock.log(`[Guide] Closing the current group stage: resolved=${e}`),this.stage={...this.stage,status:"closed",resolved:e,timeoutId:null},this.stage}patchClosedGroupStage(){var s;if(this.knock.log("[Guide] .patchClosedGroupStage"),((s=this.stage)==null?void 0:s.status)!=="closed")return;const{orderResolutionDuration:e=0}=this.options,t=setTimeout(()=>{this.closePendingGroupStage(),this.incrementCounter()},e);return this.ensureClearTimeout(),this.knock.log("[Guide] Patching the current group stage"),this.stage={...this.stage,status:"patch",ordered:[],timeoutId:t},this.stage}clearGroupStage(){this.knock.log("[Guide] .clearGroupStage"),this.stage&&(this.knock.log("[Guide] Clearing the current group stage"),this.ensureClearTimeout(),this.stage=void 0)}ensureClearTimeout(){var e;(e=this.stage)!=null&&e.timeoutId&&clearTimeout(this.stage.timeoutId)}_selectGuide(e,t={},s={}){return this.openGroupStage(),this.selectGuide(e,t,s),this.closePendingGroupStage(),this.selectGuide(e,t,s)}_selectGuides(e,t={},s={}){return this.openGroupStage(),this.selectGuides(e,t,s),this.closePendingGroupStage(),this.selectGuides(e,t,s)}async markAsSeen(e,t){if(t.message.seen_at)return;this.knock.log(`[Guide] Marking as seen (Guide key: ${e.key}, Step ref:${t.ref})`);const s=this.setStepMessageAttrs(e.key,t.ref,{seen_at:new Date().toISOString()});if(!s)return;const r={...this.buildEngagementEventBaseParams(e,s),content:s.content,data:this.targetParams.data};return this.knock.user.markGuideStepAs("seen",r),s}async markAsInteracted(e,t,s){this.knock.log(`[Guide] Marking as interacted (Guide key: ${e.key}; Step ref:${t.ref})`);const r=new Date().toISOString(),n=this.setStepMessageAttrs(e.key,t.ref,{read_at:r,interacted_at:r});if(!n)return;const i={...this.buildEngagementEventBaseParams(e,n),metadata:s};return this.knock.user.markGuideStepAs("interacted",i),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 r=this.buildEngagementEventBaseParams(e,s);return this.knock.user.markGuideStepAs("archived",{...r,unthrottled:e.bypass_global_group_limit}),s}localCopy(e){const t=this,s={...e,getStep(){return t.store.state.debug.forcedGuideKey===this.key?this.steps[0]:this.steps.find(r=>!r.message.archived_at)}};return s.getStep=s.getStep.bind(s),s.steps=e.steps.map(({message:r,...n})=>{const i={...n,message:{...r},markAsSeen(){return t.markAsSeen(s,this)},markAsInteracted({metadata:o}={}){return t.markAsInteracted(s,this,o)},markAsArchived(){return t.markAsArchived(s,this)}};return i.markAsSeen=i.markAsSeen.bind(i),i.markAsInteracted=i.markAsInteracted.bind(i),i.markAsArchived=i.markAsArchived.bind(i),i}),s.activation_url_patterns=e.activation_url_patterns.map(r=>({...r,pattern:new b.URLPattern({pathname:r.pathname})})),s}buildQueryParams(e={}){const t={...this.targetParams,...e};this.store.state.debug.forcedGuideKey&&(t.force_all_guides=!0);let r=Object.fromEntries(Object.entries(t).filter(([n,i])=>i!=null));return r=r.data?{...r,data:JSON.stringify(r.data)}:r,r}formatQueryKey(e){const s=Object.keys(e).sort().map(n=>`${encodeURIComponent(n)}=${encodeURIComponent(e[n])}`).join("&"),r=y(this.knock.userId);return s?`${r}?${s}`:r}setStepMessageAttrs(e,t,s){let r;return s.archived_at&&this.clearGroupStage(),this.store.setState(n=>{let i=n.guides[e];if(!i)return n;const o=i.steps.map(h=>(h.ref!==t||(h.message={...h.message,...s},r=h),h));i=r?{...i,steps:o}:i;const a={...n.guides,[i.key]:i},l=s.archived_at&&!i.bypass_global_group_limit?{...n.guideGroupDisplayLogs,[d.DEFAULT_GROUP_KEY]:s.archived_at}:n.guideGroupDisplayLogs;return{...n,guides:a,guideGroupDisplayLogs:l}}),r}buildEngagementEventBaseParams(e,t){return{channel_id:e.channel_id,guide_key:e.key,guide_id:e.id,guide_step_ref:t.ref,tenant:this.targetParams.tenant}}addOrReplaceGuide({data:e}){this.patchClosedGroupStage();const t=this.localCopy(e.guide);this.store.setState(s=>{const r={...s.guides,[t.key]:t};return{...s,guides:r}})}removeGuide({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const{[e.guide.key]:s,...r}=t.guides;return{...t,guides:r}})}addOrReplaceGuideGroup({data:e}){this.patchClosedGroupStage(),this.store.setState(t=>{const s=[e.guide_group],r=e.guide_group.display_sequence_unthrottled||[],n=e.guide_group.display_sequence_throttled||[];let i=t.guides;return i=r.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!0};return{...o,[a]:l}},i),i=n.reduce((o,a)=>{if(!o[a])return o;const l={...o[a],bypass_global_group_limit:!1};return{...o,[a]:l}},i),{...t,guides:i,guideGroups:s}})}updatePreviewGuide({data:e}){const t=this.localCopy(e.guide);this.store.setState(s=>{const r={...s.previewGuides,[t.key]:t};return{...s,previewGuides:r}})}checkDebugStateChanged(e,t){return!!e.forcedGuideKey!=!!t.forcedGuideKey||e.previewSessionId!==t.previewSessionId}listenForLocationChangesFromWindow(){const e=p();if(e!=null&&e.history&&(e!=null&&e.addEventListener)){e.addEventListener("popstate",this.handleLocationChange),e.addEventListener("hashchange",this.handleLocationChange);const t=e.history.pushState,s=e.history.replaceState;e.history.pushState=new Proxy(t,{apply:(r,n,i)=>{Reflect.apply(r,n,i),setTimeout(()=>{this.handleLocationChange()},0)}}),e.history.replaceState=new Proxy(s,{apply:(r,n,i)=>{Reflect.apply(r,n,i),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")}removeLocationChangeEventListeners(){const e=p();!(e!=null&&e.history)||!(e!=null&&e.removeEventListener)||(e.removeEventListener("popstate",this.handleLocationChange),e.removeEventListener("hashchange",this.handleLocationChange),this.pushStateFn&&(e.history.pushState=this.pushStateFn,this.pushStateFn=void 0),this.replaceStateFn&&(e.history.replaceState=this.replaceStateFn,this.replaceStateFn=void 0))}}exports.DEBUG_QUERY_PARAMS=g;exports.KnockGuideClient=P;exports.guidesApiRootPath=y;
2
2
  //# sourceMappingURL=client.js.map
@@ -1 +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 checkStateIfThrottled,\n findDefaultGroup,\n formatFilters,\n formatGroupStage,\n formatState,\n mockDefaultGroup,\n newUrl,\n predicateUrlPatterns,\n predicateUrlRules,\n} from \"./helpers\";\nimport {\n Any,\n ConstructorOpts,\n DebugState,\n GetGuidesQueryParams,\n GetGuidesResponse,\n GroupStage,\n GuideAddedEvent,\n GuideData,\n GuideGroupAddedEvent,\n GuideGroupUpdatedEvent,\n GuideLivePreviewUpdatedEvent,\n GuideRemovedEvent,\n GuideSocketEvent,\n GuideStepData,\n GuideUpdatedEvent,\n KnockGuide,\n KnockGuideStep,\n MarkAsArchivedParams,\n MarkAsInteractedParams,\n MarkAsSeenParams,\n MarkGuideAsResponse,\n QueryFilterParams,\n QueryStatus,\n SelectFilterParams,\n SelectGuideOpts,\n SelectGuidesOpts,\n StepMessageState,\n StoreState,\n TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n GUIDE_KEY: \"knock_guide_key\",\n PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n if (typeof window !== \"undefined\") {\n return window;\n }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n const win = checkForWindow();\n if (!win) {\n return { forcedGuideKey: null, previewSessionId: null };\n }\n\n const urlParams = new URLSearchParams(win.location.search);\n const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n const urlPreviewSessionId = urlParams.get(\n DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n );\n\n // If URL params exist, persist them to localStorage and return them\n if (urlGuideKey || urlPreviewSessionId) {\n if (win.localStorage) {\n try {\n const debugState = {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n } catch {\n // Silently fail in privacy mode\n }\n }\n return {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n }\n\n // Check local storage if no URL params\n let storedGuideKey = null;\n let storedPreviewSessionId = null;\n\n if (win.localStorage) {\n try {\n const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n if (storedDebugState) {\n const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n storedGuideKey = parsedDebugState.forcedGuideKey;\n storedPreviewSessionId = parsedDebugState.previewSessionId;\n }\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n return {\n forcedGuideKey: storedGuideKey,\n previewSessionId: storedPreviewSessionId,\n };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n try {\n const parsed = JSON.parse(value);\n return {\n forcedGuideKey: parsed?.forcedGuideKey ?? null,\n previewSessionId: parsed?.previewSessionId ?? null,\n };\n } catch {\n return {\n forcedGuideKey: null,\n previewSessionId: null,\n };\n }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n // A map of selected guides as values, with its order index as keys.\n const result = new SelectionResult();\n\n const defaultGroup = findDefaultGroup(state.guideGroups);\n if (!defaultGroup) return result;\n\n const displaySequence = [...defaultGroup.display_sequence];\n const location = state.location;\n\n // If in debug mode, put the forced guide at the beginning of the display sequence.\n if (state.debug.forcedGuideKey) {\n const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n if (forcedKeyIndex > -1) {\n displaySequence.splice(forcedKeyIndex, 1);\n }\n displaySequence.unshift(state.debug.forcedGuideKey);\n }\n\n for (const [index, guideKey] of displaySequence.entries()) {\n let guide = state.guides[guideKey];\n\n // Use preview guide if it exists and matches the forced guide key\n if (\n state.debug.forcedGuideKey === guideKey &&\n state.previewGuides[guideKey]\n ) {\n guide = state.previewGuides[guideKey];\n }\n\n if (!guide) continue;\n\n const affirmed = predicate(guide, {\n location,\n filters,\n debug: state.debug,\n });\n\n if (!affirmed) continue;\n\n result.set(index, guide);\n }\n\n result.metadata = { guideGroup: defaultGroup };\n return result;\n};\n\ntype PredicateOpts = {\n location?: string | undefined;\n filters?: SelectFilterParams | undefined;\n debug: DebugState;\n};\n\nconst predicate = (\n guide: KnockGuide,\n { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n if (filters.type && filters.type !== guide.type) {\n return false;\n }\n\n if (filters.key && filters.key !== guide.key) {\n return false;\n }\n\n // Bypass filtering if the debugged guide matches the given filters.\n // This should always run AFTER checking the filters but BEFORE\n // checking archived status and location rules.\n if (debug.forcedGuideKey === guide.key) {\n return true;\n }\n\n if (!guide.active) {\n return false;\n }\n\n if (guide.steps.every((s) => !!s.message.archived_at)) {\n return false;\n }\n\n const url = location ? newUrl(location) : undefined;\n\n const urlRules = guide.activation_url_rules || [];\n const urlPatterns = guide.activation_url_patterns || [];\n\n // A guide can have either activation url rules XOR url patterns, but not both.\n if (url && urlRules.length > 0) {\n const allowed = predicateUrlRules(url, urlRules);\n if (!allowed) return false;\n } else if (url && urlPatterns.length > 0) {\n const allowed = predicateUrlPatterns(url, urlPatterns);\n if (!allowed) return false;\n }\n\n return true;\n};\n\nexport class KnockGuideClient {\n public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n // Phoenix channels for real time guide updates over websocket\n private socket: Socket | undefined;\n private socketChannel: Channel | undefined;\n private socketChannelTopic: string;\n private socketEventTypes = [\n \"guide.added\",\n \"guide.updated\",\n \"guide.removed\",\n \"guide_group.added\",\n \"guide_group.updated\",\n \"guide.live_preview_updated\",\n ];\n private subscribeRetryCount = 0;\n\n // Original history methods to monkey patch, or restore in cleanups.\n private pushStateFn: History[\"pushState\"] | undefined;\n private replaceStateFn: History[\"replaceState\"] | undefined;\n\n // Guides that are competing to render are \"staged\" first without rendering\n // and ranked based on its relative order in the group over a duration of time\n // to resolve and render the prevailing one.\n private stage: GroupStage | undefined;\n\n private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n constructor(\n readonly knock: Knock,\n readonly channelId: string,\n readonly targetParams: TargetParams = {},\n readonly options: ConstructorOpts = {},\n ) {\n const {\n trackLocationFromWindow = true,\n throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n } = options;\n const win = checkForWindow();\n\n const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n const debug = detectDebugParams();\n\n this.store = new Store<StoreState>({\n guideGroups: [],\n guideGroupDisplayLogs: {},\n guides: {},\n previewGuides: {},\n queries: {},\n location,\n // Increment to update the state store and trigger re-selection.\n counter: 0,\n debug,\n });\n\n // In server environments we might not have a socket connection.\n const { socket: maybeSocket } = this.knock.client();\n this.socket = maybeSocket;\n this.socketChannelTopic = `guides:${channelId}`;\n\n if (trackLocationFromWindow) {\n this.listenForLocationChangesFromWindow();\n }\n\n if (throttleCheckInterval) {\n // Start the counter loop to increment at an interval.\n this.startCounterInterval(throttleCheckInterval);\n }\n\n this.knock.log(\"[Guide] Initialized a guide client\");\n }\n\n private incrementCounter() {\n this.knock.log(\"[Guide] Incrementing the counter\");\n this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n }\n\n private startCounterInterval(delay: number) {\n this.counterIntervalId = setInterval(() => {\n this.knock.log(\"[Guide] Counter interval tick\");\n if (this.stage && this.stage.status !== \"closed\") return;\n\n this.incrementCounter();\n }, delay);\n }\n\n private clearCounterInterval() {\n if (this.counterIntervalId) {\n clearInterval(this.counterIntervalId);\n this.counterIntervalId = undefined;\n }\n }\n\n cleanup() {\n this.unsubscribe();\n this.removeLocationChangeEventListeners();\n this.clearGroupStage();\n this.clearCounterInterval();\n }\n\n async fetch(opts?: { filters?: QueryFilterParams }) {\n this.knock.log(\"[Guide] .fetch\");\n this.knock.failIfNotAuthenticated();\n\n const queryParams = this.buildQueryParams(opts?.filters);\n const queryKey = this.formatQueryKey(queryParams);\n\n // If already fetched before, then noop.\n const maybeQueryStatus = this.store.state.queries[queryKey];\n if (maybeQueryStatus) {\n return maybeQueryStatus;\n }\n\n // Mark this query status as loading.\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n }));\n\n let queryStatus: QueryStatus;\n try {\n this.knock.log(\"[Guide] Fetching all eligible guides\");\n const data = await this.knock.user.getGuides<\n GetGuidesQueryParams,\n GetGuidesResponse\n >(this.channelId, queryParams);\n queryStatus = { status: \"ok\" };\n\n const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n this.knock.log(\"[Guide] Loading fetched guides\");\n this.store.setState((state) => ({\n ...state,\n guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n guideGroupDisplayLogs: guide_group_display_logs || {},\n guides: byKey(entries.map((g) => this.localCopy(g))),\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n } catch (e) {\n queryStatus = { status: \"error\", error: e as Error };\n\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n }\n\n return queryStatus;\n }\n\n subscribe() {\n if (!this.socket) return;\n this.knock.failIfNotAuthenticated();\n this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n // Ensure a live socket connection if not yet connected.\n if (!this.socket.isConnected()) {\n this.socket.connect();\n }\n\n // If there's an existing connected channel, then disconnect.\n if (this.socketChannel) {\n this.unsubscribe();\n }\n\n // Join the channel topic and subscribe to supported events.\n const debugState = this.store.state.debug;\n const params = {\n ...this.targetParams,\n user_id: this.knock.userId,\n force_all_guides: debugState.forcedGuideKey ? true : undefined,\n preview_session_id: debugState.previewSessionId || undefined,\n };\n\n const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n for (const eventType of this.socketEventTypes) {\n newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n }\n\n if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n // Reset retry count for new subscription attempt\n this.subscribeRetryCount = 0;\n\n newChannel\n .join()\n .receive(\"ok\", () => {\n this.knock.log(\"[Guide] Successfully joined channel\");\n })\n .receive(\"error\", (resp) => {\n this.knock.log(\n `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n );\n this.handleChannelJoinError();\n })\n .receive(\"timeout\", () => {\n this.knock.log(\"[Guide] Channel join timed out\");\n this.handleChannelJoinError();\n });\n }\n\n // Track the joined channel.\n this.socketChannel = newChannel;\n }\n\n private handleChannelJoinError() {\n // Prevent phx channel from retrying forever in case of either network or\n // other errors (e.g. auth error, invalid channel etc)\n if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n this.knock.log(\n `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n );\n this.unsubscribe();\n return;\n }\n\n this.subscribeRetryCount++;\n }\n\n unsubscribe() {\n if (!this.socketChannel) return;\n this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n // Unsubscribe from the socket events and leave the channel.\n for (const eventType of this.socketEventTypes) {\n this.socketChannel.off(eventType);\n }\n this.socketChannel.leave();\n\n // Unset the channel.\n this.socketChannel = undefined;\n }\n\n private handleSocketEvent(payload: GuideSocketEvent) {\n const { event, data } = payload;\n\n switch (event) {\n case \"guide.added\":\n return this.addOrReplaceGuide(payload);\n\n case \"guide.updated\":\n return data.eligible\n ? this.addOrReplaceGuide(payload)\n : this.removeGuide(payload);\n\n case \"guide.removed\":\n return this.removeGuide(payload);\n\n case \"guide_group.added\":\n case \"guide_group.updated\":\n return this.addOrReplaceGuideGroup(payload);\n\n case \"guide.live_preview_updated\":\n return this.updatePreviewGuide(payload);\n\n default:\n return;\n }\n }\n\n setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n // Make sure to clear out the stage.\n this.clearGroupStage();\n\n this.knock.log(\"[Guide] Updating the tracked location\");\n this.store.setState((state) => {\n // Clear preview guides if no longer in preview mode\n const previewGuides = additionalParams?.debug?.previewSessionId\n ? state.previewGuides\n : {};\n\n return {\n ...state,\n ...additionalParams,\n previewGuides,\n location: href,\n };\n });\n }\n\n exitDebugMode() {\n this.knock.log(\"[Guide] Exiting debug mode\");\n\n // Clear localStorage debug params\n const win = checkForWindow();\n if (win?.localStorage) {\n try {\n win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n // Clear debug state from store\n this.store.setState((state) => ({\n ...state,\n debug: { forcedGuideKey: null, previewSessionId: null },\n previewGuides: {}, // Clear preview guides when exiting debug mode\n }));\n\n // Remove URL query params if present\n // Only update the URL if params need to be cleared to avoid unnecessary navigations\n if (win) {\n const url = new URL(win.location.href);\n if (\n url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n ) {\n url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n win.location.href = url.toString();\n }\n }\n }\n\n //\n // Store selector\n //\n\n selectGuides<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ): KnockGuide<C>[] {\n this.knock.log(\n `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n\n const selectedGuide = this.selectGuide(state, filters, opts);\n if (!selectedGuide) {\n return [];\n }\n\n // There should be at least one guide to return here now.\n const guides = [...select(state, filters).values()];\n\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n const unthrottledGuides = guides.filter(\n (g) => g.bypass_global_group_limit,\n );\n const throttledCount = guides.length - unthrottledGuides.length;\n this.knock.log(\n `[Guide] Throttling ${throttledCount} guides from selection, and returning ${unthrottledGuides.length} guides`,\n );\n\n return unthrottledGuides;\n }\n\n this.knock.log(`[Guide] Returning ${guides.length} guides from selection`);\n return guides;\n }\n\n selectGuide<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ): KnockGuide<C> | undefined {\n this.knock.log(\n `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n if (\n Object.keys(state.guides).length === 0 &&\n Object.keys(state.previewGuides).length === 0\n ) {\n this.knock.log(\"[Guide] Exiting selection (no guides)\");\n return undefined;\n }\n\n const result = select(state, filters);\n\n if (result.size === 0) {\n this.knock.log(\"[Guide] Selection found zero result\");\n return undefined;\n }\n\n const [index, guide] = [...result][0]!;\n this.knock.log(\n `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n );\n\n // If a guide ignores the group limit, then return immediately to render\n // always.\n if (guide.bypass_global_group_limit) {\n this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n return guide;\n }\n\n // Check if inside the throttle window (i.e. throttled) and if so stop and\n // return undefined unless explicitly given the option to include throttled.\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n 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] Adding to the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n return undefined;\n }\n\n case \"patch\": {\n this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n\n case \"closed\": {\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n }\n }\n\n private openGroupStage() {\n this.knock.log(\"[Guide] Opening a new group stage\");\n\n const {\n orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n this.stage = {\n status: \"open\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n // Close the current non-closed stage to resolve the prevailing guide up next\n // for display amongst the ones that have been staged.\n private closePendingGroupStage() {\n this.knock.log(\"[Guide] .closePendingGroupStage\");\n if (!this.stage || this.stage.status === \"closed\") return;\n\n // Should have been cleared already since this method should be called as a\n // callback to a setTimeout, but just to be safe.\n this.ensureClearTimeout();\n\n // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n let resolved = undefined;\n if (this.store.state.debug.forcedGuideKey) {\n resolved = this.stage.ordered.find(\n (x) => x === this.store.state.debug.forcedGuideKey,\n );\n }\n\n if (!resolved) {\n resolved = this.stage.ordered.find((x) => x !== undefined);\n }\n\n this.knock.log(\n `[Guide] Closing the current group stage: resolved=${resolved}`,\n );\n\n this.stage = {\n ...this.stage,\n status: \"closed\",\n resolved,\n timeoutId: null,\n };\n\n return this.stage;\n }\n\n // Set the current closed stage status to \"patch\" to allow re-running\n // selections and re-building a group stage with the latest/updated state,\n // while keeping the currently resolved guide in place so that it stays\n // rendered until we are ready to resolve the updated stage and re-render.\n // Note, must be called ahead of updating the state store.\n private patchClosedGroupStage() {\n this.knock.log(\"[Guide] .patchClosedGroupStage\");\n if (this.stage?.status !== \"closed\") return;\n\n const { orderResolutionDuration: delay = 0 } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n // Just to be safe.\n this.ensureClearTimeout();\n\n this.knock.log(\"[Guide] Patching the current group stage\");\n\n this.stage = {\n ...this.stage,\n status: \"patch\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n private clearGroupStage() {\n this.knock.log(\"[Guide] .clearGroupStage\");\n if (!this.stage) return;\n\n this.knock.log(\"[Guide] Clearing the current group stage\");\n this.ensureClearTimeout();\n this.stage = undefined;\n }\n\n private ensureClearTimeout() {\n if (this.stage?.timeoutId) {\n clearTimeout(this.stage.timeoutId);\n }\n }\n\n // Test helpers to open and close the group stage to return the select result\n // immediately.\n private _selectGuide(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuide(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuide(state, filters, opts);\n }\n\n private _selectGuides(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuides(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuides(state, filters, opts);\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 };\n\n this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n \"seen\",\n params,\n );\n\n return updatedStep;\n }\n\n async markAsInteracted(\n guide: GuideData,\n step: GuideStepData,\n metadata?: GenericData,\n ) {\n this.knock.log(\n `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n );\n\n const ts = new Date().toISOString();\n const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n read_at: ts,\n interacted_at: ts,\n });\n if (!updatedStep) return;\n\n const params = {\n ...this.buildEngagementEventBaseParams(guide, updatedStep),\n metadata,\n };\n\n this.knock.user.markGuideStepAs<\n MarkAsInteractedParams,\n MarkGuideAsResponse\n >(\"interacted\", params);\n\n return updatedStep;\n }\n\n async markAsArchived(guide: GuideData, step: GuideStepData) {\n if (step.message.archived_at) return;\n\n this.knock.log(\n `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n );\n\n const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n archived_at: new Date().toISOString(),\n });\n if (!updatedStep) return;\n\n const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n \"archived\",\n {\n ...params,\n unthrottled: guide.bypass_global_group_limit,\n },\n );\n\n return updatedStep;\n }\n\n //\n // Helpers\n //\n\n private localCopy(remoteGuide: GuideData) {\n // eslint-disable-next-line @typescript-eslint/no-this-alias\n const self = this;\n\n // Build a local copy with helper methods added.\n const localGuide = {\n ...remoteGuide,\n // Get the next unarchived step.\n getStep() {\n // If debugging this guide, return the first step regardless of archive status\n if (self.store.state.debug.forcedGuideKey === this.key) {\n return this.steps[0];\n }\n\n return this.steps.find((s) => !s.message.archived_at);\n },\n } as KnockGuide;\n\n localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n const localStep = {\n ...rest,\n message: { ...message },\n markAsSeen() {\n // Send a seen event if it has not been previously seen.\n if (this.message.seen_at) return;\n return self.markAsSeen(localGuide, this);\n },\n markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n // Always send an interaction event through.\n return self.markAsInteracted(localGuide, this, metadata);\n },\n markAsArchived() {\n // Send an archived event if it has not been previously archived.\n if (this.message.archived_at) return;\n return self.markAsArchived(localGuide, this);\n },\n };\n\n // Bind all engagement action handler methods to the local step object so\n // they can operate on itself.\n localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n return localStep;\n });\n\n localGuide.activation_url_patterns =\n remoteGuide.activation_url_patterns.map((rule) => {\n return {\n ...rule,\n pattern: new URLPattern({ pathname: rule.pathname }),\n };\n });\n\n return localGuide;\n }\n\n private buildQueryParams(filterParams: QueryFilterParams = {}) {\n // Combine the target params with the given filter params.\n const combinedParams: GenericData = {\n ...this.targetParams,\n ...filterParams,\n };\n\n // Append debug params\n const debugState = this.store.state.debug;\n if (debugState.forcedGuideKey) {\n combinedParams.force_all_guides = true;\n }\n\n // Prune out any keys that have an undefined or null value.\n let params = Object.fromEntries(\n Object.entries(combinedParams).filter(\n ([_k, v]) => v !== undefined && v !== null,\n ),\n );\n\n // Encode target data as a JSON string, if provided.\n params = params.data\n ? { ...params, data: JSON.stringify(params.data) }\n : params;\n\n return params as GetGuidesQueryParams;\n }\n\n private formatQueryKey(queryParams: GenericData) {\n const sortedKeys = Object.keys(queryParams).sort();\n\n const queryStr = sortedKeys\n .map(\n (key) =>\n `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n )\n .join(\"&\");\n\n const basePath = guidesApiRootPath(this.knock.userId);\n return queryStr ? `${basePath}?${queryStr}` : basePath;\n }\n\n private setStepMessageAttrs(\n guideKey: string,\n stepRef: string,\n attrs: Partial<StepMessageState>,\n ) {\n let updatedStep: KnockGuideStep | undefined;\n\n // If we are marking as archived, clear the group stage so we can render\n // the next guide in the group.\n if (attrs.archived_at) {\n this.clearGroupStage();\n }\n\n this.store.setState((state) => {\n let guide = state.guides[guideKey];\n if (!guide) return state;\n\n const steps = guide.steps.map((step) => {\n if (step.ref !== stepRef) return step;\n\n // Mutate in place and maintain the same obj ref so to make it easier\n // to use in hook deps.\n step.message = { ...step.message, ...attrs };\n updatedStep = step;\n\n return step;\n });\n // If updated, return the guide as a new object so useStore can trigger.\n guide = updatedStep ? { ...guide, steps } : guide;\n\n const guides = { ...state.guides, [guide.key]: guide };\n\n // If the guide is subject to throttled settings and we are marking as\n // archived, then update the display logs to start a new throttle window.\n const guideGroupDisplayLogs =\n attrs.archived_at && !guide.bypass_global_group_limit\n ? {\n ...state.guideGroupDisplayLogs,\n [DEFAULT_GROUP_KEY]: attrs.archived_at,\n }\n : state.guideGroupDisplayLogs;\n\n return { ...state, guides, guideGroupDisplayLogs };\n });\n\n return updatedStep;\n }\n\n private buildEngagementEventBaseParams(\n guide: GuideData,\n step: GuideStepData,\n ) {\n return {\n channel_id: guide.channel_id,\n guide_key: guide.key,\n guide_id: guide.id,\n guide_step_ref: step.ref,\n // Can be used for scoping guide messages.\n tenant: this.targetParams.tenant,\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 this.knock.log(`[Guide] .handleLocationChange`);\n const win = checkForWindow();\n if (!win?.location) return;\n\n const href = win.location.href;\n if (this.store.state.location === href) return;\n\n this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n // If entering debug mode, fetch all guides.\n const currentDebugParams = this.store.state.debug;\n const newDebugParams = detectDebugParams();\n\n this.setLocation(href, { debug: newDebugParams });\n\n // If debug state has changed, refetch guides and resubscribe to the websocket channel\n const debugStateChanged = this.checkDebugStateChanged(\n currentDebugParams,\n newDebugParams,\n );\n\n if (debugStateChanged) {\n this.knock.log(\n `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n );\n this.fetch();\n this.subscribe();\n }\n };\n\n // Returns whether debug params have changed. For guide key, we only check\n // presence since the exact value has no impact on fetch/subscribe\n private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n return (\n Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n a.previewSessionId !== b.previewSessionId\n );\n }\n\n private listenForLocationChangesFromWindow() {\n const win = checkForWindow();\n if (win?.history) {\n // 1. Listen for browser back/forward button clicks.\n win.addEventListener(\"popstate\", this.handleLocationChange);\n\n // 2. Listen for hash changes in case it's used for routing.\n win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n // 3. Monkey-patch history methods to catch programmatic navigation.\n const pushStateFn = win.history.pushState;\n const replaceStateFn = win.history.replaceState;\n\n // Use setTimeout to allow the browser state to potentially settle.\n win.history.pushState = new Proxy(pushStateFn, {\n apply: (target, history, args) => {\n Reflect.apply(target, history, args);\n setTimeout(() => {\n this.handleLocationChange();\n }, 0);\n },\n });\n win.history.replaceState = new Proxy(replaceStateFn, {\n apply: (target, history, args) => {\n Reflect.apply(target, history, args);\n setTimeout(() => {\n this.handleLocationChange();\n }, 0);\n },\n });\n\n // 4. Keep refs to the original handlers so we can restore during cleanup.\n this.pushStateFn = pushStateFn;\n this.replaceStateFn = replaceStateFn;\n } else {\n this.knock.log(\n \"[Guide] Unable to access the `window.history` object to detect location changes\",\n );\n }\n }\n\n removeLocationChangeEventListeners() {\n const win = checkForWindow();\n if (!win?.history) return;\n\n win.removeEventListener(\"popstate\", this.handleLocationChange);\n win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n if (this.pushStateFn) {\n win.history.pushState = this.pushStateFn;\n this.pushStateFn = undefined;\n }\n if (this.replaceStateFn) {\n win.history.replaceState = this.replaceStateFn;\n this.replaceStateFn = undefined;\n }\n }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","guides","checkStateIfThrottled","unthrottledGuides","throttledCount","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guideGroupDisplayLogs","DEFAULT_GROUP_KEY","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
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 checkStateIfThrottled,\n findDefaultGroup,\n formatFilters,\n formatGroupStage,\n formatState,\n mockDefaultGroup,\n newUrl,\n predicateUrlPatterns,\n predicateUrlRules,\n} from \"./helpers\";\nimport {\n Any,\n ConstructorOpts,\n DebugState,\n GetGuidesQueryParams,\n GetGuidesResponse,\n GroupStage,\n GuideAddedEvent,\n GuideData,\n GuideGroupAddedEvent,\n GuideGroupUpdatedEvent,\n GuideLivePreviewUpdatedEvent,\n GuideRemovedEvent,\n GuideSocketEvent,\n GuideStepData,\n GuideUpdatedEvent,\n KnockGuide,\n KnockGuideStep,\n MarkAsArchivedParams,\n MarkAsInteractedParams,\n MarkAsSeenParams,\n MarkGuideAsResponse,\n QueryFilterParams,\n QueryStatus,\n SelectFilterParams,\n SelectGuideOpts,\n SelectGuidesOpts,\n StepMessageState,\n StoreState,\n TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n GUIDE_KEY: \"knock_guide_key\",\n PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n if (typeof window !== \"undefined\") {\n return window;\n }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n const win = checkForWindow();\n if (!win || !win.location) {\n return { forcedGuideKey: null, previewSessionId: null };\n }\n\n const urlParams = new URLSearchParams(win.location.search);\n const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n const urlPreviewSessionId = urlParams.get(\n DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n );\n\n // If URL params exist, persist them to localStorage and return them\n if (urlGuideKey || urlPreviewSessionId) {\n if (win.localStorage) {\n try {\n const debugState = {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n } catch {\n // Silently fail in privacy mode\n }\n }\n return {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n }\n\n // Check local storage if no URL params\n let storedGuideKey = null;\n let storedPreviewSessionId = null;\n\n if (win.localStorage) {\n try {\n const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n if (storedDebugState) {\n const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n storedGuideKey = parsedDebugState.forcedGuideKey;\n storedPreviewSessionId = parsedDebugState.previewSessionId;\n }\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n return {\n forcedGuideKey: storedGuideKey,\n previewSessionId: storedPreviewSessionId,\n };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n try {\n const parsed = JSON.parse(value);\n return {\n forcedGuideKey: parsed?.forcedGuideKey ?? null,\n previewSessionId: parsed?.previewSessionId ?? null,\n };\n } catch {\n return {\n forcedGuideKey: null,\n previewSessionId: null,\n };\n }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n // A map of selected guides as values, with its order index as keys.\n const result = new SelectionResult();\n\n const defaultGroup = findDefaultGroup(state.guideGroups);\n if (!defaultGroup) return result;\n\n const displaySequence = [...defaultGroup.display_sequence];\n const location = state.location;\n\n // If in debug mode, put the forced guide at the beginning of the display sequence.\n if (state.debug.forcedGuideKey) {\n const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n if (forcedKeyIndex > -1) {\n displaySequence.splice(forcedKeyIndex, 1);\n }\n displaySequence.unshift(state.debug.forcedGuideKey);\n }\n\n for (const [index, guideKey] of displaySequence.entries()) {\n let guide = state.guides[guideKey];\n\n // Use preview guide if it exists and matches the forced guide key\n if (\n state.debug.forcedGuideKey === guideKey &&\n state.previewGuides[guideKey]\n ) {\n guide = state.previewGuides[guideKey];\n }\n\n if (!guide) continue;\n\n const affirmed = predicate(guide, {\n location,\n filters,\n debug: state.debug,\n });\n\n if (!affirmed) continue;\n\n result.set(index, guide);\n }\n\n result.metadata = { guideGroup: defaultGroup };\n return result;\n};\n\ntype PredicateOpts = {\n location?: string | undefined;\n filters?: SelectFilterParams | undefined;\n debug: DebugState;\n};\n\nconst predicate = (\n guide: KnockGuide,\n { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n if (filters.type && filters.type !== guide.type) {\n return false;\n }\n\n if (filters.key && filters.key !== guide.key) {\n return false;\n }\n\n // Bypass filtering if the debugged guide matches the given filters.\n // This should always run AFTER checking the filters but BEFORE\n // checking archived status and location rules.\n if (debug.forcedGuideKey === guide.key) {\n return true;\n }\n\n if (!guide.active) {\n return false;\n }\n\n if (guide.steps.every((s) => !!s.message.archived_at)) {\n return false;\n }\n\n const url = location ? newUrl(location) : undefined;\n\n const urlRules = guide.activation_url_rules || [];\n const urlPatterns = guide.activation_url_patterns || [];\n\n // A guide can have either activation url rules XOR url patterns, but not both.\n if (url && urlRules.length > 0) {\n const allowed = predicateUrlRules(url, urlRules);\n if (!allowed) return false;\n } else if (url && urlPatterns.length > 0) {\n const allowed = predicateUrlPatterns(url, urlPatterns);\n if (!allowed) return false;\n }\n\n return true;\n};\n\nexport class KnockGuideClient {\n public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n // Phoenix channels for real time guide updates over websocket\n private socket: Socket | undefined;\n private socketChannel: Channel | undefined;\n private socketChannelTopic: string;\n private socketEventTypes = [\n \"guide.added\",\n \"guide.updated\",\n \"guide.removed\",\n \"guide_group.added\",\n \"guide_group.updated\",\n \"guide.live_preview_updated\",\n ];\n private subscribeRetryCount = 0;\n\n // Original history methods to monkey patch, or restore in cleanups.\n private pushStateFn: History[\"pushState\"] | undefined;\n private replaceStateFn: History[\"replaceState\"] | undefined;\n\n // Guides that are competing to render are \"staged\" first without rendering\n // and ranked based on its relative order in the group over a duration of time\n // to resolve and render the prevailing one.\n private stage: GroupStage | undefined;\n\n private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n constructor(\n readonly knock: Knock,\n readonly channelId: string,\n readonly targetParams: TargetParams = {},\n readonly options: ConstructorOpts = {},\n ) {\n const {\n trackLocationFromWindow = true,\n throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n } = options;\n const win = checkForWindow();\n\n const location = trackLocationFromWindow ? win?.location?.href : undefined;\n\n const debug = detectDebugParams();\n\n this.store = new Store<StoreState>({\n guideGroups: [],\n guideGroupDisplayLogs: {},\n guides: {},\n previewGuides: {},\n queries: {},\n location,\n // Increment to update the state store and trigger re-selection.\n counter: 0,\n debug,\n });\n\n // In server environments we might not have a socket connection.\n const { socket: maybeSocket } = this.knock.client();\n this.socket = maybeSocket;\n this.socketChannelTopic = `guides:${channelId}`;\n\n if (trackLocationFromWindow) {\n this.listenForLocationChangesFromWindow();\n }\n\n if (throttleCheckInterval) {\n // Start the counter loop to increment at an interval.\n this.startCounterInterval(throttleCheckInterval);\n }\n\n this.knock.log(\"[Guide] Initialized a guide client\");\n }\n\n private incrementCounter() {\n this.knock.log(\"[Guide] Incrementing the counter\");\n this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n }\n\n private startCounterInterval(delay: number) {\n this.counterIntervalId = setInterval(() => {\n this.knock.log(\"[Guide] Counter interval tick\");\n if (this.stage && this.stage.status !== \"closed\") return;\n\n this.incrementCounter();\n }, delay);\n }\n\n private clearCounterInterval() {\n if (this.counterIntervalId) {\n clearInterval(this.counterIntervalId);\n this.counterIntervalId = undefined;\n }\n }\n\n cleanup() {\n this.unsubscribe();\n this.removeLocationChangeEventListeners();\n this.clearGroupStage();\n this.clearCounterInterval();\n }\n\n async fetch(opts?: { filters?: QueryFilterParams }) {\n this.knock.log(\"[Guide] .fetch\");\n this.knock.failIfNotAuthenticated();\n\n const queryParams = this.buildQueryParams(opts?.filters);\n const queryKey = this.formatQueryKey(queryParams);\n\n // If already fetched before, then noop.\n const maybeQueryStatus = this.store.state.queries[queryKey];\n if (maybeQueryStatus) {\n return maybeQueryStatus;\n }\n\n // Mark this query status as loading.\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n }));\n\n let queryStatus: QueryStatus;\n try {\n this.knock.log(\"[Guide] Fetching all eligible guides\");\n const data = await this.knock.user.getGuides<\n GetGuidesQueryParams,\n GetGuidesResponse\n >(this.channelId, queryParams);\n queryStatus = { status: \"ok\" };\n\n const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n this.knock.log(\"[Guide] Loading fetched guides\");\n this.store.setState((state) => ({\n ...state,\n guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n guideGroupDisplayLogs: guide_group_display_logs || {},\n guides: byKey(entries.map((g) => this.localCopy(g))),\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n } catch (e) {\n queryStatus = { status: \"error\", error: e as Error };\n\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n }\n\n return queryStatus;\n }\n\n subscribe() {\n if (!this.socket) return;\n this.knock.failIfNotAuthenticated();\n this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n // Ensure a live socket connection if not yet connected.\n if (!this.socket.isConnected()) {\n this.socket.connect();\n }\n\n // If there's an existing connected channel, then disconnect.\n if (this.socketChannel) {\n this.unsubscribe();\n }\n\n // Join the channel topic and subscribe to supported events.\n const debugState = this.store.state.debug;\n const params = {\n ...this.targetParams,\n user_id: this.knock.userId,\n force_all_guides: debugState.forcedGuideKey ? true : undefined,\n preview_session_id: debugState.previewSessionId || undefined,\n };\n\n const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n for (const eventType of this.socketEventTypes) {\n newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n }\n\n if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n // Reset retry count for new subscription attempt\n this.subscribeRetryCount = 0;\n\n newChannel\n .join()\n .receive(\"ok\", () => {\n this.knock.log(\"[Guide] Successfully joined channel\");\n })\n .receive(\"error\", (resp) => {\n this.knock.log(\n `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n );\n this.handleChannelJoinError();\n })\n .receive(\"timeout\", () => {\n this.knock.log(\"[Guide] Channel join timed out\");\n this.handleChannelJoinError();\n });\n }\n\n // Track the joined channel.\n this.socketChannel = newChannel;\n }\n\n private handleChannelJoinError() {\n // Prevent phx channel from retrying forever in case of either network or\n // other errors (e.g. auth error, invalid channel etc)\n if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n this.knock.log(\n `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n );\n this.unsubscribe();\n return;\n }\n\n this.subscribeRetryCount++;\n }\n\n unsubscribe() {\n if (!this.socketChannel) return;\n this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n // Unsubscribe from the socket events and leave the channel.\n for (const eventType of this.socketEventTypes) {\n this.socketChannel.off(eventType);\n }\n this.socketChannel.leave();\n\n // Unset the channel.\n this.socketChannel = undefined;\n }\n\n private handleSocketEvent(payload: GuideSocketEvent) {\n const { event, data } = payload;\n\n switch (event) {\n case \"guide.added\":\n return this.addOrReplaceGuide(payload);\n\n case \"guide.updated\":\n return data.eligible\n ? this.addOrReplaceGuide(payload)\n : this.removeGuide(payload);\n\n case \"guide.removed\":\n return this.removeGuide(payload);\n\n case \"guide_group.added\":\n case \"guide_group.updated\":\n return this.addOrReplaceGuideGroup(payload);\n\n case \"guide.live_preview_updated\":\n return this.updatePreviewGuide(payload);\n\n default:\n return;\n }\n }\n\n setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n // Make sure to clear out the stage.\n this.clearGroupStage();\n\n this.knock.log(\"[Guide] Updating the tracked location\");\n this.store.setState((state) => {\n // Clear preview guides if no longer in preview mode\n const previewGuides = additionalParams?.debug?.previewSessionId\n ? state.previewGuides\n : {};\n\n return {\n ...state,\n ...additionalParams,\n previewGuides,\n location: href,\n };\n });\n }\n\n exitDebugMode() {\n this.knock.log(\"[Guide] Exiting debug mode\");\n\n // Clear localStorage debug params\n const win = checkForWindow();\n if (win?.localStorage) {\n try {\n win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n // Clear debug state from store\n this.store.setState((state) => ({\n ...state,\n debug: { forcedGuideKey: null, previewSessionId: null },\n previewGuides: {}, // Clear preview guides when exiting debug mode\n }));\n\n // Remove URL query params if present\n // Only update the URL if params need to be cleared to avoid unnecessary navigations\n if (win?.location) {\n const url = new URL(win.location.href);\n if (\n url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n ) {\n url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n win.location.href = url.toString();\n }\n }\n }\n\n //\n // Store selector\n //\n\n selectGuides<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ): KnockGuide<C>[] {\n this.knock.log(\n `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n\n const selectedGuide = this.selectGuide(state, filters, opts);\n if (!selectedGuide) {\n return [];\n }\n\n // There should be at least one guide to return here now.\n const guides = [...select(state, filters).values()];\n\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n const unthrottledGuides = guides.filter(\n (g) => g.bypass_global_group_limit,\n );\n const throttledCount = guides.length - unthrottledGuides.length;\n this.knock.log(\n `[Guide] Throttling ${throttledCount} guides from selection, and returning ${unthrottledGuides.length} guides`,\n );\n\n return unthrottledGuides;\n }\n\n this.knock.log(`[Guide] Returning ${guides.length} guides from selection`);\n return guides;\n }\n\n selectGuide<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ): KnockGuide<C> | undefined {\n this.knock.log(\n `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n if (\n Object.keys(state.guides).length === 0 &&\n Object.keys(state.previewGuides).length === 0\n ) {\n this.knock.log(\"[Guide] Exiting selection (no guides)\");\n return undefined;\n }\n\n const result = select(state, filters);\n\n if (result.size === 0) {\n this.knock.log(\"[Guide] Selection found zero result\");\n return undefined;\n }\n\n const [index, guide] = [...result][0]!;\n this.knock.log(\n `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n );\n\n // If a guide ignores the group limit, then return immediately to render\n // always.\n if (guide.bypass_global_group_limit) {\n this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n return guide;\n }\n\n // Check if inside the throttle window (i.e. throttled) and if so stop and\n // return undefined unless explicitly given the option to include throttled.\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n 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] Adding to the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n return undefined;\n }\n\n case \"patch\": {\n this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n\n case \"closed\": {\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n }\n }\n\n private openGroupStage() {\n this.knock.log(\"[Guide] Opening a new group stage\");\n\n const {\n orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n this.stage = {\n status: \"open\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n // Close the current non-closed stage to resolve the prevailing guide up next\n // for display amongst the ones that have been staged.\n private closePendingGroupStage() {\n this.knock.log(\"[Guide] .closePendingGroupStage\");\n if (!this.stage || this.stage.status === \"closed\") return;\n\n // Should have been cleared already since this method should be called as a\n // callback to a setTimeout, but just to be safe.\n this.ensureClearTimeout();\n\n // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n let resolved = undefined;\n if (this.store.state.debug.forcedGuideKey) {\n resolved = this.stage.ordered.find(\n (x) => x === this.store.state.debug.forcedGuideKey,\n );\n }\n\n if (!resolved) {\n resolved = this.stage.ordered.find((x) => x !== undefined);\n }\n\n this.knock.log(\n `[Guide] Closing the current group stage: resolved=${resolved}`,\n );\n\n this.stage = {\n ...this.stage,\n status: \"closed\",\n resolved,\n timeoutId: null,\n };\n\n return this.stage;\n }\n\n // Set the current closed stage status to \"patch\" to allow re-running\n // selections and re-building a group stage with the latest/updated state,\n // while keeping the currently resolved guide in place so that it stays\n // rendered until we are ready to resolve the updated stage and re-render.\n // Note, must be called ahead of updating the state store.\n private patchClosedGroupStage() {\n this.knock.log(\"[Guide] .patchClosedGroupStage\");\n if (this.stage?.status !== \"closed\") return;\n\n const { orderResolutionDuration: delay = 0 } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n // Just to be safe.\n this.ensureClearTimeout();\n\n this.knock.log(\"[Guide] Patching the current group stage\");\n\n this.stage = {\n ...this.stage,\n status: \"patch\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n private clearGroupStage() {\n this.knock.log(\"[Guide] .clearGroupStage\");\n if (!this.stage) return;\n\n this.knock.log(\"[Guide] Clearing the current group stage\");\n this.ensureClearTimeout();\n this.stage = undefined;\n }\n\n private ensureClearTimeout() {\n if (this.stage?.timeoutId) {\n clearTimeout(this.stage.timeoutId);\n }\n }\n\n // Test helpers to open and close the group stage to return the select result\n // immediately.\n private _selectGuide(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuide(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuide(state, filters, opts);\n }\n\n private _selectGuides(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuides(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuides(state, filters, opts);\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 };\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 return self.markAsSeen(localGuide, this);\n },\n markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n return self.markAsInteracted(localGuide, this, metadata);\n },\n markAsArchived() {\n return self.markAsArchived(localGuide, this);\n },\n };\n\n // Bind all engagement action handler methods to the local step object so\n // they can operate on itself.\n localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n return localStep;\n });\n\n localGuide.activation_url_patterns =\n remoteGuide.activation_url_patterns.map((rule) => {\n return {\n ...rule,\n pattern: new URLPattern({ pathname: rule.pathname }),\n };\n });\n\n return localGuide;\n }\n\n private buildQueryParams(filterParams: QueryFilterParams = {}) {\n // Combine the target params with the given filter params.\n const combinedParams: GenericData = {\n ...this.targetParams,\n ...filterParams,\n };\n\n // Append debug params\n const debugState = this.store.state.debug;\n if (debugState.forcedGuideKey) {\n combinedParams.force_all_guides = true;\n }\n\n // Prune out any keys that have an undefined or null value.\n let params = Object.fromEntries(\n Object.entries(combinedParams).filter(\n ([_k, v]) => v !== undefined && v !== null,\n ),\n );\n\n // Encode target data as a JSON string, if provided.\n params = params.data\n ? { ...params, data: JSON.stringify(params.data) }\n : params;\n\n return params as GetGuidesQueryParams;\n }\n\n private formatQueryKey(queryParams: GenericData) {\n const sortedKeys = Object.keys(queryParams).sort();\n\n const queryStr = sortedKeys\n .map(\n (key) =>\n `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n )\n .join(\"&\");\n\n const basePath = guidesApiRootPath(this.knock.userId);\n return queryStr ? `${basePath}?${queryStr}` : basePath;\n }\n\n private setStepMessageAttrs(\n guideKey: string,\n stepRef: string,\n attrs: Partial<StepMessageState>,\n ) {\n let updatedStep: KnockGuideStep | undefined;\n\n // If we are marking as archived, clear the group stage so we can render\n // the next guide in the group.\n if (attrs.archived_at) {\n this.clearGroupStage();\n }\n\n this.store.setState((state) => {\n let guide = state.guides[guideKey];\n if (!guide) return state;\n\n const steps = guide.steps.map((step) => {\n if (step.ref !== stepRef) return step;\n\n // Mutate in place and maintain the same obj ref so to make it easier\n // to use in hook deps.\n step.message = { ...step.message, ...attrs };\n updatedStep = step;\n\n return step;\n });\n // If updated, return the guide as a new object so useStore can trigger.\n guide = updatedStep ? { ...guide, steps } : guide;\n\n const guides = { ...state.guides, [guide.key]: guide };\n\n // If the guide is subject to throttled settings and we are marking as\n // archived, then update the display logs to start a new throttle window.\n const guideGroupDisplayLogs =\n attrs.archived_at && !guide.bypass_global_group_limit\n ? {\n ...state.guideGroupDisplayLogs,\n [DEFAULT_GROUP_KEY]: attrs.archived_at,\n }\n : state.guideGroupDisplayLogs;\n\n return { ...state, guides, guideGroupDisplayLogs };\n });\n\n return updatedStep;\n }\n\n private buildEngagementEventBaseParams(\n guide: GuideData,\n step: GuideStepData,\n ) {\n return {\n channel_id: guide.channel_id,\n guide_key: guide.key,\n guide_id: guide.id,\n guide_step_ref: step.ref,\n // Can be used for scoping guide messages.\n tenant: this.targetParams.tenant,\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 this.knock.log(`[Guide] .handleLocationChange`);\n const win = checkForWindow();\n if (!win?.location) return;\n\n const href = win.location.href;\n if (this.store.state.location === href) return;\n\n this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n // If entering debug mode, fetch all guides.\n const currentDebugParams = this.store.state.debug;\n const newDebugParams = detectDebugParams();\n\n this.setLocation(href, { debug: newDebugParams });\n\n // If debug state has changed, refetch guides and resubscribe to the websocket channel\n const debugStateChanged = this.checkDebugStateChanged(\n currentDebugParams,\n newDebugParams,\n );\n\n if (debugStateChanged) {\n this.knock.log(\n `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n );\n this.fetch();\n this.subscribe();\n }\n };\n\n // Returns whether debug params have changed. For guide key, we only check\n // presence since the exact value has no impact on fetch/subscribe\n private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n return (\n Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n a.previewSessionId !== b.previewSessionId\n );\n }\n\n private listenForLocationChangesFromWindow() {\n const win = checkForWindow();\n if (win?.history && win?.addEventListener) {\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 removeLocationChangeEventListeners() {\n const win = checkForWindow();\n if (!win?.history || !win?.removeEventListener) return;\n\n win.removeEventListener(\"popstate\", this.handleLocationChange);\n win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n if (this.pushStateFn) {\n win.history.pushState = this.pushStateFn;\n this.pushStateFn = undefined;\n }\n if (this.replaceStateFn) {\n win.history.replaceState = this.replaceStateFn;\n this.replaceStateFn = undefined;\n }\n }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","_a","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","formatFilters","formatState","guides","checkStateIfThrottled","unthrottledGuides","throttledCount","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guideGroupDisplayLogs","DEFAULT_GROUP_KEY","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"kVAuDMA,EAAoC,GAIpCC,EAAqC,GAAK,IAG1CC,EAAwB,EAGjBC,EAAqB,CAChC,UAAW,kBACX,mBAAoB,0BACtB,EAEMC,EAAoB,oBAGpBC,EAAiB,IAAM,CACvB,GAAA,OAAO,OAAW,IACb,OAAA,MAEX,EAEaC,EAAqBC,GAChC,aAAaA,CAAM,UAGfC,EAAoB,IAAkB,CAC1C,MAAMC,EAAMJ,EAAe,EAC3B,GAAI,CAACI,GAAO,CAACA,EAAI,SACf,MAAO,CAAE,eAAgB,KAAM,iBAAkB,IAAK,EAGxD,MAAMC,EAAY,IAAI,gBAAgBD,EAAI,SAAS,MAAM,EACnDE,EAAcD,EAAU,IAAIP,EAAmB,SAAS,EACxDS,EAAsBF,EAAU,IACpCP,EAAmB,kBACrB,EAGA,GAAIQ,GAAeC,EAAqB,CACtC,GAAIH,EAAI,aACF,GAAA,CACF,MAAMI,EAAa,CACjB,eAAgBF,EAChB,iBAAkBC,CACpB,EACAH,EAAI,aAAa,QAAQL,EAAmB,KAAK,UAAUS,CAAU,CAAC,CAAA,MAChE,CAAA,CAIH,MAAA,CACL,eAAgBF,EAChB,iBAAkBC,CACpB,CAAA,CAIF,IAAIE,EAAiB,KACjBC,EAAyB,KAE7B,GAAIN,EAAI,aACF,GAAA,CACF,MAAMO,EAAmBP,EAAI,aAAa,QAAQL,CAAiB,EACnE,GAAIY,EAAkB,CACd,MAAAC,EAAmBC,EAAyBF,CAAgB,EAClEF,EAAiBG,EAAiB,eAClCF,EAAyBE,EAAiB,gBAAA,CAC5C,MACM,CAAA,CAKH,MAAA,CACL,eAAgBH,EAChB,iBAAkBC,CACpB,CACF,EAEMG,EAA4BC,GAA8B,CAC1D,GAAA,CACI,MAAAC,EAAS,KAAK,MAAMD,CAAK,EACxB,MAAA,CACL,gBAAgBC,GAAA,YAAAA,EAAQ,iBAAkB,KAC1C,kBAAkBA,GAAA,YAAAA,EAAQ,mBAAoB,IAChD,CAAA,MACM,CACC,MAAA,CACL,eAAgB,KAChB,iBAAkB,IACpB,CAAA,CAEJ,EAEMC,EAAS,CAACC,EAAmBC,EAA8B,KAAO,CAEhE,MAAAC,EAAS,IAAIC,kBAEbC,EAAeC,EAAAA,iBAAiBL,EAAM,WAAW,EACnD,GAAA,CAACI,EAAqB,OAAAF,EAE1B,MAAMI,EAAkB,CAAC,GAAGF,EAAa,gBAAgB,EACnDG,EAAWP,EAAM,SAGnB,GAAAA,EAAM,MAAM,eAAgB,CAC9B,MAAMQ,EAAiBF,EAAgB,QAAQN,EAAM,MAAM,cAAc,EACrEQ,EAAiB,IACHF,EAAA,OAAOE,EAAgB,CAAC,EAE1BF,EAAA,QAAQN,EAAM,MAAM,cAAc,CAAA,CAGpD,SAAW,CAACS,EAAOC,CAAQ,IAAKJ,EAAgB,UAAW,CACrD,IAAAK,EAAQX,EAAM,OAAOU,CAAQ,EAI/BV,EAAM,MAAM,iBAAmBU,GAC/BV,EAAM,cAAcU,CAAQ,IAEpBC,EAAAX,EAAM,cAAcU,CAAQ,GAGlC,GAACC,GAQD,CANaC,EAAUD,EAAO,CAChC,SAAAJ,EACA,QAAAN,EACA,MAAOD,EAAM,KAAA,CACd,IAIME,EAAA,IAAIO,EAAOE,CAAK,CAAA,CAGlB,OAAAT,EAAA,SAAW,CAAE,WAAYE,CAAa,EACtCF,CACT,EAQMU,EAAY,CAChBD,EACA,CAAE,SAAAJ,EAAU,QAAAN,EAAU,GAAI,MAAAY,EAAQ,CAAA,KAC/B,CAKH,GAJIZ,EAAQ,MAAQA,EAAQ,OAASU,EAAM,MAIvCV,EAAQ,KAAOA,EAAQ,MAAQU,EAAM,IAChC,MAAA,GAML,GAAAE,EAAM,iBAAmBF,EAAM,IAC1B,MAAA,GAOL,GAJA,CAACA,EAAM,QAIPA,EAAM,MAAM,MAAOG,GAAM,CAAC,CAACA,EAAE,QAAQ,WAAW,EAC3C,MAAA,GAGT,MAAMC,EAAMR,EAAWS,SAAOT,CAAQ,EAAI,OAEpCU,EAAWN,EAAM,sBAAwB,CAAC,EAC1CO,EAAcP,EAAM,yBAA2B,CAAC,EAGlD,GAAAI,GAAOE,EAAS,OAAS,GAEvB,GAAA,CADYE,EAAAA,kBAAkBJ,EAAKE,CAAQ,EAC1B,MAAA,WACZF,GAAOG,EAAY,OAAS,GAEjC,CADYE,EAAAA,qBAAqBL,EAAKG,CAAW,EAChC,MAAA,GAGhB,MAAA,EACT,EAEO,MAAMG,CAAiB,CA4B5B,YACWC,EACAC,EACAC,EAA6B,CAC7B,EAAAC,EAA2B,GACpC,CAhCKC,EAAA,cAGCA,EAAA,eACAA,EAAA,sBACAA,EAAA,2BACAA,EAAA,wBAAmB,CACzB,cACA,gBACA,gBACA,oBACA,sBACA,4BACF,GACQA,EAAA,2BAAsB,GAGtBA,EAAA,oBACAA,EAAA,uBAKAA,EAAA,cAEAA,EAAA,0BA62BAA,EAAA,4BAAuB,IAAM,CAC9B,KAAA,MAAM,IAAI,+BAA+B,EAC9C,MAAMvC,EAAMJ,EAAe,EACvB,GAAA,EAACI,GAAA,MAAAA,EAAK,UAAU,OAEd,MAAAwC,EAAOxC,EAAI,SAAS,KAC1B,GAAI,KAAK,MAAM,MAAM,WAAawC,EAAM,OAExC,KAAK,MAAM,IAAI,uCAAuCA,CAAI,EAAE,EAGtD,MAAAC,EAAqB,KAAK,MAAM,MAAM,MACtCC,EAAiB3C,EAAkB,EAEzC,KAAK,YAAYyC,EAAM,CAAE,MAAOE,EAAgB,EAGtB,KAAK,uBAC7BD,EACAC,CACF,IAGE,KAAK,MAAM,IACT,2FACF,EACA,KAAK,MAAM,EACX,KAAK,UAAU,EAEnB,SAv4BW,KAAA,MAAAP,EACA,KAAA,UAAAC,EACA,KAAA,aAAAC,EACA,KAAA,QAAAC,EAEH,KAAA,CACJ,wBAAAK,EAA0B,GAC1B,sBAAAC,EAAwBpD,CAAA,EACtB8C,EACEtC,EAAMJ,EAAe,EAErBwB,EAAWuB,GAA0BE,EAAA7C,GAAA,YAAAA,EAAK,WAAL,YAAA6C,EAAe,KAAO,OAE3DnB,EAAQ3B,EAAkB,EAE3B,KAAA,MAAQ,IAAI+C,QAAkB,CACjC,YAAa,CAAC,EACd,sBAAuB,CAAC,EACxB,OAAQ,CAAC,EACT,cAAe,CAAC,EAChB,QAAS,CAAC,EACV,SAAA1B,EAEA,QAAS,EACT,MAAAM,CAAA,CACD,EAGD,KAAM,CAAE,OAAQqB,CAAA,EAAgB,KAAK,MAAM,OAAO,EAClD,KAAK,OAASA,EACT,KAAA,mBAAqB,UAAUX,CAAS,GAEzCO,GACF,KAAK,mCAAmC,EAGtCC,GAEF,KAAK,qBAAqBA,CAAqB,EAG5C,KAAA,MAAM,IAAI,oCAAoC,CAAA,CAG7C,kBAAmB,CACpB,KAAA,MAAM,IAAI,kCAAkC,EAC5C,KAAA,MAAM,SAAU/B,IAAW,CAAE,GAAGA,EAAO,QAASA,EAAM,QAAU,CAAI,EAAA,CAAA,CAGnE,qBAAqBmC,EAAe,CACrC,KAAA,kBAAoB,YAAY,IAAM,CACpC,KAAA,MAAM,IAAI,+BAA+B,EAC1C,OAAK,OAAS,KAAK,MAAM,SAAW,WAExC,KAAK,iBAAiB,GACrBA,CAAK,CAAA,CAGF,sBAAuB,CACzB,KAAK,oBACP,cAAc,KAAK,iBAAiB,EACpC,KAAK,kBAAoB,OAC3B,CAGF,SAAU,CACR,KAAK,YAAY,EACjB,KAAK,mCAAmC,EACxC,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,CAAA,CAG5B,MAAM,MAAMC,EAAwC,CAC7C,KAAA,MAAM,IAAI,gBAAgB,EAC/B,KAAK,MAAM,uBAAuB,EAElC,MAAMC,EAAc,KAAK,iBAAiBD,GAAA,YAAAA,EAAM,OAAO,EACjDE,EAAW,KAAK,eAAeD,CAAW,EAG1CE,EAAmB,KAAK,MAAM,MAAM,QAAQD,CAAQ,EAC1D,GAAIC,EACK,OAAAA,EAIJ,KAAA,MAAM,SAAUvC,IAAW,CAC9B,GAAGA,EACH,QAAS,CAAE,GAAGA,EAAM,QAAS,CAACsC,CAAQ,EAAG,CAAE,OAAQ,SAAY,CAAA,CAAA,EAC/D,EAEE,IAAAE,EACA,GAAA,CACG,KAAA,MAAM,IAAI,sCAAsC,EAC/C,MAAAC,EAAO,MAAM,KAAK,MAAM,KAAK,UAGjC,KAAK,UAAWJ,CAAW,EACfG,EAAA,CAAE,OAAQ,IAAK,EAE7B,KAAM,CAAE,QAAAE,EAAS,aAAcC,EAAQ,yBAAAC,CAA6B,EAAAH,EAE/D,KAAA,MAAM,IAAI,gCAAgC,EAC1C,KAAA,MAAM,SAAUzC,IAAW,CAC9B,GAAGA,EACH,aAAa2C,GAAA,YAAAA,EAAQ,QAAS,EAAIA,EAAS,CAACE,EAAAA,iBAAiBH,CAAO,CAAC,EACrE,sBAAuBE,GAA4B,CAAC,EACpD,OAAQE,EAAAA,MAAMJ,EAAQ,IAAKK,GAAM,KAAK,UAAUA,CAAC,CAAC,CAAC,EACnD,QAAS,CAAE,GAAG/C,EAAM,QAAS,CAACsC,CAAQ,EAAGE,CAAY,CAAA,EACrD,QACKQ,EAAG,CACVR,EAAc,CAAE,OAAQ,QAAS,MAAOQ,CAAW,EAE9C,KAAA,MAAM,SAAUhD,IAAW,CAC9B,GAAGA,EACH,QAAS,CAAE,GAAGA,EAAM,QAAS,CAACsC,CAAQ,EAAGE,CAAY,CAAA,EACrD,CAAA,CAGG,OAAAA,CAAA,CAGT,WAAY,CACN,GAAA,CAAC,KAAK,OAAQ,OAClB,KAAK,MAAM,uBAAuB,EAC7B,KAAA,MAAM,IAAI,0CAA0C,EAGpD,KAAK,OAAO,eACf,KAAK,OAAO,QAAQ,EAIlB,KAAK,eACP,KAAK,YAAY,EAIb,MAAAjD,EAAa,KAAK,MAAM,MAAM,MAC9B0D,EAAS,CACb,GAAG,KAAK,aACR,QAAS,KAAK,MAAM,OACpB,iBAAkB1D,EAAW,eAAiB,GAAO,OACrD,mBAAoBA,EAAW,kBAAoB,MACrD,EAEM2D,EAAa,KAAK,OAAO,QAAQ,KAAK,mBAAoBD,CAAM,EAE3D,UAAAE,KAAa,KAAK,iBAC3BD,EAAW,GAAGC,EAAYC,GAAY,KAAK,kBAAkBA,CAAO,CAAC,EAGnE,CAAC,SAAU,SAAS,EAAE,SAASF,EAAW,KAAK,IAEjD,KAAK,oBAAsB,EAE3BA,EACG,KAAK,EACL,QAAQ,KAAM,IAAM,CACd,KAAA,MAAM,IAAI,qCAAqC,CACrD,CAAA,EACA,QAAQ,QAAUG,GAAS,CAC1B,KAAK,MAAM,IACT,mCAAmC,KAAK,UAAUA,CAAI,CAAC,EACzD,EACA,KAAK,uBAAuB,CAAA,CAC7B,EACA,QAAQ,UAAW,IAAM,CACnB,KAAA,MAAM,IAAI,gCAAgC,EAC/C,KAAK,uBAAuB,CAAA,CAC7B,GAIL,KAAK,cAAgBH,CAAA,CAGf,wBAAyB,CAG3B,GAAA,KAAK,qBAAuBtE,EAAuB,CACrD,KAAK,MAAM,IACT,iDAAiD,KAAK,mBAAmB,EAC3E,EACA,KAAK,YAAY,EACjB,MAAA,CAGG,KAAA,qBAAA,CAGP,aAAc,CACR,GAAC,KAAK,cACL,MAAA,MAAM,IAAI,8CAA8C,EAGlD,UAAAuE,KAAa,KAAK,iBACtB,KAAA,cAAc,IAAIA,CAAS,EAElC,KAAK,cAAc,MAAM,EAGzB,KAAK,cAAgB,OAAA,CAGf,kBAAkBC,EAA2B,CAC7C,KAAA,CAAE,MAAAE,EAAO,KAAAb,CAAA,EAASW,EAExB,OAAQE,EAAO,CACb,IAAK,cACI,OAAA,KAAK,kBAAkBF,CAAO,EAEvC,IAAK,gBACI,OAAAX,EAAK,SACR,KAAK,kBAAkBW,CAAO,EAC9B,KAAK,YAAYA,CAAO,EAE9B,IAAK,gBACI,OAAA,KAAK,YAAYA,CAAO,EAEjC,IAAK,oBACL,IAAK,sBACI,OAAA,KAAK,uBAAuBA,CAAO,EAE5C,IAAK,6BACI,OAAA,KAAK,mBAAmBA,CAAO,EAExC,QACE,MAAA,CACJ,CAGF,YAAYzB,EAAc4B,EAAwC,GAAI,CACpE,KAAK,MAAM,IAAI,6BAA6B5B,CAAI,GAAG,EAGnD,KAAK,gBAAgB,EAEhB,KAAA,MAAM,IAAI,uCAAuC,EACjD,KAAA,MAAM,SAAU3B,GAAU,OAE7B,MAAMwD,GAAgBxB,EAAAuB,GAAA,YAAAA,EAAkB,QAAlB,MAAAvB,EAAyB,iBAC3ChC,EAAM,cACN,CAAC,EAEE,MAAA,CACL,GAAGA,EACH,GAAGuD,EACH,cAAAC,EACA,SAAU7B,CACZ,CAAA,CACD,CAAA,CAGH,eAAgB,CACT,KAAA,MAAM,IAAI,4BAA4B,EAG3C,MAAMxC,EAAMJ,EAAe,EAC3B,GAAII,GAAA,MAAAA,EAAK,aACH,GAAA,CACEA,EAAA,aAAa,WAAWL,CAAiB,CAAA,MACvC,CAAA,CAcV,GARK,KAAA,MAAM,SAAUkB,IAAW,CAC9B,GAAGA,EACH,MAAO,CAAE,eAAgB,KAAM,iBAAkB,IAAK,EACtD,cAAe,CAAA,CAAC,EAChB,EAIEb,GAAA,MAAAA,EAAK,SAAU,CACjB,MAAM4B,EAAM,IAAI,IAAI5B,EAAI,SAAS,IAAI,GAEnC4B,EAAI,aAAa,IAAIlC,EAAmB,SAAS,GACjDkC,EAAI,aAAa,IAAIlC,EAAmB,kBAAkB,KAEtDkC,EAAA,aAAa,OAAOlC,EAAmB,SAAS,EAChDkC,EAAA,aAAa,OAAOlC,EAAmB,kBAAkB,EACzDM,EAAA,SAAS,KAAO4B,EAAI,SAAS,EACnC,CACF,CAOF,aACEf,EACAC,EAA8B,CAAA,EAC9BmC,EAAyB,CAAA,EACR,CAMjB,GALA,KAAK,MAAM,IACT,mCAAmCqB,EAAAA,cAAcxD,CAAO,CAAC,YAAYyD,EAAA,YAAY1D,CAAK,CAAC,GACzF,EAGI,CADkB,KAAK,YAAYA,EAAOC,EAASmC,CAAI,EAEzD,MAAO,CAAC,EAIJ,MAAAuB,EAAS,CAAC,GAAG5D,EAAOC,EAAOC,CAAO,EAAE,QAAQ,EAElD,GAAI,CAACmC,EAAK,kBAAoBwB,EAAA,sBAAsB5D,CAAK,EAAG,CAC1D,MAAM6D,EAAoBF,EAAO,OAC9BZ,GAAMA,EAAE,yBACX,EACMe,EAAiBH,EAAO,OAASE,EAAkB,OACzD,YAAK,MAAM,IACT,sBAAsBC,CAAc,yCAAyCD,EAAkB,MAAM,SACvG,EAEOA,CAAA,CAGT,YAAK,MAAM,IAAI,qBAAqBF,EAAO,MAAM,wBAAwB,EAClEA,CAAA,CAGT,YACE3D,EACAC,EAA8B,CAAA,EAC9BmC,EAAwB,CAAA,EACG,CAI3B,GAHA,KAAK,MAAM,IACT,kCAAkCqB,EAAAA,cAAcxD,CAAO,CAAC,YAAYyD,EAAA,YAAY1D,CAAK,CAAC,GACxF,EAEE,OAAO,KAAKA,EAAM,MAAM,EAAE,SAAW,GACrC,OAAO,KAAKA,EAAM,aAAa,EAAE,SAAW,EAC5C,CACK,KAAA,MAAM,IAAI,uCAAuC,EAC/C,MAAA,CAGH,MAAAE,EAASH,EAAOC,EAAOC,CAAO,EAEhC,GAAAC,EAAO,OAAS,EAAG,CAChB,KAAA,MAAM,IAAI,qCAAqC,EAC7C,MAAA,CAGH,KAAA,CAACO,EAAOE,CAAK,EAAI,CAAC,GAAGT,CAAM,EAAE,CAAC,EAOpC,GANA,KAAK,MAAM,IACT,8BAA8BS,EAAM,GAAG,cAAcT,EAAO,IAAI,GAClE,EAIIS,EAAM,0BACR,YAAK,MAAM,IAAI,4CAA4CA,EAAM,GAAG,EAAE,EAC/DA,EAKT,GAAI,CAACyB,EAAK,kBAAoBwB,EAAA,sBAAsB5D,CAAK,EAAG,CAC1D,KAAK,MAAM,IAAI,0CAA0CW,EAAM,GAAG,EAAE,EAC7D,MAAA,CAoCD,OAJH,KAAK,QACH,KAAA,MAAQ,KAAK,eAAe,GAG3B,KAAK,MAAM,OAAQ,CACzB,IAAK,OAAQ,CACX,KAAK,MAAM,IAAI,sCAAsCA,EAAM,GAAG,EAAE,EAChE,KAAK,MAAM,QAAQF,CAAK,EAAIE,EAAM,IAC3B,MAAA,CAGT,IAAK,QAAS,CACZ,KAAK,MAAM,IAAI,qCAAqCA,EAAM,GAAG,EAAE,EAC/D,KAAK,MAAM,QAAQF,CAAK,EAAIE,EAAM,IAElC,MAAMoD,EAAM,KAAK,MAAM,WAAapD,EAAM,IAAMA,EAAQ,OACxD,YAAK,MAAM,IACT,uBAAuBoD,GAAA,YAAAA,EAAK,GAAG,cAAcC,EAAAA,iBAAiB,KAAK,KAAK,CAAC,GAC3E,EACOD,CAAA,CAGT,IAAK,SAAU,CACb,MAAMA,EAAM,KAAK,MAAM,WAAapD,EAAM,IAAMA,EAAQ,OACxD,YAAK,MAAM,IACT,uBAAuBoD,GAAA,YAAAA,EAAK,GAAG,cAAcC,EAAAA,iBAAiB,KAAK,KAAK,CAAC,GAC3E,EACOD,CAAA,CACT,CACF,CAGM,gBAAiB,CAClB,KAAA,MAAM,IAAI,mCAAmC,EAE5C,KAAA,CACJ,wBAAyB5B,EAAQzD,GAC/B,KAAK,QAEHuF,EAAY,WAAW,IAAM,CACjC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACrB9B,CAAK,EAER,YAAK,MAAQ,CACX,OAAQ,OACR,QAAS,CAAC,EACV,UAAA8B,CACF,EAEO,KAAK,KAAA,CAKN,wBAAyB,CAE/B,GADK,KAAA,MAAM,IAAI,iCAAiC,EAC5C,CAAC,KAAK,OAAS,KAAK,MAAM,SAAW,SAAU,OAInD,KAAK,mBAAmB,EAGxB,IAAIC,EACJ,OAAI,KAAK,MAAM,MAAM,MAAM,iBACdA,EAAA,KAAK,MAAM,QAAQ,KAC3BC,GAAMA,IAAM,KAAK,MAAM,MAAM,MAAM,cACtC,GAGGD,IACHA,EAAW,KAAK,MAAM,QAAQ,KAAMC,GAAMA,IAAM,MAAS,GAG3D,KAAK,MAAM,IACT,qDAAqDD,CAAQ,EAC/D,EAEA,KAAK,MAAQ,CACX,GAAG,KAAK,MACR,OAAQ,SACR,SAAAA,EACA,UAAW,IACb,EAEO,KAAK,KAAA,CAQN,uBAAwB,OAE1B,GADC,KAAA,MAAM,IAAI,gCAAgC,IAC3ClC,EAAA,KAAK,QAAL,YAAAA,EAAY,UAAW,SAAU,OAErC,KAAM,CAAE,wBAAyBG,EAAQ,GAAM,KAAK,QAE9C8B,EAAY,WAAW,IAAM,CACjC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACrB9B,CAAK,EAGR,YAAK,mBAAmB,EAEnB,KAAA,MAAM,IAAI,0CAA0C,EAEzD,KAAK,MAAQ,CACX,GAAG,KAAK,MACR,OAAQ,QACR,QAAS,CAAC,EACV,UAAA8B,CACF,EAEO,KAAK,KAAA,CAGN,iBAAkB,CACnB,KAAA,MAAM,IAAI,0BAA0B,EACpC,KAAK,QAEL,KAAA,MAAM,IAAI,0CAA0C,EACzD,KAAK,mBAAmB,EACxB,KAAK,MAAQ,OAAA,CAGP,oBAAqB,QACvBjC,EAAA,KAAK,QAAL,MAAAA,EAAY,WACD,aAAA,KAAK,MAAM,SAAS,CACnC,CAKM,aACNhC,EACAC,EAA8B,CAAA,EAC9BmC,EAAwB,CAAA,EACxB,CACA,YAAK,eAAe,EAEf,KAAA,YAAYpC,EAAOC,EAASmC,CAAI,EACrC,KAAK,uBAAuB,EAErB,KAAK,YAAYpC,EAAOC,EAASmC,CAAI,CAAA,CAGtC,cACNpC,EACAC,EAA8B,CAAA,EAC9BmC,EAAyB,CAAA,EACzB,CACA,YAAK,eAAe,EAEf,KAAA,aAAapC,EAAOC,EAASmC,CAAI,EACtC,KAAK,uBAAuB,EAErB,KAAK,aAAapC,EAAOC,EAASmC,CAAI,CAAA,CAU/C,MAAM,WAAWzB,EAAkByD,EAAqB,CAClD,GAAAA,EAAK,QAAQ,QAAS,OAE1B,KAAK,MAAM,IACT,uCAAuCzD,EAAM,GAAG,cAAcyD,EAAK,GAAG,GACxE,EAEA,MAAMC,EAAc,KAAK,oBAAoB1D,EAAM,IAAKyD,EAAK,IAAK,CAChE,QAAS,IAAI,KAAK,EAAE,YAAY,CAAA,CACjC,EACD,GAAI,CAACC,EAAa,OAElB,MAAMpB,EAAS,CACb,GAAG,KAAK,+BAA+BtC,EAAO0D,CAAW,EACzD,QAASA,EAAY,QACrB,KAAM,KAAK,aAAa,IAC1B,EAEA,YAAK,MAAM,KAAK,gBACd,OACApB,CACF,EAEOoB,CAAA,CAGT,MAAM,iBACJ1D,EACAyD,EACAE,EACA,CACA,KAAK,MAAM,IACT,6CAA6C3D,EAAM,GAAG,cAAcyD,EAAK,GAAG,GAC9E,EAEA,MAAMG,EAAK,IAAI,KAAK,EAAE,YAAY,EAC5BF,EAAc,KAAK,oBAAoB1D,EAAM,IAAKyD,EAAK,IAAK,CAChE,QAASG,EACT,cAAeA,CAAA,CAChB,EACD,GAAI,CAACF,EAAa,OAElB,MAAMpB,EAAS,CACb,GAAG,KAAK,+BAA+BtC,EAAO0D,CAAW,EACzD,SAAAC,CACF,EAEA,YAAK,MAAM,KAAK,gBAGd,aAAcrB,CAAM,EAEfoB,CAAA,CAGT,MAAM,eAAe1D,EAAkByD,EAAqB,CACtD,GAAAA,EAAK,QAAQ,YAAa,OAE9B,KAAK,MAAM,IACT,2CAA2CzD,EAAM,GAAG,cAAcyD,EAAK,GAAG,GAC5E,EAEA,MAAMC,EAAc,KAAK,oBAAoB1D,EAAM,IAAKyD,EAAK,IAAK,CAChE,YAAa,IAAI,KAAK,EAAE,YAAY,CAAA,CACrC,EACD,GAAI,CAACC,EAAa,OAElB,MAAMpB,EAAS,KAAK,+BAA+BtC,EAAO0D,CAAW,EAErE,YAAK,MAAM,KAAK,gBACd,WACA,CACE,GAAGpB,EACH,YAAatC,EAAM,yBAAA,CAEvB,EAEO0D,CAAA,CAOD,UAAUG,EAAwB,CAExC,MAAMC,EAAO,KAGPC,EAAa,CACjB,GAAGF,EAEH,SAAU,CAER,OAAIC,EAAK,MAAM,MAAM,MAAM,iBAAmB,KAAK,IAC1C,KAAK,MAAM,CAAC,EAGd,KAAK,MAAM,KAAM3D,GAAM,CAACA,EAAE,QAAQ,WAAW,CAAA,CAExD,EAEA,OAAA4D,EAAW,QAAUA,EAAW,QAAQ,KAAKA,CAAU,EAE5CA,EAAA,MAAQF,EAAY,MAAM,IAAI,CAAC,CAAE,QAAAG,EAAS,GAAGC,KAAW,CACjE,MAAMC,EAAY,CAChB,GAAGD,EACH,QAAS,CAAE,GAAGD,CAAQ,EACtB,YAAa,CACJ,OAAAF,EAAK,WAAWC,EAAY,IAAI,CACzC,EACA,iBAAiB,CAAE,SAAAJ,CAAS,EAAgC,GAAI,CAC9D,OAAOG,EAAK,iBAAiBC,EAAY,KAAMJ,CAAQ,CACzD,EACA,gBAAiB,CACR,OAAAG,EAAK,eAAeC,EAAY,IAAI,CAAA,CAE/C,EAIA,OAAAG,EAAU,WAAaA,EAAU,WAAW,KAAKA,CAAS,EAC1DA,EAAU,iBAAmBA,EAAU,iBAAiB,KAAKA,CAAS,EACtEA,EAAU,eAAiBA,EAAU,eAAe,KAAKA,CAAS,EAE3DA,CAAA,CACR,EAEDH,EAAW,wBACTF,EAAY,wBAAwB,IAAKM,IAChC,CACL,GAAGA,EACH,QAAS,IAAIC,EAAA,WAAW,CAAE,SAAUD,EAAK,QAAU,CAAA,CACrD,EACD,EAEIJ,CAAA,CAGD,iBAAiBM,EAAkC,GAAI,CAE7D,MAAMC,EAA8B,CAClC,GAAG,KAAK,aACR,GAAGD,CACL,EAGmB,KAAK,MAAM,MAAM,MACrB,iBACbC,EAAe,iBAAmB,IAIpC,IAAIhC,EAAS,OAAO,YAClB,OAAO,QAAQgC,CAAc,EAAE,OAC7B,CAAC,CAACC,EAAIC,CAAC,IAAyBA,GAAM,IAAA,CAE1C,EAGS,OAAAlC,EAAAA,EAAO,KACZ,CAAE,GAAGA,EAAQ,KAAM,KAAK,UAAUA,EAAO,IAAI,CAC7C,EAAAA,EAEGA,CAAA,CAGD,eAAeZ,EAA0B,CAG/C,MAAM+C,EAFa,OAAO,KAAK/C,CAAW,EAAE,KAAK,EAG9C,IACEgD,GACC,GAAG,mBAAmBA,CAAG,CAAC,IAAI,mBAAmBhD,EAAYgD,CAAG,CAAC,CAAC,EAAA,EAErE,KAAK,GAAG,EAELC,EAAWtG,EAAkB,KAAK,MAAM,MAAM,EACpD,OAAOoG,EAAW,GAAGE,CAAQ,IAAIF,CAAQ,GAAKE,CAAA,CAGxC,oBACN5E,EACA6E,EACAC,EACA,CACI,IAAAnB,EAIJ,OAAImB,EAAM,aACR,KAAK,gBAAgB,EAGlB,KAAA,MAAM,SAAUxF,GAAU,CACzB,IAAAW,EAAQX,EAAM,OAAOU,CAAQ,EAC7B,GAAA,CAACC,EAAc,OAAAX,EAEnB,MAAMyF,EAAQ9E,EAAM,MAAM,IAAKyD,IACzBA,EAAK,MAAQmB,IAIjBnB,EAAK,QAAU,CAAE,GAAGA,EAAK,QAAS,GAAGoB,CAAM,EAC7BnB,EAAAD,GAEPA,EACR,EAEDzD,EAAQ0D,EAAc,CAAE,GAAG1D,EAAO,MAAA8E,CAAU,EAAA9E,EAEtC,MAAAgD,EAAS,CAAE,GAAG3D,EAAM,OAAQ,CAACW,EAAM,GAAG,EAAGA,CAAM,EAI/C+E,EACJF,EAAM,aAAe,CAAC7E,EAAM,0BACxB,CACE,GAAGX,EAAM,sBACT,CAAC2F,EAAAA,iBAAiB,EAAGH,EAAM,aAE7BxF,EAAM,sBAEZ,MAAO,CAAE,GAAGA,EAAO,OAAA2D,EAAQ,sBAAA+B,CAAsB,CAAA,CAClD,EAEMrB,CAAA,CAGD,+BACN1D,EACAyD,EACA,CACO,MAAA,CACL,WAAYzD,EAAM,WAClB,UAAWA,EAAM,IACjB,SAAUA,EAAM,GAChB,eAAgByD,EAAK,IAErB,OAAQ,KAAK,aAAa,MAC5B,CAAA,CAGM,kBAAkB,CAAE,KAAA3B,GAA6C,CACvE,KAAK,sBAAsB,EAE3B,MAAM9B,EAAQ,KAAK,UAAU8B,EAAK,KAAK,EAElC,KAAA,MAAM,SAAUzC,GAAU,CACvB,MAAA2D,EAAS,CAAE,GAAG3D,EAAM,OAAQ,CAACW,EAAM,GAAG,EAAGA,CAAM,EAE9C,MAAA,CAAE,GAAGX,EAAO,OAAA2D,CAAO,CAAA,CAC3B,CAAA,CAGK,YAAY,CAAE,KAAAlB,GAA+C,CACnE,KAAK,sBAAsB,EAEtB,KAAA,MAAM,SAAUzC,GAAU,CACvB,KAAA,CAAE,CAACyC,EAAK,MAAM,GAAG,EAAGmD,EAAG,GAAGhB,GAAS5E,EAAM,OAC/C,MAAO,CAAE,GAAGA,EAAO,OAAQ4E,CAAK,CAAA,CACjC,CAAA,CAGK,uBAAuB,CAC7B,KAAAnC,CAAA,EACgD,CAChD,KAAK,sBAAsB,EAEtB,KAAA,MAAM,SAAUzC,GAAU,CAGvB,MAAA6F,EAAc,CAACpD,EAAK,WAAW,EAI/BqD,EAAcrD,EAAK,YAAY,8BAAgC,CAAC,EAChEsD,EAAYtD,EAAK,YAAY,4BAA8B,CAAC,EAElE,IAAIkB,EAAS3D,EAAM,OAEnB,OAAA2D,EAASmC,EAAY,OAAO,CAACE,EAAKX,IAAQ,CACxC,GAAI,CAACW,EAAIX,CAAG,EAAU,OAAAW,EACtB,MAAMrF,EAAQ,CAAE,GAAGqF,EAAIX,CAAG,EAAG,0BAA2B,EAAK,EAC7D,MAAO,CAAE,GAAGW,EAAK,CAACX,CAAG,EAAG1E,CAAM,GAC7BgD,CAAM,EAETA,EAASoC,EAAU,OAAO,CAACC,EAAKX,IAAQ,CACtC,GAAI,CAACW,EAAIX,CAAG,EAAU,OAAAW,EACtB,MAAMrF,EAAQ,CAAE,GAAGqF,EAAIX,CAAG,EAAG,0BAA2B,EAAM,EAC9D,MAAO,CAAE,GAAGW,EAAK,CAACX,CAAG,EAAG1E,CAAM,GAC7BgD,CAAM,EAEF,CAAE,GAAG3D,EAAO,OAAA2D,EAAQ,YAAAkC,CAAY,CAAA,CACxC,CAAA,CAGK,mBAAmB,CAAE,KAAApD,GAAsC,CACjE,MAAM9B,EAAQ,KAAK,UAAU8B,EAAK,KAAK,EAElC,KAAA,MAAM,SAAUzC,GAAU,CACvB,MAAAwD,EAAgB,CAAE,GAAGxD,EAAM,cAAe,CAACW,EAAM,GAAG,EAAGA,CAAM,EAC5D,MAAA,CAAE,GAAGX,EAAO,cAAAwD,CAAc,CAAA,CAClC,CAAA,CAqCK,uBAAuByC,EAAeC,EAAwB,CAElE,MAAA,EAAQD,EAAE,gBAAoB,EAAQC,EAAE,gBACxCD,EAAE,mBAAqBC,EAAE,gBAAA,CAIrB,oCAAqC,CAC3C,MAAM/G,EAAMJ,EAAe,EACvB,GAAAI,GAAA,MAAAA,EAAK,UAAWA,GAAA,MAAAA,EAAK,kBAAkB,CAErCA,EAAA,iBAAiB,WAAY,KAAK,oBAAoB,EAGtDA,EAAA,iBAAiB,aAAc,KAAK,oBAAoB,EAGtD,MAAAgH,EAAchH,EAAI,QAAQ,UAC1BiH,EAAiBjH,EAAI,QAAQ,aAGnCA,EAAI,QAAQ,UAAY,IAAI,MAAMgH,EAAa,CAC7C,MAAO,CAACE,EAAQC,EAASC,IAAS,CACxB,QAAA,MAAMF,EAAQC,EAASC,CAAI,EACnC,WAAW,IAAM,CACf,KAAK,qBAAqB,GACzB,CAAC,CAAA,CACN,CACD,EACDpH,EAAI,QAAQ,aAAe,IAAI,MAAMiH,EAAgB,CACnD,MAAO,CAACC,EAAQC,EAASC,IAAS,CACxB,QAAA,MAAMF,EAAQC,EAASC,CAAI,EACnC,WAAW,IAAM,CACf,KAAK,qBAAqB,GACzB,CAAC,CAAA,CACN,CACD,EAGD,KAAK,YAAcJ,EACnB,KAAK,eAAiBC,CAAA,MAEtB,KAAK,MAAM,IACT,iFACF,CACF,CAGF,oCAAqC,CACnC,MAAMjH,EAAMJ,EAAe,EACvB,EAACI,GAAA,MAAAA,EAAK,UAAW,EAACA,GAAA,MAAAA,EAAK,uBAEvBA,EAAA,oBAAoB,WAAY,KAAK,oBAAoB,EACzDA,EAAA,oBAAoB,aAAc,KAAK,oBAAoB,EAE3D,KAAK,cACHA,EAAA,QAAQ,UAAY,KAAK,YAC7B,KAAK,YAAc,QAEjB,KAAK,iBACHA,EAAA,QAAQ,aAAe,KAAK,eAChC,KAAK,eAAiB,QACxB,CAEJ"}
package/dist/esm/api.mjs CHANGED
@@ -56,7 +56,7 @@ class k {
56
56
  return i.isNetworkError(e) ? !0 : e.response ? e.response.status >= 500 && e.response.status <= 599 || e.response.status === 429 : !1;
57
57
  }
58
58
  getKnockClientHeader() {
59
- return "Knock/ClientJS 0.20.1";
59
+ return "Knock/ClientJS 0.20.3";
60
60
  }
61
61
  }
62
62
  export {
@@ -3,16 +3,16 @@ var b = (u, e, t) => e in u ? _(u, e, { enumerable: !0, configurable: !0, writab
3
3
  var d = (u, e, t) => b(u, typeof e != "symbol" ? e + "" : e, t);
4
4
  import { Store as I } from "@tanstack/store";
5
5
  import { URLPattern as C } from "urlpattern-polyfill";
6
- import { byKey as E, mockDefaultGroup as w, formatFilters as k, formatState as f, checkStateIfThrottled as G, formatGroupStage as S, DEFAULT_GROUP_KEY as R, SelectionResult as P, findDefaultGroup as A, newUrl as D, predicateUrlRules as K, predicateUrlPatterns as L } from "./helpers.mjs";
6
+ import { byKey as E, mockDefaultGroup as w, formatFilters as f, formatState as G, checkStateIfThrottled as S, formatGroupStage as y, DEFAULT_GROUP_KEY as R, SelectionResult as P, findDefaultGroup as A, newUrl as L, predicateUrlRules as D, predicateUrlPatterns as K } from "./helpers.mjs";
7
7
  const $ = 50, T = 30 * 1e3, O = 3, g = {
8
8
  GUIDE_KEY: "knock_guide_key",
9
9
  PREVIEW_SESSION_ID: "knock_preview_session_id"
10
- }, p = "knock_guide_debug", l = () => {
10
+ }, k = "knock_guide_debug", l = () => {
11
11
  if (typeof window < "u")
12
12
  return window;
13
- }, U = (u) => `/v1/users/${u}/guides`, y = () => {
13
+ }, U = (u) => `/v1/users/${u}/guides`, m = () => {
14
14
  const u = l();
15
- if (!u)
15
+ if (!u || !u.location)
16
16
  return { forcedGuideKey: null, previewSessionId: null };
17
17
  const e = new URLSearchParams(u.location.search), t = e.get(g.GUIDE_KEY), s = e.get(
18
18
  g.PREVIEW_SESSION_ID
@@ -24,7 +24,7 @@ const $ = 50, T = 30 * 1e3, O = 3, g = {
24
24
  forcedGuideKey: t,
25
25
  previewSessionId: s
26
26
  };
27
- u.localStorage.setItem(p, JSON.stringify(i));
27
+ u.localStorage.setItem(k, JSON.stringify(i));
28
28
  } catch {
29
29
  }
30
30
  return {
@@ -35,7 +35,7 @@ const $ = 50, T = 30 * 1e3, O = 3, g = {
35
35
  let r = null, n = null;
36
36
  if (u.localStorage)
37
37
  try {
38
- const i = u.localStorage.getItem(p);
38
+ const i = u.localStorage.getItem(k);
39
39
  if (i) {
40
40
  const o = F(i);
41
41
  r = o.forcedGuideKey, n = o.previewSessionId;
@@ -59,7 +59,7 @@ const $ = 50, T = 30 * 1e3, O = 3, g = {
59
59
  previewSessionId: null
60
60
  };
61
61
  }
62
- }, m = (u, e = {}) => {
62
+ }, v = (u, e = {}) => {
63
63
  const t = new P(), s = A(u.guideGroups);
64
64
  if (!s) return t;
65
65
  const r = [...s.display_sequence], n = u.location;
@@ -83,10 +83,10 @@ const $ = 50, T = 30 * 1e3, O = 3, g = {
83
83
  return !0;
84
84
  if (!u.active || u.steps.every((o) => !!o.message.archived_at))
85
85
  return !1;
86
- const r = e ? D(e) : void 0, n = u.activation_url_rules || [], i = u.activation_url_patterns || [];
86
+ const r = e ? L(e) : void 0, n = u.activation_url_rules || [], i = u.activation_url_patterns || [];
87
87
  if (r && n.length > 0) {
88
- if (!K(r, n)) return !1;
89
- } else if (r && i.length > 0 && !L(r, i))
88
+ if (!D(r, n)) return !1;
89
+ } else if (r && i.length > 0 && !K(r, i))
90
90
  return !1;
91
91
  return !0;
92
92
  };
@@ -122,7 +122,7 @@ class B {
122
122
  const t = e.location.href;
123
123
  if (this.store.state.location === t) return;
124
124
  this.knock.log(`[Guide] Detected a location change: ${t}`);
125
- const s = this.store.state.debug, r = y();
125
+ const s = this.store.state.debug, r = m();
126
126
  this.setLocation(t, { debug: r }), this.checkDebugStateChanged(
127
127
  s,
128
128
  r
@@ -130,11 +130,12 @@ class B {
130
130
  "[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel"
131
131
  ), this.fetch(), this.subscribe());
132
132
  });
133
+ var p;
133
134
  this.knock = e, this.channelId = t, this.targetParams = s, this.options = r;
134
135
  const {
135
136
  trackLocationFromWindow: n = !0,
136
137
  throttleCheckInterval: i = T
137
- } = r, o = l(), a = n ? o == null ? void 0 : o.location.href : void 0, h = y();
138
+ } = r, o = l(), a = n ? (p = o == null ? void 0 : o.location) == null ? void 0 : p.href : void 0, h = m();
138
139
  this.store = new I({
139
140
  guideGroups: [],
140
141
  guideGroupDisplayLogs: {},
@@ -182,7 +183,7 @@ class B {
182
183
  ...c,
183
184
  guideGroups: (a == null ? void 0 : a.length) > 0 ? a : [w(o)],
184
185
  guideGroupDisplayLogs: h || {},
185
- guides: E(o.map((v) => this.localCopy(v))),
186
+ guides: E(o.map((p) => this.localCopy(p))),
186
187
  queries: { ...c.queries, [s]: n }
187
188
  }));
188
189
  } catch (i) {
@@ -266,7 +267,7 @@ class B {
266
267
  const e = l();
267
268
  if (e != null && e.localStorage)
268
269
  try {
269
- e.localStorage.removeItem(p);
270
+ e.localStorage.removeItem(k);
270
271
  } catch {
271
272
  }
272
273
  if (this.store.setState((t) => ({
@@ -274,7 +275,7 @@ class B {
274
275
  debug: { forcedGuideKey: null, previewSessionId: null },
275
276
  previewGuides: {}
276
277
  // Clear preview guides when exiting debug mode
277
- })), e) {
278
+ })), e != null && e.location) {
278
279
  const t = new URL(e.location.href);
279
280
  (t.searchParams.has(g.GUIDE_KEY) || t.searchParams.has(g.PREVIEW_SESSION_ID)) && (t.searchParams.delete(g.GUIDE_KEY), t.searchParams.delete(g.PREVIEW_SESSION_ID), e.location.href = t.toString());
280
281
  }
@@ -284,11 +285,11 @@ class B {
284
285
  //
285
286
  selectGuides(e, t = {}, s = {}) {
286
287
  if (this.knock.log(
287
- `[Guide] .selectGuides (filters: ${k(t)}; state: ${f(e)})`
288
+ `[Guide] .selectGuides (filters: ${f(t)}; state: ${G(e)})`
288
289
  ), !this.selectGuide(e, t, s))
289
290
  return [];
290
- const n = [...m(e, t).values()];
291
- if (!s.includeThrottled && G(e)) {
291
+ const n = [...v(e, t).values()];
292
+ if (!s.includeThrottled && S(e)) {
292
293
  const i = n.filter(
293
294
  (a) => a.bypass_global_group_limit
294
295
  ), o = n.length - i.length;
@@ -300,12 +301,12 @@ class B {
300
301
  }
301
302
  selectGuide(e, t = {}, s = {}) {
302
303
  if (this.knock.log(
303
- `[Guide] .selectGuide (filters: ${k(t)}; state: ${f(e)})`
304
+ `[Guide] .selectGuide (filters: ${f(t)}; state: ${G(e)})`
304
305
  ), Object.keys(e.guides).length === 0 && Object.keys(e.previewGuides).length === 0) {
305
306
  this.knock.log("[Guide] Exiting selection (no guides)");
306
307
  return;
307
308
  }
308
- const r = m(e, t);
309
+ const r = v(e, t);
309
310
  if (r.size === 0) {
310
311
  this.knock.log("[Guide] Selection found zero result");
311
312
  return;
@@ -315,7 +316,7 @@ class B {
315
316
  `[Guide] Selection found: \`${i.key}\` (total: ${r.size})`
316
317
  ), i.bypass_global_group_limit)
317
318
  return this.knock.log(`[Guide] Returning the unthrottled guide: ${i.key}`), i;
318
- if (!s.includeThrottled && G(e)) {
319
+ if (!s.includeThrottled && S(e)) {
319
320
  this.knock.log(`[Guide] Throttling the selected guide: ${i.key}`);
320
321
  return;
321
322
  }
@@ -328,13 +329,13 @@ class B {
328
329
  this.knock.log(`[Guide] Patching the group stage: ${i.key}`), this.stage.ordered[n] = i.key;
329
330
  const o = this.stage.resolved === i.key ? i : void 0;
330
331
  return this.knock.log(
331
- `[Guide] Returning \`${o == null ? void 0 : o.key}\` (stage: ${S(this.stage)})`
332
+ `[Guide] Returning \`${o == null ? void 0 : o.key}\` (stage: ${y(this.stage)})`
332
333
  ), o;
333
334
  }
334
335
  case "closed": {
335
336
  const o = this.stage.resolved === i.key ? i : void 0;
336
337
  return this.knock.log(
337
- `[Guide] Returning \`${o == null ? void 0 : o.key}\` (stage: ${S(this.stage)})`
338
+ `[Guide] Returning \`${o == null ? void 0 : o.key}\` (stage: ${y(this.stage)})`
338
339
  ), o;
339
340
  }
340
341
  }
@@ -476,15 +477,13 @@ class B {
476
477
  ...n,
477
478
  message: { ...r },
478
479
  markAsSeen() {
479
- if (!this.message.seen_at)
480
- return t.markAsSeen(s, this);
480
+ return t.markAsSeen(s, this);
481
481
  },
482
482
  markAsInteracted({ metadata: o } = {}) {
483
483
  return t.markAsInteracted(s, this, o);
484
484
  },
485
485
  markAsArchived() {
486
- if (!this.message.archived_at)
487
- return t.markAsArchived(s, this);
486
+ return t.markAsArchived(s, this);
488
487
  }
489
488
  };
490
489
  return i.markAsSeen = i.markAsSeen.bind(i), i.markAsInteracted = i.markAsInteracted.bind(i), i.markAsArchived = i.markAsArchived.bind(i), i;
@@ -581,7 +580,7 @@ class B {
581
580
  }
582
581
  listenForLocationChangesFromWindow() {
583
582
  const e = l();
584
- if (e != null && e.history) {
583
+ if (e != null && e.history && (e != null && e.addEventListener)) {
585
584
  e.addEventListener("popstate", this.handleLocationChange), e.addEventListener("hashchange", this.handleLocationChange);
586
585
  const t = e.history.pushState, s = e.history.replaceState;
587
586
  e.history.pushState = new Proxy(t, {
@@ -604,7 +603,7 @@ class B {
604
603
  }
605
604
  removeLocationChangeEventListeners() {
606
605
  const e = l();
607
- 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));
606
+ !(e != null && e.history) || !(e != null && e.removeEventListener) || (e.removeEventListener("popstate", this.handleLocationChange), e.removeEventListener("hashchange", this.handleLocationChange), this.pushStateFn && (e.history.pushState = this.pushStateFn, this.pushStateFn = void 0), this.replaceStateFn && (e.history.replaceState = this.replaceStateFn, this.replaceStateFn = void 0));
608
607
  }
609
608
  }
610
609
  export {
@@ -1 +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 checkStateIfThrottled,\n findDefaultGroup,\n formatFilters,\n formatGroupStage,\n formatState,\n mockDefaultGroup,\n newUrl,\n predicateUrlPatterns,\n predicateUrlRules,\n} from \"./helpers\";\nimport {\n Any,\n ConstructorOpts,\n DebugState,\n GetGuidesQueryParams,\n GetGuidesResponse,\n GroupStage,\n GuideAddedEvent,\n GuideData,\n GuideGroupAddedEvent,\n GuideGroupUpdatedEvent,\n GuideLivePreviewUpdatedEvent,\n GuideRemovedEvent,\n GuideSocketEvent,\n GuideStepData,\n GuideUpdatedEvent,\n KnockGuide,\n KnockGuideStep,\n MarkAsArchivedParams,\n MarkAsInteractedParams,\n MarkAsSeenParams,\n MarkGuideAsResponse,\n QueryFilterParams,\n QueryStatus,\n SelectFilterParams,\n SelectGuideOpts,\n SelectGuidesOpts,\n StepMessageState,\n StoreState,\n TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n GUIDE_KEY: \"knock_guide_key\",\n PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n if (typeof window !== \"undefined\") {\n return window;\n }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n const win = checkForWindow();\n if (!win) {\n return { forcedGuideKey: null, previewSessionId: null };\n }\n\n const urlParams = new URLSearchParams(win.location.search);\n const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n const urlPreviewSessionId = urlParams.get(\n DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n );\n\n // If URL params exist, persist them to localStorage and return them\n if (urlGuideKey || urlPreviewSessionId) {\n if (win.localStorage) {\n try {\n const debugState = {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n } catch {\n // Silently fail in privacy mode\n }\n }\n return {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n }\n\n // Check local storage if no URL params\n let storedGuideKey = null;\n let storedPreviewSessionId = null;\n\n if (win.localStorage) {\n try {\n const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n if (storedDebugState) {\n const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n storedGuideKey = parsedDebugState.forcedGuideKey;\n storedPreviewSessionId = parsedDebugState.previewSessionId;\n }\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n return {\n forcedGuideKey: storedGuideKey,\n previewSessionId: storedPreviewSessionId,\n };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n try {\n const parsed = JSON.parse(value);\n return {\n forcedGuideKey: parsed?.forcedGuideKey ?? null,\n previewSessionId: parsed?.previewSessionId ?? null,\n };\n } catch {\n return {\n forcedGuideKey: null,\n previewSessionId: null,\n };\n }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n // A map of selected guides as values, with its order index as keys.\n const result = new SelectionResult();\n\n const defaultGroup = findDefaultGroup(state.guideGroups);\n if (!defaultGroup) return result;\n\n const displaySequence = [...defaultGroup.display_sequence];\n const location = state.location;\n\n // If in debug mode, put the forced guide at the beginning of the display sequence.\n if (state.debug.forcedGuideKey) {\n const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n if (forcedKeyIndex > -1) {\n displaySequence.splice(forcedKeyIndex, 1);\n }\n displaySequence.unshift(state.debug.forcedGuideKey);\n }\n\n for (const [index, guideKey] of displaySequence.entries()) {\n let guide = state.guides[guideKey];\n\n // Use preview guide if it exists and matches the forced guide key\n if (\n state.debug.forcedGuideKey === guideKey &&\n state.previewGuides[guideKey]\n ) {\n guide = state.previewGuides[guideKey];\n }\n\n if (!guide) continue;\n\n const affirmed = predicate(guide, {\n location,\n filters,\n debug: state.debug,\n });\n\n if (!affirmed) continue;\n\n result.set(index, guide);\n }\n\n result.metadata = { guideGroup: defaultGroup };\n return result;\n};\n\ntype PredicateOpts = {\n location?: string | undefined;\n filters?: SelectFilterParams | undefined;\n debug: DebugState;\n};\n\nconst predicate = (\n guide: KnockGuide,\n { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n if (filters.type && filters.type !== guide.type) {\n return false;\n }\n\n if (filters.key && filters.key !== guide.key) {\n return false;\n }\n\n // Bypass filtering if the debugged guide matches the given filters.\n // This should always run AFTER checking the filters but BEFORE\n // checking archived status and location rules.\n if (debug.forcedGuideKey === guide.key) {\n return true;\n }\n\n if (!guide.active) {\n return false;\n }\n\n if (guide.steps.every((s) => !!s.message.archived_at)) {\n return false;\n }\n\n const url = location ? newUrl(location) : undefined;\n\n const urlRules = guide.activation_url_rules || [];\n const urlPatterns = guide.activation_url_patterns || [];\n\n // A guide can have either activation url rules XOR url patterns, but not both.\n if (url && urlRules.length > 0) {\n const allowed = predicateUrlRules(url, urlRules);\n if (!allowed) return false;\n } else if (url && urlPatterns.length > 0) {\n const allowed = predicateUrlPatterns(url, urlPatterns);\n if (!allowed) return false;\n }\n\n return true;\n};\n\nexport class KnockGuideClient {\n public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n // Phoenix channels for real time guide updates over websocket\n private socket: Socket | undefined;\n private socketChannel: Channel | undefined;\n private socketChannelTopic: string;\n private socketEventTypes = [\n \"guide.added\",\n \"guide.updated\",\n \"guide.removed\",\n \"guide_group.added\",\n \"guide_group.updated\",\n \"guide.live_preview_updated\",\n ];\n private subscribeRetryCount = 0;\n\n // Original history methods to monkey patch, or restore in cleanups.\n private pushStateFn: History[\"pushState\"] | undefined;\n private replaceStateFn: History[\"replaceState\"] | undefined;\n\n // Guides that are competing to render are \"staged\" first without rendering\n // and ranked based on its relative order in the group over a duration of time\n // to resolve and render the prevailing one.\n private stage: GroupStage | undefined;\n\n private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n constructor(\n readonly knock: Knock,\n readonly channelId: string,\n readonly targetParams: TargetParams = {},\n readonly options: ConstructorOpts = {},\n ) {\n const {\n trackLocationFromWindow = true,\n throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n } = options;\n const win = checkForWindow();\n\n const location = trackLocationFromWindow ? win?.location.href : undefined;\n\n const debug = detectDebugParams();\n\n this.store = new Store<StoreState>({\n guideGroups: [],\n guideGroupDisplayLogs: {},\n guides: {},\n previewGuides: {},\n queries: {},\n location,\n // Increment to update the state store and trigger re-selection.\n counter: 0,\n debug,\n });\n\n // In server environments we might not have a socket connection.\n const { socket: maybeSocket } = this.knock.client();\n this.socket = maybeSocket;\n this.socketChannelTopic = `guides:${channelId}`;\n\n if (trackLocationFromWindow) {\n this.listenForLocationChangesFromWindow();\n }\n\n if (throttleCheckInterval) {\n // Start the counter loop to increment at an interval.\n this.startCounterInterval(throttleCheckInterval);\n }\n\n this.knock.log(\"[Guide] Initialized a guide client\");\n }\n\n private incrementCounter() {\n this.knock.log(\"[Guide] Incrementing the counter\");\n this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n }\n\n private startCounterInterval(delay: number) {\n this.counterIntervalId = setInterval(() => {\n this.knock.log(\"[Guide] Counter interval tick\");\n if (this.stage && this.stage.status !== \"closed\") return;\n\n this.incrementCounter();\n }, delay);\n }\n\n private clearCounterInterval() {\n if (this.counterIntervalId) {\n clearInterval(this.counterIntervalId);\n this.counterIntervalId = undefined;\n }\n }\n\n cleanup() {\n this.unsubscribe();\n this.removeLocationChangeEventListeners();\n this.clearGroupStage();\n this.clearCounterInterval();\n }\n\n async fetch(opts?: { filters?: QueryFilterParams }) {\n this.knock.log(\"[Guide] .fetch\");\n this.knock.failIfNotAuthenticated();\n\n const queryParams = this.buildQueryParams(opts?.filters);\n const queryKey = this.formatQueryKey(queryParams);\n\n // If already fetched before, then noop.\n const maybeQueryStatus = this.store.state.queries[queryKey];\n if (maybeQueryStatus) {\n return maybeQueryStatus;\n }\n\n // Mark this query status as loading.\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n }));\n\n let queryStatus: QueryStatus;\n try {\n this.knock.log(\"[Guide] Fetching all eligible guides\");\n const data = await this.knock.user.getGuides<\n GetGuidesQueryParams,\n GetGuidesResponse\n >(this.channelId, queryParams);\n queryStatus = { status: \"ok\" };\n\n const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n this.knock.log(\"[Guide] Loading fetched guides\");\n this.store.setState((state) => ({\n ...state,\n guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n guideGroupDisplayLogs: guide_group_display_logs || {},\n guides: byKey(entries.map((g) => this.localCopy(g))),\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n } catch (e) {\n queryStatus = { status: \"error\", error: e as Error };\n\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n }\n\n return queryStatus;\n }\n\n subscribe() {\n if (!this.socket) return;\n this.knock.failIfNotAuthenticated();\n this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n // Ensure a live socket connection if not yet connected.\n if (!this.socket.isConnected()) {\n this.socket.connect();\n }\n\n // If there's an existing connected channel, then disconnect.\n if (this.socketChannel) {\n this.unsubscribe();\n }\n\n // Join the channel topic and subscribe to supported events.\n const debugState = this.store.state.debug;\n const params = {\n ...this.targetParams,\n user_id: this.knock.userId,\n force_all_guides: debugState.forcedGuideKey ? true : undefined,\n preview_session_id: debugState.previewSessionId || undefined,\n };\n\n const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n for (const eventType of this.socketEventTypes) {\n newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n }\n\n if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n // Reset retry count for new subscription attempt\n this.subscribeRetryCount = 0;\n\n newChannel\n .join()\n .receive(\"ok\", () => {\n this.knock.log(\"[Guide] Successfully joined channel\");\n })\n .receive(\"error\", (resp) => {\n this.knock.log(\n `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n );\n this.handleChannelJoinError();\n })\n .receive(\"timeout\", () => {\n this.knock.log(\"[Guide] Channel join timed out\");\n this.handleChannelJoinError();\n });\n }\n\n // Track the joined channel.\n this.socketChannel = newChannel;\n }\n\n private handleChannelJoinError() {\n // Prevent phx channel from retrying forever in case of either network or\n // other errors (e.g. auth error, invalid channel etc)\n if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n this.knock.log(\n `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n );\n this.unsubscribe();\n return;\n }\n\n this.subscribeRetryCount++;\n }\n\n unsubscribe() {\n if (!this.socketChannel) return;\n this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n // Unsubscribe from the socket events and leave the channel.\n for (const eventType of this.socketEventTypes) {\n this.socketChannel.off(eventType);\n }\n this.socketChannel.leave();\n\n // Unset the channel.\n this.socketChannel = undefined;\n }\n\n private handleSocketEvent(payload: GuideSocketEvent) {\n const { event, data } = payload;\n\n switch (event) {\n case \"guide.added\":\n return this.addOrReplaceGuide(payload);\n\n case \"guide.updated\":\n return data.eligible\n ? this.addOrReplaceGuide(payload)\n : this.removeGuide(payload);\n\n case \"guide.removed\":\n return this.removeGuide(payload);\n\n case \"guide_group.added\":\n case \"guide_group.updated\":\n return this.addOrReplaceGuideGroup(payload);\n\n case \"guide.live_preview_updated\":\n return this.updatePreviewGuide(payload);\n\n default:\n return;\n }\n }\n\n setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n // Make sure to clear out the stage.\n this.clearGroupStage();\n\n this.knock.log(\"[Guide] Updating the tracked location\");\n this.store.setState((state) => {\n // Clear preview guides if no longer in preview mode\n const previewGuides = additionalParams?.debug?.previewSessionId\n ? state.previewGuides\n : {};\n\n return {\n ...state,\n ...additionalParams,\n previewGuides,\n location: href,\n };\n });\n }\n\n exitDebugMode() {\n this.knock.log(\"[Guide] Exiting debug mode\");\n\n // Clear localStorage debug params\n const win = checkForWindow();\n if (win?.localStorage) {\n try {\n win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n // Clear debug state from store\n this.store.setState((state) => ({\n ...state,\n debug: { forcedGuideKey: null, previewSessionId: null },\n previewGuides: {}, // Clear preview guides when exiting debug mode\n }));\n\n // Remove URL query params if present\n // Only update the URL if params need to be cleared to avoid unnecessary navigations\n if (win) {\n const url = new URL(win.location.href);\n if (\n url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n ) {\n url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n win.location.href = url.toString();\n }\n }\n }\n\n //\n // Store selector\n //\n\n selectGuides<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ): KnockGuide<C>[] {\n this.knock.log(\n `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n\n const selectedGuide = this.selectGuide(state, filters, opts);\n if (!selectedGuide) {\n return [];\n }\n\n // There should be at least one guide to return here now.\n const guides = [...select(state, filters).values()];\n\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n const unthrottledGuides = guides.filter(\n (g) => g.bypass_global_group_limit,\n );\n const throttledCount = guides.length - unthrottledGuides.length;\n this.knock.log(\n `[Guide] Throttling ${throttledCount} guides from selection, and returning ${unthrottledGuides.length} guides`,\n );\n\n return unthrottledGuides;\n }\n\n this.knock.log(`[Guide] Returning ${guides.length} guides from selection`);\n return guides;\n }\n\n selectGuide<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ): KnockGuide<C> | undefined {\n this.knock.log(\n `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n if (\n Object.keys(state.guides).length === 0 &&\n Object.keys(state.previewGuides).length === 0\n ) {\n this.knock.log(\"[Guide] Exiting selection (no guides)\");\n return undefined;\n }\n\n const result = select(state, filters);\n\n if (result.size === 0) {\n this.knock.log(\"[Guide] Selection found zero result\");\n return undefined;\n }\n\n const [index, guide] = [...result][0]!;\n this.knock.log(\n `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n );\n\n // If a guide ignores the group limit, then return immediately to render\n // always.\n if (guide.bypass_global_group_limit) {\n this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n return guide;\n }\n\n // Check if inside the throttle window (i.e. throttled) and if so stop and\n // return undefined unless explicitly given the option to include throttled.\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n 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] Adding to the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n return undefined;\n }\n\n case \"patch\": {\n this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n\n case \"closed\": {\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n }\n }\n\n private openGroupStage() {\n this.knock.log(\"[Guide] Opening a new group stage\");\n\n const {\n orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n this.stage = {\n status: \"open\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n // Close the current non-closed stage to resolve the prevailing guide up next\n // for display amongst the ones that have been staged.\n private closePendingGroupStage() {\n this.knock.log(\"[Guide] .closePendingGroupStage\");\n if (!this.stage || this.stage.status === \"closed\") return;\n\n // Should have been cleared already since this method should be called as a\n // callback to a setTimeout, but just to be safe.\n this.ensureClearTimeout();\n\n // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n let resolved = undefined;\n if (this.store.state.debug.forcedGuideKey) {\n resolved = this.stage.ordered.find(\n (x) => x === this.store.state.debug.forcedGuideKey,\n );\n }\n\n if (!resolved) {\n resolved = this.stage.ordered.find((x) => x !== undefined);\n }\n\n this.knock.log(\n `[Guide] Closing the current group stage: resolved=${resolved}`,\n );\n\n this.stage = {\n ...this.stage,\n status: \"closed\",\n resolved,\n timeoutId: null,\n };\n\n return this.stage;\n }\n\n // Set the current closed stage status to \"patch\" to allow re-running\n // selections and re-building a group stage with the latest/updated state,\n // while keeping the currently resolved guide in place so that it stays\n // rendered until we are ready to resolve the updated stage and re-render.\n // Note, must be called ahead of updating the state store.\n private patchClosedGroupStage() {\n this.knock.log(\"[Guide] .patchClosedGroupStage\");\n if (this.stage?.status !== \"closed\") return;\n\n const { orderResolutionDuration: delay = 0 } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n // Just to be safe.\n this.ensureClearTimeout();\n\n this.knock.log(\"[Guide] Patching the current group stage\");\n\n this.stage = {\n ...this.stage,\n status: \"patch\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n private clearGroupStage() {\n this.knock.log(\"[Guide] .clearGroupStage\");\n if (!this.stage) return;\n\n this.knock.log(\"[Guide] Clearing the current group stage\");\n this.ensureClearTimeout();\n this.stage = undefined;\n }\n\n private ensureClearTimeout() {\n if (this.stage?.timeoutId) {\n clearTimeout(this.stage.timeoutId);\n }\n }\n\n // Test helpers to open and close the group stage to return the select result\n // immediately.\n private _selectGuide(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuide(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuide(state, filters, opts);\n }\n\n private _selectGuides(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuides(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuides(state, filters, opts);\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 };\n\n this.knock.user.markGuideStepAs<MarkAsSeenParams, MarkGuideAsResponse>(\n \"seen\",\n params,\n );\n\n return updatedStep;\n }\n\n async markAsInteracted(\n guide: GuideData,\n step: GuideStepData,\n metadata?: GenericData,\n ) {\n this.knock.log(\n `[Guide] Marking as interacted (Guide key: ${guide.key}; Step ref:${step.ref})`,\n );\n\n const ts = new Date().toISOString();\n const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n read_at: ts,\n interacted_at: ts,\n });\n if (!updatedStep) return;\n\n const params = {\n ...this.buildEngagementEventBaseParams(guide, updatedStep),\n metadata,\n };\n\n this.knock.user.markGuideStepAs<\n MarkAsInteractedParams,\n MarkGuideAsResponse\n >(\"interacted\", params);\n\n return updatedStep;\n }\n\n async markAsArchived(guide: GuideData, step: GuideStepData) {\n if (step.message.archived_at) return;\n\n this.knock.log(\n `[Guide] Marking as archived (Guide key: ${guide.key}, Step ref:${step.ref})`,\n );\n\n const updatedStep = this.setStepMessageAttrs(guide.key, step.ref, {\n archived_at: new Date().toISOString(),\n });\n if (!updatedStep) return;\n\n const params = this.buildEngagementEventBaseParams(guide, updatedStep);\n\n this.knock.user.markGuideStepAs<MarkAsArchivedParams, MarkGuideAsResponse>(\n \"archived\",\n {\n ...params,\n unthrottled: guide.bypass_global_group_limit,\n },\n );\n\n return updatedStep;\n }\n\n //\n // Helpers\n //\n\n private localCopy(remoteGuide: GuideData) {\n // eslint-disable-next-line @typescript-eslint/no-this-alias\n const self = this;\n\n // Build a local copy with helper methods added.\n const localGuide = {\n ...remoteGuide,\n // Get the next unarchived step.\n getStep() {\n // If debugging this guide, return the first step regardless of archive status\n if (self.store.state.debug.forcedGuideKey === this.key) {\n return this.steps[0];\n }\n\n return this.steps.find((s) => !s.message.archived_at);\n },\n } as KnockGuide;\n\n localGuide.getStep = localGuide.getStep.bind(localGuide);\n\n localGuide.steps = remoteGuide.steps.map(({ message, ...rest }) => {\n const localStep = {\n ...rest,\n message: { ...message },\n markAsSeen() {\n // Send a seen event if it has not been previously seen.\n if (this.message.seen_at) return;\n return self.markAsSeen(localGuide, this);\n },\n markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n // Always send an interaction event through.\n return self.markAsInteracted(localGuide, this, metadata);\n },\n markAsArchived() {\n // Send an archived event if it has not been previously archived.\n if (this.message.archived_at) return;\n return self.markAsArchived(localGuide, this);\n },\n };\n\n // Bind all engagement action handler methods to the local step object so\n // they can operate on itself.\n localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n return localStep;\n });\n\n localGuide.activation_url_patterns =\n remoteGuide.activation_url_patterns.map((rule) => {\n return {\n ...rule,\n pattern: new URLPattern({ pathname: rule.pathname }),\n };\n });\n\n return localGuide;\n }\n\n private buildQueryParams(filterParams: QueryFilterParams = {}) {\n // Combine the target params with the given filter params.\n const combinedParams: GenericData = {\n ...this.targetParams,\n ...filterParams,\n };\n\n // Append debug params\n const debugState = this.store.state.debug;\n if (debugState.forcedGuideKey) {\n combinedParams.force_all_guides = true;\n }\n\n // Prune out any keys that have an undefined or null value.\n let params = Object.fromEntries(\n Object.entries(combinedParams).filter(\n ([_k, v]) => v !== undefined && v !== null,\n ),\n );\n\n // Encode target data as a JSON string, if provided.\n params = params.data\n ? { ...params, data: JSON.stringify(params.data) }\n : params;\n\n return params as GetGuidesQueryParams;\n }\n\n private formatQueryKey(queryParams: GenericData) {\n const sortedKeys = Object.keys(queryParams).sort();\n\n const queryStr = sortedKeys\n .map(\n (key) =>\n `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n )\n .join(\"&\");\n\n const basePath = guidesApiRootPath(this.knock.userId);\n return queryStr ? `${basePath}?${queryStr}` : basePath;\n }\n\n private setStepMessageAttrs(\n guideKey: string,\n stepRef: string,\n attrs: Partial<StepMessageState>,\n ) {\n let updatedStep: KnockGuideStep | undefined;\n\n // If we are marking as archived, clear the group stage so we can render\n // the next guide in the group.\n if (attrs.archived_at) {\n this.clearGroupStage();\n }\n\n this.store.setState((state) => {\n let guide = state.guides[guideKey];\n if (!guide) return state;\n\n const steps = guide.steps.map((step) => {\n if (step.ref !== stepRef) return step;\n\n // Mutate in place and maintain the same obj ref so to make it easier\n // to use in hook deps.\n step.message = { ...step.message, ...attrs };\n updatedStep = step;\n\n return step;\n });\n // If updated, return the guide as a new object so useStore can trigger.\n guide = updatedStep ? { ...guide, steps } : guide;\n\n const guides = { ...state.guides, [guide.key]: guide };\n\n // If the guide is subject to throttled settings and we are marking as\n // archived, then update the display logs to start a new throttle window.\n const guideGroupDisplayLogs =\n attrs.archived_at && !guide.bypass_global_group_limit\n ? {\n ...state.guideGroupDisplayLogs,\n [DEFAULT_GROUP_KEY]: attrs.archived_at,\n }\n : state.guideGroupDisplayLogs;\n\n return { ...state, guides, guideGroupDisplayLogs };\n });\n\n return updatedStep;\n }\n\n private buildEngagementEventBaseParams(\n guide: GuideData,\n step: GuideStepData,\n ) {\n return {\n channel_id: guide.channel_id,\n guide_key: guide.key,\n guide_id: guide.id,\n guide_step_ref: step.ref,\n // Can be used for scoping guide messages.\n tenant: this.targetParams.tenant,\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 this.knock.log(`[Guide] .handleLocationChange`);\n const win = checkForWindow();\n if (!win?.location) return;\n\n const href = win.location.href;\n if (this.store.state.location === href) return;\n\n this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n // If entering debug mode, fetch all guides.\n const currentDebugParams = this.store.state.debug;\n const newDebugParams = detectDebugParams();\n\n this.setLocation(href, { debug: newDebugParams });\n\n // If debug state has changed, refetch guides and resubscribe to the websocket channel\n const debugStateChanged = this.checkDebugStateChanged(\n currentDebugParams,\n newDebugParams,\n );\n\n if (debugStateChanged) {\n this.knock.log(\n `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n );\n this.fetch();\n this.subscribe();\n }\n };\n\n // Returns whether debug params have changed. For guide key, we only check\n // presence since the exact value has no impact on fetch/subscribe\n private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n return (\n Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n a.previewSessionId !== b.previewSessionId\n );\n }\n\n private listenForLocationChangesFromWindow() {\n const win = checkForWindow();\n if (win?.history) {\n // 1. Listen for browser back/forward button clicks.\n win.addEventListener(\"popstate\", this.handleLocationChange);\n\n // 2. Listen for hash changes in case it's used for routing.\n win.addEventListener(\"hashchange\", this.handleLocationChange);\n\n // 3. Monkey-patch history methods to catch programmatic navigation.\n const pushStateFn = win.history.pushState;\n const replaceStateFn = win.history.replaceState;\n\n // Use setTimeout to allow the browser state to potentially settle.\n win.history.pushState = new Proxy(pushStateFn, {\n apply: (target, history, args) => {\n Reflect.apply(target, history, args);\n setTimeout(() => {\n this.handleLocationChange();\n }, 0);\n },\n });\n win.history.replaceState = new Proxy(replaceStateFn, {\n apply: (target, history, args) => {\n Reflect.apply(target, history, args);\n setTimeout(() => {\n this.handleLocationChange();\n }, 0);\n },\n });\n\n // 4. Keep refs to the original handlers so we can restore during cleanup.\n this.pushStateFn = pushStateFn;\n this.replaceStateFn = replaceStateFn;\n } else {\n this.knock.log(\n \"[Guide] Unable to access the `window.history` object to detect location changes\",\n );\n }\n }\n\n removeLocationChangeEventListeners() {\n const win = checkForWindow();\n if (!win?.history) return;\n\n win.removeEventListener(\"popstate\", this.handleLocationChange);\n win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n if (this.pushStateFn) {\n win.history.pushState = this.pushStateFn;\n this.pushStateFn = undefined;\n }\n if (this.replaceStateFn) {\n win.history.replaceState = this.replaceStateFn;\n this.replaceStateFn = undefined;\n }\n }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","_a","formatFilters","formatState","guides","checkStateIfThrottled","unthrottledGuides","throttledCount","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guideGroupDisplayLogs","DEFAULT_GROUP_KEY","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":";;;;;;AAuDA,MAAMA,IAAoC,IAIpCC,IAAqC,KAAK,KAG1CC,IAAwB,GAGjBC,IAAqB;AAAA,EAChC,WAAW;AAAA,EACX,oBAAoB;AACtB,GAEMC,IAAoB,qBAGpBC,IAAiB,MAAM;AACvB,MAAA,OAAO,SAAW;AACb,WAAA;AAEX,GAEaC,IAAoB,CAACC,MAChC,aAAaA,CAAM,WAGfC,IAAoB,MAAkB;AAC1C,QAAMC,IAAMJ,EAAe;AAC3B,MAAI,CAACI;AACH,WAAO,EAAE,gBAAgB,MAAM,kBAAkB,KAAK;AAGxD,QAAMC,IAAY,IAAI,gBAAgBD,EAAI,SAAS,MAAM,GACnDE,IAAcD,EAAU,IAAIP,EAAmB,SAAS,GACxDS,IAAsBF,EAAU;AAAA,IACpCP,EAAmB;AAAA,EACrB;AAGA,MAAIQ,KAAeC,GAAqB;AACtC,QAAIH,EAAI;AACF,UAAA;AACF,cAAMI,IAAa;AAAA,UACjB,gBAAgBF;AAAA,UAChB,kBAAkBC;AAAA,QACpB;AACA,QAAAH,EAAI,aAAa,QAAQL,GAAmB,KAAK,UAAUS,CAAU,CAAC;AAAA,MAAA,QAChE;AAAA,MAAA;AAIH,WAAA;AAAA,MACL,gBAAgBF;AAAA,MAChB,kBAAkBC;AAAA,IACpB;AAAA,EAAA;AAIF,MAAIE,IAAiB,MACjBC,IAAyB;AAE7B,MAAIN,EAAI;AACF,QAAA;AACF,YAAMO,IAAmBP,EAAI,aAAa,QAAQL,CAAiB;AACnE,UAAIY,GAAkB;AACd,cAAAC,IAAmBC,EAAyBF,CAAgB;AAClE,QAAAF,IAAiBG,EAAiB,gBAClCF,IAAyBE,EAAiB;AAAA,MAAA;AAAA,IAC5C,QACM;AAAA,IAAA;AAKH,SAAA;AAAA,IACL,gBAAgBH;AAAA,IAChB,kBAAkBC;AAAA,EACpB;AACF,GAEMG,IAA2B,CAACC,MAA8B;AAC1D,MAAA;AACI,UAAAC,IAAS,KAAK,MAAMD,CAAK;AACxB,WAAA;AAAA,MACL,iBAAgBC,KAAA,gBAAAA,EAAQ,mBAAkB;AAAA,MAC1C,mBAAkBA,KAAA,gBAAAA,EAAQ,qBAAoB;AAAA,IAChD;AAAA,EAAA,QACM;AACC,WAAA;AAAA,MACL,gBAAgB;AAAA,MAChB,kBAAkB;AAAA,IACpB;AAAA,EAAA;AAEJ,GAEMC,IAAS,CAACC,GAAmBC,IAA8B,OAAO;AAEhE,QAAAC,IAAS,IAAIC,EAAgB,GAE7BC,IAAeC,EAAiBL,EAAM,WAAW;AACnD,MAAA,CAACI,EAAqB,QAAAF;AAE1B,QAAMI,IAAkB,CAAC,GAAGF,EAAa,gBAAgB,GACnDG,IAAWP,EAAM;AAGnB,MAAAA,EAAM,MAAM,gBAAgB;AAC9B,UAAMQ,IAAiBF,EAAgB,QAAQN,EAAM,MAAM,cAAc;AACzE,IAAIQ,IAAiB,MACHF,EAAA,OAAOE,GAAgB,CAAC,GAE1BF,EAAA,QAAQN,EAAM,MAAM,cAAc;AAAA,EAAA;AAGpD,aAAW,CAACS,GAAOC,CAAQ,KAAKJ,EAAgB,WAAW;AACrD,QAAAK,IAAQX,EAAM,OAAOU,CAAQ;AAkBjC,IAdEV,EAAM,MAAM,mBAAmBU,KAC/BV,EAAM,cAAcU,CAAQ,MAEpBC,IAAAX,EAAM,cAAcU,CAAQ,IAGlC,GAACC,KAQD,CANaC,EAAUD,GAAO;AAAA,MAChC,UAAAJ;AAAA,MACA,SAAAN;AAAA,MACA,OAAOD,EAAM;AAAA,IAAA,CACd,MAIME,EAAA,IAAIO,GAAOE,CAAK;AAAA,EAAA;AAGlB,SAAAT,EAAA,WAAW,EAAE,YAAYE,EAAa,GACtCF;AACT,GAQMU,IAAY,CAChBD,GACA,EAAE,UAAAJ,GAAU,SAAAN,IAAU,IAAI,OAAAY,IAAQ,CAAA,QAC/B;AAKH,MAJIZ,EAAQ,QAAQA,EAAQ,SAASU,EAAM,QAIvCV,EAAQ,OAAOA,EAAQ,QAAQU,EAAM;AAChC,WAAA;AAML,MAAAE,EAAM,mBAAmBF,EAAM;AAC1B,WAAA;AAOL,MAJA,CAACA,EAAM,UAIPA,EAAM,MAAM,MAAM,CAACG,MAAM,CAAC,CAACA,EAAE,QAAQ,WAAW;AAC3C,WAAA;AAGT,QAAMC,IAAMR,IAAWS,EAAOT,CAAQ,IAAI,QAEpCU,IAAWN,EAAM,wBAAwB,CAAC,GAC1CO,IAAcP,EAAM,2BAA2B,CAAC;AAGlD,MAAAI,KAAOE,EAAS,SAAS;AAEvB,QAAA,CADYE,EAAkBJ,GAAKE,CAAQ,EAC1B,QAAA;AAAA,aACZF,KAAOG,EAAY,SAAS,KAEjC,CADYE,EAAqBL,GAAKG,CAAW;AAChC,WAAA;AAGhB,SAAA;AACT;AAEO,MAAMG,EAAiB;AAAA,EA4B5B,YACWC,GACAC,GACAC,IAA6B,CAC7B,GAAAC,IAA2B,IACpC;AAhCK,IAAAC,EAAA;AAGC;AAAA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA,0BAAmB;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACQ,IAAAA,EAAA,6BAAsB;AAGtB;AAAA,IAAAA,EAAA;AACA,IAAAA,EAAA;AAKA;AAAA;AAAA;AAAA,IAAAA,EAAA;AAEA,IAAAA,EAAA;AAk3BA;AAAA,IAAAA,EAAA,8BAAuB,MAAM;AAC9B,WAAA,MAAM,IAAI,+BAA+B;AAC9C,YAAMvC,IAAMJ,EAAe;AACvB,UAAA,EAACI,KAAA,QAAAA,EAAK,UAAU;AAEd,YAAAwC,IAAOxC,EAAI,SAAS;AAC1B,UAAI,KAAK,MAAM,MAAM,aAAawC,EAAM;AAExC,WAAK,MAAM,IAAI,uCAAuCA,CAAI,EAAE;AAGtD,YAAAC,IAAqB,KAAK,MAAM,MAAM,OACtCC,IAAiB3C,EAAkB;AAEzC,WAAK,YAAYyC,GAAM,EAAE,OAAOE,GAAgB,GAGtB,KAAK;AAAA,QAC7BD;AAAA,QACAC;AAAA,MACF,MAGE,KAAK,MAAM;AAAA,QACT;AAAA,MACF,GACA,KAAK,MAAM,GACX,KAAK,UAAU;AAAA,IAEnB;AA54BW,SAAA,QAAAP,GACA,KAAA,YAAAC,GACA,KAAA,eAAAC,GACA,KAAA,UAAAC;AAEH,UAAA;AAAA,MACJ,yBAAAK,IAA0B;AAAA,MAC1B,uBAAAC,IAAwBpD;AAAA,IAAA,IACtB8C,GACEtC,IAAMJ,EAAe,GAErBwB,IAAWuB,IAA0B3C,KAAA,gBAAAA,EAAK,SAAS,OAAO,QAE1D0B,IAAQ3B,EAAkB;AAE3B,SAAA,QAAQ,IAAI8C,EAAkB;AAAA,MACjC,aAAa,CAAC;AAAA,MACd,uBAAuB,CAAC;AAAA,MACxB,QAAQ,CAAC;AAAA,MACT,eAAe,CAAC;AAAA,MAChB,SAAS,CAAC;AAAA,MACV,UAAAzB;AAAA;AAAA,MAEA,SAAS;AAAA,MACT,OAAAM;AAAA,IAAA,CACD;AAGD,UAAM,EAAE,QAAQoB,EAAA,IAAgB,KAAK,MAAM,OAAO;AAClD,SAAK,SAASA,GACT,KAAA,qBAAqB,UAAUV,CAAS,IAEzCO,KACF,KAAK,mCAAmC,GAGtCC,KAEF,KAAK,qBAAqBA,CAAqB,GAG5C,KAAA,MAAM,IAAI,oCAAoC;AAAA,EAAA;AAAA,EAG7C,mBAAmB;AACpB,SAAA,MAAM,IAAI,kCAAkC,GAC5C,KAAA,MAAM,SAAS,CAAC/B,OAAW,EAAE,GAAGA,GAAO,SAASA,EAAM,UAAU,EAAI,EAAA;AAAA,EAAA;AAAA,EAGnE,qBAAqBkC,GAAe;AACrC,SAAA,oBAAoB,YAAY,MAAM;AAEzC,MADK,KAAA,MAAM,IAAI,+BAA+B,GAC1C,OAAK,SAAS,KAAK,MAAM,WAAW,aAExC,KAAK,iBAAiB;AAAA,OACrBA,CAAK;AAAA,EAAA;AAAA,EAGF,uBAAuB;AAC7B,IAAI,KAAK,sBACP,cAAc,KAAK,iBAAiB,GACpC,KAAK,oBAAoB;AAAA,EAC3B;AAAA,EAGF,UAAU;AACR,SAAK,YAAY,GACjB,KAAK,mCAAmC,GACxC,KAAK,gBAAgB,GACrB,KAAK,qBAAqB;AAAA,EAAA;AAAA,EAG5B,MAAM,MAAMC,GAAwC;AAC7C,SAAA,MAAM,IAAI,gBAAgB,GAC/B,KAAK,MAAM,uBAAuB;AAElC,UAAMC,IAAc,KAAK,iBAAiBD,KAAA,gBAAAA,EAAM,OAAO,GACjDE,IAAW,KAAK,eAAeD,CAAW,GAG1CE,IAAmB,KAAK,MAAM,MAAM,QAAQD,CAAQ;AAC1D,QAAIC;AACK,aAAAA;AAIJ,SAAA,MAAM,SAAS,CAACtC,OAAW;AAAA,MAC9B,GAAGA;AAAA,MACH,SAAS,EAAE,GAAGA,EAAM,SAAS,CAACqC,CAAQ,GAAG,EAAE,QAAQ,UAAY,EAAA;AAAA,IAAA,EAC/D;AAEE,QAAAE;AACA,QAAA;AACG,WAAA,MAAM,IAAI,sCAAsC;AAC/C,YAAAC,IAAO,MAAM,KAAK,MAAM,KAAK,UAGjC,KAAK,WAAWJ,CAAW;AACf,MAAAG,IAAA,EAAE,QAAQ,KAAK;AAE7B,YAAM,EAAE,SAAAE,GAAS,cAAcC,GAAQ,0BAAAC,EAA6B,IAAAH;AAE/D,WAAA,MAAM,IAAI,gCAAgC,GAC1C,KAAA,MAAM,SAAS,CAACxC,OAAW;AAAA,QAC9B,GAAGA;AAAA,QACH,cAAa0C,KAAA,gBAAAA,EAAQ,UAAS,IAAIA,IAAS,CAACE,EAAiBH,CAAO,CAAC;AAAA,QACrE,uBAAuBE,KAA4B,CAAC;AAAA,QACpD,QAAQE,EAAMJ,EAAQ,IAAI,CAACK,MAAM,KAAK,UAAUA,CAAC,CAAC,CAAC;AAAA,QACnD,SAAS,EAAE,GAAG9C,EAAM,SAAS,CAACqC,CAAQ,GAAGE,EAAY;AAAA,MAAA,EACrD;AAAA,aACKQ,GAAG;AACV,MAAAR,IAAc,EAAE,QAAQ,SAAS,OAAOQ,EAAW,GAE9C,KAAA,MAAM,SAAS,CAAC/C,OAAW;AAAA,QAC9B,GAAGA;AAAA,QACH,SAAS,EAAE,GAAGA,EAAM,SAAS,CAACqC,CAAQ,GAAGE,EAAY;AAAA,MAAA,EACrD;AAAA,IAAA;AAGG,WAAAA;AAAA,EAAA;AAAA,EAGT,YAAY;AACN,QAAA,CAAC,KAAK,OAAQ;AAClB,SAAK,MAAM,uBAAuB,GAC7B,KAAA,MAAM,IAAI,0CAA0C,GAGpD,KAAK,OAAO,iBACf,KAAK,OAAO,QAAQ,GAIlB,KAAK,iBACP,KAAK,YAAY;AAIb,UAAAhD,IAAa,KAAK,MAAM,MAAM,OAC9ByD,IAAS;AAAA,MACb,GAAG,KAAK;AAAA,MACR,SAAS,KAAK,MAAM;AAAA,MACpB,kBAAkBzD,EAAW,iBAAiB,KAAO;AAAA,MACrD,oBAAoBA,EAAW,oBAAoB;AAAA,IACrD,GAEM0D,IAAa,KAAK,OAAO,QAAQ,KAAK,oBAAoBD,CAAM;AAE3D,eAAAE,KAAa,KAAK;AAC3B,MAAAD,EAAW,GAAGC,GAAW,CAACC,MAAY,KAAK,kBAAkBA,CAAO,CAAC;AAGvE,IAAI,CAAC,UAAU,SAAS,EAAE,SAASF,EAAW,KAAK,MAEjD,KAAK,sBAAsB,GAE3BA,EACG,KAAK,EACL,QAAQ,MAAM,MAAM;AACd,WAAA,MAAM,IAAI,qCAAqC;AAAA,IACrD,CAAA,EACA,QAAQ,SAAS,CAACG,MAAS;AAC1B,WAAK,MAAM;AAAA,QACT,mCAAmC,KAAK,UAAUA,CAAI,CAAC;AAAA,MACzD,GACA,KAAK,uBAAuB;AAAA,IAAA,CAC7B,EACA,QAAQ,WAAW,MAAM;AACnB,WAAA,MAAM,IAAI,gCAAgC,GAC/C,KAAK,uBAAuB;AAAA,IAAA,CAC7B,IAIL,KAAK,gBAAgBH;AAAA,EAAA;AAAA,EAGf,yBAAyB;AAG3B,QAAA,KAAK,uBAAuBrE,GAAuB;AACrD,WAAK,MAAM;AAAA,QACT,iDAAiD,KAAK,mBAAmB;AAAA,MAC3E,GACA,KAAK,YAAY;AACjB;AAAA,IAAA;AAGG,SAAA;AAAA,EAAA;AAAA,EAGP,cAAc;AACR,QAAC,KAAK,eACL;AAAA,WAAA,MAAM,IAAI,8CAA8C;AAGlD,iBAAAsE,KAAa,KAAK;AACtB,aAAA,cAAc,IAAIA,CAAS;AAElC,WAAK,cAAc,MAAM,GAGzB,KAAK,gBAAgB;AAAA;AAAA,EAAA;AAAA,EAGf,kBAAkBC,GAA2B;AAC7C,UAAA,EAAE,OAAAE,GAAO,MAAAb,EAAA,IAASW;AAExB,YAAQE,GAAO;AAAA,MACb,KAAK;AACI,eAAA,KAAK,kBAAkBF,CAAO;AAAA,MAEvC,KAAK;AACI,eAAAX,EAAK,WACR,KAAK,kBAAkBW,CAAO,IAC9B,KAAK,YAAYA,CAAO;AAAA,MAE9B,KAAK;AACI,eAAA,KAAK,YAAYA,CAAO;AAAA,MAEjC,KAAK;AAAA,MACL,KAAK;AACI,eAAA,KAAK,uBAAuBA,CAAO;AAAA,MAE5C,KAAK;AACI,eAAA,KAAK,mBAAmBA,CAAO;AAAA,MAExC;AACE;AAAA,IAAA;AAAA,EACJ;AAAA,EAGF,YAAYxB,GAAc2B,IAAwC,IAAI;AACpE,SAAK,MAAM,IAAI,6BAA6B3B,CAAI,GAAG,GAGnD,KAAK,gBAAgB,GAEhB,KAAA,MAAM,IAAI,uCAAuC,GACjD,KAAA,MAAM,SAAS,CAAC3B,MAAU;;AAE7B,YAAMuD,KAAgBC,IAAAF,KAAA,gBAAAA,EAAkB,UAAlB,QAAAE,EAAyB,mBAC3CxD,EAAM,gBACN,CAAC;AAEE,aAAA;AAAA,QACL,GAAGA;AAAA,QACH,GAAGsD;AAAA,QACH,eAAAC;AAAA,QACA,UAAU5B;AAAA,MACZ;AAAA,IAAA,CACD;AAAA,EAAA;AAAA,EAGH,gBAAgB;AACT,SAAA,MAAM,IAAI,4BAA4B;AAG3C,UAAMxC,IAAMJ,EAAe;AAC3B,QAAII,KAAA,QAAAA,EAAK;AACH,UAAA;AACE,QAAAA,EAAA,aAAa,WAAWL,CAAiB;AAAA,MAAA,QACvC;AAAA,MAAA;AAcV,QARK,KAAA,MAAM,SAAS,CAACkB,OAAW;AAAA,MAC9B,GAAGA;AAAA,MACH,OAAO,EAAE,gBAAgB,MAAM,kBAAkB,KAAK;AAAA,MACtD,eAAe,CAAA;AAAA;AAAA,IAAC,EAChB,GAIEb,GAAK;AACP,YAAM4B,IAAM,IAAI,IAAI5B,EAAI,SAAS,IAAI;AAEnC,OAAA4B,EAAI,aAAa,IAAIlC,EAAmB,SAAS,KACjDkC,EAAI,aAAa,IAAIlC,EAAmB,kBAAkB,OAEtDkC,EAAA,aAAa,OAAOlC,EAAmB,SAAS,GAChDkC,EAAA,aAAa,OAAOlC,EAAmB,kBAAkB,GACzDM,EAAA,SAAS,OAAO4B,EAAI,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAOF,aACEf,GACAC,IAA8B,CAAA,GAC9BkC,IAAyB,CAAA,GACR;AAMjB,QALA,KAAK,MAAM;AAAA,MACT,mCAAmCsB,EAAcxD,CAAO,CAAC,YAAYyD,EAAY1D,CAAK,CAAC;AAAA,IACzF,GAGI,CADkB,KAAK,YAAYA,GAAOC,GAASkC,CAAI;AAEzD,aAAO,CAAC;AAIJ,UAAAwB,IAAS,CAAC,GAAG5D,EAAOC,GAAOC,CAAO,EAAE,QAAQ;AAElD,QAAI,CAACkC,EAAK,oBAAoByB,EAAsB5D,CAAK,GAAG;AAC1D,YAAM6D,IAAoBF,EAAO;AAAA,QAC/B,CAACb,MAAMA,EAAE;AAAA,MACX,GACMgB,IAAiBH,EAAO,SAASE,EAAkB;AACzD,kBAAK,MAAM;AAAA,QACT,sBAAsBC,CAAc,yCAAyCD,EAAkB,MAAM;AAAA,MACvG,GAEOA;AAAA,IAAA;AAGT,gBAAK,MAAM,IAAI,qBAAqBF,EAAO,MAAM,wBAAwB,GAClEA;AAAA,EAAA;AAAA,EAGT,YACE3D,GACAC,IAA8B,CAAA,GAC9BkC,IAAwB,CAAA,GACG;AAI3B,QAHA,KAAK,MAAM;AAAA,MACT,kCAAkCsB,EAAcxD,CAAO,CAAC,YAAYyD,EAAY1D,CAAK,CAAC;AAAA,IACxF,GAEE,OAAO,KAAKA,EAAM,MAAM,EAAE,WAAW,KACrC,OAAO,KAAKA,EAAM,aAAa,EAAE,WAAW,GAC5C;AACK,WAAA,MAAM,IAAI,uCAAuC;AAC/C;AAAA,IAAA;AAGH,UAAAE,IAASH,EAAOC,GAAOC,CAAO;AAEhC,QAAAC,EAAO,SAAS,GAAG;AAChB,WAAA,MAAM,IAAI,qCAAqC;AAC7C;AAAA,IAAA;AAGH,UAAA,CAACO,GAAOE,CAAK,IAAI,CAAC,GAAGT,CAAM,EAAE,CAAC;AAOpC,QANA,KAAK,MAAM;AAAA,MACT,8BAA8BS,EAAM,GAAG,cAAcT,EAAO,IAAI;AAAA,IAClE,GAIIS,EAAM;AACR,kBAAK,MAAM,IAAI,4CAA4CA,EAAM,GAAG,EAAE,GAC/DA;AAKT,QAAI,CAACwB,EAAK,oBAAoByB,EAAsB5D,CAAK,GAAG;AAC1D,WAAK,MAAM,IAAI,0CAA0CW,EAAM,GAAG,EAAE;AAC7D;AAAA,IAAA;AAoCD,YAJH,KAAK,UACH,KAAA,QAAQ,KAAK,eAAe,IAG3B,KAAK,MAAM,QAAQ;AAAA,MACzB,KAAK,QAAQ;AACX,aAAK,MAAM,IAAI,sCAAsCA,EAAM,GAAG,EAAE,GAChE,KAAK,MAAM,QAAQF,CAAK,IAAIE,EAAM;AAC3B;AAAA,MAAA;AAAA,MAGT,KAAK,SAAS;AACZ,aAAK,MAAM,IAAI,qCAAqCA,EAAM,GAAG,EAAE,GAC/D,KAAK,MAAM,QAAQF,CAAK,IAAIE,EAAM;AAElC,cAAMoD,IAAM,KAAK,MAAM,aAAapD,EAAM,MAAMA,IAAQ;AACxD,oBAAK,MAAM;AAAA,UACT,uBAAuBoD,KAAA,gBAAAA,EAAK,GAAG,cAAcC,EAAiB,KAAK,KAAK,CAAC;AAAA,QAC3E,GACOD;AAAA,MAAA;AAAA,MAGT,KAAK,UAAU;AACb,cAAMA,IAAM,KAAK,MAAM,aAAapD,EAAM,MAAMA,IAAQ;AACxD,oBAAK,MAAM;AAAA,UACT,uBAAuBoD,KAAA,gBAAAA,EAAK,GAAG,cAAcC,EAAiB,KAAK,KAAK,CAAC;AAAA,QAC3E,GACOD;AAAA,MAAA;AAAA,IACT;AAAA,EACF;AAAA,EAGM,iBAAiB;AAClB,SAAA,MAAM,IAAI,mCAAmC;AAE5C,UAAA;AAAA,MACJ,yBAAyB7B,IAAQxD;AAAA,QAC/B,KAAK,SAEHuF,IAAY,WAAW,MAAM;AACjC,WAAK,uBAAuB,GAC5B,KAAK,iBAAiB;AAAA,OACrB/B,CAAK;AAER,gBAAK,QAAQ;AAAA,MACX,QAAQ;AAAA,MACR,SAAS,CAAC;AAAA,MACV,WAAA+B;AAAA,IACF,GAEO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA,EAKN,yBAAyB;AAE/B,QADK,KAAA,MAAM,IAAI,iCAAiC,GAC5C,CAAC,KAAK,SAAS,KAAK,MAAM,WAAW,SAAU;AAInD,SAAK,mBAAmB;AAGxB,QAAIC;AACJ,WAAI,KAAK,MAAM,MAAM,MAAM,mBACdA,IAAA,KAAK,MAAM,QAAQ;AAAA,MAC5B,CAACC,MAAMA,MAAM,KAAK,MAAM,MAAM,MAAM;AAAA,IACtC,IAGGD,MACHA,IAAW,KAAK,MAAM,QAAQ,KAAK,CAACC,MAAMA,MAAM,MAAS,IAG3D,KAAK,MAAM;AAAA,MACT,qDAAqDD,CAAQ;AAAA,IAC/D,GAEA,KAAK,QAAQ;AAAA,MACX,GAAG,KAAK;AAAA,MACR,QAAQ;AAAA,MACR,UAAAA;AAAA,MACA,WAAW;AAAA,IACb,GAEO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQN,wBAAwB;;AAE1B,QADC,KAAA,MAAM,IAAI,gCAAgC,KAC3CV,IAAA,KAAK,UAAL,gBAAAA,EAAY,YAAW,SAAU;AAErC,UAAM,EAAE,yBAAyBtB,IAAQ,MAAM,KAAK,SAE9C+B,IAAY,WAAW,MAAM;AACjC,WAAK,uBAAuB,GAC5B,KAAK,iBAAiB;AAAA,OACrB/B,CAAK;AAGR,gBAAK,mBAAmB,GAEnB,KAAA,MAAM,IAAI,0CAA0C,GAEzD,KAAK,QAAQ;AAAA,MACX,GAAG,KAAK;AAAA,MACR,QAAQ;AAAA,MACR,SAAS,CAAC;AAAA,MACV,WAAA+B;AAAA,IACF,GAEO,KAAK;AAAA,EAAA;AAAA,EAGN,kBAAkB;AAEpB,IADC,KAAA,MAAM,IAAI,0BAA0B,GACpC,KAAK,UAEL,KAAA,MAAM,IAAI,0CAA0C,GACzD,KAAK,mBAAmB,GACxB,KAAK,QAAQ;AAAA,EAAA;AAAA,EAGP,qBAAqB;;AACvB,KAAAT,IAAA,KAAK,UAAL,QAAAA,EAAY,aACD,aAAA,KAAK,MAAM,SAAS;AAAA,EACnC;AAAA;AAAA;AAAA,EAKM,aACNxD,GACAC,IAA8B,CAAA,GAC9BkC,IAAwB,CAAA,GACxB;AACA,gBAAK,eAAe,GAEf,KAAA,YAAYnC,GAAOC,GAASkC,CAAI,GACrC,KAAK,uBAAuB,GAErB,KAAK,YAAYnC,GAAOC,GAASkC,CAAI;AAAA,EAAA;AAAA,EAGtC,cACNnC,GACAC,IAA8B,CAAA,GAC9BkC,IAAyB,CAAA,GACzB;AACA,gBAAK,eAAe,GAEf,KAAA,aAAanC,GAAOC,GAASkC,CAAI,GACtC,KAAK,uBAAuB,GAErB,KAAK,aAAanC,GAAOC,GAASkC,CAAI;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU/C,MAAM,WAAWxB,GAAkByD,GAAqB;AAClD,QAAAA,EAAK,QAAQ,QAAS;AAE1B,SAAK,MAAM;AAAA,MACT,uCAAuCzD,EAAM,GAAG,cAAcyD,EAAK,GAAG;AAAA,IACxE;AAEA,UAAMC,IAAc,KAAK,oBAAoB1D,EAAM,KAAKyD,EAAK,KAAK;AAAA,MAChE,UAAS,oBAAI,KAAK,GAAE,YAAY;AAAA,IAAA,CACjC;AACD,QAAI,CAACC,EAAa;AAElB,UAAMrB,IAAS;AAAA,MACb,GAAG,KAAK,+BAA+BrC,GAAO0D,CAAW;AAAA,MACzD,SAASA,EAAY;AAAA,MACrB,MAAM,KAAK,aAAa;AAAA,IAC1B;AAEA,gBAAK,MAAM,KAAK;AAAA,MACd;AAAA,MACArB;AAAA,IACF,GAEOqB;AAAA,EAAA;AAAA,EAGT,MAAM,iBACJ1D,GACAyD,GACAE,GACA;AACA,SAAK,MAAM;AAAA,MACT,6CAA6C3D,EAAM,GAAG,cAAcyD,EAAK,GAAG;AAAA,IAC9E;AAEA,UAAMG,KAAK,oBAAI,KAAK,GAAE,YAAY,GAC5BF,IAAc,KAAK,oBAAoB1D,EAAM,KAAKyD,EAAK,KAAK;AAAA,MAChE,SAASG;AAAA,MACT,eAAeA;AAAA,IAAA,CAChB;AACD,QAAI,CAACF,EAAa;AAElB,UAAMrB,IAAS;AAAA,MACb,GAAG,KAAK,+BAA+BrC,GAAO0D,CAAW;AAAA,MACzD,UAAAC;AAAA,IACF;AAEA,gBAAK,MAAM,KAAK,gBAGd,cAActB,CAAM,GAEfqB;AAAA,EAAA;AAAA,EAGT,MAAM,eAAe1D,GAAkByD,GAAqB;AACtD,QAAAA,EAAK,QAAQ,YAAa;AAE9B,SAAK,MAAM;AAAA,MACT,2CAA2CzD,EAAM,GAAG,cAAcyD,EAAK,GAAG;AAAA,IAC5E;AAEA,UAAMC,IAAc,KAAK,oBAAoB1D,EAAM,KAAKyD,EAAK,KAAK;AAAA,MAChE,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IAAA,CACrC;AACD,QAAI,CAACC,EAAa;AAElB,UAAMrB,IAAS,KAAK,+BAA+BrC,GAAO0D,CAAW;AAErE,gBAAK,MAAM,KAAK;AAAA,MACd;AAAA,MACA;AAAA,QACE,GAAGrB;AAAA,QACH,aAAarC,EAAM;AAAA,MAAA;AAAA,IAEvB,GAEO0D;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAOD,UAAUG,GAAwB;AAExC,UAAMC,IAAO,MAGPC,IAAa;AAAA,MACjB,GAAGF;AAAA;AAAA,MAEH,UAAU;AAER,eAAIC,EAAK,MAAM,MAAM,MAAM,mBAAmB,KAAK,MAC1C,KAAK,MAAM,CAAC,IAGd,KAAK,MAAM,KAAK,CAAC3D,MAAM,CAACA,EAAE,QAAQ,WAAW;AAAA,MAAA;AAAA,IAExD;AAEA,WAAA4D,EAAW,UAAUA,EAAW,QAAQ,KAAKA,CAAU,GAE5CA,EAAA,QAAQF,EAAY,MAAM,IAAI,CAAC,EAAE,SAAAG,GAAS,GAAGC,QAAW;AACjE,YAAMC,IAAY;AAAA,QAChB,GAAGD;AAAA,QACH,SAAS,EAAE,GAAGD,EAAQ;AAAA,QACtB,aAAa;AAEP,cAAA,MAAK,QAAQ;AACV,mBAAAF,EAAK,WAAWC,GAAY,IAAI;AAAA,QACzC;AAAA,QACA,iBAAiB,EAAE,UAAAJ,EAAS,IAAgC,IAAI;AAE9D,iBAAOG,EAAK,iBAAiBC,GAAY,MAAMJ,CAAQ;AAAA,QACzD;AAAA,QACA,iBAAiB;AAEX,cAAA,MAAK,QAAQ;AACV,mBAAAG,EAAK,eAAeC,GAAY,IAAI;AAAA,QAAA;AAAA,MAE/C;AAIA,aAAAG,EAAU,aAAaA,EAAU,WAAW,KAAKA,CAAS,GAC1DA,EAAU,mBAAmBA,EAAU,iBAAiB,KAAKA,CAAS,GACtEA,EAAU,iBAAiBA,EAAU,eAAe,KAAKA,CAAS,GAE3DA;AAAA,IAAA,CACR,GAEDH,EAAW,0BACTF,EAAY,wBAAwB,IAAI,CAACM,OAChC;AAAA,MACL,GAAGA;AAAA,MACH,SAAS,IAAIC,EAAW,EAAE,UAAUD,EAAK,SAAU,CAAA;AAAA,IACrD,EACD,GAEIJ;AAAA,EAAA;AAAA,EAGD,iBAAiBM,IAAkC,IAAI;AAE7D,UAAMC,IAA8B;AAAA,MAClC,GAAG,KAAK;AAAA,MACR,GAAGD;AAAA,IACL;AAIA,IADmB,KAAK,MAAM,MAAM,MACrB,mBACbC,EAAe,mBAAmB;AAIpC,QAAIjC,IAAS,OAAO;AAAA,MAClB,OAAO,QAAQiC,CAAc,EAAE;AAAA,QAC7B,CAAC,CAACC,GAAIC,CAAC,MAAyBA,KAAM;AAAA,MAAA;AAAA,IAE1C;AAGS,WAAAnC,IAAAA,EAAO,OACZ,EAAE,GAAGA,GAAQ,MAAM,KAAK,UAAUA,EAAO,IAAI,EAC7C,IAAAA,GAEGA;AAAA,EAAA;AAAA,EAGD,eAAeZ,GAA0B;AAG/C,UAAMgD,IAFa,OAAO,KAAKhD,CAAW,EAAE,KAAK,EAG9C;AAAA,MACC,CAACiD,MACC,GAAG,mBAAmBA,CAAG,CAAC,IAAI,mBAAmBjD,EAAYiD,CAAG,CAAC,CAAC;AAAA,IAAA,EAErE,KAAK,GAAG,GAELC,IAAWtG,EAAkB,KAAK,MAAM,MAAM;AACpD,WAAOoG,IAAW,GAAGE,CAAQ,IAAIF,CAAQ,KAAKE;AAAA,EAAA;AAAA,EAGxC,oBACN5E,GACA6E,GACAC,GACA;AACI,QAAAnB;AAIJ,WAAImB,EAAM,eACR,KAAK,gBAAgB,GAGlB,KAAA,MAAM,SAAS,CAACxF,MAAU;AACzB,UAAAW,IAAQX,EAAM,OAAOU,CAAQ;AAC7B,UAAA,CAACC,EAAc,QAAAX;AAEnB,YAAMyF,IAAQ9E,EAAM,MAAM,IAAI,CAACyD,OACzBA,EAAK,QAAQmB,MAIjBnB,EAAK,UAAU,EAAE,GAAGA,EAAK,SAAS,GAAGoB,EAAM,GAC7BnB,IAAAD,IAEPA,EACR;AAED,MAAAzD,IAAQ0D,IAAc,EAAE,GAAG1D,GAAO,OAAA8E,EAAU,IAAA9E;AAEtC,YAAAgD,IAAS,EAAE,GAAG3D,EAAM,QAAQ,CAACW,EAAM,GAAG,GAAGA,EAAM,GAI/C+E,IACJF,EAAM,eAAe,CAAC7E,EAAM,4BACxB;AAAA,QACE,GAAGX,EAAM;AAAA,QACT,CAAC2F,CAAiB,GAAGH,EAAM;AAAA,UAE7BxF,EAAM;AAEZ,aAAO,EAAE,GAAGA,GAAO,QAAA2D,GAAQ,uBAAA+B,EAAsB;AAAA,IAAA,CAClD,GAEMrB;AAAA,EAAA;AAAA,EAGD,+BACN1D,GACAyD,GACA;AACO,WAAA;AAAA,MACL,YAAYzD,EAAM;AAAA,MAClB,WAAWA,EAAM;AAAA,MACjB,UAAUA,EAAM;AAAA,MAChB,gBAAgByD,EAAK;AAAA;AAAA,MAErB,QAAQ,KAAK,aAAa;AAAA,IAC5B;AAAA,EAAA;AAAA,EAGM,kBAAkB,EAAE,MAAA5B,KAA6C;AACvE,SAAK,sBAAsB;AAE3B,UAAM7B,IAAQ,KAAK,UAAU6B,EAAK,KAAK;AAElC,SAAA,MAAM,SAAS,CAACxC,MAAU;AACvB,YAAA2D,IAAS,EAAE,GAAG3D,EAAM,QAAQ,CAACW,EAAM,GAAG,GAAGA,EAAM;AAE9C,aAAA,EAAE,GAAGX,GAAO,QAAA2D,EAAO;AAAA,IAAA,CAC3B;AAAA,EAAA;AAAA,EAGK,YAAY,EAAE,MAAAnB,KAA+C;AACnE,SAAK,sBAAsB,GAEtB,KAAA,MAAM,SAAS,CAACxC,MAAU;AACvB,YAAA,EAAE,CAACwC,EAAK,MAAM,GAAG,GAAGoD,GAAG,GAAGhB,MAAS5E,EAAM;AAC/C,aAAO,EAAE,GAAGA,GAAO,QAAQ4E,EAAK;AAAA,IAAA,CACjC;AAAA,EAAA;AAAA,EAGK,uBAAuB;AAAA,IAC7B,MAAApC;AAAA,EAAA,GACgD;AAChD,SAAK,sBAAsB,GAEtB,KAAA,MAAM,SAAS,CAACxC,MAAU;AAGvB,YAAA6F,IAAc,CAACrD,EAAK,WAAW,GAI/BsD,IAActD,EAAK,YAAY,gCAAgC,CAAC,GAChEuD,IAAYvD,EAAK,YAAY,8BAA8B,CAAC;AAElE,UAAImB,IAAS3D,EAAM;AAEnB,aAAA2D,IAASmC,EAAY,OAAO,CAACE,GAAKX,MAAQ;AACxC,YAAI,CAACW,EAAIX,CAAG,EAAU,QAAAW;AACtB,cAAMrF,IAAQ,EAAE,GAAGqF,EAAIX,CAAG,GAAG,2BAA2B,GAAK;AAC7D,eAAO,EAAE,GAAGW,GAAK,CAACX,CAAG,GAAG1E,EAAM;AAAA,SAC7BgD,CAAM,GAETA,IAASoC,EAAU,OAAO,CAACC,GAAKX,MAAQ;AACtC,YAAI,CAACW,EAAIX,CAAG,EAAU,QAAAW;AACtB,cAAMrF,IAAQ,EAAE,GAAGqF,EAAIX,CAAG,GAAG,2BAA2B,GAAM;AAC9D,eAAO,EAAE,GAAGW,GAAK,CAACX,CAAG,GAAG1E,EAAM;AAAA,SAC7BgD,CAAM,GAEF,EAAE,GAAG3D,GAAO,QAAA2D,GAAQ,aAAAkC,EAAY;AAAA,IAAA,CACxC;AAAA,EAAA;AAAA,EAGK,mBAAmB,EAAE,MAAArD,KAAsC;AACjE,UAAM7B,IAAQ,KAAK,UAAU6B,EAAK,KAAK;AAElC,SAAA,MAAM,SAAS,CAACxC,MAAU;AACvB,YAAAuD,IAAgB,EAAE,GAAGvD,EAAM,eAAe,CAACW,EAAM,GAAG,GAAGA,EAAM;AAC5D,aAAA,EAAE,GAAGX,GAAO,eAAAuD,EAAc;AAAA,IAAA,CAClC;AAAA,EAAA;AAAA;AAAA;AAAA,EAqCK,uBAAuB0C,GAAeC,GAAwB;AAElE,WAAA,EAAQD,EAAE,kBAAoB,EAAQC,EAAE,kBACxCD,EAAE,qBAAqBC,EAAE;AAAA,EAAA;AAAA,EAIrB,qCAAqC;AAC3C,UAAM/G,IAAMJ,EAAe;AAC3B,QAAII,KAAA,QAAAA,EAAK,SAAS;AAEZ,MAAAA,EAAA,iBAAiB,YAAY,KAAK,oBAAoB,GAGtDA,EAAA,iBAAiB,cAAc,KAAK,oBAAoB;AAGtD,YAAAgH,IAAchH,EAAI,QAAQ,WAC1BiH,IAAiBjH,EAAI,QAAQ;AAGnC,MAAAA,EAAI,QAAQ,YAAY,IAAI,MAAMgH,GAAa;AAAA,QAC7C,OAAO,CAACE,GAAQC,GAASC,MAAS;AACxB,kBAAA,MAAMF,GAAQC,GAASC,CAAI,GACnC,WAAW,MAAM;AACf,iBAAK,qBAAqB;AAAA,aACzB,CAAC;AAAA,QAAA;AAAA,MACN,CACD,GACDpH,EAAI,QAAQ,eAAe,IAAI,MAAMiH,GAAgB;AAAA,QACnD,OAAO,CAACC,GAAQC,GAASC,MAAS;AACxB,kBAAA,MAAMF,GAAQC,GAASC,CAAI,GACnC,WAAW,MAAM;AACf,iBAAK,qBAAqB;AAAA,aACzB,CAAC;AAAA,QAAA;AAAA,MACN,CACD,GAGD,KAAK,cAAcJ,GACnB,KAAK,iBAAiBC;AAAA,IAAA;AAEtB,WAAK,MAAM;AAAA,QACT;AAAA,MACF;AAAA,EACF;AAAA,EAGF,qCAAqC;AACnC,UAAMjH,IAAMJ,EAAe;AACvB,IAACI,KAAA,QAAAA,EAAK,YAENA,EAAA,oBAAoB,YAAY,KAAK,oBAAoB,GACzDA,EAAA,oBAAoB,cAAc,KAAK,oBAAoB,GAE3D,KAAK,gBACHA,EAAA,QAAQ,YAAY,KAAK,aAC7B,KAAK,cAAc,SAEjB,KAAK,mBACHA,EAAA,QAAQ,eAAe,KAAK,gBAChC,KAAK,iBAAiB;AAAA,EACxB;AAEJ;"}
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 checkStateIfThrottled,\n findDefaultGroup,\n formatFilters,\n formatGroupStage,\n formatState,\n mockDefaultGroup,\n newUrl,\n predicateUrlPatterns,\n predicateUrlRules,\n} from \"./helpers\";\nimport {\n Any,\n ConstructorOpts,\n DebugState,\n GetGuidesQueryParams,\n GetGuidesResponse,\n GroupStage,\n GuideAddedEvent,\n GuideData,\n GuideGroupAddedEvent,\n GuideGroupUpdatedEvent,\n GuideLivePreviewUpdatedEvent,\n GuideRemovedEvent,\n GuideSocketEvent,\n GuideStepData,\n GuideUpdatedEvent,\n KnockGuide,\n KnockGuideStep,\n MarkAsArchivedParams,\n MarkAsInteractedParams,\n MarkAsSeenParams,\n MarkGuideAsResponse,\n QueryFilterParams,\n QueryStatus,\n SelectFilterParams,\n SelectGuideOpts,\n SelectGuidesOpts,\n StepMessageState,\n StoreState,\n TargetParams,\n} from \"./types\";\n\n// How long to wait until we resolve the guides order and determine the\n// prevailing guide.\nconst DEFAULT_ORDER_RESOLUTION_DURATION = 50; // in milliseconds\n\n// How often we should increment the counter to refresh the store state and\n// trigger subscribed callbacks.\nconst DEFAULT_COUNTER_INCREMENT_INTERVAL = 30 * 1000; // in milliseconds\n\n// Maximum number of retry attempts for channel subscription\nconst SUBSCRIBE_RETRY_LIMIT = 3;\n\n// Debug query param keys\nexport const DEBUG_QUERY_PARAMS = {\n GUIDE_KEY: \"knock_guide_key\",\n PREVIEW_SESSION_ID: \"knock_preview_session_id\",\n};\n\nconst DEBUG_STORAGE_KEY = \"knock_guide_debug\";\n\n// Return the global window object if defined, so to safely guard against SSR.\nconst checkForWindow = () => {\n if (typeof window !== \"undefined\") {\n return window;\n }\n};\n\nexport const guidesApiRootPath = (userId: string | undefined | null) =>\n `/v1/users/${userId}/guides`;\n\n// Detect debug params from URL or local storage\nconst detectDebugParams = (): DebugState => {\n const win = checkForWindow();\n if (!win || !win.location) {\n return { forcedGuideKey: null, previewSessionId: null };\n }\n\n const urlParams = new URLSearchParams(win.location.search);\n const urlGuideKey = urlParams.get(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n const urlPreviewSessionId = urlParams.get(\n DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID,\n );\n\n // If URL params exist, persist them to localStorage and return them\n if (urlGuideKey || urlPreviewSessionId) {\n if (win.localStorage) {\n try {\n const debugState = {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n win.localStorage.setItem(DEBUG_STORAGE_KEY, JSON.stringify(debugState));\n } catch {\n // Silently fail in privacy mode\n }\n }\n return {\n forcedGuideKey: urlGuideKey,\n previewSessionId: urlPreviewSessionId,\n };\n }\n\n // Check local storage if no URL params\n let storedGuideKey = null;\n let storedPreviewSessionId = null;\n\n if (win.localStorage) {\n try {\n const storedDebugState = win.localStorage.getItem(DEBUG_STORAGE_KEY);\n if (storedDebugState) {\n const parsedDebugState = safeJsonParseDebugParams(storedDebugState);\n storedGuideKey = parsedDebugState.forcedGuideKey;\n storedPreviewSessionId = parsedDebugState.previewSessionId;\n }\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n return {\n forcedGuideKey: storedGuideKey,\n previewSessionId: storedPreviewSessionId,\n };\n};\n\nconst safeJsonParseDebugParams = (value: string): DebugState => {\n try {\n const parsed = JSON.parse(value);\n return {\n forcedGuideKey: parsed?.forcedGuideKey ?? null,\n previewSessionId: parsed?.previewSessionId ?? null,\n };\n } catch {\n return {\n forcedGuideKey: null,\n previewSessionId: null,\n };\n }\n};\n\nconst select = (state: StoreState, filters: SelectFilterParams = {}) => {\n // A map of selected guides as values, with its order index as keys.\n const result = new SelectionResult();\n\n const defaultGroup = findDefaultGroup(state.guideGroups);\n if (!defaultGroup) return result;\n\n const displaySequence = [...defaultGroup.display_sequence];\n const location = state.location;\n\n // If in debug mode, put the forced guide at the beginning of the display sequence.\n if (state.debug.forcedGuideKey) {\n const forcedKeyIndex = displaySequence.indexOf(state.debug.forcedGuideKey);\n if (forcedKeyIndex > -1) {\n displaySequence.splice(forcedKeyIndex, 1);\n }\n displaySequence.unshift(state.debug.forcedGuideKey);\n }\n\n for (const [index, guideKey] of displaySequence.entries()) {\n let guide = state.guides[guideKey];\n\n // Use preview guide if it exists and matches the forced guide key\n if (\n state.debug.forcedGuideKey === guideKey &&\n state.previewGuides[guideKey]\n ) {\n guide = state.previewGuides[guideKey];\n }\n\n if (!guide) continue;\n\n const affirmed = predicate(guide, {\n location,\n filters,\n debug: state.debug,\n });\n\n if (!affirmed) continue;\n\n result.set(index, guide);\n }\n\n result.metadata = { guideGroup: defaultGroup };\n return result;\n};\n\ntype PredicateOpts = {\n location?: string | undefined;\n filters?: SelectFilterParams | undefined;\n debug: DebugState;\n};\n\nconst predicate = (\n guide: KnockGuide,\n { location, filters = {}, debug = {} }: PredicateOpts,\n) => {\n if (filters.type && filters.type !== guide.type) {\n return false;\n }\n\n if (filters.key && filters.key !== guide.key) {\n return false;\n }\n\n // Bypass filtering if the debugged guide matches the given filters.\n // This should always run AFTER checking the filters but BEFORE\n // checking archived status and location rules.\n if (debug.forcedGuideKey === guide.key) {\n return true;\n }\n\n if (!guide.active) {\n return false;\n }\n\n if (guide.steps.every((s) => !!s.message.archived_at)) {\n return false;\n }\n\n const url = location ? newUrl(location) : undefined;\n\n const urlRules = guide.activation_url_rules || [];\n const urlPatterns = guide.activation_url_patterns || [];\n\n // A guide can have either activation url rules XOR url patterns, but not both.\n if (url && urlRules.length > 0) {\n const allowed = predicateUrlRules(url, urlRules);\n if (!allowed) return false;\n } else if (url && urlPatterns.length > 0) {\n const allowed = predicateUrlPatterns(url, urlPatterns);\n if (!allowed) return false;\n }\n\n return true;\n};\n\nexport class KnockGuideClient {\n public store: Store<StoreState, (state: StoreState) => StoreState>;\n\n // Phoenix channels for real time guide updates over websocket\n private socket: Socket | undefined;\n private socketChannel: Channel | undefined;\n private socketChannelTopic: string;\n private socketEventTypes = [\n \"guide.added\",\n \"guide.updated\",\n \"guide.removed\",\n \"guide_group.added\",\n \"guide_group.updated\",\n \"guide.live_preview_updated\",\n ];\n private subscribeRetryCount = 0;\n\n // Original history methods to monkey patch, or restore in cleanups.\n private pushStateFn: History[\"pushState\"] | undefined;\n private replaceStateFn: History[\"replaceState\"] | undefined;\n\n // Guides that are competing to render are \"staged\" first without rendering\n // and ranked based on its relative order in the group over a duration of time\n // to resolve and render the prevailing one.\n private stage: GroupStage | undefined;\n\n private counterIntervalId: ReturnType<typeof setInterval> | undefined;\n\n constructor(\n readonly knock: Knock,\n readonly channelId: string,\n readonly targetParams: TargetParams = {},\n readonly options: ConstructorOpts = {},\n ) {\n const {\n trackLocationFromWindow = true,\n throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n } = options;\n const win = checkForWindow();\n\n const location = trackLocationFromWindow ? win?.location?.href : undefined;\n\n const debug = detectDebugParams();\n\n this.store = new Store<StoreState>({\n guideGroups: [],\n guideGroupDisplayLogs: {},\n guides: {},\n previewGuides: {},\n queries: {},\n location,\n // Increment to update the state store and trigger re-selection.\n counter: 0,\n debug,\n });\n\n // In server environments we might not have a socket connection.\n const { socket: maybeSocket } = this.knock.client();\n this.socket = maybeSocket;\n this.socketChannelTopic = `guides:${channelId}`;\n\n if (trackLocationFromWindow) {\n this.listenForLocationChangesFromWindow();\n }\n\n if (throttleCheckInterval) {\n // Start the counter loop to increment at an interval.\n this.startCounterInterval(throttleCheckInterval);\n }\n\n this.knock.log(\"[Guide] Initialized a guide client\");\n }\n\n private incrementCounter() {\n this.knock.log(\"[Guide] Incrementing the counter\");\n this.store.setState((state) => ({ ...state, counter: state.counter + 1 }));\n }\n\n private startCounterInterval(delay: number) {\n this.counterIntervalId = setInterval(() => {\n this.knock.log(\"[Guide] Counter interval tick\");\n if (this.stage && this.stage.status !== \"closed\") return;\n\n this.incrementCounter();\n }, delay);\n }\n\n private clearCounterInterval() {\n if (this.counterIntervalId) {\n clearInterval(this.counterIntervalId);\n this.counterIntervalId = undefined;\n }\n }\n\n cleanup() {\n this.unsubscribe();\n this.removeLocationChangeEventListeners();\n this.clearGroupStage();\n this.clearCounterInterval();\n }\n\n async fetch(opts?: { filters?: QueryFilterParams }) {\n this.knock.log(\"[Guide] .fetch\");\n this.knock.failIfNotAuthenticated();\n\n const queryParams = this.buildQueryParams(opts?.filters);\n const queryKey = this.formatQueryKey(queryParams);\n\n // If already fetched before, then noop.\n const maybeQueryStatus = this.store.state.queries[queryKey];\n if (maybeQueryStatus) {\n return maybeQueryStatus;\n }\n\n // Mark this query status as loading.\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: { status: \"loading\" } },\n }));\n\n let queryStatus: QueryStatus;\n try {\n this.knock.log(\"[Guide] Fetching all eligible guides\");\n const data = await this.knock.user.getGuides<\n GetGuidesQueryParams,\n GetGuidesResponse\n >(this.channelId, queryParams);\n queryStatus = { status: \"ok\" };\n\n const { entries, guide_groups: groups, guide_group_display_logs } = data;\n\n this.knock.log(\"[Guide] Loading fetched guides\");\n this.store.setState((state) => ({\n ...state,\n guideGroups: groups?.length > 0 ? groups : [mockDefaultGroup(entries)],\n guideGroupDisplayLogs: guide_group_display_logs || {},\n guides: byKey(entries.map((g) => this.localCopy(g))),\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n } catch (e) {\n queryStatus = { status: \"error\", error: e as Error };\n\n this.store.setState((state) => ({\n ...state,\n queries: { ...state.queries, [queryKey]: queryStatus },\n }));\n }\n\n return queryStatus;\n }\n\n subscribe() {\n if (!this.socket) return;\n this.knock.failIfNotAuthenticated();\n this.knock.log(\"[Guide] Subscribing to real time updates\");\n\n // Ensure a live socket connection if not yet connected.\n if (!this.socket.isConnected()) {\n this.socket.connect();\n }\n\n // If there's an existing connected channel, then disconnect.\n if (this.socketChannel) {\n this.unsubscribe();\n }\n\n // Join the channel topic and subscribe to supported events.\n const debugState = this.store.state.debug;\n const params = {\n ...this.targetParams,\n user_id: this.knock.userId,\n force_all_guides: debugState.forcedGuideKey ? true : undefined,\n preview_session_id: debugState.previewSessionId || undefined,\n };\n\n const newChannel = this.socket.channel(this.socketChannelTopic, params);\n\n for (const eventType of this.socketEventTypes) {\n newChannel.on(eventType, (payload) => this.handleSocketEvent(payload));\n }\n\n if ([\"closed\", \"errored\"].includes(newChannel.state)) {\n // Reset retry count for new subscription attempt\n this.subscribeRetryCount = 0;\n\n newChannel\n .join()\n .receive(\"ok\", () => {\n this.knock.log(\"[Guide] Successfully joined channel\");\n })\n .receive(\"error\", (resp) => {\n this.knock.log(\n `[Guide] Failed to join channel: ${JSON.stringify(resp)}`,\n );\n this.handleChannelJoinError();\n })\n .receive(\"timeout\", () => {\n this.knock.log(\"[Guide] Channel join timed out\");\n this.handleChannelJoinError();\n });\n }\n\n // Track the joined channel.\n this.socketChannel = newChannel;\n }\n\n private handleChannelJoinError() {\n // Prevent phx channel from retrying forever in case of either network or\n // other errors (e.g. auth error, invalid channel etc)\n if (this.subscribeRetryCount >= SUBSCRIBE_RETRY_LIMIT) {\n this.knock.log(\n `[Guide] Channel join max retry limit reached: ${this.subscribeRetryCount}`,\n );\n this.unsubscribe();\n return;\n }\n\n this.subscribeRetryCount++;\n }\n\n unsubscribe() {\n if (!this.socketChannel) return;\n this.knock.log(\"[Guide] Unsubscribing from real time updates\");\n\n // Unsubscribe from the socket events and leave the channel.\n for (const eventType of this.socketEventTypes) {\n this.socketChannel.off(eventType);\n }\n this.socketChannel.leave();\n\n // Unset the channel.\n this.socketChannel = undefined;\n }\n\n private handleSocketEvent(payload: GuideSocketEvent) {\n const { event, data } = payload;\n\n switch (event) {\n case \"guide.added\":\n return this.addOrReplaceGuide(payload);\n\n case \"guide.updated\":\n return data.eligible\n ? this.addOrReplaceGuide(payload)\n : this.removeGuide(payload);\n\n case \"guide.removed\":\n return this.removeGuide(payload);\n\n case \"guide_group.added\":\n case \"guide_group.updated\":\n return this.addOrReplaceGuideGroup(payload);\n\n case \"guide.live_preview_updated\":\n return this.updatePreviewGuide(payload);\n\n default:\n return;\n }\n }\n\n setLocation(href: string, additionalParams: Partial<StoreState> = {}) {\n this.knock.log(`[Guide] .setLocation (loc=${href})`);\n\n // Make sure to clear out the stage.\n this.clearGroupStage();\n\n this.knock.log(\"[Guide] Updating the tracked location\");\n this.store.setState((state) => {\n // Clear preview guides if no longer in preview mode\n const previewGuides = additionalParams?.debug?.previewSessionId\n ? state.previewGuides\n : {};\n\n return {\n ...state,\n ...additionalParams,\n previewGuides,\n location: href,\n };\n });\n }\n\n exitDebugMode() {\n this.knock.log(\"[Guide] Exiting debug mode\");\n\n // Clear localStorage debug params\n const win = checkForWindow();\n if (win?.localStorage) {\n try {\n win.localStorage.removeItem(DEBUG_STORAGE_KEY);\n } catch {\n // Silently fail in privacy mode\n }\n }\n\n // Clear debug state from store\n this.store.setState((state) => ({\n ...state,\n debug: { forcedGuideKey: null, previewSessionId: null },\n previewGuides: {}, // Clear preview guides when exiting debug mode\n }));\n\n // Remove URL query params if present\n // Only update the URL if params need to be cleared to avoid unnecessary navigations\n if (win?.location) {\n const url = new URL(win.location.href);\n if (\n url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||\n url.searchParams.has(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID)\n ) {\n url.searchParams.delete(DEBUG_QUERY_PARAMS.GUIDE_KEY);\n url.searchParams.delete(DEBUG_QUERY_PARAMS.PREVIEW_SESSION_ID);\n win.location.href = url.toString();\n }\n }\n }\n\n //\n // Store selector\n //\n\n selectGuides<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ): KnockGuide<C>[] {\n this.knock.log(\n `[Guide] .selectGuides (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n\n const selectedGuide = this.selectGuide(state, filters, opts);\n if (!selectedGuide) {\n return [];\n }\n\n // There should be at least one guide to return here now.\n const guides = [...select(state, filters).values()];\n\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n const unthrottledGuides = guides.filter(\n (g) => g.bypass_global_group_limit,\n );\n const throttledCount = guides.length - unthrottledGuides.length;\n this.knock.log(\n `[Guide] Throttling ${throttledCount} guides from selection, and returning ${unthrottledGuides.length} guides`,\n );\n\n return unthrottledGuides;\n }\n\n this.knock.log(`[Guide] Returning ${guides.length} guides from selection`);\n return guides;\n }\n\n selectGuide<C = Any>(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ): KnockGuide<C> | undefined {\n this.knock.log(\n `[Guide] .selectGuide (filters: ${formatFilters(filters)}; state: ${formatState(state)})`,\n );\n if (\n Object.keys(state.guides).length === 0 &&\n Object.keys(state.previewGuides).length === 0\n ) {\n this.knock.log(\"[Guide] Exiting selection (no guides)\");\n return undefined;\n }\n\n const result = select(state, filters);\n\n if (result.size === 0) {\n this.knock.log(\"[Guide] Selection found zero result\");\n return undefined;\n }\n\n const [index, guide] = [...result][0]!;\n this.knock.log(\n `[Guide] Selection found: \\`${guide.key}\\` (total: ${result.size})`,\n );\n\n // If a guide ignores the group limit, then return immediately to render\n // always.\n if (guide.bypass_global_group_limit) {\n this.knock.log(`[Guide] Returning the unthrottled guide: ${guide.key}`);\n return guide;\n }\n\n // Check if inside the throttle window (i.e. throttled) and if so stop and\n // return undefined unless explicitly given the option to include throttled.\n if (!opts.includeThrottled && checkStateIfThrottled(state)) {\n this.knock.log(`[Guide] Throttling the selected guide: ${guide.key}`);\n 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] Adding to the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n return undefined;\n }\n\n case \"patch\": {\n this.knock.log(`[Guide] Patching the group stage: ${guide.key}`);\n this.stage.ordered[index] = guide.key;\n\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n\n case \"closed\": {\n const ret = this.stage.resolved === guide.key ? guide : undefined;\n this.knock.log(\n `[Guide] Returning \\`${ret?.key}\\` (stage: ${formatGroupStage(this.stage)})`,\n );\n return ret;\n }\n }\n }\n\n private openGroupStage() {\n this.knock.log(\"[Guide] Opening a new group stage\");\n\n const {\n orderResolutionDuration: delay = DEFAULT_ORDER_RESOLUTION_DURATION,\n } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n this.stage = {\n status: \"open\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n // Close the current non-closed stage to resolve the prevailing guide up next\n // for display amongst the ones that have been staged.\n private closePendingGroupStage() {\n this.knock.log(\"[Guide] .closePendingGroupStage\");\n if (!this.stage || this.stage.status === \"closed\") return;\n\n // Should have been cleared already since this method should be called as a\n // callback to a setTimeout, but just to be safe.\n this.ensureClearTimeout();\n\n // If in debug mode, try to resolve the forced guide, otherwise return the first non-undefined guide.\n let resolved = undefined;\n if (this.store.state.debug.forcedGuideKey) {\n resolved = this.stage.ordered.find(\n (x) => x === this.store.state.debug.forcedGuideKey,\n );\n }\n\n if (!resolved) {\n resolved = this.stage.ordered.find((x) => x !== undefined);\n }\n\n this.knock.log(\n `[Guide] Closing the current group stage: resolved=${resolved}`,\n );\n\n this.stage = {\n ...this.stage,\n status: \"closed\",\n resolved,\n timeoutId: null,\n };\n\n return this.stage;\n }\n\n // Set the current closed stage status to \"patch\" to allow re-running\n // selections and re-building a group stage with the latest/updated state,\n // while keeping the currently resolved guide in place so that it stays\n // rendered until we are ready to resolve the updated stage and re-render.\n // Note, must be called ahead of updating the state store.\n private patchClosedGroupStage() {\n this.knock.log(\"[Guide] .patchClosedGroupStage\");\n if (this.stage?.status !== \"closed\") return;\n\n const { orderResolutionDuration: delay = 0 } = this.options;\n\n const timeoutId = setTimeout(() => {\n this.closePendingGroupStage();\n this.incrementCounter();\n }, delay);\n\n // Just to be safe.\n this.ensureClearTimeout();\n\n this.knock.log(\"[Guide] Patching the current group stage\");\n\n this.stage = {\n ...this.stage,\n status: \"patch\",\n ordered: [],\n timeoutId,\n };\n\n return this.stage;\n }\n\n private clearGroupStage() {\n this.knock.log(\"[Guide] .clearGroupStage\");\n if (!this.stage) return;\n\n this.knock.log(\"[Guide] Clearing the current group stage\");\n this.ensureClearTimeout();\n this.stage = undefined;\n }\n\n private ensureClearTimeout() {\n if (this.stage?.timeoutId) {\n clearTimeout(this.stage.timeoutId);\n }\n }\n\n // Test helpers to open and close the group stage to return the select result\n // immediately.\n private _selectGuide(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuideOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuide(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuide(state, filters, opts);\n }\n\n private _selectGuides(\n state: StoreState,\n filters: SelectFilterParams = {},\n opts: SelectGuidesOpts = {},\n ) {\n this.openGroupStage();\n\n this.selectGuides(state, filters, opts);\n this.closePendingGroupStage();\n\n return this.selectGuides(state, filters, opts);\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 };\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 return self.markAsSeen(localGuide, this);\n },\n markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {\n return self.markAsInteracted(localGuide, this, metadata);\n },\n markAsArchived() {\n return self.markAsArchived(localGuide, this);\n },\n };\n\n // Bind all engagement action handler methods to the local step object so\n // they can operate on itself.\n localStep.markAsSeen = localStep.markAsSeen.bind(localStep);\n localStep.markAsInteracted = localStep.markAsInteracted.bind(localStep);\n localStep.markAsArchived = localStep.markAsArchived.bind(localStep);\n\n return localStep;\n });\n\n localGuide.activation_url_patterns =\n remoteGuide.activation_url_patterns.map((rule) => {\n return {\n ...rule,\n pattern: new URLPattern({ pathname: rule.pathname }),\n };\n });\n\n return localGuide;\n }\n\n private buildQueryParams(filterParams: QueryFilterParams = {}) {\n // Combine the target params with the given filter params.\n const combinedParams: GenericData = {\n ...this.targetParams,\n ...filterParams,\n };\n\n // Append debug params\n const debugState = this.store.state.debug;\n if (debugState.forcedGuideKey) {\n combinedParams.force_all_guides = true;\n }\n\n // Prune out any keys that have an undefined or null value.\n let params = Object.fromEntries(\n Object.entries(combinedParams).filter(\n ([_k, v]) => v !== undefined && v !== null,\n ),\n );\n\n // Encode target data as a JSON string, if provided.\n params = params.data\n ? { ...params, data: JSON.stringify(params.data) }\n : params;\n\n return params as GetGuidesQueryParams;\n }\n\n private formatQueryKey(queryParams: GenericData) {\n const sortedKeys = Object.keys(queryParams).sort();\n\n const queryStr = sortedKeys\n .map(\n (key) =>\n `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`,\n )\n .join(\"&\");\n\n const basePath = guidesApiRootPath(this.knock.userId);\n return queryStr ? `${basePath}?${queryStr}` : basePath;\n }\n\n private setStepMessageAttrs(\n guideKey: string,\n stepRef: string,\n attrs: Partial<StepMessageState>,\n ) {\n let updatedStep: KnockGuideStep | undefined;\n\n // If we are marking as archived, clear the group stage so we can render\n // the next guide in the group.\n if (attrs.archived_at) {\n this.clearGroupStage();\n }\n\n this.store.setState((state) => {\n let guide = state.guides[guideKey];\n if (!guide) return state;\n\n const steps = guide.steps.map((step) => {\n if (step.ref !== stepRef) return step;\n\n // Mutate in place and maintain the same obj ref so to make it easier\n // to use in hook deps.\n step.message = { ...step.message, ...attrs };\n updatedStep = step;\n\n return step;\n });\n // If updated, return the guide as a new object so useStore can trigger.\n guide = updatedStep ? { ...guide, steps } : guide;\n\n const guides = { ...state.guides, [guide.key]: guide };\n\n // If the guide is subject to throttled settings and we are marking as\n // archived, then update the display logs to start a new throttle window.\n const guideGroupDisplayLogs =\n attrs.archived_at && !guide.bypass_global_group_limit\n ? {\n ...state.guideGroupDisplayLogs,\n [DEFAULT_GROUP_KEY]: attrs.archived_at,\n }\n : state.guideGroupDisplayLogs;\n\n return { ...state, guides, guideGroupDisplayLogs };\n });\n\n return updatedStep;\n }\n\n private buildEngagementEventBaseParams(\n guide: GuideData,\n step: GuideStepData,\n ) {\n return {\n channel_id: guide.channel_id,\n guide_key: guide.key,\n guide_id: guide.id,\n guide_step_ref: step.ref,\n // Can be used for scoping guide messages.\n tenant: this.targetParams.tenant,\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 this.knock.log(`[Guide] .handleLocationChange`);\n const win = checkForWindow();\n if (!win?.location) return;\n\n const href = win.location.href;\n if (this.store.state.location === href) return;\n\n this.knock.log(`[Guide] Detected a location change: ${href}`);\n\n // If entering debug mode, fetch all guides.\n const currentDebugParams = this.store.state.debug;\n const newDebugParams = detectDebugParams();\n\n this.setLocation(href, { debug: newDebugParams });\n\n // If debug state has changed, refetch guides and resubscribe to the websocket channel\n const debugStateChanged = this.checkDebugStateChanged(\n currentDebugParams,\n newDebugParams,\n );\n\n if (debugStateChanged) {\n this.knock.log(\n `[Guide] Debug state changed, refetching guides and resubscribing to the websocket channel`,\n );\n this.fetch();\n this.subscribe();\n }\n };\n\n // Returns whether debug params have changed. For guide key, we only check\n // presence since the exact value has no impact on fetch/subscribe\n private checkDebugStateChanged(a: DebugState, b: DebugState): boolean {\n return (\n Boolean(a.forcedGuideKey) !== Boolean(b.forcedGuideKey) ||\n a.previewSessionId !== b.previewSessionId\n );\n }\n\n private listenForLocationChangesFromWindow() {\n const win = checkForWindow();\n if (win?.history && win?.addEventListener) {\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 removeLocationChangeEventListeners() {\n const win = checkForWindow();\n if (!win?.history || !win?.removeEventListener) return;\n\n win.removeEventListener(\"popstate\", this.handleLocationChange);\n win.removeEventListener(\"hashchange\", this.handleLocationChange);\n\n if (this.pushStateFn) {\n win.history.pushState = this.pushStateFn;\n this.pushStateFn = undefined;\n }\n if (this.replaceStateFn) {\n win.history.replaceState = this.replaceStateFn;\n this.replaceStateFn = undefined;\n }\n }\n}\n"],"names":["DEFAULT_ORDER_RESOLUTION_DURATION","DEFAULT_COUNTER_INCREMENT_INTERVAL","SUBSCRIBE_RETRY_LIMIT","DEBUG_QUERY_PARAMS","DEBUG_STORAGE_KEY","checkForWindow","guidesApiRootPath","userId","detectDebugParams","win","urlParams","urlGuideKey","urlPreviewSessionId","debugState","storedGuideKey","storedPreviewSessionId","storedDebugState","parsedDebugState","safeJsonParseDebugParams","value","parsed","select","state","filters","result","SelectionResult","defaultGroup","findDefaultGroup","displaySequence","location","forcedKeyIndex","index","guideKey","guide","predicate","debug","s","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","throttleCheckInterval","_a","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","formatFilters","formatState","guides","checkStateIfThrottled","unthrottledGuides","throttledCount","ret","formatGroupStage","timeoutId","resolved","x","step","updatedStep","metadata","ts","remoteGuide","self","localGuide","message","rest","localStep","rule","URLPattern","filterParams","combinedParams","_k","v","queryStr","key","basePath","stepRef","attrs","steps","guideGroupDisplayLogs","DEFAULT_GROUP_KEY","_","guideGroups","unthrottled","throttled","acc","a","b","pushStateFn","replaceStateFn","target","history","args"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,OAAO,KAAK,MAAM,aAAa,CAAC;AAgBhC,OAAO,EACL,GAAG,EACH,eAAe,EAMf,SAAS,EAMT,aAAa,EAEb,UAAU,EACV,cAAc,EAKd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAEhB,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAcjB,eAAO,MAAM,kBAAkB;;;CAG9B,CAAC;AAWF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI,WACrC,CAAC;AAyK/B,qBAAa,gBAAgB;IA6BzB,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe;IA/B5B,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC;IAGnE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAOtB;IACF,OAAO,CAAC,mBAAmB,CAAK;IAGhC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,cAAc,CAAsC;IAK5D,OAAO,CAAC,KAAK,CAAyB;IAEtC,OAAO,CAAC,iBAAiB,CAA6C;gBAG3D,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,YAAiB,EAC/B,OAAO,GAAE,eAAoB;IAyCxC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO;IAOD,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAkDlD,SAAS;IAuDT,OAAO,CAAC,sBAAsB;IAc9B,WAAW;IAcX,OAAO,CAAC,iBAAiB;IA2BzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,GAAE,OAAO,CAAC,UAAU,CAAM;IAsBpE,aAAa;IAuCb,YAAY,CAAC,CAAC,GAAG,GAAG,EAClB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,gBAAqB,GAC1B,UAAU,CAAC,CAAC,CAAC,EAAE;IA6BlB,WAAW,CAAC,CAAC,GAAG,GAAG,EACjB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,eAAoB,GACzB,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;IAmG5B,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,aAAa;IAoBf,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA0BhD,gBAAgB,CACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,WAAW;IA0BlB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa;IA6B1D,OAAO,CAAC,SAAS;IA4DjB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,mBAAmB;IAgD3B,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;IAiC9B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,oBAAoB,CA6B1B;IAIF,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,kCAAkC;IAyC1C,kCAAkC;CAgBnC"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"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"}
@@ -108,11 +108,11 @@ export type GuideLivePreviewUpdatedEvent = SocketEventPayload<"guide.live_previe
108
108
  }>;
109
109
  export type GuideSocketEvent = GuideAddedEvent | GuideUpdatedEvent | GuideRemovedEvent | GuideGroupAddedEvent | GuideGroupUpdatedEvent | GuideLivePreviewUpdatedEvent;
110
110
  export interface KnockGuideStep<TContent = Any> extends GuideStepData<TContent> {
111
- markAsSeen: () => void;
111
+ markAsSeen: () => Promise<KnockGuideStep<TContent> | undefined>;
112
112
  markAsInteracted: (params?: {
113
113
  metadata?: GenericData;
114
- }) => void;
115
- markAsArchived: () => void;
114
+ }) => Promise<KnockGuideStep<TContent> | undefined>;
115
+ markAsArchived: () => Promise<KnockGuideStep<TContent> | undefined>;
116
116
  }
117
117
  export interface KnockGuideActivationUrlPattern extends GuideActivationUrlPatternData {
118
118
  pattern: URLPattern;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knocklabs/client",
3
- "version": "0.20.1",
3
+ "version": "0.20.3",
4
4
  "description": "The clientside library for interacting with Knock",
5
5
  "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
6
6
  "author": "@knocklabs",
@@ -83,7 +83,7 @@ export const guidesApiRootPath = (userId: string | undefined | null) =>
83
83
  // Detect debug params from URL or local storage
84
84
  const detectDebugParams = (): DebugState => {
85
85
  const win = checkForWindow();
86
- if (!win) {
86
+ if (!win || !win.location) {
87
87
  return { forcedGuideKey: null, previewSessionId: null };
88
88
  }
89
89
 
@@ -287,7 +287,7 @@ export class KnockGuideClient {
287
287
  } = options;
288
288
  const win = checkForWindow();
289
289
 
290
- const location = trackLocationFromWindow ? win?.location.href : undefined;
290
+ const location = trackLocationFromWindow ? win?.location?.href : undefined;
291
291
 
292
292
  const debug = detectDebugParams();
293
293
 
@@ -552,7 +552,7 @@ export class KnockGuideClient {
552
552
 
553
553
  // Remove URL query params if present
554
554
  // Only update the URL if params need to be cleared to avoid unnecessary navigations
555
- if (win) {
555
+ if (win?.location) {
556
556
  const url = new URL(win.location.href);
557
557
  if (
558
558
  url.searchParams.has(DEBUG_QUERY_PARAMS.GUIDE_KEY) ||
@@ -952,17 +952,12 @@ export class KnockGuideClient {
952
952
  ...rest,
953
953
  message: { ...message },
954
954
  markAsSeen() {
955
- // Send a seen event if it has not been previously seen.
956
- if (this.message.seen_at) return;
957
955
  return self.markAsSeen(localGuide, this);
958
956
  },
959
957
  markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {
960
- // Always send an interaction event through.
961
958
  return self.markAsInteracted(localGuide, this, metadata);
962
959
  },
963
960
  markAsArchived() {
964
- // Send an archived event if it has not been previously archived.
965
- if (this.message.archived_at) return;
966
961
  return self.markAsArchived(localGuide, this);
967
962
  },
968
963
  };
@@ -1197,7 +1192,7 @@ export class KnockGuideClient {
1197
1192
 
1198
1193
  private listenForLocationChangesFromWindow() {
1199
1194
  const win = checkForWindow();
1200
- if (win?.history) {
1195
+ if (win?.history && win?.addEventListener) {
1201
1196
  // 1. Listen for browser back/forward button clicks.
1202
1197
  win.addEventListener("popstate", this.handleLocationChange);
1203
1198
 
@@ -1238,7 +1233,7 @@ export class KnockGuideClient {
1238
1233
 
1239
1234
  removeLocationChangeEventListeners() {
1240
1235
  const win = checkForWindow();
1241
- if (!win?.history) return;
1236
+ if (!win?.history || !win?.removeEventListener) return;
1242
1237
 
1243
1238
  win.removeEventListener("popstate", this.handleLocationChange);
1244
1239
  win.removeEventListener("hashchange", this.handleLocationChange);
@@ -166,9 +166,11 @@ export type GuideSocketEvent =
166
166
 
167
167
  export interface KnockGuideStep<TContent = Any>
168
168
  extends GuideStepData<TContent> {
169
- markAsSeen: () => void;
170
- markAsInteracted: (params?: { metadata?: GenericData }) => void;
171
- markAsArchived: () => void;
169
+ markAsSeen: () => Promise<KnockGuideStep<TContent> | undefined>;
170
+ markAsInteracted: (params?: {
171
+ metadata?: GenericData;
172
+ }) => Promise<KnockGuideStep<TContent> | undefined>;
173
+ markAsArchived: () => Promise<KnockGuideStep<TContent> | undefined>;
172
174
  }
173
175
 
174
176
  export interface KnockGuideActivationUrlPattern