@liveblocks/core 3.18.1 → 3.18.2

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.2";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -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,