audio-channel-queue 1.12.0 → 1.12.1-beta.2

package/README.md

@@ -5,20 +5,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 +32,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 +197,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.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') {
@@ -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.js

@@ -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)
@@ -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/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 { 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

@@ -5,8 +5,8 @@
  * 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/types.d.ts

@@ -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/volume.d.ts

@@ -28,6 +28,7 @@ export declare const getFadeConfig: (fadeType: FadeType) => FadeConfig;
 export declare const transitionVolume: (channelNumber: number, targetVolume: number, duration?: number, easing?: EasingType) => Promise<void>;
 /**
  * Sets the volume for a specific channel with optional smooth transition
+ * Automatically uses Web Audio API on iOS devices for enhanced volume control
  * @param channelNumber - The channel number to set volume for
  * @param volume - Volume level (0-1)
  * @param transitionDuration - Optional transition duration in milliseconds
@@ -73,6 +74,31 @@ export declare const getAllChannelsVolume: () => number[];
  * ```
  */
 export declare const setAllChannelsVolume: (volume: number) => Promise<void>;
+/**
+ * Sets the global volume multiplier that affects all channels
+ * This acts as a global volume control - individual channel volumes are multiplied by this value
+ * @param volume - Global volume level (0-1, will be clamped to this range)
+ * @example
+ * ```typescript
+ * // Set channel-specific volumes
+ * await setChannelVolume(0, 0.8); // SFX at 80%
+ * await setChannelVolume(1, 0.6); // Music at 60%
+ *
+ * // Apply global volume of 50% - all channels play at half their set volume
+ * await setGlobalVolume(0.5); // SFX now plays at 40%, music at 30%
+ * ```
+ */
+export declare const setGlobalVolume: (volume: number) => Promise<void>;
+/**
+ * Gets the current global volume multiplier
+ * @returns Current global volume level (0-1), defaults to 1.0
+ * @example
+ * ```typescript
+ * const globalVol = getGlobalVolume();
+ * console.log(`Global volume is ${globalVol * 100}%`);
+ * ```
+ */
+export declare const getGlobalVolume: () => number;
 /**
  * Configures volume ducking for channels. When the priority channel plays audio,
  * all other channels will be automatically reduced to the ducking volume level
@@ -120,3 +146,17 @@ export declare const cancelVolumeTransition: (channelNumber: number) => void;
  * @internal
  */
 export declare const cancelAllVolumeTransitions: () => void;
+/**
+ * Initializes Web Audio API nodes for a new audio element
+ * @param audio - The audio element to initialize nodes for
+ * @param channelNumber - The channel number this audio belongs to
+ * @internal
+ */
+export declare const initializeWebAudioForAudio: (audio: HTMLAudioElement, channelNumber: number) => Promise<void>;
+/**
+ * Cleans up Web Audio API nodes for an audio element
+ * @param audio - The audio element to clean up nodes for
+ * @param channelNumber - The channel number this audio belongs to
+ * @internal
+ */
+export declare const cleanupWebAudioForAudio: (audio: HTMLAudioElement, channelNumber: number) => void;