react-native-nitro-onnx 0.1.0

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

@@ -0,0 +1,100 @@
+///
+/// VadConfig.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>
+#include <optional>
+
+namespace margelo::nitro::onnx::speech {
+
+  /**
+   * A struct which can be represented as a JavaScript object (VadConfig).
+   */
+  struct VadConfig final {
+  public:
+    std::optional<std::string> modelPath     SWIFT_PRIVATE;
+    std::optional<double> threshold     SWIFT_PRIVATE;
+    std::optional<double> minSilenceDurationMs     SWIFT_PRIVATE;
+    std::optional<double> minSpeechDurationMs     SWIFT_PRIVATE;
+    std::optional<double> preBufferMs     SWIFT_PRIVATE;
+
+  public:
+    VadConfig() = default;
+    explicit VadConfig(std::optional<std::string> modelPath, std::optional<double> threshold, std::optional<double> minSilenceDurationMs, std::optional<double> minSpeechDurationMs, std::optional<double> preBufferMs): modelPath(modelPath), threshold(threshold), minSilenceDurationMs(minSilenceDurationMs), minSpeechDurationMs(minSpeechDurationMs), preBufferMs(preBufferMs) {}
+
+  public:
+    friend bool operator==(const VadConfig& lhs, const VadConfig& rhs) = default;
+  };
+
+} // namespace margelo::nitro::onnx::speech
+
+namespace margelo::nitro {
+
+  // C++ VadConfig <> JS VadConfig (object)
+  template <>
+  struct JSIConverter<margelo::nitro::onnx::speech::VadConfig> final {
+    static inline margelo::nitro::onnx::speech::VadConfig fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::onnx::speech::VadConfig(
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "modelPath"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "threshold"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minSilenceDurationMs"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minSpeechDurationMs"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "preBufferMs")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::onnx::speech::VadConfig& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "modelPath"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.modelPath));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "threshold"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.threshold));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "minSilenceDurationMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.minSilenceDurationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "minSpeechDurationMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.minSpeechDurationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "preBufferMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.preBufferMs));
+      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::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "modelPath")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "threshold")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minSilenceDurationMs")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minSpeechDurationMs")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "preBufferMs")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,91 @@
+///
+/// VadSegment.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 <NitroModules/ArrayBuffer.hpp>
+
+namespace margelo::nitro::onnx::speech {
+
+  /**
+   * A struct which can be represented as a JavaScript object (VadSegment).
+   */
+  struct VadSegment final {
+  public:
+    double startMs     SWIFT_PRIVATE;
+    double endMs     SWIFT_PRIVATE;
+    std::shared_ptr<ArrayBuffer> samples     SWIFT_PRIVATE;
+
+  public:
+    VadSegment() = default;
+    explicit VadSegment(double startMs, double endMs, std::shared_ptr<ArrayBuffer> samples): startMs(startMs), endMs(endMs), samples(samples) {}
+
+  public:
+    friend bool operator==(const VadSegment& lhs, const VadSegment& rhs) = default;
+  };
+
+} // namespace margelo::nitro::onnx::speech
+
+namespace margelo::nitro {
+
+  // C++ VadSegment <> JS VadSegment (object)
+  template <>
+  struct JSIConverter<margelo::nitro::onnx::speech::VadSegment> final {
+    static inline margelo::nitro::onnx::speech::VadSegment fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::onnx::speech::VadSegment(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "startMs"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "endMs"))),
+        JSIConverter<std::shared_ptr<ArrayBuffer>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "samples")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::onnx::speech::VadSegment& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "startMs"), JSIConverter<double>::toJSI(runtime, arg.startMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "endMs"), JSIConverter<double>::toJSI(runtime, arg.endMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "samples"), JSIConverter<std::shared_ptr<ArrayBuffer>>::toJSI(runtime, arg.samples));
+      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<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "startMs")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "endMs")))) return false;
+      if (!JSIConverter<std::shared_ptr<ArrayBuffer>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "samples")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "react-native-nitro-onnx",
+  "version": "0.1.0",
+  "description": "React Native Nitro module wrapping sherpa-onnx for local ASR, TTS, VAD and voice cloning",
+  "license": "MIT",
+  "homepage": "https://github.com/zydbkqf/react-native-nitro-onnx",
+  "author": "Denis Cheung (https://github.com/zydbkqf)",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "source": "src/index.ts",
+  "scripts": {
+    "postinstall": "node scripts/prepare-sherpa-onnx.js",
+    "prespecs": "node scripts/prepare-sherpa-onnx.js",
+    "build": "tsc",
+    "specs": "nitrogen",
+    "test": "jest",
+    "test:cpp": "node scripts/test-cpp.js"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": ">=0.78.0",
+    "react-native-nitro-modules": ">=0.35.8"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "jest": "^29.7.0",
+    "jest-util": "^29.7.0",
+    "nitrogen": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": ">=0.35.8",
+    "ts-jest": "^29.1.0",
+    "typescript": "5.4.5"
+  },
+  "files": [
+    "src",
+    "!src/__tests__",
+    "!src/__mocks__",
+    "lib",
+    "!lib/__tests__",
+    "!lib/__mocks__",
+    "cpp",
+    "!cpp/tests",
+    "!cpp/build*",
+    "!cpp/sherpa-onnx-prebuilt",
+    "android",
+    "ios",
+    "assets",
+    "scripts",
+    "Package.swift",
+    "nitro.json",
+    "nitrogen",
+    "NitroOnnxSpeech.podspec",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "packageManager": "yarn@4.17.1"
+}

package/scripts/prepare-sherpa-onnx.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+// ------------------------------------------------------------------------------
+// Downloads the sherpa-onnx prebuilt trees needed by Android and iOS builds
+// into cpp/sherpa-onnx-prebuilt.
+//
+// The directory layout after a successful run is:
+//
+//   cpp/sherpa-onnx-prebuilt/
+//     include/sherpa-onnx/c-api/c-api.h
+//     lib/                          # host static libraries (optional)
+//     android/jniLibs/<abi>/        # Android shared libraries
+//     ios/SherpaOnnxC.xcframework/  # iOS device + simulator static archive
+//
+// Host libraries are only downloaded when running on the matching host
+// platform. Android and iOS trees are always fetched so that cross-platform
+// React Native builds can proceed without extra environment variables.
+// ------------------------------------------------------------------------------
+
+import { execFile } from "node:child_process";
+import { createWriteStream, existsSync, mkdirSync } from "node:fs";
+import fs from "node:fs/promises";
+import https from "node:https";
+import os from "node:os";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { promisify } from "node:util";
+
+const VERSION = "v1.13.7";
+const PREBUILT_DIR = path.join(process.cwd(), "cpp", "sherpa-onnx-prebuilt");
+const execFileAsync = promisify(execFile);
+
+function platformArchive() {
+  const platform = os.platform();
+  const arch = os.arch();
+  if (platform === "darwin" && arch === "arm64") {
+    return `sherpa-onnx-${VERSION}-osx-arm64-static-lib.tar.bz2`;
+  }
+  if (platform === "darwin" && arch === "x64") {
+    return `sherpa-onnx-${VERSION}-osx-x64-static-lib.tar.bz2`;
+  }
+  if (platform === "linux" && arch === "x64") {
+    return `sherpa-onnx-${VERSION}-linux-x64-static-lib.tar.bz2`;
+  }
+  if (platform === "linux" && arch === "arm64") {
+    return `sherpa-onnx-${VERSION}-linux-aarch64-static-lib.tar.bz2`;
+  }
+  if (platform === "win32" && arch === "x64") {
+    return `sherpa-onnx-${VERSION}-win-x64-static-MD-Release-lib.tar.bz2`;
+  }
+  if (platform === "win32" && arch === "arm64") {
+    return `sherpa-onnx-${VERSION}-win-arm64-static-MD-Release-lib.tar.bz2`;
+  }
+  return null;
+}
+
+function isHostLibPresent() {
+  const unixLib = path.join(PREBUILT_DIR, "lib", "libsherpa-onnx-c-api.a");
+  const windowsLib = path.join(PREBUILT_DIR, "lib", "sherpa-onnx-c-api.lib");
+  return existsSync(unixLib) || existsSync(windowsLib);
+}
+
+function isAndroidLibPresent() {
+  return existsSync(
+    path.join(PREBUILT_DIR, "android", "jniLibs", "arm64-v8a", "libsherpa-onnx-c-api.so")
+  );
+}
+
+function isIosFrameworkPresent() {
+  return existsSync(
+    path.join(PREBUILT_DIR, "ios", "SherpaOnnxC.xcframework", "Info.plist")
+  );
+}
+
+function isHeaderPresent() {
+  return existsSync(
+    path.join(PREBUILT_DIR, "include", "sherpa-onnx", "c-api", "c-api.h")
+  );
+}
+
+async function downloadFile(url, destination) {
+  const file = createWriteStream(destination);
+  await new Promise((resolve, reject) => {
+    https
+      .get(url, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          downloadFile(response.headers.location, destination).then(resolve).catch(reject);
+          return;
+        }
+        if (response.statusCode !== 200) {
+          reject(new Error(`Download failed for ${url}: ${response.statusCode}`));
+          return;
+        }
+        pipeline(response, file).then(resolve).catch(reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function extractTarBz2(archivePath, cwd, stripComponents = 1) {
+  // Use the system tar binary. Windows 10/11 ships tar.exe with bzip2 support.
+  await execFileAsync("tar", [
+    "-xjf",
+    archivePath,
+    "-C",
+    cwd,
+    `--strip-components=${stripComponents}`,
+  ]);
+}
+
+async function extractZip(archivePath, cwd) {
+  if (os.platform() === "win32") {
+    await execFileAsync("powershell", [
+      "-Command",
+      `Expand-Archive -Path "${archivePath}" -DestinationPath "${cwd}" -Force`,
+    ]);
+  } else {
+    await execFileAsync("unzip", ["-q", "-o", archivePath, "-d", cwd]);
+  }
+}
+
+async function downloadHeader() {
+  const includeDir = path.join(PREBUILT_DIR, "include", "sherpa-onnx", "c-api");
+  mkdirSync(includeDir, { recursive: true });
+
+  const url = `https://raw.githubusercontent.com/k2-fsa/sherpa-onnx/${VERSION}/sherpa-onnx/c-api/c-api.h`;
+  const destination = path.join(includeDir, "c-api.h");
+  console.log("Downloading sherpa-onnx C API header...");
+  await downloadFile(url, destination);
+}
+
+async function downloadHostLibs() {
+  const archive = platformArchive();
+  if (archive == null) {
+    console.log("Skipping host library download: unsupported host platform.");
+    return;
+  }
+
+  const url = `https://github.com/k2-fsa/sherpa-onnx/releases/download/${VERSION}/${archive}`;
+  const downloadPath = path.join(PREBUILT_DIR, archive);
+
+  console.log(`Downloading host sherpa-onnx prebuilt: ${archive}...`);
+  await downloadFile(url, downloadPath);
+
+  console.log("Extracting host archive...");
+  await extractTarBz2(downloadPath, PREBUILT_DIR, 1);
+  await fs.unlink(downloadPath);
+}
+
+async function downloadAndroidLibs() {
+  const archive = `sherpa-onnx-${VERSION}-android.tar.bz2`;
+  const url = `https://github.com/k2-fsa/sherpa-onnx/releases/download/${VERSION}/${archive}`;
+  const downloadPath = path.join(PREBUILT_DIR, archive);
+
+  console.log(`Downloading Android sherpa-onnx prebuilt: ${archive}...`);
+  await downloadFile(url, downloadPath);
+
+  // The archive contains a top-level jniLibs/ directory. Extract it to a
+  // temporary location and move it into android/jniLibs.
+  const tempDir = path.join(PREBUILT_DIR, `.android-tmp-${Date.now()}`);
+  mkdirSync(tempDir, { recursive: true });
+  console.log("Extracting Android archive...");
+  await extractTarBz2(downloadPath, tempDir, 0);
+
+  const sourceDir = path.join(tempDir, "jniLibs");
+  const targetDir = path.join(PREBUILT_DIR, "android", "jniLibs");
+  if (existsSync(targetDir)) {
+    await fs.rm(targetDir, { recursive: true, force: true });
+  }
+  mkdirSync(path.dirname(targetDir), { recursive: true });
+  await fs.rename(sourceDir, targetDir);
+  await fs.rm(tempDir, { recursive: true, force: true });
+  await fs.unlink(downloadPath);
+}
+
+async function downloadIosFramework() {
+  const archive = `sherpa-onnx-${VERSION}-ios-shared-onnxruntime-static.xcframework.zip`;
+  const url = `https://github.com/k2-fsa/sherpa-onnx/releases/download/xcframework/${archive}`;
+  const downloadPath = path.join(PREBUILT_DIR, archive);
+
+  console.log(`Downloading iOS sherpa-onnx prebuilt: ${archive}...`);
+  await downloadFile(url, downloadPath);
+
+  // The archive contains the xcframework at the top level. The
+  // ios-shared-onnxruntime-static variant names it SherpaOnnxC.xcframework
+  // (matching the inner framework name so CocoaPods generates correct linker
+  // flags). Extract to a temporary location and move it into ios/.
+  const tempDir = path.join(PREBUILT_DIR, `.ios-tmp-${Date.now()}`);
+  mkdirSync(tempDir, { recursive: true });
+  console.log("Extracting iOS archive...");
+  await extractZip(downloadPath, tempDir);
+
+  const targetDir = path.join(PREBUILT_DIR, "ios", "SherpaOnnxC.xcframework");
+  if (existsSync(targetDir)) {
+    await fs.rm(targetDir, { recursive: true, force: true });
+  }
+  mkdirSync(path.dirname(targetDir), { recursive: true });
+
+  const expectedName = path.join(tempDir, "SherpaOnnxC.xcframework");
+  const legacyName = path.join(tempDir, "sherpa-onnx.xcframework");
+  const sourceDir = existsSync(expectedName) ? expectedName : legacyName;
+
+  await fs.rename(sourceDir, targetDir);
+  await fs.rm(tempDir, { recursive: true, force: true });
+  await fs.unlink(downloadPath);
+}
+
+async function main() {
+  mkdirSync(PREBUILT_DIR, { recursive: true });
+
+  const tasks = [];
+  if (!isHeaderPresent()) {
+    tasks.push(downloadHeader());
+  }
+  if (!isHostLibPresent()) {
+    tasks.push(downloadHostLibs());
+  }
+  if (!isAndroidLibPresent()) {
+    tasks.push(downloadAndroidLibs());
+  }
+  if (!isIosFrameworkPresent()) {
+    tasks.push(downloadIosFramework());
+  }
+
+  if (tasks.length === 0) {
+    console.log("sherpa-onnx prebuilt tree is already present.");
+    return;
+  }
+
+  await Promise.all(tasks);
+  console.log(`sherpa-onnx prebuilt tree ready at ${PREBUILT_DIR}`);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/scripts/test-cpp.js

@@ -0,0 +1,24 @@
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const ROOT = path.resolve(__dirname, '..');
+const ANDROID_CMAKE_DIR = path.join(ROOT, 'android');
+const BUILD_DIR = path.join(ROOT, 'cpp', 'build-tests');
+
+function run(command, cwd) {
+  console.log(`[test-cpp] ${command}`);
+  execSync(command, { cwd, stdio: 'inherit' });
+}
+
+if (!fs.existsSync(BUILD_DIR)) {
+  fs.mkdirSync(BUILD_DIR, { recursive: true });
+}
+
+run(`cmake -S "${ANDROID_CMAKE_DIR}" -B "${BUILD_DIR}" -DBUILD_ONNX_SPEECH_TESTS=ON`, ROOT);
+run(`cmake --build "${BUILD_DIR}" --target NitroOnnxSpeechTests --parallel`, ROOT);
+run(`ctest --test-dir "${BUILD_DIR}" --output-on-failure`, ROOT);

package/src/index.ts

@@ -0,0 +1,45 @@
+// ------------------------------------------------------------------------------
+// Public entry point for react-native-nitro-onnx.
+// ------------------------------------------------------------------------------
+
+import { NitroModules } from "react-native-nitro-modules";
+import type { AudioFormat, OnnxSpeech } from "./specs/OnnxSpeech.nitro.js";
+
+export type {
+  AudioFormat,
+  Result,
+  VadConfig,
+  VadSegment,
+  VadEvents,
+  Vad,
+  AsrModelType,
+  AsrModelConfig,
+  AsrResult,
+  StreamingAsrEvents,
+  OfflineAsr,
+  StreamingAsr,
+  TtsModelType,
+  TtsModelConfig,
+  TtsResult,
+  Tts,
+  SpeakerEmbeddingConfig,
+  RegisteredSpeaker,
+  SpeakerManager,
+  OnnxSpeech,
+} from "./specs/OnnxSpeech.nitro.js";
+
+/**
+ * Get the shared OnnxSpeech Nitro module instance.
+ * Heavy AI models are loaded on demand and cached as singletons behind
+ * the individual hybrid objects (Vad, Asr, Tts, SpeakerManager).
+ */
+export function getOnnxSpeech(): OnnxSpeech {
+  return NitroModules.createHybridObject<OnnxSpeech>("NitroOnnxSpeech");
+}
+
+/** Default 16 kHz mono f32 PCM format used by every audio interface. */
+export const DEFAULT_AUDIO_FORMAT: AudioFormat = {
+  sampleRate: 16000,
+  channels: 1,
+  sampleFormat: "f32le",
+};