@pico-brief/speech-services-parallel 1.0.0

package/dist/synthesizeParallel.js

@@ -0,0 +1,144 @@
+/**
+ * Parallel text-to-speech synthesis with audio concatenation.
+ *
+ * Each text chunk is synthesized independently (with retry and credential
+ * rotation), written to a temporary file to keep memory usage low, and then
+ * concatenated into a single audio buffer via ffmpeg (or `Buffer.concat` as
+ * a fallback). The result includes per-chunk metadata with timing offsets.
+ */
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { getAudioDuration } from "@pico-brief/audio-duration";
+import { KeyManager } from "./KeyManager.js";
+import { createClientFromCredential } from "./clientFactory.js";
+import { withRetry } from "./retry.js";
+import { mapWithConcurrency } from "./concurrency.js";
+import { generateRandomString, bufferToArrayBuffer } from "./helpers.js";
+import { detectAudioFormat, audioFormatToExtension } from "./audioFormat.js";
+const commander = promisify(exec);
+/** Directory for temporary chunk audio files. */
+const workdir = os.tmpdir();
+/**
+ * Synthesizes multiple text chunks into a single audio buffer in parallel.
+ *
+ * Chunks are processed concurrently (optionally limited by `maxConcurrency`),
+ * each with automatic retry and credential rotation. The resulting audio
+ * segments are concatenated via ffmpeg into one continuous file.
+ *
+ * @param params - Configuration including provider, credentials, text chunks, and options.
+ * @returns Combined audio buffer, format string, and per-chunk metadata with timing offsets.
+ *
+ * @example
+ * ```ts
+ * const result = await synthesizeParallel({
+ *   provider: "openai",
+ *   credentials: [{ apiKey: "sk-..." }],
+ *   chunks: [{ text: "Hello" }, { text: "World" }],
+ *   ffmpegPath: "ffmpeg",
+ * });
+ * fs.writeFileSync("output.mp3", result.audio);
+ * ```
+ */
+export async function synthesizeParallel(params) {
+    const { chunks, ffmpegPath } = params;
+    const retryTimeoutMs = params.retryTimeoutMs ?? 5 * 60 * 1000;
+    const { onProgress, signal, maxConcurrency } = params;
+    const provider = params.provider;
+    const defaultGender = params.gender;
+    const defaultVoice = params.voice;
+    const defaultLanguages = params.languages;
+    const defaultProviderOptions = params.providerOptions;
+    const keyManager = new KeyManager(params.credentials);
+    const tmpPrefix = path.join(workdir, generateRandomString());
+    const tmpFiles = [];
+    try {
+        // Synthesize all chunks with optional concurrency limiting.
+        // Each chunk is written to disk immediately to avoid holding all audio in memory.
+        let completed = 0;
+        const chunkMetas = await mapWithConcurrency(chunks, async (input, i) => {
+            // Merge per-chunk provider options on top of the defaults
+            const resolvedProviderOptions = input.providerOptions
+                ? { ...defaultProviderOptions, ...input.providerOptions }
+                : defaultProviderOptions;
+            const result = await withRetry({ keyManager, retryTimeoutMs, signal, operationName: "Synthesis" }, (credential) => {
+                const client = createClientFromCredential(provider, credential);
+                return client.synthesize({
+                    provider,
+                    text: input.text,
+                    gender: input.gender ?? defaultGender,
+                    voice: input.voice ?? defaultVoice,
+                    languages: input.languages ?? defaultLanguages,
+                    providerOptions: resolvedProviderOptions,
+                });
+            });
+            // Compute duration while the audio buffer is still in scope
+            const duration = getAudioDuration(bufferToArrayBuffer(result.audio));
+            // Write each chunk to disk immediately to free memory
+            const ext = audioFormatToExtension(detectAudioFormat(result.audio));
+            const chunkFile = `${tmpPrefix}_chunk_${i}.${ext}`;
+            fs.writeFileSync(chunkFile, result.audio);
+            tmpFiles.push(chunkFile);
+            onProgress?.(++completed, chunks.length);
+            return {
+                index: i,
+                duration,
+                voice: result.voice,
+                format: result.format,
+                chunkFile,
+            };
+        }, maxConcurrency);
+        // Sort by original index to ensure correct ordering
+        chunkMetas.sort((a, b) => a.index - b.index);
+        // Build per-chunk result metadata with cumulative start times
+        let timeAcc = 0;
+        const chunkResults = chunkMetas.map(({ index, duration, voice, format }) => {
+            const startTime = timeAcc;
+            timeAcc += duration;
+            // Try to derive language from voice name (e.g. "en-US-JennyNeural" → "en-US"),
+            // otherwise fall back to the first language in the languages array
+            const voiceParts = voice.split("-");
+            const resolvedLanguages = chunks[index].languages ?? params.languages;
+            const language = voiceParts.length >= 2
+                ? voiceParts.slice(0, 2).join("-")
+                : resolvedLanguages?.[0];
+            return { chunkIndex: index, startTime, duration, voice, language, format, provider };
+        });
+        const format = chunkMetas[0]?.format ?? "mp3";
+        // Concatenate all chunk audio files into a single output
+        let combinedAudio;
+        if (ffmpegPath) {
+            // Use ffmpeg's concat demuxer for seamless joining
+            const outExt = audioFormatToExtension(detectAudioFormat(fs.readFileSync(chunkMetas[0].chunkFile)));
+            const manifestFile = `${tmpPrefix}_manifest.txt`;
+            // ffmpeg concat demuxer requires single-quoted paths in the manifest
+            const manifestContent = chunkMetas
+                .map(m => `file '${m.chunkFile}'`)
+                .join("\n");
+            fs.writeFileSync(manifestFile, manifestContent);
+            tmpFiles.push(manifestFile);
+            const outFile = `${tmpPrefix}_out.${outExt}`;
+            tmpFiles.push(outFile);
+            await commander(`"${ffmpegPath}" -f concat -safe 0 -i "${manifestFile}" -c copy "${outFile}"`);
+            combinedAudio = fs.readFileSync(outFile);
+        }
+        else {
+            // Fallback: naive buffer concatenation (may produce audible glitches)
+            console.warn("ffmpegPath not set; using Buffer.concat — audio may not be seamlessly joined");
+            combinedAudio = Buffer.concat(chunkMetas.map(m => fs.readFileSync(m.chunkFile)));
+        }
+        return { audio: combinedAudio, format, chunks: chunkResults };
+    }
+    finally {
+        // Clean up all temporary files regardless of success or failure
+        for (const f of tmpFiles) {
+            try {
+                fs.unlinkSync(f);
+            }
+            catch { /* ignore cleanup errors */ }
+        }
+    }
+}
+//# sourceMappingURL=synthesizeParallel.js.map

package/dist/synthesizeParallel.js.map

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

package/dist/transcribeParallel.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Parallel audio transcription with automatic chunking.
+ *
+ * Long audio files are split into overlapping chunks via ffmpeg, each chunk is
+ * transcribed in parallel (with retry and credential rotation), and the results
+ * are merged back into a single {@link TranscribeResult} with word-level timing.
+ *
+ * Short audio (≤ one chunk) is transcribed directly without any splitting.
+ */
+import type { TranscribeResult } from "@pico-brief/speech-services";
+import type { TranscribeParallelParams } from "./types.js";
+/**
+ * Transcribes an audio buffer in parallel using the specified provider.
+ *
+ * If the audio is longer than `targetChunkDuration` (default 300 s), it is split
+ * into overlapping chunks via ffmpeg. Each chunk is sent to the provider with
+ * automatic retry, credential rotation, and optional concurrency limiting.
+ * Overlapping words at chunk boundaries are deduplicated during the merge step.
+ *
+ * @param params - Configuration including provider, credentials, audio data, and options.
+ * @returns A merged transcription result with full text, word-level timestamps, language, and duration.
+ *
+ * @example
+ * ```ts
+ * const result = await transcribeParallel({
+ *   provider: "openai",
+ *   credentials: [{ apiKey: "sk-..." }],
+ *   audio: fs.readFileSync("interview.mp3"),
+ *   ffmpegPath: "ffmpeg",
+ * });
+ * console.log(result.text);
+ * ```
+ */
+export declare function transcribeParallel(params: TranscribeParallelParams): Promise<TranscribeResult>;
+//# sourceMappingURL=transcribeParallel.d.ts.map

package/dist/transcribeParallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribeParallel.d.ts","sourceRoot":"","sources":["../src/transcribeParallel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,6BAA6B,CAAC;AAStF,OAAO,KAAK,EAAE,wBAAwB,EAAwB,MAAM,YAAY,CAAC;AAOjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoGpG"}

package/dist/transcribeParallel.js

@@ -0,0 +1,131 @@
+/**
+ * Parallel audio transcription with automatic chunking.
+ *
+ * Long audio files are split into overlapping chunks via ffmpeg, each chunk is
+ * transcribed in parallel (with retry and credential rotation), and the results
+ * are merged back into a single {@link TranscribeResult} with word-level timing.
+ *
+ * Short audio (≤ one chunk) is transcribed directly without any splitting.
+ */
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { getAudioDuration } from "@pico-brief/audio-duration";
+import { KeyManager } from "./KeyManager.js";
+import { createClientFromCredential } from "./clientFactory.js";
+import { mergeTranscribeResults } from "./merge.js";
+import { withRetry } from "./retry.js";
+import { mapWithConcurrency } from "./concurrency.js";
+import { generateRandomString, formatTimestamp, bufferToArrayBuffer } from "./helpers.js";
+import { detectAudioFormat, audioFormatToExtension } from "./audioFormat.js";
+const commander = promisify(exec);
+/** Directory for temporary chunk files created during splitting. */
+const workdir = os.tmpdir();
+/**
+ * Transcribes an audio buffer in parallel using the specified provider.
+ *
+ * If the audio is longer than `targetChunkDuration` (default 300 s), it is split
+ * into overlapping chunks via ffmpeg. Each chunk is sent to the provider with
+ * automatic retry, credential rotation, and optional concurrency limiting.
+ * Overlapping words at chunk boundaries are deduplicated during the merge step.
+ *
+ * @param params - Configuration including provider, credentials, audio data, and options.
+ * @returns A merged transcription result with full text, word-level timestamps, language, and duration.
+ *
+ * @example
+ * ```ts
+ * const result = await transcribeParallel({
+ *   provider: "openai",
+ *   credentials: [{ apiKey: "sk-..." }],
+ *   audio: fs.readFileSync("interview.mp3"),
+ *   ffmpegPath: "ffmpeg",
+ * });
+ * console.log(result.text);
+ * ```
+ */
+export async function transcribeParallel(params) {
+    const { audio, languages, ffmpegPath } = params;
+    const targetChunkDuration = params.targetChunkDuration ?? 300;
+    const chunkOverlap = params.chunkOverlap ?? 15;
+    const retryTimeoutMs = params.retryTimeoutMs ?? 5 * 60 * 1000;
+    const { onProgress, signal, maxConcurrency } = params;
+    const provider = params.provider;
+    const providerOptions = params.providerOptions;
+    const keyManager = new KeyManager(params.credentials);
+    /**
+     * Transcribes a single audio buffer using the provider with automatic retry
+     * and credential rotation.
+     */
+    const transcribeBuffer = (buffer) => {
+        return withRetry({ keyManager, retryTimeoutMs, signal, operationName: "Transcription" }, (credential) => {
+            const client = createClientFromCredential(provider, credential);
+            return client.transcribe({
+                provider,
+                audio: buffer,
+                languages,
+                providerOptions,
+            });
+        });
+    };
+    // Compute total duration and determine how many chunks we need
+    const totalDuration = getAudioDuration(bufferToArrayBuffer(audio));
+    const numChunks = Math.max(1, Math.round(totalDuration / targetChunkDuration));
+    // Single chunk — transcribe directly, no ffmpeg splitting needed
+    if (numChunks === 1)
+        return transcribeBuffer(audio);
+    // Multiple chunks — split the audio file and transcribe each piece
+    const ext = audioFormatToExtension(detectAudioFormat(audio));
+    const tmpPrefix = path.join(workdir, generateRandomString());
+    const srcFile = `${tmpPrefix}_src.${ext}`;
+    const tmpFiles = [srcFile];
+    try {
+        fs.writeFileSync(srcFile, audio);
+        // D = ideal duration of each chunk (before adding overlap)
+        const D = totalDuration / numChunks;
+        // Build chunk file paths and ownership boundaries
+        const chunkFiles = [];
+        const chunkMetas = [];
+        for (let i = 0; i < numChunks; i++) {
+            const chunkFile = `${tmpPrefix}_chunk_${i}.${ext}`;
+            tmpFiles.push(chunkFile);
+            chunkFiles.push(chunkFile);
+            // Each chunk "owns" a time range. Words outside this range are discarded
+            // during merge to eliminate duplicates from overlapping regions.
+            const ownedStart = i * D;
+            const ownedEnd = i < numChunks - 1 ? (i + 1) * D : Infinity;
+            chunkMetas.push({ ownedStart, ownedEnd });
+        }
+        // Slice all chunks in parallel via ffmpeg (each writes to a separate file).
+        // Slices extend beyond the owned range by `chunkOverlap` on each side so
+        // that words straddling chunk boundaries are captured by both neighbors.
+        await Promise.all(chunkFiles.map((chunkFile, i) => {
+            const sliceStart = Math.max(0, i * D - chunkOverlap);
+            const sliceEnd = Math.min(totalDuration, (i + 1) * D + chunkOverlap);
+            const startTs = formatTimestamp(sliceStart);
+            const endTs = formatTimestamp(sliceEnd);
+            return commander(`"${ffmpegPath}" -ss ${startTs} -to ${endTs} -i "${srcFile}" -c copy "${chunkFile}"`);
+        }));
+        // Transcribe each chunk with optional concurrency limiting
+        let completed = 0;
+        const chunkBoundaries = await mapWithConcurrency(chunkFiles, async (chunkFile, i) => {
+            const chunkBuffer = fs.readFileSync(chunkFile);
+            const result = await transcribeBuffer(chunkBuffer);
+            onProgress?.(++completed, numChunks);
+            return { result, ownedStart: chunkMetas[i].ownedStart, ownedEnd: chunkMetas[i].ownedEnd };
+        }, maxConcurrency);
+        // Merge all chunk results, deduplicating words at overlap boundaries
+        return mergeTranscribeResults(chunkBoundaries);
+    }
+    finally {
+        // Clean up all temporary files regardless of success or failure
+        for (const f of tmpFiles) {
+            try {
+                fs.unlinkSync(f);
+            }
+            catch { /* ignore cleanup errors */ }
+        }
+    }
+}
+//# sourceMappingURL=transcribeParallel.js.map

package/dist/transcribeParallel.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Type definitions for the parallel speech services API.
+ *
+ * This file defines the parameter and result types for {@link transcribeParallel}
+ * and {@link synthesizeParallel}. Discriminated unions are used so that TypeScript
+ * can narrow the credential and option types based on the chosen `provider`.
+ */
+import type { AssemblyAIConfig, AssemblyAITranscribeOptions, AzureConfig, AzureTranscribeOptions, AzureSynthesizeOptions, CartesiaConfig, CartesiaSynthesizeOptions, DeepgramConfig, DeepgramTranscribeOptions, DeepgramSynthesizeOptions, ElevenLabsConfig, ElevenLabsTranscribeOptions, ElevenLabsSynthesizeOptions, GoogleConfig, GoogleTranscribeOptions, GoogleSynthesizeOptions, OpenAIConfig, OpenAITranscribeOptions, OpenAISynthesizeOptions, PlayHTConfig, PlayHTSynthesizeOptions, RevAIConfig, RevAITranscribeOptions, SpeechmaticsConfig, SpeechmaticsTranscribeOptions } from "@pico-brief/speech-services";
+/** Maps each transcription provider name to its credential/config type. */
+export interface TranscribeProviderConfigMap {
+    azure: AzureConfig;
+    assemblyai: AssemblyAIConfig;
+    deepgram: DeepgramConfig;
+    elevenlabs: ElevenLabsConfig;
+    google: GoogleConfig;
+    openai: OpenAIConfig;
+    revai: RevAIConfig;
+    speechmatics: SpeechmaticsConfig;
+}
+/** Maps each synthesis provider name to its credential/config type. */
+export interface SynthesizeProviderConfigMap {
+    azure: AzureConfig;
+    cartesia: CartesiaConfig;
+    deepgram: DeepgramConfig;
+    elevenlabs: ElevenLabsConfig;
+    google: GoogleConfig;
+    openai: OpenAIConfig;
+    playht: PlayHTConfig;
+}
+/** Maps each transcription provider name to its provider-specific options type. */
+export interface TranscribeProviderOptionsMap {
+    azure: AzureTranscribeOptions;
+    assemblyai: AssemblyAITranscribeOptions;
+    deepgram: DeepgramTranscribeOptions;
+    elevenlabs: ElevenLabsTranscribeOptions;
+    google: GoogleTranscribeOptions;
+    openai: OpenAITranscribeOptions;
+    revai: RevAITranscribeOptions;
+    speechmatics: SpeechmaticsTranscribeOptions;
+}
+/** Maps each synthesis provider name to its provider-specific options type. */
+export interface SynthesizeProviderOptionsMap {
+    azure: AzureSynthesizeOptions;
+    cartesia: CartesiaSynthesizeOptions;
+    deepgram: DeepgramSynthesizeOptions;
+    elevenlabs: ElevenLabsSynthesizeOptions;
+    google: GoogleSynthesizeOptions;
+    openai: OpenAISynthesizeOptions;
+    playht: PlayHTSynthesizeOptions;
+}
+/** Shared (provider-agnostic) fields for {@link TranscribeParallelParams}. */
+type TranscribeParallelBase = {
+    /** Raw audio data to transcribe. */
+    audio: Buffer;
+    /** Language hints for the provider (e.g. `["en"]`). */
+    languages?: string[];
+    /** Target duration of each audio chunk in seconds. @default 300 */
+    targetChunkDuration?: number;
+    /** Overlap between adjacent chunks in seconds, to avoid losing words at boundaries. @default 15 */
+    chunkOverlap?: number;
+    /** Absolute path (or command name) for the ffmpeg binary used to split audio. */
+    ffmpegPath: string;
+    /** Maximum time in milliseconds to keep retrying transient failures. @default 300000 */
+    retryTimeoutMs?: number;
+    /** Maximum number of chunks to transcribe in parallel at once. Unlimited by default. */
+    maxConcurrency?: number;
+    /** Signal to cancel the operation early. */
+    signal?: AbortSignal;
+    /** Called each time a chunk finishes. `completed` counts up to `total`. */
+    onProgress?: (completed: number, total: number) => void;
+};
+/**
+ * Parameters for {@link transcribeParallel}.
+ *
+ * This is a discriminated union — setting `provider` to e.g. `"openai"` narrows
+ * `credentials` to `OpenAIConfig[]` and `providerOptions` to `OpenAITranscribeOptions`.
+ */
+export type TranscribeParallelParams = {
+    [P in keyof TranscribeProviderConfigMap]: TranscribeParallelBase & {
+        /** The speech-to-text provider to use. */
+        provider: P;
+        /** One or more credential objects for the chosen provider. Multiple credentials enable automatic rotation. */
+        credentials: TranscribeProviderConfigMap[P][];
+        /** Extra provider-specific options passed through to the underlying client. */
+        providerOptions?: TranscribeProviderOptionsMap[P];
+    };
+}[keyof TranscribeProviderConfigMap];
+/** A single text chunk to be synthesized, with optional per-chunk overrides. */
+export interface SynthesizeChunkInput {
+    /** The text content to convert to speech. */
+    text: string;
+    /** Override the default gender for this chunk. */
+    gender?: "male" | "female";
+    /** Override the default voice ID/name for this chunk. */
+    voice?: string;
+    /** Override the default languages for this chunk. */
+    languages?: string[];
+    /** Override the default provider options for this chunk. Merged on top of the top-level `providerOptions`. */
+    providerOptions?: Record<string, unknown>;
+}
+/** Metadata about a single synthesized chunk within the combined audio. */
+export interface SynthesizeChunkResult {
+    /** Zero-based index of this chunk in the original input array. */
+    chunkIndex: number;
+    /** Offset of this chunk within the combined audio, in seconds. */
+    startTime: number;
+    /** Duration of this chunk in seconds. */
+    duration: number;
+    /** The voice ID or name that was actually used. */
+    voice: string;
+    /** Language derived from the voice name or from the `languages` array. */
+    language?: string;
+    /** Audio format of this chunk (e.g. `"mp3"`). */
+    format: string;
+    /** The provider that produced this chunk. */
+    provider: string;
+}
+/** The combined result returned by {@link synthesizeParallel}. */
+export interface SynthesizeParallelResult {
+    /** The concatenated audio data for all chunks. */
+    audio: Buffer;
+    /** Audio format of the combined output (e.g. `"mp3"`). */
+    format: string;
+    /** Per-chunk metadata including timing offsets and voices used. */
+    chunks: SynthesizeChunkResult[];
+}
+/** Shared (provider-agnostic) fields for {@link SynthesizeParallelParams}. */
+type SynthesizeParallelBase = {
+    /** Array of text chunks to synthesize. */
+    chunks: SynthesizeChunkInput[];
+    /** Default voice gender applied to chunks that don't specify their own. */
+    gender?: "male" | "female";
+    /** Default voice ID/name applied to chunks that don't specify their own. */
+    voice?: string;
+    /** Default language hints applied to chunks that don't specify their own. */
+    languages?: string[];
+    /** Path to ffmpeg for concatenating chunk audio files. If omitted, `Buffer.concat` is used as a fallback. */
+    ffmpegPath?: string;
+    /** Maximum time in milliseconds to keep retrying transient failures. @default 300000 */
+    retryTimeoutMs?: number;
+    /** Maximum number of chunks to synthesize in parallel at once. Unlimited by default. */
+    maxConcurrency?: number;
+    /** Signal to cancel the operation early. */
+    signal?: AbortSignal;
+    /** Called each time a chunk finishes. `completed` counts up to `total`. */
+    onProgress?: (completed: number, total: number) => void;
+};
+/**
+ * Parameters for {@link synthesizeParallel}.
+ *
+ * This is a discriminated union — setting `provider` to e.g. `"elevenlabs"` narrows
+ * `credentials` to `ElevenLabsConfig[]` and `providerOptions` to `ElevenLabsSynthesizeOptions`.
+ */
+export type SynthesizeParallelParams = {
+    [P in keyof SynthesizeProviderConfigMap]: SynthesizeParallelBase & {
+        /** The text-to-speech provider to use. */
+        provider: P;
+        /** One or more credential objects for the chosen provider. Multiple credentials enable automatic rotation. */
+        credentials: SynthesizeProviderConfigMap[P][];
+        /** Extra provider-specific options passed through to the underlying client. */
+        providerOptions?: SynthesizeProviderOptionsMap[P];
+    };
+}[keyof SynthesizeProviderConfigMap];
+/** @internal Union of all transcription provider credential types. */
+export type TranscribeCredential = TranscribeProviderConfigMap[keyof TranscribeProviderConfigMap];
+/** @internal Union of all synthesis provider credential types. */
+export type SynthesizeCredential = SynthesizeProviderConfigMap[keyof SynthesizeProviderConfigMap];
+export {};
+//# 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":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACR,gBAAgB,EAChB,2BAA2B,EAC3B,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAChC,MAAM,6BAA6B,CAAC;AAIrC,2EAA2E;AAC3E,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,kBAAkB,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACxB;AAID,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,UAAU,EAAE,2BAA2B,CAAC;IACxC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,UAAU,EAAE,2BAA2B,CAAC;IACxC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,YAAY,EAAE,6BAA6B,CAAC;CAC/C;AAED,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,UAAU,EAAE,2BAA2B,CAAC;IACxC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,uBAAuB,CAAC;CACnC;AAID,8EAA8E;AAC9E,KAAK,sBAAsB,GAAG;IAC1B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;KAClC,CAAC,IAAI,MAAM,2BAA2B,GAAG,sBAAsB,GAAG;QAC/D,0CAA0C;QAC1C,QAAQ,EAAE,CAAC,CAAC;QACZ,8GAA8G;QAC9G,WAAW,EAAE,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,+EAA+E;QAC/E,eAAe,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC;KACrD;CACJ,CAAC,MAAM,2BAA2B,CAAC,CAAC;AAIrC,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACjC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8GAA8G;IAC9G,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,kEAAkE;AAClE,MAAM,WAAW,wBAAwB;IACrC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,8EAA8E;AAC9E,KAAK,sBAAsB,GAAG;IAC1B,0CAA0C;IAC1C,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;KAClC,CAAC,IAAI,MAAM,2BAA2B,GAAG,sBAAsB,GAAG;QAC/D,0CAA0C;QAC1C,QAAQ,EAAE,CAAC,CAAC;QACZ,8GAA8G;QAC9G,WAAW,EAAE,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,+EAA+E;QAC/E,eAAe,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC;KACrD;CACJ,CAAC,MAAM,2BAA2B,CAAC,CAAC;AAIrC,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,MAAM,2BAA2B,CAAC,CAAC;AAClG,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,MAAM,2BAA2B,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the parallel speech services API.
+ *
+ * This file defines the parameter and result types for {@link transcribeParallel}
+ * and {@link synthesizeParallel}. Discriminated unions are used so that TypeScript
+ * can narrow the credential and option types based on the chosen `provider`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "@pico-brief/speech-services-parallel",
+    "version": "1.0.0",
+    "description": "Parallel STT/TTS orchestration with credential rotation, built on @pico-brief/speech-services",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "npm run build && tsx --test test/*.test.ts",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/PicoBrief/speech-services-parallel.git"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "keywords": [
+        "speech-to-text",
+        "text-to-speech",
+        "stt",
+        "tts",
+        "parallel",
+        "credential-rotation",
+        "transcription",
+        "speech-synthesis"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "@pico-brief/audio-duration": "^1.0.0",
+        "@pico-brief/speech-services": "^1.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "dotenv": "^17.3.1",
+        "tsx": "^4.21.0",
+        "typescript": "^5.0.0"
+    }
+}