nduka 1.0.0

package/dist/voice-pipeline/groq-whisper.js

@@ -0,0 +1,138 @@
+/**
+ * Groq Whisper Transcription Service
+ *
+ * Transcribes WhatsApp voice notes using Groq's Whisper API.
+ * Supports: whisper-large-v3 (accurate) and whisper-large-v3-turbo (fast).
+ *
+ * Endpoint: POST https://api.groq.com/openai/v1/audio/transcriptions
+ * Auth: Bearer GROQ_API_KEY
+ * Format: multipart/form-data with file + model
+ *
+ * WhatsApp voice notes are Opus in OGG container — Groq accepts OGG directly.
+ *
+ * Based on: https://console.groq.com/docs/speech-to-text
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+// ─── Config ──────────────────────────────────────────────────────────────────
+function loadEnvVar(key) {
+    if (process.env[key])
+        return process.env[key];
+    const envPath = resolve(process.cwd(), '.env');
+    if (existsSync(envPath)) {
+        const content = readFileSync(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const k = trimmed.slice(0, eqIdx).trim();
+            const v = trimmed.slice(eqIdx + 1).trim();
+            if (k === key && v)
+                return v;
+        }
+    }
+    return '';
+}
+const GROQ_API_KEY = loadEnvVar('GROQ_API_KEY');
+const GROQ_TRANSCRIBE_URL = 'https://api.groq.com/openai/v1/audio/transcriptions';
+// ─── Groq Whisper Service ────────────────────────────────────────────────────
+export class GroqWhisperService {
+    apiKey;
+    model;
+    constructor(model = 'whisper-large-v3-turbo') {
+        this.apiKey = GROQ_API_KEY;
+        this.model = model;
+    }
+    /** Check if the service is configured. */
+    isConfigured() {
+        return this.apiKey.length > 10;
+    }
+    /**
+     * Transcribe an audio file.
+     * @param filePath Path to the audio file (ogg, mp3, wav, etc.)
+     * @param language Optional language hint (e.g., 'en', 'ar', 'hi')
+     */
+    async transcribe(filePath, language, retries = 2) {
+        if (!this.isConfigured()) {
+            return { text: '', language: '', duration: 0, model: '', success: false, error: 'GROQ_API_KEY not configured' };
+        }
+        if (!existsSync(filePath)) {
+            return { text: '', language: '', duration: 0, model: '', success: false, error: `File not found: ${filePath}` };
+        }
+        const fileBuffer = readFileSync(filePath);
+        if (!fileBuffer || fileBuffer.length === 0) {
+            return { text: '', language: '', duration: 0, model: this.model, success: false, error: 'EMPTY_AUDIO_BUFFER' };
+        }
+        let lastError = '';
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const result = await this.transcribeBuffer(fileBuffer, filePath.split('/').pop() || 'audio.ogg', language);
+                if (result.success)
+                    return result;
+                lastError = result.error || 'Unknown error';
+            }
+            catch (err) {
+                lastError = err.message;
+            }
+            if (attempt < retries) {
+                await new Promise(r => setTimeout(r, 500 * (attempt + 1)));
+            }
+        }
+        return { text: '', language: '', duration: 0, model: this.model, success: false, error: lastError };
+    }
+    /**
+     * Transcribe audio from a buffer (in-memory).
+     */
+    async transcribeBuffer(buffer, fileName = 'audio.ogg', language) {
+        if (!this.isConfigured()) {
+            return { text: '', language: '', duration: 0, model: '', success: false, error: 'GROQ_API_KEY not configured' };
+        }
+        if (!buffer || buffer.length === 0) {
+            return { text: '', language: '', duration: 0, model: this.model, success: false, error: 'EMPTY_AUDIO_BUFFER' };
+        }
+        try {
+            const blob = new Blob([buffer]);
+            const formData = new FormData();
+            formData.append('file', blob, fileName);
+            formData.append('model', this.model);
+            if (language)
+                formData.append('language', language);
+            formData.append('response_format', 'json');
+            const response = await fetch(GROQ_TRANSCRIBE_URL, {
+                method: 'POST',
+                headers: { 'Authorization': `Bearer ${this.apiKey}` },
+                body: formData,
+            });
+            if (!response.ok) {
+                const errBody = await response.text();
+                return { text: '', language: '', duration: 0, model: this.model, success: false, error: `HTTP ${response.status}` };
+            }
+            const data = await response.json();
+            return {
+                text: data.text || '',
+                language: data.language || 'unknown',
+                duration: data.duration || 0,
+                model: this.model,
+                success: true,
+            };
+        }
+        catch (err) {
+            return { text: '', language: '', duration: 0, model: this.model, success: false, error: err.message };
+        }
+    }
+    /** Format transcription for WhatsApp display. */
+    formatForChat(result, originalSender) {
+        if (!result.success)
+            return `🎤 Voice note transcription failed: ${result.error}`;
+        const parts = [];
+        if (originalSender)
+            parts.push(`🎤 *Voice Note from ${originalSender}*`);
+        parts.push(result.text);
+        parts.push(`_(${result.language}, ${Math.round(result.duration)}s, ${result.model})_`);
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=groq-whisper.js.map

package/dist/voice-pipeline/groq-whisper.js.map

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

package/dist/voice-pipeline/index.d.ts

@@ -0,0 +1,5 @@
+export { VoiceTTSEngine, SearchEngine, KnowledgeEngine } from './combined.js';
+export { GroqWhisperService } from './groq-whisper.js';
+export type { VoiceJob, VoiceProvider, TTSSynthesisJob, SearchResult, SearchQuery, SearchProvider, KnowledgeDocument, KnowledgeChunk } from './combined.js';
+export type { TranscriptionResult, WhisperModel } from './groq-whisper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/voice-pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5J,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/voice-pipeline/index.js

@@ -0,0 +1,3 @@
+export { VoiceTTSEngine, SearchEngine, KnowledgeEngine } from './combined.js';
+export { GroqWhisperService } from './groq-whisper.js';
+//# sourceMappingURL=index.js.map

package/dist/voice-pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}