social.coves.community.comment

coves.social

Documentation

A comment on a post or another comment. Comments live in user repositories and support nested threading.

main record

A comment on a post or another comment. Comments live in user repositories and support nested threading.

Record Key tid Timestamp-based ID

Properties

bridgedStats ref #bridgedStats Optional

Bridge-asserted aggregate of origin-platform votes for federated/bridged content. Set by the bridge that materialized this record; absent for natively-authored comments.

content string Required

Comment text content

maxLength: 100000 bytesmaxGraphemes: 10000 graphemes
createdAt string datetime Required

Timestamp of comment creation

facets array of ref social.coves.richtext.facet Optional

Annotations for rich text (mentions, links, formatting, block structure)

maxLength: 200 items
langs array of string language Optional

Languages used in the comment content (ISO 639-1)

maxLength: 3 items
reply ref #replyRef Required

Reference to the post and parent being replied to

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "reply",
      "content",
      "createdAt"
    ],
    "properties": {
      "embed": {
        "refs": [
          "social.coves.embed.images",
          "social.coves.embed.post"
        ],
        "type": "union",
        "description": "Embedded media or quoted posts"
      },
      "langs": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "language"
        },
        "maxLength": 3,
        "description": "Languages used in the comment content (ISO 639-1)"
      },
      "reply": {
        "ref": "#replyRef",
        "type": "ref",
        "description": "Reference to the post and parent being replied to"
      },
      "facets": {
        "type": "array",
        "items": {
          "ref": "social.coves.richtext.facet",
          "type": "ref"
        },
        "maxLength": 200,
        "description": "Annotations for rich text (mentions, links, formatting, block structure)"
      },
      "labels": {
        "ref": "com.atproto.label.defs#selfLabels",
        "type": "ref",
        "description": "Self-applied content labels"
      },
      "content": {
        "type": "string",
        "maxLength": 100000,
        "description": "Comment text content",
        "maxGraphemes": 10000
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp of comment creation"
      },
      "bridgedStats": {
        "ref": "#bridgedStats",
        "type": "ref",
        "description": "Bridge-asserted aggregate of origin-platform votes for federated/bridged content. Set by the bridge that materialized this record; absent for natively-authored comments."
      }
    }
  },
  "description": "A comment on a post or another comment. Comments live in user repositories and support nested threading."
}
bridgedStats object

Aggregate vote counts asserted by the bridge for content federated from an origin platform (e.g. Lemmy). These supplement, and are kept separate from, native atproto votes.

Properties

asOf string datetime Required

Timestamp the origin-platform counts were sampled; used to discard stale updates

downvotes integer Required

Number of downvotes on the origin platform as of asOf

minimum: 0
upvotes integer Required

Number of upvotes on the origin platform as of asOf

minimum: 0
View raw schema 
{
  "type": "object",
  "required": [
    "upvotes",
    "downvotes",
    "asOf"
  ],
  "properties": {
    "asOf": {
      "type": "string",
      "format": "datetime",
      "description": "Timestamp the origin-platform counts were sampled; used to discard stale updates"
    },
    "upvotes": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of upvotes on the origin platform as of asOf"
    },
    "downvotes": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of downvotes on the origin platform as of asOf"
    }
  },
  "description": "Aggregate vote counts asserted by the bridge for content federated from an origin platform (e.g. Lemmy). These supplement, and are kept separate from, native atproto votes."
}
replyRef object

References for maintaining thread structure. Root always points to the original post, parent points to the immediate parent (post or comment).

Properties

View raw schema 
{
  "type": "object",
  "required": [
    "root",
    "parent"
  ],
  "properties": {
    "root": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref",
      "description": "Strong reference to the original post that started the thread"
    },
    "parent": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref",
      "description": "Strong reference to the immediate parent (post or comment) being replied to"
    }
  },
  "description": "References for maintaining thread structure. Root always points to the original post, parent points to the immediate parent (post or comment)."
}

Lexicon Garden

@