cactus-react-native 0.2.11 → 1.0.2

package/nitrogen/generated/ios/swift/HybridCactusFileSystemSpec.swift

@@ -0,0 +1,65 @@
+///
+/// HybridCactusFileSystemSpec.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+import NitroModules
+
+/// See ``HybridCactusFileSystemSpec``
+public protocol HybridCactusFileSystemSpec_protocol: HybridObject {
+  // Properties
+  
+
+  // Methods
+  func getCactusDirectory() throws -> Promise<String>
+  func fileExists(path: String) throws -> Promise<Bool>
+  func writeFile(path: String, content: String) throws -> Promise<Void>
+  func readFile(path: String) throws -> Promise<String>
+  func deleteFile(path: String) throws -> Promise<Void>
+  func modelExists(model: String) throws -> Promise<Bool>
+  func getModelPath(model: String) throws -> Promise<String>
+  func downloadModel(model: String, from: String, callback: ((_ progress: Double) -> Void)?) throws -> Promise<Void>
+  func deleteModel(model: String) throws -> Promise<Void>
+}
+
+public extension HybridCactusFileSystemSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject CactusFileSystem]"
+  }
+}
+
+/// See ``HybridCactusFileSystemSpec``
+open class HybridCactusFileSystemSpec_base {
+  private weak var cxxWrapper: HybridCactusFileSystemSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridCactusFileSystemSpec_cxx {
+  #if DEBUG
+    guard self is HybridCactusFileSystemSpec else {
+      fatalError("`self` is not a `HybridCactusFileSystemSpec`! Did you accidentally inherit from `HybridCactusFileSystemSpec_base` instead of `HybridCactusFileSystemSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridCactusFileSystemSpec_cxx(self as! HybridCactusFileSystemSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the CactusFileSystem HybridObject.
+ * Implement this protocol to create Swift-based instances of CactusFileSystem.
+ * ```swift
+ * class HybridCactusFileSystem : HybridCactusFileSystemSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridCactusFileSystemSpec = HybridCactusFileSystemSpec_protocol & HybridCactusFileSystemSpec_base

package/nitrogen/generated/ios/swift/HybridCactusFileSystemSpec_cxx.swift

@@ -0,0 +1,303 @@
+///
+/// HybridCactusFileSystemSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridCactusFileSystemSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridCactusFileSystemSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::cactus::bridge::swift`)
+   * from `Cactus-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.cactus.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridCactusFileSystemSpec` Swift protocol.
+   */
+  private var __implementation: any HybridCactusFileSystemSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridCactusFileSystemSpec_
+
+  /**
+   * Create a new `HybridCactusFileSystemSpec_cxx` that wraps the given `HybridCactusFileSystemSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridCactusFileSystemSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridCactusFileSystemSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridCactusFileSystemSpec() -> any HybridCactusFileSystemSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridCactusFileSystemSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridCactusFileSystemSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridCactusFileSystemSpec_cxx {
+    return Unmanaged<HybridCactusFileSystemSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridCactusFileSystemSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridCactusFileSystemSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridCactusFileSystemSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridCactusFileSystemSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  
+
+  // Methods
+  @inline(__always)
+  public final func getCactusDirectory() -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+    do {
+      let __result = try self.__implementation.getCactusDirectory()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(std.string(__result)) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func fileExists(path: std.string) -> bridge.Result_std__shared_ptr_Promise_bool___ {
+    do {
+      let __result = try self.__implementation.fileExists(path: String(path))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_bool__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_bool__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_bool__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func writeFile(path: std.string, content: std.string) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.writeFile(path: String(path), content: String(content))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func readFile(path: std.string) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+    do {
+      let __result = try self.__implementation.readFile(path: String(path))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(std.string(__result)) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func deleteFile(path: std.string) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.deleteFile(path: String(path))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func modelExists(model: std.string) -> bridge.Result_std__shared_ptr_Promise_bool___ {
+    do {
+      let __result = try self.__implementation.modelExists(model: String(model))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_bool__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_bool__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_bool__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func getModelPath(model: std.string) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+    do {
+      let __result = try self.__implementation.getModelPath(model: String(model))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(std.string(__result)) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func downloadModel(model: std.string, from: std.string, callback: bridge.std__optional_std__function_void_double____progress______) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.downloadModel(model: String(model), from: String(from), callback: { () -> ((_ progress: Double) -> Void)? in
+        if bridge.has_value_std__optional_std__function_void_double____progress______(callback) {
+          let __unwrapped = bridge.get_std__optional_std__function_void_double____progress______(callback)
+          return { () -> (Double) -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void_double(__unwrapped)
+            return { (__progress: Double) -> Void in
+              __wrappedFunction.call(__progress)
+            }
+          }()
+        } else {
+          return nil
+        }
+      }())
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func deleteModel(model: std.string) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.deleteModel(model: String(model))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+}

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

@@ -0,0 +1,92 @@
+///
+/// DeviceInfo.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
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::cactus {
+
+  /**
+   * A struct which can be represented as a JavaScript object (DeviceInfo).
+   */
+  struct DeviceInfo {
+  public:
+    std::string brand     SWIFT_PRIVATE;
+    std::string model     SWIFT_PRIVATE;
+    std::optional<std::string> device_id     SWIFT_PRIVATE;
+    std::string os     SWIFT_PRIVATE;
+    std::string os_version     SWIFT_PRIVATE;
+
+  public:
+    DeviceInfo() = default;
+    explicit DeviceInfo(std::string brand, std::string model, std::optional<std::string> device_id, std::string os, std::string os_version): brand(brand), model(model), device_id(device_id), os(os), os_version(os_version) {}
+  };
+
+} // namespace margelo::nitro::cactus
+
+namespace margelo::nitro {
+
+  // C++ DeviceInfo <> JS DeviceInfo (object)
+  template <>
+  struct JSIConverter<margelo::nitro::cactus::DeviceInfo> final {
+    static inline margelo::nitro::cactus::DeviceInfo fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::cactus::DeviceInfo(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "brand")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "model")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "device_id")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "os")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "os_version"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::cactus::DeviceInfo& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "brand", JSIConverter<std::string>::toJSI(runtime, arg.brand));
+      obj.setProperty(runtime, "model", JSIConverter<std::string>::toJSI(runtime, arg.model));
+      obj.setProperty(runtime, "device_id", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.device_id));
+      obj.setProperty(runtime, "os", JSIConverter<std::string>::toJSI(runtime, arg.os));
+      obj.setProperty(runtime, "os_version", JSIConverter<std::string>::toJSI(runtime, arg.os_version));
+      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 (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "brand"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "model"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "device_id"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "os"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "os_version"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,21 @@
+///
+/// HybridCactusCryptoSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridCactusCryptoSpec.hpp"
+
+namespace margelo::nitro::cactus {
+
+  void HybridCactusCryptoSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("uuidv5", &HybridCactusCryptoSpec::uuidv5);
+    });
+  }
+
+} // namespace margelo::nitro::cactus

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

@@ -0,0 +1,63 @@
+///
+/// HybridCactusCryptoSpec.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
+
+
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+
+namespace margelo::nitro::cactus {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `CactusCrypto`
+   * Inherit this class to create instances of `HybridCactusCryptoSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridCactusCrypto: public HybridCactusCryptoSpec {
+   * public:
+   *   HybridCactusCrypto(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridCactusCryptoSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridCactusCryptoSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridCactusCryptoSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<std::string>> uuidv5(const std::string& namespaceUuid, const std::string& name) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "CactusCrypto";
+  };
+
+} // namespace margelo::nitro::cactus

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

@@ -0,0 +1,22 @@
+///
+/// HybridCactusDeviceInfoSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridCactusDeviceInfoSpec.hpp"
+
+namespace margelo::nitro::cactus {
+
+  void HybridCactusDeviceInfoSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("getAppIdentifier", &HybridCactusDeviceInfoSpec::getAppIdentifier);
+      prototype.registerHybridMethod("getDeviceInfo", &HybridCactusDeviceInfoSpec::getDeviceInfo);
+    });
+  }
+
+} // namespace margelo::nitro::cactus

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

@@ -0,0 +1,67 @@
+///
+/// HybridCactusDeviceInfoSpec.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 `DeviceInfo` to properly resolve imports.
+namespace margelo::nitro::cactus { struct DeviceInfo; }
+
+#include <string>
+#include <optional>
+#include <NitroModules/Promise.hpp>
+#include "DeviceInfo.hpp"
+
+namespace margelo::nitro::cactus {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `CactusDeviceInfo`
+   * Inherit this class to create instances of `HybridCactusDeviceInfoSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridCactusDeviceInfo: public HybridCactusDeviceInfoSpec {
+   * public:
+   *   HybridCactusDeviceInfo(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridCactusDeviceInfoSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridCactusDeviceInfoSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridCactusDeviceInfoSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<std::optional<std::string>>> getAppIdentifier() = 0;
+      virtual std::shared_ptr<Promise<DeviceInfo>> getDeviceInfo() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "CactusDeviceInfo";
+  };
+
+} // namespace margelo::nitro::cactus

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

@@ -0,0 +1,29 @@
+///
+/// HybridCactusFileSystemSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridCactusFileSystemSpec.hpp"
+
+namespace margelo::nitro::cactus {
+
+  void HybridCactusFileSystemSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("getCactusDirectory", &HybridCactusFileSystemSpec::getCactusDirectory);
+      prototype.registerHybridMethod("fileExists", &HybridCactusFileSystemSpec::fileExists);
+      prototype.registerHybridMethod("writeFile", &HybridCactusFileSystemSpec::writeFile);
+      prototype.registerHybridMethod("readFile", &HybridCactusFileSystemSpec::readFile);
+      prototype.registerHybridMethod("deleteFile", &HybridCactusFileSystemSpec::deleteFile);
+      prototype.registerHybridMethod("modelExists", &HybridCactusFileSystemSpec::modelExists);
+      prototype.registerHybridMethod("getModelPath", &HybridCactusFileSystemSpec::getModelPath);
+      prototype.registerHybridMethod("downloadModel", &HybridCactusFileSystemSpec::downloadModel);
+      prototype.registerHybridMethod("deleteModel", &HybridCactusFileSystemSpec::deleteModel);
+    });
+  }
+
+} // namespace margelo::nitro::cactus