@bubblsdk/react-native-sdk 3.0.0

package/BubblReactNativeSdk.podspec

@@ -0,0 +1,17 @@
+Pod::Spec.new do |s|
+  s.name = 'BubblReactNativeSdk'
+  s.version = '3.0.0'
+  s.summary = 'React Native wrapper for Bubbl SDK v3 native Android and iOS cores.'
+  s.homepage = 'https://bubbl.tech'
+  s.license = { :type => 'Commercial', :text => 'Copyright Bubbl. All rights reserved.' }
+  s.author = { 'Bubbl' => 'engineering@bubbl.tech' }
+  s.source = { :git => 'https://devops.bubbl.tech/bubbl/renewed-sdk.git', :tag => s.version.to_s }
+
+  s.platform = :ios, '15.0'
+  s.swift_version = '5.9'
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+  s.static_framework = true
+
+  s.dependency 'React-Core'
+  s.dependency 'BubblSDK', '3.0.0'
+end

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 3.0.0
+
+- Adds the React Native facade for Bubbl SDK v3.
+- Bridges the facade to the native Android and iOS SDK cores.
+- Exposes native SDK events through `Bubbl.events`.

package/LICENSE

@@ -0,0 +1 @@
+Copyright Bubbl. All rights reserved.

package/README.md

@@ -0,0 +1,97 @@
+# Bubbl React Native SDK
+
+React Native wrapper for Bubbl SDK v3.
+
+The JavaScript facade forwards calls to the native Android and iOS SDK cores. Native runtime behavior, durable ingest queues, geofence transitions, notification triggering, Firebase/APNs payload handling, and diagnostics are owned by the platform SDKs.
+
+## Install
+
+```bash
+npm install @bubblsdk/react-native-sdk
+```
+
+## Boot
+
+```ts
+import { Bubbl } from '@bubblsdk/react-native-sdk';
+
+await Bubbl.boot({ apiKey: '...' });
+```
+
+For apps that render their own in-app notification modal while still letting
+the native SDK trigger device notifications:
+
+```ts
+await Bubbl.boot({
+  apiKey: '...',
+  notificationRenderingMode: 'sdkDefault',
+  enableDefaultNotificationModal: false,
+});
+
+// Or toggle it after boot.
+await Bubbl.disableDefaultNotificationModal();
+```
+
+Apps with their own notification inbox/history can still ask the SDK to show
+the bundled detail UI for a stored payload:
+
+```ts
+await Bubbl.openNotificationModal(payload);
+```
+
+This opens the default modal/detail UI without posting another device
+notification.
+
+## Android Notification Taps
+
+Firebase auto-rendered notifications launch the app's `MainActivity` with the
+notification payload as intent extras. Forward those launcher intents into the
+SDK so notification taps open the app and route to the right modal.
+
+Use `openDefaultModal(...)` when the SDK should show the bundled modal:
+
+```kotlin
+import android.content.Intent
+import android.os.Bundle
+import com.facebook.react.ReactActivity
+import tech.bubbl.reactnative.BubblSdkNotificationIntents
+
+class MainActivity : ReactActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        BubblSdkNotificationIntents.openDefaultModal(this, intent)
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        setIntent(intent)
+        BubblSdkNotificationIntents.openDefaultModal(this, intent)
+    }
+}
+```
+
+Use `openHostModal(...)` when the app renders its own modal. The SDK records
+the tap, keeps the payload pending across cold start, and emits
+`notificationTapped` once the React Native bridge subscribes:
+
+```kotlin
+BubblSdkNotificationIntents.openHostModal(this, intent)
+```
+
+## Events
+
+```ts
+const subscription = Bubbl.events.addListener((event) => {
+  if (event.type === 'notificationReceived') {
+    // Host apps can inspect or custom-render notification payloads here.
+  }
+});
+
+subscription.remove();
+```
+
+## Notes
+
+- Android depends on `tech.bubbl.sdk:bubbl-sdk` and requires `minSdkVersion 27` or higher.
+- iOS depends on the `BubblSDK` CocoaPods/Swift package release and requires iOS 15 or higher.
+- Host apps still need the usual platform permissions for push notifications and location tracking.

package/android/build.gradle

@@ -0,0 +1,46 @@
+plugins {
+    id "com.android.library"
+    id "org.jetbrains.kotlin.android"
+}
+
+group = "tech.bubbl.reactnative"
+version = "3.0.0"
+
+def isNewArchitectureEnabled() {
+    project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
+if (isNewArchitectureEnabled()) {
+    apply plugin: "com.facebook.react"
+}
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+def reactNativeVersion = safeExtGet("reactNativeVersion", "0.76.9")
+
+android {
+    namespace = "tech.bubbl.reactnative"
+    compileSdk = safeExtGet("compileSdkVersion", 35)
+
+    defaultConfig {
+        minSdk = safeExtGet("minSdkVersion", 27)
+        buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+}
+
+dependencies {
+    implementation "com.facebook.react:react-android:${reactNativeVersion}"
+    implementation "tech.bubbl.sdk:bubbl-sdk:3.0.0"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />