{
"id": "com.hectorsector.book.status",
"defs": {
"main": {
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"book",
"status",
"createdAt"
],
"properties": {
"book": {
"ref": "com.atproto.repo.strongRef",
"type": "ref",
"description": "Strong reference to the com.hectorsector.book.book anchor this status applies to."
},
"status": {
"type": "string",
"maxLength": 128,
"description": "The reading status being set. Open union — future status tokens may be added; consumers should handle unknown values gracefully.",
"knownValues": [
"com.hectorsector.book.status#wantToRead",
"com.hectorsector.book.status#reading",
"com.hectorsector.book.status#paused",
"com.hectorsector.book.status#didNotFinish",
"com.hectorsector.book.status#finished"
]
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "When the status change occurred. May differ from the record's server-side timestamp when backfilling history from imports (e.g. StoryGraph CSV)."
}
}
},
"description": "A reading status change event for a book. Records are append-only and timestamped — each status transition creates a new record rather than mutating an existing one. The current status of a book is derived by taking the most recent status record (by createdAt) referencing that book."
},
"paused": {
"type": "token",
"description": "The user has paused reading the book and hasn't yet decided if they will continue."
},
"reading": {
"type": "token",
"description": "The user is currently reading the book."
},
"finished": {
"type": "token",
"description": "The user has completed the book."
},
"wantToRead": {
"type": "token",
"description": "The user intends to read the book."
},
"didNotFinish": {
"type": "token",
"description": "The user has indicated they won't complete this book."
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1
}