Merge branch 'andrey/tile-compression' into andrey/no-jet-compose

* andrey/tile-compression:
  fix: Android span e2e tests (#397)
  match unit test
  chore: add CLAUDE.md (#398)
  chore: release main (#400)
  fix: correct react native session replay build step (#399)

Author: abelonogov-ld

.release-please-manifest.json

@@ -6,7 +6,7 @@
 	"sdk/@launchdarkly/observability-node": "1.0.1",
 	"sdk/@launchdarkly/observability-python": "1.1.0",
 	"sdk/@launchdarkly/observability-react-native": "0.7.0",
-	"sdk/@launchdarkly/react-native-ld-session-replay": "0.2.0",
+	"sdk/@launchdarkly/react-native-ld-session-replay": "0.2.1",
 	"sdk/@launchdarkly/session-replay": "1.0.3",
 	"sdk/highlight-run": "9.27.1"
 }

CLAUDE.md

@@ -0,0 +1,143 @@
+# CLAUDE.md
+
+## Overview
+
+LaunchDarkly Observability SDK monorepo. Contains browser, Node.js, mobile, and backend SDKs for session replay, error monitoring, logging, and distributed tracing. Fork of highlight.io.
+
+**Package manager:** Yarn 4.9.1 (`yarn install`)
+**Build system:** Turborepo
+**rrweb:** Git submodule at `rrweb/` - run `git submodule update --init --recursive` after clone (the preinstall hook handles this automatically).
+
+## Key Commands
+
+```bash
+yarn install              # Install all dependencies
+yarn build                # Build all packages (excludes rrweb, nextjs)
+yarn build:sdk            # Build only @launchdarkly/* + highlight.run
+yarn test                 # Build, lint, enforce-size, then test all packages
+yarn format-check         # Check formatting (prettier)
+yarn format:all           # Fix formatting
+yarn lint                 # Lint all packages
+yarn enforce-size         # Check bundle size limits (256KB brotli)
+yarn docs                 # Generate TypeDoc documentation
+```
+
+### Filtering to specific packages
+
+```bash
+yarn turbo run build --filter @launchdarkly/observability
+yarn turbo run test --filter highlight.run
+yarn turbo run build --filter '@launchdarkly/*'
+```
+
+### Publishing (CI-only, runs on main)
+
+```bash
+yarn publish              # @launchdarkly/* packages
+yarn publish:highlight    # highlight.run + @highlight-run/* packages
+```
+
+## Package Structure
+
+### LaunchDarkly SDKs (`sdk/@launchdarkly/`)
+
+| Package | Description |
+|---------|-------------|
+| `observability` | Browser SDK - errors, logs, traces |
+| `session-replay` | Browser SDK - session replay (thin wrapper over highlight.run) |
+| `observability-shared` | Internal shared types and GraphQL codegen (private) |
+| `observability-node` | Node.js SDK |
+| `observability-react-native` | React Native SDK |
+| `react-native-ld-session-replay` | React Native session replay |
+| `observability-python` | Python SDK |
+| `observability-dotnet` | .NET SDK |
+| `observability-android` | Android SDK |
+| `observability-java` | Java SDK |
+
+### Core packages
+
+| Package | Description |
+|---------|-------------|
+| `sdk/highlight-run` | Core browser library - session replay + observability. Most logic lives here. |
+| `rrweb/` | Forked session replay recording library (git submodule, ~15 sub-packages) |
+| `go/` | Go observability SDK |
+
+### Key source files in highlight.run
+
+- `src/index.tsx` - Public API, `H` global singleton
+- `src/sdk/record.ts` - `RecordSDK` class (session replay recording logic)
+- `src/sdk/LDRecord.ts` - `LDRecord` global singleton (LaunchDarkly entry point)
+- `src/client/index.tsx` - `Highlight` class (underlying implementation)
+- `src/client/workers/highlight-client-worker.ts` - Web Worker for async data upload
+- `src/client/types/record.ts` - `RecordOptions` type definition
+- `src/client/types/iframe.ts` - Cross-origin iframe protocol types
+- `src/client/constants/sessions.ts` - Timing constants (`FIRST_SEND_FREQUENCY`, etc.)
+- `src/plugins/record.ts` - LaunchDarkly plugin interface (`LDPlugin`)
+
+### Default backend URL
+
+The SDK sends data to `https://pub.observability.app.launchdarkly.com` by default. Configurable via `backendUrl` option.
+
+## Code Style
+
+**Prettier config** (`.prettierrc`): Tabs, no semicolons, single quotes, trailing commas, 80 char width.
+
+**Pre-commit hook** (husky): Runs `pretty-quick --staged` automatically.
+
+**TypeScript**: Strict mode. All browser SDKs build with Vite (ESM + UMD). Node SDKs use rollup or tsc.
+
+**Bundle size**: All browser packages enforce 256KB brotli limit via `size-limit`. Check with `yarn enforce-size`.
+
+## CI Pipeline
+
+The main workflow is `.github/workflows/turbo.yml` (runs on push to main and PRs):
+1. `yarn install`
+2. `yarn dedupe --check`
+3. `yarn format-check`
+4. `yarn test` (which runs build -> lint -> enforce-size -> test)
+5. On main: publishes to npm
+
+Other workflows handle language-specific SDKs (Go, Python, .NET, Android, Java, Ruby, Rust, Elixir) and E2E tests.
+
+Releases are managed by `release-please` - version bumps happen automatically via PR.
+
+## E2E Tests
+
+### Framework examples (`e2e/`)
+
+Example apps for testing SDK integrations: React, Next.js, Angular, Express, NestJS, Remix, Hono, Cloudflare Worker, React Native, Go, Python, .NET, Ruby, and more.
+
+```bash
+# Run via docker compose
+cd e2e
+docker compose build sdk && docker compose build base
+docker compose build <example> && docker compose up <example>
+
+# Run specific frameworks via turbo
+yarn e2e:nextjs
+yarn e2e:express
+yarn e2e:cloudflare
+```
+
+### Pytest E2E (`e2e/tests/`)
+
+Python-based tests that start apps, make requests, and validate data appears in the backend via GraphQL queries. Uses `app_runner.py` for lifecycle management with health check polling.
+
+```bash
+cd e2e/tests
+poetry install
+poetry run python src/app_runner.py <example>
+poetry run pytest
+```
+
+**Run tests:**
+```bash
+# Diagnose live customer URLs (headed browser, slow-mo for observation)
+yarn test:live
+
+# Run local reproduction tests (headless, uses local Express servers on :3001/:3002)
+yarn test:local
+
+# Run everything
+yarn test
+```

e2e/react-three-vite/eslint.config.js

@@ -5,7 +5,7 @@ import reactHooks from 'eslint-plugin-react-hooks'
 import reactRefresh from 'eslint-plugin-react-refresh'
 
 export default [
-	{ ignores: ['dist'] },
+	{ ignores: ['dist', '**/*.timestamp-*'] },
 	{
 		files: ['**/*.{js,jsx}'],
 		languageOptions: {

sdk/@launchdarkly/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/ReplayOptions.kt

@@ -23,7 +23,7 @@ data class ReplayOptions(
     sealed class CompressionMethod {
         data object ScreenImage : CompressionMethod()
         data class OverlayTiles(
-            val layers: Int = 10,
+            val layers: Int = 15,
             val backtracking: Boolean = true,
         ) : CompressionMethod()
     }

sdk/@launchdarkly/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/capture/ExportDiffManager.kt

@@ -46,39 +46,35 @@ class ExportDiffManager(
                     removes = currentImages.subList(lastKeyNodeIdx + 1, currentImages.size).toMutableList()
                     currentImages.subList(lastKeyNodeIdx + 1, currentImages.size).clear()
 
-                    // Keep only signatures that still point into the retained prefix.
                     val filtered = currentImagesIndex.filterValues { value -> value <= lastKeyNodeIdx }
                     currentImagesIndex.clear()
                     currentImagesIndex.putAll(filtered)
                 } else {
-                    for ((tileIdx, tile) in tiledFrame.tiles.withIndex()) {
-                        val tileSignature = signature.tileSignatures.getOrNull(tileIdx)
+                    for (tile in tiledFrame.tiles) {
                         val addImage =
-                            tile.bitmap.asExportedImage(format = format, rect = tile.rect, tileSignature = tileSignature)
+                            tile.bitmap.asExportedImage(format = format, rect = tile.rect, imageSignature = signature)
                                 ?: return null
                         adds.add(addImage)
-                        if (tileSignature != null) {
-                            currentImages.add(
-                                ExportFrame.RemoveImage(
-                                    keyFrameId = keyFrameId,
-                                    tileSignature = tileSignature,
-                                )
+                        currentImages.add(
+                            ExportFrame.RemoveImage(
+                                keyFrameId = keyFrameId,
+                                imageSignature = signature,
                             )
-                        }
+                        )
                     }
                     currentImagesIndex[signature] = currentImages.size - 1
                 }
             } else {
-                for ((tileIdx, tile) in tiledFrame.tiles.withIndex()) {
-                    val tileSignature = signature?.tileSignatures?.getOrNull(tileIdx)
-                    val addImage = tile.bitmap.asExportedImage(format = format, rect = tile.rect, tileSignature = tileSignature)
+                for (tile in tiledFrame.tiles) {
+                    val imageSignature = tiledFrame.imageSignature
+                    val addImage = tile.bitmap.asExportedImage(format = format, rect = tile.rect, imageSignature = imageSignature)
                         ?: return null
                     adds.add(addImage)
-                    if (tileSignature != null) {
+                    if (imageSignature != null) {
                         currentImages.add(
                             ExportFrame.RemoveImage(
                                 keyFrameId = keyFrameId,
-                                tileSignature = tileSignature,
+                                imageSignature = imageSignature,
                             )
                         )
                     }
@@ -114,7 +110,7 @@ class ExportDiffManager(
 private fun Bitmap.asExportedImage(
     format: ExportFrame.ExportFormat,
     rect: IntRect,
-    tileSignature: TileSignature?,
+    imageSignature: ImageSignature?,
 ): ExportFrame.AddImage? {
     val outputStream = ByteArrayOutputStream()
     return try {
@@ -138,7 +134,7 @@ private fun Bitmap.asExportedImage(
         ExportFrame.AddImage(
             imageBase64 = compressedImage,
             rect = rect,
-            tileSignature = tileSignature,
+            imageSignature = imageSignature,
         )
     } finally {
         outputStream.close()

sdk/@launchdarkly/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/capture/ExportFrame.kt

@@ -28,7 +28,7 @@ data class ExportFrame(
             AddImage(
                 imageBase64 = imageBase64,
                 rect = IntRect(left = 0, top = 0, width = origWidth, height = origHeight),
-                tileSignature = null
+                imageSignature = null
             )
         ),
         removeImages = null,
@@ -44,13 +44,13 @@ data class ExportFrame(
 
     data class RemoveImage(
         val keyFrameId: Int,
-        val tileSignature: TileSignature,
+        val imageSignature: ImageSignature,
     )
 
     data class AddImage(
         val imageBase64: String,
         val rect: IntRect,
-        val tileSignature: TileSignature?,
+        val imageSignature: ImageSignature?,
     )
 
     sealed class ExportFormat {

sdk/@launchdarkly/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/exporter/RRWebEventGenerator.kt

@@ -15,7 +15,7 @@ import com.launchdarkly.observability.replay.RRWebCustomDataTag
 import com.launchdarkly.observability.replay.RRWebIncrementalSource
 import com.launchdarkly.observability.replay.RRWebMouseInteraction
 import com.launchdarkly.observability.replay.capture.ExportFrame
-import com.launchdarkly.observability.replay.capture.TileSignature
+import com.launchdarkly.observability.replay.capture.ImageSignature
 import kotlinx.serialization.json.JsonPrimitive
 import kotlinx.serialization.json.buildJsonArray
 import kotlinx.serialization.json.buildJsonObject
@@ -57,7 +57,7 @@ class RRWebEventGenerator(
     private var imageNodeId: Int? = null
     private var bodyNodeId: Int? = null
     private var knownKeyFrameId: Int? = null
-    private val nodeIds = mutableMapOf<TileSignature, Int>()
+    private val nodeIds = mutableMapOf<ImageSignature, Int>()
 
     data class State(
         val lastSid: Int = 0,
@@ -66,7 +66,7 @@ class RRWebEventGenerator(
         val imageNodeId: Int? = null,
         val bodyNodeId: Int? = null,
         val knownKeyFrameId: Int? = null,
-        val nodeIds: Map<TileSignature, Int> = emptyMap(),
+        val nodeIds: Map<ImageSignature, Int> = emptyMap(),
     )
 
     private fun nextSid(): Int {
@@ -88,7 +88,7 @@ class RRWebEventGenerator(
 
     private fun tileNode(exportFrame: ExportFrame, image: ExportFrame.AddImage): Pair<EventNode, Int> {
         val tileCanvasId = nextNodeId()
-        image.tileSignature?.let { nodeIds[it] = tileCanvasId }
+        image.imageSignature?.let { nodeIds[it] = tileCanvasId }
         val dataUrl = "data:${imageMimeType(exportFrame.format)};base64,${image.imageBase64}"
         val node = EventNode(
             id = tileCanvasId,
@@ -110,7 +110,7 @@ class RRWebEventGenerator(
 
         var totalCanvasSize = 0
         val removes = exportFrame.removeImages?.mapNotNull { removal ->
-            nodeIds[removal.tileSignature]?.let { nodeId ->
+            nodeIds[removal.imageSignature]?.let { nodeId ->
                 Removal(parentId = bodyId, id = nodeId)
             }
         } ?: emptyList()