@knocklabs/client 0.21.0 → 0.21.1

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

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","sources":["../../../../src/clients/guide/client.ts"],"sourcesContent":["import { GenericData } from \"@knocklabs/types\";\nimport { Store } from \"@tanstack/store\";\nimport { Channel, Socket } from \"phoenix\";\nimport { URLPattern } from \"urlpattern-polyfill\";\n\nimport Knock from \"../../knock\";\n\nimport {\n  DEFAULT_GROUP_KEY,\n  SelectionResult,\n  byKey,\n  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({\n            pathname: rule.pathname ?? undefined,\n            search: rule.search ?? undefined,\n          }),\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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"}
+{"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  for (const [index, guideKey] of displaySequence.entries()) {\n    const guide = state.previewGuides[guideKey] || state.guides[guideKey];\n    if (!guide) continue;\n\n    const affirmed = predicate(guide, filters, {\n      location,\n      ineligibleGuides: state.ineligibleGuides,\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 = Pick<\n  StoreState,\n  \"location\" | \"ineligibleGuides\" | \"debug\"\n>;\n\nconst predicate = (\n  guide: KnockGuide,\n  filters: SelectFilterParams,\n  { location, ineligibleGuides = {}, 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  // If in debug mode with a forced guide key, bypass other filtering and always\n  // return true for that guide only. This should always run AFTER checking the\n  // filters but BEFORE checking archived status and location rules.\n  if (debug.forcedGuideKey) {\n    return debug.forcedGuideKey === guide.key;\n  }\n\n  const ineligible = ineligibleGuides[guide.key];\n  if (ineligible) {\n    return false;\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  return checkActivatable(guide, location);\n};\n\nexport const checkActivatable = (\n  guide: KnockGuide,\n  location: string | undefined,\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      // TODO(KNO-11523): Remove once we ship guide toolbar v2, and offload as\n      // much debugging specific logic and responsibilities to toolbar.\n      trackDebugParams = false,\n      throttleCheckInterval = DEFAULT_COUNTER_INCREMENT_INTERVAL,\n    } = options;\n    const win = checkForWindow();\n\n    const location = trackLocationFromWindow ? win?.location?.href : undefined;\n    const debug = trackDebugParams ? detectDebugParams() : undefined;\n\n    this.store = new Store<StoreState>({\n      guideGroups: [],\n      guideGroupDisplayLogs: {},\n      guides: {},\n      ineligibleGuides: {},\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 {\n        entries,\n        guide_groups: groups,\n        guide_group_display_logs,\n        ineligible_guides,\n      } = 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        ineligibleGuides: byKey(ineligible_guides || []),\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:\n        debugState?.forcedGuideKey || debugState?.debugging ? 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    // TODO(KNO-11489): Include an ineligible guide in the socket payload too\n    // and process it when handling socket events in real time.\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  setDebug(debugOpts?: Omit<DebugState, \"debugging\">) {\n    this.knock.log(\"[Guide] .setDebug()\");\n    const shouldRefetch = !this.store.state.debug?.debugging;\n\n    this.store.setState((state) => ({\n      ...state,\n      debug: { ...debugOpts, debugging: true },\n    }));\n\n    if (shouldRefetch) {\n      this.knock.log(\n        `[Guide] Start debugging, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\n    }\n  }\n\n  unsetDebug() {\n    this.knock.log(\"[Guide] .unsetDebug()\");\n    const shouldRefetch = this.store.state.debug?.debugging;\n\n    this.store.setState((state) => ({ ...state, debug: undefined }));\n\n    if (shouldRefetch) {\n      this.knock.log(\n        `[Guide] Stop debugging, refetching guides and resubscribing to the websocket channel`,\n      );\n      this.fetch();\n      this.subscribe();\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    // Resolve to the first non-undefined guide in the stage.\n    const resolved = this.stage.ordered.find((x) => x !== undefined);\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({\n            pathname: rule.pathname ?? undefined,\n            search: rule.search ?? undefined,\n          }),\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 || debugState?.debugging) {\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 (!this.options.trackDebugParams) {\n      this.setLocation(href);\n      return;\n    }\n\n    // TODO(KNO-11523): Remove below once we ship toolbar v2.\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","index","guideKey","guide","predicate","ineligibleGuides","debug","s","checkActivatable","url","newUrl","urlRules","urlPatterns","predicateUrlRules","predicateUrlPatterns","KnockGuideClient","knock","channelId","targetParams","options","__publicField","href","currentDebugParams","newDebugParams","trackLocationFromWindow","trackDebugParams","throttleCheckInterval","_a","Store","maybeSocket","delay","opts","queryParams","queryKey","maybeQueryStatus","queryStatus","data","entries","groups","guide_group_display_logs","ineligible_guides","mockDefaultGroup","byKey","g","e","params","newChannel","eventType","payload","resp","event","additionalParams","previewGuides","debugOpts","shouldRefetch","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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"}

package/dist/esm/index.mjs

@@ -1,17 +1,18 @@
-import { default as f } from "./clients/feed/index.mjs";
+import { default as a } from "./clients/feed/index.mjs";
 import t from "./knock.mjs";
-import { DEBUG_QUERY_PARAMS as m, KnockGuideClient as p } from "./clients/guide/client.mjs";
-import { TENANT_OBJECT_COLLECTION as i } from "./clients/objects/constants.mjs";
-import { NetworkStatus as s, isRequestInFlight as u } from "./networkStatus.mjs";
+import { DEBUG_QUERY_PARAMS as i, KnockGuideClient as l, checkActivatable as m } from "./clients/guide/client.mjs";
+import { TENANT_OBJECT_COLLECTION as d } from "./clients/objects/constants.mjs";
+import { NetworkStatus as u, isRequestInFlight as x } from "./networkStatus.mjs";
 import { default as n } from "./clients/feed/feed.mjs";
 export {
-  m as DEBUG_QUERY_PARAMS,
+  i as DEBUG_QUERY_PARAMS,
   n as Feed,
-  f as FeedClient,
-  p as KnockGuideClient,
-  s as NetworkStatus,
-  i as TENANT_OBJECT_COLLECTION,
+  a as FeedClient,
+  l as KnockGuideClient,
+  u as NetworkStatus,
+  d as TENANT_OBJECT_COLLECTION,
+  m as checkActivatable,
   t as default,
-  u as isRequestInFlight
+  x as isRequestInFlight
 };
 //# sourceMappingURL=index.mjs.map

package/dist/types/clients/feed/interfaces.d.ts

@@ -44,8 +44,22 @@ export type FetchFeedOptions = {
     __loadingType?: NetworkStatus.loading | NetworkStatus.fetchMore;
     __fetchSource?: "socket" | "http";
 } & Omit<FeedClientOptions, "__experimentalCrossBrowserUpdates">;
-export type FetchFeedOptionsForRequest = Omit<FeedClientOptions, "trigger_data"> & {
+/**
+ * The final data shape that is sent to the the list feed items endpoint of the Knock API.
+ *
+ * @see https://docs.knock.app/api-reference/users/feeds/list_items
+ */
+export type FetchFeedOptionsForRequest = Omit<FeedClientOptions, "trigger_data" | "inserted_at_date_range"> & {
+    /** The trigger data of the feed items (as a JSON string). */
     trigger_data?: string;
+    /** Limits the results to items inserted after or on the given date. */
+    "inserted_at.gte"?: string;
+    /** Limits the results to items inserted before or on the given date. */
+    "inserted_at.lte"?: string;
+    /** Limits the results to items inserted after the given date. */
+    "inserted_at.gt"?: string;
+    /** Limits the results to items inserted before the given date. */
+    "inserted_at.lt"?: string;
     __loadingType: undefined;
     __fetchSource: undefined;
     __experimentalCrossBrowserUpdates: undefined;

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

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

package/dist/types/clients/feed/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/clients/feed/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEhE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAY9D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,sDAM1C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;EAyB9D;AAMD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,sBAYjE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/clients/feed/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EAET,MAAM,cAAc,CAAC;AAEtB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAY9D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,sDAM1C;AAOD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;EAyB9D;AAMD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,sBAYjE"}

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

@@ -1,12 +1,13 @@
 import { GenericData } from '@knocklabs/types';
 import { Store } from '@tanstack/store';
 import { default as Knock } from '../../knock';
-import { Any, ConstructorOpts, GuideData, GuideStepData, KnockGuide, KnockGuideStep, QueryFilterParams, QueryStatus, SelectFilterParams, SelectGuideOpts, SelectGuidesOpts, StoreState, TargetParams } from './types';
+import { Any, ConstructorOpts, DebugState, GuideData, GuideStepData, KnockGuide, KnockGuideStep, QueryFilterParams, QueryStatus, SelectFilterParams, SelectGuideOpts, SelectGuidesOpts, StoreState, TargetParams } from './types';
 export declare const DEBUG_QUERY_PARAMS: {
     GUIDE_KEY: string;
     PREVIEW_SESSION_ID: string;
 };
 export declare const guidesApiRootPath: (userId: string | undefined | null) => string;
+export declare const checkActivatable: (guide: KnockGuide, location: string | undefined) => boolean;
 export declare class KnockGuideClient {
     readonly knock: Knock;
     readonly channelId: string;
@@ -36,6 +37,8 @@ export declare class KnockGuideClient {
     private handleSocketEvent;
     setLocation(href: string, additionalParams?: Partial<StoreState>): void;
     exitDebugMode(): void;
+    setDebug(debugOpts?: Omit<DebugState, "debugging">): void;
+    unsetDebug(): void;
     selectGuides<C = Any>(state: StoreState, filters?: SelectFilterParams, opts?: SelectGuidesOpts): KnockGuide<C>[];
     selectGuide<C = Any>(state: StoreState, filters?: SelectFilterParams, opts?: SelectGuideOpts): KnockGuide<C> | undefined;
     private openGroupStage;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,OAAO,KAAK,MAAM,aAAa,CAAC;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;IA0DjB,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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/client.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,3 @@
-export { KnockGuideClient, DEBUG_QUERY_PARAMS } from './client';
-export type { KnockGuide, KnockGuideStep, TargetParams as KnockGuideTargetParams, SelectFilterParams as KnockGuideFilterParams, SelectGuideOpts as KnockSelectGuideOpts, SelectGuidesOpts as KnockSelectGuidesOpts, } from './types';
+export { KnockGuideClient, DEBUG_QUERY_PARAMS, checkActivatable, } from './client';
+export type { KnockGuide, KnockGuideStep, GuideIneligibilityMarker as KnockGuideIneligibilityMarker, TargetParams as KnockGuideTargetParams, SelectFilterParams as KnockGuideFilterParams, SelectGuideOpts as KnockSelectGuideOpts, SelectGuidesOpts as KnockSelectGuidesOpts, StoreState as KnockGuideClientStoreState, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,IAAI,sBAAsB,EACtC,kBAAkB,IAAI,sBAAsB,EAC5C,eAAe,IAAI,oBAAoB,EACvC,gBAAgB,IAAI,qBAAqB,GAC1C,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/clients/guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,UAAU,EACV,cAAc,EACd,wBAAwB,IAAI,6BAA6B,EACzD,YAAY,IAAI,sBAAsB,EACtC,kBAAkB,IAAI,sBAAsB,EAC5C,eAAe,IAAI,oBAAoB,EACvC,gBAAgB,IAAI,qBAAqB,EACzC,UAAU,IAAI,0BAA0B,GACzC,MAAM,SAAS,CAAC"}

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

@@ -51,6 +51,13 @@ export interface GuideGroupData {
     inserted_at: string;
     updated_at: string;
 }
+type GuideIneligibilityReason = "guide_not_active" | "marked_as_archived" | "target_conditions_not_met" | "not_in_target_audience";
+export type GuideIneligibilityMarker = {
+    __typename: "GuideIneligibilityMarker";
+    key: KnockGuide["key"];
+    reason: GuideIneligibilityReason;
+    message: string;
+};
 export type GetGuidesQueryParams = {
     data?: string;
     tenant?: string;
@@ -61,6 +68,7 @@ export type GetGuidesResponse = {
     entries: GuideData[];
     guide_groups: GuideGroupData[];
     guide_group_display_logs: Record<GuideGroupData["key"], string>;
+    ineligible_guides: GuideIneligibilityMarker[];
 };
 export type GuideEngagementEventBaseParams = {
     channel_id: string;
@@ -129,6 +137,7 @@ export type QueryStatus = {
     error?: Error;
 };
 export type DebugState = {
+    debugging?: boolean;
     forcedGuideKey?: string | null;
     previewSessionId?: string | null;
 };
@@ -136,11 +145,12 @@ export type StoreState = {
     guideGroups: GuideGroupData[];
     guideGroupDisplayLogs: Record<GuideGroupData["key"], string>;
     guides: Record<KnockGuide["key"], KnockGuide>;
+    ineligibleGuides: Record<GuideIneligibilityMarker["key"], GuideIneligibilityMarker>;
     previewGuides: Record<KnockGuide["key"], KnockGuide>;
     queries: Record<QueryKey, QueryStatus>;
     location: string | undefined;
     counter: number;
-    debug: DebugState;
+    debug?: DebugState;
 };
 export type QueryFilterParams = Pick<GetGuidesQueryParams, "type">;
 export type SelectFilterParams = {
@@ -157,6 +167,7 @@ export type TargetParams = {
 };
 export type ConstructorOpts = {
     trackLocationFromWindow?: boolean;
+    trackDebugParams?: boolean;
     orderResolutionDuration?: number;
     throttleCheckInterval?: number;
 };

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/client",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "The clientside library for interacting with Knock",
   "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
   "author": "@knocklabs",
@@ -65,7 +65,7 @@
     "rollup": "^4.46.2",
     "typescript": "^5.8.3",
     "vite": "^5.4.19",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "@babel/runtime": "^7.28.6",

package/src/clients/feed/interfaces.ts

@@ -65,14 +65,25 @@ export type FetchFeedOptions = {
   __fetchSource?: "socket" | "http";
 } & Omit<FeedClientOptions, "__experimentalCrossBrowserUpdates">;
 
-// The final data shape that is sent to the API
-// Should match types here: https://docs.knock.app/reference#get-feed
+/**
+ * The final data shape that is sent to the the list feed items endpoint of the Knock API.
+ *
+ * @see https://docs.knock.app/api-reference/users/feeds/list_items
+ */
 export type FetchFeedOptionsForRequest = Omit<
   FeedClientOptions,
-  "trigger_data"
+  "trigger_data" | "inserted_at_date_range"
 > & {
-  // Formatted trigger data into a string
+  /** The trigger data of the feed items (as a JSON string). */
   trigger_data?: string;
+  /** Limits the results to items inserted after or on the given date. */
+  "inserted_at.gte"?: string;
+  /** Limits the results to items inserted before or on the given date. */
+  "inserted_at.lte"?: string;
+  /** Limits the results to items inserted after the given date. */
+  "inserted_at.gt"?: string;
+  /** Limits the results to items inserted before the given date. */
+  "inserted_at.lt"?: string;
   // Unset options that should not be sent to the API
   __loadingType: undefined;
   __fetchSource: undefined;

package/src/clients/feed/utils.ts

@@ -1,4 +1,8 @@
-import type { FeedClientOptions, FeedItem } from "./interfaces";
+import type {
+  FeedClientOptions,
+  FeedItem,
+  FetchFeedOptionsForRequest,
+} from "./interfaces";
 
 export function deduplicateItems(items: FeedItem[]): FeedItem[] {
   const seen: Record<string, boolean> = {};
@@ -22,6 +26,11 @@ export function sortItems(items: FeedItem[]) {
   });
 }
 
+type DateRangeParams = Pick<
+  FetchFeedOptionsForRequest,
+  "inserted_at.gte" | "inserted_at.lte" | "inserted_at.gt" | "inserted_at.lt"
+>;
+
 export function mergeDateRangeParams(options: FeedClientOptions) {
   const { inserted_at_date_range, ...rest } = options;
 
@@ -29,7 +38,7 @@ export function mergeDateRangeParams(options: FeedClientOptions) {
     return rest;
   }
 
-  const dateRangeParams: Record<string, string> = {};
+  const dateRangeParams: DateRangeParams = {};
 
   // Determine which operators to use based on the inclusive flag
   const isInclusive = inserted_at_date_range.inclusive ?? false;