Files
feishin/src/renderer/features/player/context/player-context.tsx
T
2026-02-13 02:34:22 -08:00

987 lines
32 KiB
TypeScript

import { closeAllModals, openModal } from '@mantine/modals';
import { QueryClient, useIsFetching, useQueryClient } from '@tanstack/react-query';
import { nanoid } from 'nanoid/non-secure';
import { createContext, useCallback, useContext, useMemo, useRef } from 'react';
import { useTranslation } from 'react-i18next';
import { queryKeys } from '/@/renderer/api/query-keys';
import { albumQueries } from '/@/renderer/features/albums/api/album-api';
import { artistsQueries } from '/@/renderer/features/artists/api/artists-api';
import {
filterSongsByPlayerFilters,
getAlbumArtistSongsById,
getAlbumSongsById,
getGenreSongsById,
getPlaylistSongsById,
getSongsByFolder,
} from '/@/renderer/features/player/utils';
import { playlistsQueries } from '/@/renderer/features/playlists/api/playlists-api';
import { songsQueries } from '/@/renderer/features/songs/api/songs-api';
import { AddToQueueType, usePlayerActions, useSettingsStore } from '/@/renderer/store';
import { LogCategory, logFn } from '/@/renderer/utils/logger';
import { shuffle as shuffleArray } from '/@/renderer/utils/shuffle';
import { sortSongsByFetchedOrder } from '/@/shared/api/utils';
import { Checkbox } from '/@/shared/components/checkbox/checkbox';
import { ConfirmModal } from '/@/shared/components/modal/modal';
import { Stack } from '/@/shared/components/stack/stack';
import { Text } from '/@/shared/components/text/text';
import { toast } from '/@/shared/components/toast/toast';
import { useLocalStorage } from '/@/shared/hooks/use-local-storage';
import {
AlbumListSort,
instanceOfCancellationError,
LibraryItem,
PlaylistSongListResponse,
QueueSong,
Song,
} from '/@/shared/types/domain-types';
import { Play, PlayerRepeat, PlayerShuffle } from '/@/shared/types/types';
export interface PlayerContext {
addToQueueByData: (data: Song[], type: AddToQueueType, playSongId?: string) => void;
addToQueueByFetch: (
serverId: string,
id: string[],
itemType: LibraryItem,
type: AddToQueueType,
) => void;
addToQueueByListQuery: (
serverId: string,
query: any,
itemType: LibraryItem,
type: AddToQueueType,
) => Promise<void>;
clearQueue: () => void;
clearSelected: (items: QueueSong[]) => void;
decreaseVolume: (amount: number) => void;
increaseVolume: (amount: number) => void;
mediaNext: () => void;
mediaPause: () => void;
mediaPlay: (id?: string) => void;
mediaPlayByIndex: (index: number) => void;
mediaPrevious: () => void;
mediaSeekToTimestamp: (timestamp: number) => void;
mediaSkipBackward: () => void;
mediaSkipForward: () => void;
mediaStop: () => void;
mediaToggleMute: () => void;
mediaTogglePlayPause: () => void;
moveSelectedTo: (items: QueueSong[], edge: 'bottom' | 'top', uniqueId: string) => void;
moveSelectedToBottom: (items: QueueSong[]) => void;
moveSelectedToNext: (items: QueueSong[]) => void;
moveSelectedToTop: (items: QueueSong[]) => void;
setQueue: (data: Song[], index?: number, position?: number) => void;
setRepeat: (repeat: PlayerRepeat) => void;
setShuffle: (shuffle: PlayerShuffle) => void;
setSpeed: (speed: number) => void;
setVolume: (volume: number) => void;
shuffle: () => void;
shuffleAll: () => void;
shuffleSelected: (items: QueueSong[]) => void;
toggleRepeat: () => void;
toggleShuffle: () => void;
}
export const PlayerContext = createContext<PlayerContext>({
addToQueueByData: () => {},
addToQueueByFetch: () => {},
addToQueueByListQuery: async () => {},
clearQueue: () => {},
clearSelected: () => {},
decreaseVolume: () => {},
increaseVolume: () => {},
mediaNext: () => {},
mediaPause: () => {},
mediaPlay: () => {},
mediaPlayByIndex: () => {},
mediaPrevious: () => {},
mediaSeekToTimestamp: () => {},
mediaSkipBackward: () => {},
mediaSkipForward: () => {},
mediaStop: () => {},
mediaToggleMute: () => {},
mediaTogglePlayPause: () => {},
moveSelectedTo: () => {},
moveSelectedToBottom: () => {},
moveSelectedToNext: () => {},
moveSelectedToTop: () => {},
setQueue: () => {},
setRepeat: () => {},
setShuffle: () => {},
setSpeed: () => {},
setVolume: () => {},
shuffle: () => {},
shuffleAll: () => {},
shuffleSelected: () => {},
toggleRepeat: () => {},
toggleShuffle: () => {},
});
const getRootQueryKey = (itemType: LibraryItem, serverId: string) => {
switch (itemType) {
case LibraryItem.ALBUM:
return queryKeys.songs.root(serverId);
case LibraryItem.ALBUM_ARTIST:
return queryKeys.songs.root(serverId);
case LibraryItem.ARTIST:
return queryKeys.songs.root(serverId);
case LibraryItem.GENRE:
return queryKeys.songs.root(serverId);
case LibraryItem.PLAYLIST:
return queryKeys.playlists.root(serverId);
case LibraryItem.SONG:
return queryKeys.songs.root(serverId);
default:
return queryKeys.songs.root(serverId);
}
};
export const PlayerProvider = ({ children }: { children: React.ReactNode }) => {
const { t } = useTranslation();
const queryClient = useQueryClient();
const storeActions = usePlayerActions();
const timeoutIds = useRef<null | Record<string, ReturnType<typeof setTimeout>>>({});
const [doNotShowAgain, setDoNotShowAgain] = useLocalStorage({
defaultValue: false,
key: 'large_fetch_confirmation',
});
const confirmLargeFetch = useCallback((): Promise<boolean> => {
if (doNotShowAgain) {
return Promise.resolve(true);
}
return new Promise((resolve) => {
openModal({
children: (
<ConfirmModal
labels={{
cancel: t('common.cancel', { postProcess: 'titleCase' }),
confirm: t('common.confirm', { postProcess: 'titleCase' }),
}}
onCancel={() => {
resolve(false);
closeAllModals();
}}
onConfirm={() => {
resolve(true);
closeAllModals();
}}
>
<Stack>
<Text>
{t('form.largeFetchConfirmation.description', {
postProcess: 'sentenceCase',
})}
</Text>
<Checkbox
label={t('common.doNotShowAgain', {
postProcess: 'sentenceCase',
})}
onChange={(event) => {
setDoNotShowAgain(event.currentTarget.checked);
}}
/>
</Stack>
</ConfirmModal>
),
title: t('form.largeFetchConfirmation.title', {
postProcess: 'sentenceCase',
}),
});
});
}, [doNotShowAgain, setDoNotShowAgain, t]);
const addToQueueByData = useCallback(
(data: Song[], type: AddToQueueType, playSongId?: string) => {
const filters = useSettingsStore.getState().playback.filters;
const filteredData = filterSongsByPlayerFilters(data, filters);
if (typeof type === 'object' && 'edge' in type && type.edge !== null) {
const edge = type.edge === 'top' ? 'top' : 'bottom';
logFn.debug('Added to queue by data', {
category: LogCategory.PLAYER,
meta: {
data: data.length,
edge,
filtered: filteredData.length,
type,
uniqueId: type.uniqueId,
},
});
storeActions.addToQueueByUniqueId(filteredData, type.uniqueId, edge, playSongId);
} else {
logFn.debug('Added to queue by type', {
category: LogCategory.PLAYER,
meta: { data: data.length, filtered: filteredData.length, type },
});
storeActions.addToQueueByType(filteredData, type as Play, playSongId);
}
},
[storeActions],
);
const addToQueueByFetch = useCallback(
async (serverId: string, id: string[], itemType: LibraryItem, type: AddToQueueType) => {
let toastId: null | string = null;
const fetchId = nanoid();
timeoutIds.current = {
...timeoutIds.current,
[fetchId]: setTimeout(() => {
toastId = toast.info({
autoClose: false,
message: t('player.playbackFetchCancel', {
postProcess: 'sentenceCase',
}),
onClose: () => {
queryClient.cancelQueries({
exact: false,
queryKey: getRootQueryKey(itemType, serverId),
});
queryClient.cancelQueries({
exact: false,
queryKey: queryKeys.player.fetch(),
});
},
title: t('player.playbackFetchInProgress', {
postProcess: 'sentenceCase',
}),
});
}, 2000),
};
try {
logFn.debug('Added to queue by fetch', {
category: LogCategory.PLAYER,
meta: { ids: id, itemType, serverId, type },
});
const songs = await queryClient.fetchQuery({
gcTime: 0,
queryFn: () => {
return fetchSongsByItemType(queryClient, serverId, {
id,
itemType,
});
},
queryKey: queryKeys.player.fetch(),
staleTime: 0,
});
clearTimeout(timeoutIds.current[fetchId] as ReturnType<typeof setTimeout>);
delete timeoutIds.current[fetchId];
if (toastId) {
toast.hide(toastId);
}
let sortedSongs: Song[] = [];
// Playlists should use the native order of the playlist
if (itemType === LibraryItem.PLAYLIST) {
sortedSongs = songs;
} else {
sortedSongs = sortSongsByFetchedOrder(songs, id, itemType);
}
const filters = useSettingsStore.getState().playback.filters;
const filteredSongs = filterSongsByPlayerFilters(sortedSongs, filters);
if (typeof type === 'object' && 'edge' in type && type.edge !== null) {
const edge = type.edge === 'top' ? 'top' : 'bottom';
storeActions.addToQueueByUniqueId(filteredSongs, type.uniqueId, edge);
} else {
storeActions.addToQueueByType(filteredSongs, type as Play);
}
} catch (err: any) {
if (instanceOfCancellationError(err)) {
return;
}
clearTimeout(timeoutIds.current[fetchId] as ReturnType<typeof setTimeout>);
delete timeoutIds.current[fetchId];
if (toastId) {
toast.hide(toastId);
}
toast.error({
message: err.message,
title: t('error.genericError', { postProcess: 'sentenceCase' }) as string,
});
}
},
[queryClient, storeActions, t],
);
const addToQueueByListQuery = useCallback(
async (serverId: string, query: any, itemType: LibraryItem, type: AddToQueueType) => {
let toastId: null | string = null;
let fetchId: null | string = null;
logFn.debug('Added to queue by list query', {
category: LogCategory.PLAYER,
meta: { itemType, query, serverId, type },
});
try {
let totalCount = 0;
let listQueryFn: any;
let listCountQueryFn: any;
// Special handling for albums with random sort: fetch in name order, then shuffle client-side
const isAlbumRandomSort =
itemType === LibraryItem.ALBUM && query.sortBy === AlbumListSort.RANDOM;
const fetchQuery = isAlbumRandomSort
? { ...query, sortBy: AlbumListSort.NAME }
: query;
switch (itemType) {
case LibraryItem.ALBUM: {
listQueryFn = albumQueries.list;
listCountQueryFn = albumQueries.listCount;
break;
}
case LibraryItem.ALBUM_ARTIST: {
listQueryFn = artistsQueries.albumArtistList;
listCountQueryFn = artistsQueries.albumArtistListCount;
break;
}
case LibraryItem.ARTIST: {
listQueryFn = artistsQueries.artistList;
listCountQueryFn = artistsQueries.artistListCount;
break;
}
case LibraryItem.PLAYLIST: {
listQueryFn = playlistsQueries.list;
listCountQueryFn = playlistsQueries.listCount;
break;
}
case LibraryItem.SONG: {
listQueryFn = songsQueries.list;
listCountQueryFn = songsQueries.listCount;
break;
}
default: {
throw new Error(`Unsupported item type: ${itemType}`);
}
}
// Get total count
const countResult = (await queryClient.fetchQuery({
...listCountQueryFn({
query: { ...fetchQuery },
serverId,
}),
gcTime: 0,
queryKey: queryKeys.player.fetch(),
staleTime: 0,
})) as number;
totalCount = countResult || 0;
const allResults: Song[] | string[] = [];
const pageSize = 500;
const confirmed = await confirmLargeFetch();
if (!confirmed) {
return;
}
// Start timeout only after confirmation (if needed)
fetchId = nanoid();
timeoutIds.current = {
...timeoutIds.current,
[fetchId]: setTimeout(() => {
toastId = toast.info({
autoClose: false,
message: t('player.playbackFetchCancel', {
postProcess: 'sentenceCase',
}),
onClose: () => {
logFn.debug('Cancelled fetch', {
category: LogCategory.PLAYER,
meta: { itemType, serverId },
});
queryClient.cancelQueries({
exact: false,
queryKey: getRootQueryKey(itemType, serverId),
});
queryClient.cancelQueries({
exact: false,
queryKey: queryKeys.player.fetch(),
});
},
title: t('player.playbackFetchInProgress', {
postProcess: 'sentenceCase',
}),
});
}, 2000),
};
let startIndex = 0;
while (startIndex < totalCount) {
const pageQuery = {
...fetchQuery,
limit: pageSize,
startIndex,
};
const pageResult = (await queryClient.fetchQuery({
...listQueryFn({
query: pageQuery,
serverId,
}),
gcTime: 0,
queryKey: queryKeys.player.fetch({ startIndex }),
staleTime: 0,
})) as { items: any[] };
if (pageResult?.items) {
if (itemType === LibraryItem.SONG) {
allResults.push(...pageResult.items);
} else {
const pageIds = pageResult.items.map((item: any) => item.id);
allResults.push(...pageIds);
}
}
// If we got fewer items than requested, we've reached the end
if (!pageResult?.items || pageResult.items.length < pageSize) {
break;
}
startIndex += pageSize;
}
if (fetchId && timeoutIds.current) {
clearTimeout(timeoutIds.current[fetchId] as ReturnType<typeof setTimeout>);
delete timeoutIds.current[fetchId];
}
if (toastId) {
toast.hide(toastId);
}
// Shuffle album IDs client-side if this was a random sort request
let finalResults = allResults;
if (isAlbumRandomSort && itemType === LibraryItem.ALBUM) {
finalResults = shuffleArray(allResults as string[]) as typeof allResults;
}
if (itemType === LibraryItem.SONG) {
addToQueueByData(finalResults as Song[], type);
} else {
await addToQueueByFetch(serverId, finalResults as string[], itemType, type);
}
} catch (err: any) {
if (instanceOfCancellationError(err)) {
return;
}
if (fetchId && timeoutIds.current) {
clearTimeout(timeoutIds.current[fetchId] as ReturnType<typeof setTimeout>);
delete timeoutIds.current[fetchId];
}
if (toastId) {
toast.hide(toastId);
}
toast.error({
message: err.message,
title: t('error.genericError', { postProcess: 'sentenceCase' }) as string,
});
}
},
[queryClient, confirmLargeFetch, t, addToQueueByData, addToQueueByFetch],
);
const clearQueue = useCallback(() => {
logFn.debug('Cleared queue', {
category: LogCategory.PLAYER,
});
storeActions.clearQueue();
}, [storeActions]);
const clearSelected = useCallback(
(items: QueueSong[]) => {
logFn.debug('Cleared selected', {
category: LogCategory.PLAYER,
meta: { items: items.length },
});
storeActions.clearSelected(items);
},
[storeActions],
);
const decreaseVolume = useCallback(
(amount: number) => {
logFn.debug('Decreased volume', {
category: LogCategory.PLAYER,
meta: { amount },
});
storeActions.decreaseVolume(amount);
},
[storeActions],
);
const increaseVolume = useCallback(
(amount: number) => {
logFn.debug('Increased volume', {
category: LogCategory.PLAYER,
meta: { amount },
});
storeActions.increaseVolume(amount);
},
[storeActions],
);
const mediaNext = useCallback(() => {
logFn.debug('Media next', {
category: LogCategory.PLAYER,
});
storeActions.mediaNext();
}, [storeActions]);
const mediaPause = useCallback(() => {
logFn.debug('Media pause', {
category: LogCategory.PLAYER,
});
storeActions.mediaPause();
}, [storeActions]);
const mediaPlay = useCallback(
(id?: string) => {
logFn.debug('Media play', {
category: LogCategory.PLAYER,
meta: { id },
});
storeActions.mediaPlay(id);
},
[storeActions],
);
const mediaPlayByIndex = useCallback(
(index: number) => {
logFn.debug('Media play by index', {
category: LogCategory.PLAYER,
meta: { index },
});
storeActions.mediaPlayByIndex(index);
},
[storeActions],
);
const mediaPrevious = useCallback(() => {
logFn.debug('Media previous', {
category: LogCategory.PLAYER,
});
storeActions.mediaPrevious();
}, [storeActions]);
const mediaStop = useCallback(() => {
logFn.debug('Media stop', {
category: LogCategory.PLAYER,
});
storeActions.mediaStop();
}, [storeActions]);
const mediaSeekToTimestamp = useCallback(
(timestamp: number) => {
logFn.debug('Media seek to timestamp', {
category: LogCategory.PLAYER,
meta: { timestamp },
});
storeActions.mediaSeekToTimestamp(timestamp);
},
[storeActions],
);
const mediaSkipBackward = useCallback(() => {
logFn.debug('Media skip backward', {
category: LogCategory.PLAYER,
});
storeActions.mediaSkipBackward();
}, [storeActions]);
const mediaSkipForward = useCallback(() => {
logFn.debug('Media skip forward', {
category: LogCategory.PLAYER,
});
storeActions.mediaSkipForward();
}, [storeActions]);
const setQueue = useCallback(
(data: Song[], index?: number, position?: number) => {
logFn.debug('Set queue', {
category: LogCategory.PLAYER,
meta: {
data: data.length,
index,
position,
},
});
storeActions.setQueue(data, index, position);
},
[storeActions],
);
const setSpeed = useCallback(
(speed: number) => {
logFn.debug('Set speed', {
category: LogCategory.PLAYER,
meta: { speed },
});
storeActions.setSpeed(speed);
},
[storeActions],
);
const mediaToggleMute = useCallback(() => {
logFn.debug('Media toggle mute', {
category: LogCategory.PLAYER,
});
storeActions.mediaToggleMute();
}, [storeActions]);
const mediaTogglePlayPause = useCallback(() => {
logFn.debug('Media toggle play pause', {
category: LogCategory.PLAYER,
});
storeActions.mediaTogglePlayPause();
}, [storeActions]);
const moveSelectedTo = useCallback(
(items: QueueSong[], edge: 'bottom' | 'top', uniqueId: string) => {
logFn.debug('Moved selected to', {
category: LogCategory.PLAYER,
meta: { edge, items, uniqueId },
});
storeActions.moveSelectedTo(items, uniqueId, edge);
},
[storeActions],
);
const moveSelectedToBottom = useCallback(
(items: QueueSong[]) => {
logFn.debug('Moved selected to bottom', {
category: LogCategory.PLAYER,
meta: { items },
});
storeActions.moveSelectedToBottom(items);
},
[storeActions],
);
const moveSelectedToNext = useCallback(
(items: QueueSong[]) => {
logFn.debug('Moved selected to next', {
category: LogCategory.PLAYER,
meta: { items },
});
storeActions.moveSelectedToNext(items);
},
[storeActions],
);
const moveSelectedToTop = useCallback(
(items: QueueSong[]) => {
logFn.debug('Moved selected to top', {
category: LogCategory.PLAYER,
meta: { items },
});
storeActions.moveSelectedToTop(items);
},
[storeActions],
);
const setVolume = useCallback(
(volume: number) => {
logFn.debug('Set volume', {
category: LogCategory.PLAYER,
meta: { volume },
});
storeActions.setVolume(volume);
},
[storeActions],
);
const setRepeat = useCallback(
(repeat: PlayerRepeat) => {
logFn.debug('Set repeat', {
category: LogCategory.PLAYER,
meta: { repeat },
});
storeActions.setRepeat(repeat);
},
[storeActions],
);
const setShuffle = useCallback(
(shuffle: PlayerShuffle) => {
logFn.debug('Set shuffle', {
category: LogCategory.PLAYER,
meta: { shuffle },
});
storeActions.setShuffle(shuffle);
},
[storeActions],
);
const shuffle = useCallback(() => {
logFn.debug('Shuffle', {
category: LogCategory.PLAYER,
});
storeActions.shuffle();
}, [storeActions]);
const shuffleAll = useCallback(() => {
logFn.debug('Shuffle all', {
category: LogCategory.PLAYER,
});
storeActions.shuffleAll();
}, [storeActions]);
const shuffleSelected = useCallback(
(items: QueueSong[]) => {
logFn.debug('Shuffle selected', {
category: LogCategory.PLAYER,
meta: { items },
});
storeActions.shuffleSelected(items);
},
[storeActions],
);
const toggleRepeat = useCallback(() => {
logFn.debug('Toggle repeat', {
category: LogCategory.PLAYER,
});
storeActions.toggleRepeat();
}, [storeActions]);
const toggleShuffle = useCallback(() => {
logFn.debug('Toggle shuffle', {
category: LogCategory.PLAYER,
});
storeActions.toggleShuffle();
}, [storeActions]);
const contextValue: PlayerContext = useMemo(
() => ({
addToQueueByData,
addToQueueByFetch,
addToQueueByListQuery,
clearQueue,
clearSelected,
decreaseVolume,
increaseVolume,
mediaNext,
mediaPause,
mediaPlay,
mediaPlayByIndex,
mediaPrevious,
mediaSeekToTimestamp,
mediaSkipBackward,
mediaSkipForward,
mediaStop,
mediaToggleMute,
mediaTogglePlayPause,
moveSelectedTo,
moveSelectedToBottom,
moveSelectedToNext,
moveSelectedToTop,
setQueue,
setRepeat,
setShuffle,
setSpeed,
setVolume,
shuffle,
shuffleAll,
shuffleSelected,
toggleRepeat,
toggleShuffle,
}),
[
addToQueueByData,
addToQueueByFetch,
addToQueueByListQuery,
clearQueue,
clearSelected,
decreaseVolume,
increaseVolume,
mediaNext,
mediaPause,
mediaPlay,
mediaPlayByIndex,
mediaPrevious,
mediaSeekToTimestamp,
mediaSkipBackward,
mediaSkipForward,
mediaStop,
mediaToggleMute,
mediaTogglePlayPause,
moveSelectedTo,
moveSelectedToBottom,
moveSelectedToNext,
moveSelectedToTop,
setQueue,
setRepeat,
setShuffle,
setSpeed,
setVolume,
shuffle,
shuffleAll,
shuffleSelected,
toggleRepeat,
toggleShuffle,
],
);
return <PlayerContext.Provider value={contextValue}>{children}</PlayerContext.Provider>;
};
export const usePlayer = () => {
return useContext(PlayerContext);
};
/**
* Fetches the songs from the server
* @param queryClient - The query client to use to fetch the data
* @param serverId - The library id to use to fetch the data
* @param type - The type of the item to add to the queue
* @param args - The arguments to use to fetch the data
* @returns The songs to add to the queue
*/
export async function fetchSongsByItemType(
queryClient: QueryClient,
serverId: string,
args: {
id: string[];
itemType: LibraryItem;
params?: Record<string, any>;
},
) {
const songs: Song[] = [];
switch (args.itemType) {
case LibraryItem.ALBUM: {
const albumSongsResponse = await getAlbumSongsById({
id: args.id,
query: args.params,
queryClient,
serverId,
});
songs.push(...albumSongsResponse.items);
break;
}
case LibraryItem.ALBUM_ARTIST: {
const albumArtistSongsResponse = await getAlbumArtistSongsById({
id: args.id,
query: args.params,
queryClient,
serverId,
});
songs.push(...albumArtistSongsResponse.items);
break;
}
case LibraryItem.ARTIST: {
const artistSongsResponse = await getAlbumArtistSongsById({
id: args.id,
query: args.params,
queryClient,
serverId,
});
songs.push(...artistSongsResponse.items);
break;
}
case LibraryItem.FOLDER: {
const folderSongsResponse = await getSongsByFolder({
id: args.id,
query: args.params,
queryClient,
serverId,
});
songs.push(...folderSongsResponse.items);
break;
}
case LibraryItem.GENRE: {
const genreSongsResponse = await getGenreSongsById({
id: args.id,
query: args.params,
queryClient,
serverId,
});
songs.push(...genreSongsResponse.items);
break;
}
case LibraryItem.PLAYLIST: {
const promises: Promise<PlaylistSongListResponse>[] = [];
for (const id of args.id) {
promises.push(
getPlaylistSongsById({
id,
query: args.params,
queryClient,
serverId,
}),
);
}
const results = await Promise.all(promises);
songs.push(...results.flatMap((r) => r.items));
break;
}
}
return songs;
}
export const useIsPlayerFetching = () => {
const playerFetchCount = useIsFetching({ queryKey: queryKeys.player.fetch() });
return playerFetchCount > 0;
};