audio-channel-queue 1.8.0 → 1.9.0

package/dist/pause.js

@@ -18,22 +18,15 @@ const info_1 = require("./info");
 const utils_1 = require("./utils");
 const events_1 = require("./events");
 const volume_1 = require("./volume");
-/**
- * Predefined fade configurations for different transition types
- */
-const FADE_CONFIGS = {
-    [types_1.FadeType.Linear]: { duration: 800, pauseCurve: types_1.EasingType.Linear, resumeCurve: types_1.EasingType.Linear },
-    [types_1.FadeType.Gentle]: { duration: 800, pauseCurve: types_1.EasingType.EaseOut, resumeCurve: types_1.EasingType.EaseIn },
-    [types_1.FadeType.Dramatic]: { duration: 800, pauseCurve: types_1.EasingType.EaseIn, resumeCurve: types_1.EasingType.EaseOut }
-};
 /**
  * Gets the current volume for a channel, accounting for synchronous state
  * @param channelNumber - The channel number
  * @returns Current volume level (0-1)
  */
 const getChannelVolumeSync = (channelNumber) => {
+    var _a;
     const channel = info_1.audioChannels[channelNumber];
-    return (channel === null || channel === void 0 ? void 0 : channel.volume) || 1.0;
+    return (_a = channel === null || channel === void 0 ? void 0 : channel.volume) !== null && _a !== void 0 ? _a : 1.0;
 };
 /**
  * Sets the channel volume synchronously in internal state
@@ -53,15 +46,17 @@ const setChannelVolumeSync = (channelNumber, volume) => {
  * 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); // Pause with dramatic fade out over 800ms
- * await pauseWithFade(FadeType.Linear, 2); // Linear pause with 800ms fade
+ * 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
  * ```
  */
-const pauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, channelNumber = 0) {
+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)
         return;
@@ -69,24 +64,49 @@ const pauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, func
     // Don't pause if already paused or ended
     if (currentAudio.paused || currentAudio.ended)
         return;
-    const config = FADE_CONFIGS[fadeType];
-    const originalVolume = getChannelVolumeSync(channelNumber);
-    // Store fade state for resumeWithFade to use
+    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,
+    // otherwise capture current volume
+    let originalVolume;
+    if ((_a = channel.fadeState) === null || _a === void 0 ? void 0 : _a.isTransitioning) {
+        // We're already in any kind of transition (pause or resume), preserve original volume
+        originalVolume = channel.fadeState.originalVolume;
+    }
+    else {
+        // First fade or no transition in progress, capture current volume
+        // But ensure we don't capture a volume of 0 during a transition
+        const currentVolume = getChannelVolumeSync(channelNumber);
+        originalVolume = currentVolume > 0 ? currentVolume : (_c = (_b = channel.fadeState) === null || _b === void 0 ? void 0 : _b.originalVolume) !== null && _c !== void 0 ? _c : 1.0;
+    }
+    // Store fade state for resumeWithFade to use (including custom duration)
     channel.fadeState = {
-        originalVolume,
+        customDuration: duration,
         fadeType,
-        isPaused: true
+        isPaused: true,
+        isTransitioning: true,
+        originalVolume
     };
-    if (config.duration === 0) {
+    if (effectiveDuration === 0) {
         // Instant pause
         yield (0, exports.pauseChannel)(channelNumber);
+        // Reset volume to original for resume (synchronously to avoid state issues)
+        setChannelVolumeSync(channelNumber, originalVolume);
+        // Mark transition as complete for instant pause
+        if (channel.fadeState) {
+            channel.fadeState.isTransitioning = false;
+        }
         return;
     }
     // Fade to 0 with pause curve, then pause
-    yield (0, volume_1.transitionVolume)(channelNumber, 0, config.duration, config.pauseCurve);
+    yield (0, volume_1.transitionVolume)(channelNumber, 0, effectiveDuration, config.pauseCurve);
     yield (0, exports.pauseChannel)(channelNumber);
     // Reset volume to original for resume (synchronously to avoid state issues)
     setChannelVolumeSync(channelNumber, originalVolume);
+    // Mark transition as complete
+    if (channel.fadeState) {
+        channel.fadeState.isTransitioning = false;
+    }
 });
 exports.pauseWithFade = pauseWithFade;
 /**
@@ -94,93 +114,122 @@ exports.pauseWithFade = pauseWithFade;
  * 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); // Override with linear fade on default channel
+ * await resumeWithFade(FadeType.Linear, 0, 1000); // Override with linear fade over 1 second
  * ```
  */
-const resumeWithFade = (fadeType_1, ...args_1) => __awaiter(void 0, [fadeType_1, ...args_1], void 0, function* (fadeType, channelNumber = 0) {
+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)
         return;
     const fadeState = channel.fadeState;
-    if (!fadeState || !fadeState.isPaused) {
+    if (!(fadeState === null || fadeState === void 0 ? void 0 : fadeState.isPaused)) {
         // Fall back to regular resume if no fade state
         yield (0, exports.resumeChannel)(channelNumber);
         return;
     }
     // Use provided fadeType or fall back to stored fadeType from pause
-    const effectiveFadeType = fadeType || fadeState.fadeType;
-    const config = FADE_CONFIGS[effectiveFadeType];
-    if (config.duration === 0) {
+    const effectiveFadeType = fadeType !== null && fadeType !== void 0 ? fadeType : fadeState.fadeType;
+    const config = (0, volume_1.getFadeConfig)(effectiveFadeType);
+    // Determine effective duration: custom parameter > stored custom > fadeType default
+    let effectiveDuration;
+    if (duration !== undefined) {
+        effectiveDuration = duration;
+    }
+    else if (fadeState.customDuration !== undefined) {
+        effectiveDuration = fadeState.customDuration;
+    }
+    else {
+        effectiveDuration = config.duration;
+    }
+    if (effectiveDuration === 0) {
         // Instant resume
+        const targetVolume = fadeState.originalVolume > 0 ? fadeState.originalVolume : 1.0;
+        setChannelVolumeSync(channelNumber, targetVolume);
         yield (0, exports.resumeChannel)(channelNumber);
         fadeState.isPaused = false;
+        fadeState.isTransitioning = false;
         return;
     }
+    // Race condition fix: Ensure we have a valid original volume to restore to
+    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);
     yield (0, exports.resumeChannel)(channelNumber);
-    yield (0, volume_1.transitionVolume)(channelNumber, fadeState.originalVolume, config.duration, config.resumeCurve);
+    // Use the stored original volume, not current volume, to prevent race conditions
+    yield (0, volume_1.transitionVolume)(channelNumber, targetVolume, effectiveDuration, config.resumeCurve);
     fadeState.isPaused = false;
+    fadeState.isTransitioning = false;
 });
 exports.resumeWithFade = resumeWithFade;
 /**
  * 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
  * ```
  */
-const togglePauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, channelNumber = 0) {
+const togglePauseWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, channelNumber = 0, duration) {
     const channel = info_1.audioChannels[channelNumber];
     if (!channel || channel.queue.length === 0)
         return;
     const currentAudio = channel.queue[0];
     if (currentAudio.paused) {
-        yield (0, exports.resumeWithFade)(undefined, channelNumber);
+        yield (0, exports.resumeWithFade)(undefined, channelNumber, duration);
     }
     else {
-        yield (0, exports.pauseWithFade)(fadeType, channelNumber);
+        yield (0, exports.pauseWithFade)(fadeType, channelNumber, duration);
     }
 });
 exports.togglePauseWithFade = togglePauseWithFade;
 /**
  * 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('dramatic'); // Pause everything with dramatic fade
+ * await pauseAllWithFade(FadeType.Dramatic); // Pause everything with dramatic fade
+ * await pauseAllWithFade(FadeType.Gentle, 1200); // Pause all channels with custom 1.2s fade
  * ```
  */
-const pauseAllWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle) {
+const pauseAllWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, duration) {
     const pausePromises = [];
     info_1.audioChannels.forEach((_channel, index) => {
-        pausePromises.push((0, exports.pauseWithFade)(fadeType, index));
+        pausePromises.push((0, exports.pauseWithFade)(fadeType, index, duration));
     });
     yield Promise.all(pausePromises);
 });
 exports.pauseAllWithFade = pauseAllWithFade;
 /**
  * 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
+ * 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
  * ```
  */
-const resumeAllWithFade = () => __awaiter(void 0, void 0, void 0, function* () {
+const resumeAllWithFade = (fadeType, duration) => __awaiter(void 0, void 0, void 0, function* () {
     const resumePromises = [];
     info_1.audioChannels.forEach((_channel, index) => {
-        resumePromises.push((0, exports.resumeWithFade)(undefined, index));
+        resumePromises.push((0, exports.resumeWithFade)(fadeType, index, duration));
     });
     yield Promise.all(resumePromises);
 });
@@ -190,13 +239,15 @@ exports.resumeAllWithFade = resumeAllWithFade;
  * 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('gentle'); // Global toggle with gentle fade
+ * await togglePauseAllWithFade(FadeType.Gentle); // Global toggle with gentle fade
+ * await togglePauseAllWithFade(FadeType.Dramatic, 600); // Global toggle with custom 600ms fade
  * ```
  */
-const togglePauseAllWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle) {
+const togglePauseAllWithFade = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (fadeType = types_1.FadeType.Gentle, duration) {
     let hasPlayingChannel = false;
     // Check if any channel is currently playing
     for (let i = 0; i < info_1.audioChannels.length; i++) {
@@ -212,10 +263,10 @@ const togglePauseAllWithFade = (...args_1) => __awaiter(void 0, [...args_1], voi
     // If any channel is playing, pause all with fade
     // If no channels are playing, resume all with fade
     if (hasPlayingChannel) {
-        yield (0, exports.pauseAllWithFade)(fadeType);
+        yield (0, exports.pauseAllWithFade)(fadeType, duration);
     }
     else {
-        yield (0, exports.resumeAllWithFade)();
+        yield (0, exports.resumeAllWithFade)(fadeType, duration);
     }
 });
 exports.togglePauseAllWithFade = togglePauseAllWithFade;
@@ -335,8 +386,9 @@ exports.resumeAllChannels = resumeAllChannels;
  * ```
  */
 const isChannelPaused = (channelNumber = 0) => {
+    var _a;
     const channel = info_1.audioChannels[channelNumber];
-    return (channel === null || channel === void 0 ? void 0 : channel.isPaused) || false;
+    return (_a = channel === null || channel === void 0 ? void 0 : channel.isPaused) !== null && _a !== void 0 ? _a : false;
 };
 exports.isChannelPaused = isChannelPaused;
 /**
@@ -351,7 +403,7 @@ exports.isChannelPaused = isChannelPaused;
  * ```
  */
 const getAllChannelsPauseState = () => {
-    return info_1.audioChannels.map((channel) => (channel === null || channel === void 0 ? void 0 : channel.isPaused) || false);
+    return info_1.audioChannels.map((channel) => { var _a; return (_a = channel === null || channel === void 0 ? void 0 : channel.isPaused) !== null && _a !== void 0 ? _a : false; });
 };
 exports.getAllChannelsPauseState = getAllChannelsPauseState;
 /**

package/dist/types.d.ts

@@ -1,6 +1,11 @@
 /**
  * @fileoverview Type definitions for the audio-channel-queue package
  */
+/**
+ * Symbol used as a key for global (channel-wide) progress callbacks
+ * This avoids the need for `null as any` type assertions
+ */
+export declare const GLOBAL_PROGRESS_KEY: unique symbol;
 /**
  * Array of HTMLAudioElement objects representing an audio queue
  */
@@ -8,9 +13,9 @@ export type AudioQueue = HTMLAudioElement[];
 /**
  * Basic audio queue channel structure
  */
-export type AudioQueueChannel = {
+export interface AudioQueueChannel {
     queue: AudioQueue;
-};
+}
 /**
  * Volume ducking configuration for channels
  */
@@ -208,7 +213,7 @@ export interface ExtendedAudioQueueChannel {
     audioStartCallbacks: Set<AudioStartCallback>;
     fadeState?: ChannelFadeState;
     isPaused?: boolean;
-    progressCallbacks: Map<HTMLAudioElement | null, Set<ProgressCallback>>;
+    progressCallbacks: Map<HTMLAudioElement | typeof GLOBAL_PROGRESS_KEY, Set<ProgressCallback>>;
     queue: HTMLAudioElement[];
     queueChangeCallbacks: Set<QueueChangeCallback>;
     retryConfig?: RetryConfig;
@@ -253,4 +258,8 @@ export interface ChannelFadeState {
     fadeType: FadeType;
     /** Whether the channel is currently paused due to fade */
     isPaused: boolean;
+    /** Custom duration in milliseconds if specified (overrides fade type default) */
+    customDuration?: number;
+    /** Whether the channel is currently transitioning (during any fade operation) to prevent capturing intermediate volumes during rapid pause/resume toggles */
+    isTransitioning?: boolean;
 }

package/dist/types.js

@@ -3,7 +3,12 @@
  * @fileoverview Type definitions for the audio-channel-queue package
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FadeType = exports.EasingType = void 0;
+exports.FadeType = exports.EasingType = exports.GLOBAL_PROGRESS_KEY = void 0;
+/**
+ * Symbol used as a key for global (channel-wide) progress callbacks
+ * This avoids the need for `null as any` type assertions
+ */
+exports.GLOBAL_PROGRESS_KEY = Symbol('global-progress-callbacks');
 /**
  * Easing function types for volume transitions
  */

package/dist/utils.js

@@ -56,7 +56,7 @@ const getAudioInfoFromElement = (audio, channelNumber, audioChannels) => {
     const isPlaying = !audio.paused && !audio.ended && audio.readyState > 2;
     // Calculate remainingInQueue if channel context is provided
     let remainingInQueue = 0;
-    if (channelNumber !== undefined && audioChannels && audioChannels[channelNumber]) {
+    if (channelNumber !== undefined && (audioChannels === null || audioChannels === void 0 ? void 0 : audioChannels[channelNumber])) {
         const channel = audioChannels[channelNumber];
         remainingInQueue = Math.max(0, channel.queue.length - 1); // Exclude current playing audio
     }
@@ -86,6 +86,7 @@ exports.getAudioInfoFromElement = getAudioInfoFromElement;
  * ```
  */
 const createQueueSnapshot = (channelNumber, audioChannels) => {
+    var _a, _b;
     const channel = audioChannels[channelNumber];
     if (!channel)
         return null;
@@ -100,10 +101,10 @@ const createQueueSnapshot = (channelNumber, audioChannels) => {
     return {
         channelNumber,
         currentIndex: 0, // Current playing is always index 0 in our queue structure
-        isPaused: channel.isPaused || false,
+        isPaused: (_a = channel.isPaused) !== null && _a !== void 0 ? _a : false,
         items,
         totalItems: channel.queue.length,
-        volume: channel.volume || 1.0
+        volume: (_b = channel.volume) !== null && _b !== void 0 ? _b : 1.0
     };
 };
 exports.createQueueSnapshot = createQueueSnapshot;

package/dist/volume.js

@@ -20,10 +20,22 @@ const activeTransitions = new Map();
 /**
  * Predefined fade configurations for different transition types
  */
-const FADE_CONFIGS = {
-    [types_1.FadeType.Dramatic]: { duration: 800, pauseCurve: types_1.EasingType.EaseIn, resumeCurve: types_1.EasingType.EaseOut },
-    [types_1.FadeType.Gentle]: { duration: 800, pauseCurve: types_1.EasingType.EaseOut, resumeCurve: types_1.EasingType.EaseIn },
-    [types_1.FadeType.Linear]: { duration: 800, pauseCurve: types_1.EasingType.Linear, resumeCurve: types_1.EasingType.Linear }
+const fadeConfigs = {
+    [types_1.FadeType.Dramatic]: {
+        duration: 800,
+        pauseCurve: types_1.EasingType.EaseIn,
+        resumeCurve: types_1.EasingType.EaseOut
+    },
+    [types_1.FadeType.Gentle]: {
+        duration: 800,
+        pauseCurve: types_1.EasingType.EaseOut,
+        resumeCurve: types_1.EasingType.EaseIn
+    },
+    [types_1.FadeType.Linear]: {
+        duration: 800,
+        pauseCurve: types_1.EasingType.Linear,
+        resumeCurve: types_1.EasingType.Linear
+    }
 };
 /**
  * Gets the fade configuration for a specific fade type
@@ -36,7 +48,7 @@ const FADE_CONFIGS = {
  * ```
  */
 const getFadeConfig = (fadeType) => {
-    return Object.assign({}, FADE_CONFIGS[fadeType]);
+    return Object.assign({}, fadeConfigs[fadeType]);
 };
 exports.getFadeConfig = getFadeConfig;
 /**
@@ -46,7 +58,7 @@ const easingFunctions = {
     [types_1.EasingType.Linear]: (t) => t,
     [types_1.EasingType.EaseIn]: (t) => t * t,
     [types_1.EasingType.EaseOut]: (t) => t * (2 - t),
-    [types_1.EasingType.EaseInOut]: (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t
+    [types_1.EasingType.EaseInOut]: (t) => (t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t)
 };
 /**
  * Smoothly transitions volume for a specific channel over time
@@ -69,7 +81,14 @@ const transitionVolume = (channelNumber_1, targetVolume_1, ...args_1) => __await
     const volumeDelta = targetVolume - startVolume;
     // Cancel any existing transition for this channel
     if (activeTransitions.has(channelNumber)) {
-        clearTimeout(activeTransitions.get(channelNumber));
+        const transitionId = activeTransitions.get(channelNumber);
+        if (transitionId) {
+            // Handle both requestAnimationFrame and setTimeout IDs
+            if (typeof cancelAnimationFrame !== 'undefined') {
+                cancelAnimationFrame(transitionId);
+            }
+            clearTimeout(transitionId);
+        }
         activeTransitions.delete(channelNumber);
     }
     // If no change needed, resolve immediately
@@ -92,7 +111,7 @@ const transitionVolume = (channelNumber_1, targetVolume_1, ...args_1) => __await
             const elapsed = performance.now() - startTime;
             const progress = Math.min(elapsed / duration, 1);
             const easedProgress = easingFn(progress);
-            const currentVolume = startVolume + (volumeDelta * easedProgress);
+            const currentVolume = startVolume + volumeDelta * easedProgress;
             const clampedVolume = Math.max(0, Math.min(1, currentVolume));
             // Apply volume to both channel config and current audio
             channel.volume = clampedVolume;
@@ -177,8 +196,9 @@ exports.setChannelVolume = setChannelVolume;
  * ```
  */
 const getChannelVolume = (channelNumber = 0) => {
+    var _a;
     const channel = info_1.audioChannels[channelNumber];
-    return (channel === null || channel === void 0 ? void 0 : channel.volume) || 1.0;
+    return (_a = channel === null || channel === void 0 ? void 0 : channel.volume) !== null && _a !== void 0 ? _a : 1.0;
 };
 exports.getChannelVolume = getChannelVolume;
 /**
@@ -193,7 +213,7 @@ exports.getChannelVolume = getChannelVolume;
  * ```
  */
 const getAllChannelsVolume = () => {
-    return info_1.audioChannels.map((channel) => (channel === null || channel === void 0 ? void 0 : channel.volume) || 1.0);
+    return info_1.audioChannels.map((channel) => { var _a; return (_a = channel === null || channel === void 0 ? void 0 : channel.volume) !== null && _a !== void 0 ? _a : 1.0; });
 };
 exports.getAllChannelsVolume = getAllChannelsVolume;
 /**
@@ -285,11 +305,12 @@ exports.clearVolumeDucking = clearVolumeDucking;
 const applyVolumeDucking = (activeChannelNumber) => __awaiter(void 0, void 0, void 0, function* () {
     const transitionPromises = [];
     info_1.audioChannels.forEach((channel, channelNumber) => {
+        var _a, _b;
         if (channel === null || channel === void 0 ? void 0 : channel.volumeConfig) {
             const config = channel.volumeConfig;
             if (activeChannelNumber === config.priorityChannel) {
-                const duration = config.duckTransitionDuration || 250;
-                const easing = config.transitionEasing || types_1.EasingType.EaseOut;
+                const duration = (_a = config.duckTransitionDuration) !== null && _a !== void 0 ? _a : 250;
+                const easing = (_b = config.transitionEasing) !== null && _b !== void 0 ? _b : types_1.EasingType.EaseOut;
                 // Priority channel is active, duck other channels
                 if (channelNumber === config.priorityChannel) {
                     transitionPromises.push((0, exports.transitionVolume)(channelNumber, config.priorityVolume, duration, easing));
@@ -329,13 +350,14 @@ exports.fadeVolume = fadeVolume;
 const restoreVolumeLevels = (stoppedChannelNumber) => __awaiter(void 0, void 0, void 0, function* () {
     const transitionPromises = [];
     info_1.audioChannels.forEach((channel, channelNumber) => {
+        var _a, _b, _c;
         if (channel === null || channel === void 0 ? void 0 : channel.volumeConfig) {
             const config = channel.volumeConfig;
             if (stoppedChannelNumber === config.priorityChannel) {
-                const duration = config.restoreTransitionDuration || 500;
-                const easing = config.transitionEasing || types_1.EasingType.EaseOut;
+                const duration = (_a = config.restoreTransitionDuration) !== null && _a !== void 0 ? _a : 500;
+                const easing = (_b = config.transitionEasing) !== null && _b !== void 0 ? _b : types_1.EasingType.EaseOut;
                 // Priority channel stopped, restore normal volumes
-                transitionPromises.push((0, exports.transitionVolume)(channelNumber, channel.volume || 1.0, duration, easing));
+                transitionPromises.push((0, exports.transitionVolume)(channelNumber, (_c = channel.volume) !== null && _c !== void 0 ? _c : 1.0, duration, easing));
             }
         }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "audio-channel-queue",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Allows you to queue audio files to different playback channels.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,11 @@
     "prepare": "npm run build",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "lint": "npx eslint src/**/*.ts __tests__/**/*.ts",
+    "lint:fix": "npx eslint src/**/*.ts __tests__/**/*.ts --fix",
+    "format": "npx prettier --write src/**/*.ts __tests__/**/*.ts",
+    "format:check": "npx prettier --check src/**/*.ts __tests__/**/*.ts"
   },
   "repository": {
     "type": "git",
@@ -39,6 +43,7 @@
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "ts-jest": "^29.2.5",
-    "typescript": "^5.6.2"
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.34.1"
   }
 }