audio-channel-queue 1.8.0 → 1.10.0

package/dist/errors.js

@@ -36,22 +36,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProtectedAudioElement = exports.handleAudioError = exports.setupAudioErrorHandling = exports.categorizeError = exports.emitAudioError = exports.retryFailedAudio = exports.getErrorRecovery = exports.setErrorRecovery = exports.getRetryConfig = exports.setRetryConfig = exports.offAudioError = exports.onAudioError = void 0;
+const types_1 = require("./types");
 const info_1 = require("./info");
 const utils_1 = require("./utils");
 let globalRetryConfig = {
-    enabled: true,
-    maxRetries: 3,
     baseDelay: 1000,
+    enabled: true,
     exponentialBackoff: true,
-    timeoutMs: 10000,
-    skipOnFailure: false
+    maxRetries: 3,
+    skipOnFailure: false,
+    timeoutMs: 10000
 };
 let globalErrorRecovery = {
     autoRetry: true,
-    showUserFeedback: false,
+    fallbackToNextTrack: true,
     logErrorsToAnalytics: false,
     preserveQueueOnError: true,
-    fallbackToNextTrack: true
+    showUserFeedback: false
 };
 const retryAttempts = new WeakMap();
 const loadTimeouts = new WeakMap();
@@ -59,6 +60,7 @@ const loadTimeouts = new WeakMap();
  * Subscribes to audio error events for a specific channel
  * @param channelNumber - The channel number to listen to (defaults to 0)
  * @param callback - Function to call when an audio error occurs
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioError(0, (errorInfo) => {
@@ -68,7 +70,14 @@ const loadTimeouts = new WeakMap();
  * ```
  */
 const onAudioError = (channelNumber = 0, callback) => {
-    // Ensure channel exists
+    // Validate channel number limits BEFORE creating any channels
+    if (channelNumber < 0) {
+        throw new Error('Channel number must be non-negative');
+    }
+    if (channelNumber >= types_1.MAX_CHANNELS) {
+        throw new Error(`Channel number ${channelNumber} exceeds maximum allowed channels (${types_1.MAX_CHANNELS})`);
+    }
+    // Ensure channel exists (now safe because we validated the limit above)
     while (info_1.audioChannels.length <= channelNumber) {
         info_1.audioChannels.push({
             audioCompleteCallbacks: new Set(),
@@ -191,11 +200,12 @@ exports.getErrorRecovery = getErrorRecovery;
  * ```
  */
 const retryFailedAudio = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (channelNumber = 0) {
+    var _a;
     const channel = info_1.audioChannels[channelNumber];
     if (!channel || channel.queue.length === 0)
         return false;
     const currentAudio = channel.queue[0];
-    const currentAttempts = retryAttempts.get(currentAudio) || 0;
+    const currentAttempts = (_a = retryAttempts.get(currentAudio)) !== null && _a !== void 0 ? _a : 0;
     if (currentAttempts >= globalRetryConfig.maxRetries) {
         return false;
     }
@@ -208,6 +218,8 @@ const retryFailedAudio = (...args_1) => __awaiter(void 0, [...args_1], void 0, f
         return true;
     }
     catch (error) {
+        // eslint-disable-next-line no-console
+        console.error(`Error in retryFailedAudio: ${error}`);
         // Increment retry counter
         retryAttempts.set(currentAudio, currentAttempts + 1);
         return false;
@@ -227,13 +239,15 @@ const emitAudioError = (channelNumber, errorInfo, audioChannels) => {
         return;
     // Log to analytics if enabled
     if (globalErrorRecovery.logErrorsToAnalytics) {
+        // eslint-disable-next-line no-console
         console.warn('Audio Error Analytics:', errorInfo);
     }
-    channel.audioErrorCallbacks.forEach(callback => {
+    channel.audioErrorCallbacks.forEach((callback) => {
         try {
             callback(errorInfo);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in audio error callback:', error);
         }
     });
@@ -252,7 +266,8 @@ const categorizeError = (error, audio) => {
         return 'network';
     }
     // Check for unsupported format first (more specific than decode)
-    if (errorMessage.includes('not supported') || errorMessage.includes('unsupported') ||
+    if (errorMessage.includes('not supported') ||
+        errorMessage.includes('unsupported') ||
         errorMessage.includes('format not supported')) {
         return 'unsupported';
     }
@@ -312,7 +327,7 @@ const setupAudioErrorHandling = (audio, channelNumber, originalUrl, onError) =>
         }
     };
     // Handle various error events
-    const handleError = (event) => {
+    const handleError = (_event) => {
         var _a;
         if (typeof setTimeout !== 'undefined') {
             const timeoutId = loadTimeouts.get(audio);
@@ -363,25 +378,28 @@ exports.setupAudioErrorHandling = setupAudioErrorHandling;
  * @internal
  */
 const handleAudioError = (audio, channelNumber, originalUrl, error) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
     const channel = info_1.audioChannels[channelNumber];
     if (!channel)
         return;
-    const currentAttempts = retryAttempts.get(audio) || 0;
-    const retryConfig = channel.retryConfig || globalRetryConfig;
+    const currentAttempts = (_a = retryAttempts.get(audio)) !== null && _a !== void 0 ? _a : 0;
+    const retryConfig = (_b = channel.retryConfig) !== null && _b !== void 0 ? _b : globalRetryConfig;
     const errorInfo = {
         channelNumber,
-        src: originalUrl,
-        fileName: (0, utils_1.extractFileName)(originalUrl),
         error,
         errorType: (0, exports.categorizeError)(error, audio),
-        timestamp: Date.now(),
+        fileName: (0, utils_1.extractFileName)(originalUrl),
+        remainingInQueue: channel.queue.length - 1,
         retryAttempt: currentAttempts,
-        remainingInQueue: channel.queue.length - 1
+        src: originalUrl,
+        timestamp: Date.now()
     };
     // Emit error event
     (0, exports.emitAudioError)(channelNumber, errorInfo, info_1.audioChannels);
     // Attempt retry if enabled and within limits
-    if (retryConfig.enabled && currentAttempts < retryConfig.maxRetries && globalErrorRecovery.autoRetry) {
+    if (retryConfig.enabled &&
+        currentAttempts < retryConfig.maxRetries &&
+        globalErrorRecovery.autoRetry) {
         const delay = retryConfig.exponentialBackoff
             ? retryConfig.baseDelay * Math.pow(2, currentAttempts)
             : retryConfig.baseDelay;
@@ -412,6 +430,7 @@ const handleAudioError = (audio, channelNumber, originalUrl, error) => __awaiter
             channel.queue.shift();
             // Import and use playAudioQueue to continue with next track
             const { playAudioQueue } = yield Promise.resolve().then(() => __importStar(require('./core')));
+            // eslint-disable-next-line no-console
             playAudioQueue(channelNumber).catch(console.error);
         }
         else if (!globalErrorRecovery.preserveQueueOnError) {

package/dist/events.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cleanupProgressTracking = exports.setupProgressTracking = exports.emitAudioResume = exports.emitAudioPause = exports.emitAudioComplete = exports.emitAudioStart = exports.emitQueueChange = void 0;
+const types_1 = require("./types");
 const utils_1 = require("./utils");
 /**
  * Emits a queue change event to all registered listeners for a specific channel
@@ -16,16 +17,17 @@ const utils_1 = require("./utils");
  */
 const emitQueueChange = (channelNumber, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.queueChangeCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.queueChangeCallbacks))
         return;
     const snapshot = (0, utils_1.createQueueSnapshot)(channelNumber, audioChannels);
     if (!snapshot)
         return;
-    channel.queueChangeCallbacks.forEach(callback => {
+    channel.queueChangeCallbacks.forEach((callback) => {
         try {
             callback(snapshot);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in queue change callback:', error);
         }
     });
@@ -43,13 +45,14 @@ exports.emitQueueChange = emitQueueChange;
  */
 const emitAudioStart = (channelNumber, audioInfo, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.audioStartCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioStartCallbacks))
         return;
-    channel.audioStartCallbacks.forEach(callback => {
+    channel.audioStartCallbacks.forEach((callback) => {
         try {
             callback(audioInfo);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in audio start callback:', error);
         }
     });
@@ -67,13 +70,14 @@ exports.emitAudioStart = emitAudioStart;
  */
 const emitAudioComplete = (channelNumber, audioInfo, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.audioCompleteCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioCompleteCallbacks))
         return;
-    channel.audioCompleteCallbacks.forEach(callback => {
+    channel.audioCompleteCallbacks.forEach((callback) => {
         try {
             callback(audioInfo);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in audio complete callback:', error);
         }
     });
@@ -91,13 +95,14 @@ exports.emitAudioComplete = emitAudioComplete;
  */
 const emitAudioPause = (channelNumber, audioInfo, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.audioPauseCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioPauseCallbacks))
         return;
-    channel.audioPauseCallbacks.forEach(callback => {
+    channel.audioPauseCallbacks.forEach((callback) => {
         try {
             callback(channelNumber, audioInfo);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in audio pause callback:', error);
         }
     });
@@ -115,13 +120,14 @@ exports.emitAudioPause = emitAudioPause;
  */
 const emitAudioResume = (channelNumber, audioInfo, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.audioResumeCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioResumeCallbacks))
         return;
-    channel.audioResumeCallbacks.forEach(callback => {
+    channel.audioResumeCallbacks.forEach((callback) => {
         try {
             callback(channelNumber, audioInfo);
         }
         catch (error) {
+            // eslint-disable-next-line no-console
             console.error('Error in audio resume callback:', error);
         }
     });
@@ -151,10 +157,10 @@ const setupProgressTracking = (audio, channelNumber, audioChannels) => {
     if (progressListeners.has(audio))
         return;
     const updateProgress = () => {
-        var _a, _b;
+        var _a, _b, _c, _d;
         // Get callbacks for this specific audio element AND the channel-wide callbacks
-        const audioCallbacks = ((_a = channel.progressCallbacks) === null || _a === void 0 ? void 0 : _a.get(audio)) || new Set();
-        const channelCallbacks = ((_b = channel.progressCallbacks) === null || _b === void 0 ? void 0 : _b.get(null)) || new Set();
+        const audioCallbacks = (_b = (_a = channel.progressCallbacks) === null || _a === void 0 ? void 0 : _a.get(audio)) !== null && _b !== void 0 ? _b : new Set();
+        const channelCallbacks = (_d = (_c = channel.progressCallbacks) === null || _c === void 0 ? void 0 : _c.get(types_1.GLOBAL_PROGRESS_KEY)) !== null && _d !== void 0 ? _d : new Set();
         // Combine both sets of callbacks
         const allCallbacks = new Set([...audioCallbacks, ...channelCallbacks]);
         if (allCallbacks.size === 0)
@@ -166,6 +172,7 @@ const setupProgressTracking = (audio, channelNumber, audioChannels) => {
                     callback(info);
                 }
                 catch (error) {
+                    // eslint-disable-next-line no-console
                     console.error('Error in progress callback:', error);
                 }
             });
@@ -193,7 +200,7 @@ exports.setupProgressTracking = setupProgressTracking;
  */
 const cleanupProgressTracking = (audio, channelNumber, audioChannels) => {
     const channel = audioChannels[channelNumber];
-    if (!channel || !channel.progressCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.progressCallbacks))
         return;
     // Remove event listeners
     const updateProgress = progressListeners.get(audio);

package/dist/index.d.ts

@@ -3,12 +3,13 @@
  * Exports all public functions and types for audio queue management, pause/resume controls,
  * volume management with ducking, progress tracking, and comprehensive event system
  */
-export { queueAudio, queueAudioPriority, stopCurrentAudioInChannel, stopAllAudioInChannel, stopAllAudio, playAudioQueue } from './core';
-export { getErrorRecovery, getRetryConfig, offAudioError, onAudioError, retryFailedAudio, setErrorRecovery, setRetryConfig, } from './errors';
-export { getAllChannelsPauseState, isChannelPaused, pauseAllChannels, pauseAllWithFade, pauseChannel, pauseWithFade, resumeAllChannels, resumeAllWithFade, resumeChannel, resumeWithFade, togglePauseAllChannels, togglePauseAllWithFade, togglePauseChannel, togglePauseWithFade, } from './pause';
-export { clearVolumeDucking, fadeVolume, getAllChannelsVolume, getChannelVolume, getFadeConfig, setAllChannelsVolume, setChannelVolume, setVolumeDucking, transitionVolume, } from './volume';
-export { getAllChannelsInfo, getCurrentAudioInfo, getQueueSnapshot, offAudioPause, offAudioProgress, offAudioResume, offQueueChange, onAudioComplete, onAudioPause, onAudioProgress, onAudioResume, onAudioStart, onQueueChange, } from './info';
+export { queueAudio, queueAudioPriority, stopCurrentAudioInChannel, stopAllAudioInChannel, stopAllAudio, playAudioQueue, destroyChannel, destroyAllChannels, setQueueConfig, getQueueConfig, setChannelQueueLimit } from './core';
+export { clearQueueAfterCurrent, getQueueItemInfo, getQueueLength, removeQueuedItem, reorderQueue, swapQueueItems } from './queue-manipulation';
+export { getErrorRecovery, getRetryConfig, offAudioError, onAudioError, retryFailedAudio, setErrorRecovery, setRetryConfig } from './errors';
+export { getAllChannelsPauseState, isChannelPaused, pauseAllChannels, pauseAllWithFade, pauseChannel, pauseWithFade, resumeAllChannels, resumeAllWithFade, resumeChannel, resumeWithFade, togglePauseAllChannels, togglePauseAllWithFade, togglePauseChannel, togglePauseWithFade } from './pause';
+export { clearVolumeDucking, fadeVolume, getAllChannelsVolume, getChannelVolume, getFadeConfig, setAllChannelsVolume, setChannelVolume, setVolumeDucking, transitionVolume, cancelVolumeTransition, cancelAllVolumeTransitions } from './volume';
+export { getAllChannelsInfo, getCurrentAudioInfo, getQueueSnapshot, offAudioPause, offAudioProgress, offAudioResume, offQueueChange, onAudioComplete, onAudioPause, onAudioProgress, onAudioResume, onAudioStart, onQueueChange } from './info';
 export { audioChannels } from './info';
-export { cleanWebpackFilename, createQueueSnapshot, extractFileName, getAudioInfoFromElement } from './utils';
-export type { AudioCompleteCallback, AudioCompleteInfo, AudioErrorCallback, AudioErrorInfo, AudioInfo, AudioPauseCallback, AudioQueueOptions, AudioResumeCallback, AudioStartCallback, AudioStartInfo, ChannelFadeState, ErrorRecoveryOptions, ExtendedAudioQueueChannel, FadeConfig, ProgressCallback, QueueChangeCallback, QueueItem, QueueSnapshot, RetryConfig, VolumeConfig } from './types';
-export { EasingType, FadeType } from './types';
+export { cleanWebpackFilename, createQueueSnapshot, extractFileName, getAudioInfoFromElement, sanitizeForDisplay, validateAudioUrl } from './utils';
+export type { AudioCompleteCallback, AudioCompleteInfo, AudioErrorCallback, AudioErrorInfo, AudioInfo, AudioPauseCallback, AudioQueueOptions, AudioResumeCallback, AudioStartCallback, AudioStartInfo, ChannelFadeState, ErrorRecoveryOptions, ExtendedAudioQueueChannel, FadeConfig, ProgressCallback, QueueChangeCallback, QueueItem, QueueManipulationResult, QueueSnapshot, RetryConfig, VolumeConfig, QueueConfig } from './types';
+export { EasingType, FadeType, MAX_CHANNELS, TimerType, GLOBAL_PROGRESS_KEY } from './types';

package/dist/index.js

@@ -5,8 +5,8 @@
  * volume management with ducking, progress tracking, and comprehensive event system
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.audioChannels = exports.onQueueChange = exports.onAudioStart = exports.onAudioResume = exports.onAudioProgress = exports.onAudioPause = exports.onAudioComplete = exports.offQueueChange = exports.offAudioResume = exports.offAudioProgress = exports.offAudioPause = exports.getQueueSnapshot = exports.getCurrentAudioInfo = exports.getAllChannelsInfo = exports.transitionVolume = exports.setVolumeDucking = exports.setChannelVolume = exports.setAllChannelsVolume = exports.getFadeConfig = exports.getChannelVolume = exports.getAllChannelsVolume = exports.fadeVolume = exports.clearVolumeDucking = exports.togglePauseWithFade = exports.togglePauseChannel = exports.togglePauseAllWithFade = exports.togglePauseAllChannels = exports.resumeWithFade = exports.resumeChannel = exports.resumeAllWithFade = exports.resumeAllChannels = exports.pauseWithFade = exports.pauseChannel = exports.pauseAllWithFade = exports.pauseAllChannels = exports.isChannelPaused = exports.getAllChannelsPauseState = exports.setRetryConfig = exports.setErrorRecovery = exports.retryFailedAudio = exports.onAudioError = exports.offAudioError = exports.getRetryConfig = exports.getErrorRecovery = exports.playAudioQueue = exports.stopAllAudio = exports.stopAllAudioInChannel = exports.stopCurrentAudioInChannel = exports.queueAudioPriority = exports.queueAudio = void 0;
-exports.FadeType = exports.EasingType = exports.getAudioInfoFromElement = exports.extractFileName = exports.createQueueSnapshot = exports.cleanWebpackFilename = void 0;
+exports.getAllChannelsInfo = exports.cancelAllVolumeTransitions = exports.cancelVolumeTransition = exports.transitionVolume = exports.setVolumeDucking = exports.setChannelVolume = exports.setAllChannelsVolume = exports.getFadeConfig = exports.getChannelVolume = exports.getAllChannelsVolume = exports.fadeVolume = exports.clearVolumeDucking = exports.togglePauseWithFade = exports.togglePauseChannel = exports.togglePauseAllWithFade = exports.togglePauseAllChannels = exports.resumeWithFade = exports.resumeChannel = exports.resumeAllWithFade = exports.resumeAllChannels = exports.pauseWithFade = exports.pauseChannel = exports.pauseAllWithFade = exports.pauseAllChannels = exports.isChannelPaused = exports.getAllChannelsPauseState = exports.setRetryConfig = exports.setErrorRecovery = exports.retryFailedAudio = exports.onAudioError = exports.offAudioError = exports.getRetryConfig = exports.getErrorRecovery = exports.swapQueueItems = exports.reorderQueue = exports.removeQueuedItem = exports.getQueueLength = exports.getQueueItemInfo = exports.clearQueueAfterCurrent = exports.setChannelQueueLimit = exports.getQueueConfig = exports.setQueueConfig = exports.destroyAllChannels = exports.destroyChannel = exports.playAudioQueue = exports.stopAllAudio = exports.stopAllAudioInChannel = exports.stopCurrentAudioInChannel = exports.queueAudioPriority = exports.queueAudio = void 0;
+exports.GLOBAL_PROGRESS_KEY = exports.TimerType = exports.MAX_CHANNELS = exports.FadeType = exports.EasingType = exports.validateAudioUrl = exports.sanitizeForDisplay = exports.getAudioInfoFromElement = exports.extractFileName = exports.createQueueSnapshot = exports.cleanWebpackFilename = exports.audioChannels = exports.onQueueChange = exports.onAudioStart = exports.onAudioResume = exports.onAudioProgress = exports.onAudioPause = exports.onAudioComplete = exports.offQueueChange = exports.offAudioResume = exports.offAudioProgress = exports.offAudioPause = exports.getQueueSnapshot = exports.getCurrentAudioInfo = void 0;
 // Core queue management functions
 var core_1 = require("./core");
 Object.defineProperty(exports, "queueAudio", { enumerable: true, get: function () { return core_1.queueAudio; } });
@@ -15,6 +15,19 @@ Object.defineProperty(exports, "stopCurrentAudioInChannel", { enumerable: true,
 Object.defineProperty(exports, "stopAllAudioInChannel", { enumerable: true, get: function () { return core_1.stopAllAudioInChannel; } });
 Object.defineProperty(exports, "stopAllAudio", { enumerable: true, get: function () { return core_1.stopAllAudio; } });
 Object.defineProperty(exports, "playAudioQueue", { enumerable: true, get: function () { return core_1.playAudioQueue; } });
+Object.defineProperty(exports, "destroyChannel", { enumerable: true, get: function () { return core_1.destroyChannel; } });
+Object.defineProperty(exports, "destroyAllChannels", { enumerable: true, get: function () { return core_1.destroyAllChannels; } });
+Object.defineProperty(exports, "setQueueConfig", { enumerable: true, get: function () { return core_1.setQueueConfig; } });
+Object.defineProperty(exports, "getQueueConfig", { enumerable: true, get: function () { return core_1.getQueueConfig; } });
+Object.defineProperty(exports, "setChannelQueueLimit", { enumerable: true, get: function () { return core_1.setChannelQueueLimit; } });
+// Queue manipulation functions
+var queue_manipulation_1 = require("./queue-manipulation");
+Object.defineProperty(exports, "clearQueueAfterCurrent", { enumerable: true, get: function () { return queue_manipulation_1.clearQueueAfterCurrent; } });
+Object.defineProperty(exports, "getQueueItemInfo", { enumerable: true, get: function () { return queue_manipulation_1.getQueueItemInfo; } });
+Object.defineProperty(exports, "getQueueLength", { enumerable: true, get: function () { return queue_manipulation_1.getQueueLength; } });
+Object.defineProperty(exports, "removeQueuedItem", { enumerable: true, get: function () { return queue_manipulation_1.removeQueuedItem; } });
+Object.defineProperty(exports, "reorderQueue", { enumerable: true, get: function () { return queue_manipulation_1.reorderQueue; } });
+Object.defineProperty(exports, "swapQueueItems", { enumerable: true, get: function () { return queue_manipulation_1.swapQueueItems; } });
 // Error handling and recovery functions
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "getErrorRecovery", { enumerable: true, get: function () { return errors_1.getErrorRecovery; } });
@@ -51,6 +64,8 @@ Object.defineProperty(exports, "setAllChannelsVolume", { enumerable: true, get:
 Object.defineProperty(exports, "setChannelVolume", { enumerable: true, get: function () { return volume_1.setChannelVolume; } });
 Object.defineProperty(exports, "setVolumeDucking", { enumerable: true, get: function () { return volume_1.setVolumeDucking; } });
 Object.defineProperty(exports, "transitionVolume", { enumerable: true, get: function () { return volume_1.transitionVolume; } });
+Object.defineProperty(exports, "cancelVolumeTransition", { enumerable: true, get: function () { return volume_1.cancelVolumeTransition; } });
+Object.defineProperty(exports, "cancelAllVolumeTransitions", { enumerable: true, get: function () { return volume_1.cancelAllVolumeTransitions; } });
 // Audio information and progress tracking functions
 var info_1 = require("./info");
 Object.defineProperty(exports, "getAllChannelsInfo", { enumerable: true, get: function () { return info_1.getAllChannelsInfo; } });
@@ -75,7 +90,12 @@ Object.defineProperty(exports, "cleanWebpackFilename", { enumerable: true, get:
 Object.defineProperty(exports, "createQueueSnapshot", { enumerable: true, get: function () { return utils_1.createQueueSnapshot; } });
 Object.defineProperty(exports, "extractFileName", { enumerable: true, get: function () { return utils_1.extractFileName; } });
 Object.defineProperty(exports, "getAudioInfoFromElement", { enumerable: true, get: function () { return utils_1.getAudioInfoFromElement; } });
-// Enums
+Object.defineProperty(exports, "sanitizeForDisplay", { enumerable: true, get: function () { return utils_1.sanitizeForDisplay; } });
+Object.defineProperty(exports, "validateAudioUrl", { enumerable: true, get: function () { return utils_1.validateAudioUrl; } });
+// Enums and constants
 var types_1 = require("./types");
 Object.defineProperty(exports, "EasingType", { enumerable: true, get: function () { return types_1.EasingType; } });
 Object.defineProperty(exports, "FadeType", { enumerable: true, get: function () { return types_1.FadeType; } });
+Object.defineProperty(exports, "MAX_CHANNELS", { enumerable: true, get: function () { return types_1.MAX_CHANNELS; } });
+Object.defineProperty(exports, "TimerType", { enumerable: true, get: function () { return types_1.TimerType; } });
+Object.defineProperty(exports, "GLOBAL_PROGRESS_KEY", { enumerable: true, get: function () { return types_1.GLOBAL_PROGRESS_KEY; } });

package/dist/info.d.ts

@@ -5,6 +5,9 @@ import { AudioInfo, QueueSnapshot, ProgressCallback, QueueChangeCallback, AudioS
 /**
  * Global array to store audio channels with their queues and callback management
  * Each channel maintains its own audio queue and event callback sets
+ *
+ * Note: While you can inspect this array for debugging, direct modification is discouraged.
+ * Use the provided API functions for safe channel management.
  */
 export declare const audioChannels: ExtendedAudioQueueChannel[];
 /**
@@ -37,22 +40,24 @@ export declare const getCurrentAudioInfo: (channelNumber?: number) => AudioInfo
 export declare const getAllChannelsInfo: () => (AudioInfo | null)[];
 /**
  * Gets a complete snapshot of the queue state for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @returns QueueSnapshot object or null if channel doesn't exist
  * @example
  * ```typescript
- * const snapshot = getQueueSnapshot(0);
+ * const snapshot = getQueueSnapshot();
  * if (snapshot) {
  *   console.log(`Queue has ${snapshot.totalItems} items`);
  *   console.log(`Currently playing: ${snapshot.items[0]?.fileName}`);
  * }
+ * const channelSnapshot = getQueueSnapshot(2);
  * ```
  */
-export declare const getQueueSnapshot: (channelNumber: number) => QueueSnapshot | null;
+export declare const getQueueSnapshot: (channelNumber?: number) => QueueSnapshot | null;
 /**
  * Subscribes to real-time progress updates for a specific channel
  * @param channelNumber - The channel number
  * @param callback - Function to call with audio info updates
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioProgress(0, (info) => {
@@ -64,17 +69,19 @@ export declare const getQueueSnapshot: (channelNumber: number) => QueueSnapshot
 export declare const onAudioProgress: (channelNumber: number, callback: ProgressCallback) => void;
 /**
  * Removes progress listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioProgress(0); // Stop receiving progress updates for channel 0
+ * offAudioProgress();
+ * offAudioProgress(1); // Stop receiving progress updates for channel 1
  * ```
  */
-export declare const offAudioProgress: (channelNumber: number) => void;
+export declare function offAudioProgress(channelNumber?: number): void;
 /**
  * Subscribes to queue change events for a specific channel
  * @param channelNumber - The channel number to monitor
  * @param callback - Function to call when queue changes
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onQueueChange(0, (snapshot) => {
@@ -97,6 +104,7 @@ export declare const offQueueChange: (channelNumber: number) => void;
  * Subscribes to audio start events for a specific channel
  * @param channelNumber - The channel number to monitor
  * @param callback - Function to call when audio starts playing
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioStart(0, (info) => {
@@ -110,6 +118,7 @@ export declare const onAudioStart: (channelNumber: number, callback: AudioStartC
  * Subscribes to audio complete events for a specific channel
  * @param channelNumber - The channel number to monitor
  * @param callback - Function to call when audio completes
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioComplete(0, (info) => {
@@ -125,6 +134,7 @@ export declare const onAudioComplete: (channelNumber: number, callback: AudioCom
  * Subscribes to audio pause events for a specific channel
  * @param channelNumber - The channel number to monitor
  * @param callback - Function to call when audio is paused
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioPause(0, (channelNumber, info) => {
@@ -138,6 +148,7 @@ export declare const onAudioPause: (channelNumber: number, callback: AudioPauseC
  * Subscribes to audio resume events for a specific channel
  * @param channelNumber - The channel number to monitor
  * @param callback - Function to call when audio is resumed
+ * @throws Error if the channel number exceeds the maximum allowed channels
  * @example
  * ```typescript
  * onAudioResume(0, (channelNumber, info) => {