@auxiora/stt 1.10.0 → 1.10.5

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { AudioFormat, STTOptions, Transcription, STTProvider } from './types.js';
 export { pcmToWav } from './pcm-to-wav.js';
 export { WhisperSTT, type WhisperSTTConfig } from './whisper.js';
+export { WhisperLocalSTT, type WhisperLocalConfig } from './whisper-local.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { pcmToWav } from './pcm-to-wav.js';
 export { WhisperSTT } from './whisper.js';
+export { WhisperLocalSTT } from './whisper-local.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAyB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAyB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAA2B,MAAM,oBAAoB,CAAC"}

package/dist/whisper-local.d.ts

@@ -0,0 +1,15 @@
+import type { STTProvider, STTOptions, Transcription } from './types.js';
+export interface WhisperLocalConfig {
+    binaryPath: string;
+    modelPath: string;
+    timeoutMs?: number;
+}
+export declare class WhisperLocalSTT implements STTProvider {
+    readonly name = "whisper-local";
+    private binaryPath;
+    private modelPath;
+    private timeoutMs;
+    constructor(config: WhisperLocalConfig);
+    transcribe(audio: Buffer, options?: STTOptions): Promise<Transcription>;
+}
+//# sourceMappingURL=whisper-local.d.ts.map

package/dist/whisper-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper-local.d.ts","sourceRoot":"","sources":["../src/whisper-local.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQzE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,kBAAkB;IAMhC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CA+C9E"}

package/dist/whisper-local.js

@@ -0,0 +1,60 @@
+import { execFile } from 'node:child_process';
+import { mkdtemp, writeFile, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { getLogger } from '@auxiora/logger';
+import { pcmToWav } from './pcm-to-wav.js';
+const logger = getLogger('stt:whisper-local');
+const execFileAsync = promisify(execFile);
+const MIN_AUDIO_BYTES = 16000; // 0.5s at 16kHz 16-bit mono
+export class WhisperLocalSTT {
+    name = 'whisper-local';
+    binaryPath;
+    modelPath;
+    timeoutMs;
+    constructor(config) {
+        this.binaryPath = config.binaryPath;
+        this.modelPath = config.modelPath;
+        this.timeoutMs = config.timeoutMs ?? 30_000;
+    }
+    async transcribe(audio, options) {
+        if (audio.length < MIN_AUDIO_BYTES) {
+            throw new Error('Audio too short');
+        }
+        const sampleRate = options?.sampleRate ?? 16000;
+        const wav = pcmToWav(audio, sampleRate);
+        const tmpDir = await mkdtemp(join(tmpdir(), 'whisper-'));
+        const tmpFile = join(tmpDir, 'audio.wav');
+        try {
+            await writeFile(tmpFile, wav);
+            const args = [
+                '--model', this.modelPath,
+                '--output-format', 'json',
+                '--file', tmpFile,
+            ];
+            if (options?.language) {
+                args.push('--language', options.language);
+            }
+            logger.info('Running whisper.cpp', { binaryPath: this.binaryPath, audioBytes: audio.length, sampleRate });
+            const { stdout } = await execFileAsync(this.binaryPath, args, {
+                timeout: this.timeoutMs,
+            });
+            const parsed = JSON.parse(stdout);
+            logger.info('Transcription complete', {
+                textLength: parsed.text.length,
+                language: parsed.language,
+                duration: parsed.duration,
+            });
+            return {
+                text: parsed.text.trim(),
+                language: parsed.language ?? options?.language ?? 'en',
+                duration: parsed.duration ?? 0,
+            };
+        }
+        finally {
+            await unlink(tmpFile).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=whisper-local.js.map

package/dist/whisper-local.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auxiora/stt",
-  "version": "1.10.0",
+  "version": "1.10.5",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,7 +14,7 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@auxiora/logger": "1.10.0"
+    "@auxiora/logger": "1.10.5"
   },
   "publishConfig": {
     "access": "public"