@knocklabs/client 0.14.3 → 0.14.5

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

@@ -1,5 +1,6 @@
 import { GenericData } from '@knocklabs/types';
 import { Store } from '@tanstack/store';
+import { URLPattern } from 'urlpattern-polyfill';
 import { default as Knock } from '../../knock';
 export declare const guidesApiRootPath: (userId: string | undefined | null) => string;
 interface StepMessageState {
@@ -18,6 +19,10 @@ interface GuideStepData {
     message: StepMessageState;
     content: any;
 }
+interface GuideActivationLocationRuleData {
+    directive: "allow" | "block";
+    pathname: string;
+}
 interface GuideData {
     __typename: "Guide";
     channel_id: string;
@@ -27,6 +32,7 @@ interface GuideData {
     type: string;
     semver: string;
     steps: GuideStepData[];
+    activation_location_rules: GuideActivationLocationRuleData[];
     inserted_at: string;
     updated_at: string;
 }
@@ -37,8 +43,12 @@ export interface KnockGuideStep extends GuideStepData {
     }) => void;
     markAsArchived: () => void;
 }
+interface KnockGuideActivationLocationRule extends GuideActivationLocationRuleData {
+    pattern: URLPattern;
+}
 export interface KnockGuide extends GuideData {
     steps: KnockGuideStep[];
+    activation_location_rules: KnockGuideActivationLocationRule[];
 }
 type GetGuidesQueryParams = {
     data?: string;
@@ -60,6 +70,7 @@ type QueryStatus = {
 type StoreState = {
     guides: KnockGuide[];
     queries: Record<QueryKey, QueryStatus>;
+    location: string | undefined;
 };
 type QueryFilterParams = Pick<GetGuidesQueryParams, "type">;
 export type SelectFilterParams = {
@@ -70,16 +81,23 @@ export type TargetParams = {
     data?: GenericData | undefined;
     tenant?: string | undefined;
 };
+type ConstructorOpts = {
+    trackLocationFromWindow?: boolean;
+};
 export declare class KnockGuideClient {
     readonly knock: Knock;
     readonly channelId: string;
     readonly targetParams: TargetParams;
+    readonly options: ConstructorOpts;
     store: Store<StoreState, (state: StoreState) => StoreState>;
     private socket;
     private socketChannel;
     private socketChannelTopic;
     private socketEventTypes;
-    constructor(knock: Knock, channelId: string, targetParams?: TargetParams);
+    private pushStateFn;
+    private replaceStateFn;
+    constructor(knock: Knock, channelId: string, targetParams?: TargetParams, options?: ConstructorOpts);
+    cleanup(): void;
     fetch(opts?: {
         filters?: QueryFilterParams;
     }): Promise<QueryStatus>;
@@ -98,6 +116,9 @@ export declare class KnockGuideClient {
     private addGuide;
     private replaceOrAddGuide;
     private removeGuide;
+    private handleLocationChange;
+    private listenForLocationChangesFromWindow;
+    private removeEventListeners;
 }
 export {};
 //# sourceMappingURL=client.d.ts.map

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

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

package/dist/types/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function isValidUuid(uuid: string): boolean;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,WAEvC"}

package/dist/types/knock.d.ts

@@ -28,7 +28,7 @@ declare class Knock {
     failIfNotAuthenticated(): void;
     isAuthenticated(checkUserToken?: boolean): boolean;
     teardown(): void;
-    log(message: string): void;
+    log(message: string, force?: boolean): void;
     /**
      * Initiates an API client
      */

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/client",
-  "version": "0.14.3",
+  "version": "0.14.5",
   "description": "The clientside library for interacting with Knock",
   "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
   "author": "@knocklabs",
@@ -53,7 +53,7 @@
     "@babel/plugin-proposal-object-rest-spread": "^7.16.7",
     "@babel/plugin-transform-runtime": "^7.25.4",
     "@babel/preset-env": "^7.26.0",
-    "@babel/preset-typescript": "^7.26.0",
+    "@babel/preset-typescript": "^7.27.0",
     "@types/jsonwebtoken": "^9.0.9",
     "@typescript-eslint/eslint-plugin": "^8.19.1",
     "@typescript-eslint/parser": "^8.27.0",
@@ -65,8 +65,8 @@
     "rimraf": "^6.0.1",
     "rollup": "^4.34.8",
     "typescript": "^5.8.3",
-    "vite": "^5.0.0",
-    "vitest": "^2.1.8"
+    "vite": "^5.4.18",
+    "vitest": "^3.1.1"
   },
   "dependencies": {
     "@babel/runtime": "^7.27.0",
@@ -78,6 +78,7 @@
     "eventemitter2": "^6.4.5",
     "jwt-decode": "^4.0.0",
     "phoenix": "1.7.19",
+    "urlpattern-polyfill": "^10.0.0",
     "zustand": "^4.5.6"
   }
 }

package/src/clients/feed/feed.ts

@@ -3,6 +3,7 @@ import EventEmitter from "eventemitter2";
 import { Channel } from "phoenix";
 import type { StoreApi } from "zustand";
 
+import { isValidUuid } from "../../helpers";
 import Knock from "../../knock";
 import { NetworkStatus, isRequestInFlight } from "../../networkStatus";
 import {
@@ -57,6 +58,13 @@ class Feed {
     readonly feedId: string,
     options: FeedClientOptions,
   ) {
+    if (!feedId || !isValidUuid(feedId)) {
+      this.knock.log(
+        "[Feed] Invalid or missing feedId provided to the Feed constructor. The feed should be a UUID of an in-app feed channel (`in_app_feed`) found in the Knock dashboard. Please provide a valid feedId to the Feed constructor.",
+        true,
+      );
+    }
+
     this.feedId = feedId;
     this.userFeedId = this.buildUserFeedId();
     this.store = createStore();

package/src/clients/guide/client.ts

@@ -1,6 +1,7 @@
 import { GenericData } from "@knocklabs/types";
 import { Store } from "@tanstack/store";
 import { Channel, Socket } from "phoenix";
+import { URLPattern } from "urlpattern-polyfill";
 
 import Knock from "../../knock";
 
@@ -38,6 +39,11 @@ interface GuideStepData {
   content: any;
 }
 
+interface GuideActivationLocationRuleData {
+  directive: "allow" | "block";
+  pathname: string;
+}
+
 interface GuideData {
   __typename: "Guide";
   channel_id: string;
@@ -47,6 +53,7 @@ interface GuideData {
   type: string;
   semver: string;
   steps: GuideStepData[];
+  activation_location_rules: GuideActivationLocationRuleData[];
   inserted_at: string;
   updated_at: string;
 }
@@ -57,8 +64,14 @@ export interface KnockGuideStep extends GuideStepData {
   markAsArchived: () => void;
 }
 
+interface KnockGuideActivationLocationRule
+  extends GuideActivationLocationRuleData {
+  pattern: URLPattern;
+}
+
 export interface KnockGuide extends GuideData {
   steps: KnockGuideStep[];
+  activation_location_rules: KnockGuideActivationLocationRule[];
 }
 
 type GetGuidesQueryParams = {
@@ -133,6 +146,7 @@ type QueryStatus = {
 type StoreState = {
   guides: KnockGuide[];
   queries: Record<QueryKey, QueryStatus>;
+  location: string | undefined;
 };
 
 type QueryFilterParams = Pick<GetGuidesQueryParams, "type">;
@@ -147,6 +161,10 @@ export type TargetParams = {
   tenant?: string | undefined;
 };
 
+type ConstructorOpts = {
+  trackLocationFromWindow?: boolean;
+};
+
 export class KnockGuideClient {
   public store: Store<StoreState, (state: StoreState) => StoreState>;
 
@@ -156,14 +174,26 @@ export class KnockGuideClient {
   private socketChannelTopic: string;
   private socketEventTypes = ["guide.added", "guide.updated", "guide.removed"];
 
+  // Original history methods to monkey patch, or restore in cleanups.
+  private pushStateFn: History["pushState"] | undefined;
+  private replaceStateFn: History["replaceState"] | undefined;
+
   constructor(
     readonly knock: Knock,
     readonly channelId: string,
     readonly targetParams: TargetParams = {},
+    readonly options: ConstructorOpts = {},
   ) {
+    const { trackLocationFromWindow = true } = options;
+
+    const location = trackLocationFromWindow
+      ? window?.location.href
+      : undefined;
+
     this.store = new Store<StoreState>({
       guides: [],
       queries: {},
+      location,
     });
 
     // In server environments we might not have a socket connection.
@@ -171,9 +201,18 @@ export class KnockGuideClient {
     this.socket = maybeSocket;
     this.socketChannelTopic = `guides:${channelId}`;
 
+    if (trackLocationFromWindow) {
+      this.listenForLocationChangesFromWindow();
+    }
+
     this.knock.log("[Guide] Initialized a guide client");
   }
 
+  cleanup() {
+    this.unsubscribe();
+    this.removeEventListeners();
+  }
+
   async fetch(opts?: { filters?: QueryFilterParams }) {
     this.knock.failIfNotAuthenticated();
     this.knock.log("[Guide] Loading all eligible guides");
@@ -291,8 +330,6 @@ export class KnockGuideClient {
   //
 
   select(state: StoreState, filters: SelectFilterParams = {}) {
-    // TODO(KNO-7790): Need to evaluate activation rules also.
-
     return state.guides.filter((guide) => {
       if (filters.type && filters.type !== guide.type) {
         return false;
@@ -302,6 +339,42 @@ export class KnockGuideClient {
         return false;
       }
 
+      const locationRules = guide.activation_location_rules || [];
+
+      if (locationRules.length > 0 && state.location) {
+        const allowed = locationRules.reduce<boolean | undefined>(
+          (acc, rule) => {
+            // Any matched block rule prevails so no need to evaluate further
+            // as soon as there is one.
+            if (acc === false) return false;
+
+            // At this point we either have a matched allow rule (acc is true),
+            // or no matched rule found yet (acc is undefined).
+
+            switch (rule.directive) {
+              case "allow": {
+                // No need to evaluate more allow rules once we matched one
+                // since any matched allowed rule means allow.
+                if (acc === true) return true;
+
+                const matched = rule.pattern.test(state.location);
+                return matched ? true : undefined;
+              }
+
+              case "block": {
+                // Always test block rules (unless already matched to block)
+                // because they'd prevail over matched allow rules.
+                const matched = rule.pattern.test(state.location);
+                return matched ? false : acc;
+              }
+            }
+          },
+          undefined,
+        );
+
+        if (!allowed) return false;
+      }
+
       return true;
     });
   }
@@ -427,6 +500,14 @@ export class KnockGuideClient {
       return localStep;
     });
 
+    localGuide.activation_location_rules =
+      remoteGuide.activation_location_rules.map((rule) => {
+        return {
+          ...rule,
+          pattern: new URLPattern({ pathname: rule.pathname }),
+        };
+      });
+
     return localGuide as KnockGuide;
   }
 
@@ -538,4 +619,67 @@ export class KnockGuideClient {
       return { ...state, guides };
     });
   }
+
+  private handleLocationChange() {
+    const href = window.location.href;
+    if (this.store.state.location === href) return;
+
+    this.knock.log(`[Guide] Handle Location change: ${href}`);
+
+    this.store.setState((state) => ({ ...state, location: href }));
+  }
+
+  private listenForLocationChangesFromWindow() {
+    if (window?.history) {
+      // 1. Listen for browser back/forward button clicks.
+      window.addEventListener("popstate", this.handleLocationChange);
+
+      // 2. Listen for hash changes in case it's used for routing.
+      window.addEventListener("hashchange", this.handleLocationChange);
+
+      // 3. Monkey-patch history methods to catch programmatic navigation.
+      const pushStateFn = window.history.pushState;
+      const replaceStateFn = window.history.replaceState;
+
+      // Use setTimeout to allow the browser state to potentially settle.
+      window.history.pushState = new Proxy(pushStateFn, {
+        apply: (target, history, args) => {
+          Reflect.apply(target, history, args);
+          setTimeout(() => {
+            this.handleLocationChange();
+          }, 0);
+        },
+      });
+      window.history.replaceState = new Proxy(replaceStateFn, {
+        apply: (target, history, args) => {
+          Reflect.apply(target, history, args);
+          setTimeout(() => {
+            this.handleLocationChange();
+          }, 0);
+        },
+      });
+
+      // 4. Keep refs to the original handlers so we can restore during cleanup.
+      this.pushStateFn = pushStateFn;
+      this.replaceStateFn = replaceStateFn;
+    } else {
+      this.knock.log(
+        "[Guide] Unable to access the `window.history` object to detect location changes",
+      );
+    }
+  }
+
+  private removeEventListeners() {
+    window.removeEventListener("popstate", this.handleLocationChange);
+    window.removeEventListener("hashchange", this.handleLocationChange);
+
+    if (this.pushStateFn) {
+      window.history.pushState = this.pushStateFn;
+      this.pushStateFn = undefined;
+    }
+    if (this.replaceStateFn) {
+      window.history.replaceState = this.replaceStateFn;
+      this.replaceStateFn = undefined;
+    }
+  }
 }

package/src/helpers.ts

@@ -0,0 +1,6 @@
+const uuidRegex =
+  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+
+export function isValidUuid(uuid: string) {
+  return uuidRegex.test(uuid);
+}

package/src/knock.ts

@@ -130,8 +130,8 @@ class Knock {
     }
   }
 
-  log(message: string) {
-    if (this.logLevel === "debug") {
+  log(message: string, force = false) {
+    if (this.logLevel === "debug" || force) {
       console.log(`[Knock] ${message}`);
     }
   }