@recursiv/sdk 0.7.17 → 0.7.18

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 { 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,6 +129,69 @@ 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;
+}
 export declare class ProtocolsResource {
     private client;
     constructor(client: HttpClient);
@@ -136,6 +199,24 @@ export declare class ProtocolsResource {
     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,6 +28,12 @@ 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) {
@@ -41,6 +47,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.18",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",