@recursiv/sdk 0.7.48 → 0.7.49

package/dist/index.d.ts

@@ -144,7 +144,7 @@ export { UsersResource } from './resources/users.js';
 export { CommunitiesResource } from './resources/communities.js';
 export { ChatResource } from './resources/chat.js';
 export { E2eeResource } from './resources/e2ee.js';
-export type { E2eeDevice, E2eeEnvelope, E2eeEvent, E2eeKeyPackageStatus } from './resources/e2ee.js';
+export type { E2eeDevice, E2eeEnvelope, E2eeEvent, E2eeKeyPackageStatus, E2eeObjectDownload, E2eeObjectUpload } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
 export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';

package/dist/resources/communities.d.ts

@@ -8,6 +8,10 @@ export declare class CommunitiesResource {
     /** Get a community by ID */
     get(id: string): Promise<SingleResponse<CommunityDetail>>;
     /** List members of a community */
+    /** Groups related to this one, ranked by shared members; the caller's own groups are left out. */
+    related(id: string, params?: {
+        limit?: number;
+    }): Promise<PaginatedResponse<Community>>;
     members(id: string, params?: PaginationParams): Promise<PaginatedResponse<CommunityMember>>;
     /** Create a new community */
     create(input: CreateCommunityInput): Promise<SingleResponse<CreatedCommunity>>;

package/dist/resources/communities.js

@@ -12,6 +12,10 @@ export class CommunitiesResource {
         return this.client.get(`/communities/${id}`);
     }
     /** List members of a community */
+    /** Groups related to this one, ranked by shared members; the caller's own groups are left out. */
+    related(id, params) {
+        return this.client.get(`/communities/${encodeURIComponent(id)}/related`, params);
+    }
     members(id, params) {
         return this.client.get(`/communities/${id}/members`, params);
     }

package/dist/resources/e2ee.d.ts

@@ -43,6 +43,19 @@ export interface E2eeKeyPackageStatus {
  * Requires the `e2eeV2` network feature flag and a key acting as the account
  * owner (agent-scoped keys are refused). The realm is the network id.
  */
+/** A reserved encrypted attachment object: PUT exactly `length` bytes of ciphertext to `uploadUrl`, then complete it. */
+export interface E2eeObjectUpload {
+    reference: string;
+    uploadUrl: string;
+    uploadExpiresAt: string;
+    length: number;
+}
+/** A short-lived URL for a confirmed encrypted attachment object. */
+export interface E2eeObjectDownload {
+    reference: string;
+    downloadUrl: string;
+    length: number;
+}
 export declare class E2eeResource {
     private client;
     constructor(client: HttpClient);
@@ -109,4 +122,31 @@ export declare class E2eeResource {
     }): Promise<SingleResponse<{
         ackedSeq: number;
     }>>;
+    /**
+     * Reserve an encrypted attachment object in an encrypted conversation.
+     * `length` is the ciphertext size (recursiv-attachment-v1); the key never
+     * leaves the client, it travels inside the MLS message.
+     */
+    createObject(conversationId: string, input: {
+        device_id: string;
+        length: number;
+    }): Promise<SingleResponse<E2eeObjectUpload>>;
+    /** Confirm an upload; it counts only if the stored size equals the reserved length. */
+    completeObject(objectId: string, input: {
+        device_id: string;
+    }): Promise<SingleResponse<{
+        reference: string;
+        length: number;
+    }>>;
+    /** A short-lived download URL for a confirmed object in a conversation you can read. */
+    objectDownload(objectId: string, params: {
+        device_id: string;
+    }): Promise<SingleResponse<E2eeObjectDownload>>;
+    /** Remove an object you uploaded. Copies recipients already downloaded stay theirs. */
+    deleteObject(objectId: string, params: {
+        device_id: string;
+    }): Promise<SingleResponse<{
+        reference: string;
+        deleted: boolean;
+    }>>;
 }

package/dist/resources/e2ee.js

@@ -1,9 +1,3 @@
-/**
- * E2EE v2 ciphertext transport. The server relays envelopes and public
- * credentials only; encryption happens in the shared core on each device.
- * Requires the `e2eeV2` network feature flag and a key acting as the account
- * owner (agent-scoped keys are refused). The realm is the network id.
- */
 export class E2eeResource {
     client;
     constructor(client) {
@@ -44,4 +38,24 @@ export class E2eeResource {
     acknowledge(conversationId, input) {
         return this.client.post(`/e2ee/conversations/${encodeURIComponent(conversationId)}/ack`, input);
     }
+    /**
+     * Reserve an encrypted attachment object in an encrypted conversation.
+     * `length` is the ciphertext size (recursiv-attachment-v1); the key never
+     * leaves the client, it travels inside the MLS message.
+     */
+    createObject(conversationId, input) {
+        return this.client.post(`/e2ee/conversations/${encodeURIComponent(conversationId)}/objects`, input);
+    }
+    /** Confirm an upload; it counts only if the stored size equals the reserved length. */
+    completeObject(objectId, input) {
+        return this.client.post(`/e2ee/objects/${encodeURIComponent(objectId)}/complete`, input);
+    }
+    /** A short-lived download URL for a confirmed object in a conversation you can read. */
+    objectDownload(objectId, params) {
+        return this.client.get(`/e2ee/objects/${encodeURIComponent(objectId)}`, params);
+    }
+    /** Remove an object you uploaded. Copies recipients already downloaded stay theirs. */
+    deleteObject(objectId, params) {
+        return this.client.delete(`/e2ee/objects/${encodeURIComponent(objectId)}?device_id=${encodeURIComponent(params.device_id)}`);
+    }
 }

package/dist/resources/posts.d.ts

@@ -12,6 +12,11 @@ export declare class PostsResource {
     }>>>;
     /** List posts the authenticated caller has upvoted. */
     liked(params?: Pick<ListPostsParams, 'limit' | 'offset' | 'cursor'>): Promise<PaginatedResponse<Post>>;
+    /** Posts similar to this one (embedding neighbours), in the app's scope. */
+    similar(id: string, params?: {
+        limit?: number;
+        organization_id?: string;
+    }): Promise<PaginatedResponse<Post>>;
     /** Get a single post with replies */
     get(id: string): Promise<SingleResponse<PostDetail>>;
     /** Create a new post */

package/dist/resources/posts.js

@@ -15,6 +15,10 @@ export class PostsResource {
     liked(params) {
         return this.list({ ...params, liked: true });
     }
+    /** Posts similar to this one (embedding neighbours), in the app's scope. */
+    similar(id, params) {
+        return this.client.get(`/posts/${encodeURIComponent(id)}/similar`, params);
+    }
     /** Get a single post with replies */
     get(id) {
         return this.client.get(`/posts/${id}`);

package/package.json

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