@recursiv/sdk 0.7.18 → 0.7.19

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 { 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, 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 { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';

package/dist/resources/protocols.d.ts

@@ -192,9 +192,83 @@ export interface PublishHostedPostInput extends PreviewHostedPostInput {
     /** Explicitly publish the previewed text publicly in this app. */
     publishPublicly: true;
 }
+/** Public source identity, independent of any local Minds user or handle. */
+export interface SocialProfile {
+    protocol: string;
+    nativeId: string;
+    handle: string;
+    displayName: string;
+    description: string;
+    profileUrl: string;
+    avatarUrl: string | null;
+    followersCount: number | null;
+    followingCount: number | null;
+    postsCount: number | null;
+    subscription: SocialSubscription | null;
+}
+export interface SocialSubscription {
+    id: string;
+    protocol: string;
+    nativeId: string;
+    /** Private reading subscription in this app; not a native-network follow. */
+    kind: 'minds_feed';
+    createdAt: string;
+}
+export interface SearchPublicProfilesParams {
+    protocol: string;
+    query: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface SocialProfilePage {
+    items: SocialProfile[];
+    cursor: string | null;
+}
+/** Public source data read on demand; never a canonical Minds post ID. */
+export interface SocialPost {
+    protocol: string;
+    nativeId: string;
+    sourceUrl: string;
+    author: Omit<SocialProfile, 'subscription'>;
+    text: string;
+    createdAt: string;
+    replyCount: number;
+    likeCount: number;
+    repostCount: number;
+    media: Array<{
+        type: 'image';
+        url: string;
+        alt: string;
+    }>;
+    hasAdditionalContent: boolean;
+}
+export interface SocialAuthorFeed {
+    items: SocialPost[];
+    cursor: string | null;
+    coverage: 'original_posts';
+}
 export declare class ProtocolsResource {
     private client;
     constructor(client: HttpClient);
+    /** 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>>;
+    getPublicAuthorFeed(params: {
+        protocol: string;
+        actor: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<SingleResponse<SocialAuthorFeed>>;
+    listSubscriptions(): Promise<SingleResponse<SocialSubscription[]>>;
+    /** Save a private reading subscription after resolving the immutable native ID. */
+    subscribeToProfile(input: {
+        protocol: string;
+        nativeId: string;
+        kind: 'minds_feed';
+    }): Promise<SingleResponse<SocialSubscription>>;
+    unsubscribeFromProfile(id: string): Promise<SingleResponse<{
+        deleted: true;
+    }>>;
     /** List adapters with truthful capability, maturity, and limitation metadata. */
     list(): Promise<SingleResponse<ProtocolAdapterMetadata[]>>;
     /** Configured addresses for the current app. Does not attest runtime or account readiness. */

package/dist/resources/protocols.js

@@ -39,6 +39,33 @@ export class ProtocolsResource {
     constructor(client) {
         this.client = client;
     }
+    /** Query the live public network. It does not import users or posts. */
+    searchPublicProfiles(params) {
+        return this.client.get('/protocols/social/profiles', {
+            protocol: params.protocol, query: params.query, limit: params.limit, cursor: params.cursor,
+        });
+    }
+    getPublicProfile(protocol, actor) {
+        return this.client.get('/protocols/social/profile', { protocol, actor });
+    }
+    getPublicAuthorFeed(params) {
+        return this.client.get('/protocols/social/author-feed', {
+            protocol: params.protocol, actor: params.actor, limit: params.limit, cursor: params.cursor,
+        });
+    }
+    listSubscriptions() {
+        return this.client.get('/protocols/social/subscriptions');
+    }
+    /** Save a private reading subscription after resolving the immutable native ID. */
+    subscribeToProfile(input) {
+        return this.client.post('/protocols/social/subscriptions', input);
+    }
+    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)}`);
+    }
     /** List adapters with truthful capability, maturity, and limitation metadata. */
     list() {
         return this.client.get('/protocols');

package/package.json

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