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

package/android/src/main/kotlin/com/datadog/reactnative/sessionreplay/utils/ColorUtils.kt

@@ -0,0 +1,22 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay.utils
+
+private const val HEX_COLOR_INCLUDING_ALPHA_LENGTH: Int = 8
+
+internal fun formatAsRgba(backgroundColor: Int): String {
+    val colorHexString = Integer.toHexString(backgroundColor)
+    return "#${convertArgbToRgba(colorHexString)}"
+}
+
+private fun convertArgbToRgba(hexString: String): String {
+    return if (hexString.length == HEX_COLOR_INCLUDING_ALPHA_LENGTH) {
+        hexString.substring(2, 8) + hexString.substring(0, 2)
+    } else {
+        hexString
+    }
+}

package/android/src/main/kotlin/com/datadog/reactnative/sessionreplay/utils/DrawableUtils.kt

@@ -0,0 +1,35 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay.utils
+
+import android.graphics.drawable.Drawable
+import android.graphics.drawable.InsetDrawable
+import android.graphics.drawable.LayerDrawable
+import com.facebook.react.views.view.ReactViewBackgroundDrawable
+
+internal class DrawableUtils {
+    internal fun getReactBackgroundFromDrawable(drawable: Drawable?): ReactViewBackgroundDrawable? {
+        if (drawable is ReactViewBackgroundDrawable) {
+            return drawable
+        }
+
+        if (drawable is InsetDrawable) {
+            return getReactBackgroundFromDrawable(drawable.drawable)
+        }
+
+        if (drawable is LayerDrawable) {
+            for (layerNumber in 0 until drawable.numberOfLayers) {
+                val layer = drawable.getDrawable(layerNumber)
+                if (layer is ReactViewBackgroundDrawable) {
+                    return layer
+                }
+            }
+        }
+
+        return null
+    }
+}

package/android/src/main/kotlin/com/datadog/reactnative/sessionreplay/utils/ReactViewBackgroundDrawableUtils.kt

@@ -0,0 +1,66 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay.utils
+
+import com.datadog.android.sessionreplay.model.MobileSegment
+import com.datadog.reactnative.sessionreplay.extensions.convertToDensityNormalized
+import com.facebook.react.uimanager.Spacing
+import com.facebook.react.views.view.ReactViewBackgroundDrawable
+
+internal class ReactViewBackgroundDrawableUtils(
+    private val reflectionUtils: ReflectionUtils = ReflectionUtils()
+) {
+    internal fun resolveShapeAndBorder(
+        drawable: ReactViewBackgroundDrawable,
+        opacity: Float,
+        pixelDensity: Float
+    ): Pair<MobileSegment.ShapeStyle?, MobileSegment.ShapeBorder?> {
+        val borderProps = resolveBorder(drawable, pixelDensity)
+        val backgroundColor = getBackgroundColor(drawable)
+        val colorHexString = if (backgroundColor != null) {
+            formatAsRgba(backgroundColor)
+        } else {
+            return null to borderProps
+        }
+
+        val cornerRadius =
+            drawable.fullBorderRadius.toLong().convertToDensityNormalized(pixelDensity)
+
+        return MobileSegment.ShapeStyle(
+            colorHexString,
+            opacity,
+            cornerRadius
+        ) to borderProps
+    }
+
+    private fun getBackgroundColor(
+        backgroundDrawable: ReactViewBackgroundDrawable,
+    ): Int? {
+        return reflectionUtils.getDeclaredField(
+            backgroundDrawable,
+            COLOR_FIELD_NAME
+        ) as Int?
+    }
+
+    private fun resolveBorder(
+        backgroundDrawable: ReactViewBackgroundDrawable,
+        pixelDensity: Float
+    ): MobileSegment.ShapeBorder {
+        val borderWidth =
+            backgroundDrawable.fullBorderWidth.toLong().convertToDensityNormalized(pixelDensity)
+        val borderColor = formatAsRgba(backgroundDrawable.getBorderColor(Spacing.ALL))
+
+        return MobileSegment.ShapeBorder(
+            color = borderColor,
+            width = borderWidth
+        )
+    }
+
+    private companion object {
+        private const val COLOR_FIELD_NAME = "mColor"
+    }
+}

package/android/src/main/kotlin/com/datadog/reactnative/sessionreplay/utils/ReflectionUtils.kt

@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay.utils
+
+import java.lang.reflect.Field
+
+internal class ReflectionUtils {
+    internal fun getDeclaredField(instance: Any, fieldName: String): Any? {
+        val classInstance = instance.javaClass
+        val declaredField = searchForField(classInstance, fieldName)
+
+        return declaredField?.let {
+            it.isAccessible = true
+            it.get(instance)
+        }
+    }
+
+    private fun searchForField(className: Class<*>, fieldName: String): Field? {
+        return className.declaredFields.firstOrNull { it.name == fieldName }
+            ?: if (className.superclass != null) {
+                searchForField(className.superclass, fieldName)
+            } else {
+                null
+            }
+    }
+}

package/android/src/main/kotlin/com/datadog/reactnative/sessionreplay/utils/TextViewUtils.kt

@@ -0,0 +1,40 @@
+/*
+ *
+ *  * 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.
+ *
+ */
+
+package com.datadog.reactnative.sessionreplay.utils
+
+import android.widget.TextView
+import com.datadog.android.sessionreplay.internal.recorder.MappingContext
+import com.datadog.android.sessionreplay.model.MobileSegment
+import com.datadog.reactnative.sessionreplay.TextPropertiesResolver
+
+internal class TextViewUtils {
+    internal fun mapTextViewToWireframes(
+        wireframes: List<MobileSegment.Wireframe>,
+        view: TextView,
+        mappingContext: MappingContext,
+        reactTextPropertiesResolver: TextPropertiesResolver
+    ): List<MobileSegment.Wireframe> {
+        val result = mutableListOf<MobileSegment.Wireframe>()
+        val pixelDensity = mappingContext.systemInformation.screenDensity
+
+        wireframes.forEach { originalWireframe ->
+            if (originalWireframe !is MobileSegment.Wireframe.TextWireframe) {
+                result.add(originalWireframe)
+            } else {
+                result.add(reactTextPropertiesResolver.addReactNativeProperties(
+                    originalWireframe = originalWireframe,
+                    view = view,
+                    pixelDensity = pixelDensity,
+                ))
+            }
+        }
+
+        return result
+    }
+}

package/android/src/newarch/kotlin/com/datadog/reactnative/sessionreplay/DdSessionReplay.kt

@@ -0,0 +1,33 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactMethod
+
+/**
+ * The entry point to use Datadog's Session Replay feature.
+ */
+class DdSessionReplay(
+    reactContext: ReactApplicationContext
+) : NativeDdSessionReplaySpec(reactContext) {
+
+    private val implementation = DdSessionReplayImplementation()
+
+    override fun getName(): String = DdSessionReplayImplementation.NAME
+    
+    /**
+     * Enable session replay and start recording session.
+     * @param replaySampleRate The sample rate applied for session replay.
+     * @param defaultPrivacyLevel The privacy level used for replay.
+     */
+    @ReactMethod
+    override fun enable(replaySampleRate: Double, defaultPrivacyLevel: String, promise: Promise) {
+        implementation.enable(replaySampleRate, defaultPrivacyLevel, promise)
+    }
+}

package/android/src/oldarch/kotlin/com/datadog/reactnative/sessionreplay/DdSessionReplay.kt

@@ -0,0 +1,34 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+
+/**
+ * The entry point to use Datadog's Session Replay feature.
+ */
+class DdSessionReplay(
+    reactContext: ReactApplicationContext
+) : ReactContextBaseJavaModule(reactContext) {
+
+    private val implementation = DdSessionReplayImplementation(reactContext)
+
+    override fun getName(): String = DdSessionReplayImplementation.NAME
+
+    /**
+     * Enable session replay and start recording session.
+     * @param replaySampleRate The sample rate applied for session replay.
+     * @param defaultPrivacyLevel The privacy level used for replay.
+     */
+    @ReactMethod
+    fun enable(replaySampleRate: Double, defaultPrivacyLevel: String, promise: Promise) {
+        implementation.enable(replaySampleRate, defaultPrivacyLevel, promise)
+    }
+}

package/android/src/test/kotlin/com/datadog/reactnative/sessionreplay/DdSessionReplayImplementationTest.kt

@@ -0,0 +1,105 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay
+
+import com.datadog.android.sessionreplay.SessionReplayConfiguration
+import com.datadog.android.sessionreplay.SessionReplayPrivacy
+import com.datadog.tools.unit.GenericAssert.Companion.assertThat
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.uimanager.UIManagerModule
+import fr.xgouchet.elmyr.annotation.DoubleForgery
+import fr.xgouchet.elmyr.annotation.Forgery
+import fr.xgouchet.elmyr.annotation.StringForgery
+import fr.xgouchet.elmyr.junit5.ForgeExtension
+import org.junit.jupiter.api.AfterEach
+import org.junit.jupiter.api.BeforeEach
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+import org.junit.jupiter.api.extension.Extensions
+import org.mockito.Mock
+import org.mockito.junit.jupiter.MockitoExtension
+import org.mockito.junit.jupiter.MockitoSettings
+import org.mockito.kotlin.any
+import org.mockito.kotlin.argumentCaptor
+import org.mockito.kotlin.doReturn
+import org.mockito.kotlin.verify
+import org.mockito.kotlin.whenever
+import org.mockito.quality.Strictness
+
+@Extensions(
+    ExtendWith(MockitoExtension::class),
+    ExtendWith(ForgeExtension::class)
+)
+@MockitoSettings(strictness = Strictness.LENIENT)
+internal class DdSessionReplayImplementationTest {
+
+    lateinit var testedSessionReplay: DdSessionReplayImplementation
+
+    @Mock
+    lateinit var mockPromise: Promise
+
+    @Mock
+    lateinit var mockReactContext: ReactContext
+
+    @Mock
+    lateinit var mockSessionReplay: SessionReplayWrapper
+
+    @Mock
+    lateinit var mockUiManagerModule: UIManagerModule
+
+    @BeforeEach
+    fun `set up`() {
+        whenever(mockReactContext.getNativeModule(any<Class<NativeModule>>()))
+            .doReturn(mockUiManagerModule)
+
+        testedSessionReplay =
+            DdSessionReplayImplementation(mockReactContext) { mockSessionReplay }
+    }
+
+    @AfterEach
+    fun `tear down`() {
+    }
+
+    @Test
+    fun `M enable session replay W enable()`(
+        @DoubleForgery(min = 0.0, max = 100.0) replaySampleRate: Double,
+        @Forgery privacy: SessionReplayPrivacy
+    ) {
+        // Given
+        val sessionReplayConfigCaptor = argumentCaptor<SessionReplayConfiguration>()
+
+        // When
+        testedSessionReplay.enable(replaySampleRate, privacy.toString(), mockPromise)
+
+        // Then
+        verify(mockSessionReplay).enable(sessionReplayConfigCaptor.capture())
+        assertThat(sessionReplayConfigCaptor.firstValue)
+            .hasFieldEqualTo("sampleRate", replaySampleRate.toFloat())
+            .hasFieldEqualTo("privacy", privacy)
+    }
+
+    @Test
+    fun `M enable session replay with mask W enable with bad privacy option()`(
+        @DoubleForgery(min = 0.0, max = 100.0) replaySampleRate: Double,
+        // Not ALLOW nor MASK_USER_INPUT
+        @StringForgery(regex = "^/(?!ALLOW|MASK_USER_INPUT)([a-z0-9]+)$/i") privacy: String
+    ) {
+        // Given
+        val sessionReplayConfigCaptor = argumentCaptor<SessionReplayConfiguration>()
+
+        // When
+        testedSessionReplay.enable(replaySampleRate, privacy, mockPromise)
+
+        // Then
+        verify(mockSessionReplay).enable(sessionReplayConfigCaptor.capture())
+        assertThat(sessionReplayConfigCaptor.firstValue)
+            .hasFieldEqualTo("sampleRate", replaySampleRate.toFloat())
+            .hasFieldEqualTo("privacy", SessionReplayPrivacy.MASK)
+    }
+}

package/android/src/test/kotlin/com/datadog/reactnative/sessionreplay/ReactNativeSessionReplayExtensionSupportTest.kt

@@ -0,0 +1,127 @@
+/*
+ * 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.
+ */
+
+package com.datadog.reactnative.sessionreplay
+
+import com.datadog.android.api.InternalLogger
+import com.datadog.android.sessionreplay.SessionReplayPrivacy
+import com.datadog.reactnative.sessionreplay.mappers.ReactMaskInputTextMapper
+import com.datadog.reactnative.sessionreplay.mappers.ReactMaskTextMapper
+import com.datadog.reactnative.sessionreplay.mappers.ReactTextMapper
+import com.datadog.reactnative.sessionreplay.mappers.ReactViewGroupMapper
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.uimanager.UIManagerModule
+import com.facebook.react.views.text.ReactTextView
+import com.facebook.react.views.textinput.ReactEditText
+import com.facebook.react.views.view.ReactViewGroup
+import fr.xgouchet.elmyr.junit5.ForgeExtension
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.BeforeEach
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+import org.junit.jupiter.api.extension.Extensions
+import org.mockito.Mock
+import org.mockito.junit.jupiter.MockitoExtension
+import org.mockito.junit.jupiter.MockitoSettings
+import org.mockito.kotlin.any
+import org.mockito.kotlin.doReturn
+import org.mockito.kotlin.whenever
+import org.mockito.quality.Strictness
+
+@Extensions(
+    ExtendWith(MockitoExtension::class),
+    ExtendWith(ForgeExtension::class)
+)
+@MockitoSettings(strictness = Strictness.LENIENT)
+internal class ReactNativeSessionReplayExtensionSupportTest {
+
+    @Mock
+    private lateinit var mockReactContext: ReactContext
+
+    @Mock
+    private lateinit var mockUiManagerModule: UIManagerModule
+
+    @Mock
+    private lateinit var mockLogger: InternalLogger
+
+    private lateinit var testedExtensionSupport: ReactNativeSessionReplayExtensionSupport
+
+    @BeforeEach
+    fun `set up`() {
+        whenever(mockReactContext.getNativeModule(any<Class<NativeModule>>()))
+            .doReturn(mockUiManagerModule)
+
+        testedExtensionSupport = ReactNativeSessionReplayExtensionSupport(
+            logger = mockLogger,
+            reactContext = mockReactContext
+        )
+    }
+
+    @Test
+    fun `M get custom view mappers W getCustomViewMappers()`() {
+        // When
+        val customViewMappers = testedExtensionSupport.getCustomViewMappers()
+        val allowMappers = customViewMappers[SessionReplayPrivacy.ALLOW]
+
+        // Then
+        check(allowMappers != null)
+        assertThat(allowMappers).hasSize(3)
+        assertThat(allowMappers[ReactViewGroup::class.java])
+            .isInstanceOf(ReactViewGroupMapper::class.java)
+        assertThat(allowMappers[ReactTextView::class.java])
+            .isInstanceOf(ReactTextMapper::class.java)
+        assertThat(allowMappers[ReactEditText::class.java])
+            .isInstanceOf(ReactTextMapper::class.java)
+    }
+
+    @Test
+    fun `M get mask input mappers W getCustomViewMappers()`() {
+        // When
+        val customViewMappers = testedExtensionSupport.getCustomViewMappers()
+        val maskUserInputMappers = customViewMappers[SessionReplayPrivacy.MASK_USER_INPUT]
+
+        // Then
+        check(maskUserInputMappers != null)
+        assertThat(maskUserInputMappers).hasSize(3)
+        assertThat(maskUserInputMappers[ReactViewGroup::class.java])
+            .isInstanceOf(ReactViewGroupMapper::class.java)
+        assertThat(maskUserInputMappers[ReactTextView::class.java])
+            .isInstanceOf(ReactMaskInputTextMapper::class.java)
+        assertThat(maskUserInputMappers[ReactEditText::class.java])
+            .isInstanceOf(ReactMaskInputTextMapper::class.java)
+    }
+
+    @Test
+    fun `M get mask mappers W getCustomViewMappers()`() {
+        // When
+        val customViewMappers = testedExtensionSupport.getCustomViewMappers()
+        val maskMappers = customViewMappers[SessionReplayPrivacy.MASK]
+
+        // Then
+        check(maskMappers != null)
+        assertThat(maskMappers).hasSize(3)
+        assertThat(maskMappers[ReactViewGroup::class.java])
+            .isInstanceOf(ReactViewGroupMapper::class.java)
+        assertThat(maskMappers[ReactTextView::class.java])
+            .isInstanceOf(ReactMaskTextMapper::class.java)
+        assertThat(maskMappers[ReactEditText::class.java])
+            .isInstanceOf(ReactMaskTextMapper::class.java)
+    }
+
+    @Test
+    fun `M return null W getUiManagerModule() { cannot get uiManagerModule }`() {
+        // Given
+        whenever(mockReactContext.getNativeModule(any<Class<NativeModule>>()))
+            .thenThrow(IllegalStateException())
+
+        // When
+        val uiManagerModule = testedExtensionSupport.getUiManagerModule()
+
+        // Then
+        assertThat(uiManagerModule).isNull()
+    }
+}