audio-channel-queue 1.7.0 → 1.9.0

package/src/events.ts

@@ -2,13 +2,14 @@
  * @fileoverview Event handling and emission for the audio-channel-queue package
  */
 
-import { 
-  AudioStartInfo, 
-  AudioCompleteInfo, 
+import {
+  AudioStartInfo,
+  AudioCompleteInfo,
   ExtendedAudioQueueChannel,
   QueueSnapshot,
   ProgressCallback,
   AudioInfo,
+  GLOBAL_PROGRESS_KEY
 } from './types';
 import { createQueueSnapshot, getAudioInfoFromElement } from './utils';
 
@@ -22,19 +23,20 @@ import { createQueueSnapshot, getAudioInfoFromElement } from './utils';
  * ```
  */
 export const emitQueueChange = (
-  channelNumber: number, 
+  channelNumber: number,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.queueChangeCallbacks) return;
+  if (!channel?.queueChangeCallbacks) return;
 
   const snapshot: QueueSnapshot | null = 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);
     }
   });
@@ -51,17 +53,18 @@ export const emitQueueChange = (
  * ```
  */
 export const emitAudioStart = (
-  channelNumber: number, 
+  channelNumber: number,
   audioInfo: AudioStartInfo,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioStartCallbacks) return;
+  if (!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);
     }
   });
@@ -78,17 +81,18 @@ export const emitAudioStart = (
  * ```
  */
 export const emitAudioComplete = (
-  channelNumber: number, 
+  channelNumber: number,
   audioInfo: AudioCompleteInfo,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioCompleteCallbacks) return;
+  if (!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);
     }
   });
@@ -105,17 +109,18 @@ export const emitAudioComplete = (
  * ```
  */
 export const emitAudioPause = (
-  channelNumber: number, 
+  channelNumber: number,
   audioInfo: AudioInfo,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioPauseCallbacks) return;
+  if (!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);
     }
   });
@@ -132,24 +137,25 @@ export const emitAudioPause = (
  * ```
  */
 export const emitAudioResume = (
-  channelNumber: number, 
+  channelNumber: number,
   audioInfo: AudioInfo,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioResumeCallbacks) return;
+  if (!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);
     }
   });
 };
 
 // Store listener functions for cleanup
-const progressListeners = new WeakMap<HTMLAudioElement, () => void>();
+const progressListeners: WeakMap<HTMLAudioElement, () => void> = new WeakMap();
 
 /**
  * Sets up comprehensive progress tracking for an audio element
@@ -163,7 +169,7 @@ const progressListeners = new WeakMap<HTMLAudioElement, () => void>();
  * ```
  */
 export const setupProgressTracking = (
-  audio: HTMLAudioElement, 
+  audio: HTMLAudioElement,
   channelNumber: number,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
@@ -179,12 +185,14 @@ export const setupProgressTracking = (
 
   const updateProgress = (): void => {
     // Get callbacks for this specific audio element AND the channel-wide callbacks
-    const audioCallbacks: Set<ProgressCallback> = channel.progressCallbacks?.get(audio) || new Set();
-    const channelCallbacks: Set<ProgressCallback> = channel.progressCallbacks?.get(null as any) || new Set();
-    
+    const audioCallbacks: Set<ProgressCallback> =
+      channel.progressCallbacks?.get(audio) ?? new Set();
+    const channelCallbacks: Set<ProgressCallback> =
+      channel.progressCallbacks?.get(GLOBAL_PROGRESS_KEY) ?? new Set();
+
     // Combine both sets of callbacks
     const allCallbacks: Set<ProgressCallback> = new Set([...audioCallbacks, ...channelCallbacks]);
-    
+
     if (allCallbacks.size === 0) return;
 
     const info: AudioInfo | null = getAudioInfoFromElement(audio, channelNumber, audioChannels);
@@ -193,6 +201,7 @@ export const setupProgressTracking = (
         try {
           callback(info);
         } catch (error) {
+          // eslint-disable-next-line no-console
           console.error('Error in progress callback:', error);
         }
       });
@@ -221,12 +230,12 @@ export const setupProgressTracking = (
  * ```
  */
 export const cleanupProgressTracking = (
-  audio: HTMLAudioElement, 
+  audio: HTMLAudioElement,
   channelNumber: number,
   audioChannels: ExtendedAudioQueueChannel[]
 ): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.progressCallbacks) return;
+  if (!channel?.progressCallbacks) return;
 
   // Remove event listeners
   const updateProgress: (() => void) | undefined = progressListeners.get(audio);
@@ -240,4 +249,4 @@ export const cleanupProgressTracking = (
   }
 
   channel.progressCallbacks.delete(audio);
-}; 
+};

package/src/index.ts

@@ -5,56 +5,72 @@
  */
 
 // Core queue management functions
-export { queueAudio, queueAudioPriority, stopCurrentAudioInChannel, stopAllAudioInChannel, stopAllAudio, playAudioQueue } from './core';
+export {
+  queueAudio,
+  queueAudioPriority,
+  stopCurrentAudioInChannel,
+  stopAllAudioInChannel,
+  stopAllAudio,
+  playAudioQueue
+} from './core';
 
 // Error handling and recovery functions
-export { 
-  getErrorRecovery, 
-  getRetryConfig, 
-  offAudioError, 
-  onAudioError, 
+export {
+  getErrorRecovery,
+  getRetryConfig,
+  offAudioError,
+  onAudioError,
   retryFailedAudio,
-  setErrorRecovery, 
-  setRetryConfig, 
+  setErrorRecovery,
+  setRetryConfig
 } from './errors';
 
 // Pause and resume management functions
-export { 
-  getAllChannelsPauseState, 
-  isChannelPaused, 
-  pauseAllChannels, 
-  pauseChannel, 
-  resumeAllChannels, 
-  resumeChannel, 
+export {
+  getAllChannelsPauseState,
+  isChannelPaused,
+  pauseAllChannels,
+  pauseAllWithFade,
+  pauseChannel,
+  pauseWithFade,
+  resumeAllChannels,
+  resumeAllWithFade,
+  resumeChannel,
+  resumeWithFade,
   togglePauseAllChannels,
-  togglePauseChannel, 
+  togglePauseAllWithFade,
+  togglePauseChannel,
+  togglePauseWithFade
 } from './pause';
 
 // Volume control and ducking functions
-export { 
+export {
   clearVolumeDucking,
-  getAllChannelsVolume, 
-  getChannelVolume, 
-  setAllChannelsVolume, 
-  setChannelVolume, 
-  setVolumeDucking, 
+  fadeVolume,
+  getAllChannelsVolume,
+  getChannelVolume,
+  getFadeConfig,
+  setAllChannelsVolume,
+  setChannelVolume,
+  setVolumeDucking,
+  transitionVolume
 } from './volume';
 
 // Audio information and progress tracking functions
-export { 
-  getAllChannelsInfo, 
-  getCurrentAudioInfo, 
-  getQueueSnapshot, 
-  offAudioPause, 
-  offAudioProgress, 
+export {
+  getAllChannelsInfo,
+  getCurrentAudioInfo,
+  getQueueSnapshot,
+  offAudioPause,
+  offAudioProgress,
   offAudioResume,
-  offQueueChange, 
-  onAudioComplete, 
-  onAudioPause, 
-  onAudioProgress, 
-  onAudioResume, 
-  onAudioStart, 
-  onQueueChange, 
+  offQueueChange,
+  onAudioComplete,
+  onAudioPause,
+  onAudioProgress,
+  onAudioResume,
+  onAudioStart,
+  onQueueChange
 } from './info';
 
 // Core data access for legacy compatibility
@@ -69,23 +85,28 @@ export {
 } from './utils';
 
 // TypeScript type definitions and interfaces
-export type { 
+export type {
   AudioCompleteCallback,
   AudioCompleteInfo,
   AudioErrorCallback,
   AudioErrorInfo,
-  AudioInfo, 
+  AudioInfo,
   AudioPauseCallback,
   AudioQueueOptions,
   AudioResumeCallback,
   AudioStartCallback,
   AudioStartInfo,
+  ChannelFadeState,
   ErrorRecoveryOptions,
   ExtendedAudioQueueChannel,
+  FadeConfig,
   ProgressCallback,
   QueueChangeCallback,
   QueueItem,
   QueueSnapshot,
   RetryConfig,
-  VolumeConfig 
-} from './types'; 
+  VolumeConfig
+} from './types';
+
+// Enums and constants
+export { EasingType, FadeType, GLOBAL_PROGRESS_KEY } from './types';

package/src/info.ts

@@ -2,16 +2,17 @@
  * @fileoverview Audio information and progress tracking functions for the audio-channel-queue package
  */
 
-import { 
-  AudioInfo, 
-  QueueSnapshot, 
+import {
+  AudioInfo,
+  QueueSnapshot,
   ProgressCallback,
   QueueChangeCallback,
   AudioStartCallback,
   AudioCompleteCallback,
   AudioPauseCallback,
   AudioResumeCallback,
-  ExtendedAudioQueueChannel
+  ExtendedAudioQueueChannel,
+  GLOBAL_PROGRESS_KEY
 } from './types';
 import { getAudioInfoFromElement, createQueueSnapshot } from './utils';
 import { setupProgressTracking, cleanupProgressTracking } from './events';
@@ -60,11 +61,11 @@ export const getCurrentAudioInfo = (channelNumber: number = 0): AudioInfo | null
  */
 export const getAllChannelsInfo = (): (AudioInfo | null)[] => {
   const allChannelsInfo: (AudioInfo | null)[] = [];
-  
-  for (let i = 0; i < audioChannels.length; i++) {
+
+  for (let i: number = 0; i < audioChannels.length; i++) {
     allChannelsInfo.push(getCurrentAudioInfo(i));
   }
-  
+
   return allChannelsInfo;
 };
 
@@ -99,7 +100,7 @@ export const getQueueSnapshot = (channelNumber: number): QueueSnapshot | null =>
  */
 export const onAudioProgress = (channelNumber: number, callback: ProgressCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -125,16 +126,16 @@ export const onAudioProgress = (channelNumber: number, callback: ProgressCallbac
       channel.progressCallbacks.set(currentAudio, new Set());
     }
     channel.progressCallbacks.get(currentAudio)!.add(callback);
-    
+
     // Set up tracking if not already done
     setupProgressTracking(currentAudio, channelNumber, audioChannels);
   }
 
   // Store callback for future audio elements in this channel
-  if (!channel.progressCallbacks.has(null as any)) {
-    channel.progressCallbacks.set(null as any, new Set());
+  if (!channel.progressCallbacks.has(GLOBAL_PROGRESS_KEY)) {
+    channel.progressCallbacks.set(GLOBAL_PROGRESS_KEY, new Set());
   }
-  channel.progressCallbacks.get(null as any)!.add(callback);
+  channel.progressCallbacks.get(GLOBAL_PROGRESS_KEY)!.add(callback);
 };
 
 /**
@@ -147,7 +148,7 @@ export const onAudioProgress = (channelNumber: number, callback: ProgressCallbac
  */
 export const offAudioProgress = (channelNumber: number): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.progressCallbacks) return;
+  if (!channel?.progressCallbacks) return;
 
   // Clean up event listeners for current audio if exists
   if (channel.queue.length > 0) {
@@ -173,7 +174,7 @@ export const offAudioProgress = (channelNumber: number): void => {
  */
 export const onQueueChange = (channelNumber: number, callback: QueueChangeCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -205,7 +206,7 @@ export const onQueueChange = (channelNumber: number, callback: QueueChangeCallba
  */
 export const offQueueChange = (channelNumber: number): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.queueChangeCallbacks) return;
+  if (!channel?.queueChangeCallbacks) return;
 
   channel.queueChangeCallbacks.clear();
 };
@@ -224,7 +225,7 @@ export const offQueueChange = (channelNumber: number): void => {
  */
 export const onAudioStart = (channelNumber: number, callback: AudioStartCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -262,7 +263,7 @@ export const onAudioStart = (channelNumber: number, callback: AudioStartCallback
  */
 export const onAudioComplete = (channelNumber: number, callback: AudioCompleteCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -298,7 +299,7 @@ export const onAudioComplete = (channelNumber: number, callback: AudioCompleteCa
  */
 export const onAudioPause = (channelNumber: number, callback: AudioPauseCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -334,7 +335,7 @@ export const onAudioPause = (channelNumber: number, callback: AudioPauseCallback
  */
 export const onAudioResume = (channelNumber: number, callback: AudioResumeCallback): void => {
   if (!audioChannels[channelNumber]) {
-    audioChannels[channelNumber] = { 
+    audioChannels[channelNumber] = {
       audioCompleteCallbacks: new Set(),
       audioErrorCallbacks: new Set(),
       audioPauseCallbacks: new Set(),
@@ -366,7 +367,7 @@ export const onAudioResume = (channelNumber: number, callback: AudioResumeCallba
  */
 export const offAudioPause = (channelNumber: number): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioPauseCallbacks) return;
+  if (!channel?.audioPauseCallbacks) return;
 
   channel.audioPauseCallbacks.clear();
 };
@@ -381,7 +382,7 @@ export const offAudioPause = (channelNumber: number): void => {
  */
 export const offAudioResume = (channelNumber: number): void => {
   const channel: ExtendedAudioQueueChannel = audioChannels[channelNumber];
-  if (!channel || !channel.audioResumeCallbacks) return;
+  if (!channel?.audioResumeCallbacks) return;
 
   channel.audioResumeCallbacks.clear();
-}; 
+};