feat(webviews): add MVP WebView support

MODULE.bazel

@@ -193,6 +193,7 @@ maven.install(
 
         # Compile-only via wrapper target; not on runtime classpath
         "com.squareup.retrofit2:retrofit:3.0.0",
+        "androidx.webkit:webkit:1.12.1",
     ],
     repositories = [
         "https://maven.google.com",

Makefile

@@ -76,3 +76,13 @@ xcframework:
 .PHONY: test-gradle
 test-gradle:
 	platform/jvm/gradlew :capture:testDebugUnitTest -p platform/jvm
+
+.PHONY: fix-ts
+fix-ts:
+	npm --prefix ./platform/webview run lint:fix
+	npm --prefix ./platform/webview run format
+
+.PHONY: build-ts
+build-ts:
+	npm --prefix ./platform/webview run build
+	npm --prefix ./platform/webview run generate

ci/license_header.py

@@ -27,7 +27,7 @@
     './target/',
 )
 
-extensions_to_check = ('.rs', '.toml', '.kt', '.java', '.swift')
+extensions_to_check = ('.rs', '.toml', '.kt', '.java', '.swift', '.js', '.ts')
 
 
 def check_file(file_path):

examples/android/BUILD

@@ -28,6 +28,7 @@ _maven_deps = [
     artifact("org.jetbrains:annotations"),
     artifact("androidx.metrics:metrics-performance"),
     artifact("com.squareup.retrofit2:retrofit"),
+    artifact("androidx.webkit:webkit"),
 ]
 
 aar_import(

platform/jvm/capture/BUILD.bazel

@@ -23,6 +23,14 @@ java_library(
     exports = [artifact("com.squareup.retrofit2:retrofit")],
 )
 
+# WebKit compile-only wrapper: exposes API at compile time, excluded from runtime via neverlink.
+java_library(
+    name = "webkit_compile_only",
+    neverlink = True,
+    visibility = ["//visibility:public"],
+    exports = [artifact("androidx.webkit:webkit")],
+)
+
 # export proguard library rules
 exports_files(["consumer-rules.pro"])
 
@@ -71,6 +79,7 @@ bitdrift_kt_android_library(
         artifact("androidx.metrics:metrics-performance"),
         # Compile-only dependency (neverlink wrapper). Not packaged nor appearing in POM.
         ":retrofit_compile_only",
+        ":webkit_compile_only",
     ],
 )
 

platform/jvm/capture/build.gradle.kts

@@ -28,6 +28,7 @@ dependencies {
     implementation(project(":common"))
     implementation(libs.androidx.core)
     implementation(libs.androidx.startup.runtime)
+    implementation(libs.androidx.webkit)
     implementation(libs.jsr305)
     implementation(libs.gson)
     implementation(libs.performance)

platform/jvm/capture/src/main/kotlin/io/bitdrift/capture/webview/WebViewBridgeModels.kt

@@ -0,0 +1,137 @@
+// capture-sdk - bitdrift's client SDK
+// Copyright Bitdrift, Inc. All rights reserved.
+//
+// Use of this source code is governed by a source available license that can be found in the
+// LICENSE file or at:
+// https://polyformproject.org/wp-content/uploads/2020/06/PolyForm-Shield-1.0.0.txt
+
+package io.bitdrift.capture.webview
+
+import com.google.gson.annotations.SerializedName
+
+/**
+ * Base class for all WebView bridge messages.
+ * All messages have a version, type, and timestamp.
+ */
+internal data class WebViewBridgeMessage(
+    @SerializedName("v") val version: Int = 0,
+    val tag: String? = null,
+    val type: String? = null,
+    val timestamp: Long? = null,
+    // bridgeReady
+    val url: String? = null,
+    // webVital
+    val metric: WebVitalMetric? = null,
+    val parentSpanId: String? = null,
+    // networkRequest
+    val method: String? = null,
+    val statusCode: Int? = null,
+    val durationMs: Long? = null,
+    val success: Boolean? = null,
+    val error: String? = null,
+    val requestType: String? = null,
+    val timing: NetworkTiming? = null,
+    // navigation
+    val fromUrl: String? = null,
+    val toUrl: String? = null,
+    // pageView
+    val action: String? = null,
+    val spanId: String? = null,
+    val reason: String? = null,
+    // lifecycle
+    val event: String? = null,
+    val performanceTime: Double? = null,
+    val visibilityState: String? = null,
+    // error
+    val name: String? = null,
+    val message: String? = null,
+    val stack: String? = null,
+    val filename: String? = null,
+    val lineno: Int? = null,
+    val colno: Int? = null,
+    // longTask
+    val startTime: Double? = null,
+    val attribution: LongTaskAttribution? = null,
+    // resourceError
+    val resourceType: String? = null,
+    val tagName: String? = null,
+    // console
+    val level: String? = null,
+    val args: List<String>? = null,
+    // userInteraction
+    val interactionType: String? = null,
+    val elementId: String? = null,
+    val className: String? = null,
+    val textContent: String? = null,
+    val isClickable: Boolean? = null,
+    val clickCount: Int? = null,
+    val timeWindowMs: Int? = null,
+)
+
+/**
+ * Web Vital metric data from the web-vitals library.
+ */
+internal data class WebVitalMetric(
+    val name: String? = null,
+    val value: Double? = null,
+    val rating: String? = null,
+    val delta: Double? = null,
+    val id: String? = null,
+    val navigationType: String? = null,
+    val entries: List<WebVitalEntry>? = null,
+)
+
+/**
+ * Performance entry associated with a web vital metric.
+ * Contains different fields depending on the metric type.
+ */
+internal data class WebVitalEntry(
+    // Common fields
+    val startTime: Double? = null,
+    val entryType: String? = null,
+    // LCP-specific
+    val element: String? = null,
+    val url: String? = null,
+    val size: Long? = null,
+    val renderTime: Double? = null,
+    val loadTime: Double? = null,
+    // FCP-specific
+    val name: String? = null,
+    // TTFB-specific (PerformanceNavigationTiming)
+    val domainLookupStart: Double? = null,
+    val domainLookupEnd: Double? = null,
+    val connectStart: Double? = null,
+    val connectEnd: Double? = null,
+    val secureConnectionStart: Double? = null,
+    val requestStart: Double? = null,
+    val responseStart: Double? = null,
+    // INP-specific
+    val processingStart: Double? = null,
+    val processingEnd: Double? = null,
+    val duration: Double? = null,
+    val interactionId: Long? = null,
+    // CLS-specific
+    val value: Double? = null,
+)
+
+/**
+ * Network timing data from the Performance API.
+ */
+internal data class NetworkTiming(
+    val transferSize: Long? = null,
+    val dnsMs: Long? = null,
+    val tlsMs: Long? = null,
+    val connectMs: Long? = null,
+    val ttfbMs: Long? = null,
+)
+
+/**
+ * Long task attribution data.
+ */
+internal data class LongTaskAttribution(
+    val name: String? = null,
+    val containerType: String? = null,
+    val containerSrc: String? = null,
+    val containerId: String? = null,
+    val containerName: String? = null,
+)