@supertone/supertone 0.1.0

package/dist/commonjs/lib/custom_utils/audio_utils.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * TTS Audio Processing Utilities
+ *
+ * Stateless utility functions for WAV and MP3 audio manipulation.
+ * Provides binary-level audio processing without external dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeWavBinary = mergeWavBinary;
+exports.mergeMp3Binary = mergeMp3Binary;
+exports.removeWavHeader = removeWavHeader;
+exports.removeMp3Header = removeMp3Header;
+exports.detectAudioFormat = detectAudioFormat;
+exports.extractAudioFromResponse = extractAudioFromResponse;
+exports.extractAudioFromResponses = extractAudioFromResponses;
+const constants_js_1 = require("./constants.js");
+/**
+ * Merge binary WAV data chunks into a single WAV file.
+ *
+ * Extracts audio data from each chunk, combines them, and creates a new
+ * WAV header with correct file size information. Preserves audio format
+ * parameters (channels, sample rate, etc.) from the first chunk.
+ *
+ * @param audioChunks - Array of binary WAV data to merge
+ * @returns Merged WAV file as binary data
+ */
+function mergeWavBinary(audioChunks) {
+    if (!audioChunks || audioChunks.length === 0) {
+        return new Uint8Array(0);
+    }
+    const firstAudioData = audioChunks[0];
+    if (!firstAudioData || firstAudioData.length < constants_js_1.WAV_HEADER_SIZE) {
+        throw new Error("Invalid WAV data: first chunk is too small");
+    }
+    // Parse WAV header from first chunk
+    const wavHeader = firstAudioData.slice(0, constants_js_1.WAV_HEADER_SIZE);
+    const channels = readUint16LE(wavHeader, 22);
+    const sampleRate = readUint32LE(wavHeader, 24);
+    const byteRate = readUint32LE(wavHeader, 28);
+    const blockAlign = readUint16LE(wavHeader, 32);
+    const bitsPerSample = readUint16LE(wavHeader, 34);
+    // Collect all audio data (skip headers)
+    const allAudioData = [];
+    for (const audioData of audioChunks) {
+        // Skip WAV header and extract only audio data
+        if (audioData.length >= constants_js_1.WAV_HEADER_SIZE &&
+            arrayStartsWith(audioData, "RIFF")) {
+            // Find data chunk
+            let pos = constants_js_1.WAV_RIFF_HEADER_SIZE;
+            while (pos < audioData.length - constants_js_1.WAV_CHUNK_HEADER_SIZE) {
+                const chunkId = arrayToString(audioData.slice(pos, pos + 4));
+                const chunkSize = readUint32LE(audioData, pos + 4);
+                if (chunkId === "data") {
+                    allAudioData.push(audioData.slice(pos + 8, pos + 8 + chunkSize));
+                    break;
+                }
+                pos += 8 + chunkSize;
+            }
+        }
+        else {
+            allAudioData.push(audioData);
+        }
+    }
+    // Merge all audio data
+    const mergedAudioData = concatUint8Arrays(allAudioData);
+    const totalLength = mergedAudioData.length;
+    const fileSize = totalLength + constants_js_1.WAV_RIFF_HEADER_SIZE;
+    // Create new WAV file header
+    const mergedWav = new Uint8Array(constants_js_1.WAV_HEADER_SIZE + totalLength);
+    let offset = 0;
+    // RIFF header
+    writeString(mergedWav, offset, "RIFF");
+    offset += 4;
+    writeUint32LE(mergedWav, offset, fileSize);
+    offset += 4;
+    writeString(mergedWav, offset, "WAVE");
+    offset += 4;
+    // fmt chunk
+    writeString(mergedWav, offset, "fmt ");
+    offset += 4;
+    writeUint32LE(mergedWav, offset, 16); // fmt chunk size
+    offset += 4;
+    writeUint16LE(mergedWav, offset, 1); // audio format (PCM)
+    offset += 2;
+    writeUint16LE(mergedWav, offset, channels);
+    offset += 2;
+    writeUint32LE(mergedWav, offset, sampleRate);
+    offset += 4;
+    writeUint32LE(mergedWav, offset, byteRate);
+    offset += 4;
+    writeUint16LE(mergedWav, offset, blockAlign);
+    offset += 2;
+    writeUint16LE(mergedWav, offset, bitsPerSample);
+    offset += 2;
+    // data chunk
+    writeString(mergedWav, offset, "data");
+    offset += 4;
+    writeUint32LE(mergedWav, offset, totalLength);
+    offset += 4;
+    // Audio data
+    mergedWav.set(mergedAudioData, offset);
+    return mergedWav;
+}
+/**
+ * Merge MP3 audio chunks using simple concatenation.
+ *
+ * This is a practical approach for MP3 merging. For more advanced
+ * MP3 merging with proper frame handling, consider using external libraries.
+ *
+ * @param audioChunks - Array of binary MP3 data to merge
+ * @returns Concatenated MP3 data
+ */
+function mergeMp3Binary(audioChunks) {
+    if (!audioChunks || audioChunks.length === 0) {
+        return new Uint8Array(0);
+    }
+    return concatUint8Arrays(audioChunks);
+}
+/**
+ * Remove WAV header from audio data.
+ *
+ * Used for intermediate chunks when merging multiple WAV files.
+ * Finds the "data" chunk and returns only the audio data portion.
+ *
+ * @param audioData - Binary WAV data with header
+ * @returns Binary audio data without header
+ */
+function removeWavHeader(audioData) {
+    if (audioData.length >= constants_js_1.WAV_HEADER_SIZE &&
+        arrayStartsWith(audioData, "RIFF")) {
+        // Find "data" chunk
+        const dataPos = findSubarray(audioData, stringToBytes("data"));
+        if (dataPos > 0) {
+            // Skip "data" + 4-byte size info
+            return audioData.slice(dataPos + 8);
+        }
+    }
+    return audioData;
+}
+/**
+ * Remove MP3 ID3 tags (v1 and v2) from audio data.
+ *
+ * Handles both ID3v2 tags (at the beginning) and ID3v1 tags (at the end).
+ * Returns pure MPEG audio data without metadata.
+ *
+ * @param mp3Data - Binary MP3 data with headers
+ * @returns Binary MP3 data without ID3 tags
+ */
+function removeMp3Header(mp3Data) {
+    let data = mp3Data;
+    // Remove ID3v2 tag (at beginning)
+    if (data.length >= constants_js_1.MP3_ID3V2_HEADER_SIZE && arrayStartsWith(data, "ID3")) {
+        // Safe access with non-null assertions after length check
+        const size = ((data[6] << 21) | (data[7] << 14) | (data[8] << 7) | data[9]) >>> 0;
+        let headerSize = constants_js_1.MP3_ID3V2_HEADER_SIZE;
+        if (data[5] & 0x10) {
+            // Footer present
+            headerSize += constants_js_1.MP3_ID3V2_HEADER_SIZE;
+        }
+        data = data.slice(headerSize + size);
+    }
+    // Remove ID3v1 tag (at end of file)
+    if (data.length >= constants_js_1.MP3_ID3V1_TAG_POS &&
+        arrayToString(data.slice(-constants_js_1.MP3_ID3V1_TAG_POS, -constants_js_1.MP3_ID3V1_TAG_POS + 3)) ===
+            "TAG") {
+        data = data.slice(0, -constants_js_1.MP3_ID3V1_TAG_POS);
+    }
+    return data;
+}
+/**
+ * Detect audio format from binary data.
+ *
+ * Examines the first few bytes to determine if the data is WAV, MP3,
+ * or unknown format.
+ *
+ * @param audioData - Binary audio data
+ * @returns Format string: 'wav', 'mp3', or 'unknown'
+ */
+function detectAudioFormat(audioData) {
+    if (audioData.length >= 4 && arrayStartsWith(audioData, "RIFF")) {
+        return "wav";
+    }
+    else if (audioData.length >= 3 && arrayStartsWith(audioData, "ID3")) {
+        return "mp3";
+    }
+    else if (audioData.length >= 2 &&
+        audioData[0] === 0xff &&
+        (audioData[1] === 0xfb || audioData[1] === 0xfa)) {
+        return "mp3";
+    }
+    return "unknown";
+}
+/**
+ * Extract audio data from response object.
+ *
+ * Handles ReadableStream and direct content types.
+ *
+ * @param response - Response object
+ * @returns Binary audio data
+ */
+async function extractAudioFromResponse(response) {
+    // If response is already binary data
+    if (response instanceof Uint8Array) {
+        return response;
+    }
+    // If response is ReadableStream
+    if (response instanceof ReadableStream) {
+        const reader = response.getReader();
+        const chunks = [];
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+        }
+        return concatUint8Arrays(chunks);
+    }
+    // If response is an object with content
+    if (response && typeof response === "object") {
+        if (response.content instanceof Uint8Array) {
+            return response.content;
+        }
+        if (response.data instanceof Uint8Array) {
+            return response.data;
+        }
+    }
+    // Fallback: convert to Uint8Array
+    return new Uint8Array(0);
+}
+/**
+ * Extract audio data from multiple responses.
+ *
+ * @param responses - Array of response objects
+ * @returns Array of extracted binary audio data
+ */
+async function extractAudioFromResponses(responses) {
+    const audioChunks = [];
+    for (const response of responses) {
+        const audioData = await extractAudioFromResponse(response);
+        audioChunks.push(audioData);
+    }
+    return audioChunks;
+}
+// Helper functions
+function readUint16LE(buffer, offset) {
+    if (offset + 1 >= buffer.length) {
+        throw new Error(`Buffer overflow: trying to read at offset ${offset}`);
+    }
+    return buffer[offset] | (buffer[offset + 1] << 8);
+}
+function readUint32LE(buffer, offset) {
+    if (offset + 3 >= buffer.length) {
+        throw new Error(`Buffer overflow: trying to read at offset ${offset}`);
+    }
+    return (buffer[offset] |
+        (buffer[offset + 1] << 8) |
+        (buffer[offset + 2] << 16) |
+        (buffer[offset + 3] << 24));
+}
+function writeUint16LE(buffer, offset, value) {
+    if (offset + 1 >= buffer.length) {
+        throw new Error(`Buffer overflow: trying to write at offset ${offset}`);
+    }
+    buffer[offset] = value & 0xff;
+    buffer[offset + 1] = (value >> 8) & 0xff;
+}
+function writeUint32LE(buffer, offset, value) {
+    if (offset + 3 >= buffer.length) {
+        throw new Error(`Buffer overflow: trying to write at offset ${offset}`);
+    }
+    buffer[offset] = value & 0xff;
+    buffer[offset + 1] = (value >> 8) & 0xff;
+    buffer[offset + 2] = (value >> 16) & 0xff;
+    buffer[offset + 3] = (value >> 24) & 0xff;
+}
+function writeString(buffer, offset, str) {
+    if (offset + str.length > buffer.length) {
+        throw new Error(`Buffer overflow: trying to write string at offset ${offset}`);
+    }
+    for (let i = 0; i < str.length; i++) {
+        buffer[offset + i] = str.charCodeAt(i);
+    }
+}
+function arrayToString(buffer) {
+    return String.fromCharCode(...Array.from(buffer));
+}
+function stringToBytes(str) {
+    const bytes = new Uint8Array(str.length);
+    for (let i = 0; i < str.length; i++) {
+        bytes[i] = str.charCodeAt(i);
+    }
+    return bytes;
+}
+function arrayStartsWith(buffer, str) {
+    if (buffer.length < str.length)
+        return false;
+    for (let i = 0; i < str.length; i++) {
+        if (buffer[i] !== str.charCodeAt(i))
+            return false;
+    }
+    return true;
+}
+function findSubarray(haystack, needle) {
+    for (let i = 0; i <= haystack.length - needle.length; i++) {
+        let found = true;
+        for (let j = 0; j < needle.length; j++) {
+            if (haystack[i + j] !== needle[j]) {
+                found = false;
+                break;
+            }
+        }
+        if (found)
+            return i;
+    }
+    return -1;
+}
+function concatUint8Arrays(arrays) {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}
+//# sourceMappingURL=audio_utils.js.map

package/dist/commonjs/lib/custom_utils/audio_utils.js.map

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

package/dist/commonjs/lib/custom_utils/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TTS Custom Constants
+ *
+ * Audio format and text processing constants used across TTS operations.
+ * These constants are part of the custom implementation for automatic
+ * text chunking and audio merging functionality.
+ */
+export declare const WAV_HEADER_SIZE = 44;
+export declare const WAV_RIFF_HEADER_SIZE = 36;
+export declare const WAV_CHUNK_HEADER_SIZE = 8;
+export declare const MP3_ID3V2_HEADER_SIZE = 10;
+export declare const MP3_ID3V1_TAG_POS = 128;
+export declare const DEFAULT_STREAM_CHUNK_SIZE = 8192;
+export declare const DEFAULT_MAX_TEXT_LENGTH = 300;
+export declare const MAX_PARALLEL_WORKERS = 3;
+//# sourceMappingURL=constants.d.ts.map

package/dist/commonjs/lib/custom_utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom_utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAG9C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/dist/commonjs/lib/custom_utils/constants.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * TTS Custom Constants
+ *
+ * Audio format and text processing constants used across TTS operations.
+ * These constants are part of the custom implementation for automatic
+ * text chunking and audio merging functionality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PARALLEL_WORKERS = exports.DEFAULT_MAX_TEXT_LENGTH = exports.DEFAULT_STREAM_CHUNK_SIZE = exports.MP3_ID3V1_TAG_POS = exports.MP3_ID3V2_HEADER_SIZE = exports.WAV_CHUNK_HEADER_SIZE = exports.WAV_RIFF_HEADER_SIZE = exports.WAV_HEADER_SIZE = void 0;
+// Audio format constants
+exports.WAV_HEADER_SIZE = 44;
+exports.WAV_RIFF_HEADER_SIZE = 36;
+exports.WAV_CHUNK_HEADER_SIZE = 8;
+exports.MP3_ID3V2_HEADER_SIZE = 10;
+exports.MP3_ID3V1_TAG_POS = 128; // Position from end of file
+exports.DEFAULT_STREAM_CHUNK_SIZE = 8192;
+// Text chunking constants
+exports.DEFAULT_MAX_TEXT_LENGTH = 300;
+// Parallel processing constants
+exports.MAX_PARALLEL_WORKERS = 3; // Number of workers for parallel processing
+//# sourceMappingURL=constants.js.map

package/dist/commonjs/lib/custom_utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/lib/custom_utils/constants.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,yBAAyB;AACZ,QAAA,eAAe,GAAG,EAAE,CAAC;AACrB,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAC1B,QAAA,qBAAqB,GAAG,CAAC,CAAC;AAC1B,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAC3B,QAAA,iBAAiB,GAAG,GAAG,CAAC,CAAC,4BAA4B;AACrD,QAAA,yBAAyB,GAAG,IAAI,CAAC;AAE9C,0BAA0B;AACb,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C,gCAAgC;AACnB,QAAA,oBAAoB,GAAG,CAAC,CAAC,CAAC,4CAA4C"}

package/dist/commonjs/lib/custom_utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Custom Utilities for TTS SDK
+ *
+ * This module provides custom utilities for text-to-speech operations,
+ * including automatic text chunking, audio merging, and phoneme processing.
+ */
+export * from "./constants.js";
+export { chunkText, extractAudioFromNdjson } from "./text_utils.js";
+export { mergeWavBinary, mergeMp3Binary, removeWavHeader, removeMp3Header, detectAudioFormat, extractAudioFromResponse, extractAudioFromResponses, } from "./audio_utils.js";
+export { mergePhonemeData, adjustPhonemeTiming, createEmptyPhonemeDict, type PhonemeData, } from "./phoneme_utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/lib/custom_utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom_utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACN,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,WAAW,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/commonjs/lib/custom_utils/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Custom Utilities for TTS SDK
+ *
+ * This module provides custom utilities for text-to-speech operations,
+ * including automatic text chunking, audio merging, and phoneme processing.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmptyPhonemeDict = exports.adjustPhonemeTiming = exports.mergePhonemeData = exports.extractAudioFromResponses = exports.extractAudioFromResponse = exports.detectAudioFormat = exports.removeMp3Header = exports.removeWavHeader = exports.mergeMp3Binary = exports.mergeWavBinary = exports.extractAudioFromNdjson = exports.chunkText = void 0;
+// Export all constants
+__exportStar(require("./constants.js"), exports);
+// Export text utilities
+var text_utils_js_1 = require("./text_utils.js");
+Object.defineProperty(exports, "chunkText", { enumerable: true, get: function () { return text_utils_js_1.chunkText; } });
+Object.defineProperty(exports, "extractAudioFromNdjson", { enumerable: true, get: function () { return text_utils_js_1.extractAudioFromNdjson; } });
+// Export audio utilities
+var audio_utils_js_1 = require("./audio_utils.js");
+Object.defineProperty(exports, "mergeWavBinary", { enumerable: true, get: function () { return audio_utils_js_1.mergeWavBinary; } });
+Object.defineProperty(exports, "mergeMp3Binary", { enumerable: true, get: function () { return audio_utils_js_1.mergeMp3Binary; } });
+Object.defineProperty(exports, "removeWavHeader", { enumerable: true, get: function () { return audio_utils_js_1.removeWavHeader; } });
+Object.defineProperty(exports, "removeMp3Header", { enumerable: true, get: function () { return audio_utils_js_1.removeMp3Header; } });
+Object.defineProperty(exports, "detectAudioFormat", { enumerable: true, get: function () { return audio_utils_js_1.detectAudioFormat; } });
+Object.defineProperty(exports, "extractAudioFromResponse", { enumerable: true, get: function () { return audio_utils_js_1.extractAudioFromResponse; } });
+Object.defineProperty(exports, "extractAudioFromResponses", { enumerable: true, get: function () { return audio_utils_js_1.extractAudioFromResponses; } });
+// Export phoneme utilities
+var phoneme_utils_js_1 = require("./phoneme_utils.js");
+Object.defineProperty(exports, "mergePhonemeData", { enumerable: true, get: function () { return phoneme_utils_js_1.mergePhonemeData; } });
+Object.defineProperty(exports, "adjustPhonemeTiming", { enumerable: true, get: function () { return phoneme_utils_js_1.adjustPhonemeTiming; } });
+Object.defineProperty(exports, "createEmptyPhonemeDict", { enumerable: true, get: function () { return phoneme_utils_js_1.createEmptyPhonemeDict; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/lib/custom_utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/custom_utils/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,uBAAuB;AACvB,iDAA+B;AAE/B,wBAAwB;AACxB,iDAAoE;AAA3D,0GAAA,SAAS,OAAA;AAAE,uHAAA,sBAAsB,OAAA;AAE1C,yBAAyB;AACzB,mDAQ0B;AAPzB,gHAAA,cAAc,OAAA;AACd,gHAAA,cAAc,OAAA;AACd,iHAAA,eAAe,OAAA;AACf,iHAAA,eAAe,OAAA;AACf,mHAAA,iBAAiB,OAAA;AACjB,0HAAA,wBAAwB,OAAA;AACxB,2HAAA,yBAAyB,OAAA;AAG1B,2BAA2B;AAC3B,uDAK4B;AAJ3B,oHAAA,gBAAgB,OAAA;AAChB,uHAAA,mBAAmB,OAAA;AACnB,0HAAA,sBAAsB,OAAA"}

package/dist/commonjs/lib/custom_utils/phoneme_utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TTS Phoneme Processing Utilities
+ *
+ * Stateless utility functions for phoneme data merging and timing adjustment.
+ * These functions handle the synchronization of phoneme timing data across
+ * multiple audio chunks.
+ */
+export interface PhonemeData {
+    symbols: string[];
+    durations_seconds: number[];
+    start_times_seconds: number[];
+}
+/**
+ * Merge multiple phoneme data chunks with automatic time offset adjustment.
+ *
+ * Handles the merging of phoneme data from multiple TTS chunks, ensuring
+ * continuous timing by adjusting start times and maintaining duration
+ * offsets. The first chunk's start time is normalized to 0, and
+ * subsequent chunks are offset accordingly.
+ *
+ * @param phonemeChunks - Array of phoneme dictionaries
+ * @returns Merged phoneme dictionary with adjusted timing
+ */
+export declare function mergePhonemeData(phonemeChunks: Partial<PhonemeData>[]): PhonemeData;
+/**
+ * Apply time offset to phoneme start times.
+ *
+ * Creates a new phoneme dictionary with start times shifted by the
+ * specified offset. Useful for sequential streaming scenarios.
+ *
+ * @param phonemeData - Phoneme dictionary with timing data
+ * @param offset - Time offset in seconds to add to all start times
+ * @returns New phoneme dictionary with adjusted start times
+ */
+export declare function adjustPhonemeTiming(phonemeData: Partial<PhonemeData>, offset: number): PhonemeData;
+/**
+ * Create an empty phoneme dictionary with standard structure.
+ *
+ * @returns Empty phoneme dictionary
+ */
+export declare function createEmptyPhonemeDict(): PhonemeData;
+//# sourceMappingURL=phoneme_utils.d.ts.map

package/dist/commonjs/lib/custom_utils/phoneme_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoneme_utils.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom_utils/phoneme_utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,GACnC,WAAW,CAgEb;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,EACjC,MAAM,EAAE,MAAM,GACZ,WAAW,CAcb;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,CAMpD"}

package/dist/commonjs/lib/custom_utils/phoneme_utils.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * TTS Phoneme Processing Utilities
+ *
+ * Stateless utility functions for phoneme data merging and timing adjustment.
+ * These functions handle the synchronization of phoneme timing data across
+ * multiple audio chunks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePhonemeData = mergePhonemeData;
+exports.adjustPhonemeTiming = adjustPhonemeTiming;
+exports.createEmptyPhonemeDict = createEmptyPhonemeDict;
+/**
+ * Merge multiple phoneme data chunks with automatic time offset adjustment.
+ *
+ * Handles the merging of phoneme data from multiple TTS chunks, ensuring
+ * continuous timing by adjusting start times and maintaining duration
+ * offsets. The first chunk's start time is normalized to 0, and
+ * subsequent chunks are offset accordingly.
+ *
+ * @param phonemeChunks - Array of phoneme dictionaries
+ * @returns Merged phoneme dictionary with adjusted timing
+ */
+function mergePhonemeData(phonemeChunks) {
+    const merged = {
+        symbols: [],
+        durations_seconds: [],
+        start_times_seconds: [],
+    };
+    if (!phonemeChunks || phonemeChunks.length === 0) {
+        return merged;
+    }
+    let firstChunkStartTime = null;
+    let currentTimeOffset = 0.0;
+    for (const phonemeData of phonemeChunks) {
+        if (!phonemeData) {
+            continue;
+        }
+        // Add symbols
+        const symbols = phonemeData.symbols || [];
+        merged.symbols.push(...symbols);
+        // Add durations
+        const durations = phonemeData.durations_seconds || [];
+        merged.durations_seconds.push(...durations);
+        // Adjust and add start times
+        if (phonemeData.start_times_seconds &&
+            phonemeData.start_times_seconds.length > 0) {
+            const originalStartTimes = phonemeData.start_times_seconds;
+            let adjustedStartTimes;
+            if (firstChunkStartTime === null) {
+                // First chunk: normalize to start from 0
+                // We know originalStartTimes[0] exists because length > 0
+                const firstTime = originalStartTimes[0];
+                if (firstTime === undefined) {
+                    continue; // Skip this chunk if start time is undefined
+                }
+                firstChunkStartTime = firstTime;
+                adjustedStartTimes = originalStartTimes.map((t) => t - firstChunkStartTime);
+            }
+            else {
+                // Subsequent chunks: apply accumulated offset
+                adjustedStartTimes = originalStartTimes.map((t) => t - firstChunkStartTime + currentTimeOffset);
+            }
+            merged.start_times_seconds.push(...adjustedStartTimes);
+            // Update offset for next chunk
+            if (durations.length > 0) {
+                currentTimeOffset += durations.reduce((sum, d) => sum + d, 0);
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Apply time offset to phoneme start times.
+ *
+ * Creates a new phoneme dictionary with start times shifted by the
+ * specified offset. Useful for sequential streaming scenarios.
+ *
+ * @param phonemeData - Phoneme dictionary with timing data
+ * @param offset - Time offset in seconds to add to all start times
+ * @returns New phoneme dictionary with adjusted start times
+ */
+function adjustPhonemeTiming(phonemeData, offset) {
+    const adjusted = {
+        symbols: phonemeData.symbols || [],
+        durations_seconds: phonemeData.durations_seconds || [],
+        start_times_seconds: phonemeData.start_times_seconds || [],
+    };
+    if (adjusted.start_times_seconds && adjusted.start_times_seconds.length > 0) {
+        adjusted.start_times_seconds = adjusted.start_times_seconds.map((t) => t + offset);
+    }
+    return adjusted;
+}
+/**
+ * Create an empty phoneme dictionary with standard structure.
+ *
+ * @returns Empty phoneme dictionary
+ */
+function createEmptyPhonemeDict() {
+    return {
+        symbols: [],
+        durations_seconds: [],
+        start_times_seconds: [],
+    };
+}
+//# sourceMappingURL=phoneme_utils.js.map

package/dist/commonjs/lib/custom_utils/phoneme_utils.js.map

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

package/dist/commonjs/lib/custom_utils/text_utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TTS Text Processing Utilities
+ *
+ * Stateless utility functions for text segmentation and NDJSON processing.
+ * These functions are designed to be pure functions without side effects.
+ */
+/**
+ * Split input text into sentence chunks suitable for TTS processing.
+ *
+ * Enhanced version that implements intelligent text segmentation respecting
+ * sentence boundaries while ensuring each chunk stays within TTS API limits.
+ * It handles various punctuation patterns and provides graceful fallback to
+ * word/character boundaries when necessary.
+ *
+ * @param text - Input text to be segmented
+ * @param maxLength - Maximum length of each chunk
+ * @returns Array of text chunks
+ */
+export declare function chunkText(text: string, maxLength?: number): string[];
+/**
+ * Extract audio data from NDJSON response.
+ *
+ * Handles both single JSON object and NDJSON (multiple lines) formats.
+ * Decodes base64-encoded audio data and returns as binary.
+ *
+ * @param ndjsonStr - NDJSON string containing audio_base64 field
+ * @returns Decoded binary audio data
+ */
+export declare function extractAudioFromNdjson(ndjsonStr: string): Uint8Array;
+//# sourceMappingURL=text_utils.d.ts.map

package/dist/commonjs/lib/custom_utils/text_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_utils.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom_utils/text_utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAgC,GACzC,MAAM,EAAE,CA2BV;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CA8BpE"}