posthog-js 1.288.1 → 1.290.0

package/dist/module.full.no-external.d.ts

@@ -1394,6 +1394,20 @@ interface PostHogConfig {
      * @default 'unset'
      */
     defaults: ConfigDefaults;
+    /**
+     * EXPERIMENTAL: Defers initialization of non-critical extensions (autocapture, session recording, etc.)
+     * to the next event loop tick using setTimeout. This reduces main thread blocking during SDK
+     * initialization for better page load performance, while keeping critical functionality
+     * (persistence, sessions, capture) available immediately.
+     *
+     * When enabled:
+     * - Persistence, sessions, and basic capture work immediately
+     * - Extensions (autocapture, recording, heatmaps, etc.) start after yielding back to the browser
+     *
+     * @default false (will be true for defaults >= '2025-11-06' in the future)
+     * @experimental
+     */
+    __preview_deferred_init_extensions: boolean;
     /**
      * Determines the session recording options.
      *
@@ -3302,6 +3316,7 @@ declare class PostHog {
     _triggered_notifs: any;
     compression?: Compression;
     __request_queue: QueuedRequestWithOptions[];
+    _pendingRemoteConfig?: RemoteConfig;
     analyticsDefaultEndpoint: string;
     version: string;
     _initialPersonProfilesConfig: 'always' | 'never' | 'identified_only' | null;
@@ -3352,6 +3367,8 @@ declare class PostHog {
      */
     init(token: string, config?: OnlyValidKeys<Partial<PostHogConfig>, Partial<PostHogConfig>>, name?: string): PostHog;
     _init(token: string, config?: Partial<PostHogConfig>, name?: string): PostHog;
+    private _initExtensions;
+    private _processInitTaskQueue;
     _onRemoteConfig(config: RemoteConfig): void;
     _loaded(): void;
     _start_queue_if_opted_in(): void;