mirror of
https://github.com/hectorqin/reader.git
synced 2026-11-13 14:31:11 +08:00
Kiro Agent
f15365d03c
Server: user_books gains reading_status. The shelf list computes each book's readingState — an explicit 在读/已读 mark wins, otherwise progress decides (>=99% 已读, started 在读), and 想读 gives way once reading starts — filters by ?status=, and PUT /api/v1/books/:id/reading-status sets or clears the mark. Client: chips 全部/在读/想读/已读 and 分组 (a series or a tag from the shelf's facets) above the toolbar, all kept in the URL; a state label on each cover; the ⋯ menu marks 想读/在读/已读, clears the mark, or takes the book off the shelf. Docs: API, UI and media user guide for this and the other V3.1 gaps.
45 lines
3.2 KiB
TypeScript
45 lines
3.2 KiB
TypeScript
import { test } from 'node:test';
|
|
import assert from 'node:assert/strict';
|
|
import { Db } from '../src/db/index.ts';
|
|
import { ShelfService } from '../src/services/shelf.ts';
|
|
|
|
/** 在读 / 想读 / 已读 on the shelf: marks win, otherwise progress decides; 想读 yields to reading. */
|
|
test('the shelf derives reading state from progress and marks, and filters by it', () => {
|
|
const db = new Db(':memory:'), shelf = new ShelfService(db);
|
|
try {
|
|
db.run("INSERT INTO users(id,username,password_hash,role,created_at,updated_at) VALUES('u','reader','x','member',0,0),('v','other','x','member',0,0)");
|
|
const books = ['new', 'started', 'done', 'wanted', 'wanted-started', 'marked-done', 'reread'];
|
|
books.forEach((id, index) => {
|
|
db.run(`INSERT INTO books(id,content_hash,format,title,author,created_at,updated_at) VALUES(?,?,'epub',?,'作者',1,?)`, id, 'h-' + id, id, index + 1);
|
|
db.run('INSERT INTO book_files(id,book_id,rel_path,size,mtime_ms,first_seen,last_seen) VALUES(?,?,?,100,1,1,1)', 'f-' + id, id, id + '.epub');
|
|
db.run('INSERT INTO user_books(user_id,book_id,added_at,hidden) VALUES(?,?,?,0)', 'u', id, index);
|
|
});
|
|
const progress = (book: string, percentage: number) => db.run(
|
|
"INSERT INTO reading_progress(user_id,book_id,locator,percentage,chapter_title,device,updated_at) VALUES('u',?,'',?,'','web',0)", book, percentage);
|
|
progress('started', 0.42); progress('done', 1); progress('wanted-started', 0.1); progress('reread', 1);
|
|
shelf.setReadingStatus('u', 'wanted', 'want');
|
|
shelf.setReadingStatus('u', 'wanted-started', 'want');
|
|
shelf.setReadingStatus('u', 'marked-done', 'finished');
|
|
// Reading a finished book again: an explicit 在读 beats the 100% progress.
|
|
shelf.setReadingStatus('u', 'reread', 'reading');
|
|
|
|
const states = Object.fromEntries(shelf.list('u', { pageSize: 50 }).items.map(book => [book.id, book.readingState]));
|
|
assert.deepEqual(states, { new: null, started: 'reading', done: 'finished', wanted: 'want', 'wanted-started': 'reading', 'marked-done': 'finished', reread: 'reading' });
|
|
const ids = (status: 'reading' | 'want' | 'finished') => shelf.list('u', { status, pageSize: 50, sort: 'title', order: 'asc' });
|
|
assert.deepEqual(ids('reading').items.map(book => book.id), ['reread', 'started', 'wanted-started']);
|
|
assert.equal(ids('reading').total, 3);
|
|
assert.deepEqual(ids('want').items.map(book => book.id), ['wanted']);
|
|
assert.deepEqual(ids('finished').items.map(book => book.id), ['done', 'marked-done']);
|
|
|
|
// Clearing a mark lets progress decide again; the library scope never carries a state.
|
|
shelf.setReadingStatus('u', 'reread', null);
|
|
assert.equal(shelf.list('u', { status: 'finished', pageSize: 50 }).total, 3);
|
|
assert.ok(shelf.list('u', { scope: 'library', pageSize: 50 }).items.every(book => !('readingState' in book)));
|
|
assert.ok(!('readingState' in shelf.get('u', 'done')));
|
|
|
|
assert.throws(() => shelf.setReadingStatus('v', 'done', 'want'), { statusCode: 404 }, 'not on that account\'s shelf');
|
|
assert.throws(() => shelf.setReadingStatus('u', 'done', 'paused' as never), { statusCode: 400 });
|
|
assert.throws(() => shelf.list('u', { status: 'paused' as never }), { statusCode: 400 });
|
|
} finally { db.close(); }
|
|
});
|