@scalebun/react-native 1.0.2 → 1.0.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 ScaleBun
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 ScaleBun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,65 +1,65 @@
-# @scalebun/react-native
-
-Production-grade React Native SDK for [ScaleBun](https://scalebun.com) — error reporting, analytics, session replay, and in-app engagement for iOS and Android.
-
-## Installation
-
-```sh
-npm install @scalebun/react-native
-# or
-pnpm add @scalebun/react-native
-# or
-yarn add @scalebun/react-native
-```
-
-### iOS
-
-```sh
-cd ios && pod install
-```
-
-### Optional peer dependencies
-
-Some features activate only when their peer package is installed:
-
-| Feature            | Peer dependency               |
-| ------------------ | ----------------------------- |
-| Screenshot capture | `react-native-view-shot`      |
-| Push notifications | `@notifee/react-native`       |
-| Expo Router journey | `expo-router`                |
-
-## Quick start
-
-Wrap your app in the provider and pass your project credentials from the dashboard:
-
-```tsx
-import { ScaleBunProvider } from '@scalebun/react-native';
-
-export default function App() {
-  return (
-    <ScaleBunProvider
-      config={{
-        projectId: 'YOUR_PROJECT_ID',
-        publishableKey: 'YOUR_PUBLISHABLE_KEY',
-      }}
-    >
-      <RootNavigator />
-    </ScaleBunProvider>
-  );
-}
-```
-
-The default export exposes the imperative facade for use outside React (identifying users, capturing events, etc.):
-
-```ts
-import ScaleBun from '@scalebun/react-native';
-```
-
-## Requirements
-
-- React Native `>= 0.74`
-- React `>= 18`
-
-## License
-
-MIT © ScaleBun
+# @scalebun/react-native
+
+Production-grade React Native SDK for [ScaleBun](https://scalebun.dev) — error reporting, analytics, session replay, and in-app engagement for iOS and Android.
+
+## Installation
+
+```sh
+npm install @scalebun/react-native
+# or
+pnpm add @scalebun/react-native
+# or
+yarn add @scalebun/react-native
+```
+
+### iOS
+
+```sh
+cd ios && pod install
+```
+
+### Optional peer dependencies
+
+Some features activate only when their peer package is installed:
+
+| Feature            | Peer dependency               |
+| ------------------ | ----------------------------- |
+| Screenshot capture | `react-native-view-shot`      |
+| Push notifications | `@notifee/react-native`       |
+| Expo Router journey | `expo-router`                |
+
+## Quick start
+
+Wrap your app in the provider and pass your project credentials from the dashboard:
+
+```tsx
+import { ScaleBunProvider } from '@scalebun/react-native';
+
+export default function App() {
+  return (
+    <ScaleBunProvider
+      config={{
+        projectId: 'YOUR_PROJECT_ID',
+        publishableKey: 'YOUR_PUBLISHABLE_KEY',
+      }}
+    >
+      <RootNavigator />
+    </ScaleBunProvider>
+  );
+}
+```
+
+The default export exposes the imperative facade for use outside React (identifying users, capturing events, etc.):
+
+```ts
+import ScaleBun from '@scalebun/react-native';
+```
+
+## Requirements
+
+- React Native `>= 0.74`
+- React `>= 18`
+
+## License
+
+MIT © ScaleBun

package/android/build.gradle

@@ -1,86 +1,86 @@
-plugins {
-    id 'com.android.library'
-    id 'org.jetbrains.kotlin.android'
-}
-
-/**
- * Backward-compatible build for both React Native architectures.
- *
- * New Architecture: applies the React Native Gradle plugin (runs TurboModule
- * codegen from `codegenConfig` in package.json) and compiles the `src/newarch`
- * bridge wrappers, which implement the generated `Native*Spec` base classes.
- *
- * Old Architecture: compiles the `src/oldarch` wrappers (classic NativeModule).
- *
- * Either way the actual capture logic lives in `com.scalebun.core` (shared,
- * architecture-agnostic) — the wrappers are thin glue only.
- */
-def isNewArchitectureEnabled() {
-    return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
-}
-
-if (isNewArchitectureEnabled()) {
-    apply plugin: 'com.facebook.react'
-}
-
-android {
-    namespace 'com.scalebun.sdk'
-    compileSdk 34
-
-    buildFeatures {
-        // Exposes BuildConfig.IS_NEW_ARCHITECTURE_ENABLED so the (shared, main
-        // source set) package can flag the Crash module as a TurboModule only
-        // on New Arch, while staying a legacy module on Old Arch.
-        buildConfig true
-    }
-
-    defaultConfig {
-        minSdk 24
-        targetSdk 34
-        buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
-        // Ship R8 keep-rules to consumer apps so release minification doesn't
-        // strip the native modules / codegen TurboModule specs.
-        consumerProguardFiles "consumer-rules.pro"
-    }
-
-    sourceSets {
-        main {
-            java.srcDirs = ['src/main/java']
-            manifest.srcFile 'src/main/AndroidManifest.xml'
-
-            // Architecture-specific bridge wrappers (populated in Phase 2).
-            // Pointing at a not-yet-created dir is a harmless no-op until then.
-            if (isNewArchitectureEnabled()) {
-                java.srcDirs += ['src/newarch/java']
-            } else {
-                java.srcDirs += ['src/oldarch/java']
-            }
-        }
-    }
-
-    compileOptions {
-        sourceCompatibility JavaVersion.VERSION_17
-        targetCompatibility JavaVersion.VERSION_17
-    }
-
-    kotlinOptions {
-        jvmTarget = '17'
-    }
-}
-
-dependencies {
-    implementation 'com.facebook.react:react-android'
-    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
-
-    // Google Play Install Referrer — reads the install-time referrer string for
-    // deterministic Android attribution (ScaleBunInstallReferrerModule). Small,
-    // Play-only lib; degrades gracefully (the module rejects) where Play is absent.
-    implementation 'com.android.installreferrer:installreferrer:2.2'
-
-    // Engage push-token acquisition (FCM). Declared compileOnly so the SDK does
-    // NOT force Firebase onto host apps that don't use push: ScaleBunEngageModule reaches
-    // FirebaseMessaging purely via reflection and fails soft (logged skip) when the
-    // class is absent at runtime. Host apps that want push add the real
-    // firebase-messaging dependency in their own app module — additive, no break.
-    compileOnly 'com.google.firebase:firebase-messaging:23.4.1'
-}
+plugins {
+    id 'com.android.library'
+    id 'org.jetbrains.kotlin.android'
+}
+
+/**
+ * Backward-compatible build for both React Native architectures.
+ *
+ * New Architecture: applies the React Native Gradle plugin (runs TurboModule
+ * codegen from `codegenConfig` in package.json) and compiles the `src/newarch`
+ * bridge wrappers, which implement the generated `Native*Spec` base classes.
+ *
+ * Old Architecture: compiles the `src/oldarch` wrappers (classic NativeModule).
+ *
+ * Either way the actual capture logic lives in `com.scalebun.core` (shared,
+ * architecture-agnostic) — the wrappers are thin glue only.
+ */
+def isNewArchitectureEnabled() {
+    return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
+if (isNewArchitectureEnabled()) {
+    apply plugin: 'com.facebook.react'
+}
+
+android {
+    namespace 'com.scalebun.sdk'
+    compileSdk 34
+
+    buildFeatures {
+        // Exposes BuildConfig.IS_NEW_ARCHITECTURE_ENABLED so the (shared, main
+        // source set) package can flag the Crash module as a TurboModule only
+        // on New Arch, while staying a legacy module on Old Arch.
+        buildConfig true
+    }
+
+    defaultConfig {
+        minSdk 24
+        targetSdk 34
+        buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+        // Ship R8 keep-rules to consumer apps so release minification doesn't
+        // strip the native modules / codegen TurboModule specs.
+        consumerProguardFiles "consumer-rules.pro"
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs = ['src/main/java']
+            manifest.srcFile 'src/main/AndroidManifest.xml'
+
+            // Architecture-specific bridge wrappers (populated in Phase 2).
+            // Pointing at a not-yet-created dir is a harmless no-op until then.
+            if (isNewArchitectureEnabled()) {
+                java.srcDirs += ['src/newarch/java']
+            } else {
+                java.srcDirs += ['src/oldarch/java']
+            }
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+dependencies {
+    implementation 'com.facebook.react:react-android'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
+
+    // Google Play Install Referrer — reads the install-time referrer string for
+    // deterministic Android attribution (ScaleBunInstallReferrerModule). Small,
+    // Play-only lib; degrades gracefully (the module rejects) where Play is absent.
+    implementation 'com.android.installreferrer:installreferrer:2.2'
+
+    // Engage push-token acquisition (FCM). Declared compileOnly so the SDK does
+    // NOT force Firebase onto host apps that don't use push: ScaleBunEngageModule reaches
+    // FirebaseMessaging purely via reflection and fails soft (logged skip) when the
+    // class is absent at runtime. Host apps that want push add the real
+    // firebase-messaging dependency in their own app module — additive, no break.
+    compileOnly 'com.google.firebase:firebase-messaging:23.4.1'
+}

package/android/consumer-rules.pro

@@ -1,28 +1,28 @@
-# ScaleBun React Native SDK — R8/ProGuard consumer rules.
-#
-# Applied automatically to consumer apps (via `consumerProguardFiles` in
-# build.gradle). Without these, release builds with minification can strip the
-# native modules and the codegen TurboModule specs, causing "module not found"
-# at runtime on the New Architecture.
-
-# Keep all ScaleBun native classes. The SDK's native code is reflection- and
-# JNI-accessed (RN resolves modules by getName()/@ReactMethod; codegen specs are
-# referenced from generated C++/JNI), so it must not be renamed or removed.
--keep class com.scalebun.** { *; }
-
-# Codegen-generated TurboModule specs (com.scalebun.spec.NativeScaleBun*Spec / NativeReplaySdkSpec).
--keep class com.scalebun.spec.** { *; }
-
-# Google Play Install Referrer client — used by ScaleBunInstallReferrerModule for
-# deterministic Android acquisition attribution. Kept so release minification
-# doesn't strip the referrer client.
--keep class com.android.installreferrer.** { *; }
-
-# Defensive React Native bridge reflection (RN ships equivalents, kept here so the
-# SDK is self-contained even if app rules differ).
--keepclassmembers class * extends com.facebook.react.bridge.ReactContextBaseJavaModule {
-    @com.facebook.react.bridge.ReactMethod <methods>;
-}
--keep class * extends com.facebook.react.bridge.NativeModule { *; }
--keep class * extends com.facebook.react.BaseReactPackage { *; }
--keep class * extends com.facebook.react.turbomodule.core.interfaces.TurboModule { *; }
+# ScaleBun React Native SDK — R8/ProGuard consumer rules.
+#
+# Applied automatically to consumer apps (via `consumerProguardFiles` in
+# build.gradle). Without these, release builds with minification can strip the
+# native modules and the codegen TurboModule specs, causing "module not found"
+# at runtime on the New Architecture.
+
+# Keep all ScaleBun native classes. The SDK's native code is reflection- and
+# JNI-accessed (RN resolves modules by getName()/@ReactMethod; codegen specs are
+# referenced from generated C++/JNI), so it must not be renamed or removed.
+-keep class com.scalebun.** { *; }
+
+# Codegen-generated TurboModule specs (com.scalebun.spec.NativeScaleBun*Spec / NativeReplaySdkSpec).
+-keep class com.scalebun.spec.** { *; }
+
+# Google Play Install Referrer client — used by ScaleBunInstallReferrerModule for
+# deterministic Android acquisition attribution. Kept so release minification
+# doesn't strip the referrer client.
+-keep class com.android.installreferrer.** { *; }
+
+# Defensive React Native bridge reflection (RN ships equivalents, kept here so the
+# SDK is self-contained even if app rules differ).
+-keepclassmembers class * extends com.facebook.react.bridge.ReactContextBaseJavaModule {
+    @com.facebook.react.bridge.ReactMethod <methods>;
+}
+-keep class * extends com.facebook.react.bridge.NativeModule { *; }
+-keep class * extends com.facebook.react.BaseReactPackage { *; }
+-keep class * extends com.facebook.react.turbomodule.core.interfaces.TurboModule { *; }

package/android/src/main/AndroidManifest.xml

@@ -1,14 +1,14 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.scalebun.sdk">
-
-    <!-- The SDK uploads telemetry (crashes, replay frames, performance) over the
-         network. Host RN/Expo apps normally declare INTERNET already; declaring it
-         here ensures it is present via manifest merging. -->
-    <uses-permission android:name="android.permission.INTERNET" />
-
-    <!-- [Slice D] Engage feedback voice notes (opt-in; requested at runtime before record). -->
-    <uses-permission android:name="android.permission.RECORD_AUDIO" />
-
-    <!-- Screen capture for session replay uses PixelCopy against the Activity
-         window — no special permission required. -->
-</manifest>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.scalebun.sdk">
+
+    <!-- The SDK uploads telemetry (crashes, replay frames, performance) over the
+         network. Host RN/Expo apps normally declare INTERNET already; declaring it
+         here ensures it is present via manifest merging. -->
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <!-- [Slice D] Engage feedback voice notes (opt-in; requested at runtime before record). -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+
+    <!-- Screen capture for session replay uses PixelCopy against the Activity
+         window — no special permission required. -->
+</manifest>

package/android/src/main/java/com/scalebun/core/crash/CrashStorage.kt

@@ -1,41 +1,41 @@
-package com.scalebun.core.crash
-
-import android.content.Context
-import org.json.JSONObject
-import java.io.File
-
-/**
- * Persists a single crash record to internal storage.
- * Written synchronously in the UncaughtExceptionHandler before the process dies.
- * Read and cleared on next launch via ScaleBunCrashModule.drainPendingCrash().
- */
-internal object CrashStorage {
-
-    private const val FILE_NAME = "scalebun_native_crash.json"
-
-    fun write(context: Context, crashData: JSONObject) {
-        try {
-            File(context.filesDir, FILE_NAME).writeText(crashData.toString())
-        } catch (_: Exception) {
-            // Must not throw — called from uncaught exception handler
-        }
-    }
-
-    fun read(context: Context): JSONObject? {
-        return try {
-            val file = File(context.filesDir, FILE_NAME)
-            if (!file.exists()) null else JSONObject(file.readText())
-        } catch (_: Exception) {
-            null
-        }
-    }
-
-    fun clear(context: Context) {
-        try {
-            File(context.filesDir, FILE_NAME).delete()
-        } catch (_: Exception) {}
-    }
-
-    fun hasPending(context: Context): Boolean =
-        File(context.filesDir, FILE_NAME).exists()
-}
+package com.scalebun.core.crash
+
+import android.content.Context
+import org.json.JSONObject
+import java.io.File
+
+/**
+ * Persists a single crash record to internal storage.
+ * Written synchronously in the UncaughtExceptionHandler before the process dies.
+ * Read and cleared on next launch via ScaleBunCrashModule.drainPendingCrash().
+ */
+internal object CrashStorage {
+
+    private const val FILE_NAME = "scalebun_native_crash.json"
+
+    fun write(context: Context, crashData: JSONObject) {
+        try {
+            File(context.filesDir, FILE_NAME).writeText(crashData.toString())
+        } catch (_: Exception) {
+            // Must not throw — called from uncaught exception handler
+        }
+    }
+
+    fun read(context: Context): JSONObject? {
+        return try {
+            val file = File(context.filesDir, FILE_NAME)
+            if (!file.exists()) null else JSONObject(file.readText())
+        } catch (_: Exception) {
+            null
+        }
+    }
+
+    fun clear(context: Context) {
+        try {
+            File(context.filesDir, FILE_NAME).delete()
+        } catch (_: Exception) {}
+    }
+
+    fun hasPending(context: Context): Boolean =
+        File(context.filesDir, FILE_NAME).exists()
+}