@recursiv/sdk 0.7.17 → 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, 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

@@ -129,13 +129,168 @@ export interface HostedProtocolConnections {
         url: string;
     }[];
 }
+export type HostedProtocol = 'atproto' | 'activitypub' | 'nostr';
+export interface HostedProtocolIdentity {
+    id: string;
+    protocol: HostedProtocol;
+    serverUrl: string;
+    nativeId: string;
+    handle: string;
+    profileUrl: string | null;
+    verifiedAt: string;
+    createdAt: string;
+}
+export interface HostedNostrChallenge {
+    expiresAt: string;
+    /** Sign using a NIP-07 signer; never publish this kind-22242 event. */
+    event: {
+        kind: 22242;
+        content: string;
+        created_at: number;
+        tags: string[][];
+    };
+}
+export interface HostedNostrIdentityProof {
+    id: string;
+    pubkey: string;
+    sig: string;
+    kind: number;
+    content: string;
+    created_at: number;
+    tags: string[][];
+}
+export type ConnectHostedIdentityInput = {
+    protocol: 'atproto';
+    identifier: string; /** Prefer a native app password. Used once, never stored. */
+    password: string;
+} | {
+    protocol: 'activitypub'; /** Native read:accounts/read:statuses token. Used once, never stored. */
+    accessToken: string;
+} | {
+    protocol: 'nostr';
+    event: HostedNostrIdentityProof;
+};
+export interface PreviewHostedPostInput {
+    /** AT URI, GoToSocial status ID, or Nostr event ID. Never a fetch URL. */
+    nativePostId: string;
+    /** Required for ActivityPub reads; verified as the connected owner each time. */
+    accessToken?: string;
+}
+export interface HostedPostPreview {
+    identityId: string;
+    protocol: HostedProtocol;
+    externalId: string;
+    externalUrl: string;
+    content: string;
+    publishedAt: string;
+    isNsfw: boolean;
+    sourceVisibility: 'public' | 'unlisted';
+    contentHash: string;
+}
+export interface PublishHostedPostInput extends PreviewHostedPostInput {
+    contentHash: string;
+    /** 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. */
     hostedServers(): Promise<SingleResponse<HostedProtocolConnections>>;
+    /** Private connections belonging only to the signed-in person in the key's app. */
+    hostedIdentities(): Promise<SingleResponse<Array<HostedProtocolIdentity & {
+        configured: boolean;
+    }>>>;
+    /** Request a short-lived, single-use proof bound to this app, account and relay. */
+    hostedNostrChallenge(): Promise<SingleResponse<HostedNostrChallenge>>;
+    connectHostedIdentity(input: ConnectHostedIdentityInput): Promise<SingleResponse<HostedProtocolIdentity>>;
+    disconnectHostedIdentity(id: string): Promise<SingleResponse<{
+        disconnected: true;
+    }>>;
+    /** Preview one owned native text post. Does not create a Minds post. */
+    previewHostedPost(id: string, input: PreviewHostedPostInput): Promise<SingleResponse<HostedPostPreview>>;
+    /** Refetch/recheck the preview and create one canonical, scoped app post. */
+    publishHostedPost(id: string, input: PublishHostedPostInput): Promise<SingleResponse<{
+        postId: string;
+        protocol: HostedProtocol;
+        externalId: string;
+    }>>;
     /** Get project-scoped unpublished candidate status (admin) */
     status(): Promise<SingleResponse<ProtocolCollectionStatus[]>>;
     /**

package/dist/resources/protocols.js

@@ -28,11 +28,44 @@ export const PROTOCOL_ADAPTER_MATURITIES = Object.freeze([
     'beta',
     'stable',
 ]);
+function hostedIdentityPath(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_identity_id', message: 'A valid hosted identity connection ID is required' });
+    }
+    return `/protocols/identities/${encodeURIComponent(id)}`;
+}
 export class ProtocolsResource {
     client;
     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');
@@ -41,6 +74,28 @@ export class ProtocolsResource {
     hostedServers() {
         return this.client.get('/protocols/servers');
     }
+    /** Private connections belonging only to the signed-in person in the key's app. */
+    hostedIdentities() {
+        return this.client.get('/protocols/identities');
+    }
+    /** Request a short-lived, single-use proof bound to this app, account and relay. */
+    hostedNostrChallenge() {
+        return this.client.post('/protocols/nostr-challenge', {});
+    }
+    connectHostedIdentity(input) {
+        return this.client.post('/protocols/identities', input);
+    }
+    async disconnectHostedIdentity(id) {
+        return this.client.delete(hostedIdentityPath(id));
+    }
+    /** Preview one owned native text post. Does not create a Minds post. */
+    async previewHostedPost(id, input) {
+        return this.client.post(`${hostedIdentityPath(id)}/posts/preview`, input);
+    }
+    /** Refetch/recheck the preview and create one canonical, scoped app post. */
+    async publishHostedPost(id, input) {
+        return this.client.post(`${hostedIdentityPath(id)}/posts`, input);
+    }
     /** Get project-scoped unpublished candidate status (admin) */
     status() {
         return this.client.get('/protocols/status');

package/package.json

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