475 lines
18 KiB
TypeScript
475 lines
18 KiB
TypeScript
/*
|
|
* Copyright (C) Contributors to the Suwayomi project
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
import { t as translate } from 'i18next';
|
|
import { DocumentNode, MaybeMasked, Unmasked, useFragment } from '@apollo/client';
|
|
import { makeToast } from '@/modules/core/utils/Toast.ts';
|
|
import { requestManager } from '@/lib/requests/RequestManager.ts';
|
|
import { getMetadataServerSettings } from '@/modules/settings/services/ServerSettingsMetadata.ts';
|
|
import {
|
|
ChapterListFieldsFragment,
|
|
ChapterType,
|
|
DownloadState,
|
|
DownloadStatusFieldsFragment,
|
|
DownloadTypeFieldsFragment,
|
|
} from '@/lib/graphql/generated/graphql.ts';
|
|
import { CHAPTER_LIST_FIELDS } from '@/lib/graphql/fragments/ChapterFragments.ts';
|
|
|
|
import { DirectionOffset, TranslationKey } from '@/Base.types.ts';
|
|
import { MangaIdInfo } from '@/modules/manga/Manga.types.ts';
|
|
import { ReaderOpenChapterLocationState, ReaderResumeMode } from '@/modules/reader/types/Reader.types.ts';
|
|
import { AppRoutes } from '@/modules/core/AppRoute.constants.ts';
|
|
import { getErrorMessage } from '@/lib/HelperFunctions.ts';
|
|
import { DOWNLOAD_TYPE_FIELDS } from '@/lib/graphql/fragments/DownloadFragments.ts';
|
|
import { epochToDate, getDateString } from '@/util/DateHelper.ts';
|
|
|
|
export type ChapterAction = 'download' | 'delete' | 'bookmark' | 'unbookmark' | 'mark_as_read' | 'mark_as_unread';
|
|
|
|
export const CHAPTER_ACTION_TO_TRANSLATION: {
|
|
[key in ChapterAction]: {
|
|
action: {
|
|
single: TranslationKey;
|
|
selected: TranslationKey;
|
|
};
|
|
success: TranslationKey;
|
|
error: TranslationKey;
|
|
};
|
|
} = {
|
|
download: {
|
|
action: {
|
|
single: 'chapter.action.download.add.label.action',
|
|
selected: 'chapter.action.download.add.button.selected',
|
|
},
|
|
success: 'chapter.action.download.add.label.success',
|
|
error: 'chapter.action.download.add.label.error',
|
|
},
|
|
delete: {
|
|
action: {
|
|
single: 'chapter.action.download.delete.label.action',
|
|
selected: 'chapter.action.download.delete.button.selected',
|
|
},
|
|
success: 'chapter.action.download.delete.label.success',
|
|
error: 'chapter.action.download.delete.label.error',
|
|
},
|
|
bookmark: {
|
|
action: {
|
|
single: 'chapter.action.bookmark.add.label.action',
|
|
selected: 'chapter.action.bookmark.add.button.selected',
|
|
},
|
|
success: 'chapter.action.bookmark.add.label.success',
|
|
error: 'chapter.action.bookmark.add.label.error',
|
|
},
|
|
unbookmark: {
|
|
action: {
|
|
single: 'chapter.action.bookmark.remove.label.action',
|
|
selected: 'chapter.action.bookmark.remove.button.selected',
|
|
},
|
|
success: 'chapter.action.bookmark.remove.label.success',
|
|
error: 'chapter.action.bookmark.remove.label.error',
|
|
},
|
|
mark_as_read: {
|
|
action: {
|
|
single: 'chapter.action.mark_as_read.add.label.action.current',
|
|
selected: 'chapter.action.mark_as_read.add.button.selected',
|
|
},
|
|
success: 'chapter.action.mark_as_read.add.label.success',
|
|
error: 'chapter.action.mark_as_read.add.label.error',
|
|
},
|
|
mark_as_unread: {
|
|
action: {
|
|
single: 'chapter.action.mark_as_read.remove.label.action',
|
|
selected: 'chapter.action.mark_as_read.remove.button.selected',
|
|
},
|
|
success: 'chapter.action.mark_as_read.remove.label.success',
|
|
error: 'chapter.action.mark_as_read.remove.label.error',
|
|
},
|
|
};
|
|
|
|
export type ChapterDownloadStatus = DownloadStatusFieldsFragment['queue'][number];
|
|
|
|
export type ChapterIdInfo = Pick<ChapterType, 'id'>;
|
|
export type ChapterMangaInfo = Pick<ChapterType, 'mangaId'>;
|
|
export type ChapterDownloadInfo = ChapterIdInfo & Pick<ChapterType, 'isDownloaded'>;
|
|
export type ChapterBookmarkInfo = ChapterIdInfo & Pick<ChapterType, 'isBookmarked'>;
|
|
export type ChapterReadInfo = ChapterIdInfo & Pick<ChapterType, 'isRead'>;
|
|
export type ChapterNumberInfo = ChapterIdInfo & Pick<ChapterType, 'chapterNumber'>;
|
|
export type ChapterSourceOrderInfo = ChapterIdInfo & Pick<ChapterType, 'sourceOrder'>;
|
|
export type ChapterScanlatorInfo = ChapterIdInfo & Pick<ChapterType, 'scanlator'>;
|
|
export type ChapterRealUrlInfo = Pick<ChapterType, 'realUrl'>;
|
|
|
|
export class Chapters {
|
|
static getIds(chapters: { id: number }[]): number[] {
|
|
return chapters.map((chapter) => chapter.id);
|
|
}
|
|
|
|
static getFromCache<T = ChapterListFieldsFragment>(
|
|
id: number,
|
|
fragment: DocumentNode = CHAPTER_LIST_FIELDS,
|
|
fragmentName: string = 'CHAPTER_LIST_FIELDS',
|
|
): Unmasked<T> | null {
|
|
return requestManager.graphQLClient.client.cache.readFragment<T>({
|
|
id: requestManager.graphQLClient.client.cache.identify({
|
|
__typename: 'ChapterType',
|
|
id,
|
|
}),
|
|
fragment,
|
|
fragmentName,
|
|
});
|
|
}
|
|
|
|
static getDownloadStatusFromCache<T = DownloadTypeFieldsFragment>(
|
|
id: number,
|
|
fragment: DocumentNode = DOWNLOAD_TYPE_FIELDS,
|
|
fragmentName: string = 'DOWNLOAD_TYPE_FIELDS',
|
|
): Unmasked<T> | null {
|
|
return requestManager.graphQLClient.client.cache.readFragment<T>({
|
|
id: requestManager.graphQLClient.client.cache.identify({
|
|
__typename: 'DownloadType',
|
|
chapter: {
|
|
__ref: requestManager.graphQLClient.client.cache.identify({ __typename: 'ChapterType', id }),
|
|
},
|
|
}),
|
|
fragment,
|
|
fragmentName,
|
|
});
|
|
}
|
|
|
|
static useDownloadStatusFromCache<T = DownloadTypeFieldsFragment>(
|
|
id: number,
|
|
fragment: DocumentNode = DOWNLOAD_TYPE_FIELDS,
|
|
fragmentName: string = 'DOWNLOAD_TYPE_FIELDS',
|
|
): MaybeMasked<T> | null {
|
|
const downloadStatus = useFragment<T>({
|
|
from: {
|
|
__typename: 'DownloadType',
|
|
chapter: {
|
|
__ref: requestManager.graphQLClient.client.cache.identify({ __typename: 'ChapterType', id }),
|
|
},
|
|
},
|
|
fragment,
|
|
fragmentName,
|
|
client: requestManager.graphQLClient.client,
|
|
});
|
|
|
|
if (!downloadStatus.complete || !Object.keys(downloadStatus.data ?? {}).length) {
|
|
return null;
|
|
}
|
|
|
|
return downloadStatus.data;
|
|
}
|
|
|
|
static getReaderUrl<Chapter extends ChapterMangaInfo & ChapterSourceOrderInfo>(chapter: Chapter): string {
|
|
return AppRoutes.reader.path(chapter.mangaId, chapter.sourceOrder);
|
|
}
|
|
|
|
static isDownloading(id: number): boolean {
|
|
const activeDownloadStates = [DownloadState.Downloading, DownloadState.Queued];
|
|
const downloadStatus = Chapters.getDownloadStatusFromCache(id);
|
|
|
|
return activeDownloadStates.includes(downloadStatus?.state as DownloadState);
|
|
}
|
|
|
|
static isDownloaded({ isDownloaded }: ChapterDownloadInfo): boolean {
|
|
return isDownloaded;
|
|
}
|
|
|
|
static getDownloaded<Chapter extends ChapterDownloadInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter(Chapters.isDownloaded);
|
|
}
|
|
|
|
static isDownloadable<Chapter extends ChapterDownloadInfo>(chapter: Chapter): boolean {
|
|
const downloadStatus = Chapters.getDownloadStatusFromCache(chapter.id);
|
|
return !Chapters.isDownloaded(chapter) && (!downloadStatus || downloadStatus.state === DownloadState.Error);
|
|
}
|
|
|
|
static getDownloadable<Chapter extends ChapterDownloadInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter(this.isDownloadable);
|
|
}
|
|
|
|
static isDeletable(
|
|
{ isBookmarked, ...chapter }: ChapterDownloadInfo & ChapterBookmarkInfo,
|
|
canDeleteBookmarked: boolean = false,
|
|
): boolean {
|
|
return Chapters.isDownloaded(chapter) && (!isBookmarked || canDeleteBookmarked);
|
|
}
|
|
|
|
static getDeletable<Chapters extends ChapterDownloadInfo & ChapterBookmarkInfo>(
|
|
chapters: Chapters[],
|
|
canDeleteBookmarked?: boolean,
|
|
): Chapters[] {
|
|
return chapters.filter((chapter) => Chapters.isDeletable(chapter, canDeleteBookmarked));
|
|
}
|
|
|
|
static isBookmarked({ isBookmarked }: ChapterBookmarkInfo): boolean {
|
|
return isBookmarked;
|
|
}
|
|
|
|
static getBookmarked<Chapter extends ChapterBookmarkInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter(Chapters.isBookmarked);
|
|
}
|
|
|
|
static getNonBookmarked<Chapter extends ChapterBookmarkInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter((chapter) => !Chapters.isBookmarked(chapter));
|
|
}
|
|
|
|
static isRead({ isRead }: ChapterReadInfo): boolean {
|
|
return isRead;
|
|
}
|
|
|
|
static getRead<Chapter extends ChapterReadInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter(Chapters.isRead);
|
|
}
|
|
|
|
static getNonRead<Chapter extends ChapterReadInfo>(chapters: Chapter[]): Chapter[] {
|
|
return chapters.filter((chapter) => !Chapters.isRead(chapter));
|
|
}
|
|
|
|
static getMatchingChapterNumberChapters<Chapter extends ChapterNumberInfo>(
|
|
chaptersA: Chapter[],
|
|
chaptersB: Chapter[],
|
|
): [ChapterA: Chapter, ChapterB: Chapter][] {
|
|
return chaptersA
|
|
.map((chapterA) => {
|
|
const matchingChapter = chaptersB.find((chapterB) => chapterA.chapterNumber === chapterB.chapterNumber);
|
|
|
|
if (!matchingChapter) {
|
|
return null;
|
|
}
|
|
|
|
return [chapterA, matchingChapter];
|
|
})
|
|
.filter((matchingChapters): matchingChapters is [Chapter, Chapter] => matchingChapters !== null);
|
|
}
|
|
|
|
static async download(chapterIds: number[]): Promise<void> {
|
|
return Chapters.executeAction(
|
|
'download',
|
|
chapterIds.length,
|
|
() => requestManager.addChaptersToDownloadQueue(chapterIds).response,
|
|
);
|
|
}
|
|
|
|
static async delete(chapterIds: number[]): Promise<void> {
|
|
return Chapters.executeAction(
|
|
'delete',
|
|
chapterIds.length,
|
|
() => requestManager.deleteDownloadedChapters(chapterIds).response,
|
|
);
|
|
}
|
|
|
|
static async markAsRead(
|
|
chapters: (ChapterDownloadInfo & ChapterBookmarkInfo)[],
|
|
wasManuallyMarkedAsRead: boolean = false,
|
|
trackProgressMangaId?: MangaIdInfo['id'],
|
|
): Promise<void> {
|
|
const { deleteChaptersManuallyMarkedRead, deleteChaptersWithBookmark, updateProgressManualMarkRead } =
|
|
await getMetadataServerSettings();
|
|
const chapterIdsToDelete =
|
|
deleteChaptersManuallyMarkedRead && wasManuallyMarkedAsRead
|
|
? Chapters.getIds(Chapters.getDeletable(chapters, deleteChaptersWithBookmark))
|
|
: [];
|
|
return Chapters.executeAction(
|
|
'mark_as_read',
|
|
chapters.length,
|
|
() =>
|
|
requestManager.updateChapters(Chapters.getIds(chapters), {
|
|
isRead: true,
|
|
lastPageRead: 0,
|
|
chapterIdsToDelete,
|
|
trackProgressMangaId:
|
|
updateProgressManualMarkRead && wasManuallyMarkedAsRead ? trackProgressMangaId : undefined,
|
|
}).response,
|
|
);
|
|
}
|
|
|
|
static async markAsUnread(chapterIds: number[]): Promise<void> {
|
|
return Chapters.executeAction(
|
|
'mark_as_unread',
|
|
chapterIds.length,
|
|
() => requestManager.updateChapters(chapterIds, { isRead: false }).response,
|
|
);
|
|
}
|
|
|
|
static async bookmark(chapterIds: number[]): Promise<void> {
|
|
return Chapters.executeAction(
|
|
'bookmark',
|
|
chapterIds.length,
|
|
() => requestManager.updateChapters(chapterIds, { isBookmarked: true }).response,
|
|
);
|
|
}
|
|
|
|
static async unBookmark(chapterIds: number[]): Promise<void> {
|
|
return Chapters.executeAction(
|
|
'unbookmark',
|
|
chapterIds.length,
|
|
() => requestManager.updateChapters(chapterIds, { isBookmarked: false }).response,
|
|
);
|
|
}
|
|
|
|
private static async executeAction(
|
|
action: ChapterAction,
|
|
itemCount: number,
|
|
fnToExecute: () => Promise<unknown>,
|
|
): Promise<void> {
|
|
try {
|
|
await fnToExecute();
|
|
makeToast(translate(CHAPTER_ACTION_TO_TRANSLATION[action].success, { count: itemCount }), 'success');
|
|
} catch (e) {
|
|
makeToast(
|
|
translate(CHAPTER_ACTION_TO_TRANSLATION[action].error, { count: itemCount }),
|
|
'error',
|
|
getErrorMessage(e),
|
|
);
|
|
throw e;
|
|
}
|
|
}
|
|
|
|
static async performAction<Action extends ChapterAction>(
|
|
action: Action,
|
|
chapterIds: number[],
|
|
{
|
|
wasManuallyMarkedAsRead,
|
|
trackProgressMangaId,
|
|
chapters,
|
|
}: Action extends 'mark_as_read'
|
|
? {
|
|
wasManuallyMarkedAsRead: boolean;
|
|
trackProgressMangaId?: MangaIdInfo['id'];
|
|
chapters: (ChapterDownloadInfo & ChapterBookmarkInfo & ChapterReadInfo)[];
|
|
}
|
|
: {
|
|
wasManuallyMarkedAsRead?: never;
|
|
trackProgressMangaId?: never;
|
|
chapters?: never;
|
|
},
|
|
): Promise<void> {
|
|
switch (action) {
|
|
case 'download':
|
|
return Chapters.download(chapterIds);
|
|
case 'delete':
|
|
return Chapters.delete(chapterIds);
|
|
case 'mark_as_read':
|
|
return Chapters.markAsRead(chapters!, wasManuallyMarkedAsRead!, trackProgressMangaId);
|
|
case 'mark_as_unread':
|
|
return Chapters.markAsUnread(chapterIds);
|
|
case 'bookmark':
|
|
return Chapters.bookmark(chapterIds);
|
|
case 'unbookmark':
|
|
return Chapters.unBookmark(chapterIds);
|
|
default:
|
|
throw new Error(`Chapters::performAction: unknown action "${action}"`);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the provided "uniqueChapters" plus their duplicates found in "allChapters"
|
|
*/
|
|
static addDuplicates<T extends ChapterScanlatorInfo & ChapterNumberInfo>(
|
|
uniqueChapters: T[],
|
|
allChapters: T[],
|
|
): T[] {
|
|
const chapterNumberToChapters = Object.groupBy(allChapters, ({ chapterNumber }) => chapterNumber);
|
|
|
|
return uniqueChapters
|
|
.map((uniqueChapter) => chapterNumberToChapters[uniqueChapter.chapterNumber] ?? [uniqueChapter])
|
|
.flat();
|
|
}
|
|
|
|
static removeDuplicates<T extends ChapterScanlatorInfo & ChapterNumberInfo>(currentChapter: T, chapters: T[]): T[] {
|
|
const chapterNumberToChapters = Object.groupBy(chapters, ({ chapterNumber }) => chapterNumber);
|
|
|
|
const uniqueChapters = Object.values(chapterNumberToChapters).map(
|
|
(groupedChapters) =>
|
|
// the result of groupBy can't result in undefined values
|
|
groupedChapters!.find((chapter) => chapter.id === currentChapter.id) ??
|
|
groupedChapters!.findLast((chapter) => chapter.scanlator === currentChapter.scanlator) ??
|
|
groupedChapters!.slice(-1)[0],
|
|
);
|
|
|
|
// keep the chapters in the same order as they were passed
|
|
return chapters
|
|
.map(({ id }) => uniqueChapters.find((chapter) => chapter.id === id))
|
|
.filter((chapter): chapter is T => !!chapter);
|
|
}
|
|
|
|
static getNextChapter<Chapter extends ChapterScanlatorInfo & ChapterNumberInfo & ChapterReadInfo>(
|
|
currentChapter: Chapter,
|
|
chapters: Chapter[],
|
|
{
|
|
offset = DirectionOffset.NEXT,
|
|
...options
|
|
}: { offset?: DirectionOffset; onlyUnread?: boolean; skipDupe?: boolean; skipDupeChapter?: Chapter } = {},
|
|
): Chapter | undefined {
|
|
const nextChapters = Chapters.getNextChapters(currentChapter, chapters, { offset, ...options });
|
|
|
|
const isNextChapterOffset = offset === DirectionOffset.NEXT;
|
|
const sliceStartIndex = isNextChapterOffset ? -1 : 0;
|
|
const sliceEndIndex = isNextChapterOffset ? undefined : 1;
|
|
|
|
return nextChapters.slice(sliceStartIndex, sliceEndIndex)[0];
|
|
}
|
|
|
|
static getNextChapters<Chapter extends ChapterScanlatorInfo & ChapterNumberInfo & ChapterReadInfo>(
|
|
fromChapter: Chapter,
|
|
chapters: Chapter[],
|
|
{
|
|
offset = DirectionOffset.NEXT,
|
|
onlyUnread = false,
|
|
skipDupe = false,
|
|
skipDupeChapter = fromChapter,
|
|
}: { offset?: DirectionOffset; onlyUnread?: boolean; skipDupe?: boolean; skipDupeChapter?: Chapter } = {},
|
|
): Chapter[] {
|
|
const fromChapterIndex = chapters.findIndex((chapter) => chapter.id === fromChapter.id);
|
|
|
|
const isNextChapterOffset = offset === DirectionOffset.NEXT;
|
|
const sliceStartIndex = isNextChapterOffset ? 0 : fromChapterIndex;
|
|
const sliceEndIndex = isNextChapterOffset ? fromChapterIndex + 1 : undefined;
|
|
|
|
const nextChaptersIncludingCurrent = chapters.slice(sliceStartIndex, sliceEndIndex);
|
|
const uniqueNextChapters = skipDupe
|
|
? Chapters.removeDuplicates(skipDupeChapter, nextChaptersIncludingCurrent)
|
|
: nextChaptersIncludingCurrent;
|
|
const nextChapters = uniqueNextChapters.toSpliced(isNextChapterOffset ? -1 : 0, 1);
|
|
|
|
return onlyUnread ? Chapters.getNonRead(nextChapters) : nextChapters;
|
|
}
|
|
|
|
static getReaderResumeMode(chapter: ChapterReadInfo): ReaderResumeMode {
|
|
if (chapter.isRead) {
|
|
return ReaderResumeMode.START;
|
|
}
|
|
|
|
return ReaderResumeMode.LAST_READ;
|
|
}
|
|
|
|
static getReaderOpenChapterLocationState(
|
|
chapter: ChapterReadInfo,
|
|
updateInitialChapter?: boolean,
|
|
): ReaderOpenChapterLocationState {
|
|
return {
|
|
resumeMode: Chapters.getReaderResumeMode(chapter),
|
|
updateInitialChapter,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Returns the chapters grouped by the passed key representing a timestamp.
|
|
*
|
|
* The timestamp gets mapped to a string via {@link getDateString}
|
|
*/
|
|
static groupByDate<
|
|
T extends Pick<ChapterType, 'lastReadAt'> | Pick<ChapterType, 'fetchedAt'> | Pick<ChapterType, 'uploadDate'>,
|
|
K extends keyof ExtractCommon<OmitNotMatching<ChapterType, 'lastReadAt' | 'fetchedAt' | 'uploadDate'>, T>,
|
|
>(chapters: T[], key: K): Record<string, T[]> {
|
|
return Object.groupBy(chapters, (chapter) => getDateString(epochToDate(Number(chapter[key])))) as Record<
|
|
string,
|
|
T[]
|
|
>;
|
|
}
|
|
}
|