@liveblocks/core 3.1.0 → 3.1.1

package/dist/index.d.cts

@@ -630,6 +630,16 @@ type LiveObjectUpdates<TData extends LsonObject> = {
  */
 declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     #private;
+    /**
+     * Enable or disable detection of too large LiveObjects.
+     * When enabled, throws an error if LiveObject static data exceeds 128KB, which
+     * is the maximum value the server will be able to accept.
+     * By default, this behavior is disabled to avoid the runtime performance
+     * overhead on every LiveObject.set() or LiveObject.update() call.
+     *
+     * @experimental
+     */
+    static detectLargeObjects: boolean;
     /** @private Do not use this API directly */
     static _fromItems<O extends LsonObject>(items: IdTuple<SerializedCrdt>[], pool: ManagedPool): LiveObject<O>;
     constructor(obj?: O);

package/dist/index.d.ts

@@ -630,6 +630,16 @@ type LiveObjectUpdates<TData extends LsonObject> = {
  */
 declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     #private;
+    /**
+     * Enable or disable detection of too large LiveObjects.
+     * When enabled, throws an error if LiveObject static data exceeds 128KB, which
+     * is the maximum value the server will be able to accept.
+     * By default, this behavior is disabled to avoid the runtime performance
+     * overhead on every LiveObject.set() or LiveObject.update() call.
+     *
+     * @experimental
+     */
+    static detectLargeObjects: boolean;
     /** @private Do not use this API directly */
     static _fromItems<O extends LsonObject>(items: IdTuple<SerializedCrdt>[], pool: ManagedPool): LiveObject<O>;
     constructor(obj?: O);

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.1.0";
+var PKG_VERSION = "3.1.1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -3794,8 +3794,8 @@ function createStore_forTools() {
     return DerivedSignal.from(() => {
       return (
         // A tool that's registered and scoped to a specific chat ID...
-        (chatId !== void 0 ? toolsByChatId\u03A3.get(chatId)?.get(name) : void 0)?.get() ?? // ...or a globally registered tool
-        toolsByChatId\u03A3.getOrCreate(kWILDCARD).get(name)?.get()
+        (chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0)?.get() ?? // ...or a globally registered tool
+        toolsByChatId\u03A3.getOrCreate(kWILDCARD).getOrCreate(name).get()
       );
     });
   });
@@ -6768,9 +6768,20 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
 };
 
 // src/crdts/LiveObject.ts
+var MAX_LIVE_OBJECT_SIZE = 128 * 1024;
 var LiveObject = class _LiveObject extends AbstractCrdt {
   #map;
   #propToLastUpdate;
+  /**
+   * Enable or disable detection of too large LiveObjects.
+   * When enabled, throws an error if LiveObject static data exceeds 128KB, which
+   * is the maximum value the server will be able to accept.
+   * By default, this behavior is disabled to avoid the runtime performance
+   * overhead on every LiveObject.set() or LiveObject.update() call.
+   *
+   * @experimental
+   */
+  static detectLargeObjects = false;
   static #buildRootAndParentToChildren(items) {
     const parentToChildren = /* @__PURE__ */ new Map();
     let root = null;
@@ -7159,6 +7170,31 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
    */
   update(patch) {
     this._pool?.assertStorageIsWritable();
+    if (_LiveObject.detectLargeObjects) {
+      const data = {};
+      for (const [key, value] of this.#map) {
+        if (!isLiveNode(value)) {
+          data[key] = value;
+        }
+      }
+      for (const key of Object.keys(patch)) {
+        const value = patch[key];
+        if (value === void 0) continue;
+        if (!isLiveNode(value)) {
+          data[key] = value;
+        }
+      }
+      const jsonString = JSON.stringify(data);
+      const upperBoundSize = jsonString.length * 4;
+      if (upperBoundSize > MAX_LIVE_OBJECT_SIZE) {
+        const preciseSize = new TextEncoder().encode(jsonString).length;
+        if (preciseSize > MAX_LIVE_OBJECT_SIZE) {
+          throw new Error(
+            `LiveObject size exceeded limit: ${preciseSize} bytes > ${MAX_LIVE_OBJECT_SIZE} bytes. See https://liveblocks.io/docs/platform/limits#Liveblocks-Storage-limits`
+          );
+        }
+      }
+    }
     if (this._pool === void 0 || this._id === void 0) {
       for (const key in patch) {
         const newValue = patch[key];