@posthog/next 0.1.0 → 0.4.43

package/dist/server/getPostHog.js

@@ -1,9 +1,10 @@
 import 'server-only';
 import { isFunction } from '@posthog/core';
-import { cookies } from 'next/headers';
-import { getOrCreateNodeClient } from './nodeClientCache';
-import { readPostHogCookie, cookieStateToProperties, isOptedOut } from '../shared/cookie';
-import { resolveApiKey } from '../shared/config';
+import { cookies, headers } from 'next/headers.js';
+import { getOrCreateNodeClient } from './nodeClientCache.js';
+import { readPostHogCookie, isOptedOut } from '../shared/cookie.js';
+import { resolveApiKey, resolveHostOrDefault } from '../shared/config.js';
+import { readTracingHeaders, buildContextData } from '../shared/tracing-headers.js';
 /**
  * Returns a PostHog server client scoped to the current request.
  *
@@ -11,7 +12,7 @@ import { resolveApiKey } from '../shared/config';
  * request-scoped client. Methods like `getAllFlags()`, `getFeatureFlagResult()`,
  * and `capture()` automatically use the current user's identity.
  *
- * Calls `cookies()` internally, which opts the route into dynamic rendering.
+ * Calls `cookies()` and `headers()` internally, which opts the route into dynamic rendering.
  *
  * @param apiKey - PostHog project API key. If omitted, reads from `NEXT_PUBLIC_POSTHOG_KEY`.
  * @param options - Optional `posthog-node` configuration (e.g., `{ host: '...' }`).
@@ -31,16 +32,17 @@ import { resolveApiKey } from '../shared/config';
  */
 export async function getPostHog(apiKey, options) {
     const resolvedApiKey = resolveApiKey(apiKey);
-    const host = options?.host ?? process.env.NEXT_PUBLIC_POSTHOG_HOST;
-    const resolvedOptions = host ? { ...options, host } : options;
+    const host = resolveHostOrDefault(options?.host);
+    const resolvedOptions = { ...options, host };
     const client = await getOrCreateNodeClient(resolvedApiKey, resolvedOptions);
     const cookieStore = await cookies();
     if (isOptedOut(cookieStore, resolvedApiKey)) {
         return client;
     }
     const state = readPostHogCookie(cookieStore, resolvedApiKey);
-    const properties = cookieStateToProperties(state);
-    const contextData = { distinctId: state?.distinctId, sessionId: state?.sessionId, properties };
+    const headerStore = await headers();
+    const tracing = readTracingHeaders(headerStore);
+    const contextData = buildContextData(tracing, state);
     // Wrap the shared client in a Proxy that applies request-scoped context
     // to every method call. We can't use enterContext() here because
     // AsyncLocalStorage.enterWith() doesn't propagate back to the caller

package/dist/server/getPostHog.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPostHog.js","sourceRoot":"","sources":["../../src/server/getPostHog.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAe,EAAE,OAAiC,EAAqB;IACpG,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAA;IAClE,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;IAC3E,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAA;IAEnC,IAAI,UAAU,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAC5D,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,WAAW,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IAE9F,wEAAwE;IACxE,iEAAiE;IACjE,qEAAqE;IACrE,oDAAoD;IACpD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACrB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YAC9C,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YACjD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;YACnG,CAAC;YACD,OAAO,KAAK,CAAA;QAAA,CACf;KACJ,CAAa,CAAA;AAAA,CACjB"}
+{"version":3,"file":"getPostHog.js","sourceRoot":"","sources":["../../src/server/getPostHog.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAe,EAAE,OAAiC,EAAqB;IACpG,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAChD,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5C,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;IAC3E,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAA;IAEnC,IAAI,UAAU,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAA;IACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAC/C,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAEpD,wEAAwE;IACxE,iEAAiE;IACjE,qEAAqE;IACrE,oDAAoD;IACpD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACrB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YAC9C,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YACjD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;YACnG,CAAC;YACD,OAAO,KAAK,CAAA;QAAA,CACf;KACJ,CAAa,CAAA;AAAA,CACjB"}

package/dist/shared/config.d.ts

@@ -16,7 +16,10 @@ export type PostHogServerConfig = PostHogOptions;
  *
  * Throws if neither is available.
  */
+export declare function normalizeConfigValue(value?: unknown): string | undefined;
 export declare function resolveApiKey(apiKey?: string): string;
+export declare function resolveHost(host?: string): string | undefined;
+export declare function resolveHostOrDefault(host?: string): string;
 /**
  * Next.js-specific defaults for the posthog-js client.
  *

package/dist/shared/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAEhD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,aAAa,CAKzD,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAEhD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,aAAa,CAKzD,CAAA"}

package/dist/shared/config.js

@@ -1,16 +1,27 @@
+import { DEFAULT_API_HOST } from './constants.js';
 /**
  * Resolves the PostHog API key from an explicit value or the
  * `NEXT_PUBLIC_POSTHOG_KEY` environment variable.
  *
  * Throws if neither is available.
  */
+export function normalizeConfigValue(value) {
+    const normalizedValue = typeof value === 'string' ? value.trim() : '';
+    return normalizedValue || undefined;
+}
 export function resolveApiKey(apiKey) {
-    const resolved = apiKey || process.env.NEXT_PUBLIC_POSTHOG_KEY;
+    const resolved = normalizeConfigValue(apiKey) ?? normalizeConfigValue(process.env.NEXT_PUBLIC_POSTHOG_KEY);
     if (!resolved) {
         throw new Error('[PostHog Next.js] apiKey is required. Either pass it explicitly or set the NEXT_PUBLIC_POSTHOG_KEY environment variable.');
     }
     return resolved;
 }
+export function resolveHost(host) {
+    return normalizeConfigValue(host) ?? normalizeConfigValue(process.env.NEXT_PUBLIC_POSTHOG_HOST);
+}
+export function resolveHostOrDefault(host) {
+    return resolveHost(host) ?? DEFAULT_API_HOST;
+}
 /**
  * Next.js-specific defaults for the posthog-js client.
  *

package/dist/shared/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe,EAAU;IACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAA;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACX,0HAA0H,CAC7H,CAAA;IACL,CAAC;IACD,OAAO,QAAQ,CAAA;AAAA,CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC1D,gBAAgB,EAAE,KAAK;IACvB,WAAW,EAAE,qBAAqB;IAClC,kCAAkC,EAAE,QAAQ;IAC5C,8BAA8B,EAAE,IAAI;CACvC,CAAA"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAcjD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAe,EAAsB;IACtE,MAAM,eAAe,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACrE,OAAO,eAAe,IAAI,SAAS,CAAA;AAAA,CACtC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAU;IACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;IAC1G,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACX,0HAA0H,CAC7H,CAAA;IACL,CAAC;IACD,OAAO,QAAQ,CAAA;AAAA,CAClB;AAED,MAAM,UAAU,WAAW,CAAC,IAAa,EAAsB;IAC3D,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;AAAA,CAClG;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa,EAAU;IACxD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAA;AAAA,CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC1D,gBAAgB,EAAE,KAAK;IACvB,WAAW,EAAE,qBAAqB;IAClC,kCAAkC,EAAE,QAAQ;IAC5C,8BAA8B,EAAE,IAAI;CACvC,CAAA"}

package/dist/shared/cookie.js

@@ -1,5 +1,5 @@
 import { uuidv7, isNoLike, isArray } from '@posthog/core';
-import { COOKIE_PREFIX, COOKIE_SUFFIX } from './constants';
+import { COOKIE_PREFIX, COOKIE_SUFFIX } from './constants.js';
 /**
  * Adapts a raw `Cookie` header string into a {@link CookieStore}.
  */

package/dist/shared/cookie.js.map

@@ -1 +1 @@
-{"version":3,"file":"cookie.js","sourceRoot":"","sources":["../../src/shared/cookie.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cookie.js","sourceRoot":"","sources":["../../src/shared/cookie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAU7D;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB,EAAe;IACrE,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,IAAI,YAAY,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACnD,IAAI,GAAG,EAAE,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YACzE,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAA;AAAA,CAC7F;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAU;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACtF,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,EAAE,CAAA;AAAA,CACxD;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAU;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,SAAS,GAAG,MAAM,EAAE,CAAA;IAC1B,OAAO,IAAI,CAAC,SAAS,CAAC;QAClB,WAAW,EAAE,WAAW;QACxB,UAAU,EAAE,WAAW;QACvB,WAAW,EAAE,WAAW;QACxB,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC;KAChC,CAAC,CAAA;AAAA,CACL;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB,EAAE,MAAc,EAA6B;IAC/F,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAAA,CAC1D;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAgC,EAAsC;IAC1G,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,SAAS,CAAA;IACpB,CAAC;IACD,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClB,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAA;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAA;IACrC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAAA,CAC3D;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAA6B;IAC/E,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,IAAI,CAAA;IACf,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACtC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAA;QACf,CAAC;QAED,gFAAgF;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAEnE,OAAO;YACH,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACtC,YAAY,EAAE,MAAM,CAAC,WAAW,KAAK,YAAY;YACjD,SAAS,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACxD,QAAQ,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAClF,CAAA;IACL,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAA;IACf,CAAC;AAAA,CACJ;AAOD,MAAM,cAAc,GAAG,kBAAkB,CAAA;AAEzC,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAA4B,EAAU;IACvF,IAAI,MAAM,EAAE,wBAAwB,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,wBAAwB,CAAA;IAC1C,CAAC;IACD,IAAI,MAAM,EAAE,+BAA+B,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,+BAA+B,GAAG,MAAM,CAAA;IAC1D,CAAC;IACD,OAAO,cAAc,GAAG,MAAM,CAAA;AAAA,CACjC;AAMD,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,MAAc,EAAE,MAAsB,EAAW;IAC9F,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAEtC,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IAED,sDAAoD;IACpD,OAAO,MAAM,EAAE,4BAA4B,IAAI,KAAK,CAAA;AAAA,CACvD"}

package/dist/shared/tracing-headers.d.ts

@@ -0,0 +1,38 @@
+import type { PostHogCookieState } from './cookie.js';
+/**
+ * Header names used by the PostHog browser SDK's tracing headers feature.
+ *
+ * When `__add_tracing_headers` is enabled in the browser SDK, these headers
+ * are added to outgoing fetch/XHR requests so that server-side code can
+ * correlate events back to the browser session.
+ */
+export declare const POSTHOG_SESSION_ID_HEADER = "x-posthog-session-id";
+export declare const POSTHOG_DISTINCT_ID_HEADER = "x-posthog-distinct-id";
+export declare const POSTHOG_WINDOW_ID_HEADER = "x-posthog-window-id";
+export interface TracingHeaderValues {
+    distinctId?: string;
+    sessionId?: string;
+    windowId?: string;
+}
+/**
+ * Extracts PostHog tracing header values from request headers.
+ *
+ * Accepts either a Headers-like object with a `.get()` method (e.g. from
+ * `next/headers`) or a plain record (e.g. `ctx.req.headers` in Pages Router).
+ */
+export declare function readTracingHeaders(headers: {
+    get(name: string): string | null;
+} | Record<string, string | string[] | undefined>): TracingHeaderValues;
+/**
+ * Builds context data by merging cookie state with tracing headers.
+ *
+ * Tracing headers take precedence over cookie values for `distinctId` and
+ * `sessionId` because they represent the browser's current state and are
+ * set per-request by the browser SDK.
+ */
+export declare function buildContextData(tracing: TracingHeaderValues, state: PostHogCookieState | null): {
+    distinctId: string | undefined;
+    sessionId: string | undefined;
+    properties: Record<string, string> | undefined;
+};
+//# sourceMappingURL=tracing-headers.d.ts.map

package/dist/shared/tracing-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-headers.d.ts","sourceRoot":"","sources":["../../src/shared/tracing-headers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAC/D,eAAO,MAAM,0BAA0B,0BAA0B,CAAA;AACjE,eAAO,MAAM,wBAAwB,wBAAwB,CAAA;AAE7D,MAAM,WAAW,mBAAmB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE;IAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC9F,mBAAmB,CAcrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,kBAAkB,GAAG,IAAI,GACjC;IAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAAE,CAWnH"}

package/dist/shared/tracing-headers.js

@@ -0,0 +1,52 @@
+import { isFunction, isArray } from '@posthog/core';
+import { cookieStateToProperties } from './cookie.js';
+/**
+ * Header names used by the PostHog browser SDK's tracing headers feature.
+ *
+ * When `__add_tracing_headers` is enabled in the browser SDK, these headers
+ * are added to outgoing fetch/XHR requests so that server-side code can
+ * correlate events back to the browser session.
+ */
+export const POSTHOG_SESSION_ID_HEADER = 'x-posthog-session-id';
+export const POSTHOG_DISTINCT_ID_HEADER = 'x-posthog-distinct-id';
+export const POSTHOG_WINDOW_ID_HEADER = 'x-posthog-window-id';
+/**
+ * Extracts PostHog tracing header values from request headers.
+ *
+ * Accepts either a Headers-like object with a `.get()` method (e.g. from
+ * `next/headers`) or a plain record (e.g. `ctx.req.headers` in Pages Router).
+ */
+export function readTracingHeaders(headers) {
+    const getValue = (name) => {
+        if (isFunction(headers.get)) {
+            return headers.get(name) ?? undefined;
+        }
+        const value = headers[name];
+        return typeof value === 'string' ? value : isArray(value) ? value[0] : undefined;
+    };
+    return {
+        distinctId: getValue(POSTHOG_DISTINCT_ID_HEADER) || undefined,
+        sessionId: getValue(POSTHOG_SESSION_ID_HEADER) || undefined,
+        windowId: getValue(POSTHOG_WINDOW_ID_HEADER) || undefined,
+    };
+}
+/**
+ * Builds context data by merging cookie state with tracing headers.
+ *
+ * Tracing headers take precedence over cookie values for `distinctId` and
+ * `sessionId` because they represent the browser's current state and are
+ * set per-request by the browser SDK.
+ */
+export function buildContextData(tracing, state) {
+    const mergedProperties = {
+        ...cookieStateToProperties(state),
+        ...(tracing.sessionId ? { $session_id: tracing.sessionId } : {}),
+        ...(tracing.windowId ? { $window_id: tracing.windowId } : {}),
+    };
+    return {
+        distinctId: tracing.distinctId || state?.distinctId,
+        sessionId: tracing.sessionId || state?.sessionId,
+        properties: Object.keys(mergedProperties).length > 0 ? mergedProperties : undefined,
+    };
+}
+//# sourceMappingURL=tracing-headers.js.map

package/dist/shared/tracing-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-headers.js","sourceRoot":"","sources":["../../src/shared/tracing-headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAA;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAA;AACjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAA;AAQ7D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAC9B,OAA6F,EAC1E;IACnB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC;QACnD,IAAI,UAAU,CAAE,OAA4B,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,OAAQ,OAAgD,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;QACnF,CAAC;QACD,MAAM,KAAK,GAAI,OAAyD,CAAC,IAAI,CAAC,CAAA;QAC9E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAAA,CACnF,CAAA;IAED,OAAO;QACH,UAAU,EAAE,QAAQ,CAAC,0BAA0B,CAAC,IAAI,SAAS;QAC7D,SAAS,EAAE,QAAQ,CAAC,yBAAyB,CAAC,IAAI,SAAS;QAC3D,QAAQ,EAAE,QAAQ,CAAC,wBAAwB,CAAC,IAAI,SAAS;KAC5D,CAAA;AAAA,CACJ;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC5B,OAA4B,EAC5B,KAAgC,EACiF;IACjH,MAAM,gBAAgB,GAA2B;QAC7C,GAAG,uBAAuB,CAAC,KAAK,CAAC;QACjC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAA;IACD,OAAO;QACH,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,EAAE,UAAU;QACnD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,SAAS;QAChD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;KACtF,CAAA;AAAA,CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/next",
-  "version": "0.1.0",
+  "version": "0.4.43",
   "description": "PostHog integration for Next.js",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "author": {
     "name": "PostHog",
-    "email": "hey@posthog.com",
+    "email": "engineering@posthog.com",
     "url": "https://posthog.com"
   },
   "type": "module",
@@ -33,6 +33,11 @@
     },
     "./pages": {
       "types": "./dist/pages.d.ts",
+      "edge-light": "./dist/pages.edge.js",
+      "edge": "./dist/pages.edge.js",
+      "worker": "./dist/pages.edge.js",
+      "browser": "./dist/pages.client.js",
+      "react-server": "./dist/pages.js",
       "default": "./dist/pages.js"
     }
   },
@@ -45,9 +50,10 @@
   ],
   "dependencies": {
     "server-only": "^0.0.1",
-    "@posthog/core": "1.23.2",
-    "posthog-js": "1.359.1",
-    "posthog-node": "5.28.0"
+    "@posthog/core": "1.28.3",
+    "posthog-js": "1.372.9",
+    "posthog-node": "5.33.3",
+    "@posthog/react": "1.9.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
@@ -78,8 +84,9 @@
   },
   "scripts": {
     "clean": "rimraf dist",
-    "build": "tsgo -p tsconfig.build.json",
+    "build": "tsgo -p tsconfig.build.json && pnpm check:esm-specifiers",
     "dev": "tsgo -p tsconfig.build.json --watch",
+    "check:esm-specifiers": "node ./scripts/check-relative-esm-specifiers.mjs",
     "test:unit": "jest",
     "test": "pnpm test:unit",
     "lint": "eslint src",

package/src/app/PostHogProvider.tsx

@@ -1,12 +1,12 @@
 import React from 'react'
 import type { PostHogConfig } from 'posthog-js'
-import { ClientPostHogProvider } from '../client/ClientPostHogProvider'
-import type { BootstrapConfig } from '../client/ClientPostHogProvider'
-import { cookies } from 'next/headers'
+import { ClientPostHogProvider } from '../client/ClientPostHogProvider.js'
+import type { BootstrapConfig } from '../client/ClientPostHogProvider.js'
+import { cookies } from 'next/headers.js'
 import type { PostHogOptions } from 'posthog-node'
-import { getOrCreateNodeClient } from '../server/nodeClientCache'
-import { NEXTJS_CLIENT_DEFAULTS, resolveApiKey } from '../shared/config'
-import { readPostHogCookie, isOptedOut } from '../shared/cookie'
+import { getOrCreateNodeClient } from '../server/nodeClientCache.js'
+import { NEXTJS_CLIENT_DEFAULTS, resolveApiKey, resolveHostOrDefault } from '../shared/config.js'
+import { readPostHogCookie, isOptedOut } from '../shared/cookie.js'
 
 type AllFlagsOptions = {
     groups?: Record<string, string>
@@ -82,7 +82,7 @@ export async function PostHogProvider({
         )
     }
 
-    const host = clientOptions?.api_host ?? process.env.NEXT_PUBLIC_POSTHOG_HOST
+    const host = resolveHostOrDefault(clientOptions?.api_host)
     const resolvedOptions: Partial<PostHogConfig> = {
         ...NEXTJS_CLIENT_DEFAULTS,
         ...clientOptions,
@@ -131,7 +131,7 @@ async function evaluateFlags(
         return undefined
     }
 
-    const host = serverOptions?.host ?? process.env.NEXT_PUBLIC_POSTHOG_HOST
+    const host = resolveHostOrDefault(serverOptions?.host)
     const nodeOptions: Partial<PostHogOptions> = { ...serverOptions, ...(host ? { host } : {}) }
     const client = await getOrCreateNodeClient(apiKey, nodeOptions)
 

package/src/client/ClientPostHogProvider.tsx

@@ -2,7 +2,7 @@
 
 import React from 'react'
 import posthogJs from 'posthog-js'
-import { PostHogProvider as ReactPostHogProvider } from 'posthog-js/react'
+import { PostHogContext } from '@posthog/react'
 import type { BootstrapConfig, PostHogConfig } from 'posthog-js'
 
 export type { BootstrapConfig }
@@ -47,5 +47,5 @@ export function ClientPostHogProvider({ apiKey, options, bootstrap, children }:
         posthogJs.init(apiKey, mergedOptions)
     }
 
-    return <ReactPostHogProvider client={posthogJs}>{children}</ReactPostHogProvider>
+    return <PostHogContext.Provider value={{ client: posthogJs, bootstrap }}>{children}</PostHogContext.Provider>
 }

package/src/client/PostHogPageView.tsx

@@ -1,8 +1,8 @@
 'use client'
 
 import { Suspense, useEffect } from 'react'
-import { usePathname, useSearchParams } from 'next/navigation'
-import { usePostHog } from 'posthog-js/react'
+import { usePathname, useSearchParams } from 'next/navigation.js'
+import { usePostHog } from '@posthog/react'
 
 /**
  * Tracks pageviews on route change in Next.js App Router.

package/src/client/hooks.ts

@@ -5,4 +5,4 @@ export {
     useFeatureFlagResult as useFeatureFlag,
     useActiveFeatureFlags,
     PostHogFeature,
-} from 'posthog-js/react'
+} from '@posthog/react'

package/src/index.client.ts

@@ -1,9 +1,9 @@
 // Browser-safe exports. PostHogProvider (a server component) is excluded
 // because it imports posthog-node which uses Node.js APIs.
-export { PostHogPageView } from './client/PostHogPageView'
-export { DEFAULT_INGEST_PATH } from './shared/constants'
-export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks'
+export { PostHogPageView } from './client/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks.js'
 
 // Re-export types (type-only, erased at build time)
-export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider'
-export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware'
+export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'

package/src/index.edge.ts

@@ -1,10 +1,10 @@
 // Edge-runtime exports (middleware). Excludes PostHogProvider and
 // posthog-node which require Node.js APIs.
-export { postHogMiddleware } from './middleware/postHogMiddleware'
-export { PostHogPageView } from './client/PostHogPageView'
-export { DEFAULT_INGEST_PATH } from './shared/constants'
-export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks'
+export { postHogMiddleware } from './middleware/postHogMiddleware.js'
+export { PostHogPageView } from './client/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks.js'
 
 // Re-export types (type-only, erased at build time)
-export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider'
-export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware'
+export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'

package/src/index.react-server.ts

@@ -1,7 +1,7 @@
 // Server component exports (only available in react-server context)
-export { PostHogProvider } from './app/PostHogProvider'
-export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider'
+export { PostHogProvider } from './app/PostHogProvider.js'
+export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider.js'
 
 // Client-safe exports (re-exported so server components can also import them)
-export { PostHogPageView } from './client/PostHogPageView'
-export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks'
+export { PostHogPageView } from './client/PostHogPageView.js'
+export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks.js'

package/src/index.ts

@@ -1,8 +1,8 @@
-export { PostHogProvider } from './app/PostHogProvider'
-export { getPostHog } from './server/getPostHog'
-export { postHogMiddleware } from './middleware/postHogMiddleware'
-export { PostHogPageView } from './client/PostHogPageView'
-export { DEFAULT_INGEST_PATH } from './shared/constants'
-export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks'
-export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider'
-export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware'
+export { PostHogProvider } from './app/PostHogProvider.js'
+export { getPostHog } from './server/getPostHog.js'
+export { postHogMiddleware } from './middleware/postHogMiddleware.js'
+export { PostHogPageView } from './client/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export { usePostHog, useFeatureFlag, useActiveFeatureFlags, PostHogFeature } from './client/hooks.js'
+export type { PostHogProviderProps, BootstrapFlagsConfig } from './app/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'

package/src/middleware/postHogMiddleware.ts

@@ -1,11 +1,11 @@
 import 'server-only'
 
-import { NextResponse } from 'next/server'
-import type { NextRequest } from 'next/server'
-import { getPostHogCookieName, readPostHogCookie, serializePostHogCookie, isOptedOut } from '../shared/cookie'
-import { generateAnonymousId } from '../shared/identity'
-import { resolveApiKey } from '../shared/config'
-import { COOKIE_MAX_AGE_SECONDS, DEFAULT_API_HOST, DEFAULT_INGEST_PATH } from '../shared/constants'
+import { NextResponse } from 'next/server.js'
+import type { NextRequest } from 'next/server.js'
+import { getPostHogCookieName, readPostHogCookie, serializePostHogCookie, isOptedOut } from '../shared/cookie.js'
+import { generateAnonymousId } from '../shared/identity.js'
+import { resolveApiKey, resolveHostOrDefault } from '../shared/config.js'
+import { COOKIE_MAX_AGE_SECONDS, DEFAULT_INGEST_PATH } from '../shared/constants.js'
 
 export interface PostHogProxyOptions {
     /** Path prefix to intercept. Default: '/ingest'. */
@@ -43,10 +43,17 @@ export interface PostHogMiddlewareOptions {
      */
     response?: NextResponse
     /**
-     * When true, skips cookie seeding when no consent cookie is present.
-     * Mirrors the client-side `opt_out_capturing_by_default` option.
+     * Whether the middleware seeds the anonymous identity cookie on first visit.
+     *
+     * When `true` (the default), the middleware generates a UUIDv7 anonymous ID
+     * and sets the `ph_<key>_posthog` cookie on the first request so that server
+     * and client share the same identity from the first render.
+     *
+     * Set to `false` if you need user consent before setting any cookies. The
+     * middleware will not set the cookie and it will only be created by the
+     * client SDK.
      */
-    optOutByDefault?: boolean
+    seedAnonymousCookie?: boolean
     /**
      * Custom name for the consent cookie.
      * Mirrors the client-side `consent_persistence_name` option.
@@ -87,7 +94,7 @@ function resolveProxyConfig(proxy: boolean | PostHogProxyOptions | undefined): R
     const prefix = options.pathPrefix ?? DEFAULT_INGEST_PATH
     return {
         pathPrefix: prefix.startsWith('/') ? prefix : `/${prefix}`,
-        host: options.host ?? DEFAULT_API_HOST,
+        host: resolveHostOrDefault(options.host),
     }
 }
 
@@ -139,8 +146,9 @@ export function postHogMiddleware(config: PostHogMiddlewareOptions = {}) {
         const state = readPostHogCookie(request.cookies, apiKey)
         const response = config.response ?? NextResponse.next()
 
+        const shouldSeed = config.seedAnonymousCookie ?? true
         const optedOut = isOptedOut(request.cookies, apiKey, {
-            opt_out_capturing_by_default: config.optOutByDefault,
+            opt_out_capturing_by_default: !shouldSeed,
             consent_persistence_name: config.consentCookieName,
             opt_out_capturing_cookie_prefix: config.consentCookiePrefix,
         })

package/src/pages/PostHogPageView.tsx

@@ -1,6 +1,6 @@
 import { useEffect } from 'react'
-import { useRouter } from 'next/router'
-import { usePostHog } from 'posthog-js/react'
+import { useRouter } from 'next/router.js'
+import { usePostHog } from '@posthog/react'
 
 /**
  * Tracks pageviews on route change in Next.js Pages Router.

package/src/pages/PostHogProvider.tsx

@@ -1,7 +1,7 @@
 import React from 'react'
 import type { PostHogConfig, BootstrapConfig } from 'posthog-js'
-import { ClientPostHogProvider } from '../client/ClientPostHogProvider'
-import { NEXTJS_CLIENT_DEFAULTS, resolveApiKey } from '../shared/config'
+import { ClientPostHogProvider } from '../client/ClientPostHogProvider.js'
+import { NEXTJS_CLIENT_DEFAULTS, resolveApiKey, resolveHostOrDefault } from '../shared/config.js'
 
 export interface PagesPostHogProviderProps {
     /**
@@ -46,7 +46,7 @@ export function PostHogProvider({ apiKey: apiKeyProp, clientOptions, bootstrap,
         )
     }
 
-    const host = clientOptions?.api_host ?? process.env.NEXT_PUBLIC_POSTHOG_HOST
+    const host = resolveHostOrDefault(clientOptions?.api_host)
     const resolvedOptions: Partial<PostHogConfig> = {
         ...NEXTJS_CLIENT_DEFAULTS,
         ...clientOptions,

package/src/pages/getServerSidePostHog.ts

@@ -1,8 +1,9 @@
 import type { GetServerSidePropsContext } from 'next'
 import type { PostHogOptions, IPostHog } from 'posthog-node'
-import { getOrCreateNodeClient } from '../server/nodeClientCache'
-import { cookieStoreFromHeader, readPostHogCookie, cookieStateToProperties, isOptedOut } from '../shared/cookie'
-import { resolveApiKey } from '../shared/config'
+import { getOrCreateNodeClient } from '../server/nodeClientCache.js'
+import { cookieStoreFromHeader, readPostHogCookie, isOptedOut } from '../shared/cookie.js'
+import { resolveApiKey, resolveHostOrDefault } from '../shared/config.js'
+import { readTracingHeaders, buildContextData } from '../shared/tracing-headers.js'
 
 /**
  * Creates a PostHog server client scoped to the current request.
@@ -33,16 +34,16 @@ export async function getServerSidePostHog(
     options?: Partial<PostHogOptions>
 ): Promise<IPostHog> {
     const resolvedApiKey = resolveApiKey(apiKey)
-    const host = options?.host ?? process.env.NEXT_PUBLIC_POSTHOG_HOST
-    const resolvedOptions = host ? { ...options, host } : options
+    const host = resolveHostOrDefault(options?.host)
+    const resolvedOptions = { ...options, host }
     const client = await getOrCreateNodeClient(resolvedApiKey, resolvedOptions)
 
     const cookieStore = cookieStoreFromHeader(ctx.req.headers.cookie || '')
 
     if (!isOptedOut(cookieStore, resolvedApiKey)) {
         const state = readPostHogCookie(cookieStore, resolvedApiKey)
-        const properties = cookieStateToProperties(state)
-        client.enterContext({ distinctId: state?.distinctId, sessionId: state?.sessionId, properties })
+        const tracing = readTracingHeaders(ctx.req.headers)
+        client.enterContext(buildContextData(tracing, state))
     }
 
     return client

package/src/pages.client.ts

@@ -0,0 +1,9 @@
+// Client-runtime barrel for the `./pages` subpath. Resolved by Next.js's
+// `browser` exports condition. Excludes `getPostHog`, `getServerSidePostHog`,
+// and `postHogMiddleware`, which import `server-only` or `posthog-node` and
+// must not be reachable from a client bundle.
+export { PostHogProvider } from './pages/PostHogProvider.js'
+export { PostHogPageView } from './pages/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export type { PagesPostHogProviderProps } from './pages/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'

package/src/pages.edge.ts

@@ -0,0 +1,10 @@
+// Edge-runtime barrel for the `./pages` subpath. Resolved by Next.js's
+// `edge-light`, `edge`, and `worker` exports conditions. Excludes
+// `getPostHog` and `getServerSidePostHog` which require Node.js APIs
+// (via `posthog-node`) that aren't available in the Edge runtime.
+export { PostHogProvider } from './pages/PostHogProvider.js'
+export { postHogMiddleware } from './middleware/postHogMiddleware.js'
+export { PostHogPageView } from './pages/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export type { PagesPostHogProviderProps } from './pages/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'

package/src/pages.ts

@@ -1,8 +1,8 @@
-export { PostHogProvider } from './pages/PostHogProvider'
-export { getServerSidePostHog } from './pages/getServerSidePostHog'
-export { getPostHog } from './server/getPostHog'
-export { postHogMiddleware } from './middleware/postHogMiddleware'
-export { PostHogPageView } from './pages/PostHogPageView'
-export { DEFAULT_INGEST_PATH } from './shared/constants'
-export type { PagesPostHogProviderProps } from './pages/PostHogProvider'
-export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware'
+export { PostHogProvider } from './pages/PostHogProvider.js'
+export { getServerSidePostHog } from './pages/getServerSidePostHog.js'
+export { getPostHog } from './server/getPostHog.js'
+export { postHogMiddleware } from './middleware/postHogMiddleware.js'
+export { PostHogPageView } from './pages/PostHogPageView.js'
+export { DEFAULT_INGEST_PATH } from './shared/constants.js'
+export type { PagesPostHogProviderProps } from './pages/PostHogProvider.js'
+export type { PostHogMiddlewareOptions, PostHogProxyOptions } from './middleware/postHogMiddleware.js'