@atproto/api 0.31.0 → 0.31.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atproto/api
 
+## 0.31.1
+
+### Patch Changes
+
+- [#5853](https://github.com/bluesky-social/atproto/pull/5853) [`57b7a37`](https://github.com/bluesky-social/atproto/commit/57b7a375f571bf7f42709f93f98d3f9bd000fb6d) Thanks [@blackmichael](https://github.com/blackmichael)! - Add optional hydrated viewBskyPost values alongside existing bskyPostRef fields on Atmosphere timeline activities and Explore articles and livestreams. Reuse post hydration and viewer visibility checks, preserving references and external content when posts are unavailable. Refresh consuming contract inputs.
+  
+  Keep Explore and the Atmosphere timeline available when optional post hydration fails, omitting incomplete post views while retaining external content and references. Preserve request cancellation and failures for required timeline root posts.
+
+- [#5871](https://github.com/bluesky-social/atproto/pull/5871) [`4ca55db`](https://github.com/bluesky-social/atproto/commit/4ca55dbc6d9e04d721fc14abffb73ce33158e002) Thanks [@blackmichael](https://github.com/blackmichael)! - Rework Atmosphere timeline groups: replace overflow with complete group item URIs and hydrate only the newest actor-group item. Keep subject groups to one collection and multiple actors, and return article creations as standalone items with collection-specific related activity references and actor profiles.
+  
+  Require complete actor lists for subject groups and related-activity buckets, preserving the existing record fallbacks when profiles are unavailable.
+
 ## 0.31.0
 
 ### Minor Changes

package/dist/client/lexicons.d.ts

@@ -9445,6 +9445,11 @@ export declare const schemaDict: {
                         readonly ref: 'lex:com.atproto.repo.strongRef';
                         readonly description: 'The Bluesky post associated with the article, as declared by its author. The referenced post may not be available.';
                     };
+                    readonly viewBskyPost: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.feed.defs#postView';
+                        readonly description: 'The hydrated Bluesky post associated with the article, as declared by its author. Omitted when the post is unavailable to the viewer.';
+                    };
                     readonly view: {
                         readonly type: 'ref';
                         readonly ref: 'lex:app.bsky.embed.external#viewArticle';
@@ -9492,6 +9497,11 @@ export declare const schemaDict: {
                         readonly ref: 'lex:com.atproto.repo.strongRef';
                         readonly description: 'The Bluesky post that announced the livestream, as declared by its author. The referenced post may not be available.';
                     };
+                    readonly viewBskyPost: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.feed.defs#postView';
+                        readonly description: 'The hydrated Bluesky post that announced the livestream, as declared by its author. Omitted when the post is unavailable to the viewer.';
+                    };
                     readonly view: {
                         readonly type: 'ref';
                         readonly ref: 'lex:app.bsky.embed.external#viewLivestream';
@@ -9594,7 +9604,7 @@ export declare const schemaDict: {
         readonly defs: {
             readonly main: {
                 readonly type: 'query';
-                readonly description: "Get the authenticated viewer's Atmosphere activity timeline. Grouping and related activity are limited to the returned page.";
+                readonly description: "Get the authenticated viewer's Atmosphere activity timeline. Groups contain visible activities from the returned page.";
                 readonly parameters: {
                     readonly type: 'params';
                     readonly properties: {
@@ -9616,7 +9626,7 @@ export declare const schemaDict: {
                                 readonly type: 'array';
                                 readonly items: {
                                     readonly type: 'union';
-                                    readonly refs: ["lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityItemOverflow", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroup"];
+                                    readonly refs: ["lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityActorGroup", "lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubjectGroup"];
                                 };
                             };
                         };
@@ -9666,40 +9676,131 @@ export declare const schemaDict: {
                         readonly type: 'ref';
                         readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState';
                     };
+                    readonly relatedActivity: {
+                        readonly type: 'array';
+                        readonly 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.";
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRelatedGroup';
+                        };
+                    };
                     readonly bskyPostRef: {
                         readonly type: 'ref';
                         readonly ref: 'lex:com.atproto.repo.strongRef';
                         readonly description: 'The Bluesky post associated with the rendered article or livestream, as declared by its author. The referenced post may not be available.';
                     };
+                    readonly viewBskyPost: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.feed.defs#postView';
+                        readonly 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.';
+                    };
                     readonly view: {
                         readonly type: 'union';
                         readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery", "lex:app.bsky.embed.external#viewLivestream", "lex:app.bsky.feed.defs#postView"];
                     };
-                    readonly relatedActivity: {
+                };
+            };
+            readonly activityActorGroup: {
+                readonly type: 'object';
+                readonly 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.';
+                readonly required: ["id", "collection", "indexedAt", "actor", "item", "uris"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: 'string';
+                    };
+                    readonly collection: {
+                        readonly type: 'string';
+                        readonly format: 'nsid';
+                    };
+                    readonly indexedAt: {
+                        readonly type: 'string';
+                        readonly format: 'datetime';
+                    };
+                    readonly actor: {
+                        readonly type: 'string';
+                        readonly format: 'did';
+                    };
+                    readonly item: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                    };
+                    readonly uris: {
                         readonly type: 'array';
-                        readonly description: 'Recommendations and shares attached to this article. Attached activities do not themselves contain related activity.';
+                        readonly description: 'All visible group item URIs, including the hydrated item, in newest-first timeline order.';
+                        readonly minLength: 2;
                         readonly items: {
-                            readonly type: 'ref';
-                            readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                            readonly type: 'string';
+                            readonly format: 'at-uri';
                         };
                     };
                 };
             };
-            readonly activityItemOverflow: {
+            readonly activitySubject: {
                 readonly type: 'object';
-                readonly description: 'Distinct additional activities omitted from this page for an author and collection, without hydrating the omitted records.';
-                readonly required: ["count", "collection", "associatedProfiles"];
+                readonly description: 'The shared target of grouped activities, not an activity itself.';
+                readonly required: ["uri", "viewerState", "view"];
                 readonly properties: {
-                    readonly count: {
-                        readonly type: 'integer';
-                        readonly minimum: 1;
+                    readonly uri: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                    readonly viewerState: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState';
+                    };
+                    readonly bskyPostRef: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:com.atproto.repo.strongRef';
+                        readonly description: "The author's declared Bluesky post for the target. The post may be unavailable.";
+                    };
+                    readonly viewBskyPost: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.feed.defs#postView';
+                        readonly description: "The hydrated Bluesky post declared by the target's author. Omitted when the post is unavailable to the viewer.";
+                    };
+                    readonly view: {
+                        readonly type: 'union';
+                        readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery"];
+                    };
+                };
+            };
+            readonly activityGroupItem: {
+                readonly type: 'object';
+                readonly description: 'An unhydrated group item. Its actor DID is the authority of its record URI.';
+                readonly required: ["record", "collection"];
+                readonly properties: {
+                    readonly record: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRecord';
                     };
                     readonly collection: {
                         readonly type: 'string';
                         readonly format: 'nsid';
                     };
-                    readonly associatedProfiles: {
+                };
+            };
+            readonly activityRelatedGroup: {
+                readonly type: 'object';
+                readonly 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.";
+                readonly required: ["collection", "activities", "actors"];
+                readonly properties: {
+                    readonly collection: {
+                        readonly type: 'string';
+                        readonly format: 'nsid';
+                    };
+                    readonly activities: {
+                        readonly type: 'array';
+                        readonly description: "Visible activity references in newest-first timeline order. Every activity has the bucket's collection.";
+                        readonly minLength: 1;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem';
+                        };
+                    };
+                    readonly actors: {
                         readonly type: 'array';
+                        readonly description: "Unique actors in first-appearance order among the bucket's activities.";
+                        readonly minLength: 1;
                         readonly items: {
                             readonly type: 'ref';
                             readonly ref: 'lex:app.bsky.actor.defs#profileViewBasic';
@@ -9707,18 +9808,14 @@ export declare const schemaDict: {
                     };
                 };
             };
-            readonly activityGroup: {
+            readonly activitySubjectGroup: {
                 readonly type: 'object';
-                readonly 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.";
-                readonly required: ["id", "groupBy", "collection", "indexedAt", "items"];
+                readonly 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.';
+                readonly required: ["id", "collection", "indexedAt", "subject", "activities", "actors"];
                 readonly properties: {
                     readonly id: {
                         readonly type: 'string';
                     };
-                    readonly groupBy: {
-                        readonly type: 'string';
-                        readonly knownValues: ["subject", "actor"];
-                    };
                     readonly collection: {
                         readonly type: 'string';
                         readonly format: 'nsid';
@@ -9727,21 +9824,27 @@ export declare const schemaDict: {
                         readonly type: 'string';
                         readonly format: 'datetime';
                     };
-                    readonly items: {
+                    readonly subject: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubject';
+                    };
+                    readonly activities: {
                         readonly type: 'array';
+                        readonly description: "Visible group items in newest-first timeline order. Every activity has the group's collection.";
                         readonly minLength: 2;
                         readonly items: {
                             readonly type: 'ref';
-                            readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                            readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem';
                         };
                     };
-                    readonly subject: {
-                        readonly type: 'string';
-                        readonly format: 'at-uri';
-                    };
-                    readonly actor: {
-                        readonly type: 'string';
-                        readonly format: 'did';
+                    readonly actors: {
+                        readonly type: 'array';
+                        readonly description: 'Unique actors in first-appearance order among group items. At least two distinct actors are required.';
+                        readonly minLength: 2;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.actor.defs#profileViewBasic';
+                        };
                     };
                 };
             };
@@ -37619,6 +37722,11 @@ export declare const schemas: ({
                     readonly ref: 'lex:com.atproto.repo.strongRef';
                     readonly description: 'The Bluesky post associated with the article, as declared by its author. The referenced post may not be available.';
                 };
+                readonly viewBskyPost: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.feed.defs#postView';
+                    readonly description: 'The hydrated Bluesky post associated with the article, as declared by its author. Omitted when the post is unavailable to the viewer.';
+                };
                 readonly view: {
                     readonly type: 'ref';
                     readonly ref: 'lex:app.bsky.embed.external#viewArticle';
@@ -37666,6 +37774,11 @@ export declare const schemas: ({
                     readonly ref: 'lex:com.atproto.repo.strongRef';
                     readonly description: 'The Bluesky post that announced the livestream, as declared by its author. The referenced post may not be available.';
                 };
+                readonly viewBskyPost: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.feed.defs#postView';
+                    readonly description: 'The hydrated Bluesky post that announced the livestream, as declared by its author. Omitted when the post is unavailable to the viewer.';
+                };
                 readonly view: {
                     readonly type: 'ref';
                     readonly ref: 'lex:app.bsky.embed.external#viewLivestream';
@@ -37767,7 +37880,7 @@ export declare const schemas: ({
     readonly defs: {
         readonly main: {
             readonly type: 'query';
-            readonly description: "Get the authenticated viewer's Atmosphere activity timeline. Grouping and related activity are limited to the returned page.";
+            readonly description: "Get the authenticated viewer's Atmosphere activity timeline. Groups contain visible activities from the returned page.";
             readonly parameters: {
                 readonly type: 'params';
                 readonly properties: {
@@ -37789,7 +37902,7 @@ export declare const schemas: ({
                             readonly type: 'array';
                             readonly items: {
                                 readonly type: 'union';
-                                readonly refs: ["lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityItemOverflow", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroup"];
+                                readonly refs: ["lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem", "lex:app.bsky.unspecced.getAtmosphereTimeline#activityActorGroup", "lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubjectGroup"];
                             };
                         };
                     };
@@ -37839,40 +37952,131 @@ export declare const schemas: ({
                     readonly type: 'ref';
                     readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState';
                 };
+                readonly relatedActivity: {
+                    readonly type: 'array';
+                    readonly 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.";
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRelatedGroup';
+                    };
+                };
                 readonly bskyPostRef: {
                     readonly type: 'ref';
                     readonly ref: 'lex:com.atproto.repo.strongRef';
                     readonly description: 'The Bluesky post associated with the rendered article or livestream, as declared by its author. The referenced post may not be available.';
                 };
+                readonly viewBskyPost: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.feed.defs#postView';
+                    readonly 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.';
+                };
                 readonly view: {
                     readonly type: 'union';
                     readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery", "lex:app.bsky.embed.external#viewLivestream", "lex:app.bsky.feed.defs#postView"];
                 };
-                readonly relatedActivity: {
+            };
+        };
+        readonly activityActorGroup: {
+            readonly type: 'object';
+            readonly 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.';
+            readonly required: ["id", "collection", "indexedAt", "actor", "item", "uris"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: 'string';
+                };
+                readonly collection: {
+                    readonly type: 'string';
+                    readonly format: 'nsid';
+                };
+                readonly indexedAt: {
+                    readonly type: 'string';
+                    readonly format: 'datetime';
+                };
+                readonly actor: {
+                    readonly type: 'string';
+                    readonly format: 'did';
+                };
+                readonly item: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                };
+                readonly uris: {
                     readonly type: 'array';
-                    readonly description: 'Recommendations and shares attached to this article. Attached activities do not themselves contain related activity.';
+                    readonly description: 'All visible group item URIs, including the hydrated item, in newest-first timeline order.';
+                    readonly minLength: 2;
                     readonly items: {
-                        readonly type: 'ref';
-                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
                     };
                 };
             };
         };
-        readonly activityItemOverflow: {
+        readonly activitySubject: {
             readonly type: 'object';
-            readonly description: 'Distinct additional activities omitted from this page for an author and collection, without hydrating the omitted records.';
-            readonly required: ["count", "collection", "associatedProfiles"];
+            readonly description: 'The shared target of grouped activities, not an activity itself.';
+            readonly required: ["uri", "viewerState", "view"];
             readonly properties: {
-                readonly count: {
-                    readonly type: 'integer';
-                    readonly minimum: 1;
+                readonly uri: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+                readonly viewerState: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#viewerState';
+                };
+                readonly bskyPostRef: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:com.atproto.repo.strongRef';
+                    readonly description: "The author's declared Bluesky post for the target. The post may be unavailable.";
+                };
+                readonly viewBskyPost: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.feed.defs#postView';
+                    readonly description: "The hydrated Bluesky post declared by the target's author. Omitted when the post is unavailable to the viewer.";
+                };
+                readonly view: {
+                    readonly type: 'union';
+                    readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery"];
+                };
+            };
+        };
+        readonly activityGroupItem: {
+            readonly type: 'object';
+            readonly description: 'An unhydrated group item. Its actor DID is the authority of its record URI.';
+            readonly required: ["record", "collection"];
+            readonly properties: {
+                readonly record: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityRecord';
                 };
                 readonly collection: {
                     readonly type: 'string';
                     readonly format: 'nsid';
                 };
-                readonly associatedProfiles: {
+            };
+        };
+        readonly activityRelatedGroup: {
+            readonly type: 'object';
+            readonly 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.";
+            readonly required: ["collection", "activities", "actors"];
+            readonly properties: {
+                readonly collection: {
+                    readonly type: 'string';
+                    readonly format: 'nsid';
+                };
+                readonly activities: {
+                    readonly type: 'array';
+                    readonly description: "Visible activity references in newest-first timeline order. Every activity has the bucket's collection.";
+                    readonly minLength: 1;
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem';
+                    };
+                };
+                readonly actors: {
                     readonly type: 'array';
+                    readonly description: "Unique actors in first-appearance order among the bucket's activities.";
+                    readonly minLength: 1;
                     readonly items: {
                         readonly type: 'ref';
                         readonly ref: 'lex:app.bsky.actor.defs#profileViewBasic';
@@ -37880,18 +38084,14 @@ export declare const schemas: ({
                 };
             };
         };
-        readonly activityGroup: {
+        readonly activitySubjectGroup: {
             readonly type: 'object';
-            readonly 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.";
-            readonly required: ["id", "groupBy", "collection", "indexedAt", "items"];
+            readonly 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.';
+            readonly required: ["id", "collection", "indexedAt", "subject", "activities", "actors"];
             readonly properties: {
                 readonly id: {
                     readonly type: 'string';
                 };
-                readonly groupBy: {
-                    readonly type: 'string';
-                    readonly knownValues: ["subject", "actor"];
-                };
                 readonly collection: {
                     readonly type: 'string';
                     readonly format: 'nsid';
@@ -37900,21 +38100,27 @@ export declare const schemas: ({
                     readonly type: 'string';
                     readonly format: 'datetime';
                 };
-                readonly items: {
+                readonly subject: {
+                    readonly type: 'ref';
+                    readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activitySubject';
+                };
+                readonly activities: {
                     readonly type: 'array';
+                    readonly description: "Visible group items in newest-first timeline order. Every activity has the group's collection.";
                     readonly minLength: 2;
                     readonly items: {
                         readonly type: 'ref';
-                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityItem';
+                        readonly ref: 'lex:app.bsky.unspecced.getAtmosphereTimeline#activityGroupItem';
                     };
                 };
-                readonly subject: {
-                    readonly type: 'string';
-                    readonly format: 'at-uri';
-                };
-                readonly actor: {
-                    readonly type: 'string';
-                    readonly format: 'did';
+                readonly actors: {
+                    readonly type: 'array';
+                    readonly description: 'Unique actors in first-appearance order among group items. At least two distinct actors are required.';
+                    readonly minLength: 2;
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.actor.defs#profileViewBasic';
+                    };
                 };
             };
         };