@ddd-ts-kit/kernel 0.8.0 → 0.10.0

package/dist/infrastructure/in-memory/in-memory-event-store.js

@@ -0,0 +1,37 @@
+import { ConcurrencyError } from '../../domain/errors/concurrency-error.js';
+/** Reference implementation, for tests and single-process apps. Not transactional: a failed unit of work keeps what it appended. */
+export class InMemoryEventStore {
+    events = [];
+    async append(stream, expectedVersion, events) {
+        const version = this.versionOf(stream);
+        if (version !== expectedVersion) {
+            throw new ConcurrencyError(stream);
+        }
+        events.forEach((event, index) => {
+            this.events.push(structuredClone({
+                ...event,
+                metadata: event.metadata ?? {},
+                stream,
+                version: version + index + 1,
+                position: this.events.length + 1,
+            }));
+        });
+        return { version: version + events.length, position: this.events.length };
+    }
+    async readStream(stream, after = 0) {
+        return this.events.filter((event) => event.stream === stream && event.version > after).map(copy);
+    }
+    async readAll(after, limit) {
+        return this.events.slice(Math.max(0, after), Math.max(0, after) + Math.max(0, limit)).map(copy);
+    }
+    async head() {
+        return this.events.length;
+    }
+    versionOf(stream) {
+        return this.events.filter((event) => event.stream === stream).length;
+    }
+}
+function copy(event) {
+    return structuredClone(event);
+}
+//# sourceMappingURL=in-memory-event-store.js.map

package/dist/infrastructure/in-memory/in-memory-event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-event-store.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-event-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,oIAAoI;AACpI,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAkB,EAAE,CAAC;IAE5C,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,eAAuB,EAAE,MAAgC;QACpF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,eAAe,CAAC;gBACd,GAAG,KAAK;gBACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;gBAC9B,MAAM;gBACN,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,CAAC;gBAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;aACjC,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,KAAK,GAAG,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnG,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,KAAa;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACvE,CAAC;CACF;AAED,SAAS,IAAI,CAAC,KAAkB;IAC9B,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/infrastructure/in-memory/in-memory-snapshot-store.d.ts

@@ -0,0 +1,9 @@
+import type { StoredSnapshot } from '../../application/event-sourcing/stored-snapshot.js';
+import type { SnapshotStore } from '../../application/ports/snapshot-store.js';
+/** Reference implementation, for tests and single-process apps. */
+export declare class InMemorySnapshotStore implements SnapshotStore {
+    private readonly snapshots;
+    find(stream: string): Promise<StoredSnapshot | undefined>;
+    save(snapshot: StoredSnapshot): Promise<void>;
+}
+//# sourceMappingURL=in-memory-snapshot-store.d.ts.map

package/dist/infrastructure/in-memory/in-memory-snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-snapshot-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,mEAAmE;AACnE,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAEzD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAI9D;IAEK,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlD;CACF"}

package/dist/infrastructure/in-memory/in-memory-snapshot-store.js

@@ -0,0 +1,15 @@
+/** Reference implementation, for tests and single-process apps. */
+export class InMemorySnapshotStore {
+    snapshots = new Map();
+    async find(stream) {
+        const snapshot = this.snapshots.get(stream);
+        return snapshot === undefined ? undefined : structuredClone(snapshot);
+    }
+    async save(snapshot) {
+        const held = this.snapshots.get(snapshot.stream);
+        if (held === undefined || held.version < snapshot.version) {
+            this.snapshots.set(snapshot.stream, structuredClone(snapshot));
+        }
+    }
+}
+//# sourceMappingURL=in-memory-snapshot-store.js.map

package/dist/infrastructure/in-memory/in-memory-snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-snapshot-store.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-snapshot-store.ts"],"names":[],"mappings":"AAGA,mEAAmE;AACnE,MAAM,OAAO,qBAAqB;IACf,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/D,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE5C,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAwB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEjD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}

package/dist/infrastructure/in-memory/in-memory-subject-key-store.d.ts

@@ -0,0 +1,10 @@
+import type { SubjectKey } from '../../application/event-sourcing/subject-key.js';
+import type { SubjectKeyStore } from '../../application/ports/subject-key-store.js';
+/** Reference implementation, for tests and single-process apps: the keys die with the process. */
+export declare class InMemorySubjectKeyStore implements SubjectKeyStore {
+    private readonly current;
+    keyFor(subject: string): Promise<SubjectKey>;
+    find(keyId: string): Promise<SubjectKey | undefined>;
+    erase(subject: string): Promise<boolean>;
+}
+//# sourceMappingURL=in-memory-subject-key-store.d.ts.map

package/dist/infrastructure/in-memory/in-memory-subject-key-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-subject-key-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-subject-key-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAEpF,kGAAkG;AAClG,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEnD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAYjD;IAEK,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEzD;IAEK,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7C;CACF"}

package/dist/infrastructure/in-memory/in-memory-subject-key-store.js

@@ -0,0 +1,21 @@
+import { randomBytes, randomUUID } from 'node:crypto';
+/** Reference implementation, for tests and single-process apps: the keys die with the process. */
+export class InMemorySubjectKeyStore {
+    current = new Map();
+    async keyFor(subject) {
+        const held = this.current.get(subject);
+        if (held !== undefined) {
+            return held;
+        }
+        const key = { id: randomUUID(), subject, material: randomBytes(32).toString('base64') };
+        this.current.set(subject, key);
+        return key;
+    }
+    async find(keyId) {
+        return [...this.current.values()].find((key) => key.id === keyId);
+    }
+    async erase(subject) {
+        return this.current.delete(subject);
+    }
+}
+//# sourceMappingURL=in-memory-subject-key-store.js.map

package/dist/infrastructure/in-memory/in-memory-subject-key-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-subject-key-store.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-subject-key-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAItD,kGAAkG;AAClG,MAAM,OAAO,uBAAuB;IACjB,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEzD,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAExF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import type { ScopedCriteria } from '../../application/criteria/scoped-criteria.js';
+import type { Page } from '../../application/pagination/page.js';
+import type { ReadModelRows } from '../../application/ports/read-model-rows.js';
+import type { ReadModelStore } from '../../application/ports/read-model-store.js';
+import type { EventStamp } from '../../application/read-model/event-stamp.js';
+import type { ReadModelWrite } from '../../application/read-model/read-model-write.js';
+/**
+ * The copy a rebuild fills, as the store of a projection: the same writes as the live store,
+ * "apply if newer" included, on the rows `ReadModelTable.shadow()` gives. A projection writes, it
+ * does not search: `search` is refused.
+ */
+export declare class ShadowReadModelStore<Row> implements ReadModelStore<Row> {
+    private readonly rows;
+    constructor(rows: ReadModelRows<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>>;
+}
+//# sourceMappingURL=shadow-read-model-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-read-model-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/read-model/shadow-read-model-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,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,oBAAoB,CAAC,GAAG,CAAE,YAAW,cAAc,CAAC,GAAG,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EAAI;IAEnD,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;IAED,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAExD;CACF"}

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

@@ -0,0 +1,25 @@
+import { writeIfNewer } from './write-if-newer.js';
+/**
+ * The copy a rebuild fills, as the store of a projection: the same writes as the live store,
+ * "apply if newer" included, on the rows `ReadModelTable.shadow()` gives. A projection writes, it
+ * does not search: `search` is refused.
+ */
+export class ShadowReadModelStore {
+    rows;
+    constructor(rows) {
+        this.rows = rows;
+    }
+    async get(key) {
+        return (await this.rows.find(key))?.row;
+    }
+    upsertIfNewer(key, stamp, next) {
+        return writeIfNewer(this.rows, { key, stamp, next });
+    }
+    delete(key, stamp) {
+        return writeIfNewer(this.rows, { key, stamp });
+    }
+    search(criteria) {
+        return Promise.reject(new TypeError('The copy of a read model being rebuilt is written, never searched'));
+    }
+}
+//# sourceMappingURL=shadow-read-model-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-read-model-store.js","sourceRoot":"","sources":["../../../src/infrastructure/read-model/shadow-read-model-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACF,IAAI;IAAjC,YAA6B,IAAwB;oBAAxB,IAAI;IAAuB,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;IAC1C,CAAC;IAED,aAAa,CACX,GAAW,EACX,KAAiB,EACjB,IAAmD;QAEnD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAiB;QACnC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,QAA6B;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC,CAAC;IAC5G,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-ts-kit/kernel",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Framework-agnostic DDD building blocks, application ports and an in-memory event bus.",
   "license": "MIT",
   "repository": {