Add UDS/RPC bridge benchmark suite with standalone app

.env.example

@@ -0,0 +1,27 @@
+# BrowserStack App Automate credentials. Copy this file to .env and
+# fill in the values from `Account → Settings → Access Keys` in the
+# BrowserStack dashboard. Both scripts in scripts/ read these via
+# `node --env-file=.env`.
+BROWSERSTACK_USERNAME=
+BROWSERSTACK_ACCESS_KEY=
+
+# Optional escape hatch: pin builds to an existing BrowserStack
+# project rather than letting BS auto-create one from the bundle ID.
+# Leave unset for the normal path — the runner sends no `project`
+# field and BrowserStack auto-creates a project named after the
+# uploaded app's bundle ID. Only set this if your access key lacks
+# project-creation permission AND you want to attach builds to a
+# pre-existing project. Use the project name as it appears in the
+# App Automate dashboard.
+# BENCH_BROWSERSTACK_PROJECT=
+
+# Apple Developer Team ID (10-char identifier). Required by
+# `apps/benchmark/scripts/build-ipa.sh` to archive the bench app for
+# BrowserStack iOS dispatches. Visible at the top right of any page on
+# https://developer.apple.com/account/. The bundle id
+# `com.comapeo.core.benchmark` must already be registered as an
+# Identifier under the same team. No Capabilities or App Store Connect
+# entry are required — BrowserStack auto-resigns IPAs with their own
+# provisioning profile on upload.
+# APPLE_DEVELOPMENT_TEAM_ID=ABC1234DEF
+

.gitignore

@@ -83,3 +83,19 @@ build/
 
 # eslint
 .eslintcache
+
+# Local secrets (BrowserStack credentials etc). The .example file is
+# checked in and lists the variables; copy it to .env and fill in.
+.env
+.env.local
+.env.*.local
+
+# Bench result NDJSONs, written by `scripts/bench-summarize.ts` after
+# pulling device logs from a BrowserStack build. Treat as build
+# artifacts; copy out of this dir if you want to commit a specific
+# run's results.
+apps/benchmark/results/
+
+# `apps/benchmark/scripts/build-ipa.sh` output (xcarchive + IPA staged
+# for BrowserStack upload). Regenerable; never commit.
+apps/benchmark/ios-build/

android/build.gradle

@@ -42,6 +42,12 @@ def comapeoAbiFilters = {
     return effective
 }()
 
+// Entry filename inside `nodejs-project/`. Default `index.mjs` (the
+// production bundle). Consumers shipping a sibling entry file (e.g.
+// `apps/benchmark/`) drop it into their own `assets/nodejs-project/`
+// and override here; AGP merges the assets at APK build time.
+def comapeoEntryFile = (rootProject.findProperty('comapeoEntryFile') ?: project.findProperty('comapeoEntryFile') ?: 'index.mjs').toString()
+
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
 applyKotlinExpoModulesCorePlugin()
@@ -76,6 +82,8 @@ android {
         versionCode 1
         versionName "0.1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        // Java-string-literal form (embedded quotes) is what `buildConfigField` needs.
+        buildConfigField "String", "COMAPEO_ENTRY_FILE", "\"${comapeoEntryFile}\""
         externalNativeBuild {
             cmake {
                 cppFlags ''
@@ -87,6 +95,7 @@ android {
             abiFilters(*comapeoAbiFilters)
         }
     }
+
     lintOptions {
         abortOnError false
     }
@@ -98,9 +107,6 @@ android {
             // native module instance × ABI). Both directories ship into the
             // same APK `lib/<abi>/` segment.
             jniLibs.srcDirs 'libnode/bin/', 'src/main/jniLibs/'
-            assets {
-                srcDirs 'src/main/assets'
-            }
         }
     }
     externalNativeBuild {
@@ -111,6 +117,8 @@ android {
     }
     buildFeatures {
         prefab true
+        // AGP 8.x default is off; needed for `buildConfigField` above.
+        buildConfig true
     }
     packagingOptions {
         excludes += [

android/src/main/java/com/comapeo/core/NodeJSService.kt

@@ -43,7 +43,8 @@ private data class ErrorNativeMessage(
 const val APK_LAST_UPDATE_TIME_KEY = "apk_last_update_time"
 const val SHARED_PREFS_NAME_POSTFIX = "_nodejs_preferences"
 const val NODEJS_PROJECT_DIRNAME = "nodejs-project"
-const val NODEJS_PROJECT_INDEX_FILENAME = "index.mjs"
+// Override via `comapeoEntryFile` Gradle property; see android/build.gradle.
+val NODEJS_PROJECT_INDEX_FILENAME: String = BuildConfig.COMAPEO_ENTRY_FILE
 
 /**
  * Bound on `ipcDeferred.await()` inside `sendErrorNativeFrame`. If the
@@ -409,15 +410,17 @@ class NodeJSService(
                     }
                 }
 
-                val exitCode = startNodeWithArguments(
-                    arrayOf(
-                        "node",
-                        jsFile.absolutePath,
-                        comapeoSocketFile.absolutePath,
-                        controlSocketFile.absolutePath,
-                        dataDir,
-                    )
-                )
+                // `--device=<tag>` is read by downstream telemetry (bench, Sentry).
+                // Production backend ignores unknown flags so it's a safe no-op.
+                val deviceTag = "${android.os.Build.MANUFACTURER} ${android.os.Build.MODEL} (Android ${android.os.Build.VERSION.RELEASE})"
+                val exitCode = startNodeWithArguments(arrayOf(
+                    "node",
+                    jsFile.absolutePath,
+                    comapeoSocketFile.absolutePath,
+                    controlSocketFile.absolutePath,
+                    dataDir,
+                    "--device=$deviceTag",
+                ))
                 log("NodeJS service completed with exit code $exitCode")
 
                 // Classify the exit. "Requested" means we asked for it

apps/benchmark/.gitignore

@@ -0,0 +1,40 @@
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native (regenerated by `expo prebuild`; the with-comapeo-bench config
+# plugin re-applies bench wiring on every prebuild, so checking these
+# in would only invite drift)
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# expo prebuild
+/android
+/ios

apps/benchmark/.maestro/bench-payload-1KB.yaml

@@ -0,0 +1,28 @@
+appId: com.comapeo.core.benchmark
+---
+# Per-payload-size variant of bench-rpc.yaml: only 1KB selected.
+
+- launchApp:
+    clearState: true
+
+- extendedWaitUntil:
+    visible:
+      id: "service-state"
+      text: "STARTED"
+    timeout: 60000
+
+- tapOn:
+    id: "size-64"
+- tapOn:
+    id: "size-65536"
+
+- tapOn:
+    id: "send-button"
+
+- extendedWaitUntil:
+    visible:
+      id: "benchmark-result"
+    timeout: 60000
+
+- assertVisible:
+    text: "1KB"

apps/benchmark/.maestro/bench-payload-1MB.yaml

@@ -0,0 +1,35 @@
+appId: com.comapeo.core.benchmark
+---
+# Per-payload-size variant of bench-rpc.yaml: only 1MB selected. Note
+# 1MB is NOT in the default selection — the flow deselects the three
+# defaults and selects 1MB explicitly. Timeout is bumped because each
+# round-trip moves a megabyte through the bridge.
+
+- launchApp:
+    clearState: true
+
+- extendedWaitUntil:
+    visible:
+      id: "service-state"
+      text: "STARTED"
+    timeout: 60000
+
+- tapOn:
+    id: "size-64"
+- tapOn:
+    id: "size-1024"
+- tapOn:
+    id: "size-65536"
+- tapOn:
+    id: "size-1048576"
+
+- tapOn:
+    id: "send-button"
+
+- extendedWaitUntil:
+    visible:
+      id: "benchmark-result"
+    timeout: 180000
+
+- assertVisible:
+    text: "1MB"

apps/benchmark/.maestro/bench-payload-64B.yaml

@@ -0,0 +1,30 @@
+appId: com.comapeo.core.benchmark
+---
+# Per-payload-size variant of bench-rpc.yaml: only 64B selected.
+# Default selection is {64B, 1KB, 64KB}; deselect the two larger sizes
+# so the run records 64B-only RTT distribution.
+
+- launchApp:
+    clearState: true
+
+- extendedWaitUntil:
+    visible:
+      id: "service-state"
+      text: "STARTED"
+    timeout: 60000
+
+- tapOn:
+    id: "size-1024"
+- tapOn:
+    id: "size-65536"
+
+- tapOn:
+    id: "send-button"
+
+- extendedWaitUntil:
+    visible:
+      id: "benchmark-result"
+    timeout: 60000
+
+- assertVisible:
+    text: "64B"

apps/benchmark/.maestro/bench-payload-64KB.yaml

@@ -0,0 +1,28 @@
+appId: com.comapeo.core.benchmark
+---
+# Per-payload-size variant of bench-rpc.yaml: only 64KB selected.
+
+- launchApp:
+    clearState: true
+
+- extendedWaitUntil:
+    visible:
+      id: "service-state"
+      text: "STARTED"
+    timeout: 60000
+
+- tapOn:
+    id: "size-64"
+- tapOn:
+    id: "size-1024"
+
+- tapOn:
+    id: "send-button"
+
+- extendedWaitUntil:
+    visible:
+      id: "benchmark-result"
+    timeout: 90000
+
+- assertVisible:
+    text: "64KB"

apps/benchmark/.maestro/bench-rpc.yaml

@@ -0,0 +1,34 @@
+appId: com.comapeo.core.benchmark
+---
+# UDS / RPC bridge benchmark — bench app launches its own bench backend
+# (rolled up from `apps/benchmark/backend/`, dropped into the consumer
+# app's `nodejs-project/` by the `with-comapeo-bench` Expo plugin and
+# loaded via the module's `comapeoEntryFile` override), waits for the
+# service to reach STARTED, runs a sweep across the default payload
+# sizes, and reads back the on-screen p50/p95/p99 panel. Spans are also
+# written to the app's documents directory; "Export results" opens the
+# system share sheet.
+
+- launchApp:
+    clearState: true
+
+- extendedWaitUntil:
+    visible:
+      id: "service-state"
+      text: "STARTED"
+    timeout: 60000
+
+- tapOn:
+    id: "send-button"
+
+- extendedWaitUntil:
+    visible:
+      id: "benchmark-result"
+    timeout: 120000
+
+- assertVisible:
+    id: "benchmark-result"
+- assertVisible:
+    text: "p50"
+- assertVisible:
+    text: "p99"

apps/benchmark/.maestro/config.yaml

@@ -0,0 +1,12 @@
+# Workspace config for the bench Maestro suite. Picked up automatically
+# when Maestro runs against this directory; the BrowserStack runner zips
+# everything under here into a single parent folder so BS sees the same
+# layout.
+#
+# `flows` constrains discovery to bench-only YAMLs — keeps stray editor
+# files (`.swp`, `.DS_Store`) and accidental sibling additions out of the
+# uploaded zip. The runner's `bench-summarize.ts` and the BS dispatch
+# script don't read this file directly; it's purely for Maestro's CLI
+# `maestro test` discovery.
+flows:
+  - "bench-*.yaml"