@posthog/next 0.4.47 → 0.4.49

package/dist/shared/constants.d.ts

@@ -1,5 +1,3 @@
-export declare const COOKIE_PREFIX = "ph_";
-export declare const COOKIE_SUFFIX = "_posthog";
 export declare const DEFAULT_API_HOST = "https://us.i.posthog.com";
 export declare const COOKIE_MAX_AGE_SECONDS: number;
 export declare const DEFAULT_INGEST_PATH = "/ingest";

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,QAAQ,CAAA;AAClC,eAAO,MAAM,aAAa,aAAa,CAAA;AACvC,eAAO,MAAM,gBAAgB,6BAA6B,CAAA;AAC1D,eAAO,MAAM,sBAAsB,QAAqB,CAAA;AACxD,eAAO,MAAM,mBAAmB,YAAY,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,6BAA6B,CAAA;AAC1D,eAAO,MAAM,sBAAsB,QAAqB,CAAA;AACxD,eAAO,MAAM,mBAAmB,YAAY,CAAA"}

package/dist/shared/constants.js

@@ -1,5 +1,3 @@
-export const COOKIE_PREFIX = 'ph_';
-export const COOKIE_SUFFIX = '_posthog';
 export const DEFAULT_API_HOST = 'https://us.i.posthog.com';
 export const COOKIE_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
 export const DEFAULT_INGEST_PATH = '/ingest';

package/dist/shared/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAA;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAA;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAA;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA"}

package/dist/shared/cookie.d.ts

@@ -1,69 +1,3 @@
-/**
- * Minimal cookie-reading interface compatible with Next.js `cookies()`,
- * `request.cookies`, and plain objects.
- */
-export interface CookieStore {
-    get(name: string): {
-        value: string;
-    } | undefined;
-}
-/**
- * Adapts a raw `Cookie` header string into a {@link CookieStore}.
- */
-export declare function cookieStoreFromHeader(cookieHeader: string): CookieStore;
-export interface PostHogCookieState {
-    distinctId: string;
-    isIdentified: boolean;
-    sessionId?: string;
-    deviceId?: string;
-}
-/**
- * Returns the PostHog cookie name for the given API key.
- *
- * PostHog-js stores state in a cookie named `ph_<sanitized_token>_posthog`.
- * The token is sanitized by replacing `+` with `PL`, `/` with `SL`, `=` with `EQ`.
- *
- * @param apiKey - The PostHog project API key
- * @returns The cookie name string
- */
-export declare function getPostHogCookieName(apiKey: string): string;
-/**
- * Serializes an anonymous ID into the JSON format posthog-js expects.
- *
- * When `distinct_id === $device_id`, posthog-js treats the user as anonymous.
- *
- * @param anonymousId - The anonymous distinct ID to serialize
- * @returns JSON string suitable for the PostHog cookie value
- */
-export declare function serializePostHogCookie(anonymousId: string): string;
-/**
- * Reads and parses the PostHog cookie from a cookie store.
- *
- * Compatible with Next.js `cookies()`, `request.cookies`, and any object
- * with a `get(name)` method that returns `{ value: string } | undefined`.
- */
-export declare function readPostHogCookie(cookies: CookieStore, apiKey: string): PostHogCookieState | null;
-/**
- * Converts cookie state into PostHog properties (e.g. `$session_id`, `$device_id`).
- */
-export declare function cookieStateToProperties(state: PostHogCookieState | null): Record<string, string> | undefined;
-/**
- * Parses a PostHog cookie value and extracts identity information.
- *
- * The cookie value is a JSON object containing `distinct_id` and `$user_state`.
- * A user is considered identified if `$user_state` is `'identified'`.
- *
- * @param cookieValue - The raw cookie string value
- * @returns Parsed identity state, or null if the cookie is missing/invalid
- */
-export declare function parsePostHogCookie(cookieValue: string): PostHogCookieState | null;
-export interface ConsentCookieConfig {
-    consent_persistence_name?: string | null;
-    opt_out_capturing_cookie_prefix?: string | null;
-}
-export declare function getConsentCookieName(apiKey: string, config?: ConsentCookieConfig): string;
-export interface ConsentConfig extends ConsentCookieConfig {
-    opt_out_capturing_by_default?: boolean;
-}
-export declare function isOptedOut(cookies: CookieStore, apiKey: string, config?: ConsentConfig): boolean;
+export { cookieStateToProperties, cookieStoreFromHeader, getConsentCookieName, getPostHogCookieName, isOptedOut, parsePostHogCookie, readPostHogCookie, serializePostHogCookie, } from '@posthog/core';
+export type { ConsentConfig, ConsentCookieConfig, CookieStore, PostHogCookieState } from '@posthog/core';
 //# sourceMappingURL=cookie.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/shared/cookie.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAWvE;AAED,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CASlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAIjG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAY5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAuBjF;AAED,MAAM,WAAW,mBAAmB;IAChC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,+BAA+B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAClD;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAQzF;AAED,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD,4BAA4B,CAAC,EAAE,OAAO,CAAA;CACzC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAUhG"}
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/shared/cookie.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/shared/cookie.js

@@ -1,126 +1,6 @@
-import { uuidv7, isNoLike, isArray } from '@posthog/core';
-import { COOKIE_PREFIX, COOKIE_SUFFIX } from './constants.js';
-/**
- * Adapts a raw `Cookie` header string into a {@link CookieStore}.
- */
-export function cookieStoreFromHeader(cookieHeader) {
-    const cookies = {};
-    if (cookieHeader) {
-        for (const pair of cookieHeader.split(';')) {
-            const [key, ...valueParts] = pair.trim().split('=');
-            if (key) {
-                cookies[key.trim()] = decodeURIComponent(valueParts.join('=').trim());
-            }
-        }
-    }
-    return { get: (name) => (name in cookies ? { value: cookies[name] } : undefined) };
-}
-/**
- * Returns the PostHog cookie name for the given API key.
- *
- * PostHog-js stores state in a cookie named `ph_<sanitized_token>_posthog`.
- * The token is sanitized by replacing `+` with `PL`, `/` with `SL`, `=` with `EQ`.
- *
- * @param apiKey - The PostHog project API key
- * @returns The cookie name string
- */
-export function getPostHogCookieName(apiKey) {
-    const sanitized = apiKey.replace(/\+/g, 'PL').replace(/\//g, 'SL').replace(/=/g, 'EQ');
-    return `${COOKIE_PREFIX}${sanitized}${COOKIE_SUFFIX}`;
-}
-/**
- * Serializes an anonymous ID into the JSON format posthog-js expects.
- *
- * When `distinct_id === $device_id`, posthog-js treats the user as anonymous.
- *
- * @param anonymousId - The anonymous distinct ID to serialize
- * @returns JSON string suitable for the PostHog cookie value
- */
-export function serializePostHogCookie(anonymousId) {
-    const now = Date.now();
-    const sessionId = uuidv7();
-    return JSON.stringify({
-        distinct_id: anonymousId,
-        $device_id: anonymousId,
-        $user_state: 'anonymous',
-        $sesid: [now, sessionId, now],
-    });
-}
-/**
- * Reads and parses the PostHog cookie from a cookie store.
- *
- * Compatible with Next.js `cookies()`, `request.cookies`, and any object
- * with a `get(name)` method that returns `{ value: string } | undefined`.
- */
-export function readPostHogCookie(cookies, apiKey) {
-    const cookieName = getPostHogCookieName(apiKey);
-    const cookie = cookies.get(cookieName);
-    return cookie ? parsePostHogCookie(cookie.value) : null;
-}
-/**
- * Converts cookie state into PostHog properties (e.g. `$session_id`, `$device_id`).
- */
-export function cookieStateToProperties(state) {
-    if (!state) {
-        return undefined;
-    }
-    const props = {};
-    if (state.sessionId) {
-        props.$session_id = state.sessionId;
-    }
-    if (state.deviceId) {
-        props.$device_id = state.deviceId;
-    }
-    return Object.keys(props).length > 0 ? props : undefined;
-}
-/**
- * Parses a PostHog cookie value and extracts identity information.
- *
- * The cookie value is a JSON object containing `distinct_id` and `$user_state`.
- * A user is considered identified if `$user_state` is `'identified'`.
- *
- * @param cookieValue - The raw cookie string value
- * @returns Parsed identity state, or null if the cookie is missing/invalid
- */
-export function parsePostHogCookie(cookieValue) {
-    if (!cookieValue) {
-        return null;
-    }
-    try {
-        const parsed = JSON.parse(cookieValue);
-        if (!parsed || typeof parsed !== 'object' || !parsed.distinct_id) {
-            return null;
-        }
-        // $sesid is stored as [lastActivityTimestamp, sessionId, sessionStartTimestamp]
-        const sesid = isArray(parsed.$sesid) ? parsed.$sesid[1] : undefined;
-        return {
-            distinctId: String(parsed.distinct_id),
-            isIdentified: parsed.$user_state === 'identified',
-            sessionId: typeof sesid === 'string' ? sesid : undefined,
-            deviceId: typeof parsed.$device_id === 'string' ? parsed.$device_id : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-const CONSENT_PREFIX = '__ph_opt_in_out_';
-export function getConsentCookieName(apiKey, config) {
-    if (config?.consent_persistence_name) {
-        return config.consent_persistence_name;
-    }
-    if (config?.opt_out_capturing_cookie_prefix) {
-        return config.opt_out_capturing_cookie_prefix + apiKey;
-    }
-    return CONSENT_PREFIX + apiKey;
-}
-export function isOptedOut(cookies, apiKey, config) {
-    const cookieName = getConsentCookieName(apiKey, config);
-    const cookie = cookies.get(cookieName);
-    if (cookie) {
-        return isNoLike(cookie.value);
-    }
-    // No consent cookie means pending — defer to config
-    return config?.opt_out_capturing_by_default ?? false;
-}
+// Cookie helpers were lifted to `@posthog/core` so all SDKs (posthog-node,
+// posthog-js-lite, etc.) can share them. This module re-exports the public
+// surface for any internal `@posthog/next` imports — keep using these from
+// `./shared/cookie` within next/, or import directly from `@posthog/core`.
+export { cookieStateToProperties, cookieStoreFromHeader, getConsentCookieName, getPostHogCookieName, isOptedOut, parsePostHogCookie, readPostHogCookie, serializePostHogCookie, } from '@posthog/core';
 //# sourceMappingURL=cookie.js.map

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,2EAA2E;AAC3E,2EAA2E;AAC3E,6EAA2E;AAC3E,2EAA2E;AAC3E,OAAO,EACH,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,eAAe,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/next",
-  "version": "0.4.47",
+  "version": "0.4.49",
   "description": "PostHog integration for Next.js",
   "repository": {
     "type": "git",
@@ -50,10 +50,10 @@
   ],
   "dependencies": {
     "server-only": "^0.0.1",
-    "@posthog/core": "1.28.7",
+    "@posthog/core": "1.29.1",
     "@posthog/react": "1.9.0",
-    "posthog-node": "5.33.7",
-    "posthog-js": "1.373.2"
+    "posthog-node": "5.34.1",
+    "posthog-js": "1.373.4"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",

package/src/shared/constants.ts

@@ -1,5 +1,3 @@
-export const COOKIE_PREFIX = 'ph_'
-export const COOKIE_SUFFIX = '_posthog'
 export const DEFAULT_API_HOST = 'https://us.i.posthog.com'
 export const COOKIE_MAX_AGE_SECONDS = 365 * 24 * 60 * 60
 export const DEFAULT_INGEST_PATH = '/ingest'

package/src/shared/cookie.ts

@@ -1,162 +1,15 @@
-import { uuidv7, isNoLike, isArray } from '@posthog/core'
-import { COOKIE_PREFIX, COOKIE_SUFFIX } from './constants.js'
-
-/**
- * Minimal cookie-reading interface compatible with Next.js `cookies()`,
- * `request.cookies`, and plain objects.
- */
-export interface CookieStore {
-    get(name: string): { value: string } | undefined
-}
-
-/**
- * Adapts a raw `Cookie` header string into a {@link CookieStore}.
- */
-export function cookieStoreFromHeader(cookieHeader: string): CookieStore {
-    const cookies: Record<string, string> = {}
-    if (cookieHeader) {
-        for (const pair of cookieHeader.split(';')) {
-            const [key, ...valueParts] = pair.trim().split('=')
-            if (key) {
-                cookies[key.trim()] = decodeURIComponent(valueParts.join('=').trim())
-            }
-        }
-    }
-    return { get: (name: string) => (name in cookies ? { value: cookies[name] } : undefined) }
-}
-
-export interface PostHogCookieState {
-    distinctId: string
-    isIdentified: boolean
-    sessionId?: string
-    deviceId?: string
-}
-
-/**
- * Returns the PostHog cookie name for the given API key.
- *
- * PostHog-js stores state in a cookie named `ph_<sanitized_token>_posthog`.
- * The token is sanitized by replacing `+` with `PL`, `/` with `SL`, `=` with `EQ`.
- *
- * @param apiKey - The PostHog project API key
- * @returns The cookie name string
- */
-export function getPostHogCookieName(apiKey: string): string {
-    const sanitized = apiKey.replace(/\+/g, 'PL').replace(/\//g, 'SL').replace(/=/g, 'EQ')
-    return `${COOKIE_PREFIX}${sanitized}${COOKIE_SUFFIX}`
-}
-
-/**
- * Serializes an anonymous ID into the JSON format posthog-js expects.
- *
- * When `distinct_id === $device_id`, posthog-js treats the user as anonymous.
- *
- * @param anonymousId - The anonymous distinct ID to serialize
- * @returns JSON string suitable for the PostHog cookie value
- */
-export function serializePostHogCookie(anonymousId: string): string {
-    const now = Date.now()
-    const sessionId = uuidv7()
-    return JSON.stringify({
-        distinct_id: anonymousId,
-        $device_id: anonymousId,
-        $user_state: 'anonymous',
-        $sesid: [now, sessionId, now],
-    })
-}
-
-/**
- * Reads and parses the PostHog cookie from a cookie store.
- *
- * Compatible with Next.js `cookies()`, `request.cookies`, and any object
- * with a `get(name)` method that returns `{ value: string } | undefined`.
- */
-export function readPostHogCookie(cookies: CookieStore, apiKey: string): PostHogCookieState | null {
-    const cookieName = getPostHogCookieName(apiKey)
-    const cookie = cookies.get(cookieName)
-    return cookie ? parsePostHogCookie(cookie.value) : null
-}
-
-/**
- * Converts cookie state into PostHog properties (e.g. `$session_id`, `$device_id`).
- */
-export function cookieStateToProperties(state: PostHogCookieState | null): Record<string, string> | undefined {
-    if (!state) {
-        return undefined
-    }
-    const props: Record<string, string> = {}
-    if (state.sessionId) {
-        props.$session_id = state.sessionId
-    }
-    if (state.deviceId) {
-        props.$device_id = state.deviceId
-    }
-    return Object.keys(props).length > 0 ? props : undefined
-}
-
-/**
- * Parses a PostHog cookie value and extracts identity information.
- *
- * The cookie value is a JSON object containing `distinct_id` and `$user_state`.
- * A user is considered identified if `$user_state` is `'identified'`.
- *
- * @param cookieValue - The raw cookie string value
- * @returns Parsed identity state, or null if the cookie is missing/invalid
- */
-export function parsePostHogCookie(cookieValue: string): PostHogCookieState | null {
-    if (!cookieValue) {
-        return null
-    }
-
-    try {
-        const parsed = JSON.parse(cookieValue)
-        if (!parsed || typeof parsed !== 'object' || !parsed.distinct_id) {
-            return null
-        }
-
-        // $sesid is stored as [lastActivityTimestamp, sessionId, sessionStartTimestamp]
-        const sesid = isArray(parsed.$sesid) ? parsed.$sesid[1] : undefined
-
-        return {
-            distinctId: String(parsed.distinct_id),
-            isIdentified: parsed.$user_state === 'identified',
-            sessionId: typeof sesid === 'string' ? sesid : undefined,
-            deviceId: typeof parsed.$device_id === 'string' ? parsed.$device_id : undefined,
-        }
-    } catch {
-        return null
-    }
-}
-
-export interface ConsentCookieConfig {
-    consent_persistence_name?: string | null
-    opt_out_capturing_cookie_prefix?: string | null
-}
-
-const CONSENT_PREFIX = '__ph_opt_in_out_'
-
-export function getConsentCookieName(apiKey: string, config?: ConsentCookieConfig): string {
-    if (config?.consent_persistence_name) {
-        return config.consent_persistence_name
-    }
-    if (config?.opt_out_capturing_cookie_prefix) {
-        return config.opt_out_capturing_cookie_prefix + apiKey
-    }
-    return CONSENT_PREFIX + apiKey
-}
-
-export interface ConsentConfig extends ConsentCookieConfig {
-    opt_out_capturing_by_default?: boolean
-}
-
-export function isOptedOut(cookies: CookieStore, apiKey: string, config?: ConsentConfig): boolean {
-    const cookieName = getConsentCookieName(apiKey, config)
-    const cookie = cookies.get(cookieName)
-
-    if (cookie) {
-        return isNoLike(cookie.value)
-    }
-
-    // No consent cookie means pending — defer to config
-    return config?.opt_out_capturing_by_default ?? false
-}
+// Cookie helpers were lifted to `@posthog/core` so all SDKs (posthog-node,
+// posthog-js-lite, etc.) can share them. This module re-exports the public
+// surface for any internal `@posthog/next` imports — keep using these from
+// `./shared/cookie` within next/, or import directly from `@posthog/core`.
+export {
+    cookieStateToProperties,
+    cookieStoreFromHeader,
+    getConsentCookieName,
+    getPostHogCookieName,
+    isOptedOut,
+    parsePostHogCookie,
+    readPostHogCookie,
+    serializePostHogCookie,
+} from '@posthog/core'
+export type { ConsentConfig, ConsentCookieConfig, CookieStore, PostHogCookieState } from '@posthog/core'