@dr33m/react-native-litert-lm 0.5.0

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

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

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

@@ -0,0 +1,87 @@
+///
+/// ToolCall.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 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
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::litertlm {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ToolCall).
+   */
+  struct ToolCall final {
+  public:
+    std::string name     SWIFT_PRIVATE;
+    std::string argumentsJson     SWIFT_PRIVATE;
+
+  public:
+    ToolCall() = default;
+    explicit ToolCall(std::string name, std::string argumentsJson): name(name), argumentsJson(argumentsJson) {}
+
+  public:
+    friend bool operator==(const ToolCall& lhs, const ToolCall& rhs) = default;
+  };
+
+} // namespace margelo::nitro::litertlm
+
+namespace margelo::nitro {
+
+  // C++ ToolCall <> JS ToolCall (object)
+  template <>
+  struct JSIConverter<margelo::nitro::litertlm::ToolCall> final {
+    static inline margelo::nitro::litertlm::ToolCall fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::litertlm::ToolCall(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "name"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "argumentsJson")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::litertlm::ToolCall& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "name"), JSIConverter<std::string>::toJSI(runtime, arg.name));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "argumentsJson"), JSIConverter<std::string>::toJSI(runtime, arg.argumentsJson));
+      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, PropNameIDCache::get(runtime, "name")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "argumentsJson")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,91 @@
+///
+/// ToolDefinition.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 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
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::litertlm {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ToolDefinition).
+   */
+  struct ToolDefinition final {
+  public:
+    std::string name     SWIFT_PRIVATE;
+    std::string description     SWIFT_PRIVATE;
+    std::string parametersJson     SWIFT_PRIVATE;
+
+  public:
+    ToolDefinition() = default;
+    explicit ToolDefinition(std::string name, std::string description, std::string parametersJson): name(name), description(description), parametersJson(parametersJson) {}
+
+  public:
+    friend bool operator==(const ToolDefinition& lhs, const ToolDefinition& rhs) = default;
+  };
+
+} // namespace margelo::nitro::litertlm
+
+namespace margelo::nitro {
+
+  // C++ ToolDefinition <> JS ToolDefinition (object)
+  template <>
+  struct JSIConverter<margelo::nitro::litertlm::ToolDefinition> final {
+    static inline margelo::nitro::litertlm::ToolDefinition fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::litertlm::ToolDefinition(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "name"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "description"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "parametersJson")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::litertlm::ToolDefinition& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "name"), JSIConverter<std::string>::toJSI(runtime, arg.name));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "description"), JSIConverter<std::string>::toJSI(runtime, arg.description));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "parametersJson"), JSIConverter<std::string>::toJSI(runtime, arg.parametersJson));
+      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, PropNameIDCache::get(runtime, "name")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "description")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "parametersJson")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,87 @@
+///
+/// ToolResponse.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 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
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::litertlm {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ToolResponse).
+   */
+  struct ToolResponse final {
+  public:
+    std::string name     SWIFT_PRIVATE;
+    std::string responseJson     SWIFT_PRIVATE;
+
+  public:
+    ToolResponse() = default;
+    explicit ToolResponse(std::string name, std::string responseJson): name(name), responseJson(responseJson) {}
+
+  public:
+    friend bool operator==(const ToolResponse& lhs, const ToolResponse& rhs) = default;
+  };
+
+} // namespace margelo::nitro::litertlm
+
+namespace margelo::nitro {
+
+  // C++ ToolResponse <> JS ToolResponse (object)
+  template <>
+  struct JSIConverter<margelo::nitro::litertlm::ToolResponse> final {
+    static inline margelo::nitro::litertlm::ToolResponse fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::litertlm::ToolResponse(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "name"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "responseJson")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::litertlm::ToolResponse& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "name"), JSIConverter<std::string>::toJSI(runtime, arg.name));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "responseJson"), JSIConverter<std::string>::toJSI(runtime, arg.responseJson));
+      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, PropNameIDCache::get(runtime, "name")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "responseJson")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@dr33m/react-native-litert-lm",
+  "version": "0.5.0",
+  "litertLm": {
+    "version": "0.12.0",
+    "androidMavenVersion": "0.12.0",
+    "iosGitTag": "v0.12.0"
+  },
+  "description": "High-performance LLM inference for React Native using LiteRT-LM. Optimized for Gemma 4 and other on-device language models.",
+  "license": "MIT",
+  "author": "Thamsanqa Dreem (https://github.com/dr-33-m)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dr-33-m/react-native-litert-lm.git"
+  },
+  "homepage": "https://github.com/dr-33-m/react-native-litert-lm#readme",
+  "bugs": {
+    "url": "https://github.com/dr-33-m/react-native-litert-lm/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "react-native",
+    "nitro",
+    "litert",
+    "litert-lm",
+    "llm",
+    "gemma",
+    "gemma-4",
+    "gemma-3n",
+    "ai",
+    "machine-learning",
+    "on-device",
+    "inference",
+    "expo"
+  ],
+  "main": "lib/index",
+  "module": "lib/index",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android/src",
+    "android/build.gradle",
+    "android/CMakeLists.txt",
+    "ios/**/*.swift",
+    "ios/**/*.mm",
+    "ios/**/*.m",
+    "cpp",
+    "nitrogen/generated",
+    "scripts/postinstall.js",
+    "scripts/framework-source.js",
+    "scripts/download-ios-frameworks.sh",
+    "react-native.config.js",
+    "react-native-litert-lm.podspec",
+    "app.plugin.js",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
+    "prepack": "npx nitrogen && npm run build",
+    "specs": "npx nitrogen",
+    "clean": "rm -rf lib android/build ios/build ios/Frameworks nitrogen/generated",
+    "download-frameworks": "scripts/download-ios-frameworks.sh",
+    "check-framework-release": "node scripts/check-framework-release.js",
+    "prepublishOnly": "node scripts/check-framework-release.js",
+    "android": "expo run:android",
+    "android:clean": "cd android && ./gradlew clean",
+    "ios": "expo run:ios",
+    "release": "release-it"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "~55.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/react": "~19.2.10",
+    "@types/react-test-renderer": "^19.1.0",
+    "jest": "^30.4.2",
+    "react": "^19.2.6",
+    "react-native": "^0.85.3",
+    "react-native-nitro-modules": "^0.35.9",
+    "react-test-renderer": "^19.2.6",
+    "release-it": "^19.2.4",
+    "ts-jest": "^29.4.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "expo": ">=55.0.0",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.35.9"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  }
+}

package/react-native-litert-lm.podspec

@@ -0,0 +1,62 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-litert-lm"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.platforms    = { :ios => "15.1" }
+  s.module_name  = "LiteRTLM"
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+  
+  s.swift_version = '5.9'
+
+  s.source_files = [
+    # Swift, Objective-C/C++ implementation & autolinking
+    "ios/*.{swift,m,mm}",
+    # Nitrogen generated iOS bridge & shared C++ interfaces
+    "nitrogen/generated/ios/**/*.{mm,swift}",
+    "nitrogen/generated/shared/c++/**/*.{hpp,cpp}",
+  ]
+
+  # Prebuilt LiteRT-LM C engine (xcframework). Not shipped in the npm tarball;
+  # fetched on install by scripts/postinstall.js (asset/tag defined in
+  # scripts/framework-source.js). Manual/upstream fallback:
+  # scripts/download-ios-frameworks.sh.
+  s.vendored_frameworks = 'ios/Frameworks/CLiteRTLM.xcframework'
+
+  s.pod_target_xcconfig = {
+    'CLANG_CXX_LANGUAGE_STANDARD' => 'c++20',
+    'SWIFT_VERSION' => '5.9',
+    'HEADER_SEARCH_PATHS' => [
+      '"$(PODS_TARGET_SRCROOT)/nitrogen/generated/shared/c++"',
+      '"$(PODS_TARGET_SRCROOT)/nitrogen/generated/ios"',
+    ].join(' '),
+    'OTHER_LDFLAGS' => '$(inherited) -ObjC',
+  }
+
+  # Load nitrogen autolinking
+  load 'nitrogen/generated/ios/LiteRTLM+autolinking.rb'
+  add_nitrogen_files(s)
+
+  # Core React Native dependencies
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+  s.dependency 'ReactCommon/turbomodule/core'
+
+  # Apple frameworks needed by LiteRT-LM engine
+  # Metal/MPS: GPU inference, Accelerate: BLAS/LAPACK, CoreML: delegate
+  s.frameworks = ['Metal', 'MetalPerformanceShaders', 'Accelerate', 'CoreML', 'CoreGraphics']
+  s.libraries = ['c++']
+
+  s.test_spec 'Tests' do |test_spec|
+    test_spec.source_files = 'ios/Tests/**/*.{swift}'
+  end
+
+  install_modules_dependencies(s)
+end
+

package/react-native.config.js

@@ -0,0 +1,16 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        sourceDir: "./android",
+        packageImportPath: "import dev.litert.litertlm.LiteRTLMPackage;",
+        packageInstance: "new LiteRTLMPackage()",
+        componentDescriptors: [],
+        cmakeListsPath: "CMakeLists.txt",
+      },
+      ios: {
+        podspecPath: "./react-native-litert-lm.podspec",
+      },
+    },
+  },
+};

package/scripts/download-ios-frameworks.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# download-ios-frameworks.sh
+# Downloads the official prebuilt LiteRT-LM iOS framework (CLiteRTLM.xcframework)
+# directly from the google-ai-edge/LiteRT-LM releases.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Resolve the asset URL + output dir from the shared single source of truth
+# (scripts/framework-source.js) so this manual path can't drift from postinstall.
+RELEASE_URL="$(node -e "console.log(require('$SCRIPT_DIR/framework-source').ASSET_URL)")"
+OUTPUT_DIR="$(node -e "console.log(require('$SCRIPT_DIR/framework-source').FRAMEWORKS_DIR)")"
+
+# Skip if already present
+if [ -d "$OUTPUT_DIR/CLiteRTLM.xcframework" ]; then
+  echo "[LiteRT-LM] iOS CLiteRTLM.xcframework already present, skipping download."
+  exit 0
+fi
+
+echo "[LiteRT-LM] Downloading prebuilt iOS engine from Google's release:"
+echo "   ${RELEASE_URL}"
+
+mkdir -p "$OUTPUT_DIR"
+TMP_ZIP="$PROJECT_ROOT/.ios-frameworks-tmp.zip"
+
+if curl -fsSL -o "$TMP_ZIP" "$RELEASE_URL"; then
+  echo "[LiteRT-LM] Download successful, extracting to $OUTPUT_DIR..."
+  rm -rf "$OUTPUT_DIR/CLiteRTLM.xcframework"
+  unzip -o -q "$TMP_ZIP" -d "$OUTPUT_DIR"
+  rm -f "$TMP_ZIP"
+  echo "[LiteRT-LM] ✅ iOS frameworks successfully installed."
+  exit 0
+else
+  rm -f "$TMP_ZIP"
+  echo "Error: Failed to download LiteRT-LM iOS framework from ${RELEASE_URL}"
+  exit 1
+fi

package/scripts/framework-source.js

@@ -0,0 +1,46 @@
+/**
+ * framework-source.js
+ *
+ * Single source of truth for the prebuilt iOS framework artifact, shared by
+ * scripts/postinstall.js, scripts/download-ios-frameworks.sh, and
+ * scripts/check-framework-release.js, so the asset name, tag, and URL can never
+ * drift between the install path and the release-time guardrail.
+ *
+ * The artifact is Google's canonical LiteRT-LM release (NOT a per-version
+ * re-host of this package), pinned to the LiteRT-LM **engine** version
+ * (`litertLm.iosGitTag` in package.json), NOT this wrapper's npm version. So:
+ *   - patch releases of this wrapper reuse the same framework (no re-upload),
+ *   - there is no per-release asset for the maintainer to forget to upload,
+ *   - the guardrail checks the exact URL consumers fetch.
+ *
+ * Override the host/asset (e.g. to point at a private mirror) via env vars:
+ *   LITERT_FRAMEWORK_REPO   (default: google-ai-edge/LiteRT-LM)
+ *   LITERT_FRAMEWORK_ASSET  (default: CLiteRTLM.xcframework.zip)
+ */
+
+const path = require('path');
+const packageJson = require('../package.json');
+
+/** GitHub repo that hosts the framework release asset. */
+const GITHUB_REPO = process.env.LITERT_FRAMEWORK_REPO || 'google-ai-edge/LiteRT-LM';
+
+/** Release asset filename. Must match the file on the GitHub release. */
+const ASSET_NAME = process.env.LITERT_FRAMEWORK_ASSET || 'CLiteRTLM.xcframework.zip';
+
+/** Release tag the asset lives under — the LiteRT-LM engine git tag, e.g. "v0.12.0". */
+const FRAMEWORK_TAG = packageJson.litertLm.iosGitTag;
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const FRAMEWORKS_DIR = path.join(PACKAGE_ROOT, 'ios', 'Frameworks');
+
+/** Fully-resolved download URL for the framework zip. */
+const ASSET_URL = `https://github.com/${GITHUB_REPO}/releases/download/${FRAMEWORK_TAG}/${ASSET_NAME}`;
+
+module.exports = {
+  GITHUB_REPO,
+  ASSET_NAME,
+  FRAMEWORK_TAG,
+  PACKAGE_ROOT,
+  FRAMEWORKS_DIR,
+  ASSET_URL,
+};