@spotify-confidence/csr-common 0.18.8 → 0.18.9

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.18.9](https://github.com/spotify/confidence-sdk-js/compare/csr-common-v0.18.8...csr-common-v0.18.9) (2026-09-07)
+
+
+### 🐛 Bug Fixes
+
+* stop passive recording frames extending sessions ([#449](https://github.com/spotify/confidence-sdk-js/issues/449)) ([df763a1](https://github.com/spotify/confidence-sdk-js/commit/df763a10d6f16ce5b871530ca3fe8b5c153c16d7))
+
 ## [0.18.8](https://github.com/spotify/confidence-sdk-js/compare/csr-common-v0.18.7...csr-common-v0.18.8) (2026-08-28)
 
 

package/dist/index.cjs

@@ -1,70 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/events.ts
-/**
-* Mirrors rrweb's serialized-node types but decoupled — we own the enum.
-*/
-let SerializedNodeType = /* @__PURE__ */ function(SerializedNodeType) {
-	SerializedNodeType[SerializedNodeType["Document"] = 0] = "Document";
-	SerializedNodeType[SerializedNodeType["DocumentType"] = 1] = "DocumentType";
-	SerializedNodeType[SerializedNodeType["Element"] = 2] = "Element";
-	SerializedNodeType[SerializedNodeType["Text"] = 3] = "Text";
-	SerializedNodeType[SerializedNodeType["CDATA"] = 4] = "CDATA";
-	SerializedNodeType[SerializedNodeType["Comment"] = 5] = "Comment";
-	return SerializedNodeType;
-}({});
-/**
-* Mirrors rrweb event types but decoupled — we own the enum.
-*/
-let RecordingEventType = /* @__PURE__ */ function(RecordingEventType) {
-	RecordingEventType[RecordingEventType["DomContentLoaded"] = 0] = "DomContentLoaded";
-	RecordingEventType[RecordingEventType["Load"] = 1] = "Load";
-	RecordingEventType[RecordingEventType["FullSnapshot"] = 2] = "FullSnapshot";
-	RecordingEventType[RecordingEventType["IncrementalSnapshot"] = 3] = "IncrementalSnapshot";
-	RecordingEventType[RecordingEventType["Meta"] = 4] = "Meta";
-	RecordingEventType[RecordingEventType["Custom"] = 5] = "Custom";
-	RecordingEventType[RecordingEventType["Plugin"] = 6] = "Plugin";
-	return RecordingEventType;
-}({});
-/**
-* Incremental snapshot sub-types.
-*/
-let IncrementalSource = /* @__PURE__ */ function(IncrementalSource) {
-	IncrementalSource[IncrementalSource["Mutation"] = 0] = "Mutation";
-	IncrementalSource[IncrementalSource["MouseMove"] = 1] = "MouseMove";
-	IncrementalSource[IncrementalSource["MouseInteraction"] = 2] = "MouseInteraction";
-	IncrementalSource[IncrementalSource["Scroll"] = 3] = "Scroll";
-	IncrementalSource[IncrementalSource["ViewportResize"] = 4] = "ViewportResize";
-	IncrementalSource[IncrementalSource["Input"] = 5] = "Input";
-	IncrementalSource[IncrementalSource["TouchMove"] = 6] = "TouchMove";
-	IncrementalSource[IncrementalSource["MediaInteraction"] = 7] = "MediaInteraction";
-	IncrementalSource[IncrementalSource["StyleSheetRule"] = 8] = "StyleSheetRule";
-	IncrementalSource[IncrementalSource["CanvasMutation"] = 9] = "CanvasMutation";
-	IncrementalSource[IncrementalSource["Font"] = 10] = "Font";
-	IncrementalSource[IncrementalSource["Log"] = 11] = "Log";
-	IncrementalSource[IncrementalSource["Drag"] = 12] = "Drag";
-	IncrementalSource[IncrementalSource["StyleDeclaration"] = 13] = "StyleDeclaration";
-	IncrementalSource[IncrementalSource["Selection"] = 14] = "Selection";
-	IncrementalSource[IncrementalSource["AdoptedStyleSheet"] = 15] = "AdoptedStyleSheet";
-	return IncrementalSource;
-}({});
-/**
-* From rrweb MouseInteractions.
-*/
-let MouseInteractions = /* @__PURE__ */ function(MouseInteractions) {
-	MouseInteractions[MouseInteractions["MouseUp"] = 0] = "MouseUp";
-	MouseInteractions[MouseInteractions["MouseDown"] = 1] = "MouseDown";
-	MouseInteractions[MouseInteractions["Click"] = 2] = "Click";
-	MouseInteractions[MouseInteractions["ContextMenu"] = 3] = "ContextMenu";
-	MouseInteractions[MouseInteractions["DblClick"] = 4] = "DblClick";
-	MouseInteractions[MouseInteractions["Focus"] = 5] = "Focus";
-	MouseInteractions[MouseInteractions["Blur"] = 6] = "Blur";
-	MouseInteractions[MouseInteractions["TouchStart"] = 7] = "TouchStart";
-	MouseInteractions[MouseInteractions["TouchMove_Departed"] = 8] = "TouchMove_Departed";
-	MouseInteractions[MouseInteractions["TouchEnd"] = 9] = "TouchEnd";
-	MouseInteractions[MouseInteractions["TouchCancel"] = 10] = "TouchCancel";
-	return MouseInteractions;
-}({});
-//#endregion
+const require_session_activity = require("./session-activity-HfuXKqGd.cjs");
 //#region src/url.ts
 /**
 * Extract only the pathname from a URL, stripping origin, query string, and
@@ -102,14 +37,20 @@ function validateMeasureValue(value) {
 	return null;
 }
 //#endregion
-exports.IncrementalSource = IncrementalSource;
+exports.IncrementalSource = require_session_activity.IncrementalSource;
 exports.MAX_DISTINCT_KEYS = MAX_DISTINCT_KEYS;
 exports.MAX_KEY_LENGTH = MAX_KEY_LENGTH;
 exports.MAX_TAG_VALUE_LENGTH = MAX_TAG_VALUE_LENGTH;
 exports.MAX_VALUES_PER_KEY = MAX_VALUES_PER_KEY;
-exports.MouseInteractions = MouseInteractions;
-exports.RecordingEventType = RecordingEventType;
-exports.SerializedNodeType = SerializedNodeType;
+exports.MouseInteractions = require_session_activity.MouseInteractions;
+exports.RecordingCustomEventTag = require_session_activity.RecordingCustomEventTag;
+exports.RecordingEventType = require_session_activity.RecordingEventType;
+exports.RecordingMetricKey = require_session_activity.RecordingMetricKey;
+exports.RecordingPluginName = require_session_activity.RecordingPluginName;
+exports.SerializedNodeType = require_session_activity.SerializedNodeType;
+exports.isSessionActivityEvent = require_session_activity.isSessionActivityEvent;
+exports.isUserInteractionEvent = require_session_activity.isUserInteractionEvent;
+exports.isUserInteractionMetric = require_session_activity.isUserInteractionMetric;
 exports.stripUrl = stripUrl;
 exports.validateKey = validateKey;
 exports.validateMeasureValue = validateMeasureValue;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { i as ClientContext, n as Frame, o as UserAgentContext } from "./types-CtBIVgp2.cjs";
+import { i as ClientContext, n as Frame, o as UserAgentContext } from "./types-Bg0UKTVQ.cjs";
 
 //#region src/events.d.ts
 /**
@@ -24,6 +24,33 @@ declare enum RecordingEventType {
   Custom = 5,
   Plugin = 6
 }
+declare const RecordingCustomEventTag: {
+  readonly RageClick: "csr:rageClick";
+  readonly FormFieldReEdit: "csr:formFieldReEdit";
+  readonly ScrollBack: "csr:scrollBack";
+  readonly Click: "csr:click";
+  readonly Input: "csr:input";
+  readonly DeadClick: "csr:deadClick";
+  readonly TabUnfocus: "csr:tabUnfocus";
+  readonly TabRefocus: "csr:tabRefocus";
+  readonly RouteChange: "csr:routeChange";
+  readonly ErrorMessage: "csr:errorMessage";
+  readonly DialogOpened: "csr:dialogOpened";
+  readonly IdleGap: "csr:idleGap";
+  readonly AwayGap: "csr:awayGap";
+};
+declare const RecordingPluginName: {
+  readonly BlockedElementLabels: "csr/blocked-element-labels@1";
+  readonly Clipboard: "csr/clipboard@1";
+  readonly ClickModifiers: "csr/click-modifiers@1";
+  readonly TabVisibility: "csr:tabVisibility";
+  readonly ConsoleLog: "rrweb/console@1";
+  readonly NetworkRequest: "csr:networkRequest";
+  readonly RouteChange: "csr:routeChange";
+  readonly Tag: "csr:tag";
+  readonly Measure: "csr:measure";
+  readonly FlagEvaluation: "csr:flagEvaluation";
+};
 /**
 * Incremental snapshot sub-types.
 */
@@ -100,7 +127,7 @@ type OpaqueIncrementalData = {
 };
 type IncrementalSnapshotData = MouseInteractionData | SelectionData | OpaqueIncrementalData;
 type RageClickCustomData = {
-  tag: "csr:rageClick";
+  tag: typeof RecordingCustomEventTag.RageClick;
   payload: {
     eventId?: string;
     targetId: number;
@@ -111,7 +138,7 @@ type RageClickCustomData = {
   };
 };
 type FormFieldReEditCustomData = {
-  tag: "csr:formFieldReEdit";
+  tag: typeof RecordingCustomEventTag.FormFieldReEdit;
   payload: {
     eventId?: string;
     targetId: number;
@@ -121,7 +148,7 @@ type FormFieldReEditCustomData = {
   };
 };
 type ScrollBackCustomData = {
-  tag: "csr:scrollBack";
+  tag: typeof RecordingCustomEventTag.ScrollBack;
   payload: {
     eventId?: string;
     scrollBackPx: number;
@@ -137,7 +164,7 @@ type ElementDescriptor = {
   attributes?: Record<string, string>;
 };
 type ClickCustomData = {
-  tag: "csr:click";
+  tag: typeof RecordingCustomEventTag.Click;
   payload: {
     eventId?: string;
     targetId: number;
@@ -151,7 +178,7 @@ type ClickCustomData = {
   };
 };
 type InputCustomData = {
-  tag: "csr:input";
+  tag: typeof RecordingCustomEventTag.Input;
   payload: {
     eventId?: string;
     targetId: number;
@@ -164,14 +191,14 @@ type InputCustomData = {
 };
 type ClipboardAction = "copy" | "cut" | "paste";
 type ClipboardPluginData = {
-  plugin: "csr/clipboard@1";
+  plugin: typeof RecordingPluginName.Clipboard;
   payload: {
     action: ClipboardAction;
     targetId: number;
   };
 };
 type DeadClickCustomData = {
-  tag: "csr:deadClick";
+  tag: typeof RecordingCustomEventTag.DeadClick;
   payload: {
     eventId?: string;
     targetId: number;
@@ -180,14 +207,14 @@ type DeadClickCustomData = {
   };
 };
 type TabUnfocusCustomData = {
-  tag: "csr:tabUnfocus";
+  tag: typeof RecordingCustomEventTag.TabUnfocus;
   payload: {
     eventId?: string;
     pathname?: string;
   };
 };
 type TabRefocusCustomData = {
-  tag: "csr:tabRefocus";
+  tag: typeof RecordingCustomEventTag.TabRefocus;
   payload: {
     eventId?: string;
     awayDurationMs: number;
@@ -201,7 +228,7 @@ type RouteChangePayload = {
   trigger: RouteChangeTrigger;
 };
 type RouteChangeCustomData = {
-  tag: "csr:routeChange";
+  tag: typeof RecordingCustomEventTag.RouteChange;
   payload: RouteChangePayload & {
     eventId?: string;
   };
@@ -210,7 +237,7 @@ type RouteChangeCustomData = {
 * Plugin event data emitted by the recorder for tab visibility changes.
 */
 type TabVisibilityPluginData = {
-  plugin: "csr:tabVisibility";
+  plugin: typeof RecordingPluginName.TabVisibility;
   payload: {
     hidden: boolean;
   };
@@ -221,7 +248,7 @@ type ConsoleLogLevel = "log" | "warn" | "error" | "debug" | "info";
 * Shape matches `@rrweb/rrweb-plugin-console-record` LogData.
 */
 type ConsoleLogPluginData = {
-  plugin: "rrweb/console@1";
+  plugin: typeof RecordingPluginName.ConsoleLog;
   payload: {
     level: ConsoleLogLevel;
     payload: string[];
@@ -236,7 +263,7 @@ type GraphQLRequestMetadata = {
 * Plugin event data emitted by the recorder for network requests.
 */
 type NetworkRequestPluginData = {
-  plugin: "csr:networkRequest";
+  plugin: typeof RecordingPluginName.NetworkRequest;
   payload: {
     initiator: NetworkRequestInitiator;
     method: string;
@@ -249,47 +276,48 @@ type NetworkRequestPluginData = {
   };
 };
 type RouteChangePluginData = {
-  plugin: "csr:routeChange";
+  plugin: typeof RecordingPluginName.RouteChange;
   payload: RouteChangePayload;
 };
 type TagPluginData = {
-  plugin: "csr:tag";
+  plugin: typeof RecordingPluginName.Tag;
   payload: {
     key: string;
     value?: string;
   };
 };
 type MeasurePluginData = {
-  plugin: "csr:measure";
+  plugin: typeof RecordingPluginName.Measure;
   payload: {
     key: string;
     value?: number;
   };
 };
 type FlagEvaluationPluginData = {
-  plugin: "csr:flagEvaluation";
+  plugin: typeof RecordingPluginName.FlagEvaluation;
   payload: {
     flagKey: string;
     variant: string;
     assignmentOrigin: string;
   };
 };
+type PluginEventData = ClipboardPluginData | TabVisibilityPluginData | ConsoleLogPluginData | NetworkRequestPluginData | RouteChangePluginData | TagPluginData | MeasurePluginData | FlagEvaluationPluginData;
 type ErrorMessageCustomData = {
-  tag: "csr:errorMessage";
+  tag: typeof RecordingCustomEventTag.ErrorMessage;
   payload: {
     eventId?: string;
     text: string;
   };
 };
 type DialogOpenedCustomData = {
-  tag: "csr:dialogOpened";
+  tag: typeof RecordingCustomEventTag.DialogOpened;
   payload: {
     eventId?: string;
     content: string[];
   };
 };
 type IdleGapCustomData = {
-  tag: "csr:idleGap";
+  tag: typeof RecordingCustomEventTag.IdleGap;
   payload: {
     eventId?: string;
     visibleGapS: number;
@@ -299,7 +327,7 @@ type IdleGapCustomData = {
   };
 };
 type AwayGapCustomData = {
-  tag: "csr:awayGap";
+  tag: typeof RecordingCustomEventTag.AwayGap;
   payload: {
     eventId?: string;
     totalGapS: number;
@@ -332,7 +360,11 @@ type RecordingEvent = {
   timestamp: number;
   data: IncrementalSnapshotData;
 } | {
-  type: Exclude<RecordingEventType, RecordingEventType.Custom | RecordingEventType.IncrementalSnapshot>;
+  type: RecordingEventType.Plugin;
+  timestamp: number;
+  data: PluginEventData;
+} | {
+  type: Exclude<RecordingEventType, RecordingEventType.Custom | RecordingEventType.IncrementalSnapshot | RecordingEventType.Plugin>;
   timestamp: number;
   data: unknown;
 };
@@ -344,6 +376,28 @@ type RecordingEvent = {
 */
 declare function stripUrl(url: string): string;
 //#endregion
+//#region src/metrics.d.ts
+declare const RecordingMetricKey: {
+  readonly Click: "clicks";
+  readonly Input: "inputs";
+  readonly RageClick: "rageClicks";
+  readonly DeadClick: "deadClicks";
+  readonly ScrollBack: "scrollBacks";
+  readonly TabUnfocus: "tabUnfocuses";
+  readonly ErrorMessage: "errorMessages";
+  readonly FailedNetworkRequest: "networkRequestsFailed";
+  readonly NetworkRequest: "networkRequests";
+  readonly ConsoleLog: "consoleLogs";
+  readonly ConsoleWarning: "consoleWarnings";
+  readonly ConsoleError: "consoleErrors";
+  readonly RouteChange: "routeChanges";
+};
+//#endregion
+//#region src/session-activity.d.ts
+declare const isUserInteractionEvent: (event: unknown) => boolean;
+declare const isUserInteractionMetric: (metricKey: string) => boolean;
+declare const isSessionActivityEvent: (event: unknown) => boolean;
+//#endregion
 //#region src/custom-event-limits.d.ts
 declare const MAX_KEY_LENGTH = 128;
 declare const MAX_TAG_VALUE_LENGTH = 256;
@@ -353,4 +407,4 @@ declare function validateKey(key: string): string | null;
 declare function validateTagValue(value: string | undefined): string | null;
 declare function validateMeasureValue(value: number | undefined): string | null;
 //#endregion
-export { type AwayGapCustomData, type ClickCustomData, type ClientContext, type ClipboardAction, type ClipboardPluginData, type ConsoleLogLevel, type ConsoleLogPluginData, type CustomEventData, type DeadClickCustomData, type DialogOpenedCustomData, type ElementDescriptor, type ErrorMessageCustomData, type FlagEvaluationPluginData, type FormFieldReEditCustomData, type Frame, type GraphQLRequestMetadata, type IdleGapCustomData, type IncrementalSnapshotData, IncrementalSource, type InputCustomData, MAX_DISTINCT_KEYS, MAX_KEY_LENGTH, MAX_TAG_VALUE_LENGTH, MAX_VALUES_PER_KEY, type MeasurePluginData, type MouseInteractionData, MouseInteractions, type NetworkRequestInitiator, type NetworkRequestPluginData, type OpaqueIncrementalData, type RageClickCustomData, type RecordingEvent, RecordingEventType, type RouteChangeCustomData, type RouteChangePayload, type RouteChangePluginData, type RouteChangeTrigger, type ScrollBackCustomData, type SelectionData, type SelectionRange, SerializedNodeType, type TabRefocusCustomData, type TabUnfocusCustomData, type TabVisibilityPluginData, type TagPluginData, type UserAgentContext, stripUrl, validateKey, validateMeasureValue, validateTagValue };
+export { type AwayGapCustomData, type ClickCustomData, type ClientContext, type ClipboardAction, type ClipboardPluginData, type ConsoleLogLevel, type ConsoleLogPluginData, type CustomEventData, type DeadClickCustomData, type DialogOpenedCustomData, type ElementDescriptor, type ErrorMessageCustomData, type FlagEvaluationPluginData, type FormFieldReEditCustomData, type Frame, type GraphQLRequestMetadata, type IdleGapCustomData, type IncrementalSnapshotData, IncrementalSource, type InputCustomData, MAX_DISTINCT_KEYS, MAX_KEY_LENGTH, MAX_TAG_VALUE_LENGTH, MAX_VALUES_PER_KEY, type MeasurePluginData, type MouseInteractionData, MouseInteractions, type NetworkRequestInitiator, type NetworkRequestPluginData, type OpaqueIncrementalData, type PluginEventData, type RageClickCustomData, RecordingCustomEventTag, type RecordingEvent, RecordingEventType, RecordingMetricKey, RecordingPluginName, type RouteChangeCustomData, type RouteChangePayload, type RouteChangePluginData, type RouteChangeTrigger, type ScrollBackCustomData, type SelectionData, type SelectionRange, SerializedNodeType, type TabRefocusCustomData, type TabUnfocusCustomData, type TabVisibilityPluginData, type TagPluginData, type UserAgentContext, isSessionActivityEvent, isUserInteractionEvent, isUserInteractionMetric, stripUrl, validateKey, validateMeasureValue, validateTagValue };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { i as ClientContext, n as Frame, o as UserAgentContext } from "./types-CtBIVgp2.js";
+import { i as ClientContext, n as Frame, o as UserAgentContext } from "./types-Bg0UKTVQ.js";
 
 //#region src/events.d.ts
 /**
@@ -24,6 +24,33 @@ declare enum RecordingEventType {
   Custom = 5,
   Plugin = 6
 }
+declare const RecordingCustomEventTag: {
+  readonly RageClick: "csr:rageClick";
+  readonly FormFieldReEdit: "csr:formFieldReEdit";
+  readonly ScrollBack: "csr:scrollBack";
+  readonly Click: "csr:click";
+  readonly Input: "csr:input";
+  readonly DeadClick: "csr:deadClick";
+  readonly TabUnfocus: "csr:tabUnfocus";
+  readonly TabRefocus: "csr:tabRefocus";
+  readonly RouteChange: "csr:routeChange";
+  readonly ErrorMessage: "csr:errorMessage";
+  readonly DialogOpened: "csr:dialogOpened";
+  readonly IdleGap: "csr:idleGap";
+  readonly AwayGap: "csr:awayGap";
+};
+declare const RecordingPluginName: {
+  readonly BlockedElementLabels: "csr/blocked-element-labels@1";
+  readonly Clipboard: "csr/clipboard@1";
+  readonly ClickModifiers: "csr/click-modifiers@1";
+  readonly TabVisibility: "csr:tabVisibility";
+  readonly ConsoleLog: "rrweb/console@1";
+  readonly NetworkRequest: "csr:networkRequest";
+  readonly RouteChange: "csr:routeChange";
+  readonly Tag: "csr:tag";
+  readonly Measure: "csr:measure";
+  readonly FlagEvaluation: "csr:flagEvaluation";
+};
 /**
 * Incremental snapshot sub-types.
 */
@@ -100,7 +127,7 @@ type OpaqueIncrementalData = {
 };
 type IncrementalSnapshotData = MouseInteractionData | SelectionData | OpaqueIncrementalData;
 type RageClickCustomData = {
-  tag: "csr:rageClick";
+  tag: typeof RecordingCustomEventTag.RageClick;
   payload: {
     eventId?: string;
     targetId: number;
@@ -111,7 +138,7 @@ type RageClickCustomData = {
   };
 };
 type FormFieldReEditCustomData = {
-  tag: "csr:formFieldReEdit";
+  tag: typeof RecordingCustomEventTag.FormFieldReEdit;
   payload: {
     eventId?: string;
     targetId: number;
@@ -121,7 +148,7 @@ type FormFieldReEditCustomData = {
   };
 };
 type ScrollBackCustomData = {
-  tag: "csr:scrollBack";
+  tag: typeof RecordingCustomEventTag.ScrollBack;
   payload: {
     eventId?: string;
     scrollBackPx: number;
@@ -137,7 +164,7 @@ type ElementDescriptor = {
   attributes?: Record<string, string>;
 };
 type ClickCustomData = {
-  tag: "csr:click";
+  tag: typeof RecordingCustomEventTag.Click;
   payload: {
     eventId?: string;
     targetId: number;
@@ -151,7 +178,7 @@ type ClickCustomData = {
   };
 };
 type InputCustomData = {
-  tag: "csr:input";
+  tag: typeof RecordingCustomEventTag.Input;
   payload: {
     eventId?: string;
     targetId: number;
@@ -164,14 +191,14 @@ type InputCustomData = {
 };
 type ClipboardAction = "copy" | "cut" | "paste";
 type ClipboardPluginData = {
-  plugin: "csr/clipboard@1";
+  plugin: typeof RecordingPluginName.Clipboard;
   payload: {
     action: ClipboardAction;
     targetId: number;
   };
 };
 type DeadClickCustomData = {
-  tag: "csr:deadClick";
+  tag: typeof RecordingCustomEventTag.DeadClick;
   payload: {
     eventId?: string;
     targetId: number;
@@ -180,14 +207,14 @@ type DeadClickCustomData = {
   };
 };
 type TabUnfocusCustomData = {
-  tag: "csr:tabUnfocus";
+  tag: typeof RecordingCustomEventTag.TabUnfocus;
   payload: {
     eventId?: string;
     pathname?: string;
   };
 };
 type TabRefocusCustomData = {
-  tag: "csr:tabRefocus";
+  tag: typeof RecordingCustomEventTag.TabRefocus;
   payload: {
     eventId?: string;
     awayDurationMs: number;
@@ -201,7 +228,7 @@ type RouteChangePayload = {
   trigger: RouteChangeTrigger;
 };
 type RouteChangeCustomData = {
-  tag: "csr:routeChange";
+  tag: typeof RecordingCustomEventTag.RouteChange;
   payload: RouteChangePayload & {
     eventId?: string;
   };
@@ -210,7 +237,7 @@ type RouteChangeCustomData = {
 * Plugin event data emitted by the recorder for tab visibility changes.
 */
 type TabVisibilityPluginData = {
-  plugin: "csr:tabVisibility";
+  plugin: typeof RecordingPluginName.TabVisibility;
   payload: {
     hidden: boolean;
   };
@@ -221,7 +248,7 @@ type ConsoleLogLevel = "log" | "warn" | "error" | "debug" | "info";
 * Shape matches `@rrweb/rrweb-plugin-console-record` LogData.
 */
 type ConsoleLogPluginData = {
-  plugin: "rrweb/console@1";
+  plugin: typeof RecordingPluginName.ConsoleLog;
   payload: {
     level: ConsoleLogLevel;
     payload: string[];
@@ -236,7 +263,7 @@ type GraphQLRequestMetadata = {
 * Plugin event data emitted by the recorder for network requests.
 */
 type NetworkRequestPluginData = {
-  plugin: "csr:networkRequest";
+  plugin: typeof RecordingPluginName.NetworkRequest;
   payload: {
     initiator: NetworkRequestInitiator;
     method: string;
@@ -249,47 +276,48 @@ type NetworkRequestPluginData = {
   };
 };
 type RouteChangePluginData = {
-  plugin: "csr:routeChange";
+  plugin: typeof RecordingPluginName.RouteChange;
   payload: RouteChangePayload;
 };
 type TagPluginData = {
-  plugin: "csr:tag";
+  plugin: typeof RecordingPluginName.Tag;
   payload: {
     key: string;
     value?: string;
   };
 };
 type MeasurePluginData = {
-  plugin: "csr:measure";
+  plugin: typeof RecordingPluginName.Measure;
   payload: {
     key: string;
     value?: number;
   };
 };
 type FlagEvaluationPluginData = {
-  plugin: "csr:flagEvaluation";
+  plugin: typeof RecordingPluginName.FlagEvaluation;
   payload: {
     flagKey: string;
     variant: string;
     assignmentOrigin: string;
   };
 };
+type PluginEventData = ClipboardPluginData | TabVisibilityPluginData | ConsoleLogPluginData | NetworkRequestPluginData | RouteChangePluginData | TagPluginData | MeasurePluginData | FlagEvaluationPluginData;
 type ErrorMessageCustomData = {
-  tag: "csr:errorMessage";
+  tag: typeof RecordingCustomEventTag.ErrorMessage;
   payload: {
     eventId?: string;
     text: string;
   };
 };
 type DialogOpenedCustomData = {
-  tag: "csr:dialogOpened";
+  tag: typeof RecordingCustomEventTag.DialogOpened;
   payload: {
     eventId?: string;
     content: string[];
   };
 };
 type IdleGapCustomData = {
-  tag: "csr:idleGap";
+  tag: typeof RecordingCustomEventTag.IdleGap;
   payload: {
     eventId?: string;
     visibleGapS: number;
@@ -299,7 +327,7 @@ type IdleGapCustomData = {
   };
 };
 type AwayGapCustomData = {
-  tag: "csr:awayGap";
+  tag: typeof RecordingCustomEventTag.AwayGap;
   payload: {
     eventId?: string;
     totalGapS: number;
@@ -332,7 +360,11 @@ type RecordingEvent = {
   timestamp: number;
   data: IncrementalSnapshotData;
 } | {
-  type: Exclude<RecordingEventType, RecordingEventType.Custom | RecordingEventType.IncrementalSnapshot>;
+  type: RecordingEventType.Plugin;
+  timestamp: number;
+  data: PluginEventData;
+} | {
+  type: Exclude<RecordingEventType, RecordingEventType.Custom | RecordingEventType.IncrementalSnapshot | RecordingEventType.Plugin>;
   timestamp: number;
   data: unknown;
 };
@@ -344,6 +376,28 @@ type RecordingEvent = {
 */
 declare function stripUrl(url: string): string;
 //#endregion
+//#region src/metrics.d.ts
+declare const RecordingMetricKey: {
+  readonly Click: "clicks";
+  readonly Input: "inputs";
+  readonly RageClick: "rageClicks";
+  readonly DeadClick: "deadClicks";
+  readonly ScrollBack: "scrollBacks";
+  readonly TabUnfocus: "tabUnfocuses";
+  readonly ErrorMessage: "errorMessages";
+  readonly FailedNetworkRequest: "networkRequestsFailed";
+  readonly NetworkRequest: "networkRequests";
+  readonly ConsoleLog: "consoleLogs";
+  readonly ConsoleWarning: "consoleWarnings";
+  readonly ConsoleError: "consoleErrors";
+  readonly RouteChange: "routeChanges";
+};
+//#endregion
+//#region src/session-activity.d.ts
+declare const isUserInteractionEvent: (event: unknown) => boolean;
+declare const isUserInteractionMetric: (metricKey: string) => boolean;
+declare const isSessionActivityEvent: (event: unknown) => boolean;
+//#endregion
 //#region src/custom-event-limits.d.ts
 declare const MAX_KEY_LENGTH = 128;
 declare const MAX_TAG_VALUE_LENGTH = 256;
@@ -353,4 +407,4 @@ declare function validateKey(key: string): string | null;
 declare function validateTagValue(value: string | undefined): string | null;
 declare function validateMeasureValue(value: number | undefined): string | null;
 //#endregion
-export { type AwayGapCustomData, type ClickCustomData, type ClientContext, type ClipboardAction, type ClipboardPluginData, type ConsoleLogLevel, type ConsoleLogPluginData, type CustomEventData, type DeadClickCustomData, type DialogOpenedCustomData, type ElementDescriptor, type ErrorMessageCustomData, type FlagEvaluationPluginData, type FormFieldReEditCustomData, type Frame, type GraphQLRequestMetadata, type IdleGapCustomData, type IncrementalSnapshotData, IncrementalSource, type InputCustomData, MAX_DISTINCT_KEYS, MAX_KEY_LENGTH, MAX_TAG_VALUE_LENGTH, MAX_VALUES_PER_KEY, type MeasurePluginData, type MouseInteractionData, MouseInteractions, type NetworkRequestInitiator, type NetworkRequestPluginData, type OpaqueIncrementalData, type RageClickCustomData, type RecordingEvent, RecordingEventType, type RouteChangeCustomData, type RouteChangePayload, type RouteChangePluginData, type RouteChangeTrigger, type ScrollBackCustomData, type SelectionData, type SelectionRange, SerializedNodeType, type TabRefocusCustomData, type TabUnfocusCustomData, type TabVisibilityPluginData, type TagPluginData, type UserAgentContext, stripUrl, validateKey, validateMeasureValue, validateTagValue };
+export { type AwayGapCustomData, type ClickCustomData, type ClientContext, type ClipboardAction, type ClipboardPluginData, type ConsoleLogLevel, type ConsoleLogPluginData, type CustomEventData, type DeadClickCustomData, type DialogOpenedCustomData, type ElementDescriptor, type ErrorMessageCustomData, type FlagEvaluationPluginData, type FormFieldReEditCustomData, type Frame, type GraphQLRequestMetadata, type IdleGapCustomData, type IncrementalSnapshotData, IncrementalSource, type InputCustomData, MAX_DISTINCT_KEYS, MAX_KEY_LENGTH, MAX_TAG_VALUE_LENGTH, MAX_VALUES_PER_KEY, type MeasurePluginData, type MouseInteractionData, MouseInteractions, type NetworkRequestInitiator, type NetworkRequestPluginData, type OpaqueIncrementalData, type PluginEventData, type RageClickCustomData, RecordingCustomEventTag, type RecordingEvent, RecordingEventType, RecordingMetricKey, RecordingPluginName, type RouteChangeCustomData, type RouteChangePayload, type RouteChangePluginData, type RouteChangeTrigger, type ScrollBackCustomData, type SelectionData, type SelectionRange, SerializedNodeType, type TabRefocusCustomData, type TabUnfocusCustomData, type TabVisibilityPluginData, type TagPluginData, type UserAgentContext, isSessionActivityEvent, isUserInteractionEvent, isUserInteractionMetric, stripUrl, validateKey, validateMeasureValue, validateTagValue };