appambit 0.1.0

package/Appambit.podspec

@@ -0,0 +1,22 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Appambit"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/AppAmbit/appambit-sdk-react-native.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
+  s.private_header_files = "ios/**/*.h"
+  
+  s.dependency 'AppAmbitSdk', '~> 0.1.0'
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 AppAmbit
+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,191 @@
+# AppAmbit React Native SDK
+
+**Track. Debug. Distribute.**
+**AppAmbit: track, debug, and distribute your apps from one dashboard.**
+
+Lightweight SDK for analytics, events, logging, crashes, and offline support. Simple setup, minimal overhead.
+
+> Full product docs live here: **[docs.appambit.com](https://docs.appambit.com)**
+
+---
+
+## Contents
+
+* [Features](#features)
+* [Requirements](#requirements)
+* [Install](#install)
+* [Quickstart](#quickstart)
+* [Usage](#usage)
+* [Release Distribution](#release-distribution)
+* [Privacy and Data](#privacy-and-data)
+* [Troubleshooting](#troubleshooting)
+* [Contributing](#contributing)
+* [Versioning](#versioning)
+* [Security](#security)
+* [License](#license)
+
+---
+
+## Features
+
+* Session analytics with automatic lifecycle tracking
+* Event tracking with custom properties
+* Error logging for quick diagnostics 
+* Crash capture with stack traces and threads
+* Offline support with batching, retry, and queue
+* Create multiple app profiles for staging and production
+* Small footprint
+
+---
+
+## Requirements
+
+- Node >= 20
+- Yarn >=3.6.1
+- **Android SDK with:**
+    - Android 5.0+
+    - compileSdkVersion 34
+    - targetSdkVersion 34
+    - minSdkVersion 21
+- **iOS SDK with:**
+    - Xcode 15+ (for iOS)
+    - macOS 13+
+
+---
+
+
+## Install
+
+### NPM
+
+Add the package to your React Native project:
+
+```bash
+npm install appambit
+# or specify version
+npm install appambit@0.1.0
+```
+---
+
+## Quickstart
+
+Initialize the SDK with your **API key**.
+
+### Javascript
+
+```javascript
+export default function App() {
+  useEffect(() => {
+    start("<YOUR-APPKEY>");
+  }, []);
+}
+```
+
+---
+
+## Android App Requirements
+
+Add these permissions to your `AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+---
+
+## Usage
+
+* **Session activity** – automatically tracks user session starts, stops, and durations
+* **Track events** – send structured events with custom properties
+
+  ```javascript
+    trackEvent("ButtonClicked", {"Count": "41"})
+  ```
+* **Logs**: add structured log messages for debugging
+
+  ```javascript
+    try {
+        throw new Error();
+    } catch (e) {
+        logError(
+        { stack: e.stack, 
+        exception: e, 
+        classFqn: e.constructor.name, 
+        properties: {"user_id": "1"} },
+        );
+    }
+  ```
+* **Crash Reporting**: uncaught crashes are automatically captured and uploaded on next launch
+
+---
+
+## Release Distribution
+
+Upload your APK, AAB, or IPA directly to your AppAmbit dashboard.
+Distribute release builds through:
+* Direct install links
+* Email distribution
+* Environment-specific channels
+
+---
+
+## Privacy and Data
+
+* The SDK batches and transmits data efficiently
+* You control what is sent — avoid secrets or sensitive PII
+* Supports compliance with Google Play policies
+
+For details, see the docs: **[docs.appambit.com](https://docs.appambit.com)**
+
+---
+
+## Troubleshooting
+
+* **No data in dashboard** → check API key, endpoint, and network access
+* **React Native dependency not resolving** → run `npm install` or `yarn install` and verify again 
+* **Crash not appearing** → crashes are sent on next launch
+
+---
+
+## Contributing
+
+We welcome issues and pull requests.
+
+* Fork the repo
+* Create a feature branch
+* Add tests where applicable
+* Open a PR with a clear summary
+
+Please follow React Native API design guidelines and document public APIs.
+
+---
+
+## Versioning
+
+Semantic Versioning (`MAJOR.MINOR.PATCH`) is used.
+
+* Breaking changes → **major**
+* New features → **minor**
+* Fixes → **patch**
+
+---
+
+## Security
+
+If you find a security issue, please contact us at **[hello@appambit.com](mailto:hello@appambit.com)** rather than opening a public issue.
+
+---
+
+## License
+
+Open source under the terms described in the [LICENSE](./LICENSE) file.
+
+---
+
+## Links
+
+* **Docs**: [docs.appambit.com](https://docs.appambit.com)
+* **Dashboard**: [appambit.com](https://appambit.com)
+* **Discord**: [discord.gg](https://discord.gg/nJyetYue2s)
+* **Examples**: Sample React Native test app included in repo.

package/android/build.gradle

@@ -0,0 +1,78 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['Appambit_' + name]
+  }
+
+  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"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Appambit_" + name]).toInteger()
+}
+
+android {
+  namespace "com.appambit"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation "com.appambit:appambit:0.1.0"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Appambit_kotlinVersion=2.0.21
+Appambit_minSdkVersion=21
+Appambit_targetSdkVersion=34
+Appambit_compileSdkVersion=35
+Appambit_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

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

package/android/src/main/java/com/appambit/AppambitAnalyticsModule.kt

@@ -0,0 +1,56 @@
+package com.appambit
+
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.ReadableMapKeySetIterator
+import com.facebook.react.bridge.ReadableMap as RNReadableMap
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.appambit.sdk.Analytics
+
+@ReactModule(name = AppambitAnalyticsModule.NAME)
+class AppambitAnalyticsModule(reactContext: ReactApplicationContext) :
+  NativeAppambitAnalyticsSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  override fun setUserId(userId: String?) {
+    Analytics.setUserId(userId)
+  }
+
+  override fun setUserEmail(userEmail: String?) {
+    Analytics.setUserEmail(userEmail)
+  }
+
+  override fun clearToken() {
+    Analytics.clearToken()
+  }
+
+  override fun startSession() {
+    Analytics.startSession()
+  }
+
+  override fun endSession() {
+    Analytics.endSession()
+  }
+
+  override fun enableManualSession() {
+    Analytics.enableManualSession()
+  }
+
+  override fun trackEvent(eventTitle: String, properties: ReadableMap?) {
+    val props: MutableMap<String, String>? = properties?.toHashMap()
+      ?.mapValues { it.value.toString() }
+      ?.toMutableMap()
+    Analytics.trackEvent(eventTitle, props)
+  }
+  override fun generateTestEvent() {
+    Analytics.generateTestEvent()
+  }
+
+  companion object {
+    const val NAME = "AppAmbitAnalytics"
+  }
+}

package/android/src/main/java/com/appambit/AppambitCrashesModule.kt

@@ -0,0 +1,90 @@
+package com.appambit
+
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.ReadableMapKeySetIterator
+import com.facebook.react.bridge.ReadableMap as RNReadableMap
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactMethod
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.appambit.sdk.Crashes
+@ReactModule(name = AppambitCrashesModule.NAME)
+class AppambitCrashesModule(reactContext: ReactApplicationContext) :
+  NativeAppambitCrashesSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  @ReactMethod
+  override fun didCrashInLastSession(promise: Promise) {
+    try {
+        val crashed = Crashes.didCrashInLastSession()
+        promise.resolve(crashed)
+    } catch (e: Exception) {
+        promise.reject("DID_CRASH_ERROR", e)
+    }
+  }
+
+  override fun generateTestCrash() {
+    Thread {
+      Crashes.generateTestCrash()
+    }.start()
+  }
+
+  override fun logErrorMessage(message: String, properties: ReadableMap?) {
+
+    val props: MutableMap<String, String> = properties?.toHashMap()
+      ?.mapValues { it.value.toString() }
+      ?.toMutableMap() ?: mutableMapOf()
+
+    Crashes.logError(message, props)
+  }
+
+  override fun logError(errorMap: ReadableMap) {
+    val map = errorMap.toHashMap()
+
+    val message = map["message"]?.toString() ?: "Unknown error"
+    val stack = map["stack"]?.toString()
+    val classFqn = map["classFqn"]?.toString()
+    val fileName = map["fileName"]?.toString()
+
+    val lineNumber = try {
+      when (val lineNum = map["lineNumber"]) {
+        is Number -> lineNum.toInt()
+        is String -> lineNum.toIntOrNull()
+        else -> null
+      }
+    } catch (e: Exception) {
+      null
+    }
+
+    val properties: Map<String, String> =
+      ((map["properties"] as? Map<*, *>)?.map { (k, v) ->
+        k.toString() to v.toString()
+      }?.toMap()) ?: emptyMap()
+
+    val finalProperties = properties.toMutableMap()
+
+    val exception = Exception(message)
+
+    if (!stack.isNullOrEmpty()) {
+      val stackTraceElements: Array<StackTraceElement> = stack.lines().map { line ->
+        StackTraceElement(
+          classFqn,
+          line,
+          fileName,
+          lineNumber ?: 0
+        )
+      }.toTypedArray()
+
+      exception.stackTrace = stackTraceElements
+    }
+    Crashes.logError(exception, finalProperties.toMap())
+  }
+
+  companion object {
+    const val NAME = "AppAmbitCrashes"
+  }
+}

package/android/src/main/java/com/appambit/AppambitModule.kt

@@ -0,0 +1,22 @@
+package com.appambit
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.appambit.sdk.AppAmbit
+
+@ReactModule(name = AppambitModule.NAME)
+class AppambitModule(reactContext: ReactApplicationContext) :
+  NativeAppambitCoreSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  override fun start(appkey: String) {
+    AppAmbit.start(reactApplicationContext, appkey)
+  }
+
+  companion object {
+    const val NAME = "AppAmbitCore"
+  }
+}

package/android/src/main/java/com/appambit/AppambitPackage.kt

@@ -0,0 +1,42 @@
+package com.appambit
+
+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 java.util.HashMap
+
+class AppambitPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return when (name) {
+      AppambitModule.NAME -> AppambitModule(reactContext)
+      AppambitCrashesModule.NAME -> AppambitCrashesModule(reactContext)
+      AppambitAnalyticsModule.NAME -> AppambitAnalyticsModule(reactContext)
+      else -> null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+
+      fun addInfo(name: String) {
+        moduleInfos[name] = ReactModuleInfo(
+          name,
+          name,
+          false,
+          false,
+          false,
+          true
+        )
+      }
+
+      addInfo(AppambitModule.NAME)
+      addInfo(AppambitCrashesModule.NAME)
+      addInfo(AppambitAnalyticsModule.NAME)
+
+      moduleInfos
+    }
+  }
+}

package/ios/AppAmbitAnalytics.h

@@ -0,0 +1,5 @@
+#import <AppambitSpec/AppambitSpec.h>
+
+@interface AppAmbitAnalytics : NSObject <NativeAppambitAnalyticsSpec>
+
+@end

package/ios/AppAmbitAnalytics.mm

@@ -0,0 +1,45 @@
+#import "Appambit.h"
+#import <Appambit-Swift.h>
+
+@implementation AppAmbitAnalytics
+RCT_EXPORT_MODULE(AppAmbitAnalytics);
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeAppambitAnalyticsSpecJSI>(params);
+}
+
+- (void)clearToken { 
+  [AppAmbitSdkWrapper clearToken];
+}
+
+- (void)enableManualSession { 
+  [AppAmbitSdkWrapper enableManualSession];
+}
+
+- (void)startSession {
+  [AppAmbitSdkWrapper startSession];
+}
+
+- (void)endSession { 
+  [AppAmbitSdkWrapper endSession];
+}
+
+- (void)generateTestEvent { 
+  [AppAmbitSdkWrapper generateTestEvent];
+}
+
+- (void)setUserEmail:(nonnull NSString *)email { 
+  [AppAmbitSdkWrapper setUserEmailWithUserEmail:email];
+}
+
+- (void)setUserId:(nonnull NSString *)userId { 
+  [AppAmbitSdkWrapper setUserIdWithUserId:userId];
+}
+
+- (void)trackEvent:(nonnull NSString *)eventTitle properties:(nonnull NSDictionary *)properties { 
+  [AppAmbitSdkWrapper trackEventWithEventTitle:eventTitle properties:properties];
+}
+
+@end

package/ios/AppAmbitCrashes.h

@@ -0,0 +1,5 @@
+#import <AppambitSpec/AppambitSpec.h>
+
+@interface AppAmbitCrashes : NSObject <NativeAppambitCrashesSpec>
+
+@end

package/ios/AppAmbitCrashes.mm

@@ -0,0 +1,80 @@
+#import "Appambit.h"
+#import <Appambit-Swift.h>
+
+@implementation AppAmbitCrashes
+RCT_EXPORT_MODULE(AppAmbitCrashes);
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeAppambitCrashesSpecJSI>(params);
+}
+
+- (void)didCrashInLastSession:(RCTPromiseResolveBlock)resolve
+                      reject:(RCTPromiseRejectBlock)reject {
+    [AppAmbitSdkWrapper didCrashInLastSessionWithCompletion:^(BOOL crashed) {
+        resolve(@(crashed));
+    }];
+}
+
+- (void)generateTestCrash { 
+  [AppAmbitSdkWrapper generateTestCrash];
+}
+
+- (void)logErrorMessage:(nonnull NSString *)errorTitle properties:(nonnull NSDictionary *)properties {
+  [AppAmbitSdkWrapper logErrorWithMessage:errorTitle properties:properties];
+}
+
+- (void)logError:(JS::NativeAppambitCrashes::ErrorPayload &)payload {
+
+    NSString *rawMessage = payload.message();
+    NSString *stack = payload.stack();
+    NSString *classFqn = payload.classFqn() ?: @"JSException";
+    NSString *fileName = payload.fileName();
+    NSNumber *lineNumber = payload.lineNumber().has_value()
+        ? @(payload.lineNumber().value())
+        : nil;
+
+    NSDictionary *rawProps = nil;
+    if ([payload.properties() isKindOfClass:[NSDictionary class]]) {
+        rawProps = (NSDictionary *)payload.properties();
+    }
+
+    NSString *derivedMessage = @"JS Error";
+    if (stack && stack.length > 0) {
+        NSArray *lines = [stack componentsSeparatedByCharactersInSet:[NSCharacterSet newlineCharacterSet]];
+        if (lines.count > 0) {
+            derivedMessage = lines.firstObject;
+        }
+    }
+
+    NSString *finalMessage = (rawMessage && ![rawMessage isEqualToString:@"{}"] && rawMessage.length > 0)
+        ? rawMessage
+        : derivedMessage;
+
+    NSMutableDictionary<NSString*, NSString*> *properties = [NSMutableDictionary dictionary];
+    if (rawProps) {
+        [rawProps enumerateKeysAndObjectsUsingBlock:^(id key, id value, BOOL *stop) {
+            properties[key] = [value description];
+        }];
+    }
+
+    NSMutableDictionary *userInfo = [@{
+        NSLocalizedDescriptionKey: finalMessage,
+        @"classFqn": classFqn ?: @"Unknown"
+    } mutableCopy];
+
+    if (stack) userInfo[@"stackTrace"] = stack;
+    if (fileName) userInfo[@"fileName"] = fileName;
+    if (lineNumber) userInfo[@"lineNumber"] = lineNumber;
+    if (properties.count > 0) userInfo[@"properties"] = properties;
+
+    NSError *error = [NSError errorWithDomain:@"com.appambit.react.error"
+                                         code:-1
+                                     userInfo:userInfo];
+
+    [AppAmbitSdkWrapper logErrorWithException:error properties:properties];
+}
+
+
+@end