@liveblocks/node 3.15.3 → 3.15.4

package/dist/index.d.cts

@@ -104,6 +104,15 @@ type Identity = {
 type ThreadParticipants = {
     participantIds: string[];
 };
+type AttachmentWithUrl = {
+    type: "attachment";
+    id: string;
+    mimeType: string;
+    name: string;
+    size: number;
+    url: string;
+    expiresAt: string;
+};
 type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
     roomId: string;
     data: {
@@ -901,6 +910,18 @@ declare class Liveblocks {
         threadId: string;
         commentId: string;
     }, options?: RequestOptions): Promise<void>;
+    /**
+     * Gets an attachment's metadata and a presigned download URL.
+     *
+     * @param params.roomId The room ID the attachment belongs to.
+     * @param params.attachmentId The attachment ID (starts with "at_").
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The attachment metadata including a presigned download URL.
+     */
+    getAttachment(params: {
+        roomId: string;
+        attachmentId: string;
+    }, options?: RequestOptions): Promise<AttachmentWithUrl>;
     /**
      * Creates a new thread. The thread will be created with the specified comment as its first comment.
      * If the thread already exists, a `LiveblocksError` will be thrown with status code 409.

package/dist/index.d.ts

@@ -104,6 +104,15 @@ type Identity = {
 type ThreadParticipants = {
     participantIds: string[];
 };
+type AttachmentWithUrl = {
+    type: "attachment";
+    id: string;
+    mimeType: string;
+    name: string;
+    size: number;
+    url: string;
+    expiresAt: string;
+};
 type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
     roomId: string;
     data: {
@@ -901,6 +910,18 @@ declare class Liveblocks {
         threadId: string;
         commentId: string;
     }, options?: RequestOptions): Promise<void>;
+    /**
+     * Gets an attachment's metadata and a presigned download URL.
+     *
+     * @param params.roomId The room ID the attachment belongs to.
+     * @param params.attachmentId The attachment ID (starts with "at_").
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The attachment metadata including a presigned download URL.
+     */
+    getAttachment(params: {
+        roomId: string;
+        attachmentId: string;
+    }, options?: RequestOptions): Promise<AttachmentWithUrl>;
     /**
      * Creates a new thread. The thread will be created with the specified comment as its first comment.
      * If the thread already exists, a `LiveblocksError` will be thrown with status code 409.

package/dist/index.js

@@ -3,7 +3,7 @@ import { detectDupes } from "@liveblocks/core";
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/node";
-var PKG_VERSION = "3.15.3";
+var PKG_VERSION = "3.15.4";
 var PKG_FORMAT = "esm";
 
 // src/client.ts
@@ -1126,6 +1126,26 @@ var Liveblocks = class {
       throw await LiveblocksError.from(res);
     }
   }
+  /**
+   * Gets an attachment's metadata and a presigned download URL.
+   *
+   * @param params.roomId The room ID the attachment belongs to.
+   * @param params.attachmentId The attachment ID (starts with "at_").
+   * @param options.signal (optional) An abort signal to cancel the request.
+   * @returns The attachment metadata including a presigned download URL.
+   */
+  async getAttachment(params, options) {
+    const { roomId, attachmentId } = params;
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/attachments/${attachmentId}`,
+      void 0,
+      options
+    );
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+    return await res.json();
+  }
   /**
    * Creates a new thread. The thread will be created with the specified comment as its first comment.
    * If the thread already exists, a `LiveblocksError` will be thrown with status code 409.