react-native-candle 0.1.18 → 0.1.20

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

@@ -0,0 +1,99 @@
+///
+/// TradeAssetRef.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
+
+// Forward declaration of `FiatAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct FiatAssetRef; }
+// Forward declaration of `MarketTradeAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct MarketTradeAssetRef; }
+// Forward declaration of `TransportAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct TransportAssetRef; }
+// Forward declaration of `OtherAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct OtherAssetRef; }
+// Forward declaration of `NothingAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct NothingAssetRef; }
+
+#include <optional>
+#include "FiatAssetRef.hpp"
+#include "MarketTradeAssetRef.hpp"
+#include "TransportAssetRef.hpp"
+#include "OtherAssetRef.hpp"
+#include "NothingAssetRef.hpp"
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * A struct which can be represented as a JavaScript object (TradeAssetRef).
+   */
+  struct TradeAssetRef {
+  public:
+    std::optional<FiatAssetRef> fiatAssetRef     SWIFT_PRIVATE;
+    std::optional<MarketTradeAssetRef> marketTradeAssetRef     SWIFT_PRIVATE;
+    std::optional<TransportAssetRef> transportAssetRef     SWIFT_PRIVATE;
+    std::optional<OtherAssetRef> otherAssetRef     SWIFT_PRIVATE;
+    std::optional<NothingAssetRef> nothingAssetRef     SWIFT_PRIVATE;
+
+  public:
+    TradeAssetRef() = default;
+    explicit TradeAssetRef(std::optional<FiatAssetRef> fiatAssetRef, std::optional<MarketTradeAssetRef> marketTradeAssetRef, std::optional<TransportAssetRef> transportAssetRef, std::optional<OtherAssetRef> otherAssetRef, std::optional<NothingAssetRef> nothingAssetRef): fiatAssetRef(fiatAssetRef), marketTradeAssetRef(marketTradeAssetRef), transportAssetRef(transportAssetRef), otherAssetRef(otherAssetRef), nothingAssetRef(nothingAssetRef) {}
+  };
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ TradeAssetRef <> JS TradeAssetRef (object)
+  template <>
+  struct JSIConverter<TradeAssetRef> final {
+    static inline TradeAssetRef fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return TradeAssetRef(
+        JSIConverter<std::optional<FiatAssetRef>>::fromJSI(runtime, obj.getProperty(runtime, "fiatAssetRef")),
+        JSIConverter<std::optional<MarketTradeAssetRef>>::fromJSI(runtime, obj.getProperty(runtime, "marketTradeAssetRef")),
+        JSIConverter<std::optional<TransportAssetRef>>::fromJSI(runtime, obj.getProperty(runtime, "transportAssetRef")),
+        JSIConverter<std::optional<OtherAssetRef>>::fromJSI(runtime, obj.getProperty(runtime, "otherAssetRef")),
+        JSIConverter<std::optional<NothingAssetRef>>::fromJSI(runtime, obj.getProperty(runtime, "nothingAssetRef"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const TradeAssetRef& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "fiatAssetRef", JSIConverter<std::optional<FiatAssetRef>>::toJSI(runtime, arg.fiatAssetRef));
+      obj.setProperty(runtime, "marketTradeAssetRef", JSIConverter<std::optional<MarketTradeAssetRef>>::toJSI(runtime, arg.marketTradeAssetRef));
+      obj.setProperty(runtime, "transportAssetRef", JSIConverter<std::optional<TransportAssetRef>>::toJSI(runtime, arg.transportAssetRef));
+      obj.setProperty(runtime, "otherAssetRef", JSIConverter<std::optional<OtherAssetRef>>::toJSI(runtime, arg.otherAssetRef));
+      obj.setProperty(runtime, "nothingAssetRef", JSIConverter<std::optional<NothingAssetRef>>::toJSI(runtime, arg.nothingAssetRef));
+      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::optional<FiatAssetRef>>::canConvert(runtime, obj.getProperty(runtime, "fiatAssetRef"))) return false;
+      if (!JSIConverter<std::optional<MarketTradeAssetRef>>::canConvert(runtime, obj.getProperty(runtime, "marketTradeAssetRef"))) return false;
+      if (!JSIConverter<std::optional<TransportAssetRef>>::canConvert(runtime, obj.getProperty(runtime, "transportAssetRef"))) return false;
+      if (!JSIConverter<std::optional<OtherAssetRef>>::canConvert(runtime, obj.getProperty(runtime, "otherAssetRef"))) return false;
+      if (!JSIConverter<std::optional<NothingAssetRef>>::canConvert(runtime, obj.getProperty(runtime, "nothingAssetRef"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,74 @@
+///
+/// TradeRef.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
+
+// Forward declaration of `TradeAssetRef` to properly resolve imports.
+namespace margelo::nitro::rncandle { struct TradeAssetRef; }
+
+#include "TradeAssetRef.hpp"
+
+namespace margelo::nitro::rncandle {
+
+  /**
+   * A struct which can be represented as a JavaScript object (TradeRef).
+   */
+  struct TradeRef {
+  public:
+    TradeAssetRef lost     SWIFT_PRIVATE;
+    TradeAssetRef gained     SWIFT_PRIVATE;
+
+  public:
+    TradeRef() = default;
+    explicit TradeRef(TradeAssetRef lost, TradeAssetRef gained): lost(lost), gained(gained) {}
+  };
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ TradeRef <> JS TradeRef (object)
+  template <>
+  struct JSIConverter<TradeRef> final {
+    static inline TradeRef fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return TradeRef(
+        JSIConverter<TradeAssetRef>::fromJSI(runtime, obj.getProperty(runtime, "lost")),
+        JSIConverter<TradeAssetRef>::fromJSI(runtime, obj.getProperty(runtime, "gained"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const TradeRef& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "lost", JSIConverter<TradeAssetRef>::toJSI(runtime, arg.lost));
+      obj.setProperty(runtime, "gained", JSIConverter<TradeAssetRef>::toJSI(runtime, arg.gained));
+      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<TradeAssetRef>::canConvert(runtime, obj.getProperty(runtime, "lost"))) return false;
+      if (!JSIConverter<TradeAssetRef>::canConvert(runtime, obj.getProperty(runtime, "gained"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,77 @@
+///
+/// TransportAssetRef.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 (TransportAssetRef).
+   */
+  struct TransportAssetRef {
+  public:
+    std::string assetKind     SWIFT_PRIVATE;
+    std::string serviceTradeID     SWIFT_PRIVATE;
+    std::string linkedAccountID     SWIFT_PRIVATE;
+
+  public:
+    TransportAssetRef() = default;
+    explicit TransportAssetRef(std::string assetKind, std::string serviceTradeID, std::string linkedAccountID): assetKind(assetKind), serviceTradeID(serviceTradeID), linkedAccountID(linkedAccountID) {}
+  };
+
+} // namespace margelo::nitro::rncandle
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::rncandle;
+
+  // C++ TransportAssetRef <> JS TransportAssetRef (object)
+  template <>
+  struct JSIConverter<TransportAssetRef> final {
+    static inline TransportAssetRef fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return TransportAssetRef(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "assetKind")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "serviceTradeID")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "linkedAccountID"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const TransportAssetRef& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "assetKind", JSIConverter<std::string>::toJSI(runtime, arg.assetKind));
+      obj.setProperty(runtime, "serviceTradeID", JSIConverter<std::string>::toJSI(runtime, arg.serviceTradeID));
+      obj.setProperty(runtime, "linkedAccountID", JSIConverter<std::string>::toJSI(runtime, arg.linkedAccountID));
+      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, "assetKind"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "serviceTradeID"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "linkedAccountID"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-candle",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Candle SDK for React Native",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",

package/src/index.ts

@@ -1,7 +1,7 @@
 import { NitroModules } from "react-native-nitro-modules";
 import type {
   AppUser,
-  AssetAccount as NitroAssetAccount,
+  AssetAccount as InternalAssetAccount,
   AssetAccountQuery,
   FiatAsset,
   FiatAssetQuoteRequest,
@@ -17,7 +17,7 @@ import type {
   Service,
   TradeAsset as InternalTradeAsset,
   TradeAssetQuoteRequest,
-  TradeQuery,
+  TradeQuery as InternalTradeQuery,
   TransportAsset,
   TransportAssetQuoteRequest,
   LegalAccountKind,
@@ -29,6 +29,15 @@ import type {
   ServiceCounterparty,
   Counterparty as InternalCounterparty,
   ActiveLinkedAccountDetails,
+  ExecuteTradeRequest,
+  AssetAccountRef,
+  LinkedAccountRef,
+  NothingAssetRef,
+  TransportAssetRef,
+  OtherAssetRef,
+  FiatAssetRef,
+  MarketTradeAssetRef,
+  TradeAssetRef as InternalTradeAssetRef,
 } from "./specs/RNCandle.nitro";
 
 export class CandleClient {
@@ -105,8 +114,12 @@ export class CandleClient {
     });
   }
 
-  public async unlinkAccount(linkedAccountID: string): Promise<void> {
-    await this.candle.unlinkAccount(linkedAccountID);
+  public async getLinkedAccount(ref: LinkedAccountRef): Promise<LinkedAccount> {
+    return this.candle.getLinkedAccount(ref);
+  }
+
+  public async unlinkAccount(path: LinkedAccountRef): Promise<void> {
+    await this.candle.unlinkAccount(path);
   }
 
   public async deleteUser(): Promise<void> {
@@ -117,6 +130,17 @@ export class CandleClient {
     return this.candle.getAvailableTools();
   }
 
+  public async executeTrade(request: ExecuteTradeRequest): Promise<Trade> {
+    const result = await this.candle.executeTrade(request);
+    return {
+      dateTime: result.dateTime,
+      state: result.state,
+      counterparty: this.convertToCounterparty(result.counterparty),
+      lost: this.convertTradeAsset(result.lost),
+      gained: this.convertTradeAsset(result.gained),
+    };
+  }
+
   public async executeTool(tool: {
     name: string;
     arguments: string;
@@ -131,21 +155,12 @@ export class CandleClient {
     return accounts.map((account) => this.convertToAssetAccount(account));
   }
 
-  public async getTrades(
-    query: {
-      gainedAssetKind?: TradeQueryAssetKind;
-      lostAssetKind?: TradeQueryAssetKind;
-      counterpartyKind?: "merchant" | "user" | "service";
-    } & TradeQuery = {}
-  ): Promise<
-    {
-      dateTime: string;
-      state: TradeState;
-      counterparty: Counterparty;
-      lost: TradeAsset;
-      gained: TradeAsset;
-    }[]
-  > {
+  public async getAssetAccount(ref: AssetAccountRef): Promise<AssetAccount> {
+    const account = await this.candle.getAssetAccount(ref);
+    return this.convertToAssetAccount(account);
+  }
+
+  public async getTrades(query: TradeQuery = {}): Promise<Trade[]> {
     const trades = await this.candle.getTrades(query);
     return trades.map(({ dateTime, counterparty, gained, lost, state }) => ({
       dateTime,
@@ -156,6 +171,23 @@ export class CandleClient {
     }));
   }
 
+  public async getTrade(input: {
+    lost: TradeAssetRef;
+    gained: TradeAssetRef;
+  }): Promise<Trade> {
+    const trade = await this.candle.getTrade({
+      lost: this.convertTradeAssetRef(input.lost),
+      gained: this.convertTradeAssetRef(input.gained),
+    });
+    return {
+      dateTime: trade.dateTime,
+      state: trade.state,
+      counterparty: this.convertToCounterparty(trade.counterparty),
+      lost: this.convertTradeAsset(trade.lost),
+      gained: this.convertTradeAsset(trade.gained),
+    };
+  }
+
   public async getTradeQuotes(request: {
     linkedAccountIDs?: string;
     gained:
@@ -202,6 +234,50 @@ export class CandleClient {
     });
   }
 
+  private convertTradeAssetRef(
+    tradeAssetRef: TradeAssetRef
+  ): InternalTradeAssetRef {
+    switch (tradeAssetRef.assetKind) {
+      case "fiat":
+        return {
+          fiatAssetRef: {
+            assetKind: "fiat",
+            linkedAccountID: tradeAssetRef.linkedAccountID,
+            serviceTradeID: tradeAssetRef.serviceTradeID,
+          },
+        };
+      case "stock":
+      case "crypto":
+        return {
+          marketTradeAssetRef: {
+            assetKind: tradeAssetRef.assetKind,
+            linkedAccountID: tradeAssetRef.linkedAccountID,
+            serviceTradeID: tradeAssetRef.serviceTradeID,
+          },
+        };
+      case "transport":
+        return {
+          transportAssetRef: {
+            assetKind: "transport",
+            linkedAccountID: tradeAssetRef.linkedAccountID,
+            serviceTradeID: tradeAssetRef.serviceTradeID,
+          },
+        };
+      case "other":
+        return {
+          otherAssetRef: {
+            assetKind: "other",
+          },
+        };
+      case "nothing":
+        return {
+          nothingAssetRef: {
+            assetKind: "nothing",
+          },
+        };
+    }
+  }
+
   private convertTradeAsset(tradeAsset: InternalTradeAsset): TradeAsset {
     if (tradeAsset.fiatAsset !== undefined) {
       return {
@@ -250,7 +326,7 @@ export class CandleClient {
     }
   }
 
-  private convertToAssetAccount(account: NitroAssetAccount): AssetAccount {
+  private convertToAssetAccount(account: InternalAssetAccount): AssetAccount {
     const { legalAccountKind, nickname } = account;
     const { fiatAccountDetails, marketAccountDetails } = account.details;
 
@@ -298,6 +374,12 @@ type Counterparty =
       kind: "service";
     } & ServiceCounterparty);
 
+type TradeQuery = {
+  gainedAssetKind?: TradeQueryAssetKind;
+  lostAssetKind?: TradeQueryAssetKind;
+  counterpartyKind?: "merchant" | "user" | "service";
+} & InternalTradeQuery;
+
 type TradeQueryAssetKind =
   | "fiat"
   | "stock"
@@ -328,4 +410,32 @@ type AssetAccount = {
       };
 };
 
-export type { LinkedAccount, AppUser, Service, TradeState, TradeAsset };
+type Trade = {
+  dateTime: string;
+  state: TradeState;
+  counterparty: Counterparty;
+  lost: TradeAsset;
+  gained: TradeAsset;
+};
+
+type TradeAssetRef =
+  | ({ assetKind: "transport" } & TransportAssetRef)
+  | ({ assetKind: "nothing" } & NothingAssetRef)
+  | ({ assetKind: "other" } & OtherAssetRef)
+  | ({ assetKind: "fiat" } & FiatAssetRef)
+  | ({ assetKind: "stock" | "crypto" } & MarketTradeAssetRef);
+
+export type {
+  LinkedAccountRef,
+  AssetAccountRef,
+  TradeAssetRef,
+  LinkedAccount,
+  AppUser,
+  Service,
+  TradeState,
+  TradeAsset,
+  Trade,
+  TradeQuery,
+  Counterparty,
+  AssetAccount,
+};

package/src/specs/RNCandle.nitro.ts

@@ -218,6 +218,11 @@ export type TradeQuoteRequest = {
   gained: TradeAssetQuoteRequest;
 };
 
+export type ExecuteTradeRequest = {
+  linkedAccountID: string;
+  context: string;
+};
+
 export type TradeQuote = {
   lost: TradeAsset;
   gained: TradeAsset;
@@ -339,6 +344,55 @@ export type ToolCall = {
   arguments: string;
 };
 
+export type LinkedAccountRef = {
+  linkedAccountID: string;
+};
+
+export type AssetAccountRef = {
+  linkedAccountID: string;
+  assetKind: string; // "fiat" | "stock" | "crypto"
+  serviceAccountID: string;
+};
+
+export type FiatAssetRef = {
+  assetKind: string; // fiat
+  serviceTradeID?: string;
+  linkedAccountID: string;
+};
+
+export type MarketTradeAssetRef = {
+  assetKind: string; // "stock" | "crypto"
+  serviceTradeID: string;
+  linkedAccountID: string;
+};
+
+export type TransportAssetRef = {
+  assetKind: string; // "transport"
+  serviceTradeID: string;
+  linkedAccountID: string;
+};
+
+export type OtherAssetRef = {
+  assetKind: string; // "other"
+};
+
+export type NothingAssetRef = {
+  assetKind: string; // "nothing"
+};
+
+export type TradeAssetRef = {
+  fiatAssetRef?: FiatAssetRef;
+  marketTradeAssetRef?: MarketTradeAssetRef;
+  transportAssetRef?: TransportAssetRef;
+  otherAssetRef?: OtherAssetRef;
+  nothingAssetRef?: NothingAssetRef;
+};
+
+export type TradeRef = {
+  lost: TradeAssetRef;
+  gained: TradeAssetRef;
+};
+
 export interface RNCandle extends HybridObject<{ ios: "swift" }> {
   candleLinkSheet(
     isPresented: boolean,
@@ -352,11 +406,14 @@ export interface RNCandle extends HybridObject<{ ios: "swift" }> {
   ): void;
   initialize(appUser: AppUser): void;
   getLinkedAccounts(): Promise<LinkedAccount[]>;
-  unlinkAccount(linkedAccountID: string): Promise<void>;
+  getLinkedAccount(ref: LinkedAccountRef): Promise<LinkedAccount>;
+  unlinkAccount(ref: LinkedAccountRef): Promise<void>;
   getAssetAccounts(query: AssetAccountQuery): Promise<AssetAccount[]>;
+  getAssetAccount(ref: AssetAccountRef): Promise<AssetAccount>;
   getTrades(query: TradeQuery): Promise<Trade[]>;
+  getTrade(ref: TradeRef): Promise<Trade>;
   getTradeQuotes(request: TradeQuoteRequest): Promise<TradeQuote[]>;
-  submitTrade(serviceTradeID: string): Promise<Trade>;
+  executeTrade(request: ExecuteTradeRequest): Promise<Trade>;
   deleteUser(): Promise<void>;
   // FIXME: The return type should be a more specific type based on the actual tool calls available.
   getAvailableTools(): Promise<Array<AnyMap>>;