Add BookDate card stack animations and thumbnail caching

Implements pure CSS card stack animations for BookDate recommendations, including smooth exit and advance transitions. Adds local caching of library cover thumbnails during scans, updates database schema and API to serve cached covers, and enhances BookDate to support 'favorites' scope with a book picker modal. Updates admin settings validation logic for Prowlarr, improves indexer state management, and documents new features and backend changes.
This commit is contained in:
kikootwo
2026-01-20 17:28:27 -05:00
parent 2d9ed5c76a
commit ac2ad8aac2
33 changed files with 2371 additions and 707 deletions
@@ -122,4 +122,200 @@ describe('ThumbnailCacheService', () => {
expect(service.getCacheDirectory()).toBe('/app/cache/thumbnails');
});
describe('Library Thumbnail Caching', () => {
it('returns null when missing required parameters', async () => {
const service = new ThumbnailCacheService();
expect(await service.cacheLibraryThumbnail('', 'url', 'http://server', 'token', 'plex')).toBeNull();
expect(await service.cacheLibraryThumbnail('guid', '', 'http://server', 'token', 'plex')).toBeNull();
expect(await service.cacheLibraryThumbnail('guid', 'url', '', 'token', 'plex')).toBeNull();
expect(await service.cacheLibraryThumbnail('guid', 'url', 'http://server', '', 'plex')).toBeNull();
});
it('returns cached path when library cover already exists', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockResolvedValue(undefined);
const service = new ThumbnailCacheService();
const result = await service.cacheLibraryThumbnail(
'plex://guid/123',
'/library/metadata/456/thumb',
'http://plex:32400',
'token123',
'plex'
);
expect(result).toContain(path.join('app', 'cache', 'library'));
expect(result).toMatch(/[a-f0-9]{16}\.jpg$/);
expect(axiosMock.get).not.toHaveBeenCalled();
});
it('downloads library cover for Plex backend with token in URL', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockRejectedValue(new Error('missing'));
axiosMock.get.mockResolvedValue({
headers: { 'content-type': 'image/jpeg' },
data: Buffer.from([1, 2, 3]),
});
fsMock.writeFile.mockResolvedValue(undefined);
const service = new ThumbnailCacheService();
const result = await service.cacheLibraryThumbnail(
'plex://guid/789',
'/library/metadata/123/thumb/456.jpg',
'http://plex:32400',
'plextoken',
'plex'
);
expect(result).toContain(path.join('app', 'cache', 'library'));
expect(result).toMatch(/[a-f0-9]{16}\.jpg$/);
expect(axiosMock.get).toHaveBeenCalledWith(
'http://plex:32400/library/metadata/123/thumb/456.jpg?X-Plex-Token=plextoken',
expect.objectContaining({
responseType: 'arraybuffer',
timeout: 10000,
})
);
expect(fsMock.writeFile).toHaveBeenCalled();
});
it('downloads library cover for Audiobookshelf backend with auth header', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockRejectedValue(new Error('missing'));
axiosMock.get.mockResolvedValue({
headers: { 'content-type': 'image/png' },
data: Buffer.from([4, 5, 6]),
});
fsMock.writeFile.mockResolvedValue(undefined);
const service = new ThumbnailCacheService();
const result = await service.cacheLibraryThumbnail(
'abs-item-456',
'/api/items/abs-item-456/cover',
'http://abs:13378',
'abstoken',
'audiobookshelf'
);
// URL has no extension, so defaults to .jpg
expect(result).toContain(path.join('app', 'cache', 'library'));
expect(result).toMatch(/[a-f0-9]{16}\.jpg$/);
expect(axiosMock.get).toHaveBeenCalledWith(
'http://abs:13378/api/items/abs-item-456/cover',
expect.objectContaining({
headers: expect.objectContaining({
Authorization: 'Bearer abstoken',
}),
})
);
expect(fsMock.writeFile).toHaveBeenCalled();
});
it('rejects non-image content types for library covers', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockRejectedValue(new Error('missing'));
axiosMock.get.mockResolvedValue({
headers: { 'content-type': 'text/html' },
data: Buffer.from('error page'),
});
const service = new ThumbnailCacheService();
const result = await service.cacheLibraryThumbnail(
'guid',
'/cover',
'http://server',
'token',
'plex'
);
expect(result).toBeNull();
expect(fsMock.writeFile).not.toHaveBeenCalled();
});
it('generates consistent SHA-256 hash filenames for same plexGuid', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockResolvedValue(undefined);
const service = new ThumbnailCacheService();
const result1 = await service.cacheLibraryThumbnail(
'plex://guid/123',
'/thumb.jpg',
'http://server',
'token',
'plex'
);
const result2 = await service.cacheLibraryThumbnail(
'plex://guid/123',
'/thumb.jpg',
'http://server',
'token',
'plex'
);
expect(result1).toBe(result2);
const filename = path.basename(result1 || '');
expect(filename).toMatch(/^[a-f0-9]{16}\.jpg$/);
});
it('cleans up orphaned library thumbnails', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
const service = new ThumbnailCacheService();
// First, cache some files to get their actual hash filenames
fsMock.access.mockRejectedValue(new Error('not found'));
axiosMock.get.mockResolvedValue({
headers: { 'content-type': 'image/jpeg' },
data: Buffer.from([1, 2, 3]),
});
fsMock.writeFile.mockResolvedValue(undefined);
const path1 = await service.cacheLibraryThumbnail('guid-1', '/cover.jpg', 'http://server', 'token', 'plex');
const path2 = await service.cacheLibraryThumbnail('guid-2', '/cover.jpg', 'http://server', 'token', 'plex');
const filename1 = path.basename(path1 || '');
const filename2 = path.basename(path2 || '');
// Now set up the cleanup test with actual filenames
fsMock.readdir.mockResolvedValue([
filename1, // Will be kept
'orphaned123456ab.png', // Will be deleted
filename2, // Will be kept
]);
fsMock.unlink.mockResolvedValue(undefined);
const plexGuidMap = new Map([
['guid-1', 'any-value'],
['guid-2', 'any-value'],
]);
const deleted = await service.cleanupLibraryThumbnails(plexGuidMap);
expect(deleted).toBe(1);
expect(fsMock.unlink).toHaveBeenCalledTimes(1);
expect(fsMock.unlink).toHaveBeenCalledWith(
expect.stringContaining('orphaned123456ab.png')
);
});
it('handles errors gracefully when caching library thumbnails', async () => {
fsMock.mkdir.mockResolvedValue(undefined);
fsMock.access.mockRejectedValue(new Error('missing'));
axiosMock.get.mockRejectedValue(new Error('Network error'));
const service = new ThumbnailCacheService();
const result = await service.cacheLibraryThumbnail(
'guid',
'/cover',
'http://server',
'token',
'plex'
);
expect(result).toBeNull();
expect(fsMock.writeFile).not.toHaveBeenCalled();
});
});
});