@liveblocks/node 3.22.0-rc1 → 3.23.0-file1

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, LiveFile, LiveFileReference, 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, 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: {
@@ -311,6 +315,22 @@ type Page<T> = {
     nextCursor: string | null;
     data: T[];
 };
+type HistoryVersion = {
+    id: string;
+    createdAt: Date;
+    authors: {
+        id: string;
+    }[];
+};
+type GetVersionHistoryOptions = {
+    limit?: number;
+    cursor?: string;
+};
+type CreateVersionHistorySnapshotResponse = {
+    data: {
+        id: string;
+    };
+};
 type GetRoomsOptions = RoomsQueryCriteria & PaginationOptions;
 type GetInboxNotificationsOptions = InboxNotificationsQueryCriteria & PaginationOptions;
 type CreateRoomOptions = {
@@ -761,6 +781,43 @@ declare class Liveblocks {
     getYjsDocumentAsBinaryUpdate(roomId: string, params?: {
         guid?: string;
     }, options?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Returns the version history snapshots for the room, sorted by creation date from newest to oldest.
+     * @param roomId The ID of the room to get the version history from.
+     * @param params.limit (optional) The number of versions to return. The limit can range between 1 and 100, and defaults to 20.
+     * @param params.cursor (optional) A cursor used for pagination. Get the value from the `nextCursor` response of the previous page.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns A list of version history snapshots and the next page cursor.
+     */
+    getVersionHistory(roomId: string, params?: GetVersionHistoryOptions, options?: RequestOptions): Promise<Page<HistoryVersion>>;
+    /**
+     * Creates a new version history snapshot of the room, capturing both its Storage and Yjs documents.
+     * @param roomId The ID of the room to create a version history snapshot for.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The created version ID.
+     */
+    createVersionHistorySnapshot(roomId: string, options?: RequestOptions): Promise<CreateVersionHistorySnapshotResponse>;
+    /**
+     * Returns a specific version of the room's Yjs document encoded as a binary Yjs update.
+     * @param params.roomId The room ID to get the Yjs document version from.
+     * @param params.versionId The ID of the version to get.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The version's Yjs document encoded as a binary update.
+     */
+    getYjsVersion(params: {
+        roomId: string;
+        versionId: string;
+    }, options?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Permanently deletes a version from the room's history.
+     * @param params.roomId The room ID to delete the version in.
+     * @param params.versionId The ID of the version to delete.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     */
+    deleteVersion(params: {
+        roomId: string;
+        versionId: string;
+    }, options?: RequestOptions): Promise<void>;
     /**
      * Gets all the threads in a room.
      *
@@ -923,6 +980,14 @@ declare class Liveblocks {
         roomId: string;
         attachmentId: string;
     }, options?: RequestOptions): Promise<AttachmentWithUrl>;
+    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.
@@ -1995,4 +2060,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 CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetWebKnowledgeSourceLinksOptions, 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, LiveFile, LiveFileReference, 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, 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: {
@@ -311,6 +315,22 @@ type Page<T> = {
     nextCursor: string | null;
     data: T[];
 };
+type HistoryVersion = {
+    id: string;
+    createdAt: Date;
+    authors: {
+        id: string;
+    }[];
+};
+type GetVersionHistoryOptions = {
+    limit?: number;
+    cursor?: string;
+};
+type CreateVersionHistorySnapshotResponse = {
+    data: {
+        id: string;
+    };
+};
 type GetRoomsOptions = RoomsQueryCriteria & PaginationOptions;
 type GetInboxNotificationsOptions = InboxNotificationsQueryCriteria & PaginationOptions;
 type CreateRoomOptions = {
@@ -761,6 +781,43 @@ declare class Liveblocks {
     getYjsDocumentAsBinaryUpdate(roomId: string, params?: {
         guid?: string;
     }, options?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Returns the version history snapshots for the room, sorted by creation date from newest to oldest.
+     * @param roomId The ID of the room to get the version history from.
+     * @param params.limit (optional) The number of versions to return. The limit can range between 1 and 100, and defaults to 20.
+     * @param params.cursor (optional) A cursor used for pagination. Get the value from the `nextCursor` response of the previous page.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns A list of version history snapshots and the next page cursor.
+     */
+    getVersionHistory(roomId: string, params?: GetVersionHistoryOptions, options?: RequestOptions): Promise<Page<HistoryVersion>>;
+    /**
+     * Creates a new version history snapshot of the room, capturing both its Storage and Yjs documents.
+     * @param roomId The ID of the room to create a version history snapshot for.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The created version ID.
+     */
+    createVersionHistorySnapshot(roomId: string, options?: RequestOptions): Promise<CreateVersionHistorySnapshotResponse>;
+    /**
+     * Returns a specific version of the room's Yjs document encoded as a binary Yjs update.
+     * @param params.roomId The room ID to get the Yjs document version from.
+     * @param params.versionId The ID of the version to get.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     * @returns The version's Yjs document encoded as a binary update.
+     */
+    getYjsVersion(params: {
+        roomId: string;
+        versionId: string;
+    }, options?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Permanently deletes a version from the room's history.
+     * @param params.roomId The room ID to delete the version in.
+     * @param params.versionId The ID of the version to delete.
+     * @param options.signal (optional) An abort signal to cancel the request.
+     */
+    deleteVersion(params: {
+        roomId: string;
+        versionId: string;
+    }, options?: RequestOptions): Promise<void>;
     /**
      * Gets all the threads in a room.
      *
@@ -923,6 +980,14 @@ declare class Liveblocks {
         roomId: string;
         attachmentId: string;
     }, options?: RequestOptions): Promise<AttachmentWithUrl>;
+    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.
@@ -1995,4 +2060,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 CreateWebKnowledgeSourceOptions, type CustomNotificationEvent, type GetAiCopilotsOptions, type GetInboxNotificationsOptions, type GetKnowledgeSourcesOptions, type GetRoomsOptions, type GetWebKnowledgeSourceLinksOptions, 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.22.0-rc1";
+var PKG_VERSION = "3.23.0-file1";
 var PKG_FORMAT = "esm";
 
 // src/client.ts
 import {
+  autoRetry,
   checkBounds,
+  chunk,
   ClientMsgCode,
   convertToCommentData,
   convertToCommentUserReaction,
@@ -19,7 +21,10 @@ import {
   convertToUserSubscriptionData,
   createManagedPool,
   createNotificationSettings,
+  createStorageFileId,
+  getLiveFileId,
   isPlainObject,
+  LiveFile,
   LiveObject,
   makeAbortController,
   normalizeRoomAccesses,
@@ -64,8 +69,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 +294,120 @@ var Session = class {
 };
 
 // src/client.ts
+var STORAGE_FILE_PART_SIZE = 5 * 1024 * 1024;
+var STORAGE_FILE_RETRY_ATTEMPTS = 10;
+var STORAGE_FILE_RETRY_DELAYS = [
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3,
+  2e3
+];
+async function uploadStorageFile({
+  file,
+  signal,
+  abortErrorMessage,
+  uploadSingle,
+  createMultipartUpload,
+  uploadMultipartPart,
+  completeMultipartUpload,
+  abortMultipartUpload
+}) {
+  const abortError = createAbortError(abortErrorMessage);
+  if (signal?.aborted) {
+    throw abortError;
+  }
+  const handleRetryError = (err) => {
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    if (err instanceof LiveblocksError && err.status === 413) {
+      throw err;
+    }
+    return false;
+  };
+  if (file.size <= STORAGE_FILE_PART_SIZE) {
+    return autoRetry(
+      uploadSingle,
+      STORAGE_FILE_RETRY_ATTEMPTS,
+      STORAGE_FILE_RETRY_DELAYS,
+      handleRetryError
+    );
+  }
+  let uploadId;
+  const uploadedParts = [];
+  const multipartUpload = await autoRetry(
+    createMultipartUpload,
+    STORAGE_FILE_RETRY_ATTEMPTS,
+    STORAGE_FILE_RETRY_DELAYS,
+    handleRetryError
+  );
+  try {
+    uploadId = multipartUpload.uploadId;
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    const batches = chunk(splitStorageFileIntoParts(file), 5);
+    for (const parts of batches) {
+      const uploadedPartPromises = [];
+      for (const { part, partNumber } of parts) {
+        uploadedPartPromises.push(
+          autoRetry(
+            () => uploadMultipartPart(multipartUpload.uploadId, partNumber, part),
+            STORAGE_FILE_RETRY_ATTEMPTS,
+            STORAGE_FILE_RETRY_DELAYS,
+            handleRetryError
+          )
+        );
+      }
+      uploadedParts.push(...await Promise.all(uploadedPartPromises));
+    }
+    if (signal?.aborted) {
+      throw abortError;
+    }
+    return completeMultipartUpload(
+      multipartUpload.uploadId,
+      uploadedParts.sort((a, b) => a.partNumber - b.partNumber)
+    );
+  } catch (err) {
+    if (uploadId && isAbortOrTimeoutError(err)) {
+      try {
+        await abortMultipartUpload(uploadId);
+      } catch {
+      }
+    }
+    throw err;
+  }
+}
+function splitStorageFileIntoParts(file) {
+  const parts = [];
+  let start = 0;
+  while (start < file.size) {
+    const end = Math.min(start + STORAGE_FILE_PART_SIZE, file.size);
+    parts.push({
+      partNumber: parts.length + 1,
+      part: file.slice(start, end)
+    });
+    start = end;
+  }
+  return parts;
+}
+function isAbortOrTimeoutError(err) {
+  return err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+}
+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;
@@ -337,6 +456,12 @@ function inflateWebKnowledgeSourceLink(link) {
     lastIndexedAt: new Date(link.lastIndexedAt)
   };
 }
+function inflateHistoryVersion(version) {
+  return {
+    ...version,
+    createdAt: new Date(version.createdAt)
+  };
+}
 var Liveblocks = class {
   #secret;
   #baseUrl;
@@ -353,8 +478,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"
@@ -369,6 +494,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 = {
@@ -401,6 +532,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 = {
@@ -777,7 +924,7 @@ var Liveblocks = class {
    */
   async getActiveUsers(roomId, options) {
     const res = await this.#get(
-      url2`/v2/rooms/${roomId}/active_users`,
+      url2`/v2/rooms/${roomId}/active-users`,
       void 0,
       options
     );
@@ -794,7 +941,7 @@ var Liveblocks = class {
    */
   async broadcastEvent(roomId, message, options) {
     const res = await this.#post(
-      url2`/v2/rooms/${roomId}/broadcast_event`,
+      url2`/v2/rooms/${roomId}/broadcast-event`,
       message,
       options
     );
@@ -961,6 +1108,82 @@ var Liveblocks = class {
     }
     return res.arrayBuffer();
   }
+  /**
+   * Returns the version history snapshots for the room, sorted by creation date from newest to oldest.
+   * @param roomId The ID of the room to get the version history from.
+   * @param params.limit (optional) The number of versions to return. The limit can range between 1 and 100, and defaults to 20.
+   * @param params.cursor (optional) A cursor used for pagination. Get the value from the `nextCursor` response of the previous page.
+   * @param options.signal (optional) An abort signal to cancel the request.
+   * @returns A list of version history snapshots and the next page cursor.
+   */
+  async getVersionHistory(roomId, params = {}, options) {
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/versions`,
+      { limit: params.limit, cursor: params.cursor },
+      options
+    );
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+    const page = await res.json();
+    return {
+      nextCursor: page.nextCursor,
+      data: page.data.map(inflateHistoryVersion)
+    };
+  }
+  /**
+   * Creates a new version history snapshot of the room, capturing both its Storage and Yjs documents.
+   * @param roomId The ID of the room to create a version history snapshot for.
+   * @param options.signal (optional) An abort signal to cancel the request.
+   * @returns The created version ID.
+   */
+  async createVersionHistorySnapshot(roomId, options) {
+    const res = await this.#post(
+      url2`/v2/rooms/${roomId}/versions`,
+      {},
+      options
+    );
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+    return await res.json();
+  }
+  /**
+   * Returns a specific version of the room's Yjs document encoded as a binary Yjs update.
+   * @param params.roomId The room ID to get the Yjs document version from.
+   * @param params.versionId The ID of the version to get.
+   * @param options.signal (optional) An abort signal to cancel the request.
+   * @returns The version's Yjs document encoded as a binary update.
+   */
+  async getYjsVersion(params, options) {
+    const { roomId, versionId } = params;
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/versions/${versionId}/yjs`,
+      void 0,
+      options
+    );
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+    return res.arrayBuffer();
+  }
+  /**
+   * Permanently deletes a version from the room's history.
+   * @param params.roomId The room ID to delete the version in.
+   * @param params.versionId The ID of the version to delete.
+   * @param options.signal (optional) An abort signal to cancel the request.
+   */
+  async deleteVersion(params, options) {
+    const { roomId, versionId } = params;
+    const res = await this.#delete(
+      url2`/v2/rooms/${roomId}/versions/${versionId}`,
+      void 0,
+      options
+    );
+    if (!res.ok) {
+      throw await LiveblocksError.from(res);
+    }
+  }
   /* -------------------------------------------------------------------------------------------------
    * Comments
    * -----------------------------------------------------------------------------------------------*/
@@ -1176,6 +1399,73 @@ var Liveblocks = class {
     }
     return await res.json();
   }
+  async uploadFile(params, options) {
+    const { roomId, file } = params;
+    const fileId = createStorageFileId();
+    const fileData = await uploadStorageFile({
+      file,
+      signal: options?.signal,
+      abortErrorMessage: `Upload of file ${fileId} was aborted.`,
+      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) => {
+        const res = await this.#putBlob(
+          url2`/v2/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}/${String(partNumber)}`,
+          part,
+          void 0,
+          options
+        );
+        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.
@@ -1933,7 +2223,7 @@ var Liveblocks = class {
     try {
       const resp = await this.#requestStorageMutation(roomId, { signal });
       const { actor, nodes } = resp;
-      const pool = createManagedPool(roomId, {
+      const pool = createManagedPool({
         getCurrentConnectionId: () => actor,
         onDispatch: (ops, _reverse, _storageUpdates) => {
           if (ops.length === 0) return;
@@ -2999,10 +3289,12 @@ import {
   LiveList,
   LiveMap,
   LiveObject as LiveObject2,
+  LiveFile as LiveFile2,
   stringifyCommentBody
 } from "@liveblocks/core";
 detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 export {
+  LiveFile2 as LiveFile,
   LiveList,
   LiveMap,
   LiveObject2 as LiveObject,