@powerhousedao/reactor 6.0.0-dev.209 → 6.0.0-dev.210

package/dist/index.js

@@ -1,5 +1,5 @@
-import { actions, actions as documentActions, createPresignedHeader, defaultBaseState, deriveOperationId, generateId, hashDocumentStateForScope, isUndoRedo } from "@powerhousedao/shared/document-model";
-import { addFile, deleteNode } from "@powerhousedao/shared/document-drive";
+import { actions, actions as documentActions, createPresignedHeader, defaultBaseState, deriveOperationId, generateId, hashDocumentStateForScope, isUndoRedo, replayDocument } from "@powerhousedao/shared/document-model";
+import { addFile, addFolder, copyNode, deleteNode, driveCreateDocument, generateNodesCopy, getDescendants, handleTargetNameCollisions, isFileNode, isFolderNode, moveNode, updateNode } from "@powerhousedao/shared/document-drive";
 import { v4 } from "uuid";
 import { ConsoleLogger } from "document-model";
 import { Migrator, sql } from "kysely";
@@ -257,33 +257,6 @@ function buildSingleJobMeta(jobId, callerMeta) {
 	};
 }
 //#endregion
-//#region src/events/types.ts
-/**
-* Custom error class that aggregates multiple errors from event subscribers.
-*/
-var EventBusAggregateError = class extends Error {
-	errors;
-	constructor(errors) {
-		const message = `EventBus emit failed with ${errors.length} error(s): ${errors.map((e) => {
-			if (e && typeof e === "object" && "message" in e) return e.message;
-			return String(e);
-		}).join("; ")}`;
-		super(message);
-		this.name = "EventBusAggregateError";
-		this.errors = errors;
-	}
-};
-/**
-* Event types for reactor lifecycle events.
-*/
-const ReactorEventTypes = {
-	JOB_PENDING: 10001,
-	JOB_RUNNING: 10002,
-	JOB_WRITE_READY: 10003,
-	JOB_READ_READY: 10004,
-	JOB_FAILED: 10005
-};
-//#endregion
 //#region src/shared/types.ts
 /**
 * Enum that determines deletion propagation.
@@ -318,6 +291,230 @@ let JobStatus = /* @__PURE__ */ function(JobStatus) {
 	return JobStatus;
 }({});
 //#endregion
+//#region src/client/drive-client.ts
+/**
+* Implementation of {@link IDriveClient}.
+*
+* Holds a back-reference to its parent {@link IReactorClient} for read and
+* single-document write primitives, plus direct access to {@link IReactor}
+* for batch execution. The back-reference is captured but never invoked
+* during construction, so the partial-`this` hazard does not apply.
+*/
+var DriveClient = class {
+	constructor(client, logger, reactor, signer) {
+		this.client = client;
+		this.logger = logger;
+		this.reactor = reactor;
+		this.signer = signer;
+	}
+	async create(input, signal) {
+		this.logger.verbose("drives.create(@input)", input);
+		const driveDoc = driveCreateDocument({ global: {
+			name: input.global.name || "",
+			icon: input.global.icon ?? null,
+			nodes: []
+		} });
+		if (input.preferredEditor) driveDoc.header.meta = {
+			...driveDoc.header.meta,
+			preferredEditor: input.preferredEditor
+		};
+		return this.client.create(driveDoc, void 0, signal);
+	}
+	async addFile(driveIdentifier, document, parentFolder, signal) {
+		this.logger.verbose("drives.addFile(@driveIdentifier, @document, @parentFolder)", driveIdentifier, document.header.id, parentFolder);
+		const documentId = document.header.id;
+		const documentActions = await signActions([
+			createDocumentAction({
+				model: document.header.documentType,
+				version: 0,
+				documentId: document.header.id,
+				signing: {
+					signature: document.header.id,
+					publicKey: document.header.sig.publicKey,
+					nonce: document.header.sig.nonce,
+					createdAtUtcIso: document.header.createdAtUtcIso,
+					documentType: document.header.documentType
+				},
+				slug: document.header.slug,
+				name: document.header.name,
+				branch: document.header.branch,
+				meta: document.header.meta,
+				protocolVersions: document.header.protocolVersions ?? { "base-reducer": 2 }
+			}),
+			upgradeDocumentAction({
+				documentId: document.header.id,
+				model: document.header.documentType,
+				fromVersion: 0,
+				toVersion: 1,
+				initialState: document.state
+			}),
+			addRelationshipAction(driveIdentifier, documentId, "child")
+		], this.signer, signal);
+		const driveActions = await signActions([addFile({
+			id: documentId,
+			name: document.header.name || documentId,
+			documentType: document.header.documentType,
+			parentFolder
+		})], this.signer, signal);
+		const batchResult = await this.reactor.executeBatch({ jobs: [{
+			key: "document",
+			documentId,
+			scope: getSharedActionScope(documentActions),
+			branch: "main",
+			actions: documentActions,
+			dependsOn: []
+		}, {
+			key: "drive",
+			documentId: driveIdentifier,
+			scope: getSharedActionScope(driveActions),
+			branch: "main",
+			actions: driveActions,
+			dependsOn: ["document"]
+		}] }, signal);
+		const completedJobs = await Promise.all(Object.values(batchResult.jobs).map((job) => this.client.waitForJob(job, signal)));
+		for (const job of completedJobs) if (job.status === JobStatus.FAILED) throw new Error(job.error?.message);
+		return this.reactor.get(documentId);
+	}
+	async addFolder(driveIdentifier, name, parentFolder, signal) {
+		this.logger.verbose("drives.addFolder(@driveIdentifier, @name, @parentFolder)", driveIdentifier, name, parentFolder);
+		const folderId = generateId();
+		const node = (await this.client.execute(driveIdentifier, "main", [addFolder({
+			id: folderId,
+			name,
+			parentFolder
+		})], signal)).state.global.nodes.find((n) => n.id === folderId);
+		if (!node || !isFolderNode(node)) throw new Error("Folder creation failed");
+		return node;
+	}
+	async removeNode(driveIdentifier, nodeId, signal) {
+		this.logger.verbose("drives.removeNode(@driveIdentifier, @nodeId)", driveIdentifier, nodeId);
+		const drive = await this.client.get(driveIdentifier, void 0, signal);
+		const node = drive.state.global.nodes.find((n) => n.id === nodeId);
+		if (!node) throw new Error(`Node ${nodeId} not found in drive ${driveIdentifier}`);
+		if (isFolderNode(node)) {
+			const fileDescendants = getDescendants(node, drive.state.global.nodes).filter(isFileNode);
+			for (const file of fileDescendants) await this.removeFileNode(driveIdentifier, file.id, signal);
+			await this.client.execute(driveIdentifier, "main", [deleteNode({ id: nodeId })], signal);
+			return;
+		}
+		await this.removeFileNode(driveIdentifier, nodeId, signal);
+	}
+	async renameNode(driveIdentifier, nodeId, name, signal) {
+		this.logger.verbose("drives.renameNode(@driveIdentifier, @nodeId, @name)", driveIdentifier, nodeId, name);
+		if ((await this.client.execute(nodeId, "main", [actions.setName({ name })], signal)).header.name !== name) throw new Error("Document rename did not apply");
+		const node = (await this.client.execute(driveIdentifier, "main", [updateNode({
+			id: nodeId,
+			name
+		})], signal)).state.global.nodes.find((n) => n.id === nodeId);
+		if (!node) throw new Error("Node missing from drive after rename");
+		return node;
+	}
+	async moveNode(driveIdentifier, srcNodeId, targetParentFolderId, signal) {
+		this.logger.verbose("drives.moveNode(@driveIdentifier, @srcNodeId, @targetParentFolderId)", driveIdentifier, srcNodeId, targetParentFolderId);
+		return this.client.execute(driveIdentifier, "main", [moveNode({
+			srcFolder: srcNodeId,
+			targetParentFolder: targetParentFolderId
+		})], signal);
+	}
+	async copyNode(driveIdentifier, srcNodeId, targetParentFolderId, signal) {
+		this.logger.verbose("drives.copyNode(@driveIdentifier, @srcNodeId, @targetParentFolderId)", driveIdentifier, srcNodeId, targetParentFolderId);
+		const drive = await this.client.get(driveIdentifier, void 0, signal);
+		const srcNode = drive.state.global.nodes.find((n) => n.id === srcNodeId);
+		if (!srcNode) throw new Error(`Node ${srcNodeId} not found in drive ${driveIdentifier}`);
+		const copyPlan = generateNodesCopy({
+			srcId: srcNodeId,
+			targetParentFolder: targetParentFolderId,
+			targetName: srcNode.name
+		}, () => generateId(), drive.state.global.nodes);
+		const resolvedNamesByTargetId = /* @__PURE__ */ new Map();
+		for (const entry of copyPlan) {
+			const node = drive.state.global.nodes.find((n) => n.id === entry.srcId);
+			if (!node) continue;
+			const resolved = handleTargetNameCollisions({
+				nodes: drive.state.global.nodes,
+				srcName: entry.targetName || node.name,
+				srcKind: isFileNode(node) ? "file" : "folder",
+				targetParentFolder: entry.targetParentFolder ?? null
+			});
+			resolvedNamesByTargetId.set(entry.targetId, resolved);
+		}
+		for (const entry of copyPlan) {
+			const node = drive.state.global.nodes.find((n) => n.id === entry.srcId);
+			if (!node || !isFileNode(node)) continue;
+			const srcDoc = await this.client.get(entry.srcId, void 0, signal);
+			const module = await this.client.getDocumentModelModule(srcDoc.header.documentType);
+			const duplicated = replayDocument(srcDoc.initialState, srcDoc.operations, module.reducer, createPresignedHeader(entry.targetId, srcDoc.header.documentType));
+			const resolvedName = resolvedNamesByTargetId.get(entry.targetId);
+			if (resolvedName) duplicated.header.name = resolvedName;
+			await this.addFile(driveIdentifier, duplicated, entry.targetParentFolder ?? void 0, signal);
+		}
+		return this.client.execute(driveIdentifier, "main", copyPlan.map((entry) => copyNode(entry)), signal);
+	}
+	async getNode(driveIdentifier, nodeId, signal) {
+		this.logger.verbose("drives.getNode(@driveIdentifier, @nodeId)", driveIdentifier, nodeId);
+		const node = (await this.client.get(driveIdentifier, void 0, signal)).state.global.nodes.find((n) => n.id === nodeId);
+		if (!node) throw new Error(`Node ${nodeId} not found in drive ${driveIdentifier}`);
+		return node;
+	}
+	async listNodes(driveIdentifier, parentFolder, signal) {
+		this.logger.verbose("drives.listNodes(@driveIdentifier, @parentFolder)", driveIdentifier, parentFolder);
+		const nodes = (await this.client.get(driveIdentifier, void 0, signal)).state.global.nodes;
+		if (parentFolder === void 0) return [...nodes];
+		return nodes.filter((n) => (n.parentFolder ?? null) === parentFolder);
+	}
+	async removeFileNode(driveId, fileId, signal) {
+		const relationshipActions = await signActions([removeRelationshipAction(driveId, fileId, "child")], this.signer, signal);
+		const driveActions = await signActions([deleteNode({ id: fileId })], this.signer, signal);
+		const batchResult = await this.reactor.executeBatch({ jobs: [{
+			key: "relationship",
+			documentId: driveId,
+			scope: getSharedActionScope(relationshipActions),
+			branch: "main",
+			actions: relationshipActions,
+			dependsOn: []
+		}, {
+			key: "drive",
+			documentId: driveId,
+			scope: getSharedActionScope(driveActions),
+			branch: "main",
+			actions: driveActions,
+			dependsOn: ["relationship"]
+		}] }, signal);
+		const completedJobs = await Promise.all(Object.values(batchResult.jobs).map((job) => this.client.waitForJob(job, signal)));
+		for (const job of completedJobs) if (job.status === JobStatus.FAILED) throw new Error(job.error?.message);
+		const deleteJob = await this.reactor.deleteDocument(fileId, this.signer, signal);
+		const deleteCompleted = await this.client.waitForJob(deleteJob, signal);
+		if (deleteCompleted.status === JobStatus.FAILED) throw new Error(deleteCompleted.error?.message);
+	}
+};
+//#endregion
+//#region src/events/types.ts
+/**
+* Custom error class that aggregates multiple errors from event subscribers.
+*/
+var EventBusAggregateError = class extends Error {
+	errors;
+	constructor(errors) {
+		const message = `EventBus emit failed with ${errors.length} error(s): ${errors.map((e) => {
+			if (e && typeof e === "object" && "message" in e) return e.message;
+			return String(e);
+		}).join("; ")}`;
+		super(message);
+		this.name = "EventBusAggregateError";
+		this.errors = errors;
+	}
+};
+/**
+* Event types for reactor lifecycle events.
+*/
+const ReactorEventTypes = {
+	JOB_PENDING: 10001,
+	JOB_RUNNING: 10002,
+	JOB_WRITE_READY: 10003,
+	JOB_READ_READY: 10004,
+	JOB_FAILED: 10005
+};
+//#endregion
 //#region src/shared/awaiter.ts
 /**
 * Checks if a job status is terminal (job has finished).
@@ -484,6 +681,7 @@ var ReactorClient = class {
 	jobAwaiter;
 	documentIndexer;
 	documentView;
+	drives;
 	constructor(logger, reactor, signer, subscriptionManager, jobAwaiter, documentIndexer, documentView) {
 		this.logger = logger;
 		this.reactor = reactor;
@@ -492,6 +690,7 @@ var ReactorClient = class {
 		this.jobAwaiter = jobAwaiter;
 		this.documentIndexer = documentIndexer;
 		this.documentView = documentView;
+		this.drives = new DriveClient(this, logger, reactor, signer);
 		this.logger.verbose("ReactorClient initialized");
 	}
 	/**
@@ -579,36 +778,36 @@ var ReactorClient = class {
 		};
 	}
 	/**
-	* Retrieves children of a document
+	* Retrieves outgoing relationships of a given type from a source document.
 	*/
-	async getChildren(parentIdentifier, view, paging, signal) {
-		this.logger.verbose("getChildren(@parentIdentifier, @view, @paging)", parentIdentifier, view, paging);
-		const parentId = await this.documentView.resolveIdOrSlug(parentIdentifier, view, void 0, signal);
-		const childIds = (await this.documentIndexer.getOutgoing(parentId, void 0, void 0, void 0, signal)).results.map((rel) => rel.targetId);
-		if (childIds.length === 0) return {
+	async getOutgoingRelationships(sourceIdentifier, relationshipType, view, paging, signal) {
+		this.logger.verbose("getOutgoingRelationships(@sourceIdentifier, @relationshipType, @view, @paging)", sourceIdentifier, relationshipType, view, paging);
+		const sourceId = await this.documentView.resolveIdOrSlug(sourceIdentifier, view, void 0, signal);
+		const targetIds = (await this.documentIndexer.getOutgoing(sourceId, [relationshipType], void 0, void 0, signal)).results.map((rel) => rel.targetId);
+		if (targetIds.length === 0) return {
 			results: [],
 			options: paging || {
 				cursor: "0",
 				limit: 0
 			}
 		};
-		return this.reactor.find({ ids: childIds }, view, paging, void 0, signal);
+		return this.reactor.find({ ids: targetIds }, view, paging, void 0, signal);
 	}
 	/**
-	* Retrieves parents of a document
+	* Retrieves incoming relationships of a given type to a target document.
 	*/
-	async getParents(childIdentifier, view, paging, signal) {
-		this.logger.verbose("getParents(@childIdentifier, @view, @paging)", childIdentifier, view, paging);
-		const childId = await this.documentView.resolveIdOrSlug(childIdentifier, view, void 0, signal);
-		const parentIds = (await this.documentIndexer.getIncoming(childId, void 0, void 0, void 0, signal)).results.map((rel) => rel.sourceId);
-		if (parentIds.length === 0) return {
+	async getIncomingRelationships(targetIdentifier, relationshipType, view, paging, signal) {
+		this.logger.verbose("getIncomingRelationships(@targetIdentifier, @relationshipType, @view, @paging)", targetIdentifier, relationshipType, view, paging);
+		const targetId = await this.documentView.resolveIdOrSlug(targetIdentifier, view, void 0, signal);
+		const sourceIds = (await this.documentIndexer.getIncoming(targetId, [relationshipType], void 0, void 0, signal)).results.map((rel) => rel.sourceId);
+		if (sourceIds.length === 0) return {
 			results: [],
 			options: paging || {
 				cursor: "0",
 				limit: 0
 			}
 		};
-		return this.reactor.find({ ids: parentIds }, view, paging, void 0, signal);
+		return this.reactor.find({ ids: sourceIds }, view, paging, void 0, signal);
 	}
 	/**
 	* Filters documents by criteria and returns a list of them
@@ -693,61 +892,13 @@ var ReactorClient = class {
 	}
 	/**
 	* Creates an empty document in a drive as a single batched operation.
+	* Delegates to {@link IDriveClient.addFile}.
+	*
+	* @deprecated Use `client.drives.addFile` instead. This method will be
+	* removed in a future release.
 	*/
 	async createDocumentInDrive(driveId, document, parentFolder, signal) {
-		this.logger.verbose("createDocumentInDrive(@driveId, @document, @parentFolder)", driveId, document, parentFolder);
-		const documentId = document.header.id;
-		const documentActions = await signActions([
-			createDocumentAction({
-				model: document.header.documentType,
-				version: 0,
-				documentId: document.header.id,
-				signing: {
-					signature: document.header.id,
-					publicKey: document.header.sig.publicKey,
-					nonce: document.header.sig.nonce,
-					createdAtUtcIso: document.header.createdAtUtcIso,
-					documentType: document.header.documentType
-				},
-				slug: document.header.slug,
-				name: document.header.name,
-				branch: document.header.branch,
-				meta: document.header.meta,
-				protocolVersions: document.header.protocolVersions ?? { "base-reducer": 2 }
-			}),
-			upgradeDocumentAction({
-				documentId: document.header.id,
-				model: document.header.documentType,
-				fromVersion: 0,
-				toVersion: 1,
-				initialState: document.state
-			}),
-			addRelationshipAction(driveId, documentId, "child")
-		], this.signer, signal);
-		const driveActions = await signActions([addFile({
-			id: documentId,
-			name: document.header.name || documentId,
-			documentType: document.header.documentType,
-			parentFolder
-		})], this.signer, signal);
-		const batchResult = await this.reactor.executeBatch({ jobs: [{
-			key: "document",
-			documentId,
-			scope: getSharedActionScope(documentActions),
-			branch: "main",
-			actions: documentActions,
-			dependsOn: []
-		}, {
-			key: "drive",
-			documentId: driveId,
-			scope: getSharedActionScope(driveActions),
-			branch: "main",
-			actions: driveActions,
-			dependsOn: ["document"]
-		}] }, signal);
-		const completedJobs = await Promise.all(Object.values(batchResult.jobs).map((job) => this.waitForJob(job, signal)));
-		for (const job of completedJobs) if (job.status === JobStatus.FAILED) throw new Error(job.error?.message);
-		return this.reactor.get(documentId);
+		return this.drives.addFile(driveId, document, parentFolder, signal);
 	}
 	/**
 	* Applies a list of actions to a document and waits for completion
@@ -779,32 +930,32 @@ var ReactorClient = class {
 	/**
 	* Adds multiple documents as children to another and waits for completion
 	*/
-	async addChildren(parentIdentifier, documentIdentifiers, branch = "main", signal) {
-		this.logger.verbose("addChildren(@parentIdentifier, @count children, @branch)", parentIdentifier, documentIdentifiers.length, branch);
-		const jobInfo = await this.reactor.addChildren(parentIdentifier, documentIdentifiers, branch, this.signer, signal);
+	async addRelationship(sourceIdentifier, targetIdentifier, relationshipType, branch = "main", signal) {
+		this.logger.verbose("addRelationship(@sourceIdentifier, @targetIdentifier, @relationshipType, @branch)", sourceIdentifier, targetIdentifier, relationshipType, branch);
+		const jobInfo = await this.reactor.addRelationship(sourceIdentifier, targetIdentifier, relationshipType, branch, this.signer, signal);
 		const completedJob = await this.waitForJob(jobInfo, signal);
 		if (completedJob.status === JobStatus.FAILED) throw new Error(completedJob.error?.message);
-		return await this.reactor.getByIdOrSlug(parentIdentifier, { branch }, completedJob.consistencyToken, signal);
+		return await this.reactor.getByIdOrSlug(sourceIdentifier, { branch }, completedJob.consistencyToken, signal);
 	}
 	/**
-	* Removes multiple documents as children from another and waits for completion
+	* Removes a relationship between two documents and waits for completion.
 	*/
-	async removeChildren(parentIdentifier, documentIdentifiers, branch = "main", signal) {
-		this.logger.verbose("removeChildren(@parentIdentifier, @count children, @branch)", parentIdentifier, documentIdentifiers.length, branch);
-		const jobInfo = await this.reactor.removeChildren(parentIdentifier, documentIdentifiers, branch, this.signer, signal);
+	async removeRelationship(sourceIdentifier, targetIdentifier, relationshipType, branch = "main", signal) {
+		this.logger.verbose("removeRelationship(@sourceIdentifier, @targetIdentifier, @relationshipType, @branch)", sourceIdentifier, targetIdentifier, relationshipType, branch);
+		const jobInfo = await this.reactor.removeRelationship(sourceIdentifier, targetIdentifier, relationshipType, branch, this.signer, signal);
 		const completedJob = await this.waitForJob(jobInfo, signal);
 		if (completedJob.status === JobStatus.FAILED) throw new Error(completedJob.error?.message);
-		return await this.reactor.getByIdOrSlug(parentIdentifier, { branch }, completedJob.consistencyToken, signal);
+		return await this.reactor.getByIdOrSlug(sourceIdentifier, { branch }, completedJob.consistencyToken, signal);
 	}
 	/**
-	* Moves multiple documents from one parent to another and waits for completion
+	* Moves a relationship from one source document to another and waits for completion.
 	*/
-	async moveChildren(sourceParentIdentifier, targetParentIdentifier, documentIdentifiers, branch = "main", signal) {
-		this.logger.verbose("moveChildren(@sourceParentIdentifier, @targetParentIdentifier, @count children, @branch)", sourceParentIdentifier, targetParentIdentifier, documentIdentifiers.length, branch);
-		const removeJobInfo = await this.reactor.removeChildren(sourceParentIdentifier, documentIdentifiers, branch, this.signer, signal);
+	async moveRelationship(sourceParentIdentifier, targetParentIdentifier, targetIdentifier, relationshipType, branch = "main", signal) {
+		this.logger.verbose("moveRelationship(@sourceParentIdentifier, @targetParentIdentifier, @targetIdentifier, @relationshipType, @branch)", sourceParentIdentifier, targetParentIdentifier, targetIdentifier, relationshipType, branch);
+		const removeJobInfo = await this.reactor.removeRelationship(sourceParentIdentifier, targetIdentifier, relationshipType, branch, this.signer, signal);
 		const removeCompletedJob = await this.waitForJob(removeJobInfo, signal);
 		if (removeCompletedJob.status === JobStatus.FAILED) throw new Error(removeCompletedJob.error?.message);
-		const addJobInfo = await this.reactor.addChildren(targetParentIdentifier, documentIdentifiers, branch, this.signer, signal);
+		const addJobInfo = await this.reactor.addRelationship(targetParentIdentifier, targetIdentifier, relationshipType, branch, this.signer, signal);
 		const addCompletedJob = await this.waitForJob(addJobInfo, signal);
 		if (addCompletedJob.status === JobStatus.FAILED) throw new Error(addCompletedJob.error?.message);
 		return {
@@ -841,13 +992,13 @@ var ReactorClient = class {
 			}
 			for (const descendantId of toDelete) {
 				if (descendantId === identifier) continue;
-				const removalJobs = await this.removeFromAllParents(descendantId, signal);
+				const removalJobs = await this.removeAllIncomingRelationships(descendantId, signal);
 				jobs.push(...removalJobs);
 				const jobInfo = await this.reactor.deleteDocument(descendantId, this.signer, signal);
 				jobs.push(jobInfo);
 			}
 		}
-		const removalJobs = await this.removeFromAllParents(identifier, signal);
+		const removalJobs = await this.removeAllIncomingRelationships(identifier, signal);
 		jobs.push(...removalJobs);
 		const jobInfo = await this.reactor.deleteDocument(identifier, this.signer, signal);
 		jobs.push(jobInfo);
@@ -923,46 +1074,15 @@ var ReactorClient = class {
 			unsubscribeRelationship();
 		};
 	}
-	async removeFromAllParents(documentId, signal) {
+	async removeAllIncomingRelationships(documentId, signal) {
 		const incoming = await this.documentIndexer.getIncoming(documentId, void 0, void 0, void 0, signal);
 		const jobs = [];
 		for (const rel of incoming.results) {
-			const relJobs = await this.removeFromParent(documentId, rel, signal);
-			jobs.push(...relJobs);
+			const jobInfo = await this.reactor.removeRelationship(rel.sourceId, documentId, rel.relationshipType, "main", this.signer, signal);
+			jobs.push(jobInfo);
 		}
 		return jobs;
 	}
-	async removeFromParent(documentId, rel, signal) {
-		const parentId = rel.sourceId;
-		let parentDoc;
-		try {
-			parentDoc = await this.reactor.get(parentId, void 0, void 0, signal);
-		} catch {
-			return [];
-		}
-		const isDrive = parentDoc.header.documentType === "powerhouse/document-drive";
-		const relationshipActions = await signActions([removeRelationshipAction(parentId, documentId, rel.relationshipType)], this.signer, signal);
-		if (isDrive) {
-			const driveActions = await signActions([deleteNode({ id: documentId })], this.signer, signal);
-			const batchResult = await this.reactor.executeBatch({ jobs: [{
-				key: "relationship",
-				documentId: parentId,
-				scope: getSharedActionScope(relationshipActions),
-				branch: "main",
-				actions: relationshipActions,
-				dependsOn: []
-			}, {
-				key: "drive",
-				documentId: parentId,
-				scope: getSharedActionScope(driveActions),
-				branch: "main",
-				actions: driveActions,
-				dependsOn: ["relationship"]
-			}] }, signal);
-			return [...Object.values(batchResult.jobs)];
-		}
-		return [await this.reactor.removeChildren(parentId, [documentId], "main", this.signer, signal)];
-	}
 };
 //#endregion
 //#region src/cache/collection-membership-cache.ts
@@ -8816,13 +8936,13 @@ var Reactor = class {
 		this.logger.verbose("getByIdOrSlug(@identifier, @view)", identifier, view);
 		return await this.documentView.getByIdOrSlug(identifier, view, consistencyToken, signal);
 	}
-	async getChildren(documentId, consistencyToken, signal) {
-		const relationships = await this.documentIndexer.getOutgoing(documentId, ["child"], void 0, consistencyToken, signal);
+	async getOutgoingRelationships(sourceId, relationshipType, consistencyToken, signal) {
+		const relationships = await this.documentIndexer.getOutgoing(sourceId, [relationshipType], void 0, consistencyToken, signal);
 		if (signal?.aborted) throw new AbortError();
 		return relationships.results.map((rel) => rel.targetId);
 	}
-	async getParents(childId, consistencyToken, signal) {
-		const relationships = await this.documentIndexer.getIncoming(childId, ["parent"], void 0, consistencyToken, signal);
+	async getIncomingRelationships(targetId, relationshipType, consistencyToken, signal) {
+		const relationships = await this.documentIndexer.getIncoming(targetId, [relationshipType], void 0, consistencyToken, signal);
 		if (signal?.aborted) throw new AbortError();
 		return relationships.results.map((rel) => rel.sourceId);
 	}
@@ -9182,19 +9302,19 @@ var Reactor = class {
 		}
 		return { jobs: Object.fromEntries(jobInfos) };
 	}
-	async addChildren(parentId, documentIds, branch = "main", signer, signal) {
-		this.logger.verbose("addChildren(@parentId, @count children, @branch)", parentId, documentIds.length, branch);
+	async addRelationship(sourceId, targetId, relationshipType, branch = "main", signer, signal) {
+		this.logger.verbose("addRelationship(@sourceId, @targetId, @relationshipType, @branch)", sourceId, targetId, relationshipType, branch);
 		if (signal?.aborted) throw new AbortError();
-		let actions = documentIds.map((childId) => addRelationshipAction(parentId, childId, "child"));
+		let actions = [addRelationshipAction(sourceId, targetId, relationshipType)];
 		if (signer) actions = await signActions(actions, signer, signal);
-		return await this.execute(parentId, branch, actions, signal);
+		return await this.execute(sourceId, branch, actions, signal);
 	}
-	async removeChildren(parentId, documentIds, branch = "main", signer, signal) {
-		this.logger.verbose("removeChildren(@parentId, @count children, @branch)", parentId, documentIds.length, branch);
+	async removeRelationship(sourceId, targetId, relationshipType, branch = "main", signer, signal) {
+		this.logger.verbose("removeRelationship(@sourceId, @targetId, @relationshipType, @branch)", sourceId, targetId, relationshipType, branch);
 		if (signal?.aborted) throw new AbortError();
-		let actions = documentIds.map((childId) => removeRelationshipAction(parentId, childId, "child"));
+		let actions = [removeRelationshipAction(sourceId, targetId, relationshipType)];
 		if (signer) actions = await signActions(actions, signer, signal);
-		return await this.execute(parentId, branch, actions, signal);
+		return await this.execute(sourceId, branch, actions, signal);
 	}
 	getJobStatus(jobId, signal) {
 		this.logger.verbose("getJobStatus(@jobId)", jobId);
@@ -9772,6 +9892,6 @@ var DocumentIntegrityService = class {
 	}
 };
 //#endregion
-export { BaseReadModel, ChannelError, ChannelErrorSource, ChannelScheme, ConsistencyTracker, DefaultSubscriptionErrorHandler, DocumentChangeType, DocumentIntegrityService, DocumentModelRegistry, DuplicateManifestError, DuplicateModuleError, DuplicateOperationError, EventBus, EventBusAggregateError, GqlRequestChannel, GqlRequestChannelFactory, GqlResponseChannel, GqlResponseChannelFactory, SimpleJobExecutor as InMemoryJobExecutor, SimpleJobExecutor, InMemoryJobTracker, InMemoryQueue, IntervalPollTimer, InvalidModuleError, JobAwaiter, JobExecutorEventTypes, JobStatus, KyselyDocumentIndexer, KyselyDocumentView, KyselyKeyframeStore, KyselyOperationStore, KyselySyncCursorStorage, KyselySyncRemoteStorage, KyselyWriteCache, Mailbox, ModuleNotFoundError, NullDocumentModelResolver, OptimisticLockError, PollingChannelError, ProcessorManager, PropagationMode, QueueEventTypes, REACTOR_SCHEMA, Reactor, ReactorBuilder, ReactorClient, ReactorClientBuilder, ReactorEventTypes, ReactorSubscriptionManager, ReadModelCoordinator, RelationalDbProcessor, RelationshipChangeType, RevisionMismatchError, SimpleJobExecutorManager, SyncBuilder, SyncEventTypes, SyncOperation, SyncOperationAggregateError, SyncOperationStatus, SyncStatus, SyncStatusTracker, addRelationshipAction, batchOperationsByDocument, consolidateSyncOperations, createDocumentAction, createMutableShutdownStatus, createRelationalDb, deleteDocumentAction, documentActions, driveCollectionId, driveIdFromUrl, envelopesToSyncOperations, getMigrationStatus, makeConsistencyKey, parseDriveUrl, removeRelationshipAction, runMigrations, sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, upgradeDocumentAction };
+export { BaseReadModel, ChannelError, ChannelErrorSource, ChannelScheme, ConsistencyTracker, DefaultSubscriptionErrorHandler, DocumentChangeType, DocumentIntegrityService, DocumentModelRegistry, DriveClient, DuplicateManifestError, DuplicateModuleError, DuplicateOperationError, EventBus, EventBusAggregateError, GqlRequestChannel, GqlRequestChannelFactory, GqlResponseChannel, GqlResponseChannelFactory, SimpleJobExecutor as InMemoryJobExecutor, SimpleJobExecutor, InMemoryJobTracker, InMemoryQueue, IntervalPollTimer, InvalidModuleError, JobAwaiter, JobExecutorEventTypes, JobStatus, KyselyDocumentIndexer, KyselyDocumentView, KyselyKeyframeStore, KyselyOperationStore, KyselySyncCursorStorage, KyselySyncRemoteStorage, KyselyWriteCache, Mailbox, ModuleNotFoundError, NullDocumentModelResolver, OptimisticLockError, PollingChannelError, ProcessorManager, PropagationMode, QueueEventTypes, REACTOR_SCHEMA, Reactor, ReactorBuilder, ReactorClient, ReactorClientBuilder, ReactorEventTypes, ReactorSubscriptionManager, ReadModelCoordinator, RelationalDbProcessor, RelationshipChangeType, RevisionMismatchError, SimpleJobExecutorManager, SyncBuilder, SyncEventTypes, SyncOperation, SyncOperationAggregateError, SyncOperationStatus, SyncStatus, SyncStatusTracker, addRelationshipAction, batchOperationsByDocument, consolidateSyncOperations, createDocumentAction, createMutableShutdownStatus, createRelationalDb, deleteDocumentAction, documentActions, driveCollectionId, driveIdFromUrl, envelopesToSyncOperations, getMigrationStatus, makeConsistencyKey, parseDriveUrl, removeRelationshipAction, runMigrations, sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, upgradeDocumentAction };
 
 //# sourceMappingURL=index.js.map