react-native-sherpa-onnx 0.1.0

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

@@ -0,0 +1,39 @@
+import type { InitializeOptions, ModelType } from '../types';
+/**
+ * STT-specific initialization options
+ */
+export interface STTInitializeOptions {
+    /**
+     * Model directory path configuration
+     */
+    modelPath: InitializeOptions['modelPath'];
+    /**
+     * Model quantization preference
+     * - true: Prefer int8 quantized models (model.int8.onnx) - smaller, faster
+     * - false: Prefer regular models (model.onnx) - higher accuracy
+     * - undefined: Try int8 first, then fall back to regular (default behavior)
+     */
+    preferInt8?: boolean;
+    /**
+     * Explicit model type specification for STT models
+     * - 'transducer': Force detection as Zipformer/Transducer model
+     * - 'paraformer': Force detection as Paraformer model
+     * - 'nemo_ctc': Force detection as NeMo CTC model
+     * - 'whisper': Force detection as Whisper model
+     * - 'wenet_ctc': Force detection as WeNet CTC model
+     * - 'sense_voice': Force detection as SenseVoice model
+     * - 'funasr_nano': Force detection as FunASR Nano model
+     * - 'auto': Automatic detection based on files (default)
+     */
+    modelType?: ModelType;
+}
+/**
+ * Transcription result
+ */
+export interface TranscriptionResult {
+    /**
+     * Transcribed text
+     */
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/stt/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/lib/typescript/src/tts/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Text-to-Speech (TTS) feature module
+ *
+ * @remarks
+ * This feature is not yet implemented. This module serves as a placeholder
+ * for future TTS functionality.
+ *
+ * @example
+ * ```typescript
+ * // Future usage:
+ * import { initializeTTS, synthesizeText } from 'react-native-sherpa-onnx/tts';
+ *
+ * await initializeTTS({ modelPath: 'models/tts-model' });
+ * const audioPath = await synthesizeText('Hello, world!');
+ * ```
+ */
+/**
+ * TTS initialization options (placeholder)
+ */
+export interface TTSInitializeOptions {
+    modelPath: string;
+}
+/**
+ * TTS synthesis result (placeholder)
+ */
+export interface SynthesisResult {
+    audioPath: string;
+}
+/**
+ * Initialize Text-to-Speech (TTS) with model directory.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function initializeTTS(_options: TTSInitializeOptions): Promise<void>;
+/**
+ * Synthesize text to speech audio.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function synthesizeText(_text: string): Promise<string>;
+/**
+ * Release TTS resources.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function unloadTTS(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/tts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;CAEnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;CAEnB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzC"}

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

@@ -0,0 +1,59 @@
+/**
+ * Model path configuration options
+ */
+export type ModelPathConfig = {
+    /**
+     * Path type: 'asset' - Model is bundled in app assets
+     * On iOS: Bundle path (e.g., "models/sherpa-onnx-model")
+     * On Android: Asset path (e.g., "models/sherpa-onnx-model")
+     */
+    type: 'asset';
+    path: string;
+} | {
+    /**
+     * Path type: 'file' - Model is in file system
+     * Absolute path to model directory
+     */
+    type: 'file';
+    path: string;
+} | {
+    /**
+     * Path type: 'auto' - Automatically detect path type
+     * Tries asset first, then file system
+     */
+    type: 'auto';
+    path: string;
+};
+/**
+ * Model type for explicit model detection
+ */
+export type ModelType = 'transducer' | 'paraformer' | 'nemo_ctc' | 'whisper' | 'wenet_ctc' | 'sense_voice' | 'funasr_nano' | 'auto';
+/**
+ * Model initialization options
+ */
+export interface InitializeOptions {
+    /**
+     * Model directory path configuration
+     */
+    modelPath: ModelPathConfig | string;
+    /**
+     * Model quantization preference
+     * - true: Prefer int8 quantized models (model.int8.onnx) - smaller, faster
+     * - false: Prefer regular models (model.onnx) - higher accuracy
+     * - undefined: Try int8 first, then fall back to regular (default behavior)
+     */
+    preferInt8?: boolean;
+    /**
+     * Explicit model type specification
+     * - 'transducer': Force detection as Zipformer/Transducer model
+     * - 'paraformer': Force detection as Paraformer model
+     * - 'nemo_ctc': Force detection as NeMo CTC model
+     * - 'whisper': Force detection as Whisper model
+     * - 'wenet_ctc': Force detection as WeNet CTC model
+     * - 'sense_voice': Force detection as SenseVoice model
+     * - 'funasr_nano': Force detection as FunASR Nano model
+     * - 'auto': Automatic detection based on files (default)
+     */
+    modelType?: ModelType;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IACE;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,WAAW,GACX,aAAa,GACb,aAAa,GACb,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,eAAe,GAAG,MAAM,CAAC;IAEpC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB"}

package/lib/typescript/src/utils.d.ts

@@ -0,0 +1,53 @@
+import type { ModelPathConfig } from './types';
+/**
+ * Utility functions for model path handling
+ */
+/**
+ * Predefined model identifiers
+ */
+export declare const MODELS: {
+    readonly ZIPFORMER_EN: "sherpa-onnx-zipformer-small-en";
+    readonly PARAFORMER_ZH: "sherpa-onnx-paraformer-zh-small";
+};
+export type ModelId = (typeof MODELS)[keyof typeof MODELS];
+/**
+ * Get the default model directory path for the current platform.
+ * This is a helper for apps that want to use a standard location.
+ *
+ * @returns Platform-specific default path
+ */
+export declare function getDefaultModelPath(): string;
+/**
+ * Create a model path configuration for asset models.
+ * Use this when models are bundled in your app's assets.
+ *
+ * @param assetPath - Path relative to assets (e.g., "models/sherpa-onnx-model")
+ * @returns Model path configuration
+ */
+export declare function assetModelPath(assetPath: string): ModelPathConfig;
+/**
+ * Create a model path configuration for file system models.
+ * Use this when models are downloaded or stored in file system.
+ *
+ * @param filePath - Absolute path to model directory
+ * @returns Model path configuration
+ */
+export declare function fileModelPath(filePath: string): ModelPathConfig;
+/**
+ * Create a model path configuration with auto-detection.
+ * Tries asset first, then file system.
+ *
+ * @param path - Path to try (will be checked as both asset and file)
+ * @returns Model path configuration
+ */
+export declare function autoModelPath(path: string): ModelPathConfig;
+/**
+ * Resolve model path based on configuration.
+ * This handles different path types (asset, file, auto) and returns
+ * a platform-specific absolute path that can be used by native code.
+ *
+ * @param config - Model path configuration or simple string path
+ * @returns Promise resolving to absolute path usable by native code
+ */
+export declare function resolveModelPath(config: ModelPathConfig | string): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

package/lib/typescript/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAKjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAK/D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAK3D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,GAAG,MAAM,GAC/B,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/lib/typescript/src/vad/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Voice Activity Detection (VAD) feature module
+ *
+ * @remarks
+ * This feature is not yet implemented. This module serves as a placeholder
+ * for future VAD functionality.
+ *
+ * @example
+ * ```typescript
+ * // Future usage:
+ * import { initializeVAD, detectVoiceActivity } from 'react-native-sherpa-onnx/vad';
+ *
+ * await initializeVAD({ modelPath: 'models/vad-model' });
+ * const segments = await detectVoiceActivity('path/to/audio.wav');
+ * ```
+ */
+/**
+ * VAD initialization options (placeholder)
+ */
+export interface VADInitializeOptions {
+    modelPath: string;
+}
+/**
+ * Voice activity segment
+ */
+export interface VoiceSegment {
+    start: number;
+    end: number;
+}
+/**
+ * Initialize Voice Activity Detection (VAD) with model directory.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function initializeVAD(_options: VADInitializeOptions): Promise<void>;
+/**
+ * Detect voice activity in an audio file.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function detectVoiceActivity(_filePath: string): Promise<VoiceSegment[]>;
+/**
+ * Release VAD resources.
+ *
+ * @throws {Error} Not yet implemented
+ */
+export declare function unloadVAD(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/vad/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vad/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;CAEnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CAEb;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzC"}

package/package.json

@@ -0,0 +1,221 @@
+{
+  "name": "react-native-sherpa-onnx",
+  "version": "0.1.0",
+  "description": "Offline Speech-to-text, text-to-speech, speaker diarization, speech enhancement, source separation, and VAD with sherpa-onnx for React NativeSpeech-to-Text with sherpa-onnx for React Native",
+  "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"
+    },
+    "./stt": {
+      "source": "./src/stt/index.ts",
+      "types": "./lib/typescript/src/stt/index.d.ts",
+      "default": "./lib/module/stt/index.js"
+    },
+    "./tts": {
+      "source": "./src/tts/index.ts",
+      "types": "./lib/typescript/src/tts/index.d.ts",
+      "default": "./lib/module/tts/index.js"
+    },
+    "./vad": {
+      "source": "./src/vad/index.ts",
+      "types": "./lib/typescript/src/vad/index.d.ts",
+      "default": "./lib/module/vad/index.js"
+    },
+    "./diarization": {
+      "source": "./src/diarization/index.ts",
+      "types": "./lib/typescript/src/diarization/index.d.ts",
+      "default": "./lib/module/diarization/index.js"
+    },
+    "./enhancement": {
+      "source": "./src/enhancement/index.ts",
+      "types": "./lib/typescript/src/enhancement/index.d.ts",
+      "default": "./lib/module/enhancement/index.js"
+    },
+    "./separation": {
+      "source": "./src/separation/index.ts",
+      "types": "./lib/typescript/src/separation/index.d.ts",
+      "default": "./lib/module/separation/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "scripts/**",
+    "scripts/**/*",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*",
+    "!./sherpa-onnx",
+    "!./sherpa-onnx/**",
+    "!ios/Frameworks/.gitkeep"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-sherpa-onnx-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "copy-headers": "node scripts/copy-headers.js",
+    "download-ios-framework": "bash scripts/setup-ios-framework.sh",
+    "setup-assets": "node scripts/setup-assets.js",
+    "postinstall": "node scripts/setup-assets.js",
+    "prepublishOnly": "yarn copy-headers",
+    "prepack": "yarn copy-headers",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint --ignore-pattern \"sherpa-onnx/**\" \"**/*.{js,ts,tsx}\"",
+    "prettier": "npx prettier --write \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "verdaccio:start": "VERDACCIO_BODY_SIZE_LIMIT=100mb verdaccio --config verdaccio.config.yaml",
+    "registry:local": "node scripts/switch-registry.js local",
+    "registry:public": "node scripts/switch-registry.js public",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XDcobra/react-native-sherpa-onnx.git"
+  },
+  "author": "XDcobra <xdcobra11@gmail.com> (https://github.com/XDcobra)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/XDcobra/react-native-sherpa-onnx/issues"
+  },
+  "homepage": "https://github.com/XDcobra/react-native-sherpa-onnx#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.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",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "SherpaOnnxSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.sherpaonnx"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ],
+    "rules": {
+      "header-max-length": [
+        2,
+        "always",
+        300
+      ]
+    }
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.0"
+  }
+}

package/scripts/copy-headers.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+
+/**
+ * Script to copy sherpa-onnx header files to Android and iOS include directories.
+ * This ensures that the headers are available when the package is published to npm,
+ * even if the git submodule is not initialized.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const SOURCE_DIR = path.join(
+  __dirname,
+  '..',
+  'sherpa-onnx',
+  'sherpa-onnx',
+  'c-api'
+);
+const ANDROID_DEST_DIR = path.join(
+  __dirname,
+  '..',
+  'android',
+  'src',
+  'main',
+  'cpp',
+  'include',
+  'sherpa-onnx',
+  'c-api'
+);
+const IOS_DEST_DIR = path.join(
+  __dirname,
+  '..',
+  'ios',
+  'include',
+  'sherpa-onnx',
+  'c-api'
+);
+
+const HEADER_FILES = ['c-api.h', 'cxx-api.h'];
+
+// C++ API implementation file needed for iOS (compiles the C++ wrapper around C API)
+const CXX_IMPL_FILE = 'cxx-api.cc';
+const IOS_ROOT_DIR = path.join(__dirname, '..', 'ios');
+
+function ensureDirectoryExists(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+    console.log(`Created directory: ${dirPath}`);
+  }
+}
+
+function copyFile(source, destination) {
+  try {
+    fs.copyFileSync(source, destination);
+    console.log(
+      `Copied: ${path.basename(source)} -> ${path.relative(
+        process.cwd(),
+        destination
+      )}`
+    );
+    return true;
+  } catch (error) {
+    console.error(`Failed to copy ${source}:`, error.message);
+    return false;
+  }
+}
+
+function areHeadersAlreadyPresent() {
+  // Check if all critical headers are already in the destination directories
+  const requiredFiles = [
+    path.join(ANDROID_DEST_DIR, 'c-api.h'),
+    path.join(IOS_DEST_DIR, 'c-api.h'),
+    path.join(IOS_DEST_DIR, 'cxx-api.h'),
+  ];
+
+  return requiredFiles.every((file) => fs.existsSync(file));
+}
+
+function main() {
+  console.log('Checking sherpa-onnx header files...\n');
+
+  // Check if headers are already present (e.g., from npm package)
+  if (areHeadersAlreadyPresent()) {
+    console.log('Header files already present, skipping copy.');
+    console.log('  Android: android/src/main/cpp/include/sherpa-onnx/c-api/');
+    console.log('  iOS:     ios/include/sherpa-onnx/c-api/');
+    return;
+  }
+
+  console.log(
+    'Header files not found, attempting to copy from git submodule...\n'
+  );
+
+  // Check if source directory exists
+  if (!fs.existsSync(SOURCE_DIR)) {
+    console.error(`Error: Source directory not found: ${SOURCE_DIR}`);
+    console.error('Possible causes:');
+    console.error('  1. Git submodule is not initialized');
+    console.error(
+      '  2. You are using an npm package (headers should already be included)'
+    );
+    console.error('');
+    console.error('Solutions:');
+    console.error(
+      '  • Initialize submodule: git submodule update --init --recursive'
+    );
+    console.error(
+      '  • Check if headers exist in ios/include/ or android/.../include/'
+    );
+    process.exit(1);
+  }
+
+  // Ensure destination directories exist
+  ensureDirectoryExists(ANDROID_DEST_DIR);
+  ensureDirectoryExists(IOS_DEST_DIR);
+
+  let successCount = 0;
+  let failCount = 0;
+
+  // Copy header files to Android
+  console.log('Copying to Android...');
+  for (const headerFile of HEADER_FILES) {
+    const source = path.join(SOURCE_DIR, headerFile);
+    const destination = path.join(ANDROID_DEST_DIR, headerFile);
+
+    if (!fs.existsSync(source)) {
+      console.error(`Source file not found: ${source}`);
+      failCount++;
+      continue;
+    }
+
+    if (copyFile(source, destination)) {
+      successCount++;
+    } else {
+      failCount++;
+    }
+  }
+
+  // Copy header files to iOS
+  console.log('\nCopying to iOS...');
+  for (const headerFile of HEADER_FILES) {
+    const source = path.join(SOURCE_DIR, headerFile);
+    const destination = path.join(IOS_DEST_DIR, headerFile);
+
+    if (!fs.existsSync(source)) {
+      console.error(`Source file not found: ${source}`);
+      failCount++;
+      continue;
+    }
+
+    if (copyFile(source, destination)) {
+      successCount++;
+    } else {
+      failCount++;
+    }
+  }
+
+  // Copy C++ API implementation to iOS root (needed for compilation)
+  console.log('\nCopying C++ API implementation to iOS...');
+  const cxxImplSource = path.join(SOURCE_DIR, CXX_IMPL_FILE);
+  const cxxImplDest = path.join(IOS_ROOT_DIR, CXX_IMPL_FILE);
+
+  if (!fs.existsSync(cxxImplSource)) {
+    console.error(`Source file not found: ${cxxImplSource}`);
+    failCount++;
+  } else if (copyFile(cxxImplSource, cxxImplDest)) {
+    successCount++;
+  } else {
+    failCount++;
+  }
+
+  console.log(`\n${'='.repeat(50)}`);
+  console.log(
+    `Summary: ${successCount} files copied successfully, ${failCount} failed`
+  );
+
+  if (failCount > 0) {
+    process.exit(1);
+  } else {
+    console.log('All header files copied successfully!');
+  }
+}
+
+main();