react-native-candle 0.1.0

package/nitrogen/generated/ios/swift/Service.swift

@@ -0,0 +1,56 @@
+///
+/// Service.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `Service`, backed by a C++ enum.
+ */
+public typealias Service = margelo.nitro.rncandle.Service
+
+public extension Service {
+  /**
+   * Get a Service for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "robinhood":
+        self = .robinhood
+      case "cash_app":
+        self = .cashApp
+      case "venmo":
+        self = .venmo
+      case "apple":
+        self = .apple
+      case "demo":
+        self = .demo
+      case "default":
+        self = .default
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this Service represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .robinhood:
+        return "robinhood"
+      case .cashApp:
+        return "cash_app"
+      case .venmo:
+        return "venmo"
+      case .apple:
+        return "apple"
+      case .demo:
+        return "demo"
+      case .default:
+        return "default"
+    }
+  }
+}

package/nitrogen/generated/ios/swift/ToolCall.swift

@@ -0,0 +1,46 @@
+///
+/// ToolCall.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `ToolCall`, backed by a C++ struct.
+ */
+public typealias ToolCall = margelo.nitro.rncandle.ToolCall
+
+public extension ToolCall {
+  private typealias bridge = margelo.nitro.rncandle.bridge.swift
+
+  /**
+   * Create a new instance of `ToolCall`.
+   */
+  init(name: String, arguments: String) {
+    self.init(std.string(name), std.string(arguments))
+  }
+
+  var name: String {
+    @inline(__always)
+    get {
+      return String(self.__name)
+    }
+    @inline(__always)
+    set {
+      self.__name = std.string(newValue)
+    }
+  }
+  
+  var arguments: String {
+    @inline(__always)
+    get {
+      return String(self.__arguments)
+    }
+    @inline(__always)
+    set {
+      self.__arguments = std.string(newValue)
+    }
+  }
+}

package/nitrogen/generated/shared/c++/HybridRNCandleSpec.cpp

@@ -0,0 +1,28 @@
+///
+/// HybridRNCandleSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridRNCandleSpec.hpp"
+
+namespace margelo::nitro::rncandle {
+
+  void HybridRNCandleSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("candleLinkSheet", &HybridRNCandleSpec::candleLinkSheet);
+      prototype.registerHybridMethod("getLinkedAccounts", &HybridRNCandleSpec::getLinkedAccounts);
+      prototype.registerHybridMethod("unlinkAccount", &HybridRNCandleSpec::unlinkAccount);
+      prototype.registerHybridMethod("getFiatAccounts", &HybridRNCandleSpec::getFiatAccounts);
+      prototype.registerHybridMethod("getActivity", &HybridRNCandleSpec::getActivity);
+      prototype.registerHybridMethod("deleteUser", &HybridRNCandleSpec::deleteUser);
+      prototype.registerHybridMethod("getAvailableTools", &HybridRNCandleSpec::getAvailableTools);
+      prototype.registerHybridMethod("executeTool", &HybridRNCandleSpec::executeTool);
+    });
+  }
+
+} // namespace margelo::nitro::rncandle

package/nitrogen/generated/shared/c++/HybridRNCandleSpec.hpp

@@ -0,0 +1,83 @@
+///
+/// HybridRNCandleSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `Service` to properly resolve imports.
+namespace margelo::nitro::rncandle { enum class Service; }
+// Forward declaration of `PresentationBackground` to properly resolve imports.
+namespace margelo::nitro::rncandle { enum class PresentationBackground; }
+// Forward declaration of `PresentationStyle` to properly resolve imports.
+namespace margelo::nitro::rncandle { enum class PresentationStyle; }
+// Forward declaration of `ToolCall` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct ToolCall; }
+
+#include "Service.hpp"
+#include <optional>
+#include <string>
+#include "PresentationBackground.hpp"
+#include "PresentationStyle.hpp"
+#include <functional>
+#include <NitroModules/Promise.hpp>
+#include "ToolCall.hpp"
+
+namespace margelo::nitro::rncandle {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `RNCandle`
+   * Inherit this class to create instances of `HybridRNCandleSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridRNCandle: public HybridRNCandleSpec {
+   * public:
+   *   HybridRNCandle(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridRNCandleSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridRNCandleSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridRNCandleSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual void candleLinkSheet(bool isPresented, Service service, double cornerRadius, const std::optional<std::string>& customerName, bool showSandbox, bool showDynamicLoading, PresentationBackground presentationBackground, PresentationStyle presentationStyle, const std::function<void(const std::string& /* account */)>& onSuccess) = 0;
+      virtual std::shared_ptr<Promise<std::string>> getLinkedAccounts() = 0;
+      virtual std::shared_ptr<Promise<void>> unlinkAccount(const std::string& linkedAccountID) = 0;
+      virtual std::shared_ptr<Promise<std::string>> getFiatAccounts() = 0;
+      virtual std::shared_ptr<Promise<std::string>> getActivity(const std::optional<std::string>& span) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteUser() = 0;
+      virtual std::shared_ptr<Promise<std::string>> getAvailableTools() = 0;
+      virtual std::shared_ptr<Promise<std::string>> executeTool(const ToolCall& tool) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "RNCandle";
+  };
+
+} // namespace margelo::nitro::rncandle

package/nitrogen/generated/shared/c++/PresentationBackground.hpp

@@ -0,0 +1,78 @@
+///
+/// PresentationBackground.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * An enum which can be represented as a JavaScript union (PresentationBackground).
+   */
+  enum class PresentationBackground {
+    DEFAULT      SWIFT_NAME(default) = 0,
+    BLUR      SWIFT_NAME(blur) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ PresentationBackground <> JS PresentationBackground (union)
+  template <>
+  struct JSIConverter<PresentationBackground> final {
+    static inline PresentationBackground fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("default"): return PresentationBackground::DEFAULT;
+        case hashString("blur"): return PresentationBackground::BLUR;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PresentationBackground - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, PresentationBackground arg) {
+      switch (arg) {
+        case PresentationBackground::DEFAULT: return JSIConverter<std::string>::toJSI(runtime, "default");
+        case PresentationBackground::BLUR: return JSIConverter<std::string>::toJSI(runtime, "blur");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PresentationBackground to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("default"):
+        case hashString("blur"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/PresentationStyle.hpp

@@ -0,0 +1,78 @@
+///
+/// PresentationStyle.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * An enum which can be represented as a JavaScript union (PresentationStyle).
+   */
+  enum class PresentationStyle {
+    SHEET      SWIFT_NAME(sheet) = 0,
+    FULLSCREEN      SWIFT_NAME(fullscreen) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ PresentationStyle <> JS PresentationStyle (union)
+  template <>
+  struct JSIConverter<PresentationStyle> final {
+    static inline PresentationStyle fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("sheet"): return PresentationStyle::SHEET;
+        case hashString("fullScreen"): return PresentationStyle::FULLSCREEN;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PresentationStyle - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, PresentationStyle arg) {
+      switch (arg) {
+        case PresentationStyle::SHEET: return JSIConverter<std::string>::toJSI(runtime, "sheet");
+        case PresentationStyle::FULLSCREEN: return JSIConverter<std::string>::toJSI(runtime, "fullScreen");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PresentationStyle to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("sheet"):
+        case hashString("fullScreen"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/Service.hpp

@@ -0,0 +1,94 @@
+///
+/// Service.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * An enum which can be represented as a JavaScript union (Service).
+   */
+  enum class Service {
+    ROBINHOOD      SWIFT_NAME(robinhood) = 0,
+    CASH_APP      SWIFT_NAME(cashApp) = 1,
+    VENMO      SWIFT_NAME(venmo) = 2,
+    APPLE      SWIFT_NAME(apple) = 3,
+    DEMO      SWIFT_NAME(demo) = 4,
+    DEFAULT      SWIFT_NAME(default) = 5,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ Service <> JS Service (union)
+  template <>
+  struct JSIConverter<Service> final {
+    static inline Service fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("robinhood"): return Service::ROBINHOOD;
+        case hashString("cash_app"): return Service::CASH_APP;
+        case hashString("venmo"): return Service::VENMO;
+        case hashString("apple"): return Service::APPLE;
+        case hashString("demo"): return Service::DEMO;
+        case hashString("default"): return Service::DEFAULT;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum Service - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, Service arg) {
+      switch (arg) {
+        case Service::ROBINHOOD: return JSIConverter<std::string>::toJSI(runtime, "robinhood");
+        case Service::CASH_APP: return JSIConverter<std::string>::toJSI(runtime, "cash_app");
+        case Service::VENMO: return JSIConverter<std::string>::toJSI(runtime, "venmo");
+        case Service::APPLE: return JSIConverter<std::string>::toJSI(runtime, "apple");
+        case Service::DEMO: return JSIConverter<std::string>::toJSI(runtime, "demo");
+        case Service::DEFAULT: return JSIConverter<std::string>::toJSI(runtime, "default");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert Service to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("robinhood"):
+        case hashString("cash_app"):
+        case hashString("venmo"):
+        case hashString("apple"):
+        case hashString("demo"):
+        case hashString("default"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/ToolCall.hpp

@@ -0,0 +1,73 @@
+///
+/// ToolCall.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ToolCall).
+   */
+  struct ToolCall {
+  public:
+    std::string name     SWIFT_PRIVATE;
+    std::string arguments     SWIFT_PRIVATE;
+
+  public:
+    ToolCall() = default;
+    explicit ToolCall(std::string name, std::string arguments): name(name), arguments(arguments) {}
+  };
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ ToolCall <> JS ToolCall (object)
+  template <>
+  struct JSIConverter<ToolCall> final {
+    static inline ToolCall fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return ToolCall(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "name")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "arguments"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const ToolCall& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "name", JSIConverter<std::string>::toJSI(runtime, arg.name));
+      obj.setProperty(runtime, "arguments", JSIConverter<std::string>::toJSI(runtime, arg.arguments));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "name"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "arguments"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "react-native-candle",
+  "version": "0.1.0",
+  "description": "Candle SDK for React Native",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/commonjs/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "scripts": {
+    "build": "rm -rf lib && bun typecheck && bob build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf android/build node_modules/**/android/build lib android/.cxx node_modules/**/android/.cxx",
+    "release": "release-it",
+    "specs": "bun typecheck && nitro-codegen --logLevel=\\\"debug\\\" && bun run build",
+    "specs:pod": "bun specs && bun --cwd ../example pod"
+  },
+  "keywords": [
+    "react-native",
+    "nitro",
+    "nitro-modile",
+    "expo",
+    "apple",
+    "ai"
+  ],
+  "files": [
+    "src",
+    "react-native.config.js",
+    "lib",
+    "nitrogen",
+    "plugin",
+    "cpp",
+    "android/build.gradle",
+    "android/gradle.properties",
+    "android/CMakeLists.txt",
+    "android/src",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "app.plugin.js",
+    "*.podspec",
+    "README.md"
+  ],
+  "repository": "https://github.com/candlefinance/candle-react-native.git",
+  "author": "Gary Tokman",
+  "license": "MIT",
+  "bugs": "https://github.com/candlefinance/candle-react-native/issues",
+  "homepage": "https://github.com/candlefinance/candle-react-native",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^9.0.10",
+    "react": "^18.3.1",
+    "react-native": "^0.78.1",
+    "nitro-codegen": "^0.25.2",
+    "react-native-nitro-modules": "^0.25.2",
+    "react-native-builder-bob": "^0.35.2",
+    "release-it": "^18.1.2",
+    "@release-it/bumper": "^7.0.1",
+    "@release-it/conventional-changelog": "^10.0.0"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*"
+  },
+  "release-it": {
+    "npm": {
+      "publish": true
+    },
+    "git": false,
+    "github": {
+      "release": false
+    },
+    "hooks": {
+      "before:init": "bun typecheck",
+      "after:bump": "bun build"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "esm": true
+        }
+      ]
+    ]
+  },
+  "eslintIgnore": [
+    "node_modules/",
+    "lib/"
+  ]
+}