@liveblocks/node 2.18.4-uns2 → 2.20.0

package/dist/index.js

@@ -3,7 +3,7 @@ import { detectDupes } from "@liveblocks/core";
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/node";
-var PKG_VERSION = "2.18.4-uns2";
+var PKG_VERSION = "2.20.0";
 var PKG_FORMAT = "esm";
 
 // src/client.ts
@@ -14,6 +14,7 @@ import {
   convertToThreadData,
   createUserNotificationSettings,
   objectToQuery,
+  tryParseJson,
   url as url2,
   urljoin
 } from "@liveblocks/core";
@@ -213,7 +214,7 @@ var Liveblocks = class {
     this.#secret = secret;
     this.#baseUrl = new URL(getBaseUrl(options.baseUrl));
   }
-  async #post(path, json) {
+  async #post(path, json, options) {
     const url3 = urljoin(this.#baseUrl, path);
     const headers = {
       Authorization: `Bearer ${this.#secret}`,
@@ -223,11 +224,12 @@ var Liveblocks = class {
     const res = await fetch(url3, {
       method: "POST",
       headers,
-      body: JSON.stringify(json)
+      body: JSON.stringify(json),
+      signal: options?.signal
     });
     return res;
   }
-  async #put(path, json) {
+  async #put(path, json, options) {
     const url3 = urljoin(this.#baseUrl, path);
     const headers = {
       Authorization: `Bearer ${this.#secret}`,
@@ -237,34 +239,48 @@ var Liveblocks = class {
     return await fetch(url3, {
       method: "PUT",
       headers,
-      body: JSON.stringify(json)
+      body: JSON.stringify(json),
+      signal: options?.signal
     });
   }
-  async #putBinary(path, body, params) {
+  async #putBinary(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();
-    return await fetch(url3, { method: "PUT", headers, body });
+    return await fetch(url3, {
+      method: "PUT",
+      headers,
+      body,
+      signal: options?.signal
+    });
   }
-  async #delete(path) {
+  async #delete(path, options) {
     const url3 = urljoin(this.#baseUrl, path);
     const headers = {
       Authorization: `Bearer ${this.#secret}`
     };
     const fetch = await fetchPolyfill();
-    const res = await fetch(url3, { method: "DELETE", headers });
+    const res = await fetch(url3, {
+      method: "DELETE",
+      headers,
+      signal: options?.signal
+    });
     return res;
   }
-  async #get(path, params) {
+  async #get(path, params, options) {
     const url3 = urljoin(this.#baseUrl, path, params);
     const headers = {
       Authorization: `Bearer ${this.#secret}`
     };
     const fetch = await fetchPolyfill();
-    const res = await fetch(url3, { method: "GET", headers });
+    const res = await fetch(url3, {
+      method: "GET",
+      headers,
+      signal: options?.signal
+    });
     return res;
   }
   /* -------------------------------------------------------------------------------------------------
@@ -362,9 +378,10 @@ var Liveblocks = class {
    * @param params.metadata (optional) A filter on metadata. Multiple metadata keys can be used to filter rooms.
    * @param params.groupIds (optional) A filter on groups accesses. Multiple groups can be used.
    * @param params.query (optional) A query to filter rooms by. It is based on our query language. You can filter by metadata and room ID.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A list of rooms.
    */
-  async getRooms(params = {}) {
+  async getRooms(params = {}, options) {
     const path = url2`/v2/rooms`;
     let query;
     if (typeof params.query === "string") {
@@ -386,10 +403,9 @@ var Liveblocks = class {
       ),
       query
     };
-    const res = await this.#get(path, queryParams);
+    const res = await this.#get(path, queryParams, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const rooms = data.data.map((room) => {
@@ -413,20 +429,24 @@ var Liveblocks = class {
    * @param params.groupsAccesses (optional) The group accesses for the room. Can contain a maximum of 100 entries. Key length has a limit of 40 characters.
    * @param params.usersAccesses (optional) The user accesses for the room. Can contain a maximum of 100 entries. Key length has a limit of 40 characters.
    * @param params.metadata (optional) The metadata for the room. Supports upto a maximum of 50 entries. Key length has a limit of 40 characters. Value length has a limit of 256 characters.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The created room.
    */
-  async createRoom(roomId, params) {
+  async createRoom(roomId, params, options) {
     const { defaultAccesses, groupsAccesses, usersAccesses, metadata } = params;
-    const res = await this.#post(url2`/v2/rooms`, {
-      id: roomId,
-      defaultAccesses,
-      groupsAccesses,
-      usersAccesses,
-      metadata
-    });
+    const res = await this.#post(
+      url2`/v2/rooms`,
+      {
+        id: roomId,
+        defaultAccesses,
+        groupsAccesses,
+        usersAccesses,
+        metadata
+      },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const lastConnectionAt = data.lastConnectionAt ? new Date(data.lastConnectionAt) : void 0;
@@ -441,12 +461,12 @@ var Liveblocks = class {
    * Returns a room with the given id.
    * @param roomId The id of the room to return.
    * @returns The room with the given id.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async getRoom(roomId) {
-    const res = await this.#get(url2`/v2/rooms/${roomId}`);
+  async getRoom(roomId, options) {
+    const res = await this.#get(url2`/v2/rooms/${roomId}`, void 0, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const lastConnectionAt = data.lastConnectionAt ? new Date(data.lastConnectionAt) : void 0;
@@ -465,19 +485,23 @@ var Liveblocks = class {
    * @param params.groupsAccesses (optional) The group accesses for the room. Can contain a maximum of 100 entries. Key length has a limit of 40 characters.
    * @param params.usersAccesses (optional) The user accesses for the room. Can contain a maximum of 100 entries. Key length has a limit of 40 characters.
    * @param params.metadata (optional) The metadata for the room. Supports upto a maximum of 50 entries. Key length has a limit of 40 characters. Value length has a limit of 256 characters.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The updated room.
    */
-  async updateRoom(roomId, params) {
+  async updateRoom(roomId, params, options) {
     const { defaultAccesses, groupsAccesses, usersAccesses, metadata } = params;
-    const res = await this.#post(url2`/v2/rooms/${roomId}`, {
-      defaultAccesses,
-      groupsAccesses,
-      usersAccesses,
-      metadata
-    });
+    const res = await this.#post(
+      url2`/v2/rooms/${roomId}`,
+      {
+        defaultAccesses,
+        groupsAccesses,
+        usersAccesses,
+        metadata
+      },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const lastConnectionAt = data.lastConnectionAt ? new Date(data.lastConnectionAt) : void 0;
@@ -491,24 +515,28 @@ var Liveblocks = class {
   /**
    * Deletes a room with the given id. A deleted room is no longer accessible from the API or the dashboard and it cannot be restored.
    * @param roomId The id of the room to delete.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteRoom(roomId) {
-    const res = await this.#delete(url2`/v2/rooms/${roomId}`);
+  async deleteRoom(roomId, options) {
+    const res = await this.#delete(url2`/v2/rooms/${roomId}`, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Returns a list of users currently present in the requested room. For better performance, we recommand to call this endpoint every 10 seconds maximum. Duplicates can happen if a user is in the requested room with multiple browser tabs opened.
    * @param roomId The id of the room to get the users from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A list of users currently present in the requested room.
    */
-  async getActiveUsers(roomId) {
-    const res = await this.#get(url2`/v2/rooms/${roomId}/active_users`);
+  async getActiveUsers(roomId, options) {
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/active_users`,
+      void 0,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -516,22 +544,26 @@ var Liveblocks = class {
    * Boadcasts an event to a room without having to connect to it via the client from @liveblocks/client. The connectionId passed to event listeners is -1 when using this API.
    * @param roomId The id of the room to broadcast the event to.
    * @param message The message to broadcast. It can be any JSON serializable value.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async broadcastEvent(roomId, message) {
+  async broadcastEvent(roomId, message, options) {
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/broadcast_event`,
-      message
+      message,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
-  async getStorageDocument(roomId, format = "plain-lson") {
-    const res = await this.#get(url2`/v2/rooms/${roomId}/storage`, { format });
+  async getStorageDocument(roomId, format = "plain-lson", options) {
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/storage`,
+      { format },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -541,25 +573,29 @@ var Liveblocks = class {
    *
    * @param roomId The id of the room to initialize the storage from.
    * @param document The document to initialize the storage with.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The initialized storage document. It is of the same format as the one passed in.
    */
-  async initializeStorageDocument(roomId, document) {
-    const res = await this.#post(url2`/v2/rooms/${roomId}/storage`, document);
+  async initializeStorageDocument(roomId, document, options) {
+    const res = await this.#post(
+      url2`/v2/rooms/${roomId}/storage`,
+      document,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
   /**
    * Deletes all of the room’s Storage data and disconnect all users from the room if there are any. Note that this does not delete the Yjs document in the room if one exists.
    * @param roomId The id of the room to delete the storage from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteStorageDocument(roomId) {
-    const res = await this.#delete(url2`/v2/rooms/${roomId}/storage`);
+  async deleteStorageDocument(roomId, options) {
+    const res = await this.#delete(url2`/v2/rooms/${roomId}/storage`, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /* -------------------------------------------------------------------------------------------------
@@ -571,19 +607,19 @@ var Liveblocks = class {
    * @param params.format (optional) If true, YText will return formatting.
    * @param params.key (optional) If provided, returns only a single key’s value, e.g. doc.get(key).toJSON().
    * @param params.type (optional) Used with key to override the inferred type, i.e. "ymap" will return doc.get(key, Y.Map).
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A JSON representation of the room’s Yjs document.
    */
-  async getYjsDocument(roomId, params = {}) {
+  async getYjsDocument(roomId, params = {}, options) {
     const { format, key, type } = params;
     const path = url2`v2/rooms/${roomId}/ydoc`;
-    const res = await this.#get(path, {
-      formatting: format ? "true" : void 0,
-      key,
-      type
-    });
+    const res = await this.#get(
+      path,
+      { formatting: format ? "true" : void 0, key, type },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -592,14 +628,17 @@ var Liveblocks = class {
    * @param roomId The id of the room to send the Yjs binary update to.
    * @param update The Yjs update to send. Typically the result of calling `Yjs.encodeStateAsUpdate(doc)`. Read the [Yjs documentation](https://docs.yjs.dev/api/document-updates) to learn how to create a binary update.
    * @param params.guid (optional) If provided, the binary update will be applied to the Yjs subdocument with the given guid. If not provided, the binary update will be applied to the root Yjs document.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async sendYjsBinaryUpdate(roomId, update, params = {}) {
-    const res = await this.#putBinary(url2`/v2/rooms/${roomId}/ydoc`, update, {
-      guid: params.guid
-    });
+  async sendYjsBinaryUpdate(roomId, update, params = {}, options) {
+    const res = await this.#putBinary(
+      url2`/v2/rooms/${roomId}/ydoc`,
+      update,
+      { guid: params.guid },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
@@ -607,15 +646,17 @@ var Liveblocks = class {
    * See [Yjs documentation](https://docs.yjs.dev/api/document-updates) for more information on working with updates.
    * @param roomId The id of the room to get the Yjs document from.
    * @param params.guid (optional) If provided, returns the binary update of the Yjs subdocument with the given guid. If not provided, returns the binary update of the root Yjs document.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The room’s Yjs document encoded as a single binary update.
    */
-  async getYjsDocumentAsBinaryUpdate(roomId, params = {}) {
-    const res = await this.#get(url2`/v2/rooms/${roomId}/ydoc-binary`, {
-      guid: params.guid
-    });
+  async getYjsDocumentAsBinaryUpdate(roomId, params = {}, options) {
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/ydoc-binary`,
+      { guid: params.guid },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return res.arrayBuffer();
   }
@@ -626,16 +667,13 @@ var Liveblocks = class {
    * Creates a new schema which can be referenced later to enforce a room’s Storage data structure.
    * @param name The name used to reference the schema. Must be a non-empty string with less than 65 characters and only contain lowercase letters, numbers and dashes
    * @param body The exact allowed shape of data in the room. It is a multi-line string written in the [Liveblocks schema syntax](https://liveblocks.io/docs/platform/schema-validation/syntax).
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The created schema.
    */
-  async createSchema(name, body) {
-    const res = await this.#post(url2`/v2/schemas`, {
-      name,
-      body
-    });
+  async createSchema(name, body, options) {
+    const res = await this.#post(url2`/v2/schemas`, { name, body }, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const createdAt = new Date(data.createdAt);
@@ -649,13 +687,17 @@ var Liveblocks = class {
   /**
    * Returns a schema by its id.
    * @param schemaId Id of the schema - this is the combination of the schema name and version of the schema to update. For example, `my-schema@1`.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The schema with the given id.
    */
-  async getSchema(schemaId) {
-    const res = await this.#get(url2`/v2/schemas/${schemaId}`);
+  async getSchema(schemaId, options) {
+    const res = await this.#get(
+      url2`/v2/schemas/${schemaId}`,
+      void 0,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const createdAt = new Date(data.createdAt);
@@ -670,15 +712,17 @@ var Liveblocks = class {
    * Updates the body for the schema. A schema can only be updated if it is not used by any room.
    * @param schemaId Id of the schema - this is the combination of the schema name and version of the schema to update. For example, `my-schema@1`.
    * @param body The exact allowed shape of data in the room. It is a multi-line string written in the [Liveblocks schema syntax](https://liveblocks.io/docs/platform/schema-validation/syntax).
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The updated schema. The version of the schema will be incremented.
    */
-  async updateSchema(schemaId, body) {
-    const res = await this.#put(url2`/v2/schemas/${schemaId}`, {
-      body
-    });
+  async updateSchema(schemaId, body, options) {
+    const res = await this.#put(
+      url2`/v2/schemas/${schemaId}`,
+      { body },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const createdAt = new Date(data.createdAt);
@@ -692,24 +736,28 @@ var Liveblocks = class {
   /**
    * Deletes a schema by its id. A schema can only be deleted if it is not used by any room.
    * @param schemaId Id of the schema - this is the combination of the schema name and version of the schema to update. For example, `my-schema@1`.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteSchema(schemaId) {
-    const res = await this.#delete(url2`/v2/schemas/${schemaId}`);
+  async deleteSchema(schemaId, options) {
+    const res = await this.#delete(url2`/v2/schemas/${schemaId}`, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Returns the schema attached to a room.
    * @param roomId The id of the room to get the schema from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns
    */
-  async getSchemaByRoomId(roomId) {
-    const res = await this.#get(url2`/v2/rooms/${roomId}/schema`);
+  async getSchemaByRoomId(roomId, options) {
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/schema`,
+      void 0,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     const createdAt = new Date(data.createdAt);
@@ -725,27 +773,29 @@ var Liveblocks = class {
    * If the current contents of the room’s Storage do not match the schema, attaching will fail and the error message will give details on why the schema failed to attach.
    * @param roomId The id of the room to attach the schema to.
    * @param schemaId Id of the schema - this is the combination of the schema name and version of the schema to update. For example, `my-schema@1`.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The schema id as JSON.
    */
-  async attachSchemaToRoom(roomId, schemaId) {
-    const res = await this.#post(url2`/v2/rooms/${roomId}/schema`, {
-      schema: schemaId
-    });
+  async attachSchemaToRoom(roomId, schemaId, options) {
+    const res = await this.#post(
+      url2`/v2/rooms/${roomId}/schema`,
+      { schema: schemaId },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
   /**
    * Detaches a schema from a room, and disables runtime schema validation for the room.
    * @param roomId The id of the room to detach the schema from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async detachSchemaFromRoom(roomId) {
-    const res = await this.#delete(url2`/v2/rooms/${roomId}/schema`);
+  async detachSchemaFromRoom(roomId, options) {
+    const res = await this.#delete(url2`/v2/rooms/${roomId}/schema`, options);
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /* -------------------------------------------------------------------------------------------------
@@ -756,9 +806,10 @@ var Liveblocks = class {
    *
    * @param params.roomId The room ID to get the threads from.
    * @param params.query The query to filter threads by. It is based on our query language and can filter by metadata.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A list of threads.
    */
-  async getThreads(params) {
+  async getThreads(params, options) {
     const { roomId } = params;
     let query;
     if (typeof params.query === "string") {
@@ -766,12 +817,13 @@ var Liveblocks = class {
     } else if (typeof params.query === "object") {
       query = objectToQuery(params.query);
     }
-    const res = await this.#get(url2`/v2/rooms/${roomId}/threads`, {
-      query
-    });
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/threads`,
+      { query },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const { data } = await res.json();
     return {
@@ -783,14 +835,18 @@ var Liveblocks = class {
    *
    * @param params.roomId The room ID to get the thread from.
    * @param params.threadId The thread ID.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A thread.
    */
-  async getThread(params) {
+  async getThread(params, options) {
     const { roomId, threadId } = params;
-    const res = await this.#get(url2`/v2/rooms/${roomId}/threads/${threadId}`);
+    const res = await this.#get(
+      url2`/v2/rooms/${roomId}/threads/${threadId}`,
+      void 0,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToThreadData(await res.json());
   }
@@ -802,16 +858,18 @@ var Liveblocks = class {
    *
    * @param params.roomId The room ID to get the thread participants from.
    * @param params.threadId The thread ID to get the participants from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns An object containing an array of participant IDs.
    */
-  async getThreadParticipants(params) {
+  async getThreadParticipants(params, options) {
     const { roomId, threadId } = params;
     const res = await this.#get(
-      url2`/v2/rooms/${roomId}/threads/${threadId}/participants`
+      url2`/v2/rooms/${roomId}/threads/${threadId}/participants`,
+      void 0,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -821,16 +879,18 @@ var Liveblocks = class {
    * @param params.roomId The room ID to get the comment from.
    * @param params.threadId The thread ID to get the comment from.
    * @param params.commentId The comment ID.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns A comment.
    */
-  async getComment(params) {
+  async getComment(params, options) {
     const { roomId, threadId, commentId } = params;
     const res = await this.#get(
-      url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}`
+      url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}`,
+      void 0,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToCommentData(await res.json());
   }
@@ -842,20 +902,21 @@ 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 options.signal (optional) An abort signal to cancel the request.
    * @returns The created comment.
    */
-  async createComment(params) {
+  async createComment(params, options) {
     const { roomId, threadId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/comments`,
       {
         ...data,
         createdAt: data.createdAt?.toISOString()
-      }
+      },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToCommentData(await res.json());
   }
@@ -866,20 +927,18 @@ var Liveblocks = class {
    * @param params.commentId The comment ID to edit.
    * @param params.data.body The body of the comment.
    * @param params.data.editedAt (optional) The date the comment was edited.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The edited comment.
    */
-  async editComment(params) {
+  async editComment(params, options) {
     const { roomId, threadId, commentId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}`,
-      {
-        ...data,
-        editedAt: data.editedAt?.toISOString()
-      }
+      { ...data, editedAt: data.editedAt?.toISOString() },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToCommentData(await res.json());
   }
@@ -888,15 +947,16 @@ var Liveblocks = class {
    * @param params.roomId The room ID to delete the comment in.
    * @param params.threadId The thread ID to delete the comment in.
    * @param params.commentId The comment ID to delete.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteComment(params) {
+  async deleteComment(params, options) {
     const { roomId, threadId, commentId } = params;
     const res = await this.#delete(
-      url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}`
+      url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
@@ -907,20 +967,24 @@ 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 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.
    */
-  async createThread(params) {
+  async createThread(params, options) {
     const { roomId, data } = params;
-    const res = await this.#post(url2`/v2/rooms/${roomId}/threads`, {
-      ...data,
-      comment: {
-        ...data.comment,
-        createdAt: data.comment.createdAt?.toISOString()
-      }
-    });
+    const res = await this.#post(
+      url2`/v2/rooms/${roomId}/threads`,
+      {
+        ...data,
+        comment: {
+          ...data.comment,
+          createdAt: data.comment.createdAt?.toISOString()
+        }
+      },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToThreadData(await res.json());
   }
@@ -928,15 +992,16 @@ var Liveblocks = class {
    * Deletes a thread and all of its comments.
    * @param params.roomId The room ID to delete the thread in.
    * @param params.threadId The thread ID to delete.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteThread(params) {
+  async deleteThread(params, options) {
     const { roomId, threadId } = params;
     const res = await this.#delete(
-      url2`/v2/rooms/${roomId}/threads/${threadId}`
+      url2`/v2/rooms/${roomId}/threads/${threadId}`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
@@ -944,17 +1009,18 @@ var Liveblocks = class {
    * @param params.roomId The room ID of the thread.
    * @param params.threadId The thread ID to mark as resolved.
    * @param params.data.userId The user ID of the user who marked the thread as resolved.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The thread marked as resolved.
    */
-  async markThreadAsResolved(params) {
+  async markThreadAsResolved(params, options) {
     const { roomId, threadId } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/mark-as-resolved`,
-      {}
+      {},
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToThreadData(await res.json());
   }
@@ -963,17 +1029,18 @@ var Liveblocks = class {
    * @param params.roomId The room ID of the thread.
    * @param params.threadId The thread ID to mark as unresolved.
    * @param params.data.userId The user ID of the user who marked the thread as unresolved.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The thread marked as unresolved.
    */
-  async markThreadAsUnresolved(params) {
+  async markThreadAsUnresolved(params, options) {
     const { roomId, threadId } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/mark-as-unresolved`,
-      {}
+      {},
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToThreadData(await res.json());
   }
@@ -984,20 +1051,21 @@ var Liveblocks = class {
    * @param params.data.metadata The metadata for the thread. Value must be a string, boolean or number
    * @param params.data.userId The user ID of the user who updated the thread.
    * @param params.data.updatedAt (optional) The date the thread is set to be updated.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The updated thread metadata.
    */
-  async editThreadMetadata(params) {
+  async editThreadMetadata(params, options) {
     const { roomId, threadId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/metadata`,
       {
         ...data,
         updatedAt: data.updatedAt?.toISOString()
-      }
+      },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -1009,20 +1077,21 @@ var Liveblocks = class {
    * @param params.data.emoji The (emoji) reaction to add.
    * @param params.data.userId The user ID of the user associated with the reaction.
    * @param params.data.createdAt (optional) The date the reaction is set to be created.
+   * @param options.signal (optional) An abort signal to cancel the request.
    * @returns The created comment reaction.
    */
-  async addCommentReaction(params) {
+  async addCommentReaction(params, options) {
     const { roomId, threadId, commentId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${commentId}/add-reaction`,
       {
         ...data,
         createdAt: data.createdAt?.toISOString()
-      }
+      },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const reaction = await res.json();
     return convertToCommentUserReaction(reaction);
@@ -1035,34 +1104,37 @@ var Liveblocks = class {
    * @param params.data.emoji The (emoji) reaction to remove.
    * @param params.data.userId The user ID of the user associated with the reaction.
    * @param params.data.removedAt (optional) The date the reaction is set to be removed.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async removeCommentReaction(params) {
+  async removeCommentReaction(params, options) {
     const { roomId, threadId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/threads/${threadId}/comments/${params.commentId}/remove-reaction`,
       {
         ...data,
         removedAt: data.removedAt?.toISOString()
-      }
+      },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Returns the inbox notifications for a user.
    * @param params.userId The user ID to get the inbox notifications from.
    * @param params.inboxNotificationId The ID of the inbox notification to get.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async getInboxNotification(params) {
+  async getInboxNotification(params, options) {
     const { userId, inboxNotificationId } = params;
     const res = await this.#get(
-      url2`/v2/users/${userId}/inbox-notifications/${inboxNotificationId}`
+      url2`/v2/users/${userId}/inbox-notifications/${inboxNotificationId}`,
+      void 0,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return convertToInboxNotificationData(
       await res.json()
@@ -1072,8 +1144,9 @@ var Liveblocks = class {
    * Returns the inbox notifications for a user.
    * @param params.userId The user ID to get the inbox notifications from.
    * @param params.query The query to filter inbox notifications by. It is based on our query language and can filter by unread.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async getInboxNotifications(params) {
+  async getInboxNotifications(params, options) {
     const { userId } = params;
     let query;
     if (typeof params.query === "string") {
@@ -1081,12 +1154,13 @@ var Liveblocks = class {
     } else if (typeof params.query === "object") {
       query = objectToQuery(params.query);
     }
-    const res = await this.#get(url2`/v2/users/${userId}/inbox-notifications`, {
-      query
-    });
+    const res = await this.#get(
+      url2`/v2/users/${userId}/inbox-notifications`,
+      { query },
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const { data } = await res.json();
     return {
@@ -1097,15 +1171,17 @@ var Liveblocks = class {
    * Gets the user's room notification settings.
    * @param params.userId The user ID to get the room notifications from.
    * @param params.roomId The room ID to get the room notification settings from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async getRoomNotificationSettings(params) {
+  async getRoomNotificationSettings(params, options) {
     const { userId, roomId } = params;
     const res = await this.#get(
-      url2`/v2/rooms/${roomId}/users/${userId}/notification-settings`
+      url2`/v2/rooms/${roomId}/users/${userId}/notification-settings`,
+      void 0,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -1114,16 +1190,17 @@ var Liveblocks = class {
    * @param params.userId The user ID to update the room notification settings for.
    * @param params.roomId The room ID to update the room notification settings for.
    * @param params.data The new room notification settings for the user.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async updateRoomNotificationSettings(params) {
+  async updateRoomNotificationSettings(params, options) {
     const { userId, roomId, data } = params;
     const res = await this.#post(
       url2`/v2/rooms/${roomId}/users/${userId}/notification-settings`,
-      data
+      data,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     return await res.json();
   }
@@ -1131,33 +1208,33 @@ var Liveblocks = class {
    * Delete the user's room notification settings.
    * @param params.userId The user ID to delete the room notification settings from.
    * @param params.roomId The room ID to delete the room notification settings from.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteRoomNotificationSettings(params) {
+  async deleteRoomNotificationSettings(params, options) {
     const { userId, roomId } = params;
     const res = await this.#delete(
-      url2`/v2/rooms/${roomId}/users/${userId}/notification-settings`
+      url2`/v2/rooms/${roomId}/users/${userId}/notification-settings`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Update a room ID.
    * @param params.roomId The current ID of the room.
    * @param params.newRoomId The new room ID.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async updateRoomId(params) {
+  async updateRoomId(params, options) {
     const { currentRoomId, newRoomId } = params;
     const res = await this.#post(
       url2`/v2/rooms/${currentRoomId}/update-room-id`,
-      {
-        newRoomId
-      }
+      { newRoomId },
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const data = await res.json();
     return {
@@ -1166,52 +1243,61 @@ var Liveblocks = class {
       lastConnectionAt: data.lastConnectionAt ? new Date(data.lastConnectionAt) : void 0
     };
   }
-  async triggerInboxNotification(params) {
-    const res = await this.#post(url2`/v2/inbox-notifications/trigger`, params);
+  async triggerInboxNotification(params, options) {
+    const res = await this.#post(
+      url2`/v2/inbox-notifications/trigger`,
+      params,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Deletes an inbox notification for a user.
    * @param params.userId The user ID for which to delete the inbox notification.
    * @param params.inboxNotificationId The ID of the inbox notification to delete.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteInboxNotification(params) {
+  async deleteInboxNotification(params, options) {
     const { userId, inboxNotificationId } = params;
     const res = await this.#delete(
-      url2`/v2/users/${userId}/inbox-notifications/${inboxNotificationId}`
+      url2`/v2/users/${userId}/inbox-notifications/${inboxNotificationId}`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Deletes all inbox notifications for a user.
    * @param params.userId The user ID for which to delete all the inbox notifications.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteAllInboxNotifications(params) {
+  async deleteAllInboxNotifications(params, options) {
     const { userId } = params;
     const res = await this.#delete(
-      url2`/v2/users/${userId}/inbox-notifications`
+      url2`/v2/users/${userId}/inbox-notifications`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
   /**
    * Get notification settings for a user for a project.
    * @param params.userId The user ID to get the notifications settings for.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async getNotificationSettings(params) {
+  async getNotificationSettings(params, options) {
     const { userId } = params;
-    const res = await this.#get(url2`/v2/users/${userId}/notification-settings`);
+    const res = await this.#get(
+      url2`/v2/users/${userId}/notification-settings`,
+      void 0,
+      options
+    );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const plainSettings = await res.json();
     const settings = createUserNotificationSettings(plainSettings);
@@ -1221,16 +1307,17 @@ var Liveblocks = class {
    * Update the user's notification settings.
    * @param params.userId The user ID to update the notification settings for.
    * @param params.data The new notification settings for the user.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async updateNotificationSettings(params) {
+  async updateNotificationSettings(params, options) {
     const { userId, data } = params;
     const res = await this.#post(
       url2`/v2/users/${userId}/notification-settings`,
-      data
+      data,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
     const plainSettings = await res.json();
     const settings = createUserNotificationSettings(plainSettings);
@@ -1239,24 +1326,51 @@ var Liveblocks = class {
   /**
    * Delete the user's notification settings
    * @param params.userId The user ID to update the notification settings for.
+   * @param options.signal (optional) An abort signal to cancel the request.
    */
-  async deleteNotificationSettings(params) {
+  async deleteNotificationSettings(params, options) {
     const { userId } = params;
     const res = await this.#delete(
-      url2`/v2/users/${userId}/notification-settings`
+      url2`/v2/users/${userId}/notification-settings`,
+      options
     );
     if (!res.ok) {
-      const text = await res.text();
-      throw new LiveblocksError(res.status, text);
+      throw await LiveblocksError.from(res);
     }
   }
 };
-var LiveblocksError = class extends Error {
+var LiveblocksError = class _LiveblocksError extends Error {
   status;
-  constructor(status, message = "") {
+  details;
+  constructor(message, status, details) {
     super(message);
     this.name = "LiveblocksError";
     this.status = status;
+    this.details = details;
+  }
+  toString() {
+    let msg = `${this.name}: ${this.message} (status ${this.status})`;
+    if (this.details) {
+      msg += `
+${this.details}`;
+    }
+    return msg;
+  }
+  static async from(res) {
+    const FALLBACK = "An error happened without an error message";
+    let text;
+    try {
+      text = await res.text();
+    } catch {
+      text = FALLBACK;
+    }
+    const obj = tryParseJson(text) ?? { message: text };
+    const message = obj.message || FALLBACK;
+    const details = [
+      obj.suggestion ? `Suggestion: ${String(obj.suggestion)}` : void 0,
+      obj.docs ? `See also: ${String(obj.docs)}` : void 0
+    ].filter(Boolean).join("\n") || void 0;
+    return new _LiveblocksError(message, res.status, details);
   }
 };