@liveblocks/core 3.13.0 → 3.13.1-hackathon

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.13.0";
+var PKG_VERSION = "3.13.1-hackathon";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -3132,6 +3132,9 @@ var ServerMsgCode = Object.freeze({
   COMMENT_REACTION_ADDED: 405,
   COMMENT_REACTION_REMOVED: 406,
   COMMENT_METADATA_UPDATED: 409,
+  // For Agent Sessions
+  AGENT_SESSIONS: 501,
+  AGENT_MESSAGES: 503,
   // Error codes
   REJECT_STORAGE_OP: 299
   // Sent if a mutation was not allowed on the server (i.e. due to permissions, limit exceeded, etc)
@@ -8507,7 +8510,10 @@ var ClientMsgCode = Object.freeze({
   UPDATE_STORAGE: 201,
   // For Yjs support
   FETCH_YDOC: 300,
-  UPDATE_YDOC: 301
+  UPDATE_YDOC: 301,
+  // For Agent Sessions
+  FETCH_AGENT_SESSIONS: 500,
+  FETCH_AGENT_MESSAGES: 502
 });
 
 // src/refs/ManagedOthers.ts
@@ -8965,6 +8971,7 @@ function createRoom(options, config) {
     storageStatus: makeEventSource(),
     ydoc: makeEventSource(),
     comments: makeEventSource(),
+    agentSessions: makeEventSource(),
     roomWillDestroy: makeEventSource()
   };
   async function createTextMention(mentionId, mention) {
@@ -9575,6 +9582,45 @@ function createRoom(options, config) {
           eventHub.comments.notify(message);
           break;
         }
+        case ServerMsgCode.AGENT_SESSIONS: {
+          const agentSessionsMsg = message;
+          if (agentSessionsMsg.operation === "list") {
+            for (const [
+              requestId,
+              { resolve }
+            ] of pendingAgentSessionsRequests) {
+              resolve({
+                sessions: agentSessionsMsg.sessions,
+                nextCursor: agentSessionsMsg.nextCursor
+              });
+              pendingAgentSessionsRequests.delete(requestId);
+              break;
+            }
+          }
+          eventHub.agentSessions.notify(agentSessionsMsg);
+          break;
+        }
+        case ServerMsgCode.AGENT_MESSAGES: {
+          const agentMessagesMsg = message;
+          if (agentMessagesMsg.operation === "list") {
+            for (const [
+              requestId,
+              { resolve }
+            ] of pendingAgentMessagesRequests) {
+              const parsedRequestId = JSON.parse(requestId);
+              if (parsedRequestId.sessionId === agentMessagesMsg.sessionId) {
+                resolve({
+                  messages: agentMessagesMsg.messages,
+                  nextCursor: agentMessagesMsg.nextCursor
+                });
+                pendingAgentMessagesRequests.delete(requestId);
+                break;
+              }
+            }
+          }
+          eventHub.agentSessions.notify(agentMessagesMsg);
+          break;
+        }
         default:
           break;
       }
@@ -9676,6 +9722,8 @@ function createRoom(options, config) {
   }
   let _getStorage$ = null;
   let _resolveStoragePromise = null;
+  const pendingAgentSessionsRequests = /* @__PURE__ */ new Map();
+  const pendingAgentMessagesRequests = /* @__PURE__ */ new Map();
   function processInitialStorage(message) {
     const unacknowledgedOps = new Map(context.unacknowledgedOps);
     createOrUpdateRootFromMessage(message);
@@ -9743,6 +9791,65 @@ function createRoom(options, config) {
     }
     flushNowOrSoon();
   }
+  async function fetchAgentSessions(options2) {
+    const requestId = JSON.stringify({
+      cursor: _optionalChain([options2, 'optionalAccess', _194 => _194.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _195 => _195.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _196 => _196.limit]),
+      metadata: _optionalChain([options2, 'optionalAccess', _197 => _197.metadata])
+    });
+    const { promise, resolve, reject } = Promise_withResolvers();
+    pendingAgentSessionsRequests.set(requestId, { resolve, reject });
+    const message = {
+      type: ClientMsgCode.FETCH_AGENT_SESSIONS,
+      cursor: _optionalChain([options2, 'optionalAccess', _198 => _198.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _199 => _199.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _200 => _200.limit]),
+      metadata: _optionalChain([options2, 'optionalAccess', _201 => _201.metadata])
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+    setTimeout(() => {
+      if (pendingAgentSessionsRequests.has(requestId)) {
+        pendingAgentSessionsRequests.delete(requestId);
+        reject(new Error("Agent sessions fetch timeout"));
+      }
+    }, 3e4);
+    return promise;
+  }
+  async function fetchAgentMessages(sessionId, options2) {
+    const requestId = JSON.stringify({
+      sessionId,
+      cursor: _optionalChain([options2, 'optionalAccess', _202 => _202.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _203 => _203.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _204 => _204.limit])
+    });
+    const existingRequest = pendingAgentMessagesRequests.get(requestId);
+    if (existingRequest) {
+      return new Promise((resolve2, reject2) => {
+        existingRequest.resolve = resolve2;
+        existingRequest.reject = reject2;
+      });
+    }
+    const { promise, resolve, reject } = Promise_withResolvers();
+    pendingAgentMessagesRequests.set(requestId, { resolve, reject });
+    const message = {
+      type: ClientMsgCode.FETCH_AGENT_MESSAGES,
+      sessionId,
+      cursor: _optionalChain([options2, 'optionalAccess', _205 => _205.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _206 => _206.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _207 => _207.limit])
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+    setTimeout(() => {
+      if (pendingAgentMessagesRequests.has(requestId)) {
+        pendingAgentMessagesRequests.delete(requestId);
+        reject(new Error("Agent messages fetch timeout"));
+      }
+    }, 3e4);
+    return promise;
+  }
   function undo() {
     if (context.activeBatch) {
       throw new Error("undo is not allowed during a batch");
@@ -9885,6 +9992,7 @@ function createRoom(options, config) {
     storageStatus: eventHub.storageStatus.observable,
     ydoc: eventHub.ydoc.observable,
     comments: eventHub.comments.observable,
+    agentSessions: eventHub.agentSessions.observable,
     roomWillDestroy: eventHub.roomWillDestroy.observable
   };
   async function getThreadsSince(options2) {
@@ -9897,8 +10005,8 @@ function createRoom(options, config) {
   async function getThreads(options2) {
     return httpClient.getThreads({
       roomId,
-      query: _optionalChain([options2, 'optionalAccess', _194 => _194.query]),
-      cursor: _optionalChain([options2, 'optionalAccess', _195 => _195.cursor])
+      query: _optionalChain([options2, 'optionalAccess', _208 => _208.query]),
+      cursor: _optionalChain([options2, 'optionalAccess', _209 => _209.cursor])
     });
   }
   async function getThread(threadId) {
@@ -10020,7 +10128,7 @@ function createRoom(options, config) {
   function getSubscriptionSettings(options2) {
     return httpClient.getSubscriptionSettings({
       roomId,
-      signal: _optionalChain([options2, 'optionalAccess', _196 => _196.signal])
+      signal: _optionalChain([options2, 'optionalAccess', _210 => _210.signal])
     });
   }
   function updateSubscriptionSettings(settings) {
@@ -10042,7 +10150,7 @@ function createRoom(options, config) {
     {
       [kInternal]: {
         get presenceBuffer() {
-          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _197 => _197.buffer, 'access', _198 => _198.presenceUpdates, 'optionalAccess', _199 => _199.data]), () => ( null)));
+          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _211 => _211.buffer, 'access', _212 => _212.presenceUpdates, 'optionalAccess', _213 => _213.data]), () => ( null)));
         },
         // prettier-ignore
         get undoStack() {
@@ -10057,9 +10165,9 @@ function createRoom(options, config) {
           return context.yjsProvider;
         },
         setYjsProvider(newProvider) {
-          _optionalChain([context, 'access', _200 => _200.yjsProvider, 'optionalAccess', _201 => _201.off, 'call', _202 => _202("status", yjsStatusDidChange)]);
+          _optionalChain([context, 'access', _214 => _214.yjsProvider, 'optionalAccess', _215 => _215.off, 'call', _216 => _216("status", yjsStatusDidChange)]);
           context.yjsProvider = newProvider;
-          _optionalChain([newProvider, 'optionalAccess', _203 => _203.on, 'call', _204 => _204("status", yjsStatusDidChange)]);
+          _optionalChain([newProvider, 'optionalAccess', _217 => _217.on, 'call', _218 => _218("status", yjsStatusDidChange)]);
           context.yjsProviderDidChange.notify();
         },
         yjsProviderDidChange: context.yjsProviderDidChange.observable,
@@ -10093,7 +10201,7 @@ function createRoom(options, config) {
       id: roomId,
       subscribe: makeClassicSubscribeFn(
         roomId,
-        events,
+        eventHub,
         config.errorEventSource
       ),
       connect: () => managedSocket.connect(),
@@ -10105,7 +10213,7 @@ function createRoom(options, config) {
           source.dispose();
         }
         eventHub.roomWillDestroy.notify();
-        _optionalChain([context, 'access', _205 => _205.yjsProvider, 'optionalAccess', _206 => _206.off, 'call', _207 => _207("status", yjsStatusDidChange)]);
+        _optionalChain([context, 'access', _219 => _219.yjsProvider, 'optionalAccess', _220 => _220.off, 'call', _221 => _221("status", yjsStatusDidChange)]);
         syncSourceForStorage.destroy();
         syncSourceForYjs.destroy();
         uninstallBgTabSpy();
@@ -10128,6 +10236,8 @@ function createRoom(options, config) {
         resume: resumeHistory
       },
       fetchYDoc,
+      fetchAgentSessions,
+      fetchAgentMessages,
       getStorage,
       getStorageSnapshot,
       getStorageStatus,
@@ -10256,7 +10366,7 @@ function makeClassicSubscribeFn(roomId, events, errorEvents) {
     }
     if (isLiveNode(first)) {
       const node = first;
-      if (_optionalChain([options, 'optionalAccess', _208 => _208.isDeep])) {
+      if (_optionalChain([options, 'optionalAccess', _222 => _222.isDeep])) {
         const storageCallback = second;
         return subscribeToLiveStructureDeeply(node, storageCallback);
       } else {
@@ -10339,8 +10449,8 @@ function createClient(options) {
     const userId = token.k === "sec-legacy" /* SECRET_LEGACY */ ? token.id : token.uid;
     currentUserId.set(() => userId);
   });
-  const fetchPolyfill = _optionalChain([clientOptions, 'access', _209 => _209.polyfills, 'optionalAccess', _210 => _210.fetch]) || /* istanbul ignore next */
-  _optionalChain([globalThis, 'access', _211 => _211.fetch, 'optionalAccess', _212 => _212.bind, 'call', _213 => _213(globalThis)]);
+  const fetchPolyfill = _optionalChain([clientOptions, 'access', _223 => _223.polyfills, 'optionalAccess', _224 => _224.fetch]) || /* istanbul ignore next */
+  _optionalChain([globalThis, 'access', _225 => _225.fetch, 'optionalAccess', _226 => _226.bind, 'call', _227 => _227(globalThis)]);
   const httpClient = createApiClient({
     baseUrl,
     fetchPolyfill,
@@ -10358,7 +10468,7 @@ function createClient(options) {
     delegates: {
       createSocket: makeCreateSocketDelegateForAi(
         baseUrl,
-        _optionalChain([clientOptions, 'access', _214 => _214.polyfills, 'optionalAccess', _215 => _215.WebSocket])
+        _optionalChain([clientOptions, 'access', _228 => _228.polyfills, 'optionalAccess', _229 => _229.WebSocket])
       ),
       authenticate: async () => {
         const resp = await authManager.getAuthValue({
@@ -10420,7 +10530,7 @@ function createClient(options) {
           createSocket: makeCreateSocketDelegateForRoom(
             roomId,
             baseUrl,
-            _optionalChain([clientOptions, 'access', _216 => _216.polyfills, 'optionalAccess', _217 => _217.WebSocket]),
+            _optionalChain([clientOptions, 'access', _230 => _230.polyfills, 'optionalAccess', _231 => _231.WebSocket]),
             options2.engine
           ),
           authenticate: makeAuthDelegateForRoom(roomId, authManager)
@@ -10445,7 +10555,7 @@ function createClient(options) {
     const shouldConnect = _nullishCoalesce(options2.autoConnect, () => ( true));
     if (shouldConnect) {
       if (typeof atob === "undefined") {
-        if (_optionalChain([clientOptions, 'access', _218 => _218.polyfills, 'optionalAccess', _219 => _219.atob]) === void 0) {
+        if (_optionalChain([clientOptions, 'access', _232 => _232.polyfills, 'optionalAccess', _233 => _233.atob]) === void 0) {
           throw new Error(
             "You need to polyfill atob to use the client in your environment. Please follow the instructions at https://liveblocks.io/docs/errors/liveblocks-client/atob-polyfill"
           );
@@ -10457,7 +10567,7 @@ function createClient(options) {
     return leaseRoom(newRoomDetails);
   }
   function getRoom(roomId) {
-    const room = _optionalChain([roomsById, 'access', _220 => _220.get, 'call', _221 => _221(roomId), 'optionalAccess', _222 => _222.room]);
+    const room = _optionalChain([roomsById, 'access', _234 => _234.get, 'call', _235 => _235(roomId), 'optionalAccess', _236 => _236.room]);
     return room ? room : null;
   }
   function logout() {
@@ -10473,7 +10583,7 @@ function createClient(options) {
   const batchedResolveUsers = new Batch(
     async (batchedUserIds) => {
       const userIds = batchedUserIds.flat();
-      const users = await _optionalChain([resolveUsers, 'optionalCall', _223 => _223({ userIds })]);
+      const users = await _optionalChain([resolveUsers, 'optionalCall', _237 => _237({ userIds })]);
       warnOnceIf(
         !resolveUsers,
         "Set the resolveUsers option in createClient to specify user info."
@@ -10490,7 +10600,7 @@ function createClient(options) {
   const batchedResolveRoomsInfo = new Batch(
     async (batchedRoomIds) => {
       const roomIds = batchedRoomIds.flat();
-      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _224 => _224({ roomIds })]);
+      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _238 => _238({ roomIds })]);
       warnOnceIf(
         !resolveRoomsInfo,
         "Set the resolveRoomsInfo option in createClient to specify room info."
@@ -10507,7 +10617,7 @@ function createClient(options) {
   const batchedResolveGroupsInfo = new Batch(
     async (batchedGroupIds) => {
       const groupIds = batchedGroupIds.flat();
-      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _225 => _225({ groupIds })]);
+      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _239 => _239({ groupIds })]);
       warnOnceIf(
         !resolveGroupsInfo,
         "Set the resolveGroupsInfo option in createClient to specify group info."
@@ -10563,7 +10673,7 @@ function createClient(options) {
       }
     };
     const win = typeof window !== "undefined" ? window : void 0;
-    _optionalChain([win, 'optionalAccess', _226 => _226.addEventListener, 'call', _227 => _227("beforeunload", maybePreventClose)]);
+    _optionalChain([win, 'optionalAccess', _240 => _240.addEventListener, 'call', _241 => _241("beforeunload", maybePreventClose)]);
   }
   async function getNotificationSettings(options2) {
     const plainSettings = await httpClient.getNotificationSettings(options2);
@@ -10690,7 +10800,7 @@ var commentBodyElementsTypes = {
   mention: "inline"
 };
 function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
-  if (!body || !_optionalChain([body, 'optionalAccess', _228 => _228.content])) {
+  if (!body || !_optionalChain([body, 'optionalAccess', _242 => _242.content])) {
     return;
   }
   const element = typeof elementOrVisitor === "string" ? elementOrVisitor : void 0;
@@ -10700,13 +10810,13 @@ function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
   for (const block of body.content) {
     if (type === "all" || type === "block") {
       if (guard(block)) {
-        _optionalChain([visitor, 'optionalCall', _229 => _229(block)]);
+        _optionalChain([visitor, 'optionalCall', _243 => _243(block)]);
       }
     }
     if (type === "all" || type === "inline") {
       for (const inline of block.children) {
         if (guard(inline)) {
-          _optionalChain([visitor, 'optionalCall', _230 => _230(inline)]);
+          _optionalChain([visitor, 'optionalCall', _244 => _244(inline)]);
         }
       }
     }
@@ -10876,7 +10986,7 @@ var stringifyCommentBodyPlainElements = {
   text: ({ element }) => element.text,
   link: ({ element }) => _nullishCoalesce(element.text, () => ( element.url)),
   mention: ({ element, user, group }) => {
-    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _231 => _231.name]), () => ( _optionalChain([group, 'optionalAccess', _232 => _232.name]))), () => ( element.id))}`;
+    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _245 => _245.name]), () => ( _optionalChain([group, 'optionalAccess', _246 => _246.name]))), () => ( element.id))}`;
   }
 };
 var stringifyCommentBodyHtmlElements = {
@@ -10906,7 +11016,7 @@ var stringifyCommentBodyHtmlElements = {
     return html`<a href="${href}" target="_blank" rel="noopener noreferrer">${element.text ? html`${element.text}` : element.url}</a>`;
   },
   mention: ({ element, user, group }) => {
-    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _233 => _233.name]) ? html`${_optionalChain([user, 'optionalAccess', _234 => _234.name])}` : _optionalChain([group, 'optionalAccess', _235 => _235.name]) ? html`${_optionalChain([group, 'optionalAccess', _236 => _236.name])}` : element.id}</span>`;
+    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _247 => _247.name]) ? html`${_optionalChain([user, 'optionalAccess', _248 => _248.name])}` : _optionalChain([group, 'optionalAccess', _249 => _249.name]) ? html`${_optionalChain([group, 'optionalAccess', _250 => _250.name])}` : element.id}</span>`;
   }
 };
 var stringifyCommentBodyMarkdownElements = {
@@ -10936,20 +11046,20 @@ var stringifyCommentBodyMarkdownElements = {
     return markdown`[${_nullishCoalesce(element.text, () => ( element.url))}](${href})`;
   },
   mention: ({ element, user, group }) => {
-    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _237 => _237.name]), () => ( _optionalChain([group, 'optionalAccess', _238 => _238.name]))), () => ( element.id))}`;
+    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _251 => _251.name]), () => ( _optionalChain([group, 'optionalAccess', _252 => _252.name]))), () => ( element.id))}`;
   }
 };
 async function stringifyCommentBody(body, options) {
-  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _239 => _239.format]), () => ( "plain"));
-  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _240 => _240.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
+  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _253 => _253.format]), () => ( "plain"));
+  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _254 => _254.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
   const elements = {
     ...format === "html" ? stringifyCommentBodyHtmlElements : format === "markdown" ? stringifyCommentBodyMarkdownElements : stringifyCommentBodyPlainElements,
-    ..._optionalChain([options, 'optionalAccess', _241 => _241.elements])
+    ..._optionalChain([options, 'optionalAccess', _255 => _255.elements])
   };
   const { users: resolvedUsers, groups: resolvedGroupsInfo } = await resolveMentionsInCommentBody(
     body,
-    _optionalChain([options, 'optionalAccess', _242 => _242.resolveUsers]),
-    _optionalChain([options, 'optionalAccess', _243 => _243.resolveGroupsInfo])
+    _optionalChain([options, 'optionalAccess', _256 => _256.resolveUsers]),
+    _optionalChain([options, 'optionalAccess', _257 => _257.resolveGroupsInfo])
   );
   const blocks = body.content.flatMap((block, blockIndex) => {
     switch (block.type) {
@@ -11080,9 +11190,9 @@ function lsonToJson(value) {
   }
   return value;
 }
-function deepLiveify(value) {
+function _deepLiveify(value) {
   if (Array.isArray(value)) {
-    return new LiveList(value.map(deepLiveify));
+    return new LiveList(value.map(_deepLiveify));
   } else if (isPlainObject(value)) {
     const init = {};
     for (const key in value) {
@@ -11090,7 +11200,7 @@ function deepLiveify(value) {
       if (val === void 0) {
         continue;
       }
-      init[key] = deepLiveify(val);
+      init[key] = _deepLiveify(val);
     }
     return new LiveObject(init);
   } else {
@@ -11127,7 +11237,7 @@ function patchLiveList(liveList, prev, next) {
   if (i > prevEnd) {
     if (i <= nextEnd) {
       while (i <= nextEnd) {
-        liveList.insert(deepLiveify(next[i]), i);
+        liveList.insert(_deepLiveify(next[i]), i);
         i++;
       }
     }
@@ -11145,12 +11255,12 @@ function patchLiveList(liveList, prev, next) {
       if (isLiveObject(liveListNode) && isPlainObject(prevNode) && isPlainObject(nextNode)) {
         patchLiveObject(liveListNode, prevNode, nextNode);
       } else {
-        liveList.set(i, deepLiveify(nextNode));
+        liveList.set(i, _deepLiveify(nextNode));
       }
       i++;
     }
     while (i <= nextEnd) {
-      liveList.insert(deepLiveify(next[i]), i);
+      liveList.insert(_deepLiveify(next[i]), i);
       i++;
     }
     let localI = i;
@@ -11177,7 +11287,7 @@ Only serializable value can be synced with Liveblocks.`
   if (next === void 0) {
     liveObject.delete(key);
   } else if (value === void 0) {
-    liveObject.set(key, deepLiveify(next));
+    liveObject.set(key, _deepLiveify(next));
   } else if (prev === next) {
     return;
   } else if (isLiveList(value) && Array.isArray(prev) && Array.isArray(next)) {
@@ -11185,7 +11295,7 @@ Only serializable value can be synced with Liveblocks.`
   } else if (isLiveObject(value) && isPlainObject(prev) && isPlainObject(next)) {
     patchLiveObject(value, prev, next);
   } else {
-    liveObject.set(key, deepLiveify(next));
+    liveObject.set(key, _deepLiveify(next));
   }
 }
 function patchLiveObject(root, prev, next) {
@@ -11236,12 +11346,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _244 => _244.updates, 'access', _245 => _245[key], 'optionalAccess', _246 => _246.type]) === "update") {
+          if (_optionalChain([update, 'access', _258 => _258.updates, 'access', _259 => _259[key], 'optionalAccess', _260 => _260.type]) === "update") {
             const val = update.node.get(key);
             if (val !== void 0) {
               newState[key] = lsonToJson(val);
             }
-          } else if (_optionalChain([update, 'access', _247 => _247.updates, 'access', _248 => _248[key], 'optionalAccess', _249 => _249.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _261 => _261.updates, 'access', _262 => _262[key], 'optionalAccess', _263 => _263.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -11302,12 +11412,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _250 => _250.updates, 'access', _251 => _251[key], 'optionalAccess', _252 => _252.type]) === "update") {
+          if (_optionalChain([update, 'access', _264 => _264.updates, 'access', _265 => _265[key], 'optionalAccess', _266 => _266.type]) === "update") {
             const value = update.node.get(key);
             if (value !== void 0) {
               newState[key] = lsonToJson(value);
             }
-          } else if (_optionalChain([update, 'access', _253 => _253.updates, 'access', _254 => _254[key], 'optionalAccess', _255 => _255.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _267 => _267.updates, 'access', _268 => _268[key], 'optionalAccess', _269 => _269.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -11387,9 +11497,9 @@ function makePoller(callback, intervalMs, options) {
   const startTime = performance.now();
   const doc = typeof document !== "undefined" ? document : void 0;
   const win = typeof window !== "undefined" ? window : void 0;
-  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _256 => _256.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
+  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _270 => _270.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
   const context = {
-    inForeground: _optionalChain([doc, 'optionalAccess', _257 => _257.visibilityState]) !== "hidden",
+    inForeground: _optionalChain([doc, 'optionalAccess', _271 => _271.visibilityState]) !== "hidden",
     lastSuccessfulPollAt: startTime,
     count: 0,
     backoff: 0
@@ -11470,11 +11580,11 @@ function makePoller(callback, intervalMs, options) {
     pollNowIfStale();
   }
   function onVisibilityChange() {
-    setInForeground(_optionalChain([doc, 'optionalAccess', _258 => _258.visibilityState]) !== "hidden");
+    setInForeground(_optionalChain([doc, 'optionalAccess', _272 => _272.visibilityState]) !== "hidden");
   }
-  _optionalChain([doc, 'optionalAccess', _259 => _259.addEventListener, 'call', _260 => _260("visibilitychange", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _261 => _261.addEventListener, 'call', _262 => _262("online", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _263 => _263.addEventListener, 'call', _264 => _264("focus", pollNowIfStale)]);
+  _optionalChain([doc, 'optionalAccess', _273 => _273.addEventListener, 'call', _274 => _274("visibilitychange", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _275 => _275.addEventListener, 'call', _276 => _276("online", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _277 => _277.addEventListener, 'call', _278 => _278("focus", pollNowIfStale)]);
   fsm.start();
   return {
     inc,
@@ -11486,6 +11596,90 @@ function makePoller(callback, intervalMs, options) {
   };
 }
 
+// src/mutations.ts
+function generateOpsFromJson(nodes, mutation, actorId = 1) {
+  const capturedOps = [];
+  const pool = createManagedPool("mutation-temp", {
+    getCurrentConnectionId: () => actorId,
+    onDispatch: (ops) => {
+      capturedOps.push(...ops);
+    }
+  });
+  const root = LiveObject._fromItems(nodes, pool);
+  if (isPlainObject(mutation)) {
+    applyMutationToLiveObject(root, mutation);
+  } else {
+    throw new Error(
+      "Root mutation must be an object. Use a nested key to update specific values."
+    );
+  }
+  return capturedOps;
+}
+function applyMutationToLiveObject(target, mutation) {
+  for (const key in mutation) {
+    const mutationValue = mutation[key];
+    if (mutationValue === void 0) {
+      continue;
+    }
+    const existingValue = target.get(key);
+    if (isLiveNode(mutationValue)) {
+      target.set(key, mutationValue);
+      continue;
+    }
+    if (isLiveObject(existingValue) && isPlainObject(mutationValue)) {
+      applyMutationToLiveObject(
+        existingValue,
+        mutationValue
+      );
+    } else if (isLiveMap(existingValue) && isPlainObject(mutationValue)) {
+      applyMutationToLiveMap(existingValue, mutationValue);
+    } else if (isLiveList(existingValue) && Array.isArray(mutationValue)) {
+      applyMutationToLiveList(existingValue, mutationValue);
+    } else if (existingValue === void 0 && isPlainObject(mutationValue)) {
+      const convertedValue = _deepLiveify(mutationValue);
+      target.set(key, convertedValue);
+    } else {
+      target.set(key, mutationValue);
+    }
+  }
+}
+function applyMutationToLiveMap(target, mutation) {
+  for (const key in mutation) {
+    const mutationValue = mutation[key];
+    if (mutationValue === void 0) {
+      continue;
+    }
+    const existingValue = target.get(key);
+    if (isLiveNode(mutationValue)) {
+      target.set(key, mutationValue);
+      continue;
+    }
+    if (isLiveObject(existingValue) && isPlainObject(mutationValue)) {
+      applyMutationToLiveObject(
+        existingValue,
+        mutationValue
+      );
+    } else if (isLiveMap(existingValue) && isPlainObject(mutationValue)) {
+      applyMutationToLiveMap(existingValue, mutationValue);
+    } else if (isLiveList(existingValue) && Array.isArray(mutationValue)) {
+      applyMutationToLiveList(existingValue, mutationValue);
+    } else if (existingValue === void 0 && isPlainObject(mutationValue)) {
+      const convertedValue = _deepLiveify(mutationValue);
+      target.set(key, convertedValue);
+    } else {
+      const newValue = isLiveNode(mutationValue) ? mutationValue : mutationValue;
+      target.set(key, newValue);
+    }
+  }
+}
+function applyMutationToLiveList(target, mutation) {
+  target.clear();
+  for (const item of mutation) {
+    const liveItem = isLiveNode(item) ? item : item;
+    target.push(liveItem);
+  }
+}
+
 // src/protocol/Subscriptions.ts
 function getSubscriptionKey(subscription, subjectId) {
   if (typeof subscription === "string") {
@@ -11606,5 +11800,6 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isPlainObject = isPlainObject; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.patchNotificationSettings = patchNotificationSettings; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
+
+exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateOpsFromJson = generateOpsFromJson; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isPlainObject = isPlainObject; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.patchNotificationSettings = patchNotificationSettings; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.cjs.map