social.dracome.library.review

A review of one edition by an actor. Duplicate convention: the rkey is a TID minted once at first create and never changes. Several records may exist for one actor and edition (for example from out-of-band writers); consumers SHOULD treat the record with the greatest `updatedAt` (falling back to `createdAt`) as the winner and break ties by the lowest TID, ignoring the others. This is a convention, not an enforced contract: AppViews MUST tolerate a differing winner, and may see a record's catalogTarget change over time.

Repository @dracome.social did:plc:66dyrt2bmghwlmdteyizs5l3 namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritylibrary.dracome.social
Indexed

Record

record · key tid

Properties

catalogSnapshot

requiredref

Point-in-time catalog metadata for the reviewed work or edition, captured when this record was last written. Refreshed on every update.

catalogTarget

requiredref

The work and edition that this review is about. Mutable.

createdAt

requiredstring · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.

Optional attached images: an optional primary image plus up to 4 secondary images (5 total). Images are independently addable/removable.

language

string · language

Optional language code the review text is written in, if different from or more specific than the actor's default language.

rating

requiredinteger

Scale-relative rating value. Valid range depends on ratingScale: 1-5 for 1 (whole stars), 1-10 for 2 (half stars), 1-20 for 4 (quarter stars). Interpretation: stars = rating / ratingScale. Runtime validation MUST enforce per-scale limits.

  • minimum: 1
  • maximum: 20

ratingScale

requiredinteger

The rating granularity divisor used at write time: divide rating by this value to recover stars. 1 = whole stars, 2 = half stars, 4 = quarter stars. Reflects whichever scale was in effect the last time rating was written on this record.

  • enum: 1 | 2 | 4

reviewCopy

boolean

True when the posted review discloses that the actor received or owns a review copy of this work or edition.

text

string

Optional review text. When provided, must be non-empty after trimming.

  • maxLength: 40000
  • maxGraphemes: 10000

updatedAt

string · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A portable review with an embedded book reference.

  • What a member thought of something, with a rating from 1 to 10, in a content space (D99). Members respond by replying to it, so a review heads a thread. The author edits it, rating included, by rewriting it at the same key; it sorts by createdAt, so an edit keeps its place.

  • A user's review of a book. StrongRefs the catalog book and optionally the originating bookShelving. rkey: tid. Written by the OAuth client (livtet-service) via com.atproto.repo.putRecord.

  • A review for a piece of media

  • A long-form review of a catalog work, authored on a NeoDB instance.