@atproto/api 0.31.0 → 0.31.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9764,6 +9764,11 @@ export const schemaDict = {
9764
9764
  ref: 'lex:com.atproto.repo.strongRef',
9765
9765
  description: 'The Bluesky post associated with the article, as declared by its author. The referenced post may not be available.',
9766
9766
  },
9767
+ viewBskyPost: {
9768
+ type: 'ref',
9769
+ ref: 'lex:app.bsky.feed.defs#postView',
9770
+ description: 'The hydrated Bluesky post associated with the article, as declared by its author. Omitted when the post is unavailable to the viewer.',
9771
+ },
9767
9772
  view: {
9768
9773
  type: 'ref',
9769
9774
  ref: 'lex:app.bsky.embed.external#viewArticle',
@@ -9811,6 +9816,11 @@ export const schemaDict = {
9811
9816
  ref: 'lex:com.atproto.repo.strongRef',
9812
9817
  description: 'The Bluesky post that announced the livestream, as declared by its author. The referenced post may not be available.',
9813
9818
  },
9819
+ viewBskyPost: {
9820
+ type: 'ref',
9821
+ ref: 'lex:app.bsky.feed.defs#postView',
9822
+ description: 'The hydrated Bluesky post that announced the livestream, as declared by its author. Omitted when the post is unavailable to the viewer.',
9823
+ },
9814
9824
  view: {
9815
9825
  type: 'ref',
9816
9826
  ref: 'lex:app.bsky.embed.external#viewLivestream',
@@ -9913,7 +9923,7 @@ export const schemaDict = {
9913
9923
  defs: {
9914
9924
  main: {
9915
9925
  type: 'query',
9916
- description: "Get the authenticated viewer's Atmosphere activity timeline. Grouping and related activity are limited to the returned page.",
9926
+ description: "Get the authenticated viewer's Atmosphere activity timeline. Groups contain visible activities from the returned page.",
9917
9927
  parameters: {
9918
9928
  type: 'params',
9919
9929
  properties: {
@@ -9937,8 +9947,8 @@ export const schemaDict = {
9937
9947
  type: 'union',
9938
9948
  refs: [
9939
9949
  'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem',
9940
- 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItemOverflow',
9941
- 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroup',
9950
+ 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityActorGroup',
9951
+ 'lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubjectGroup',
9942
9952
  ],
9943
9953
  },
9944
9954
  },
@@ -9989,11 +9999,24 @@ export const schemaDict = {
9989
9999
  type: 'ref',
9990
10000
  ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState',
9991
10001
  },
10002
+ relatedActivity: {
10003
+ type: 'array',
10004
+ description: "Collection-specific activity references targeting this item's record. Article creations with related activity remain standalone; only the parent item's view is hydrated.",
10005
+ items: {
10006
+ type: 'ref',
10007
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRelatedGroup',
10008
+ },
10009
+ },
9992
10010
  bskyPostRef: {
9993
10011
  type: 'ref',
9994
10012
  ref: 'lex:com.atproto.repo.strongRef',
9995
10013
  description: 'The Bluesky post associated with the rendered article or livestream, as declared by its author. The referenced post may not be available.',
9996
10014
  },
10015
+ viewBskyPost: {
10016
+ type: 'ref',
10017
+ ref: 'lex:app.bsky.feed.defs#postView',
10018
+ description: 'The hydrated Bluesky post associated with the rendered article or livestream, as declared by its author. Omitted when the post is unavailable to the viewer.',
10019
+ },
9997
10020
  view: {
9998
10021
  type: 'union',
9999
10022
  refs: [
@@ -10004,31 +10027,113 @@ export const schemaDict = {
10004
10027
  'lex:app.bsky.feed.defs#postView',
10005
10028
  ],
10006
10029
  },
10007
- relatedActivity: {
10030
+ },
10031
+ },
10032
+ activityActorGroup: {
10033
+ type: 'object',
10034
+ description: 'Activities by one actor in one collection, positioned at the newest group item. Only the newest item is hydrated. Article creations with related activity remain standalone.',
10035
+ required: ['id', 'collection', 'indexedAt', 'actor', 'item', 'uris'],
10036
+ properties: {
10037
+ id: {
10038
+ type: 'string',
10039
+ },
10040
+ collection: {
10041
+ type: 'string',
10042
+ format: 'nsid',
10043
+ },
10044
+ indexedAt: {
10045
+ type: 'string',
10046
+ format: 'datetime',
10047
+ },
10048
+ actor: {
10049
+ type: 'string',
10050
+ format: 'did',
10051
+ },
10052
+ item: {
10053
+ type: 'ref',
10054
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem',
10055
+ },
10056
+ uris: {
10008
10057
  type: 'array',
10009
- description: 'Recommendations and shares attached to this article. Attached activities do not themselves contain related activity.',
10058
+ description: 'All visible group item URIs, including the hydrated item, in newest-first timeline order.',
10059
+ minLength: 2,
10010
10060
  items: {
10011
- type: 'ref',
10012
- ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem',
10061
+ type: 'string',
10062
+ format: 'at-uri',
10013
10063
  },
10014
10064
  },
10015
10065
  },
10016
10066
  },
10017
- activityItemOverflow: {
10067
+ activitySubject: {
10018
10068
  type: 'object',
10019
- description: 'Distinct additional activities omitted from this page for an author and collection, without hydrating the omitted records.',
10020
- required: ['count', 'collection', 'associatedProfiles'],
10069
+ description: 'The shared target of grouped activities, not an activity itself.',
10070
+ required: ['uri', 'viewerState', 'view'],
10021
10071
  properties: {
10022
- count: {
10023
- type: 'integer',
10024
- minimum: 1,
10072
+ uri: {
10073
+ type: 'string',
10074
+ format: 'at-uri',
10075
+ },
10076
+ viewerState: {
10077
+ type: 'ref',
10078
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState',
10079
+ },
10080
+ bskyPostRef: {
10081
+ type: 'ref',
10082
+ ref: 'lex:com.atproto.repo.strongRef',
10083
+ description: "The author's declared Bluesky post for the target. The post may be unavailable.",
10084
+ },
10085
+ viewBskyPost: {
10086
+ type: 'ref',
10087
+ ref: 'lex:app.bsky.feed.defs#postView',
10088
+ description: "The hydrated Bluesky post declared by the target's author. Omitted when the post is unavailable to the viewer.",
10089
+ },
10090
+ view: {
10091
+ type: 'union',
10092
+ refs: [
10093
+ 'lex:app.bsky.embed.external#viewArticle',
10094
+ 'lex:app.bsky.embed.external#viewArticlePublication',
10095
+ 'lex:app.bsky.embed.external#viewGallery',
10096
+ ],
10097
+ },
10098
+ },
10099
+ },
10100
+ activityGroupItem: {
10101
+ type: 'object',
10102
+ description: 'An unhydrated group item. Its actor DID is the authority of its record URI.',
10103
+ required: ['record', 'collection'],
10104
+ properties: {
10105
+ record: {
10106
+ type: 'ref',
10107
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRecord',
10025
10108
  },
10026
10109
  collection: {
10027
10110
  type: 'string',
10028
10111
  format: 'nsid',
10029
10112
  },
10030
- associatedProfiles: {
10113
+ },
10114
+ },
10115
+ activityRelatedGroup: {
10116
+ type: 'object',
10117
+ description: "Visible activities in one collection targeting the parent item's record, without a time window. Contains references and profiles only, not a shared subject or hydrated action views. Buckets follow newest-first first appearance.",
10118
+ required: ['collection', 'activities', 'actors'],
10119
+ properties: {
10120
+ collection: {
10121
+ type: 'string',
10122
+ format: 'nsid',
10123
+ },
10124
+ activities: {
10031
10125
  type: 'array',
10126
+ description: "Visible activity references in newest-first timeline order. Every activity has the bucket's collection.",
10127
+ minLength: 1,
10128
+ items: {
10129
+ type: 'ref',
10130
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem',
10131
+ },
10132
+ },
10133
+ actors: {
10134
+ type: 'array',
10135
+ description: "Unique actors in first-appearance order among the bucket's activities.",
10136
+ minLength: 1,
10032
10137
  items: {
10033
10138
  type: 'ref',
10034
10139
  ref: 'lex:app.bsky.actor.defs#profileViewBasic',
@@ -10036,18 +10141,21 @@ export const schemaDict = {
10036
10141
  },
10037
10142
  },
10038
10143
  },
10039
- activityGroup: {
10144
+ activitySubjectGroup: {
10040
10145
  type: 'object',
10041
- description: "Two or more activities of the same collection, within a fixed window anchored at the newest member. The group occupies the newest member's position.",
10042
- required: ['id', 'groupBy', 'collection', 'indexedAt', 'items'],
10146
+ description: 'Activities in one collection sharing a target, by at least two distinct actors, positioned at the newest group item. Article recommendations and shares group separately across the returned page without a time window. Article creations are not subject-group items. Publication subscriptions and gallery favorites retain age-based grouping windows.',
10147
+ required: [
10148
+ 'id',
10149
+ 'collection',
10150
+ 'indexedAt',
10151
+ 'subject',
10152
+ 'activities',
10153
+ 'actors',
10154
+ ],
10043
10155
  properties: {
10044
10156
  id: {
10045
10157
  type: 'string',
10046
10158
  },
10047
- groupBy: {
10048
- type: 'string',
10049
- knownValues: ['subject', 'actor'],
10050
- },
10051
10159
  collection: {
10052
10160
  type: 'string',
10053
10161
  format: 'nsid',
@@ -10056,21 +10164,27 @@ export const schemaDict = {
10056
10164
  type: 'string',
10057
10165
  format: 'datetime',
10058
10166
  },
10059
- items: {
10167
+ subject: {
10168
+ type: 'ref',
10169
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubject',
10170
+ },
10171
+ activities: {
10060
10172
  type: 'array',
10173
+ description: "Visible group items in newest-first timeline order. Every activity has the group's collection.",
10061
10174
  minLength: 2,
10062
10175
  items: {
10063
10176
  type: 'ref',
10064
- ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem',
10177
+ ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem',
10065
10178
  },
10066
10179
  },
10067
- subject: {
10068
- type: 'string',
10069
- format: 'at-uri',
10070
- },
10071
- actor: {
10072
- type: 'string',
10073
- format: 'did',
10180
+ actors: {
10181
+ type: 'array',
10182
+ description: 'Unique actors in first-appearance order among group items. At least two distinct actors are required.',
10183
+ minLength: 2,
10184
+ items: {
10185
+ type: 'ref',
10186
+ ref: 'lex:app.bsky.actor.defs#profileViewBasic',
10187
+ },
10074
10188
  },
10075
10189
  },
10076
10190
  },