@datadog/mobile-react-native-session-replay 2.0.2-alpha.0

package/lib/commonjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "SessionReplay", {
+  enumerable: true,
+  get: function () {
+    return _SessionReplay.SessionReplay;
+  }
+});
+Object.defineProperty(exports, "SessionReplayConfiguration", {
+  enumerable: true,
+  get: function () {
+    return _SessionReplay.SessionReplayConfiguration;
+  }
+});
+Object.defineProperty(exports, "SessionReplayPrivacy", {
+  enumerable: true,
+  get: function () {
+    return _SessionReplay.SessionReplayPrivacy;
+  }
+});
+
+var _SessionReplay = require("./SessionReplay");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAMA","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport {\n    SessionReplay,\n    SessionReplayConfiguration,\n    SessionReplayPrivacy\n} from './SessionReplay';\n\nexport { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy };\n"]}

package/lib/commonjs/nativeModulesTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=nativeModulesTypes.js.map

package/lib/commonjs/nativeModulesTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","sourcesContent":[]}

package/lib/commonjs/specs/NativeDdSessionReplay.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _reactNative = require("react-native");
+
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+/* eslint-disable @typescript-eslint/ban-types */
+var _default = _reactNative.TurboModuleRegistry.get('DdSessionReplay');
+
+exports.default = _default;
+//# sourceMappingURL=NativeDdSessionReplay.js.map

package/lib/commonjs/specs/NativeDdSessionReplay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["NativeDdSessionReplay.ts"],"names":["TurboModuleRegistry","get"],"mappings":";;;;;;;AAQA;;AARA;AACA;AACA;AACA;AACA;;AAEA;eAqBeA,iCAAoBC,GAApB,CAA8B,iBAA9B,C","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\n/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\n/**\n * Do not import this Spec directly, use NativeSessionReplayType instead.\n */\nexport interface Spec extends TurboModule {\n    readonly getConstants: () => {};\n\n    /**\n     * Enable session replay and start recording session.\n     * @param replaySampleRate: The sample rate applied for session replay.\n     * @param defaultPrivacyLevel: The privacy level used for replay.\n     */\n    enable(\n        replaySampleRate: number,\n        defaultPrivacyLevel: string\n    ): Promise<void>;\n}\n\nexport default TurboModuleRegistry.get<Spec>('DdSessionReplay');\n"]}

package/lib/module/SessionReplay.js

@@ -0,0 +1,53 @@
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+export let SessionReplayPrivacy;
+/**
+ * The Session Replay configuration object.
+ */
+
+(function (SessionReplayPrivacy) {
+  SessionReplayPrivacy["MASK"] = "MASK";
+  SessionReplayPrivacy["ALLOW"] = "ALLOW";
+  SessionReplayPrivacy["MASK_USER_INPUT"] = "MASK_USER_INPUT";
+})(SessionReplayPrivacy || (SessionReplayPrivacy = {}));
+
+const DEFAULTS = {
+  replaySampleRate: 0,
+  defaultPrivacyLevel: SessionReplayPrivacy.MASK
+};
+export class SessionReplayWrapper {
+  constructor() {
+    _defineProperty(this, "nativeSessionReplay", require('./specs/NativeDdSessionReplay').default);
+
+    _defineProperty(this, "buildConfiguration", configuration => {
+      if (!configuration) {
+        return DEFAULTS;
+      }
+
+      const {
+        replaySampleRate,
+        defaultPrivacyLevel
+      } = configuration;
+      return {
+        replaySampleRate: replaySampleRate !== undefined ? replaySampleRate : DEFAULTS.replaySampleRate,
+        defaultPrivacyLevel: defaultPrivacyLevel !== undefined ? defaultPrivacyLevel : DEFAULTS.defaultPrivacyLevel
+      };
+    });
+
+    _defineProperty(this, "enable", configuration => {
+      const {
+        replaySampleRate,
+        defaultPrivacyLevel
+      } = this.buildConfiguration(configuration);
+      return this.nativeSessionReplay.enable(replaySampleRate, defaultPrivacyLevel);
+    });
+  }
+
+}
+export const SessionReplay = new SessionReplayWrapper();
+//# sourceMappingURL=SessionReplay.js.map

package/lib/module/SessionReplay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["SessionReplay.ts"],"names":["SessionReplayPrivacy","DEFAULTS","replaySampleRate","defaultPrivacyLevel","MASK","SessionReplayWrapper","require","default","configuration","undefined","buildConfiguration","nativeSessionReplay","enable","SessionReplay"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AAIA,WAAYA,oBAAZ;AAMA;AACA;AACA;;WARYA,oB;AAAAA,EAAAA,oB;AAAAA,EAAAA,oB;AAAAA,EAAAA,oB;GAAAA,oB,KAAAA,oB;;AA0BZ,MAAMC,QAAQ,GAAG;AACbC,EAAAA,gBAAgB,EAAE,CADL;AAEbC,EAAAA,mBAAmB,EAAEH,oBAAoB,CAACI;AAF7B,CAAjB;AAKA,OAAO,MAAMC,oBAAN,CAA2B;AAAA;AAAA,iDAEyBC,OAAO,CAAC,+BAAD,CAAP,CAClDC,OAHyB;;AAAA,gDAM1BC,aADyB,IAKxB;AACD,UAAI,CAACA,aAAL,EAAoB;AAChB,eAAOP,QAAP;AACH;;AACD,YAAM;AAAEC,QAAAA,gBAAF;AAAoBC,QAAAA;AAApB,UAA4CK,aAAlD;AACA,aAAO;AACHN,QAAAA,gBAAgB,EACZA,gBAAgB,KAAKO,SAArB,GACMP,gBADN,GAEMD,QAAQ,CAACC,gBAJhB;AAKHC,QAAAA,mBAAmB,EACfA,mBAAmB,KAAKM,SAAxB,GACMN,mBADN,GAEMF,QAAQ,CAACE;AARhB,OAAP;AAUH,KAzB6B;;AAAA,oCA+BpBK,aAAD,IAA+D;AACpE,YAAM;AACFN,QAAAA,gBADE;AAEFC,QAAAA;AAFE,UAGF,KAAKO,kBAAL,CAAwBF,aAAxB,CAHJ;AAKA,aAAO,KAAKG,mBAAL,CAAyBC,MAAzB,CACHV,gBADG,EAEHC,mBAFG,CAAP;AAIH,KAzC6B;AAAA;;AAAA;AA4ClC,OAAO,MAAMU,aAAa,GAAG,IAAIR,oBAAJ,EAAtB","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport type { NativeSessionReplayType } from './nativeModulesTypes';\n\nexport enum SessionReplayPrivacy {\n    MASK = 'MASK',\n    ALLOW = 'ALLOW',\n    MASK_USER_INPUT = 'MASK_USER_INPUT'\n}\n\n/**\n * The Session Replay configuration object.\n */\nexport interface SessionReplayConfiguration {\n    /**\n     * The sampling rate for Session Replay.\n     * It is applied in addition to the RUM session sample rate.\n     * Range `0`-`100`.\n     *\n     * Default value is `20`.\n     */\n    replaySampleRate?: number;\n    /**\n     * Defines the way sensitive content (e.g. text) should be masked.\n     *\n     * Default `SessionReplayPrivacy.MASK`.\n     */\n    defaultPrivacyLevel?: SessionReplayPrivacy;\n}\n\nconst DEFAULTS = {\n    replaySampleRate: 0,\n    defaultPrivacyLevel: SessionReplayPrivacy.MASK\n};\n\nexport class SessionReplayWrapper {\n    // eslint-disable-next-line global-require, @typescript-eslint/no-var-requires\n    private nativeSessionReplay: NativeSessionReplayType = require('./specs/NativeDdSessionReplay')\n        .default;\n\n    private buildConfiguration = (\n        configuration?: SessionReplayConfiguration\n    ): {\n        replaySampleRate: number;\n        defaultPrivacyLevel: SessionReplayPrivacy;\n    } => {\n        if (!configuration) {\n            return DEFAULTS;\n        }\n        const { replaySampleRate, defaultPrivacyLevel } = configuration;\n        return {\n            replaySampleRate:\n                replaySampleRate !== undefined\n                    ? replaySampleRate\n                    : DEFAULTS.replaySampleRate,\n            defaultPrivacyLevel:\n                defaultPrivacyLevel !== undefined\n                    ? defaultPrivacyLevel\n                    : DEFAULTS.defaultPrivacyLevel\n        };\n    };\n\n    /**\n     * Enable session replay and start recording session.\n     * @param configuration: The session replay configuration.\n     */\n    enable = (configuration?: SessionReplayConfiguration): Promise<void> => {\n        const {\n            replaySampleRate,\n            defaultPrivacyLevel\n        } = this.buildConfiguration(configuration);\n\n        return this.nativeSessionReplay.enable(\n            replaySampleRate,\n            defaultPrivacyLevel\n        );\n    };\n}\n\nexport const SessionReplay = new SessionReplayWrapper();\n"]}

package/lib/module/index.js

@@ -0,0 +1,8 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+import { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy } from './SessionReplay';
+export { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy };
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index.ts"],"names":["SessionReplay","SessionReplayConfiguration","SessionReplayPrivacy"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AAEA,SACIA,aADJ,EAEIC,0BAFJ,EAGIC,oBAHJ,QAIO,iBAJP;AAMA,SAASF,aAAT,EAAwBC,0BAAxB,EAAoDC,oBAApD","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport {\n    SessionReplay,\n    SessionReplayConfiguration,\n    SessionReplayPrivacy\n} from './SessionReplay';\n\nexport { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy };\n"]}

package/lib/module/nativeModulesTypes.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=nativeModulesTypes.js.map

package/lib/module/nativeModulesTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","sourcesContent":[]}

package/lib/module/specs/NativeDdSessionReplay.js

@@ -0,0 +1,14 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+/* eslint-disable @typescript-eslint/ban-types */
+import { TurboModuleRegistry } from 'react-native';
+/**
+ * Do not import this Spec directly, use NativeSessionReplayType instead.
+ */
+
+export default TurboModuleRegistry.get('DdSessionReplay');
+//# sourceMappingURL=NativeDdSessionReplay.js.map

package/lib/module/specs/NativeDdSessionReplay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["NativeDdSessionReplay.ts"],"names":["TurboModuleRegistry","get"],"mappings":"AAAA;AACA;AACA;AACA;AACA;;AAEA;AAEA,SAASA,mBAAT,QAAoC,cAApC;AAEA;AACA;AACA;;AAeA,eAAeA,mBAAmB,CAACC,GAApB,CAA8B,iBAA9B,CAAf","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\n/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\n/**\n * Do not import this Spec directly, use NativeSessionReplayType instead.\n */\nexport interface Spec extends TurboModule {\n    readonly getConstants: () => {};\n\n    /**\n     * Enable session replay and start recording session.\n     * @param replaySampleRate: The sample rate applied for session replay.\n     * @param defaultPrivacyLevel: The privacy level used for replay.\n     */\n    enable(\n        replaySampleRate: number,\n        defaultPrivacyLevel: string\n    ): Promise<void>;\n}\n\nexport default TurboModuleRegistry.get<Spec>('DdSessionReplay');\n"]}

package/lib/typescript/SessionReplay.d.ts

@@ -0,0 +1,34 @@
+export declare enum SessionReplayPrivacy {
+    MASK = "MASK",
+    ALLOW = "ALLOW",
+    MASK_USER_INPUT = "MASK_USER_INPUT"
+}
+/**
+ * The Session Replay configuration object.
+ */
+export interface SessionReplayConfiguration {
+    /**
+     * The sampling rate for Session Replay.
+     * It is applied in addition to the RUM session sample rate.
+     * Range `0`-`100`.
+     *
+     * Default value is `20`.
+     */
+    replaySampleRate?: number;
+    /**
+     * Defines the way sensitive content (e.g. text) should be masked.
+     *
+     * Default `SessionReplayPrivacy.MASK`.
+     */
+    defaultPrivacyLevel?: SessionReplayPrivacy;
+}
+export declare class SessionReplayWrapper {
+    private nativeSessionReplay;
+    private buildConfiguration;
+    /**
+     * Enable session replay and start recording session.
+     * @param configuration: The session replay configuration.
+     */
+    enable: (configuration?: SessionReplayConfiguration) => Promise<void>;
+}
+export declare const SessionReplay: SessionReplayWrapper;

package/lib/typescript/index.d.ts

@@ -0,0 +1,2 @@
+import { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy } from './SessionReplay';
+export { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy };

package/lib/typescript/nativeModulesTypes.d.ts

@@ -0,0 +1,18 @@
+import type { Spec as NativeDdSessionReplay } from './specs/NativeDdSessionReplay';
+/**
+ * In this file, native modules types extend the specs for TurboModules.
+ * As we cannot use enums or classes in the specs, we override methods using them here.
+ */
+declare type PrivacyLevel = 'MASK' | 'MASK_USER_INPUT' | 'ALLOW';
+/**
+ * The entry point to use Datadog's Session Replay feature.
+ */
+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.
+     */
+    enable(replaySampleRate: number, defaultPrivacyLevel: PrivacyLevel): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,15 @@
+import type { TurboModule } from 'react-native';
+/**
+ * Do not import this Spec directly, use NativeSessionReplayType instead.
+ */
+export interface Spec extends TurboModule {
+    readonly getConstants: () => {};
+    /**
+     * Enable session replay and start recording session.
+     * @param replaySampleRate: The sample rate applied for session replay.
+     * @param defaultPrivacyLevel: The privacy level used for replay.
+     */
+    enable(replaySampleRate: number, defaultPrivacyLevel: string): Promise<void>;
+}
+declare const _default: Spec | null;
+export default _default;

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@datadog/mobile-react-native-session-replay",
+  "version": "2.0.2-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.17.1"
+  },
+  "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": "DatadogSDKReactNativeSessionReplay",
+    "type": "modules",
+    "jsSrcsDir": "./src/specs",
+    "android": {
+      "javaPackageName": "com.datadog.reactnative.sessionreplay"
+    }
+  }
+}

package/src/SessionReplay.ts

@@ -0,0 +1,84 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+import type { NativeSessionReplayType } from './nativeModulesTypes';
+
+export enum SessionReplayPrivacy {
+    MASK = 'MASK',
+    ALLOW = 'ALLOW',
+    MASK_USER_INPUT = 'MASK_USER_INPUT'
+}
+
+/**
+ * The Session Replay configuration object.
+ */
+export interface SessionReplayConfiguration {
+    /**
+     * The sampling rate for Session Replay.
+     * It is applied in addition to the RUM session sample rate.
+     * Range `0`-`100`.
+     *
+     * Default value is `20`.
+     */
+    replaySampleRate?: number;
+    /**
+     * Defines the way sensitive content (e.g. text) should be masked.
+     *
+     * Default `SessionReplayPrivacy.MASK`.
+     */
+    defaultPrivacyLevel?: SessionReplayPrivacy;
+}
+
+const DEFAULTS = {
+    replaySampleRate: 0,
+    defaultPrivacyLevel: SessionReplayPrivacy.MASK
+};
+
+export class SessionReplayWrapper {
+    // eslint-disable-next-line global-require, @typescript-eslint/no-var-requires
+    private nativeSessionReplay: NativeSessionReplayType = require('./specs/NativeDdSessionReplay')
+        .default;
+
+    private buildConfiguration = (
+        configuration?: SessionReplayConfiguration
+    ): {
+        replaySampleRate: number;
+        defaultPrivacyLevel: SessionReplayPrivacy;
+    } => {
+        if (!configuration) {
+            return DEFAULTS;
+        }
+        const { replaySampleRate, defaultPrivacyLevel } = configuration;
+        return {
+            replaySampleRate:
+                replaySampleRate !== undefined
+                    ? replaySampleRate
+                    : DEFAULTS.replaySampleRate,
+            defaultPrivacyLevel:
+                defaultPrivacyLevel !== undefined
+                    ? defaultPrivacyLevel
+                    : DEFAULTS.defaultPrivacyLevel
+        };
+    };
+
+    /**
+     * Enable session replay and start recording session.
+     * @param configuration: The session replay configuration.
+     */
+    enable = (configuration?: SessionReplayConfiguration): Promise<void> => {
+        const {
+            replaySampleRate,
+            defaultPrivacyLevel
+        } = this.buildConfiguration(configuration);
+
+        return this.nativeSessionReplay.enable(
+            replaySampleRate,
+            defaultPrivacyLevel
+        );
+    };
+}
+
+export const SessionReplay = new SessionReplayWrapper();

package/src/__tests__/SessionReplay.test.ts

@@ -0,0 +1,49 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+import { NativeModules } from 'react-native';
+
+import { SessionReplay, SessionReplayPrivacy } from '../SessionReplay';
+
+beforeEach(() => {
+    NativeModules.DdSessionReplay.enable.mockClear();
+});
+
+describe('SessionReplay', () => {
+    describe('enable', () => {
+        it('calls native session replay with default configuration', () => {
+            SessionReplay.enable();
+
+            expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
+                0,
+                'MASK'
+            );
+        });
+
+        it('calls native session replay with provided configuration', () => {
+            SessionReplay.enable({
+                replaySampleRate: 100,
+                defaultPrivacyLevel: SessionReplayPrivacy.ALLOW
+            });
+
+            expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
+                100,
+                'ALLOW'
+            );
+        });
+
+        it('calls native session replay with edge cases in configuration', () => {
+            SessionReplay.enable({
+                replaySampleRate: 0
+            });
+
+            expect(NativeModules.DdSessionReplay.enable).toHaveBeenCalledWith(
+                0,
+                'MASK'
+            );
+        });
+    });
+});

package/src/index.ts

@@ -0,0 +1,13 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+import {
+    SessionReplay,
+    SessionReplayConfiguration,
+    SessionReplayPrivacy
+} from './SessionReplay';
+
+export { SessionReplay, SessionReplayConfiguration, SessionReplayPrivacy };

package/src/nativeModulesTypes.ts

@@ -0,0 +1,29 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+import type { Spec as NativeDdSessionReplay } from './specs/NativeDdSessionReplay';
+
+/**
+ * In this file, native modules types extend the specs for TurboModules.
+ * As we cannot use enums or classes in the specs, we override methods using them here.
+ */
+
+type PrivacyLevel = 'MASK' | 'MASK_USER_INPUT' | 'ALLOW';
+
+/**
+ * The entry point to use Datadog's Session Replay feature.
+ */
+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.
+     */
+    enable(
+        replaySampleRate: number,
+        defaultPrivacyLevel: PrivacyLevel
+    ): Promise<void>;
+}

package/src/specs/NativeDdSessionReplay.ts

@@ -0,0 +1,28 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+/* eslint-disable @typescript-eslint/ban-types */
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * Do not import this Spec directly, use NativeSessionReplayType instead.
+ */
+export interface Spec extends TurboModule {
+    readonly getConstants: () => {};
+
+    /**
+     * Enable session replay and start recording session.
+     * @param replaySampleRate: The sample rate applied for session replay.
+     * @param defaultPrivacyLevel: The privacy level used for replay.
+     */
+    enable(
+        replaySampleRate: number,
+        defaultPrivacyLevel: string
+    ): Promise<void>;
+}
+
+export default TurboModuleRegistry.get<Spec>('DdSessionReplay');