audio-channel-queue 1.10.0 → 1.12.0

package/README.md

@@ -75,8 +75,8 @@ Install this package by running either of these commands (typescript packages ar
 ```typescript
 // Add an audio file to the queue and start playing it automatically.
 queueAudio(audioUrl, channelNumber?, options?);
-queueAudio('hello.mp3'); // Add to default channel 0
-queueAudio('laser.mp3', 1, { loop: true, volume: 0.8 }); // Add to channel 1 with options
+await queueAudio('hello.mp3'); // Add to default channel 0
+await queueAudio('laser.mp3', 1, { loop: true, volume: 0.8 }); // Add to channel 1 with options
 ```
 
 
@@ -84,8 +84,8 @@ queueAudio('laser.mp3', 1, { loop: true, volume: 0.8 }); // Add to channel 1 wit
 ```typescript
 // Add a file to the front of the queue (plays after current audio finishes).
 queueAudioPriority(audioUrl, channelNumber?, options?);
-queueAudioPriority('urgent.mp3'); // Add to front of default channel 0
-queueAudioPriority('announcement.mp3', 1, { volume: 1.0 }); // Add to front of channel 1
+await queueAudioPriority('urgent.mp3'); // Add to front of default channel 0
+await queueAudioPriority('announcement.mp3', 1, { volume: 1.0 }); // Add to front of channel 1
 ```
 
 
@@ -93,8 +93,8 @@ queueAudioPriority('announcement.mp3', 1, { volume: 1.0 }); // Add to front of c
 ```typescript
 // Stop the current audio and automatically start playing the next one in queue.
 stopCurrentAudioInChannel(channelNumber?);
-stopCurrentAudioInChannel(); // Stop current audio in default channel (0)
-stopCurrentAudioInChannel(2); // Stop current audio in channel 2
+await stopCurrentAudioInChannel(); // Stop current audio in default channel (0)
+await stopCurrentAudioInChannel(2); // Stop current audio in channel 2
 ```
 
 
@@ -102,14 +102,14 @@ stopCurrentAudioInChannel(2); // Stop current audio in channel 2
 ```typescript
 // Stop all audio in a channel and remove all enqueued files.
 stopAllAudioInChannel(channelNumber?);
-stopAllAudioInChannel(); // Stop and clear all audio in default channel (0)
-stopAllAudioInChannel(1); // Stop and clear all audio in channel 1
+await stopAllAudioInChannel(); // Stop and clear all audio in default channel (0)
+await stopAllAudioInChannel(1); // Stop and clear all audio in channel 1
 ```
 
 ### Stop All Audio
 ```typescript
 // Stop all audio in all channels and remove all enqueued files.
-stopAllAudio();
+await stopAllAudio();
 ```
 
 ## 🔄 Advanced Queue Manipulation:
@@ -118,32 +118,32 @@ stopAllAudio();
 ```typescript
 // Remove a specific item from the queue by its position (cannot remove currently playing item at index 0).
 removeQueuedItem(queuedSlotNumber, channelNumber?);
-const result = removeQueuedItem(2); // Remove item at index 2 from default channel (0)
-const result = removeQueuedItem(1, 1); // Remove item at index 1 from channel 1
+const result = await removeQueuedItem(2); // Remove item at index 2 from default channel (0)
+const result = await removeQueuedItem(1, 1); // Remove item at index 1 from channel 1
 ```
 
 ### Reorder Queue Items
 ```typescript
 // Move a queue item from one position to another (cannot move currently playing item at index 0).
 reorderQueue(currentQueuedSlotNumber, newQueuedSlotNumber, channelNumber?);
-const result = reorderQueue(3, 1); // Move item from index 3 to index 1 in default channel (0)
-const result = reorderQueue(2, 4, 1); // Move item from index 2 to index 4 in channel 1
+const result = await reorderQueue(3, 1); // Move item from index 3 to index 1 in default channel (0)
+const result = await reorderQueue(2, 4, 1); // Move item from index 2 to index 4 in channel 1
 ```
 
 ### Clear Queue After Current
 ```typescript
 // Remove all items from the queue except the currently playing audio.
 clearQueueAfterCurrent(channelNumber?);
-const result = clearQueueAfterCurrent(); // Clear queue after current in default channel (0)
-const result = clearQueueAfterCurrent(2); // Clear queue after current in channel 2
+const result = await clearQueueAfterCurrent(); // Clear queue after current in default channel (0)
+const result = await clearQueueAfterCurrent(2); // Clear queue after current in channel 2
 ```
 
 ### Swap Queue Items
 ```typescript
 // Swap the positions of two items in the queue (cannot involve currently playing item at index 0).
 swapQueueItems(firstQueuedSlotNumber, secondQueuedSlotNumber, channelNumber?);
-const result = swapQueueItems(1, 3); // Swap items at index 1 and 3 in default channel (0)
-const result = swapQueueItems(2, 4, 1); // Swap items at index 2 and 4 in channel 1
+const result = await swapQueueItems(1, 3); // Swap items at index 1 and 3 in default channel (0)
+const result = await swapQueueItems(2, 4, 1); // Swap items at index 2 and 4 in channel 1
 ```
 
 ### Get Queue Item Info
@@ -177,8 +177,8 @@ interface QueueManipulationResult {
 ```typescript
 // Set the volume for a specific channel (0-1 range).
 setChannelVolume(channelNumber, volume);
-setChannelVolume(0, 0.5); // Set channel 0 to 50% volume
-setChannelVolume(1, 0.8); // Set channel 1 to 80% volume
+await setChannelVolume(0, 0.5); // Set channel 0 to 50% volume
+await setChannelVolume(1, 0.8); // Set channel 1 to 80% volume
 ```
 
 ### Get Channel Volume
@@ -193,8 +193,8 @@ console.log(`Channel volume: ${(getChannelVolume(2) * 100).toFixed(0)}%`); // Ge
 ```typescript
 // Set the same volume level for all channels.
 setAllChannelsVolume(volume);
-setAllChannelsVolume(0.6); // Set all channels to 60% volume
-setAllChannelsVolume(0.0); // Mute all channels
+await setAllChannelsVolume(0.6); // Set all channels to 60% volume
+await setAllChannelsVolume(0.0); // Mute all channels
 ```
 
 ### Volume Ducking (Background Audio Reduction)
@@ -356,30 +356,65 @@ onQueueChange(channelNumber, callback);
 onQueueChange(0, (snapshot) => updateQueueDisplay(snapshot)); // Update UI on queue changes
 ```
 
+```typescript
+// Unsubscribe from queue change events (removes ALL queue change callbacks for the channel)
+offQueueChange(channelNumber?);
+offQueueChange(); // Stop receiving all queue change notifications for default channel (0)
+offQueueChange(1); // Stop receiving all queue change notifications for channel 1
+```
+
 ```typescript
 // Subscribe to audio start events.
 onAudioStart(channelNumber, callback);
 onAudioStart(0, (info) => console.log(`Started: ${info.fileName}`)); // Log audio starts
 ```
 
+```typescript
+// Unsubscribe from audio start events (removes ALL start callbacks for the channel)
+offAudioStart(channelNumber?);
+offAudioStart(); // Stop receiving all start notifications for default channel (0)
+offAudioStart(1); // Stop receiving all start notifications for channel 1
+```
+
 ```typescript
 // Subscribe to audio completion events.
 onAudioComplete(channelNumber, callback);
 onAudioComplete(0, (info) => logPlayHistory(info)); // Track completed audio
 ```
 
+```typescript
+// Unsubscribe from audio completion events (removes ALL complete callbacks for the channel)
+offAudioComplete(channelNumber?);
+offAudioComplete(); // Stop receiving all completion notifications for default channel (0)
+offAudioComplete(1); // Stop receiving all completion notifications for channel 1
+```
+
 ```typescript
 // Subscribe to audio pause events.
 onAudioPause(channelNumber, callback);
 onAudioPause(0, (info) => showPauseIcon(info)); // Show pause state in UI
 ```
 
+```typescript
+// Unsubscribe from audio pause events (removes ALL pause callbacks for the channel)
+offAudioPause(channelNumber?);
+offAudioPause(); // Stop receiving all pause notifications for default channel (0)
+offAudioPause(1); // Stop receiving all pause notifications for channel 1
+```
+
 ```typescript
 // Subscribe to audio resume events.
 onAudioResume(channelNumber, callback);
 onAudioResume(0, (info) => showPlayIcon(info)); // Show play state in UI
 ```
 
+```typescript
+// Unsubscribe from audio resume events (removes ALL resume callbacks for the channel)
+offAudioResume(channelNumber?);
+offAudioResume(); // Stop receiving all resume notifications for default channel (0)
+offAudioResume(1); // Stop receiving all resume notifications for channel 1
+```
+
 ### TypeScript Support
 If you cannot import audio files into your app, you may need a `custom.d.ts` file in the root directory. An example of one is shown here:
 

package/dist/core.d.ts

@@ -73,10 +73,10 @@ export declare const queueAudioPriority: (audioUrl: string, channelNumber?: numb
 /**
  * Plays the audio queue for a specific channel
  * @param channelNumber - The channel number to play
- * @returns Promise that resolves when the current audio finishes playing
+ * @returns Promise that resolves when the audio starts playing (setup complete)
  * @example
  * ```typescript
- * await playAudioQueue(0); // Play queue for channel 0
+ * await playAudioQueue(0); // Start playing queue for channel 0
  * ```
  */
 export declare const playAudioQueue: (channelNumber: number) => Promise<void>;

package/dist/core.js

@@ -260,9 +260,9 @@ const queueAudio = (audioUrl_1, ...args_1) => __awaiter(void 0, [audioUrl_1, ...
             channel.maxQueueSize = options.maxQueueSize;
         }
     }
-    // Handle priority option (same as addToFront for backward compatibility)
-    const shouldAddToFront = (options === null || options === void 0 ? void 0 : options.addToFront) || (options === null || options === void 0 ? void 0 : options.priority);
-    // Add to queue based on priority/addToFront option
+    // Handle addToFront option
+    const shouldAddToFront = options === null || options === void 0 ? void 0 : options.addToFront;
+    // Add to queue based on addToFront option
     if (shouldAddToFront && channel.queue.length > 0) {
         // Insert after currently playing track (at index 1)
         channel.queue.splice(1, 0, audio);
@@ -279,12 +279,8 @@ const queueAudio = (audioUrl_1, ...args_1) => __awaiter(void 0, [audioUrl_1, ...
     (0, events_1.emitQueueChange)(channelNumber, info_1.audioChannels);
     // Start playing if this is the first item and channel isn't paused
     if (channel.queue.length === 1 && !channel.isPaused) {
-        // Use setTimeout to ensure the queue change event is emitted first
-        setTimeout(() => {
-            (0, exports.playAudioQueue)(channelNumber).catch((error) => {
-                (0, errors_1.handleAudioError)(audio, channelNumber, validatedUrl, error);
-            });
-        }, 0);
+        // Await the audio setup to complete before resolving queueAudio
+        yield (0, exports.playAudioQueue)(channelNumber);
     }
 });
 exports.queueAudio = queueAudio;
@@ -309,10 +305,10 @@ exports.queueAudioPriority = queueAudioPriority;
 /**
  * Plays the audio queue for a specific channel
  * @param channelNumber - The channel number to play
- * @returns Promise that resolves when the current audio finishes playing
+ * @returns Promise that resolves when the audio starts playing (setup complete)
  * @example
  * ```typescript
- * await playAudioQueue(0); // Play queue for channel 0
+ * await playAudioQueue(0); // Start playing queue for channel 0
  * ```
  */
 const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, function* () {
@@ -331,6 +327,7 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
         let hasStarted = false;
         let metadataLoaded = false;
         let playStarted = false;
+        let setupComplete = false;
         // Check if we should fire onAudioStart (both conditions met)
         const tryFireAudioStart = () => {
             if (!hasStarted && metadataLoaded && playStarted) {
@@ -341,6 +338,11 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
                     fileName: (0, utils_1.extractFileName)(currentAudio.src),
                     src: currentAudio.src
                 }, info_1.audioChannels);
+                // Resolve setup promise when audio start event is fired
+                if (!setupComplete) {
+                    setupComplete = true;
+                    resolve();
+                }
             }
         };
         // Event handler for when metadata loads (duration becomes available)
@@ -371,7 +373,6 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
                 catch (error) {
                     yield (0, errors_1.handleAudioError)(currentAudio, channelNumber, currentAudio.src, error);
                 }
-                resolve();
             }
             else {
                 // For non-looping audio, remove from queue and play next
@@ -384,7 +385,6 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
                 (0, events_1.emitQueueChange)(channelNumber, info_1.audioChannels);
                 // Play next audio immediately if there's more in queue
                 yield (0, exports.playAudioQueue)(channelNumber);
-                resolve();
             }
         });
         // Add event listeners
@@ -398,7 +398,10 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
         // Enhanced play with error handling
         currentAudio.play().catch((error) => __awaiter(void 0, void 0, void 0, function* () {
             yield (0, errors_1.handleAudioError)(currentAudio, channelNumber, currentAudio.src, error);
-            resolve(); // Resolve to prevent hanging
+            if (!setupComplete) {
+                setupComplete = true;
+                resolve(); // Resolve gracefully instead of rejecting
+            }
         }));
     });
 });

package/dist/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Error handling, retry logic, and recovery mechanisms for the audio-channel-queue package
  */
-import { AudioErrorInfo, AudioErrorCallback, RetryConfig, ErrorRecoveryOptions, ExtendedAudioQueueChannel } from './types';
+import { AudioErrorInfo, AudioErrorCallback, AudioErrorType, RetryConfig, ErrorRecoveryOptions, ExtendedAudioQueueChannel } from './types';
 /**
  * Subscribes to audio error events for a specific channel
  * @param channelNumber - The channel number to listen to (defaults to 0)
@@ -61,10 +61,10 @@ export declare const getRetryConfig: () => RetryConfig;
  * ```typescript
  * setErrorRecovery({
  *   autoRetry: true,
- *   showUserFeedback: true,
+ *   fallbackToNextTrack: true,
  *   logErrorsToAnalytics: true,
  *   preserveQueueOnError: true,
- *   fallbackToNextTrack: true
+ *   showUserFeedback: true
  * });
  * ```
  */
@@ -109,7 +109,7 @@ export declare const emitAudioError: (channelNumber: number, errorInfo: AudioErr
  * @returns The categorized error type
  * @internal
  */
-export declare const categorizeError: (error: Error, audio: HTMLAudioElement) => AudioErrorInfo["errorType"];
+export declare const categorizeError: (error: Error, audio: HTMLAudioElement) => AudioErrorType;
 /**
  * Sets up comprehensive error handling for an audio element
  * @param audio - The audio element to set up error handling for

package/dist/errors.js

@@ -43,6 +43,7 @@ let globalRetryConfig = {
     baseDelay: 1000,
     enabled: true,
     exponentialBackoff: true,
+    fallbackUrls: [],
     maxRetries: 3,
     skipOnFailure: false,
     timeoutMs: 10000
@@ -161,10 +162,10 @@ exports.getRetryConfig = getRetryConfig;
  * ```typescript
  * setErrorRecovery({
  *   autoRetry: true,
- *   showUserFeedback: true,
+ *   fallbackToNextTrack: true,
  *   logErrorsToAnalytics: true,
  *   preserveQueueOnError: true,
- *   fallbackToNextTrack: true
+ *   showUserFeedback: true
  * });
  * ```
  */
@@ -263,34 +264,34 @@ exports.emitAudioError = emitAudioError;
 const categorizeError = (error, audio) => {
     const errorMessage = error.message.toLowerCase();
     if (errorMessage.includes('network') || errorMessage.includes('fetch')) {
-        return 'network';
+        return types_1.AudioErrorType.Network;
     }
     // Check for unsupported format first (more specific than decode)
     if (errorMessage.includes('not supported') ||
         errorMessage.includes('unsupported') ||
         errorMessage.includes('format not supported')) {
-        return 'unsupported';
+        return types_1.AudioErrorType.Unsupported;
     }
     if (errorMessage.includes('decode') || errorMessage.includes('format')) {
-        return 'decode';
+        return types_1.AudioErrorType.Decode;
     }
     if (errorMessage.includes('permission') || errorMessage.includes('blocked')) {
-        return 'permission';
+        return types_1.AudioErrorType.Permission;
     }
     if (errorMessage.includes('abort')) {
-        return 'abort';
+        return types_1.AudioErrorType.Abort;
     }
     if (errorMessage.includes('timeout')) {
-        return 'timeout';
+        return types_1.AudioErrorType.Timeout;
     }
     // Check audio element network state for more context
     if (audio.networkState === HTMLMediaElement.NETWORK_NO_SOURCE) {
-        return 'network';
+        return types_1.AudioErrorType.Network;
     }
     if (audio.networkState === HTMLMediaElement.NETWORK_LOADING) {
-        return 'timeout';
+        return types_1.AudioErrorType.Timeout;
     }
-    return 'unknown';
+    return types_1.AudioErrorType.Unknown;
 };
 exports.categorizeError = categorizeError;
 /**

package/dist/index.d.ts

@@ -7,9 +7,9 @@ export { queueAudio, queueAudioPriority, stopCurrentAudioInChannel, stopAllAudio
 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 { cancelAllVolumeTransitions, cancelVolumeTransition, clearVolumeDucking, getAllChannelsVolume, getChannelVolume, getFadeConfig, setAllChannelsVolume, setChannelVolume, setVolumeDucking, transitionVolume } from './volume';
+export { getAllChannelsInfo, getCurrentAudioInfo, getQueueSnapshot, offAudioComplete, offAudioPause, offAudioProgress, offAudioResume, offAudioStart, offQueueChange, onAudioComplete, onAudioPause, onAudioProgress, onAudioResume, onAudioStart, onQueueChange } from './info';
 export { audioChannels } from './info';
 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';
+export { AudioErrorType, 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.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;
+exports.getCurrentAudioInfo = exports.getAllChannelsInfo = exports.transitionVolume = exports.setVolumeDucking = exports.setChannelVolume = exports.setAllChannelsVolume = exports.getFadeConfig = exports.getChannelVolume = exports.getAllChannelsVolume = exports.clearVolumeDucking = exports.cancelVolumeTransition = exports.cancelAllVolumeTransitions = 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.AudioErrorType = 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.offAudioStart = exports.offAudioResume = exports.offAudioProgress = exports.offAudioPause = exports.offAudioComplete = exports.getQueueSnapshot = void 0;
 // Core queue management functions
 var core_1 = require("./core");
 Object.defineProperty(exports, "queueAudio", { enumerable: true, get: function () { return core_1.queueAudio; } });
@@ -55,8 +55,9 @@ Object.defineProperty(exports, "togglePauseChannel", { enumerable: true, get: fu
 Object.defineProperty(exports, "togglePauseWithFade", { enumerable: true, get: function () { return pause_1.togglePauseWithFade; } });
 // Volume control and ducking functions
 var volume_1 = require("./volume");
+Object.defineProperty(exports, "cancelAllVolumeTransitions", { enumerable: true, get: function () { return volume_1.cancelAllVolumeTransitions; } });
+Object.defineProperty(exports, "cancelVolumeTransition", { enumerable: true, get: function () { return volume_1.cancelVolumeTransition; } });
 Object.defineProperty(exports, "clearVolumeDucking", { enumerable: true, get: function () { return volume_1.clearVolumeDucking; } });
-Object.defineProperty(exports, "fadeVolume", { enumerable: true, get: function () { return volume_1.fadeVolume; } });
 Object.defineProperty(exports, "getAllChannelsVolume", { enumerable: true, get: function () { return volume_1.getAllChannelsVolume; } });
 Object.defineProperty(exports, "getChannelVolume", { enumerable: true, get: function () { return volume_1.getChannelVolume; } });
 Object.defineProperty(exports, "getFadeConfig", { enumerable: true, get: function () { return volume_1.getFadeConfig; } });
@@ -64,16 +65,16 @@ 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; } });
 Object.defineProperty(exports, "getCurrentAudioInfo", { enumerable: true, get: function () { return info_1.getCurrentAudioInfo; } });
 Object.defineProperty(exports, "getQueueSnapshot", { enumerable: true, get: function () { return info_1.getQueueSnapshot; } });
+Object.defineProperty(exports, "offAudioComplete", { enumerable: true, get: function () { return info_1.offAudioComplete; } });
 Object.defineProperty(exports, "offAudioPause", { enumerable: true, get: function () { return info_1.offAudioPause; } });
 Object.defineProperty(exports, "offAudioProgress", { enumerable: true, get: function () { return info_1.offAudioProgress; } });
 Object.defineProperty(exports, "offAudioResume", { enumerable: true, get: function () { return info_1.offAudioResume; } });
+Object.defineProperty(exports, "offAudioStart", { enumerable: true, get: function () { return info_1.offAudioStart; } });
 Object.defineProperty(exports, "offQueueChange", { enumerable: true, get: function () { return info_1.offQueueChange; } });
 Object.defineProperty(exports, "onAudioComplete", { enumerable: true, get: function () { return info_1.onAudioComplete; } });
 Object.defineProperty(exports, "onAudioPause", { enumerable: true, get: function () { return info_1.onAudioPause; } });
@@ -94,6 +95,7 @@ Object.defineProperty(exports, "sanitizeForDisplay", { enumerable: true, get: fu
 Object.defineProperty(exports, "validateAudioUrl", { enumerable: true, get: function () { return utils_1.validateAudioUrl; } });
 // Enums and constants
 var types_1 = require("./types");
+Object.defineProperty(exports, "AudioErrorType", { enumerable: true, get: function () { return types_1.AudioErrorType; } });
 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; } });

package/dist/info.d.ts

@@ -2,6 +2,29 @@
  * @fileoverview Audio information and progress tracking functions for the audio-channel-queue package
  */
 import { AudioInfo, QueueSnapshot, ProgressCallback, QueueChangeCallback, AudioStartCallback, AudioCompleteCallback, AudioPauseCallback, AudioResumeCallback, ExtendedAudioQueueChannel } from './types';
+/**
+ * Gets the current list of whitelisted channel properties
+ * This is automatically derived from the ExtendedAudioQueueChannel interface
+ * @returns Array of whitelisted property names
+ * @internal
+ */
+export declare const getWhitelistedChannelProperties: () => string[];
+/**
+ * Returns the list of non-whitelisted properties found on a specific channel
+ * These are properties that will trigger warnings when modified directly
+ * @param channelNumber - The channel number to inspect (defaults to 0)
+ * @returns Array of property names that are not in the whitelist, or empty array if channel doesn't exist
+ * @example
+ * ```typescript
+ * // Add some custom property to a channel
+ * (audioChannels[0] as any).customProperty = 'test';
+ *
+ * const nonWhitelisted = getNonWhitelistedChannelProperties(0);
+ * console.log(nonWhitelisted); // ['customProperty']
+ * ```
+ * @internal
+ */
+export declare const getNonWhitelistedChannelProperties: (channelNumber?: number) => string[];
 /**
  * Global array to store audio channels with their queues and callback management
  * Each channel maintains its own audio queue and event callback sets
@@ -93,13 +116,14 @@ export declare function offAudioProgress(channelNumber?: number): void;
 export declare const onQueueChange: (channelNumber: number, callback: QueueChangeCallback) => void;
 /**
  * Removes queue change listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offQueueChange(0); // Stop receiving queue change notifications for channel 0
+ * offQueueChange(); // Stop receiving queue change notifications for default channel (0)
+ * offQueueChange(1); // Stop receiving queue change notifications for channel 1
  * ```
  */
-export declare const offQueueChange: (channelNumber: number) => void;
+export declare const offQueueChange: (channelNumber?: number) => void;
 /**
  * Subscribes to audio start events for a specific channel
  * @param channelNumber - The channel number to monitor
@@ -160,19 +184,41 @@ export declare const onAudioPause: (channelNumber: number, callback: AudioPauseC
 export declare const onAudioResume: (channelNumber: number, callback: AudioResumeCallback) => void;
 /**
  * Removes pause event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioPause(0); // Stop receiving pause notifications for channel 0
+ * offAudioPause(); // Stop receiving pause notifications for default channel (0)
+ * offAudioPause(1); // Stop receiving pause notifications for channel 1
  * ```
  */
-export declare const offAudioPause: (channelNumber: number) => void;
+export declare const offAudioPause: (channelNumber?: number) => void;
 /**
  * Removes resume event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
+ * @example
+ * ```typescript
+ * offAudioResume(); // Stop receiving resume notifications for default channel (0)
+ * offAudioResume(1); // Stop receiving resume notifications for channel 1
+ * ```
+ */
+export declare const offAudioResume: (channelNumber?: number) => void;
+/**
+ * Removes audio start event listeners for a specific channel
+ * @param channelNumber - The channel number (defaults to 0)
+ * @example
+ * ```typescript
+ * offAudioStart(); // Stop receiving start notifications for default channel (0)
+ * offAudioStart(1); // Stop receiving start notifications for channel 1
+ * ```
+ */
+export declare const offAudioStart: (channelNumber?: number) => void;
+/**
+ * Removes audio complete event listeners for a specific channel
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioResume(0); // Stop receiving resume notifications for channel 0
+ * offAudioComplete(); // Stop receiving completion notifications for default channel (0)
+ * offAudioComplete(1); // Stop receiving completion notifications for channel 1
  * ```
  */
-export declare const offAudioResume: (channelNumber: number) => void;
+export declare const offAudioComplete: (channelNumber?: number) => void;