@loonylabs/tts-middleware 0.1.1

package/dist/middleware/services/tts/utils/character-counter.utils.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Character Counting Utilities
+ *
+ * @description Accurate character counting for billing purposes.
+ * This is billing-critical code - all functions must be 100% accurate
+ * and match provider billing methodologies.
+ *
+ * @critical This code directly impacts customer billing. Any bugs here
+ * could result in incorrect charges. Test coverage MUST be 100%.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countCharacters = countCharacters;
+exports.countCharactersWithoutSSML = countCharactersWithoutSSML;
+exports.validateCharacterCount = validateCharacterCount;
+exports.countBillableCharacters = countBillableCharacters;
+exports.estimateAudioDuration = estimateAudioDuration;
+exports.formatCharacterCount = formatCharacterCount;
+/**
+ * Count all characters in text for billing purposes
+ *
+ * @param text - The input text to count
+ * @returns The total number of characters including spaces, punctuation, and newlines
+ *
+ * @description
+ * This function counts ALL characters in the input text:
+ * - Letters (a-z, A-Z)
+ * - Numbers (0-9)
+ * - Spaces and tabs
+ * - Newlines (\n, \r\n)
+ * - Punctuation and special characters
+ * - Unicode characters (counted as 1 character each)
+ * - Emoji (counted as 1 character each, regardless of byte length)
+ *
+ * @example
+ * ```typescript
+ * countCharacters("Hello World!") // returns 12
+ * countCharacters("Guten Morgen")  // returns 12
+ * countCharacters("Hello 👋")      // returns 8
+ * countCharacters("")              // returns 0
+ * ```
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length
+ *
+ * @critical Billing-critical function. Must be 100% accurate.
+ */
+function countCharacters(text) {
+    // JavaScript string length counts UTF-16 code units
+    // For most characters this equals 1, which matches provider billing
+    return text.length;
+}
+/**
+ * Count characters in text after removing SSML markup
+ *
+ * @param text - The input text (may contain SSML tags)
+ * @returns The number of characters excluding SSML tags
+ *
+ * @description
+ * This function removes all SSML (Speech Synthesis Markup Language) tags
+ * before counting characters. This is used when the middleware generates
+ * SSML internally but billing is based on the plain text content.
+ *
+ * SSML tags removed include:
+ * - `<speak>`, `</speak>` - Root element
+ * - `<voice>`, `</voice>` - Voice selection
+ * - `<prosody>`, `</prosody>` - Prosody (rate, pitch, volume)
+ * - `<emphasis>`, `</emphasis>` - Emphasis
+ * - `<break>` - Pauses
+ * - `<say-as>`, `</say-as>` - Interpret-as hints
+ * - `<phoneme>`, `</phoneme>` - Phonetic pronunciation
+ * - `<sub>`, `</sub>` - Substitution
+ * - `<lang>`, `</lang>` - Language switching
+ * - And all other SSML tags
+ *
+ * @example
+ * ```typescript
+ * countCharactersWithoutSSML("<speak>Hello</speak>")
+ * // returns 5 (only "Hello" is counted)
+ *
+ * countCharactersWithoutSSML('<voice name="en-US-Jenny">Text</voice>')
+ * // returns 4 (only "Text" is counted)
+ *
+ * countCharactersWithoutSSML('<prosody rate="slow">Hello World</prosody>')
+ * // returns 11 (only "Hello World" is counted)
+ * ```
+ *
+ * @critical Billing-critical function. Must match Azure's character counting.
+ */
+function countCharactersWithoutSSML(text) {
+    // Remove all SSML tags (opening and closing tags, including self-closing)
+    // Pattern: <tag> or </tag> or <tag attr="value"> or <tag/>
+    const withoutSSML = text.replace(/<[^>]+>/g, '');
+    // Count the remaining characters
+    return withoutSSML.length;
+}
+/**
+ * Validate that character count matches expected range
+ *
+ * @param text - The input text
+ * @param minChars - Minimum expected characters (default: 0)
+ * @param maxChars - Maximum expected characters (default: Infinity)
+ * @returns True if count is within range
+ * @throws {RangeError} If character count is outside expected range
+ *
+ * @description
+ * This is a utility function to validate text length before synthesis.
+ * Providers often have limits on input text length (e.g., Azure: 3000 chars per request).
+ *
+ * @example
+ * ```typescript
+ * validateCharacterCount("Hello", 1, 100) // returns true
+ * validateCharacterCount("", 1, 100)       // throws RangeError
+ * ```
+ */
+function validateCharacterCount(text, minChars = 0, maxChars = Infinity) {
+    const count = countCharacters(text);
+    if (count < minChars) {
+        throw new RangeError(`Text must have at least ${minChars} characters (got ${count})`);
+    }
+    if (count > maxChars) {
+        throw new RangeError(`Text must have at most ${maxChars} characters (got ${count})`);
+    }
+    return true;
+}
+/**
+ * Count billable characters (alias for countCharacters)
+ *
+ * @param text - The input text
+ * @returns The number of billable characters
+ *
+ * @description
+ * Semantic alias for countCharacters to make billing calculations clearer.
+ * This is the function consumers should use when calculating costs.
+ *
+ * @example
+ * ```typescript
+ * const text = "Hello World!";
+ * const chars = countBillableCharacters(text); // 12
+ * const costUSD = (chars / 1_000_000) * 16; // $16 per 1M chars
+ * ```
+ */
+function countBillableCharacters(text) {
+    return countCharacters(text);
+}
+/**
+ * Estimate audio duration based on character count
+ *
+ * @param text - The input text
+ * @param speedMultiplier - Speech speed (0.5 to 2.0, default: 1.0)
+ * @param charsPerSecond - Average characters spoken per second (default: 15)
+ * @returns Estimated duration in milliseconds
+ *
+ * @description
+ * Provides a rough estimate of audio duration based on character count.
+ * This is NOT exact and varies by:
+ * - Language (some languages are more verbose)
+ * - Voice (different voices have different pacing)
+ * - Content (technical terms take longer)
+ * - Speed setting
+ *
+ * Default assumption: ~15 characters per second at normal speed
+ * (roughly 150-180 words per minute, assuming 5-6 chars per word)
+ *
+ * @example
+ * ```typescript
+ * estimateAudioDuration("Hello World!", 1.0) // ~800ms
+ * estimateAudioDuration("Hello World!", 0.5) // ~1600ms (slower)
+ * ```
+ */
+function estimateAudioDuration(text, speedMultiplier = 1.0, charsPerSecond = 15) {
+    const charCount = countCharacters(text);
+    // Calculate seconds at normal speed
+    const secondsAtNormalSpeed = charCount / charsPerSecond;
+    // Adjust for speed multiplier (higher speed = shorter duration)
+    const adjustedSeconds = secondsAtNormalSpeed / speedMultiplier;
+    // Convert to milliseconds
+    return Math.round(adjustedSeconds * 1000);
+}
+/**
+ * Format character count for display
+ *
+ * @param count - The character count
+ * @returns Formatted string (e.g., "1.2K chars", "1.5M chars")
+ *
+ * @description
+ * Formats large character counts in human-readable format.
+ * Useful for displaying usage statistics.
+ *
+ * @example
+ * ```typescript
+ * formatCharacterCount(500)         // "500 chars"
+ * formatCharacterCount(1234)        // "1.2K chars"
+ * formatCharacterCount(1500000)     // "1.5M chars"
+ * ```
+ */
+function formatCharacterCount(count) {
+    if (count < 1000) {
+        return `${count} chars`;
+    }
+    if (count < 1000000) {
+        return `${(count / 1000).toFixed(1)}K chars`;
+    }
+    return `${(count / 1000000).toFixed(1)}M chars`;
+}
+//# sourceMappingURL=character-counter.utils.js.map

package/dist/middleware/services/tts/utils/character-counter.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-counter.utils.js","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/utils/character-counter.utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA8BH,0CAIC;AAuCD,gEAOC;AAqBD,wDAoBC;AAmBD,0DAEC;AA2BD,sDAeC;AAmBD,oDAUC;AAnND;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,oDAAoD;IACpD,oEAAoE;IACpE,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,SAAgB,0BAA0B,CAAC,IAAY;IACrD,0EAA0E;IAC1E,2DAA2D;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEjD,iCAAiC;IACjC,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,sBAAsB,CACpC,IAAY,EACZ,WAAmB,CAAC,EACpB,WAAmB,QAAQ;IAE3B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEpC,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,UAAU,CAClB,2BAA2B,QAAQ,oBAAoB,KAAK,GAAG,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,UAAU,CAClB,0BAA0B,QAAQ,oBAAoB,KAAK,GAAG,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,qBAAqB,CACnC,IAAY,EACZ,kBAA0B,GAAG,EAC7B,iBAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAExC,oCAAoC;IACpC,MAAM,oBAAoB,GAAG,SAAS,GAAG,cAAc,CAAC;IAExD,gEAAgE;IAChE,MAAM,eAAe,GAAG,oBAAoB,GAAG,eAAe,CAAC;IAE/D,0BAA0B;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,KAAK,QAAQ,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,GAAG,OAAS,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,CAAC,KAAK,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/middleware/services/tts/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * TTS Utility Functions
+ *
+ * Export all utility functions for TTS operations
+ */
+export { countCharacters, countCharactersWithoutSSML, validateCharacterCount, countBillableCharacters, estimateAudioDuration, formatCharacterCount, } from './character-counter.utils';
+export { setLogger, getLogger, resetLogger, setLogLevel, getLogLevel, silentLogger, log, } from './logger.utils';
+export type { TTSLogger, LogLevel } from './logger.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/services/tts/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/middleware/services/tts/utils/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * TTS Utility Functions
+ *
+ * Export all utility functions for TTS operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = exports.silentLogger = exports.getLogLevel = exports.setLogLevel = exports.resetLogger = exports.getLogger = exports.setLogger = exports.formatCharacterCount = exports.estimateAudioDuration = exports.countBillableCharacters = exports.validateCharacterCount = exports.countCharactersWithoutSSML = exports.countCharacters = void 0;
+var character_counter_utils_1 = require("./character-counter.utils");
+Object.defineProperty(exports, "countCharacters", { enumerable: true, get: function () { return character_counter_utils_1.countCharacters; } });
+Object.defineProperty(exports, "countCharactersWithoutSSML", { enumerable: true, get: function () { return character_counter_utils_1.countCharactersWithoutSSML; } });
+Object.defineProperty(exports, "validateCharacterCount", { enumerable: true, get: function () { return character_counter_utils_1.validateCharacterCount; } });
+Object.defineProperty(exports, "countBillableCharacters", { enumerable: true, get: function () { return character_counter_utils_1.countBillableCharacters; } });
+Object.defineProperty(exports, "estimateAudioDuration", { enumerable: true, get: function () { return character_counter_utils_1.estimateAudioDuration; } });
+Object.defineProperty(exports, "formatCharacterCount", { enumerable: true, get: function () { return character_counter_utils_1.formatCharacterCount; } });
+// Logger utilities
+var logger_utils_1 = require("./logger.utils");
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return logger_utils_1.setLogger; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return logger_utils_1.getLogger; } });
+Object.defineProperty(exports, "resetLogger", { enumerable: true, get: function () { return logger_utils_1.resetLogger; } });
+Object.defineProperty(exports, "setLogLevel", { enumerable: true, get: function () { return logger_utils_1.setLogLevel; } });
+Object.defineProperty(exports, "getLogLevel", { enumerable: true, get: function () { return logger_utils_1.getLogLevel; } });
+Object.defineProperty(exports, "silentLogger", { enumerable: true, get: function () { return logger_utils_1.silentLogger; } });
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return logger_utils_1.log; } });
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/tts/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/utils/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qEAOmC;AANjC,0HAAA,eAAe,OAAA;AACf,qIAAA,0BAA0B,OAAA;AAC1B,iIAAA,sBAAsB,OAAA;AACtB,kIAAA,uBAAuB,OAAA;AACvB,gIAAA,qBAAqB,OAAA;AACrB,+HAAA,oBAAoB,OAAA;AAGtB,mBAAmB;AACnB,+CAQwB;AAPtB,yGAAA,SAAS,OAAA;AACT,yGAAA,SAAS,OAAA;AACT,2GAAA,WAAW,OAAA;AACX,2GAAA,WAAW,OAAA;AACX,2GAAA,WAAW,OAAA;AACX,4GAAA,YAAY,OAAA;AACZ,mGAAA,GAAG,OAAA"}

package/dist/middleware/services/tts/utils/logger.utils.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Pluggable Logger Interface for TTS Middleware
+ *
+ * @description Allows customization of logging behavior.
+ * By default, uses console logging, but can be replaced
+ * with any logger implementation (Winston, Pino, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Use custom logger
+ * import { setLogger } from '@loonylabs/tts-middleware';
+ *
+ * setLogger({
+ *   info: (msg, meta) => winston.info(msg, meta),
+ *   warn: (msg, meta) => winston.warn(msg, meta),
+ *   error: (msg, meta) => winston.error(msg, meta),
+ *   debug: (msg, meta) => winston.debug(msg, meta),
+ * });
+ * ```
+ */
+/**
+ * Log level type
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+/**
+ * Logger interface that can be implemented by any logging library
+ */
+export interface TTSLogger {
+    /**
+     * Log an info message
+     */
+    info(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Silent logger that discards all messages
+ * Useful for testing or when logging should be disabled
+ */
+export declare const silentLogger: TTSLogger;
+/**
+ * Set the logger implementation
+ *
+ * @param logger - The logger implementation to use
+ *
+ * @example
+ * ```typescript
+ * import { setLogger, silentLogger } from '@loonylabs/tts-middleware';
+ *
+ * // Disable logging
+ * setLogger(silentLogger);
+ *
+ * // Use custom logger
+ * setLogger({
+ *   info: (msg, meta) => myLogger.info(msg, meta),
+ *   warn: (msg, meta) => myLogger.warn(msg, meta),
+ *   error: (msg, meta) => myLogger.error(msg, meta),
+ *   debug: (msg, meta) => myLogger.debug(msg, meta),
+ * });
+ * ```
+ */
+export declare function setLogger(logger: TTSLogger): void;
+/**
+ * Get the current logger implementation
+ *
+ * @returns The current logger
+ */
+export declare function getLogger(): TTSLogger;
+/**
+ * Reset logger to default console logger
+ */
+export declare function resetLogger(): void;
+/**
+ * Set the minimum log level
+ *
+ * @param level - The minimum log level to display
+ *
+ * @example
+ * ```typescript
+ * import { setLogLevel } from '@loonylabs/tts-middleware';
+ *
+ * // Only show warnings and errors
+ * setLogLevel('warn');
+ *
+ * // Show all messages including debug
+ * setLogLevel('debug');
+ * ```
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current log level
+ *
+ * @returns The current minimum log level
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Internal logging function used by TTS components
+ *
+ * @internal
+ * @param provider - Provider name for log prefix
+ * @param level - Log level
+ * @param message - Log message
+ * @param meta - Optional metadata
+ */
+export declare function log(provider: string, level: LogLevel, message: string, meta?: Record<string, unknown>): void;
+//# sourceMappingURL=logger.utils.d.ts.map

package/dist/middleware/services/tts/utils/logger.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.utils.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/utils/logger.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAoCD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAK1B,CAAC;AAsBF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAYD;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAUN"}

package/dist/middleware/services/tts/utils/logger.utils.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Pluggable Logger Interface for TTS Middleware
+ *
+ * @description Allows customization of logging behavior.
+ * By default, uses console logging, but can be replaced
+ * with any logger implementation (Winston, Pino, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Use custom logger
+ * import { setLogger } from '@loonylabs/tts-middleware';
+ *
+ * setLogger({
+ *   info: (msg, meta) => winston.info(msg, meta),
+ *   warn: (msg, meta) => winston.warn(msg, meta),
+ *   error: (msg, meta) => winston.error(msg, meta),
+ *   debug: (msg, meta) => winston.debug(msg, meta),
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.silentLogger = void 0;
+exports.setLogger = setLogger;
+exports.getLogger = getLogger;
+exports.resetLogger = resetLogger;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
+exports.log = log;
+/**
+ * Default console logger implementation
+ */
+const consoleLogger = {
+    info: (message, meta) => {
+        if (meta) {
+            console.info(message, meta);
+        }
+        else {
+            console.info(message);
+        }
+    },
+    warn: (message, meta) => {
+        if (meta) {
+            console.warn(message, meta);
+        }
+        else {
+            console.warn(message);
+        }
+    },
+    error: (message, meta) => {
+        if (meta) {
+            console.error(message, meta);
+        }
+        else {
+            console.error(message);
+        }
+    },
+    debug: (message, meta) => {
+        if (meta) {
+            console.debug(message, meta);
+        }
+        else {
+            console.debug(message);
+        }
+    },
+};
+/**
+ * Silent logger that discards all messages
+ * Useful for testing or when logging should be disabled
+ */
+exports.silentLogger = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    debug: () => { },
+};
+/**
+ * Current logger instance
+ */
+let currentLogger = consoleLogger;
+/**
+ * Current log level (messages below this level are discarded)
+ */
+let currentLogLevel = 'info';
+/**
+ * Log level priority (higher = more important)
+ */
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Set the logger implementation
+ *
+ * @param logger - The logger implementation to use
+ *
+ * @example
+ * ```typescript
+ * import { setLogger, silentLogger } from '@loonylabs/tts-middleware';
+ *
+ * // Disable logging
+ * setLogger(silentLogger);
+ *
+ * // Use custom logger
+ * setLogger({
+ *   info: (msg, meta) => myLogger.info(msg, meta),
+ *   warn: (msg, meta) => myLogger.warn(msg, meta),
+ *   error: (msg, meta) => myLogger.error(msg, meta),
+ *   debug: (msg, meta) => myLogger.debug(msg, meta),
+ * });
+ * ```
+ */
+function setLogger(logger) {
+    currentLogger = logger;
+}
+/**
+ * Get the current logger implementation
+ *
+ * @returns The current logger
+ */
+function getLogger() {
+    return currentLogger;
+}
+/**
+ * Reset logger to default console logger
+ */
+function resetLogger() {
+    currentLogger = consoleLogger;
+}
+/**
+ * Set the minimum log level
+ *
+ * @param level - The minimum log level to display
+ *
+ * @example
+ * ```typescript
+ * import { setLogLevel } from '@loonylabs/tts-middleware';
+ *
+ * // Only show warnings and errors
+ * setLogLevel('warn');
+ *
+ * // Show all messages including debug
+ * setLogLevel('debug');
+ * ```
+ */
+function setLogLevel(level) {
+    currentLogLevel = level;
+}
+/**
+ * Get the current log level
+ *
+ * @returns The current minimum log level
+ */
+function getLogLevel() {
+    return currentLogLevel;
+}
+/**
+ * Check if a log level should be displayed
+ *
+ * @param level - The level to check
+ * @returns True if the level should be displayed
+ */
+function shouldLog(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[currentLogLevel];
+}
+/**
+ * Internal logging function used by TTS components
+ *
+ * @internal
+ * @param provider - Provider name for log prefix
+ * @param level - Log level
+ * @param message - Log message
+ * @param meta - Optional metadata
+ */
+function log(provider, level, message, meta) {
+    if (!shouldLog(level)) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${provider.toUpperCase()}] [${level.toUpperCase()}]`;
+    const formattedMessage = `${prefix} ${message}`;
+    currentLogger[level](formattedMessage, meta);
+}
+//# sourceMappingURL=logger.utils.js.map

package/dist/middleware/services/tts/utils/logger.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.utils.js","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/utils/logger.utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAsHH,8BAEC;AAOD,8BAEC;AAKD,kCAEC;AAkBD,kCAEC;AAOD,kCAEC;AAqBD,kBAeC;AAzKD;;GAEG;AACH,MAAM,aAAa,GAAc;IAC/B,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QACxD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QACxD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QACzD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QACzD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,YAAY,GAAc;IACrC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,IAAI,aAAa,GAAc,aAAa,CAAC;AAE7C;;GAEG;AACH,IAAI,eAAe,GAAa,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,kBAAkB,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,SAAS,CAAC,MAAiB;IACzC,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS;IACvB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,aAAa,GAAG,aAAa,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,WAAW,CAAC,KAAe;IACzC,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW;IACzB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,GAAG,CACjB,QAAgB,EAChB,KAAe,EACf,OAAe,EACf,IAA8B;IAE9B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IACrF,MAAM,gBAAgB,GAAG,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAEhD,aAAa,CAAC,KAAK,CAAC,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}