@involvex/youtube-music-cli 0.0.46 → 0.0.47

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@involvex/youtube-music-cli",
-    "version": "0.0.46",
+    "version": "0.0.47",
     "description": "- A Commandline music player for youtube-music",
     "repository": {
         "type": "git",

package/dist/source/components/common/ShortcutsBar.js

@@ -10,7 +10,7 @@ import { ICONS } from "../../utils/icons.js";
 const FLASH_DURATION_MS = 300;
 export default function ShortcutsBar() {
     const { theme } = useTheme();
-    const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, } = usePlayer();
+    const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, toggleAutoplay, } = usePlayer();
     const [flashState, setFlashState] = useState({});
     const flash = (key) => {
         setFlashState(prev => ({ ...prev, [key]: true }));
@@ -62,6 +62,10 @@ export default function ShortcutsBar() {
         flash('repeat');
         toggleRepeat();
     });
+    useKeyBinding(KEYBINDINGS.AUTOPLAY_TOGGLE, () => {
+        flash('autoplay');
+        toggleAutoplay();
+    });
     // Note: SETTINGS keybinding handled by MainLayout to avoid double-dispatch
     const shuffleColor = flashState['shuffle']
         ? theme.colors.success
@@ -76,5 +80,10 @@ export default function ShortcutsBar() {
     const volumeColor = flashState['volume']
         ? theme.colors.success
         : theme.colors.primary;
-    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsxs(Text, { color: shortcutColor('playPause'), children: [playerState.isPlaying ? ICONS.PAUSE : ICONS.PLAY_PAUSE_ON, " [Space]"] }), ' ', "| ", _jsxs(Text, { color: shortcutColor('prev'), children: [ICONS.PREV, " [B/\u2190]"] }), " |", ' ', _jsxs(Text, { color: shortcutColor('next'), children: [ICONS.NEXT, " [N/\u2192]"] }), " |", ' ', _jsxs(Text, { color: shuffleColor, children: [ICONS.SHUFFLE, " [Shift+S]"] }), " |", ' ', _jsxs(Text, { color: repeatColor, children: [playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL, ' ', "[R]"] }), ' ', "| ", _jsxs(Text, { color: theme.colors.text, children: [ICONS.PLAYLIST, " [Shift+P]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.DOWNLOAD, " [Shift+D]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.SEARCH, " [/]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.HELP, " [?]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.BG_PLAY, " [Shift+Q]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.RESUME, " [Shift+R]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.QUIT, " [Q]"] })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: shuffleColor, children: ICONS.SHUFFLE }), ' ', _jsx(Text, { color: repeatColor, children: playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: volumeColor, children: [playerState.volume, "%"] })] })] }));
+    const autoplayColor = flashState['autoplay']
+        ? theme.colors.success
+        : playerState.autoplay
+            ? theme.colors.primary
+            : theme.colors.dim;
+    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsxs(Text, { color: shortcutColor('playPause'), children: [playerState.isPlaying ? ICONS.PAUSE : ICONS.PLAY_PAUSE_ON, " [Space]"] }), ' ', "| ", _jsxs(Text, { color: shortcutColor('prev'), children: [ICONS.PREV, " [B/\u2190]"] }), " |", ' ', _jsxs(Text, { color: shortcutColor('next'), children: [ICONS.NEXT, " [N/\u2192]"] }), " |", ' ', _jsxs(Text, { color: shuffleColor, children: [ICONS.SHUFFLE, " [Shift+S]"] }), " |", ' ', _jsxs(Text, { color: repeatColor, children: [playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL, ' ', "[R]"] }), ' ', "| ", _jsxs(Text, { color: autoplayColor, children: [ICONS.AUTOPLAY, " [Shift+A]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.PLAYLIST, " [Shift+P]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.DOWNLOAD, " [Shift+D]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.SEARCH, " [/]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.HELP, " [?]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.BG_PLAY, " [Shift+Q]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.RESUME, " [Shift+R]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.QUIT, " [Q]"] })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: shuffleColor, children: ICONS.SHUFFLE }), ' ', _jsx(Text, { color: repeatColor, children: playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsx(Text, { color: autoplayColor, children: ICONS.AUTOPLAY }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: volumeColor, children: [playerState.volume, "%"] })] })] }));
 }

package/dist/source/hooks/usePlayer.d.ts

@@ -17,6 +17,7 @@ export declare function usePlayer(): {
     volumeFineDown: () => void;
     toggleShuffle: () => void;
     toggleRepeat: () => void;
+    toggleAutoplay: () => void;
     setQueue: (queue: Track[]) => void;
     addToQueue: (track: Track) => void;
     removeFromQueue: (index: number) => void;

package/dist/source/services/player-state/player-state.service.d.ts

@@ -8,6 +8,7 @@ export interface PersistedPlayerState {
     volume: number;
     shuffle: boolean;
     repeat: 'off' | 'all' | 'one';
+    autoplay?: boolean;
     lastUpdated: string;
 }
 /**

package/dist/source/services/player-state/player-state.service.js

@@ -15,6 +15,7 @@ const defaultState = {
     volume: 70,
     shuffle: false,
     repeat: 'off',
+    autoplay: true,
     lastUpdated: new Date().toISOString(),
 };
 /**

package/dist/source/services/web/web-server-manager.js

@@ -21,6 +21,7 @@ class WebServerManager {
         queuePosition: 0,
         repeat: 'off',
         shuffle: false,
+        autoplay: true,
         isLoading: false,
         error: null,
         playRequestId: 0,

package/dist/source/services/web/web-streaming.service.js

@@ -164,6 +164,7 @@ class WebStreamingService {
             'queuePosition',
             'repeat',
             'shuffle',
+            'autoplay',
             'isLoading',
             'error',
         ];
@@ -186,9 +187,10 @@ class WebStreamingService {
      * Update and broadcast player state (throttled)
      */
     onStateChange(state) {
-        this.prevState = { ...state };
         const now = Date.now();
+        // Compute delta against OLD prevState BEFORE updating it
         const delta = this.computeDelta(state);
+        this.prevState = { ...state };
         // Skip if no changes
         if (Object.keys(delta).length === 0) {
             return;

package/dist/source/stores/player.store.d.ts

@@ -18,6 +18,7 @@ type PlayerContextValue = {
     volumeFineDown: () => void;
     toggleShuffle: () => void;
     toggleRepeat: () => void;
+    toggleAutoplay: () => void;
     setQueue: (queue: Track[]) => void;
     addToQueue: (track: Track) => void;
     removeFromQueue: (index: number) => void;

package/dist/source/stores/player.store.js

@@ -21,6 +21,7 @@ const initialState = {
     queuePosition: 0,
     repeat: 'off',
     shuffle: false,
+    autoplay: true,
     isLoading: false,
     error: null,
     playRequestId: 0,
@@ -150,6 +151,8 @@ export function playerReducer(state, action) {
         }
         case 'TOGGLE_SHUFFLE':
             return { ...state, shuffle: !state.shuffle };
+        case 'TOGGLE_AUTOPLAY':
+            return { ...state, autoplay: !state.autoplay };
         case 'TOGGLE_REPEAT':
             const repeatModes = ['off', 'all', 'one'];
             const currentIndex = repeatModes.indexOf(state.repeat);
@@ -225,6 +228,7 @@ export function playerReducer(state, action) {
                 volume: action.volume,
                 shuffle: action.shuffle,
                 repeat: action.repeat,
+                autoplay: action.autoplay ?? true,
                 isPlaying: false, // Don't auto-play restored state
             };
         default:
@@ -547,6 +551,62 @@ function PlayerManager() {
         state.shuffle,
         dispatch,
     ]);
+    // Smart autoplay: fetch suggestions when near end of queue
+    const fetchedForRef = useRef(null);
+    const isFetchingAutoplayRef = useRef(false);
+    useEffect(() => {
+        if (!state.autoplay || !state.currentTrack || !state.isPlaying) {
+            return;
+        }
+        // Already looping — no need to feed the queue
+        if (state.repeat === 'all' || (state.shuffle && state.queue.length > 1)) {
+            return;
+        }
+        // Still enough tracks ahead — wait until we're close to the end
+        const tracksAhead = state.queue.length - state.queuePosition - 1;
+        if (tracksAhead > 5)
+            return;
+        // Already fetched for this track or a fetch is in flight
+        if (fetchedForRef.current === state.currentTrack.videoId ||
+            isFetchingAutoplayRef.current) {
+            return;
+        }
+        const trackId = state.currentTrack.videoId;
+        const trackTitle = state.currentTrack.title;
+        isFetchingAutoplayRef.current = true;
+        fetchedForRef.current = trackId;
+        musicService
+            .getSuggestions(trackId)
+            .then(suggestions => {
+            for (const track of suggestions) {
+                dispatch({ category: 'ADD_TO_QUEUE', track });
+            }
+            logger.info('PlayerManager', 'Autoplay: added suggestions', {
+                count: suggestions.length,
+                basedOn: trackTitle,
+            });
+        })
+            .catch((error) => {
+            isFetchingAutoplayRef.current = false;
+            fetchedForRef.current = null; // Allow retry on next track change
+            logger.warn('PlayerManager', 'Autoplay: failed to fetch suggestions', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        })
+            .finally(() => {
+            isFetchingAutoplayRef.current = false;
+        });
+    }, [
+        state.autoplay,
+        state.currentTrack,
+        state.isPlaying,
+        state.repeat,
+        state.shuffle,
+        state.queue.length,
+        state.queuePosition,
+        musicService,
+        dispatch,
+    ]);
     return null;
 }
 export function PlayerProvider({ children }) {
@@ -574,6 +634,7 @@ export function PlayerProvider({ children }) {
                     volume: persistedState.volume,
                     shuffle: persistedState.shuffle,
                     repeat: persistedState.repeat,
+                    autoplay: persistedState.autoplay ?? true,
                 });
             }
         });
@@ -596,6 +657,7 @@ export function PlayerProvider({ children }) {
                 volume: state.volume,
                 shuffle: state.shuffle,
                 repeat: state.repeat,
+                autoplay: state.autoplay,
             });
         }, 
         // Debounce progress updates (5s), immediate for track/queue changes
@@ -613,6 +675,7 @@ export function PlayerProvider({ children }) {
         state.volume,
         state.shuffle,
         state.repeat,
+        state.autoplay,
     ]);
     // Save immediately on unmount/quit
     useEffect(() => {
@@ -627,6 +690,7 @@ export function PlayerProvider({ children }) {
                 volume: currentState.volume,
                 shuffle: currentState.shuffle,
                 repeat: currentState.repeat,
+                autoplay: currentState.autoplay,
             });
         };
         process.on('beforeExit', handleExit);
@@ -695,6 +759,7 @@ export function PlayerProvider({ children }) {
         },
         toggleShuffle: () => dispatch({ category: 'TOGGLE_SHUFFLE' }),
         toggleRepeat: () => dispatch({ category: 'TOGGLE_REPEAT' }),
+        toggleAutoplay: () => dispatch({ category: 'TOGGLE_AUTOPLAY' }),
         setQueue: (queue) => dispatch({ category: 'SET_QUEUE', queue }),
         addToQueue: (track) => dispatch({ category: 'ADD_TO_QUEUE', track }),
         removeFromQueue: (index) => dispatch({ category: 'REMOVE_FROM_QUEUE', index }),

package/dist/source/types/actions.d.ts

@@ -44,6 +44,9 @@ export interface ToggleShuffleAction {
 export interface ToggleRepeatAction {
     readonly category: 'TOGGLE_REPEAT';
 }
+export interface ToggleAutoplayAction {
+    readonly category: 'TOGGLE_AUTOPLAY';
+}
 export interface SetQueueAction {
     readonly category: 'SET_QUEUE';
     queue: Track[];
@@ -91,6 +94,7 @@ export interface RestoreStateAction {
     volume: number;
     shuffle: boolean;
     repeat: 'off' | 'all' | 'one';
+    autoplay?: boolean;
 }
 export interface SetSpeedAction {
     readonly category: 'SET_SPEED';

package/dist/source/types/player.types.d.ts

@@ -1,4 +1,4 @@
-import type { PlayAction, PauseAction, ResumeAction, StopAction, NextAction, PreviousAction, SeekAction, SetVolumeAction, VolumeUpAction, VolumeDownAction, VolumeFineUpAction, VolumeFineDownAction, ToggleShuffleAction, ToggleRepeatAction, SetQueueAction, AddToQueueAction, RemoveFromQueueAction, ClearQueueAction, SetQueuePositionAction, UpdateProgressAction, SetDurationAction, TickAction, SetLoadingAction, SetErrorAction, RestoreStateAction, SetSpeedAction } from './actions.ts';
+import type { PlayAction, PauseAction, ResumeAction, StopAction, NextAction, PreviousAction, SeekAction, SetVolumeAction, VolumeUpAction, VolumeDownAction, VolumeFineUpAction, VolumeFineDownAction, ToggleShuffleAction, ToggleRepeatAction, ToggleAutoplayAction, SetQueueAction, AddToQueueAction, RemoveFromQueueAction, ClearQueueAction, SetQueuePositionAction, UpdateProgressAction, SetDurationAction, TickAction, SetLoadingAction, SetErrorAction, RestoreStateAction, SetSpeedAction } from './actions.ts';
 import type { Track } from './youtube-music.types.ts';
 export interface PlayerState {
     currentTrack: Track | null;
@@ -11,8 +11,9 @@ export interface PlayerState {
     queuePosition: number;
     repeat: 'off' | 'all' | 'one';
     shuffle: boolean;
+    autoplay: boolean;
     isLoading: boolean;
     error: string | null;
     playRequestId: number;
 }
-export type PlayerAction = PlayAction | PauseAction | ResumeAction | StopAction | NextAction | PreviousAction | SeekAction | SetVolumeAction | VolumeUpAction | VolumeDownAction | VolumeFineUpAction | VolumeFineDownAction | ToggleShuffleAction | ToggleRepeatAction | SetQueueAction | AddToQueueAction | RemoveFromQueueAction | ClearQueueAction | SetQueuePositionAction | UpdateProgressAction | SetDurationAction | TickAction | SetLoadingAction | SetErrorAction | RestoreStateAction | SetSpeedAction;
+export type PlayerAction = PlayAction | PauseAction | ResumeAction | StopAction | NextAction | PreviousAction | SeekAction | SetVolumeAction | VolumeUpAction | VolumeDownAction | VolumeFineUpAction | VolumeFineDownAction | ToggleShuffleAction | ToggleRepeatAction | ToggleAutoplayAction | SetQueueAction | AddToQueueAction | RemoveFromQueueAction | ClearQueueAction | SetQueuePositionAction | UpdateProgressAction | SetDurationAction | TickAction | SetLoadingAction | SetErrorAction | RestoreStateAction | SetSpeedAction;

package/dist/source/utils/constants.d.ts

@@ -49,6 +49,7 @@ export declare const KEYBINDINGS: {
     readonly VOLUME_FINE_DOWN: readonly ["shift+-"];
     readonly SHUFFLE: readonly ["shift+s"];
     readonly REPEAT: readonly ["r"];
+    readonly AUTOPLAY_TOGGLE: readonly ["shift+a"];
     readonly GAPLESS_TOGGLE: readonly ["shift+g"];
     readonly CROSSFADE_CYCLE: readonly ["shift+c"];
     readonly EQUALIZER_CYCLE: readonly ["shift+e"];

package/dist/source/utils/constants.js

@@ -85,6 +85,7 @@ export const KEYBINDINGS = {
     VOLUME_FINE_DOWN: ['shift+-'], // Fine-grained -1 step
     SHUFFLE: ['shift+s'],
     REPEAT: ['r'],
+    AUTOPLAY_TOGGLE: ['shift+a'],
     GAPLESS_TOGGLE: ['shift+g'],
     CROSSFADE_CYCLE: ['shift+c'],
     EQUALIZER_CYCLE: ['shift+e'],

package/dist/source/utils/icons.d.ts

@@ -16,4 +16,5 @@ export declare const ICONS: {
     readonly RESUME: "⟳";
     readonly BG_PLAY: "○";
     readonly VOLUME: "♪";
+    readonly AUTOPLAY: "∞";
 };

package/dist/source/utils/icons.js

@@ -23,4 +23,6 @@ export const ICONS = {
     BG_PLAY: '○', // U+25CB
     // Status
     VOLUME: '♪', // U+266A
+    // Autoplay / radio
+    AUTOPLAY: '∞', // U+221E
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.46",
+	"version": "0.0.47",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",