@liveblocks/node 3.23.0-exp2 → 3.23.0-exp4

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Permission, Json, DFMD, FeedCreateMetadata, RoomPermissions, RoomAccesses, OptionalTupleUnless, BaseUserMeta, DU, PartialUnless, UpdateRoomAccesses, DE, JsonObject, PlainLsonObject, ToJson, DS, QueryMetadata, DTM, ThreadVisibility, ThreadData, DCM, UserSubscriptionData, CommentData, BaseMetadata, CommentBody, Patchable, SubscriptionData, CommentUserReaction, InboxNotificationData, UserRoomSubscriptionSettings, RoomSubscriptionSettings, KDAD, DAD, NotificationSettings, PartialNotificationSettings, GroupScopes, GroupData, LiveObject, Awaitable, DFM, Feed, FeedUpdateMetadata, FeedMessage, NotificationChannel } from '@liveblocks/core';
-export { CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, LiveList, LiveMap, LiveObject, LiveStructure, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, RoomAccesses, RoomPermissions, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionsFromCommentBody, isNotificationChannelEnabled, stringifyCommentBody } from '@liveblocks/core';
+import { Permission, Json, DFMD, FeedCreateMetadata, RoomPermissions, RoomAccesses, OptionalTupleUnless, BaseUserMeta, DU, PartialUnless, UpdateRoomAccesses, DE, JsonObject, PlainLsonObject, ToJson, DS, QueryMetadata, DTM, ThreadVisibility, ThreadData, DCM, UserSubscriptionData, CommentData, BaseMetadata, CommentBody, Patchable, CommentAttachment, LiveFile, LiveFileReference, SubscriptionData, CommentUserReaction, InboxNotificationData, UserRoomSubscriptionSettings, RoomSubscriptionSettings, KDAD, DAD, NotificationSettings, PartialNotificationSettings, GroupScopes, GroupData, LiveObject, Awaitable, DFM, Feed, FeedUpdateMetadata, FeedMessage, NotificationChannel } from '@liveblocks/core';
+export { CommentAttachment, CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, LiveFile, LiveFileData, LiveList, LiveMap, LiveObject, LiveStructure, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, RoomAccesses, RoomPermissions, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionsFromCommentBody, isNotificationChannelEnabled, stringifyCommentBody } from '@liveblocks/core';
 import { IncomingHttpHeaders } from 'http';
 
 /**
@@ -102,6 +102,10 @@ type AttachmentWithUrl = {
     url: string;
     expiresAt: string;
 };
+type StorageFileUrl = {
+    url: string;
+    expiresAt: string;
+};
 type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
     roomId: string;
     data: {
@@ -110,6 +114,7 @@ type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
             userId: string;
             createdAt?: Date;
             body: CommentBody;
+            attachmentIds?: string[];
         } & PartialUnless<CM, {
             metadata: CM;
         }>;
@@ -124,6 +129,7 @@ type CreateCommentOptions<CM extends BaseMetadata> = {
         userId: string;
         createdAt?: Date;
         body: CommentBody;
+        attachmentIds?: string[];
     } & PartialUnless<CM, {
         metadata: CM;
     }>;
@@ -926,6 +932,7 @@ declare class Liveblocks {
      * @param params.data.userId The user ID of the user who is set to create the comment.
      * @param params.data.createdAt (optional) The date the comment is set to be created.
      * @param params.data.body The body of the comment.
+     * @param params.data.attachmentIds (optional) The attachment IDs to add to the comment.
      * @param params.data.metadata (optional) The metadata for the comment.
      * @param options.signal (optional) An abort signal to cancel the request.
      * @returns The created comment.
@@ -937,6 +944,7 @@ declare class Liveblocks {
      * @param params.threadId The thread ID to edit the comment in.
      * @param params.commentId The comment ID to edit.
      * @param params.data.body The body of the comment.
+     * @param params.data.attachmentIds (optional) The IDs of every attachment that should remain on the comment.
      * @param params.data.metadata (optional) The metadata for the comment. Value must be a string, boolean or number. Use null to delete a key.
      * @param params.data.editedAt (optional) The date the comment was edited.
      * @param options.signal (optional) An abort signal to cancel the request.
@@ -948,6 +956,7 @@ declare class Liveblocks {
         commentId: string;
         data: {
             body: CommentBody;
+            attachmentIds?: string[];
             metadata?: Patchable<CM>;
             editedAt?: Date;
         };
@@ -976,6 +985,28 @@ declare class Liveblocks {
         roomId: string;
         attachmentId: string;
     }, options?: RequestOptions): Promise<AttachmentWithUrl>;
+    /**
+     * Uploads an attachment that can be added to a comment.
+     *
+     * @param params.roomId The room ID to upload the attachment to.
+     * @param params.userId The user ID of the user uploading the attachment.
+     * @param params.file The file to upload.
+     * @param options.signal (optional) An abort signal to cancel the upload.
+     * @returns The uploaded attachment.
+     */
+    uploadAttachment(params: {
+        roomId: string;
+        userId: string;
+        file: File;
+    }, options?: RequestOptions): Promise<CommentAttachment>;
+    uploadFile(params: {
+        roomId: string;
+        file: File;
+    }, options?: RequestOptions): Promise<LiveFile>;
+    getFileUrl(params: {
+        roomId: string;
+        file: LiveFileReference;
+    }, options?: RequestOptions): Promise<StorageFileUrl>;
     /**
      * 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.
@@ -984,6 +1015,7 @@ declare class Liveblocks {
      * @param params.thread.comment.userId The user ID of the user who created the comment.
      * @param params.thread.comment.createdAt (optional) The date the comment was created.
      * @param params.thread.comment.body The body of the comment.
+     * @param params.thread.comment.attachmentIds (optional) The attachment IDs to add to the comment.
      * @param params.thread.comment.metadata (optional) The metadata for the comment.
      * @param options.signal (optional) An abort signal to cancel the request.
      * @returns The created thread. The thread will be created with the specified comment as its first comment.
@@ -2048,4 +2080,4 @@ declare function isCustomNotificationEvent(event: WebhookEvent): event is Custom
  */
 type RoomPermission = RoomPermissions;
 
-export { type AiCopilot, type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, type CreateAiCopilotOptions, type CreateFeedMessageOptions, type CreateFeedOptions, type CreateFileKnowledgeSourceOptions, type CreateRoomOptions, type CreateVersionHistorySnapshotResponse, type CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetVersionHistoryOptions, type GetWebKnowledgeSourceLinksOptions, type HistoryVersion, type InboxNotificationsQueryCriteria, type KnowledgeSource, Liveblocks, LiveblocksError, type LiveblocksOptions, type MassMutateStorageCallback, type MassMutateStorageOptions, type MutateStorageCallback, type MutateStorageOptions, type NotificationEvent, type Page, type PaginationOptions, type RoomCreatedEvent, type RoomData, type RoomDeletedEvent, type RoomPermission, type RoomUser, type RoomsQueryCriteria, type SetPresenceOptions, type StorageUpdatedEvent, type TextMentionNotificationEvent, type ThreadCreatedEvent, type ThreadDeletedEvent, type ThreadMarkedAsResolvedEvent, type ThreadMarkedAsUnresolvedEvent, type ThreadMetadataUpdatedEvent, type ThreadNotificationEvent, type ThreadParticipants, type UpdateAiCopilotOptions, type UpdateFeedMessageOptions, type UpdateFeedOptions, type UpdateRoomOptions, type UpsertRoomOptions, type UserEnteredEvent, type UserLeftEvent, type WebKnowledgeSourceLink, type WebhookEvent, WebhookHandler, type WebhookRequest, type YDocUpdatedEvent, isCustomNotificationEvent, isTextMentionNotificationEvent, isThreadNotificationEvent, markdownToCommentBody };
+export { type AiCopilot, type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, type CreateAiCopilotOptions, type CreateFeedMessageOptions, type CreateFeedOptions, type CreateFileKnowledgeSourceOptions, type CreateRoomOptions, type CreateVersionHistorySnapshotResponse, type CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetVersionHistoryOptions, type GetWebKnowledgeSourceLinksOptions, type HistoryVersion, type InboxNotificationsQueryCriteria, type KnowledgeSource, Liveblocks, LiveblocksError, type LiveblocksOptions, type MassMutateStorageCallback, type MassMutateStorageOptions, type MutateStorageCallback, type MutateStorageOptions, type NotificationEvent, type Page, type PaginationOptions, type RoomCreatedEvent, type RoomData, type RoomDeletedEvent, type RoomPermission, type RoomUser, type RoomsQueryCriteria, type SetPresenceOptions, type StorageFileUrl, type StorageUpdatedEvent, type TextMentionNotificationEvent, type ThreadCreatedEvent, type ThreadDeletedEvent, type ThreadMarkedAsResolvedEvent, type ThreadMarkedAsUnresolvedEvent, type ThreadMetadataUpdatedEvent, type ThreadNotificationEvent, type ThreadParticipants, type UpdateAiCopilotOptions, type UpdateFeedMessageOptions, type UpdateFeedOptions, type UpdateRoomOptions, type UpsertRoomOptions, type UserEnteredEvent, type UserLeftEvent, type WebKnowledgeSourceLink, type WebhookEvent, WebhookHandler, type WebhookRequest, type YDocUpdatedEvent, isCustomNotificationEvent, isTextMentionNotificationEvent, isThreadNotificationEvent, markdownToCommentBody };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Permission, Json, DFMD, FeedCreateMetadata, RoomPermissions, RoomAccesses, OptionalTupleUnless, BaseUserMeta, DU, PartialUnless, UpdateRoomAccesses, DE, JsonObject, PlainLsonObject, ToJson, DS, QueryMetadata, DTM, ThreadVisibility, ThreadData, DCM, UserSubscriptionData, CommentData, BaseMetadata, CommentBody, Patchable, SubscriptionData, CommentUserReaction, InboxNotificationData, UserRoomSubscriptionSettings, RoomSubscriptionSettings, KDAD, DAD, NotificationSettings, PartialNotificationSettings, GroupScopes, GroupData, LiveObject, Awaitable, DFM, Feed, FeedUpdateMetadata, FeedMessage, NotificationChannel } from '@liveblocks/core';
-export { CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, LiveList, LiveMap, LiveObject, LiveStructure, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, RoomAccesses, RoomPermissions, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionsFromCommentBody, isNotificationChannelEnabled, stringifyCommentBody } from '@liveblocks/core';
+import { Permission, Json, DFMD, FeedCreateMetadata, RoomPermissions, RoomAccesses, OptionalTupleUnless, BaseUserMeta, DU, PartialUnless, UpdateRoomAccesses, DE, JsonObject, PlainLsonObject, ToJson, DS, QueryMetadata, DTM, ThreadVisibility, ThreadData, DCM, UserSubscriptionData, CommentData, BaseMetadata, CommentBody, Patchable, CommentAttachment, LiveFile, LiveFileReference, SubscriptionData, CommentUserReaction, InboxNotificationData, UserRoomSubscriptionSettings, RoomSubscriptionSettings, KDAD, DAD, NotificationSettings, PartialNotificationSettings, GroupScopes, GroupData, LiveObject, Awaitable, DFM, Feed, FeedUpdateMetadata, FeedMessage, NotificationChannel } from '@liveblocks/core';
+export { CommentAttachment, CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, LiveFile, LiveFileData, LiveList, LiveMap, LiveObject, LiveStructure, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, RoomAccesses, RoomPermissions, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionsFromCommentBody, isNotificationChannelEnabled, stringifyCommentBody } from '@liveblocks/core';
 import { IncomingHttpHeaders } from 'http';
 
 /**
@@ -102,6 +102,10 @@ type AttachmentWithUrl = {
     url: string;
     expiresAt: string;
 };
+type StorageFileUrl = {
+    url: string;
+    expiresAt: string;
+};
 type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
     roomId: string;
     data: {
@@ -110,6 +114,7 @@ type CreateThreadOptions<TM extends BaseMetadata, CM extends BaseMetadata> = {
             userId: string;
             createdAt?: Date;
             body: CommentBody;
+            attachmentIds?: string[];
         } & PartialUnless<CM, {
             metadata: CM;
         }>;
@@ -124,6 +129,7 @@ type CreateCommentOptions<CM extends BaseMetadata> = {
         userId: string;
         createdAt?: Date;
         body: CommentBody;
+        attachmentIds?: string[];
     } & PartialUnless<CM, {
         metadata: CM;
     }>;
@@ -926,6 +932,7 @@ declare class Liveblocks {
      * @param params.data.userId The user ID of the user who is set to create the comment.
      * @param params.data.createdAt (optional) The date the comment is set to be created.
      * @param params.data.body The body of the comment.
+     * @param params.data.attachmentIds (optional) The attachment IDs to add to the comment.
      * @param params.data.metadata (optional) The metadata for the comment.
      * @param options.signal (optional) An abort signal to cancel the request.
      * @returns The created comment.
@@ -937,6 +944,7 @@ declare class Liveblocks {
      * @param params.threadId The thread ID to edit the comment in.
      * @param params.commentId The comment ID to edit.
      * @param params.data.body The body of the comment.
+     * @param params.data.attachmentIds (optional) The IDs of every attachment that should remain on the comment.
      * @param params.data.metadata (optional) The metadata for the comment. Value must be a string, boolean or number. Use null to delete a key.
      * @param params.data.editedAt (optional) The date the comment was edited.
      * @param options.signal (optional) An abort signal to cancel the request.
@@ -948,6 +956,7 @@ declare class Liveblocks {
         commentId: string;
         data: {
             body: CommentBody;
+            attachmentIds?: string[];
             metadata?: Patchable<CM>;
             editedAt?: Date;
         };
@@ -976,6 +985,28 @@ declare class Liveblocks {
         roomId: string;
         attachmentId: string;
     }, options?: RequestOptions): Promise<AttachmentWithUrl>;
+    /**
+     * Uploads an attachment that can be added to a comment.
+     *
+     * @param params.roomId The room ID to upload the attachment to.
+     * @param params.userId The user ID of the user uploading the attachment.
+     * @param params.file The file to upload.
+     * @param options.signal (optional) An abort signal to cancel the upload.
+     * @returns The uploaded attachment.
+     */
+    uploadAttachment(params: {
+        roomId: string;
+        userId: string;
+        file: File;
+    }, options?: RequestOptions): Promise<CommentAttachment>;
+    uploadFile(params: {
+        roomId: string;
+        file: File;
+    }, options?: RequestOptions): Promise<LiveFile>;
+    getFileUrl(params: {
+        roomId: string;
+        file: LiveFileReference;
+    }, options?: RequestOptions): Promise<StorageFileUrl>;
     /**
      * 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.
@@ -984,6 +1015,7 @@ declare class Liveblocks {
      * @param params.thread.comment.userId The user ID of the user who created the comment.
      * @param params.thread.comment.createdAt (optional) The date the comment was created.
      * @param params.thread.comment.body The body of the comment.
+     * @param params.thread.comment.attachmentIds (optional) The attachment IDs to add to the comment.
      * @param params.thread.comment.metadata (optional) The metadata for the comment.
      * @param options.signal (optional) An abort signal to cancel the request.
      * @returns The created thread. The thread will be created with the specified comment as its first comment.
@@ -2048,4 +2080,4 @@ declare function isCustomNotificationEvent(event: WebhookEvent): event is Custom
  */
 type RoomPermission = RoomPermissions;
 
-export { type AiCopilot, type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, type CreateAiCopilotOptions, type CreateFeedMessageOptions, type CreateFeedOptions, type CreateFileKnowledgeSourceOptions, type CreateRoomOptions, type CreateVersionHistorySnapshotResponse, type CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetVersionHistoryOptions, type GetWebKnowledgeSourceLinksOptions, type HistoryVersion, type InboxNotificationsQueryCriteria, type KnowledgeSource, Liveblocks, LiveblocksError, type LiveblocksOptions, type MassMutateStorageCallback, type MassMutateStorageOptions, type MutateStorageCallback, type MutateStorageOptions, type NotificationEvent, type Page, type PaginationOptions, type RoomCreatedEvent, type RoomData, type RoomDeletedEvent, type RoomPermission, type RoomUser, type RoomsQueryCriteria, type SetPresenceOptions, type StorageUpdatedEvent, type TextMentionNotificationEvent, type ThreadCreatedEvent, type ThreadDeletedEvent, type ThreadMarkedAsResolvedEvent, type ThreadMarkedAsUnresolvedEvent, type ThreadMetadataUpdatedEvent, type ThreadNotificationEvent, type ThreadParticipants, type UpdateAiCopilotOptions, type UpdateFeedMessageOptions, type UpdateFeedOptions, type UpdateRoomOptions, type UpsertRoomOptions, type UserEnteredEvent, type UserLeftEvent, type WebKnowledgeSourceLink, type WebhookEvent, WebhookHandler, type WebhookRequest, type YDocUpdatedEvent, isCustomNotificationEvent, isTextMentionNotificationEvent, isThreadNotificationEvent, markdownToCommentBody };
+export { type AiCopilot, type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, type CreateAiCopilotOptions, type CreateFeedMessageOptions, type CreateFeedOptions, type CreateFileKnowledgeSourceOptions, type CreateRoomOptions, type CreateVersionHistorySnapshotResponse, type CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetVersionHistoryOptions, type GetWebKnowledgeSourceLinksOptions, type HistoryVersion, type InboxNotificationsQueryCriteria, type KnowledgeSource, Liveblocks, LiveblocksError, type LiveblocksOptions, type MassMutateStorageCallback, type MassMutateStorageOptions, type MutateStorageCallback, type MutateStorageOptions, type NotificationEvent, type Page, type PaginationOptions, type RoomCreatedEvent, type RoomData, type RoomDeletedEvent, type RoomPermission, type RoomUser, type RoomsQueryCriteria, type SetPresenceOptions, type StorageFileUrl, type StorageUpdatedEvent, type TextMentionNotificationEvent, type ThreadCreatedEvent, type ThreadDeletedEvent, type ThreadMarkedAsResolvedEvent, type ThreadMarkedAsUnresolvedEvent, type ThreadMetadataUpdatedEvent, type ThreadNotificationEvent, type ThreadParticipants, type UpdateAiCopilotOptions, type UpdateFeedMessageOptions, type UpdateFeedOptions, type UpdateRoomOptions, type UpsertRoomOptions, type UserEnteredEvent, type UserLeftEvent, type WebKnowledgeSourceLink, type WebhookEvent, WebhookHandler, type WebhookRequest, type YDocUpdatedEvent, isCustomNotificationEvent, isTextMentionNotificationEvent, isThreadNotificationEvent, markdownToCommentBody };

package/dist/index.js

@@ -3,12 +3,14 @@ import { detectDupes } from "@liveblocks/core";
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/node";
-var PKG_VERSION = "3.23.0-exp2";
+var PKG_VERSION = "3.23.0-exp4";
 var PKG_FORMAT = "esm";
 
 // src/client.ts
 import {
+  autoRetry,
   checkBounds,
+  chunk,
   ClientMsgCode,
   convertToCommentData,
   convertToCommentUserReaction,
@@ -17,9 +19,13 @@ import {
   convertToSubscriptionData,
   convertToThreadData,
   convertToUserSubscriptionData,
+  createCommentAttachmentId,
   createManagedPool,
   createNotificationSettings,
+  createStorageFileId,
+  getLiveFileId,
   isPlainObject,
+  LiveFile,
   LiveObject,
   makeAbortController,
   normalizeRoomAccesses,
@@ -64,8 +70,8 @@ var LineStream = class extends TransformStream {
   constructor() {
     let buffer = "";
     super({
-      transform(chunk, controller) {
-        buffer += chunk;
+      transform(chunk2, controller) {
+        buffer += chunk2;
         if (buffer.includes("\n")) {
           const lines = buffer.split("\n");
           for (let i = 0; i < lines.length - 1; i++) {
@@ -289,6 +295,158 @@ var Session = class {
 };
 
 // src/client.ts
+var ROOM_FILE_PART_SIZE = 5 * 1024 * 1024;
+var ROOM_FILE_RETRY_ATTEMPTS = 10;
+var ROOM_FILE_RETRY_DELAYS = [
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3
+];
+async function uploadRoomFile({
+  file,
+  signal,
+  abortErrorMessage,
+  retryMultipartCompletion,
+  uploadSingle,
+  createMultipartUpload,
+  uploadMultipartPart,
+  completeMultipartUpload,
+  abortMultipartUpload
+}) {
+  const abortError = createAbortError(abortErrorMessage);
+  if (signal?.aborted) {
+    throw abortError;
+  }
+  const handleRetryError = (err) => {
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    return err instanceof LiveblocksError && err.status >= 400 && err.status < 500;
+  };
+  if (file.size <= ROOM_FILE_PART_SIZE) {
+    return autoRetry(
+      uploadSingle,
+      ROOM_FILE_RETRY_ATTEMPTS,
+      ROOM_FILE_RETRY_DELAYS,
+      handleRetryError
+    );
+  }
+  let uploadId;
+  const uploadedParts = [];
+  const multipartUpload = await autoRetry(
+    createMultipartUpload,
+    ROOM_FILE_RETRY_ATTEMPTS,
+    ROOM_FILE_RETRY_DELAYS,
+    handleRetryError
+  );
+  const partUploadController = new AbortController();
+  const partUploadSignal = partUploadController.signal;
+  const abortPartUploads = (reason) => {
+    partUploadController.abort(reason);
+  };
+  const handleExternalAbort = () => abortPartUploads();
+  if (signal?.aborted) {
+    handleExternalAbort();
+  } else {
+    signal?.addEventListener("abort", handleExternalAbort, { once: true });
+  }
+  try {
+    uploadId = multipartUpload.uploadId;
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    const batches = chunk(splitRoomFileIntoParts(file), 5);
+    for (const parts of batches) {
+      const firstPartUploadFailure = {};
+      const partUploads$ = [];
+      for (const { part, partNumber } of parts) {
+        partUploads$.push(
+          autoRetry(
+            () => uploadMultipartPart(
+              multipartUpload.uploadId,
+              partNumber,
+              part,
+              partUploadSignal
+            ),
+            ROOM_FILE_RETRY_ATTEMPTS,
+            ROOM_FILE_RETRY_DELAYS,
+            (error) => {
+              if (signal?.aborted) {
+                throw abortError;
+              }
+              return partUploadSignal.aborted || handleRetryError(error);
+            }
+          ).catch((error) => {
+            if (firstPartUploadFailure.value === void 0) {
+              firstPartUploadFailure.value = { error };
+              abortPartUploads(error);
+            }
+            throw error;
+          })
+        );
+      }
+      const settledPartUploads = await Promise.allSettled(partUploads$);
+      if (firstPartUploadFailure.value !== void 0) {
+        throw firstPartUploadFailure.value.error;
+      }
+      for (const settledPartUpload of settledPartUploads) {
+        if (settledPartUpload.status === "fulfilled") {
+          uploadedParts.push(settledPartUpload.value);
+        }
+      }
+    }
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    const sortedParts = uploadedParts.sort(
+      (a, b) => a.partNumber - b.partNumber
+    );
+    return retryMultipartCompletion ? autoRetry(
+      () => completeMultipartUpload(multipartUpload.uploadId, sortedParts),
+      ROOM_FILE_RETRY_ATTEMPTS,
+      ROOM_FILE_RETRY_DELAYS,
+      handleRetryError
+    ) : completeMultipartUpload(uploadId, sortedParts);
+  } catch (err) {
+    if (uploadId) {
+      try {
+        await abortMultipartUpload(uploadId);
+      } catch {
+      }
+    }
+    throw err;
+  } finally {
+    signal?.removeEventListener("abort", handleExternalAbort);
+  }
+}
+function splitRoomFileIntoParts(file) {
+  const parts = [];
+  let start = 0;
+  while (start < file.size) {
+    const end = Math.min(start + ROOM_FILE_PART_SIZE, file.size);
+    parts.push({
+      partNumber: parts.length + 1,
+      part: file.slice(start, end)
+    });
+    start = end;
+  }
+  return parts;
+}
+function createAbortError(message) {
+  if (typeof DOMException === "function") {
+    return new DOMException(message, "AbortError");
+  }
+  const err = new Error(message);
+  err.name = "AbortError";
+  return err;
+}
 function inflateRoomData(room) {
   const createdAt = new Date(room.createdAt);
   const lastConnectionAt = room.lastConnectionAt ? new Date(room.lastConnectionAt) : void 0;
@@ -359,8 +517,8 @@ var Liveblocks = class {
     this.#baseUrl = new URL(getBaseUrl(options.baseUrl));
     this.#localDev = !!options.baseUrl && /^https?:\/\/localhost[:/]/.test(options.baseUrl);
   }
-  async #post(path, json, options) {
-    const url3 = urljoin(this.#baseUrl, path);
+  async #post(path, json, options, params) {
+    const url3 = urljoin(this.#baseUrl, path, params);
     const headers = {
       Authorization: `Bearer ${this.#secret}`,
       "Content-Type": "application/json"
@@ -375,6 +533,12 @@ var Liveblocks = class {
     xwarn(res, "POST", path);
     return res;
   }
+  async #readJsonResponse(res) {
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+    return await res.json();
+  }
   async #patch(path, json, options) {
     const url3 = urljoin(this.#baseUrl, path);
     const headers = {
@@ -407,6 +571,22 @@ var Liveblocks = class {
     xwarn(res, "PUT", path);
     return res;
   }
+  async #putBlob(path, body, params, options) {
+    const url3 = urljoin(this.#baseUrl, path, params);
+    const headers = {
+      Authorization: `Bearer ${this.#secret}`,
+      "Content-Type": "application/octet-stream"
+    };
+    const fetch = await fetchPolyfill();
+    const res = await fetch(url3, {
+      method: "PUT",
+      headers,
+      body,
+      signal: options?.signal
+    });
+    xwarn(res, "PUT", path);
+    return res;
+  }
   async #delete(path, params, options) {
     const url3 = urljoin(this.#baseUrl, path, params);
     const headers = {
@@ -1174,6 +1354,7 @@ var Liveblocks = class {
    * @param params.data.userId The user ID of the user who is set to create the comment.
    * @param params.data.createdAt (optional) The date the comment is set to be created.
    * @param params.data.body The body of the comment.
+   * @param params.data.attachmentIds (optional) The attachment IDs to add to the comment.
    * @param params.data.metadata (optional) The metadata for the comment.
    * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The created comment.
@@ -1199,6 +1380,7 @@ var Liveblocks = class {
    * @param params.threadId The thread ID to edit the comment in.
    * @param params.commentId The comment ID to edit.
    * @param params.data.body The body of the comment.
+   * @param params.data.attachmentIds (optional) The IDs of every attachment that should remain on the comment.
    * @param params.data.metadata (optional) The metadata for the comment. Value must be a string, boolean or number. Use null to delete a key.
    * @param params.data.editedAt (optional) The date the comment was edited.
    * @param options.signal (optional) An abort signal to cancel the request.
@@ -1211,6 +1393,7 @@ var Liveblocks = class {
       {
         body: data.body,
         editedAt: data.editedAt?.toISOString(),
+        attachmentIds: data.attachmentIds,
         metadata: data.metadata
       },
       options
@@ -1258,6 +1441,137 @@ var Liveblocks = class {
     }
     return await res.json();
   }
+  /**
+   * Uploads an attachment that can be added to a comment.
+   *
+   * @param params.roomId The room ID to upload the attachment to.
+   * @param params.userId The user ID of the user uploading the attachment.
+   * @param params.file The file to upload.
+   * @param options.signal (optional) An abort signal to cancel the upload.
+   * @returns The uploaded attachment.
+   */
+  async uploadAttachment(params, options) {
+    const { roomId, userId, file } = params;
+    const attachmentId = createCommentAttachmentId();
+    return await uploadRoomFile({
+      file,
+      signal: options?.signal,
+      abortErrorMessage: `Upload of attachment ${attachmentId} was aborted.`,
+      retryMultipartCompletion: false,
+      uploadSingle: async () => {
+        const res = await this.#putBlob(
+          url2`/v2/rooms/${roomId}/attachments/${attachmentId}/upload/${file.name}`,
+          file,
+          { fileSize: file.size, userId },
+          options
+        );
+        return await this.#readJsonResponse(res);
+      },
+      createMultipartUpload: async () => {
+        const res = await this.#post(
+          url2`/v2/rooms/${roomId}/attachments/${attachmentId}/multipart/${file.name}`,
+          void 0,
+          options,
+          { fileSize: file.size }
+        );
+        return await this.#readJsonResponse(res);
+      },
+      uploadMultipartPart: async (uploadId, partNumber, part, signal) => {
+        const res = await this.#putBlob(
+          url2`/v2/rooms/${roomId}/attachments/${attachmentId}/multipart/${uploadId}/${String(partNumber)}`,
+          part,
+          void 0,
+          { signal }
+        );
+        return await this.#readJsonResponse(res);
+      },
+      completeMultipartUpload: async (uploadId, parts) => {
+        const res = await this.#post(
+          url2`/v2/rooms/${roomId}/attachments/${attachmentId}/multipart/${uploadId}/complete`,
+          { parts },
+          options,
+          { userId }
+        );
+        return await this.#readJsonResponse(res);
+      },
+      abortMultipartUpload: async (uploadId) => {
+        const res = await this.#delete(
+          url2`/v2/rooms/${roomId}/attachments/${attachmentId}/multipart/${uploadId}`
+        );
+        if (!res.ok) {
+          throw await LiveblocksError.from(res);
+        }
+      }
+    });
+  }
+  async uploadFile(params, options) {
+    const { roomId, file } = params;
+    const fileId = createStorageFileId();
+    const fileData = await uploadRoomFile({
+      file,
+      signal: options?.signal,
+      abortErrorMessage: `Upload of file ${fileId} was aborted.`,
+      retryMultipartCompletion: true,
+      uploadSingle: async () => {
+        const res = await this.#putBlob(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/upload/${file.name}`,
+          file,
+          { fileSize: file.size },
+          options
+        );
+        return await this.#readJsonResponse(res);
+      },
+      createMultipartUpload: async () => {
+        const res = await this.#post(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/multipart/${file.name}`,
+          void 0,
+          options,
+          { fileSize: file.size }
+        );
+        return await this.#readJsonResponse(res);
+      },
+      uploadMultipartPart: async (uploadId, partNumber, part, signal) => {
+        const res = await this.#putBlob(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}/${String(partNumber)}`,
+          part,
+          void 0,
+          { signal }
+        );
+        return await this.#readJsonResponse(res);
+      },
+      completeMultipartUpload: async (uploadId, parts) => {
+        const res = await this.#post(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}/complete`,
+          { parts },
+          options
+        );
+        return await this.#readJsonResponse(res);
+      },
+      abortMultipartUpload: async (uploadId) => {
+        const res = await this.#delete(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}`
+        );
+        if (!res.ok) {
+          throw await LiveblocksError.from(res);
+        }
+      }
+    });
+    return new LiveFile(fileData);
+  }
+  async getFileUrl(params, options) {
+    const { roomId, file } = params;
+    const fileId = getLiveFileId(file);
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/storage/files/${fileId}`,
+      void 0,
+      options
+    );
+    const storageFile = await this.#readJsonResponse(res);
+    return {
+      url: storageFile.url,
+      expiresAt: storageFile.expiresAt
+    };
+  }
   /**
    * 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.
@@ -1266,6 +1580,7 @@ var Liveblocks = class {
    * @param params.thread.comment.userId The user ID of the user who created the comment.
    * @param params.thread.comment.createdAt (optional) The date the comment was created.
    * @param params.thread.comment.body The body of the comment.
+   * @param params.thread.comment.attachmentIds (optional) The attachment IDs to add to the comment.
    * @param params.thread.comment.metadata (optional) The metadata for the comment.
    * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The created thread. The thread will be created with the specified comment as its first comment.
@@ -3078,6 +3393,7 @@ function isCustomNotificationEvent(event) {
 import {
   getMentionsFromCommentBody,
   isNotificationChannelEnabled,
+  LiveFile as LiveFile2,
   LiveList,
   LiveMap,
   LiveObject as LiveObject2,
@@ -3085,6 +3401,7 @@ import {
 } from "@liveblocks/core";
 detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 export {
+  LiveFile2 as LiveFile,
   LiveList,
   LiveMap,
   LiveObject2 as LiveObject,