@derogab/stt-proxy 0.2.0 → 0.3.0

package/README.md

@@ -1,5 +1,5 @@
 # stt-proxy
-A simple and lightweight proxy for seamless integration with multiple STT providers including Whisper.cpp.
+A simple and lightweight proxy for seamless integration with multiple STT providers including Whisper.cpp and Cloudflare AI.
 
 ## Features
 
@@ -28,6 +28,13 @@ console.log(result.text);
 The package automatically detects which STT provider to use based on your environment variables.
 Configure one or more providers:
 
+### Provider Selection
+```bash
+PROVIDER=cloudflare # Optional, force a specific provider (whisper.cpp, cloudflare)
+```
+
+When `PROVIDER` is set, the specified provider will be used and an error is thrown if its credentials are not configured. When not set, providers are selected automatically based on priority.
+
 ### Whisper.cpp (Local)
 ```bash
 WHISPER_CPP_MODEL_PATH=/path/to/ggml-base.bin # Required, path to your GGML model file
@@ -38,6 +45,14 @@ Download models from [HuggingFace](https://huggingface.co/ggerganov/whisper.cpp/
 curl -L -o ggml-base.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin
 ```
 
+### Cloudflare AI
+```bash
+CLOUDFLARE_ACCOUNT_ID=your-account-id # Required
+CLOUDFLARE_AUTH_KEY=your-api-token    # Required
+```
+
+Uses the `@cf/openai/whisper-large-v3-turbo` model.
+
 ## API Reference
 
 ### `transcribe(audio: string | Buffer, options?): Promise<TranscribeOutput>`
@@ -87,14 +102,17 @@ console.log(result3.text);
 
 ## Provider Priority
 
-The package selects providers in the following order:
-1. **Whisper.cpp** (if `WHISPER_CPP_MODEL_PATH` is set)
+When `PROVIDER` environment variable is set, that provider is used directly.
+
+Otherwise, the package selects providers in the following order:
+1. **Whisper.cpp** (if `WHISPER_CPP_MODEL_PATH` is set and file exists)
+2. **Cloudflare AI** (if `CLOUDFLARE_ACCOUNT_ID` and `CLOUDFLARE_AUTH_KEY` are set)
 
 If no providers are configured, the function throws an error.
 
 ## Requirements
 
-- **FFmpeg**: Required for audio conversion.
+- **FFmpeg**: Required for audio conversion (Whisper.cpp only).
   ```bash
   # macOS
   brew install ffmpeg
@@ -114,6 +132,9 @@ npm install
 
 # Build the package
 npm run build
+
+# Run tests
+npm test
 ```
 
 ## Credits

package/dist/cjs/index.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcribe = transcribe;
+require("dotenv/config");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const child_process_1 = require("child_process");
+// ============================================================================
+// Shared utilities
+// ============================================================================
+function cleanTranscription(text) {
+    return text.replace(/[\x00-\x1F\x7F]/g, '').trim();
+}
+function generateTempPath(prefix, extension) {
+    const randomId = `${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    return path.join(os.tmpdir(), `${prefix}_${randomId}.${extension}`);
+}
+// ============================================================================
+// Whisper.cpp provider
+// ============================================================================
+let whisperInstance = null;
+let currentModelPath = null;
+function isWhisperConfigured() {
+    const modelPath = process.env['WHISPER_CPP_MODEL_PATH'];
+    return !!modelPath && fs.existsSync(modelPath);
+}
+async function getWhisperInstance() {
+    const modelPath = process.env['WHISPER_CPP_MODEL_PATH'];
+    if (!modelPath) {
+        throw new Error('WHISPER_CPP_MODEL_PATH environment variable is not set');
+    }
+    if (!fs.existsSync(modelPath)) {
+        throw new Error(`Whisper model not found at path: ${modelPath}`);
+    }
+    if (whisperInstance && currentModelPath === modelPath) {
+        return whisperInstance;
+    }
+    if (whisperInstance) {
+        await whisperInstance.free();
+        whisperInstance = null;
+    }
+    const { Whisper } = await Promise.resolve().then(() => require('smart-whisper'));
+    whisperInstance = new Whisper(modelPath, { gpu: true });
+    currentModelPath = modelPath;
+    return whisperInstance;
+}
+function audioToPcm(audioPath) {
+    const tempPcmPath = generateTempPath('whisper', 'pcm');
+    try {
+        (0, child_process_1.execSync)(`ffmpeg -y -i "${audioPath}" -ar 16000 -ac 1 -f f32le "${tempPcmPath}"`, { stdio: 'pipe' });
+        const pcmBuffer = fs.readFileSync(tempPcmPath);
+        return new Float32Array(pcmBuffer.buffer, pcmBuffer.byteOffset, pcmBuffer.length / 4);
+    }
+    finally {
+        if (fs.existsSync(tempPcmPath)) {
+            fs.unlinkSync(tempPcmPath);
+        }
+    }
+}
+function resultsToText(results) {
+    return results.map((r) => r.text).join(' ');
+}
+async function transcribeWithWhisper(audioPath, options = {}) {
+    if (!fs.existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const whisper = await getWhisperInstance();
+    const pcmData = audioToPcm(audioPath);
+    const transcribeParams = {
+        format: 'simple',
+        ...(options.language !== undefined && { language: options.language }),
+        ...(options.translate !== undefined && { translate: options.translate }),
+    };
+    const task = await whisper.transcribe(pcmData, transcribeParams);
+    const results = await task.result;
+    return { text: cleanTranscription(resultsToText(results)) };
+}
+// ============================================================================
+// Cloudflare provider
+// ============================================================================
+function isCloudflareConfigured() {
+    return !!(process.env['CLOUDFLARE_ACCOUNT_ID'] && process.env['CLOUDFLARE_AUTH_KEY']);
+}
+async function transcribeWithCloudflare(audioPath, options = {}) {
+    if (!fs.existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const accountId = process.env['CLOUDFLARE_ACCOUNT_ID'];
+    const authKey = process.env['CLOUDFLARE_AUTH_KEY'];
+    if (!accountId || !authKey) {
+        throw new Error('Cloudflare credentials not configured. Set CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY environment variables.');
+    }
+    const audioBuffer = fs.readFileSync(audioPath);
+    const url = `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/@cf/openai/whisper-large-v3-turbo`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${authKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            audio: audioBuffer.toString('base64'),
+            task: options.translate ? 'translate' : 'transcribe',
+            vad_filter: true,
+            ...(options.language && { language: options.language }),
+        }),
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`Cloudflare API error: ${response.status} ${response.statusText} - ${errorBody}`);
+    }
+    const data = await response.json();
+    if (!data.success || !data.result?.text) {
+        const errorMessage = data.errors?.[0]?.message || 'Unknown Cloudflare API error';
+        throw new Error(`Cloudflare transcription failed: ${errorMessage}`);
+    }
+    return { text: cleanTranscription(data.result.text) };
+}
+function selectProvider() {
+    // Check for explicit provider selection
+    const explicitProvider = process.env['PROVIDER']?.toLowerCase();
+    if (explicitProvider) {
+        // Validate explicit provider configuration
+        switch (explicitProvider) {
+            case 'whisper.cpp':
+                if (!isWhisperConfigured()) {
+                    throw new Error("PROVIDER is set to 'whisper.cpp' but WHISPER_CPP_MODEL_PATH is not configured or model file does not exist.");
+                }
+                return 'whisper.cpp';
+            case 'cloudflare':
+                if (!isCloudflareConfigured()) {
+                    throw new Error("PROVIDER is set to 'cloudflare' but CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY are not configured.");
+                }
+                return 'cloudflare';
+            default:
+                throw new Error(`Unknown provider: ${explicitProvider}. Valid providers are: whisper.cpp, cloudflare`);
+        }
+    }
+    // Auto-detection priority: whisper.cpp > cloudflare
+    if (isWhisperConfigured())
+        return 'whisper.cpp';
+    if (isCloudflareConfigured())
+        return 'cloudflare';
+    throw new Error('No STT provider configured. Set WHISPER_CPP_MODEL_PATH or CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY environment variables.');
+}
+async function transcribeFromPath(audioPath, options, provider) {
+    if (provider === 'cloudflare') {
+        return transcribeWithCloudflare(audioPath, options);
+    }
+    return transcribeWithWhisper(audioPath, options);
+}
+async function transcribeFromBuffer(audioBuffer, options, provider) {
+    const tempPath = generateTempPath('stt_input', 'audio');
+    fs.writeFileSync(tempPath, audioBuffer);
+    try {
+        return await transcribeFromPath(tempPath, options, provider);
+    }
+    finally {
+        if (fs.existsSync(tempPath)) {
+            fs.unlinkSync(tempPath);
+        }
+    }
+}
+async function transcribe(audio, options = {}) {
+    const provider = selectProvider();
+    return Buffer.isBuffer(audio)
+        ? transcribeFromBuffer(audio, options, provider)
+        : transcribeFromPath(audio, options, provider);
+}
+// ============================================================================
+// Cleanup handlers
+// ============================================================================
+async function freeWhisper() {
+    if (whisperInstance) {
+        await whisperInstance.free();
+        whisperInstance = null;
+        currentModelPath = null;
+    }
+}
+process.on('exit', () => {
+    if (whisperInstance) {
+        // Note: Cannot use async operations in 'exit' handler
+        // The instance will be cleaned up by the process termination
+        whisperInstance = null;
+        currentModelPath = null;
+    }
+});
+const shutdownHandler = async () => {
+    await freeWhisper();
+    process.exit(0);
+};
+process.on('SIGINT', shutdownHandler);
+process.on('SIGTERM', shutdownHandler);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/esm/index.js

@@ -0,0 +1,192 @@
+import 'dotenv/config';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { execSync } from 'child_process';
+// ============================================================================
+// Shared utilities
+// ============================================================================
+function cleanTranscription(text) {
+    return text.replace(/[\x00-\x1F\x7F]/g, '').trim();
+}
+function generateTempPath(prefix, extension) {
+    const randomId = `${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    return path.join(os.tmpdir(), `${prefix}_${randomId}.${extension}`);
+}
+// ============================================================================
+// Whisper.cpp provider
+// ============================================================================
+let whisperInstance = null;
+let currentModelPath = null;
+function isWhisperConfigured() {
+    const modelPath = process.env['WHISPER_CPP_MODEL_PATH'];
+    return !!modelPath && fs.existsSync(modelPath);
+}
+async function getWhisperInstance() {
+    const modelPath = process.env['WHISPER_CPP_MODEL_PATH'];
+    if (!modelPath) {
+        throw new Error('WHISPER_CPP_MODEL_PATH environment variable is not set');
+    }
+    if (!fs.existsSync(modelPath)) {
+        throw new Error(`Whisper model not found at path: ${modelPath}`);
+    }
+    if (whisperInstance && currentModelPath === modelPath) {
+        return whisperInstance;
+    }
+    if (whisperInstance) {
+        await whisperInstance.free();
+        whisperInstance = null;
+    }
+    const { Whisper } = await import('smart-whisper');
+    whisperInstance = new Whisper(modelPath, { gpu: true });
+    currentModelPath = modelPath;
+    return whisperInstance;
+}
+function audioToPcm(audioPath) {
+    const tempPcmPath = generateTempPath('whisper', 'pcm');
+    try {
+        execSync(`ffmpeg -y -i "${audioPath}" -ar 16000 -ac 1 -f f32le "${tempPcmPath}"`, { stdio: 'pipe' });
+        const pcmBuffer = fs.readFileSync(tempPcmPath);
+        return new Float32Array(pcmBuffer.buffer, pcmBuffer.byteOffset, pcmBuffer.length / 4);
+    }
+    finally {
+        if (fs.existsSync(tempPcmPath)) {
+            fs.unlinkSync(tempPcmPath);
+        }
+    }
+}
+function resultsToText(results) {
+    return results.map((r) => r.text).join(' ');
+}
+async function transcribeWithWhisper(audioPath, options = {}) {
+    if (!fs.existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const whisper = await getWhisperInstance();
+    const pcmData = audioToPcm(audioPath);
+    const transcribeParams = {
+        format: 'simple',
+        ...(options.language !== undefined && { language: options.language }),
+        ...(options.translate !== undefined && { translate: options.translate }),
+    };
+    const task = await whisper.transcribe(pcmData, transcribeParams);
+    const results = await task.result;
+    return { text: cleanTranscription(resultsToText(results)) };
+}
+// ============================================================================
+// Cloudflare provider
+// ============================================================================
+function isCloudflareConfigured() {
+    return !!(process.env['CLOUDFLARE_ACCOUNT_ID'] && process.env['CLOUDFLARE_AUTH_KEY']);
+}
+async function transcribeWithCloudflare(audioPath, options = {}) {
+    if (!fs.existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const accountId = process.env['CLOUDFLARE_ACCOUNT_ID'];
+    const authKey = process.env['CLOUDFLARE_AUTH_KEY'];
+    if (!accountId || !authKey) {
+        throw new Error('Cloudflare credentials not configured. Set CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY environment variables.');
+    }
+    const audioBuffer = fs.readFileSync(audioPath);
+    const url = `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/@cf/openai/whisper-large-v3-turbo`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${authKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            audio: audioBuffer.toString('base64'),
+            task: options.translate ? 'translate' : 'transcribe',
+            vad_filter: true,
+            ...(options.language && { language: options.language }),
+        }),
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`Cloudflare API error: ${response.status} ${response.statusText} - ${errorBody}`);
+    }
+    const data = await response.json();
+    if (!data.success || !data.result?.text) {
+        const errorMessage = data.errors?.[0]?.message || 'Unknown Cloudflare API error';
+        throw new Error(`Cloudflare transcription failed: ${errorMessage}`);
+    }
+    return { text: cleanTranscription(data.result.text) };
+}
+function selectProvider() {
+    // Check for explicit provider selection
+    const explicitProvider = process.env['PROVIDER']?.toLowerCase();
+    if (explicitProvider) {
+        // Validate explicit provider configuration
+        switch (explicitProvider) {
+            case 'whisper.cpp':
+                if (!isWhisperConfigured()) {
+                    throw new Error("PROVIDER is set to 'whisper.cpp' but WHISPER_CPP_MODEL_PATH is not configured or model file does not exist.");
+                }
+                return 'whisper.cpp';
+            case 'cloudflare':
+                if (!isCloudflareConfigured()) {
+                    throw new Error("PROVIDER is set to 'cloudflare' but CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY are not configured.");
+                }
+                return 'cloudflare';
+            default:
+                throw new Error(`Unknown provider: ${explicitProvider}. Valid providers are: whisper.cpp, cloudflare`);
+        }
+    }
+    // Auto-detection priority: whisper.cpp > cloudflare
+    if (isWhisperConfigured())
+        return 'whisper.cpp';
+    if (isCloudflareConfigured())
+        return 'cloudflare';
+    throw new Error('No STT provider configured. Set WHISPER_CPP_MODEL_PATH or CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_AUTH_KEY environment variables.');
+}
+async function transcribeFromPath(audioPath, options, provider) {
+    if (provider === 'cloudflare') {
+        return transcribeWithCloudflare(audioPath, options);
+    }
+    return transcribeWithWhisper(audioPath, options);
+}
+async function transcribeFromBuffer(audioBuffer, options, provider) {
+    const tempPath = generateTempPath('stt_input', 'audio');
+    fs.writeFileSync(tempPath, audioBuffer);
+    try {
+        return await transcribeFromPath(tempPath, options, provider);
+    }
+    finally {
+        if (fs.existsSync(tempPath)) {
+            fs.unlinkSync(tempPath);
+        }
+    }
+}
+export async function transcribe(audio, options = {}) {
+    const provider = selectProvider();
+    return Buffer.isBuffer(audio)
+        ? transcribeFromBuffer(audio, options, provider)
+        : transcribeFromPath(audio, options, provider);
+}
+// ============================================================================
+// Cleanup handlers
+// ============================================================================
+async function freeWhisper() {
+    if (whisperInstance) {
+        await whisperInstance.free();
+        whisperInstance = null;
+        currentModelPath = null;
+    }
+}
+process.on('exit', () => {
+    if (whisperInstance) {
+        // Note: Cannot use async operations in 'exit' handler
+        // The instance will be cleaned up by the process termination
+        whisperInstance = null;
+        currentModelPath = null;
+    }
+});
+const shutdownHandler = async () => {
+    await freeWhisper();
+    process.exit(0);
+};
+process.on('SIGINT', shutdownHandler);
+process.on('SIGTERM', shutdownHandler);
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+import 'dotenv/config';
+export interface TranscribeOptions {
+    language?: string;
+    translate?: boolean;
+}
+export interface TranscribeOutput {
+    text: string;
+}
+export declare function transcribe(audio: string | Buffer, options?: TranscribeOptions): Promise<TranscribeOutput>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAWvB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAiND,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMnH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@derogab/stt-proxy",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A simple and lightweight proxy for seamless integration with multiple STT (Speech-to-Text) providers including Whisper.cpp",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -18,6 +18,9 @@
       }
     }
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "npm run build:cjs && npm run build:esm && npm run build:types",
     "build:cjs": "tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
@@ -26,6 +29,7 @@
     "test": "vitest run",
     "test:unit": "vitest run --exclude='**/*.integration.test.*'",
     "test:whisper": "vitest run --testTimeout=300000 --hookTimeout=600000 test/whisper-cpp.integration.test.ts",
+    "test:cloudflare": "vitest run --testTimeout=60000 --hookTimeout=60000 test/cloudflare.integration.test.ts",
     "test:watch": "vitest watch",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit -p tsconfig.esm.json"
@@ -40,6 +44,8 @@
     "transcription",
     "whisper",
     "whisper.cpp",
+    "cloudflare",
+    "cloudflare-ai",
     "proxy",
     "gateway"
   ],

package/.github/workflows/release.yml

@@ -1,131 +0,0 @@
-name: Release and publish package to NPM
-
-on:
-  push:
-    # Publish `v1.2.3` tags as releases.
-    tags:
-      - v*
-
-jobs:
-  # Release the TAG to GitHub.
-  release:
-    name: Release pushed tag
-    if: startsWith(github.ref, 'refs/tags/')
-    permissions:
-      contents: write
-    runs-on: ubuntu-latest
-    steps:
-      - name: Create release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          tag: ${{ github.ref_name }}
-        run: |
-          gh release create "$tag" \
-              --repo="$GITHUB_REPOSITORY" \
-              --title="v${tag#v}" \
-              --generate-notes
-  # Publish the package.
-  publish-npm:
-    name: Publish Package on NPM
-    needs: release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-      - name: Setup Node
-        uses: actions/setup-node@v6
-        with:
-          node-version: '20.x'
-          cache: 'npm'
-          registry-url: 'https://registry.npmjs.org'
-      - name: Install FFmpeg
-        run: sudo apt-get update && sudo apt-get install -y ffmpeg
-      - name: Cache Whisper model
-        uses: actions/cache@v4
-        with:
-          path: test/models
-          key: whisper-model-tiny-v1
-      - name: Cache test audio
-        uses: actions/cache@v4
-        with:
-          path: test/audio
-          key: test-audio-jfk-v1
-      - name: Install dependencies (clean)
-        run: npm ci
-      - name: Type check
-        run: npm run typecheck
-      - name: Run tests
-        run: npm test --if-present
-      - name: Build
-        run: npm run build
-      - name: Verify tag matches package.json version
-        run: |
-          PKG_VERSION="$(node -p "require('./package.json').version")"
-          TAG_VERSION="${GITHUB_REF_NAME#v}"   # supports tags like v1.2.3
-          echo "package.json: $PKG_VERSION"
-          echo "release tag:   $TAG_VERSION"
-          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
-            echo "Release tag ($TAG_VERSION) does not match package.json version ($PKG_VERSION)."
-            exit 1
-          fi
-      - name: Show publish contents (dry run)
-        run: npm pack --dry-run
-      - name: Publish to npm (with provenance)
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish --provenance --access public
-  publish-github:
-    name: Publish Package on GitHub
-    needs: release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-      - name: Setup Node
-        uses: actions/setup-node@v6
-        with:
-          node-version: '20.x'
-          cache: 'npm'
-          registry-url: 'https://npm.pkg.github.com'
-      - name: Install FFmpeg
-        run: sudo apt-get update && sudo apt-get install -y ffmpeg
-      - name: Cache Whisper model
-        uses: actions/cache@v4
-        with:
-          path: test/models
-          key: whisper-model-tiny-v1
-      - name: Cache test audio
-        uses: actions/cache@v4
-        with:
-          path: test/audio
-          key: test-audio-jfk-v1
-      - name: Install dependencies (clean)
-        run: npm ci
-      - name: Type check
-        run: npm run typecheck
-      - name: Run tests
-        run: npm test --if-present
-      - name: Build
-        run: npm run build
-      - name: Verify tag matches package.json version
-        run: |
-          PKG_VERSION="$(node -p "require('./package.json').version")"
-          TAG_VERSION="${GITHUB_REF_NAME#v}"   # supports tags like v1.2.3
-          echo "package.json: $PKG_VERSION"
-          echo "release tag:   $TAG_VERSION"
-          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
-            echo "Release tag ($TAG_VERSION) does not match package.json version ($PKG_VERSION)."
-            exit 1
-          fi
-      - name: Show publish contents (dry run)
-        run: npm pack --dry-run
-      - name: Publish to GitHub Packages (with provenance)
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_GITHUB_TOKEN }}
-        run: npm publish --provenance --access public

package/.github/workflows/tests.yml

@@ -1,42 +0,0 @@
-name: Tests
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  tests:
-    name: Run tests
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-      - name: Setup Node
-        uses: actions/setup-node@v6
-        with:
-          node-version: '20.x'
-          cache: 'npm'
-      - name: Install FFmpeg
-        run: sudo apt-get update && sudo apt-get install -y ffmpeg
-      - name: Cache Whisper model
-        uses: actions/cache@v4
-        with:
-          path: test/models
-          key: whisper-model-tiny-v1
-      - name: Cache test audio
-        uses: actions/cache@v4
-        with:
-          path: test/audio
-          key: test-audio-jfk-v1
-      - name: Install dependencies
-        run: npm ci
-      - name: Type check
-        run: npm run typecheck
-      - name: Build project
-        run: npm run build
-      - name: Run all tests
-        run: npm test

package/CLAUDE.md

@@ -1,47 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Build Commands
-
-```bash
-npm install          # Install dependencies
-npm run build        # Build all outputs (CJS, ESM, and types)
-npm run build:cjs    # Build CommonJS output only
-npm run build:esm    # Build ESM output only
-npm run build:types  # Build type declarations only
-```
-
-## Test Commands
-
-```bash
-npm test              # Run all tests (unit + integration)
-npm run test:unit     # Run unit tests only
-npm run test:whisper  # Run Whisper.cpp integration tests only
-npm run test:watch    # Run tests in watch mode
-npm run test:coverage # Run tests with coverage report
-```
-
-**Important**: Always run `npm test` after making changes to verify nothing is broken. Tests are located in the `test/` folder.
-
-Tests are written using Vitest and cover:
-- Provider selection logic (Whisper.cpp priority)
-- Error handling for all providers
-- Audio transcription functionality
-- API request formatting
-
-## Architecture
-
-This is a TypeScript npm package (`@derogab/stt-proxy`) that provides a unified interface for multiple STT providers. The entire implementation is in a single file: `src/index.ts`.
-
-### Provider Selection
-
-The `transcribe()` function automatically selects a provider based on environment variables in this priority order:
-1. **Whisper.cpp** - if `WHISPER_CPP_MODEL_PATH` is set
-
-### Build Output
-
-The package builds to three output formats:
-- `dist/cjs/` - CommonJS (for `require()`)
-- `dist/esm/` - ES Modules (for `import`)
-- `dist/types/` - TypeScript declarations

package/src/index.ts

@@ -1,174 +0,0 @@
-import 'dotenv/config';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-import { execSync } from 'child_process';
-import type { Whisper, TranscribeResult } from 'smart-whisper';
-
-export interface TranscribeOptions {
-  language?: string;
-  translate?: boolean;
-}
-
-export interface TranscribeOutput {
-  text: string;
-}
-
-let whisperInstance: Whisper | null = null;
-let currentModelPath: string | null = null;
-
-function getWhisperModelPath(): string | undefined {
-  return process.env['WHISPER_CPP_MODEL_PATH'];
-}
-
-function isWhisperConfigured(): boolean {
-  const modelPath = getWhisperModelPath();
-  return modelPath !== undefined && fs.existsSync(modelPath);
-}
-
-async function getWhisperInstance(): Promise<Whisper> {
-  const modelPath = getWhisperModelPath();
-
-  if (!modelPath) {
-    throw new Error('WHISPER_CPP_MODEL_PATH environment variable is not set');
-  }
-
-  if (!fs.existsSync(modelPath)) {
-    throw new Error(`Whisper model not found at path: ${modelPath}`);
-  }
-
-  if (whisperInstance && currentModelPath === modelPath) {
-    return whisperInstance;
-  }
-
-  if (whisperInstance) {
-    await whisperInstance.free();
-    whisperInstance = null;
-  }
-
-  const { Whisper } = await import('smart-whisper');
-  whisperInstance = new Whisper(modelPath, { gpu: true });
-  currentModelPath = modelPath;
-
-  return whisperInstance;
-}
-
-function audioToPcm(audioPath: string): Float32Array {
-  const tempDir = os.tmpdir();
-  const tempPcmPath = path.join(tempDir, `whisper_${Date.now()}_${Math.random().toString(36).substring(7)}.pcm`);
-
-  try {
-    execSync(
-      `ffmpeg -y -i "${audioPath}" -ar 16000 -ac 1 -f f32le "${tempPcmPath}"`,
-      { stdio: 'pipe' }
-    );
-
-    const pcmBuffer = fs.readFileSync(tempPcmPath);
-    return new Float32Array(pcmBuffer.buffer, pcmBuffer.byteOffset, pcmBuffer.length / 4);
-  } finally {
-    if (fs.existsSync(tempPcmPath)) {
-      fs.unlinkSync(tempPcmPath);
-    }
-  }
-}
-
-function cleanTranscription(text: string): string {
-  return text
-    .replace(/[\x00-\x1F\x7F]/g, '')
-    .trim();
-}
-
-function resultsToText(results: TranscribeResult<'simple'>[]): string {
-  return results.map((r) => r.text).join(' ');
-}
-
-async function transcribe_whispercpp(audioPath: string, options: TranscribeOptions = {}): Promise<TranscribeOutput> {
-  if (!fs.existsSync(audioPath)) {
-    throw new Error(`Audio file not found: ${audioPath}`);
-  }
-
-  const whisper = await getWhisperInstance();
-  const pcmData = audioToPcm(audioPath);
-
-  const transcribeParams: { language?: string; translate?: boolean; format: 'simple' } = {
-    format: 'simple',
-  };
-
-  if (options.language !== undefined) {
-    transcribeParams.language = options.language;
-  }
-
-  if (options.translate !== undefined) {
-    transcribeParams.translate = options.translate;
-  }
-
-  const task = await whisper.transcribe(pcmData, transcribeParams);
-  const results = await task.result;
-  const text = resultsToText(results);
-
-  return {
-    text: cleanTranscription(text),
-  };
-}
-
-export async function transcribe(audio: string | Buffer, options: TranscribeOptions = {}): Promise<TranscribeOutput> {
-  const modelPath = getWhisperModelPath();
-
-  if (modelPath) {
-    if (Buffer.isBuffer(audio)) {
-      return transcribeBuffer(audio, options);
-    }
-    return transcribe_whispercpp(audio, options);
-  }
-
-  throw new Error('No STT provider configured. Set WHISPER_CPP_MODEL_PATH environment variable.');
-}
-
-async function transcribeBuffer(audioBuffer: Buffer, options: TranscribeOptions = {}): Promise<TranscribeOutput> {
-  const modelPath = getWhisperModelPath();
-
-  if (!modelPath) {
-    throw new Error('No STT provider configured. Set WHISPER_CPP_MODEL_PATH environment variable.');
-  }
-
-  const tempDir = os.tmpdir();
-  const tempPath = path.join(tempDir, `whisper_input_${Date.now()}_${Math.random().toString(36).substring(7)}.audio`);
-
-  fs.writeFileSync(tempPath, audioBuffer);
-
-  try {
-    const result = await transcribe_whispercpp(tempPath, options);
-    return result;
-  } finally {
-    if (fs.existsSync(tempPath)) {
-      fs.unlinkSync(tempPath);
-    }
-  }
-}
-
-async function freeWhisper(): Promise<void> {
-  if (whisperInstance) {
-    await whisperInstance.free();
-    whisperInstance = null;
-    currentModelPath = null;
-  }
-}
-
-// Automatically clean up Whisper instance on process exit
-process.on('exit', () => {
-  if (whisperInstance) {
-    // Note: Cannot use async operations in 'exit' handler
-    // The instance will be cleaned up by the process termination
-    whisperInstance = null;
-    currentModelPath = null;
-  }
-});
-
-// Handle graceful shutdown signals
-const shutdownHandler = async () => {
-  await freeWhisper();
-  process.exit(0);
-};
-
-process.on('SIGINT', shutdownHandler);
-process.on('SIGTERM', shutdownHandler);

package/test/index.test.ts

@@ -1,128 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import * as fs from 'fs';
-
-vi.mock('fs', async () => {
-  const actual = await vi.importActual<typeof import('fs')>('fs');
-  return {
-    ...actual,
-    existsSync: vi.fn(),
-    readFileSync: vi.fn(),
-    writeFileSync: vi.fn(),
-    unlinkSync: vi.fn(),
-  };
-});
-
-vi.mock('child_process', () => ({
-  execSync: vi.fn(),
-}));
-
-vi.mock('smart-whisper', () => ({
-  Whisper: vi.fn().mockImplementation(() => ({
-    transcribe: vi.fn().mockResolvedValue({
-      result: Promise.resolve([{ text: 'Hello, world!', from: 0, to: 1000 }]),
-    }),
-    free: vi.fn().mockResolvedValue(undefined),
-  })),
-}));
-
-describe('stt-proxy', () => {
-  const originalEnv = process.env;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    process.env = { ...originalEnv };
-    delete process.env['WHISPER_CPP_MODEL_PATH'];
-  });
-
-  afterEach(() => {
-    process.env = originalEnv;
-    vi.resetModules();
-  });
-
-
-  describe('transcribe', () => {
-    it('should throw error when no provider is configured (string path)', async () => {
-      const { transcribe } = await import('../src/index.js');
-      await expect(transcribe('/path/to/audio.wav')).rejects.toThrow(
-        'No STT provider configured'
-      );
-    });
-
-    it('should throw error when no provider is configured (Buffer)', async () => {
-      const { transcribe } = await import('../src/index.js');
-      const buffer = Buffer.from('test');
-      await expect(transcribe(buffer)).rejects.toThrow(
-        'No STT provider configured'
-      );
-    });
-
-    it('should throw error when audio file does not exist', async () => {
-      process.env['WHISPER_CPP_MODEL_PATH'] = '/path/to/model.bin';
-      vi.mocked(fs.existsSync).mockImplementation((path) => {
-        if (path === '/path/to/model.bin') return true;
-        return false;
-      });
-      const { transcribe } = await import('../src/index.js');
-      await expect(transcribe('/path/to/audio.wav')).rejects.toThrow(
-        'Audio file not found'
-      );
-    });
-
-    it('should throw error when model file does not exist', async () => {
-      process.env['WHISPER_CPP_MODEL_PATH'] = '/path/to/model.bin';
-      vi.mocked(fs.existsSync).mockImplementation((path) => {
-        if (path === '/path/to/audio.wav') return true;
-        return false;
-      });
-      const { transcribe } = await import('../src/index.js');
-      await expect(transcribe('/path/to/audio.wav')).rejects.toThrow(
-        'Whisper model not found at path'
-      );
-    });
-
-    it('should successfully transcribe audio file', async () => {
-      process.env['WHISPER_CPP_MODEL_PATH'] = '/path/to/model.bin';
-      vi.mocked(fs.existsSync).mockReturnValue(true);
-      // Mock readFileSync to return a valid PCM buffer (Float32Array requires 4-byte aligned buffer)
-      const pcmData = new Float32Array([0.1, 0.2, 0.3]);
-      vi.mocked(fs.readFileSync).mockReturnValue(Buffer.from(pcmData.buffer));
-      const { transcribe } = await import('../src/index.js');
-
-      const result = await transcribe('/path/to/audio.wav');
-
-      expect(result).toBeDefined();
-      expect(result.text).toBe('Hello, world!');
-    });
-
-    it('should successfully transcribe audio from buffer', async () => {
-      process.env['WHISPER_CPP_MODEL_PATH'] = '/path/to/model.bin';
-      vi.mocked(fs.existsSync).mockReturnValue(true);
-      // Mock readFileSync to return a valid PCM buffer (Float32Array requires 4-byte aligned buffer)
-      const pcmData = new Float32Array([0.1, 0.2, 0.3]);
-      vi.mocked(fs.readFileSync).mockReturnValue(Buffer.from(pcmData.buffer));
-      const { transcribe } = await import('../src/index.js');
-
-      const audioBuffer = Buffer.from('fake audio data');
-      const result = await transcribe(audioBuffer);
-
-      expect(result).toBeDefined();
-      expect(result.text).toBe('Hello, world!');
-    });
-  });
-
-
-  describe('API exports', () => {
-    it('should export transcribe function', async () => {
-      const module = await import('../src/index.js');
-      expect(typeof module.transcribe).toBe('function');
-    });
-
-    it('should only export transcribe function (no other functions)', async () => {
-      const module = await import('../src/index.js');
-      const exportedFunctions = Object.keys(module).filter(
-        key => typeof module[key as keyof typeof module] === 'function'
-      );
-      expect(exportedFunctions).toEqual(['transcribe']);
-    });
-  });
-});

package/test/whisper-cpp.integration.test.ts

@@ -1,119 +0,0 @@
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as https from 'https';
-import * as http from 'http';
-
-const __dirname = path.dirname(new URL(import.meta.url).pathname);
-
-const TEST_MODEL_DIR = path.join(__dirname, 'models');
-const TEST_AUDIO_DIR = path.join(__dirname, 'audio');
-const MODEL_NAME = 'ggml-tiny.bin';
-const MODEL_PATH = path.join(TEST_MODEL_DIR, MODEL_NAME);
-const AUDIO_FILE = path.join(TEST_AUDIO_DIR, 'jfk.wav');
-
-const MODEL_URL = 'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny.bin';
-const JFK_AUDIO_URL = 'https://github.com/ggerganov/whisper.cpp/raw/master/samples/jfk.wav';
-
-async function downloadFile(url: string, destPath: string, maxRedirects = 10): Promise<void> {
-  return new Promise((resolve, reject) => {
-    if (maxRedirects <= 0) {
-      return reject(new Error('Too many redirects'));
-    }
-
-    const dir = path.dirname(destPath);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    const protocol = url.startsWith('https') ? https : http;
-
-    protocol.get(url, (response) => {
-      if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-        let redirectUrl = response.headers.location;
-        if (redirectUrl.startsWith('/')) {
-          const urlObj = new URL(url);
-          redirectUrl = `${urlObj.protocol}//${urlObj.host}${redirectUrl}`;
-        }
-        downloadFile(redirectUrl, destPath, maxRedirects - 1).then(resolve).catch(reject);
-        return;
-      } else if (response.statusCode === 200) {
-        const file = fs.createWriteStream(destPath);
-        response.pipe(file);
-        file.on('finish', () => {
-          file.close();
-          resolve();
-        });
-        file.on('error', (err) => {
-          fs.unlinkSync(destPath);
-          reject(err);
-        });
-      } else {
-        reject(new Error(`HTTP ${response.statusCode}`));
-      }
-    }).on('error', reject);
-  });
-}
-
-function normalizeTranscription(text: string): string {
-  return text.toLowerCase().replace(/[.,!?]/g, '').trim();
-}
-
-describe('whisper.cpp integration tests', () => {
-  let transcribe: typeof import('../src/index.js').transcribe;
-
-  beforeAll(async () => {
-    // Download model if needed
-    if (!fs.existsSync(MODEL_PATH) || fs.statSync(MODEL_PATH).size === 0) {
-      if (fs.existsSync(MODEL_PATH)) fs.unlinkSync(MODEL_PATH);
-      console.log(`Downloading Whisper tiny model to ${MODEL_PATH}...`);
-      console.log('This may take a few minutes on first run.');
-      await downloadFile(MODEL_URL, MODEL_PATH);
-      console.log('Model downloaded successfully.');
-    }
-
-    // Download audio if needed
-    if (!fs.existsSync(AUDIO_FILE) || fs.statSync(AUDIO_FILE).size === 0) {
-      if (fs.existsSync(AUDIO_FILE)) fs.unlinkSync(AUDIO_FILE);
-      console.log(`Downloading JFK test audio to ${AUDIO_FILE}...`);
-      await downloadFile(JFK_AUDIO_URL, AUDIO_FILE);
-      console.log('Audio downloaded successfully.');
-    }
-
-    // Set model path
-    process.env['WHISPER_CPP_MODEL_PATH'] = MODEL_PATH;
-
-    // Import module
-    const stt = await import('../src/index.js');
-    transcribe = stt.transcribe;
-  }, 600000); // 10 minute timeout for model download
-
-  it('should transcribe JFK speech audio file', async () => {
-    const result = await transcribe(AUDIO_FILE);
-
-    expect(result).toBeDefined();
-    expect(result.text).toBeDefined();
-    expect(typeof result.text).toBe('string');
-    expect(result.text.length).toBeGreaterThan(0);
-
-    const normalizedResult = normalizeTranscription(result.text);
-    expect(normalizedResult).toContain('ask not what your country can do for you');
-  }, 300000); // 5 minute timeout
-
-  it('should transcribe audio from buffer', async () => {
-    const audioBuffer = fs.readFileSync(AUDIO_FILE);
-    const result = await transcribe(audioBuffer);
-
-    expect(result).toBeDefined();
-    expect(result.text).toBeDefined();
-    expect(typeof result.text).toBe('string');
-    expect(result.text.length).toBeGreaterThan(0);
-
-    const normalizedResult = normalizeTranscription(result.text);
-    expect(normalizedResult).toContain('ask not what your country can do for you');
-  }, 300000); // 5 minute timeout
-
-  it('should throw error for non-existent audio file', async () => {
-    await expect(transcribe('/non/existent/audio.wav')).rejects.toThrow('Audio file not found');
-  });
-});

package/tsconfig.cjs.json

@@ -1,14 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "module": "commonjs",
-    "moduleResolution": "node",
-    "outDir": "./dist/cjs",
-    "declaration": false,
-    "declarationMap": false,
-    "verbatimModuleSyntax": false,
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["**/*.test.ts", "vitest.config.ts"]
-}

package/tsconfig.esm.json

@@ -1,14 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "outDir": "./dist/esm",
-    "declaration": false,
-    "declarationMap": false,
-    "verbatimModuleSyntax": false,
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["**/*.test.ts", "vitest.config.ts"]
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "target": "esnext",
-    "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "noUncheckedSideEffectImports": true,
-    "moduleDetection": "force",
-    "skipLibCheck": true
-  }
-}

package/tsconfig.types.json

@@ -1,15 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "outDir": "./dist/types",
-    "declaration": true,
-    "declarationMap": true,
-    "emitDeclarationOnly": true,
-    "verbatimModuleSyntax": false,
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["**/*.test.ts", "vitest.config.ts"]
-}

package/vitest.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    environment: 'node',
-    include: ['test/**/*.test.ts'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'html'],
-      include: ['src/**/*.ts'],
-    },
-  },
-});