@datadog/mobile-react-native-session-replay 2.4.4-alpha.0 → 2.6.0

package/lib/typescript/specs/NativeDdSessionReplay.d.ts

@@ -7,10 +7,23 @@ export interface Spec extends TurboModule {
     /**
      * Enable session replay and start recording session.
      * @param replaySampleRate: The sample rate applied for session replay.
-     * @param defaultPrivacyLevel: The privacy level used for replay.
      * @param customEndpoint: Custom server url for sending replay data.
+     * @param imagePrivacyLevel: Defines the way images should be masked.
+     * @param touchPrivacyLevel: Defines the way user touches should be masked.
+     * @param textAndInputPrivacyLevel: Defines the way text and input should be masked.
+     * @param startRecordingImmediately: Whether the recording should start automatically when the feature is enabled.
+     * When `true`, the recording starts automatically; when `false` it doesn't,
+     * and the recording will need to be started manually. Default: `true`.
      */
-    enable(replaySampleRate: number, defaultPrivacyLevel: string, customEndpoint: string): Promise<void>;
+    enable(replaySampleRate: number, customEndpoint: string, imagePrivacyLevel: string, touchPrivacyLevel: string, textAndInputPrivacyLevel: string, startRecordingImmediately: boolean): Promise<void>;
+    /**
+     * Manually start the recording of the current session.
+     */
+    startRecording(): Promise<void>;
+    /**
+     * Manually stop the recording of the current session.
+     */
+    stopRecording(): Promise<void>;
 }
 declare const _default: Spec | null;
 export default _default;

package/lib/typescript/specs/NativeDdSessionReplay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeDdSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeDdSessionReplay.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,MAAM,CACF,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,EAC3B,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;;AAGD,wBAAgE"}
+{"version":3,"file":"NativeDdSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeDdSessionReplay.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,MAAM,CACF,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,wBAAwB,EAAE,MAAM,EAChC,yBAAyB,EAAE,OAAO,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;;AAGD,wBAAgE"}

package/package.json

@@ -1,90 +1,91 @@
 {
-  "name": "@datadog/mobile-react-native-session-replay",
-  "version": "2.4.4-alpha.0",
-  "description": "A client-side React Native module to enable session replay with Datadog",
-  "keywords": [
-    "datadog",
-    "react-native",
-    "ios",
-    "android"
-  ],
-  "author": "Datadog (https://github.com/DataDog)",
-  "homepage": "https://github.com/DataDog/dd-sdk-reactnative#readme",
-  "repository": "https://github.com/DataDog/dd-sdk-reactnative",
-  "bugs": {
-    "url": "https://github.com/DataDog/dd-sdk-reactnative/issues"
-  },
-  "license": "Apache-2.0",
-  "main": "lib/commonjs/index",
-  "files": [
-    "src/**",
-    "lib/**",
-    "android/build.gradle",
-    "android/detekt.yml",
-    "android/gradle.properties",
-    "android/src/**",
-    "ios/Sources/**",
-    "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/project.xcworkspace/xcsharedata",
-    "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/project.xcworkspace/*.xcworkspacedata",
-    "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/*.pbxproj",
-    "DatadogSDKReactNativeSessionReplay.podspec"
-  ],
-  "types": "lib/typescript/index.d.ts",
-  "react-native": "src/index",
-  "source": "src",
-  "module": "lib/module/index",
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "scripts": {
-    "test": "jest",
-    "lint": "eslint .",
-    "prepare": "rm -rf lib && yarn bob build"
-  },
-  "peerDependencies": {
-    "react": ">=16.13.1",
-    "react-native": ">=0.63.4 <1.0"
-  },
-  "devDependencies": {
-    "@testing-library/react-native": "7.0.2",
-    "react-native-builder-bob": "0.26.0"
-  },
-  "jest": {
-    "preset": "react-native",
-    "moduleNameMapper": {
-      "@datadog/mobile-react-native": "<rootDir>../core/src"
-    },
-    "modulePathIgnorePatterns": [
-      "<rootDir>/lib/"
+    "name": "@datadog/mobile-react-native-session-replay",
+    "version": "2.6.0",
+    "description": "A client-side React Native module to enable session replay with Datadog",
+    "keywords": [
+        "datadog",
+        "react-native",
+        "ios",
+        "android"
     ],
-    "setupFiles": [
-      "./../../node_modules/react-native-gesture-handler/jestSetup.js",
-      "./../../jest.setup.js"
+    "author": "Datadog (https://github.com/DataDog)",
+    "homepage": "https://github.com/DataDog/dd-sdk-reactnative#readme",
+    "repository": "https://github.com/DataDog/dd-sdk-reactnative",
+    "bugs": {
+        "url": "https://github.com/DataDog/dd-sdk-reactnative/issues"
+    },
+    "license": "Apache-2.0",
+    "main": "lib/commonjs/index",
+    "files": [
+        "src/**",
+        "lib/**",
+        "android/build.gradle",
+        "android/detekt.yml",
+        "android/gradle.properties",
+        "android/consumer-proguard-rules.pro",
+        "android/src/**",
+        "ios/Sources/**",
+        "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/project.xcworkspace/xcsharedata",
+        "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/project.xcworkspace/*.xcworkspacedata",
+        "ios/DatadogSDKReactNativeSessionReplay.xcodeproj/*.pbxproj",
+        "DatadogSDKReactNativeSessionReplay.podspec"
     ],
-    "transformIgnorePatterns": [
-      "jest-runner"
-    ]
-  },
-  "react-native-builder-bob": {
+    "types": "lib/typescript/index.d.ts",
+    "react-native": "src/index",
     "source": "src",
-    "output": "lib",
-    "targets": [
-      "commonjs",
-      "module",
-      [
-        "typescript",
-        {
-          "tsc": "./../../node_modules/.bin/tsc"
+    "module": "lib/module/index",
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "test": "jest",
+        "lint": "eslint .",
+        "prepare": "rm -rf lib && yarn bob build"
+    },
+    "peerDependencies": {
+        "react": ">=16.13.1",
+        "react-native": ">=0.63.4 <1.0"
+    },
+    "devDependencies": {
+        "@testing-library/react-native": "7.0.2",
+        "react-native-builder-bob": "0.26.0"
+    },
+    "jest": {
+        "preset": "react-native",
+        "moduleNameMapper": {
+            "@datadog/mobile-react-native": "<rootDir>../core/src"
+        },
+        "modulePathIgnorePatterns": [
+            "<rootDir>/lib/"
+        ],
+        "setupFiles": [
+            "./../../node_modules/react-native-gesture-handler/jestSetup.js",
+            "./../../jest.setup.js"
+        ],
+        "transformIgnorePatterns": [
+            "jest-runner"
+        ]
+    },
+    "react-native-builder-bob": {
+        "source": "src",
+        "output": "lib",
+        "targets": [
+            "commonjs",
+            "module",
+            [
+                "typescript",
+                {
+                    "tsc": "./../../node_modules/.bin/tsc"
+                }
+            ]
+        ]
+    },
+    "codegenConfig": {
+        "name": "DdSDKReactNativeSessionReplay",
+        "type": "modules",
+        "jsSrcsDir": "./src/specs",
+        "android": {
+            "javaPackageName": "com.datadog.reactnative.sessionreplay"
         }
-      ]
-    ]
-  },
-  "codegenConfig": {
-    "name": "DdSDKReactNativeSessionReplay",
-    "type": "modules",
-    "jsSrcsDir": "./src/specs",
-    "android": {
-      "javaPackageName": "com.datadog.reactnative.sessionreplay"
     }
-  }
-}
+}

package/src/SessionReplay.ts

@@ -12,6 +12,49 @@ export enum SessionReplayPrivacy {
     MASK_USER_INPUT = 'MASK_USER_INPUT'
 }
 
+export enum ImagePrivacyLevel {
+    /**
+     * Only images that are bundled within the application will be recorded.
+     *
+     * On Android, all images larger than 100x100 dp will be masked, as we consider them non-bundled images.
+     */
+    MASK_NON_BUNDLED_ONLY = 'MASK_NON_BUNDLED_ONLY',
+    /**
+     * No images will be recorded.
+     */
+    MASK_ALL = 'MASK_ALL',
+    /**
+     * All images will be recorded, including the ones downloaded from the Internet or generated during the app runtime.
+     */
+    MASK_NONE = 'MASK_NONE'
+}
+
+export enum TouchPrivacyLevel {
+    /**
+     * Show all user touches.
+     */
+    SHOW = 'SHOW',
+    /**
+     * Hide all user touches.
+     */
+    HIDE = 'HIDE'
+}
+
+export enum TextAndInputPrivacyLevel {
+    /**
+     * Show all texts except sensitive inputs (e.g password fields).
+     */
+    MASK_SENSITIVE_INPUTS = 'MASK_SENSITIVE_INPUTS',
+    /**
+     * Mask all input fields (e.g text fields, switches, checkboxes).
+     */
+    MASK_ALL_INPUTS = 'MASK_ALL_INPUTS',
+    /**
+     * Mask all texts and inputs (e.g labels).
+     */
+    MASK_ALL = 'MASK_ALL'
+}
+
 /**
  * The Session Replay configuration object.
  */
@@ -24,22 +67,70 @@ export interface SessionReplayConfiguration {
      * Default value is `20`.
      */
     replaySampleRate?: number;
+
     /**
-     * Defines the way sensitive content (e.g. text) should be masked.
-     *
-     * Default `SessionReplayPrivacy.MASK`.
+     * Defines the way images should be masked (Default: `MASK_ALL`)
      */
-    defaultPrivacyLevel?: SessionReplayPrivacy;
+    imagePrivacyLevel?: ImagePrivacyLevel;
+
+    /**
+     * Defines the way user touches (e.g tap) should be masked (Default: `HIDE`)
+     */
+    touchPrivacyLevel?: TouchPrivacyLevel;
+
+    /**
+     * Defines the way text and input (e.g text fields, checkboxes) should be masked (Default: `MASK_ALL`)
+     */
+    textAndInputPrivacyLevel?: TextAndInputPrivacyLevel;
+
     /**
      * Custom server url for sending replay data.
      */
     customEndpoint?: string;
+
+    /**
+     * Whether the recording should start automatically when the feature is enabled.
+     * When `true`, the recording starts automatically.
+     * when `false` it doesn't, and the recording will need to be started manually.
+     * Default: `true`.
+     */
+    startRecordingImmediately?: boolean;
+
+    /**
+     * Defines the way sensitive content (e.g. text) should be masked.
+     *
+     * Default `SessionReplayPrivacy.MASK`.
+     * @deprecated Use {@link imagePrivacyLevel}, {@link touchPrivacyLevel} and {@link textAndInputPrivacyLevel} instead.
+     * Note: setting this property (`defaultPrivacyLevel`) will override the individual privacy levels.
+     */
+    defaultPrivacyLevel?: SessionReplayPrivacy;
 }
 
-const DEFAULTS = {
+type InternalBaseSessionReplayConfiguration = {
+    replaySampleRate: number;
+    customEndpoint: string;
+    startRecordingImmediately: boolean;
+};
+
+type InternalPrivacySessionReplayConfiguration = {
+    imagePrivacyLevel: ImagePrivacyLevel;
+    touchPrivacyLevel: TouchPrivacyLevel;
+    textAndInputPrivacyLevel: TextAndInputPrivacyLevel;
+};
+
+type InternalSessionReplayConfiguration = InternalBaseSessionReplayConfiguration &
+    InternalPrivacySessionReplayConfiguration;
+
+const DEFAULTS: InternalSessionReplayConfiguration & {
+    defaultPrivacyLevel: SessionReplayPrivacy;
+} = {
     replaySampleRate: 0,
     defaultPrivacyLevel: SessionReplayPrivacy.MASK,
-    customEndpoint: ''
+    customEndpoint: '',
+    imagePrivacyLevel: ImagePrivacyLevel.MASK_ALL,
+    touchPrivacyLevel: TouchPrivacyLevel.HIDE,
+    textAndInputPrivacyLevel: TextAndInputPrivacyLevel.MASK_ALL,
+    startRecordingImmediately: true
 };
 
 export class SessionReplayWrapper {
@@ -49,33 +140,69 @@ export class SessionReplayWrapper {
 
     private buildConfiguration = (
         configuration?: SessionReplayConfiguration
-    ): {
-        replaySampleRate: number;
-        defaultPrivacyLevel: SessionReplayPrivacy;
-        customEndpoint: string;
-    } => {
+    ): InternalSessionReplayConfiguration => {
         if (!configuration) {
             return DEFAULTS;
         }
         const {
             replaySampleRate,
-            defaultPrivacyLevel,
-            customEndpoint
+            customEndpoint,
+            startRecordingImmediately
         } = configuration;
-        return {
+
+        const baseConfig: InternalBaseSessionReplayConfiguration = {
             replaySampleRate:
                 replaySampleRate !== undefined
                     ? replaySampleRate
                     : DEFAULTS.replaySampleRate,
-            defaultPrivacyLevel:
-                defaultPrivacyLevel !== undefined
-                    ? defaultPrivacyLevel
-                    : DEFAULTS.defaultPrivacyLevel,
             customEndpoint:
                 customEndpoint !== undefined
                     ? customEndpoint
-                    : DEFAULTS.customEndpoint
+                    : DEFAULTS.customEndpoint,
+            startRecordingImmediately:
+                startRecordingImmediately !== undefined
+                    ? startRecordingImmediately
+                    : DEFAULTS.startRecordingImmediately
+        };
+
+        const privacyConfig: InternalPrivacySessionReplayConfiguration = {
+            imagePrivacyLevel:
+                configuration.imagePrivacyLevel ?? DEFAULTS.imagePrivacyLevel,
+            touchPrivacyLevel:
+                configuration.touchPrivacyLevel ?? DEFAULTS.touchPrivacyLevel,
+            textAndInputPrivacyLevel:
+                configuration.textAndInputPrivacyLevel ??
+                DEFAULTS.textAndInputPrivacyLevel
         };
+
+        // Legacy Default Privacy Level property handling
+        if (configuration.defaultPrivacyLevel) {
+            switch (configuration.defaultPrivacyLevel) {
+                case SessionReplayPrivacy.MASK:
+                    privacyConfig.imagePrivacyLevel =
+                        ImagePrivacyLevel.MASK_ALL;
+                    privacyConfig.touchPrivacyLevel = TouchPrivacyLevel.HIDE;
+                    privacyConfig.textAndInputPrivacyLevel =
+                        TextAndInputPrivacyLevel.MASK_ALL;
+                    break;
+                case SessionReplayPrivacy.MASK_USER_INPUT:
+                    privacyConfig.imagePrivacyLevel =
+                        ImagePrivacyLevel.MASK_NONE;
+                    privacyConfig.touchPrivacyLevel = TouchPrivacyLevel.HIDE;
+                    privacyConfig.textAndInputPrivacyLevel =
+                        TextAndInputPrivacyLevel.MASK_ALL_INPUTS;
+                    break;
+                case SessionReplayPrivacy.ALLOW:
+                    privacyConfig.imagePrivacyLevel =
+                        ImagePrivacyLevel.MASK_NONE;
+                    privacyConfig.touchPrivacyLevel = TouchPrivacyLevel.SHOW;
+                    privacyConfig.textAndInputPrivacyLevel =
+                        TextAndInputPrivacyLevel.MASK_SENSITIVE_INPUTS;
+                    break;
+            }
+        }
+
+        return { ...baseConfig, ...privacyConfig };
     };
 
     /**
@@ -85,16 +212,36 @@ export class SessionReplayWrapper {
     enable = (configuration?: SessionReplayConfiguration): Promise<void> => {
         const {
             replaySampleRate,
-            defaultPrivacyLevel,
-            customEndpoint
+            customEndpoint,
+            imagePrivacyLevel,
+            touchPrivacyLevel,
+            textAndInputPrivacyLevel,
+            startRecordingImmediately
         } = this.buildConfiguration(configuration);
 
         return this.nativeSessionReplay.enable(
             replaySampleRate,
-            defaultPrivacyLevel,
-            customEndpoint
+            customEndpoint,
+            imagePrivacyLevel,
+            touchPrivacyLevel,
+            textAndInputPrivacyLevel,
+            startRecordingImmediately
         );
     };
+
+    /**
+     * Manually start the recording of the current session.
+     */
+    startRecording = (): Promise<void> => {
+        return this.nativeSessionReplay.startRecording();
+    };
+
+    /**
+     * Manually stop the recording of the current session.
+     */
+    stopRecording = (): Promise<void> => {
+        return this.nativeSessionReplay.stopRecording();
+    };
 }
 
 export const SessionReplay = new SessionReplayWrapper();

package/src/__tests__/SessionReplay.test.ts

@@ -6,7 +6,21 @@
 
 import { NativeModules } from 'react-native';
 
-import { SessionReplay, SessionReplayPrivacy } from '../SessionReplay';
+import {
+    ImagePrivacyLevel,
+    SessionReplay,
+    SessionReplayPrivacy,
+    TextAndInputPrivacyLevel,
+    TouchPrivacyLevel
+} from '../SessionReplay';
+
+function getRandomEnumValue<
+    T extends { [s: string]: T[keyof T] } | ArrayLike<T[keyof T]>
+>(enumObj: T): T[keyof T] {
+    const values = Object.values(enumObj) as T[keyof T][]; // Get all enum values
+    const randomIndex = Math.floor(Math.random() * values.length); // Generate a random index
+    return values[randomIndex]; // Return the random value
+}
 
 beforeEach(() => {
     NativeModules.DdSessionReplay.enable.mockClear();
@@ -19,12 +33,15 @@ describe('SessionReplay', () => {
 
             expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
                 0,
-                'MASK',
-                ''
+                '',
+                'MASK_ALL',
+                'HIDE',
+                'MASK_ALL',
+                true
             );
         });
 
-        it('calls native session replay with provided configuration', () => {
+        it('calls native session replay with provided configuration { w defaultPrivacyLevel = ALLOW }', () => {
             SessionReplay.enable({
                 replaySampleRate: 100,
                 defaultPrivacyLevel: SessionReplayPrivacy.ALLOW,
@@ -33,11 +50,77 @@ describe('SessionReplay', () => {
 
             expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
                 100,
-                'ALLOW',
-                'https://session-replay.example.com'
+                'https://session-replay.example.com',
+                'MASK_NONE',
+                'SHOW',
+                'MASK_SENSITIVE_INPUTS',
+                true
+            );
+        });
+
+        it('calls native session replay with provided configuration { w defaultPrivacyLevel = MASK }', () => {
+            SessionReplay.enable({
+                replaySampleRate: 100,
+                defaultPrivacyLevel: SessionReplayPrivacy.MASK,
+                customEndpoint: 'https://session-replay.example.com'
+            });
+
+            expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
+                100,
+                'https://session-replay.example.com',
+                'MASK_ALL',
+                'HIDE',
+                'MASK_ALL',
+                true
+            );
+        });
+
+        it('calls native session replay with provided configuration { w defaultPrivacyLevel = MASK_USER_INPUT }', () => {
+            SessionReplay.enable({
+                replaySampleRate: 100,
+                defaultPrivacyLevel: SessionReplayPrivacy.MASK_USER_INPUT,
+                customEndpoint: 'https://session-replay.example.com'
+            });
+
+            expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
+                100,
+                'https://session-replay.example.com',
+                'MASK_NONE',
+                'HIDE',
+                'MASK_ALL_INPUTS',
+                true
             );
         });
 
+        it('calls native session replay with provided configuration { w random privacy levels }', () => {
+            const TIMES = 20;
+
+            const image = getRandomEnumValue(ImagePrivacyLevel);
+            const touch = getRandomEnumValue(TouchPrivacyLevel);
+            const textAndInput = getRandomEnumValue(TextAndInputPrivacyLevel);
+
+            for (let i = 0; i < TIMES; ++i) {
+                SessionReplay.enable({
+                    replaySampleRate: 100,
+                    customEndpoint: 'https://session-replay.example.com',
+                    imagePrivacyLevel: image,
+                    touchPrivacyLevel: touch,
+                    textAndInputPrivacyLevel: textAndInput
+                });
+
+                expect(
+                    NativeModules.DdSessionReplay.enable
+                ).toHaveBeenCalledWith(
+                    100,
+                    'https://session-replay.example.com',
+                    image,
+                    touch,
+                    textAndInput,
+                    true
+                );
+            }
+        });
+
         it('calls native session replay with edge cases in configuration', () => {
             SessionReplay.enable({
                 replaySampleRate: 0,
@@ -46,8 +129,11 @@ describe('SessionReplay', () => {
 
             expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
                 0,
-                'MASK',
-                ''
+                '',
+                'MASK_ALL',
+                'HIDE',
+                'MASK_ALL',
+                true
             );
         });
     });

package/src/index.ts

@@ -5,8 +5,20 @@
  */
 
 import type { SessionReplayConfiguration } from './SessionReplay';
-import { SessionReplay, SessionReplayPrivacy } from './SessionReplay';
+import {
+    SessionReplay,
+    SessionReplayPrivacy,
+    ImagePrivacyLevel,
+    TouchPrivacyLevel,
+    TextAndInputPrivacyLevel
+} from './SessionReplay';
 
-export { SessionReplay, SessionReplayPrivacy };
+export {
+    SessionReplay,
+    SessionReplayPrivacy,
+    ImagePrivacyLevel,
+    TouchPrivacyLevel,
+    TextAndInputPrivacyLevel
+};
 
 export type { SessionReplayConfiguration };

package/src/nativeModulesTypes.ts

@@ -11,7 +11,12 @@ import type { Spec as NativeDdSessionReplay } from './specs/NativeDdSessionRepla
  * As we cannot use enums or classes in the specs, we override methods using them here.
  */
 
-type PrivacyLevel = 'MASK' | 'MASK_USER_INPUT' | 'ALLOW';
+type ImagePrivacyLevel = 'MASK_NON_BUNDLED_ONLY' | 'MASK_ALL' | 'MASK_NONE';
+type TouchPrivacyLevel = 'SHOW' | 'HIDE';
+type TextAndInputPrivacyLevel =
+    | 'MASK_SENSITIVE_INPUTS'
+    | 'MASK_ALL_INPUTS'
+    | 'MASK_ALL';
 
 /**
  * The entry point to use Datadog's Session Replay feature.
@@ -20,12 +25,30 @@ export interface NativeSessionReplayType extends NativeDdSessionReplay {
     /**
      * Enable session replay and start recording session.
      * @param replaySampleRate: The sample rate applied for session replay.
-     * @param defaultPrivacyLevel: The privacy level used for replay.
      * @param customEndpoint: Custom server url for sending replay data.
+     * @param imagePrivacyLevel: Defines the way images should be masked.
+     * @param touchPrivacyLevel: Defines the way user touches should be masked.
+     * @param textAndInputPrivacyLevel: Defines the way text and input should be masked.
+     * @param startRecordingImmediately: Whether the recording should start automatically when the feature is enabled.
+     * When `true`, the recording starts automatically; when `false` it doesn't, and the recording will need
+     * to be started manually. Default: `true`.
      */
     enable(
         replaySampleRate: number,
-        defaultPrivacyLevel: PrivacyLevel,
-        customEndpoint: string
+        customEndpoint: string,
+        imagePrivacyLevel: ImagePrivacyLevel,
+        touchPrivacyLevel: TouchPrivacyLevel,
+        textAndInputPrivacyLevel: TextAndInputPrivacyLevel,
+        startRecordingImmediately: boolean
     ): Promise<void>;
+
+    /**
+     * Manually start the recording of the current session.
+     */
+    startRecording(): Promise<void>;
+
+    /**
+     * Manually stop the recording of the current session.
+     */
+    stopRecording(): Promise<void>;
 }