swish-recorder 0.1.6 → 0.2.1

package/README.md

@@ -35,25 +35,25 @@ pnpm add swish-recorder
 
 ## Usage
 
-### Vanilla JS
+### Recommended: `beforeSendHandler` (zero-miss)
 
-Call `SwishRecorder.init` right after `posthog.init`. The project token is read automatically from the PostHog instance — no extra credentials needed.
+Inject the handler directly into PostHog's config so it captures snapshots from the very first event — including the initial DOM snapshot that fires before `loaded` callbacks.
 
 ```ts
 import posthog from 'posthog-js'
 import { SwishRecorder } from 'swish-recorder'
 
+const swish = SwishRecorder.beforeSendHandler()
+
 posthog.init('phc_your_project_token', {
   api_host: 'https://eu.i.posthog.com',
   defaults: '2026-01-30',
+  before_send: swish.handler,
+  loaded: (ph) => swish.bind(ph),  // starts session lifecycle tracking
 })
-
-SwishRecorder.init({ posthog })
 ```
 
-### React (manual init)
-
-Initialize PostHog before mounting your app, then pass the instance to `PostHogProvider` via `client=`. Call `SwishRecorder.init` in between — before `createRoot`.
+### React
 
 ```tsx
 // src/main.tsx
@@ -64,13 +64,15 @@ import { PostHogProvider } from 'posthog-js/react'
 import { SwishRecorder } from 'swish-recorder'
 import App from './App'
 
+const swish = SwishRecorder.beforeSendHandler()
+
 posthog.init(import.meta.env.VITE_PUBLIC_POSTHOG_TOKEN, {
   api_host: import.meta.env.VITE_PUBLIC_POSTHOG_HOST,
   defaults: '2026-01-30',
+  before_send: swish.handler,
+  loaded: (ph) => swish.bind(ph),
 })
 
-SwishRecorder.init({ posthog })
-
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
     <PostHogProvider client={posthog}>
@@ -80,12 +82,8 @@ createRoot(document.getElementById('root')!).render(
 )
 ```
 
-> If you use `@posthog/react` instead of `posthog-js/react`, replace the import accordingly — the API is identical.
-
 ### React (PostHogProvider only)
 
-If you let `PostHogProvider` handle initialization (passing `apiKey` + `options` directly), PostHog isn't available until after it loads. Use the `loaded` callback to init SwishRecorder at that point:
-
 ```tsx
 // src/main.tsx
 import { StrictMode } from 'react'
@@ -94,6 +92,8 @@ import { PostHogProvider } from 'posthog-js/react'
 import { SwishRecorder } from 'swish-recorder'
 import App from './App'
 
+const swish = SwishRecorder.beforeSendHandler()
+
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
     <PostHogProvider
@@ -101,9 +101,8 @@ createRoot(document.getElementById('root')!).render(
       options={{
         api_host: import.meta.env.VITE_PUBLIC_POSTHOG_HOST,
         defaults: '2026-01-30',
-        loaded: (posthog) => {
-          SwishRecorder.init({ posthog })
-        },
+        before_send: swish.handler,
+        loaded: (ph) => swish.bind(ph),
       }}
     >
       <App />
@@ -112,7 +111,14 @@ createRoot(document.getElementById('root')!).render(
 )
 ```
 
-No separate `posthog.init` call needed — `PostHogProvider` takes care of it.
+### Legacy: `SwishRecorder.init`
+
+Still works, but may miss the initial DOM snapshot on pages where PostHog starts recording from cached config before the `loaded` callback fires.
+
+```ts
+posthog.init('phc_your_project_token', { ... })
+SwishRecorder.init({ posthog })
+```
 
 ---
 

package/dist/index.cjs

@@ -25,6 +25,17 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var API_HOST = "https://api.swish.is";
 var PREFIX = "[swish-recorder]";
+var VERSION = "0.2.1";
+function getToken(posthog) {
+  var _a;
+  const token = (_a = posthog.config) == null ? void 0 : _a.token;
+  if (!token) throw new Error(`${PREFIX} PostHog instance has no config.token`);
+  return token;
+}
+function getBeforeSend(posthog) {
+  var _a;
+  return (_a = posthog.config) == null ? void 0 : _a.before_send;
+}
 var SwishRecorder = class _SwishRecorder {
   constructor(config) {
     this.config = config;
@@ -45,6 +56,79 @@ var SwishRecorder = class _SwishRecorder {
     instance._setup();
     return instance;
   }
+  /**
+   * Create a `before_send` handler to pass directly into PostHog's config.
+   * This ensures snapshot interception is active from the very first event,
+   * avoiding the race condition where PostHog starts recording from persisted
+   * config before `SwishRecorder.init()` can hook in.
+   *
+   * Usage:
+   *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })
+   *   posthog.init(token, { before_send: swish.handler })
+   *   // later, after posthog is ready:
+   *   swish.bind(posthog)   // starts session lifecycle tracking
+   */
+  static beforeSendHandler(opts) {
+    var _a, _b;
+    const apiHost = (_a = opts == null ? void 0 : opts.apiHost) != null ? _a : API_HOST;
+    const debug = (_b = opts == null ? void 0 : opts.debug) != null ? _b : false;
+    let token = null;
+    let pendingSnapshots = [];
+    const log = (...args) => {
+      if (debug) console.log(PREFIX, ...args);
+    };
+    const warn = (...args) => {
+      if (debug) console.warn(PREFIX, ...args);
+    };
+    const sendSnapshot = (props, ts) => {
+      fetch(`${apiHost}/replays/ingest`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-PostHog-Token": token
+        },
+        body: JSON.stringify({
+          session_id: props.$session_id,
+          window_id: props.$window_id,
+          snapshot_data: props.$snapshot_data,
+          distinct_id: props.distinct_id,
+          timestamp: ts,
+          sdk_version: VERSION
+        })
+      }).then((res) => {
+        if (debug) {
+          if (res.ok) log(`ingest OK \u2014 ${res.status}`);
+          else warn(`ingest failed \u2014 ${res.status} ${res.statusText}`);
+        }
+      }).catch((err) => warn("ingest error \u2014", err));
+    };
+    const handler = (event) => {
+      if ((event == null ? void 0 : event.event) === "$snapshot") {
+        const props = event.properties;
+        const ts = Date.now();
+        if (token) {
+          sendSnapshot(props, ts);
+        } else {
+          pendingSnapshots.push({ props, ts });
+          log(`buffered snapshot (pre-bind) \u2014 ${pendingSnapshots.length} pending`);
+        }
+      }
+      return event;
+    };
+    const bind = (posthog) => {
+      token = getToken(posthog);
+      log(`bind \u2014 token=${token.slice(0, 12)}\u2026`);
+      if (pendingSnapshots.length > 0) {
+        log(`flushing ${pendingSnapshots.length} buffered snapshots`);
+        for (const { props, ts } of pendingSnapshots) {
+          sendSnapshot(props, ts);
+        }
+        pendingSnapshots = [];
+      }
+      return _SwishRecorder.init({ posthog, apiHost, debug, _skipBeforeSend: true });
+    };
+    return { handler, bind };
+  }
   _sendSessionEnd(sessionId, reason) {
     this._log(`session end \u2014 session=${sessionId} reason=${reason}`);
     navigator.sendBeacon(
@@ -54,7 +138,7 @@ var SwishRecorder = class _SwishRecorder {
           JSON.stringify({
             session_id: sessionId,
             reason,
-            token: this.config.posthog.config.token
+            token: getToken(this.config.posthog)
           })
         ],
         { type: "application/json" }
@@ -69,14 +153,15 @@ var SwishRecorder = class _SwishRecorder {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "X-PostHog-Token": this.config.posthog.config.token
+        "X-PostHog-Token": getToken(this.config.posthog)
       },
       body: JSON.stringify({
         session_id: sessionId,
         window_id: windowId,
         snapshot_data: snapshotData,
         distinct_id: distinctId,
-        timestamp: Date.now()
+        timestamp: Date.now(),
+        sdk_version: VERSION
       })
     }).then((res) => {
       if (this.config.debug) {
@@ -92,33 +177,39 @@ var SwishRecorder = class _SwishRecorder {
   }
   _setup() {
     const { posthog } = this.config;
-    const token = posthog.config.token;
-    this._log(`init \u2014 token=${token.slice(0, 12)}\u2026`);
-    if (!token) {
+    let token;
+    try {
+      token = getToken(posthog);
+    } catch (e) {
       this._warn("no PostHog token found \u2014 recording disabled");
       return;
     }
-    const snapshotHandler = (event) => {
-      if ((event == null ? void 0 : event.event) === "$snapshot") {
-        const props = event.properties;
-        this._ingestSnapshot(
-          props.$session_id,
-          props.$window_id,
-          props.$snapshot_data,
-          props.distinct_id
-        );
-      } else if (this.config.debug && event) {
-        this._log(`before_send passthrough \u2014 event=${event.event}`);
-      }
-      return event;
-    };
-    const existing = posthog.config.before_send;
-    this._log(
-      `before_send \u2014 existing handler: ${existing ? Array.isArray(existing) ? `array(${existing.length})` : "function" : "none"}`
-    );
-    posthog.set_config({
-      before_send: existing ? Array.isArray(existing) ? [...existing, snapshotHandler] : [existing, snapshotHandler] : snapshotHandler
-    });
+    this._log(`init \u2014 token=${token.slice(0, 12)}\u2026`);
+    if (!this.config._skipBeforeSend) {
+      const snapshotHandler = (event) => {
+        if ((event == null ? void 0 : event.event) === "$snapshot") {
+          const props = event.properties;
+          this._ingestSnapshot(
+            props.$session_id,
+            props.$window_id,
+            props.$snapshot_data,
+            props.distinct_id
+          );
+        } else if (this.config.debug && event) {
+          this._log(`before_send passthrough \u2014 event=${event.event}`);
+        }
+        return event;
+      };
+      const existing = getBeforeSend(posthog);
+      this._log(
+        `before_send \u2014 existing handler: ${existing ? Array.isArray(existing) ? `array(${existing.length})` : "function" : "none"}`
+      );
+      posthog.set_config({
+        before_send: existing ? Array.isArray(existing) ? [...existing, snapshotHandler] : [existing, snapshotHandler] : snapshotHandler
+      });
+    } else {
+      this._log("before_send \u2014 already registered via beforeSendHandler()");
+    }
     this.unsubscribeSessionId = posthog.onSessionId(
       (newSessionId, _windowId, changeReason) => {
         this._log(

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Minimal PostHog interface — no posthog-js dependency needed\ninterface PostHogLike {\n  set_config(config: { before_send?: unknown }): void;\n  onSessionId(\n    callback: (\n      sessionId: string,\n      windowId: string | null | undefined,\n      changeReason?: {\n        activityTimeout?: boolean;\n        sessionPastMaximumLength?: boolean;\n      },\n    ) => void,\n  ): () => void;\n  readonly config: {\n    token: string;\n    before_send?: unknown;\n  };\n}\n\ntype BeforeSendFn = (\n  event: { event: string; properties: Record<string, unknown> } | null,\n) => { event: string; properties: Record<string, unknown> } | null;\n\nconst API_HOST = \"https://api.swish.is\";\nconst PREFIX = \"[swish-recorder]\";\n\nexport interface SwishRecorderConfig {\n  /** PostHog instance from your app — token is read automatically. */\n  posthog: PostHogLike;\n  /** Enable console logging for debugging. */\n  debug?: boolean;\n  /** Override the Swish API URL. Useful for local development (e.g. \"http://localhost:8000\"). */\n  apiHost?: string;\n}\n\nexport class SwishRecorder {\n  private currentSessionId: string | null = null;\n  private unsubscribeSessionId: (() => void) | null = null;\n  private handleUnload: (() => void) | null = null;\n\n  private readonly apiHost: string;\n\n  private constructor(private readonly config: SwishRecorderConfig) {\n    this.apiHost = config.apiHost ?? API_HOST;\n  }\n\n  private _log(...args: unknown[]): void {\n    if (this.config.debug) console.log(PREFIX, ...args);\n  }\n\n  private _warn(...args: unknown[]): void {\n    if (this.config.debug) console.warn(PREFIX, ...args);\n  }\n\n  static init(config: SwishRecorderConfig): SwishRecorder {\n    const instance = new SwishRecorder(config);\n    instance._setup();\n    return instance;\n  }\n\n  private _sendSessionEnd(sessionId: string, reason: string): void {\n    this._log(`session end — session=${sessionId} reason=${reason}`);\n    navigator.sendBeacon(\n      `${this.apiHost}/replays/session-end`,\n      new Blob(\n        [\n          JSON.stringify({\n            session_id: sessionId,\n            reason,\n            token: this.config.posthog.config.token,\n          }),\n        ],\n        { type: \"application/json\" },\n      ),\n    );\n  }\n\n  private _ingestSnapshot(\n    sessionId: string,\n    windowId: string,\n    snapshotData: unknown,\n    distinctId: string,\n  ): void {\n    this._log(\n      `ingesting snapshot — session=${sessionId} window=${windowId} distinct_id=${distinctId}`,\n    );\n    fetch(`${this.apiHost}/replays/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-PostHog-Token\": this.config.posthog.config.token,\n      },\n      body: JSON.stringify({\n        session_id: sessionId,\n        window_id: windowId,\n        snapshot_data: snapshotData,\n        distinct_id: distinctId,\n        timestamp: Date.now(),\n      }),\n    })\n      .then((res) => {\n        if (this.config.debug) {\n          if (res.ok) {\n            this._log(`ingest OK — ${res.status}`);\n          } else {\n            this._warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        }\n      })\n      .catch((err) => {\n        this._warn(\"ingest error —\", err);\n      });\n  }\n\n  private _setup(): void {\n    const { posthog } = this.config;\n    const token = posthog.config.token;\n\n    this._log(`init — token=${token.slice(0, 12)}…`);\n\n    if (!token) {\n      this._warn(\"no PostHog token found — recording disabled\");\n      return;\n    }\n\n    // 1. Intercept $snapshot events via before_send (non-destructive append)\n    const snapshotHandler: BeforeSendFn = (event) => {\n      if (event?.event === \"$snapshot\") {\n        const props = event.properties;\n        this._ingestSnapshot(\n          props.$session_id as string,\n          props.$window_id as string,\n          props.$snapshot_data,\n          props.distinct_id as string,\n        );\n      } else if (this.config.debug && event) {\n        this._log(`before_send passthrough — event=${event.event}`);\n      }\n      return event;\n    };\n\n    const existing = posthog.config.before_send;\n    this._log(\n      `before_send — existing handler: ${existing ? (Array.isArray(existing) ? `array(${(existing as unknown[]).length})` : \"function\") : \"none\"}`,\n    );\n    posthog.set_config({\n      before_send: existing\n        ? Array.isArray(existing)\n          ? [...(existing as BeforeSendFn[]), snapshotHandler]\n          : [existing as BeforeSendFn, snapshotHandler]\n        : snapshotHandler,\n    });\n\n    // 2. Session rotation signal — fires on idle timeout or max session length\n    this.unsubscribeSessionId = posthog.onSessionId(\n      (newSessionId, _windowId, changeReason) => {\n        this._log(\n          `session ID changed — new=${newSessionId} reason=${JSON.stringify(changeReason ?? null)}`,\n        );\n        if (this.currentSessionId && changeReason) {\n          const reason = changeReason.activityTimeout\n            ? \"activity_timeout\"\n            : changeReason.sessionPastMaximumLength\n              ? \"session_length\"\n              : null;\n          if (reason) this._sendSessionEnd(this.currentSessionId, reason);\n        }\n        this.currentSessionId = newSessionId;\n      },\n    );\n\n    // 3. Tab close — sendBeacon survives page unload, fetch does not\n    this.handleUnload = () => {\n      if (this.currentSessionId)\n        this._sendSessionEnd(this.currentSessionId, \"tab_close\");\n    };\n    window.addEventListener(\"beforeunload\", this.handleUnload);\n\n    this._log(\"ready\");\n  }\n\n  destroy(): void {\n    this._log(\"destroy\");\n    this.unsubscribeSessionId?.();\n    if (this.handleUnload) {\n      window.removeEventListener(\"beforeunload\", this.handleUnload);\n    }\n    this.unsubscribeSessionId = null;\n    this.handleUnload = null;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Minimal PostHog interface — no posthog-js dependency needed.\n//\n// posthog-js types the `loaded` callback parameter as\n// `PostHogInterface = Omit<PostHog, 'config' | 'init'>`, which strips\n// `config` from the type even though the runtime object always has it.\n// We keep `config` optional here so users can pass either the full\n// PostHog instance or the `loaded` callback parameter without type errors.\n// At runtime we assert `config` exists — it always does.\ninterface PostHogLike {\n  set_config(config: { before_send?: unknown }): void;\n  onSessionId(\n    callback: (\n      sessionId: string,\n      windowId: string | null | undefined,\n      changeReason?: {\n        noSessionId?: boolean;\n        activityTimeout?: boolean;\n        sessionPastMaximumLength?: boolean;\n      },\n    ) => void,\n  ): () => void;\n  config?: {\n    token: string;\n    before_send?: unknown;\n  };\n}\n\n/**\n * Compatible with posthog-js BeforeSendFn / CaptureResult.\n * We use `any` for the public handler type so it's assignable to PostHog's\n * `before_send` without users needing type casts — the actual shapes evolve\n * across posthog-js versions and we only inspect `event` + `properties`.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype BeforeSendFn = (event: any) => any;\n\nconst API_HOST = \"https://api.swish.is\";\nconst PREFIX = \"[swish-recorder]\";\nconst VERSION = \"0.2.1\";\n\n/** Read posthog.config.token — always exists at runtime even when typed away. */\nfunction getToken(posthog: PostHogLike): string {\n  const token = (posthog as { config?: { token?: string } }).config?.token;\n  if (!token) throw new Error(`${PREFIX} PostHog instance has no config.token`);\n  return token;\n}\n\n/** Read posthog.config.before_send — may be undefined. */\nfunction getBeforeSend(posthog: PostHogLike): unknown {\n  return (posthog as { config?: { before_send?: unknown } }).config\n    ?.before_send;\n}\n\nexport interface SwishRecorderConfig {\n  /** PostHog instance from your app — token is read automatically. */\n  posthog: PostHogLike;\n  /** Enable console logging for debugging. */\n  debug?: boolean;\n  /** Override the Swish API URL. Useful for local development (e.g. \"http://localhost:8000\"). */\n  apiHost?: string;\n  /** @internal Skip before_send registration (already handled by beforeSendHandler). */\n  _skipBeforeSend?: boolean;\n}\n\nexport class SwishRecorder {\n  private currentSessionId: string | null = null;\n  private unsubscribeSessionId: (() => void) | null = null;\n  private handleUnload: (() => void) | null = null;\n\n  private readonly apiHost: string;\n\n  private constructor(private readonly config: SwishRecorderConfig) {\n    this.apiHost = config.apiHost ?? API_HOST;\n  }\n\n  private _log(...args: unknown[]): void {\n    if (this.config.debug) console.log(PREFIX, ...args);\n  }\n\n  private _warn(...args: unknown[]): void {\n    if (this.config.debug) console.warn(PREFIX, ...args);\n  }\n\n  static init(config: SwishRecorderConfig): SwishRecorder {\n    const instance = new SwishRecorder(config);\n    instance._setup();\n    return instance;\n  }\n\n  /**\n   * Create a `before_send` handler to pass directly into PostHog's config.\n   * This ensures snapshot interception is active from the very first event,\n   * avoiding the race condition where PostHog starts recording from persisted\n   * config before `SwishRecorder.init()` can hook in.\n   *\n   * Usage:\n   *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })\n   *   posthog.init(token, { before_send: swish.handler })\n   *   // later, after posthog is ready:\n   *   swish.bind(posthog)   // starts session lifecycle tracking\n   */\n  static beforeSendHandler(opts?: {\n    apiHost?: string;\n    debug?: boolean;\n  }): { handler: BeforeSendFn; bind: (posthog: PostHogLike) => SwishRecorder } {\n    const apiHost = opts?.apiHost ?? API_HOST;\n    const debug = opts?.debug ?? false;\n    let token: string | null = null;\n    let pendingSnapshots: { props: Record<string, unknown>; ts: number }[] = [];\n\n    const log = (...args: unknown[]) => {\n      if (debug) console.log(PREFIX, ...args);\n    };\n    const warn = (...args: unknown[]) => {\n      if (debug) console.warn(PREFIX, ...args);\n    };\n\n    const sendSnapshot = (props: Record<string, unknown>, ts: number) => {\n      fetch(`${apiHost}/replays/ingest`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-PostHog-Token\": token!,\n        },\n        body: JSON.stringify({\n          session_id: props.$session_id,\n          window_id: props.$window_id,\n          snapshot_data: props.$snapshot_data,\n          distinct_id: props.distinct_id,\n          timestamp: ts,\n          sdk_version: VERSION,\n        }),\n      })\n        .then((res) => {\n          if (debug) {\n            if (res.ok) log(`ingest OK — ${res.status}`);\n            else warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        })\n        .catch((err) => warn(\"ingest error —\", err));\n    };\n\n    const handler: BeforeSendFn = (event) => {\n      if (event?.event === \"$snapshot\") {\n        const props = event.properties;\n        const ts = Date.now();\n        if (token) {\n          sendSnapshot(props, ts);\n        } else {\n          // Buffer until bind() provides the token\n          pendingSnapshots.push({ props, ts });\n          log(`buffered snapshot (pre-bind) — ${pendingSnapshots.length} pending`);\n        }\n      }\n      return event;\n    };\n\n    const bind = (posthog: PostHogLike): SwishRecorder => {\n      token = getToken(posthog);\n      log(`bind — token=${token.slice(0, 12)}…`);\n\n      // Flush any snapshots captured before bind\n      if (pendingSnapshots.length > 0) {\n        log(`flushing ${pendingSnapshots.length} buffered snapshots`);\n        for (const { props, ts } of pendingSnapshots) {\n          sendSnapshot(props, ts);\n        }\n        pendingSnapshots = [];\n      }\n\n      return SwishRecorder.init({ posthog, apiHost, debug, _skipBeforeSend: true });\n    };\n\n    return { handler, bind };\n  }\n\n  private _sendSessionEnd(sessionId: string, reason: string): void {\n    this._log(`session end — session=${sessionId} reason=${reason}`);\n    navigator.sendBeacon(\n      `${this.apiHost}/replays/session-end`,\n      new Blob(\n        [\n          JSON.stringify({\n            session_id: sessionId,\n            reason,\n            token: getToken(this.config.posthog),\n          }),\n        ],\n        { type: \"application/json\" },\n      ),\n    );\n  }\n\n  private _ingestSnapshot(\n    sessionId: string,\n    windowId: string,\n    snapshotData: unknown,\n    distinctId: string,\n  ): void {\n    this._log(\n      `ingesting snapshot — session=${sessionId} window=${windowId} distinct_id=${distinctId}`,\n    );\n    fetch(`${this.apiHost}/replays/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-PostHog-Token\": getToken(this.config.posthog),\n      },\n      body: JSON.stringify({\n        session_id: sessionId,\n        window_id: windowId,\n        snapshot_data: snapshotData,\n        distinct_id: distinctId,\n        timestamp: Date.now(),\n        sdk_version: VERSION,\n      }),\n    })\n      .then((res) => {\n        if (this.config.debug) {\n          if (res.ok) {\n            this._log(`ingest OK — ${res.status}`);\n          } else {\n            this._warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        }\n      })\n      .catch((err) => {\n        this._warn(\"ingest error —\", err);\n      });\n  }\n\n  private _setup(): void {\n    const { posthog } = this.config;\n    let token: string;\n    try {\n      token = getToken(posthog);\n    } catch {\n      this._warn(\"no PostHog token found — recording disabled\");\n      return;\n    }\n\n    this._log(`init — token=${token.slice(0, 12)}…`);\n\n    // 1. Intercept $snapshot events via before_send (non-destructive append)\n    //    Skip if already registered via beforeSendHandler()\n    if (!this.config._skipBeforeSend) {\n      const snapshotHandler: BeforeSendFn = (event) => {\n        if (event?.event === \"$snapshot\") {\n          const props = event.properties;\n          this._ingestSnapshot(\n            props.$session_id as string,\n            props.$window_id as string,\n            props.$snapshot_data,\n            props.distinct_id as string,\n          );\n        } else if (this.config.debug && event) {\n          this._log(`before_send passthrough — event=${event.event}`);\n        }\n        return event;\n      };\n\n      const existing = getBeforeSend(posthog);\n      this._log(\n        `before_send — existing handler: ${existing ? (Array.isArray(existing) ? `array(${(existing as unknown[]).length})` : \"function\") : \"none\"}`,\n      );\n      posthog.set_config({\n        before_send: existing\n          ? Array.isArray(existing)\n            ? [...(existing as BeforeSendFn[]), snapshotHandler]\n            : [existing as BeforeSendFn, snapshotHandler]\n          : snapshotHandler,\n      });\n    } else {\n      this._log(\"before_send — already registered via beforeSendHandler()\");\n    }\n\n    // 2. Session rotation signal — fires on idle timeout or max session length\n    this.unsubscribeSessionId = posthog.onSessionId(\n      (newSessionId, _windowId, changeReason) => {\n        this._log(\n          `session ID changed — new=${newSessionId} reason=${JSON.stringify(changeReason ?? null)}`,\n        );\n        if (this.currentSessionId && changeReason) {\n          const reason = changeReason.activityTimeout\n            ? \"activity_timeout\"\n            : changeReason.sessionPastMaximumLength\n              ? \"session_length\"\n              : null;\n          if (reason) this._sendSessionEnd(this.currentSessionId, reason);\n        }\n        this.currentSessionId = newSessionId;\n      },\n    );\n\n    // 3. Tab close — sendBeacon survives page unload, fetch does not\n    this.handleUnload = () => {\n      if (this.currentSessionId)\n        this._sendSessionEnd(this.currentSessionId, \"tab_close\");\n    };\n    window.addEventListener(\"beforeunload\", this.handleUnload);\n\n    this._log(\"ready\");\n  }\n\n  destroy(): void {\n    this._log(\"destroy\");\n    this.unsubscribeSessionId?.();\n    if (this.handleUnload) {\n      window.removeEventListener(\"beforeunload\", this.handleUnload);\n    }\n    this.unsubscribeSessionId = null;\n    this.handleUnload = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -3,14 +3,22 @@ interface PostHogLike {
         before_send?: unknown;
     }): void;
     onSessionId(callback: (sessionId: string, windowId: string | null | undefined, changeReason?: {
+        noSessionId?: boolean;
         activityTimeout?: boolean;
         sessionPastMaximumLength?: boolean;
     }) => void): () => void;
-    readonly config: {
+    config?: {
         token: string;
         before_send?: unknown;
     };
 }
+/**
+ * Compatible with posthog-js BeforeSendFn / CaptureResult.
+ * We use `any` for the public handler type so it's assignable to PostHog's
+ * `before_send` without users needing type casts — the actual shapes evolve
+ * across posthog-js versions and we only inspect `event` + `properties`.
+ */
+type BeforeSendFn = (event: any) => any;
 interface SwishRecorderConfig {
     /** PostHog instance from your app — token is read automatically. */
     posthog: PostHogLike;
@@ -18,6 +26,8 @@ interface SwishRecorderConfig {
     debug?: boolean;
     /** Override the Swish API URL. Useful for local development (e.g. "http://localhost:8000"). */
     apiHost?: string;
+    /** @internal Skip before_send registration (already handled by beforeSendHandler). */
+    _skipBeforeSend?: boolean;
 }
 declare class SwishRecorder {
     private readonly config;
@@ -29,6 +39,25 @@ declare class SwishRecorder {
     private _log;
     private _warn;
     static init(config: SwishRecorderConfig): SwishRecorder;
+    /**
+     * Create a `before_send` handler to pass directly into PostHog's config.
+     * This ensures snapshot interception is active from the very first event,
+     * avoiding the race condition where PostHog starts recording from persisted
+     * config before `SwishRecorder.init()` can hook in.
+     *
+     * Usage:
+     *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })
+     *   posthog.init(token, { before_send: swish.handler })
+     *   // later, after posthog is ready:
+     *   swish.bind(posthog)   // starts session lifecycle tracking
+     */
+    static beforeSendHandler(opts?: {
+        apiHost?: string;
+        debug?: boolean;
+    }): {
+        handler: BeforeSendFn;
+        bind: (posthog: PostHogLike) => SwishRecorder;
+    };
     private _sendSessionEnd;
     private _ingestSnapshot;
     private _setup;

package/dist/index.d.ts

@@ -3,14 +3,22 @@ interface PostHogLike {
         before_send?: unknown;
     }): void;
     onSessionId(callback: (sessionId: string, windowId: string | null | undefined, changeReason?: {
+        noSessionId?: boolean;
         activityTimeout?: boolean;
         sessionPastMaximumLength?: boolean;
     }) => void): () => void;
-    readonly config: {
+    config?: {
         token: string;
         before_send?: unknown;
     };
 }
+/**
+ * Compatible with posthog-js BeforeSendFn / CaptureResult.
+ * We use `any` for the public handler type so it's assignable to PostHog's
+ * `before_send` without users needing type casts — the actual shapes evolve
+ * across posthog-js versions and we only inspect `event` + `properties`.
+ */
+type BeforeSendFn = (event: any) => any;
 interface SwishRecorderConfig {
     /** PostHog instance from your app — token is read automatically. */
     posthog: PostHogLike;
@@ -18,6 +26,8 @@ interface SwishRecorderConfig {
     debug?: boolean;
     /** Override the Swish API URL. Useful for local development (e.g. "http://localhost:8000"). */
     apiHost?: string;
+    /** @internal Skip before_send registration (already handled by beforeSendHandler). */
+    _skipBeforeSend?: boolean;
 }
 declare class SwishRecorder {
     private readonly config;
@@ -29,6 +39,25 @@ declare class SwishRecorder {
     private _log;
     private _warn;
     static init(config: SwishRecorderConfig): SwishRecorder;
+    /**
+     * Create a `before_send` handler to pass directly into PostHog's config.
+     * This ensures snapshot interception is active from the very first event,
+     * avoiding the race condition where PostHog starts recording from persisted
+     * config before `SwishRecorder.init()` can hook in.
+     *
+     * Usage:
+     *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })
+     *   posthog.init(token, { before_send: swish.handler })
+     *   // later, after posthog is ready:
+     *   swish.bind(posthog)   // starts session lifecycle tracking
+     */
+    static beforeSendHandler(opts?: {
+        apiHost?: string;
+        debug?: boolean;
+    }): {
+        handler: BeforeSendFn;
+        bind: (posthog: PostHogLike) => SwishRecorder;
+    };
     private _sendSessionEnd;
     private _ingestSnapshot;
     private _setup;

package/dist/index.js

@@ -1,6 +1,17 @@
 // src/index.ts
 var API_HOST = "https://api.swish.is";
 var PREFIX = "[swish-recorder]";
+var VERSION = "0.2.1";
+function getToken(posthog) {
+  var _a;
+  const token = (_a = posthog.config) == null ? void 0 : _a.token;
+  if (!token) throw new Error(`${PREFIX} PostHog instance has no config.token`);
+  return token;
+}
+function getBeforeSend(posthog) {
+  var _a;
+  return (_a = posthog.config) == null ? void 0 : _a.before_send;
+}
 var SwishRecorder = class _SwishRecorder {
   constructor(config) {
     this.config = config;
@@ -21,6 +32,79 @@ var SwishRecorder = class _SwishRecorder {
     instance._setup();
     return instance;
   }
+  /**
+   * Create a `before_send` handler to pass directly into PostHog's config.
+   * This ensures snapshot interception is active from the very first event,
+   * avoiding the race condition where PostHog starts recording from persisted
+   * config before `SwishRecorder.init()` can hook in.
+   *
+   * Usage:
+   *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })
+   *   posthog.init(token, { before_send: swish.handler })
+   *   // later, after posthog is ready:
+   *   swish.bind(posthog)   // starts session lifecycle tracking
+   */
+  static beforeSendHandler(opts) {
+    var _a, _b;
+    const apiHost = (_a = opts == null ? void 0 : opts.apiHost) != null ? _a : API_HOST;
+    const debug = (_b = opts == null ? void 0 : opts.debug) != null ? _b : false;
+    let token = null;
+    let pendingSnapshots = [];
+    const log = (...args) => {
+      if (debug) console.log(PREFIX, ...args);
+    };
+    const warn = (...args) => {
+      if (debug) console.warn(PREFIX, ...args);
+    };
+    const sendSnapshot = (props, ts) => {
+      fetch(`${apiHost}/replays/ingest`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-PostHog-Token": token
+        },
+        body: JSON.stringify({
+          session_id: props.$session_id,
+          window_id: props.$window_id,
+          snapshot_data: props.$snapshot_data,
+          distinct_id: props.distinct_id,
+          timestamp: ts,
+          sdk_version: VERSION
+        })
+      }).then((res) => {
+        if (debug) {
+          if (res.ok) log(`ingest OK \u2014 ${res.status}`);
+          else warn(`ingest failed \u2014 ${res.status} ${res.statusText}`);
+        }
+      }).catch((err) => warn("ingest error \u2014", err));
+    };
+    const handler = (event) => {
+      if ((event == null ? void 0 : event.event) === "$snapshot") {
+        const props = event.properties;
+        const ts = Date.now();
+        if (token) {
+          sendSnapshot(props, ts);
+        } else {
+          pendingSnapshots.push({ props, ts });
+          log(`buffered snapshot (pre-bind) \u2014 ${pendingSnapshots.length} pending`);
+        }
+      }
+      return event;
+    };
+    const bind = (posthog) => {
+      token = getToken(posthog);
+      log(`bind \u2014 token=${token.slice(0, 12)}\u2026`);
+      if (pendingSnapshots.length > 0) {
+        log(`flushing ${pendingSnapshots.length} buffered snapshots`);
+        for (const { props, ts } of pendingSnapshots) {
+          sendSnapshot(props, ts);
+        }
+        pendingSnapshots = [];
+      }
+      return _SwishRecorder.init({ posthog, apiHost, debug, _skipBeforeSend: true });
+    };
+    return { handler, bind };
+  }
   _sendSessionEnd(sessionId, reason) {
     this._log(`session end \u2014 session=${sessionId} reason=${reason}`);
     navigator.sendBeacon(
@@ -30,7 +114,7 @@ var SwishRecorder = class _SwishRecorder {
           JSON.stringify({
             session_id: sessionId,
             reason,
-            token: this.config.posthog.config.token
+            token: getToken(this.config.posthog)
           })
         ],
         { type: "application/json" }
@@ -45,14 +129,15 @@ var SwishRecorder = class _SwishRecorder {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "X-PostHog-Token": this.config.posthog.config.token
+        "X-PostHog-Token": getToken(this.config.posthog)
       },
       body: JSON.stringify({
         session_id: sessionId,
         window_id: windowId,
         snapshot_data: snapshotData,
         distinct_id: distinctId,
-        timestamp: Date.now()
+        timestamp: Date.now(),
+        sdk_version: VERSION
       })
     }).then((res) => {
       if (this.config.debug) {
@@ -68,33 +153,39 @@ var SwishRecorder = class _SwishRecorder {
   }
   _setup() {
     const { posthog } = this.config;
-    const token = posthog.config.token;
-    this._log(`init \u2014 token=${token.slice(0, 12)}\u2026`);
-    if (!token) {
+    let token;
+    try {
+      token = getToken(posthog);
+    } catch (e) {
       this._warn("no PostHog token found \u2014 recording disabled");
       return;
     }
-    const snapshotHandler = (event) => {
-      if ((event == null ? void 0 : event.event) === "$snapshot") {
-        const props = event.properties;
-        this._ingestSnapshot(
-          props.$session_id,
-          props.$window_id,
-          props.$snapshot_data,
-          props.distinct_id
-        );
-      } else if (this.config.debug && event) {
-        this._log(`before_send passthrough \u2014 event=${event.event}`);
-      }
-      return event;
-    };
-    const existing = posthog.config.before_send;
-    this._log(
-      `before_send \u2014 existing handler: ${existing ? Array.isArray(existing) ? `array(${existing.length})` : "function" : "none"}`
-    );
-    posthog.set_config({
-      before_send: existing ? Array.isArray(existing) ? [...existing, snapshotHandler] : [existing, snapshotHandler] : snapshotHandler
-    });
+    this._log(`init \u2014 token=${token.slice(0, 12)}\u2026`);
+    if (!this.config._skipBeforeSend) {
+      const snapshotHandler = (event) => {
+        if ((event == null ? void 0 : event.event) === "$snapshot") {
+          const props = event.properties;
+          this._ingestSnapshot(
+            props.$session_id,
+            props.$window_id,
+            props.$snapshot_data,
+            props.distinct_id
+          );
+        } else if (this.config.debug && event) {
+          this._log(`before_send passthrough \u2014 event=${event.event}`);
+        }
+        return event;
+      };
+      const existing = getBeforeSend(posthog);
+      this._log(
+        `before_send \u2014 existing handler: ${existing ? Array.isArray(existing) ? `array(${existing.length})` : "function" : "none"}`
+      );
+      posthog.set_config({
+        before_send: existing ? Array.isArray(existing) ? [...existing, snapshotHandler] : [existing, snapshotHandler] : snapshotHandler
+      });
+    } else {
+      this._log("before_send \u2014 already registered via beforeSendHandler()");
+    }
     this.unsubscribeSessionId = posthog.onSessionId(
       (newSessionId, _windowId, changeReason) => {
         this._log(

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Minimal PostHog interface — no posthog-js dependency needed\ninterface PostHogLike {\n  set_config(config: { before_send?: unknown }): void;\n  onSessionId(\n    callback: (\n      sessionId: string,\n      windowId: string | null | undefined,\n      changeReason?: {\n        activityTimeout?: boolean;\n        sessionPastMaximumLength?: boolean;\n      },\n    ) => void,\n  ): () => void;\n  readonly config: {\n    token: string;\n    before_send?: unknown;\n  };\n}\n\ntype BeforeSendFn = (\n  event: { event: string; properties: Record<string, unknown> } | null,\n) => { event: string; properties: Record<string, unknown> } | null;\n\nconst API_HOST = \"https://api.swish.is\";\nconst PREFIX = \"[swish-recorder]\";\n\nexport interface SwishRecorderConfig {\n  /** PostHog instance from your app — token is read automatically. */\n  posthog: PostHogLike;\n  /** Enable console logging for debugging. */\n  debug?: boolean;\n  /** Override the Swish API URL. Useful for local development (e.g. \"http://localhost:8000\"). */\n  apiHost?: string;\n}\n\nexport class SwishRecorder {\n  private currentSessionId: string | null = null;\n  private unsubscribeSessionId: (() => void) | null = null;\n  private handleUnload: (() => void) | null = null;\n\n  private readonly apiHost: string;\n\n  private constructor(private readonly config: SwishRecorderConfig) {\n    this.apiHost = config.apiHost ?? API_HOST;\n  }\n\n  private _log(...args: unknown[]): void {\n    if (this.config.debug) console.log(PREFIX, ...args);\n  }\n\n  private _warn(...args: unknown[]): void {\n    if (this.config.debug) console.warn(PREFIX, ...args);\n  }\n\n  static init(config: SwishRecorderConfig): SwishRecorder {\n    const instance = new SwishRecorder(config);\n    instance._setup();\n    return instance;\n  }\n\n  private _sendSessionEnd(sessionId: string, reason: string): void {\n    this._log(`session end — session=${sessionId} reason=${reason}`);\n    navigator.sendBeacon(\n      `${this.apiHost}/replays/session-end`,\n      new Blob(\n        [\n          JSON.stringify({\n            session_id: sessionId,\n            reason,\n            token: this.config.posthog.config.token,\n          }),\n        ],\n        { type: \"application/json\" },\n      ),\n    );\n  }\n\n  private _ingestSnapshot(\n    sessionId: string,\n    windowId: string,\n    snapshotData: unknown,\n    distinctId: string,\n  ): void {\n    this._log(\n      `ingesting snapshot — session=${sessionId} window=${windowId} distinct_id=${distinctId}`,\n    );\n    fetch(`${this.apiHost}/replays/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-PostHog-Token\": this.config.posthog.config.token,\n      },\n      body: JSON.stringify({\n        session_id: sessionId,\n        window_id: windowId,\n        snapshot_data: snapshotData,\n        distinct_id: distinctId,\n        timestamp: Date.now(),\n      }),\n    })\n      .then((res) => {\n        if (this.config.debug) {\n          if (res.ok) {\n            this._log(`ingest OK — ${res.status}`);\n          } else {\n            this._warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        }\n      })\n      .catch((err) => {\n        this._warn(\"ingest error —\", err);\n      });\n  }\n\n  private _setup(): void {\n    const { posthog } = this.config;\n    const token = posthog.config.token;\n\n    this._log(`init — token=${token.slice(0, 12)}…`);\n\n    if (!token) {\n      this._warn(\"no PostHog token found — recording disabled\");\n      return;\n    }\n\n    // 1. Intercept $snapshot events via before_send (non-destructive append)\n    const snapshotHandler: BeforeSendFn = (event) => {\n      if (event?.event === \"$snapshot\") {\n        const props = event.properties;\n        this._ingestSnapshot(\n          props.$session_id as string,\n          props.$window_id as string,\n          props.$snapshot_data,\n          props.distinct_id as string,\n        );\n      } else if (this.config.debug && event) {\n        this._log(`before_send passthrough — event=${event.event}`);\n      }\n      return event;\n    };\n\n    const existing = posthog.config.before_send;\n    this._log(\n      `before_send — existing handler: ${existing ? (Array.isArray(existing) ? `array(${(existing as unknown[]).length})` : \"function\") : \"none\"}`,\n    );\n    posthog.set_config({\n      before_send: existing\n        ? Array.isArray(existing)\n          ? [...(existing as BeforeSendFn[]), snapshotHandler]\n          : [existing as BeforeSendFn, snapshotHandler]\n        : snapshotHandler,\n    });\n\n    // 2. Session rotation signal — fires on idle timeout or max session length\n    this.unsubscribeSessionId = posthog.onSessionId(\n      (newSessionId, _windowId, changeReason) => {\n        this._log(\n          `session ID changed — new=${newSessionId} reason=${JSON.stringify(changeReason ?? null)}`,\n        );\n        if (this.currentSessionId && changeReason) {\n          const reason = changeReason.activityTimeout\n            ? \"activity_timeout\"\n            : changeReason.sessionPastMaximumLength\n              ? \"session_length\"\n              : null;\n          if (reason) this._sendSessionEnd(this.currentSessionId, reason);\n        }\n        this.currentSessionId = newSessionId;\n      },\n    );\n\n    // 3. Tab close — sendBeacon survives page unload, fetch does not\n    this.handleUnload = () => {\n      if (this.currentSessionId)\n        this._sendSessionEnd(this.currentSessionId, \"tab_close\");\n    };\n    window.addEventListener(\"beforeunload\", this.handleUnload);\n\n    this._log(\"ready\");\n  }\n\n  destroy(): void {\n    this._log(\"destroy\");\n    this.unsubscribeSessionId?.();\n    if (this.handleUnload) {\n      window.removeEventListener(\"beforeunload\", this.handleUnload);\n    }\n    this.unsubscribeSessionId = null;\n    this.handleUnload = null;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Minimal PostHog interface — no posthog-js dependency needed.\n//\n// posthog-js types the `loaded` callback parameter as\n// `PostHogInterface = Omit<PostHog, 'config' | 'init'>`, which strips\n// `config` from the type even though the runtime object always has it.\n// We keep `config` optional here so users can pass either the full\n// PostHog instance or the `loaded` callback parameter without type errors.\n// At runtime we assert `config` exists — it always does.\ninterface PostHogLike {\n  set_config(config: { before_send?: unknown }): void;\n  onSessionId(\n    callback: (\n      sessionId: string,\n      windowId: string | null | undefined,\n      changeReason?: {\n        noSessionId?: boolean;\n        activityTimeout?: boolean;\n        sessionPastMaximumLength?: boolean;\n      },\n    ) => void,\n  ): () => void;\n  config?: {\n    token: string;\n    before_send?: unknown;\n  };\n}\n\n/**\n * Compatible with posthog-js BeforeSendFn / CaptureResult.\n * We use `any` for the public handler type so it's assignable to PostHog's\n * `before_send` without users needing type casts — the actual shapes evolve\n * across posthog-js versions and we only inspect `event` + `properties`.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype BeforeSendFn = (event: any) => any;\n\nconst API_HOST = \"https://api.swish.is\";\nconst PREFIX = \"[swish-recorder]\";\nconst VERSION = \"0.2.1\";\n\n/** Read posthog.config.token — always exists at runtime even when typed away. */\nfunction getToken(posthog: PostHogLike): string {\n  const token = (posthog as { config?: { token?: string } }).config?.token;\n  if (!token) throw new Error(`${PREFIX} PostHog instance has no config.token`);\n  return token;\n}\n\n/** Read posthog.config.before_send — may be undefined. */\nfunction getBeforeSend(posthog: PostHogLike): unknown {\n  return (posthog as { config?: { before_send?: unknown } }).config\n    ?.before_send;\n}\n\nexport interface SwishRecorderConfig {\n  /** PostHog instance from your app — token is read automatically. */\n  posthog: PostHogLike;\n  /** Enable console logging for debugging. */\n  debug?: boolean;\n  /** Override the Swish API URL. Useful for local development (e.g. \"http://localhost:8000\"). */\n  apiHost?: string;\n  /** @internal Skip before_send registration (already handled by beforeSendHandler). */\n  _skipBeforeSend?: boolean;\n}\n\nexport class SwishRecorder {\n  private currentSessionId: string | null = null;\n  private unsubscribeSessionId: (() => void) | null = null;\n  private handleUnload: (() => void) | null = null;\n\n  private readonly apiHost: string;\n\n  private constructor(private readonly config: SwishRecorderConfig) {\n    this.apiHost = config.apiHost ?? API_HOST;\n  }\n\n  private _log(...args: unknown[]): void {\n    if (this.config.debug) console.log(PREFIX, ...args);\n  }\n\n  private _warn(...args: unknown[]): void {\n    if (this.config.debug) console.warn(PREFIX, ...args);\n  }\n\n  static init(config: SwishRecorderConfig): SwishRecorder {\n    const instance = new SwishRecorder(config);\n    instance._setup();\n    return instance;\n  }\n\n  /**\n   * Create a `before_send` handler to pass directly into PostHog's config.\n   * This ensures snapshot interception is active from the very first event,\n   * avoiding the race condition where PostHog starts recording from persisted\n   * config before `SwishRecorder.init()` can hook in.\n   *\n   * Usage:\n   *   const swish = SwishRecorder.beforeSendHandler({ apiHost: '...' })\n   *   posthog.init(token, { before_send: swish.handler })\n   *   // later, after posthog is ready:\n   *   swish.bind(posthog)   // starts session lifecycle tracking\n   */\n  static beforeSendHandler(opts?: {\n    apiHost?: string;\n    debug?: boolean;\n  }): { handler: BeforeSendFn; bind: (posthog: PostHogLike) => SwishRecorder } {\n    const apiHost = opts?.apiHost ?? API_HOST;\n    const debug = opts?.debug ?? false;\n    let token: string | null = null;\n    let pendingSnapshots: { props: Record<string, unknown>; ts: number }[] = [];\n\n    const log = (...args: unknown[]) => {\n      if (debug) console.log(PREFIX, ...args);\n    };\n    const warn = (...args: unknown[]) => {\n      if (debug) console.warn(PREFIX, ...args);\n    };\n\n    const sendSnapshot = (props: Record<string, unknown>, ts: number) => {\n      fetch(`${apiHost}/replays/ingest`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-PostHog-Token\": token!,\n        },\n        body: JSON.stringify({\n          session_id: props.$session_id,\n          window_id: props.$window_id,\n          snapshot_data: props.$snapshot_data,\n          distinct_id: props.distinct_id,\n          timestamp: ts,\n          sdk_version: VERSION,\n        }),\n      })\n        .then((res) => {\n          if (debug) {\n            if (res.ok) log(`ingest OK — ${res.status}`);\n            else warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        })\n        .catch((err) => warn(\"ingest error —\", err));\n    };\n\n    const handler: BeforeSendFn = (event) => {\n      if (event?.event === \"$snapshot\") {\n        const props = event.properties;\n        const ts = Date.now();\n        if (token) {\n          sendSnapshot(props, ts);\n        } else {\n          // Buffer until bind() provides the token\n          pendingSnapshots.push({ props, ts });\n          log(`buffered snapshot (pre-bind) — ${pendingSnapshots.length} pending`);\n        }\n      }\n      return event;\n    };\n\n    const bind = (posthog: PostHogLike): SwishRecorder => {\n      token = getToken(posthog);\n      log(`bind — token=${token.slice(0, 12)}…`);\n\n      // Flush any snapshots captured before bind\n      if (pendingSnapshots.length > 0) {\n        log(`flushing ${pendingSnapshots.length} buffered snapshots`);\n        for (const { props, ts } of pendingSnapshots) {\n          sendSnapshot(props, ts);\n        }\n        pendingSnapshots = [];\n      }\n\n      return SwishRecorder.init({ posthog, apiHost, debug, _skipBeforeSend: true });\n    };\n\n    return { handler, bind };\n  }\n\n  private _sendSessionEnd(sessionId: string, reason: string): void {\n    this._log(`session end — session=${sessionId} reason=${reason}`);\n    navigator.sendBeacon(\n      `${this.apiHost}/replays/session-end`,\n      new Blob(\n        [\n          JSON.stringify({\n            session_id: sessionId,\n            reason,\n            token: getToken(this.config.posthog),\n          }),\n        ],\n        { type: \"application/json\" },\n      ),\n    );\n  }\n\n  private _ingestSnapshot(\n    sessionId: string,\n    windowId: string,\n    snapshotData: unknown,\n    distinctId: string,\n  ): void {\n    this._log(\n      `ingesting snapshot — session=${sessionId} window=${windowId} distinct_id=${distinctId}`,\n    );\n    fetch(`${this.apiHost}/replays/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-PostHog-Token\": getToken(this.config.posthog),\n      },\n      body: JSON.stringify({\n        session_id: sessionId,\n        window_id: windowId,\n        snapshot_data: snapshotData,\n        distinct_id: distinctId,\n        timestamp: Date.now(),\n        sdk_version: VERSION,\n      }),\n    })\n      .then((res) => {\n        if (this.config.debug) {\n          if (res.ok) {\n            this._log(`ingest OK — ${res.status}`);\n          } else {\n            this._warn(`ingest failed — ${res.status} ${res.statusText}`);\n          }\n        }\n      })\n      .catch((err) => {\n        this._warn(\"ingest error —\", err);\n      });\n  }\n\n  private _setup(): void {\n    const { posthog } = this.config;\n    let token: string;\n    try {\n      token = getToken(posthog);\n    } catch {\n      this._warn(\"no PostHog token found — recording disabled\");\n      return;\n    }\n\n    this._log(`init — token=${token.slice(0, 12)}…`);\n\n    // 1. Intercept $snapshot events via before_send (non-destructive append)\n    //    Skip if already registered via beforeSendHandler()\n    if (!this.config._skipBeforeSend) {\n      const snapshotHandler: BeforeSendFn = (event) => {\n        if (event?.event === \"$snapshot\") {\n          const props = event.properties;\n          this._ingestSnapshot(\n            props.$session_id as string,\n            props.$window_id as string,\n            props.$snapshot_data,\n            props.distinct_id as string,\n          );\n        } else if (this.config.debug && event) {\n          this._log(`before_send passthrough — event=${event.event}`);\n        }\n        return event;\n      };\n\n      const existing = getBeforeSend(posthog);\n      this._log(\n        `before_send — existing handler: ${existing ? (Array.isArray(existing) ? `array(${(existing as unknown[]).length})` : \"function\") : \"none\"}`,\n      );\n      posthog.set_config({\n        before_send: existing\n          ? Array.isArray(existing)\n            ? [...(existing as BeforeSendFn[]), snapshotHandler]\n            : [existing as BeforeSendFn, snapshotHandler]\n          : snapshotHandler,\n      });\n    } else {\n      this._log(\"before_send — already registered via beforeSendHandler()\");\n    }\n\n    // 2. Session rotation signal — fires on idle timeout or max session length\n    this.unsubscribeSessionId = posthog.onSessionId(\n      (newSessionId, _windowId, changeReason) => {\n        this._log(\n          `session ID changed — new=${newSessionId} reason=${JSON.stringify(changeReason ?? null)}`,\n        );\n        if (this.currentSessionId && changeReason) {\n          const reason = changeReason.activityTimeout\n            ? \"activity_timeout\"\n            : changeReason.sessionPastMaximumLength\n              ? \"session_length\"\n              : null;\n          if (reason) this._sendSessionEnd(this.currentSessionId, reason);\n        }\n        this.currentSessionId = newSessionId;\n      },\n    );\n\n    // 3. Tab close — sendBeacon survives page unload, fetch does not\n    this.handleUnload = () => {\n      if (this.currentSessionId)\n        this._sendSessionEnd(this.currentSessionId, \"tab_close\");\n    };\n    window.addEventListener(\"beforeunload\", this.handleUnload);\n\n    this._log(\"ready\");\n  }\n\n  destroy(): void {\n    this._log(\"destroy\");\n    this.unsubscribeSessionId?.();\n    if (this.handleUnload) {\n      window.removeEventListener(\"beforeunload\", this.handleUnload);\n    }\n    this.unsubscribeSessionId = null;\n    this.handleUnload = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swish-recorder",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "First-party session recording SDK for Swish",
   "type": "module",
   "main": "./dist/index.cjs",