@liveblocks/core 3.18.1 → 3.18.3-test1

package/dist/index.d.cts

@@ -1092,9 +1092,7 @@ type LiveNode = LiveStructure | LiveRegister<Json>;
  * A mapping of keys to Lson values. A Lson value is any valid JSON
  * value or a Live storage data structure (LiveMap, LiveList, etc.)
  */
-type LsonObject = {
-    [key: string]: Lson | undefined;
-};
+type LsonObject = Record<string, Lson | undefined>;
 /**
  * Helper type to convert any valid Lson type to the equivalent Json type.
  *
@@ -1110,8 +1108,10 @@ type LsonObject = {
  *   ToJson<LiveObject<{ a: number, b: LiveList<string>, c?: number }>>
  *                                      // { readonly a: null, readonly b: readonly string[], readonly c?: number }
  */
-type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I> ? readonly ToJson<I>[] : L extends LiveObject<infer O> ? ToJson<O> : L extends LiveMap<infer KS, infer V> ? {
-    readonly [P in KS]: ToJson<V>;
+type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I extends Lson> ? Lson extends I ? readonly ReadonlyJson[] : readonly ToJson<I>[] : L extends LiveObject<infer O extends LsonObject> ? LsonObject extends O ? ReadonlyJsonObject : {
+    readonly [K in keyof O]: ToJson<Exclude<O[K], undefined>> | (undefined extends O[K] ? undefined : never);
+} : L extends LiveMap<infer KS extends string, infer V extends Lson> ? Lson extends V ? ReadonlyJsonObject : {
+    readonly [K in KS]: ToJson<V>;
 } : L extends LsonObject ? string extends keyof L ? ReadonlyJsonObject : {
     readonly [K in keyof L]: ToJson<Exclude<L[K], undefined>> | (undefined extends L[K] ? undefined : never);
 } : L extends Json ? L : never;
@@ -3288,9 +3288,27 @@ interface History {
      * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
      */
     resume: () => void;
-    readonly [kInternal]: {
-        withoutHistory: <T>(fn: () => T) => T;
-    };
+    /**
+     * Executes a callback with history tracking temporarily disabled. Any
+     * storage mutations made inside the callback will be applied normally
+     * but will not appear on the undo/redo stacks.
+     *
+     * This is useful for background or async writes that should not be
+     * undoable, such as writing back results from an AI generation task
+     * or reconciling state from an external source.
+     *
+     * Returns the callback's return value. If the callback throws, the
+     * undo/redo stacks are left unchanged (as if the callback never ran).
+     *
+     * @example
+     * room.history.disable(() => {
+     *   root.set("generatedText", result);
+     * });
+     *
+     * @experimental This API is experimental and may change or be removed
+     * in a future release without following semver guarantees.
+     */
+    disable: <T>(fn: () => T) => T;
 }
 type HistoryEvent = {
     canUndo: boolean;

package/dist/index.d.ts

@@ -1092,9 +1092,7 @@ type LiveNode = LiveStructure | LiveRegister<Json>;
  * A mapping of keys to Lson values. A Lson value is any valid JSON
  * value or a Live storage data structure (LiveMap, LiveList, etc.)
  */
-type LsonObject = {
-    [key: string]: Lson | undefined;
-};
+type LsonObject = Record<string, Lson | undefined>;
 /**
  * Helper type to convert any valid Lson type to the equivalent Json type.
  *
@@ -1110,8 +1108,10 @@ type LsonObject = {
  *   ToJson<LiveObject<{ a: number, b: LiveList<string>, c?: number }>>
  *                                      // { readonly a: null, readonly b: readonly string[], readonly c?: number }
  */
-type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I> ? readonly ToJson<I>[] : L extends LiveObject<infer O> ? ToJson<O> : L extends LiveMap<infer KS, infer V> ? {
-    readonly [P in KS]: ToJson<V>;
+type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I extends Lson> ? Lson extends I ? readonly ReadonlyJson[] : readonly ToJson<I>[] : L extends LiveObject<infer O extends LsonObject> ? LsonObject extends O ? ReadonlyJsonObject : {
+    readonly [K in keyof O]: ToJson<Exclude<O[K], undefined>> | (undefined extends O[K] ? undefined : never);
+} : L extends LiveMap<infer KS extends string, infer V extends Lson> ? Lson extends V ? ReadonlyJsonObject : {
+    readonly [K in KS]: ToJson<V>;
 } : L extends LsonObject ? string extends keyof L ? ReadonlyJsonObject : {
     readonly [K in keyof L]: ToJson<Exclude<L[K], undefined>> | (undefined extends L[K] ? undefined : never);
 } : L extends Json ? L : never;
@@ -3288,9 +3288,27 @@ interface History {
      * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
      */
     resume: () => void;
-    readonly [kInternal]: {
-        withoutHistory: <T>(fn: () => T) => T;
-    };
+    /**
+     * Executes a callback with history tracking temporarily disabled. Any
+     * storage mutations made inside the callback will be applied normally
+     * but will not appear on the undo/redo stacks.
+     *
+     * This is useful for background or async writes that should not be
+     * undoable, such as writing back results from an AI generation task
+     * or reconciling state from an external source.
+     *
+     * Returns the callback's return value. If the callback throws, the
+     * undo/redo stacks are left unchanged (as if the callback never ran).
+     *
+     * @example
+     * room.history.disable(() => {
+     *   root.set("generatedText", result);
+     * });
+     *
+     * @experimental This API is experimental and may change or be removed
+     * in a future release without following semver guarantees.
+     */
+    disable: <T>(fn: () => T) => T;
 }
 type HistoryEvent = {
     canUndo: boolean;

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.18.1";
+var PKG_VERSION = "3.18.3-test1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -145,7 +145,7 @@ function makeBufferableEventSource() {
 // src/lib/freeze.ts
 var freeze = process.env.NODE_ENV === "production" ? (
   /* istanbul ignore next */
-  (x) => x
+  ((x) => x)
 ) : Object.freeze;
 
 // src/lib/utils.ts
@@ -182,7 +182,7 @@ function mapValues(obj, mapFn) {
 function tryParseJson(rawMessage) {
   try {
     return JSON.parse(rawMessage);
-  } catch (e) {
+  } catch {
     return void 0;
   }
 }
@@ -198,7 +198,7 @@ function b64decode(b64value) {
       }).join("")
     );
     return decodedValue;
-  } catch (err) {
+  } catch {
     return atob(b64value);
   }
 }
@@ -266,8 +266,8 @@ function partition(iterable, predicate) {
 }
 
 // src/lib/signals.ts
-var kSinks = Symbol("kSinks");
-var kTrigger = Symbol("kTrigger");
+var kSinks = /* @__PURE__ */ Symbol("kSinks");
+var kTrigger = /* @__PURE__ */ Symbol("kTrigger");
 var signalsToTrigger = null;
 var trackedReads = null;
 function batch(callback) {
@@ -412,7 +412,7 @@ var PatchableSignal = class extends Signal {
     super.set((old) => merge(old, patch));
   }
 };
-var INITIAL = Symbol();
+var INITIAL = /* @__PURE__ */ Symbol();
 var DerivedSignal = class _DerivedSignal extends AbstractSignal {
   #prevValue;
   #dirty;
@@ -1547,7 +1547,7 @@ function isUrl(string) {
   try {
     new URL(string);
     return true;
-  } catch (_) {
+  } catch {
     return false;
   }
 }
@@ -1976,7 +1976,7 @@ function createApiClient({
                 roomId
               })
             );
-          } catch (error4) {
+          } catch {
           }
         }
         throw error3;
@@ -2075,7 +2075,7 @@ function createApiClient({
             url`/v2/c/chats/${chatId}/attachments/${attachment.id}/multipart/${multipartUpload.uploadId}`,
             await authManager.getAuthValue({ requestedScope: "comments:read" })
           );
-        } catch (err2) {
+        } catch {
         }
         throw err;
       }
@@ -3874,7 +3874,7 @@ var ManagedSocket = class {
 };
 
 // src/internal.ts
-var kInternal = Symbol();
+var kInternal = /* @__PURE__ */ Symbol();
 
 // src/lib/IncrementalJsonParser.ts
 var EMPTY_OBJECT = Object.freeze({});
@@ -4328,7 +4328,7 @@ function createStore_forKnowledge() {
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-var kWILDCARD = Symbol("*");
+var kWILDCARD = /* @__PURE__ */ Symbol("*");
 function createStore_forTools() {
   const toolsByChatId\u03A3 = new DefaultMap(
     (_chatId) => {
@@ -8646,7 +8646,7 @@ function warnOnceIf(condition, message, key = message) {
 }
 
 // src/protocol/NotificationSettings.ts
-var kPlain = Symbol("notification-settings-plain");
+var kPlain = /* @__PURE__ */ Symbol("notification-settings-plain");
 function createNotificationSettings(plain) {
   const channels = [
     "email",
@@ -9558,7 +9558,7 @@ function createRoom(options, config) {
     }
     const canWrite = self.get()?.canWrite ?? true;
     const root = context.root;
-    withoutHistory(() => {
+    disableHistory(() => {
       for (const key in context.initialStorage) {
         if (root.get(key) === void 0) {
           if (canWrite) {
@@ -9843,6 +9843,7 @@ function createRoom(options, config) {
     return context.redoStack.length > 0;
   }
   function onHistoryChange() {
+    if (historyDisabled > 0) return;
     eventHub.history.notify({ canUndo: canUndo(), canRedo: canRedo() });
   }
   function onUserJoinedMessage(message) {
@@ -10632,14 +10633,24 @@ function createRoom(options, config) {
     }
     commitPausedHistoryToUndoStack();
   }
-  function withoutHistory(fn) {
-    const undoBefore = context.undoStack.length;
-    const redoBefore = context.redoStack.length;
+  let historyDisabled = 0;
+  function disableHistory(fn) {
+    const origUndo = context.undoStack;
+    const origRedo = context.redoStack;
+    const tempUndo = [];
+    const tempRedo = [];
+    context.undoStack = tempUndo;
+    context.redoStack = tempRedo;
+    historyDisabled++;
     try {
       return fn();
     } finally {
-      context.undoStack.length = undoBefore;
-      context.redoStack.length = redoBefore;
+      historyDisabled--;
+      if (context.undoStack !== tempUndo || context.redoStack !== tempRedo) {
+        throw new Error("unexpected stack swap during history.disable()");
+      }
+      context.undoStack = origUndo;
+      context.redoStack = origRedo;
     }
   }
   const syncSourceForStorage = config.createSyncSource();
@@ -10948,9 +10959,7 @@ function createRoom(options, config) {
         clear,
         pause: pauseHistory,
         resume: resumeHistory,
-        [kInternal]: {
-          withoutHistory
-        }
+        disable: disableHistory
       },
       fetchYDoc,
       fetchFeeds,