commit 2140aa713440002488b50dbee7616ab20bca257d · bretton.dev/coves

+77 -55

internal/atproto/lexicon/social/coves/post/get.json

···

       4
        
         "defs": {

     

       5
        
           "main": {

     

       6
        
             "type": "query",

     

       7
       -
             "description": "Get a single post with all its details",

     

       8
        
             "parameters": {

     

       9
        
               "type": "params",

     

       10
       -
               "required": ["uri"],

     

       11
        
               "properties": {

     

       12
       -
                 "uri": {

     

       13
       -
                   "type": "string",

     

       14
       -
                   "format": "at-uri",

     

       15
       -
                   "description": "AT-URI of the post"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       16
        
                 }

     

       17
        
               }

     

       18
        
             },

     
···

       20
        
               "encoding": "application/json",

     

       21
        
               "schema": {

     

       22
        
                 "type": "object",

     

       23
       -
                 "required": ["post"],

     

       24
        
                 "properties": {

     

       25
       -
                   "post": {

     

       26
       -
                     "type": "ref",

     

       27
       -
                     "ref": "#postView"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       28
        
                   }

     

       29
        
                 }

     

       30
        
               }

     

       31
       -
             }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       32
        
           },

     

       33
        
           "postView": {

     

       34
        
             "type": "object",

     
···

       67
        
                   "ref": "social.coves.richtext.facet"

     

       68
        
                 }

     

       69
        
               },

     

       70
       -
               "images": {

     

       71
       -
                 "type": "array",

     

       72
       -
                 "items": {

     

       73
       -
                   "type": "ref",

     

       74
       -
                   "ref": "#imageView"

     

       75
       -
                 }

     

       76
       -
               },

     

       77
       -
               "video": {

     

       78
       -
                 "type": "ref",

     

       79
       -
                 "ref": "#videoView"

     

       80
       -
               },

     

       81
       -
               "external": {

     

       82
       -
                 "type": "ref",

     

       83
       -
                 "ref": "#externalView"

     

       84
        
               },

     

       85
        
               "language": {

     

       86
        
                 "type": "string",

     
···

       151
        
               }

     

       152
        
             }

     

       153
        
           },

     

       154
       -
           "imageView": {

     

       155
        
             "type": "object",

     

       156
       -
             "required": ["fullsize"],

     

       0
        
       
     

       157
        
             "properties": {

     

       158
       -
               "fullsize": {

     

       159
       -
                 "type": "string",

     

       160
       -
                 "format": "uri"

     

       161
       -
               },

     

       162
       -
               "thumb": {

     

       163
        
                 "type": "string",

     

       164
       -
                 "format": "uri"

     

       165
        
               },

     

       166
       -
               "alt": {

     

       167
       -
                 "type": "string"

     

       0
        
       
     

       168
        
               }

     

       169
        
             }

     

       170
        
           },

     

       171
       -
           "videoView": {

     

       172
        
             "type": "object",

     

       173
       -
             "required": ["url"],

     

       0
        
       
     

       174
        
             "properties": {

     

       175
       -
               "url": {

     

       176
        
                 "type": "string",

     

       177
       -
                 "format": "uri"

     

       178
        
               },

     

       179
       -
               "thumbnail": {

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       180
        
                 "type": "string",

     

       181
       -
                 "format": "uri"

     

       0
        
       
     

       182
        
               },

     

       183
       -
               "alt": {

     

       184
       -
                 "type": "string"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       185
        
               }

     

       186
        
             }

     

       187
        
           },

     

       188
       -
           "externalView": {

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       189
        
             "type": "object",

     

       190
       -
             "required": ["uri"],

     

       0
        
       
     

       191
        
             "properties": {

     

       192
       -
               "uri": {

     

       193
        
                 "type": "string",

     

       194
       -
                 "format": "uri"

     

       195
       -
               },

     

       196
       -
               "title": {

     

       197
       -
                 "type": "string"

     

       198
        
               },

     

       199
       -
               "description": {

     

       200
        
                 "type": "string"

     

       201
       -
               },

     

       202
       -
               "thumb": {

     

       203
       -
                 "type": "string",

     

       204
       -
                 "format": "uri"

     

       205
        
               }

     

       206
        
             }

     

       207
        
           },

···

       4
        
         "defs": {

     

       5
        
           "main": {

     

       6
        
             "type": "query",

     

       7
       +
             "description": "Get posts by AT-URI. Supports batch fetching for feed hydration. Returns posts in same order as input URIs.",

     

       8
        
             "parameters": {

     

       9
        
               "type": "params",

     

       10
       +
               "required": ["uris"],

     

       11
        
               "properties": {

     

       12
       +
                 "uris": {

     

       13
       +
                   "type": "array",

     

       14
       +
                   "description": "List of post AT-URIs to fetch (max 25)",

     

       15
       +
                   "items": {

     

       16
       +
                     "type": "string",

     

       17
       +
                     "format": "at-uri"

     

       18
       +
                   },

     

       19
       +
                   "maxLength": 25,

     

       20
       +
                   "minLength": 1

     

       21
        
                 }

     

       22
        
               }

     

       23
        
             },

     
···

       25
        
               "encoding": "application/json",

     

       26
        
               "schema": {

     

       27
        
                 "type": "object",

     

       28
       +
                 "required": ["posts"],

     

       29
        
                 "properties": {

     

       30
       +
                   "posts": {

     

       31
       +
                     "type": "array",

     

       32
       +
                     "description": "Array of post views. May include notFound/blocked entries for missing posts.",

     

       33
       +
                     "items": {

     

       34
       +
                       "type": "union",

     

       35
       +
                       "refs": ["#postView", "#notFoundPost", "#blockedPost"]

     

       36
       +
                     }

     

       37
        
                   }

     

       38
        
                 }

     

       39
        
               }

     

       40
       +
             },

     

       41
       +
             "errors": [

     

       42
       +
               {"name": "InvalidRequest", "description": "Invalid URI format or empty array"}

     

       43
       +
             ]

     

       44
        
           },

     

       45
        
           "postView": {

     

       46
        
             "type": "object",

     
···

       79
        
                   "ref": "social.coves.richtext.facet"

     

       80
        
                 }

     

       81
        
               },

     

       82
       +
               "embed": {

     

       83
       +
                 "type": "union",

     

       84
       +
                 "description": "Embedded content (images, video, link preview, or quoted post)",

     

       85
       +
                 "refs": [

     

       86
       +
                   "social.coves.embed.images#view",

     

       87
       +
                   "social.coves.embed.video#view",

     

       88
       +
                   "social.coves.embed.external#view",

     

       89
       +
                   "social.coves.embed.record#view",

     

       90
       +
                   "social.coves.embed.recordWithMedia#view"

     

       91
       +
                 ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       92
        
               },

     

       93
        
               "language": {

     

       94
        
                 "type": "string",

     
···

       159
        
               }

     

       160
        
             }

     

       161
        
           },

     

       162
       +
           "notFoundPost": {

     

       163
        
             "type": "object",

     

       164
       +
             "description": "Post was not found (deleted, never indexed, or invalid URI)",

     

       165
       +
             "required": ["uri", "notFound"],

     

       166
        
             "properties": {

     

       167
       +
               "uri": {

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       168
        
                 "type": "string",

     

       169
       +
                 "format": "at-uri"

     

       170
        
               },

     

       171
       +
               "notFound": {

     

       172
       +
                 "type": "boolean",

     

       173
       +
                 "const": true

     

       174
        
               }

     

       175
        
             }

     

       176
        
           },

     

       177
       +
           "blockedPost": {

     

       178
        
             "type": "object",

     

       179
       +
             "description": "Post is blocked due to viewer blocking author/community, or community moderation",

     

       180
       +
             "required": ["uri", "blocked"],

     

       181
        
             "properties": {

     

       182
       +
               "uri": {

     

       183
        
                 "type": "string",

     

       184
       +
                 "format": "at-uri"

     

       185
        
               },

     

       186
       +
               "blocked": {

     

       187
       +
                 "type": "boolean",

     

       188
       +
                 "const": true

     

       189
       +
               },

     

       190
       +
               "blockedBy": {

     

       191
        
                 "type": "string",

     

       192
       +
                 "enum": ["author", "community", "moderator"],

     

       193
       +
                 "description": "What caused the block: viewer blocked author, viewer blocked community, or post was removed by moderators"

     

       194
        
               },

     

       195
       +
               "author": {

     

       196
       +
                 "type": "ref",

     

       197
       +
                 "ref": "#blockedAuthor"

     

       198
       +
               },

     

       199
       +
               "community": {

     

       200
       +
                 "type": "ref",

     

       201
       +
                 "ref": "#blockedCommunity"

     

       202
        
               }

     

       203
        
             }

     

       204
        
           },

     

       205
       +
           "blockedAuthor": {

     

       206
       +
             "type": "object",

     

       207
       +
             "description": "Minimal author info for blocked posts",

     

       208
       +
             "required": ["did"],

     

       209
       +
             "properties": {

     

       210
       +
               "did": {

     

       211
       +
                 "type": "string",

     

       212
       +
                 "format": "did"

     

       213
       +
               }

     

       214
       +
             }

     

       215
       +
           },

     

       216
       +
           "blockedCommunity": {

     

       217
        
             "type": "object",

     

       218
       +
             "description": "Minimal community info for blocked posts",

     

       219
       +
             "required": ["did"],

     

       220
        
             "properties": {

     

       221
       +
               "did": {

     

       222
        
                 "type": "string",

     

       223
       +
                 "format": "did"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       224
        
               },

     

       225
       +
               "name": {

     

       226
        
                 "type": "string"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       227
        
               }

     

       228
        
             }

     

       229
        
           },

+61

internal/core/posts/post.go

···

       66
        
       	Facets         []interface{}          `json:"facets,omitempty"`

     

       67
        
       	ContentLabels  []string               `json:"contentLabels,omitempty"`

     

       68
        
       }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       66
        
       	Facets         []interface{}          `json:"facets,omitempty"`

     

       67
        
       	ContentLabels  []string               `json:"contentLabels,omitempty"`

     

       68
        
       }

     

       69
       +
       

     

       70
       +
       // PostView represents the full view of a post with all metadata

     

       71
       +
       // Matches social.coves.post.get#postView lexicon

     

       72
       +
       // Used in feeds and get endpoints

     

       73
       +
       type PostView struct {

     

       74
       +
       	IndexedAt     time.Time     `json:"indexedAt"`

     

       75
       +
       	CreatedAt     time.Time     `json:"createdAt"`

     

       76
       +
       	Record        interface{}   `json:"record,omitempty"`

     

       77
       +
       	Embed         interface{}   `json:"embed,omitempty"`

     

       78
       +
       	Language      *string       `json:"language,omitempty"`

     

       79
       +
       	EditedAt      *time.Time    `json:"editedAt,omitempty"`

     

       80
       +
       	Title         *string       `json:"title,omitempty"`

     

       81
       +
       	Text          *string       `json:"text,omitempty"`

     

       82
       +
       	Viewer        *ViewerState  `json:"viewer,omitempty"`

     

       83
       +
       	Author        *AuthorView   `json:"author"`

     

       84
       +
       	Stats         *PostStats    `json:"stats,omitempty"`

     

       85
       +
       	Community     *CommunityRef `json:"community"`

     

       86
       +
       	RKey          string        `json:"rkey"`

     

       87
       +
       	CID           string        `json:"cid"`

     

       88
       +
       	URI           string        `json:"uri"`

     

       89
       +
       	TextFacets    []interface{} `json:"textFacets,omitempty"`

     

       90
       +
       	UpvoteCount   int           `json:"-"`

     

       91
       +
       	DownvoteCount int           `json:"-"`

     

       92
       +
       	Score         int           `json:"-"`

     

       93
       +
       	CommentCount  int           `json:"-"`

     

       94
       +
       }

     

       95
       +
       

     

       96
       +
       // AuthorView represents author information in post views

     

       97
       +
       type AuthorView struct {

     

       98
       +
       	DisplayName *string `json:"displayName,omitempty"`

     

       99
       +
       	Avatar      *string `json:"avatar,omitempty"`

     

       100
       +
       	Reputation  *int    `json:"reputation,omitempty"`

     

       101
       +
       	DID         string  `json:"did"`

     

       102
       +
       	Handle      string  `json:"handle"`

     

       103
       +
       }

     

       104
       +
       

     

       105
       +
       // CommunityRef represents minimal community info in post views

     

       106
       +
       type CommunityRef struct {

     

       107
       +
       	Avatar *string `json:"avatar,omitempty"`

     

       108
       +
       	DID    string  `json:"did"`

     

       109
       +
       	Name   string  `json:"name"`

     

       110
       +
       }

     

       111
       +
       

     

       112
       +
       // PostStats represents aggregated statistics

     

       113
       +
       type PostStats struct {

     

       114
       +
       	TagCounts    map[string]int `json:"tagCounts,omitempty"`

     

       115
       +
       	Upvotes      int            `json:"upvotes"`

     

       116
       +
       	Downvotes    int            `json:"downvotes"`

     

       117
       +
       	Score        int            `json:"score"`

     

       118
       +
       	CommentCount int            `json:"commentCount"`

     

       119
       +
       	ShareCount   int            `json:"shareCount,omitempty"`

     

       120
       +
       }

     

       121
       +
       

     

       122
       +
       // ViewerState represents the viewer's relationship with the post

     

       123
       +
       type ViewerState struct {

     

       124
       +
       	Vote     *string  `json:"vote,omitempty"`

     

       125
       +
       	VoteURI  *string  `json:"voteUri,omitempty"`

     

       126
       +
       	SavedURI *string  `json:"savedUri,omitempty"`

     

       127
       +
       	Tags     []string `json:"tags,omitempty"`

     

       128
       +
       	Saved    bool     `json:"saved"`

     

       129
       +
       }