@liveblocks/react-flow 3.17.0 → 3.18.0-rc2

package/dist/{version.cjs → lib/version.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 const PKG_NAME = "@liveblocks/react-flow";
-const PKG_VERSION = typeof "3.17.0" === "string" && "3.17.0";
+const PKG_VERSION = typeof "3.18.0-rc2" === "string" && "3.18.0-rc2";
 const PKG_FORMAT = typeof TSUP_FORMAT === "string" && TSUP_FORMAT;
 
 exports.PKG_FORMAT = PKG_FORMAT;

package/dist/lib/version.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.cjs","sources":["../../src/lib/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":";;AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,YAAA,KAAgB,QAAY,IAAA,aAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;;;"}

package/dist/{version.js → lib/version.js}

@@ -1,5 +1,5 @@
 const PKG_NAME = "@liveblocks/react-flow";
-const PKG_VERSION = typeof "3.17.0" === "string" && "3.17.0";
+const PKG_VERSION = typeof "3.18.0-rc2" === "string" && "3.18.0-rc2";
 const PKG_FORMAT = typeof TSUP_FORMAT === "string" && TSUP_FORMAT;
 
 export { PKG_FORMAT, PKG_NAME, PKG_VERSION };

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sources":["../../src/lib/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":"AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,YAAA,KAAgB,QAAY,IAAA,aAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;"}

package/dist/node.cjs

@@ -0,0 +1,151 @@
+'use strict';
+
+var core = require('@liveblocks/core');
+var shared = require('./lib/shared.cjs');
+
+async function mutateFlow(options, callback) {
+  const { client, roomId } = options;
+  const storageKey = options.storageKey ?? shared.DEFAULT_STORAGE_KEY;
+  const getNodeSyncConfig = shared.buildNodeConfigCache(options.nodes?.sync);
+  const getEdgeSyncConfig = shared.buildEdgeConfigCache(options.edges?.sync);
+  const nodeListCache = /* @__PURE__ */ new WeakMap();
+  const edgeListCache = /* @__PURE__ */ new WeakMap();
+  await client.mutateStorage(roomId, async ({ root }) => {
+    let flow = root.get(storageKey);
+    if (!flow) {
+      const newFlow = new core.LiveObject({
+        nodes: new core.LiveMap(),
+        edges: new core.LiveMap()
+      });
+      root.set(storageKey, newFlow);
+      flow = newFlow;
+    }
+    const nodesLiveMap = flow.get("nodes");
+    const edgesLiveMap = flow.get("edges");
+    function getNodes() {
+      const nodeMap = nodesLiveMap.toJSON();
+      if (!nodeListCache.has(nodeMap)) {
+        nodeListCache.set(nodeMap, Object.values(nodeMap));
+      }
+      return nodeListCache.get(nodeMap);
+    }
+    function getEdges() {
+      const edgeMap = edgesLiveMap.toJSON();
+      if (!edgeListCache.has(edgeMap)) {
+        edgeListCache.set(edgeMap, Object.values(edgeMap));
+      }
+      return edgeListCache.get(edgeMap);
+    }
+    function getNode(id) {
+      return nodesLiveMap.get(id)?.toJSON();
+    }
+    function getEdge(id) {
+      return edgesLiveMap.get(id)?.toJSON();
+    }
+    function upsertNode(id, newNode) {
+      const existing = nodesLiveMap.get(id);
+      const syncConfig = getNodeSyncConfig(newNode.type);
+      if (!existing) {
+        nodesLiveMap.set(id, shared.toLiveblocksInternalNode(newNode, syncConfig));
+      } else {
+        existing.reconcile(newNode, syncConfig);
+      }
+    }
+    function upsertEdge(id, newEdge) {
+      const existing = edgesLiveMap.get(id);
+      const syncConfig = getEdgeSyncConfig(newEdge.type);
+      if (!existing) {
+        edgesLiveMap.set(id, shared.toLiveblocksInternalEdge(newEdge, syncConfig));
+      } else {
+        existing.reconcile(newEdge, syncConfig);
+      }
+    }
+    const mutableFlow = {
+      get nodes() {
+        return getNodes();
+      },
+      get edges() {
+        return getEdges();
+      },
+      toJSON() {
+        return { nodes: getNodes(), edges: getEdges() };
+      },
+      getNode,
+      getEdge,
+      addNode(node) {
+        upsertNode(node.id, node);
+      },
+      addNodes(nodes) {
+        for (const node of nodes) {
+          mutableFlow.addNode(node);
+        }
+      },
+      updateNode(id, partialOrUpdater) {
+        const oldNode = getNode(id);
+        if (!oldNode)
+          return;
+        let newNode;
+        if (typeof partialOrUpdater === "function") {
+          newNode = partialOrUpdater(oldNode);
+        } else {
+          newNode = { ...oldNode, ...partialOrUpdater };
+        }
+        return upsertNode(id, newNode);
+      },
+      updateNodeData(id, partialOrUpdater) {
+        return mutableFlow.updateNode(id, (node) => {
+          const currData = node.data ?? {};
+          const newData = typeof partialOrUpdater === "function" ? partialOrUpdater(currData) : { ...currData, ...partialOrUpdater };
+          return { ...node, data: newData };
+        });
+      },
+      removeNode(id) {
+        nodesLiveMap.delete(id);
+      },
+      removeNodes(ids) {
+        for (const id of ids) {
+          nodesLiveMap.delete(id);
+        }
+      },
+      addEdge(edge) {
+        upsertEdge(edge.id, edge);
+      },
+      addEdges(edges) {
+        for (const edge of edges) {
+          mutableFlow.addEdge(edge);
+        }
+      },
+      updateEdge(id, partialOrUpdater) {
+        const oldEdge = getEdge(id);
+        if (!oldEdge)
+          return;
+        let newEdge;
+        if (typeof partialOrUpdater === "function") {
+          newEdge = partialOrUpdater(oldEdge);
+        } else {
+          newEdge = { ...oldEdge, ...partialOrUpdater };
+        }
+        return upsertEdge(id, newEdge);
+      },
+      updateEdgeData(id, partialOrUpdater) {
+        return mutableFlow.updateEdge(id, (edge) => {
+          const currData = edge.data;
+          const newData = typeof partialOrUpdater === "function" ? partialOrUpdater(currData) : { ...currData, ...partialOrUpdater };
+          return { ...edge, data: newData };
+        });
+      },
+      removeEdge(id) {
+        edgesLiveMap.delete(id);
+      },
+      removeEdges(ids) {
+        for (const id of ids) {
+          edgesLiveMap.delete(id);
+        }
+      }
+    };
+    await callback(mutableFlow);
+  });
+}
+
+exports.mutateFlow = mutateFlow;
+//# sourceMappingURL=node.cjs.map

package/dist/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.cjs","sources":["../src/node.ts"],"sourcesContent":["import type { JsonObject, LsonObject } from \"@liveblocks/core\";\nimport { LiveMap, LiveObject } from \"@liveblocks/core\";\nimport type { BuiltInEdge, BuiltInNode, Edge, Node } from \"@xyflow/react\";\n\nimport {\n  buildEdgeConfigCache,\n  buildNodeConfigCache,\n  DEFAULT_STORAGE_KEY,\n  toLiveblocksInternalEdge,\n  toLiveblocksInternalNode,\n} from \"./lib/shared\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksFlow,\n  NodeSyncConfig,\n} from \"./lib/types\";\n\n/**\n * A minimal interface for the Liveblocks Node client — just the\n * `mutateStorage` method we actually need. This avoids importing\n * `@liveblocks/node` as a dependency.\n */\ninterface ILiveblocksClient {\n  mutateStorage(\n    roomId: string,\n    callback: (context: {\n      root: LiveObject<LsonObject>;\n    }) => void | Promise<void>\n  ): Promise<void>;\n}\n\n/** Options for `mutateFlow()`. */\nexport interface MutateFlowOptions<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> {\n  client: ILiveblocksClient;\n  roomId: string;\n  storageKey?: string;\n  nodes?: { sync?: NodeSyncConfig<N> };\n  edges?: { sync?: EdgeSyncConfig<E> };\n}\n\nexport interface MutableFlow<N extends Node, E extends Edge> {\n  /** The current list of nodes. */\n  readonly nodes: readonly N[];\n  /** The current list of edges. */\n  readonly edges: readonly E[];\n  /** Returns a plain object snapshot with `nodes` and `edges` arrays. */\n  toJSON(): {\n    nodes: readonly N[];\n    edges: readonly E[];\n  };\n\n  /** Returns a single node by ID, or `undefined` if not found. */\n  getNode(id: string): N | undefined;\n  /** Returns a single edge by ID, or `undefined` if not found. */\n  getEdge(id: string): E | undefined;\n\n  /** Adds a node. If a node with the same ID already exists, it is replaced. */\n  addNode(node: N): void;\n  /** Adds multiple nodes. Existing nodes with the same IDs are replaced. */\n  addNodes(nodes: N[]): void;\n  /** Updates a node by merging a partial object. No-op if the node does not exist. */\n  updateNode(id: string, partial: Partial<N>): void;\n  /** Updates a node using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */\n  updateNode(id: string, updater: (node: N) => N): void;\n  /** Updates a node's `data` by merging a partial object. No-op if the node does not exist. */\n  updateNodeData(id: string, partial: Partial<N[\"data\"]>): void;\n  /** Updates a node's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */\n  updateNodeData<D extends N[\"data\"]>(\n    id: string,\n    updater: (data: D) => D\n  ): void;\n  /** Removes a node by ID. */\n  removeNode(id: string): void;\n  /** Removes multiple nodes by ID. */\n  removeNodes(ids: string[]): void;\n\n  /** Adds an edge. If an edge with the same ID already exists, it is replaced. */\n  addEdge(edge: E): void;\n  /** Adds multiple edges. Existing edges with the same IDs are replaced. */\n  addEdges(edges: E[]): void;\n  /** Updates an edge by merging a partial object. No-op if the edge does not exist. */\n  updateEdge(id: string, partial: Partial<E>): void;\n  /** Updates an edge using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */\n  updateEdge(id: string, updater: (edge: E) => E): void;\n  /** Updates an edge's `data` by merging a partial object. No-op if the edge does not exist. */\n  updateEdgeData(id: string, partial: Partial<NonNullable<E[\"data\"]>>): void;\n  /** Updates an edge's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */\n  updateEdgeData<D extends E[\"data\"]>(\n    id: string,\n    updater: (data: D) => D\n  ): void;\n  /** Removes an edge by ID. */\n  removeEdge(id: string): void;\n  /** Removes multiple edges by ID. */\n  removeEdges(ids: string[]): void;\n}\n\n/**\n * Opens a flow (a collection of React Flow nodes and edges) for reading and\n * mutating, then automatically flushes all changes when the callback\n * completes.\n *\n * @example\n * ```ts\n * await mutateFlow({ client, roomId: \"my-room\" }, (flow) => {\n *   flow.addNode({ id: \"1\", position: { x: 0, y: 0 }, data: {} });\n *   flow.updateNodeData(\"1\", { label: \"Hello\" });\n * });\n * ```\n */\nexport async function mutateFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: MutateFlowOptions<N, E>,\n  callback: (flow: MutableFlow<N, E>) => void | Promise<void>\n): Promise<void> {\n  const { client, roomId } = options;\n  const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n\n  const getNodeSyncConfig = buildNodeConfigCache(options.nodes?.sync);\n  const getEdgeSyncConfig = buildEdgeConfigCache(options.edges?.sync);\n\n  const nodeListCache = new WeakMap<Record<string, N>, N[]>();\n  const edgeListCache = new WeakMap<Record<string, E>, E[]>();\n\n  await client.mutateStorage(roomId, async ({ root }) => {\n    let flow = root.get(storageKey) as InternalLiveblocksFlow | undefined;\n    if (!flow) {\n      const newFlow = new LiveObject({\n        nodes: new LiveMap(),\n        edges: new LiveMap(),\n      }) satisfies InternalLiveblocksFlow;\n      root.set(storageKey, newFlow);\n      flow = newFlow;\n    }\n\n    const nodesLiveMap = flow.get(\"nodes\");\n    const edgesLiveMap = flow.get(\"edges\");\n\n    function getNodes(): readonly N[] {\n      const nodeMap = nodesLiveMap.toJSON() as unknown as Record<string, N>;\n      if (!nodeListCache.has(nodeMap)) {\n        // TODO (LB-3665): To support sub-nodes, this function will need to emit nodes\n        // in topological order (parents before children), deferring any node with a\n        // parentId until its parent has been emitted.\n        nodeListCache.set(nodeMap, Object.values(nodeMap));\n      }\n      return nodeListCache.get(nodeMap)!;\n    }\n\n    function getEdges(): readonly E[] {\n      const edgeMap = edgesLiveMap.toJSON() as unknown as Record<string, E>;\n      if (!edgeListCache.has(edgeMap)) {\n        edgeListCache.set(edgeMap, Object.values(edgeMap));\n      }\n      return edgeListCache.get(edgeMap)!;\n    }\n\n    function getNode(id: string) {\n      return nodesLiveMap.get(id)?.toJSON() as N | undefined;\n    }\n    function getEdge(id: string) {\n      return edgesLiveMap.get(id)?.toJSON() as E | undefined;\n    }\n\n    function upsertNode(id: string, newNode: N) {\n      const existing = nodesLiveMap.get(id);\n      const syncConfig = getNodeSyncConfig(newNode.type);\n      if (!existing) {\n        nodesLiveMap.set(id, toLiveblocksInternalNode(newNode, syncConfig));\n      } else {\n        existing.reconcile(newNode as unknown as JsonObject, syncConfig);\n      }\n    }\n\n    function upsertEdge(id: string, newEdge: E) {\n      const existing = edgesLiveMap.get(id);\n      const syncConfig = getEdgeSyncConfig(newEdge.type);\n      if (!existing) {\n        edgesLiveMap.set(id, toLiveblocksInternalEdge(newEdge, syncConfig));\n      } else {\n        existing.reconcile(newEdge as unknown as JsonObject, syncConfig);\n      }\n    }\n\n    const mutableFlow: MutableFlow<N, E> = {\n      get nodes() {\n        return getNodes();\n      },\n      get edges() {\n        return getEdges();\n      },\n      toJSON() {\n        return { nodes: getNodes(), edges: getEdges() };\n      },\n      getNode,\n      getEdge,\n\n      addNode(node: N) {\n        upsertNode(node.id, node);\n      },\n      addNodes(nodes: N[]) {\n        for (const node of nodes) {\n          mutableFlow.addNode(node);\n        }\n      },\n      updateNode(id: string, partialOrUpdater: Partial<N> | ((node: N) => N)) {\n        const oldNode = getNode(id);\n        if (!oldNode) return;\n\n        let newNode: N;\n        if (typeof partialOrUpdater === \"function\") {\n          newNode = partialOrUpdater(oldNode);\n        } else {\n          newNode = { ...oldNode, ...partialOrUpdater };\n        }\n        return upsertNode(id, newNode);\n      },\n      updateNodeData(\n        id: string,\n        partialOrUpdater:\n          | Partial<N[\"data\"]>\n          | (<D extends N[\"data\"]>(data: D) => D)\n      ) {\n        return mutableFlow.updateNode(id, (node) => {\n          const currData = node.data ?? ({} as N[\"data\"]);\n          const newData =\n            typeof partialOrUpdater === \"function\"\n              ? partialOrUpdater(currData)\n              : { ...currData, ...partialOrUpdater };\n          return { ...node, data: newData };\n        });\n      },\n      removeNode(id: string) {\n        nodesLiveMap.delete(id);\n      },\n      removeNodes(ids: string[]) {\n        for (const id of ids) {\n          nodesLiveMap.delete(id);\n        }\n      },\n\n      addEdge(edge: E) {\n        upsertEdge(edge.id, edge);\n      },\n      addEdges(edges: E[]) {\n        for (const edge of edges) {\n          mutableFlow.addEdge(edge);\n        }\n      },\n      updateEdge(id: string, partialOrUpdater: Partial<E> | ((edge: E) => E)) {\n        const oldEdge = getEdge(id);\n        if (!oldEdge) return;\n\n        let newEdge: E;\n        if (typeof partialOrUpdater === \"function\") {\n          newEdge = partialOrUpdater(oldEdge);\n        } else {\n          newEdge = { ...oldEdge, ...partialOrUpdater };\n        }\n        return upsertEdge(id, newEdge);\n      },\n      updateEdgeData(\n        id: string,\n        partialOrUpdater:\n          | Partial<NonNullable<E[\"data\"]>>\n          | (<D extends E[\"data\"]>(data: D) => D)\n      ) {\n        return mutableFlow.updateEdge(id, (edge) => {\n          const currData = edge.data;\n          const newData =\n            typeof partialOrUpdater === \"function\"\n              ? partialOrUpdater(currData)\n              : { ...currData, ...partialOrUpdater };\n          return { ...edge, data: newData };\n        });\n      },\n      removeEdge(id: string) {\n        edgesLiveMap.delete(id);\n      },\n      removeEdges(ids: string[]) {\n        for (const id of ids) {\n          edgesLiveMap.delete(id);\n        }\n      },\n    };\n\n    await callback(mutableFlow);\n  });\n}\n"],"names":["DEFAULT_STORAGE_KEY","buildNodeConfigCache","buildEdgeConfigCache","LiveObject","LiveMap","toLiveblocksInternalNode","toLiveblocksInternalEdge"],"mappings":";;;;;AAiHsB,eAAA,UAAA,CAIpB,SACA,QACe,EAAA;AACf,EAAM,MAAA,EAAE,MAAQ,EAAA,MAAA,EAAW,GAAA,OAAA,CAAA;AAC3B,EAAM,MAAA,UAAA,GAAa,QAAQ,UAAc,IAAAA,0BAAA,CAAA;AAEzC,EAAA,MAAM,iBAAoB,GAAAC,2BAAA,CAAqB,OAAQ,CAAA,KAAA,EAAO,IAAI,CAAA,CAAA;AAClE,EAAA,MAAM,iBAAoB,GAAAC,2BAAA,CAAqB,OAAQ,CAAA,KAAA,EAAO,IAAI,CAAA,CAAA;AAElE,EAAM,MAAA,aAAA,uBAAoB,OAAgC,EAAA,CAAA;AAC1D,EAAM,MAAA,aAAA,uBAAoB,OAAgC,EAAA,CAAA;AAE1D,EAAA,MAAM,OAAO,aAAc,CAAA,MAAA,EAAQ,OAAO,EAAE,MAAW,KAAA;AACrD,IAAI,IAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,UAAU,CAAA,CAAA;AAC9B,IAAA,IAAI,CAAC,IAAM,EAAA;AACT,MAAM,MAAA,OAAA,GAAU,IAAIC,eAAW,CAAA;AAAA,QAC7B,KAAA,EAAO,IAAIC,YAAQ,EAAA;AAAA,QACnB,KAAA,EAAO,IAAIA,YAAQ,EAAA;AAAA,OACpB,CAAA,CAAA;AACD,MAAK,IAAA,CAAA,GAAA,CAAI,YAAY,OAAO,CAAA,CAAA;AAC5B,MAAO,IAAA,GAAA,OAAA,CAAA;AAAA,KACT;AAEA,IAAM,MAAA,YAAA,GAAe,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AACrC,IAAM,MAAA,YAAA,GAAe,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AAErC,IAAA,SAAS,QAAyB,GAAA;AAChC,MAAM,MAAA,OAAA,GAAU,aAAa,MAAO,EAAA,CAAA;AACpC,MAAA,IAAI,CAAC,aAAA,CAAc,GAAI,CAAA,OAAO,CAAG,EAAA;AAI/B,QAAA,aAAA,CAAc,GAAI,CAAA,OAAA,EAAS,MAAO,CAAA,MAAA,CAAO,OAAO,CAAC,CAAA,CAAA;AAAA,OACnD;AACA,MAAO,OAAA,aAAA,CAAc,IAAI,OAAO,CAAA,CAAA;AAAA,KAClC;AAEA,IAAA,SAAS,QAAyB,GAAA;AAChC,MAAM,MAAA,OAAA,GAAU,aAAa,MAAO,EAAA,CAAA;AACpC,MAAA,IAAI,CAAC,aAAA,CAAc,GAAI,CAAA,OAAO,CAAG,EAAA;AAC/B,QAAA,aAAA,CAAc,GAAI,CAAA,OAAA,EAAS,MAAO,CAAA,MAAA,CAAO,OAAO,CAAC,CAAA,CAAA;AAAA,OACnD;AACA,MAAO,OAAA,aAAA,CAAc,IAAI,OAAO,CAAA,CAAA;AAAA,KAClC;AAEA,IAAA,SAAS,QAAQ,EAAY,EAAA;AAC3B,MAAA,OAAO,YAAa,CAAA,GAAA,CAAI,EAAE,CAAA,EAAG,MAAO,EAAA,CAAA;AAAA,KACtC;AACA,IAAA,SAAS,QAAQ,EAAY,EAAA;AAC3B,MAAA,OAAO,YAAa,CAAA,GAAA,CAAI,EAAE,CAAA,EAAG,MAAO,EAAA,CAAA;AAAA,KACtC;AAEA,IAAS,SAAA,UAAA,CAAW,IAAY,OAAY,EAAA;AAC1C,MAAM,MAAA,QAAA,GAAW,YAAa,CAAA,GAAA,CAAI,EAAE,CAAA,CAAA;AACpC,MAAM,MAAA,UAAA,GAAa,iBAAkB,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AACjD,MAAA,IAAI,CAAC,QAAU,EAAA;AACb,QAAA,YAAA,CAAa,GAAI,CAAA,EAAA,EAAIC,+BAAyB,CAAA,OAAA,EAAS,UAAU,CAAC,CAAA,CAAA;AAAA,OAC7D,MAAA;AACL,QAAS,QAAA,CAAA,SAAA,CAAU,SAAkC,UAAU,CAAA,CAAA;AAAA,OACjE;AAAA,KACF;AAEA,IAAS,SAAA,UAAA,CAAW,IAAY,OAAY,EAAA;AAC1C,MAAM,MAAA,QAAA,GAAW,YAAa,CAAA,GAAA,CAAI,EAAE,CAAA,CAAA;AACpC,MAAM,MAAA,UAAA,GAAa,iBAAkB,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AACjD,MAAA,IAAI,CAAC,QAAU,EAAA;AACb,QAAA,YAAA,CAAa,GAAI,CAAA,EAAA,EAAIC,+BAAyB,CAAA,OAAA,EAAS,UAAU,CAAC,CAAA,CAAA;AAAA,OAC7D,MAAA;AACL,QAAS,QAAA,CAAA,SAAA,CAAU,SAAkC,UAAU,CAAA,CAAA;AAAA,OACjE;AAAA,KACF;AAEA,IAAA,MAAM,WAAiC,GAAA;AAAA,MACrC,IAAI,KAAQ,GAAA;AACV,QAAA,OAAO,QAAS,EAAA,CAAA;AAAA,OAClB;AAAA,MACA,IAAI,KAAQ,GAAA;AACV,QAAA,OAAO,QAAS,EAAA,CAAA;AAAA,OAClB;AAAA,MACA,MAAS,GAAA;AACP,QAAA,OAAO,EAAE,KAAO,EAAA,QAAA,EAAY,EAAA,KAAA,EAAO,UAAW,EAAA,CAAA;AAAA,OAChD;AAAA,MACA,OAAA;AAAA,MACA,OAAA;AAAA,MAEA,QAAQ,IAAS,EAAA;AACf,QAAW,UAAA,CAAA,IAAA,CAAK,IAAI,IAAI,CAAA,CAAA;AAAA,OAC1B;AAAA,MACA,SAAS,KAAY,EAAA;AACnB,QAAA,KAAA,MAAW,QAAQ,KAAO,EAAA;AACxB,UAAA,WAAA,CAAY,QAAQ,IAAI,CAAA,CAAA;AAAA,SAC1B;AAAA,OACF;AAAA,MACA,UAAA,CAAW,IAAY,gBAAiD,EAAA;AACtE,QAAM,MAAA,OAAA,GAAU,QAAQ,EAAE,CAAA,CAAA;AAC1B,QAAA,IAAI,CAAC,OAAA;AAAS,UAAA,OAAA;AAEd,QAAI,IAAA,OAAA,CAAA;AACJ,QAAI,IAAA,OAAO,qBAAqB,UAAY,EAAA;AAC1C,UAAA,OAAA,GAAU,iBAAiB,OAAO,CAAA,CAAA;AAAA,SAC7B,MAAA;AACL,UAAA,OAAA,GAAU,EAAE,GAAG,OAAS,EAAA,GAAG,gBAAiB,EAAA,CAAA;AAAA,SAC9C;AACA,QAAO,OAAA,UAAA,CAAW,IAAI,OAAO,CAAA,CAAA;AAAA,OAC/B;AAAA,MACA,cAAA,CACE,IACA,gBAGA,EAAA;AACA,QAAA,OAAO,WAAY,CAAA,UAAA,CAAW,EAAI,EAAA,CAAC,IAAS,KAAA;AAC1C,UAAM,MAAA,QAAA,GAAW,IAAK,CAAA,IAAA,IAAS,EAAC,CAAA;AAChC,UAAM,MAAA,OAAA,GACJ,OAAO,gBAAA,KAAqB,UACxB,GAAA,gBAAA,CAAiB,QAAQ,CAAA,GACzB,EAAE,GAAG,QAAU,EAAA,GAAG,gBAAiB,EAAA,CAAA;AACzC,UAAA,OAAO,EAAE,GAAG,IAAM,EAAA,IAAA,EAAM,OAAQ,EAAA,CAAA;AAAA,SACjC,CAAA,CAAA;AAAA,OACH;AAAA,MACA,WAAW,EAAY,EAAA;AACrB,QAAA,YAAA,CAAa,OAAO,EAAE,CAAA,CAAA;AAAA,OACxB;AAAA,MACA,YAAY,GAAe,EAAA;AACzB,QAAA,KAAA,MAAW,MAAM,GAAK,EAAA;AACpB,UAAA,YAAA,CAAa,OAAO,EAAE,CAAA,CAAA;AAAA,SACxB;AAAA,OACF;AAAA,MAEA,QAAQ,IAAS,EAAA;AACf,QAAW,UAAA,CAAA,IAAA,CAAK,IAAI,IAAI,CAAA,CAAA;AAAA,OAC1B;AAAA,MACA,SAAS,KAAY,EAAA;AACnB,QAAA,KAAA,MAAW,QAAQ,KAAO,EAAA;AACxB,UAAA,WAAA,CAAY,QAAQ,IAAI,CAAA,CAAA;AAAA,SAC1B;AAAA,OACF;AAAA,MACA,UAAA,CAAW,IAAY,gBAAiD,EAAA;AACtE,QAAM,MAAA,OAAA,GAAU,QAAQ,EAAE,CAAA,CAAA;AAC1B,QAAA,IAAI,CAAC,OAAA;AAAS,UAAA,OAAA;AAEd,QAAI,IAAA,OAAA,CAAA;AACJ,QAAI,IAAA,OAAO,qBAAqB,UAAY,EAAA;AAC1C,UAAA,OAAA,GAAU,iBAAiB,OAAO,CAAA,CAAA;AAAA,SAC7B,MAAA;AACL,UAAA,OAAA,GAAU,EAAE,GAAG,OAAS,EAAA,GAAG,gBAAiB,EAAA,CAAA;AAAA,SAC9C;AACA,QAAO,OAAA,UAAA,CAAW,IAAI,OAAO,CAAA,CAAA;AAAA,OAC/B;AAAA,MACA,cAAA,CACE,IACA,gBAGA,EAAA;AACA,QAAA,OAAO,WAAY,CAAA,UAAA,CAAW,EAAI,EAAA,CAAC,IAAS,KAAA;AAC1C,UAAA,MAAM,WAAW,IAAK,CAAA,IAAA,CAAA;AACtB,UAAM,MAAA,OAAA,GACJ,OAAO,gBAAA,KAAqB,UACxB,GAAA,gBAAA,CAAiB,QAAQ,CAAA,GACzB,EAAE,GAAG,QAAU,EAAA,GAAG,gBAAiB,EAAA,CAAA;AACzC,UAAA,OAAO,EAAE,GAAG,IAAM,EAAA,IAAA,EAAM,OAAQ,EAAA,CAAA;AAAA,SACjC,CAAA,CAAA;AAAA,OACH;AAAA,MACA,WAAW,EAAY,EAAA;AACrB,QAAA,YAAA,CAAa,OAAO,EAAE,CAAA,CAAA;AAAA,OACxB;AAAA,MACA,YAAY,GAAe,EAAA;AACzB,QAAA,KAAA,MAAW,MAAM,GAAK,EAAA;AACpB,UAAA,YAAA,CAAa,OAAO,EAAE,CAAA,CAAA;AAAA,SACxB;AAAA,OACF;AAAA,KACF,CAAA;AAEA,IAAA,MAAM,SAAS,WAAW,CAAA,CAAA;AAAA,GAC3B,CAAA,CAAA;AACH;;;;"}

package/dist/node.d.cts

@@ -0,0 +1,99 @@
+import { SyncConfig, LiveObject, LsonObject } from '@liveblocks/core';
+import { Node, Edge, BuiltInNode, BuiltInEdge } from '@xyflow/react';
+
+type InferNodeTypeLiterals<N> = N extends Node<any, infer T extends string> ? string extends T ? never : T : never;
+type NodeTypeLiterals<N> = (string & {}) | "*" | InferNodeTypeLiterals<N>;
+type InferEdgeTypeLiterals<E> = E extends Edge<any, infer T extends string> ? string extends T ? never : T : never;
+type EdgeTypeLiterals<E> = (string & {}) | "*" | InferEdgeTypeLiterals<E>;
+type NodeSyncConfig<N extends Node> = {
+    [key in NodeTypeLiterals<N>]?: SyncConfig;
+};
+type EdgeSyncConfig<E extends Edge> = {
+    [key in EdgeTypeLiterals<E>]?: SyncConfig;
+};
+
+/**
+ * A minimal interface for the Liveblocks Node client — just the
+ * `mutateStorage` method we actually need. This avoids importing
+ * `@liveblocks/node` as a dependency.
+ */
+interface ILiveblocksClient {
+    mutateStorage(roomId: string, callback: (context: {
+        root: LiveObject<LsonObject>;
+    }) => void | Promise<void>): Promise<void>;
+}
+/** Options for `mutateFlow()`. */
+interface MutateFlowOptions<N extends Node = BuiltInNode, E extends Edge = BuiltInEdge> {
+    client: ILiveblocksClient;
+    roomId: string;
+    storageKey?: string;
+    nodes?: {
+        sync?: NodeSyncConfig<N>;
+    };
+    edges?: {
+        sync?: EdgeSyncConfig<E>;
+    };
+}
+interface MutableFlow<N extends Node, E extends Edge> {
+    /** The current list of nodes. */
+    readonly nodes: readonly N[];
+    /** The current list of edges. */
+    readonly edges: readonly E[];
+    /** Returns a plain object snapshot with `nodes` and `edges` arrays. */
+    toJSON(): {
+        nodes: readonly N[];
+        edges: readonly E[];
+    };
+    /** Returns a single node by ID, or `undefined` if not found. */
+    getNode(id: string): N | undefined;
+    /** Returns a single edge by ID, or `undefined` if not found. */
+    getEdge(id: string): E | undefined;
+    /** Adds a node. If a node with the same ID already exists, it is replaced. */
+    addNode(node: N): void;
+    /** Adds multiple nodes. Existing nodes with the same IDs are replaced. */
+    addNodes(nodes: N[]): void;
+    /** Updates a node by merging a partial object. No-op if the node does not exist. */
+    updateNode(id: string, partial: Partial<N>): void;
+    /** Updates a node using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */
+    updateNode(id: string, updater: (node: N) => N): void;
+    /** Updates a node's `data` by merging a partial object. No-op if the node does not exist. */
+    updateNodeData(id: string, partial: Partial<N["data"]>): void;
+    /** Updates a node's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */
+    updateNodeData<D extends N["data"]>(id: string, updater: (data: D) => D): void;
+    /** Removes a node by ID. */
+    removeNode(id: string): void;
+    /** Removes multiple nodes by ID. */
+    removeNodes(ids: string[]): void;
+    /** Adds an edge. If an edge with the same ID already exists, it is replaced. */
+    addEdge(edge: E): void;
+    /** Adds multiple edges. Existing edges with the same IDs are replaced. */
+    addEdges(edges: E[]): void;
+    /** Updates an edge by merging a partial object. No-op if the edge does not exist. */
+    updateEdge(id: string, partial: Partial<E>): void;
+    /** Updates an edge using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */
+    updateEdge(id: string, updater: (edge: E) => E): void;
+    /** Updates an edge's `data` by merging a partial object. No-op if the edge does not exist. */
+    updateEdgeData(id: string, partial: Partial<NonNullable<E["data"]>>): void;
+    /** Updates an edge's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */
+    updateEdgeData<D extends E["data"]>(id: string, updater: (data: D) => D): void;
+    /** Removes an edge by ID. */
+    removeEdge(id: string): void;
+    /** Removes multiple edges by ID. */
+    removeEdges(ids: string[]): void;
+}
+/**
+ * Opens a flow (a collection of React Flow nodes and edges) for reading and
+ * mutating, then automatically flushes all changes when the callback
+ * completes.
+ *
+ * @example
+ * ```ts
+ * await mutateFlow({ client, roomId: "my-room" }, (flow) => {
+ *   flow.addNode({ id: "1", position: { x: 0, y: 0 }, data: {} });
+ *   flow.updateNodeData("1", { label: "Hello" });
+ * });
+ * ```
+ */
+declare function mutateFlow<N extends Node = BuiltInNode, E extends Edge = BuiltInEdge>(options: MutateFlowOptions<N, E>, callback: (flow: MutableFlow<N, E>) => void | Promise<void>): Promise<void>;
+
+export { MutableFlow, MutateFlowOptions, mutateFlow };

package/dist/node.d.ts

@@ -0,0 +1,99 @@
+import { SyncConfig, LiveObject, LsonObject } from '@liveblocks/core';
+import { Node, Edge, BuiltInNode, BuiltInEdge } from '@xyflow/react';
+
+type InferNodeTypeLiterals<N> = N extends Node<any, infer T extends string> ? string extends T ? never : T : never;
+type NodeTypeLiterals<N> = (string & {}) | "*" | InferNodeTypeLiterals<N>;
+type InferEdgeTypeLiterals<E> = E extends Edge<any, infer T extends string> ? string extends T ? never : T : never;
+type EdgeTypeLiterals<E> = (string & {}) | "*" | InferEdgeTypeLiterals<E>;
+type NodeSyncConfig<N extends Node> = {
+    [key in NodeTypeLiterals<N>]?: SyncConfig;
+};
+type EdgeSyncConfig<E extends Edge> = {
+    [key in EdgeTypeLiterals<E>]?: SyncConfig;
+};
+
+/**
+ * A minimal interface for the Liveblocks Node client — just the
+ * `mutateStorage` method we actually need. This avoids importing
+ * `@liveblocks/node` as a dependency.
+ */
+interface ILiveblocksClient {
+    mutateStorage(roomId: string, callback: (context: {
+        root: LiveObject<LsonObject>;
+    }) => void | Promise<void>): Promise<void>;
+}
+/** Options for `mutateFlow()`. */
+interface MutateFlowOptions<N extends Node = BuiltInNode, E extends Edge = BuiltInEdge> {
+    client: ILiveblocksClient;
+    roomId: string;
+    storageKey?: string;
+    nodes?: {
+        sync?: NodeSyncConfig<N>;
+    };
+    edges?: {
+        sync?: EdgeSyncConfig<E>;
+    };
+}
+interface MutableFlow<N extends Node, E extends Edge> {
+    /** The current list of nodes. */
+    readonly nodes: readonly N[];
+    /** The current list of edges. */
+    readonly edges: readonly E[];
+    /** Returns a plain object snapshot with `nodes` and `edges` arrays. */
+    toJSON(): {
+        nodes: readonly N[];
+        edges: readonly E[];
+    };
+    /** Returns a single node by ID, or `undefined` if not found. */
+    getNode(id: string): N | undefined;
+    /** Returns a single edge by ID, or `undefined` if not found. */
+    getEdge(id: string): E | undefined;
+    /** Adds a node. If a node with the same ID already exists, it is replaced. */
+    addNode(node: N): void;
+    /** Adds multiple nodes. Existing nodes with the same IDs are replaced. */
+    addNodes(nodes: N[]): void;
+    /** Updates a node by merging a partial object. No-op if the node does not exist. */
+    updateNode(id: string, partial: Partial<N>): void;
+    /** Updates a node using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */
+    updateNode(id: string, updater: (node: N) => N): void;
+    /** Updates a node's `data` by merging a partial object. No-op if the node does not exist. */
+    updateNodeData(id: string, partial: Partial<N["data"]>): void;
+    /** Updates a node's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */
+    updateNodeData<D extends N["data"]>(id: string, updater: (data: D) => D): void;
+    /** Removes a node by ID. */
+    removeNode(id: string): void;
+    /** Removes multiple nodes by ID. */
+    removeNodes(ids: string[]): void;
+    /** Adds an edge. If an edge with the same ID already exists, it is replaced. */
+    addEdge(edge: E): void;
+    /** Adds multiple edges. Existing edges with the same IDs are replaced. */
+    addEdges(edges: E[]): void;
+    /** Updates an edge by merging a partial object. No-op if the edge does not exist. */
+    updateEdge(id: string, partial: Partial<E>): void;
+    /** Updates an edge using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */
+    updateEdge(id: string, updater: (edge: E) => E): void;
+    /** Updates an edge's `data` by merging a partial object. No-op if the edge does not exist. */
+    updateEdgeData(id: string, partial: Partial<NonNullable<E["data"]>>): void;
+    /** Updates an edge's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */
+    updateEdgeData<D extends E["data"]>(id: string, updater: (data: D) => D): void;
+    /** Removes an edge by ID. */
+    removeEdge(id: string): void;
+    /** Removes multiple edges by ID. */
+    removeEdges(ids: string[]): void;
+}
+/**
+ * Opens a flow (a collection of React Flow nodes and edges) for reading and
+ * mutating, then automatically flushes all changes when the callback
+ * completes.
+ *
+ * @example
+ * ```ts
+ * await mutateFlow({ client, roomId: "my-room" }, (flow) => {
+ *   flow.addNode({ id: "1", position: { x: 0, y: 0 }, data: {} });
+ *   flow.updateNodeData("1", { label: "Hello" });
+ * });
+ * ```
+ */
+declare function mutateFlow<N extends Node = BuiltInNode, E extends Edge = BuiltInEdge>(options: MutateFlowOptions<N, E>, callback: (flow: MutableFlow<N, E>) => void | Promise<void>): Promise<void>;
+
+export { MutableFlow, MutateFlowOptions, mutateFlow };

package/dist/node.js

@@ -0,0 +1,149 @@
+import { LiveObject, LiveMap } from '@liveblocks/core';
+import { DEFAULT_STORAGE_KEY, buildNodeConfigCache, buildEdgeConfigCache, toLiveblocksInternalNode, toLiveblocksInternalEdge } from './lib/shared.js';
+
+async function mutateFlow(options, callback) {
+  const { client, roomId } = options;
+  const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+  const getNodeSyncConfig = buildNodeConfigCache(options.nodes?.sync);
+  const getEdgeSyncConfig = buildEdgeConfigCache(options.edges?.sync);
+  const nodeListCache = /* @__PURE__ */ new WeakMap();
+  const edgeListCache = /* @__PURE__ */ new WeakMap();
+  await client.mutateStorage(roomId, async ({ root }) => {
+    let flow = root.get(storageKey);
+    if (!flow) {
+      const newFlow = new LiveObject({
+        nodes: new LiveMap(),
+        edges: new LiveMap()
+      });
+      root.set(storageKey, newFlow);
+      flow = newFlow;
+    }
+    const nodesLiveMap = flow.get("nodes");
+    const edgesLiveMap = flow.get("edges");
+    function getNodes() {
+      const nodeMap = nodesLiveMap.toJSON();
+      if (!nodeListCache.has(nodeMap)) {
+        nodeListCache.set(nodeMap, Object.values(nodeMap));
+      }
+      return nodeListCache.get(nodeMap);
+    }
+    function getEdges() {
+      const edgeMap = edgesLiveMap.toJSON();
+      if (!edgeListCache.has(edgeMap)) {
+        edgeListCache.set(edgeMap, Object.values(edgeMap));
+      }
+      return edgeListCache.get(edgeMap);
+    }
+    function getNode(id) {
+      return nodesLiveMap.get(id)?.toJSON();
+    }
+    function getEdge(id) {
+      return edgesLiveMap.get(id)?.toJSON();
+    }
+    function upsertNode(id, newNode) {
+      const existing = nodesLiveMap.get(id);
+      const syncConfig = getNodeSyncConfig(newNode.type);
+      if (!existing) {
+        nodesLiveMap.set(id, toLiveblocksInternalNode(newNode, syncConfig));
+      } else {
+        existing.reconcile(newNode, syncConfig);
+      }
+    }
+    function upsertEdge(id, newEdge) {
+      const existing = edgesLiveMap.get(id);
+      const syncConfig = getEdgeSyncConfig(newEdge.type);
+      if (!existing) {
+        edgesLiveMap.set(id, toLiveblocksInternalEdge(newEdge, syncConfig));
+      } else {
+        existing.reconcile(newEdge, syncConfig);
+      }
+    }
+    const mutableFlow = {
+      get nodes() {
+        return getNodes();
+      },
+      get edges() {
+        return getEdges();
+      },
+      toJSON() {
+        return { nodes: getNodes(), edges: getEdges() };
+      },
+      getNode,
+      getEdge,
+      addNode(node) {
+        upsertNode(node.id, node);
+      },
+      addNodes(nodes) {
+        for (const node of nodes) {
+          mutableFlow.addNode(node);
+        }
+      },
+      updateNode(id, partialOrUpdater) {
+        const oldNode = getNode(id);
+        if (!oldNode)
+          return;
+        let newNode;
+        if (typeof partialOrUpdater === "function") {
+          newNode = partialOrUpdater(oldNode);
+        } else {
+          newNode = { ...oldNode, ...partialOrUpdater };
+        }
+        return upsertNode(id, newNode);
+      },
+      updateNodeData(id, partialOrUpdater) {
+        return mutableFlow.updateNode(id, (node) => {
+          const currData = node.data ?? {};
+          const newData = typeof partialOrUpdater === "function" ? partialOrUpdater(currData) : { ...currData, ...partialOrUpdater };
+          return { ...node, data: newData };
+        });
+      },
+      removeNode(id) {
+        nodesLiveMap.delete(id);
+      },
+      removeNodes(ids) {
+        for (const id of ids) {
+          nodesLiveMap.delete(id);
+        }
+      },
+      addEdge(edge) {
+        upsertEdge(edge.id, edge);
+      },
+      addEdges(edges) {
+        for (const edge of edges) {
+          mutableFlow.addEdge(edge);
+        }
+      },
+      updateEdge(id, partialOrUpdater) {
+        const oldEdge = getEdge(id);
+        if (!oldEdge)
+          return;
+        let newEdge;
+        if (typeof partialOrUpdater === "function") {
+          newEdge = partialOrUpdater(oldEdge);
+        } else {
+          newEdge = { ...oldEdge, ...partialOrUpdater };
+        }
+        return upsertEdge(id, newEdge);
+      },
+      updateEdgeData(id, partialOrUpdater) {
+        return mutableFlow.updateEdge(id, (edge) => {
+          const currData = edge.data;
+          const newData = typeof partialOrUpdater === "function" ? partialOrUpdater(currData) : { ...currData, ...partialOrUpdater };
+          return { ...edge, data: newData };
+        });
+      },
+      removeEdge(id) {
+        edgesLiveMap.delete(id);
+      },
+      removeEdges(ids) {
+        for (const id of ids) {
+          edgesLiveMap.delete(id);
+        }
+      }
+    };
+    await callback(mutableFlow);
+  });
+}
+
+export { mutateFlow };
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sources":["../src/node.ts"],"sourcesContent":["import type { JsonObject, LsonObject } from \"@liveblocks/core\";\nimport { LiveMap, LiveObject } from \"@liveblocks/core\";\nimport type { BuiltInEdge, BuiltInNode, Edge, Node } from \"@xyflow/react\";\n\nimport {\n  buildEdgeConfigCache,\n  buildNodeConfigCache,\n  DEFAULT_STORAGE_KEY,\n  toLiveblocksInternalEdge,\n  toLiveblocksInternalNode,\n} from \"./lib/shared\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksFlow,\n  NodeSyncConfig,\n} from \"./lib/types\";\n\n/**\n * A minimal interface for the Liveblocks Node client — just the\n * `mutateStorage` method we actually need. This avoids importing\n * `@liveblocks/node` as a dependency.\n */\ninterface ILiveblocksClient {\n  mutateStorage(\n    roomId: string,\n    callback: (context: {\n      root: LiveObject<LsonObject>;\n    }) => void | Promise<void>\n  ): Promise<void>;\n}\n\n/** Options for `mutateFlow()`. */\nexport interface MutateFlowOptions<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> {\n  client: ILiveblocksClient;\n  roomId: string;\n  storageKey?: string;\n  nodes?: { sync?: NodeSyncConfig<N> };\n  edges?: { sync?: EdgeSyncConfig<E> };\n}\n\nexport interface MutableFlow<N extends Node, E extends Edge> {\n  /** The current list of nodes. */\n  readonly nodes: readonly N[];\n  /** The current list of edges. */\n  readonly edges: readonly E[];\n  /** Returns a plain object snapshot with `nodes` and `edges` arrays. */\n  toJSON(): {\n    nodes: readonly N[];\n    edges: readonly E[];\n  };\n\n  /** Returns a single node by ID, or `undefined` if not found. */\n  getNode(id: string): N | undefined;\n  /** Returns a single edge by ID, or `undefined` if not found. */\n  getEdge(id: string): E | undefined;\n\n  /** Adds a node. If a node with the same ID already exists, it is replaced. */\n  addNode(node: N): void;\n  /** Adds multiple nodes. Existing nodes with the same IDs are replaced. */\n  addNodes(nodes: N[]): void;\n  /** Updates a node by merging a partial object. No-op if the node does not exist. */\n  updateNode(id: string, partial: Partial<N>): void;\n  /** Updates a node using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */\n  updateNode(id: string, updater: (node: N) => N): void;\n  /** Updates a node's `data` by merging a partial object. No-op if the node does not exist. */\n  updateNodeData(id: string, partial: Partial<N[\"data\"]>): void;\n  /** Updates a node's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the node does not exist. */\n  updateNodeData<D extends N[\"data\"]>(\n    id: string,\n    updater: (data: D) => D\n  ): void;\n  /** Removes a node by ID. */\n  removeNode(id: string): void;\n  /** Removes multiple nodes by ID. */\n  removeNodes(ids: string[]): void;\n\n  /** Adds an edge. If an edge with the same ID already exists, it is replaced. */\n  addEdge(edge: E): void;\n  /** Adds multiple edges. Existing edges with the same IDs are replaced. */\n  addEdges(edges: E[]): void;\n  /** Updates an edge by merging a partial object. No-op if the edge does not exist. */\n  updateEdge(id: string, partial: Partial<E>): void;\n  /** Updates an edge using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */\n  updateEdge(id: string, updater: (edge: E) => E): void;\n  /** Updates an edge's `data` by merging a partial object. No-op if the edge does not exist. */\n  updateEdgeData(id: string, partial: Partial<NonNullable<E[\"data\"]>>): void;\n  /** Updates an edge's `data` using an updater function. Always return a new object, never mutate in-place. No-op if the edge does not exist. */\n  updateEdgeData<D extends E[\"data\"]>(\n    id: string,\n    updater: (data: D) => D\n  ): void;\n  /** Removes an edge by ID. */\n  removeEdge(id: string): void;\n  /** Removes multiple edges by ID. */\n  removeEdges(ids: string[]): void;\n}\n\n/**\n * Opens a flow (a collection of React Flow nodes and edges) for reading and\n * mutating, then automatically flushes all changes when the callback\n * completes.\n *\n * @example\n * ```ts\n * await mutateFlow({ client, roomId: \"my-room\" }, (flow) => {\n *   flow.addNode({ id: \"1\", position: { x: 0, y: 0 }, data: {} });\n *   flow.updateNodeData(\"1\", { label: \"Hello\" });\n * });\n * ```\n */\nexport async function mutateFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: MutateFlowOptions<N, E>,\n  callback: (flow: MutableFlow<N, E>) => void | Promise<void>\n): Promise<void> {\n  const { client, roomId } = options;\n  const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n\n  const getNodeSyncConfig = buildNodeConfigCache(options.nodes?.sync);\n  const getEdgeSyncConfig = buildEdgeConfigCache(options.edges?.sync);\n\n  const nodeListCache = new WeakMap<Record<string, N>, N[]>();\n  const edgeListCache = new WeakMap<Record<string, E>, E[]>();\n\n  await client.mutateStorage(roomId, async ({ root }) => {\n    let flow = root.get(storageKey) as InternalLiveblocksFlow | undefined;\n    if (!flow) {\n      const newFlow = new LiveObject({\n        nodes: new LiveMap(),\n        edges: new LiveMap(),\n      }) satisfies InternalLiveblocksFlow;\n      root.set(storageKey, newFlow);\n      flow = newFlow;\n    }\n\n    const nodesLiveMap = flow.get(\"nodes\");\n    const edgesLiveMap = flow.get(\"edges\");\n\n    function getNodes(): readonly N[] {\n      const nodeMap = nodesLiveMap.toJSON() as unknown as Record<string, N>;\n      if (!nodeListCache.has(nodeMap)) {\n        // TODO (LB-3665): To support sub-nodes, this function will need to emit nodes\n        // in topological order (parents before children), deferring any node with a\n        // parentId until its parent has been emitted.\n        nodeListCache.set(nodeMap, Object.values(nodeMap));\n      }\n      return nodeListCache.get(nodeMap)!;\n    }\n\n    function getEdges(): readonly E[] {\n      const edgeMap = edgesLiveMap.toJSON() as unknown as Record<string, E>;\n      if (!edgeListCache.has(edgeMap)) {\n        edgeListCache.set(edgeMap, Object.values(edgeMap));\n      }\n      return edgeListCache.get(edgeMap)!;\n    }\n\n    function getNode(id: string) {\n      return nodesLiveMap.get(id)?.toJSON() as N | undefined;\n    }\n    function getEdge(id: string) {\n      return edgesLiveMap.get(id)?.toJSON() as E | undefined;\n    }\n\n    function upsertNode(id: string, newNode: N) {\n      const existing = nodesLiveMap.get(id);\n      const syncConfig = getNodeSyncConfig(newNode.type);\n      if (!existing) {\n        nodesLiveMap.set(id, toLiveblocksInternalNode(newNode, syncConfig));\n      } else {\n        existing.reconcile(newNode as unknown as JsonObject, syncConfig);\n      }\n    }\n\n    function upsertEdge(id: string, newEdge: E) {\n      const existing = edgesLiveMap.get(id);\n      const syncConfig = getEdgeSyncConfig(newEdge.type);\n      if (!existing) {\n        edgesLiveMap.set(id, toLiveblocksInternalEdge(newEdge, syncConfig));\n      } else {\n        existing.reconcile(newEdge as unknown as JsonObject, syncConfig);\n      }\n    }\n\n    const mutableFlow: MutableFlow<N, E> = {\n      get nodes() {\n        return getNodes();\n      },\n      get edges() {\n        return getEdges();\n      },\n      toJSON() {\n        return { nodes: getNodes(), edges: getEdges() };\n      },\n      getNode,\n      getEdge,\n\n      addNode(node: N) {\n        upsertNode(node.id, node);\n      },\n      addNodes(nodes: N[]) {\n        for (const node of nodes) {\n          mutableFlow.addNode(node);\n        }\n      },\n      updateNode(id: string, partialOrUpdater: Partial<N> | ((node: N) => N)) {\n        const oldNode = getNode(id);\n        if (!oldNode) return;\n\n        let newNode: N;\n        if (typeof partialOrUpdater === \"function\") {\n          newNode = partialOrUpdater(oldNode);\n        } else {\n          newNode = { ...oldNode, ...partialOrUpdater };\n        }\n        return upsertNode(id, newNode);\n      },\n      updateNodeData(\n        id: string,\n        partialOrUpdater:\n          | Partial<N[\"data\"]>\n          | (<D extends N[\"data\"]>(data: D) => D)\n      ) {\n        return mutableFlow.updateNode(id, (node) => {\n          const currData = node.data ?? ({} as N[\"data\"]);\n          const newData =\n            typeof partialOrUpdater === \"function\"\n              ? partialOrUpdater(currData)\n              : { ...currData, ...partialOrUpdater };\n          return { ...node, data: newData };\n        });\n      },\n      removeNode(id: string) {\n        nodesLiveMap.delete(id);\n      },\n      removeNodes(ids: string[]) {\n        for (const id of ids) {\n          nodesLiveMap.delete(id);\n        }\n      },\n\n      addEdge(edge: E) {\n        upsertEdge(edge.id, edge);\n      },\n      addEdges(edges: E[]) {\n        for (const edge of edges) {\n          mutableFlow.addEdge(edge);\n        }\n      },\n      updateEdge(id: string, partialOrUpdater: Partial<E> | ((edge: E) => E)) {\n        const oldEdge = getEdge(id);\n        if (!oldEdge) return;\n\n        let newEdge: E;\n        if (typeof partialOrUpdater === \"function\") {\n          newEdge = partialOrUpdater(oldEdge);\n        } else {\n          newEdge = { ...oldEdge, ...partialOrUpdater };\n        }\n        return upsertEdge(id, newEdge);\n      },\n      updateEdgeData(\n        id: string,\n        partialOrUpdater:\n          | Partial<NonNullable<E[\"data\"]>>\n          | (<D extends E[\"data\"]>(data: D) => D)\n      ) {\n        return mutableFlow.updateEdge(id, (edge) => {\n          const currData = edge.data;\n          const newData =\n            typeof partialOrUpdater === \"function\"\n              ? partialOrUpdater(currData)\n              : { ...currData, ...partialOrUpdater };\n          return { ...edge, data: newData };\n        });\n      },\n      removeEdge(id: string) {\n        edgesLiveMap.delete(id);\n      },\n      removeEdges(ids: string[]) {\n        for (const id of ids) {\n          edgesLiveMap.delete(id);\n        }\n      },\n    };\n\n    await callback(mutableFlow);\n  });\n}\n"],"names":[],"mappings":"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"}