react-native-fluxsens-syaxon 0.1.1

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Empover
+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

@@ -0,0 +1,406 @@
+# Syaxon React Native SDK
+
+The **Syaxon React Native SDK** enables React Native applications to integrate Syaxon services including:
+
+- Push Notifications (Firebase Cloud Messaging)
+- Notification Permission Management
+- Device Token Management
+- Event Tracking
+- Offline Event Queue
+- Persistent Local Storage (MMKV)
+
+The SDK supports:
+
+- ✅ React Native New Architecture (TurboModules)
+- ✅ Android
+- ✅ iOS
+- ✅ React Native 0.76+
+
+---
+
+# Installation
+
+## Install the SDK
+
+```bash
+yarn add syaxon-react-native-sdk
+```
+
+or
+
+```bash
+npm install syaxon-react-native-sdk
+```
+
+---
+
+# iOS Installation
+
+Navigate to the iOS folder.
+
+```bash
+cd ios
+pod install
+```
+
+---
+
+# Android Installation
+
+No additional configuration is required.
+
+---
+
+# Firebase Setup
+
+The SDK uses Firebase Cloud Messaging.
+
+## Android
+
+Add your Firebase configuration file.
+
+```
+android/app/google-services.json
+```
+
+Configure Gradle according to the Firebase documentation.
+
+---
+
+## iOS
+
+Add
+
+```
+GoogleService-Info.plist
+```
+
+to your Xcode project.
+
+Enable the following capabilities.
+
+- Push Notifications
+- Background Modes
+  - Remote Notifications
+
+---
+
+# SDK Initialization
+
+Initialize the SDK once during application startup.
+
+```typescript
+import SyaxonSdk from 'syaxon-react-native-sdk';
+
+await SyaxonSdk.initialize('YOUR_API_KEY');
+```
+
+---
+
+# Request Notification Permission
+
+```typescript
+const granted =
+  await SyaxonSdk.requestPushPermission();
+
+console.log(granted);
+```
+
+Returns
+
+```
+true
+```
+
+or
+
+```
+false
+```
+
+---
+
+# Check Notification Permission
+
+```typescript
+const granted =
+  await SyaxonSdk.hasPushPermission();
+```
+
+---
+
+# Get FCM Token
+
+```typescript
+const token =
+  await SyaxonSdk.getPushToken();
+
+console.log(token);
+```
+
+Returns
+
+```typescript
+string | null
+```
+
+---
+
+# iOS AppDelegate Configuration
+
+The SDK requires the host application to forward APNS lifecycle callbacks.
+
+Open
+
+```
+AppDelegate.swift
+```
+
+Import the SDK bridge (or expose `SyaxonIntegration` using your bridging header if required by your project).
+
+Forward the following callbacks.
+
+## Register Device Token
+
+```swift
+func application(
+    _ application: UIApplication,
+    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data
+) {
+    SyaxonIntegration.didRegisterForRemoteNotifications(
+        withDeviceToken: deviceToken
+    )
+}
+```
+
+---
+
+## Registration Failed
+
+```swift
+func application(
+    _ application: UIApplication,
+    didFailToRegisterForRemoteNotificationsWithError error: Error
+) {
+    SyaxonIntegration.didFailToRegisterForRemoteNotificationsWithError(error)
+}
+```
+
+---
+
+## Silent Notification
+
+```swift
+func application(
+    _ application: UIApplication,
+    didReceiveRemoteNotification userInfo: [AnyHashable : Any],
+    fetchCompletionHandler completionHandler:
+    @escaping (UIBackgroundFetchResult) -> Void
+) {
+
+    SyaxonIntegration.didReceiveRemoteNotification(userInfo)
+
+    completionHandler(.newData)
+}
+```
+
+---
+
+## Foreground Notification
+
+```swift
+func userNotificationCenter(
+    _ center: UNUserNotificationCenter,
+    willPresent notification: UNNotification,
+    withCompletionHandler completionHandler:
+    @escaping (UNNotificationPresentationOptions) -> Void
+) {
+
+    SyaxonIntegration.willPresentNotification(notification)
+
+    completionHandler([.banner, .badge, .sound])
+}
+```
+
+---
+
+## Notification Opened
+
+```swift
+func userNotificationCenter(
+    _ center: UNUserNotificationCenter,
+    didReceive response: UNNotificationResponse,
+    withCompletionHandler completionHandler:
+    @escaping () -> Void
+) {
+
+    SyaxonIntegration.didReceiveNotificationResponse(response)
+
+    completionHandler()
+}
+```
+
+---
+
+# Android
+
+No additional native configuration is required.
+
+---
+
+# API
+
+## initialize
+
+```typescript
+initialize(apiKey: string): Promise<boolean>
+```
+
+Initializes the SDK.
+
+---
+
+## requestPushPermission
+
+```typescript
+requestPushPermission(): Promise<boolean>
+```
+
+Requests notification permission.
+
+---
+
+## hasPushPermission
+
+```typescript
+hasPushPermission(): Promise<boolean>
+```
+
+Returns current notification permission status.
+
+---
+
+## getPushToken
+
+```typescript
+getPushToken(): Promise<string | null>
+```
+
+Returns the current FCM registration token.
+
+---
+
+## multiply
+
+```typescript
+multiply(a: number, b: number): number
+```
+
+Example TurboModule method.
+
+---
+
+# Requirements
+
+| Platform | Minimum Version |
+|-----------|-----------------|
+| iOS | 13.0 |
+| Android | API 24+ |
+| React Native | 0.76+ |
+
+---
+## Firebase Prerequisites
+
+The Syaxon React Native SDK uses **Firebase Cloud Messaging (FCM)** to deliver push notifications.
+
+Before integrating the SDK, you must:
+
+1. Create or use an existing Firebase project.
+2. Enable **Firebase Cloud Messaging** in the Firebase Console.
+3. Add your Android and/or iOS application to the Firebase project.
+4. Download the Firebase configuration files:
+   - Android: `google-services.json`
+   - iOS: `GoogleService-Info.plist`
+5. Configure Firebase in your application as described in the installation steps.
+
+> **Note:** The SDK does not create or manage Firebase projects. Your application must use a Firebase project that you own and configure.
+
+---
+## Granting Firebase Access
+
+To enable the Syaxon platform to send push notifications on your behalf, you must provide the Syaxon team with access to your Firebase project.
+
+Depending on your organization's security policies, this can be done by either:
+
+- Adding the Syaxon service account to your Firebase project with the required permissions, or
+- Sharing the Firebase Cloud Messaging service account credentials securely with the Syaxon team.
+
+The minimum required permissions are those necessary to send Firebase Cloud Messaging (FCM) notifications.
+
+> **Important:** Do not share Firebase project owner credentials. Follow your organization's security policies when granting access.
+
+---
+
+# Example
+
+```typescript
+import SyaxonSdk from 'syaxon-react-native-sdk';
+
+async function setup() {
+    await SyaxonSdk.initialize("YOUR_API_KEY");
+
+    const granted =
+        await SyaxonSdk.requestPushPermission();
+
+    if (granted) {
+        const token =
+            await SyaxonSdk.getPushToken();
+
+        console.log(token);
+    }
+}
+
+setup();
+```
+
+---
+
+# Troubleshooting
+
+## TurboModule could not be found
+
+If you receive
+
+```
+TurboModuleRegistry.getEnforcing(...):
+'SyaxonReactNativeSdk' could not be found
+```
+
+Ensure:
+
+- React Native New Architecture is enabled.
+- CocoaPods have been installed.
+- The application has been rebuilt after installing the SDK.
+- The generated TurboModule implementation (`getTurboModule`) is present in the native module.
+
+---
+
+## iOS Build Issues
+
+If you modify native files:
+
+```bash
+cd ios
+
+rm -rf Pods Podfile.lock
+
+pod install
+```
+
+Then clean the Xcode build folder and rebuild the application.
+
+---
+
+# License
+
+MIT

package/SyaxonReactNativeSdk.podspec

@@ -0,0 +1,29 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "SyaxonReactNativeSdk"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.public_header_files = [
+    "ios/Integration/SyaxonIntegration.h"
+  ]
+  # Vendor Tencent MMKV directly. Consumers only ever autolink THIS module —
+  # MMKV comes along transitively via CocoaPods, same pattern OneSignal/
+  # AppsFlyer/Branch use for their own native dependencies.
+  s.dependency "MMKV", "~> 2.0"
+  s.dependency 'FirebaseCore'
+  s.dependency 'FirebaseMessaging'
+  # s.pod_target_xcconfig = {
+  # 'DEFINES_MODULE' => 'YES'
+  # }
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,65 @@
+buildscript {
+  ext.SyaxonReactNativeSdk = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return SyaxonReactNativeSdk[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.syaxonreactnativesdk"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+  kotlinOptions {
+    jvmTarget = "17"
+}
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "com.tencent:mmkv:1.3.9"
+  implementation platform("com.google.firebase:firebase-bom:34.10.0")
+  implementation "com.google.firebase:firebase-messaging"
+  implementation "com.google.firebase:firebase-installations"
+  implementation "androidx.core:core:1.17.0"
+  implementation "com.squareup.retrofit2:retrofit:2.11.0"
+  implementation "com.squareup.retrofit2:converter-gson:2.11.0"
+    // OkHttp
+  implementation "com.squareup.okhttp3:okhttp:4.12.0"
+  implementation "com.squareup.okhttp3:logging-interceptor:4.12.0"
+  implementation "com.google.code.gson:gson:2.13.1"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,18 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<uses-permission android:name="android.permission.INTERNET"/>
+<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+
+<application>
+  <receiver
+    android:name="com.syaxonreactnativesdk.firebase.NotificationOpenedReceiver"
+    android:exported="false"/>
+
+  <service
+    android:name="com.syaxonreactnativesdk.firebase.SyaxonFirebaseMessagingService"
+    android:exported="false">
+    <intent-filter>
+      <action android:name="com.google.firebase.MESSAGING_EVENT"/>
+    </intent-filter>
+  </service>
+</application>
+</manifest>

package/android/src/main/java/com/syaxonreactnativesdk/SyaxonDeviceInfoModule.kt

@@ -0,0 +1,70 @@
+package com.syaxonreactnativesdk
+
+import android.content.pm.PackageManager
+import android.os.Build
+import android.provider.Settings
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+
+class SyaxonDeviceInfoModule(
+    reactContext: com.facebook.react.bridge.ReactApplicationContext
+) : NativeSyaxonDeviceInfoSpec(reactContext) {
+
+    companion object {
+        const val NAME = "SyaxonDeviceInfo"
+    }
+
+    override fun getName(): String = NAME
+
+    override fun getSDKAttributes(promise: Promise) {
+        try {
+            val context = reactApplicationContext
+
+            val packageManager = context.packageManager
+            val packageName = context.packageName
+
+            val packageInfo = packageManager.getPackageInfo(packageName, 0)
+
+            val appName = packageManager
+                .getApplicationLabel(context.applicationInfo)
+                .toString()
+
+            val versionName = packageInfo.versionName ?: ""
+
+            val buildNumber =
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                    packageInfo.longVersionCode.toString()
+                } else {
+                    @Suppress("DEPRECATION")
+                    packageInfo.versionCode.toString()
+                }
+
+            val deviceId = Settings.Secure.getString(
+                context.contentResolver,
+                Settings.Secure.ANDROID_ID
+            ) ?: ""
+
+            val locale = context.resources.configuration.locales[0]
+
+            val map = Arguments.createMap()
+
+            map.putString("sxn-device-id", deviceId)
+            map.putString("sxn-device-model", Build.MODEL)
+            map.putString("sxn-manufacturer", Build.MANUFACTURER)
+            map.putString("sxn-os", "Android")
+            map.putString("sxn-os-version", Build.VERSION.RELEASE)
+            map.putString("sxn-app-name", appName)
+            map.putString("sxn-package-name", packageName)
+            map.putString("sxn-app-version", versionName)
+            map.putString("sxn-build-number", buildNumber)
+            map.putString("sxn-country", locale.country)
+            map.putString("sxn-language", locale.language)
+            map.putString("sxn-timezone", java.util.TimeZone.getDefault().id)
+
+            promise.resolve(map)
+
+        } catch (e: Exception) {
+            promise.reject("DEVICE_INFO_ERROR", e)
+        }
+    }
+}