ReadingBySeriesDto

Totals for one series, most-read first.

booksinteger<int64>required

Distinct books of the series read in the window.

booksFinishedinteger<int64>required

Read-throughs finished in the window. Can exceed books only when a book was genuinely re-read inside the window.

duration objectrequired

Reading time split by how it was arrived at.

Deliberately two numbers rather than one. Time from the compatibility surfaces is reconstructed from the gaps between their writes: it undercounts and cannot see reading done from a downloaded book at all. Presenting a combined figure is fine; hiding that part of it is an estimate is not.

inferredMsinteger<int64>required

Milliseconds reconstructed server-side. An underestimate.

Example: 900000

measuredMsinteger<int64>required

Milliseconds reported by a client that measured its own reading.

Example: 5400000

totalMsinteger<int64>required

Convenience sum of the two, so clients do not each reimplement it.

Example: 6300000

pagesReadinteger<int64>required

removedFromLibrarybooleanrequired

True on the single row that gathers reading whose book has since been deleted from the server. That time still counts towards every total, but which series it belonged to is no longer known. Its books and booksFinished are always 0: both count distinct books, and deleted books cannot be told apart.

seriesId(string | null)<uuid>nullable

Null on the removed-from-library row.

seriesNamestring | nullnullable

Null on the removed-from-library row.

Example: Berserk

sessionsinteger<int64>required

ReadingBySeriesDto

{
  "books": 0,
  "booksFinished": 0,
  "duration": {
    "inferredMs": 900000,
    "measuredMs": 5400000,
    "totalMs": 6300000
  },
  "pagesRead": 0,
  "removedFromLibrary": true,
  "seriesId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "seriesName": "Berserk",
  "sessions": 0
}