@recursiv/sdk 0.7.19 → 0.7.21

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, 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, 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

@@ -192,6 +192,18 @@ export interface PublishHostedPostInput extends PreviewHostedPostInput {
     /** Explicitly publish the previewed text publicly in this app. */
     publishPublicly: true;
 }
+/** Installed on-demand reading clients, their source coverage and supported UI. */
+export interface SocialNetwork {
+    protocol: string;
+    name: string;
+    provider: {
+        name: string;
+        url: string;
+    };
+    coverage: string;
+    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription'>;
+    profileSearchPagination: boolean;
+}
 /** Public source identity, independent of any local Minds user or handle. */
 export interface SocialProfile {
     protocol: string;
@@ -214,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;
@@ -232,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;
@@ -249,7 +268,12 @@ export interface SocialAuthorFeed {
 }
 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>>;
     getPublicProfile(protocol: string, actor: string): Promise<SingleResponse<SocialProfile>>;

package/dist/resources/protocols.js

@@ -36,9 +36,27 @@ 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');
+    }
     /** Query the live public network. It does not import users or posts. */
     searchPublicProfiles(params) {
         return this.client.get('/protocols/social/profiles', {
@@ -58,13 +76,19 @@ export class ProtocolsResource {
     }
     /** 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.19",
+  "version": "0.7.21",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",