Lexicons

{
  "lexicon": 1,
  "id": "app.standard-reader.labeler.defs",
  "defs": {
    "labelerPolicies": {
      "type": "object",
      "required": [
        "labelValues"
      ],
      "properties": {
        "labelValues": {
          "type": "array",
          "items": {
            "type": "ref",
            "ref": "com.atproto.label.defs#labelValue"
          },
          "description": "The label values which this labeler publishes. May include global or custom (labeler-defined) values."
        },
        "labelValueDefinitions": {
          "type": "array",
          "items": {
            "type": "ref",
            "ref": "com.atproto.label.defs#labelValueDefinition"
          },
          "description": "Label values created by this labeler and scoped exclusively to it. Each value provides its own meaning and behaviors."
        }
      }
    },
    "labelerView": {
      "type": "object",
      "required": [
        "did"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did"
        },
        "displayName": {
          "type": "string",
          "maxGraphemes": 64,
          "maxLength": 640
        },
        "description": {
          "type": "string",
          "maxGraphemes": 300,
          "maxLength": 3000
        },
        "avatar": {
          "type": "string",
          "format": "uri"
        },
        "policies": {
          "type": "ref",
          "ref": "#labelerPolicies"
        },
        "indexedAt": {
          "type": "string",
          "format": "datetime"
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.collection",
  "defs": {
    "main": {
      "type": "record",
      "description": "Curated magazine collection manifest for a site.standard.document. Uses the same record key as the document it extends so both records can be fetched with one predictable pair of GETs.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "document",
          "items",
          "createdAt"
        ],
        "properties": {
          "document": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.document record this collection renders."
          },
          "editorial": {
            "type": "ref",
            "ref": "app.standard-reader.collection#editorial"
          },
          "colophon": {
            "type": "ref",
            "ref": "app.standard-reader.collection#colophon"
          },
          "items": {
            "type": "array",
            "maxLength": 42,
            "items": {
              "type": "ref",
              "ref": "app.standard-reader.collection#item"
            },
            "description": "Ordered curated articles plus optional per-item notes."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the collection manifest was first published."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the collection manifest was last edited."
          }
        }
      }
    },
    "editorial": {
      "type": "object",
      "description": "Optional editorial intro shown ahead of the curated pieces.",
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 160
        },
        "body": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Editorial body as Markpub markdown (legacy plain string accepted on read during migration)."
        }
      }
    },
    "colophon": {
      "type": "object",
      "description": "Optional closing credits on the magazine end spread.",
      "properties": {
        "body": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Colophon body as Markpub markdown (legacy plain string accepted on read during migration)."
        }
      }
    },
    "item": {
      "type": "object",
      "required": [
        "document"
      ],
      "properties": {
        "document": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of an included site.standard.document."
        },
        "note": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Optional Markpub markdown note shown ahead of the piece (legacy plain string accepted on read during migration)."
        }
      }
    },
    "documentLink": {
      "type": "object",
      "required": [
        "uri"
      ],
      "description": "Inverse link entry for site.standard.document#links pointing back at this collection sidecar.",
      "properties": {
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of the app.standard-reader.collection sidecar record."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.collectionsPublication",
  "defs": {
    "main": {
      "type": "record",
      "description": "Marks a site.standard.publication as a Standard Reader collections series. Uses the same record key as the publication it marks.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "publication",
          "createdAt"
        ],
        "properties": {
          "publication": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.publication record used to publish collections."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this publication was marked as a collections series."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.graph.follow",
  "defs": {
    "main": {
      "type": "record",
      "description": "Follows another user (a DID, not a publication). Presence of the record means followed; deleting it unfollows. The rkey is derived from the subject DID so each followed user maps to a single record. A followed user's recommends and documents enrich the reader's home feed.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "createdAt"
        ],
        "properties": {
          "subject": {
            "type": "string",
            "format": "did",
            "description": "DID of the user being followed."
          },
          "excludedPublications": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Publications owned by the followed user that the reader has explicitly opted out of (following a user subscribes to all their publications except these). AT URIs of site.standard.publication records."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader followed the user."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.labeler.service",
  "defs": {
    "main": {
      "type": "record",
      "description": "Registers a Standard Reader labeler. This record is the single source of truth for a labeler: its identity, where to reach its label server, how it presents, and its label-value definitions. Indexed off the network like any other record (the owner of the record is the labeler's author); the label server itself only answers com.atproto.label.queryLabels / subscribeLabels.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": [
          "did",
          "serviceEndpoint",
          "createdAt"
        ],
        "properties": {
          "did": {
            "type": "string",
            "format": "did",
            "description": "DID of the labeler — the `src` on its labels (and whose key signs them)."
          },
          "serviceEndpoint": {
            "type": "string",
            "format": "uri",
            "description": "Origin serving this labeler's com.atproto.label.queryLabels / subscribeLabels."
          },
          "displayName": {
            "type": "string",
            "maxGraphemes": 64,
            "maxLength": 640
          },
          "description": {
            "type": "string",
            "maxGraphemes": 300,
            "maxLength": 3000
          },
          "avatar": {
            "type": "blob",
            "accept": [
              "image/png",
              "image/jpeg",
              "image/svg+xml"
            ],
            "maxSize": 1000000
          },
          "policies": {
            "type": "ref",
            "ref": "app.standard-reader.labeler.defs#labelerPolicies"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.labeler.subscription",
  "defs": {
    "main": {
      "type": "record",
      "description": "Subscribes the reader to a labeler service (like adding a Bluesky moderation service). Presence of the record means subscribed; deleting it unsubscribes. The rkey is derived from the labeler DID so each labeler maps to a single record. Successor to app.standard-reader.labelerSubscription, nested under the labeler NSID group.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "labeler",
          "createdAt"
        ],
        "properties": {
          "labeler": {
            "type": "string",
            "format": "did",
            "description": "DID of the labeler service being subscribed to."
          },
          "labels": {
            "type": "array",
            "description": "Per-label visibility overrides for this labeler's label values.",
            "items": {
              "type": "ref",
              "ref": "#labelPref"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader subscribed to the labeler."
          }
        }
      }
    },
    "labelPref": {
      "type": "object",
      "description": "How the reader wants a single label value from this labeler treated.",
      "required": [
        "val",
        "visibility"
      ],
      "properties": {
        "val": {
          "type": "string",
          "maxLength": 128,
          "description": "The label value this preference applies to."
        },
        "visibility": {
          "type": "string",
          "maxLength": 16,
          "knownValues": [
            "ignore",
            "warn",
            "hide"
          ],
          "description": "ignore = show normally; warn = content warning / blur; hide = filter out."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.labelerSubscription",
  "defs": {
    "main": {
      "type": "record",
      "description": "Subscribes the reader to a labeler service (like adding a Bluesky moderation service). Presence of the record means subscribed; deleting it unsubscribes. The rkey is derived from the labeler DID so each labeler maps to a single record.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "labeler",
          "createdAt"
        ],
        "properties": {
          "labeler": {
            "type": "string",
            "format": "did",
            "description": "DID of the labeler service being subscribed to."
          },
          "labels": {
            "type": "array",
            "description": "Per-label visibility overrides for this labeler's label values.",
            "items": {
              "type": "ref",
              "ref": "#labelPref"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader subscribed to the labeler."
          }
        }
      }
    },
    "labelPref": {
      "type": "object",
      "description": "How the reader wants a single label value from this labeler treated.",
      "required": [
        "val",
        "visibility"
      ],
      "properties": {
        "val": {
          "type": "string",
          "maxLength": 128,
          "description": "The label value this preference applies to."
        },
        "visibility": {
          "type": "string",
          "maxLength": 16,
          "knownValues": [
            "ignore",
            "warn",
            "hide"
          ],
          "description": "ignore = show normally; warn = content warning / blur; hide = filter out."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.list",
  "defs": {
    "main": {
      "type": "record",
      "description": "A named, ordered, shareable list of publications (like a Bluesky user list, but for site.standard.publication subscriptions). Lists are one level deep; a publication may appear in multiple lists.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": [
          "name",
          "publications",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 640,
            "maxGraphemes": 64,
            "description": "Display name of the list."
          },
          "description": {
            "type": "string",
            "maxLength": 3000,
            "maxGraphemes": 300,
            "description": "Optional description shown on the list's public page."
          },
          "publications": {
            "type": "array",
            "maxLength": 500,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Ordered AT URIs of the site.standard.publication records in this list."
          },
          "users": {
            "type": "array",
            "maxLength": 500,
            "items": {
              "type": "string",
              "format": "did"
            },
            "description": "Ordered DIDs of the users (authors) in this list. Optional; a list may hold publications, users, or both."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the list was created."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.listSave",
  "defs": {
    "main": {
      "type": "record",
      "description": "Saves another reader's app.standard-reader.list into this reader's app (like adding a Bluesky list). Presence of the record means saved; deleting it removes the list again.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "list",
          "createdAt"
        ],
        "properties": {
          "list": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the app.standard-reader.list record being saved."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the list was saved."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.publicationTheme",
  "defs": {
    "main": {
      "type": "record",
      "description": "Standard Reader typography for a collections publication. Uses the same record key as the publication. Colors remain on the publication's site.standard.theme.basic record.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "publication",
          "createdAt"
        ],
        "properties": {
          "publication": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.publication this theme applies to."
          },
          "fonts": {
            "type": "ref",
            "ref": "app.standard-reader.publicationTheme#fonts"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the theme record was first published."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the theme record was last edited."
          }
        }
      }
    },
    "fonts": {
      "type": "object",
      "description": "Google Font family names for collection title and body typography.",
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 60
        },
        "body": {
          "type": "string",
          "maxLength": 60
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.read",
  "defs": {
    "main": {
      "type": "record",
      "description": "Marks a site.standard.document as read by the reader. Presence of the record means read; deleting it marks the article unread again.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "createdAt"
        ],
        "properties": {
          "subject": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.document record that was read."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader opened / marked the article read."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.sidebarPref",
  "defs": {
    "main": {
      "type": "record",
      "description": "A reader's personal sidebar preferences: the display order of their subscription list groups and which groups are collapsed. A singleton record (rkey `self`).",
      "key": "literal:self",
      "record": {
        "type": "object",
        "required": [
          "updatedAt"
        ],
        "properties": {
          "listOrder": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Ordered AT URIs of the reader's list groups (own + saved) as shown top-to-bottom in the sidebar. Groups not present are appended in their default order."
          },
          "collapsed": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "AT URIs of the list groups the reader has collapsed in the sidebar."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When these preferences were last changed."
          }
        }
      }
    }
  }
}