posthog-js 1.167.1 → 1.169.0

package/dist/lib/src/extensions/replay/sessionrecording.d.ts

@@ -1,6 +1,7 @@
 import { PostHog } from '../../posthog-core';
 import { DecideResponse } from '../../types';
 import { EventType, type eventWithTime, IncrementalSource } from '@rrweb/types';
+type SessionStartReason = 'sampling_override' | 'recording_initialized' | 'linked_flag_match' | 'linked_flag_override' | 'sampling' | 'session_id_changed';
 export declare const RECORDING_IDLE_THRESHOLD_MS: number;
 export declare const RECORDING_MAX_EVENT_SIZE: number;
 export declare const RECORDING_BUFFER_TIMEOUT = 2000;
@@ -89,7 +90,7 @@ export declare class SessionRecording {
     private _onOffline;
     private _onOnline;
     private _onVisibilityChange;
-    startIfEnabledOrStop(): void;
+    startIfEnabledOrStop(startReason?: SessionStartReason): void;
     stopRecording(): void;
     private makeSamplingDecision;
     afterDecideResponse(response: DecideResponse): void;
@@ -124,5 +125,14 @@ export declare class SessionRecording {
      * instead call `posthog.startSessionRecording({linked_flag: true})`
      * */
     overrideLinkedFlag(): void;
+    /**
+     * this ignores the sampling config and causes capture to start
+     * (if recording would have started had the flag been received i.e. it does not override other config).
+     *
+     * It is not usual to call this directly,
+     * instead call `posthog.startSessionRecording({sampling: true})`
+     * */
+    overrideSampling(): void;
+    private _reportStarted;
 }
 export {};

package/dist/lib/src/types.d.ts

@@ -455,23 +455,14 @@ export type ErrorEventArgs = [
     colno?: number | undefined,
     error?: Error | undefined
 ];
+export type ErrorMetadata = {
+    handled?: boolean;
+    synthetic?: boolean;
+    overrideExceptionType?: string;
+    overrideExceptionMessage?: string;
+    defaultExceptionType?: string;
+    defaultExceptionMessage?: string;
+};
 export declare const severityLevels: readonly ["fatal", "error", "warning", "log", "info", "debug"];
 export declare type SeverityLevel = typeof severityLevels[number];
-export interface ErrorProperties {
-    $exception_type: string;
-    $exception_message: string;
-    $exception_level: SeverityLevel;
-    $exception_source?: string;
-    $exception_lineno?: number;
-    $exception_colno?: number;
-    $exception_DOMException_code?: string;
-    $exception_is_synthetic?: boolean;
-    $exception_stack_trace_raw?: string;
-    $exception_handled?: boolean;
-    $exception_personURL?: string;
-}
-export interface ErrorConversions {
-    errorToProperties: (args: ErrorEventArgs) => ErrorProperties;
-    unhandledRejectionToProperties: (args: [ev: PromiseRejectionEvent]) => ErrorProperties;
-}
 export {};

package/dist/lib/src/utils/globals.d.ts

@@ -1,6 +1,7 @@
+import { ErrorProperties } from '../extensions/exception-autocapture/error-conversion';
 import type { PostHog } from '../posthog-core';
 import { SessionIdManager } from '../sessionid';
-import { ErrorEventArgs, ErrorProperties, Properties } from '../types';
+import { ErrorEventArgs, ErrorMetadata, Properties } from '../types';
 declare const win: (Window & typeof globalThis) | undefined;
 /**
  * This is our contract between (potentially) lazily loaded extensions and the SDK
@@ -10,7 +11,7 @@ export type PostHogExtensionKind = 'toolbar' | 'exception-autocapture' | 'web-vi
 interface PostHogExtensions {
     loadExternalDependency?: (posthog: PostHog, kind: PostHogExtensionKind, callback: (error?: string | Event, event?: Event) => void) => void;
     loadSiteApp?: (posthog: PostHog, appUrl: string, callback: (error?: string | Event, event?: Event) => void) => void;
-    parseErrorAsProperties?: ([event, source, lineno, colno, error]: ErrorEventArgs) => ErrorProperties;
+    parseErrorAsProperties?: ([event, source, lineno, colno, error]: ErrorEventArgs, metadata?: ErrorMetadata) => ErrorProperties;
     errorWrappingFunctions?: {
         wrapOnError: (captureFn: (props: Properties) => void) => () => void;
         wrapUnhandledRejection: (captureFn: (props: Properties) => void) => () => void;