cactus-react-native 1.0.1 → 1.1.0

package/lib/typescript/src/telemetry/Telemetry.d.ts

@@ -1,8 +1,9 @@
 import type { CactusLMCompleteResult } from '../types/CactusLM';
+import type { CactusSTTTranscribeResult } from '../types/CactusSTT';
 export interface LogRecord {
     framework: 'react-native';
     framework_version: string;
-    event_type: 'init' | 'completion' | 'embedding';
+    event_type: 'init' | 'completion' | 'transcription' | 'embedding' | 'image_embedding' | 'audio_embedding';
     model: string;
     success: boolean;
     message?: string;
@@ -25,6 +26,9 @@ export declare class Telemetry {
     static init(cactusTelemetryToken?: string): Promise<void>;
     static logInit(model: string, success: boolean, message?: string): Promise<void>;
     static logCompletion(model: string, success: boolean, message?: string, result?: CactusLMCompleteResult): Promise<void>;
+    static logTranscribe(model: string, success: boolean, message?: string, result?: CactusSTTTranscribeResult): Promise<void>;
     static logEmbedding(model: string, success: boolean, message?: string): Promise<void>;
+    static logImageEmbedding(model: string, success: boolean, message?: string): Promise<void>;
+    static logAudioEmbedding(model: string, success: boolean, message?: string): Promise<void>;
 }
 //# sourceMappingURL=Telemetry.d.ts.map

package/lib/typescript/src/telemetry/Telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Telemetry.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/Telemetry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,SAAS;IAExB,SAAS,EAAE,cAAc,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAS;IAC7C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA0C;IAC9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAIpC;mBAEmB,SAAS;WA6BhB,aAAa,IAAI,OAAO;WAIlB,IAAI,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAqBxD,OAAO,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;WAcF,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC;WAkBF,YAAY,CACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CAajB"}
+{"version":3,"file":"Telemetry.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/Telemetry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,SAAS;IAExB,SAAS,EAAE,cAAc,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,UAAU,EACN,MAAM,GACN,YAAY,GACZ,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,iBAAiB,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAS;IAC7C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA0C;IAC9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAOpC;mBAEmB,SAAS;WAiChB,aAAa,IAAI,OAAO;WAIlB,IAAI,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAyBxD,OAAO,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;WAcF,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC;WAkBF,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC;WAkBF,YAAY,CACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;WAcF,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;WAcF,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CAajB"}

package/lib/typescript/src/types/CactusLM.d.ts

@@ -1,15 +1,17 @@
 export interface CactusLMParams {
     model?: string;
     contextSize?: number;
+    corpusDir?: string;
 }
 export interface CactusLMDownloadParams {
     onProgress?: (progress: number) => void;
 }
 export interface Message {
     role: 'user' | 'assistant' | 'system';
-    content: string;
+    content?: string;
+    images?: string[];
 }
-export interface Options {
+export interface CompleteOptions {
     temperature?: number;
     topP?: number;
     topK?: number;
@@ -17,7 +19,6 @@ export interface Options {
     stopSequences?: string[];
 }
 export interface Tool {
-    type: 'function';
     name: string;
     description: string;
     parameters: {
@@ -33,9 +34,10 @@ export interface Tool {
 }
 export interface CactusLMCompleteParams {
     messages: Message[];
-    options?: Options;
+    options?: CompleteOptions;
     tools?: Tool[];
     onToken?: (token: string) => void;
+    mode?: 'local' | 'hybrid';
 }
 export interface CactusLMCompleteResult {
     success: boolean;
@@ -59,7 +61,10 @@ export interface CactusLMEmbedParams {
 export interface CactusLMEmbedResult {
     embedding: number[];
 }
-export interface CactusLMGetModelsParams {
-    forceRefresh?: boolean;
+export interface CactusLMImageEmbedParams {
+    imagePath: string;
+}
+export interface CactusLMImageEmbedResult {
+    embedding: number[];
 }
 //# sourceMappingURL=CactusLM.d.ts.map

package/lib/typescript/src/types/CactusLM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CactusLM.d.ts","sourceRoot":"","sources":["../../../../src/types/CactusLM.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE;YACV,CAAC,GAAG,EAAE,MAAM,GAAG;gBACb,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC;QACF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACnC,EAAE,CAAC;IACJ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}
+{"version":3,"file":"CactusLM.d.ts","sourceRoot":"","sources":["../../../../src/types/CactusLM.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE;YACV,CAAC,GAAG,EAAE,MAAM,GAAG;gBACb,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC;QACF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACnC,EAAE,CAAC;IACJ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/lib/typescript/src/types/CactusSTT.d.ts

@@ -0,0 +1,37 @@
+export interface CactusSTTParams {
+    model?: string;
+    contextSize?: number;
+}
+export interface CactusSTTDownloadParams {
+    onProgress?: (progress: number) => void;
+}
+export interface TranscribeOptions {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+}
+export interface CactusSTTTranscribeParams {
+    audioFilePath: string;
+    prompt?: string;
+    options?: TranscribeOptions;
+    onToken?: (token: string) => void;
+}
+export interface CactusSTTTranscribeResult {
+    success: boolean;
+    response: string;
+    timeToFirstTokenMs: number;
+    totalTimeMs: number;
+    tokensPerSecond: number;
+    prefillTokens: number;
+    decodeTokens: number;
+    totalTokens: number;
+}
+export interface CactusSTTAudioEmbedParams {
+    audioPath: string;
+}
+export interface CactusSTTAudioEmbedResult {
+    embedding: number[];
+}
+//# sourceMappingURL=CactusSTT.d.ts.map

package/lib/typescript/src/types/CactusSTT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CactusSTT.d.ts","sourceRoot":"","sources":["../../../../src/types/CactusSTT.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/nitro.json

@@ -25,6 +25,10 @@
     "CactusDeviceInfo": {
       "kotlin": "HybridCactusDeviceInfo",
       "swift": "HybridCactusDeviceInfo"
+    },
+    "CactusImage": {
+      "kotlin": "HybridCactusImage",
+      "swift": "HybridCactusImage"
     }
   },
   "ignorePaths": ["node_modules"]

package/nitrogen/generated/android/c++/JHybridCactusImageSpec.cpp

@@ -0,0 +1,81 @@
+///
+/// JHybridCactusImageSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "JHybridCactusImageSpec.hpp"
+
+
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+#include <NitroModules/JPromise.hpp>
+
+namespace margelo::nitro::cactus {
+
+  jni::local_ref<JHybridCactusImageSpec::jhybriddata> JHybridCactusImageSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
+    return makeCxxInstance(jThis);
+  }
+
+  void JHybridCactusImageSpec::registerNatives() {
+    registerHybrid({
+      makeNativeMethod("initHybrid", JHybridCactusImageSpec::initHybrid),
+    });
+  }
+
+  size_t JHybridCactusImageSpec::getExternalMemorySize() noexcept {
+    static const auto method = javaClassStatic()->getMethod<jlong()>("getMemorySize");
+    return method(_javaPart);
+  }
+
+  void JHybridCactusImageSpec::dispose() noexcept {
+    static const auto method = javaClassStatic()->getMethod<void()>("dispose");
+    method(_javaPart);
+  }
+
+  std::string JHybridCactusImageSpec::toString() {
+    static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
+    auto javaString = method(_javaPart);
+    return javaString->toStdString();
+  }
+
+  // Properties
+  
+
+  // Methods
+  std::shared_ptr<Promise<std::string>> JHybridCactusImageSpec::base64(const std::string& path) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* path */)>("base64");
+    auto __result = method(_javaPart, jni::make_jstring(path));
+    return [&]() {
+      auto __promise = Promise<std::string>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<jni::JString>(__boxedResult);
+        __promise->resolve(__result->toStdString());
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+  std::shared_ptr<Promise<std::string>> JHybridCactusImageSpec::resize(const std::string& path, double height, double width, double quality) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* path */, double /* height */, double /* width */, double /* quality */)>("resize");
+    auto __result = method(_javaPart, jni::make_jstring(path), height, width, quality);
+    return [&]() {
+      auto __promise = Promise<std::string>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<jni::JString>(__boxedResult);
+        __promise->resolve(__result->toStdString());
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+
+} // namespace margelo::nitro::cactus

package/nitrogen/generated/android/c++/JHybridCactusImageSpec.hpp

@@ -0,0 +1,66 @@
+///
+/// HybridCactusImageSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <NitroModules/JHybridObject.hpp>
+#include <fbjni/fbjni.h>
+#include "HybridCactusImageSpec.hpp"
+
+
+
+
+namespace margelo::nitro::cactus {
+
+  using namespace facebook;
+
+  class JHybridCactusImageSpec: public jni::HybridClass<JHybridCactusImageSpec, JHybridObject>,
+                                public virtual HybridCactusImageSpec {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/cactus/HybridCactusImageSpec;";
+    static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
+    static void registerNatives();
+
+  protected:
+    // C++ constructor (called from Java via `initHybrid()`)
+    explicit JHybridCactusImageSpec(jni::alias_ref<jhybridobject> jThis) :
+      HybridObject(HybridCactusImageSpec::TAG),
+      HybridBase(jThis),
+      _javaPart(jni::make_global(jThis)) {}
+
+  public:
+    ~JHybridCactusImageSpec() override {
+      // Hermes GC can destroy JS objects on a non-JNI Thread.
+      jni::ThreadScope::WithClassLoader([&] { _javaPart.reset(); });
+    }
+
+  public:
+    size_t getExternalMemorySize() noexcept override;
+    void dispose() noexcept override;
+    std::string toString() override;
+
+  public:
+    inline const jni::global_ref<JHybridCactusImageSpec::javaobject>& getJavaPart() const noexcept {
+      return _javaPart;
+    }
+
+  public:
+    // Properties
+    
+
+  public:
+    // Methods
+    std::shared_ptr<Promise<std::string>> base64(const std::string& path) override;
+    std::shared_ptr<Promise<std::string>> resize(const std::string& path, double height, double width, double quality) override;
+
+  private:
+    friend HybridBase;
+    using HybridBase::HybridBase;
+    jni::global_ref<JHybridCactusImageSpec::javaobject> _javaPart;
+  };
+
+} // namespace margelo::nitro::cactus

package/nitrogen/generated/android/cactus+autolinking.cmake

@@ -37,11 +37,13 @@ target_sources(
   ../nitrogen/generated/shared/c++/HybridCactusCryptoSpec.cpp
   ../nitrogen/generated/shared/c++/HybridCactusDeviceInfoSpec.cpp
   ../nitrogen/generated/shared/c++/HybridCactusFileSystemSpec.cpp
+  ../nitrogen/generated/shared/c++/HybridCactusImageSpec.cpp
   ../nitrogen/generated/shared/c++/HybridCactusUtilSpec.cpp
   # Android-specific Nitrogen C++ sources
   ../nitrogen/generated/android/c++/JHybridCactusCryptoSpec.cpp
   ../nitrogen/generated/android/c++/JHybridCactusDeviceInfoSpec.cpp
   ../nitrogen/generated/android/c++/JHybridCactusFileSystemSpec.cpp
+  ../nitrogen/generated/android/c++/JHybridCactusImageSpec.cpp
 )
 
 # From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake

package/nitrogen/generated/android/cactusOnLoad.cpp

@@ -19,6 +19,7 @@
 #include "JHybridCactusDeviceInfoSpec.hpp"
 #include "JHybridCactusFileSystemSpec.hpp"
 #include "JFunc_void_double.hpp"
+#include "JHybridCactusImageSpec.hpp"
 #include "HybridCactus.hpp"
 #include "HybridCactusUtil.hpp"
 #include <NitroModules/DefaultConstructableObject.hpp>
@@ -36,6 +37,7 @@ int initialize(JavaVM* vm) {
     margelo::nitro::cactus::JHybridCactusDeviceInfoSpec::registerNatives();
     margelo::nitro::cactus::JHybridCactusFileSystemSpec::registerNatives();
     margelo::nitro::cactus::JFunc_void_double_cxx::registerNatives();
+    margelo::nitro::cactus::JHybridCactusImageSpec::registerNatives();
 
     // Register Nitro Hybrid Objects
     HybridObjectRegistry::registerHybridObjectConstructor(
@@ -80,6 +82,14 @@ int initialize(JavaVM* vm) {
         return instance->cthis()->shared();
       }
     );
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "CactusImage",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridCactusImageSpec::javaobject> object("com/margelo/nitro/cactus/HybridCactusImage");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
   });
 }
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/cactus/HybridCactusImageSpec.kt

@@ -0,0 +1,62 @@
+///
+/// HybridCactusImageSpec.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.cactus
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
+import com.margelo.nitro.core.HybridObject
+
+/**
+ * A Kotlin class representing the CactusImage HybridObject.
+ * Implement this abstract class to create Kotlin-based instances of CactusImage.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "SimpleRedundantLet",
+  "LocalVariableName", "PropertyName", "PrivatePropertyName", "FunctionName"
+)
+abstract class HybridCactusImageSpec: HybridObject() {
+  @DoNotStrip
+  private var mHybridData: HybridData = initHybrid()
+
+  init {
+    super.updateNative(mHybridData)
+  }
+
+  override fun updateNative(hybridData: HybridData) {
+    mHybridData = hybridData
+    super.updateNative(hybridData)
+  }
+
+  // Default implementation of `HybridObject.toString()`
+  override fun toString(): String {
+    return "[HybridObject CactusImage]"
+  }
+
+  // Properties
+  
+
+  // Methods
+  @DoNotStrip
+  @Keep
+  abstract fun base64(path: String): Promise<String>
+  
+  @DoNotStrip
+  @Keep
+  abstract fun resize(path: String, height: Double, width: Double, quality: Double): Promise<String>
+
+  private external fun initHybrid(): HybridData
+
+  companion object {
+    protected const val TAG = "HybridCactusImageSpec"
+  }
+}

package/nitrogen/generated/ios/Cactus-Swift-Cxx-Bridge.cpp

@@ -12,6 +12,7 @@
 #include "HybridCactusCryptoSpecSwift.hpp"
 #include "HybridCactusDeviceInfoSpecSwift.hpp"
 #include "HybridCactusFileSystemSpecSwift.hpp"
+#include "HybridCactusImageSpecSwift.hpp"
 
 namespace margelo::nitro::cactus::bridge::swift {
 
@@ -118,5 +119,21 @@ namespace margelo::nitro::cactus::bridge::swift {
     Cactus::HybridCactusFileSystemSpec_cxx& swiftPart = swiftWrapper->getSwiftPart();
     return swiftPart.toUnsafe();
   }
+  
+  // pragma MARK: std::shared_ptr<HybridCactusImageSpec>
+  std::shared_ptr<HybridCactusImageSpec> create_std__shared_ptr_HybridCactusImageSpec_(void* NON_NULL swiftUnsafePointer) noexcept {
+    Cactus::HybridCactusImageSpec_cxx swiftPart = Cactus::HybridCactusImageSpec_cxx::fromUnsafe(swiftUnsafePointer);
+    return std::make_shared<margelo::nitro::cactus::HybridCactusImageSpecSwift>(swiftPart);
+  }
+  void* NON_NULL get_std__shared_ptr_HybridCactusImageSpec_(std__shared_ptr_HybridCactusImageSpec_ cppType) {
+    std::shared_ptr<margelo::nitro::cactus::HybridCactusImageSpecSwift> swiftWrapper = std::dynamic_pointer_cast<margelo::nitro::cactus::HybridCactusImageSpecSwift>(cppType);
+    #ifdef NITRO_DEBUG
+    if (swiftWrapper == nullptr) [[unlikely]] {
+      throw std::runtime_error("Class \"HybridCactusImageSpec\" is not implemented in Swift!");
+    }
+    #endif
+    Cactus::HybridCactusImageSpec_cxx& swiftPart = swiftWrapper->getSwiftPart();
+    return swiftPart.toUnsafe();
+  }
 
 } // namespace margelo::nitro::cactus::bridge::swift

package/nitrogen/generated/ios/Cactus-Swift-Cxx-Bridge.hpp

@@ -16,6 +16,8 @@ namespace margelo::nitro::cactus { class HybridCactusCryptoSpec; }
 namespace margelo::nitro::cactus { class HybridCactusDeviceInfoSpec; }
 // Forward declaration of `HybridCactusFileSystemSpec` to properly resolve imports.
 namespace margelo::nitro::cactus { class HybridCactusFileSystemSpec; }
+// Forward declaration of `HybridCactusImageSpec` to properly resolve imports.
+namespace margelo::nitro::cactus { class HybridCactusImageSpec; }
 
 // Forward declarations of Swift defined types
 // Forward declaration of `HybridCactusCryptoSpec_cxx` to properly resolve imports.
@@ -24,12 +26,15 @@ namespace Cactus { class HybridCactusCryptoSpec_cxx; }
 namespace Cactus { class HybridCactusDeviceInfoSpec_cxx; }
 // Forward declaration of `HybridCactusFileSystemSpec_cxx` to properly resolve imports.
 namespace Cactus { class HybridCactusFileSystemSpec_cxx; }
+// Forward declaration of `HybridCactusImageSpec_cxx` to properly resolve imports.
+namespace Cactus { class HybridCactusImageSpec_cxx; }
 
 // Include C++ defined types
 #include "DeviceInfo.hpp"
 #include "HybridCactusCryptoSpec.hpp"
 #include "HybridCactusDeviceInfoSpec.hpp"
 #include "HybridCactusFileSystemSpec.hpp"
+#include "HybridCactusImageSpec.hpp"
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/PromiseHolder.hpp>
 #include <NitroModules/Result.hpp>
@@ -369,5 +374,17 @@ namespace margelo::nitro::cactus::bridge::swift {
   inline Result_std__shared_ptr_Promise_void___ create_Result_std__shared_ptr_Promise_void___(const std::exception_ptr& error) noexcept {
     return Result<std::shared_ptr<Promise<void>>>::withError(error);
   }
+  
+  // pragma MARK: std::shared_ptr<HybridCactusImageSpec>
+  /**
+   * Specialized version of `std::shared_ptr<HybridCactusImageSpec>`.
+   */
+  using std__shared_ptr_HybridCactusImageSpec_ = std::shared_ptr<HybridCactusImageSpec>;
+  std::shared_ptr<HybridCactusImageSpec> create_std__shared_ptr_HybridCactusImageSpec_(void* NON_NULL swiftUnsafePointer) noexcept;
+  void* NON_NULL get_std__shared_ptr_HybridCactusImageSpec_(std__shared_ptr_HybridCactusImageSpec_ cppType);
+  
+  // pragma MARK: std::weak_ptr<HybridCactusImageSpec>
+  using std__weak_ptr_HybridCactusImageSpec_ = std::weak_ptr<HybridCactusImageSpec>;
+  inline std__weak_ptr_HybridCactusImageSpec_ weakify_std__shared_ptr_HybridCactusImageSpec_(const std::shared_ptr<HybridCactusImageSpec>& strong) noexcept { return strong; }
 
 } // namespace margelo::nitro::cactus::bridge::swift

package/nitrogen/generated/ios/Cactus-Swift-Cxx-Umbrella.hpp

@@ -16,12 +16,15 @@ namespace margelo::nitro::cactus { class HybridCactusCryptoSpec; }
 namespace margelo::nitro::cactus { class HybridCactusDeviceInfoSpec; }
 // Forward declaration of `HybridCactusFileSystemSpec` to properly resolve imports.
 namespace margelo::nitro::cactus { class HybridCactusFileSystemSpec; }
+// Forward declaration of `HybridCactusImageSpec` to properly resolve imports.
+namespace margelo::nitro::cactus { class HybridCactusImageSpec; }
 
 // Include C++ defined types
 #include "DeviceInfo.hpp"
 #include "HybridCactusCryptoSpec.hpp"
 #include "HybridCactusDeviceInfoSpec.hpp"
 #include "HybridCactusFileSystemSpec.hpp"
+#include "HybridCactusImageSpec.hpp"
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/Result.hpp>
 #include <exception>
@@ -46,6 +49,8 @@ namespace Cactus { class HybridCactusCryptoSpec_cxx; }
 namespace Cactus { class HybridCactusDeviceInfoSpec_cxx; }
 // Forward declaration of `HybridCactusFileSystemSpec_cxx` to properly resolve imports.
 namespace Cactus { class HybridCactusFileSystemSpec_cxx; }
+// Forward declaration of `HybridCactusImageSpec_cxx` to properly resolve imports.
+namespace Cactus { class HybridCactusImageSpec_cxx; }
 
 // Include Swift defined types
 #if __has_include("Cactus-Swift.h")

package/nitrogen/generated/ios/CactusAutolinking.mm

@@ -15,6 +15,7 @@
 #include "HybridCactusFileSystemSpecSwift.hpp"
 #include "HybridCactusCryptoSpecSwift.hpp"
 #include "HybridCactusDeviceInfoSpecSwift.hpp"
+#include "HybridCactusImageSpecSwift.hpp"
 
 @interface CactusAutolinking : NSObject
 @end
@@ -64,6 +65,13 @@
       return hybridObject;
     }
   );
+  HybridObjectRegistry::registerHybridObjectConstructor(
+    "CactusImage",
+    []() -> std::shared_ptr<HybridObject> {
+      std::shared_ptr<HybridCactusImageSpec> hybridObject = Cactus::CactusAutolinking::createCactusImage();
+      return hybridObject;
+    }
+  );
 }
 
 @end

package/nitrogen/generated/ios/CactusAutolinking.swift

@@ -52,4 +52,19 @@ public final class CactusAutolinking {
       return __cxxWrapped.getCxxPart()
     }()
   }
+  
+  /**
+   * Creates an instance of a Swift class that implements `HybridCactusImageSpec`,
+   * and wraps it in a Swift class that can directly interop with C++ (`HybridCactusImageSpec_cxx`)
+   *
+   * This is generated by Nitrogen and will initialize the class specified
+   * in the `"autolinking"` property of `nitro.json` (in this case, `HybridCactusImage`).
+   */
+  public static func createCactusImage() -> bridge.std__shared_ptr_HybridCactusImageSpec_ {
+    let hybridObject = HybridCactusImage()
+    return { () -> bridge.std__shared_ptr_HybridCactusImageSpec_ in
+      let __cxxWrapped = hybridObject.getCxxWrapper()
+      return __cxxWrapped.getCxxPart()
+    }()
+  }
 }

package/nitrogen/generated/ios/c++/HybridCactusImageSpecSwift.cpp

@@ -0,0 +1,11 @@
+///
+/// HybridCactusImageSpecSwift.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridCactusImageSpecSwift.hpp"
+
+namespace margelo::nitro::cactus {
+} // namespace margelo::nitro::cactus

package/nitrogen/generated/ios/c++/HybridCactusImageSpecSwift.hpp

@@ -0,0 +1,85 @@
+///
+/// HybridCactusImageSpecSwift.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include "HybridCactusImageSpec.hpp"
+
+// Forward declaration of `HybridCactusImageSpec_cxx` to properly resolve imports.
+namespace Cactus { class HybridCactusImageSpec_cxx; }
+
+
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+
+#include "Cactus-Swift-Cxx-Umbrella.hpp"
+
+namespace margelo::nitro::cactus {
+
+  /**
+   * The C++ part of HybridCactusImageSpec_cxx.swift.
+   *
+   * HybridCactusImageSpecSwift (C++) accesses HybridCactusImageSpec_cxx (Swift), and might
+   * contain some additional bridging code for C++ <> Swift interop.
+   *
+   * Since this obviously introduces an overhead, I hope at some point in
+   * the future, HybridCactusImageSpec_cxx can directly inherit from the C++ class HybridCactusImageSpec
+   * to simplify the whole structure and memory management.
+   */
+  class HybridCactusImageSpecSwift: public virtual HybridCactusImageSpec {
+  public:
+    // Constructor from a Swift instance
+    explicit HybridCactusImageSpecSwift(const Cactus::HybridCactusImageSpec_cxx& swiftPart):
+      HybridObject(HybridCactusImageSpec::TAG),
+      _swiftPart(swiftPart) { }
+
+  public:
+    // Get the Swift part
+    inline Cactus::HybridCactusImageSpec_cxx& getSwiftPart() noexcept {
+      return _swiftPart;
+    }
+
+  public:
+    inline size_t getExternalMemorySize() noexcept override {
+      return _swiftPart.getMemorySize();
+    }
+    void dispose() noexcept override {
+      _swiftPart.dispose();
+    }
+    std::string toString() override {
+      return _swiftPart.toString();
+    }
+
+  public:
+    // Properties
+    
+
+  public:
+    // Methods
+    inline std::shared_ptr<Promise<std::string>> base64(const std::string& path) override {
+      auto __result = _swiftPart.base64(path);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    inline std::shared_ptr<Promise<std::string>> resize(const std::string& path, double height, double width, double quality) override {
+      auto __result = _swiftPart.resize(path, std::forward<decltype(height)>(height), std::forward<decltype(width)>(width), std::forward<decltype(quality)>(quality));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+
+  private:
+    Cactus::HybridCactusImageSpec_cxx _swiftPart;
+  };
+
+} // namespace margelo::nitro::cactus