@recursiv/sdk 0.7.37 → 0.7.39

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. */
@@ -887,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;
@@ -1012,6 +1023,7 @@ export declare class ProtocolsResource {
         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: {
@@ -1019,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

@@ -110,11 +110,13 @@ 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,
-            ...(params.includePreviews !== undefined ? { includePreviews: params.includePreviews } : {}) });
+            ...(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;

package/package.json

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