channelkit 1.0.0

package/dist/media/formatter.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * AI Data Formatter: transforms message text using AI providers.
+ *
+ * Uses a user-defined prompt to instruct the AI how to format/transform
+ * the incoming text (e.g. extract structured data, reformat, translate).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFormatProvider = createFormatProvider;
+function getApiKey(provider) {
+    const envMap = {
+        openai: 'OPENAI_API_KEY',
+        anthropic: 'ANTHROPIC_API_KEY',
+        google: 'GOOGLE_API_KEY',
+    };
+    const envVar = envMap[provider];
+    const key = envVar ? process.env[envVar] : undefined;
+    if (!key) {
+        throw new Error(`Missing API key for format provider "${provider}". Set ${envVar} in settings or environment.`);
+    }
+    return key;
+}
+class OpenAIFormatter {
+    apiKey;
+    model;
+    constructor(config) {
+        this.apiKey = getApiKey('openai');
+        this.model = config.model || 'gpt-4o-mini';
+    }
+    async format(text, prompt) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 30000);
+        try {
+            const res = await fetch('https://api.openai.com/v1/chat/completions', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [
+                        { role: 'system', content: prompt },
+                        { role: 'user', content: text },
+                    ],
+                    temperature: 0,
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const err = await res.text();
+                throw new Error(`OpenAI ${res.status}: ${err.substring(0, 200)}`);
+            }
+            const data = await res.json();
+            return data.choices?.[0]?.message?.content?.trim() || text;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+class AnthropicFormatter {
+    apiKey;
+    model;
+    constructor(config) {
+        this.apiKey = getApiKey('anthropic');
+        this.model = config.model || 'claude-sonnet-4-20250514';
+    }
+    async format(text, prompt) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 30000);
+        try {
+            const res = await fetch('https://api.anthropic.com/v1/messages', {
+                method: 'POST',
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'anthropic-version': '2023-06-01',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    max_tokens: 4096,
+                    system: prompt,
+                    messages: [
+                        { role: 'user', content: text },
+                    ],
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const err = await res.text();
+                throw new Error(`Anthropic ${res.status}: ${err.substring(0, 200)}`);
+            }
+            const data = await res.json();
+            return data.content?.[0]?.text?.trim() || text;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+class GoogleFormatter {
+    apiKey;
+    model;
+    constructor(config) {
+        this.apiKey = getApiKey('google');
+        this.model = config.model || 'gemini-2.5-flash';
+    }
+    async format(text, prompt) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 30000);
+        try {
+            const url = `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:generateContent?key=${this.apiKey}`;
+            const res = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    systemInstruction: { parts: [{ text: prompt }] },
+                    contents: [{ parts: [{ text }] }],
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const err = await res.text();
+                throw new Error(`Google ${res.status}: ${err.substring(0, 200)}`);
+            }
+            const data = await res.json();
+            return data.candidates?.[0]?.content?.parts?.[0]?.text?.trim() || text;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function createFormatProvider(config) {
+    switch (config.provider) {
+        case 'openai':
+            return new OpenAIFormatter(config);
+        case 'anthropic':
+            return new AnthropicFormatter(config);
+        case 'google':
+            return new GoogleFormatter(config);
+        default:
+            throw new Error(`Unknown format provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/media/formatter.js.map

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

package/dist/media/processor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MediaProcessor: handles STT/TTS/AI-formatting for the message pipeline
+ *
+ * Inbound:  voice message → STT → AI format → adds text to UnifiedMessage
+ * Outbound: webhook returns { voice: true } → TTS → sends audio
+ */
+import { ServiceConfig } from '../config/types';
+import { UnifiedMessage, WebhookResponse } from '../core/types';
+export interface InboundResult {
+    /** Whether AI formatting was applied to the message text */
+    formatApplied?: boolean;
+    /** Original message text before formatting (only set when formatting changed it) */
+    formatOriginalText?: string;
+    /** If formatting failed, the error message — signals the request should be cancelled */
+    formatError?: string;
+}
+/**
+ * Process inbound message:
+ * 1. If audio + STT configured → transcribe to text
+ * 2. If format configured → run AI formatting on text
+ * Mutates the message in place. Returns format processing info.
+ */
+export declare function processInbound(message: UnifiedMessage, serviceConfig: ServiceConfig): Promise<InboundResult>;
+export interface OutboundResult {
+    response: WebhookResponse;
+    ttsError?: string;
+}
+/**
+ * Process outbound response: if TTS is configured on the service, synthesize audio.
+ * Returns the response (with media buffer on success) and any TTS error.
+ */
+export declare function processOutbound(response: WebhookResponse, serviceConfig: ServiceConfig): Promise<OutboundResult>;
+//# sourceMappingURL=processor.d.ts.map

package/dist/media/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../src/media/processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA4ChE,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAkDlH;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAqBtH"}

package/dist/media/processor.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * MediaProcessor: handles STT/TTS/AI-formatting for the message pipeline
+ *
+ * Inbound:  voice message → STT → AI format → adds text to UnifiedMessage
+ * Outbound: webhook returns { voice: true } → TTS → sends audio
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processInbound = processInbound;
+exports.processOutbound = processOutbound;
+const stt_1 = require("./stt");
+const tts_1 = require("./tts");
+const formatter_1 = require("./formatter");
+const cache = {
+    stt: new Map(),
+    tts: new Map(),
+    format: new Map(),
+};
+function getSTT(config) {
+    if (!config.stt)
+        return null;
+    const key = `${config.stt.provider}:${config.stt.language || ''}`;
+    if (!cache.stt.has(key)) {
+        cache.stt.set(key, (0, stt_1.createSTTProvider)(config.stt));
+    }
+    return cache.stt.get(key);
+}
+function getTTS(config) {
+    if (!config.tts)
+        return null;
+    const key = `${config.tts.provider}:${config.tts.voice || ''}`;
+    if (!cache.tts.has(key)) {
+        cache.tts.set(key, (0, tts_1.createTTSProvider)(config.tts));
+    }
+    return cache.tts.get(key);
+}
+function getFormatter(config) {
+    if (!config.format)
+        return null;
+    const key = `${config.format.provider}:${config.format.model || 'default'}`;
+    if (!cache.format.has(key)) {
+        cache.format.set(key, (0, formatter_1.createFormatProvider)(config.format));
+    }
+    return cache.format.get(key);
+}
+/**
+ * Process inbound message:
+ * 1. If audio + STT configured → transcribe to text
+ * 2. If format configured → run AI formatting on text
+ * Mutates the message in place. Returns format processing info.
+ */
+async function processInbound(message, serviceConfig) {
+    const result = {};
+    // Step 1: STT — transcribe audio to text
+    if (message.type === 'audio' && serviceConfig.stt && message.media?.buffer) {
+        const stt = getSTT(serviceConfig);
+        if (stt) {
+            try {
+                const mimetype = message.media.mimetype || 'audio/ogg';
+                console.log(`[stt] Transcribing message ${message.id} (${mimetype}, ${message.media.buffer.length} bytes)...`);
+                const transcript = await stt.transcribe(message.media.buffer, mimetype, serviceConfig.stt.language);
+                if (transcript) {
+                    message.text = transcript;
+                    console.log(`[stt] Transcribed: "${transcript.substring(0, 80)}${transcript.length > 80 ? '...' : ''}"`);
+                }
+                else {
+                    console.log(`[stt] Empty transcription for message ${message.id}`);
+                }
+                // Clear media buffer after transcription unless forward_audio is enabled
+                if (!serviceConfig.stt.forward_audio) {
+                    delete message.media;
+                }
+            }
+            catch (err) {
+                console.error(`[stt] Transcription failed for message ${message.id}:`, err);
+            }
+        }
+    }
+    // Step 2: AI formatting — transform text using configured prompt
+    if (serviceConfig.format && message.text) {
+        const formatter = getFormatter(serviceConfig);
+        if (formatter) {
+            try {
+                console.log(`[format] Formatting message ${message.id} with ${serviceConfig.format.provider}...`);
+                const originalText = message.text;
+                const formatted = await formatter.format(message.text, serviceConfig.format.prompt);
+                if (formatted) {
+                    console.log(`[format] Result: "${formatted.substring(0, 80)}${formatted.length > 80 ? '...' : ''}"`);
+                    message.text = formatted;
+                    result.formatApplied = true;
+                    result.formatOriginalText = originalText;
+                }
+            }
+            catch (err) {
+                const errMsg = err?.message || String(err);
+                console.error(`[format] Formatting failed for message ${message.id}:`, errMsg);
+                result.formatError = errMsg.substring(0, 300);
+            }
+        }
+    }
+    return result;
+}
+/** Strip messaging formatting characters so TTS reads clean text. */
+function stripFormatting(text) {
+    return text
+        .replace(/\*([^*]+)\*/g, '$1') // *bold*
+        .replace(/_([^_]+)_/g, '$1') // _italic_
+        .replace(/~([^~]+)~/g, '$1') // ~strikethrough~
+        .replace(/```[\s\S]*?```/g, '') // ```code blocks```
+        .replace(/`([^`]+)`/g, '$1') // `inline code`
+        .replace(/^>\s?/gm, '') // > blockquote
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // [link text](url)
+        .replace(/!\[([^\]]*)\]\([^)]+\)/g, '$1') // ![alt](image url)
+        .replace(/^#{1,6}\s+/gm, '') // # headings
+        .replace(/^[-*+]\s+/gm, '') // bullet lists
+        .replace(/^\d+\.\s+/gm, '') // numbered lists
+        .trim();
+}
+/**
+ * Process outbound response: if TTS is configured on the service, synthesize audio.
+ * Returns the response (with media buffer on success) and any TTS error.
+ */
+async function processOutbound(response, serviceConfig) {
+    // Synthesize when TTS is configured on the service, unless the webhook explicitly opted out (voice: false)
+    if (response.voice === false || !response.text || !serviceConfig.tts)
+        return { response };
+    const tts = getTTS(serviceConfig);
+    if (!tts)
+        return { response };
+    try {
+        const ttsText = stripFormatting(response.text);
+        console.log(`[tts] Synthesizing: "${ttsText.substring(0, 80)}${ttsText.length > 80 ? '...' : ''}"`);
+        const { buffer, mimetype } = await tts.synthesize(ttsText, serviceConfig.tts.voice);
+        console.log(`[tts] Synthesized ${buffer.length} bytes (${mimetype})`);
+        return {
+            response: { ...response, media: { buffer, mimetype } },
+        };
+    }
+    catch (err) {
+        console.error(`[tts] Synthesis failed:`, err);
+        const errMsg = err?.message || String(err);
+        return { response, ttsError: errMsg.substring(0, 300) };
+    }
+}
+//# sourceMappingURL=processor.js.map

package/dist/media/processor.js.map

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

package/dist/media/stt.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Speech-to-Text providers for ChannelKit
+ */
+export interface STTProvider {
+    transcribe(audio: Buffer, mimetype: string, language?: string): Promise<string>;
+}
+export interface STTConfig {
+    provider: 'google' | 'whisper' | 'deepgram';
+    language?: string;
+    alternative_languages?: string[];
+}
+/**
+ * Create an STT provider instance
+ */
+export declare function createSTTProvider(config: STTConfig): STTProvider;
+//# sourceMappingURL=stt.d.ts.map

package/dist/media/stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt.d.ts","sourceRoot":"","sources":["../../src/media/stt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AA+QD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAWhE"}

package/dist/media/stt.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Speech-to-Text providers for ChannelKit
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSTTProvider = createSTTProvider;
+// Env var convention: <PROVIDER>_STT_API_KEY
+function getApiKey(provider) {
+    const key = process.env[`${provider.toUpperCase()}_STT_API_KEY`]
+        || process.env[`${provider.toUpperCase()}_API_KEY`];
+    if (!key) {
+        throw new Error(`Missing API key for STT provider "${provider}". Set ${provider.toUpperCase()}_STT_API_KEY or ${provider.toUpperCase()}_API_KEY environment variable.`);
+    }
+    return key;
+}
+/**
+ * Google Cloud Speech-to-Text (REST API)
+ * Supports both API key and Application Default Credentials (ADC).
+ * Priority: GOOGLE_STT_API_KEY > GOOGLE_API_KEY > ADC (gcloud auth)
+ */
+class GoogleSTT {
+    sttConfig;
+    apiKey;
+    constructor(sttConfig) {
+        this.sttConfig = sttConfig;
+        // API key is optional — fall back to ADC
+        this.apiKey = process.env.GOOGLE_STT_API_KEY
+            || process.env.GOOGLE_API_KEY
+            || null;
+    }
+    /**
+     * Get an access token from ADC (Application Default Credentials).
+     * Works when `gcloud auth application-default login` has been run,
+     * or when GOOGLE_APPLICATION_CREDENTIALS points to a service account JSON.
+     */
+    async getAccessToken() {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        const home = process.env.HOME || '~';
+        const candidates = [
+            process.env.GOOGLE_APPLICATION_CREDENTIALS,
+            `${home}/.config/google/stt-credentials.json`,
+            `${home}/.config/gcloud/application_default_credentials.json`,
+        ].filter(Boolean);
+        const credPath = candidates.find(p => fs.existsSync(p));
+        if (!credPath) {
+            throw new Error(`Google STT: No API key and no ADC found. Either set GOOGLE_STT_API_KEY / GOOGLE_API_KEY, ` +
+                `or run "gcloud auth application-default login".`);
+        }
+        const fsSync = await Promise.resolve().then(() => __importStar(require('fs')));
+        const creds = JSON.parse(fsSync.readFileSync(credPath, 'utf-8'));
+        // Service account JSON
+        if (creds.type === 'service_account') {
+            const jwt = await this.createServiceAccountJWT(creds);
+            return jwt;
+        }
+        // User credentials (from gcloud auth)
+        if (creds.type === 'authorized_user') {
+            const res = await fetch('https://oauth2.googleapis.com/token', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                body: new URLSearchParams({
+                    client_id: creds.client_id,
+                    client_secret: creds.client_secret,
+                    refresh_token: creds.refresh_token,
+                    grant_type: 'refresh_token',
+                }),
+            });
+            if (!res.ok)
+                throw new Error(`Failed to refresh Google token: ${res.status}`);
+            const data = await res.json();
+            return data.access_token;
+        }
+        throw new Error(`Unsupported Google credential type: ${creds.type}`);
+    }
+    async createServiceAccountJWT(creds) {
+        const crypto = await Promise.resolve().then(() => __importStar(require('crypto')));
+        const now = Math.floor(Date.now() / 1000);
+        const header = Buffer.from(JSON.stringify({ alg: 'RS256', typ: 'JWT' })).toString('base64url');
+        const payload = Buffer.from(JSON.stringify({
+            iss: creds.client_email,
+            scope: 'https://www.googleapis.com/auth/cloud-platform',
+            aud: 'https://oauth2.googleapis.com/token',
+            iat: now,
+            exp: now + 3600,
+        })).toString('base64url');
+        const signature = crypto.sign('RSA-SHA256', Buffer.from(`${header}.${payload}`), creds.private_key);
+        const jwt = `${header}.${payload}.${signature.toString('base64url')}`;
+        const res = await fetch('https://oauth2.googleapis.com/token', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+                assertion: jwt,
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to get service account token: ${res.status}`);
+        const data = await res.json();
+        return data.access_token;
+    }
+    async transcribe(audio, mimetype, language) {
+        const encoding = this.getEncoding(mimetype);
+        const langCode = language || this.sttConfig.language || 'en-US';
+        const config = {
+            encoding,
+            languageCode: langCode,
+            enableAutomaticPunctuation: true,
+        };
+        // WhatsApp Ogg/Opus files have sample rate 0 in the header, so always specify explicitly.
+        // WhatsApp voice notes are 16kHz; generic Opus is typically 48kHz.
+        config.sampleRateHertz = encoding === 'OGG_OPUS' ? 16000 : 16000;
+        // Auto language detection: add alternative languages
+        if (this.sttConfig.alternative_languages?.length) {
+            config.alternativeLanguageCodes = this.sttConfig.alternative_languages;
+        }
+        // Validate audio header
+        const magic = audio.slice(0, 4).toString('ascii');
+        if (encoding === 'OGG_OPUS' && magic !== 'OggS') {
+            console.warn(`[stt:google] Audio buffer does not start with OggS magic (got: ${magic}). Buffer may be corrupt.`);
+        }
+        const body = {
+            config,
+            audio: {
+                content: audio.toString('base64'),
+            },
+        };
+        // Use API key if available, otherwise ADC
+        let url;
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey) {
+            url = `https://speech.googleapis.com/v1/speech:recognize?key=${this.apiKey}`;
+        }
+        else {
+            const token = await this.getAccessToken();
+            url = 'https://speech.googleapis.com/v1/speech:recognize';
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        console.log(`[stt:google] Request config: encoding=${encoding}, lang=${langCode}, audioBytes=${audio.length}, magic=${magic}`);
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Google STT error: ${res.status} ${err}`);
+        }
+        const data = await res.json();
+        const results = data.results || [];
+        if (!results.length) {
+            console.log(`[stt:google] No results returned. Response: ${JSON.stringify(data).slice(0, 500)}`);
+        }
+        return results
+            .map((r) => r.alternatives?.[0]?.transcript || '')
+            .join(' ')
+            .trim();
+    }
+    getEncoding(mimetype) {
+        if (mimetype.includes('opus') || mimetype.includes('ogg'))
+            return 'OGG_OPUS';
+        if (mimetype.includes('flac'))
+            return 'FLAC';
+        if (mimetype.includes('wav'))
+            return 'LINEAR16';
+        if (mimetype.includes('mp3') || mimetype.includes('mpeg'))
+            return 'MP3';
+        if (mimetype.includes('webm'))
+            return 'WEBM_OPUS';
+        return 'OGG_OPUS'; // default for voice messages
+    }
+}
+/**
+ * OpenAI Whisper API
+ */
+class WhisperSTT {
+    apiKey;
+    constructor() {
+        this.apiKey = getApiKey('openai');
+    }
+    async transcribe(audio, mimetype, language) {
+        const ext = this.getExtension(mimetype);
+        const formData = new FormData();
+        formData.append('file', new Blob([new Uint8Array(audio)], { type: mimetype }), `audio.${ext}`);
+        formData.append('model', 'whisper-1');
+        if (language) {
+            // Whisper expects ISO 639-1 (e.g. 'he', 'en'), not full locale
+            formData.append('language', language.split('-')[0]);
+        }
+        const res = await fetch('https://api.openai.com/v1/audio/transcriptions', {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${this.apiKey}` },
+            body: formData,
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Whisper STT error: ${res.status} ${err}`);
+        }
+        const data = await res.json();
+        return (data.text || '').trim();
+    }
+    getExtension(mimetype) {
+        if (mimetype.includes('ogg') || mimetype.includes('opus'))
+            return 'ogg';
+        if (mimetype.includes('mp3') || mimetype.includes('mpeg'))
+            return 'mp3';
+        if (mimetype.includes('wav'))
+            return 'wav';
+        if (mimetype.includes('webm'))
+            return 'webm';
+        if (mimetype.includes('flac'))
+            return 'flac';
+        return 'ogg';
+    }
+}
+/**
+ * Deepgram STT API
+ */
+class DeepgramSTT {
+    apiKey;
+    constructor() {
+        this.apiKey = getApiKey('deepgram');
+    }
+    async transcribe(audio, mimetype, language) {
+        const params = new URLSearchParams({
+            model: 'nova-2',
+            punctuate: 'true',
+        });
+        if (language) {
+            params.set('language', language.split('-')[0]);
+        }
+        else {
+            params.set('detect_language', 'true');
+        }
+        const res = await fetch(`https://api.deepgram.com/v1/listen?${params}`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Token ${this.apiKey}`,
+                'Content-Type': mimetype,
+            },
+            body: audio,
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Deepgram STT error: ${res.status} ${err}`);
+        }
+        const data = await res.json();
+        return (data.results?.channels?.[0]?.alternatives?.[0]?.transcript || '').trim();
+    }
+}
+/**
+ * Create an STT provider instance
+ */
+function createSTTProvider(config) {
+    switch (config.provider) {
+        case 'google':
+            return new GoogleSTT(config);
+        case 'whisper':
+            return new WhisperSTT();
+        case 'deepgram':
+            return new DeepgramSTT();
+        default:
+            throw new Error(`Unknown STT provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=stt.js.map