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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Action, CreateDocumentActionInput, DocumentModelModule, ISigner, Operation, OperationContext, OperationWithContext, OperationWithContext as OperationWithContext$1, PHDocument, PHDocumentState, SignatureVerificationHandler, UpgradeDocumentActionInput, UpgradeManifest, UpgradeReducer, UpgradeTransition, actions as documentActions } from "@powerhousedao/shared/document-model";
+import { DocumentDriveDocument, DriveInput, FolderNode, Node } from "@powerhousedao/shared/document-drive";
 import { ILogger } from "document-model";
 import * as kysely from "kysely";
 import { Generated, Insertable, Kysely, Transaction } from "kysely";
@@ -1266,6 +1267,544 @@ interface IEventBus {
   emit(type: number, data: any): Promise<void>;
 }
 //#endregion
+//#region src/shared/awaiter.d.ts
+interface IJobAwaiter {
+  /**
+   * Waits for a job to complete: turns a job into a promise.
+   *
+   * @param jobId - The job id or job object
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The result of the job
+   */
+  waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Shuts down the job awaiter. This will synchronously reject all pending jobs.
+   */
+  shutdown(): void;
+}
+/**
+ * Event-driven implementation of IJobAwaiter.
+ * Subscribes to operation events to detect job completion without polling.
+ */
+declare class JobAwaiter implements IJobAwaiter {
+  private eventBus;
+  private getJobStatus;
+  private pendingJobs;
+  private unsubscribers;
+  constructor(eventBus: IEventBus, getJobStatus: (jobId: string, signal?: AbortSignal) => Promise<JobInfo>);
+  private subscribeToEvents;
+  shutdown(): void;
+  waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  private handleWriteReady;
+  private handleReadReady;
+  private handleJobFailed;
+  private checkAndResolveWaiters;
+}
+//#endregion
+//#region src/subs/types.d.ts
+/**
+ * Error handler for subscription callback errors
+ */
+interface ISubscriptionErrorHandler {
+  /**
+   * Called when a subscription callback throws an error
+   * @param error - The error that was thrown
+   * @param context - Context about which subscription failed
+   */
+  handleError(error: unknown, context: SubscriptionErrorContext): void;
+}
+/**
+ * Context information about a subscription error
+ */
+interface SubscriptionErrorContext {
+  /** The type of event that was being processed */
+  eventType: "created" | "deleted" | "updated" | "relationshipChanged";
+  /** The subscription ID that failed */
+  subscriptionId: string;
+  /** Optional additional data about the event */
+  eventData?: unknown;
+}
+/**
+ * Interface for subscribing to document events in the reactor.
+ */
+interface IReactorSubscriptionManager {
+  /**
+   * Subscribes to document creation events
+   *
+   * @param callback - Function called when documents are created
+   * @param search - Optional search filter to limit which documents trigger events
+   * @param view - Optional filter containing branch and scopes information
+   * @returns A function that unsubscribes from the events
+   */
+  onDocumentCreated(callback: (result: PagedResults<string>) => void, search?: SearchFilter): () => void;
+  /**
+   * Subscribes to document deletion events
+   *
+   * @param callback - Function called when documents are deleted
+   * @param search - Optional search filter to limit which documents trigger events
+   * @returns A function that unsubscribes from the events
+   */
+  onDocumentDeleted(callback: (documentIds: string[]) => void, search?: SearchFilter): () => void;
+  /**
+   * Subscribes to document state updates
+   *
+   * @param callback - Function called when documents are updated
+   * @param search - Optional search filter to limit which documents trigger events
+   * @param view - Optional filter containing branch and scopes information
+   * @returns A function that unsubscribes from the events
+   */
+  onDocumentStateUpdated(callback: (result: PagedResults<PHDocument>) => void, search?: SearchFilter, view?: ViewFilter): () => void;
+  /**
+   * Subscribes to parent-child relationship change events
+   *
+   * @param callback - Function called when parent-child relationships change
+   * @param search - Optional search filter to limit which documents trigger events
+   * @returns A function that unsubscribes from the events
+   */
+  onRelationshipChanged(callback: (parentId: string, childId: string, changeType: RelationshipChangeType) => void, search?: SearchFilter): () => void;
+}
+//#endregion
+//#region src/client/types.d.ts
+/**
+ * Describes the types of document changes that can occur.
+ */
+declare enum DocumentChangeType {
+  Created = "created",
+  Deleted = "deleted",
+  Updated = "updated",
+  ParentAdded = "parent_added",
+  ParentRemoved = "parent_removed",
+  ChildAdded = "child_added",
+  ChildRemoved = "child_removed"
+}
+/**
+ * Represents a change event for documents.
+ */
+type DocumentChangeEvent = {
+  type: DocumentChangeType;
+  documents: PHDocument[];
+  context?: {
+    parentId?: string;
+    childId?: string;
+  };
+};
+/**
+ * Options for creating an empty document.
+ */
+type CreateDocumentOptions = {
+  /** Optional "id" or "slug" of parent document */parentIdentifier?: string; /** Optional version of the document model to use (defaults to latest) */
+  documentModelVersion?: number;
+};
+/**
+ * Drive-aware operations grouped under `client.drives`.
+ *
+ * These methods orchestrate the multi-action, multi-document choreography
+ * required to keep a drive's `state.global.nodes` array consistent with the
+ * relationship index and the underlying documents. Use the flat
+ * `IReactorClient` primitives (`get`, `execute`, `find`) for everything that
+ * is not drive-aware.
+ */
+interface IDriveClient {
+  /**
+   * Creates a new drive document and waits for completion.
+   */
+  create(input: DriveInput, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  /**
+   * Adds a document to a drive as a single batched operation.
+   *
+   * Issues CREATE_DOCUMENT, UPGRADE_DOCUMENT, ADD_RELATIONSHIP on the new
+   * document and ADD_FILE on the drive in a single dependent batch.
+   */
+  addFile<TDocument extends PHDocument = PHDocument>(driveIdentifier: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Adds a folder node to a drive.
+   */
+  addFolder(driveIdentifier: string, name: string, parentFolder?: string, signal?: AbortSignal): Promise<FolderNode>;
+  /**
+   * Removes a node from a drive. Folder nodes cascade: descendant file
+   * documents are deleted first, then the folder node entry itself.
+   */
+  removeNode(driveIdentifier: string, nodeId: string, signal?: AbortSignal): Promise<void>;
+  /**
+   * Renames a node. Updates both the underlying document header and the
+   * drive's node entry.
+   */
+  renameNode(driveIdentifier: string, nodeId: string, name: string, signal?: AbortSignal): Promise<Node>;
+  /**
+   * Moves a node to a different parent folder within the same drive.
+   * Pass `undefined` to move the node to the drive root.
+   */
+  moveNode(driveIdentifier: string, srcNodeId: string, targetParentFolderId: string | undefined, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  /**
+   * Copies a node (and its subtree, if it is a folder) within a drive.
+   * Each copied file gets a new id and a duplicated document.
+   */
+  copyNode(driveIdentifier: string, srcNodeId: string, targetParentFolderId: string | undefined, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  /**
+   * Returns a single node from the drive's `state.global.nodes` array.
+   */
+  getNode(driveIdentifier: string, nodeId: string, signal?: AbortSignal): Promise<Node>;
+  /**
+   * Returns nodes in the drive, optionally filtered to a single parent
+   * folder. Pass `null` to list root-level nodes only.
+   */
+  listNodes(driveIdentifier: string, parentFolder?: string | null, signal?: AbortSignal): Promise<Node[]>;
+}
+/**
+ * The ReactorClient interface that wraps lower-level APIs to provide
+ * a simpler interface for document operations.
+ *
+ * Features:
+ * - Wraps Jobs with Promises for easier async handling
+ * - Manages signing of submitted Action objects
+ * - Provides quality-of-life functions for common tasks
+ * - Wraps subscription interface with ViewFilters
+ */
+interface IReactorClient {
+  /**
+   * Drive-aware operations. See {@link IDriveClient}.
+   */
+  readonly drives: IDriveClient;
+  /**
+   * Retrieves a list of document model modules.
+   *
+   * @param namespace - Optional namespace like "powerhouse" or "sky", defaults to ""
+   * @param paging - Optional pagination options
+   * @param signal - Optional abort signal to cancel the request
+   * @returns List of document model modules
+   */
+  getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
+  /**
+   * Retrieves a specific document model module by document type.
+   *
+   * @param documentType - The document type identifier
+   * @returns The document model module
+   */
+  getDocumentModelModule(documentType: string): Promise<DocumentModelModule<any>>;
+  /**
+   * Retrieves a specific document by identifier (either id or slug).
+   *
+   * @param identifier - Required, this is the document id or slug
+   * @param view - Optional filter containing branch and scopes information
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The up-to-date PHDocument with scopes and list of child document ids
+   */
+  get<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Retrieves operations for a document.
+   *
+   * @param documentIdentifier - Required, this is either a document "id" field or a "slug"
+   * @param view - Optional filter containing branch and scopes information
+   * @param filter - Optional filter for actionTypes, timestamps, and revision
+   * @param paging - Optional pagination options
+   * @param signal - Optional abort signal to cancel the request
+   * @returns Paginated list of operations
+   */
+  getOperations(documentIdentifier: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
+  /**
+   * Retrieves outgoing relationships of a given type from a source document.
+   *
+   * @param sourceIdentifier - Required, this is either a document "id" field or a "slug"
+   * @param relationshipType - The relationship type to filter by
+   * @param view - Optional filter containing branch and scopes information
+   * @param paging - Optional pagination options
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The target documents and paging cursor
+   */
+  getOutgoingRelationships(sourceIdentifier: string, relationshipType: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Retrieves incoming relationships of a given type to a target document.
+   *
+   * @param targetIdentifier - Required, this is either a document "id" field or a "slug"
+   * @param relationshipType - The relationship type to filter by
+   * @param view - Optional filter containing branch and scopes information
+   * @param paging - Optional pagination options
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The source documents and paging cursor
+   */
+  getIncomingRelationships(targetIdentifier: string, relationshipType: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Filters documents by criteria and returns a list of them
+   *
+   * @param search - Search filter options (type, parentId, identifiers)
+   * @param view - Optional filter containing branch and scopes information
+   * @param paging - Optional pagination options
+   * @param signal - Optional abort signal to cancel the request
+   * @returns List of documents matching criteria and pagination cursor
+   */
+  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Creates a document and waits for completion
+   *
+   * @param document - Document with optional id, slug, parent, model type, and initial state
+   * @param parentIdentifier - Optional "id" or "slug" of parent document
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The created document
+   */
+  create<TDocument extends PHDocument = PHDocument>(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Creates an empty document and waits for completion
+   *
+   * @param documentModelType - Type of document to create
+   * @param options - Optional creation options (parentIdentifier, documentModelVersion)
+   * @param signal - Optional abort signal to cancel the request
+   */
+  createEmpty<TDocument extends PHDocument>(documentModelType: string, options?: CreateDocumentOptions, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Creates an empty document in a drive as a single batched operation.
+   * This is more efficient than createEmpty + addFile as it batches all
+   * actions into dependent jobs and waits for them to complete together.
+   *
+   * @deprecated Use {@link IDriveClient.addFile} via `client.drives.addFile`
+   * instead. This method will be removed in a future release.
+   * @param driveId - The drive document id or slug
+   * @param document - The document to create
+   * @param parentFolder - Optional folder id within the drive
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The created document
+   */
+  createDocumentInDrive<TDocument extends PHDocument>(driveId: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Applies a list of actions to a document and waits for completion
+   *
+   * @param documentIdentifier - Target document id or slug
+   * @param branch - Branch to apply actions to
+   * @param actions - List of actions to apply
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The updated document
+   */
+  execute<TDocument extends PHDocument>(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Submits a list of actions to a document
+   *
+   * @param documentIdentifier - Target document id or slug
+   * @param branch - Branch to apply actions to
+   * @param actions - List of actions to apply
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The job
+   */
+  executeAsync(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Renames a document and waits for completion
+   *
+   * @param documentIdentifier - Target document id or slug
+   * @param name - The new name of the document
+   * @param branch - Optional branch to rename the document, defaults to "main"
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The updated document.
+   */
+  rename(documentIdentifier: string, name: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Adds a relationship between two documents and waits for completion.
+   *
+   * @param sourceIdentifier - Source document id or slug
+   * @param targetIdentifier - Target document id or slug
+   * @param relationshipType - Relationship type identifier
+   * @param branch - Optional branch to add the relationship to, defaults to "main"
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The updated source document
+   */
+  addRelationship(sourceIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Removes a relationship between two documents and waits for completion.
+   *
+   * @param sourceIdentifier - Source document id or slug
+   * @param targetIdentifier - Target document id or slug
+   * @param relationshipType - Relationship type identifier
+   * @param branch - Optional branch to remove the relationship from, defaults to "main"
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The updated source document
+   */
+  removeRelationship(sourceIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Moves a relationship from one source document to another and waits for completion.
+   *
+   * @param sourceParentIdentifier - Source parent document id or slug
+   * @param targetParentIdentifier - Target parent document id or slug
+   * @param targetIdentifier - The target document id or slug
+   * @param relationshipType - Relationship type identifier
+   * @param branch - Optional branch to apply the move to, defaults to "main"
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The updated source and target documents
+   */
+  moveRelationship(sourceParentIdentifier: string, targetParentIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<{
+    source: PHDocument;
+    target: PHDocument;
+  }>;
+  /**
+   * Deletes a document and waits for completion
+   *
+   * @param identifier - Document identifier (id or slug)
+   * @param propagate - Optional mode for handling children, CASCADE deletes child documents
+   * @param signal - Optional abort signal to cancel the request
+   * @returns a promise, resolving on deletion confirmation
+   */
+  deleteDocument(identifier: string, propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  /**
+   * Deletes documents and waits for completion
+   *
+   * @param identifiers - Document identifiers (ids or slugs)
+   * @param propagate - Optional mode for handling children, CASCADE deletes child documents
+   * @param signal - Optional abort signal to cancel the request
+   * @returns a promise, resolving on deletion confirmation
+   */
+  deleteDocuments(identifiers: string[], propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  /**
+   * Loads multiple batches of pre-existing operations across documents with dependency management.
+   * Waits for all jobs to complete.
+   *
+   * @param request - Batch load request containing jobs with dependencies
+   * @param signal - Optional abort signal to cancel the request
+   * @returns Map of job keys to completed job information
+   */
+  loadBatch(request: BatchLoadRequest, signal?: AbortSignal): Promise<BatchLoadResult>;
+  /**
+   * Retrieves the status of a job
+   *
+   * @param jobId - The job id
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The job status
+   */
+  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Waits for a job to complete
+   *
+   * @param jobId - The job id or job object
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The result of the job
+   */
+  waitForJob(jobId: string | JobInfo, signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Subscribes to changes for documents matching specified filters
+   *
+   * @param search - Search filter options (type, parentId, identifiers)
+   * @param callback - Function called when documents change with the change event details
+   * @param view - Optional filter containing branch and scopes information
+   * @returns A function that unsubscribes from the changes
+   */
+  subscribe(search: SearchFilter, callback: (event: DocumentChangeEvent) => void, view?: ViewFilter): () => void;
+}
+//#endregion
+//#region src/client/reactor-client.d.ts
+/**
+ * ReactorClient implementation that wraps lower-level APIs to provide
+ * a simpler interface for document operations.
+ *
+ * Features:
+ * - Wraps Jobs with Promises for easier async handling
+ * - Manages signing of submitted Action objects
+ * - Provides quality-of-life functions for common tasks
+ * - Wraps subscription interface with ViewFilters
+ */
+declare class ReactorClient implements IReactorClient {
+  private logger;
+  private reactor;
+  private signer;
+  private subscriptionManager;
+  private jobAwaiter;
+  private documentIndexer;
+  private documentView;
+  readonly drives: IDriveClient;
+  constructor(logger: ILogger, reactor: IReactor, signer: ISigner, subscriptionManager: IReactorSubscriptionManager, jobAwaiter: IJobAwaiter, documentIndexer: IDocumentIndexer, documentView: IDocumentView);
+  /**
+   * Retrieves a list of document model modules.
+   */
+  getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
+  /**
+   * Retrieves a specific document model module by document type.
+   *
+   * @param documentType - The document type identifier
+   * @returns The document model module
+   */
+  getDocumentModelModule(documentType: string): Promise<DocumentModelModule<any>>;
+  /**
+   * Retrieves a specific PHDocument
+   */
+  get<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Retrieves operations for a document
+   */
+  getOperations(documentIdentifier: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
+  private getOperationsWithCompositeCursor;
+  /**
+   * Retrieves outgoing relationships of a given type from a source document.
+   */
+  getOutgoingRelationships(sourceIdentifier: string, relationshipType: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Retrieves incoming relationships of a given type to a target document.
+   */
+  getIncomingRelationships(targetIdentifier: string, relationshipType: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Filters documents by criteria and returns a list of them
+   */
+  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  /**
+   * Creates a document and waits for completion
+   */
+  create<TDocument extends PHDocument = PHDocument>(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Creates an empty document and waits for completion
+   */
+  createEmpty<TDocument extends PHDocument>(documentModelType: string, options?: CreateDocumentOptions, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * 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.
+   */
+  createDocumentInDrive<TDocument extends PHDocument>(driveId: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Applies a list of actions to a document and waits for completion
+   */
+  execute<TDocument extends PHDocument>(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<TDocument>;
+  /**
+   * Submits a list of actions to a document
+   */
+  executeAsync(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Renames a document and waits for completion
+   */
+  rename(documentIdentifier: string, name: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Adds multiple documents as children to another and waits for completion
+   */
+  addRelationship(sourceIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Removes a relationship between two documents and waits for completion.
+   */
+  removeRelationship(sourceIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  /**
+   * Moves a relationship from one source document to another and waits for completion.
+   */
+  moveRelationship(sourceParentIdentifier: string, targetParentIdentifier: string, targetIdentifier: string, relationshipType: string, branch?: string, signal?: AbortSignal): Promise<{
+    source: PHDocument;
+    target: PHDocument;
+  }>;
+  loadBatch(request: BatchLoadRequest, signal?: AbortSignal): Promise<BatchLoadResult>;
+  /**
+   * Deletes a document and waits for completion
+   */
+  deleteDocument(identifier: string, propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  /**
+   * Deletes documents and waits for completion
+   */
+  deleteDocuments(identifiers: string[], propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  /**
+   * Retrieves the status of a job
+   */
+  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Waits for a job to complete
+   */
+  waitForJob(jobId: string | JobInfo, signal?: AbortSignal): Promise<JobInfo>;
+  /**
+   * Subscribes to changes for documents matching specified filters
+   */
+  subscribe(search: SearchFilter, callback: (event: DocumentChangeEvent) => void, view?: ViewFilter): () => void;
+  private removeAllIncomingRelationships;
+}
+//#endregion
 //#region src/executor/types.d.ts
 /**
  * Represents the result of a job execution
@@ -1708,40 +2247,6 @@ interface IDocumentModelRegistry {
   getUpgradeReducer(documentType: string, fromVersion: number, toVersion: number): UpgradeReducer<any, any>;
 }
 //#endregion
-//#region src/shared/awaiter.d.ts
-interface IJobAwaiter {
-  /**
-   * Waits for a job to complete: turns a job into a promise.
-   *
-   * @param jobId - The job id or job object
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The result of the job
-   */
-  waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
-  /**
-   * Shuts down the job awaiter. This will synchronously reject all pending jobs.
-   */
-  shutdown(): void;
-}
-/**
- * Event-driven implementation of IJobAwaiter.
- * Subscribes to operation events to detect job completion without polling.
- */
-declare class JobAwaiter implements IJobAwaiter {
-  private eventBus;
-  private getJobStatus;
-  private pendingJobs;
-  private unsubscribers;
-  constructor(eventBus: IEventBus, getJobStatus: (jobId: string, signal?: AbortSignal) => Promise<JobInfo>);
-  private subscribeToEvents;
-  shutdown(): void;
-  waitForJob(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
-  private handleWriteReady;
-  private handleReadReady;
-  private handleJobFailed;
-  private checkAndResolveWaiters;
-}
-//#endregion
 //#region src/shared/consistency-tracker.d.ts
 interface IConsistencyTracker {
   /**
@@ -1877,108 +2382,45 @@ interface SyncDeadLetterTable {
   job_dependencies: unknown;
   remote_name: string;
   document_id: string;
-  scopes: unknown;
-  branch: string;
-  operations: unknown;
-  error_source: string;
-  error_message: string;
-  created_at: Generated<Date>;
-}
-interface Database$1 {
-  Operation: OperationTable;
-  Keyframe: KeyframeTable;
-  document_collections: DocumentCollectionTable;
-  operation_index_operations: OperationIndexOperationTable;
-  sync_remotes: SyncRemoteTable;
-  sync_cursors: SyncCursorTable;
-  sync_dead_letters: SyncDeadLetterTable;
-}
-interface DocumentTable {
-  id: string;
-  createdAt: Generated<Date>;
-  updatedAt: Generated<Date>;
-}
-interface DocumentRelationshipTable {
-  id: Generated<string>;
-  sourceId: string;
-  targetId: string;
-  relationshipType: string;
-  metadata: unknown;
-  createdAt: Generated<Date>;
-  updatedAt: Generated<Date>;
-}
-interface IndexerStateTable {
-  id: Generated<number>;
-  lastOperationId: number;
-  lastOperationTimestamp: Generated<Date>;
-}
-interface DocumentIndexerDatabase {
-  Document: DocumentTable;
-  DocumentRelationship: DocumentRelationshipTable;
-  IndexerState: IndexerStateTable;
-}
-//#endregion
-//#region src/subs/types.d.ts
-/**
- * Error handler for subscription callback errors
- */
-interface ISubscriptionErrorHandler {
-  /**
-   * Called when a subscription callback throws an error
-   * @param error - The error that was thrown
-   * @param context - Context about which subscription failed
-   */
-  handleError(error: unknown, context: SubscriptionErrorContext): void;
-}
-/**
- * Context information about a subscription error
- */
-interface SubscriptionErrorContext {
-  /** The type of event that was being processed */
-  eventType: "created" | "deleted" | "updated" | "relationshipChanged";
-  /** The subscription ID that failed */
-  subscriptionId: string;
-  /** Optional additional data about the event */
-  eventData?: unknown;
-}
-/**
- * Interface for subscribing to document events in the reactor.
- */
-interface IReactorSubscriptionManager {
-  /**
-   * Subscribes to document creation events
-   *
-   * @param callback - Function called when documents are created
-   * @param search - Optional search filter to limit which documents trigger events
-   * @param view - Optional filter containing branch and scopes information
-   * @returns A function that unsubscribes from the events
-   */
-  onDocumentCreated(callback: (result: PagedResults<string>) => void, search?: SearchFilter): () => void;
-  /**
-   * Subscribes to document deletion events
-   *
-   * @param callback - Function called when documents are deleted
-   * @param search - Optional search filter to limit which documents trigger events
-   * @returns A function that unsubscribes from the events
-   */
-  onDocumentDeleted(callback: (documentIds: string[]) => void, search?: SearchFilter): () => void;
-  /**
-   * Subscribes to document state updates
-   *
-   * @param callback - Function called when documents are updated
-   * @param search - Optional search filter to limit which documents trigger events
-   * @param view - Optional filter containing branch and scopes information
-   * @returns A function that unsubscribes from the events
-   */
-  onDocumentStateUpdated(callback: (result: PagedResults<PHDocument>) => void, search?: SearchFilter, view?: ViewFilter): () => void;
-  /**
-   * Subscribes to parent-child relationship change events
-   *
-   * @param callback - Function called when parent-child relationships change
-   * @param search - Optional search filter to limit which documents trigger events
-   * @returns A function that unsubscribes from the events
-   */
-  onRelationshipChanged(callback: (parentId: string, childId: string, changeType: RelationshipChangeType) => void, search?: SearchFilter): () => void;
+  scopes: unknown;
+  branch: string;
+  operations: unknown;
+  error_source: string;
+  error_message: string;
+  created_at: Generated<Date>;
+}
+interface Database$1 {
+  Operation: OperationTable;
+  Keyframe: KeyframeTable;
+  document_collections: DocumentCollectionTable;
+  operation_index_operations: OperationIndexOperationTable;
+  sync_remotes: SyncRemoteTable;
+  sync_cursors: SyncCursorTable;
+  sync_dead_letters: SyncDeadLetterTable;
+}
+interface DocumentTable {
+  id: string;
+  createdAt: Generated<Date>;
+  updatedAt: Generated<Date>;
+}
+interface DocumentRelationshipTable {
+  id: Generated<string>;
+  sourceId: string;
+  targetId: string;
+  relationshipType: string;
+  metadata: unknown;
+  createdAt: Generated<Date>;
+  updatedAt: Generated<Date>;
+}
+interface IndexerStateTable {
+  id: Generated<number>;
+  lastOperationId: number;
+  lastOperationTimestamp: Generated<Date>;
+}
+interface DocumentIndexerDatabase {
+  Document: DocumentTable;
+  DocumentRelationship: DocumentRelationshipTable;
+  IndexerState: IndexerStateTable;
 }
 //#endregion
 //#region src/sync/errors.d.ts
@@ -2278,695 +2720,355 @@ interface ISyncManager {
    *
    * @returns Array of all remotes
    */
-  list(): Remote[];
-  /**
-   * Waits for sync operations for a job to complete.
-   * Resolves when SYNC_SUCCEEDED is emitted.
-   * Rejects when SYNC_FAILED is emitted.
-   *
-   * @param jobId - The job id to wait for
-   * @param signal - Optional abort signal
-   * @returns The sync result
-   */
-  waitForSync(jobId: string, signal?: AbortSignal): Promise<SyncResult>;
-  /**
-   * Gets the current sync status for a document.
-   *
-   * @param documentId - The document ID to check
-   * @returns The sync status, or undefined if the document has never been tracked
-   */
-  getSyncStatus(documentId: string): SyncStatus | undefined;
-  /**
-   * Registers a callback that fires when a document's sync status changes.
-   *
-   * @param callback - Called with (documentId, newStatus) on each transition
-   * @returns Unsubscribe function
-   */
-  onSyncStatusChange(callback: SyncStatusChangeCallback): () => void;
-}
-//#endregion
-//#region src/core/types.d.ts
-/**
- * A single mutation job within a batch request.
- */
-type ExecutionJobPlan = {
-  key: string;
-  documentId: string;
-  scope: string;
-  branch: string;
-  actions: Action[];
-  dependsOn: string[];
-};
-/**
- * Request for batch mutation operation.
- */
-type BatchExecutionRequest = {
-  jobs: ExecutionJobPlan[];
-};
-/**
- * Result from batch mutation operation.
- */
-type BatchExecutionResult = {
-  jobs: Record<string, JobInfo>;
-};
-/**
- * A single load job within a batch request.
- */
-type LoadJobPlan = {
-  key: string;
-  documentId: string;
-  scope: string;
-  branch: string;
-  operations: Operation[];
-  dependsOn: string[];
-};
-/**
- * Request for batch load operation.
- */
-type BatchLoadRequest = {
-  jobs: LoadJobPlan[];
-};
-/**
- * Result from batch load operation.
- */
-type BatchLoadResult = {
-  jobs: Record<string, JobInfo>;
-};
-/**
- * The main Reactor interface that serves as a facade for document operations.
- * This interface provides a unified API for document management, including
- * creation, retrieval, mutation, and deletion operations.
- */
-interface IReactor {
-  /**
-   * Signals that the reactor should shutdown.
-   */
-  kill(): ShutdownStatus;
-  /**
-   * Retrieves a list of document model modules.
-   *
-   * @param namespace - Optional namespace like "powerhouse" or "sky", defaults to ""
-   * @param paging - Optional options for paging data in large queries.
-   * @param signal - Optional abort signal to cancel the request
-   * @returns List of document model modules
-   */
-  getDocumentModels(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
-  /**
-   * Retrieves a specific PHDocument by id
-   *
-   * @param id - Required, this is the document id
-   * @param view - Optional filter containing branch and scopes information
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The up-to-date PHDocument
-   */
-  get<TDocument extends PHDocument>(id: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Retrieves a specific PHDocument by slug
-   *
-   * @param slug - Required, this is the document slug
-   * @param view - Optional filter containing branch and scopes information
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The up-to-date PHDocument with scopes and list of child document ids
-   */
-  getBySlug<TDocument extends PHDocument>(slug: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Retrieves a specific PHDocument by identifier (either id or slug).
-   * Throws an error if the identifier matches both an id and a slug that refer to different documents.
-   *
-   * @param identifier - Required, this is the document id or slug
-   * @param view - Optional filter containing branch and scopes information
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The up-to-date PHDocument with scopes and list of child document ids
-   * @throws {Error} If identifier matches both an ID and slug referring to different documents
-   */
-  getByIdOrSlug<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Retrieves the children of a document
-   *
-   * @param parentId - The parent document id
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The list of child document ids
-   */
-  getChildren(parentId: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-  /**
-   * Retrieves the parents of a document
-   *
-   * @param childId - The child document id
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The list of parent document ids
-   */
-  getParents(childId: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-  /**
-   * Retrieves the operations for a document
-   *
-   * @param documentId - The document id
-   * @param view - Optional filter containing branch and scopes information
-   * @param filter - Optional filter for actionTypes, timestamps, and revision
-   * @param paging - Optional pagination options
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The list of operations
-   */
-  getOperations(documentId: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<Record<string, PagedResults<Operation>>>;
-  /**
-   * Filters documents by criteria and returns a list of them
-   *
-   * @param search - Search filter options (type, parentId, identifiers)
-   * @param view - Optional filter containing branch and scopes information
-   * @param paging - Optional pagination options
-   * @param consistencyToken - Optional token for read-after-write consistency
-   * @param signal - Optional abort signal to cancel the request
-   * @returns List of documents matching criteria and pagination cursor
-   */
-  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-  /**
-   * Creates a document
-   *
-   * @param document - Document with optional id, slug, parent, model type, and initial state
-   * @param signer - Optional signer to sign the actions
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns The job status
-   */
-  create(document: PHDocument, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
-  /**
-   * Deletes a document
-   *
-   * @param id - Document id
-   * @param signer - Optional signer to sign the actions
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns The job id and status
-   */
-  deleteDocument(id: string, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
-  /**
-   * Applies a list of actions to a document.
-   *
-   * @param docId - Document id
-   * @param branch - Branch to apply actions to
-   * @param actions - List of actions to apply
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns The job id and status
-   */
-  execute(docId: string, branch: string, actions: Action[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
-  /**
-   * Loads existing operations generated elsewhere into this reactor.
-   *
-   * @param docId - Document id
-   * @param branch - Branch to load operations to
-   * @param operations - List of operations to load
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns The job id and status
-   */
-  load(docId: string, branch: string, operations: Operation[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
-  /**
-   * Applies multiple mutations across documents with dependency management.
-   *
-   * @param request - Batch mutation request containing jobs with dependencies
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns Map of job keys to job information
-   */
-  executeBatch(request: BatchExecutionRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchExecutionResult>;
-  /**
-   * Loads multiple batches of pre-existing operations across documents with dependency management.
-   *
-   * @param request - Batch load request containing jobs with dependencies
-   * @param signal - Optional abort signal to cancel the request
-   * @param meta - Optional metadata that flows through the job lifecycle
-   * @returns Map of job keys to job information
-   */
-  loadBatch(request: BatchLoadRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchLoadResult>;
+  list(): Remote[];
   /**
-   * Adds multiple documents as children to another
+   * Waits for sync operations for a job to complete.
+   * Resolves when SYNC_SUCCEEDED is emitted.
+   * Rejects when SYNC_FAILED is emitted.
    *
-   * @param parentId - Parent document id
-   * @param documentIds - List of document ids to add as children
-   * @param branch - Branch to add children to, defaults to "main"
-   * @param signer - Optional signer to sign the actions
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The job id and status
+   * @param jobId - The job id to wait for
+   * @param signal - Optional abort signal
+   * @returns The sync result
    */
-  addChildren(parentId: string, documentIds: string[], branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+  waitForSync(jobId: string, signal?: AbortSignal): Promise<SyncResult>;
   /**
-   * Removes multiple documents as children from another
+   * Gets the current sync status for a document.
    *
-   * @param parentId - Parent document id
-   * @param documentIds - List of document ids to remove as children
-   * @param branch - Branch to remove children from, defaults to "main"
-   * @param signer - Optional signer to sign the actions
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The job id and status
+   * @param documentId - The document ID to check
+   * @returns The sync status, or undefined if the document has never been tracked
    */
-  removeChildren(parentId: string, documentIds: string[], branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+  getSyncStatus(documentId: string): SyncStatus | undefined;
   /**
-   * Retrieves the status of a job
+   * Registers a callback that fires when a document's sync status changes.
    *
-   * @param jobId - The job id
-   * @returns The job status
+   * @param callback - Called with (documentId, newStatus) on each transition
+   * @returns Unsubscribe function
    */
-  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  onSyncStatusChange(callback: SyncStatusChangeCallback): () => void;
 }
+//#endregion
+//#region src/core/types.d.ts
 /**
- * Feature flags for reactor configuration
+ * A single mutation job within a batch request.
  */
-type ReactorFeatures = {
-  [key: string]: boolean;
+type ExecutionJobPlan = {
+  key: string;
+  documentId: string;
+  scope: string;
+  branch: string;
+  actions: Action[];
+  dependsOn: string[];
 };
 /**
- * Combined database type that includes all schemas
- */
-type Database = Database$1 & DocumentViewDatabase & DocumentIndexerDatabase;
-/**
- * Container for all sync manager dependencies created during the build process.
- */
-interface SyncModule {
-  remoteStorage: ISyncRemoteStorage;
-  cursorStorage: ISyncCursorStorage;
-  deadLetterStorage: ISyncDeadLetterStorage;
-  channelFactory: IChannelFactory;
-  syncManager: ISyncManager;
-}
-/**
- * Container for all reactor dependencies created during the build process.
- * Provides direct access to internal components for advanced use cases,
- * testing, or integration scenarios.
+ * Request for batch mutation operation.
  */
-interface ReactorModule {
-  eventBus: IEventBus;
-  documentModelRegistry: IDocumentModelRegistry;
-  queue: IQueue;
-  jobTracker: IJobTracker;
-  executorManager: IJobExecutorManager;
-  database: Kysely<Database>;
-  operationStore: IOperationStore;
-  keyframeStore: IKeyframeStore;
-  writeCache: IWriteCache;
-  operationIndex: IOperationIndex;
-  documentView: IDocumentView;
-  documentViewConsistencyTracker: IConsistencyTracker;
-  documentIndexer: IDocumentIndexer;
-  documentIndexerConsistencyTracker: IConsistencyTracker;
-  readModelCoordinator: IReadModelCoordinator;
-  subscriptionManager: IReactorSubscriptionManager;
-  processorManager: IProcessorManager$1;
-  processorManagerConsistencyTracker: IConsistencyTracker;
-  syncModule: SyncModule | undefined;
-  reactor: IReactor;
-}
+type BatchExecutionRequest = {
+  jobs: ExecutionJobPlan[];
+};
 /**
- * Container for all reactor client dependencies created during the build process.
- * Provides direct access to internal components for advanced use cases,
- * testing, or integration scenarios.
+ * Result from batch mutation operation.
  */
-interface ReactorClientModule {
-  client: ReactorClient;
-  reactor: IReactor;
-  eventBus: IEventBus;
-  documentIndexer: IDocumentIndexer;
-  documentView: IDocumentView;
-  signer: ISigner;
-  subscriptionManager: IReactorSubscriptionManager;
-  jobAwaiter: IJobAwaiter;
-  reactorModule: ReactorModule | undefined;
-}
-//#endregion
-//#region src/client/types.d.ts
+type BatchExecutionResult = {
+  jobs: Record<string, JobInfo>;
+};
 /**
- * Describes the types of document changes that can occur.
+ * A single load job within a batch request.
  */
-declare enum DocumentChangeType {
-  Created = "created",
-  Deleted = "deleted",
-  Updated = "updated",
-  ParentAdded = "parent_added",
-  ParentRemoved = "parent_removed",
-  ChildAdded = "child_added",
-  ChildRemoved = "child_removed"
-}
+type LoadJobPlan = {
+  key: string;
+  documentId: string;
+  scope: string;
+  branch: string;
+  operations: Operation[];
+  dependsOn: string[];
+};
 /**
- * Represents a change event for documents.
+ * Request for batch load operation.
  */
-type DocumentChangeEvent = {
-  type: DocumentChangeType;
-  documents: PHDocument[];
-  context?: {
-    parentId?: string;
-    childId?: string;
-  };
+type BatchLoadRequest = {
+  jobs: LoadJobPlan[];
 };
 /**
- * Options for creating an empty document.
+ * Result from batch load operation.
  */
-type CreateDocumentOptions = {
-  /** Optional "id" or "slug" of parent document */parentIdentifier?: string; /** Optional version of the document model to use (defaults to latest) */
-  documentModelVersion?: number;
+type BatchLoadResult = {
+  jobs: Record<string, JobInfo>;
 };
 /**
- * The ReactorClient interface that wraps lower-level APIs to provide
- * a simpler interface for document operations.
- *
- * Features:
- * - Wraps Jobs with Promises for easier async handling
- * - Manages signing of submitted Action objects
- * - Provides quality-of-life functions for common tasks
- * - Wraps subscription interface with ViewFilters
+ * The main Reactor interface that serves as a facade for document operations.
+ * This interface provides a unified API for document management, including
+ * creation, retrieval, mutation, and deletion operations.
  */
-interface IReactorClient {
+interface IReactor {
+  /**
+   * Signals that the reactor should shutdown.
+   */
+  kill(): ShutdownStatus;
   /**
    * Retrieves a list of document model modules.
    *
    * @param namespace - Optional namespace like "powerhouse" or "sky", defaults to ""
-   * @param paging - Optional pagination options
+   * @param paging - Optional options for paging data in large queries.
    * @param signal - Optional abort signal to cancel the request
    * @returns List of document model modules
    */
-  getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
+  getDocumentModels(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
   /**
-   * Retrieves a specific document model module by document type.
+   * Retrieves a specific PHDocument by id
    *
-   * @param documentType - The document type identifier
-   * @returns The document model module
+   * @param id - Required, this is the document id
+   * @param view - Optional filter containing branch and scopes information
+   * @param consistencyToken - Optional token for read-after-write consistency
+   * @param signal - Optional abort signal to cancel the request
+   * @returns The up-to-date PHDocument
    */
-  getDocumentModelModule(documentType: string): Promise<DocumentModelModule<any>>;
+  get<TDocument extends PHDocument>(id: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
   /**
-   * Retrieves a specific document by identifier (either id or slug).
+   * Retrieves a specific PHDocument by slug
    *
-   * @param identifier - Required, this is the document id or slug
+   * @param slug - Required, this is the document slug
    * @param view - Optional filter containing branch and scopes information
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
    * @returns The up-to-date PHDocument with scopes and list of child document ids
    */
-  get<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
+  getBySlug<TDocument extends PHDocument>(slug: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
   /**
-   * Retrieves operations for a document.
+   * Retrieves a specific PHDocument by identifier (either id or slug).
+   * Throws an error if the identifier matches both an id and a slug that refer to different documents.
    *
-   * @param documentIdentifier - Required, this is either a document "id" field or a "slug"
+   * @param identifier - Required, this is the document id or slug
    * @param view - Optional filter containing branch and scopes information
-   * @param filter - Optional filter for actionTypes, timestamps, and revision
-   * @param paging - Optional pagination options
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
-   * @returns Paginated list of operations
+   * @returns The up-to-date PHDocument with scopes and list of child document ids
+   * @throws {Error} If identifier matches both an ID and slug referring to different documents
    */
-  getOperations(documentIdentifier: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
+  getByIdOrSlug<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
   /**
-   * Retrieves children of a document.
+   * Retrieves outgoing relationships of a given type from a source document.
    *
-   * @param parentIdentifier - Required, this is either a document "id" field or a "slug"
-   * @param view - Optional filter containing branch and scopes information
-   * @param paging - Optional pagination options
+   * @param sourceId - The source document id
+   * @param relationshipType - The relationship type to filter by
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
-   * @returns The up-to-date PHDocument and paging cursor
+   * @returns The list of target document ids
    */
-  getChildren(parentIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  getOutgoingRelationships(sourceId: string, relationshipType: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
   /**
-   * Retrieves parents of a document.
+   * Retrieves incoming relationships of a given type to a target document.
    *
-   * @param childIdentifier - Required, this is either a document "id" field or a "slug"
-   * @param view - Optional filter containing branch and scopes information
-   * @param paging - Optional pagination options
+   * @param targetId - The target document id
+   * @param relationshipType - The relationship type to filter by
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
-   * @returns The up-to-date PHDocument and paging cursor
+   * @returns The list of source document ids
    */
-  getParents(childIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
+  getIncomingRelationships(targetId: string, relationshipType: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
   /**
-   * Filters documents by criteria and returns a list of them
+   * Retrieves the operations for a document
    *
-   * @param search - Search filter options (type, parentId, identifiers)
+   * @param documentId - The document id
    * @param view - Optional filter containing branch and scopes information
+   * @param filter - Optional filter for actionTypes, timestamps, and revision
    * @param paging - Optional pagination options
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
-   * @returns List of documents matching criteria and pagination cursor
-   */
-  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-  /**
-   * Creates a document and waits for completion
-   *
-   * @param document - Document with optional id, slug, parent, model type, and initial state
-   * @param parentIdentifier - Optional "id" or "slug" of parent document
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The created document
-   */
-  create<TDocument extends PHDocument = PHDocument>(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Creates an empty document and waits for completion
-   *
-   * @param documentModelType - Type of document to create
-   * @param options - Optional creation options (parentIdentifier, documentModelVersion)
-   * @param signal - Optional abort signal to cancel the request
-   */
-  createEmpty<TDocument extends PHDocument>(documentModelType: string, options?: CreateDocumentOptions, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Creates an empty document in a drive as a single batched operation.
-   * This is more efficient than createEmpty + addFile as it batches all
-   * actions into dependent jobs and waits for them to complete together.
-   *
-   * @param driveId - The drive document id or slug
-   * @param document - The document to create
-   * @param parentFolder - Optional folder id within the drive
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The created document
-   */
-  createDocumentInDrive<TDocument extends PHDocument>(driveId: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Applies a list of actions to a document and waits for completion
-   *
-   * @param documentIdentifier - Target document id or slug
-   * @param branch - Branch to apply actions to
-   * @param actions - List of actions to apply
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The updated document
-   */
-  execute<TDocument extends PHDocument>(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Submits a list of actions to a document
-   *
-   * @param documentIdentifier - Target document id or slug
-   * @param branch - Branch to apply actions to
-   * @param actions - List of actions to apply
-   * @param signal - Optional abort signal to cancel the request
-   * @returns The job
+   * @returns The list of operations
    */
-  executeAsync(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
+  getOperations(documentId: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<Record<string, PagedResults<Operation>>>;
   /**
-   * Renames a document and waits for completion
+   * Filters documents by criteria and returns a list of them
    *
-   * @param documentIdentifier - Target document id or slug
-   * @param name - The new name of the document
-   * @param branch - Optional branch to rename the document, defaults to "main"
+   * @param search - Search filter options (type, parentId, identifiers)
+   * @param view - Optional filter containing branch and scopes information
+   * @param paging - Optional pagination options
+   * @param consistencyToken - Optional token for read-after-write consistency
    * @param signal - Optional abort signal to cancel the request
-   * @returns The updated document.
+   * @returns List of documents matching criteria and pagination cursor
    */
-  rename(documentIdentifier: string, name: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
   /**
-   * Adds multiple documents as children to another and waits for completion
+   * Creates a document
    *
-   * @param parentIdentifier - Parent document id or slug
-   * @param documentIdentifiers - List of document identifiers to add as children
-   * @param branch - Optional branch to add children to, defaults to "main"
+   * @param document - Document with optional id, slug, parent, model type, and initial state
+   * @param signer - Optional signer to sign the actions
    * @param signal - Optional abort signal to cancel the request
-   * @returns The updated parent document
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns The job status
    */
-  addChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  create(document: PHDocument, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
   /**
-   * Removes multiple documents as children from another and waits for completion
+   * Deletes a document
    *
-   * @param parentIdentifier - Parent document identifiers
-   * @param documentIdentifiers - List of document ids to remove as children
-   * @param branch - Optional branch to remove children from, defaults to "main"
+   * @param id - Document id
+   * @param signer - Optional signer to sign the actions
    * @param signal - Optional abort signal to cancel the request
-   * @returns The updated parent document
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns The job id and status
    */
-  removeChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
+  deleteDocument(id: string, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
   /**
-   * Moves multiple documents from one parent to another and waits for completion
+   * Applies a list of actions to a document.
    *
-   * @param sourceParentIdentifier - Source parent document id or slug
-   * @param targetParentIdentifier - Target parent document id or slug
-   * @param documentIdentifiers - List of document identifiers to move
-   * @param branch - Optional branch to move children to, defaults to "main"
+   * @param docId - Document id
+   * @param branch - Branch to apply actions to
+   * @param actions - List of actions to apply
    * @param signal - Optional abort signal to cancel the request
-   * @returns The updated source and target documents
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns The job id and status
    */
-  moveChildren(sourceParentIdentifier: string, targetParentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<{
-    source: PHDocument;
-    target: PHDocument;
-  }>;
+  execute(docId: string, branch: string, actions: Action[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
   /**
-   * Deletes a document and waits for completion
+   * Loads existing operations generated elsewhere into this reactor.
    *
-   * @param identifier - Document identifier (id or slug)
-   * @param propagate - Optional mode for handling children, CASCADE deletes child documents
+   * @param docId - Document id
+   * @param branch - Branch to load operations to
+   * @param operations - List of operations to load
    * @param signal - Optional abort signal to cancel the request
-   * @returns a promise, resolving on deletion confirmation
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns The job id and status
    */
-  deleteDocument(identifier: string, propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  load(docId: string, branch: string, operations: Operation[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
   /**
-   * Deletes documents and waits for completion
+   * Applies multiple mutations across documents with dependency management.
    *
-   * @param identifiers - Document identifiers (ids or slugs)
-   * @param propagate - Optional mode for handling children, CASCADE deletes child documents
+   * @param request - Batch mutation request containing jobs with dependencies
    * @param signal - Optional abort signal to cancel the request
-   * @returns a promise, resolving on deletion confirmation
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns Map of job keys to job information
    */
-  deleteDocuments(identifiers: string[], propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
+  executeBatch(request: BatchExecutionRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchExecutionResult>;
   /**
    * Loads multiple batches of pre-existing operations across documents with dependency management.
-   * Waits for all jobs to complete.
    *
    * @param request - Batch load request containing jobs with dependencies
    * @param signal - Optional abort signal to cancel the request
-   * @returns Map of job keys to completed job information
+   * @param meta - Optional metadata that flows through the job lifecycle
+   * @returns Map of job keys to job information
    */
-  loadBatch(request: BatchLoadRequest, signal?: AbortSignal): Promise<BatchLoadResult>;
+  loadBatch(request: BatchLoadRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchLoadResult>;
   /**
-   * Retrieves the status of a job
+   * Adds a relationship between two documents.
    *
-   * @param jobId - The job id
+   * @param sourceId - Source document id
+   * @param targetId - Target document id
+   * @param relationshipType - Relationship type identifier
+   * @param branch - Branch to add the relationship to, defaults to "main"
+   * @param signer - Optional signer to sign the actions
    * @param signal - Optional abort signal to cancel the request
-   * @returns The job status
+   * @returns The job id and status
    */
-  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+  addRelationship(sourceId: string, targetId: string, relationshipType: string, branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
   /**
-   * Waits for a job to complete
+   * Removes a relationship between two documents.
    *
-   * @param jobId - The job id or job object
+   * @param sourceId - Source document id
+   * @param targetId - Target document id
+   * @param relationshipType - Relationship type identifier
+   * @param branch - Branch to remove the relationship from, defaults to "main"
+   * @param signer - Optional signer to sign the actions
    * @param signal - Optional abort signal to cancel the request
-   * @returns The result of the job
+   * @returns The job id and status
    */
-  waitForJob(jobId: string | JobInfo, signal?: AbortSignal): Promise<JobInfo>;
+  removeRelationship(sourceId: string, targetId: string, relationshipType: string, branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
   /**
-   * Subscribes to changes for documents matching specified filters
+   * Retrieves the status of a job
    *
-   * @param search - Search filter options (type, parentId, identifiers)
-   * @param callback - Function called when documents change with the change event details
-   * @param view - Optional filter containing branch and scopes information
-   * @returns A function that unsubscribes from the changes
+   * @param jobId - The job id
+   * @returns The job status
    */
-  subscribe(search: SearchFilter, callback: (event: DocumentChangeEvent) => void, view?: ViewFilter): () => void;
+  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
+}
+/**
+ * Feature flags for reactor configuration
+ */
+type ReactorFeatures = {
+  [key: string]: boolean;
+};
+/**
+ * Combined database type that includes all schemas
+ */
+type Database = Database$1 & DocumentViewDatabase & DocumentIndexerDatabase;
+/**
+ * Container for all sync manager dependencies created during the build process.
+ */
+interface SyncModule {
+  remoteStorage: ISyncRemoteStorage;
+  cursorStorage: ISyncCursorStorage;
+  deadLetterStorage: ISyncDeadLetterStorage;
+  channelFactory: IChannelFactory;
+  syncManager: ISyncManager;
+}
+/**
+ * Container for all reactor dependencies created during the build process.
+ * Provides direct access to internal components for advanced use cases,
+ * testing, or integration scenarios.
+ */
+interface ReactorModule {
+  eventBus: IEventBus;
+  documentModelRegistry: IDocumentModelRegistry;
+  queue: IQueue;
+  jobTracker: IJobTracker;
+  executorManager: IJobExecutorManager;
+  database: Kysely<Database>;
+  operationStore: IOperationStore;
+  keyframeStore: IKeyframeStore;
+  writeCache: IWriteCache;
+  operationIndex: IOperationIndex;
+  documentView: IDocumentView;
+  documentViewConsistencyTracker: IConsistencyTracker;
+  documentIndexer: IDocumentIndexer;
+  documentIndexerConsistencyTracker: IConsistencyTracker;
+  readModelCoordinator: IReadModelCoordinator;
+  subscriptionManager: IReactorSubscriptionManager;
+  processorManager: IProcessorManager$1;
+  processorManagerConsistencyTracker: IConsistencyTracker;
+  syncModule: SyncModule | undefined;
+  reactor: IReactor;
+}
+/**
+ * Container for all reactor client dependencies created during the build process.
+ * Provides direct access to internal components for advanced use cases,
+ * testing, or integration scenarios.
+ */
+interface ReactorClientModule {
+  client: ReactorClient;
+  reactor: IReactor;
+  eventBus: IEventBus;
+  documentIndexer: IDocumentIndexer;
+  documentView: IDocumentView;
+  signer: ISigner;
+  subscriptionManager: IReactorSubscriptionManager;
+  jobAwaiter: IJobAwaiter;
+  reactorModule: ReactorModule | undefined;
 }
 //#endregion
-//#region src/client/reactor-client.d.ts
+//#region src/client/drive-client.d.ts
 /**
- * ReactorClient implementation that wraps lower-level APIs to provide
- * a simpler interface for document operations.
+ * Implementation of {@link IDriveClient}.
  *
- * Features:
- * - Wraps Jobs with Promises for easier async handling
- * - Manages signing of submitted Action objects
- * - Provides quality-of-life functions for common tasks
- * - Wraps subscription interface with ViewFilters
+ * 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.
  */
-declare class ReactorClient implements IReactorClient {
-  private logger;
-  private reactor;
-  private signer;
-  private subscriptionManager;
-  private jobAwaiter;
-  private documentIndexer;
-  private documentView;
-  constructor(logger: ILogger, reactor: IReactor, signer: ISigner, subscriptionManager: IReactorSubscriptionManager, jobAwaiter: IJobAwaiter, documentIndexer: IDocumentIndexer, documentView: IDocumentView);
-  /**
-   * Retrieves a list of document model modules.
-   */
-  getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
-  /**
-   * Retrieves a specific document model module by document type.
-   *
-   * @param documentType - The document type identifier
-   * @returns The document model module
-   */
-  getDocumentModelModule(documentType: string): Promise<DocumentModelModule<any>>;
-  /**
-   * Retrieves a specific PHDocument
-   */
-  get<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Retrieves operations for a document
-   */
-  getOperations(documentIdentifier: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
-  private getOperationsWithCompositeCursor;
-  /**
-   * Retrieves children of a document
-   */
-  getChildren(parentIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-  /**
-   * Retrieves parents of a document
-   */
-  getParents(childIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-  /**
-   * Filters documents by criteria and returns a list of them
-   */
-  find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-  /**
-   * Creates a document and waits for completion
-   */
-  create<TDocument extends PHDocument = PHDocument>(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Creates an empty document and waits for completion
-   */
-  createEmpty<TDocument extends PHDocument>(documentModelType: string, options?: CreateDocumentOptions, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Creates an empty document in a drive as a single batched operation.
-   */
-  createDocumentInDrive<TDocument extends PHDocument>(driveId: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Applies a list of actions to a document and waits for completion
-   */
-  execute<TDocument extends PHDocument>(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<TDocument>;
-  /**
-   * Submits a list of actions to a document
-   */
-  executeAsync(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
-  /**
-   * Renames a document and waits for completion
-   */
-  rename(documentIdentifier: string, name: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-  /**
-   * Adds multiple documents as children to another and waits for completion
-   */
-  addChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-  /**
-   * Removes multiple documents as children from another and waits for completion
-   */
-  removeChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-  /**
-   * Moves multiple documents from one parent to another and waits for completion
-   */
-  moveChildren(sourceParentIdentifier: string, targetParentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<{
-    source: PHDocument;
-    target: PHDocument;
-  }>;
-  loadBatch(request: BatchLoadRequest, signal?: AbortSignal): Promise<BatchLoadResult>;
-  /**
-   * Deletes a document and waits for completion
-   */
-  deleteDocument(identifier: string, propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
-  /**
-   * Deletes documents and waits for completion
-   */
-  deleteDocuments(identifiers: string[], propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
-  /**
-   * Retrieves the status of a job
-   */
-  getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
-  /**
-   * Waits for a job to complete
-   */
-  waitForJob(jobId: string | JobInfo, signal?: AbortSignal): Promise<JobInfo>;
-  /**
-   * Subscribes to changes for documents matching specified filters
-   */
-  subscribe(search: SearchFilter, callback: (event: DocumentChangeEvent) => void, view?: ViewFilter): () => void;
-  private removeFromAllParents;
-  private removeFromParent;
+declare class DriveClient implements IDriveClient {
+  private readonly client;
+  private readonly logger;
+  private readonly reactor;
+  private readonly signer;
+  constructor(client: IReactorClient, logger: ILogger, reactor: IReactor, signer: ISigner);
+  create(input: DriveInput, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  addFile<TDocument extends PHDocument = PHDocument>(driveIdentifier: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
+  addFolder(driveIdentifier: string, name: string, parentFolder?: string, signal?: AbortSignal): Promise<FolderNode>;
+  removeNode(driveIdentifier: string, nodeId: string, signal?: AbortSignal): Promise<void>;
+  renameNode(driveIdentifier: string, nodeId: string, name: string, signal?: AbortSignal): Promise<Node>;
+  moveNode(driveIdentifier: string, srcNodeId: string, targetParentFolderId: string | undefined, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  copyNode(driveIdentifier: string, srcNodeId: string, targetParentFolderId: string | undefined, signal?: AbortSignal): Promise<DocumentDriveDocument>;
+  getNode(driveIdentifier: string, nodeId: string, signal?: AbortSignal): Promise<Node>;
+  listNodes(driveIdentifier: string, parentFolder?: string | null, signal?: AbortSignal): Promise<Node[]>;
+  private removeFileNode;
 }
 //#endregion
 //#region src/cache/write-cache-types.d.ts
@@ -3156,8 +3258,8 @@ declare class Reactor implements IReactor {
   get<TDocument extends PHDocument>(id: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
   getBySlug<TDocument extends PHDocument>(slug: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
   getByIdOrSlug<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-  getChildren(documentId: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-  getParents(childId: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
+  getOutgoingRelationships(sourceId: string, relationshipType: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
+  getIncomingRelationships(targetId: string, relationshipType: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
   getOperations(documentId: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<Record<string, PagedResults<Operation>>>;
   find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
   create(document: PHDocument, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
@@ -3166,8 +3268,8 @@ declare class Reactor implements IReactor {
   load(docId: string, branch: string, operations: Operation[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
   executeBatch(request: BatchExecutionRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchExecutionResult>;
   loadBatch(request: BatchLoadRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchLoadResult>;
-  addChildren(parentId: string, documentIds: string[], branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
-  removeChildren(parentId: string, documentIds: string[], branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+  addRelationship(sourceId: string, targetId: string, relationshipType: string, branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+  removeRelationship(sourceId: string, targetId: string, relationshipType: string, branch?: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
   getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
   private findByIds;
   private findBySlugs;
@@ -4388,5 +4490,5 @@ declare class ProcessorManager extends BaseReadModel implements IProcessorManage
   private deleteProcessorCursors;
 }
 //#endregion
-export { type AtomicTxn, type AttachmentHash, type AttachmentRef, BaseReadModel, type BatchLoadRequest, type BatchLoadResult, type CachedSnapshot, type ChannelConfig, ChannelError, ChannelErrorSource, type ChannelHealth, type ChannelMeta, ChannelScheme, type ConnectionState, type ConnectionStateChangeCallback, type ConnectionStateChangedEvent, type ConnectionStateSnapshot, type ConsistencyCoordinate, type ConsistencyKey, type ConsistencyToken, ConsistencyTracker, type Database, type DeadLetterAddedEvent, DefaultSubscriptionErrorHandler, type DocumentChangeEvent, DocumentChangeType, type DocumentGraphEdge, type DocumentIndexerDatabase, DocumentIntegrityService, DocumentModelRegistry, type DocumentRelationship, type DocumentRevisions, type DocumentStreamKey, type DocumentViewDatabase, DuplicateManifestError, DuplicateModuleError, DuplicateOperationError, EventBus, EventBusAggregateError, type ExecutorStartedEvent, type ExecutorStoppedEvent, type GqlChannelConfig, GqlRequestChannel, GqlRequestChannelFactory, GqlResponseChannel, GqlResponseChannelFactory, type IChannel, type IChannelFactory, type IConsistencyTracker, type IDocumentGraph, type IDocumentIndexer, type IDocumentIntegrityService, type IDocumentModelLoader, type IDocumentModelRegistry, type IDocumentView, type IEventBus, type IJobAwaiter, type IJobExecutor, type IJobExecutorManager, type IJobTracker, type IKeyframeStore, type IOperationIndex, type IOperationStore, type IPollTimer, type IProcessor, type IProcessorHostModule, type IProcessorManager, type IQueue, type IReactor, type IReactorClient, type IReactorSubscriptionManager, type IReadModel, type IReadModelCoordinator, type IRelationalDb, type ISubscriptionErrorHandler, type ISyncCursorStorage, type ISyncManager, type ISyncRemoteStorage, type ISyncStatusTracker, type IWriteCache, SimpleJobExecutor as InMemoryJobExecutor, SimpleJobExecutor, InMemoryJobTracker, InMemoryQueue, type InsertableDocumentSnapshot, IntervalPollTimer, InvalidModuleError, type Job, type JobAvailableEvent, JobAwaiter, type JobCompletedEvent, type JobExecutorConfig, JobExecutorEventTypes, type JobExecutorFactory, type JobFailedEvent, type JobInfo, type JobPendingEvent, type JobReadReadyEvent, type JobResult, type JobRunningEvent, type JobStartedEvent, JobStatus, type JobWriteReadyEvent, type JwtHandler, type KeyframeSnapshot, type KeyframeValidationIssue, KyselyDocumentIndexer, KyselyDocumentView, KyselyKeyframeStore, KyselyOperationStore, KyselySyncCursorStorage, KyselySyncRemoteStorage, KyselyWriteCache, type LoadJobPlan, Mailbox, ModuleNotFoundError, NullDocumentModelResolver, type OperationBatch, type OperationContext, type OperationFilter, type OperationIndexEntry, type OperationTable, type OperationWithContext, OptimisticLockError, type PagedResults, type PagingOptions, type ParsedDriveUrl, PollingChannelError, type ProcessorApp, type ProcessorFactory, type ProcessorFactoryBuilder, type ProcessorFilter, ProcessorManager, type ProcessorRecord, type ProcessorStatus, PropagationMode, QueueEventTypes, REACTOR_SCHEMA, Reactor, ReactorBuilder, ReactorClient, ReactorClientBuilder, type ReactorClientModule, ReactorEventTypes, type ReactorFeatures, type JobFailedEvent$1 as ReactorJobFailedEvent, type ReactorModule, ReactorSubscriptionManager, ReadModelCoordinator, type RebuildResult, RelationalDbProcessor, RelationshipChangeType, type Remote, type RemoteCursor, type RemoteFilter, type RemoteOptions, type RemoteRecord, type RemoteStatus, RevisionMismatchError, type SearchFilter, type ShutdownStatus, type SignatureVerificationHandler, type SignerConfig, SimpleJobExecutorManager, type SnapshotValidationIssue, type Database$1 as StorageDatabase, type SubscriptionErrorContext, SyncBuilder, type SyncEnvelope, type SyncEnvelopeType, SyncEventTypes, type SyncFailedEvent, type SyncModule, SyncOperation, SyncOperationAggregateError, type SyncOperationErrorType, SyncOperationStatus, type SyncPendingEvent, SyncStatus, type SyncStatusChangeCallback, SyncStatusTracker, type SyncSucceededEvent, type TrackedProcessor, type Unsubscribe, type ValidationResult, type ViewFilter, type WriteCacheConfig, addRelationshipAction, batchOperationsByDocument, consolidateSyncOperations, createDocumentAction, createMutableShutdownStatus, createRelationalDb, deleteDocumentAction, documentActions, driveCollectionId, driveIdFromUrl, envelopesToSyncOperations, getMigrationStatus, makeConsistencyKey, parseDriveUrl, removeRelationshipAction, runMigrations, sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, upgradeDocumentAction };
+export { type AtomicTxn, type AttachmentHash, type AttachmentRef, BaseReadModel, type BatchLoadRequest, type BatchLoadResult, type CachedSnapshot, type ChannelConfig, ChannelError, ChannelErrorSource, type ChannelHealth, type ChannelMeta, ChannelScheme, type ConnectionState, type ConnectionStateChangeCallback, type ConnectionStateChangedEvent, type ConnectionStateSnapshot, type ConsistencyCoordinate, type ConsistencyKey, type ConsistencyToken, ConsistencyTracker, type Database, type DeadLetterAddedEvent, DefaultSubscriptionErrorHandler, type DocumentChangeEvent, DocumentChangeType, type DocumentGraphEdge, type DocumentIndexerDatabase, DocumentIntegrityService, DocumentModelRegistry, type DocumentRelationship, type DocumentRevisions, type DocumentStreamKey, type DocumentViewDatabase, DriveClient, DuplicateManifestError, DuplicateModuleError, DuplicateOperationError, EventBus, EventBusAggregateError, type ExecutorStartedEvent, type ExecutorStoppedEvent, type GqlChannelConfig, GqlRequestChannel, GqlRequestChannelFactory, GqlResponseChannel, GqlResponseChannelFactory, type IChannel, type IChannelFactory, type IConsistencyTracker, type IDocumentGraph, type IDocumentIndexer, type IDocumentIntegrityService, type IDocumentModelLoader, type IDocumentModelRegistry, type IDocumentView, type IDriveClient, type IEventBus, type IJobAwaiter, type IJobExecutor, type IJobExecutorManager, type IJobTracker, type IKeyframeStore, type IOperationIndex, type IOperationStore, type IPollTimer, type IProcessor, type IProcessorHostModule, type IProcessorManager, type IQueue, type IReactor, type IReactorClient, type IReactorSubscriptionManager, type IReadModel, type IReadModelCoordinator, type IRelationalDb, type ISubscriptionErrorHandler, type ISyncCursorStorage, type ISyncManager, type ISyncRemoteStorage, type ISyncStatusTracker, type IWriteCache, SimpleJobExecutor as InMemoryJobExecutor, SimpleJobExecutor, InMemoryJobTracker, InMemoryQueue, type InsertableDocumentSnapshot, IntervalPollTimer, InvalidModuleError, type Job, type JobAvailableEvent, JobAwaiter, type JobCompletedEvent, type JobExecutorConfig, JobExecutorEventTypes, type JobExecutorFactory, type JobFailedEvent, type JobInfo, type JobPendingEvent, type JobReadReadyEvent, type JobResult, type JobRunningEvent, type JobStartedEvent, JobStatus, type JobWriteReadyEvent, type JwtHandler, type KeyframeSnapshot, type KeyframeValidationIssue, KyselyDocumentIndexer, KyselyDocumentView, KyselyKeyframeStore, KyselyOperationStore, KyselySyncCursorStorage, KyselySyncRemoteStorage, KyselyWriteCache, type LoadJobPlan, Mailbox, ModuleNotFoundError, NullDocumentModelResolver, type OperationBatch, type OperationContext, type OperationFilter, type OperationIndexEntry, type OperationTable, type OperationWithContext, OptimisticLockError, type PagedResults, type PagingOptions, type ParsedDriveUrl, PollingChannelError, type ProcessorApp, type ProcessorFactory, type ProcessorFactoryBuilder, type ProcessorFilter, ProcessorManager, type ProcessorRecord, type ProcessorStatus, PropagationMode, QueueEventTypes, REACTOR_SCHEMA, Reactor, ReactorBuilder, ReactorClient, ReactorClientBuilder, type ReactorClientModule, ReactorEventTypes, type ReactorFeatures, type JobFailedEvent$1 as ReactorJobFailedEvent, type ReactorModule, ReactorSubscriptionManager, ReadModelCoordinator, type RebuildResult, RelationalDbProcessor, RelationshipChangeType, type Remote, type RemoteCursor, type RemoteFilter, type RemoteOptions, type RemoteRecord, type RemoteStatus, RevisionMismatchError, type SearchFilter, type ShutdownStatus, type SignatureVerificationHandler, type SignerConfig, SimpleJobExecutorManager, type SnapshotValidationIssue, type Database$1 as StorageDatabase, type SubscriptionErrorContext, SyncBuilder, type SyncEnvelope, type SyncEnvelopeType, SyncEventTypes, type SyncFailedEvent, type SyncModule, SyncOperation, SyncOperationAggregateError, type SyncOperationErrorType, SyncOperationStatus, type SyncPendingEvent, SyncStatus, type SyncStatusChangeCallback, SyncStatusTracker, type SyncSucceededEvent, type TrackedProcessor, type Unsubscribe, type ValidationResult, type ViewFilter, type WriteCacheConfig, addRelationshipAction, batchOperationsByDocument, consolidateSyncOperations, createDocumentAction, createMutableShutdownStatus, createRelationalDb, deleteDocumentAction, documentActions, driveCollectionId, driveIdFromUrl, envelopesToSyncOperations, getMigrationStatus, makeConsistencyKey, parseDriveUrl, removeRelationshipAction, runMigrations, sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, upgradeDocumentAction };
 //# sourceMappingURL=index.d.ts.map