audio-channel-queue 1.12.0 → 1.13.2

package/README.md

@@ -1,3 +1,15 @@
+# ⚠️ DEPRECATED - This package has been renamed
+
+This package is deprecated and will no longer receive updates.
+
+**Please use [`AudioQ`](https://www.npmjs.com/package/audioq) instead:**
+
+\`\`\`bash
+npm install audioq
+\`\`\`
+
+All future development will happen in the new package.
+
 # Audio Channel Queue
 The purpose of this package is to help manage the playback of audio files. 
 
@@ -5,20 +17,20 @@ The purpose of this package is to help manage the playback of audio files.
 
 📚 [Docs](https://tonycarpenter21.github.io/audio-queue-docs/)
 
-## 🌟 Key Features
+## Key Features
 
-- ✅ **Multi-channel queue management** - Independent audio queues for concurrent playback
-- ✅ **Pause/Resume functionality** - Full playback control for individual channels or all channels
-- ✅ **Volume control with ducking** - Dynamic volume management and automatic background audio reduction
-- ✅ **Loop support** - Seamless audio looping for background music and ambient sounds
-- ✅ **Priority queueing** - Add urgent audio to the front of any queue
-- ✅ **Real-time progress tracking** - Comprehensive playback monitoring and metadata
-- ✅ **Event-driven architecture** - Extensive callback system for UI integration
-- ✅ **TypeScript support** - Full type definitions and IntelliSense support
-- ✅ **Zero dependencies** - Lightweight and self-contained
-- ✅ **Backward compatible** - All existing APIs continue to work
+- **Multi-channel queue management** - Independent audio queues for concurrent playback
+- **Pause/Resume functionality** - Full playback control for individual channels or all channels
+- **Volume control with ducking** - Dynamic volume management, global volume control, and automatic background audio reduction
+- **Loop support** - Seamless audio looping for background music and ambient sounds
+- **Priority queueing** - Add urgent audio to the front of any queue
+- **Real-time progress tracking** - Comprehensive playback monitoring and metadata
+- **Event-driven architecture** - Extensive callback system for UI integration
+- **TypeScript support** - Full type definitions and IntelliSense support
+- **Zero dependencies** - Lightweight and self-contained
+- **Backward compatible** - All existing APIs continue to work
 
-This package offers TypeScript support 📘, boasts zero dependencies 🚫, and is released under the MIT license 📜. As an added bonus, it's NON-GMO 🌱 and 100% Free Range Organic 🐓.
+This package offers TypeScript support, has zero dependencies, and is released under the MIT license.
 
 To preview this package and see how it works with visualized code examples, check out the demo that can be found here: [Audio Channel Queue Demo](https://tonycarpenter21.github.io/audio-queue-demo/). (A link to the demo repo can be found here: [Audio Channel Queue Demo Repo](https://github.com/tonycarpenter21/audio-queue-demo).)
 
@@ -32,18 +44,18 @@ Documentation can be found [here](https://tonycarpenter21.github.io/audio-queue-
 
 This package is designed for **browser environments** and uses the Web Audio API (`HTMLAudioElement`). It is **not** intended for Node.js server-side use.
 
-### ✅ **Supported Browsers:**
+### **Supported Browsers:**
 - **Chrome 51+** (June 2016)
 - **Firefox 54+** (June 2017)  
 - **Safari 10+** (September 2016)
 - **Edge 15+** (April 2017)
 - **Mobile browsers** with HTML5 audio support
 
-### 🛠️ **Development Requirements:**
+### **Development Requirements:**
 - **Node.js 14+** (for building and testing only)
 - **TypeScript 4.5+** (included in devDependencies)
 
-### ⚠️ **Not Supported:**
+### **Not Supported:**
 - Node.js server environments (no HTMLAudioElement)
 - Internet Explorer (lacks ES6 support)
 - Web Workers (no DOM access)
@@ -197,6 +209,47 @@ await setAllChannelsVolume(0.6); // Set all channels to 60% volume
 await setAllChannelsVolume(0.0); // Mute all channels
 ```
 
+### Global Volume Control
+```typescript
+// Set a global volume multiplier that affects all channels while preserving their relative levels.
+setGlobalVolume(volume);
+await setGlobalVolume(0.5); // Set global volume to 50%
+```
+
+```typescript
+// Get the current global volume level.
+getGlobalVolume();
+const globalVol = getGlobalVolume(); // Returns current global volume (0-1)
+console.log(`Global volume: ${(getGlobalVolume() * 100).toFixed(0)}%`);
+```
+
+**How Global Volume Works:**
+The global volume acts as a **global volume multiplier** - it scales all channel volumes proportionally while preserving their individual settings. This is perfect for implementing a global volume slider in your UI.
+
+```typescript
+// Example: Setting up different audio types with a global volume control
+await setChannelVolume(0, 0.3); // SFX channel at 30%
+await setChannelVolume(1, 0.7); // Music channel at 70%
+await setChannelVolume(2, 0.5); // Voice channel at 50%
+
+// User adjusts global volume slider to 50%
+await setGlobalVolume(0.5);
+
+// Actual playback volumes become:
+// - SFX: 30% × 50% = 15%
+// - Music: 70% × 50% = 35%
+// - Voice: 50% × 50% = 25%
+
+// Channel volumes remain at their original settings (0.3, 0.7, 0.5)
+// So when global volume is increased, ratios are preserved
+await setGlobalVolume(1.0); // Back to full volume
+// - SFX: 30% × 100% = 30%
+// - Music: 70% × 100% = 70%
+// - Voice: 50% × 100% = 50%
+```
+
+**Note:** `setAllChannelsVolume()` sets all channels to the **same** volume, while `setGlobalVolume()` **multiplies** all channels by the same amount, preserving their relative differences.
+
 ### Volume Ducking (Background Audio Reduction)
 ```typescript
 // Automatically reduce other channels' volume when priority audio plays.

package/dist/core.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Core queue management functions for the audio-channel-queue package
+ * @fileoverview Core queue management functions for the audioq package
  */
 import { AudioQueueOptions, QueueConfig } from './types';
 /**

package/dist/core.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Core queue management functions for the audio-channel-queue package
+ * @fileoverview Core queue management functions for the audioq package
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -183,7 +183,7 @@ const checkQueueLimit = (channel, channelNumber, maxQueueSize) => {
             (0, events_1.cleanupProgressTracking)(removedAudio, channelNumber, info_1.audioChannels);
             if (globalQueueConfig.showQueueWarnings) {
                 // eslint-disable-next-line no-console
-                console.info(`Dropped oldest queued item to make room for new audio`);
+                console.warn(`Dropped oldest queued item to make room for new audio`);
             }
             return true;
         }
@@ -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') {
@@ -316,9 +318,10 @@ const playAudioQueue = (channelNumber) => __awaiter(void 0, void 0, void 0, func
     if (!channel || channel.queue.length === 0)
         return;
     const currentAudio = channel.queue[0];
-    // Apply channel volume if not already set
+    // Apply channel volume with global volume multiplier if not already set
     if (currentAudio.volume === 1.0 && channel.volume !== undefined) {
-        currentAudio.volume = channel.volume;
+        const globalVolume = (0, volume_1.getGlobalVolume)();
+        currentAudio.volume = channel.volume * globalVolume;
     }
     (0, events_1.setupProgressTracking)(currentAudio, channelNumber, info_1.audioChannels);
     // Apply volume ducking when audio starts
@@ -378,6 +381,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,5 +1,5 @@
 /**
- * @fileoverview Error handling, retry logic, and recovery mechanisms for the audio-channel-queue package
+ * @fileoverview Error handling, retry logic, and recovery mechanisms for the audioq package
  */
 import { AudioErrorInfo, AudioErrorCallback, AudioErrorType, RetryConfig, ErrorRecoveryOptions, ExtendedAudioQueueChannel } from './types';
 /**

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Error handling, retry logic, and recovery mechanisms for the audio-channel-queue package
+ * @fileoverview Error handling, retry logic, and recovery mechanisms for the audioq package
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -56,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)
@@ -241,7 +240,7 @@ const emitAudioError = (channelNumber, errorInfo, audioChannels) => {
     // Log to analytics if enabled
     if (globalErrorRecovery.logErrorsToAnalytics) {
         // eslint-disable-next-line no-console
-        console.warn('Audio Error Analytics:', errorInfo);
+        console.error('Audio Error Analytics:', errorInfo);
     }
     channel.audioErrorCallbacks.forEach((callback) => {
         try {
@@ -306,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);
     };
@@ -352,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);
@@ -451,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/events.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Event handling and emission for the audio-channel-queue package
+ * @fileoverview Event handling and emission for the audioq package
  */
 import { AudioStartInfo, AudioCompleteInfo, ExtendedAudioQueueChannel, AudioInfo } from './types';
 /**

package/dist/events.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Event handling and emission for the audio-channel-queue package
+ * @fileoverview Event handling and emission for the audioq package
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cleanupProgressTracking = exports.setupProgressTracking = exports.emitAudioResume = exports.emitAudioPause = exports.emitAudioComplete = exports.emitAudioStart = exports.emitQueueChange = void 0;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Main entry point for the audio-channel-queue package
+ * @fileoverview Main entry point for the audioq package
  * Exports all public functions and types for audio queue management, pause/resume controls,
  * volume management with ducking, progress tracking, and comprehensive event system
  */
@@ -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 { cancelAllVolumeTransitions, cancelVolumeTransition, clearVolumeDucking, getAllChannelsVolume, getChannelVolume, getFadeConfig, setAllChannelsVolume, setChannelVolume, setVolumeDucking, transitionVolume } from './volume';
+export { cancelAllVolumeTransitions, cancelVolumeTransition, clearVolumeDucking, getAllChannelsVolume, getChannelVolume, getFadeConfig, getGlobalVolume, setAllChannelsVolume, setChannelVolume, setGlobalVolume, 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 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

@@ -1,12 +1,12 @@
 "use strict";
 /**
- * @fileoverview Main entry point for the audio-channel-queue package
+ * @fileoverview Main entry point for the audioq package
  * Exports all public functions and types for audio queue management, pause/resume controls,
  * volume management with ducking, progress tracking, and comprehensive event system
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.transitionVolume = exports.setVolumeDucking = exports.setGlobalVolume = exports.setChannelVolume = exports.setAllChannelsVolume = exports.getGlobalVolume = 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 = exports.createWebAudioNodes = exports.cleanupWebAudioNodes = void 0;
 // Core queue management functions
 var core_1 = require("./core");
 Object.defineProperty(exports, "queueAudio", { enumerable: true, get: function () { return core_1.queueAudio; } });
@@ -61,10 +61,26 @@ Object.defineProperty(exports, "clearVolumeDucking", { enumerable: true, get: fu
 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, "getGlobalVolume", { enumerable: true, get: function () { return volume_1.getGlobalVolume; } });
 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, "setGlobalVolume", { enumerable: true, get: function () { return volume_1.setGlobalVolume; } });
 Object.defineProperty(exports, "setVolumeDucking", { enumerable: true, get: function () { return volume_1.setVolumeDucking; } });
 Object.defineProperty(exports, "transitionVolume", { enumerable: true, get: function () { return volume_1.transitionVolume; } });
+// 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; } });

package/dist/info.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Audio information and progress tracking functions for the audio-channel-queue package
+ * @fileoverview Audio information and progress tracking functions for the audioq package
  */
 import { AudioInfo, QueueSnapshot, ProgressCallback, QueueChangeCallback, AudioStartCallback, AudioCompleteCallback, AudioPauseCallback, AudioResumeCallback, ExtendedAudioQueueChannel } from './types';
 /**

package/dist/info.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Audio information and progress tracking functions for the audio-channel-queue package
+ * @fileoverview Audio information and progress tracking functions for the audioq package
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.offAudioComplete = exports.offAudioStart = exports.offAudioResume = exports.offAudioPause = exports.onAudioResume = exports.onAudioPause = exports.onAudioComplete = exports.onAudioStart = exports.offQueueChange = exports.onQueueChange = exports.onAudioProgress = exports.getQueueSnapshot = exports.getAllChannelsInfo = exports.getCurrentAudioInfo = exports.audioChannels = exports.getNonWhitelistedChannelProperties = exports.getWhitelistedChannelProperties = void 0;
@@ -36,7 +36,9 @@ const getWhitelistedChannelProperties = () => {
         'isLocked',
         'maxQueueSize',
         'retryConfig',
-        'volumeConfig' // Legacy property that might still be used
+        'volumeConfig', // Legacy property that might still be used
+        'webAudioContext', // Web Audio API context
+        'webAudioNodes' // Web Audio API nodes map
     ];
     return [...new Set(propertyNames)]; // Remove duplicates
 };

package/dist/pause.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Pause and resume management functions for the audio-channel-queue package
+ * @fileoverview Pause and resume management functions for the audioq package
  */
 import { FadeType } from './types';
 /**

package/dist/pause.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Pause and resume management functions for the audio-channel-queue package
+ * @fileoverview Pause and resume management functions for the audioq package
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -18,6 +18,7 @@ const info_1 = require("./info");
 const utils_1 = require("./utils");
 const events_1 = require("./events");
 const volume_1 = require("./volume");
+const web_audio_1 = require("./web-audio");
 /**
  * Gets the current volume for a channel, accounting for synchronous state
  * @param channelNumber - The channel number
@@ -38,7 +39,15 @@ const setChannelVolumeSync = (channelNumber, volume) => {
     if (channel) {
         channel.volume = volume;
         if (channel.queue.length > 0) {
-            channel.queue[0].volume = volume;
+            const audio = channel.queue[0];
+            if (channel.webAudioNodes) {
+                const nodes = channel.webAudioNodes.get(audio);
+                if (nodes) {
+                    // Update the gain node when Web Audio is active
+                    (0, web_audio_1.setWebAudioVolume)(nodes.gainNode, volume);
+                }
+            }
+            audio.volume = volume;
         }
     }
 };
@@ -58,12 +67,14 @@ const setChannelVolumeSync = (channelNumber, volume) => {
 const pauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, channelNumber = 0, duration) {
     var _a, _b, _c;
     const channel = info_1.audioChannels[channelNumber];
-    if (!channel || channel.queue.length === 0)
+    if (!channel || channel.queue.length === 0) {
         return;
+    }
     const currentAudio = channel.queue[0];
     // Don't pause if already paused or ended
-    if (currentAudio.paused || currentAudio.ended)
+    if (currentAudio.paused || currentAudio.ended) {
         return;
+    }
     const config = (0, volume_1.getFadeConfig)(fadeType);
     const effectiveDuration = duration !== null && duration !== void 0 ? duration : config.duration;
     // Race condition fix: Use existing fadeState originalVolume if already transitioning,
@@ -100,9 +111,11 @@ const pauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, func
     }
     // Fade to 0 with pause curve, then pause
     yield (0, volume_1.transitionVolume)(channelNumber, 0, effectiveDuration, config.pauseCurve);
+    // Pause the audio
     yield (0, exports.pauseChannel)(channelNumber);
-    // Reset volume to original for resume (synchronously to avoid state issues)
-    setChannelVolumeSync(channelNumber, originalVolume);
+    // Restore channel.volume for resume, but DON'T restore gain node to prevent blip
+    // The gain node will be restored during the resume fade
+    channel.volume = originalVolume;
     // Mark transition as complete
     if (channel.fadeState) {
         channel.fadeState.isTransitioning = false;
@@ -125,8 +138,10 @@ exports.pauseWithFade = pauseWithFade;
  */
 const resumeWithFade = (fadeType_1, ...args_1) => __awaiter(void 0, [fadeType_1, ...args_1], void 0, function* (fadeType, channelNumber = 0, duration) {
     const channel = info_1.audioChannels[channelNumber];
-    if (!channel || channel.queue.length === 0)
+    if (!channel || channel.queue.length === 0) {
         return;
+    }
+    const audio = channel.queue[0];
     const fadeState = channel.fadeState;
     if (!(fadeState === null || fadeState === void 0 ? void 0 : fadeState.isPaused)) {
         // Fall back to regular resume if no fade state
@@ -160,8 +175,19 @@ const resumeWithFade = (fadeType_1, ...args_1) => __awaiter(void 0, [fadeType_1,
     const targetVolume = fadeState.originalVolume > 0 ? fadeState.originalVolume : 1.0;
     // Mark as transitioning to prevent volume capture during rapid toggles
     fadeState.isTransitioning = true;
-    // Set volume to 0, resume, then fade to original with resume curve
-    setChannelVolumeSync(channelNumber, 0);
+    // Ensure gain node is at 0 before resuming (should already be from pause)
+    // Don't touch audio.volume when Web Audio is active - iOS may reset it
+    // Don't touch channel.volume - it should stay at originalVolume
+    if (channel.webAudioNodes) {
+        const nodes = channel.webAudioNodes.get(audio);
+        if (nodes) {
+            (0, web_audio_1.setWebAudioVolume)(nodes.gainNode, 0);
+        }
+    }
+    else {
+        // Fallback for non-Web Audio: set audio.volume directly
+        audio.volume = 0;
+    }
     yield (0, exports.resumeChannel)(channelNumber);
     // Use the stored original volume, not current volume, to prevent race conditions
     yield (0, volume_1.transitionVolume)(channelNumber, targetVolume, effectiveDuration, config.resumeCurve);

package/dist/queue-manipulation.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Queue manipulation functions for the audio-channel-queue package
+ * @fileoverview Queue manipulation functions for the audioq package
  * Provides advanced queue management including item removal, reordering, and clearing
  */
 import { QueueManipulationResult, QueueItem } from './types';

package/dist/queue-manipulation.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Queue manipulation functions for the audio-channel-queue package
+ * @fileoverview Queue manipulation functions for the audioq package
  * Provides advanced queue management including item removal, reordering, and clearing
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Type definitions for the audio-channel-queue package
+ * @fileoverview Type definitions for the audioq package
  */
 /**
  * Maximum number of audio channels allowed to prevent memory exhaustion
@@ -260,6 +260,39 @@ export interface ErrorRecoveryOptions {
  * Callback function type for audio error events
  */
 export type AudioErrorCallback = (errorInfo: AudioErrorInfo) => void;
+/**
+ * Web Audio API configuration options
+ */
+export interface WebAudioConfig {
+    /** Whether to automatically use Web Audio API on iOS devices */
+    autoDetectIOS: boolean;
+    /** Whether Web Audio API support is enabled */
+    enabled: boolean;
+    /** Whether to force Web Audio API usage on all devices */
+    forceWebAudio: boolean;
+}
+/**
+ * Web Audio API support information
+ */
+export interface WebAudioSupport {
+    /** Whether Web Audio API is available in the current environment */
+    available: boolean;
+    /** Whether the current device is iOS */
+    isIOS: boolean;
+    /** Whether Web Audio API is currently being used */
+    usingWebAudio: boolean;
+    /** Reason for current Web Audio API usage state */
+    reason: string;
+}
+/**
+ * Web Audio API node set for audio element control
+ */
+export interface WebAudioNodeSet {
+    /** Gain node for volume control */
+    gainNode: GainNode;
+    /** Media element source node */
+    sourceNode: MediaElementAudioSourceNode;
+}
 /**
  * Extended audio channel with comprehensive queue management, callback support, and state tracking
  */
@@ -292,6 +325,10 @@ export interface ExtendedAudioQueueChannel {
     retryConfig?: RetryConfig;
     /** Current volume level for the channel (0-1) */
     volume: number;
+    /** Web Audio API context for this channel */
+    webAudioContext?: AudioContext;
+    /** Map of Web Audio API nodes for each audio element */
+    webAudioNodes?: Map<HTMLAudioElement, WebAudioNodeSet>;
 }
 /**
  * Easing function types for smooth volume transitions and animations

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Type definitions for the audio-channel-queue package
+ * @fileoverview Type definitions for the audioq package
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TimerType = exports.FadeType = exports.EasingType = exports.AudioErrorType = exports.GLOBAL_PROGRESS_KEY = exports.MAX_CHANNELS = void 0;

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Utility functions for the audio-channel-queue package
+ * @fileoverview Utility functions for the audioq package
  */
 import { AudioInfo, QueueSnapshot, ExtendedAudioQueueChannel } from './types';
 /**

package/dist/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @fileoverview Utility functions for the audio-channel-queue package
+ * @fileoverview Utility functions for the audioq package
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cleanWebpackFilename = exports.createQueueSnapshot = exports.getAudioInfoFromElement = exports.extractFileName = exports.sanitizeForDisplay = exports.validateAudioUrl = void 0;