@whisper-cpp-node/core 0.1.0

package/README.md

@@ -0,0 +1,160 @@
+# @whisper-cpp-node/core
+
+Node.js bindings for [whisper.cpp](https://github.com/ggerganov/whisper.cpp) - fast speech-to-text on Apple Silicon with Core ML and Metal support.
+
+## Features
+
+- **Fast**: Native whisper.cpp performance with Metal GPU acceleration
+- **Core ML**: Optional Apple Neural Engine support for 3x+ speedup
+- **Streaming VAD**: Built-in Silero voice activity detection
+- **TypeScript**: Full type definitions included
+- **Self-contained**: No external dependencies, just install and use
+
+## Requirements
+
+- macOS 13.3+ (Ventura or later)
+- Apple Silicon (M1/M2/M3/M4)
+- Node.js 18+
+
+## Installation
+
+```bash
+npm install @whisper-cpp-node/core
+# or
+pnpm add @whisper-cpp-node/core
+```
+
+The platform-specific binary (`@whisper-cpp-node/darwin-arm64`) is automatically installed.
+
+## Quick Start
+
+```typescript
+import {
+  createWhisperContext,
+  transcribeAsync,
+} from "@whisper-cpp-node/core";
+
+// Create a context with your model
+const ctx = createWhisperContext({
+  model: "./models/ggml-base.en.bin",
+  use_gpu: true,
+});
+
+// Transcribe audio
+const result = await transcribeAsync(ctx, {
+  fname_inp: "./audio.wav",
+  language: "en",
+});
+
+console.log(result.segments);
+
+// Clean up
+ctx.free();
+```
+
+## API
+
+### `createWhisperContext(options)`
+
+Create a persistent context for transcription.
+
+```typescript
+interface WhisperContextOptions {
+  model: string;           // Path to GGML model file (required)
+  use_gpu?: boolean;       // Enable GPU acceleration (default: true)
+  use_coreml?: boolean;    // Enable Core ML on macOS (default: false)
+  flash_attn?: boolean;    // Enable Flash Attention (default: false)
+  gpu_device?: number;     // GPU device index (default: 0)
+  dtw?: string;            // DTW preset for word timestamps
+  no_prints?: boolean;     // Suppress log output (default: false)
+}
+```
+
+### `transcribeAsync(context, options)`
+
+Transcribe audio file (Promise-based).
+
+```typescript
+interface TranscribeOptions {
+  fname_inp: string;       // Path to audio file (required)
+  language?: string;       // Language code (e.g., 'en', 'zh', 'auto')
+  translate?: boolean;     // Translate to English
+  n_threads?: number;      // Number of threads
+  no_timestamps?: boolean; // Disable timestamps
+  // ... see types.ts for full options
+}
+
+interface TranscribeResult {
+  segments: Array<{
+    start: string;         // "HH:MM:SS,mmm"
+    end: string;
+    text: string;
+  }>;
+}
+```
+
+### `createVadContext(options)`
+
+Create a voice activity detection context.
+
+```typescript
+interface VadContextOptions {
+  model: string;           // Path to Silero VAD model
+  threshold?: number;      // Speech threshold (default: 0.5)
+  n_threads?: number;      // Number of threads (default: 1)
+  no_prints?: boolean;     // Suppress log output
+}
+
+// Usage
+const vad = createVadContext({
+  model: "./models/ggml-silero-v6.2.0.bin",
+});
+
+const samples = new Float32Array(vad.getWindowSamples());
+// ... fill samples with 16kHz audio
+const probability = vad.process(samples);
+
+vad.free();
+```
+
+## Core ML Acceleration
+
+For 3x+ faster encoding on Apple Silicon:
+
+1. Generate a Core ML model:
+   ```bash
+   pip install ane_transformers openai-whisper coremltools
+   ./models/generate-coreml-model.sh base.en
+   ```
+
+2. Place it next to your GGML model:
+   ```
+   models/ggml-base.en.bin
+   models/ggml-base.en-encoder.mlmodelc/
+   ```
+
+3. Enable Core ML:
+   ```typescript
+   const ctx = createWhisperContext({
+     model: "./models/ggml-base.en.bin",
+     use_coreml: true,
+   });
+   ```
+
+## Models
+
+Download models from [Hugging Face](https://huggingface.co/ggerganov/whisper.cpp):
+
+```bash
+# Base English model (~150MB)
+curl -L -o models/ggml-base.en.bin \
+  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin
+
+# Large v3 Turbo quantized (~500MB)
+curl -L -o models/ggml-large-v3-turbo-q4_0.bin \
+  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q4_0.bin
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import type { WhisperContext, WhisperContextOptions, VadContext, VadContextOptions, TranscribeOptions, TranscribeResult } from "./types";
+export type { WhisperContextOptions, VadContextOptions, TranscribeOptions, TranscribeResult, TranscriptSegment, WhisperContext, VadContext, WhisperContextConstructor, VadContextConstructor, } from "./types";
+export declare const WhisperContextClass: import("./types").WhisperContextConstructor;
+export declare const VadContextClass: import("./types").VadContextConstructor;
+export declare const transcribe: (context: WhisperContext, options: TranscribeOptions, callback: import("./types").TranscribeCallback) => void;
+export declare const transcribeAsync: (context: WhisperContext, options: TranscribeOptions) => Promise<TranscribeResult>;
+/**
+ * Create a new WhisperContext
+ *
+ * @example
+ * ```typescript
+ * const ctx = createWhisperContext({
+ *   model: './models/ggml-base.en.bin',
+ *   use_gpu: true,
+ *   use_coreml: true,
+ * });
+ *
+ * const result = await transcribeAsync(ctx, {
+ *   fname_inp: './audio.wav',
+ *   language: 'en',
+ * });
+ *
+ * console.log(result.segments);
+ * ctx.free();
+ * ```
+ */
+export declare function createWhisperContext(options: WhisperContextOptions): WhisperContext;
+/**
+ * Create a new VadContext for voice activity detection
+ *
+ * @example
+ * ```typescript
+ * const vad = createVadContext({
+ *   model: './models/ggml-silero-v6.2.0.bin',
+ *   threshold: 0.5,
+ * });
+ *
+ * const samples = new Float32Array(512);
+ * const probability = vad.process(samples);
+ *
+ * vad.free();
+ * ```
+ */
+export declare function createVadContext(options: VadContextOptions): VadContext;
+declare const _default: {
+    WhisperContext: import("./types").WhisperContextConstructor;
+    VadContext: import("./types").VadContextConstructor;
+    transcribe: (context: WhisperContext, options: TranscribeOptions, callback: import("./types").TranscribeCallback) => void;
+    transcribeAsync: (context: WhisperContext, options: TranscribeOptions) => Promise<TranscribeResult>;
+    createWhisperContext: typeof createWhisperContext;
+    createVadContext: typeof createVadContext;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAMjB,eAAO,MAAM,mBAAmB,6CAAuB,CAAC;AACxD,eAAO,MAAM,eAAe,yCAAmB,CAAC;AAGhD,eAAO,MAAM,UAAU,+GAAmB,CAAC;AAG3C,eAAO,MAAM,eAAe,EAAkC,CAC5D,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAEhB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE;;;;;+BAhDU,cAAc,WACd,iBAAiB,KACvB,OAAO,CAAC,gBAAgB,CAAC;;;;AAiD9B,wBAOE"}

package/dist/index.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcribeAsync = exports.transcribe = exports.VadContextClass = exports.WhisperContextClass = void 0;
+exports.createWhisperContext = createWhisperContext;
+exports.createVadContext = createVadContext;
+const util_1 = require("util");
+const loader_1 = require("./loader");
+// Load native addon
+const addon = (0, loader_1.loadNativeAddon)();
+// Export native constructors with different names to avoid conflict
+exports.WhisperContextClass = addon.WhisperContext;
+exports.VadContextClass = addon.VadContext;
+// Original callback-based transcribe
+exports.transcribe = addon.transcribe;
+// Promisified version for async/await
+exports.transcribeAsync = (0, util_1.promisify)(addon.transcribe);
+/**
+ * Create a new WhisperContext
+ *
+ * @example
+ * ```typescript
+ * const ctx = createWhisperContext({
+ *   model: './models/ggml-base.en.bin',
+ *   use_gpu: true,
+ *   use_coreml: true,
+ * });
+ *
+ * const result = await transcribeAsync(ctx, {
+ *   fname_inp: './audio.wav',
+ *   language: 'en',
+ * });
+ *
+ * console.log(result.segments);
+ * ctx.free();
+ * ```
+ */
+function createWhisperContext(options) {
+    return new addon.WhisperContext(options);
+}
+/**
+ * Create a new VadContext for voice activity detection
+ *
+ * @example
+ * ```typescript
+ * const vad = createVadContext({
+ *   model: './models/ggml-silero-v6.2.0.bin',
+ *   threshold: 0.5,
+ * });
+ *
+ * const samples = new Float32Array(512);
+ * const probability = vad.process(samples);
+ *
+ * vad.free();
+ * ```
+ */
+function createVadContext(options) {
+    return new addon.VadContext(options);
+}
+// Default export with all functionality
+exports.default = {
+    WhisperContext: addon.WhisperContext,
+    VadContext: addon.VadContext,
+    transcribe: addon.transcribe,
+    transcribeAsync: exports.transcribeAsync,
+    createWhisperContext,
+    createVadContext,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA6DA,oDAIC;AAkBD,4CAEC;AArFD,+BAAiC;AACjC,qCAA2C;AAwB3C,oBAAoB;AACpB,MAAM,KAAK,GAAiB,IAAA,wBAAe,GAAE,CAAC;AAE9C,oEAAoE;AACvD,QAAA,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC;AAC3C,QAAA,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC;AAEhD,qCAAqC;AACxB,QAAA,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;AAE3C,sCAAsC;AACzB,QAAA,eAAe,GAAG,IAAA,gBAAS,EAAC,KAAK,CAAC,UAAU,CAG3B,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,oBAAoB,CAClC,OAA8B;IAE9B,OAAO,IAAI,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,gBAAgB,CAAC,OAA0B;IACzD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,wCAAwC;AACxC,kBAAe;IACb,cAAc,EAAE,KAAK,CAAC,cAAc;IACpC,UAAU,EAAE,KAAK,CAAC,UAAU;IAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;IAC5B,eAAe,EAAf,uBAAe;IACf,oBAAoB;IACpB,gBAAgB;CACjB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,6 @@
+import type { WhisperAddon } from "./types";
+/**
+ * Load the native addon for the current platform
+ */
+export declare function loadNativeAddon(): WhisperAddon;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA6D5C;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CA4B9C"}

package/dist/loader.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadNativeAddon = loadNativeAddon;
+const os_1 = require("os");
+const path_1 = require("path");
+const fs_1 = require("fs");
+/**
+ * Supported platform-arch combinations
+ */
+const SUPPORTED_PLATFORMS = {
+    "darwin-arm64": "@whisper-cpp-node/darwin-arm64",
+    // Future: add more platforms
+    // "darwin-x64": "@whisper-cpp-node/darwin-x64",
+    // "linux-x64": "@whisper-cpp-node/linux-x64",
+    // "win32-x64": "@whisper-cpp-node/win32-x64",
+};
+/**
+ * Get the platform key for current system
+ */
+function getPlatformKey() {
+    return `${(0, os_1.platform)()}-${(0, os_1.arch)()}`;
+}
+/**
+ * Get the platform-specific package name
+ */
+function getPlatformPackage() {
+    const platformKey = getPlatformKey();
+    const packageName = SUPPORTED_PLATFORMS[platformKey];
+    if (!packageName) {
+        const supported = Object.keys(SUPPORTED_PLATFORMS).join(", ");
+        throw new Error(`Unsupported platform: ${platformKey}. ` +
+            `Supported platforms: ${supported}`);
+    }
+    return packageName;
+}
+/**
+ * Try to find the binary in workspace development paths
+ */
+function tryWorkspacePath() {
+    const platformKey = getPlatformKey();
+    // In monorepo development, the binary is in sibling package
+    const possiblePaths = [
+        // From dist/ folder: ../darwin-arm64/whisper.node
+        (0, path_1.join)(__dirname, "..", "..", platformKey, "whisper.node"),
+        // From src/ folder during ts-node: ../../darwin-arm64/whisper.node
+        (0, path_1.join)(__dirname, "..", "..", "..", platformKey, "whisper.node"),
+    ];
+    for (const p of possiblePaths) {
+        if ((0, fs_1.existsSync)(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Load the native addon for the current platform
+ */
+function loadNativeAddon() {
+    const packageName = getPlatformPackage();
+    // First, try workspace development path
+    const workspacePath = tryWorkspacePath();
+    if (workspacePath) {
+        return require(workspacePath);
+    }
+    // Then try the installed package
+    try {
+        const binaryPath = require.resolve((0, path_1.join)(packageName, "whisper.node"));
+        return require(binaryPath);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "MODULE_NOT_FOUND") {
+            throw new Error(`Native binary not found. Please ensure ${packageName} is installed.\n` +
+                `Try running: npm install ${packageName}\n` +
+                `Original error: ${err.message}`);
+        }
+        throw new Error(`Failed to load native addon from ${packageName}: ${err.message}`);
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":";;AAmEA,0CA4BC;AA/FD,2BAAoC;AACpC,+BAA4B;AAC5B,2BAAgC;AAGhC;;GAEG;AACH,MAAM,mBAAmB,GAA2B;IAClD,cAAc,EAAE,gCAAgC;IAChD,6BAA6B;IAC7B,gDAAgD;IAChD,8CAA8C;IAC9C,8CAA8C;CAC/C,CAAC;AAEF;;GAEG;AACH,SAAS,cAAc;IACrB,OAAO,GAAG,IAAA,aAAQ,GAAE,IAAI,IAAA,SAAI,GAAE,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB;IACzB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,yBAAyB,WAAW,IAAI;YACtC,wBAAwB,SAAS,EAAE,CACtC,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,4DAA4D;IAC5D,MAAM,aAAa,GAAG;QACpB,kDAAkD;QAClD,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC;QACxD,mEAAmE;QACnE,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC;KAC/D,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,IAAA,eAAU,EAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IAEzC,wCAAwC;IACxC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,aAAa,CAAiB,CAAC;IAChD,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAA,WAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;QACtE,OAAO,OAAO,CAAC,UAAU,CAAiB,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAA8B,CAAC;QAE3C,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,0CAA0C,WAAW,kBAAkB;gBACrE,4BAA4B,WAAW,IAAI;gBAC3C,mBAAmB,GAAG,CAAC,OAAO,EAAE,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,oCAAoC,WAAW,KAAK,GAAG,CAAC,OAAO,EAAE,CAClE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Options for creating a WhisperContext
+ */
+export interface WhisperContextOptions {
+    /** Path to the GGML model file */
+    model: string;
+    /** Enable GPU acceleration (default: true) */
+    use_gpu?: boolean;
+    /** Enable Flash Attention (default: false) */
+    flash_attn?: boolean;
+    /** GPU device index (default: 0) */
+    gpu_device?: number;
+    /** Enable Core ML acceleration on macOS (default: false) */
+    use_coreml?: boolean;
+    /** DTW alignment preset for word-level timestamps (e.g., 'base.en', 'small', 'large.v3') */
+    dtw?: string;
+    /** Suppress whisper.cpp log output (default: false) */
+    no_prints?: boolean;
+}
+/**
+ * Options for transcription
+ */
+export interface TranscribeOptions {
+    /** Path to the audio file */
+    fname_inp: string;
+    /** Language code (e.g., 'en', 'zh', 'auto') */
+    language?: string;
+    /** Translate to English */
+    translate?: boolean;
+    /** Number of threads to use */
+    n_threads?: number;
+    /** Number of processors */
+    n_processors?: number;
+    /** Disable timestamps in output */
+    no_timestamps?: boolean;
+    /** Detect language automatically */
+    detect_language?: boolean;
+    /** Single segment mode */
+    single_segment?: boolean;
+    /** Maximum segment length (0 = no limit) */
+    max_len?: number;
+    /** Maximum tokens per segment (0 = no limit) */
+    max_tokens?: number;
+    /** Maximum context size (-1 = default) */
+    max_context?: number;
+    /** Temperature for sampling */
+    temperature?: number;
+    /** Temperature increment for fallback */
+    temperature_inc?: number;
+    /** Best of N sampling */
+    best_of?: number;
+    /** Beam size (-1 = greedy) */
+    beam_size?: number;
+    /** Entropy threshold */
+    entropy_thold?: number;
+    /** Log probability threshold */
+    logprob_thold?: number;
+    /** No speech threshold */
+    no_speech_thold?: number;
+    /** Initial prompt text */
+    prompt?: string;
+}
+/**
+ * Transcription result segment (tuple format)
+ * [0]: Start time in format "HH:MM:SS,mmm"
+ * [1]: End time in format "HH:MM:SS,mmm"
+ * [2]: Transcribed text
+ */
+export type TranscriptSegment = [start: string, end: string, text: string];
+/**
+ * Transcription result
+ */
+export interface TranscribeResult {
+    /** Array of transcript segments as [start, end, text] tuples */
+    segments: TranscriptSegment[];
+}
+/**
+ * Options for creating a VadContext
+ */
+export interface VadContextOptions {
+    /** Path to the Silero VAD model file */
+    model: string;
+    /** Speech detection threshold (default: 0.5) */
+    threshold?: number;
+    /** Number of threads (default: 1) */
+    n_threads?: number;
+    /** Suppress model loading prints */
+    no_prints?: boolean;
+}
+/**
+ * WhisperContext class for persistent model context
+ */
+export interface WhisperContext {
+    /** Get whisper.cpp system info string */
+    getSystemInfo(): string;
+    /** Check if model is multilingual */
+    isMultilingual(): boolean;
+    /** Free the context and release resources */
+    free(): void;
+}
+/**
+ * WhisperContext constructor type
+ */
+export interface WhisperContextConstructor {
+    new (options: WhisperContextOptions): WhisperContext;
+}
+/**
+ * VadContext class for voice activity detection
+ */
+export interface VadContext {
+    /** Get the required window size in samples */
+    getWindowSamples(): number;
+    /** Get the expected sample rate (16000 Hz) */
+    getSampleRate(): number;
+    /** Process audio samples and return speech probability [0, 1] */
+    process(samples: Float32Array): number;
+    /** Reset the internal LSTM state */
+    reset(): void;
+    /** Free the context and release resources */
+    free(): void;
+}
+/**
+ * VadContext constructor type
+ */
+export interface VadContextConstructor {
+    new (options: VadContextOptions): VadContext;
+}
+/**
+ * Transcribe callback function signature
+ */
+export type TranscribeCallback = (error: Error | null, result?: TranscribeResult) => void;
+/**
+ * Native addon interface
+ */
+export interface WhisperAddon {
+    WhisperContext: WhisperContextConstructor;
+    VadContext: VadContextConstructor;
+    transcribe: (context: WhisperContext, options: TranscribeOptions, callback: TranscribeCallback) => void;
+    whisper: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@whisper-cpp-node/core",
+  "version": "0.1.0",
+  "description": "Node.js bindings for whisper.cpp - fast speech-to-text on Apple Silicon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/niconicoye/whisper.cpp",
+    "directory": "npm/packages/core"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "optionalDependencies": {
+    "@whisper-cpp-node/darwin-arm64": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "whisper",
+    "whisper.cpp",
+    "speech-to-text",
+    "transcription",
+    "audio",
+    "asr",
+    "apple-silicon",
+    "coreml",
+    "metal"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}