node-cqrs 1.2.0-alpha.1 → 1.2.0-alpha.3

package/dist/types/workers/WorkerProxyProjection.d.ts

@@ -1,4 +1,4 @@
-import type { IEvent, IEventStorageReader, IEventStore, IExtendableLogger, ILogger, IViewLocker } from '../interfaces/index.ts';
+import type { IEvent, IEventSet, IEventStorageReader, IEventStore, IExtendableLogger, ILogger, IViewLocker } from '../interfaces/index.ts';
 import type { IProxyProjection, IWorkerProjection, ProxyProjectionParams } from './interfaces/index.ts';
 import * as Comlink from 'comlink';
 /**
@@ -7,6 +7,7 @@ import * as Comlink from 'comlink';
  */
 export declare class WorkerProxyProjection<TView, TProjection extends IWorkerProjection<TView> = IWorkerProjection<TView>> implements IProxyProjection<TView> {
     #private;
+    static RESTORE_BATCH_SIZE: number;
     viewLocker?: IViewLocker;
     get remoteProjection(): Comlink.Remote<TProjection>;
     get view(): Comlink.Remote<TView>;
@@ -15,12 +16,17 @@ export declare class WorkerProxyProjection<TView, TProjection extends IWorkerPro
     });
     subscribe(eventStore: IEventStore): void;
     restore(eventStore: IEventStorageReader): Promise<void>;
-    /** Restore view state from not-yet-projected events */
+    /**
+     * Restore view state from not-yet-projected events.
+     *
+     * Events are projected in batches to reduce worker RPC overhead.
+     * The batch size can be configured through {@link WorkerProxyProjection.RESTORE_BATCH_SIZE}.
+     */
     protected _restore(eventStore: IEventStorageReader): Promise<void>;
     protected _onWorkerError: (error: unknown) => void;
     protected _onWorkerExit: (exitCode: number) => void;
     ensureWorkerReady(): Promise<void>;
     project(event: IEvent): Promise<void>;
-    protected _project(event: IEvent): Promise<void>;
+    protected _projectBatch(batch: IEventSet): Promise<void>;
     dispose(): void;
 }

package/dist/types/workers/utils/createWorker.d.ts

@@ -1,10 +1,10 @@
-import { Worker } from 'node:worker_threads';
-import { type IWorkerData } from '../protocol.ts';
+import type { Worker } from 'node:worker_threads';
+import type { IWorkerData } from '../protocol.ts';
 /**
- * Create a worker instance, await a handshake or a failure
+ * Create a worker instance for a projection worker module, await a handshake or a failure.
  *
- * @param workerModulePath - Path to worker module
- * @param ports - Container with MessagePorts for communication with worker projection and view instances
- * @returns Worker instance
+ * @param workerModulePath - Absolute or relative path to the worker module
+ * @param ports - MessagePorts for projection and view communication (transferred into the worker)
+ * @returns Resolved Worker instance after the ready handshake
  */
 export declare function createWorker(workerModulePath: string, ports: IWorkerData): Promise<Worker>;

package/dist/types/workers/utils/index.d.ts

@@ -1,5 +1,3 @@
-export * from './createWorker.ts';
 export * from './createWorkerInstance.ts';
-export * from './nodeEndpoint.ts';
 export * from './workerProxyFactory.ts';
 export type * from './ProjectionView.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-cqrs",
-  "version": "1.2.0-alpha.1",
+  "version": "1.2.0-alpha.3",
   "description": "TypeScript CQRS/Event Sourcing toolkit for Node.js with DI, sagas, projections, and optional Worker, RabbitMQ, and SQLite adapters",
   "type": "module",
   "keywords": [

package/dist/cjs/sqlite-workers/utils/createSqliteWorker.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSqliteWorker = createSqliteWorker;
-const node_worker_threads_1 = require("node:worker_threads");
-const protocol_ts_1 = require("../protocol.js");
-const SqliteWorkerRunner_ts_1 = require("../SqliteWorkerRunner.js");
-async function createSqliteWorker(params) {
-    const { sqliteWorkerRunnerLocation = SqliteWorkerRunner_ts_1.SqliteWorkerRunner.location, ...workerData } = params;
-    const worker = new node_worker_threads_1.Worker(sqliteWorkerRunnerLocation, { workerData });
-    await new Promise((resolve, reject) => {
-        let onError;
-        let onMessage;
-        let onExit;
-        const cleanup = () => {
-            worker.off('error', onError);
-            worker.off('message', onMessage);
-            worker.off('exit', onExit);
-        };
-        onMessage = (message) => {
-            if (!(0, protocol_ts_1.isSqliteWorkerReadyMessage)(message))
-                return;
-            cleanup();
-            resolve();
-        };
-        onError = (err) => {
-            cleanup();
-            reject(err);
-        };
-        onExit = (exitCode) => {
-            cleanup();
-            reject(new Error(`SQLite worker exited prematurely with exit code ${exitCode}`));
-        };
-        worker.on('message', onMessage);
-        worker.once('error', onError);
-        worker.once('exit', onExit);
-    });
-    return worker;
-}
-//# sourceMappingURL=createSqliteWorker.js.map

package/dist/cjs/sqlite-workers/utils/createSqliteWorker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSqliteWorker.js","sourceRoot":"","sources":["../../../../src/sqlite-workers/utils/createSqliteWorker.ts"],"names":[],"mappings":";;AAIA,gDA2CC;AA/CD,6DAA6C;AAC7C,gDAA0F;AAC1F,oEAA8D;AAEvD,KAAK,UAAU,kBAAkB,CAAC,MAA+B;IACvE,MAAM,EACL,0BAA0B,GAAG,0CAAkB,CAAC,QAAQ,EACxD,GAAG,UAAU,EACb,GAAG,MAAM,CAAC;IAEX,MAAM,MAAM,GAAG,IAAI,4BAAM,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAEtE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,OAA+B,CAAC;QACpC,IAAI,SAAqC,CAAC;QAC1C,IAAI,MAAkC,CAAC;QAEvC,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,SAAS,GAAG,CAAC,OAAgB,EAAE,EAAE;YAChC,IAAI,CAAC,IAAA,wCAA0B,EAAC,OAAO,CAAC;gBACvC,OAAO;YAER,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACX,CAAC,CAAC;QAEF,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE;YAC1B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC;QAEF,MAAM,GAAG,CAAC,QAAgB,EAAE,EAAE;YAC7B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/cjs/sqlite-workers/utils/nodeEndpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodeEndpoint.js","sourceRoot":"","sources":["../../../../src/sqlite-workers/utils/nodeEndpoint.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA4C;AAC5C,gDAAkC;AAKlC,4CAA4C;AAC5C,yEAAyE;AACzE,MAAM,eAAe,GAAG,IAAA,2BAAa,EAAC,OAAO,UAAU,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACxG,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACjC,UAAU,CAAC,CAAC;AACb,MAAM,kBAAkB,GAAG,eAAe,CAAC,+BAA+B,CAAC,CAAC;AAC/D,QAAA,YAAY,GACxB,CAAC,kBAAkB,EAAE,OAAO,IAAI,kBAAkB,CAAQ,CAAC"}

package/dist/cjs/workers/utils/nodeEndpoint.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodeEndpoint = void 0;
-// Jest (CJS) cannot import the ESM adapter;
-// the UMD build is CJS/UMD but the default export shape varies by loader
-const nodeEndpointModule = require('comlink/dist/umd/node-adapter');
-exports.nodeEndpoint = (nodeEndpointModule?.default ?? nodeEndpointModule);
-//# sourceMappingURL=nodeEndpoint.js.map

package/dist/cjs/workers/utils/nodeEndpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodeEndpoint.js","sourceRoot":"","sources":["../../../../src/workers/utils/nodeEndpoint.ts"],"names":[],"mappings":";;;AAEA,4CAA4C;AAC5C,yEAAyE;AACzE,MAAM,kBAAkB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;AACvD,QAAA,YAAY,GACxB,CAAC,kBAAkB,EAAE,OAAO,IAAI,kBAAkB,CAAQ,CAAC"}

package/dist/esm/sqlite-workers/utils/createSqliteWorker.js

@@ -1,36 +0,0 @@
-import { Worker } from 'node:worker_threads';
-import { isSqliteWorkerReadyMessage } from "../protocol.js";
-import { SqliteWorkerRunner } from "../SqliteWorkerRunner.js";
-export async function createSqliteWorker(params) {
-    const { sqliteWorkerRunnerLocation = SqliteWorkerRunner.location, ...workerData } = params;
-    const worker = new Worker(sqliteWorkerRunnerLocation, { workerData });
-    await new Promise((resolve, reject) => {
-        let onError;
-        let onMessage;
-        let onExit;
-        const cleanup = () => {
-            worker.off('error', onError);
-            worker.off('message', onMessage);
-            worker.off('exit', onExit);
-        };
-        onMessage = (message) => {
-            if (!isSqliteWorkerReadyMessage(message))
-                return;
-            cleanup();
-            resolve();
-        };
-        onError = (err) => {
-            cleanup();
-            reject(err);
-        };
-        onExit = (exitCode) => {
-            cleanup();
-            reject(new Error(`SQLite worker exited prematurely with exit code ${exitCode}`));
-        };
-        worker.on('message', onMessage);
-        worker.once('error', onError);
-        worker.once('exit', onExit);
-    });
-    return worker;
-}
-//# sourceMappingURL=createSqliteWorker.js.map

package/dist/esm/sqlite-workers/utils/createSqliteWorker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSqliteWorker.js","sourceRoot":"","sources":["../../../../src/sqlite-workers/utils/createSqliteWorker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAgC,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAA+B;IACvE,MAAM,EACL,0BAA0B,GAAG,kBAAkB,CAAC,QAAQ,EACxD,GAAG,UAAU,EACb,GAAG,MAAM,CAAC;IAEX,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAEtE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,OAA+B,CAAC;QACpC,IAAI,SAAqC,CAAC;QAC1C,IAAI,MAAkC,CAAC;QAEvC,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,SAAS,GAAG,CAAC,OAAgB,EAAE,EAAE;YAChC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;gBACvC,OAAO;YAER,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACX,CAAC,CAAC;QAEF,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE;YAC1B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC;QAEF,MAAM,GAAG,CAAC,QAAgB,EAAE,EAAE;YAC7B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/esm/sqlite-workers/utils/nodeEndpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodeEndpoint.js","sourceRoot":"","sources":["../../../../src/sqlite-workers/utils/nodeEndpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,4CAA4C;AAC5C,yEAAyE;AACzE,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,UAAU,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACxG,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACjC,UAAU,CAAC,CAAC;AACb,MAAM,kBAAkB,GAAG,eAAe,CAAC,+BAA+B,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,YAAY,GACxB,CAAC,kBAAkB,EAAE,OAAO,IAAI,kBAAkB,CAAQ,CAAC"}

package/dist/esm/workers/utils/nodeEndpoint.js

@@ -1,5 +0,0 @@
-// Jest (CJS) cannot import the ESM adapter;
-// the UMD build is CJS/UMD but the default export shape varies by loader
-const nodeEndpointModule = require('comlink/dist/umd/node-adapter');
-export const nodeEndpoint = (nodeEndpointModule?.default ?? nodeEndpointModule);
-//# sourceMappingURL=nodeEndpoint.js.map

package/dist/esm/workers/utils/nodeEndpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nodeEndpoint.js","sourceRoot":"","sources":["../../../../src/workers/utils/nodeEndpoint.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,yEAAyE;AACzE,MAAM,kBAAkB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,YAAY,GACxB,CAAC,kBAAkB,EAAE,OAAO,IAAI,kBAAkB,CAAQ,CAAC"}

package/dist/types/sqlite-workers/utils/createSqliteWorker.d.ts

@@ -1,3 +0,0 @@
-import { Worker } from 'node:worker_threads';
-import { type SqliteWorkerProxyParams } from '../protocol.ts';
-export declare function createSqliteWorker(params: SqliteWorkerProxyParams): Promise<Worker>;

package/dist/types/workers/utils/nodeEndpoint.d.ts

@@ -1,2 +0,0 @@
-import * as Comlink from 'comlink';
-export declare const nodeEndpoint: (arg: any) => Comlink.Endpoint;