@ddd-ts-kit/kernel 0.8.0 → 0.10.0

package/dist/infrastructure/event-sourcing/event-serializer.js

@@ -0,0 +1,104 @@
+import { StoredEventData } from '../../application/event-sourcing/stored-event-data.js';
+import { UnreadableEventError } from '../../application/event-sourcing/unreadable-event-error.js';
+import { UuidGenerator } from '../id/uuid-generator.js';
+import { PersonalDataCipher } from './personal-data-cipher.js';
+import { storedOrigins } from './stored-origins.js';
+/**
+ * Turns the domain events of one aggregate into stored events and back, as `defineStoredEvent`
+ * declared them: the current version of their shape on the way in, and on the way out the
+ * upcasters from the version they were stored with, then `decode`. Stored events are never
+ * rewritten. Personal values are sealed on the way in and opened on the way out.
+ */
+export class EventSerializer {
+    options;
+    types = new Map();
+    ids;
+    constructor(types, options = {}) {
+        this.options = options;
+        for (const name of Object.keys(types)) {
+            const declared = Reflect.get(types, name);
+            if (isStoredEventType(declared)) {
+                this.types.set(name, declared);
+            }
+        }
+        this.ids = options.ids ?? new UuidGenerator();
+    }
+    /** Whether events of this name are declared here: what a subscription skips otherwise. */
+    declares(type) {
+        return this.types.has(type);
+    }
+    async serialize(event) {
+        const declared = this.typeOf(event.name);
+        return {
+            id: this.ids.next(),
+            type: event.name,
+            schemaVersion: declared.version,
+            data: await this.seal(declared.encode(event)),
+            metadata: { aggregateId: event.aggregateId },
+            occurredAt: event.occurredAt,
+        };
+    }
+    async deserialize(stored) {
+        const declared = this.typeOf(stored.type);
+        const where = `${stored.type} ${stored.id}`;
+        const data = upcast(declared, await this.open(stored.data), stored);
+        const event = declared.decode(new StoredEventData(data, where), {
+            id: stored.id,
+            aggregateId: aggregateIdOf(stored),
+            occurredAt: stored.occurredAt,
+            version: stored.version,
+        });
+        storedOrigins.set(event, stored);
+        return event;
+    }
+    /** Seals the personal values of the data, for an event or a snapshot. */
+    async seal(data) {
+        if (!PersonalDataCipher.holdsPersonalData(data)) {
+            return data;
+        }
+        if (this.options.cipher === undefined) {
+            throw new TypeError('Personal data is stored sealed: give the serializer a PersonalDataCipher');
+        }
+        return this.options.cipher.seal(data);
+    }
+    /** Opens the sealed values of the data; an erased one reads `ERASED_PERSONAL_DATA`. */
+    async open(data) {
+        if (!PersonalDataCipher.holdsPersonalData(data)) {
+            return data;
+        }
+        if (this.options.cipher === undefined) {
+            throw new UnreadableEventError('Stored data holds sealed values: give the serializer a PersonalDataCipher');
+        }
+        return this.options.cipher.open(data);
+    }
+    typeOf(type) {
+        const declared = this.types.get(type);
+        if (declared === undefined) {
+            throw new UnreadableEventError(`"${type}" is not a stored event of this serializer: declare it with defineStoredEvent`);
+        }
+        return declared;
+    }
+}
+/** What `defineStoredEvent` answers, told apart from anything else a record of declarations could hold. */
+function isStoredEventType(value) {
+    return typeof value === 'object' && value !== null && 'decode' in value && 'encode' in value && 'version' in value;
+}
+function upcast(declared, data, stored) {
+    if (stored.schemaVersion > declared.version) {
+        throw new UnreadableEventError(`${stored.type} ${stored.id} is stored in version ${stored.schemaVersion}, and this release reads up to ${declared.version}`);
+    }
+    let current = data;
+    for (let version = stored.schemaVersion; version < declared.version; version += 1) {
+        const upcaster = declared.upcasters[version];
+        if (upcaster === undefined) {
+            throw new UnreadableEventError(`${stored.type} has no upcaster from version ${version}`);
+        }
+        current = upcaster(current);
+    }
+    return current;
+}
+function aggregateIdOf(stored) {
+    const declared = stored.metadata['aggregateId'];
+    return typeof declared === 'string' ? declared : stored.stream;
+}
+//# sourceMappingURL=event-serializer.js.map

package/dist/infrastructure/event-sourcing/event-serializer.js.map

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

package/dist/infrastructure/event-sourcing/event-sourced-repository.d.ts

@@ -0,0 +1,32 @@
+import type { EventStore } from '../../application/ports/event-store.js';
+import type { DomainEvent } from '../../domain/domain-event.js';
+import type { AggregateHistory } from '../../domain/event-sourcing/aggregate-history.js';
+import type { EventSourcedAggregate } from '../../domain/event-sourcing/event-sourced-aggregate.js';
+import type { EventSerializer } from './event-serializer.js';
+import type { SnapshotPolicy } from './snapshot-policy.js';
+export interface EventSourcedRepositoryParts<A extends EventSourcedAggregate<E, S>, E extends DomainEvent, S> {
+    readonly store: EventStore;
+    readonly serializer: EventSerializer<E>;
+    /** `<context>.<aggregate>`: the stream of an aggregate is `<category>-<id>`. */
+    readonly category: string;
+    /** The static `rehydrate` of the aggregate: `(id, history) => AttendanceRecord.rehydrate(id, history)`. */
+    rehydrate(id: string, history: AggregateHistory<E, S>): A;
+    readonly snapshots?: SnapshotPolicy<A, S>;
+}
+/**
+ * What the repository adapter of an event-sourced aggregate delegates to: `findById` replays the
+ * stream, from the last snapshot when the aggregate takes them; `save` appends what the aggregate
+ * recorded, at the version it was loaded at, in the transaction of the unit of work, and takes a
+ * snapshot when one is due. The events then leave with the save like any other (`dispatchingOnSave`).
+ */
+export declare class EventSourcedRepository<A extends EventSourcedAggregate<E, S>, E extends DomainEvent, S = never> {
+    private readonly parts;
+    constructor(parts: EventSourcedRepositoryParts<A, E, S>);
+    static streamOf(category: string, id: string): string;
+    findById(id: string): Promise<A | undefined>;
+    save(aggregate: A): Promise<void>;
+    private serialized;
+    private snapshotIfDue;
+    private snapshotOf;
+}
+//# sourceMappingURL=event-sourced-repository.d.ts.map

package/dist/infrastructure/event-sourcing/event-sourced-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourced-repository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/event-sourced-repository.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC;IAC1G,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2GAA2G;IAC3G,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB,CAAC,CAAC,SAAS,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC,GAAG,KAAK;IAC7F,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,2BAA2B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAI;IAE5E,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEpD;IAEK,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAgBjD;IAEK,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAStC;YAEa,UAAU;YAUV,aAAa;YAeb,UAAU;CAYzB"}

package/dist/infrastructure/event-sourcing/event-sourced-repository.js

@@ -0,0 +1,68 @@
+import { storedDataOf } from '../../application/event-sourcing/stored-data-of.js';
+import { StoredEventData } from '../../application/event-sourcing/stored-event-data.js';
+import { appendChanges } from '../../application/persistence/append-changes.js';
+/**
+ * What the repository adapter of an event-sourced aggregate delegates to: `findById` replays the
+ * stream, from the last snapshot when the aggregate takes them; `save` appends what the aggregate
+ * recorded, at the version it was loaded at, in the transaction of the unit of work, and takes a
+ * snapshot when one is due. The events then leave with the save like any other (`dispatchingOnSave`).
+ */
+export class EventSourcedRepository {
+    parts;
+    constructor(parts) {
+        this.parts = parts;
+    }
+    static streamOf(category, id) {
+        return `${category}-${id}`;
+    }
+    async findById(id) {
+        const stream = EventSourcedRepository.streamOf(this.parts.category, id);
+        const snapshot = await this.snapshotOf(stream);
+        const stored = await this.parts.store.readStream(stream, snapshot?.version ?? 0);
+        if (snapshot === undefined && stored.length === 0) {
+            return undefined;
+        }
+        const events = [];
+        for (const event of stored) {
+            events.push(await this.parts.serializer.deserialize(event));
+        }
+        return this.parts.rehydrate(id, snapshot === undefined ? { events } : { snapshot, events });
+    }
+    async save(aggregate) {
+        const before = aggregate.version;
+        const stream = EventSourcedRepository.streamOf(this.parts.category, aggregate.id);
+        await appendChanges(aggregate, async ({ expected, events }) => {
+            await this.parts.store.append(stream, expected, await this.serialized(events));
+        });
+        await this.snapshotIfDue(aggregate, stream, before);
+    }
+    async serialized(events) {
+        const serialized = [];
+        for (const event of events) {
+            serialized.push(await this.parts.serializer.serialize(event));
+        }
+        return serialized;
+    }
+    async snapshotIfDue(aggregate, stream, before) {
+        const policy = this.parts.snapshots;
+        if (policy === undefined || Math.floor(aggregate.version / policy.every) === Math.floor(before / policy.every)) {
+            return;
+        }
+        await policy.store.save({
+            stream,
+            version: aggregate.version,
+            schemaVersion: policy.version,
+            data: await this.parts.serializer.seal(storedDataOf(policy.encode(aggregate))),
+        });
+    }
+    async snapshotOf(stream) {
+        const policy = this.parts.snapshots;
+        const found = await policy?.store.find(stream);
+        if (policy === undefined || found === undefined || found.schemaVersion !== policy.version) {
+            return undefined;
+        }
+        const data = await this.parts.serializer.open(found.data);
+        return { version: found.version, state: policy.decode(new StoredEventData(data, `the snapshot of ${stream}`)) };
+    }
+}
+//# sourceMappingURL=event-sourced-repository.js.map

package/dist/infrastructure/event-sourcing/event-sourced-repository.js.map

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

package/dist/infrastructure/event-sourcing/event-sourcing-stores.d.ts

@@ -0,0 +1,12 @@
+import type { CheckpointStore } from '../../application/ports/checkpoint-store.js';
+import type { EventStore } from '../../application/ports/event-store.js';
+import type { SnapshotStore } from '../../application/ports/snapshot-store.js';
+import type { SubjectKeyStore } from '../../application/ports/subject-key-store.js';
+/** The stores event sourcing needs in one database, to bind to their ports in the composition root. */
+export interface EventSourcingStores {
+    readonly events: EventStore;
+    readonly snapshots: SnapshotStore;
+    readonly checkpoints: CheckpointStore;
+    readonly subjectKeys: SubjectKeyStore;
+}
+//# sourceMappingURL=event-sourcing-stores.d.ts.map

package/dist/infrastructure/event-sourcing/event-sourcing-stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourcing-stores.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/event-sourcing-stores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAEpF,uGAAuG;AACvG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;CACvC"}

package/dist/infrastructure/event-sourcing/event-sourcing-stores.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-sourcing-stores.js.map

package/dist/infrastructure/event-sourcing/event-sourcing-stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourcing-stores.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/event-sourcing-stores.ts"],"names":[],"mappings":""}

package/dist/infrastructure/event-sourcing/event-store-projection-rebuild.d.ts

@@ -0,0 +1,34 @@
+import type { StoredEvent } from '../../application/event-sourcing/stored-event.js';
+import type { EventStore } from '../../application/ports/event-store.js';
+import type { ReadModelStore } from '../../application/ports/read-model-store.js';
+import type { ReadModelTable } from '../../application/ports/read-model-table.js';
+import type { UnitOfWork } from '../../application/ports/unit-of-work.js';
+export interface EventStoreProjectionRebuildParts<Row> {
+    readonly table: ReadModelTable<Row>;
+    readonly store: EventStore;
+    /** The unit of work of the table's database: the end of the replay and the swap are one transaction. */
+    readonly unitOfWork: UnitOfWork;
+    /** How the projection applies an event to the store it is given: the same projection, built over the copy. */
+    applierOn(copy: ReadModelStore<Row>): (event: StoredEvent) => Promise<void>;
+    /** Events read per round. Default 500. */
+    readonly batchSize?: number;
+}
+/** What a rebuild from the event store did. */
+export interface EventStoreRebuildReport {
+    /** Events read from the store, from position zero to its head at the swap. */
+    readonly replayed: number;
+}
+/**
+ * Rebuilds a read model fed by the event store from position zero, without stopping its catch-up
+ * subscription. An empty copy of the table is filled by replaying the whole store through the
+ * projection; then, in one transaction, the writers are held, the events appended meanwhile are
+ * replayed, and the copy takes the place of the table. The subscription goes on from its
+ * checkpoint: what it applies again is stale against the stamps of the copy.
+ */
+export declare class EventStoreProjectionRebuild<Row> {
+    private readonly parts;
+    constructor(parts: EventStoreProjectionRebuildParts<Row>);
+    run(): Promise<EventStoreRebuildReport>;
+    private replay;
+}
+//# sourceMappingURL=event-store-projection-rebuild.d.ts.map

package/dist/infrastructure/event-sourcing/event-store-projection-rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-projection-rebuild.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/event-store-projection-rebuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAG1E,MAAM,WAAW,gCAAgC,CAAC,GAAG;IACnD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,wGAAwG;IACxG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,8GAA8G;IAC9G,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,2BAA2B,CAAC,GAAG;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,gCAAgC,CAAC,GAAG,CAAC,EAAI;IAEvE,GAAG,IAAI,OAAO,CAAC,uBAAuB,CAAC,CA0B5C;YAEa,MAAM;CAuBrB"}

package/dist/infrastructure/event-sourcing/event-store-projection-rebuild.js

@@ -0,0 +1,48 @@
+import { ShadowReadModelStore } from '../read-model/shadow-read-model-store.js';
+/**
+ * Rebuilds a read model fed by the event store from position zero, without stopping its catch-up
+ * subscription. An empty copy of the table is filled by replaying the whole store through the
+ * projection; then, in one transaction, the writers are held, the events appended meanwhile are
+ * replayed, and the copy takes the place of the table. The subscription goes on from its
+ * checkpoint: what it applies again is stale against the stamps of the copy.
+ */
+export class EventStoreProjectionRebuild {
+    parts;
+    constructor(parts) {
+        this.parts = parts;
+    }
+    async run() {
+        const { table, unitOfWork } = this.parts;
+        await table.abandonRebuild();
+        await table.beginRebuild();
+        try {
+            const apply = this.parts.applierOn(new ShadowReadModelStore(table.shadow()));
+            const copied = await this.replay(apply, 0);
+            const replayed = await unitOfWork.run(async () => {
+                await table.holdWriters();
+                const caughtUp = await this.replay(apply, copied.position);
+                await table.promote();
+                return copied.read + caughtUp.read;
+            });
+            return { replayed };
+        }
+        catch (error) {
+            await table.abandonRebuild();
+            throw error;
+        }
+    }
+    async replay(apply, from) {
+        const { store, batchSize = 500 } = this.parts;
+        let position = from;
+        let read = 0;
+        for (let events = await store.readAll(position, batchSize); events.length > 0; events = await store.readAll(position, batchSize)) {
+            for (const event of events) {
+                await apply(event);
+                position = event.position;
+            }
+            read += events.length;
+        }
+        return { position, read };
+    }
+}
+//# sourceMappingURL=event-store-projection-rebuild.js.map

package/dist/infrastructure/event-sourcing/event-store-projection-rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-projection-rebuild.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/event-store-projection-rebuild.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAmBhF;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IACT,KAAK;IAAlC,YAA6B,KAA4C;qBAA5C,KAAK;IAA0C,CAAC;IAE7E,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7B,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAE3C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC/C,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;gBAE1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAE3D,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBAEtB,OAAO,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;YAE7B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,KAA4C,EAC5C,IAAY;QAEZ,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC9C,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KACE,IAAI,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EACrD,MAAM,CAAC,MAAM,GAAG,CAAC,EACjB,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EACjD,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnB,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC5B,CAAC;YAED,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/infrastructure/event-sourcing/personal-data-cipher.d.ts

@@ -0,0 +1,19 @@
+import type { StoredData } from '../../application/event-sourcing/stored-data.js';
+import type { SubjectKeyStore } from '../../application/ports/subject-key-store.js';
+/**
+ * Crypto-shredding of the personal values of stored data. `seal` replaces each value marked with
+ * `personalData(subject, value)` by its encryption under the current key of its subject (AES-256-GCM,
+ * a fresh nonce per value, the key id written next to it); `open` gives the values back, and
+ * `ERASED_PERSONAL_DATA` for those whose key was destroyed by `SubjectKeyStore.erase`.
+ */
+export declare class PersonalDataCipher {
+    private readonly keys;
+    constructor(keys: SubjectKeyStore);
+    /** Whether the data holds a personal value, sealed or not. */
+    static holdsPersonalData(data: StoredData): boolean;
+    seal(data: StoredData): Promise<StoredData>;
+    open(data: StoredData): Promise<StoredData>;
+    private sealed;
+    private opened;
+}
+//# sourceMappingURL=personal-data-cipher.d.ts.map

package/dist/infrastructure/event-sourcing/personal-data-cipher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal-data-cipher.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/personal-data-cipher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAGlF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAOpF;;;;;GAKG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,eAAe,EAAI;IAEtD,8DAA8D;IAC9D,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAElD;IAED,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAM1C;IAED,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAM1C;YAEa,MAAM;YAYN,MAAM;CAiBrB"}

package/dist/infrastructure/event-sourcing/personal-data-cipher.js

@@ -0,0 +1,84 @@
+import { createCipheriv, createDecipheriv, randomBytes } from 'node:crypto';
+import { ERASED_PERSONAL_DATA } from '../../application/event-sourcing/erased-personal-data.js';
+import { isStoredData } from '../../application/event-sourcing/is-stored-data.js';
+import { rewriteObjects } from './rewrite-objects.js';
+const ALGORITHM = 'aes-256-gcm';
+const IV_BYTES = 12;
+const TAG_BYTES = 16;
+/**
+ * Crypto-shredding of the personal values of stored data. `seal` replaces each value marked with
+ * `personalData(subject, value)` by its encryption under the current key of its subject (AES-256-GCM,
+ * a fresh nonce per value, the key id written next to it); `open` gives the values back, and
+ * `ERASED_PERSONAL_DATA` for those whose key was destroyed by `SubjectKeyStore.erase`.
+ */
+export class PersonalDataCipher {
+    keys;
+    constructor(keys) {
+        this.keys = keys;
+    }
+    /** Whether the data holds a personal value, sealed or not. */
+    static holdsPersonalData(data) {
+        return holdsIn(data);
+    }
+    seal(data) {
+        return rewriteObjects(data, (object) => {
+            const personal = personalOf(object);
+            return personal === undefined ? undefined : this.sealed(personal.subject, personal.value);
+        });
+    }
+    open(data) {
+        return rewriteObjects(data, (object) => {
+            const sealed = sealedOf(object);
+            return sealed === undefined ? undefined : this.opened(sealed);
+        });
+    }
+    async sealed(subject, value) {
+        const key = await this.keys.keyFor(subject);
+        const iv = randomBytes(IV_BYTES);
+        const cipher = createCipheriv(ALGORITHM, materialOf(key), iv);
+        cipher.setAAD(Buffer.from(key.id));
+        const encrypted = Buffer.concat([cipher.update(value, 'utf8'), cipher.final(), cipher.getAuthTag()]);
+        return { $sealed: { key: key.id, iv: iv.toString('base64'), data: encrypted.toString('base64') } };
+    }
+    async opened(sealed) {
+        const key = await this.keys.find(sealed.key);
+        if (key === undefined) {
+            return ERASED_PERSONAL_DATA;
+        }
+        const bytes = Buffer.from(sealed.data, 'base64');
+        const decipher = createDecipheriv(ALGORITHM, materialOf(key), Buffer.from(sealed.iv, 'base64'));
+        decipher.setAAD(Buffer.from(key.id));
+        decipher.setAuthTag(bytes.subarray(bytes.length - TAG_BYTES));
+        return Buffer.concat([decipher.update(bytes.subarray(0, bytes.length - TAG_BYTES)), decipher.final()]).toString('utf8');
+    }
+}
+function materialOf(key) {
+    return Buffer.from(key.material, 'base64');
+}
+function holdsIn(value) {
+    if (isStoredData(value)) {
+        return isMarked(value) || Object.values(value).some(holdsIn);
+    }
+    return Array.isArray(value) && value.some((item) => holdsIn(item));
+}
+function isMarked(value) {
+    return personalOf(value) !== undefined || sealedOf(value) !== undefined;
+}
+function personalOf(object) {
+    const marked = onlyField(object, '$personal');
+    const subject = marked?.['subject'];
+    const value = marked?.['value'];
+    return typeof subject === 'string' && typeof value === 'string' ? { subject, value } : undefined;
+}
+function sealedOf(object) {
+    const marked = onlyField(object, '$sealed');
+    const key = marked?.['key'];
+    const iv = marked?.['iv'];
+    const data = marked?.['data'];
+    return typeof key === 'string' && typeof iv === 'string' && typeof data === 'string' ? { key, iv, data } : undefined;
+}
+function onlyField(object, field) {
+    const value = object[field];
+    return Object.keys(object).length === 1 && isStoredData(value) ? value : undefined;
+}
+//# sourceMappingURL=personal-data-cipher.js.map

package/dist/infrastructure/event-sourcing/personal-data-cipher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal-data-cipher.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/personal-data-cipher.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-options.d.ts

@@ -0,0 +1,6 @@
+/** Where the tables of an event store live in PostgreSQL. */
+export interface EventStoreTablesOptions {
+    /** The schema of the bounded context; created when missing. Without it, the default schema of the connection. */
+    readonly schema?: string;
+}
+//# sourceMappingURL=event-store-tables-options.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables-options.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables-options.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,iHAAiH;IACjH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-store-tables-options.js.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables-options.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables-options.ts"],"names":[],"mappings":""}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-sql.d.ts

@@ -0,0 +1,9 @@
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/**
+ * The statements that create the tables of an event store on PostgreSQL, for a migration of the
+ * project: the events, the head of the store (the position the next append starts after), the
+ * snapshots, the checkpoints of the subscriptions and the keys of the data subjects. Each one
+ * can run again.
+ */
+export declare function eventStoreTablesSql(options?: EventStoreTablesOptions): readonly string[];
+//# sourceMappingURL=event-store-tables-sql.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables-sql.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables-sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,SAAS,MAAM,EAAE,CAwB5F"}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-sql.js

@@ -0,0 +1,32 @@
+import { qualifiedTable } from './qualified-table.js';
+/**
+ * The statements that create the tables of an event store on PostgreSQL, for a migration of the
+ * project: the events, the head of the store (the position the next append starts after), the
+ * snapshots, the checkpoints of the subscriptions and the keys of the data subjects. Each one
+ * can run again.
+ */
+export function eventStoreTablesSql(options = {}) {
+    const { schema } = options;
+    const table = (name) => qualifiedTable(schema, name);
+    return [
+        ...(schema === undefined ? [] : [`create schema if not exists "${schema.replaceAll('"', '""')}"`]),
+        `create table if not exists ${table('head')} (id smallint primary key, position bigint not null)`,
+        `create table if not exists ${table('events')} (
+  position bigint primary key,
+  stream text not null,
+  version integer not null,
+  event_id text not null unique,
+  type text not null,
+  schema_version integer not null,
+  data jsonb not null,
+  metadata jsonb not null,
+  occurred_at timestamptz(3) not null,
+  recorded_at timestamptz(3) not null default now(),
+  unique (stream, version)
+)`,
+        `create table if not exists ${table('snapshots')} (stream text primary key, version integer not null, schema_version integer not null, data jsonb not null, taken_at timestamptz(3) not null default now())`,
+        `create table if not exists ${table('checkpoints')} (subscriber text primary key, position bigint not null, updated_at timestamptz(3) not null default now())`,
+        `create table if not exists ${table('subjectKeys')} (subject text primary key, key_id text not null unique, material text not null, created_at timestamptz(3) not null default now())`,
+    ];
+}
+//# sourceMappingURL=event-store-tables-sql.js.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables-sql.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables-sql.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAA4B,EAAE;IACvE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAA0C,EAAU,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEnG,OAAO;QACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,gCAAgC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAClG,8BAA8B,KAAK,CAAC,MAAM,CAAC,sDAAsD;QACjG,8BAA8B,KAAK,CAAC,QAAQ,CAAC;;;;;;;;;;;;EAY/C;QACE,8BAA8B,KAAK,CAAC,WAAW,CAAC,4JAA4J;QAC5M,8BAA8B,KAAK,CAAC,aAAa,CAAC,4GAA4G;QAC9J,8BAA8B,KAAK,CAAC,aAAa,CAAC,oIAAoI;KACvL,CAAC;AACJ,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables.d.ts

@@ -0,0 +1,9 @@
+/** The names of the tables of an event store, fixed: a context that keeps one gives it a schema of its own. */
+export declare const EVENT_STORE_TABLES: {
+    readonly events: 'stored_events';
+    readonly head: 'stored_events_head';
+    readonly snapshots: 'stream_snapshots';
+    readonly checkpoints: 'subscription_checkpoints';
+    readonly subjectKeys: 'subject_keys';
+};
+//# sourceMappingURL=event-store-tables.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,eAAO,MAAM,kBAAkB;aAC7B,MAAM,EAAE,eAAe;aACvB,IAAI,EAAE,oBAAoB;aAC1B,SAAS,EAAE,kBAAkB;aAC7B,WAAW,EAAE,0BAA0B;aACvC,WAAW,EAAE,cAAc;CACnB,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/event-store-tables.js

@@ -0,0 +1,9 @@
+/** The names of the tables of an event store, fixed: a context that keeps one gives it a schema of its own. */
+export const EVENT_STORE_TABLES = {
+    events: 'stored_events',
+    head: 'stored_events_head',
+    snapshots: 'stream_snapshots',
+    checkpoints: 'subscription_checkpoints',
+    subjectKeys: 'subject_keys',
+};
+//# sourceMappingURL=event-store-tables.js.map

package/dist/infrastructure/event-sourcing/postgres/event-store-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-tables.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/event-store-tables.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,kBAAkB;IAC7B,WAAW,EAAE,0BAA0B;IACvC,WAAW,EAAE,cAAc;CACnB,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/is-append-conflict.d.ts

@@ -0,0 +1,3 @@
+/** Whether an append lost to a concurrent one, whatever wraps the error of the driver: the driver alone (knex), `cause` (drizzle), `driverError` (TypeORM) or `meta` (Prisma). */
+export declare function isAppendConflict(error: unknown, depth?: number): boolean;
+//# sourceMappingURL=is-append-conflict.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/is-append-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-append-conflict.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/is-append-conflict.ts"],"names":[],"mappings":"AAWA,kLAAkL;AAClL,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAQ,GAAG,OAAO,CAYvE"}

package/dist/infrastructure/event-sourcing/postgres/is-append-conflict.js

@@ -0,0 +1,22 @@
+/**
+ * What PostgreSQL answers when another transaction appended first: a duplicate (stream, version)
+ * (23505); a serialization failure (40001) when the unit of work runs at REPEATABLE READ or
+ * SERIALIZABLE and the head of the store moved since it began; a deadlock (40P01) when the same
+ * transaction took other row locks in another order than a concurrent one. Each is a conflict the
+ * caller retries, never a fault of the store.
+ */
+const CONFLICTS = new Set(['23505', '40001', '40P01']);
+const WRAPPERS = ['cause', 'driverError', 'meta', 'originalError'];
+const DEPTH = 4;
+/** Whether an append lost to a concurrent one, whatever wraps the error of the driver: the driver alone (knex), `cause` (drizzle), `driverError` (TypeORM) or `meta` (Prisma). */
+export function isAppendConflict(error, depth = DEPTH) {
+    if (typeof error !== 'object' || error === null || depth === 0) {
+        return false;
+    }
+    const code = Reflect.get(error, 'code');
+    if (typeof code === 'string' && CONFLICTS.has(code)) {
+        return true;
+    }
+    return WRAPPERS.some((key) => isAppendConflict(Reflect.get(error, key), depth - 1));
+}
+//# sourceMappingURL=is-append-conflict.js.map

package/dist/infrastructure/event-sourcing/postgres/is-append-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-append-conflict.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/is-append-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACvD,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;AACnE,MAAM,KAAK,GAAG,CAAC,CAAC;AAEhB,kLAAkL;AAClL,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,KAAK,GAAG,KAAK;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/postgres-checkpoint-store.d.ts

@@ -0,0 +1,12 @@
+import type { CheckpointStore } from '../../../application/ports/checkpoint-store.js';
+import type { SqlRun } from '../../read-model/sql-run.js';
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/** The checkpoints of the subscriptions on PostgreSQL, moved by a statement guarded by the position it starts from. */
+export declare class PostgresCheckpointStore implements CheckpointStore {
+    private readonly run;
+    private readonly table;
+    constructor(run: SqlRun, options?: EventStoreTablesOptions);
+    position(subscriber: string): Promise<number>;
+    advance(subscriber: string, from: number, to: number): Promise<void>;
+}
+//# sourceMappingURL=postgres-checkpoint-store.d.ts.map