readest

Files

T

Huang Xin 35b02c4efc feat(statistics): KOReader-compatible reading stats with cross-device sync (#4606 )

Supersedes #3156. Adds a reading-statistics system whose canonical data model
is KOReader's own (book + page_stat_data), so stats round-trip losslessly
between Readest and KOReader.

- Storage: a cross-platform Turso statistics.db in KOReader's exact schema
  (web/Workers, desktop, iOS, Android) — replacing #3156's Node-only
  better-sqlite3 + statistics.json.
- Tracking: per-page reading events (time-on-page, idle-capped) flushed on
  page-change/idle/hide/close — the KOReader model — not session aggregates.
- Sync: legacy /api/sync extended with a stats type backed by self-contained
  Supabase tables (stat_books, stat_pages); union/longer-duration-wins merge
  keyed on book_hash. apps/readest.koplugin syncs through the same endpoint.
- Scale & robustness: per-tab singleton connection (avoids OPFS lock
  conflicts) + explicit WAL checkpoint; transactional bulk apply; chunked
  resumable push; client-driven paged pull with trailing-ms completion;
  paginated/scoped server merge.

Verified: 5668 unit tests, 155 koplugin busted tests, biome+tsgo + luacheck
all green; web OPFS DB verified live.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-16 10:42:39 +02:00

docs

feat(koplugin): Readest Library view in KOReader (#4056 )

2026-05-04 23:12:34 +02:00

icons

feat(koplugin): Readest Library view in KOReader (#4056 )

2026-05-04 23:12:34 +02:00

library

fix(koplugin): upload local book cover so synced books show a cover (#4374 ) (#4385 )

2026-05-31 17:36:23 +02:00

locales

feat(statistics): KOReader-compatible reading stats with cross-device sync (#4606 )