At this level
org.passingreads · 2- org.passingreads.actor.defs defs Profile view of a user for API responses. Based on the actor.profile record but with resolved avatar URL.
- org.passingreads.actor.getAccountState query State the appview holds for the authenticated user alone, which their repository does not carry. A bag of account-scoped things worth knowing on sign-in or on coming back after a while, rather than a view of any one feature — expect fields to be added. Never cacheable.
- org.passingreads.actor.getProfile query Get profile of a user.
- org.passingreads.actor.listProfiles query List all profiles for static site generation.
- org.passingreads.actor.profile record Profile information describing the entity behind the PassingReads account.
- org.passingreads.book.checkin token Represents a book being moved to a location, without changing hands.
- org.passingreads.book.defs defs A confirmed book event for display purposes. Omits the `signatures` array and book reference since it's shown in context of a book.
- org.passingreads.book.drop token Represents a book being dropped at a location.
- org.passingreads.book.event record The status of a book has changed.
- org.passingreads.book.find token Represents a book being found at a location.
- org.passingreads.book.getBook query Get full details about a specific book.
- org.passingreads.book.getBooks query Get full details about multiple books in a single request.
- org.passingreads.book.getLibrary query Get books currently in a user's library.
- org.passingreads.book.getLocationBooks query Get books at a specific H3 location.
- org.passingreads.book.getLocationCounts query Get book counts grouped by H3 cell, for rendering the homepage map at varying zoom levels.
- org.passingreads.book.getPublicationBooks query List every dropped book copy that shares a publicationId. Unlike searchBooks this does not de-duplicate — the publication detail page wants every individual copy so the user can see exactly how many are out there and where.
- org.passingreads.book.getRegistrationHints query Resolve the community's best guess at which publication an unregistered book is, from registration hints. Returns the publicationId suggested by the most hinters, ties broken by the earliest hint, so the registration flow can pre-fill and skip the search step.
- org.passingreads.book.gift token Represents a book being handed to a named person, pending their acceptance.
- org.passingreads.book.giftAcceptance token Represents the named recipient of a gift taking the book.
- org.passingreads.book.group record A named collection of books in a user's library (e.g. 'For the school', 'Take to Spain').
- org.passingreads.book.listBookIds query List all book IDs and locations for static site generation.
- org.passingreads.book.listBookKeys query List the book private keys the authenticated user has stashed on the appview. Used by clients to populate the local key cache after sign-in on a new device.
- org.passingreads.book.listDroppedBooks query List all currently dropped books (books whose current state is 'org.passingreads.book.drop').
- org.passingreads.book.note record
- org.passingreads.book.registration record A book that has been registered on PassingReads
- org.passingreads.book.registrationHint record A hint for which publication this book is, so that registration is especiall.
- org.passingreads.book.rejectGift procedure Turn down a gift offered to the authenticated user, so it stops appearing in their account state. Deliberately appview-side only: nothing is written to the recipient's repository and the giver is never told, because a gift is an unsolicited message and being able to refuse one must not expose the refusal. The book never left the giver's hands, so refusing only hides the offer — there is nothing to hand back.
- org.passingreads.book.searchBooks query Search dropped books by free text against title, authors, and publicationId. Results are de-duplicated per (publicationId, currentLocation) — multiple copies of the same publication at the same location collapse to the most recently-active copy. Ordered by last_event_at desc.
- org.passingreads.book.stashBookKey procedure Stash a book's private key on the appview so the user can interact with the book (drop it, leave a note) from any device without re-scanning the QR. Stashed keys are wiped automatically when a drop event is ingested for that book.