@knocklabs/react 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.9.3
+
+### Patch Changes
+
+- 79d7608: [guide] add KnockGuideLocationSensor helper component for Tanstack Router
+
+## 0.9.2
+
+### Patch Changes
+
+- 1e538b9: [guide] add a secondary entry point for nextjs specific helpers for guide location detection
+- Updated dependencies [1e538b9]
+  - @knocklabs/client@0.19.2
+  - @knocklabs/react-core@0.11.2
+
 ## 0.9.1
 
 ### Patch Changes

package/dist/cjs/modules/core/utils.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=e=>{const n=window.screenLeft??window.screenX,t=window.screenTop??window.screenY,o=window.innerWidth??document.documentElement.clientWidth??screen.width,i=window.innerHeight??document.documentElement.clientHeight??screen.height,c=o/2-600/2+n,d=`width=600,height=800,top=${i/2-800/2+t},left=${c}`;window.open(e,"_blank",d)};exports.openPopupWindow=h;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=e=>{const n=window.screenLeft??window.screenX,t=window.screenTop??window.screenY,o=window.innerWidth??document.documentElement.clientWidth??screen.width,i=window.innerHeight??document.documentElement.clientHeight??screen.height,c=o/2-600/2+n,d=`width=600,height=800,top=${i/2-800/2+t},left=${c}`;window.open(e,"_blank",d)},h=()=>{if(typeof window<"u")return window};exports.checkForWindow=h;exports.openPopupWindow=w;
 //# sourceMappingURL=utils.js.map

package/dist/cjs/modules/core/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../../src/modules/core/utils.ts"],"sourcesContent":["export const openPopupWindow = (url: string) => {\n  const width = 600;\n  const height = 800;\n  // Calculate the position to center the window\n  const screenLeft = window.screenLeft ?? window.screenX;\n  const screenTop = window.screenTop ?? window.screenY;\n\n  const innerWidth =\n    window.innerWidth ?? document.documentElement.clientWidth ?? screen.width;\n  const innerHeight =\n    window.innerHeight ??\n    document.documentElement.clientHeight ??\n    screen.height;\n\n  const left = innerWidth / 2 - width / 2 + screenLeft;\n  const top = innerHeight / 2 - height / 2 + screenTop;\n\n  // Window features\n  const features = `width=${width},height=${height},top=${top},left=${left}`;\n\n  window.open(url, \"_blank\", features);\n};\n\nexport const checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n"],"names":["openPopupWindow","url","screenLeft","window","screenX","screenTop","screenY","innerWidth","document","documentElement","clientWidth","screen","width","innerHeight","clientHeight","height","left","features","open"],"mappings":"gFAAaA,MAAAA,EAAmBC,GAAgB,CAIxCC,MAAAA,EAAaC,OAAOD,YAAcC,OAAOC,QACzCC,EAAYF,OAAOE,WAAaF,OAAOG,QAEvCC,EACJJ,OAAOI,YAAcC,SAASC,gBAAgBC,aAAeC,OAAOC,MAChEC,EACJV,OAAOU,aACPL,SAASC,gBAAgBK,cACzBH,OAAOI,OAEHC,EAAOT,EAAa,EAAIK,IAAQ,EAAIV,EAIpCe,EAAW,4BAHLJ,EAAc,EAAIE,IAAS,EAAIV,CAGgB,SAASW,CAAI,GAEjEE,OAAAA,KAAKjB,EAAK,SAAUgB,CAAQ,CACrC"}
+{"version":3,"file":"utils.js","sources":["../../../../src/modules/core/utils.ts"],"sourcesContent":["export const openPopupWindow = (url: string) => {\n  const width = 600;\n  const height = 800;\n  // Calculate the position to center the window\n  const screenLeft = window.screenLeft ?? window.screenX;\n  const screenTop = window.screenTop ?? window.screenY;\n\n  const innerWidth =\n    window.innerWidth ?? document.documentElement.clientWidth ?? screen.width;\n  const innerHeight =\n    window.innerHeight ??\n    document.documentElement.clientHeight ??\n    screen.height;\n\n  const left = innerWidth / 2 - width / 2 + screenLeft;\n  const top = innerHeight / 2 - height / 2 + screenTop;\n\n  // Window features\n  const features = `width=${width},height=${height},top=${top},left=${left}`;\n\n  window.open(url, \"_blank\", features);\n};\n\nexport const checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n"],"names":["openPopupWindow","url","screenLeft","window","screenX","screenTop","screenY","innerWidth","document","documentElement","clientWidth","screen","width","innerHeight","clientHeight","height","left","features","open","checkForWindow"],"mappings":"gFAAaA,MAAAA,EAAmBC,GAAgB,CAIxCC,MAAAA,EAAaC,OAAOD,YAAcC,OAAOC,QACzCC,EAAYF,OAAOE,WAAaF,OAAOG,QAEvCC,EACJJ,OAAOI,YAAcC,SAASC,gBAAgBC,aAAeC,OAAOC,MAChEC,EACJV,OAAOU,aACPL,SAASC,gBAAgBK,cACzBH,OAAOI,OAEHC,EAAOT,EAAa,EAAIK,IAAQ,EAAIV,EAIpCe,EAAW,4BAHLJ,EAAc,EAAIE,IAAS,EAAIV,CAGgB,SAASW,CAAI,GAEjEE,OAAAA,KAAKjB,EAAK,SAAUgB,CAAQ,CACrC,EAEaE,EAAiBA,IAAM,CAC9B,GAAA,OAAOhB,OAAW,IACbA,OAAAA,MAEX"}

package/dist/cjs/next/KnockGuideLocationSensor.js

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@knocklabs/react-core"),c=require("next/navigation.js"),i=require("next/router.js"),l=require("react"),u=require("../modules/core/utils.js"),f=e=>e&&typeof e=="object"&&"default"in e?e:{default:e},s=f(l),d=()=>{const e=i.useRouter(),{client:o}=a.useGuideContext();return s.default.useEffect(()=>{const n=u.checkForWindow();if(!n)return;o.store.state.location||o.setLocation(n.location.href),o.removeLocationChangeEventListeners();const t=r=>{o.setLocation(n.location.origin+r)};return e.events.on("routeChangeComplete",t),()=>{e.events.off("routeChangeComplete",t)}},[o]),null},h=()=>{const e=c.usePathname(),n=c.useSearchParams().toString(),{client:t}=a.useGuideContext();return s.default.useEffect(()=>{t.removeLocationChangeEventListeners()},[t]),s.default.useEffect(()=>{const r=u.checkForWindow();r&&t.setLocation(r.location.href)},[t,e,n]),null},m={PagesRouter:d,AppRouter:h};exports.KnockGuideLocationSensor=m;
+//# sourceMappingURL=KnockGuideLocationSensor.js.map

package/dist/cjs/next/KnockGuideLocationSensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.js","sources":["../../../src/next/KnockGuideLocationSensor.tsx"],"sourcesContent":["\"use client\";\n\nimport { useGuideContext } from \"@knocklabs/react-core\";\n// Note the .js suffix for Next 15 ESM friendliness:\nimport { usePathname, useSearchParams } from \"next/navigation.js\";\nimport { useRouter } from \"next/router.js\";\nimport React from \"react\";\n\nimport { checkForWindow } from \"../modules/core/utils\";\n\nconst PagesRouter: React.FC = () => {\n  const router = useRouter();\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    // Set the initial location if not yet set.\n    if (!client.store.state.location) {\n      client.setLocation(win.location.href);\n    }\n\n    // If you are using this helper module, then that means we are detecting\n    // route changes from next's router rather than from the global history\n    // object which the guide client does by default, so ensure we don't have\n    // any event listeners hanging around unnecessarily.\n    client.removeLocationChangeEventListeners();\n\n    // Attach a route change event listener to the nextjs router. Note, here url\n    // is the pathname and any query parameters of the new route but does not\n    // include the domain or origin.\n    const handleRouteChangeComplete = (url: string) => {\n      client.setLocation(win.location.origin + url);\n    };\n    router.events.on(\"routeChangeComplete\", handleRouteChangeComplete);\n\n    return () => {\n      router.events.off(\"routeChangeComplete\", handleRouteChangeComplete);\n    };\n    // We want to run this effect once per client instance and `router` is not\n    // guaranteed to be referentially stable.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [client]);\n\n  return null;\n};\n\nconst AppRouter: React.FC = () => {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n  const queryStr = searchParams.toString();\n\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    // Same here, remove any location change event listeners on the window\n    // object in case they are attached.\n    client.removeLocationChangeEventListeners();\n  }, [client]);\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    client.setLocation(win.location.href);\n  }, [client, pathname, queryStr]);\n\n  return null;\n};\n\nexport const KnockGuideLocationSensor = {\n  PagesRouter,\n  AppRouter,\n};\n"],"names":["PagesRouter","router","useRouter","client","useGuideContext","React","useEffect","win","checkForWindow","store","state","location","setLocation","href","removeLocationChangeEventListeners","handleRouteChangeComplete","url","origin","events","on","off","AppRouter","pathname","usePathname","queryStr","useSearchParams","toString","KnockGuideLocationSensor"],"mappings":"0TAUMA,EAAwBA,IAAM,CAClC,MAAMC,EAASC,EAAAA,UAAU,EACnB,CAAEC,OAAAA,GAAWC,kBAAgB,EAEnCC,OAAAA,EAAAA,QAAMC,UAAU,IAAM,CACpB,MAAMC,EAAMC,EAAAA,eAAe,EAC3B,GAAI,CAACD,EAAK,OAGLJ,EAAOM,MAAMC,MAAMC,UACfC,EAAAA,YAAYL,EAAII,SAASE,IAAI,EAOtCV,EAAOW,mCAAmC,EAKpCC,MAAAA,EAA6BC,GAAgB,CACjDb,EAAOS,YAAYL,EAAII,SAASM,OAASD,CAAG,CAC9C,EACOE,OAAAA,EAAAA,OAAOC,GAAG,sBAAuBJ,CAAyB,EAE1D,IAAM,CACJG,EAAAA,OAAOE,IAAI,sBAAuBL,CAAyB,CACpE,CAAA,EAIC,CAACZ,CAAM,CAAC,EAEJ,IACT,EAEMkB,EAAsBA,IAAM,CAChC,MAAMC,EAAWC,EAAAA,YAAY,EAEvBC,EADeC,EAAAA,gBAAgB,EACPC,SAAS,EAEjC,CAAEvB,OAAAA,GAAWC,kBAAgB,EAEnCC,OAAAA,EAAAA,QAAMC,UAAU,IAAM,CAGpBH,EAAOW,mCAAmC,CAAA,EACzC,CAACX,CAAM,CAAC,EAEXE,EAAAA,QAAMC,UAAU,IAAM,CACpB,MAAMC,EAAMC,EAAAA,eAAe,EACtBD,GAEEK,EAAAA,YAAYL,EAAII,SAASE,IAAI,CACnC,EAAA,CAACV,EAAQmB,EAAUE,CAAQ,CAAC,EAExB,IACT,EAEaG,EAA2B,CACtC3B,YAAAA,EACAqB,UAAAA,CACF"}

package/dist/cjs/next.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./next/KnockGuideLocationSensor.js");exports.KnockGuideLocationSensor=o.KnockGuideLocationSensor;
+//# sourceMappingURL=next.js.map

package/dist/cjs/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/cjs/tanstack/KnockGuideLocationSensor.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("@knocklabs/react-core"),r=require("@tanstack/react-router"),i=require("react"),u=require("../modules/core/utils.js"),s=e=>e&&typeof e=="object"&&"default"in e?e:{default:e},n=s(i),a=()=>{const{href:e}=r.useLocation(),{client:t}=c.useGuideContext();return n.default.useEffect(()=>{t.removeLocationChangeEventListeners()},[t]),n.default.useEffect(()=>{const o=u.checkForWindow();o&&t.setLocation(o.location.origin+e)},[t,e]),null};exports.KnockGuideLocationSensor=a;
+//# sourceMappingURL=KnockGuideLocationSensor.js.map

package/dist/cjs/tanstack/KnockGuideLocationSensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.js","sources":["../../../src/tanstack/KnockGuideLocationSensor.tsx"],"sourcesContent":["import { useGuideContext } from \"@knocklabs/react-core\";\nimport { useLocation } from \"@tanstack/react-router\";\nimport React from \"react\";\n\nimport { checkForWindow } from \"../modules/core/utils\";\n\nexport const KnockGuideLocationSensor: React.FC = () => {\n  const { href } = useLocation();\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    client.removeLocationChangeEventListeners();\n  }, [client]);\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    // href here is the full path of the location, including pathname, search,\n    // and hash but does not include the origin.\n    client.setLocation(win.location.origin + href);\n  }, [client, href]);\n\n  return null;\n};\n"],"names":["KnockGuideLocationSensor","href","useLocation","client","useGuideContext","React","useEffect","removeLocationChangeEventListeners","win","checkForWindow","setLocation","location","origin"],"mappings":"qRAMaA,EAAqCA,IAAM,CAChD,KAAA,CAAEC,KAAAA,GAASC,cAAY,EACvB,CAAEC,OAAAA,GAAWC,kBAAgB,EAEnCC,OAAAA,EAAAA,QAAMC,UAAU,IAAM,CACpBH,EAAOI,mCAAmC,CAAA,EACzC,CAACJ,CAAM,CAAC,EAEXE,EAAAA,QAAMC,UAAU,IAAM,CACpB,MAAME,EAAMC,EAAAA,eAAe,EACtBD,GAILL,EAAOO,YAAYF,EAAIG,SAASC,OAASX,CAAI,CAAA,EAC5C,CAACE,EAAQF,CAAI,CAAC,EAEV,IACT"}

package/dist/cjs/tanstack.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./tanstack/KnockGuideLocationSensor.js");exports.KnockGuideLocationSensor=o.KnockGuideLocationSensor;
+//# sourceMappingURL=tanstack.js.map

package/dist/cjs/tanstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/modules/core/utils.mjs

@@ -1,8 +1,12 @@
 const r = (e) => {
-  const n = window.screenLeft ?? window.screenX, t = window.screenTop ?? window.screenY, o = window.innerWidth ?? document.documentElement.clientWidth ?? screen.width, i = window.innerHeight ?? document.documentElement.clientHeight ?? screen.height, c = o / 2 - 600 / 2 + n, h = `width=600,height=800,top=${i / 2 - 800 / 2 + t},left=${c}`;
-  window.open(e, "_blank", h);
+  const n = window.screenLeft ?? window.screenX, t = window.screenTop ?? window.screenY, o = window.innerWidth ?? document.documentElement.clientWidth ?? screen.width, i = window.innerHeight ?? document.documentElement.clientHeight ?? screen.height, c = o / 2 - 600 / 2 + n, d = `width=600,height=800,top=${i / 2 - 800 / 2 + t},left=${c}`;
+  window.open(e, "_blank", d);
+}, p = () => {
+  if (typeof window < "u")
+    return window;
 };
 export {
+  p as checkForWindow,
   r as openPopupWindow
 };
 //# sourceMappingURL=utils.mjs.map

package/dist/esm/modules/core/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sources":["../../../../src/modules/core/utils.ts"],"sourcesContent":["export const openPopupWindow = (url: string) => {\n  const width = 600;\n  const height = 800;\n  // Calculate the position to center the window\n  const screenLeft = window.screenLeft ?? window.screenX;\n  const screenTop = window.screenTop ?? window.screenY;\n\n  const innerWidth =\n    window.innerWidth ?? document.documentElement.clientWidth ?? screen.width;\n  const innerHeight =\n    window.innerHeight ??\n    document.documentElement.clientHeight ??\n    screen.height;\n\n  const left = innerWidth / 2 - width / 2 + screenLeft;\n  const top = innerHeight / 2 - height / 2 + screenTop;\n\n  // Window features\n  const features = `width=${width},height=${height},top=${top},left=${left}`;\n\n  window.open(url, \"_blank\", features);\n};\n\nexport const checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n"],"names":["openPopupWindow","url","screenLeft","window","screenX","screenTop","screenY","innerWidth","document","documentElement","clientWidth","screen","width","innerHeight","clientHeight","height","left","features","open"],"mappings":"AAAaA,MAAAA,IAAkBA,CAACC,MAAgB;AAIxCC,QAAAA,IAAaC,OAAOD,cAAcC,OAAOC,SACzCC,IAAYF,OAAOE,aAAaF,OAAOG,SAEvCC,IACJJ,OAAOI,cAAcC,SAASC,gBAAgBC,eAAeC,OAAOC,OAChEC,IACJV,OAAOU,eACPL,SAASC,gBAAgBK,gBACzBH,OAAOI,QAEHC,IAAOT,IAAa,IAAIK,MAAQ,IAAIV,GAIpCe,IAAW,4BAHLJ,IAAc,IAAIE,MAAS,IAAIV,CAGgB,SAASW,CAAI;AAEjEE,SAAAA,KAAKjB,GAAK,UAAUgB,CAAQ;AACrC;"}
+{"version":3,"file":"utils.mjs","sources":["../../../../src/modules/core/utils.ts"],"sourcesContent":["export const openPopupWindow = (url: string) => {\n  const width = 600;\n  const height = 800;\n  // Calculate the position to center the window\n  const screenLeft = window.screenLeft ?? window.screenX;\n  const screenTop = window.screenTop ?? window.screenY;\n\n  const innerWidth =\n    window.innerWidth ?? document.documentElement.clientWidth ?? screen.width;\n  const innerHeight =\n    window.innerHeight ??\n    document.documentElement.clientHeight ??\n    screen.height;\n\n  const left = innerWidth / 2 - width / 2 + screenLeft;\n  const top = innerHeight / 2 - height / 2 + screenTop;\n\n  // Window features\n  const features = `width=${width},height=${height},top=${top},left=${left}`;\n\n  window.open(url, \"_blank\", features);\n};\n\nexport const checkForWindow = () => {\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n};\n"],"names":["openPopupWindow","url","screenLeft","window","screenX","screenTop","screenY","innerWidth","document","documentElement","clientWidth","screen","width","innerHeight","clientHeight","height","left","features","open","checkForWindow"],"mappings":"AAAaA,MAAAA,IAAkBA,CAACC,MAAgB;AAIxCC,QAAAA,IAAaC,OAAOD,cAAcC,OAAOC,SACzCC,IAAYF,OAAOE,aAAaF,OAAOG,SAEvCC,IACJJ,OAAOI,cAAcC,SAASC,gBAAgBC,eAAeC,OAAOC,OAChEC,IACJV,OAAOU,eACPL,SAASC,gBAAgBK,gBACzBH,OAAOI,QAEHC,IAAOT,IAAa,IAAIK,MAAQ,IAAIV,GAIpCe,IAAW,4BAHLJ,IAAc,IAAIE,MAAS,IAAIV,CAGgB,SAASW,CAAI;AAEjEE,SAAAA,KAAKjB,GAAK,UAAUgB,CAAQ;AACrC,GAEaE,IAAiBA,MAAM;AAC9B,MAAA,OAAOhB,SAAW;AACbA,WAAAA;AAEX;"}

package/dist/esm/next/KnockGuideLocationSensor.mjs

@@ -0,0 +1,39 @@
+"use client";
+import { useGuideContext as c } from "@knocklabs/react-core";
+import { usePathname as i, useSearchParams as u } from "next/navigation.js";
+import { useRouter as m } from "next/router.js";
+import s from "react";
+import { checkForWindow as a } from "../modules/core/utils.mjs";
+const f = () => {
+  const n = m(), {
+    client: t
+  } = c();
+  return s.useEffect(() => {
+    const o = a();
+    if (!o) return;
+    t.store.state.location || t.setLocation(o.location.href), t.removeLocationChangeEventListeners();
+    const e = (r) => {
+      t.setLocation(o.location.origin + r);
+    };
+    return n.events.on("routeChangeComplete", e), () => {
+      n.events.off("routeChangeComplete", e);
+    };
+  }, [t]), null;
+}, l = () => {
+  const n = i(), o = u().toString(), {
+    client: e
+  } = c();
+  return s.useEffect(() => {
+    e.removeLocationChangeEventListeners();
+  }, [e]), s.useEffect(() => {
+    const r = a();
+    r && e.setLocation(r.location.href);
+  }, [e, n, o]), null;
+}, v = {
+  PagesRouter: f,
+  AppRouter: l
+};
+export {
+  v as KnockGuideLocationSensor
+};
+//# sourceMappingURL=KnockGuideLocationSensor.mjs.map

package/dist/esm/next/KnockGuideLocationSensor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.mjs","sources":["../../../src/next/KnockGuideLocationSensor.tsx"],"sourcesContent":["\"use client\";\n\nimport { useGuideContext } from \"@knocklabs/react-core\";\n// Note the .js suffix for Next 15 ESM friendliness:\nimport { usePathname, useSearchParams } from \"next/navigation.js\";\nimport { useRouter } from \"next/router.js\";\nimport React from \"react\";\n\nimport { checkForWindow } from \"../modules/core/utils\";\n\nconst PagesRouter: React.FC = () => {\n  const router = useRouter();\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    // Set the initial location if not yet set.\n    if (!client.store.state.location) {\n      client.setLocation(win.location.href);\n    }\n\n    // If you are using this helper module, then that means we are detecting\n    // route changes from next's router rather than from the global history\n    // object which the guide client does by default, so ensure we don't have\n    // any event listeners hanging around unnecessarily.\n    client.removeLocationChangeEventListeners();\n\n    // Attach a route change event listener to the nextjs router. Note, here url\n    // is the pathname and any query parameters of the new route but does not\n    // include the domain or origin.\n    const handleRouteChangeComplete = (url: string) => {\n      client.setLocation(win.location.origin + url);\n    };\n    router.events.on(\"routeChangeComplete\", handleRouteChangeComplete);\n\n    return () => {\n      router.events.off(\"routeChangeComplete\", handleRouteChangeComplete);\n    };\n    // We want to run this effect once per client instance and `router` is not\n    // guaranteed to be referentially stable.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [client]);\n\n  return null;\n};\n\nconst AppRouter: React.FC = () => {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n  const queryStr = searchParams.toString();\n\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    // Same here, remove any location change event listeners on the window\n    // object in case they are attached.\n    client.removeLocationChangeEventListeners();\n  }, [client]);\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    client.setLocation(win.location.href);\n  }, [client, pathname, queryStr]);\n\n  return null;\n};\n\nexport const KnockGuideLocationSensor = {\n  PagesRouter,\n  AppRouter,\n};\n"],"names":["PagesRouter","router","useRouter","client","useGuideContext","React","useEffect","win","checkForWindow","store","state","location","setLocation","href","removeLocationChangeEventListeners","handleRouteChangeComplete","url","origin","events","on","off","AppRouter","pathname","usePathname","queryStr","useSearchParams","toString","KnockGuideLocationSensor"],"mappings":";;;;;;AAUA,MAAMA,IAAwBA,MAAM;AAClC,QAAMC,IAASC,EAAU,GACnB;AAAA,IAAEC,QAAAA;AAAAA,MAAWC,EAAgB;AAEnCC,SAAAA,EAAMC,UAAU,MAAM;AACpB,UAAMC,IAAMC,EAAe;AAC3B,QAAI,CAACD,EAAK;AAGV,IAAKJ,EAAOM,MAAMC,MAAMC,YACfC,EAAAA,YAAYL,EAAII,SAASE,IAAI,GAOtCV,EAAOW,mCAAmC;AAKpCC,UAAAA,IAA4BA,CAACC,MAAgB;AACjDb,MAAAA,EAAOS,YAAYL,EAAII,SAASM,SAASD,CAAG;AAAA,IAC9C;AACOE,WAAAA,EAAAA,OAAOC,GAAG,uBAAuBJ,CAAyB,GAE1D,MAAM;AACJG,MAAAA,EAAAA,OAAOE,IAAI,uBAAuBL,CAAyB;AAAA,IACpE;AAAA,EAAA,GAIC,CAACZ,CAAM,CAAC,GAEJ;AACT,GAEMkB,IAAsBA,MAAM;AAChC,QAAMC,IAAWC,EAAY,GAEvBC,IADeC,EAAgB,EACPC,SAAS,GAEjC;AAAA,IAAEvB,QAAAA;AAAAA,MAAWC,EAAgB;AAEnCC,SAAAA,EAAMC,UAAU,MAAM;AAGpBH,IAAAA,EAAOW,mCAAmC;AAAA,EAAA,GACzC,CAACX,CAAM,CAAC,GAEXE,EAAMC,UAAU,MAAM;AACpB,UAAMC,IAAMC,EAAe;AAC3B,IAAKD,KAEEK,EAAAA,YAAYL,EAAII,SAASE,IAAI;AAAA,EACnC,GAAA,CAACV,GAAQmB,GAAUE,CAAQ,CAAC,GAExB;AACT,GAEaG,IAA2B;AAAA,EACtC3B,aAAAA;AAAAA,EACAqB,WAAAA;AACF;"}

package/dist/esm/next.mjs

@@ -0,0 +1,5 @@
+import { KnockGuideLocationSensor as n } from "./next/KnockGuideLocationSensor.mjs";
+export {
+  n as KnockGuideLocationSensor
+};
+//# sourceMappingURL=next.mjs.map

package/dist/esm/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/tanstack/KnockGuideLocationSensor.mjs

@@ -0,0 +1,21 @@
+import { useGuideContext as r } from "@knocklabs/react-core";
+import { useLocation as i } from "@tanstack/react-router";
+import n from "react";
+import { checkForWindow as c } from "../modules/core/utils.mjs";
+const a = () => {
+  const {
+    href: t
+  } = i(), {
+    client: o
+  } = r();
+  return n.useEffect(() => {
+    o.removeLocationChangeEventListeners();
+  }, [o]), n.useEffect(() => {
+    const e = c();
+    e && o.setLocation(e.location.origin + t);
+  }, [o, t]), null;
+};
+export {
+  a as KnockGuideLocationSensor
+};
+//# sourceMappingURL=KnockGuideLocationSensor.mjs.map

package/dist/esm/tanstack/KnockGuideLocationSensor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.mjs","sources":["../../../src/tanstack/KnockGuideLocationSensor.tsx"],"sourcesContent":["import { useGuideContext } from \"@knocklabs/react-core\";\nimport { useLocation } from \"@tanstack/react-router\";\nimport React from \"react\";\n\nimport { checkForWindow } from \"../modules/core/utils\";\n\nexport const KnockGuideLocationSensor: React.FC = () => {\n  const { href } = useLocation();\n  const { client } = useGuideContext();\n\n  React.useEffect(() => {\n    client.removeLocationChangeEventListeners();\n  }, [client]);\n\n  React.useEffect(() => {\n    const win = checkForWindow();\n    if (!win) return;\n\n    // href here is the full path of the location, including pathname, search,\n    // and hash but does not include the origin.\n    client.setLocation(win.location.origin + href);\n  }, [client, href]);\n\n  return null;\n};\n"],"names":["KnockGuideLocationSensor","href","useLocation","client","useGuideContext","React","useEffect","removeLocationChangeEventListeners","win","checkForWindow","setLocation","location","origin"],"mappings":";;;;AAMO,MAAMA,IAAqCA,MAAM;AAChD,QAAA;AAAA,IAAEC,MAAAA;AAAAA,MAASC,EAAY,GACvB;AAAA,IAAEC,QAAAA;AAAAA,MAAWC,EAAgB;AAEnCC,SAAAA,EAAMC,UAAU,MAAM;AACpBH,IAAAA,EAAOI,mCAAmC;AAAA,EAAA,GACzC,CAACJ,CAAM,CAAC,GAEXE,EAAMC,UAAU,MAAM;AACpB,UAAME,IAAMC,EAAe;AAC3B,IAAKD,KAILL,EAAOO,YAAYF,EAAIG,SAASC,SAASX,CAAI;AAAA,EAAA,GAC5C,CAACE,GAAQF,CAAI,CAAC,GAEV;AACT;"}

package/dist/esm/tanstack.mjs

@@ -0,0 +1,5 @@
+import { KnockGuideLocationSensor as n } from "./tanstack/KnockGuideLocationSensor.mjs";
+export {
+  n as KnockGuideLocationSensor
+};
+//# sourceMappingURL=tanstack.mjs.map

package/dist/esm/tanstack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/types/next/KnockGuideLocationSensor.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export declare const KnockGuideLocationSensor: {
+    PagesRouter: React.FC<{}>;
+    AppRouter: React.FC<{}>;
+};
+//# sourceMappingURL=KnockGuideLocationSensor.d.ts.map

package/dist/types/next/KnockGuideLocationSensor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.d.ts","sourceRoot":"","sources":["../../../src/next/KnockGuideLocationSensor.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAiE1B,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC"}

package/dist/types/next/index.d.ts

@@ -0,0 +1,2 @@
+export { KnockGuideLocationSensor } from './KnockGuideLocationSensor';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/types/tanstack/KnockGuideLocationSensor.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+export declare const KnockGuideLocationSensor: React.FC;
+//# sourceMappingURL=KnockGuideLocationSensor.d.ts.map

package/dist/types/tanstack/KnockGuideLocationSensor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockGuideLocationSensor.d.ts","sourceRoot":"","sources":["../../../src/tanstack/KnockGuideLocationSensor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAkB5C,CAAC"}

package/dist/types/tanstack/index.d.ts

@@ -0,0 +1,2 @@
+export { KnockGuideLocationSensor } from './KnockGuideLocationSensor';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/tanstack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tanstack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@knocklabs/react",
   "description": "A set of React components to build notification experiences powered by Knock",
   "author": "@knocklabs",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "license": "MIT",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.mjs",
@@ -16,6 +16,18 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/esm/index.mjs",
       "default": "./dist/cjs/index.js"
+    },
+    "./next": {
+      "require": "./dist/cjs/next.js",
+      "types": "./dist/types/next/index.d.ts",
+      "import": "./dist/esm/next.mjs",
+      "default": "./dist/cjs/next.js"
+    },
+    "./tanstack": {
+      "require": "./dist/cjs/tanstack.js",
+      "types": "./dist/types/tanstack/index.d.ts",
+      "import": "./dist/esm/tanstack.mjs",
+      "default": "./dist/cjs/tanstack.js"
     }
   },
   "files": [
@@ -46,12 +58,22 @@
     "url": "https://github.com/knocklabs/javascript/issues"
   },
   "peerDependencies": {
+    "@tanstack/react-router": "^1.0.0",
+    "next": "^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0",
     "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
     "react-dom": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@tanstack/react-router": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    }
+  },
   "dependencies": {
-    "@knocklabs/client": "^0.19.1",
-    "@knocklabs/react-core": "^0.11.1",
+    "@knocklabs/client": "^0.19.2",
+    "@knocklabs/react-core": "^0.11.2",
     "@popperjs/core": "^2.11.8",
     "@radix-ui/react-dialog": "^1.1.15",
     "@telegraph/combobox": "^0.1.16",
@@ -64,7 +86,8 @@
   },
   "devDependencies": {
     "@codecov/vite-plugin": "^1.9.1",
-    "@testing-library/dom": "^10.4.0",
+    "@tanstack/react-router": "1.134.12",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/eslint-plugin-jsx-a11y": "^6",
     "@types/lodash.debounce": "^4.0.9",
@@ -78,7 +101,8 @@
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.14",
-    "jsdom": "^27.0.0",
+    "jsdom": "^27.1.0",
+    "next": "15.3.3",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "rimraf": "^6.0.1",