@kindly-ai/react-native 0.1.0

package/KindlyReactNative.podspec

@@ -0,0 +1,36 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "KindlyReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  # iOS 15.0 mirrors what `kindly-ai/sdk-chat-ios/Kindly.podspec` declares
+  # (the bundled xcframework is built against iOS 15). Older targets cause
+  # runtime crashes when dyld can't find symbols introduced in 15.x.
+  s.platforms    = { :ios => "15.0" }
+  s.source       = { :git => "https://github.com/AlexyIbrahim/sdk-chat-react-native-sources.git", :tag => "v#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.private_header_files = "ios/**/*.h"
+
+  # Bundled iOS Kindly framework — populated by `scripts/bundle-native-sdks.yml`
+  # which fetches the pre-built signed xcframework from
+  # `kindly-ai/sdk-chat-ios` releases and copies it under `ios/Frameworks/`.
+  # Customers get the same binary native iOS customers get — no rebuild,
+  # no Apple cert in this pipeline.
+  s.vendored_frameworks = "ios/Frameworks/Kindly.xcframework"
+
+  # Sentry is the only external dep the bundled Kindly.xcframework needs at
+  # runtime (mirrors `Kindly.podspec` line 23 of the iOS source release repo).
+  s.dependency "Sentry", "~> 9.0"
+
+  s.swift_version = "5.0"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Alexy
+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,127 @@
+# @kindly-ai/react-native
+
+The official **Kindly Chat SDK** for React Native — a thin TurboModule
+wrapper around the public iOS xcframework and Android AAR. The native
+binaries ship inside the npm tarball, so customers don't need Swift Package
+Manager, Maven Central, or any extra Gradle config.
+
+> **Status:** Early access. Targets React Native New Architecture
+> (TurboModules + Codegen). Requires RN ≥ 0.76.
+
+## Installation
+
+```sh
+yarn add @kindly-ai/react-native
+cd ios && pod install
+```
+
+That's it — no extra setup. The bundled iOS framework is pre-signed with the
+Apple Distribution cert and passes App Store ITMS-91065 validation.
+
+## Usage
+
+```ts
+import { KindlySDK, hexColor } from '@kindly-ai/react-native';
+
+// 1. Initialize once on app start
+KindlySDK.start({
+  botKey: 'your-bot-key',
+  languageCode: 'en',
+  // Optional: invoked by the SDK when it needs an authenticated JWT.
+  // Return null for anonymous chats.
+  authTokenCallback: async () => null,
+});
+
+// 2. Open the chat UI when the user wants it
+<Button title="Open chat" onPress={() => KindlySDK.launchChat()} />
+
+// 3. (Optional) host-app callbacks for buttons / link interception
+KindlySDK.setDelegate({
+  onButtonPressed: (button, chatLog) => console.log('button', button),
+  shouldHandleLink: (url) => {
+    if (url.startsWith('myapp://')) {
+      // Take over the deep link
+      return false;
+    }
+    return true; // let the SDK open it
+  },
+});
+```
+
+## API
+
+### Lifecycle
+
+| Method | Purpose |
+|---|---|
+| `start({botKey, languageCode?, authTokenCallback?})` | Initialize the SDK. Must be called before any other method. |
+| `displayChat({languageCode?, triggerDialogueId?})` | Show the chat UI. |
+| `launchChat({triggerDialogueId?})` | Connect (if needed) and show chat. Recommended on Android. |
+| `closeChat()` | Dismiss the UI without ending the session. |
+| `endChat()` | End the chat session: clears messages, token, dismisses UI. |
+| `kill()` | Tear the SDK down completely; call `start()` again before reuse. |
+| `setLanguage(code)` | Update the language for the current session. |
+
+### Messaging
+
+| Method | Purpose |
+|---|---|
+| `sendMessage(text, {newContext?})` | Send a message programmatically. Returns the reconciled message. |
+| `setNewContext({...})` / `clearNewContext()` | Stage / clear context attached to the next message. |
+| `triggerDialogue(id)` / `clearTriggerDialogue()` | Trigger a specific dialogue by id. |
+| `handleUrl(url)` | Handle a `kindly://chat/dialogue/{id}` deep link. Returns true if the URL was handled. |
+| `callHandover(callback)` | Initiate a handover to a human agent. |
+
+### Theme
+
+| Method | Purpose |
+|---|---|
+| `setCustomTheme({…})` | Apply a custom theme. Pass undefined fields to keep defaults. |
+| `clearCustomTheme()` | Revert to the default / API-supplied theme. |
+| `hexColor(hex)` | Helper: `#RRGGBB` / `#AARRGGBB` → ARGB int (used in the theme). |
+
+### Push
+
+| Method | Purpose |
+|---|---|
+| `setAPNSDeviceToken(token)` | iOS only — register the APNS device token. |
+| `saveNotificationToken(token)` | Android only — register the FCM token. |
+| `handleNotification(data)` | Forward an incoming push payload to the SDK. |
+| `isKindlyNotification(data)` | Returns true if the given push originated from Kindly. |
+
+### State / settings
+
+| Method | Purpose |
+|---|---|
+| `isChatDisplayed()` | Returns true if the chat UI is currently visible (iOS only — Android always false). |
+| `saveAuthToken(token)` | Save a JWT auth token (iOS keychain). |
+| `setVerboseLogging(enabled)` | Toggle verbose SDK logging. |
+| `setCrashReporting(enabled)` | Toggle Sentry crash reporting from inside the SDK. |
+
+### Delegate
+
+| Method | Purpose |
+|---|---|
+| `setDelegate({onButtonPressed?, shouldHandleLink?, shouldHandleNotification?})` | Register host-app callbacks. |
+| `clearDelegate()` | Remove all delegate callbacks. |
+
+`shouldHandleLink` and `shouldHandleNotification` are awaited synchronously
+by the native SDK with a 5-second timeout. After timeout the SDK falls back
+to its default `true` (handle normally) so chat doesn't hang on a slow JS
+callback.
+
+## Compatibility
+
+- **React Native:** 0.76+ (New Architecture only)
+- **iOS:** 15.0+
+- **Android:** API level 24+ (Android 7.0)
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,113 @@
+// Kindly React Native SDK — Android plugin build script.
+//
+// Architecture mirrors `flutter-sdk/android/build.gradle`:
+//
+// 1. Kotlin / AGP / JVM versions match the bundled Kindly Android SDK
+//    (currently Kotlin 2.3.20 / AGP 8.6.0 / JVM 17). The bundled AAR was
+//    compiled against those, and Kotlin metadata is NOT forward-compatible:
+//    older compilers throw "Module was compiled with an incompatible
+//    version of Kotlin" when they encounter 2.3.x metadata. Bumping in
+//    lockstep with `kindly-ai/sdk-chat-android-sources` is mandatory.
+//
+// 2. Local Maven repo (`maven-repo/`) inside this package's `android/`.
+//    Populated at bundle time by `scripts/bundle-native-sdks.yml` from
+//    `kindly-ai/sdk-chat-android` raw URLs. Customer apps pick it up
+//    transparently via the `allprojects { repositories { ... } }` block —
+//    strict-mode (`FAIL_ON_PROJECT_REPOS`) builds work without extra
+//    configuration since the path is local.
+//
+// 3. JitPack is NOT used. JitPack rejected `1.0.100`+ with opaque "Error
+//    building" messages and is generally flaky for arbitrary projects.
+//    The bundled-Maven approach has zero external dependencies.
+
+buildscript {
+  ext.kotlin_version = "2.3.20"
+  repositories {
+    google()
+    mavenCentral()
+  }
+  dependencies {
+    classpath("com.android.tools.build:gradle:8.6.0")
+    classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version")
+  }
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+allprojects {
+  repositories {
+    google()
+    mavenCentral()
+    // Local Maven repo bundled INSIDE this RN package. Contains the signed
+    // Kindly Android SDK AAR + its full POM (= every transitive dep the
+    // SDK needs: Compose, Coil, Pusher, OkHttp, etc.). Populated at
+    // bundle time by `scripts/bundle-native-sdks.yml`, which fetches both
+    // files from the public release repo `kindly-ai/sdk-chat-android` and
+    // writes them under standard Maven layout.
+    maven { url "$projectDir/maven-repo" }
+  }
+}
+
+android {
+  namespace "com.kindlyai.reactnative"
+
+  // RN 0.85 template default is 36 — kept in lockstep so the codegen-
+  // generated abstract class compiles with the same ABI customers use.
+  compileSdkVersion 36
+
+  defaultConfig {
+    minSdkVersion 24       // RN's minimum since 0.74
+    targetSdkVersion 36
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  // JVM 17 — required by Kotlin 2.3.20 (which defaults to 21 unless
+  // overridden, and would fail with "Inconsistent JVM-target compatibility"
+  // if Java compile sat at 1.8). 17 is also the AGP 8.x default and what
+  // GitHub Actions / CI runners standardize on.
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  sourceSets {
+    main.java.srcDirs += "src/main/kotlin"
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+
+  // Kindly Android SDK resolved from the bundled `maven-repo/` (declared
+  // above in `allprojects`). The POM there lists the full transitive dep
+  // set so Gradle pulls everything automatically — no need to re-declare
+  // deps here. The version string is rewritten by
+  // `scripts/bundle-native-sdks.yml` at bundle time to match the just-
+  // released Android SDK version (`git describe --tags --abbrev=0` on
+  // the public release repo).
+  implementation "ai.kindly:sdk:1.0.93"
+
+  // Required by the AuthTokenCallback bridge in KindlyReactNativeModule.kt
+  // (`CompletableDeferred`, `runBlocking`, `withTimeoutOrNull`).
+  implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4"
+}

package/android/maven-repo/ai/kindly/sdk/1.0.93/sdk-1.0.93.pom

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>ai.kindly</groupId>
+  <artifactId>sdk</artifactId>
+  <version>1.0.93</version>
+  <packaging>aar</packaging>
+  <name>Kindly SDK</name>
+  <description>Kindly Chat SDK for Android — customer support chat widget</description>
+  <url>https://github.com/kindly-ai/chat-android.git</url>
+  <inceptionYear>2023</inceptionYear>
+  <licenses>
+    <license>
+      <name>The Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
+    </license>
+  </licenses>
+  <developers>
+    <developer>
+      <id>AlexyIbrahim</id>
+      <name>Alexy Ibrahim</name>
+      <email>alexy.ib@gmail.com</email>
+    </developer>
+  </developers>
+  <scm>
+    <connection>scm:git:https://github.com/kindly-ai/sdk-chat-android.git</connection>
+    <developerConnection>scm:git:ssh://github.com/kindly-ai/sdk-chat-android.git</developerConnection>
+    <url>https://github.com/kindly-ai/sdk-chat-android</url>
+  </scm>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>com.simpligility.maven.plugins</groupId>
+        <artifactId>android-maven-plugin</artifactId>
+        <version>4.5.0</version>
+        <extensions>true</extensions>
+      </plugin>
+    </plugins>
+  </build>
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>2.0.0</version>
+      <type>jar</type>
+      <scope>test</scope>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>io.coil-kt</groupId>
+      <artifactId>coil-compose</artifactId>
+      <version>2.7.0</version>
+    </dependency>
+    <dependency>
+      <groupId>io.coil-kt</groupId>
+      <artifactId>coil-svg</artifactId>
+      <version>2.7.0</version>
+    </dependency>
+    <dependency>
+      <groupId>io.coil-kt</groupId>
+      <artifactId>coil-gif</artifactId>
+      <version>2.7.0</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.compose.ui</groupId>
+      <artifactId>ui</artifactId>
+      <version>1.6.4</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.compose.material3</groupId>
+      <artifactId>material3</artifactId>
+      <version>1.2.1</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.compose.ui</groupId>
+      <artifactId>ui-tooling-preview</artifactId>
+      <version>1.6.4</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.navigation</groupId>
+      <artifactId>navigation-compose</artifactId>
+      <version>2.7.7</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.activity</groupId>
+      <artifactId>activity-compose</artifactId>
+      <version>1.8.2</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.lifecycle</groupId>
+      <artifactId>lifecycle-runtime-ktx</artifactId>
+      <version>2.7.0</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.lifecycle</groupId>
+      <artifactId>lifecycle-process</artifactId>
+      <version>2.7.0</version>
+    </dependency>
+    <dependency>
+      <groupId>androidx.core</groupId>
+      <artifactId>core-ktx</artifactId>
+      <version>1.12.0</version>
+    </dependency>
+    <dependency>
+      <groupId>com.pusher</groupId>
+      <artifactId>pusher-java-client</artifactId>
+      <version>2.4.4</version>
+    </dependency>
+    <dependency>
+      <groupId>org.jetbrains.kotlinx</groupId>
+      <artifactId>kotlinx-serialization-json</artifactId>
+      <version>1.7.3</version>
+    </dependency>
+    <dependency>
+      <groupId>com.google.firebase</groupId>
+      <artifactId>firebase-messaging-ktx</artifactId>
+      <version>24.0.3</version>
+    </dependency>
+    <dependency>
+      <groupId>io.sentry</groupId>
+      <artifactId>sentry-android</artifactId>
+      <version>[8.0.0,9.0.0)</version>
+    </dependency>
+  </dependencies>
+</project>

package/android/src/main/AndroidManifest.xml

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