react-native-candle 0.1.51 → 19.0.6-beta

package/README.md

@@ -1,188 +1,33 @@
-# react-native-candle
+# React Native SDK Module
 
----
+This directory is the workspace source for `react-native-candle`.
 
-## Installation
+User-facing installation and API docs live in `web-docs/`. This README only covers the repo-local workflow that is specific to this module.
 
-```
-npm install react-native-candle react-native-nitro-modules
-```
+## What Is Here
 
-```
-yarn add react-native-candle react-native-nitro-modules
-```
+- `src/specs/RNCandle.nitro.ts`: Nitro bridge schema and generated native bindings source of truth
+- `src/types.ts`: public TypeScript wrapper layer over the Nitro-generated models
+- `ios/Sources/`: handwritten Swift bridge code
+- `sdk-react-native-example-app/`: the local app used to exercise the package in development
 
-```
-bun add react-native-candle react-native-nitro-modules
-```
+## Module-Specific Workflow
 
-If you are using Expo add the plugin to your `app.json`
+- After changing `src/specs/RNCandle.nitro.ts`, run `pnpm run gen:nitro`.
+- After changing the public TS wrapper layer or native bridge code, run:
+  - `pnpm run lintCheck`
+  - `pnpm run formatCheck`
+  - `pnpm run compileCheck`
+- Before finishing, run `pnpm turbo check` from the repo root.
 
-```json
-"plugins": [
-  // other plugins
-  "react-native-candle",
-  [
-    "expo-build-properties",
-    {
-      "ios": {
-        "deploymentTarget": "17.0",
-        "useFrameworks": "dynamic"
-      }
-    }
-  ]
-],
-```
+## iOS Development Notes
 
-## Usage
+- The package is currently iOS-only at runtime. The docs and example app assume iOS 17+.
+- The example app injects the local Swift SDK pod path in `plugins/withLocalSwiftPod.js`, so native iOS dependency changes usually require `cd ../sdk-react-native-example-app && pnpm prebuild` before rebuilding.
+- `ReactNativeCandle.podspec` now pins `Candle` to the same version as this package. If those versions ever stop moving in lockstep, the release wiring will need to change.
 
-#### Public API
+## Release Notes
 
-```ts
-import { useState } from "react";
-import { ActivityIndicator, Button, StyleSheet, View } from "react-native";
-import {
-  deleteUser,
-  unlinkAccount,
-  executeTool,
-  getAvailableTools,
-  getFiatAccounts,
-  getActivity,
-  getLinkedAccounts,
-  presentCandleLinkSheet,
-} from "react-native-candle";
-
-export default function TabOneScreen() {
-  const [isLoading, setIsLoading] = useState(false);
-  return (
-    <View style={[styles.container]}>
-      <ActivityIndicator animating={isLoading} />
-      <Button
-        title="Unlink Account"
-        onPress={() => {
-          setIsLoading(true);
-          unlinkAccount("linkedAccountID") // Replace with actual linked account ID
-            .then(() => {
-              console.log("User unlinked successfully.");
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error unlinking user:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Delete User"
-        onPress={() => {
-          setIsLoading(true);
-          deleteUser()
-            .then(() => {
-              console.log("User deleted successfully.");
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error deleting user:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Get Available Tools"
-        onPress={() => {
-          setIsLoading(true);
-          getAvailableTools()
-            .then((tools) => {
-              console.log("Available tools:", tools);
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error fetching available tools:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Execute Tool"
-        onPress={() => {
-          setIsLoading(true);
-          executeTool({ arguments: "", name: "get_linked_accounts" })
-            .then((result) => {
-              console.log("Tool executed successfully:", result);
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error executing tool:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Get Fiat Accounts"
-        onPress={() => {
-          setIsLoading(true);
-          getFiatAccounts()
-            .then((accounts) => {
-              console.log("Fiat accounts:", accounts);
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error fetching fiat accounts:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Get Activity"
-        onPress={() => {
-          setIsLoading(true);
-          getActivity("P1D")
-            .then((activity) => {
-              console.log("Activity:", activity);
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error fetching activity:", error);
-              setIsLoading(false);
-            });
-        }}
-      />
-      <Button
-        title="Get Linked Accounts"
-        onPress={() => {
-          setIsLoading(true);
-          getLinkedAccounts()
-            .then((accounts) => {
-              console.log("Linked accounts:", accounts);
-              setIsLoading(false);
-            })
-            .catch((error) => {
-              console.error("Error fetching linked accounts:", error);
-            });
-        }}
-      />
-      <Button
-        title="Show Candle Sheet"
-        onPress={() => {
-          presentCandleLinkSheet({
-            onSuccess: (linkedAccount) => {
-              console.log("Account selected:", linkedAccount);
-            },
-            customerName: "Akme Inc.",
-            presentationStyle: "fullScreen",
-          });
-        }}
-      />
-    </View>
-  );
-}
-
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    backgroundColor: "#fff",
-    alignItems: "center",
-    justifyContent: "center",
-  },
-});
-```
+- `publish.sh` prepares the public repo contents.
+- `pnpm run script -- apply-public-package-metadata ...` rewrites package metadata for release outputs.
+- `public/README.md` is the public-facing README template for this module and should stay aligned with the actual package capabilities.

package/ReactNativeCandle.podspec

@@ -10,7 +10,7 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => '17.0', :visionos => 1.0 }
+  s.platforms    = { :ios => '17.0' }
   s.source       = { :git => "https://github.com/candlefinance/candle-react-native.git", :tag => "#{s.version}" }
 
   s.source_files = [
@@ -30,7 +30,7 @@ Pod::Spec.new do |s|
   load 'nitrogen/generated/ios/ReactNativeCandle+autolinking.rb'
   add_nitrogen_files(s)
 
-  s.dependency 'Candle', '10.0.0'
+  s.dependency 'Candle', s.version.to_s
   s.dependency 'React-jsi'
   s.dependency 'React-callinvoker'
   install_modules_dependencies(s)

package/android/CMakeLists.txt

@@ -0,0 +1,11 @@
+project(ReactNativeCandle)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+add_library(ReactNativeCandle SHARED
+            src/main/cpp/cpp-adapter.cpp
+)
+
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/ReactNativeCandle+autolinking.cmake)

package/android/build.gradle

@@ -0,0 +1,136 @@
+import groovy.json.JsonSlurper
+
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:9.1.0"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${ReactNativeCandle_kotlinVersion}"
+    classpath "org.jetbrains.kotlin:compose-compiler-gradle-plugin:${ReactNativeCandle_kotlinVersion}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def sdkVersion =
+    new JsonSlurper().parseText(file("../package.json").text).version ?: "0.0.0"
+def localSdkKotlinRepo = file("../../sdk-kotlin/candle/build/local-maven-repo")
+
+apply plugin: "com.android.library"
+apply plugin: "org.jetbrains.kotlin.android"
+apply plugin: "org.jetbrains.kotlin.plugin.compose"
+apply from: "../nitrogen/generated/android/ReactNativeCandle+autolinking.gradle"
+
+android {
+  namespace "com.margelo.nitro.rncandle"
+  compileSdkVersion 36
+
+  defaultConfig {
+    minSdkVersion 28
+    targetSdkVersion 36
+    consumerProguardFiles "consumer-rules.pro"
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -Wextra"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  buildFeatures {
+    compose true
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+      "META-INF",
+      "META-INF/**",
+      "**/libc++_shared.so",
+      "**/libfbjni.so",
+      "**/libjsi.so",
+      "**/libfolly_json.so",
+      "**/libfolly_runtime.so",
+      "**/libglog.so",
+      "**/libhermes.so",
+      "**/libhermes-executor-debug.so",
+      "**/libhermes_executor.so",
+      "**/libreactnative.so",
+      "**/libreactnativejni.so",
+      "**/libturbomodulejsijni.so",
+      "**/libreact_nativemodule_core.so",
+      "**/libjscexecutor.so"
+    ]
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+}
+
+repositories {
+  google()
+  mavenCentral()
+
+  if (localSdkKotlinRepo.exists()) {
+    maven {
+      url = uri(localSdkKotlinRepo)
+    }
+  }
+
+  if (System.getenv("GITHUB_ACTOR") != null && System.getenv("GITHUB_TOKEN") != null) {
+    maven {
+      url = uri("https://maven.pkg.github.com/candlefinance/candle")
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+
+configurations.configureEach {
+  if (localSdkKotlinRepo.exists()) {
+    resolutionStrategy.cacheChangingModulesFor 0, "seconds"
+  }
+}
+
+dependencies {
+  implementation project(":react-native-nitro-modules")
+  implementation "com.facebook.react:react-native:+"
+  implementation("fi.candle:sdk-kotlin:${sdkVersion}") {
+    if (localSdkKotlinRepo.exists()) {
+      changing = true
+    }
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,2 @@
+ReactNativeCandle_kotlinVersion=2.1.21
+org.gradle.caching=true

package/android/src/main/AndroidManifest.xml

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

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,9 @@
+#include <fbjni/fbjni.h>
+
+#include "ReactNativeCandleOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, [] {
+    margelo::nitro::rncandle::registerAllNatives();
+  });
+}