audio-channel-queue 1.11.0 → 1.12.1-beta.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,6 +356,13 @@ 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);
@@ -364,8 +371,9 @@ onAudioStart(0, (info) => console.log(`Started: ${info.fileName}`)); // Log audi
 
 ```typescript
 // Unsubscribe from audio start events (removes ALL start callbacks for the channel)
-offAudioStart(channelNumber);
-offAudioStart(0); // Stop receiving all start notifications for channel 0
+offAudioStart(channelNumber?);
+offAudioStart(); // Stop receiving all start notifications for default channel (0)
+offAudioStart(1); // Stop receiving all start notifications for channel 1
 ```
 
 ```typescript
@@ -376,8 +384,9 @@ onAudioComplete(0, (info) => logPlayHistory(info)); // Track completed audio
 
 ```typescript
 // Unsubscribe from audio completion events (removes ALL complete callbacks for the channel)
-offAudioComplete(channelNumber);
-offAudioComplete(0); // Stop receiving all completion notifications for channel 0
+offAudioComplete(channelNumber?);
+offAudioComplete(); // Stop receiving all completion notifications for default channel (0)
+offAudioComplete(1); // Stop receiving all completion notifications for channel 1
 ```
 
 ```typescript
@@ -386,12 +395,26 @@ 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.js

@@ -244,6 +244,8 @@ const queueAudio = (audioUrl_1, ...args_1) => __awaiter(void 0, [audioUrl_1, ...
     (0, errors_1.setupAudioErrorHandling)(audio, channelNumber, validatedUrl, (error) => __awaiter(void 0, void 0, void 0, function* () {
         yield (0, errors_1.handleAudioError)(audio, channelNumber, validatedUrl, error);
     }));
+    // Initialize Web Audio API support if needed
+    yield (0, volume_1.initializeWebAudioForAudio)(audio, channelNumber);
     // Apply options if provided
     if (options) {
         if (typeof options.loop === 'boolean') {
@@ -260,9 +262,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);
@@ -378,6 +380,7 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
                 // For non-looping audio, remove from queue and play next
                 currentAudio.pause();
                 (0, events_1.cleanupProgressTracking)(currentAudio, channelNumber, info_1.audioChannels);
+                (0, volume_1.cleanupWebAudioForAudio)(currentAudio, channelNumber);
                 channel.queue.shift();
                 channel.isPaused = false; // Reset pause state
                 // Restore volume levels AFTER removing audio from queue

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
@@ -55,7 +56,6 @@ let globalErrorRecovery = {
     showUserFeedback: false
 };
 const retryAttempts = new WeakMap();
-const loadTimeouts = new WeakMap();
 /**
  * Subscribes to audio error events for a specific channel
  * @param channelNumber - The channel number to listen to (defaults to 0)
@@ -161,10 +161,10 @@ exports.getRetryConfig = getRetryConfig;
  * ```typescript
  * setErrorRecovery({
  *   autoRetry: true,
- *   showUserFeedback: true,
+ *   fallbackToNextTrack: true,
  *   logErrorsToAnalytics: true,
  *   preserveQueueOnError: true,
- *   fallbackToNextTrack: true
+ *   showUserFeedback: true
  * });
  * ```
  */
@@ -263,34 +263,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;
 /**
@@ -305,37 +305,9 @@ const setupAudioErrorHandling = (audio, channelNumber, originalUrl, onError) =>
     const channel = info_1.audioChannels[channelNumber];
     if (!channel)
         return;
-    // Set up loading timeout with test environment compatibility
-    let timeoutId;
-    if (typeof setTimeout !== 'undefined') {
-        timeoutId = setTimeout(() => {
-            if (audio.networkState === HTMLMediaElement.NETWORK_LOADING) {
-                const timeoutError = new Error(`Audio loading timeout after ${globalRetryConfig.timeoutMs}ms`);
-                (0, exports.handleAudioError)(audio, channelNumber, originalUrl, timeoutError);
-            }
-        }, globalRetryConfig.timeoutMs);
-        loadTimeouts.set(audio, timeoutId);
-    }
-    // Clear timeout when metadata loads successfully
-    const handleLoadSuccess = () => {
-        if (typeof setTimeout !== 'undefined') {
-            const timeoutId = loadTimeouts.get(audio);
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-                loadTimeouts.delete(audio);
-            }
-        }
-    };
     // Handle various error events
     const handleError = (_event) => {
         var _a;
-        if (typeof setTimeout !== 'undefined') {
-            const timeoutId = loadTimeouts.get(audio);
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-                loadTimeouts.delete(audio);
-            }
-        }
         const error = new Error(`Audio loading failed: ${((_a = audio.error) === null || _a === void 0 ? void 0 : _a.message) || 'Unknown error'}`);
         (0, exports.handleAudioError)(audio, channelNumber, originalUrl, error);
     };
@@ -351,8 +323,6 @@ const setupAudioErrorHandling = (audio, channelNumber, originalUrl, onError) =>
     audio.addEventListener('error', handleError);
     audio.addEventListener('abort', handleAbort);
     audio.addEventListener('stalled', handleStall);
-    audio.addEventListener('loadedmetadata', handleLoadSuccess);
-    audio.addEventListener('canplay', handleLoadSuccess);
     // Custom play error handling
     if (onError) {
         const originalPlay = audio.play.bind(audio);
@@ -450,19 +420,10 @@ exports.handleAudioError = handleAudioError;
 const createProtectedAudioElement = (url, channelNumber) => __awaiter(void 0, void 0, void 0, function* () {
     const audio = new Audio();
     return new Promise((resolve, reject) => {
-        const cleanup = () => {
-            const timeoutId = loadTimeouts.get(audio);
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-                loadTimeouts.delete(audio);
-            }
-        };
         const handleSuccess = () => {
-            cleanup();
             resolve(audio);
         };
         const handleError = (error) => {
-            cleanup();
             reject(error);
         };
         // Set up error handling

package/dist/index.d.ts

@@ -7,9 +7,10 @@ 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 { cancelAllVolumeTransitions, cancelVolumeTransition, clearVolumeDucking, getAllChannelsVolume, getChannelVolume, getFadeConfig, setAllChannelsVolume, setChannelVolume, setVolumeDucking, transitionVolume } from './volume';
+export { cleanupWebAudioNodes, createWebAudioNodes, getAudioContext, getWebAudioConfig, getWebAudioSupport, getWebAudioVolume, isIOSDevice, isWebAudioSupported, resumeAudioContext, setWebAudioConfig, setWebAudioVolume, shouldUseWebAudio } from './web-audio';
 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 type { AudioCompleteCallback, AudioCompleteInfo, AudioErrorCallback, AudioErrorInfo, AudioInfo, AudioPauseCallback, AudioQueueOptions, AudioResumeCallback, AudioStartCallback, AudioStartInfo, ChannelFadeState, ErrorRecoveryOptions, ExtendedAudioQueueChannel, FadeConfig, ProgressCallback, QueueChangeCallback, QueueConfig, QueueItem, QueueManipulationResult, QueueSnapshot, RetryConfig, VolumeConfig, WebAudioConfig, WebAudioNodeSet, WebAudioSupport } 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.offAudioStart = exports.offAudioResume = exports.offAudioProgress = exports.offAudioPause = exports.offAudioComplete = exports.getQueueSnapshot = exports.getCurrentAudioInfo = void 0;
+exports.createWebAudioNodes = exports.cleanupWebAudioNodes = 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 = exports.getCurrentAudioInfo = exports.getAllChannelsInfo = exports.shouldUseWebAudio = exports.setWebAudioVolume = exports.setWebAudioConfig = exports.resumeAudioContext = exports.isWebAudioSupported = exports.isIOSDevice = exports.getWebAudioVolume = exports.getWebAudioSupport = exports.getWebAudioConfig = exports.getAudioContext = 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,8 +65,20 @@ 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; } });
+// Web Audio API support functions
+var web_audio_1 = require("./web-audio");
+Object.defineProperty(exports, "cleanupWebAudioNodes", { enumerable: true, get: function () { return web_audio_1.cleanupWebAudioNodes; } });
+Object.defineProperty(exports, "createWebAudioNodes", { enumerable: true, get: function () { return web_audio_1.createWebAudioNodes; } });
+Object.defineProperty(exports, "getAudioContext", { enumerable: true, get: function () { return web_audio_1.getAudioContext; } });
+Object.defineProperty(exports, "getWebAudioConfig", { enumerable: true, get: function () { return web_audio_1.getWebAudioConfig; } });
+Object.defineProperty(exports, "getWebAudioSupport", { enumerable: true, get: function () { return web_audio_1.getWebAudioSupport; } });
+Object.defineProperty(exports, "getWebAudioVolume", { enumerable: true, get: function () { return web_audio_1.getWebAudioVolume; } });
+Object.defineProperty(exports, "isIOSDevice", { enumerable: true, get: function () { return web_audio_1.isIOSDevice; } });
+Object.defineProperty(exports, "isWebAudioSupported", { enumerable: true, get: function () { return web_audio_1.isWebAudioSupported; } });
+Object.defineProperty(exports, "resumeAudioContext", { enumerable: true, get: function () { return web_audio_1.resumeAudioContext; } });
+Object.defineProperty(exports, "setWebAudioConfig", { enumerable: true, get: function () { return web_audio_1.setWebAudioConfig; } });
+Object.defineProperty(exports, "setWebAudioVolume", { enumerable: true, get: function () { return web_audio_1.setWebAudioVolume; } });
+Object.defineProperty(exports, "shouldUseWebAudio", { enumerable: true, get: function () { return web_audio_1.shouldUseWebAudio; } });
 // Audio information and progress tracking functions
 var info_1 = require("./info");
 Object.defineProperty(exports, "getAllChannelsInfo", { enumerable: true, get: function () { return info_1.getAllChannelsInfo; } });
@@ -96,6 +109,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

@@ -116,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
@@ -183,37 +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(0); // Stop receiving resume notifications for channel 0
+ * 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;
+export declare const offAudioResume: (channelNumber?: number) => void;
 /**
  * Removes audio start event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioStart(0); // Stop receiving start notifications for channel 0
+ * 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;
+export declare const offAudioStart: (channelNumber?: number) => void;
 /**
  * Removes audio complete event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioComplete(0); // Stop receiving completion 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 offAudioComplete: (channelNumber: number) => void;
+export declare const offAudioComplete: (channelNumber?: number) => void;

package/dist/info.js

@@ -301,13 +301,14 @@ const onQueueChange = (channelNumber, callback) => {
 exports.onQueueChange = onQueueChange;
 /**
  * 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
  * ```
  */
-const offQueueChange = (channelNumber) => {
+const offQueueChange = (channelNumber = 0) => {
     const channel = exports.audioChannels[channelNumber];
     if (!(channel === null || channel === void 0 ? void 0 : channel.queueChangeCallbacks))
         return;
@@ -462,13 +463,14 @@ const onAudioResume = (channelNumber, callback) => {
 exports.onAudioResume = onAudioResume;
 /**
  * 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
  * ```
  */
-const offAudioPause = (channelNumber) => {
+const offAudioPause = (channelNumber = 0) => {
     const channel = exports.audioChannels[channelNumber];
     if (!(channel === null || channel === void 0 ? void 0 : channel.audioPauseCallbacks))
         return;
@@ -477,13 +479,14 @@ const offAudioPause = (channelNumber) => {
 exports.offAudioPause = offAudioPause;
 /**
  * Removes resume event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioResume(0); // Stop receiving resume notifications for channel 0
+ * offAudioResume(); // Stop receiving resume notifications for default channel (0)
+ * offAudioResume(1); // Stop receiving resume notifications for channel 1
  * ```
  */
-const offAudioResume = (channelNumber) => {
+const offAudioResume = (channelNumber = 0) => {
     const channel = exports.audioChannels[channelNumber];
     if (!(channel === null || channel === void 0 ? void 0 : channel.audioResumeCallbacks))
         return;
@@ -492,13 +495,14 @@ const offAudioResume = (channelNumber) => {
 exports.offAudioResume = offAudioResume;
 /**
  * Removes audio start event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioStart(0); // Stop receiving start notifications for channel 0
+ * offAudioStart(); // Stop receiving start notifications for default channel (0)
+ * offAudioStart(1); // Stop receiving start notifications for channel 1
  * ```
  */
-const offAudioStart = (channelNumber) => {
+const offAudioStart = (channelNumber = 0) => {
     const channel = exports.audioChannels[channelNumber];
     if (!(channel === null || channel === void 0 ? void 0 : channel.audioStartCallbacks))
         return;
@@ -507,13 +511,14 @@ const offAudioStart = (channelNumber) => {
 exports.offAudioStart = offAudioStart;
 /**
  * Removes audio complete event listeners for a specific channel
- * @param channelNumber - The channel number
+ * @param channelNumber - The channel number (defaults to 0)
  * @example
  * ```typescript
- * offAudioComplete(0); // Stop receiving completion notifications for channel 0
+ * offAudioComplete(); // Stop receiving completion notifications for default channel (0)
+ * offAudioComplete(1); // Stop receiving completion notifications for channel 1
  * ```
  */
-const offAudioComplete = (channelNumber) => {
+const offAudioComplete = (channelNumber = 0) => {
     const channel = exports.audioChannels[channelNumber];
     if (!(channel === null || channel === void 0 ? void 0 : channel.audioCompleteCallbacks))
         return;