@inditextech/weave-sdk 2.13.1 → 2.15.0

package/dist/sdk.js

@@ -1,6 +1,6 @@
 import Konva from "konva";
 import pino from "pino";
-import { WEAVE_ASYNC_STATUS, WEAVE_AWARENESS_LAYER_ID, WEAVE_EXPORT_BACKGROUND_COLOR, WEAVE_EXPORT_FORMATS, WEAVE_INSTANCE_STATUS, WEAVE_KONVA_BACKEND, WEAVE_NODE_CUSTOM_EVENTS, WEAVE_NODE_LAYER_ID, WEAVE_NODE_POSITION, WEAVE_STORE_CONNECTION_STATUS, WEAVE_UTILITY_LAYER_ID } from "@inditextech/weave-types";
+import { WEAVE_ASYNC_STATUS, WEAVE_AWARENESS_LAYER_ID, WEAVE_EXPORT_BACKGROUND_COLOR, WEAVE_EXPORT_FORMATS, WEAVE_INSTANCE_STATUS, WEAVE_KONVA_BACKEND, WEAVE_LOG_LEVEL, WEAVE_NODE_CHANGE_TYPE, WEAVE_NODE_CUSTOM_EVENTS, WEAVE_NODE_LAYER_ID, WEAVE_NODE_POSITION, WEAVE_STORE_CONNECTION_STATUS, WEAVE_UTILITY_LAYER_ID } from "@inditextech/weave-types";
 import { getYjsDoc, getYjsValue, observeDeep, syncedStore } from "@syncedstore/core";
 import * as Y$1 from "yjs";
 import * as Y from "yjs";
@@ -15142,7 +15142,6 @@ var WeaveStore = class {
 		}
 		observeDeep(this.getState(), () => {
 			const newState = JSON.parse(JSON.stringify(this.getState()));
-			this.logger.debug({ newState }, "State changed");
 			this.instance.emitEvent("onStateChange", newState);
 			const nodesSelectionPlugin = this.instance.getPlugin("nodesSelection");
 			if (this.isRoomLoaded && nodesSelectionPlugin?.getSelectedNodes().length === 1) {
@@ -17676,8 +17675,11 @@ function moveNodeToContainer(instance, node, containerToMove, originalNode, orig
 		if (nodeHandler) {
 			instance.stateTransactional(() => {
 				const actualNode = nodeHandler.serialize(node);
-				instance.removeNodeNT(actualNode);
-				instance.addNodeNT(actualNode, layerToMoveAttrs.id);
+				instance.removeNodeNT(actualNode, { emitUserChangeEvent: false });
+				instance.addNodeNT(actualNode, layerToMoveAttrs.id, {
+					emitUserChangeEvent: true,
+					overrideUserChangeType: WEAVE_NODE_CHANGE_TYPE.UPDATE
+				});
 			});
 			return true;
 		}
@@ -18592,6 +18594,10 @@ const WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_DEFAULT_CONFIG = { style: {
 //#endregion
 //#region src/constants.ts
 const DEFAULT_THROTTLE_MS = 50;
+const DEFAULT_ADD_NODE_OPTIONS = { emitUserChangeEvent: true };
+const DEFAULT_UPDATE_NODE_OPTIONS = { emitUserChangeEvent: true };
+const DEFAULT_REMOVE_NODE_OPTIONS = { emitUserChangeEvent: true };
+const DEFAULT_MOVE_NODE_OPTIONS = { emitUserChangeEvent: true };
 
 //#endregion
 //#region src/plugins/users-presence/constants.ts
@@ -21149,7 +21155,7 @@ var WeaveGroupsManager = class {
 		const groupHandler = this.instance.getNodeHandler("group");
 		if (groupHandler) {
 			const groupNode$1 = groupHandler.create(groupId, { draggable: true });
-			this.instance.addNode(groupNode$1, parentNodeId);
+			this.instance.addNode(groupNode$1, parentNodeId, { emitUserChangeEvent: false });
 		}
 		const nodesWithZIndex = realNodes.map((node) => {
 			const instance = mainLayer?.findOne(`#${node.key}`);
@@ -21175,7 +21181,7 @@ var WeaveGroupsManager = class {
 					const handler = this.instance.getNodeHandler("group");
 					if (handler) {
 						const stateNode = handler.serialize(konvaGroup);
-						this.instance.addNode(stateNode, groupId);
+						this.instance.addNode(stateNode, groupId, { emitUserChangeEvent: false });
 					}
 				}
 				continue;
@@ -21193,7 +21199,7 @@ var WeaveGroupsManager = class {
 				const handler = this.instance.getNodeHandler(konvaNode.getAttrs().nodeType);
 				if (handler) {
 					const stateNode = handler.serialize(konvaNode);
-					this.instance.addNode(stateNode, groupId);
+					this.instance.addNode(stateNode, groupId, { emitUserChangeEvent: false });
 				}
 			}
 		}
@@ -21278,7 +21284,7 @@ var WeaveGroupsManager = class {
 		const groupHandler = this.instance.getNodeHandler("group");
 		if (groupHandler) {
 			const groupNode = groupHandler.serialize(konvaGroup);
-			this.instance.removeNode(groupNode);
+			this.instance.removeNode(groupNode, { emitUserChangeEvent: false });
 		}
 		setTimeout(() => {
 			this.getNodesMultiSelectionFeedbackPlugin()?.cleanupSelectedHalos();
@@ -21308,12 +21314,13 @@ var WeaveGroupsManager = class {
 //#endregion
 //#region src/logger/logger.ts
 var WeaveLogger = class {
-	constructor(config) {
+	constructor(instance, config) {
+		this.instance = instance;
 		this.config = config;
 		this.disabled = this.config.disabled ?? false;
 		this.logger = pino({
 			name: "weave.js",
-			level: this.config.level ?? "error",
+			level: this.config.level ?? WEAVE_LOG_LEVEL.ERROR,
 			browser: {
 				write: {
 					warn: (o) => {
@@ -21381,7 +21388,14 @@ var WeaveLogger = class {
 		return this.logger;
 	}
 	getChildLogger(name) {
-		return this.logger.child({ name });
+		const configuration = this.instance.getConfiguration();
+		const modulesLogging = configuration.logger?.modules ?? [];
+		let childLoggerLevel = configuration.logger?.level ?? WEAVE_LOG_LEVEL.ERROR;
+		for (const moduleLevel of modulesLogging) {
+			const [moduleName, level] = moduleLevel.split(":");
+			if (name === moduleName) childLoggerLevel = level;
+		}
+		return this.logger.child({ name }, { level: childLoggerLevel });
 	}
 };
 
@@ -21615,76 +21629,6 @@ var WeaveCloningManager = class {
 			minPoint
 		};
 	}
-	cloneNodes(instancesToClone, targetContainer, onPoint) {
-		if (instancesToClone.length === 0) return;
-		if (!targetContainer) return;
-		const groupId = v4_default();
-		const newGroup = new Konva.Group({ id: groupId });
-		targetContainer.add(newGroup);
-		const nodesWithZIndex = instancesToClone.map((node) => ({
-			node,
-			zIndex: node.zIndex()
-		})).filter((node) => node.zIndex !== -1);
-		const sortedNodesByZIndex = (0, import_lodash.orderBy)(nodesWithZIndex, ["zIndex"], ["asc"]).map((node) => node.node);
-		for (const [index, node] of sortedNodesByZIndex.entries()) {
-			const nodeAttrs = node.getAttrs();
-			if (nodeAttrs.type === "group") {
-				const clonedNode$1 = node.clone({
-					id: v4_default(),
-					type: "group"
-				});
-				const nodePos$1 = clonedNode$1.getAbsolutePosition();
-				const nodeRotation$1 = clonedNode$1.getAbsoluteRotation();
-				const parent$1 = node.getParent();
-				if (parent$1 && parent$1.getAttrs().nodeId && !parent$1.getAttrs().containerId) {
-					const realParent = this.instance.getStage().findOne(`#${parent$1.getAttrs().nodeId}`);
-					if (realParent) {
-						nodePos$1.x += realParent.x();
-						nodePos$1.y += realParent.y();
-					}
-				}
-				clonedNode$1.moveTo(newGroup);
-				clonedNode$1.zIndex(index);
-				clonedNode$1.setAbsolutePosition(nodePos$1);
-				clonedNode$1.rotation(nodeRotation$1);
-				continue;
-			}
-			const clonedNode = node.clone({ id: v4_default() });
-			const nodePos = clonedNode.getAbsolutePosition();
-			const nodeRotation = clonedNode.getAbsoluteRotation();
-			const parent = node.getParent();
-			if (parent && parent.getAttrs().nodeId && !parent.getAttrs().containerId) {
-				const realParent = this.instance.getStage().findOne(`#${parent.getAttrs().nodeId}`);
-				if (realParent) {
-					nodePos.x += realParent.x();
-					nodePos.y += realParent.y();
-				}
-			}
-			clonedNode.moveTo(newGroup);
-			clonedNode.zIndex(index);
-			clonedNode.setAbsolutePosition(nodePos);
-			clonedNode.rotation(nodeRotation);
-		}
-		const actualPos = newGroup.getClientRect({ relativeTo: targetContainer });
-		newGroup.x(onPoint.x - actualPos.x);
-		newGroup.y(onPoint.y - actualPos.y);
-		const groupChildren = [...newGroup.getChildren()];
-		for (const [index, node] of groupChildren.entries()) {
-			const nodePos = node.getAbsolutePosition();
-			const nodeRotation = node.getAbsoluteRotation();
-			node.moveTo(targetContainer);
-			node.zIndex(index);
-			node.setAbsolutePosition(nodePos);
-			node.rotation(nodeRotation);
-			const handler = this.instance.getNodeHandler(node.getAttrs().nodeType);
-			if (handler) {
-				const stateNode = handler.serialize(node);
-				this.instance.addNode(stateNode, targetContainer.getAttrs().id);
-			}
-			node.destroy();
-		}
-		newGroup.destroy();
-	}
 	recursivelyUpdateKeys(nodes) {
 		for (const child of nodes) {
 			const newNodeId = v4_default();
@@ -21703,7 +21647,7 @@ var WeaveCloningManager = class {
 		serializedNode.key = newNodeId;
 		serializedNode.props.id = newNodeId;
 		const realParent = this.instance.getInstanceRecursive(parent);
-		this.instance.addNode(serializedNode, realParent?.getAttrs().id);
+		this.instance.addNode(serializedNode, realParent?.getAttrs().id, { emitUserChangeEvent: false });
 		return this.instance.getStage().findOne(`#${newNodeId}`);
 	}
 	addClone(node) {
@@ -21768,7 +21712,7 @@ var WeaveZIndexManager = class {
 		const handler = this.instance.getNodeHandler(instance.getAttrs().nodeType);
 		if (handler) {
 			const nodeState = handler.serialize(instance);
-			this.instance.moveNode(nodeState, WEAVE_NODE_POSITION.UP);
+			this.instance.zMoveNode(nodeState, WEAVE_NODE_POSITION.UP);
 		}
 	}
 	moveDown(instance) {
@@ -21776,7 +21720,7 @@ var WeaveZIndexManager = class {
 		const handler = this.instance.getNodeHandler(instance.getAttrs().nodeType);
 		if (handler) {
 			const nodeState = handler.serialize(instance);
-			this.instance.moveNode(nodeState, WEAVE_NODE_POSITION.DOWN);
+			this.instance.zMoveNode(nodeState, WEAVE_NODE_POSITION.DOWN);
 		}
 	}
 	sendToBack(instances) {
@@ -21786,7 +21730,7 @@ var WeaveZIndexManager = class {
 			const handler = this.instance.getNodeHandler(node.getAttrs().nodeType);
 			if (handler) {
 				const nodeState = handler.serialize(node);
-				this.instance.moveNode(nodeState, WEAVE_NODE_POSITION.BACK);
+				this.instance.zMoveNode(nodeState, WEAVE_NODE_POSITION.BACK);
 			}
 		}
 	}
@@ -21797,7 +21741,7 @@ var WeaveZIndexManager = class {
 			const handler = this.instance.getNodeHandler(node.getAttrs().nodeType);
 			if (handler) {
 				const nodeState = handler.serialize(node);
-				this.instance.moveNode(nodeState, WEAVE_NODE_POSITION.FRONT);
+				this.instance.zMoveNode(nodeState, WEAVE_NODE_POSITION.FRONT);
 			}
 		}
 	}
@@ -21992,7 +21936,7 @@ var WeaveStateManager = class {
 			this.instance.emitEvent("onNodeRemoved", node);
 		}
 	}
-	moveNode(node, position) {
+	zMoveNode(node, position) {
 		const state = this.instance.getStore().getState();
 		if ((0, import_lodash.isEmpty)(state.weave)) {
 			const msg = `State is empty, cannot update the node`;
@@ -22114,7 +22058,7 @@ var WeaveRegisterManager = class {
 
 //#endregion
 //#region package.json
-var version = "2.13.1";
+var version = "2.15.0";
 
 //#endregion
 //#region src/managers/setup.ts
@@ -22630,14 +22574,19 @@ var WeaveMutexManager = class {
 			(changes) => {
 				const actUser = this.instance.getStore().getUser();
 				for (const change of changes) {
-					if (!change[this.WEAVE_USER_MUTEX_LOCK_KEY] && change[WEAVE_CONNECTED_USER_INFO_KEY] && actUser.id !== change[WEAVE_CONNECTED_USER_INFO_KEY].id) {
+					const remoteUser = change[WEAVE_CONNECTED_USER_INFO_KEY];
+					if (!remoteUser) continue;
+					const actualMutexLock = this.getUserMutexLock(this.getUserMutexKey(change[WEAVE_CONNECTED_USER_INFO_KEY]));
+					if (change[this.WEAVE_USER_MUTEX_LOCK_KEY] === void 0 && actualMutexLock !== void 0 && actUser.id !== remoteUser.id) {
 						const user = change[WEAVE_CONNECTED_USER_INFO_KEY];
+						this.logger.debug(`Asked for release for remote user: ${user.name}`);
 						this.releaseMutexLockRemote(user);
 						continue;
 					}
-					if (change[WEAVE_CONNECTED_USER_INFO_KEY] && actUser.id !== change[WEAVE_CONNECTED_USER_INFO_KEY].id) {
+					if (change[this.WEAVE_USER_MUTEX_LOCK_KEY] !== void 0 && actualMutexLock === void 0 && actUser.id !== remoteUser.id) {
 						const user = change[WEAVE_CONNECTED_USER_INFO_KEY];
 						const mutexInfo = change[this.WEAVE_USER_MUTEX_LOCK_KEY];
+						this.logger.debug(`Asked for lock for remote user: ${user.name}`);
 						this.setMutexLockRemote({
 							nodeIds: mutexInfo.nodeIds,
 							operation: mutexInfo.operation,
@@ -22710,13 +22659,17 @@ var WeaveMutexManager = class {
 				operation,
 				metadata
 			});
-			if (sendAwareness) store.setAwarenessInfo(this.WEAVE_USER_MUTEX_LOCK_KEY, {
-				user,
-				nodeIds,
-				operation,
-				metadata
-			});
+			if (sendAwareness) {
+				this.logger.debug(`Propagating lock for user: ${user.name}`);
+				store.setAwarenessInfo(this.WEAVE_USER_MUTEX_LOCK_KEY, {
+					user,
+					nodeIds,
+					operation,
+					metadata
+				});
+			}
 			this.instance.emitEvent("onMutexLockChange", { locks: [...this.userMutexLocked.keys()] });
+			this.logger.debug(`Setting lock for user: ${user.name}`);
 			return true;
 		}
 		if (preLockedNodes.length !== nodeIds.length) {
@@ -22742,14 +22695,18 @@ var WeaveMutexManager = class {
 				if (nodeInstance) nodeInstance.releaseMutex();
 			}
 			this.userMutexLocked.delete(userMutexKey);
-			if (sendAwareness) store.setAwarenessInfo(this.WEAVE_USER_MUTEX_LOCK_KEY, void 0);
+			if (sendAwareness) {
+				this.logger.debug(`Propagating release for user: ${user.name}`);
+				store.setAwarenessInfo(this.WEAVE_USER_MUTEX_LOCK_KEY, void 0);
+			}
 			this.instance.emitEvent("onMutexLockChange", { locks: [...this.userMutexLocked.keys()] });
+			this.logger.debug(`Releasing lock for user: ${user.name}`);
 		}
 	}
 };
 
 //#endregion
-//#region src/managers/async/watch-map.ts
+//#region src/utils/watch-map.ts
 function watchMap(onChange, map = new Map()) {
 	const handler = { get(target, prop, receiver) {
 		if (prop === "set") return (key, value$1) => {
@@ -22852,6 +22809,53 @@ var WeaveHooksManager = class {
 	}
 };
 
+//#endregion
+//#region src/managers/users/constants.ts
+const WEAVE_USER_INFO_KEY = "userInfo";
+
+//#endregion
+//#region src/managers/users/users.ts
+var WeaveUsersManager = class {
+	constructor(instance) {
+		this.instance = instance;
+		this.logger = this.instance.getChildLogger("users-manager");
+		this.logger.debug("Users manager created");
+		this.connectedUsers = new Map();
+		this.init();
+	}
+	init() {
+		this.instance.addEventListener("onAwarenessChange", (changes) => {
+			let usersChanged = false;
+			const actualUsers = Array.from(this.connectedUsers.values());
+			const users = [];
+			for (const change of changes) {
+				if (!change[WEAVE_USER_INFO_KEY]) continue;
+				if (change[WEAVE_USER_INFO_KEY]) {
+					const userInformation = change[WEAVE_USER_INFO_KEY];
+					users.push(userInformation);
+				}
+			}
+			for (const user of users) if (!this.connectedUsers.has(user.id)) {
+				this.logger.debug(`User connected: ${user.name}`);
+				this.connectedUsers.set(user.id, user);
+				usersChanged = true;
+			}
+			for (const userInformation of actualUsers) {
+				const user = users.find((u) => u.id === userInformation.id);
+				if (user === void 0) {
+					this.logger.debug(`User disconnected: ${userInformation.name}`);
+					this.connectedUsers.delete(userInformation.id);
+					usersChanged = true;
+				}
+			}
+			if (usersChanged) this.instance.emitEvent("onUsersChange");
+		});
+	}
+	getUsers() {
+		return Array.from(this.connectedUsers.values());
+	}
+};
+
 //#endregion
 //#region src/weave.ts
 var Weave = class {
@@ -22865,7 +22869,7 @@ var Weave = class {
 		this.id = v4_default();
 		this.initialized = false;
 		this.config = mergeExceptArrays({}, weaveConfig);
-		this.logger = new WeaveLogger(this.config?.logger ?? {
+		this.logger = new WeaveLogger(this, this.config?.logger ?? {
 			disabled: false,
 			level: "error"
 		});
@@ -22886,6 +22890,7 @@ var Weave = class {
 		this.exportManager = new WeaveExportManager(this);
 		this.actionsManager = new WeaveActionsManager(this);
 		this.pluginsManager = new WeavePluginsManager(this);
+		this.usersManager = new WeaveUsersManager(this);
 		this.mutexManager = new WeaveMutexManager(this);
 		this.asyncManager = new WeaveAsyncManager(this);
 		this.hooksManager = new WeaveHooksManager(this);
@@ -22999,6 +23004,52 @@ var Weave = class {
 		this.moduleLogger.debug(`Removing listening to event [${event}]`);
 		this.emitter.off(event, callback);
 	}
+	emitUserChangeEvent(data, changeType) {
+		const stage = this.getStage();
+		const user = this.getStore().getUser();
+		const node = data.node;
+		let parent = void 0;
+		let nodeParent = void 0;
+		if (nodeParent === void 0 && data?.parentId !== void 0 && stage) nodeParent = stage.findOne(`#${data.parentId}`);
+		if (nodeParent === void 0 && data?.parentId === void 0 && stage) {
+			const parentNode = stage.findOne(`#${node.key}`);
+			if (parentNode) nodeParent = this.getNodeContainer(parentNode);
+		}
+		if (nodeParent !== void 0) {
+			const handler = this.getNodeHandler(nodeParent?.getAttrs().nodeType);
+			if (handler) parent = handler.serialize(nodeParent);
+		}
+		if (!parent) return;
+		this.emitEvent("onUserChange", {
+			user,
+			changeType,
+			parent,
+			node
+		});
+		this.cleanupTransactionIdToInstance(node);
+	}
+	setTransactionIdToInstance(node) {
+		const realNode = this.getStage().findOne(`#${node.key}`);
+		if (realNode) {
+			node.props.transactionId = v4_default();
+			realNode.setAttr("transactionId", node.props.transactionId);
+		}
+	}
+	cleanupTransactionIdToInstance(node) {
+		const realNode = this.getStage().findOne(`#${node.key}`);
+		if (realNode) realNode.setAttr("transactionId", void 0);
+	}
+	decorateWithZIndex(node) {
+		const realNode = this.getStage().findOne(`#${node.key}`);
+		if (realNode) {
+			const zIndex = realNode.zIndex();
+			node.props = {
+				...node.props,
+				zIndex
+			};
+		}
+		return node;
+	}
 	getLogger() {
 		return this.logger;
 	}
@@ -23115,12 +23166,12 @@ var Weave = class {
 	update(newState) {
 		this.getStore().setState(newState);
 		this.renderer.render(() => {
-			this.emitEvent("onRender", {});
+			this.emitEvent("onRender");
 		});
 	}
 	render() {
 		this.renderer.render(() => {
-			this.emitEvent("onRender", {});
+			this.emitEvent("onRender");
 		});
 	}
 	findNodeById(tree, key, parent = null, index = -1) {
@@ -23132,43 +23183,102 @@ var Weave = class {
 	getNode(nodeKey) {
 		return this.stateManager.getNode(nodeKey);
 	}
-	addNode(node, parentId = "mainLayer", index = void 0) {
+	addNode(node, parentId = "mainLayer", options = DEFAULT_ADD_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			this.stateManager.addNode(node, parentId, index);
+			this.addNodeNT(node, parentId, options);
 		});
 	}
-	addNodeNT(node, parentId = "mainLayer", index = void 0) {
+	addNodeNT(node, parentId = "mainLayer", options = DEFAULT_ADD_NODE_OPTIONS) {
+		const { index, emitUserChangeEvent, overrideUserChangeType } = mergeExceptArrays(DEFAULT_ADD_NODE_OPTIONS, options);
+		if (emitUserChangeEvent) this.setTransactionIdToInstance(node);
 		this.stateManager.addNode(node, parentId, index);
+		if (emitUserChangeEvent) {
+			const handleSendEvent = (addedNode) => {
+				if (node.props.transactionId === addedNode.getAttrs().transactionId) {
+					const decoratedNode = this.decorateWithZIndex(node);
+					this.emitUserChangeEvent({
+						node: decoratedNode,
+						parentId
+					}, overrideUserChangeType ?? WEAVE_NODE_CHANGE_TYPE.CREATE);
+					this.removeEventListener("onNodeRenderedAdded", handleSendEvent);
+				}
+			};
+			this.addEventListener("onNodeRenderedAdded", handleSendEvent);
+		}
 	}
-	updateNode(node) {
+	updateNode(node, options = DEFAULT_UPDATE_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			this.stateManager.updateNode(node);
+			this.updateNodeNT(node, options);
 		});
 	}
-	updateNodeNT(node) {
+	updateNodeNT(node, options = DEFAULT_UPDATE_NODE_OPTIONS) {
+		const { emitUserChangeEvent } = mergeExceptArrays(DEFAULT_UPDATE_NODE_OPTIONS, options);
+		if (emitUserChangeEvent) this.setTransactionIdToInstance(node);
 		this.stateManager.updateNode(node);
+		if (emitUserChangeEvent) {
+			const handleSendEvent = (updatedNode) => {
+				if (node.props.transactionId === updatedNode.getAttrs().transactionId) {
+					const decoratedNode = this.decorateWithZIndex(node);
+					this.emitUserChangeEvent({ node: decoratedNode }, WEAVE_NODE_CHANGE_TYPE.UPDATE);
+					this.removeEventListener("onNodeRenderedUpdated", handleSendEvent);
+				}
+			};
+			this.addEventListener("onNodeRenderedUpdated", handleSendEvent);
+		}
 	}
-	updateNodes(nodes) {
+	updateNodes(nodes, options = DEFAULT_UPDATE_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			this.stateManager.updateNodes(nodes);
+			this.updateNodesNT(nodes, options);
 		});
 	}
-	updateNodesNT(nodes) {
+	updateNodesNT(nodes, options = DEFAULT_UPDATE_NODE_OPTIONS) {
+		const { emitUserChangeEvent } = mergeExceptArrays(DEFAULT_UPDATE_NODE_OPTIONS, options);
+		const transactionsIds = {};
+		if (emitUserChangeEvent) for (const node of nodes) {
+			this.setTransactionIdToInstance(node);
+			transactionsIds[node.key] = node.props.transactionId;
+		}
 		this.stateManager.updateNodes(nodes);
+		if (emitUserChangeEvent) {
+			const handleSendEvent = (updatedNode) => {
+				for (const node of nodes) if (transactionsIds[node.key] === updatedNode.getAttrs().transactionId) {
+					const decoratedNode = this.decorateWithZIndex(node);
+					this.emitUserChangeEvent({ node: decoratedNode }, WEAVE_NODE_CHANGE_TYPE.UPDATE);
+					delete transactionsIds[node.key];
+					if (Object.keys(transactionsIds).length === 0) this.removeEventListener("onNodeRenderedUpdated", handleSendEvent);
+					break;
+				}
+			};
+			this.addEventListener("onNodeRenderedUpdated", handleSendEvent);
+		}
 	}
-	removeNode(node) {
+	removeNode(node, options = DEFAULT_REMOVE_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			this.stateManager.removeNode(node);
-			this.runPhaseHooks("onRemoveNode", (hook) => {
-				const nodeInstance = this.getStage().findOne(`#${node.key}`);
-				if (nodeInstance) hook({ node: nodeInstance });
-			});
-			const selectionPlugin = this.getPlugin("nodesSelection");
-			if (selectionPlugin) selectionPlugin.setSelectedNodes([]);
+			this.removeNodeNT(node, options);
 		});
 	}
-	removeNodeNT(node) {
+	removeNodeNT(node, options = DEFAULT_REMOVE_NODE_OPTIONS) {
+		const { emitUserChangeEvent } = mergeExceptArrays(DEFAULT_REMOVE_NODE_OPTIONS, options);
+		let parentId = void 0;
+		let decoratedNode = void 0;
+		if (emitUserChangeEvent) {
+			this.setTransactionIdToInstance(node);
+			decoratedNode = this.decorateWithZIndex(node);
+			parentId = this.getContainerByNodeId(node.key);
+		}
 		this.stateManager.removeNode(node);
+		if (decoratedNode && emitUserChangeEvent) {
+			const handleSendEvent = (removedNode) => {
+				if (node.props.transactionId === removedNode.getAttrs().transactionId) {
+					this.emitUserChangeEvent({
+						node: decoratedNode,
+						parentId
+					}, WEAVE_NODE_CHANGE_TYPE.DELETE);
+					this.removeEventListener("onNodeRenderedRemoved", handleSendEvent);
+				}
+			};
+			this.addEventListener("onNodeRenderedRemoved", handleSendEvent);
+		}
 		this.runPhaseHooks("onRemoveNode", (hook) => {
 			const nodeInstance = this.getStage().findOne(`#${node.key}`);
 			if (nodeInstance) hook({ node: nodeInstance });
@@ -23176,25 +23286,36 @@ var Weave = class {
 		const selectionPlugin = this.getPlugin("nodesSelection");
 		if (selectionPlugin) selectionPlugin.setSelectedNodes([]);
 	}
-	removeNodes(nodes) {
+	removeNodes(nodes, options = DEFAULT_REMOVE_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			for (const node of nodes) this.removeNodeNT(node);
-			const selectionPlugin = this.getPlugin("nodesSelection");
-			if (selectionPlugin) selectionPlugin.setSelectedNodes([]);
+			this.removeNodesNT(nodes, options);
 		});
 	}
-	removeNodesNT(nodes) {
-		for (const node of nodes) this.removeNodeNT(node);
+	removeNodesNT(nodes, options = DEFAULT_REMOVE_NODE_OPTIONS) {
+		for (const node of nodes) this.removeNodeNT(node, options);
 		const selectionPlugin = this.getPlugin("nodesSelection");
 		if (selectionPlugin) selectionPlugin.setSelectedNodes([]);
 	}
-	moveNode(node, position) {
+	zMoveNode(node, position, options = DEFAULT_MOVE_NODE_OPTIONS) {
 		this.stateTransactional(() => {
-			this.stateManager.moveNode(node, position);
-		});
-	}
-	moveNodeNT(node, position) {
-		this.stateManager.moveNode(node, position);
+			this.zMoveNodeNT(node, position, options);
+		});
+	}
+	zMoveNodeNT(node, position, options = DEFAULT_MOVE_NODE_OPTIONS) {
+		const { emitUserChangeEvent } = mergeExceptArrays(DEFAULT_MOVE_NODE_OPTIONS, options);
+		if (emitUserChangeEvent) this.setTransactionIdToInstance(node);
+		this.updateNodeNT(node, { emitUserChangeEvent: false });
+		this.stateManager.zMoveNode(node, position);
+		if (emitUserChangeEvent) {
+			const handleSendEvent = (movedNode) => {
+				if (node.props.transactionId === movedNode.getAttrs().transactionId) {
+					const decoratedNode = this.decorateWithZIndex(node);
+					this.emitUserChangeEvent({ node: decoratedNode }, WEAVE_NODE_CHANGE_TYPE.UPDATE);
+					this.removeEventListener("onNodeRenderedUpdated", handleSendEvent);
+				}
+			};
+			this.addEventListener("onNodeRenderedUpdated", handleSendEvent);
+		}
 	}
 	getElementsTree() {
 		return this.stateManager.getElementsTree();
@@ -23202,6 +23323,15 @@ var Weave = class {
 	isEmpty() {
 		return this.getElementsTree().length === 0;
 	}
+	getContainerByNodeId(nodeId) {
+		let parentId = void 0;
+		const nodeParent = this.getStage().findOne(`#${nodeId}`);
+		if (nodeParent) {
+			const parent = this.getNodeContainer(nodeParent);
+			if (parent) parentId = parent.getAttrs().id;
+		}
+		return parentId;
+	}
 	getNodeContainerId(node) {
 		const stage = this.getStage();
 		let nodeContainer = node.getParent()?.getAttrs().id ?? "";
@@ -23278,9 +23408,6 @@ var Weave = class {
 	nodesToGroupSerialized(instancesToClone) {
 		return this.cloningManager.nodesToGroupSerialized(instancesToClone);
 	}
-	cloneNodes(instancesToClone, targetContainer, onPoint) {
-		this.cloningManager.cloneNodes(instancesToClone, targetContainer, onPoint);
-	}
 	getFonts() {
 		return this.fontsManager.getFonts();
 	}
@@ -23423,6 +23550,9 @@ var Weave = class {
 	getNodeMutexLock(nodeId) {
 		return this.mutexManager.getNodeMutexLock(nodeId);
 	}
+	getUsers() {
+		return this.usersManager.getUsers();
+	}
 };
 
 //#endregion
@@ -35229,22 +35359,16 @@ var WeaveConnectedUsersPlugin = class extends WeavePlugin {
 				store.setAwarenessInfo(WEAVE_CONNECTED_USER_INFO_KEY, userInfo$1);
 			} else store.setAwarenessInfo(WEAVE_CONNECTED_USER_INFO_KEY, void 0);
 		});
-		this.instance.addEventListener("onAwarenessChange", (changes) => {
+		this.instance.addEventListener("onUsersChange", () => {
 			if (!this.enabled) {
-				this.connectedUsers = {};
 				this.instance.emitEvent("onConnectedUsersChange", {});
 				return;
 			}
-			const newConnectedUsers = {};
-			for (const change of changes) {
-				if (!change[WEAVE_CONNECTED_USER_INFO_KEY]) continue;
-				if (change[WEAVE_CONNECTED_USER_INFO_KEY]) {
-					const userInformation = change[WEAVE_CONNECTED_USER_INFO_KEY];
-					newConnectedUsers[userInformation.id] = userInformation;
-				}
-			}
-			if (!(0, import_lodash.isEqual)(this.connectedUsers, newConnectedUsers)) this.instance.emitEvent("onConnectedUsersChange", newConnectedUsers);
-			this.connectedUsers = newConnectedUsers;
+			const actualUsers = this.instance.getUsers();
+			const newUsers = {};
+			for (const user of actualUsers) newUsers[user.id] = user;
+			if (!(0, import_lodash.isEqual)(this.connectedUsers, newUsers)) this.instance.emitEvent("onConnectedUsersChange", newUsers);
+			this.connectedUsers = newUsers;
 		});
 	}
 	enable() {
@@ -35297,21 +35421,30 @@ var WeaveUsersSelectionPlugin = class extends WeavePlugin {
 				store.setAwarenessInfo(WEAVE_USER_SELECTION_KEY, void 0);
 			}
 		});
-		this.instance.addEventListener("onAwarenessChange", (changes) => {
-			const selfUser = this.config.getUser();
-			const allActiveUsers = [];
-			for (const change of changes) {
-				if (!change[WEAVE_USER_SELECTION_KEY]) continue;
-				if (change[WEAVE_USER_SELECTION_KEY] && selfUser.id !== change[WEAVE_USER_SELECTION_KEY].user) {
+		this.instance.addEventListener(
+			"onAwarenessChange",
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(changes) => {
+				const selfUser = this.config.getUser();
+				for (const change of changes) if (change[WEAVE_USER_SELECTION_KEY] && selfUser.id !== change[WEAVE_USER_SELECTION_KEY].user) {
 					const userSelection = change[WEAVE_USER_SELECTION_KEY];
-					allActiveUsers.push(userSelection.user);
 					this.usersSelection[userSelection.user] = userSelection;
 				}
+				this.renderSelectors();
 			}
-			const allNodesSelections = Object.keys(this.usersSelection);
-			const inactiveUsers = allNodesSelections.filter((user) => !allNodesSelections.includes(user));
-			for (let i = 0; i < inactiveUsers.length; i++) delete this.usersSelection[inactiveUsers[i]];
-			this.renderSelectors();
+);
+		this.instance.addEventListener("onUsersChange", () => {
+			const actualUsers = this.instance.getUsers();
+			const usersWithSelection = Object.keys(this.usersSelection);
+			let hasChanges = false;
+			for (const userId of usersWithSelection) {
+				const userExists = actualUsers.find((user) => user.id === userId);
+				if (userExists === void 0) {
+					delete this.usersSelection[userId];
+					hasChanges = true;
+				}
+			}
+			if (hasChanges) this.renderSelectors();
 		});
 		stage.on("dragstart dragmove dragend", () => {
 			this.renderSelectors();