@scalebun/react-native 1.0.1 → 1.0.2

package/android/src/main/java/com/scalebun/replaysdk/voice/VoiceTranscriber.kt

@@ -1,104 +1,104 @@
-package com.scalebun.replaysdk.voice
-
-import android.content.Context
-import android.content.Intent
-import android.os.Build
-import android.os.Bundle
-import android.os.Handler
-import android.os.Looper
-import android.speech.RecognitionListener
-import android.speech.RecognizerIntent
-import android.speech.SpeechRecognizer
-
-/**
- * ScaleBun SDK — on-device voice transcription (Slice D).
- *
- * This is the Android implementation behind the SDK's TranscriptionProvider
- * abstraction: on-device STT only (no network, no creds). It runs a live
- * SpeechRecognizer session concurrently with the recorder and accumulates the
- * best transcript, returned when recording stops.
- *
- * The transcript is a best-effort PREFILL — the user always edits and explicitly
- * approves the final wording in the prompt before anything is sent, so an empty
- * result here (no STT engine, no mic input on a headless emulator) is non-fatal:
- * the editable field is the source of truth. The interface is platform-neutral so
- * a backend engine could replace this later without touching callers.
- */
-class VoiceTranscriber(private val context: Context) {
-
-    private var recognizer: SpeechRecognizer? = null
-    private val main = Handler(Looper.getMainLooper())
-    @Volatile private var transcript: String = ""
-    @Volatile private var available: Boolean = false
-
-    /** Start a live on-device recognition session. Best-effort — never throws. */
-    fun start() {
-        main.post {
-            try {
-                if (!SpeechRecognizer.isRecognitionAvailable(context)) return@post
-                val rec = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
-                    SpeechRecognizer.isOnDeviceRecognitionAvailable(context)
-                ) {
-                    SpeechRecognizer.createOnDeviceSpeechRecognizer(context)
-                } else {
-                    SpeechRecognizer.createSpeechRecognizer(context)
-                }
-                rec.setRecognitionListener(listener)
-                val intent = Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH).apply {
-                    putExtra(
-                        RecognizerIntent.EXTRA_LANGUAGE_MODEL,
-                        RecognizerIntent.LANGUAGE_MODEL_FREE_FORM,
-                    )
-                    putExtra(RecognizerIntent.EXTRA_PARTIAL_RESULTS, true)
-                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-                        putExtra(RecognizerIntent.EXTRA_PREFER_OFFLINE, true)
-                    }
-                }
-                recognizer = rec
-                available = true
-                rec.startListening(intent)
-            } catch (_: Exception) {
-                available = false
-            }
-        }
-    }
-
-    /** Stop the session and return the accumulated transcript (may be empty). */
-    fun stop(): TranscriptResult {
-        main.post {
-            try {
-                recognizer?.stopListening()
-                recognizer?.destroy()
-            } catch (_: Exception) {
-            }
-            recognizer = null
-        }
-        return TranscriptResult(transcript.trim(), available)
-    }
-
-    private val listener = object : RecognitionListener {
-        override fun onResults(results: Bundle?) {
-            results
-                ?.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION)
-                ?.firstOrNull()
-                ?.let { if (it.isNotBlank()) transcript = it }
-        }
-
-        override fun onPartialResults(partial: Bundle?) {
-            partial
-                ?.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION)
-                ?.firstOrNull()
-                ?.let { if (it.isNotBlank()) transcript = it }
-        }
-
-        override fun onError(error: Int) {}
-        override fun onReadyForSpeech(params: Bundle?) {}
-        override fun onBeginningOfSpeech() {}
-        override fun onRmsChanged(rmsdB: Float) {}
-        override fun onBufferReceived(buffer: ByteArray?) {}
-        override fun onEndOfSpeech() {}
-        override fun onEvent(eventType: Int, params: Bundle?) {}
-    }
-
-    data class TranscriptResult(val text: String, val available: Boolean)
-}
+package com.scalebun.replaysdk.voice
+
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.os.Bundle
+import android.os.Handler
+import android.os.Looper
+import android.speech.RecognitionListener
+import android.speech.RecognizerIntent
+import android.speech.SpeechRecognizer
+
+/**
+ * ScaleBun SDK — on-device voice transcription (Slice D).
+ *
+ * This is the Android implementation behind the SDK's TranscriptionProvider
+ * abstraction: on-device STT only (no network, no creds). It runs a live
+ * SpeechRecognizer session concurrently with the recorder and accumulates the
+ * best transcript, returned when recording stops.
+ *
+ * The transcript is a best-effort PREFILL — the user always edits and explicitly
+ * approves the final wording in the prompt before anything is sent, so an empty
+ * result here (no STT engine, no mic input on a headless emulator) is non-fatal:
+ * the editable field is the source of truth. The interface is platform-neutral so
+ * a backend engine could replace this later without touching callers.
+ */
+class VoiceTranscriber(private val context: Context) {
+
+    private var recognizer: SpeechRecognizer? = null
+    private val main = Handler(Looper.getMainLooper())
+    @Volatile private var transcript: String = ""
+    @Volatile private var available: Boolean = false
+
+    /** Start a live on-device recognition session. Best-effort — never throws. */
+    fun start() {
+        main.post {
+            try {
+                if (!SpeechRecognizer.isRecognitionAvailable(context)) return@post
+                val rec = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
+                    SpeechRecognizer.isOnDeviceRecognitionAvailable(context)
+                ) {
+                    SpeechRecognizer.createOnDeviceSpeechRecognizer(context)
+                } else {
+                    SpeechRecognizer.createSpeechRecognizer(context)
+                }
+                rec.setRecognitionListener(listener)
+                val intent = Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH).apply {
+                    putExtra(
+                        RecognizerIntent.EXTRA_LANGUAGE_MODEL,
+                        RecognizerIntent.LANGUAGE_MODEL_FREE_FORM,
+                    )
+                    putExtra(RecognizerIntent.EXTRA_PARTIAL_RESULTS, true)
+                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+                        putExtra(RecognizerIntent.EXTRA_PREFER_OFFLINE, true)
+                    }
+                }
+                recognizer = rec
+                available = true
+                rec.startListening(intent)
+            } catch (_: Exception) {
+                available = false
+            }
+        }
+    }
+
+    /** Stop the session and return the accumulated transcript (may be empty). */
+    fun stop(): TranscriptResult {
+        main.post {
+            try {
+                recognizer?.stopListening()
+                recognizer?.destroy()
+            } catch (_: Exception) {
+            }
+            recognizer = null
+        }
+        return TranscriptResult(transcript.trim(), available)
+    }
+
+    private val listener = object : RecognitionListener {
+        override fun onResults(results: Bundle?) {
+            results
+                ?.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION)
+                ?.firstOrNull()
+                ?.let { if (it.isNotBlank()) transcript = it }
+        }
+
+        override fun onPartialResults(partial: Bundle?) {
+            partial
+                ?.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION)
+                ?.firstOrNull()
+                ?.let { if (it.isNotBlank()) transcript = it }
+        }
+
+        override fun onError(error: Int) {}
+        override fun onReadyForSpeech(params: Bundle?) {}
+        override fun onBeginningOfSpeech() {}
+        override fun onRmsChanged(rmsdB: Float) {}
+        override fun onBufferReceived(buffer: ByteArray?) {}
+        override fun onEndOfSpeech() {}
+        override fun onEvent(eventType: Int, params: Bundle?) {}
+    }
+
+    data class TranscriptResult(val text: String, val available: Boolean)
+}

package/android/src/main/java/com/scalebun/rn/ScaleBunPackage.kt

@@ -1,113 +1,113 @@
-package com.scalebun.rn
-
-import com.facebook.react.BaseReactPackage
-import com.facebook.react.bridge.NativeModule
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.module.model.ReactModuleInfo
-import com.facebook.react.module.model.ReactModuleInfoProvider
-import com.scalebun.profiler.ProfilerModule
-import com.scalebun.replaysdk.ReplaySdkModule
-import com.scalebun.rn.crash.ScaleBunCrashModule
-import com.scalebun.rn.engage.ScaleBunEngageModule
-import com.scalebun.rn.performance.PerformanceModule
-import com.scalebun.rn.referrer.ScaleBunInstallReferrerModule
-import com.scalebun.rn.ota.ScaleBunOtaModule
-import com.scalebun.rn.storage.ScaleBunStorageModule
-import com.scalebun.sdk.BuildConfig
-
-/**
- * Single autolink entry point for the ScaleBun SDK on Android.
- *
- * React Native autolinking registers exactly **one** package per dependency, so
- * this aggregator owns every ScaleBun native module and is wired in
- * `react-native.config.js` — consumers add **nothing** to `MainApplication.kt`.
- *
- * It is a [BaseReactPackage] (the modern, both-architecture base) so modules can
- * be exposed as real **TurboModules** on the New Architecture and classic
- * NativeModules on the Old Architecture, lazily (one instance per requested
- * name). Per-module migration status:
- *  - `ScaleBunCrash`        → backward-compatible TurboModule (Phase 2)
- *  - `ScaleBunProfiler`     → backward-compatible TurboModule (Phase 2; events via emitter)
- *  - `ScaleBunPerformance`  → backward-compatible TurboModule (Phase 2; events via emitter)
- *  - `ReplaySdk`       → backward-compatible TurboModule (Phase 3; events via emitter)
- *
- * NOTE (migration): consumers who previously added a ScaleBun package to
- * `MainApplication` manually must **remove** it, or RN throws on the duplicate
- * native-module name.
- */
-class ScaleBunPackage : BaseReactPackage() {
-
-    override fun getModule(
-        name: String,
-        reactContext: ReactApplicationContext,
-    ): NativeModule? = when (name) {
-        ScaleBunCrashModule.NAME -> ScaleBunCrashModule(reactContext)
-        PROFILER -> ProfilerModule(reactContext)
-        REPLAY -> ReplaySdkModule(reactContext)
-        PERFORMANCE -> PerformanceModule(reactContext)
-        ENGAGE -> ScaleBunEngageModule(reactContext)
-        ScaleBunStorageModule.NAME -> ScaleBunStorageModule(reactContext)
-        ScaleBunInstallReferrerModule.NAME -> ScaleBunInstallReferrerModule(reactContext)
-        ScaleBunOtaModule.NAME -> ScaleBunOtaModule(reactContext)
-        else -> null
-    }
-
-    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
-        val isNewArch = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
-        return ReactModuleInfoProvider {
-            mapOf(
-                // Crash is a real TurboModule on New Arch (codegen-backed),
-                // a legacy NativeModule on Old Arch.
-                ScaleBunCrashModule.NAME to info(
-                    ScaleBunCrashModule.NAME, ScaleBunCrashModule::class.java.name, isTurbo = isNewArch,
-                ),
-                // Profiler is a backward-compatible TurboModule on New Arch (events
-                // still flow via the device event emitter, independent of this).
-                PROFILER to info(PROFILER, ProfilerModule::class.java.name, isTurbo = isNewArch),
-                PERFORMANCE to info(PERFORMANCE, PerformanceModule::class.java.name, isTurbo = isNewArch),
-                REPLAY to info(REPLAY, ReplaySdkModule::class.java.name, isTurbo = isNewArch),
-                // Engage is a classic NativeModule (no codegen spec), so it is NEVER
-                // a TurboModule — isTurbo MUST be false or the New-Arch TurboModule
-                // system would look for a non-existent JSI spec. It resolves via the
-                // interop layer on New Arch and as a plain NativeModule on Old Arch.
-                ENGAGE to info(ENGAGE, ScaleBunEngageModule::class.java.name, isTurbo = false),
-                // Storage is the SDK's first-party durable KV store. It HAS a codegen
-                // spec (src/specs/NativeScaleBunStorage.ts), so it is a real TurboModule on
-                // New Arch (with a synchronous getAllSync JSI method) and a classic
-                // NativeModule on Old Arch.
-                ScaleBunStorageModule.NAME to info(
-                    ScaleBunStorageModule.NAME, ScaleBunStorageModule::class.java.name, isTurbo = isNewArch,
-                ),
-                // Install Referrer (Android-only) HAS a codegen spec
-                // (src/specs/NativeScaleBunInstallReferrer.ts) → real TurboModule on
-                // New Arch, classic NativeModule on Old Arch.
-                ScaleBunInstallReferrerModule.NAME to info(
-                    ScaleBunInstallReferrerModule.NAME, ScaleBunInstallReferrerModule::class.java.name, isTurbo = isNewArch,
-                ),
-                // OTA bundle management HAS a codegen spec
-                // (src/specs/NativeScaleBunOta.ts) → real TurboModule on
-                // New Arch, classic NativeModule on Old Arch.
-                ScaleBunOtaModule.NAME to info(
-                    ScaleBunOtaModule.NAME, ScaleBunOtaModule::class.java.name, isTurbo = isNewArch,
-                ),
-            )
-        }
-    }
-
-    private fun info(name: String, className: String, isTurbo: Boolean) =
-        ReactModuleInfo(
-            name,
-            className,
-            /* canOverrideExistingModule = */ false,
-            /* needsEagerInit = */ false,
-            /* isCxxModule = */ false,
-            /* isTurboModule = */ isTurbo,
-        )
-
-    private companion object {
-        const val PROFILER = "ScaleBunProfiler"
-        const val REPLAY = "ReplaySdk"
-        const val PERFORMANCE = "ScaleBunPerformance"
-        const val ENGAGE = "ScaleBunEngage"
-    }
-}
+package com.scalebun.rn
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.scalebun.profiler.ProfilerModule
+import com.scalebun.replaysdk.ReplaySdkModule
+import com.scalebun.rn.crash.ScaleBunCrashModule
+import com.scalebun.rn.engage.ScaleBunEngageModule
+import com.scalebun.rn.performance.PerformanceModule
+import com.scalebun.rn.referrer.ScaleBunInstallReferrerModule
+import com.scalebun.rn.ota.ScaleBunOtaModule
+import com.scalebun.rn.storage.ScaleBunStorageModule
+import com.scalebun.sdk.BuildConfig
+
+/**
+ * Single autolink entry point for the ScaleBun SDK on Android.
+ *
+ * React Native autolinking registers exactly **one** package per dependency, so
+ * this aggregator owns every ScaleBun native module and is wired in
+ * `react-native.config.js` — consumers add **nothing** to `MainApplication.kt`.
+ *
+ * It is a [BaseReactPackage] (the modern, both-architecture base) so modules can
+ * be exposed as real **TurboModules** on the New Architecture and classic
+ * NativeModules on the Old Architecture, lazily (one instance per requested
+ * name). Per-module migration status:
+ *  - `ScaleBunCrash`        → backward-compatible TurboModule (Phase 2)
+ *  - `ScaleBunProfiler`     → backward-compatible TurboModule (Phase 2; events via emitter)
+ *  - `ScaleBunPerformance`  → backward-compatible TurboModule (Phase 2; events via emitter)
+ *  - `ReplaySdk`       → backward-compatible TurboModule (Phase 3; events via emitter)
+ *
+ * NOTE (migration): consumers who previously added a ScaleBun package to
+ * `MainApplication` manually must **remove** it, or RN throws on the duplicate
+ * native-module name.
+ */
+class ScaleBunPackage : BaseReactPackage() {
+
+    override fun getModule(
+        name: String,
+        reactContext: ReactApplicationContext,
+    ): NativeModule? = when (name) {
+        ScaleBunCrashModule.NAME -> ScaleBunCrashModule(reactContext)
+        PROFILER -> ProfilerModule(reactContext)
+        REPLAY -> ReplaySdkModule(reactContext)
+        PERFORMANCE -> PerformanceModule(reactContext)
+        ENGAGE -> ScaleBunEngageModule(reactContext)
+        ScaleBunStorageModule.NAME -> ScaleBunStorageModule(reactContext)
+        ScaleBunInstallReferrerModule.NAME -> ScaleBunInstallReferrerModule(reactContext)
+        ScaleBunOtaModule.NAME -> ScaleBunOtaModule(reactContext)
+        else -> null
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        val isNewArch = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
+        return ReactModuleInfoProvider {
+            mapOf(
+                // Crash is a real TurboModule on New Arch (codegen-backed),
+                // a legacy NativeModule on Old Arch.
+                ScaleBunCrashModule.NAME to info(
+                    ScaleBunCrashModule.NAME, ScaleBunCrashModule::class.java.name, isTurbo = isNewArch,
+                ),
+                // Profiler is a backward-compatible TurboModule on New Arch (events
+                // still flow via the device event emitter, independent of this).
+                PROFILER to info(PROFILER, ProfilerModule::class.java.name, isTurbo = isNewArch),
+                PERFORMANCE to info(PERFORMANCE, PerformanceModule::class.java.name, isTurbo = isNewArch),
+                REPLAY to info(REPLAY, ReplaySdkModule::class.java.name, isTurbo = isNewArch),
+                // Engage is a classic NativeModule (no codegen spec), so it is NEVER
+                // a TurboModule — isTurbo MUST be false or the New-Arch TurboModule
+                // system would look for a non-existent JSI spec. It resolves via the
+                // interop layer on New Arch and as a plain NativeModule on Old Arch.
+                ENGAGE to info(ENGAGE, ScaleBunEngageModule::class.java.name, isTurbo = false),
+                // Storage is the SDK's first-party durable KV store. It HAS a codegen
+                // spec (src/specs/NativeScaleBunStorage.ts), so it is a real TurboModule on
+                // New Arch (with a synchronous getAllSync JSI method) and a classic
+                // NativeModule on Old Arch.
+                ScaleBunStorageModule.NAME to info(
+                    ScaleBunStorageModule.NAME, ScaleBunStorageModule::class.java.name, isTurbo = isNewArch,
+                ),
+                // Install Referrer (Android-only) HAS a codegen spec
+                // (src/specs/NativeScaleBunInstallReferrer.ts) → real TurboModule on
+                // New Arch, classic NativeModule on Old Arch.
+                ScaleBunInstallReferrerModule.NAME to info(
+                    ScaleBunInstallReferrerModule.NAME, ScaleBunInstallReferrerModule::class.java.name, isTurbo = isNewArch,
+                ),
+                // OTA bundle management HAS a codegen spec
+                // (src/specs/NativeScaleBunOta.ts) → real TurboModule on
+                // New Arch, classic NativeModule on Old Arch.
+                ScaleBunOtaModule.NAME to info(
+                    ScaleBunOtaModule.NAME, ScaleBunOtaModule::class.java.name, isTurbo = isNewArch,
+                ),
+            )
+        }
+    }
+
+    private fun info(name: String, className: String, isTurbo: Boolean) =
+        ReactModuleInfo(
+            name,
+            className,
+            /* canOverrideExistingModule = */ false,
+            /* needsEagerInit = */ false,
+            /* isCxxModule = */ false,
+            /* isTurboModule = */ isTurbo,
+        )
+
+    private companion object {
+        const val PROFILER = "ScaleBunProfiler"
+        const val REPLAY = "ReplaySdk"
+        const val PERFORMANCE = "ScaleBunPerformance"
+        const val ENGAGE = "ScaleBunEngage"
+    }
+}

package/android/src/main/java/com/scalebun/rn/crash/ScaleBunCrashModule.kt

@@ -1,100 +1,100 @@
-package com.scalebun.rn.crash
-
-import com.facebook.react.bridge.*
-import com.scalebun.core.crash.CrashStorage
-import com.scalebun.core.crash.NativeCrashHandler
-
-/**
- * React Native bridge for native crash capture.
- *
- * Backward-compatible across architectures: extends [ScaleBunCrashSpec], which is the
- * codegen TurboModule base on New Arch (`src/newarch`) and a classic
- * NativeModule base on Old Arch (`src/oldarch`). All capture logic stays in
- * `com.scalebun.core.crash` — this is thin glue only.
- *
- * Methods:
- *   install()            — installs Thread.UncaughtExceptionHandler
- *   drainPendingCrash()  — returns crash from previous run (or null), then clears it
- *   crashNow()           — DEV/TEST: throws on a background thread so the
- *                          installed handler captures + persists it, then dies
- */
-class ScaleBunCrashModule(reactContext: ReactApplicationContext) :
-    ScaleBunCrashSpec(reactContext) {
-
-    companion object {
-        const val NAME = "ScaleBunCrash"
-    }
-
-    override fun getName(): String = NAME
-
-    @ReactMethod
-    override fun crashNow(promise: Promise) {
-        // Resolve first — the JS side won't get a chance once the process dies.
-        promise.resolve(true)
-        // Throw on a fresh thread; the installed default UncaughtExceptionHandler
-        // persists the crash and the process terminates (real native crash).
-        Thread {
-            throw RuntimeException("ScaleBun test native crash (Android)")
-        }.start()
-    }
-
-    @ReactMethod
-    override fun install(promise: Promise) {
-        try {
-            NativeCrashHandler.install(reactApplicationContext.applicationContext)
-            promise.resolve(true)
-        } catch (e: Exception) {
-            promise.reject("CRASH_INSTALL_ERROR", e.message, e)
-        }
-    }
-
-    @ReactMethod
-    override fun drainPendingCrash(promise: Promise) {
-        try {
-            val context = reactApplicationContext.applicationContext
-            val crash = CrashStorage.read(context)
-            if (crash == null) {
-                promise.resolve(null)
-                return
-            }
-            CrashStorage.clear(context)
-
-            val result = Arguments.createMap()
-            result.putString("name", crash.optString("name", "crash.native"))
-            result.putString("exceptionType", crash.optString("exceptionType"))
-            result.putString("message", crash.optString("message"))
-            result.putString("threadName", crash.optString("threadName"))
-            result.putDouble("timestamp", crash.optDouble("timestamp"))
-            result.putString("platform", "android")
-
-            val stackJson = crash.optJSONArray("stackTrace")
-            if (stackJson != null) {
-                val frames = Arguments.createArray()
-                for (i in 0 until stackJson.length()) {
-                    frames.pushString(stackJson.optString(i))
-                }
-                result.putArray("stackTrace", frames)
-            }
-
-            val causeJson = crash.optJSONObject("cause")
-            if (causeJson != null) {
-                val cause = Arguments.createMap()
-                cause.putString("exceptionType", causeJson.optString("exceptionType"))
-                cause.putString("message", causeJson.optString("message"))
-                val causeStack = causeJson.optJSONArray("stackTrace")
-                if (causeStack != null) {
-                    val frames = Arguments.createArray()
-                    for (i in 0 until causeStack.length()) {
-                        frames.pushString(causeStack.optString(i))
-                    }
-                    cause.putArray("stackTrace", frames)
-                }
-                result.putMap("cause", cause)
-            }
-
-            promise.resolve(result)
-        } catch (e: Exception) {
-            promise.reject("CRASH_DRAIN_ERROR", e.message, e)
-        }
-    }
-}
+package com.scalebun.rn.crash
+
+import com.facebook.react.bridge.*
+import com.scalebun.core.crash.CrashStorage
+import com.scalebun.core.crash.NativeCrashHandler
+
+/**
+ * React Native bridge for native crash capture.
+ *
+ * Backward-compatible across architectures: extends [ScaleBunCrashSpec], which is the
+ * codegen TurboModule base on New Arch (`src/newarch`) and a classic
+ * NativeModule base on Old Arch (`src/oldarch`). All capture logic stays in
+ * `com.scalebun.core.crash` — this is thin glue only.
+ *
+ * Methods:
+ *   install()            — installs Thread.UncaughtExceptionHandler
+ *   drainPendingCrash()  — returns crash from previous run (or null), then clears it
+ *   crashNow()           — DEV/TEST: throws on a background thread so the
+ *                          installed handler captures + persists it, then dies
+ */
+class ScaleBunCrashModule(reactContext: ReactApplicationContext) :
+    ScaleBunCrashSpec(reactContext) {
+
+    companion object {
+        const val NAME = "ScaleBunCrash"
+    }
+
+    override fun getName(): String = NAME
+
+    @ReactMethod
+    override fun crashNow(promise: Promise) {
+        // Resolve first — the JS side won't get a chance once the process dies.
+        promise.resolve(true)
+        // Throw on a fresh thread; the installed default UncaughtExceptionHandler
+        // persists the crash and the process terminates (real native crash).
+        Thread {
+            throw RuntimeException("ScaleBun test native crash (Android)")
+        }.start()
+    }
+
+    @ReactMethod
+    override fun install(promise: Promise) {
+        try {
+            NativeCrashHandler.install(reactApplicationContext.applicationContext)
+            promise.resolve(true)
+        } catch (e: Exception) {
+            promise.reject("CRASH_INSTALL_ERROR", e.message, e)
+        }
+    }
+
+    @ReactMethod
+    override fun drainPendingCrash(promise: Promise) {
+        try {
+            val context = reactApplicationContext.applicationContext
+            val crash = CrashStorage.read(context)
+            if (crash == null) {
+                promise.resolve(null)
+                return
+            }
+            CrashStorage.clear(context)
+
+            val result = Arguments.createMap()
+            result.putString("name", crash.optString("name", "crash.native"))
+            result.putString("exceptionType", crash.optString("exceptionType"))
+            result.putString("message", crash.optString("message"))
+            result.putString("threadName", crash.optString("threadName"))
+            result.putDouble("timestamp", crash.optDouble("timestamp"))
+            result.putString("platform", "android")
+
+            val stackJson = crash.optJSONArray("stackTrace")
+            if (stackJson != null) {
+                val frames = Arguments.createArray()
+                for (i in 0 until stackJson.length()) {
+                    frames.pushString(stackJson.optString(i))
+                }
+                result.putArray("stackTrace", frames)
+            }
+
+            val causeJson = crash.optJSONObject("cause")
+            if (causeJson != null) {
+                val cause = Arguments.createMap()
+                cause.putString("exceptionType", causeJson.optString("exceptionType"))
+                cause.putString("message", causeJson.optString("message"))
+                val causeStack = causeJson.optJSONArray("stackTrace")
+                if (causeStack != null) {
+                    val frames = Arguments.createArray()
+                    for (i in 0 until causeStack.length()) {
+                        frames.pushString(causeStack.optString(i))
+                    }
+                    cause.putArray("stackTrace", frames)
+                }
+                result.putMap("cause", cause)
+            }
+
+            promise.resolve(result)
+        } catch (e: Exception) {
+            promise.reject("CRASH_DRAIN_ERROR", e.message, e)
+        }
+    }
+}