@aranova/tracking-next 0.16.0 → 0.16.1

package/README.md

@@ -23,12 +23,32 @@ export const config = {
 };
 ```
 
+**Next 16:** the `middleware` file convention is deprecated in favor of `proxy`.
+`createTrackingMiddleware()` returns a convention-agnostic handler, so no code change is
+needed — just rename the file to `proxy.ts` and keep the same default export and `config`:
+
+```ts
+// proxy.ts
+import { createTrackingMiddleware } from "@aranova/tracking-next/middleware";
+
+export default createTrackingMiddleware();
+
+export const config = {
+  matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
+};
+```
+
+`middleware.ts` still works during the transition; use `proxy.ts` on Next 16+ to silence the
+deprecation warning.
+
 ## Provider
 
 Create one shared tracking module and use its scoped exports throughout your app.
 
 ```ts
 // lib/tracking.ts
+"use client";
+
 import { createTracking } from "@aranova/tracking-next";
 
 export const { TrackingProvider, useTracking } = createTracking({
@@ -75,6 +95,15 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 }
 ```
 
+`lib/tracking.ts` needs the `"use client"` directive above because `createTracking()`
+creates React context — the module that calls it is a Client Component. Your root layout
+stays a Server Component and just renders the client `<TrackingProvider>`.
+
+**No consumer `<Suspense>` boundary is required.** The provider reads `useSearchParams()`
+only inside its own internal `<Suspense>` boundary, so it never opts the enclosing route out
+of static prerendering. A fully static page (including one with `export const dynamic = 'error'`)
+builds cleanly and stays `○ (Static)` with `<TrackingProvider>` in the root layout.
+
 Tracking is on by default (consent v2, opt-out model) — no banner. Add a footer
 "cookie preferences" control built on `useCookiePreferences()` (see **Consent** below)
 and disclose the tracking + opt-out in the site's privacy policy.

package/dist/index.js

@@ -2604,7 +2604,7 @@ function GoogleAdsTracking(props) {
 var import_navigation = require("next/navigation");
 
 // package.json
-var version = "0.16.0";
+var version = "0.16.1";
 
 // src/factory.tsx
 var import_react4 = require("react");
@@ -2697,6 +2697,14 @@ var PhoneField = (0, import_react3.forwardRef)(function PhoneField2({ country, v
 
 // src/factory.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
+function PageViewTracker({ fire }) {
+  const pathname = (0, import_navigation.usePathname)();
+  const searchParams = (0, import_navigation.useSearchParams)();
+  (0, import_react4.useEffect)(() => {
+    fire();
+  }, [pathname, searchParams, fire]);
+  return null;
+}
 function createTracking(options) {
   const { apiKey, endpoint, triggers, environment, gtagIds, debug, phone, conversionConfig } = options;
   if (!apiKey || !endpoint) {
@@ -2723,7 +2731,6 @@ function createTracking(options) {
   const timeOnSiteConfig = triggers.automatic.time_on_site ?? null;
   function TrackingProvider({ children }) {
     const pathname = (0, import_navigation.usePathname)();
-    const searchParams = (0, import_navigation.useSearchParams)();
     const client = (0, import_react4.useMemo)(
       () => createTypedClient(
         getOrCreateTrackingClient({
@@ -2753,7 +2760,7 @@ function createTracking(options) {
       const autoFire = conversionStore ? createConversionAutoFire(conversionStore) : null;
       return (c) => autoFire ? withConversionAutoFire(c, autoFire) : c;
     }, [conversionStore]);
-    (0, import_react4.useEffect)(() => {
+    const firePageView = (0, import_react4.useCallback)(() => {
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -2765,7 +2772,7 @@ function createTracking(options) {
         debug
       });
       fireManualPageView(wrapClient(rawClient));
-    }, [pathname, searchParams]);
+    }, [wrapClient]);
     const firedPagesRef = (0, import_react4.useRef)(/* @__PURE__ */ new Set());
     (0, import_react4.useEffect)(() => {
       if (!specificPageVisitConfig || pathname === null) return;
@@ -2904,7 +2911,10 @@ function createTracking(options) {
         }
       };
     }, []);
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PhoneConfigProvider, { value: phone ?? null, children }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(TrackingContext.Provider, { value: client, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react4.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PageViewTracker, { fire: firePageView }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PhoneConfigProvider, { value: phone ?? null, children })
+    ] });
   }
   function useTracking() {
     const client = (0, import_react4.useContext)(TrackingContext);