@ddd-ts-kit/kernel 0.0.0-stage → 0.1.1

package/dist/infrastructure/read-model/projection-rebuild.js

@@ -0,0 +1,88 @@
+import { writeIfNewer } from './write-if-newer.js';
+/**
+ * Rebuilds a read model from its source of truth, without an event store and without stopping
+ * the projection. The copy is filled from the export alone; every key an event writes
+ * meanwhile is read again from the source; the last of them are read with the writers held,
+ * in the transaction that puts the copy in place of the table.
+ */
+export class ProjectionRebuild {
+    parts;
+    constructor(parts) {
+        this.parts = parts;
+    }
+    async run() {
+        const { table, unitOfWork } = this.parts;
+        await table.abandonRebuild();
+        await table.beginRebuild();
+        try {
+            const copied = await this.copy();
+            const caughtUp = await this.catchUp();
+            const held = await unitOfWork.run(() => this.swap());
+            return { copied, reread: caughtUp.reread + held, rounds: caughtUp.rounds };
+        }
+        catch (error) {
+            await table.abandonRebuild();
+            throw error;
+        }
+    }
+    async copy() {
+        const { table, source } = this.parts;
+        let copied = 0;
+        let cursor;
+        do {
+            const page = await source.export(cursor);
+            for (const { key, row, stamp } of page.items) {
+                await writeIfNewer(table.shadow(), { key, stamp, next: () => row });
+            }
+            copied += page.items.length;
+            cursor = page.nextCursor;
+        } while (cursor !== undefined);
+        return copied;
+    }
+    async catchUp() {
+        const { table, batchSize = 500, settledBelow = 50, maxRounds = 20 } = this.parts;
+        let reread = 0;
+        let rounds = 0;
+        for (; rounds < maxRounds; rounds += 1) {
+            const keys = await table.touched(batchSize);
+            if (keys.length <= settledBelow) {
+                break;
+            }
+            reread += await this.readAgain(keys);
+        }
+        return { reread, rounds };
+    }
+    async swap() {
+        const { table, batchSize = 500 } = this.parts;
+        let reread = 0;
+        await table.holdWriters();
+        for (let keys = await table.touched(batchSize); keys.length > 0; keys = await table.touched(batchSize)) {
+            reread += await this.readAgain(keys);
+        }
+        await table.promote();
+        return reread;
+    }
+    async readAgain(keys) {
+        const { table, source } = this.parts;
+        const found = await source.lookup(keys.map(({ key }) => key));
+        for (const { key } of keys) {
+            const entry = found.get(key);
+            if (entry === undefined) {
+                await this.forget(key);
+            }
+            else {
+                await writeIfNewer(table.shadow(), { key, stamp: entry.stamp, next: () => entry.row });
+            }
+        }
+        await table.settle(keys);
+        return keys.length;
+    }
+    /** The source no longer has the row: the copy takes the trace the table holds of its deletion, if it has one. */
+    async forget(key) {
+        const live = await this.parts.table.find(key);
+        if (live !== undefined && live.row === undefined) {
+            await writeIfNewer(this.parts.table.shadow(), { key, stamp: live.stamp });
+        }
+    }
+}
+//# sourceMappingURL=projection-rebuild.js.map

package/dist/infrastructure/read-model/projection-rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-rebuild.js","sourceRoot":"","sources":["../../../src/infrastructure/read-model/projection-rebuild.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/read-model/sql-run.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Runs one statement on the executor of the current unit of work and answers its rows.
+ * Parameters are written `$1`, `$2`, each once and in order, so an adapter whose driver wants
+ * `?` only has to replace them.
+ */
+export type SqlRun = (statement: string, parameters: readonly (string | number)[]) => Promise<readonly Readonly<Record<string, unknown>>[]>;
+//# sourceMappingURL=sql-run.d.ts.map

package/dist/infrastructure/read-model/sql-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-run.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/read-model/sql-run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KACrC,OAAO,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/dist/infrastructure/read-model/sql-run.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sql-run.js.map

package/dist/infrastructure/read-model/sql-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-run.js","sourceRoot":"","sources":["../../../src/infrastructure/read-model/sql-run.ts"],"names":[],"mappings":""}

package/dist/infrastructure/read-model/table-read-model-store.d.ts

@@ -0,0 +1,23 @@
+import type { CriteriaDefinition } from '../../application/criteria/criteria-definition.js';
+import type { ScopedCriteria } from '../../application/criteria/scoped-criteria.js';
+import type { Page } from '../../application/pagination/page.js';
+import type { ReadModelStore } from '../../application/ports/read-model-store.js';
+import type { ReadModelTable } from '../../application/ports/read-model-table.js';
+import type { EventStamp } from '../../application/read-model/event-stamp.js';
+import type { ReadModelWrite } from '../../application/read-model/read-model-write.js';
+/**
+ * A `ReadModelStore` over the table an adapter gives: the same class in memory and on every
+ * ORM. A write made while a rebuild runs records its key first, so the rebuild reads that row
+ * again from the source before it swaps.
+ */
+export declare class TableReadModelStore<Row extends object> implements ReadModelStore<Row> {
+    readonly table: ReadModelTable<Row>;
+    readonly definition: CriteriaDefinition<Row>;
+    constructor(table: ReadModelTable<Row>, definition: CriteriaDefinition<Row>);
+    get(key: string): Promise<Row | undefined>;
+    upsertIfNewer(key: string, stamp: EventStamp, next: (current: Row | undefined) => Row | undefined): Promise<ReadModelWrite>;
+    delete(key: string, stamp: EventStamp): Promise<ReadModelWrite>;
+    search(criteria: ScopedCriteria<Row>): Promise<Page<Row>>;
+    private written;
+}
+//# sourceMappingURL=table-read-model-store.d.ts.map

package/dist/infrastructure/read-model/table-read-model-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-read-model-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/read-model/table-read-model-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAGvF;;;;GAIG;AACH,qBAAa,mBAAmB,CAAC,GAAG,SAAS,MAAM,CAAE,YAAW,cAAc,CAAC,GAAG,CAAC;IAE/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC;IAF9C,YACW,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,EAC1B,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC1C;IAEE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAE/C;IAED,aAAa,CACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,SAAS,KAAK,GAAG,GAAG,SAAS,GAClD,OAAO,CAAC,cAAc,CAAC,CAEzB;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAE9D;IAEK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAU9D;YAEa,OAAO;CAOtB"}

package/dist/infrastructure/read-model/table-read-model-store.js

@@ -0,0 +1,40 @@
+import { pageOfPlan } from '../../application/criteria/page-of-plan.js';
+import { planCriteria } from '../../application/criteria/plan-criteria.js';
+import { writeIfNewer } from './write-if-newer.js';
+/**
+ * A `ReadModelStore` over the table an adapter gives: the same class in memory and on every
+ * ORM. A write made while a rebuild runs records its key first, so the rebuild reads that row
+ * again from the source before it swaps.
+ */
+export class TableReadModelStore {
+    table;
+    definition;
+    constructor(table, definition) {
+        this.table = table;
+        this.definition = definition;
+    }
+    async get(key) {
+        return (await this.table.find(key))?.row;
+    }
+    upsertIfNewer(key, stamp, next) {
+        return this.written({ key, stamp, next });
+    }
+    delete(key, stamp) {
+        return this.written({ key, stamp });
+    }
+    async search(criteria) {
+        const plan = planCriteria(this.definition, criteria);
+        if (plan.empty) {
+            return pageOfPlan(plan, [], 0);
+        }
+        const { rows, total } = await this.table.search(plan);
+        return pageOfPlan(plan, rows, total);
+    }
+    async written(change) {
+        if (await this.table.rebuilding()) {
+            await this.table.touch(change.key);
+        }
+        return writeIfNewer(this.table, change);
+    }
+}
+//# sourceMappingURL=table-read-model-store.js.map

package/dist/infrastructure/read-model/table-read-model-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-read-model-store.js","sourceRoot":"","sources":["../../../src/infrastructure/read-model/table-read-model-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAO3E,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAEnB,KAAK;IACL,UAAU;IAFrB,YACW,KAA0B,EAC1B,UAAmC;qBADnC,KAAK;0BACL,UAAU;IAClB,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;IAC3C,CAAC;IAED,aAAa,CACX,GAAW,EACX,KAAiB,EACjB,IAAmD;QAEnD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAiB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAA6B;QACxC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEtD,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,MAA0B;QAC9C,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/infrastructure/read-model/write-if-newer.d.ts

@@ -0,0 +1,17 @@
+import type { ReadModelRows } from '../../application/ports/read-model-rows.js';
+import type { EventStamp } from '../../application/read-model/event-stamp.js';
+import type { ReadModelWrite } from '../../application/read-model/read-model-write.js';
+export interface StampedChange<Row> {
+    readonly key: string;
+    readonly stamp: EventStamp;
+    /** The row to write from the current one. Absent for a deletion. */
+    readonly next?: (current: Row | undefined) => Row | undefined;
+}
+/**
+ * "Apply if newer", once for every store. It reads the row, gives up when the row holds this
+ * event or a later one, and writes on the condition that the row still holds the stamp it
+ * read: a concurrent write makes it read again, so two events of one key never overwrite each
+ * other blindly, with or without a transaction.
+ */
+export declare function writeIfNewer<Row>(rows: ReadModelRows<Row>, change: StampedChange<Row>): Promise<ReadModelWrite>;
+//# sourceMappingURL=write-if-newer.d.ts.map

package/dist/infrastructure/read-model/write-if-newer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-if-newer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/read-model/write-if-newer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAIvF,MAAM,WAAW,aAAa,CAAC,GAAG;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,SAAS,KAAK,GAAG,GAAG,SAAS,CAAC;CAC/D;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBrH"}

package/dist/infrastructure/read-model/write-if-newer.js

@@ -0,0 +1,32 @@
+import { isNewer } from '../../application/read-model/is-newer.js';
+import { ConcurrencyError } from '../../domain/errors/concurrency-error.js';
+const ATTEMPTS = 5;
+/**
+ * "Apply if newer", once for every store. It reads the row, gives up when the row holds this
+ * event or a later one, and writes on the condition that the row still holds the stamp it
+ * read: a concurrent write makes it read again, so two events of one key never overwrite each
+ * other blindly, with or without a transaction.
+ */
+export async function writeIfNewer(rows, change) {
+    for (let attempt = 0; attempt < ATTEMPTS; attempt += 1) {
+        const held = await rows.find(change.key);
+        if (held !== undefined && !isNewer(change.stamp, held.stamp)) {
+            return 'stale';
+        }
+        const written = await attempted(rows, change, held);
+        if (written !== undefined) {
+            return written;
+        }
+    }
+    throw new ConcurrencyError(change.key);
+}
+/** `undefined` when another write got there first. */
+async function attempted(rows, { key, stamp, next }, held) {
+    const row = next?.(held?.row);
+    if (row === undefined && (next !== undefined || held === undefined)) {
+        return 'ignored';
+    }
+    const done = held === undefined ? await rows.insert({ key, row, stamp }) : await rows.replace({ key, row, stamp }, held.stamp);
+    return done ? 'applied' : undefined;
+}
+//# sourceMappingURL=write-if-newer.js.map

package/dist/infrastructure/read-model/write-if-newer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-if-newer.js","sourceRoot":"","sources":["../../../src/infrastructure/read-model/write-if-newer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAS5E,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAM,IAAwB,EAAE,MAA0B;IAC1F,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAEpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,sDAAsD;AACtD,KAAK,UAAU,SAAS,CACtB,IAAwB,EACxB,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAsB,EACxC,IAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE9B,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GACR,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpH,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@ddd-ts-kit/kernel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Framework-agnostic DDD building blocks, application ports and an in-memory event bus.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/kernel"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/kernel#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./declarations": {
+      "types": "./dist/declarations.d.ts",
+      "default": "./dist/declarations.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  }
+}