@scalebun/react-native 1.0.0 → 1.0.2

package/android/src/main/java/com/scalebun/replaysdk/core/ReplayConfig.kt

@@ -1,144 +1,144 @@
-package com.scalebun.replaysdk.core
-
-/**
- * Replay SDK configuration.
- * Mirrors the TypeScript ReplayConfig type.
- */
-data class ReplayConfig(
-    val enabled: Boolean = true,
-    val apiKey: String = "",
-    val endpoint: String = "",
-    val captureMode: CaptureMode = CaptureMode.INTERACTIONS,
-    val screenshotQuality: ScreenshotQuality = ScreenshotQuality.NORMAL,
-    val screenshotCaptureIntervalMs: Long = 1500L,
-    val userStepsEnabled: Boolean = true,
-    val networkLogsEnabled: Boolean = true,
-    val sdkLogsEnabled: Boolean = true,
-    val autoStart: Boolean = true,
-    val maxSessionDurationMs: Long = 300_000L,
-    val maxFramesPerSession: Int = 500,
-    val maxEventsPerSession: Int = 5000,
-    val maxStorageSizeBytes: Long = 100L * 1024 * 1024,
-    val uploadBatchSize: Int = 10,
-    val maxRetryAttempts: Int = 3,
-    val verboseLogging: Boolean = false,
-    // Quality preset values
-    val maxWidth: Int = 720,
-    val jpegQuality: Int = 70,
-    val format: String = "webp",
-    // Privacy
-    val maskTextInputs: Boolean = true,
-    val maskImages: Boolean = false,
-    val disableScreenshots: Boolean = false,
-    val ignoredScreens: List<String> = emptyList(),
-    val maskedElementIds: List<String> = emptyList(),
-    // ─── Native file-based outbox (durable; survives restart). Default-safe OFF. ───
-    // SaaS uploads use `apiBaseUrl` + `clientKey` (header x-scalebun-client-key) against the
-    // /ingestion routes — NOT the legacy `endpoint`/`apiKey` pair.
-    val clientKey: String = "",
-    val apiBaseUrl: String = "",
-    val enableNativeFileOutbox: Boolean = false,
-    val nativeOutboxUploadEnabled: Boolean = false,
-    val useObjectStorageForFrames: Boolean = false,
-    val outboxMaxBytes: Long = 100L * 1024 * 1024,   // LRU-evict sessions past this
-    val outboxMaxAgeMs: Long = 7L * 24 * 60 * 60 * 1000, // drop sessions older than 7d
-    val outboxMaxUploadAttempts: Int = 30,           // serverAttemptCount cap → dead-letter
-    // Network-aware retry knobs (section 6/7). Defaults are spec defaults.
-    val outboxRetryIntervalMs: Long = 3000,          // retry cadence when the timer is armed
-    val outboxPoisonMaxAttempts: Int = 2,            // 4xx≠429 → dead after this many
-    val outboxRespectRetryAfter: Boolean = true,     // honor a Retry-After header
-    val outboxStrictThreeSecondRetry: Boolean = false, // false → backoff after 10 server attempts
-    val outboxNetworkFailuresCountTowardDead: Boolean = false, // never; documented default
-    // Frame stability (native-only knobs; safe defaults, no JS change required).
-    // Gate captures on a stable draw state so navigation/loading frames are not
-    // half-rendered. See FrameCaptureScheduler / UiStabilityDetector.
-    val stabilityEnabled: Boolean = true,
-    val stabilityTimeoutMs: Long = 600L,     // fallback so capture never blocks forever
-    val captureMinIntervalMs: Long = 200L,   // spacing between captures (delays, never drops)
-    val settleWindowMs: Long = 1200L         // window to catch late content after navigation
-) {
-    companion object {
-        fun fromMap(map: Map<String, Any?>): ReplayConfig {
-            return ReplayConfig(
-                enabled = map["enabled"] as? Boolean ?: true,
-                apiKey = map["apiKey"] as? String ?: "",
-                endpoint = map["endpoint"] as? String ?: "",
-                captureMode = CaptureMode.fromString(map["captureMode"] as? String ?: "interactions"),
-                screenshotQuality = ScreenshotQuality.fromString(map["screenshotQuality"] as? String ?: "normal"),
-                screenshotCaptureIntervalMs = (map["screenshotCaptureIntervalMs"] as? Number)?.toLong() ?: 1500L,
-                userStepsEnabled = map["userStepsEnabled"] as? Boolean ?: true,
-                networkLogsEnabled = map["networkLogsEnabled"] as? Boolean ?: true,
-                sdkLogsEnabled = map["sdkLogsEnabled"] as? Boolean ?: true,
-                autoStart = map["autoStart"] as? Boolean ?: true,
-                maxSessionDurationMs = (map["maxSessionDurationMs"] as? Number)?.toLong() ?: 300_000L,
-                maxFramesPerSession = (map["maxFramesPerSession"] as? Number)?.toInt() ?: 500,
-                maxEventsPerSession = (map["maxEventsPerSession"] as? Number)?.toInt() ?: 5000,
-                maxStorageSizeBytes = (map["maxStorageSizeBytes"] as? Number)?.toLong() ?: (100L * 1024 * 1024),
-                uploadBatchSize = (map["uploadBatchSize"] as? Number)?.toInt() ?: 10,
-                maxRetryAttempts = (map["maxRetryAttempts"] as? Number)?.toInt() ?: 3,
-                verboseLogging = map["verboseLogging"] as? Boolean ?: false,
-                maxWidth = (map["maxWidth"] as? Number)?.toInt() ?: 720,
-                jpegQuality = (map["jpegQuality"] as? Number)?.toInt() ?: 70,
-                format = map["format"] as? String ?: "webp",
-                maskTextInputs = map["maskTextInputs"] as? Boolean ?: true,
-                maskImages = map["maskImages"] as? Boolean ?: false,
-                disableScreenshots = map["disableScreenshots"] as? Boolean ?: false,
-                ignoredScreens = (map["ignoredScreens"] as? List<*>)?.filterIsInstance<String>() ?: emptyList(),
-                maskedElementIds = (map["maskedElementIds"] as? List<*>)?.filterIsInstance<String>() ?: emptyList(),
-                clientKey = map["clientKey"] as? String ?: "",
-                apiBaseUrl = map["apiBaseUrl"] as? String ?: "",
-                enableNativeFileOutbox = map["enableNativeFileOutbox"] as? Boolean ?: false,
-                nativeOutboxUploadEnabled = map["nativeOutboxUploadEnabled"] as? Boolean ?: false,
-                useObjectStorageForFrames = map["useObjectStorageForFrames"] as? Boolean ?: false,
-                outboxMaxBytes = (map["outboxMaxBytes"] as? Number)?.toLong() ?: (100L * 1024 * 1024),
-                outboxMaxAgeMs = (map["outboxMaxAgeMs"] as? Number)?.toLong() ?: (7L * 24 * 60 * 60 * 1000),
-                outboxMaxUploadAttempts = (map["outboxMaxUploadAttempts"] as? Number)?.toInt() ?: 30,
-                outboxRetryIntervalMs = (map["nativeOutboxRetryIntervalMs"] as? Number)?.toLong()
-                    ?: (map["outboxRetryIntervalMs"] as? Number)?.toLong() ?: 3000L,
-                outboxPoisonMaxAttempts = (map["nativeOutboxPoisonMaxAttempts"] as? Number)?.toInt()
-                    ?: (map["outboxPoisonMaxAttempts"] as? Number)?.toInt() ?: 2,
-                outboxRespectRetryAfter = (map["nativeOutboxRespectRetryAfter"] as? Boolean)
-                    ?: (map["outboxRespectRetryAfter"] as? Boolean) ?: true,
-                outboxStrictThreeSecondRetry = (map["nativeOutboxStrictThreeSecondRetry"] as? Boolean)
-                    ?: (map["outboxStrictThreeSecondRetry"] as? Boolean) ?: false,
-                outboxNetworkFailuresCountTowardDead = (map["nativeOutboxNetworkFailuresCountTowardDead"] as? Boolean)
-                    ?: (map["outboxNetworkFailuresCountTowardDead"] as? Boolean) ?: false,
-                stabilityEnabled = map["stabilityEnabled"] as? Boolean ?: true,
-                stabilityTimeoutMs = (map["stabilityTimeoutMs"] as? Number)?.toLong() ?: 600L,
-                captureMinIntervalMs = (map["captureMinIntervalMs"] as? Number)?.toLong() ?: 200L,
-                settleWindowMs = (map["settleWindowMs"] as? Number)?.toLong() ?: 1200L
-            )
-        }
-    }
-}
-
-enum class CaptureMode(val value: String) {
-    NAVIGATION("navigation"),
-    INTERACTIONS("interactions"),
-    FREQUENCY("frequency");
-
-    companion object {
-        fun fromString(s: String): CaptureMode = entries.find { it.value == s } ?: INTERACTIONS
-    }
-}
-
-enum class ScreenshotQuality(val value: String) {
-    HIGH("high"),
-    NORMAL("normal"),
-    LOW("low"),
-    GRAYSCALE("grayscale");
-
-    companion object {
-        fun fromString(s: String): ScreenshotQuality = entries.find { it.value == s } ?: NORMAL
-    }
-}
-
-enum class SessionState(val value: String) {
-    IDLE("idle"),
-    RECORDING("recording"),
-    PAUSED("paused"),
-    FINALIZING("finalizing"),
-    UPLOADING("uploading"),
-    COMPLETED("completed"),
-    FAILED("failed");
-}
+package com.scalebun.replaysdk.core
+
+/**
+ * Replay SDK configuration.
+ * Mirrors the TypeScript ReplayConfig type.
+ */
+data class ReplayConfig(
+    val enabled: Boolean = true,
+    val apiKey: String = "",
+    val endpoint: String = "",
+    val captureMode: CaptureMode = CaptureMode.INTERACTIONS,
+    val screenshotQuality: ScreenshotQuality = ScreenshotQuality.NORMAL,
+    val screenshotCaptureIntervalMs: Long = 1500L,
+    val userStepsEnabled: Boolean = true,
+    val networkLogsEnabled: Boolean = true,
+    val sdkLogsEnabled: Boolean = true,
+    val autoStart: Boolean = true,
+    val maxSessionDurationMs: Long = 300_000L,
+    val maxFramesPerSession: Int = 500,
+    val maxEventsPerSession: Int = 5000,
+    val maxStorageSizeBytes: Long = 100L * 1024 * 1024,
+    val uploadBatchSize: Int = 10,
+    val maxRetryAttempts: Int = 3,
+    val verboseLogging: Boolean = false,
+    // Quality preset values
+    val maxWidth: Int = 720,
+    val jpegQuality: Int = 70,
+    val format: String = "webp",
+    // Privacy
+    val maskTextInputs: Boolean = true,
+    val maskImages: Boolean = false,
+    val disableScreenshots: Boolean = false,
+    val ignoredScreens: List<String> = emptyList(),
+    val maskedElementIds: List<String> = emptyList(),
+    // ─── Native file-based outbox (durable; survives restart). Default-safe OFF. ───
+    // SaaS uploads use `apiBaseUrl` + `clientKey` (header x-scalebun-client-key) against the
+    // /ingestion routes — NOT the legacy `endpoint`/`apiKey` pair.
+    val clientKey: String = "",
+    val apiBaseUrl: String = "",
+    val enableNativeFileOutbox: Boolean = false,
+    val nativeOutboxUploadEnabled: Boolean = false,
+    val useObjectStorageForFrames: Boolean = false,
+    val outboxMaxBytes: Long = 100L * 1024 * 1024,   // LRU-evict sessions past this
+    val outboxMaxAgeMs: Long = 7L * 24 * 60 * 60 * 1000, // drop sessions older than 7d
+    val outboxMaxUploadAttempts: Int = 30,           // serverAttemptCount cap → dead-letter
+    // Network-aware retry knobs (section 6/7). Defaults are spec defaults.
+    val outboxRetryIntervalMs: Long = 3000,          // retry cadence when the timer is armed
+    val outboxPoisonMaxAttempts: Int = 2,            // 4xx≠429 → dead after this many
+    val outboxRespectRetryAfter: Boolean = true,     // honor a Retry-After header
+    val outboxStrictThreeSecondRetry: Boolean = false, // false → backoff after 10 server attempts
+    val outboxNetworkFailuresCountTowardDead: Boolean = false, // never; documented default
+    // Frame stability (native-only knobs; safe defaults, no JS change required).
+    // Gate captures on a stable draw state so navigation/loading frames are not
+    // half-rendered. See FrameCaptureScheduler / UiStabilityDetector.
+    val stabilityEnabled: Boolean = true,
+    val stabilityTimeoutMs: Long = 600L,     // fallback so capture never blocks forever
+    val captureMinIntervalMs: Long = 200L,   // spacing between captures (delays, never drops)
+    val settleWindowMs: Long = 1200L         // window to catch late content after navigation
+) {
+    companion object {
+        fun fromMap(map: Map<String, Any?>): ReplayConfig {
+            return ReplayConfig(
+                enabled = map["enabled"] as? Boolean ?: true,
+                apiKey = map["apiKey"] as? String ?: "",
+                endpoint = map["endpoint"] as? String ?: "",
+                captureMode = CaptureMode.fromString(map["captureMode"] as? String ?: "interactions"),
+                screenshotQuality = ScreenshotQuality.fromString(map["screenshotQuality"] as? String ?: "normal"),
+                screenshotCaptureIntervalMs = (map["screenshotCaptureIntervalMs"] as? Number)?.toLong() ?: 1500L,
+                userStepsEnabled = map["userStepsEnabled"] as? Boolean ?: true,
+                networkLogsEnabled = map["networkLogsEnabled"] as? Boolean ?: true,
+                sdkLogsEnabled = map["sdkLogsEnabled"] as? Boolean ?: true,
+                autoStart = map["autoStart"] as? Boolean ?: true,
+                maxSessionDurationMs = (map["maxSessionDurationMs"] as? Number)?.toLong() ?: 300_000L,
+                maxFramesPerSession = (map["maxFramesPerSession"] as? Number)?.toInt() ?: 500,
+                maxEventsPerSession = (map["maxEventsPerSession"] as? Number)?.toInt() ?: 5000,
+                maxStorageSizeBytes = (map["maxStorageSizeBytes"] as? Number)?.toLong() ?: (100L * 1024 * 1024),
+                uploadBatchSize = (map["uploadBatchSize"] as? Number)?.toInt() ?: 10,
+                maxRetryAttempts = (map["maxRetryAttempts"] as? Number)?.toInt() ?: 3,
+                verboseLogging = map["verboseLogging"] as? Boolean ?: false,
+                maxWidth = (map["maxWidth"] as? Number)?.toInt() ?: 720,
+                jpegQuality = (map["jpegQuality"] as? Number)?.toInt() ?: 70,
+                format = map["format"] as? String ?: "webp",
+                maskTextInputs = map["maskTextInputs"] as? Boolean ?: true,
+                maskImages = map["maskImages"] as? Boolean ?: false,
+                disableScreenshots = map["disableScreenshots"] as? Boolean ?: false,
+                ignoredScreens = (map["ignoredScreens"] as? List<*>)?.filterIsInstance<String>() ?: emptyList(),
+                maskedElementIds = (map["maskedElementIds"] as? List<*>)?.filterIsInstance<String>() ?: emptyList(),
+                clientKey = map["clientKey"] as? String ?: "",
+                apiBaseUrl = map["apiBaseUrl"] as? String ?: "",
+                enableNativeFileOutbox = map["enableNativeFileOutbox"] as? Boolean ?: false,
+                nativeOutboxUploadEnabled = map["nativeOutboxUploadEnabled"] as? Boolean ?: false,
+                useObjectStorageForFrames = map["useObjectStorageForFrames"] as? Boolean ?: false,
+                outboxMaxBytes = (map["outboxMaxBytes"] as? Number)?.toLong() ?: (100L * 1024 * 1024),
+                outboxMaxAgeMs = (map["outboxMaxAgeMs"] as? Number)?.toLong() ?: (7L * 24 * 60 * 60 * 1000),
+                outboxMaxUploadAttempts = (map["outboxMaxUploadAttempts"] as? Number)?.toInt() ?: 30,
+                outboxRetryIntervalMs = (map["nativeOutboxRetryIntervalMs"] as? Number)?.toLong()
+                    ?: (map["outboxRetryIntervalMs"] as? Number)?.toLong() ?: 3000L,
+                outboxPoisonMaxAttempts = (map["nativeOutboxPoisonMaxAttempts"] as? Number)?.toInt()
+                    ?: (map["outboxPoisonMaxAttempts"] as? Number)?.toInt() ?: 2,
+                outboxRespectRetryAfter = (map["nativeOutboxRespectRetryAfter"] as? Boolean)
+                    ?: (map["outboxRespectRetryAfter"] as? Boolean) ?: true,
+                outboxStrictThreeSecondRetry = (map["nativeOutboxStrictThreeSecondRetry"] as? Boolean)
+                    ?: (map["outboxStrictThreeSecondRetry"] as? Boolean) ?: false,
+                outboxNetworkFailuresCountTowardDead = (map["nativeOutboxNetworkFailuresCountTowardDead"] as? Boolean)
+                    ?: (map["outboxNetworkFailuresCountTowardDead"] as? Boolean) ?: false,
+                stabilityEnabled = map["stabilityEnabled"] as? Boolean ?: true,
+                stabilityTimeoutMs = (map["stabilityTimeoutMs"] as? Number)?.toLong() ?: 600L,
+                captureMinIntervalMs = (map["captureMinIntervalMs"] as? Number)?.toLong() ?: 200L,
+                settleWindowMs = (map["settleWindowMs"] as? Number)?.toLong() ?: 1200L
+            )
+        }
+    }
+}
+
+enum class CaptureMode(val value: String) {
+    NAVIGATION("navigation"),
+    INTERACTIONS("interactions"),
+    FREQUENCY("frequency");
+
+    companion object {
+        fun fromString(s: String): CaptureMode = entries.find { it.value == s } ?: INTERACTIONS
+    }
+}
+
+enum class ScreenshotQuality(val value: String) {
+    HIGH("high"),
+    NORMAL("normal"),
+    LOW("low"),
+    GRAYSCALE("grayscale");
+
+    companion object {
+        fun fromString(s: String): ScreenshotQuality = entries.find { it.value == s } ?: NORMAL
+    }
+}
+
+enum class SessionState(val value: String) {
+    IDLE("idle"),
+    RECORDING("recording"),
+    PAUSED("paused"),
+    FINALIZING("finalizing"),
+    UPLOADING("uploading"),
+    COMPLETED("completed"),
+    FAILED("failed");
+}

package/android/src/main/java/com/scalebun/replaysdk/core/ReplayLogger.kt

@@ -1,31 +1,31 @@
-package com.scalebun.replaysdk.core
-
-import android.util.Log
-
-/**
- * Internal logger with tag prefix and verbose mode support.
- */
-object ReplayLogger {
-    private const val TAG = "ReplaySdk"
-    var verbose: Boolean = false
-
-    fun debug(message: String) {
-        if (verbose) Log.d(TAG, message)
-    }
-
-    fun info(message: String) {
-        Log.i(TAG, message)
-    }
-
-    fun warn(message: String) {
-        Log.w(TAG, message)
-    }
-
-    fun error(message: String, throwable: Throwable? = null) {
-        if (throwable != null) {
-            Log.e(TAG, message, throwable)
-        } else {
-            Log.e(TAG, message)
-        }
-    }
-}
+package com.scalebun.replaysdk.core
+
+import android.util.Log
+
+/**
+ * Internal logger with tag prefix and verbose mode support.
+ */
+object ReplayLogger {
+    private const val TAG = "ReplaySdk"
+    var verbose: Boolean = false
+
+    fun debug(message: String) {
+        if (verbose) Log.d(TAG, message)
+    }
+
+    fun info(message: String) {
+        Log.i(TAG, message)
+    }
+
+    fun warn(message: String) {
+        Log.w(TAG, message)
+    }
+
+    fun error(message: String, throwable: Throwable? = null) {
+        if (throwable != null) {
+            Log.e(TAG, message, throwable)
+        } else {
+            Log.e(TAG, message)
+        }
+    }
+}

package/android/src/main/java/com/scalebun/replaysdk/core/SessionIdGenerator.kt

@@ -1,15 +1,15 @@
-package com.scalebun.replaysdk.core
-
-import java.util.UUID
-
-/**
- * Session/event/frame ID generator.
- */
-object SessionIdGenerator {
-    fun sessionId(): String = "rs-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
-    fun eventId(): String = "re-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
-    fun frameId(): String = "rf-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
-    fun batchId(): String = "rb-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
-
-    private fun shortRandom(): String = UUID.randomUUID().toString().take(8).replace("-", "")
-}
+package com.scalebun.replaysdk.core
+
+import java.util.UUID
+
+/**
+ * Session/event/frame ID generator.
+ */
+object SessionIdGenerator {
+    fun sessionId(): String = "rs-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
+    fun eventId(): String = "re-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
+    fun frameId(): String = "rf-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
+    fun batchId(): String = "rb-${System.currentTimeMillis().toString(36)}-${shortRandom()}"
+
+    private fun shortRandom(): String = UUID.randomUUID().toString().take(8).replace("-", "")
+}

package/android/src/main/java/com/scalebun/replaysdk/models/ReplayModels.kt

@@ -1,88 +1,88 @@
-package com.scalebun.replaysdk.models
-
-/**
- * Represents a single captured screenshot frame.
- */
-data class ReplayFrame(
-    val frameId: String,
-    val sessionId: String,
-    val timestamp: Long,
-    val sequenceNumber: Int,
-    val screenName: String,
-    val trigger: String,
-    val format: String,
-    val sizeBytes: Int,
-    val width: Int,
-    val height: Int,
-    val quality: String,
-    val masked: Boolean,
-    val base64: String? = null, // Only populated when reading for upload
-    val filePath: String? = null
-) {
-    fun toMap(): Map<String, Any?> = mapOf(
-        "frameId" to frameId,
-        "sessionId" to sessionId,
-        "timestamp" to timestamp,
-        "sequenceNumber" to sequenceNumber,
-        "screenName" to screenName,
-        "trigger" to trigger,
-        "format" to format,
-        "sizeBytes" to sizeBytes,
-        "width" to width,
-        "height" to height,
-        "quality" to quality,
-        "masked" to masked
-    )
-}
-
-/**
- * Represents a timeline event within a replay session.
- */
-data class TimelineEvent(
-    val eventId: String,
-    val sessionId: String,
-    val type: String,
-    val timestamp: Long,
-    val screenName: String,
-    val label: String,
-    val frameId: String? = null,
-    val data: Map<String, Any?>? = null
-) {
-    fun toMap(): Map<String, Any?> = mapOf(
-        "eventId" to eventId,
-        "sessionId" to sessionId,
-        "type" to type,
-        "timestamp" to timestamp,
-        "screenName" to screenName,
-        "label" to label,
-        "frameId" to frameId,
-        "data" to data
-    )
-}
-
-/**
- * Represents a complete replay session.
- */
-data class ReplaySession(
-    val sessionId: String,
-    val state: String,
-    val startedAt: Long,
-    val endedAt: Long? = null,
-    val frameCount: Int = 0,
-    val eventCount: Int = 0,
-    val currentScreen: String = "unknown"
-) {
-    val durationMs: Long
-        get() = (endedAt ?: System.currentTimeMillis()) - startedAt
-
-    fun toMap(): Map<String, Any?> = mapOf(
-        "sessionId" to sessionId,
-        "state" to state,
-        "startedAt" to startedAt,
-        "endedAt" to endedAt,
-        "durationMs" to durationMs,
-        "frameCount" to frameCount,
-        "eventCount" to eventCount,
-        "currentScreen" to currentScreen
-    )
-}
+package com.scalebun.replaysdk.models
+
+/**
+ * Represents a single captured screenshot frame.
+ */
+data class ReplayFrame(
+    val frameId: String,
+    val sessionId: String,
+    val timestamp: Long,
+    val sequenceNumber: Int,
+    val screenName: String,
+    val trigger: String,
+    val format: String,
+    val sizeBytes: Int,
+    val width: Int,
+    val height: Int,
+    val quality: String,
+    val masked: Boolean,
+    val base64: String? = null, // Only populated when reading for upload
+    val filePath: String? = null
+) {
+    fun toMap(): Map<String, Any?> = mapOf(
+        "frameId" to frameId,
+        "sessionId" to sessionId,
+        "timestamp" to timestamp,
+        "sequenceNumber" to sequenceNumber,
+        "screenName" to screenName,
+        "trigger" to trigger,
+        "format" to format,
+        "sizeBytes" to sizeBytes,
+        "width" to width,
+        "height" to height,
+        "quality" to quality,
+        "masked" to masked
+    )
+}
+
+/**
+ * Represents a timeline event within a replay session.
+ */
+data class TimelineEvent(
+    val eventId: String,
+    val sessionId: String,
+    val type: String,
+    val timestamp: Long,
+    val screenName: String,
+    val label: String,
+    val frameId: String? = null,
+    val data: Map<String, Any?>? = null
+) {
+    fun toMap(): Map<String, Any?> = mapOf(
+        "eventId" to eventId,
+        "sessionId" to sessionId,
+        "type" to type,
+        "timestamp" to timestamp,
+        "screenName" to screenName,
+        "label" to label,
+        "frameId" to frameId,
+        "data" to data
+    )
+}
+
+/**
+ * Represents a complete replay session.
+ */
+data class ReplaySession(
+    val sessionId: String,
+    val state: String,
+    val startedAt: Long,
+    val endedAt: Long? = null,
+    val frameCount: Int = 0,
+    val eventCount: Int = 0,
+    val currentScreen: String = "unknown"
+) {
+    val durationMs: Long
+        get() = (endedAt ?: System.currentTimeMillis()) - startedAt
+
+    fun toMap(): Map<String, Any?> = mapOf(
+        "sessionId" to sessionId,
+        "state" to state,
+        "startedAt" to startedAt,
+        "endedAt" to endedAt,
+        "durationMs" to durationMs,
+        "frameCount" to frameCount,
+        "eventCount" to eventCount,
+        "currentScreen" to currentScreen
+    )
+}