feat: add LocationSensor helper component for next AppRouter and PagesRouter

[thomaswhyyou]

Description

Adds a couple Next js specific helper components for detecting location changes for the guide client, rather than auto detecting from the window object, so activation evaluations can run properly.

We've observed the latter (default) not working in our dashboard in prod currently, even though it works fine when running locally. It appears that Next js is doing something differently in production builds, where it's potentially caching history methods early in production (for optimizations?) and bypassing the monkey patching (pushState/replaceState) we are doing on the window object during a guide client initialization.

These specific helpers are meant to be used inside the KnockGuideProvider, which calls setLocation on the provided client using the nextjs router object. For example:

<KnockProvider>
  <KnockGuideProvider
    trackLocationFromWindow={false}
  >
    {children}
    <KnockGuideLocationSensorNextPagesRouter />
  </KnockGuideProvider>
</KnockProvider>

---

Note

Adds Next.js App/Pages Router LocationSensor components and updates the guide client to explicitly remove window-based listeners, with exports and peer deps adjusted.

• Guides (React):
  • New: LocationSensorNextAppRouter and LocationSensorNextPagesRouter components to track route changes via Next.js routers and call client.setLocation.
  • Exports: Re-exported as KnockGuideLocationSensorNextAppRouter and KnockGuideLocationSensorNextPagesRouter from packages/react/src/index.ts and guide module indexes.
• Guide Client (Core):
  • Renames cleanup method to removeLocationChangeEventListeners() and uses it in cleanup().
  • Adds log in handleLocationChange; maintains and restores history patches when removing listeners.
• Dependencies:
  • Adds optional next as a peer dependency and includes it in devDependencies for @knocklabs/react.

^{Written by Cursor Bugbot for commit d795cc6. This will update automatically on new commits. Configure here.}

[linear]

KNO-10209 [SDK] Activation rules are not being re-evaluated on location change

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
javascript-ms-teams-connect-example	Ready	Preview	Comment	Oct 28, 2025 9:42pm
javascript-nextjs-example	Ready	Preview	Comment	Oct 28, 2025 9:42pm
javascript-slack-connect-example	Ready	Preview	Comment	Oct 28, 2025 9:42pm
javascript-slack-kit-example	Ready	Preview	Comment	Oct 28, 2025 9:42pm

[changeset-bot]

🦋 Changeset detected

Latest commit: d795cc6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 13 packages

Name	Type
@knocklabs/client	Patch
@knocklabs/react	Patch
client-example	Patch
guide-example	Patch
@knocklabs/expo	Patch
@knocklabs/react-core	Patch
@knocklabs/react-native	Patch
ms-teams-connect-example	Patch
nextjs-app-dir-example	Patch
nextjs-example	Patch
slack-connect-example	Patch
slack-kit-example	Patch
@knocklabs/expo-example	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[thomaswhyyou]

• feat: add LocationSensor helper component for next AppRouter and PagesRouter #789 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

❌ Patch coverage is 32.65306% with 33 lines in your changes missing coverage. Please review.
✅ Project coverage is 65.84%. Comparing base (be65601) to head (d795cc6).
⚠️ Report is 2 commits behind head on main.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...uide/components/LocationSensor/NextPagesRouter.tsx	20.83%	19 Missing ⚠️
.../guide/components/LocationSensor/NextAppRouter.tsx	26.31%	14 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #789      +/-   ##
==========================================
- Coverage   66.06%   65.84%   -0.22%     
==========================================
  Files         185      188       +3     
  Lines        7706     7753      +47     
  Branches      950      950              
==========================================
+ Hits         5091     5105      +14     
- Misses       2591     2624      +33     
  Partials       24       24              

Files with missing lines	Coverage Δ
packages/client/src/clients/guide/client.ts	87.23% <100.00%> (+0.01%)	⬆️
packages/react/src/index.ts	100.00% <ø> (ø)
...c/modules/guide/components/LocationSensor/index.ts	100.00% <100.00%> (ø)
...ckages/react/src/modules/guide/components/index.ts	100.00% <100.00%> (ø)
packages/react/src/modules/guide/index.ts	100.00% <ø> (ø)
.../guide/components/LocationSensor/NextAppRouter.tsx	26.31% <26.31%> (ø)
...uide/components/LocationSensor/NextPagesRouter.tsx	20.83% <20.83%> (ø)