posthog-js 1.167.1 → 1.169.0

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

@@ -507,25 +507,16 @@ type ErrorEventArgs = [
     colno?: number | undefined,
     error?: Error | undefined
 ];
+type ErrorMetadata = {
+    handled?: boolean;
+    synthetic?: boolean;
+    overrideExceptionType?: string;
+    overrideExceptionMessage?: string;
+    defaultExceptionType?: string;
+    defaultExceptionMessage?: string;
+};
 declare const severityLevels: readonly ["fatal", "error", "warning", "log", "info", "debug"];
 declare type SeverityLevel = typeof severityLevels[number];
-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;
-}
-interface ErrorConversions {
-    errorToProperties: (args: ErrorEventArgs) => ErrorProperties;
-    unhandledRejectionToProperties: (args: [ev: PromiseRejectionEvent]) => ErrorProperties;
-}
 
 /**
  * PostHog Persistence Object
@@ -650,6 +641,7 @@ declare class PostHogFeatureFlags {
     resetGroupPropertiesForFlags(group_type?: string): void;
 }
 
+type SessionStartReason = 'sampling_override' | 'recording_initialized' | 'linked_flag_match' | 'linked_flag_override' | 'sampling' | 'session_id_changed';
 declare class SessionRecording {
     private readonly instance;
     private _endpoint;
@@ -696,7 +688,7 @@ declare class SessionRecording {
     private _onOffline;
     private _onOnline;
     private _onVisibilityChange;
-    startIfEnabledOrStop(): void;
+    startIfEnabledOrStop(startReason?: SessionStartReason): void;
     stopRecording(): void;
     private makeSamplingDecision;
     afterDecideResponse(response: DecideResponse): void;
@@ -731,6 +723,15 @@ 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;
 }
 
 declare class Toolbar {
@@ -2104,4 +2105,4 @@ declare class PostHog {
 
 declare const posthog: PostHog;
 
-export { type ActionStepStringMatching, type ActionStepType, type ActionType, type AutocaptureCompatibleElement, type AutocaptureConfig, type BasicSurveyQuestion, type BootstrapConfig, type Breaker, type CaptureOptions, type CaptureResult, type CapturedNetworkRequest, Compression, type DecideResponse, type DomAutocaptureEvents, type EarlyAccessFeature, type EarlyAccessFeatureCallback, type EarlyAccessFeatureResponse, type ErrorConversions, type ErrorEventArgs, type ErrorProperties, type EventHandler, type FeatureFlagsCallback, type FlagVariant, type Headers, type HeatmapConfig, type InitiatorType, type IsFeatureEnabledOptions, type JsonRecord, type JsonType, type LinkSurveyQuestion, type MultipleSurveyQuestion, type NetworkRecordOptions, type NetworkRequest, type OptInOutCapturingOptions, type PerformanceCaptureConfig, type PersistentStore, PostHog, type PostHogConfig, type Properties, type Property, type QueuedRequestOptions, type RatingSurveyQuestion, type RequestCallback, type RequestOptions, type RequestResponse, type RetriableRequestOptions, type SessionIdChangedCallback, type SessionRecordingOptions, type SeverityLevel, type SnippetArrayItem, type SupportedWebVitalsMetrics, type Survey, type SurveyAppearance, type SurveyCallback, type SurveyElement, type SurveyQuestion, SurveyQuestionBranchingType, type SurveyQuestionDescriptionContentType, SurveyQuestionType, type SurveyRenderReason, type SurveyResponse, SurveyType, type SurveyUrlMatchType, type ToolbarParams, type ToolbarSource, type ToolbarUserIntent, type ToolbarVersion, posthog as default, posthog, severityLevels };
+export { type ActionStepStringMatching, type ActionStepType, type ActionType, type AutocaptureCompatibleElement, type AutocaptureConfig, type BasicSurveyQuestion, type BootstrapConfig, type Breaker, type CaptureOptions, type CaptureResult, type CapturedNetworkRequest, Compression, type DecideResponse, type DomAutocaptureEvents, type EarlyAccessFeature, type EarlyAccessFeatureCallback, type EarlyAccessFeatureResponse, type ErrorEventArgs, type ErrorMetadata, type EventHandler, type FeatureFlagsCallback, type FlagVariant, type Headers, type HeatmapConfig, type InitiatorType, type IsFeatureEnabledOptions, type JsonRecord, type JsonType, type LinkSurveyQuestion, type MultipleSurveyQuestion, type NetworkRecordOptions, type NetworkRequest, type OptInOutCapturingOptions, type PerformanceCaptureConfig, type PersistentStore, PostHog, type PostHogConfig, type Properties, type Property, type QueuedRequestOptions, type RatingSurveyQuestion, type RequestCallback, type RequestOptions, type RequestResponse, type RetriableRequestOptions, type SessionIdChangedCallback, type SessionRecordingOptions, type SeverityLevel, type SnippetArrayItem, type SupportedWebVitalsMetrics, type Survey, type SurveyAppearance, type SurveyCallback, type SurveyElement, type SurveyQuestion, SurveyQuestionBranchingType, type SurveyQuestionDescriptionContentType, SurveyQuestionType, type SurveyRenderReason, type SurveyResponse, SurveyType, type SurveyUrlMatchType, type ToolbarParams, type ToolbarSource, type ToolbarUserIntent, type ToolbarVersion, posthog as default, posthog, severityLevels };