cactus-react-native 0.2.11 → 1.0.2

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

@@ -0,0 +1,73 @@
+///
+/// HybridCactusFileSystemSpec.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>
+#include <functional>
+#include <optional>
+
+namespace margelo::nitro::cactus {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `CactusFileSystem`
+   * Inherit this class to create instances of `HybridCactusFileSystemSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridCactusFileSystem: public HybridCactusFileSystemSpec {
+   * public:
+   *   HybridCactusFileSystem(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridCactusFileSystemSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridCactusFileSystemSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridCactusFileSystemSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<std::string>> getCactusDirectory() = 0;
+      virtual std::shared_ptr<Promise<bool>> fileExists(const std::string& path) = 0;
+      virtual std::shared_ptr<Promise<void>> writeFile(const std::string& path, const std::string& content) = 0;
+      virtual std::shared_ptr<Promise<std::string>> readFile(const std::string& path) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteFile(const std::string& path) = 0;
+      virtual std::shared_ptr<Promise<bool>> modelExists(const std::string& model) = 0;
+      virtual std::shared_ptr<Promise<std::string>> getModelPath(const std::string& model) = 0;
+      virtual std::shared_ptr<Promise<void>> downloadModel(const std::string& model, const std::string& from, const std::optional<std::function<void(double /* progress */)>>& callback) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteModel(const std::string& model) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "CactusFileSystem";
+  };
+
+} // namespace margelo::nitro::cactus

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

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

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

@@ -0,0 +1,71 @@
+///
+/// HybridCactusSpec.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 <NitroModules/Promise.hpp>
+#include <string>
+#include <optional>
+#include <functional>
+#include <vector>
+
+namespace margelo::nitro::cactus {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `Cactus`
+   * Inherit this class to create instances of `HybridCactusSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridCactus: public HybridCactusSpec {
+   * public:
+   *   HybridCactus(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridCactusSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridCactusSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridCactusSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> init(const std::string& modelPath, double contextSize, const std::optional<std::string>& corpusDir) = 0;
+      virtual std::shared_ptr<Promise<std::string>> complete(const std::string& messagesJson, double responseBufferSize, const std::optional<std::string>& optionsJson, const std::optional<std::string>& toolsJson, const std::optional<std::function<void(const std::string& /* token */, double /* tokenId */)>>& callback) = 0;
+      virtual std::shared_ptr<Promise<std::vector<double>>> embed(const std::string& text, double embeddingBufferSize) = 0;
+      virtual std::shared_ptr<Promise<void>> reset() = 0;
+      virtual std::shared_ptr<Promise<void>> stop() = 0;
+      virtual std::shared_ptr<Promise<void>> destroy() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "Cactus";
+  };
+
+} // namespace margelo::nitro::cactus

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

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

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

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

package/package.json

@@ -1,20 +1,27 @@
 {
   "name": "cactus-react-native",
-  "version": "0.2.11",
+  "version": "1.0.2",
   "description": "Run AI models locally on mobile devices",
-  "main": "lib/commonjs/index",
-  "module": "lib/module/index",
-  "types": "lib/typescript/index.d.ts",
-  "react-native": "src/index",
-  "source": "src/index",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "src",
     "lib",
-    "scripts",
-    "ios",
-    "ios/CMakeLists.txt",
     "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
     "*.podspec",
+    "react-native.config.js",
     "!ios/build",
     "!android/build",
     "!android/gradle",
@@ -24,70 +31,72 @@
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
-    "!**/.*",
-    "!ios/*.xcodeproj"
+    "!**/.*"
   ],
   "scripts": {
-    "build": "bob build",
-    "docgen": "typedoc src/index.ts --plugin typedoc-plugin-markdown --readme none --out docs/API",
-    "typecheck": "tsc --noEmit",
+    "example": "yarn workspace cactus-react-native-example",
+    "test": "jest",
+    "typecheck": "tsc",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "release": "release-it --ci",
-    "postinstall": "node ./scripts/postInstall.js"
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "release": "release-it --only-version"
   },
   "keywords": [
     "react-native",
     "ios",
-    "android",
-    "large language model",
-    "LLM",
-    "Local LLM"
+    "android"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cactus-compute/cactus.git"
+    "url": "git+https://github.com/cactus-compute/cactus-react-native.git"
   },
-  "author": "cactus-compute <founders@cactus-compute.com> (https://github.com/cactus-compute)",
+  "author": "cactus-compute <founders@cactus-compute.com> (https://cactuscompute.com)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/cactus-compute/cactus/issues"
+    "url": "https://github.com/cactus-compute/cactus-react-native/issues"
   },
-  "homepage": "https://github.com/cactus-compute/cactus#readme",
+  "homepage": "https://github.com/cactus-compute/cactus-react-native#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^17.0.2",
-    "@fugood/eslint-config-react": "^0.5.0",
-    "@react-native-community/eslint-config": "^3.0.2",
-    "@release-it/conventional-changelog": "^5.0.0",
-    "@types/jest": "^28.1.2",
-    "@types/react": "~17.0.21",
-    "@types/react-native": "0.70.0",
-    "commitlint": "^17.0.2",
-    "eslint": "^8.4.1",
-    "jest": "^28.1.1",
-    "pod-install": "^0.1.0",
-    "prettier": "^2.0.5",
-    "react": "18.2.0",
-    "react-native": "0.72.3",
-    "react-native-builder-bob": "^0.37.0",
-    "release-it": "^15.0.0",
-    "typedoc": "^0.24.7",
-    "typedoc-plugin-markdown": "^3.15.3",
-    "typescript": "^5.0.2"
-  },
-  "resolutions": {
-    "@types/react": "17.0.21"
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@evilmartians/lefthook": "^1.12.3",
+    "@react-native/babel-preset": "0.81.1",
+    "@react-native/eslint-config": "^0.81.1",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "nitrogen": "^0.31.3",
+    "prettier": "^3.6.2",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "react-native-builder-bob": "^0.40.14",
+    "react-native-nitro-modules": "^0.31.3",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "react-native-fs": "*"
-  },
-  "engines": {
-    "node": ">= 16.0.0"
+    "react-native-nitro-modules": "^0.31.3"
   },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
   "jest": {
     "preset": "react-native",
     "modulePathIgnorePatterns": [
@@ -106,110 +115,43 @@
       "tagName": "v${version}"
     },
     "npm": {
-      "publish": true,
-      "skipChecks": true
+      "publish": true
     },
     "github": {
       "release": true
     },
     "plugins": {
       "@release-it/conventional-changelog": {
-        "preset": "angular"
-      }
-    },
-    "increment": false
-  },
-  "eslintConfig": {
-    "extends": "@fugood/eslint-config-react",
-    "env": {
-      "browser": true,
-      "jest": true
-    },
-    "globals": {},
-    "rules": {
-      "react/no-array-index-key": 0,
-      "global-require": 0
-    },
-    "overrides": [
-      {
-        "files": [
-          "*.ts",
-          "*.tsx"
-        ],
-        "parser": "@typescript-eslint/parser",
-        "plugins": [
-          "@typescript-eslint/eslint-plugin"
-        ],
-        "rules": {
-          "@typescript-eslint/no-unused-vars": [
-            "error",
-            {
-              "argsIgnorePattern": "^_",
-              "destructuredArrayIgnorePattern": "^_"
-            }
-          ],
-          "no-unused-vars": "off",
-          "no-shadow": "off",
-          "@typescript-eslint/no-shadow": 1,
-          "no-undef": "off",
-          "func-call-spacing": "off",
-          "@typescript-eslint/func-call-spacing": 1,
-          "import/extensions": [
-            "error",
-            "ignorePackages",
-            {
-              "js": "never",
-              "jsx": "never",
-              "ts": "never",
-              "tsx": "never"
-            }
-          ],
-          "react/jsx-filename-extension": [
-            1,
-            {
-              "extensions": [
-                ".js",
-                ".jsx",
-                ".tsx"
-              ]
-            }
-          ]
-        }
-      }
-    ],
-    "settings": {
-      "import/resolver": {
-        "node": {
-          "extensions": [
-            ".js",
-            ".jsx",
-            ".ts",
-            ".tsx"
-          ]
+        "preset": {
+          "name": "angular"
         }
       }
     }
   },
-  "eslintIgnore": [
-    "node_modules/",
-    "lib/",
-    "example/",
-    "*.d.ts",
-    "llama.cpp/"
-  ],
   "prettier": {
-    "trailingComma": "all",
-    "tabWidth": 2,
-    "semi": false,
+    "quoteProps": "consistent",
     "singleQuote": true,
-    "printWidth": 80
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
   },
   "react-native-builder-bob": {
     "source": "src",
     "output": "lib",
     "targets": [
-      "commonjs",
-      "module",
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
       [
         "typescript",
         {
@@ -218,10 +160,9 @@
       ]
     ]
   },
-  "codegenConfig": {
-    "name": "CactusSpec",
-    "type": "modules",
-    "jsSrcsDir": "src"
-  },
-  "packageManager": "yarn@1.22.22"
+  "create-react-native-library": {
+    "languages": "kotlin-swift",
+    "type": "nitro-module",
+    "version": "0.54.8"
+  }
 }

package/src/api/Database.ts

@@ -0,0 +1,83 @@
+import { CactusUtil } from '../native';
+import type { DeviceInfo } from '../specs/CactusDeviceInfo.nitro';
+import type { LogRecord } from '../telemetry/Telemetry';
+import { packageVersion } from '../constants/packageVersion';
+import type { CactusModel } from '../types/CactusModel';
+
+interface CactusModelResponse {
+  name: string;
+  slug: string;
+  quantization: number;
+  size_mb: number;
+  download_url: string;
+  supports_tool_calling: boolean;
+  supports_vision: boolean;
+  created_at: Date;
+}
+
+export class Database {
+  private static readonly url = 'https://vlqqczxwyaodtcdmdmlw.supabase.co';
+  private static readonly key =
+    'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InZscXFjenh3eWFvZHRjZG1kbWx3Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTE1MTg2MzIsImV4cCI6MjA2NzA5NDYzMn0.nBzqGuK9j6RZ6mOPWU2boAC_5H9XDs-fPpo5P3WZYbI';
+
+  public static async sendLogRecords(records: LogRecord[]): Promise<void> {
+    const response = await fetch(`${this.url}/rest/v1/logs`, {
+      method: 'POST',
+      headers: {
+        'apikey': this.key,
+        'Authorization': `Bearer ${this.key}`,
+        'Content-Type': 'application/json',
+        'Content-Profile': 'cactus',
+        'Prefer': 'return=minimal',
+      },
+      body: JSON.stringify(records),
+    });
+
+    if (!response.ok) {
+      throw new Error('Sending logs failed');
+    }
+  }
+
+  public static async registerDevice(device_data: DeviceInfo): Promise<string> {
+    const response = await fetch(
+      `${this.url}/functions/v1/device-registration`,
+      {
+        method: 'POST',
+        body: JSON.stringify({ device_data }),
+      }
+    );
+
+    if (!response.ok) {
+      throw new Error('Registering device failed');
+    }
+
+    return await CactusUtil.registerApp(await response.text());
+  }
+
+  public static async getModels(): Promise<CactusModel[]> {
+    const response = await fetch(
+      `${this.url}/functions/v1/get-models?sdk_name=react&sdk_version=${packageVersion}`,
+      {
+        headers: { apikey: this.key, Authorization: `Bearer ${this.key}` },
+      }
+    );
+
+    if (!response.ok) {
+      throw new Error('Getting models failed');
+    }
+
+    const models = (await response.json()) as CactusModelResponse[];
+
+    return models.map((model) => ({
+      name: model.name,
+      slug: model.slug,
+      quantization: model.quantization,
+      sizeMb: model.size_mb,
+      downloadUrl: model.download_url,
+      supportsToolCalling: model.supports_tool_calling,
+      supportsVision: model.supports_vision,
+      createdAt: model.created_at,
+      isDownloaded: false,
+    }));
+  }
+}