@powerhousedao/reactor 5.2.0-staging.9 → 6.0.0-dev.1

package/dist/src/core/reactor-client-builder.d.ts

@@ -1,7 +1,9 @@
 import type { IEventBus } from "#events/interfaces.js";
+import type { ILogger } from "#logging/types.js";
+import type { ISigner } from "document-model";
 import { ReactorClient } from "../client/reactor-client.js";
 import { type IJobAwaiter } from "../shared/awaiter.js";
-import type { ISigner, SignerConfig } from "../signer/types.js";
+import type { SignerConfig } from "../signer/types.js";
 import type { IDocumentIndexer } from "../storage/interfaces.js";
 import type { IReactorSubscriptionManager } from "../subs/types.js";
 import type { ReactorBuilder } from "./reactor-builder.js";
@@ -10,6 +12,7 @@ import type { IReactor, ReactorClientModule } from "./types.js";
  * Builder class for constructing ReactorClient instances with proper configuration
  */
 export declare class ReactorClientBuilder {
+    private logger?;
     private reactorBuilder?;
     private reactor?;
     private eventBus?;
@@ -18,6 +21,12 @@ export declare class ReactorClientBuilder {
     private signatureVerifier?;
     private subscriptionManager?;
     private jobAwaiter?;
+    /**
+     * Sets the logger for the ReactorClient.
+     * @param logger - The logger to use.
+     * @returns The ReactorClientBuilder instance.
+     */
+    withLogger(logger: ILogger): this;
     /**
      * Either this or withReactor must be set.
      */

package/dist/src/core/reactor-client-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactor-client-builder.d.ts","sourceRoot":"","sources":["../../../src/core/reactor-client-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EACV,OAAO,EAEP,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAE/E;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAA+B;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAA8B;IAC1D,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC;;OAEG;IACI,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAS/D;;OAEG;IACI,WAAW,CAChB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,SAAS,EACnB,eAAe,EAAE,gBAAgB,GAChC,IAAI;IAWP;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI;IAUhD,uBAAuB,CAC5B,mBAAmB,EAAE,2BAA2B,GAC/C,IAAI;IAKA,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAKvC,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAK/B,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAwDzD"}
+{"version":3,"file":"reactor-client-builder.d.ts","sourceRoot":"","sources":["../../../src/core/reactor-client-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAEV,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAE/E;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAA+B;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAA8B;IAC1D,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKxC;;OAEG;IACI,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAS/D;;OAEG;IACI,WAAW,CAChB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,SAAS,EACnB,eAAe,EAAE,gBAAgB,GAChC,IAAI;IAWP;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI;IAUhD,uBAAuB,CAC5B,mBAAmB,EAAE,2BAA2B,GAC/C,IAAI;IAKA,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAKvC,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAK/B,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA8DzD"}

package/dist/src/core/reactor-client-builder.js

@@ -1,3 +1,4 @@
+import { ConsoleLogger } from "#logging/console.js";
 import { ReactorClient } from "../client/reactor-client.js";
 import { JobAwaiter } from "../shared/awaiter.js";
 import { PassthroughSigner } from "../signer/passthrough-signer.js";
@@ -7,6 +8,7 @@ import { ReactorSubscriptionManager } from "../subs/react-subscription-manager.j
  * Builder class for constructing ReactorClient instances with proper configuration
  */
 export class ReactorClientBuilder {
+    logger;
     reactorBuilder;
     reactor;
     eventBus;
@@ -15,6 +17,15 @@ export class ReactorClientBuilder {
     signatureVerifier;
     subscriptionManager;
     jobAwaiter;
+    /**
+     * Sets the logger for the ReactorClient.
+     * @param logger - The logger to use.
+     * @returns The ReactorClientBuilder instance.
+     */
+    withLogger(logger) {
+        this.logger = logger;
+        return this;
+    }
     /**
      * Either this or withReactor must be set.
      */
@@ -65,6 +76,9 @@ export class ReactorClientBuilder {
         return module.client;
     }
     async buildModule() {
+        if (!this.logger) {
+            this.logger = new ConsoleLogger(["reactor-client"]);
+        }
         let reactor;
         let eventBus;
         let documentIndexer;
@@ -89,10 +103,11 @@ export class ReactorClientBuilder {
         }
         const signer = this.signer ?? new PassthroughSigner();
         const subscriptionManager = this.subscriptionManager ??
+            reactorModule?.subscriptionManager ??
             new ReactorSubscriptionManager(new DefaultSubscriptionErrorHandler());
         const jobAwaiter = this.jobAwaiter ??
             new JobAwaiter(eventBus, (jobId, signal) => reactor.getJobStatus(jobId, signal));
-        const client = new ReactorClient(reactor, signer, subscriptionManager, jobAwaiter, documentIndexer);
+        const client = new ReactorClient(this.logger, reactor, signer, subscriptionManager, jobAwaiter, documentIndexer);
         return {
             client,
             reactor,

package/dist/src/core/reactor-client-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactor-client-builder.js","sourceRoot":"","sources":["../../../src/core/reactor-client-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reactor-client-builder.js","sourceRoot":"","sources":["../../../src/core/reactor-client-builder.ts"],"names":[],"mappings":"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"}

package/dist/src/core/reactor.d.ts

@@ -1,10 +1,10 @@
+import type { ILogger } from "#logging/types.js";
 import type { BaseDocumentDriveServer } from "document-drive";
-import type { Action, DocumentModelModule, Operation, PHDocument } from "document-model";
+import type { Action, DocumentModelModule, ISigner, Operation, PHDocument } from "document-model";
 import type { IJobTracker } from "../job-tracker/interfaces.js";
 import type { IQueue } from "../queue/interfaces.js";
 import type { IReadModelCoordinator } from "../read-models/interfaces.js";
 import type { ConsistencyToken, JobInfo, PagedResults, PagingOptions, SearchFilter, ShutdownStatus, ViewFilter } from "../shared/types.js";
-import type { ISigner } from "../signer/types.js";
 import type { IConsistencyAwareStorage, IDocumentIndexer, IDocumentView, IOperationStore } from "../storage/interfaces.js";
 import type { BatchExecutionRequest, BatchExecutionResult, IReactor, ReactorFeatures } from "./types.js";
 /**
@@ -12,6 +12,7 @@ import type { BatchExecutionRequest, BatchExecutionResult, IReactor, ReactorFeat
  * for the new Reactor architecture.
  */
 export declare class Reactor implements IReactor {
+    private logger;
     private driveServer;
     private documentStorage;
     private shutdownStatus;
@@ -23,7 +24,7 @@ export declare class Reactor implements IReactor {
     private documentView;
     private _documentIndexer;
     private operationStore;
-    constructor(driveServer: BaseDocumentDriveServer, documentStorage: IConsistencyAwareStorage, queue: IQueue, jobTracker: IJobTracker, readModelCoordinator: IReadModelCoordinator, features: ReactorFeatures, documentView: IDocumentView, documentIndexer: IDocumentIndexer, operationStore: IOperationStore);
+    constructor(logger: ILogger, driveServer: BaseDocumentDriveServer, documentStorage: IConsistencyAwareStorage, queue: IQueue, jobTracker: IJobTracker, readModelCoordinator: IReadModelCoordinator, features: ReactorFeatures, documentView: IDocumentView, documentIndexer: IDocumentIndexer, operationStore: IOperationStore);
     /**
      * Signals that the reactor should shutdown.
      */
@@ -64,25 +65,25 @@ export declare class Reactor implements IReactor {
     /**
      * Creates a document
      */
-    create(document: PHDocument, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+    create(document: PHDocument, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
     /**
      * Deletes a document
      */
-    deleteDocument(id: string, signer?: ISigner, signal?: AbortSignal): Promise<JobInfo>;
+    deleteDocument(id: string, signer?: ISigner, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
     /**
      * Applies a list of actions to a document
      */
-    execute(docId: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
+    execute(docId: string, branch: string, actions: Action[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
     /**
      * Imports pre-existing operations that were produced by another reactor.
      * This function may cause a reshuffle, which will generate additional
      * operations.
      */
-    load(docId: string, branch: string, operations: Operation[], signal?: AbortSignal): Promise<JobInfo>;
+    load(docId: string, branch: string, operations: Operation[], signal?: AbortSignal, meta?: Record<string, unknown>): Promise<JobInfo>;
     /**
      * Applies multiple mutations across documents with dependency management
      */
-    executeBatch(request: BatchExecutionRequest, signal?: AbortSignal): Promise<BatchExecutionResult>;
+    executeBatch(request: BatchExecutionRequest, signal?: AbortSignal, meta?: Record<string, unknown>): Promise<BatchExecutionResult>;
     /**
      * Adds multiple documents as children to another
      */

package/dist/src/core/reactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../../../src/core/reactor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../../../src/core/reactor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EACV,MAAM,EAEN,mBAAmB,EACnB,OAAO,EACP,SAAS,EAET,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,QAAQ,EACR,eAAe,EAChB,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IACtC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,oBAAoB,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAkB;gBAGtC,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,uBAAuB,EACpC,eAAe,EAAE,wBAAwB,EACzC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,WAAW,EACvB,oBAAoB,EAAE,qBAAqB,EAC3C,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,aAAa,EAC3B,eAAe,EAAE,gBAAgB,EACjC,cAAc,EAAE,eAAe;IA2BjC;;OAEG;IACH,IAAI,IAAI,cAAc;IAetB;;OAEG;IACH,iBAAiB,CACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IA4C7C;;OAEG;IACG,GAAG,CAAC,SAAS,SAAS,UAAU,EACpC,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,UAAU,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,QAAQ,EAAE,SAAS,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAkEF;;OAEG;IACG,SAAS,CAAC,SAAS,SAAS,UAAU,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,QAAQ,EAAE,SAAS,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IA6CF;;OAEG;IACG,aAAa,CAAC,SAAS,SAAS,UAAU,EAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,UAAU,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,QAAQ,EAAE,SAAS,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAiEF;;OAEG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,aAAa,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IAoHnD;;OAEG;IACG,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,aAAa,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IA8DpC;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,UAAU,EACpB,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;IAoFnB;;OAEG;IACG,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;IAgDnB;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;IAyDnB;;;;OAIG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,EAAE,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;IAiEnB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAoFhC;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,GAAE,MAAe,EACvB,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IAwBnB;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,GAAE,MAAe,EACvB,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IAwBnB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BnE;;OAEG;YACW,SAAS;IAmIvB;;OAEG;YACW,WAAW;IAoKzB;;OAEG;YACW,cAAc;IAqF5B;;OAEG;YACW,UAAU;CAsHzB"}

package/dist/src/core/reactor.js

@@ -1,3 +1,4 @@
+import { addRelationshipAction, createDocumentAction, deleteDocumentAction, removeRelationshipAction, upgradeDocumentAction, } from "#actions/index.js";
 import { AbortError } from "document-drive";
 import { v4 as uuidv4 } from "uuid";
 import { createMutableShutdownStatus } from "../shared/factories.js";
@@ -9,6 +10,7 @@ import { filterByType, getSharedScope, signAction, signActions, toErrorInfo, top
  * for the new Reactor architecture.
  */
 export class Reactor {
+    logger;
     driveServer;
     documentStorage;
     shutdownStatus;
@@ -20,8 +22,9 @@ export class Reactor {
     documentView;
     _documentIndexer;
     operationStore;
-    constructor(driveServer, documentStorage, queue, jobTracker, readModelCoordinator, features, documentView, documentIndexer, operationStore) {
+    constructor(logger, driveServer, documentStorage, queue, jobTracker, readModelCoordinator, features, documentView, documentIndexer, operationStore) {
         // Store required dependencies
+        this.logger = logger;
         this.driveServer = driveServer;
         this.documentStorage = documentStorage;
         this.queue = queue;
@@ -35,12 +38,14 @@ export class Reactor {
         const [status, setter] = createMutableShutdownStatus(false);
         this.shutdownStatus = status;
         this.setShutdown = setter;
+        this.logger.verbose("Reactor({ legacyStorage: @legacy })", features.legacyStorageEnabled);
         this.readModelCoordinator.start();
     }
     /**
      * Signals that the reactor should shutdown.
      */
     kill() {
+        this.logger.verbose("kill()");
         // Mark the reactor as shutdown
         this.setShutdown(true);
         // Stop the read model coordinator
@@ -53,6 +58,7 @@ export class Reactor {
      * Retrieves a list of document model specifications
      */
     getDocumentModels(namespace, paging, signal) {
+        this.logger.verbose("getDocumentModels(@namespace, @paging)", namespace, paging);
         // Get document model modules from the drive server + filter
         const modules = this.driveServer.getDocumentModelModules();
         const filteredModels = modules.filter((module) => !namespace || module.documentModel.global.id.startsWith(namespace));
@@ -80,6 +86,7 @@ export class Reactor {
      * Retrieves a specific PHDocument by id
      */
     async get(id, view, consistencyToken, signal) {
+        this.logger.verbose("get(@id, @view)", id, view);
         if (this.features.legacyStorageEnabled) {
             const document = await this.documentStorage.get(id, consistencyToken, signal);
             if (signal?.aborted) {
@@ -119,6 +126,7 @@ export class Reactor {
      * Retrieves a specific PHDocument by slug
      */
     async getBySlug(slug, view, consistencyToken, signal) {
+        this.logger.verbose("getBySlug(@slug, @view)", slug, view);
         if (this.features.legacyStorageEnabled) {
             let ids;
             try {
@@ -147,6 +155,7 @@ export class Reactor {
      * Retrieves a specific PHDocument by identifier (either id or slug)
      */
     async getByIdOrSlug(identifier, view, consistencyToken, signal) {
+        this.logger.verbose("getByIdOrSlug(@identifier, @view)", identifier, view);
         if (this.features.legacyStorageEnabled) {
             try {
                 return await this.get(identifier, view, consistencyToken, signal);
@@ -184,6 +193,7 @@ export class Reactor {
      * Retrieves the operations for a document
      */
     async getOperations(documentId, view, paging, consistencyToken, signal) {
+        this.logger.verbose("getOperations(@documentId, @view, @paging)", documentId, view, paging);
         if (this.features.legacyStorageEnabled) {
             // Use storage directly to get the document
             const document = await this.documentStorage.get(documentId, consistencyToken, signal);
@@ -257,6 +267,7 @@ export class Reactor {
      * Filters documents by criteria and returns a list of them
      */
     async find(search, view, paging, consistencyToken, signal) {
+        this.logger.verbose("find(@search, @view, @paging)", search, view, paging);
         let results;
         if (search.ids) {
             if (search.slugs && search.slugs.length > 0) {
@@ -293,52 +304,39 @@ export class Reactor {
     /**
      * Creates a document
      */
-    async create(document, signer, signal) {
+    async create(document, signer, signal, meta) {
+        this.logger.verbose("create(@id, @type, @slug)", document.header.id, document.header.documentType, document.header.slug);
         const createdAtUtcIso = new Date().toISOString();
         if (signal?.aborted) {
             throw new AbortError();
         }
-        // Create a CREATE_DOCUMENT action with proper CreateDocumentActionInput
-        const input = {
+        const createInput = {
             model: document.header.documentType,
-            version: "0.0.0",
+            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,
+            },
         };
-        // Add signing info
-        input.signing = {
-            signature: document.header.id,
-            publicKey: document.header.sig.publicKey,
-            nonce: document.header.sig.nonce,
-            createdAtUtcIso: document.header.createdAtUtcIso,
-            documentType: document.header.documentType,
-        };
-        // Add optional mutable header fields (always include even if empty/undefined)
-        input.slug = document.header.slug;
-        input.name = document.header.name;
-        input.branch = document.header.branch;
-        input.meta = document.header.meta;
-        const createAction = {
-            id: `${document.header.id}-create`,
-            type: "CREATE_DOCUMENT",
-            scope: "document",
-            timestampUtcMs: new Date().toISOString(),
-            input,
-        };
-        // Create an UPGRADE_DOCUMENT action to set the initial state
-        const upgradeInput = {
-            model: document.header.documentType,
-            fromVersion: "0.0.0",
-            toVersion: "0.0.0", // Same version since we're just setting initial state
+        const createAction = createDocumentAction(createInput);
+        const upgradeAction = upgradeDocumentAction({
             documentId: document.header.id,
+            model: document.header.documentType,
+            fromVersion: 0,
+            toVersion: 1,
             initialState: document.state,
-        };
-        const upgradeAction = {
-            id: `${document.header.id}-upgrade`,
-            type: "UPGRADE_DOCUMENT",
-            scope: "document",
-            timestampUtcMs: new Date().toISOString(),
-            input: upgradeInput,
-        };
+        });
         // Sign actions if signer is provided
         let actions = [createAction, upgradeAction];
         if (signer) {
@@ -357,6 +355,7 @@ export class Reactor {
             queueHint: [],
             maxRetries: 3,
             errorHistory: [],
+            meta,
         };
         // Create job info and register with tracker
         const jobInfo = {
@@ -368,6 +367,7 @@ export class Reactor {
                 createdAtUtcIso,
                 coordinates: [],
             },
+            meta,
         };
         this.jobTracker.registerJob(jobInfo);
         // Enqueue the job
@@ -377,21 +377,13 @@ export class Reactor {
     /**
      * Deletes a document
      */
-    async deleteDocument(id, signer, signal) {
+    async deleteDocument(id, signer, signal, meta) {
+        this.logger.verbose("deleteDocument(@id)", id);
         const createdAtUtcIso = new Date().toISOString();
         if (signal?.aborted) {
             throw new AbortError();
         }
-        const deleteInput = {
-            documentId: id,
-        };
-        let action = {
-            id: `${id}-delete`,
-            type: "DELETE_DOCUMENT",
-            scope: "document",
-            timestampUtcMs: new Date().toISOString(),
-            input: deleteInput,
-        };
+        let action = deleteDocumentAction(id);
         // Sign action if signer is provided
         if (signer) {
             action = await signAction(action, signer, signal);
@@ -408,6 +400,7 @@ export class Reactor {
             queueHint: [],
             maxRetries: 3,
             errorHistory: [],
+            meta,
         };
         const jobInfo = {
             id: job.id,
@@ -418,6 +411,7 @@ export class Reactor {
                 createdAtUtcIso,
                 coordinates: [],
             },
+            meta,
         };
         this.jobTracker.registerJob(jobInfo);
         await this.queue.enqueue(job);
@@ -426,7 +420,8 @@ export class Reactor {
     /**
      * Applies a list of actions to a document
      */
-    async execute(docId, branch, actions, signal) {
+    async execute(docId, branch, actions, signal, meta) {
+        this.logger.verbose("execute(@docId, @branch, @actions)", docId, branch, actions);
         if (signal?.aborted) {
             throw new AbortError();
         }
@@ -446,6 +441,7 @@ export class Reactor {
             queueHint: [],
             maxRetries: 3,
             errorHistory: [],
+            meta,
         };
         // Create job info and register with tracker
         const jobInfo = {
@@ -457,6 +453,7 @@ export class Reactor {
                 createdAtUtcIso,
                 coordinates: [],
             },
+            meta,
         };
         this.jobTracker.registerJob(jobInfo);
         // Enqueue the job
@@ -471,7 +468,8 @@ export class Reactor {
      * This function may cause a reshuffle, which will generate additional
      * operations.
      */
-    async load(docId, branch, operations, signal) {
+    async load(docId, branch, operations, signal, meta) {
+        this.logger.verbose("load(@docId, @branch, @count, @operations)", docId, branch, operations.length, operations);
         if (signal?.aborted) {
             throw new AbortError();
         }
@@ -498,6 +496,7 @@ export class Reactor {
             queueHint: [],
             maxRetries: 3,
             errorHistory: [],
+            meta,
         };
         const jobInfo = {
             id: job.id,
@@ -508,6 +507,7 @@ export class Reactor {
                 createdAtUtcIso,
                 coordinates: [],
             },
+            meta,
         };
         this.jobTracker.registerJob(jobInfo);
         await this.queue.enqueue(job);
@@ -519,7 +519,8 @@ export class Reactor {
     /**
      * Applies multiple mutations across documents with dependency management
      */
-    async executeBatch(request, signal) {
+    async executeBatch(request, signal, meta) {
+        this.logger.verbose("executeBatch(@count jobs)", request.jobs.length);
         if (signal?.aborted) {
             throw new AbortError();
         }
@@ -544,6 +545,7 @@ export class Reactor {
                     createdAtUtcIso,
                     coordinates: [],
                 },
+                meta,
             };
             this.jobTracker.registerJob(jobInfo);
             jobInfos.set(jobPlan.key, jobInfo);
@@ -570,6 +572,7 @@ export class Reactor {
                     queueHint,
                     maxRetries: 3,
                     errorHistory: [],
+                    meta,
                 };
                 await this.queue.enqueue(job);
                 enqueuedKeys.push(key);
@@ -599,20 +602,11 @@ export class Reactor {
      * Adds multiple documents as children to another
      */
     async addChildren(parentId, documentIds, branch = "main", signer, signal) {
+        this.logger.verbose("addChildren(@parentId, @count children, @branch)", parentId, documentIds.length, branch);
         if (signal?.aborted) {
             throw new AbortError();
         }
-        let actions = documentIds.map((childId) => ({
-            id: uuidv4(),
-            type: "ADD_RELATIONSHIP",
-            scope: "document",
-            timestampUtcMs: new Date().toISOString(),
-            input: {
-                sourceId: parentId,
-                targetId: childId,
-                relationshipType: "child",
-            },
-        }));
+        let actions = documentIds.map((childId) => addRelationshipAction(parentId, childId, "child"));
         // Sign actions if signer is provided
         if (signer) {
             actions = await signActions(actions, signer, signal);
@@ -623,20 +617,11 @@ export class Reactor {
      * Removes multiple documents as children from another
      */
     async removeChildren(parentId, documentIds, branch = "main", signer, signal) {
+        this.logger.verbose("removeChildren(@parentId, @count children, @branch)", parentId, documentIds.length, branch);
         if (signal?.aborted) {
             throw new AbortError();
         }
-        let actions = documentIds.map((childId) => ({
-            id: uuidv4(),
-            type: "REMOVE_RELATIONSHIP",
-            scope: "document",
-            timestampUtcMs: new Date().toISOString(),
-            input: {
-                sourceId: parentId,
-                targetId: childId,
-                relationshipType: "child",
-            },
-        }));
+        let actions = documentIds.map((childId) => removeRelationshipAction(parentId, childId, "child"));
         // Sign actions if signer is provided
         if (signer) {
             actions = await signActions(actions, signer, signal);
@@ -647,6 +632,7 @@ export class Reactor {
      * Retrieves the status of a job
      */
     getJobStatus(jobId, signal) {
+        this.logger.verbose("getJobStatus(@jobId)", jobId);
         if (signal?.aborted) {
             throw new AbortError();
         }
@@ -673,6 +659,7 @@ export class Reactor {
      * Finds documents by their IDs
      */
     async findByIds(ids, view, paging, consistencyToken, signal) {
+        this.logger.verbose("findByIds(@count ids)", ids.length);
         if (consistencyToken) {
             await this.documentView.waitForConsistency(consistencyToken, undefined, signal);
         }
@@ -760,6 +747,7 @@ export class Reactor {
      * Finds documents by their slugs
      */
     async findBySlugs(slugs, view, paging, consistencyToken, signal) {
+        this.logger.verbose("findBySlugs(@count slugs)", slugs.length);
         if (consistencyToken) {
             await this.documentView.waitForConsistency(consistencyToken, undefined, signal);
         }
@@ -868,6 +856,7 @@ export class Reactor {
      * Finds documents by parent ID
      */
     async findByParentId(parentId, view, paging, signal) {
+        this.logger.verbose("findByParentId(@parentId)", parentId);
         // Get child relationships from indexer
         const relationships = await this._documentIndexer.getOutgoing(parentId, ["child"], undefined, signal);
         if (signal?.aborted) {
@@ -923,6 +912,7 @@ export class Reactor {
      * Finds documents by type
      */
     async findByType(type, view, paging, consistencyToken, signal) {
+        this.logger.verbose("findByType(@type)", type);
         if (consistencyToken) {
             await this.documentView.waitForConsistency(consistencyToken, undefined, signal);
         }