@spotify-confidence/csr-common 0.18.6 → 0.18.8

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.18.8](https://github.com/spotify/confidence-sdk-js/compare/csr-common-v0.18.7...csr-common-v0.18.8) (2026-08-28)
+
+
+### ✨ New Features
+
+* expose clipboard input provenance types ([#446](https://github.com/spotify/confidence-sdk-js/issues/446)) ([c955079](https://github.com/spotify/confidence-sdk-js/commit/c9550793998c8f2e043d926b9e5ec1690304da91))
+
+## [0.18.7](https://github.com/spotify/confidence-sdk-js/compare/csr-common-v0.18.6...csr-common-v0.18.7) (2026-08-18)
+
+
+### ✨ New Features
+
+* **csr-recorder:** capture click modifier keys ([#435](https://github.com/spotify/confidence-sdk-js/issues/435)) ([a1e7a96](https://github.com/spotify/confidence-sdk-js/commit/a1e7a96996cd2f361f3b44cc924d6b4d5ff0b003))
+
 ## [0.18.6](https://github.com/spotify/confidence-sdk-js/compare/csr-common-v0.18.5...csr-common-v0.18.6) (2026-08-18)
 
 

package/dist/index.d.cts

@@ -70,7 +70,12 @@ type MouseInteractionData = {
   id: number;
   x?: number;
   y?: number;
-  pointerType?: number;
+  pointerType?: number; /** Mouse button and modifier keys present on click events. */
+  button?: number;
+  altKey?: boolean;
+  ctrlKey?: boolean;
+  metaKey?: boolean;
+  shiftKey?: boolean;
 };
 type SelectionRange = {
   start: number;
@@ -138,6 +143,11 @@ type ClickCustomData = {
     targetId: number;
     element?: ElementDescriptor;
     pathname?: string;
+    button?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
   };
 };
 type InputCustomData = {
@@ -149,6 +159,15 @@ type InputCustomData = {
     pathname?: string;
     fieldType?: string;
     hasValue?: boolean;
+    source?: "paste";
+  };
+};
+type ClipboardAction = "copy" | "cut" | "paste";
+type ClipboardPluginData = {
+  plugin: "csr/clipboard@1";
+  payload: {
+    action: ClipboardAction;
+    targetId: number;
   };
 };
 type DeadClickCustomData = {
@@ -334,4 +353,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 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 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 };

package/dist/index.d.ts

@@ -70,7 +70,12 @@ type MouseInteractionData = {
   id: number;
   x?: number;
   y?: number;
-  pointerType?: number;
+  pointerType?: number; /** Mouse button and modifier keys present on click events. */
+  button?: number;
+  altKey?: boolean;
+  ctrlKey?: boolean;
+  metaKey?: boolean;
+  shiftKey?: boolean;
 };
 type SelectionRange = {
   start: number;
@@ -138,6 +143,11 @@ type ClickCustomData = {
     targetId: number;
     element?: ElementDescriptor;
     pathname?: string;
+    button?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
   };
 };
 type InputCustomData = {
@@ -149,6 +159,15 @@ type InputCustomData = {
     pathname?: string;
     fieldType?: string;
     hasValue?: boolean;
+    source?: "paste";
+  };
+};
+type ClipboardAction = "copy" | "cut" | "paste";
+type ClipboardPluginData = {
+  plugin: "csr/clipboard@1";
+  payload: {
+    action: ClipboardAction;
+    targetId: number;
   };
 };
 type DeadClickCustomData = {
@@ -334,4 +353,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 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 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spotify-confidence/csr-common",
   "license": "Apache-2.0",
-  "version": "0.18.6",
+  "version": "0.18.8",
   "repository": {
     "type": "git",
     "url": "https://github.com/spotify/confidence-sdk-js.git",

package/src/events.ts

@@ -72,6 +72,12 @@ export type MouseInteractionData = {
   x?: number;
   y?: number;
   pointerType?: number;
+  /** Mouse button and modifier keys present on click events. */
+  button?: number;
+  altKey?: boolean;
+  ctrlKey?: boolean;
+  metaKey?: boolean;
+  shiftKey?: boolean;
 };
 
 export type SelectionRange = {
@@ -148,6 +154,11 @@ export type ClickCustomData = {
     targetId: number;
     element?: ElementDescriptor;
     pathname?: string;
+    button?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
   };
 };
 
@@ -160,6 +171,17 @@ export type InputCustomData = {
     pathname?: string;
     fieldType?: string;
     hasValue?: boolean;
+    source?: 'paste';
+  };
+};
+
+export type ClipboardAction = 'copy' | 'cut' | 'paste';
+
+export type ClipboardPluginData = {
+  plugin: 'csr/clipboard@1';
+  payload: {
+    action: ClipboardAction;
+    targetId: number;
   };
 };
 

package/src/index.ts

@@ -12,6 +12,8 @@ export {
   type CustomEventData,
   type ClickCustomData,
   type InputCustomData,
+  type ClipboardAction,
+  type ClipboardPluginData,
   type RageClickCustomData,
   type FormFieldReEditCustomData,
   type ScrollBackCustomData,

package/src/uploader/create-uploader.test.ts

@@ -61,10 +61,6 @@ function installWorkerStubs(opts?: { workerThrows?: boolean; sharedWorkerThrows?
   }
 }
 
-function tick() {
-  return new Promise(r => setTimeout(r, 0));
-}
-
 describe('createUploader', () => {
   const blobUrls: string[] = [];
 
@@ -112,8 +108,14 @@ describe('createUploader', () => {
 
       const createUploader = await loadCreateUploader();
       const logs: string[] = [];
-      createUploader({ ...DEFAULTS, workerMode: 'dedicated', debugLogger: m => logs.push(m) });
-      await tick();
+      await expect(
+        createUploader({
+          ...DEFAULTS,
+          workerMode: 'dedicated',
+          debugLogger: m => logs.push(m),
+          _welcomeTimeoutMs: 0,
+        }),
+      ).rejects.toThrow(/welcome timeout/);
 
       expect(blobUrls).toHaveLength(0);
       expect(logs.some(l => l.includes('via data'))).toBe(true);
@@ -136,8 +138,14 @@ describe('createUploader', () => {
 
       const createUploader = await loadCreateUploader();
       const logs: string[] = [];
-      createUploader({ ...DEFAULTS, workerMode: 'dedicated', debugLogger: m => logs.push(m) });
-      await tick();
+      await expect(
+        createUploader({
+          ...DEFAULTS,
+          workerMode: 'dedicated',
+          debugLogger: m => logs.push(m),
+          _welcomeTimeoutMs: 0,
+        }),
+      ).rejects.toThrow(/welcome timeout/);
 
       expect(blobUrls).toHaveLength(1);
       expect(constructedUrl).toBe(blobUrls[0]);
@@ -163,8 +171,14 @@ describe('createUploader', () => {
 
       const createUploader = await loadCreateUploader();
       const logs: string[] = [];
-      createUploader({ ...DEFAULTS, workerMode: 'shared', debugLogger: m => logs.push(m) });
-      await tick();
+      await expect(
+        createUploader({
+          ...DEFAULTS,
+          workerMode: 'shared',
+          debugLogger: m => logs.push(m),
+          _welcomeTimeoutMs: 0,
+        }),
+      ).rejects.toThrow(/welcome timeout/);
 
       expect(blobUrls).toHaveLength(1);
       expect(constructedUrl).toBe(blobUrls[0]);