whisper-coreml 0.2.0

package/dist/index.cjs

@@ -0,0 +1,243 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  WHISPER_MODEL: () => WHISPER_MODEL,
+  WhisperAsrEngine: () => WhisperAsrEngine,
+  downloadModel: () => downloadModel,
+  formatBytes: () => formatBytes,
+  getDefaultModelDir: () => getDefaultModelDir,
+  getLoadError: () => getLoadError,
+  getModelPath: () => getModelPath,
+  isAvailable: () => isAvailable,
+  isModelDownloaded: () => isModelDownloaded
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/download.ts
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var WHISPER_MODEL = {
+  name: "large-v3-turbo",
+  size: "1.5 GB",
+  languages: "99 languages",
+  url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin"
+};
+function getDefaultModelDir() {
+  return (0, import_node_path.join)((0, import_node_os.homedir)(), ".cache", "whisper-coreml", "models");
+}
+function getModelPath(modelDir) {
+  const dir = modelDir ?? getDefaultModelDir();
+  return (0, import_node_path.join)(dir, `ggml-${WHISPER_MODEL.name}.bin`);
+}
+function isModelDownloaded(modelDir) {
+  const modelPath = getModelPath(modelDir);
+  return (0, import_node_fs.existsSync)(modelPath);
+}
+async function downloadModel(options = {}) {
+  const modelDir = options.modelDir ?? getDefaultModelDir();
+  const modelPath = getModelPath(modelDir);
+  if (!options.force && (0, import_node_fs.existsSync)(modelPath)) {
+    return modelPath;
+  }
+  if ((0, import_node_fs.existsSync)(modelPath)) {
+    (0, import_node_fs.rmSync)(modelPath);
+  }
+  (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(modelPath), { recursive: true });
+  console.log(`Downloading Whisper ${WHISPER_MODEL.name} (${WHISPER_MODEL.size})...`);
+  console.log(`Source: ${WHISPER_MODEL.url}`);
+  console.log(`Target: ${modelPath}`);
+  const response = await fetch(WHISPER_MODEL.url);
+  if (!response.ok) {
+    throw new Error(`Failed to download model: ${response.statusText}`);
+  }
+  const contentLength = response.headers.get("content-length");
+  const totalBytes = contentLength ? parseInt(contentLength, 10) : 0;
+  const reader = response.body?.getReader();
+  if (!reader) {
+    throw new Error("Failed to get response body reader");
+  }
+  const chunks = [];
+  let downloadedBytes = 0;
+  while (true) {
+    const result = await reader.read();
+    if (result.done) {
+      break;
+    }
+    const chunk = result.value;
+    chunks.push(chunk);
+    downloadedBytes += chunk.length;
+    const percent = totalBytes > 0 ? Math.round(downloadedBytes / totalBytes * 100) : 0;
+    if (options.onProgress) {
+      options.onProgress({
+        downloadedBytes,
+        totalBytes,
+        percent
+      });
+    }
+    process.stdout.write(
+      `\rProgress: ${String(percent)}% (${formatBytes(downloadedBytes)}/${formatBytes(totalBytes)})`
+    );
+  }
+  const buffer = Buffer.concat(chunks);
+  (0, import_node_fs.writeFileSync)(modelPath, buffer);
+  console.log("\n\u2713 Model downloaded successfully!");
+  return modelPath;
+}
+function formatBytes(bytes) {
+  if (bytes < 1024) {
+    return `${String(bytes)} B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+  if (bytes < 1024 * 1024 * 1024) {
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+  }
+  return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+
+// src/index.ts
+var bindingsModule = require("bindings");
+function loadAddon() {
+  if (process.platform !== "darwin") {
+    throw new Error("whisper-coreml is only supported on macOS");
+  }
+  try {
+    return bindingsModule("whisper_asr");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to load Whisper ASR native addon: ${message}`);
+  }
+}
+var addon = null;
+var loadError = null;
+function getAddon() {
+  if (!addon) {
+    try {
+      addon = loadAddon();
+    } catch (error) {
+      loadError = error instanceof Error ? error : new Error(String(error));
+      throw error;
+    }
+  }
+  return addon;
+}
+function isAvailable() {
+  return process.platform === "darwin" && process.arch === "arm64";
+}
+function getLoadError() {
+  return loadError;
+}
+var WhisperAsrEngine = class {
+  options;
+  initialized = false;
+  constructor(options) {
+    this.options = options;
+  }
+  /* v8 ignore start - native addon calls, tested via E2E */
+  /**
+   * Initialize the Whisper engine
+   * This loads the model into memory - may take a few seconds.
+   */
+  initialize() {
+    if (this.initialized) {
+      return Promise.resolve();
+    }
+    const nativeAddon = getAddon();
+    const success = nativeAddon.initialize({
+      modelPath: this.options.modelPath,
+      language: this.options.language ?? "auto",
+      translate: this.options.translate ?? false,
+      threads: this.options.threads ?? 0
+    });
+    if (!success) {
+      return Promise.reject(new Error("Failed to initialize Whisper engine"));
+    }
+    this.initialized = true;
+    return Promise.resolve();
+  }
+  /**
+   * Check if the engine is ready for transcription
+   */
+  isReady() {
+    if (!this.initialized) {
+      return false;
+    }
+    try {
+      return getAddon().isInitialized();
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Transcribe audio samples
+   *
+   * @param samples - Float32Array of audio samples (mono, 16kHz)
+   * @param sampleRate - Sample rate in Hz (default: 16000)
+   * @returns Transcription result with text and segments
+   */
+  transcribe(samples, sampleRate = 16e3) {
+    if (!this.initialized) {
+      return Promise.reject(new Error("Whisper engine not initialized. Call initialize() first."));
+    }
+    const result = getAddon().transcribe(samples, sampleRate);
+    return Promise.resolve({
+      text: result.text,
+      language: result.language,
+      durationMs: result.durationMs,
+      segments: result.segments
+    });
+  }
+  /**
+   * Clean up resources and unload the model
+   */
+  cleanup() {
+    if (this.initialized) {
+      try {
+        getAddon().cleanup();
+      } catch {
+      }
+      this.initialized = false;
+    }
+  }
+  /**
+   * Get version information
+   */
+  getVersion() {
+    return getAddon().getVersion();
+  }
+  /* v8 ignore stop */
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WHISPER_MODEL,
+  WhisperAsrEngine,
+  downloadModel,
+  formatBytes,
+  getDefaultModelDir,
+  getLoadError,
+  getModelPath,
+  isAvailable,
+  isModelDownloaded
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/download.ts"],"sourcesContent":["/**\n * whisper-coreml\n *\n * OpenAI Whisper ASR for Node.js with CoreML/ANE acceleration on Apple Silicon.\n * Based on whisper.cpp with Apple Neural Engine support.\n *\n * Uses the large-v3-turbo model exclusively, as it offers the best speed/quality\n * ratio and is the main reason to choose Whisper over Parakeet.\n */\n\n// Dynamic require for loading native addon (works in both ESM and CJS)\n// eslint-disable-next-line @typescript-eslint/no-require-imports\nconst bindingsModule = require(\"bindings\") as (name: string) => unknown\n\n/**\n * Native addon interface\n */\ninterface NativeAddon {\n  initialize(options: {\n    modelPath: string\n    language?: string\n    translate?: boolean\n    threads?: number\n  }): boolean\n  isInitialized(): boolean\n  transcribe(samples: Float32Array, sampleRate: number): NativeTranscriptionResult\n  cleanup(): void\n  getVersion(): { addon: string; whisper: string; coreml: string }\n}\n\ninterface NativeTranscriptionResult {\n  text: string\n  language: string\n  durationMs: number\n  segments: {\n    startMs: number\n    endMs: number\n    text: string\n    confidence: number\n  }[]\n}\n\n/* v8 ignore start - platform checks and native addon loading */\n\n/**\n * Load the native addon\n */\nfunction loadAddon(): NativeAddon {\n  if (process.platform !== \"darwin\") {\n    throw new Error(\"whisper-coreml is only supported on macOS\")\n  }\n\n  try {\n    return bindingsModule(\"whisper_asr\") as NativeAddon\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    throw new Error(`Failed to load Whisper ASR native addon: ${message}`)\n  }\n}\n\n/* v8 ignore stop */\n\nlet addon: NativeAddon | null = null\nlet loadError: Error | null = null\n\nfunction getAddon(): NativeAddon {\n  if (!addon) {\n    try {\n      addon = loadAddon()\n    } catch (error) {\n      loadError = error instanceof Error ? error : new Error(String(error))\n      throw error\n    }\n  }\n  return addon\n}\n\n/**\n * Check if Whisper ASR is available on this platform\n */\nexport function isAvailable(): boolean {\n  return process.platform === \"darwin\" && process.arch === \"arm64\"\n}\n\n/**\n * Get the load error if the addon failed to load\n */\nexport function getLoadError(): Error | null {\n  return loadError\n}\n\n/**\n * Transcription segment with timestamps\n */\nexport interface TranscriptionSegment {\n  /** Start time in milliseconds */\n  startMs: number\n  /** End time in milliseconds */\n  endMs: number\n  /** Transcribed text for this segment */\n  text: string\n  /** Confidence score (0-1) */\n  confidence: number\n}\n\n/**\n * Transcription result\n */\nexport interface TranscriptionResult {\n  /** Full transcribed text */\n  text: string\n  /** Detected or specified language (ISO code) */\n  language: string\n  /** Processing time in milliseconds */\n  durationMs: number\n  /** Individual segments with timestamps */\n  segments: TranscriptionSegment[]\n}\n\n/**\n * Whisper ASR engine options\n */\nexport interface WhisperAsrOptions {\n  /** Path to the Whisper model file (ggml format) */\n  modelPath: string\n  /** Language code (e.g., \"en\", \"de\", \"fr\") or \"auto\" for auto-detection */\n  language?: string\n  /** Translate to English (default: false) */\n  translate?: boolean\n  /** Number of threads (0 = auto) */\n  threads?: number\n}\n\n/**\n * Whisper ASR Engine with CoreML acceleration\n *\n * Uses the large-v3-turbo model for best speed/quality balance.\n *\n * @example\n * ```typescript\n * import { WhisperAsrEngine, getModelPath } from \"whisper-coreml\"\n *\n * const engine = new WhisperAsrEngine({\n *   modelPath: getModelPath()\n * })\n *\n * await engine.initialize()\n * const result = await engine.transcribe(audioSamples, 16000)\n * console.log(result.text)\n * ```\n */\nexport class WhisperAsrEngine {\n  private options: WhisperAsrOptions\n  private initialized = false\n\n  constructor(options: WhisperAsrOptions) {\n    this.options = options\n  }\n\n  /* v8 ignore start - native addon calls, tested via E2E */\n\n  /**\n   * Initialize the Whisper engine\n   * This loads the model into memory - may take a few seconds.\n   */\n  initialize(): Promise<void> {\n    if (this.initialized) {\n      return Promise.resolve()\n    }\n\n    const nativeAddon = getAddon()\n    const success = nativeAddon.initialize({\n      modelPath: this.options.modelPath,\n      language: this.options.language ?? \"auto\",\n      translate: this.options.translate ?? false,\n      threads: this.options.threads ?? 0\n    })\n\n    if (!success) {\n      return Promise.reject(new Error(\"Failed to initialize Whisper engine\"))\n    }\n\n    this.initialized = true\n    return Promise.resolve()\n  }\n\n  /**\n   * Check if the engine is ready for transcription\n   */\n  isReady(): boolean {\n    if (!this.initialized) {\n      return false\n    }\n    try {\n      return getAddon().isInitialized()\n    } catch {\n      return false\n    }\n  }\n\n  /**\n   * Transcribe audio samples\n   *\n   * @param samples - Float32Array of audio samples (mono, 16kHz)\n   * @param sampleRate - Sample rate in Hz (default: 16000)\n   * @returns Transcription result with text and segments\n   */\n  transcribe(samples: Float32Array, sampleRate = 16000): Promise<TranscriptionResult> {\n    if (!this.initialized) {\n      return Promise.reject(new Error(\"Whisper engine not initialized. Call initialize() first.\"))\n    }\n\n    const result = getAddon().transcribe(samples, sampleRate)\n\n    return Promise.resolve({\n      text: result.text,\n      language: result.language,\n      durationMs: result.durationMs,\n      segments: result.segments\n    })\n  }\n\n  /**\n   * Clean up resources and unload the model\n   */\n  cleanup(): void {\n    if (this.initialized) {\n      try {\n        getAddon().cleanup()\n      } catch {\n        // Ignore cleanup errors\n      }\n      this.initialized = false\n    }\n  }\n\n  /**\n   * Get version information\n   */\n  getVersion(): { addon: string; whisper: string; coreml: string } {\n    return getAddon().getVersion()\n  }\n\n  /* v8 ignore stop */\n}\n\n// Re-export download utilities\nexport {\n  downloadModel,\n  formatBytes,\n  getDefaultModelDir,\n  getModelPath,\n  isModelDownloaded,\n  WHISPER_MODEL,\n  type DownloadOptions\n} from \"./download.js\"\n","/**\n * Model download functionality for whisper-coreml\n *\n * Note: We only support large-v3-turbo as it's the only Whisper model\n * that offers better quality than Parakeet while maintaining reasonable speed.\n */\n\nimport { existsSync, mkdirSync, writeFileSync, rmSync } from \"node:fs\"\nimport { homedir } from \"node:os\"\nimport { join, dirname } from \"node:path\"\n\n/**\n * Whisper large-v3-turbo model info\n * This is the only model we support as it offers the best speed/quality ratio\n * and is the main reason to choose Whisper over Parakeet.\n */\nexport const WHISPER_MODEL = {\n  name: \"large-v3-turbo\",\n  size: \"1.5 GB\",\n  languages: \"99 languages\",\n  url: \"https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin\"\n} as const\n\n/**\n * Default model directory in user's cache\n */\nexport function getDefaultModelDir(): string {\n  return join(homedir(), \".cache\", \"whisper-coreml\", \"models\")\n}\n\n/**\n * Get the path to the model\n */\nexport function getModelPath(modelDir?: string): string {\n  const dir = modelDir ?? getDefaultModelDir()\n  return join(dir, `ggml-${WHISPER_MODEL.name}.bin`)\n}\n\n/**\n * Check if the model is downloaded\n */\nexport function isModelDownloaded(modelDir?: string): boolean {\n  const modelPath = getModelPath(modelDir)\n  return existsSync(modelPath)\n}\n\ninterface DownloadProgress {\n  downloadedBytes: number\n  totalBytes: number\n  percent: number\n}\n\nexport interface DownloadOptions {\n  /** Target directory for model (default: ~/.cache/whisper-coreml/models) */\n  modelDir?: string\n\n  /** Progress callback */\n  onProgress?: (progress: DownloadProgress) => void\n\n  /** Force re-download even if model exists */\n  force?: boolean\n}\n\n/* v8 ignore start - network I/O */\n\n/**\n * Download the Whisper large-v3-turbo model from Hugging Face\n */\nexport async function downloadModel(options: DownloadOptions = {}): Promise<string> {\n  const modelDir = options.modelDir ?? getDefaultModelDir()\n  const modelPath = getModelPath(modelDir)\n\n  if (!options.force && existsSync(modelPath)) {\n    return modelPath\n  }\n\n  // Clean up partial downloads\n  if (existsSync(modelPath)) {\n    rmSync(modelPath)\n  }\n\n  mkdirSync(dirname(modelPath), { recursive: true })\n\n  console.log(`Downloading Whisper ${WHISPER_MODEL.name} (${WHISPER_MODEL.size})...`)\n  console.log(`Source: ${WHISPER_MODEL.url}`)\n  console.log(`Target: ${modelPath}`)\n\n  const response = await fetch(WHISPER_MODEL.url)\n  if (!response.ok) {\n    throw new Error(`Failed to download model: ${response.statusText}`)\n  }\n\n  const contentLength = response.headers.get(\"content-length\")\n  const totalBytes = contentLength ? parseInt(contentLength, 10) : 0\n\n  const reader = response.body?.getReader()\n  if (!reader) {\n    throw new Error(\"Failed to get response body reader\")\n  }\n\n  const chunks: Uint8Array[] = []\n  let downloadedBytes = 0\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  while (true) {\n    const result = await reader.read()\n    if (result.done) {\n      break\n    }\n\n    const chunk = result.value as Uint8Array\n    chunks.push(chunk)\n    downloadedBytes += chunk.length\n\n    const percent = totalBytes > 0 ? Math.round((downloadedBytes / totalBytes) * 100) : 0\n\n    if (options.onProgress) {\n      options.onProgress({\n        downloadedBytes,\n        totalBytes,\n        percent\n      })\n    }\n\n    // Progress indicator\n    process.stdout.write(\n      `\\rProgress: ${String(percent)}% (${formatBytes(downloadedBytes)}/${formatBytes(totalBytes)})`\n    )\n  }\n\n  // Combine chunks and write to file\n  const buffer = Buffer.concat(chunks)\n  writeFileSync(modelPath, buffer)\n\n  console.log(\"\\n✓ Model downloaded successfully!\")\n  return modelPath\n}\n\n/* v8 ignore stop */\n\n/**\n * Format bytes to human readable string\n * @internal Exported for testing\n */\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) {\n    return `${String(bytes)} B`\n  }\n  if (bytes < 1024 * 1024) {\n    return `${(bytes / 1024).toFixed(1)} KB`\n  }\n  if (bytes < 1024 * 1024 * 1024) {\n    return `${(bytes / 1024 / 1024).toFixed(1)} MB`\n  }\n  return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,162 @@
+/**
+ * Model download functionality for whisper-coreml
+ *
+ * Note: We only support large-v3-turbo as it's the only Whisper model
+ * that offers better quality than Parakeet while maintaining reasonable speed.
+ */
+/**
+ * Whisper large-v3-turbo model info
+ * This is the only model we support as it offers the best speed/quality ratio
+ * and is the main reason to choose Whisper over Parakeet.
+ */
+declare const WHISPER_MODEL: {
+    readonly name: "large-v3-turbo";
+    readonly size: "1.5 GB";
+    readonly languages: "99 languages";
+    readonly url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin";
+};
+/**
+ * Default model directory in user's cache
+ */
+declare function getDefaultModelDir(): string;
+/**
+ * Get the path to the model
+ */
+declare function getModelPath(modelDir?: string): string;
+/**
+ * Check if the model is downloaded
+ */
+declare function isModelDownloaded(modelDir?: string): boolean;
+interface DownloadProgress {
+    downloadedBytes: number;
+    totalBytes: number;
+    percent: number;
+}
+interface DownloadOptions {
+    /** Target directory for model (default: ~/.cache/whisper-coreml/models) */
+    modelDir?: string;
+    /** Progress callback */
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Force re-download even if model exists */
+    force?: boolean;
+}
+/**
+ * Download the Whisper large-v3-turbo model from Hugging Face
+ */
+declare function downloadModel(options?: DownloadOptions): Promise<string>;
+/**
+ * Format bytes to human readable string
+ * @internal Exported for testing
+ */
+declare function formatBytes(bytes: number): string;
+
+/**
+ * whisper-coreml
+ *
+ * OpenAI Whisper ASR for Node.js with CoreML/ANE acceleration on Apple Silicon.
+ * Based on whisper.cpp with Apple Neural Engine support.
+ *
+ * Uses the large-v3-turbo model exclusively, as it offers the best speed/quality
+ * ratio and is the main reason to choose Whisper over Parakeet.
+ */
+/**
+ * Check if Whisper ASR is available on this platform
+ */
+declare function isAvailable(): boolean;
+/**
+ * Get the load error if the addon failed to load
+ */
+declare function getLoadError(): Error | null;
+/**
+ * Transcription segment with timestamps
+ */
+interface TranscriptionSegment {
+    /** Start time in milliseconds */
+    startMs: number;
+    /** End time in milliseconds */
+    endMs: number;
+    /** Transcribed text for this segment */
+    text: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Transcription result
+ */
+interface TranscriptionResult {
+    /** Full transcribed text */
+    text: string;
+    /** Detected or specified language (ISO code) */
+    language: string;
+    /** Processing time in milliseconds */
+    durationMs: number;
+    /** Individual segments with timestamps */
+    segments: TranscriptionSegment[];
+}
+/**
+ * Whisper ASR engine options
+ */
+interface WhisperAsrOptions {
+    /** Path to the Whisper model file (ggml format) */
+    modelPath: string;
+    /** Language code (e.g., "en", "de", "fr") or "auto" for auto-detection */
+    language?: string;
+    /** Translate to English (default: false) */
+    translate?: boolean;
+    /** Number of threads (0 = auto) */
+    threads?: number;
+}
+/**
+ * Whisper ASR Engine with CoreML acceleration
+ *
+ * Uses the large-v3-turbo model for best speed/quality balance.
+ *
+ * @example
+ * ```typescript
+ * import { WhisperAsrEngine, getModelPath } from "whisper-coreml"
+ *
+ * const engine = new WhisperAsrEngine({
+ *   modelPath: getModelPath()
+ * })
+ *
+ * await engine.initialize()
+ * const result = await engine.transcribe(audioSamples, 16000)
+ * console.log(result.text)
+ * ```
+ */
+declare class WhisperAsrEngine {
+    private options;
+    private initialized;
+    constructor(options: WhisperAsrOptions);
+    /**
+     * Initialize the Whisper engine
+     * This loads the model into memory - may take a few seconds.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the engine is ready for transcription
+     */
+    isReady(): boolean;
+    /**
+     * Transcribe audio samples
+     *
+     * @param samples - Float32Array of audio samples (mono, 16kHz)
+     * @param sampleRate - Sample rate in Hz (default: 16000)
+     * @returns Transcription result with text and segments
+     */
+    transcribe(samples: Float32Array, sampleRate?: number): Promise<TranscriptionResult>;
+    /**
+     * Clean up resources and unload the model
+     */
+    cleanup(): void;
+    /**
+     * Get version information
+     */
+    getVersion(): {
+        addon: string;
+        whisper: string;
+        coreml: string;
+    };
+}
+
+export { type DownloadOptions, type TranscriptionResult, type TranscriptionSegment, WHISPER_MODEL, WhisperAsrEngine, type WhisperAsrOptions, downloadModel, formatBytes, getDefaultModelDir, getLoadError, getModelPath, isAvailable, isModelDownloaded };

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Model download functionality for whisper-coreml
+ *
+ * Note: We only support large-v3-turbo as it's the only Whisper model
+ * that offers better quality than Parakeet while maintaining reasonable speed.
+ */
+/**
+ * Whisper large-v3-turbo model info
+ * This is the only model we support as it offers the best speed/quality ratio
+ * and is the main reason to choose Whisper over Parakeet.
+ */
+declare const WHISPER_MODEL: {
+    readonly name: "large-v3-turbo";
+    readonly size: "1.5 GB";
+    readonly languages: "99 languages";
+    readonly url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin";
+};
+/**
+ * Default model directory in user's cache
+ */
+declare function getDefaultModelDir(): string;
+/**
+ * Get the path to the model
+ */
+declare function getModelPath(modelDir?: string): string;
+/**
+ * Check if the model is downloaded
+ */
+declare function isModelDownloaded(modelDir?: string): boolean;
+interface DownloadProgress {
+    downloadedBytes: number;
+    totalBytes: number;
+    percent: number;
+}
+interface DownloadOptions {
+    /** Target directory for model (default: ~/.cache/whisper-coreml/models) */
+    modelDir?: string;
+    /** Progress callback */
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Force re-download even if model exists */
+    force?: boolean;
+}
+/**
+ * Download the Whisper large-v3-turbo model from Hugging Face
+ */
+declare function downloadModel(options?: DownloadOptions): Promise<string>;
+/**
+ * Format bytes to human readable string
+ * @internal Exported for testing
+ */
+declare function formatBytes(bytes: number): string;
+
+/**
+ * whisper-coreml
+ *
+ * OpenAI Whisper ASR for Node.js with CoreML/ANE acceleration on Apple Silicon.
+ * Based on whisper.cpp with Apple Neural Engine support.
+ *
+ * Uses the large-v3-turbo model exclusively, as it offers the best speed/quality
+ * ratio and is the main reason to choose Whisper over Parakeet.
+ */
+/**
+ * Check if Whisper ASR is available on this platform
+ */
+declare function isAvailable(): boolean;
+/**
+ * Get the load error if the addon failed to load
+ */
+declare function getLoadError(): Error | null;
+/**
+ * Transcription segment with timestamps
+ */
+interface TranscriptionSegment {
+    /** Start time in milliseconds */
+    startMs: number;
+    /** End time in milliseconds */
+    endMs: number;
+    /** Transcribed text for this segment */
+    text: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Transcription result
+ */
+interface TranscriptionResult {
+    /** Full transcribed text */
+    text: string;
+    /** Detected or specified language (ISO code) */
+    language: string;
+    /** Processing time in milliseconds */
+    durationMs: number;
+    /** Individual segments with timestamps */
+    segments: TranscriptionSegment[];
+}
+/**
+ * Whisper ASR engine options
+ */
+interface WhisperAsrOptions {
+    /** Path to the Whisper model file (ggml format) */
+    modelPath: string;
+    /** Language code (e.g., "en", "de", "fr") or "auto" for auto-detection */
+    language?: string;
+    /** Translate to English (default: false) */
+    translate?: boolean;
+    /** Number of threads (0 = auto) */
+    threads?: number;
+}
+/**
+ * Whisper ASR Engine with CoreML acceleration
+ *
+ * Uses the large-v3-turbo model for best speed/quality balance.
+ *
+ * @example
+ * ```typescript
+ * import { WhisperAsrEngine, getModelPath } from "whisper-coreml"
+ *
+ * const engine = new WhisperAsrEngine({
+ *   modelPath: getModelPath()
+ * })
+ *
+ * await engine.initialize()
+ * const result = await engine.transcribe(audioSamples, 16000)
+ * console.log(result.text)
+ * ```
+ */
+declare class WhisperAsrEngine {
+    private options;
+    private initialized;
+    constructor(options: WhisperAsrOptions);
+    /**
+     * Initialize the Whisper engine
+     * This loads the model into memory - may take a few seconds.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the engine is ready for transcription
+     */
+    isReady(): boolean;
+    /**
+     * Transcribe audio samples
+     *
+     * @param samples - Float32Array of audio samples (mono, 16kHz)
+     * @param sampleRate - Sample rate in Hz (default: 16000)
+     * @returns Transcription result with text and segments
+     */
+    transcribe(samples: Float32Array, sampleRate?: number): Promise<TranscriptionResult>;
+    /**
+     * Clean up resources and unload the model
+     */
+    cleanup(): void;
+    /**
+     * Get version information
+     */
+    getVersion(): {
+        addon: string;
+        whisper: string;
+        coreml: string;
+    };
+}
+
+export { type DownloadOptions, type TranscriptionResult, type TranscriptionSegment, WHISPER_MODEL, WhisperAsrEngine, type WhisperAsrOptions, downloadModel, formatBytes, getDefaultModelDir, getLoadError, getModelPath, isAvailable, isModelDownloaded };

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  WHISPER_MODEL,
+  WhisperAsrEngine,
+  downloadModel,
+  formatBytes,
+  getDefaultModelDir,
+  getLoadError,
+  getModelPath,
+  isAvailable,
+  isModelDownloaded
+} from "./chunk-MOQMN4DX.js";
+export {
+  WHISPER_MODEL,
+  WhisperAsrEngine,
+  downloadModel,
+  formatBytes,
+  getDefaultModelDir,
+  getLoadError,
+  getModelPath,
+  isAvailable,
+  isModelDownloaded
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}