@recursiv/sdk 0.7.36 → 0.7.39

package/README.md

@@ -592,4 +592,6 @@ blocks/mutes as well. All reply and account endpoints still require authenticati
 
 Standalone public text publication uses `protocols.prepareNativePost({ clientMutationId, text, accountIds })`, then explicitly approved `submitNativePost`. Keep the same mutation ID after uncertain preparation; previously attempted deliveries are reconciled without resending. `nativePostStatus` and paginated `nativePostHistory` expose private app/user-owned outcomes. Review current own posts with `prepareNativePostRemoval`, then approve exact removal IDs through `removeNativePost`. Check connected-account `publish_text` capabilities; only explicitly enabled apps may publish. Text is sent unchanged, public only, with each provider’s actual limits. These methods do not accept media, a reply parent or caller-supplied authority.
 
-For Bluesky accounts advertising `quote`, prepare the same publication with `quote: { protocol: 'bluesky', nativeId: sourceAtUri }`. The server resolves the exact source CID using each connected account, checks quote permission and Minds safety, and rechecks before writing. Review each delivery’s `quote` alongside the account and comment before submitting. Changed or unavailable sources cannot publish; uncertain deliveries reconcile the original record key. ActivityPub/Nostr quotes are not provided by this method. Public post reads include at most one filtered `quote` with `state: 'available'` and `post`, or `state: 'unavailable'` without source content.
+For Bluesky accounts advertising `quote`, prepare the same publication with `quote: { protocol: 'bluesky', nativeId: sourceAtUri }`. The server resolves the exact source CID using each connected account, checks quote permission and Minds safety, and rechecks before writing. Review each delivery’s `quote` alongside the account and comment before submitting. Changed or unavailable sources cannot publish; uncertain deliveries reconcile the original record key. ActivityPub/Nostr quotes are not provided by this method. Public post reads include at most one filtered `quote` with `state: 'available'` and `post`, or `state: 'unavailable'` without source content. Available quotes may include `embeddedReferences`: exact standalone source-reference lines in the unchanged outer `text`. Omit them only when the quoted original is actually visible; retain them for unavailable or locally hidden quotes. Nostr references are decoded and matched by the server, without following relay hints.
+
+Topic browsing can request `getPublicTrends({ protocol: "bluesky", includePreviews: true })`. Optional `SocialTrend.preview` is a real image-bearing post from that topic, never a generated illustration. The server samples at most eight posts for each of ten topics, with three concurrent reads and a shared 2.5-second deadline; missing images leave usable text topics. App moderation and user source controls filter previews on every request. Bluesky CDN image attachments, quote-with-media images, and unlabeled link-preview thumbnails are supported; omitted content retains the source link.

package/dist/resources/posts.d.ts

@@ -5,6 +5,11 @@ export declare class PostsResource {
     constructor(client: HttpClient);
     /** List posts with optional filters */
     list(params?: ListPostsParams): Promise<PaginatedResponse<Post>>;
+    /** Broad categories currently enabled for public posts in this app. */
+    categories(): Promise<SingleResponse<Array<{
+        id: string;
+        name: string;
+    }>>>;
     /** List posts the authenticated caller has upvoted. */
     liked(params?: Pick<ListPostsParams, 'limit' | 'offset' | 'cursor'>): Promise<PaginatedResponse<Post>>;
     /** Get a single post with replies */

package/dist/resources/posts.js

@@ -7,6 +7,10 @@ export class PostsResource {
     list(params) {
         return this.client.get('/posts', params);
     }
+    /** Broad categories currently enabled for public posts in this app. */
+    categories() {
+        return this.client.get('/posts/categories');
+    }
     /** List posts the authenticated caller has upvoted. */
     liked(params) {
         return this.list({ ...params, liked: true });

package/dist/resources/protocols.d.ts

@@ -784,6 +784,11 @@ export interface SocialNetwork {
     capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription' | 'following_feed' | 'conversation_read' | 'public_trends' | 'trend_feed' | 'popular_accounts' | 'post_search'>;
     profileSearchPagination: boolean;
     postSearchAccountRequired?: boolean;
+    /** Categories available from the current app configuration. */
+    categories?: Array<{
+        id: string;
+        name: string;
+    }>;
     conversationCoverage?: string;
 }
 /** Public source identity, independent of any local Minds user or handle. */
@@ -848,6 +853,8 @@ export interface SocialPost {
     quote?: {
         state: 'available';
         post: Omit<SocialPost, 'quote'>;
+        /** Exact standalone references in text; omit only while this original is visibly rendered. */
+        embeddedReferences?: string[];
     } | {
         state: 'unavailable';
     };
@@ -885,6 +892,12 @@ export interface SocialTrendProvenance {
     coverage: 'provider_ranked_window';
     /** Exact ranking interval is not supplied by these providers. */
     rankingWindow: null;
+    categoryFilter?: {
+        selected: string;
+        status: 'complete' | 'partial';
+        classified: number;
+        unclassified: number;
+    };
 }
 export interface SocialTrend {
     protocol: string;
@@ -894,6 +907,8 @@ export interface SocialTrend {
     sourceUrl: string;
     startedAt: string | null;
     postCount: number | null;
+    /** A real image-bearing post from this topic, filtered by current source controls. */
+    preview?: SocialPost;
 }
 export type SocialTrends = SocialTrendProvenance & ({
     kind: 'topics';
@@ -1007,6 +1022,8 @@ export declare class ProtocolsResource {
         protocol: string;
         limit?: number;
         cursor?: string;
+        includePreviews?: boolean;
+        category?: string;
     }): Promise<SingleResponse<SocialTrends>>;
     /** Open a topic currently listed by the provider. Use its nativeId as topic and preserve the opaque cursor. */
     getPublicTrendFeed(params: {
@@ -1014,6 +1031,7 @@ export declare class ProtocolsResource {
         topic: string;
         limit?: number;
         cursor?: string;
+        category?: string;
     }): Promise<SingleResponse<SocialTrendFeed>>;
     /** Provider-ranked public accounts with explicit provenance; served from the app's index when a fresh snapshot exists. */
     getPublicPopularProfiles(params: {

package/dist/resources/protocols.js

@@ -109,11 +109,14 @@ export class ProtocolsResource {
     }
     /** Current provider-ranked topics or posts, with explicit source and coverage. Does not ingest content. */
     getPublicTrends(params) {
-        return this.client.get('/protocols/social/trends', { protocol: params.protocol, limit: params.limit, cursor: params.cursor });
+        return this.client.get('/protocols/social/trends', { protocol: params.protocol, limit: params.limit, cursor: params.cursor,
+            ...(params.includePreviews !== undefined ? { includePreviews: params.includePreviews } : {}),
+            ...(params.category !== undefined ? { category: params.category } : {}) });
     }
     /** Open a topic currently listed by the provider. Use its nativeId as topic and preserve the opaque cursor. */
     getPublicTrendFeed(params) {
-        return this.client.get('/protocols/social/trend-feed', { protocol: params.protocol, topic: params.topic, limit: params.limit, cursor: params.cursor });
+        return this.client.get('/protocols/social/trend-feed', { protocol: params.protocol, topic: params.topic, limit: params.limit, cursor: params.cursor,
+            ...(params.category !== undefined ? { category: params.category } : {}) });
     }
     /** Provider-ranked public accounts with explicit provenance; served from the app's index when a fresh snapshot exists. */
     getPublicPopularProfiles(params) {

package/dist/types.d.ts

@@ -171,6 +171,8 @@ export interface UpdatePostInput {
 }
 export type ReactionType = 'like' | 'heart' | 'fire' | 'laugh' | 'sad' | 'angry' | 'upvote' | 'downvote';
 export interface ListPostsParams extends PaginationParams {
+    /** Public-only broad category. Requires an enabled app experiment; limit <=25. */
+    category?: string;
     community_id?: string;
     author_id?: string;
     organization_id?: string;
@@ -278,7 +280,18 @@ export interface LastMessage {
     created_at: string;
 }
 export type ChatRequestStatus = 'accepted' | 'pending' | 'declined';
+/** Persisted sending policy; independent of enrollment/transport feature flags. */
+export type ConversationEncryptionPolicy = {
+    mode: 'plaintext';
+} | {
+    mode: 'legacy_v1';
+    state: 'enabled' | 'locked';
+} | {
+    mode: 'mls_v2';
+};
 export interface Conversation {
+    /** Missing on older APIs: treat as unknown, never as plaintext permission. */
+    encryption?: ConversationEncryptionPolicy;
     id: string;
     type: string;
     name: string | null;
@@ -290,6 +303,8 @@ export interface Conversation {
     created_at: string;
 }
 export interface ConversationDetail {
+    /** Missing on older APIs: treat as unknown, never as plaintext permission. */
+    encryption?: ConversationEncryptionPolicy;
     id: string;
     type: string;
     name: string | null;

package/llm.md

@@ -822,6 +822,8 @@ user/app-bound result IDs and discard UI state after an account switch. The last
 read-back observation is separate from retained publication/deletion evidence.
 
 Standalone public text posts: `prepareNativePost({ clientMutationId, text, accountIds })` → review → `submitNativePost(id, { approve: true, deliveryIds })`. Use `nativePostStatus(id)` / `nativePostHistory({limit,cursor})` for private durable outcomes and `prepareNativePostRemoval(id,{deliveryIds})` → `removeNativePost(id,{approve:true,removals:[{deliveryId,removalId}]})` for reviewed own-post removal. Check `publish_text` capability; no media, reply parent or audience override. Preserve mutation IDs, never create a new send to recover uncertainty.
-Bluesky quote: accounts must advertise `quote`; call `prepareNativePost({clientMutationId,text,accountIds,quote:{protocol:'bluesky',nativeId:sourceAtUri}})`, review each returned quote/account/comment, then approve via the same submit method. The server binds the source CID and rechecks permissions before sending. No cross-network quote conversion. Public reads expose one filtered `post.quote` (`available` with `post`, or `unavailable` without source details).
+Bluesky quote: accounts must advertise `quote`; call `prepareNativePost({clientMutationId,text,accountIds,quote:{protocol:'bluesky',nativeId:sourceAtUri}})`, review each returned quote/account/comment, then approve via the same submit method. The server binds the source CID and rechecks permissions before sending. No cross-network quote conversion. Public reads expose one filtered `post.quote` (`available` with `post`, or `unavailable` without source details). Available quotes may include `embeddedReferences`: exact standalone source-reference lines in the unchanged outer `text`. Omit them only when the quoted original is actually visible; retain them for unavailable or locally hidden quotes. Nostr references are decoded and matched by the server, without following relay hints.
 
 Public post search (API/SDK 0.7.35): `const { data: page } = await r.protocols.searchPublicPosts({ protocol: 'nostr', query: 'open social', limit: 10 })`. Bluesky/ActivityPub require a selected `accountId` from `nativeSocialAccounts()` with `post_search`; older Bluesky grants must reconnect with consent. Open their results with `getConnectedSocialConversation({ protocol, accountId: page.readerAccountId, post: item.nativeId, readRef: item.readRef })` and pass the same accountId to `reportSource` for post reports. Nostr uses `getPublicConversation`. Pages report provider/observedAt and bounded coverage; no invented exhaustive or global search. Keep cursors paired with the exact owner, query, account, limit and connection revision. No writes, credentials or new ingestion are part of search.
+
+Topic browsing can request `getPublicTrends({ protocol: "bluesky", includePreviews: true })`. Optional `SocialTrend.preview` is a real image-bearing post from that topic, never a generated illustration. The server samples at most eight posts for each of ten topics, with three concurrent reads and a shared 2.5-second deadline; missing images leave usable text topics. App moderation and user source controls filter previews on every request. Bluesky CDN image attachments, quote-with-media images, and unlabeled link-preview thumbnails are supported; omitted content retains the source link.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recursiv/sdk",
-  "version": "0.7.36",
+  "version": "0.7.39",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",