@recursiv/sdk 0.7.20 → 0.7.22

package/dist/index.d.ts

@@ -189,7 +189,7 @@ export type { UploadMediaInput, UploadUrlInput, UploadUrlResult } from './resour
 export { WalletResource } from './resources/wallet.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, } from './resources/protocols.js';
-export type { SocialProfile, SocialSubscription, SocialProfilePage, SocialNetwork, SocialPost, SocialAuthorFeed, SearchPublicProfilesParams, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, HostedPostPreview, ConnectHostedIdentityInput, PreviewHostedPostInput, PublishHostedPostInput, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
+export type { SocialProfile, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialNetwork, SocialPost, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, HostedPostPreview, ConnectHostedIdentityInput, PreviewHostedPostInput, PublishHostedPostInput, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';

package/dist/resources/protocols.d.ts

@@ -201,7 +201,7 @@ export interface SocialNetwork {
         url: string;
     };
     coverage: string;
-    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription'>;
+    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription' | 'following_feed'>;
     profileSearchPagination: boolean;
 }
 /** Public source identity, independent of any local Minds user or handle. */
@@ -226,6 +226,13 @@ export interface SocialSubscription {
     kind: 'minds_feed';
     createdAt: string;
 }
+export type SocialSubscriptionChange = {
+    type: 'subscribed';
+    subscription: SocialSubscription;
+} | {
+    type: 'unsubscribed';
+    id: string;
+};
 export interface SearchPublicProfilesParams {
     protocol: string;
     query: string;
@@ -244,9 +251,9 @@ export interface SocialPost {
     author: Omit<SocialProfile, 'subscription'>;
     text: string;
     createdAt: string;
-    replyCount: number;
-    likeCount: number;
-    repostCount: number;
+    replyCount: number | null;
+    likeCount: number | null;
+    repostCount: number | null;
     media: Array<{
         type: 'image';
         url: string;
@@ -259,9 +266,30 @@ export interface SocialAuthorFeed {
     cursor: string | null;
     coverage: 'original_posts';
 }
+export interface SocialFollowingSource {
+    subscriptionId: string;
+    protocol: string;
+    nativeId: string;
+    status: 'ok' | 'unavailable' | 'rate_limited' | 'unsupported_protocol';
+    moreAvailable: boolean | null;
+}
+/** A bounded batch of recent author windows. Continue the cursor to read more followed accounts. */
+export interface SocialFollowingFeed {
+    items: SocialPost[];
+    cursor: string | null;
+    sources: SocialFollowingSource[];
+    accountsRead: number;
+    totalAccounts: number;
+    postsPerAccount: number;
+    coverage: 'recent_original_posts';
+}
 export declare class ProtocolsResource {
     private client;
+    private subscriptionListeners;
     constructor(client: HttpClient);
+    /** Confirmed changes from this SDK instance only. Unsubscribe when a view unmounts or its account changes. */
+    onSubscriptionChange(listener: (change: SocialSubscriptionChange) => void): () => void;
+    private subscriptionChanged;
     publicNetworks(): Promise<SingleResponse<SocialNetwork[]>>;
     /** Query the live public network. It does not import users or posts. */
     searchPublicProfiles(params: SearchPublicProfilesParams): Promise<SingleResponse<SocialProfilePage>>;
@@ -273,6 +301,11 @@ export declare class ProtocolsResource {
         cursor?: string;
     }): Promise<SingleResponse<SocialAuthorFeed>>;
     listSubscriptions(): Promise<SingleResponse<SocialSubscription[]>>;
+    /** Recent originals from the current app user's followed accounts, with explicit source failures. */
+    getFollowingFeed(params?: {
+        protocol?: string;
+        cursor?: string;
+    }): Promise<SingleResponse<SocialFollowingFeed>>;
     /** Save a private reading subscription after resolving the immutable native ID. */
     subscribeToProfile(input: {
         protocol: string;

package/dist/resources/protocols.js

@@ -36,9 +36,24 @@ function hostedIdentityPath(id) {
 }
 export class ProtocolsResource {
     client;
+    subscriptionListeners = new Set();
     constructor(client) {
         this.client = client;
     }
+    /** Confirmed changes from this SDK instance only. Unsubscribe when a view unmounts or its account changes. */
+    onSubscriptionChange(listener) {
+        this.subscriptionListeners.add(listener);
+        return () => { this.subscriptionListeners.delete(listener); };
+    }
+    subscriptionChanged(change) {
+        for (const listener of [...this.subscriptionListeners]) {
+            // A view failure must not turn a confirmed server write into a failed mutation.
+            try {
+                listener(change);
+            }
+            catch { /* Other mounted views still receive the change. */ }
+        }
+    }
     publicNetworks() {
         return this.client.get('/protocols/social/networks');
     }
@@ -59,15 +74,25 @@ export class ProtocolsResource {
     listSubscriptions() {
         return this.client.get('/protocols/social/subscriptions');
     }
+    /** Recent originals from the current app user's followed accounts, with explicit source failures. */
+    getFollowingFeed(params = {}) {
+        return this.client.get('/protocols/social/following-feed', { protocol: params.protocol, cursor: params.cursor });
+    }
     /** Save a private reading subscription after resolving the immutable native ID. */
     subscribeToProfile(input) {
-        return this.client.post('/protocols/social/subscriptions', input);
+        return this.client.post('/protocols/social/subscriptions', input).then(result => {
+            this.subscriptionChanged({ type: 'subscribed', subscription: result.data });
+            return result;
+        });
     }
     unsubscribeFromProfile(id) {
         if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {
             throw new ValidationError({ type: 'validation_error', code: 'invalid_subscription_id', message: 'A valid subscription ID is required' });
         }
-        return this.client.delete(`/protocols/social/subscriptions/${encodeURIComponent(id)}`);
+        return this.client.delete(`/protocols/social/subscriptions/${encodeURIComponent(id)}`).then(result => {
+            this.subscriptionChanged({ type: 'unsubscribed', id });
+            return result;
+        });
     }
     /** List adapters with truthful capability, maturity, and limitation metadata. */
     list() {

package/package.json

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