audio-channel-queue 1.7.0 → 1.9.0

package/dist/core.js

@@ -143,7 +143,7 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
                 hasStarted = true;
                 (0, events_1.emitAudioStart)(channelNumber, {
                     channelNumber,
-                    duration: currentAudio.duration * 1000, // Now guaranteed to have valid duration
+                    duration: currentAudio.duration * 1000,
                     fileName: (0, utils_1.extractFileName)(currentAudio.src),
                     src: currentAudio.src
                 }, info_1.audioChannels);
@@ -200,7 +200,7 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
         currentAudio.addEventListener('play', handlePlay);
         currentAudio.addEventListener('ended', handleEnded);
         // Check if metadata is already loaded (in case it loads before we add the listener)
-        if (currentAudio.readyState >= 1) { // HAVE_METADATA or higher
+        if (currentAudio.readyState >= 1) {
             metadataLoaded = true;
         }
         // Enhanced play with error handling
@@ -238,6 +238,7 @@ const stopCurrentAudioInChannel = (...args_1) => __awaiter(void 0, [...args_1],
         channel.isPaused = false; // Reset pause state
         (0, events_1.emitQueueChange)(channelNumber, info_1.audioChannels);
         // Start next audio without waiting for it to complete
+        // eslint-disable-next-line no-console
         (0, exports.playAudioQueue)(channelNumber).catch(console.error);
     }
 });
@@ -268,7 +269,7 @@ const stopAllAudioInChannel = (...args_1) => __awaiter(void 0, [...args_1], void
             (0, events_1.cleanupProgressTracking)(currentAudio, channelNumber, info_1.audioChannels);
         }
         // Clean up all progress tracking for this channel
-        channel.queue.forEach(audio => (0, events_1.cleanupProgressTracking)(audio, channelNumber, info_1.audioChannels));
+        channel.queue.forEach((audio) => (0, events_1.cleanupProgressTracking)(audio, channelNumber, info_1.audioChannels));
         channel.queue = [];
         channel.isPaused = false; // Reset pause state
         (0, events_1.emitQueueChange)(channelNumber, info_1.audioChannels);

package/dist/errors.js

@@ -39,19 +39,19 @@ exports.createProtectedAudioElement = exports.handleAudioError = exports.setupAu
 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();
@@ -191,11 +191,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 +209,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 +230,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 +257,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 +318,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 +369,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 +421,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

@@ -4,10 +4,11 @@
  * 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, pauseChannel, resumeAllChannels, resumeChannel, togglePauseAllChannels, togglePauseChannel, } from './pause';
-export { clearVolumeDucking, getAllChannelsVolume, getChannelVolume, setAllChannelsVolume, setChannelVolume, setVolumeDucking, } from './volume';
-export { getAllChannelsInfo, getCurrentAudioInfo, getQueueSnapshot, offAudioPause, offAudioProgress, offAudioResume, offQueueChange, onAudioComplete, onAudioPause, onAudioProgress, onAudioResume, onAudioStart, onQueueChange, } from './info';
+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 { audioChannels } from './info';
 export { cleanWebpackFilename, createQueueSnapshot, extractFileName, getAudioInfoFromElement } from './utils';
-export type { AudioCompleteCallback, AudioCompleteInfo, AudioErrorCallback, AudioErrorInfo, AudioInfo, AudioPauseCallback, AudioQueueOptions, AudioResumeCallback, AudioStartCallback, AudioStartInfo, ErrorRecoveryOptions, ExtendedAudioQueueChannel, ProgressCallback, QueueChangeCallback, QueueItem, QueueSnapshot, RetryConfig, VolumeConfig } from './types';
+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, GLOBAL_PROGRESS_KEY } from './types';

package/dist/index.js

@@ -5,7 +5,8 @@
  * volume management with ducking, progress tracking, and comprehensive event system
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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 = exports.getAllChannelsInfo = exports.setVolumeDucking = exports.setChannelVolume = exports.setAllChannelsVolume = exports.getChannelVolume = exports.getAllChannelsVolume = exports.clearVolumeDucking = exports.togglePauseChannel = exports.togglePauseAllChannels = exports.resumeChannel = exports.resumeAllChannels = exports.pauseChannel = 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.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.GLOBAL_PROGRESS_KEY = exports.FadeType = exports.EasingType = exports.getAudioInfoFromElement = exports.extractFileName = exports.createQueueSnapshot = exports.cleanWebpackFilename = void 0;
 // Core queue management functions
 var core_1 = require("./core");
 Object.defineProperty(exports, "queueAudio", { enumerable: true, get: function () { return core_1.queueAudio; } });
@@ -28,19 +29,28 @@ var pause_1 = require("./pause");
 Object.defineProperty(exports, "getAllChannelsPauseState", { enumerable: true, get: function () { return pause_1.getAllChannelsPauseState; } });
 Object.defineProperty(exports, "isChannelPaused", { enumerable: true, get: function () { return pause_1.isChannelPaused; } });
 Object.defineProperty(exports, "pauseAllChannels", { enumerable: true, get: function () { return pause_1.pauseAllChannels; } });
+Object.defineProperty(exports, "pauseAllWithFade", { enumerable: true, get: function () { return pause_1.pauseAllWithFade; } });
 Object.defineProperty(exports, "pauseChannel", { enumerable: true, get: function () { return pause_1.pauseChannel; } });
+Object.defineProperty(exports, "pauseWithFade", { enumerable: true, get: function () { return pause_1.pauseWithFade; } });
 Object.defineProperty(exports, "resumeAllChannels", { enumerable: true, get: function () { return pause_1.resumeAllChannels; } });
+Object.defineProperty(exports, "resumeAllWithFade", { enumerable: true, get: function () { return pause_1.resumeAllWithFade; } });
 Object.defineProperty(exports, "resumeChannel", { enumerable: true, get: function () { return pause_1.resumeChannel; } });
+Object.defineProperty(exports, "resumeWithFade", { enumerable: true, get: function () { return pause_1.resumeWithFade; } });
 Object.defineProperty(exports, "togglePauseAllChannels", { enumerable: true, get: function () { return pause_1.togglePauseAllChannels; } });
+Object.defineProperty(exports, "togglePauseAllWithFade", { enumerable: true, get: function () { return pause_1.togglePauseAllWithFade; } });
 Object.defineProperty(exports, "togglePauseChannel", { enumerable: true, get: function () { return pause_1.togglePauseChannel; } });
+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, "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; } });
 Object.defineProperty(exports, "setAllChannelsVolume", { enumerable: true, get: function () { return volume_1.setAllChannelsVolume; } });
 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; } });
 // Audio information and progress tracking functions
 var info_1 = require("./info");
 Object.defineProperty(exports, "getAllChannelsInfo", { enumerable: true, get: function () { return info_1.getAllChannelsInfo; } });
@@ -65,3 +75,8 @@ 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 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, "GLOBAL_PROGRESS_KEY", { enumerable: true, get: function () { return types_1.GLOBAL_PROGRESS_KEY; } });

package/dist/info.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.offAudioResume = exports.offAudioPause = exports.onAudioResume = exports.onAudioPause = exports.onAudioComplete = exports.onAudioStart = exports.offQueueChange = exports.onQueueChange = exports.offAudioProgress = exports.onAudioProgress = exports.getQueueSnapshot = exports.getAllChannelsInfo = exports.getCurrentAudioInfo = exports.audioChannels = void 0;
+const types_1 = require("./types");
 const utils_1 = require("./utils");
 const events_1 = require("./events");
 /**
@@ -113,10 +114,10 @@ const onAudioProgress = (channelNumber, callback) => {
         (0, events_1.setupProgressTracking)(currentAudio, channelNumber, exports.audioChannels);
     }
     // Store callback for future audio elements in this channel
-    if (!channel.progressCallbacks.has(null)) {
-        channel.progressCallbacks.set(null, new Set());
+    if (!channel.progressCallbacks.has(types_1.GLOBAL_PROGRESS_KEY)) {
+        channel.progressCallbacks.set(types_1.GLOBAL_PROGRESS_KEY, new Set());
     }
-    channel.progressCallbacks.get(null).add(callback);
+    channel.progressCallbacks.get(types_1.GLOBAL_PROGRESS_KEY).add(callback);
 };
 exports.onAudioProgress = onAudioProgress;
 /**
@@ -129,7 +130,7 @@ exports.onAudioProgress = onAudioProgress;
  */
 const offAudioProgress = (channelNumber) => {
     const channel = exports.audioChannels[channelNumber];
-    if (!channel || !channel.progressCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.progressCallbacks))
         return;
     // Clean up event listeners for current audio if exists
     if (channel.queue.length > 0) {
@@ -184,7 +185,7 @@ exports.onQueueChange = onQueueChange;
  */
 const offQueueChange = (channelNumber) => {
     const channel = exports.audioChannels[channelNumber];
-    if (!channel || !channel.queueChangeCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.queueChangeCallbacks))
         return;
     channel.queueChangeCallbacks.clear();
 };
@@ -337,7 +338,7 @@ exports.onAudioResume = onAudioResume;
  */
 const offAudioPause = (channelNumber) => {
     const channel = exports.audioChannels[channelNumber];
-    if (!channel || !channel.audioPauseCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioPauseCallbacks))
         return;
     channel.audioPauseCallbacks.clear();
 };
@@ -352,7 +353,7 @@ exports.offAudioPause = offAudioPause;
  */
 const offAudioResume = (channelNumber) => {
     const channel = exports.audioChannels[channelNumber];
-    if (!channel || !channel.audioResumeCallbacks)
+    if (!(channel === null || channel === void 0 ? void 0 : channel.audioResumeCallbacks))
         return;
     channel.audioResumeCallbacks.clear();
 };

package/dist/pause.d.ts

@@ -1,6 +1,89 @@
 /**
  * @fileoverview Pause and resume management functions for the audio-channel-queue package
  */
+import { FadeType } from './types';
+/**
+ * Pauses the currently playing audio in a specific channel with smooth volume fade
+ * @param fadeType - Type of fade transition to apply
+ * @param channelNumber - The channel number to pause (defaults to 0)
+ * @param duration - Optional custom fade duration in milliseconds (uses fadeType default if not provided)
+ * @returns Promise that resolves when the pause and fade are complete
+ * @example
+ * ```typescript
+ * await pauseWithFade(FadeType.Gentle, 0); // Pause with gentle fade out over 800ms
+ * await pauseWithFade(FadeType.Dramatic, 1, 1500); // Pause with dramatic fade out over 1.5s
+ * await pauseWithFade(FadeType.Linear, 2, 500); // Linear pause with custom 500ms fade
+ * ```
+ */
+export declare const pauseWithFade: (fadeType?: FadeType, channelNumber?: number, duration?: number) => Promise<void>;
+/**
+ * Resumes the currently paused audio in a specific channel with smooth volume fade
+ * Uses the complementary fade curve automatically based on the pause fade type, or allows override
+ * @param fadeType - Optional fade type to override the stored fade type from pause
+ * @param channelNumber - The channel number to resume (defaults to 0)
+ * @param duration - Optional custom fade duration in milliseconds (uses stored or fadeType default if not provided)
+ * @returns Promise that resolves when the resume and fade are complete
+ * @example
+ * ```typescript
+ * await resumeWithFade(); // Resume with automatically paired fade curve from pause
+ * await resumeWithFade(FadeType.Dramatic, 0); // Override with dramatic fade
+ * await resumeWithFade(FadeType.Linear, 0, 1000); // Override with linear fade over 1 second
+ * ```
+ */
+export declare const resumeWithFade: (fadeType?: FadeType, channelNumber?: number, duration?: number) => Promise<void>;
+/**
+ * Toggles pause/resume state for a specific channel with integrated fade
+ * @param fadeType - Type of fade transition to apply when pausing
+ * @param channelNumber - The channel number to toggle (defaults to 0)
+ * @param duration - Optional custom fade duration in milliseconds (uses fadeType default if not provided)
+ * @returns Promise that resolves when the toggle and fade are complete
+ * @example
+ * ```typescript
+ * await togglePauseWithFade(FadeType.Gentle, 0); // Toggle with gentle fade
+ * await togglePauseWithFade(FadeType.Dramatic, 0, 500); // Toggle with custom 500ms fade
+ * ```
+ */
+export declare const togglePauseWithFade: (fadeType?: FadeType, channelNumber?: number, duration?: number) => Promise<void>;
+/**
+ * Pauses all currently playing audio across all channels with smooth volume fade
+ * @param fadeType - Type of fade transition to apply to all channels
+ * @param duration - Optional custom fade duration in milliseconds (uses fadeType default if not provided)
+ * @returns Promise that resolves when all channels are paused and faded
+ * @example
+ * ```typescript
+ * await pauseAllWithFade(FadeType.Dramatic); // Pause everything with dramatic fade
+ * await pauseAllWithFade(FadeType.Gentle, 1200); // Pause all channels with custom 1.2s fade
+ * ```
+ */
+export declare const pauseAllWithFade: (fadeType?: FadeType, duration?: number) => Promise<void>;
+/**
+ * Resumes all currently paused audio across all channels with smooth volume fade
+ * Uses automatically paired fade curves based on each channel's pause fade type, or allows override
+ * @param fadeType - Optional fade type to override stored fade types for all channels
+ * @param duration - Optional custom fade duration in milliseconds (uses stored or fadeType default if not provided)
+ * @returns Promise that resolves when all channels are resumed and faded
+ * @example
+ * ```typescript
+ * await resumeAllWithFade(); // Resume everything with paired fade curves
+ * await resumeAllWithFade(FadeType.Gentle, 800); // Override all channels with gentle fade over 800ms
+ * await resumeAllWithFade(undefined, 600); // Use stored fade types with custom 600ms duration
+ * ```
+ */
+export declare const resumeAllWithFade: (fadeType?: FadeType, duration?: number) => Promise<void>;
+/**
+ * Toggles pause/resume state for all channels with integrated fade
+ * If any channels are playing, all will be paused with fade
+ * If all channels are paused, all will be resumed with fade
+ * @param fadeType - Type of fade transition to apply when pausing
+ * @param duration - Optional custom fade duration in milliseconds (uses fadeType default if not provided)
+ * @returns Promise that resolves when all toggles and fades are complete
+ * @example
+ * ```typescript
+ * await togglePauseAllWithFade(FadeType.Gentle); // Global toggle with gentle fade
+ * await togglePauseAllWithFade(FadeType.Dramatic, 600); // Global toggle with custom 600ms fade
+ * ```
+ */
+export declare const togglePauseAllWithFade: (fadeType?: FadeType, duration?: number) => Promise<void>;
 /**
  * Pauses the currently playing audio in a specific channel
  * @param channelNumber - The channel number to pause (defaults to 0)