@ddd-ts-kit/kernel 0.8.0 → 0.10.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-checkpoint-store.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-checkpoint-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,uHAAuH;AACvH,qBAAa,uBAAwB,YAAW,eAAe;IAI3D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YACmB,GAAG,EAAE,MAAM,EAC5B,OAAO,GAAE,uBAA4B,EAGtC;IAEK,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlD;IAEK,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzE;CACF"}

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

@@ -0,0 +1,26 @@
+import { ConcurrencyError } from '../../../domain/errors/concurrency-error.js';
+import { qualifiedTable } from './qualified-table.js';
+/** The checkpoints of the subscriptions on PostgreSQL, moved by a statement guarded by the position it starts from. */
+export class PostgresCheckpointStore {
+    run;
+    table;
+    constructor(run, options = {}) {
+        this.run = run;
+        this.table = qualifiedTable(options.schema, 'checkpoints');
+    }
+    async position(subscriber) {
+        const [row] = await this.run(`select position from ${this.table} where subscriber = $1::text`, [subscriber]);
+        return Number(row?.['position'] ?? 0);
+    }
+    async advance(subscriber, from, to) {
+        const moved = from === 0
+            ? await this.run(`insert into ${this.table} as c (subscriber, position) values ($1::text, $2::bigint)
+on conflict (subscriber) do update set position = excluded.position, updated_at = now() where c.position = $3::bigint
+returning subscriber`, [subscriber, to, from])
+            : await this.run(`update ${this.table} set position = $1::bigint, updated_at = now() where subscriber = $2::text and position = $3::bigint returning subscriber`, [to, subscriber, from]);
+        if (moved.length === 0) {
+            throw new ConcurrencyError(subscriber);
+        }
+    }
+}
+//# sourceMappingURL=postgres-checkpoint-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-checkpoint-store.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-checkpoint-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,uHAAuH;AACvH,MAAM,OAAO,uBAAuB;IAIf,GAAG;IAHL,KAAK,CAAS;IAE/B,YACmB,GAAW,EAC5B,OAAO,GAA4B,EAAE;mBADpB,GAAG;QAGpB,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAkB;QAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,KAAK,8BAA8B,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAE7G,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,IAAY,EAAE,EAAU;QACxD,MAAM,KAAK,GACT,IAAI,KAAK,CAAC;YACR,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CACZ,eAAe,IAAI,CAAC,KAAK;;qBAEhB,EACT,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,CACvB;YACH,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CACZ,UAAU,IAAI,CAAC,KAAK,2HAA2H,EAC/I,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CACvB,CAAC;QAER,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,6 @@
+import type { SqlRun } from '../../read-model/sql-run.js';
+import type { EventSourcingStores } from '../event-sourcing-stores.js';
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/** The stores of event sourcing on PostgreSQL over the statements of an ORM adapter: what each adapter package hands out. */
+export declare function postgresEventSourcing(run: SqlRun, options?: EventStoreTablesOptions): EventSourcingStores;
+//# sourceMappingURL=postgres-event-sourcing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-event-sourcing.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-event-sourcing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAM/E,6HAA6H;AAC7H,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,mBAAmB,CAO7G"}

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

@@ -0,0 +1,14 @@
+import { PostgresCheckpointStore } from './postgres-checkpoint-store.js';
+import { PostgresEventStore } from './postgres-event-store.js';
+import { PostgresSnapshotStore } from './postgres-snapshot-store.js';
+import { PostgresSubjectKeyStore } from './postgres-subject-key-store.js';
+/** The stores of event sourcing on PostgreSQL over the statements of an ORM adapter: what each adapter package hands out. */
+export function postgresEventSourcing(run, options = {}) {
+    return {
+        events: new PostgresEventStore(run, options),
+        snapshots: new PostgresSnapshotStore(run, options),
+        checkpoints: new PostgresCheckpointStore(run, options),
+        subjectKeys: new PostgresSubjectKeyStore(run, options),
+    };
+}
+//# sourceMappingURL=postgres-event-sourcing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-event-sourcing.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-event-sourcing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,6HAA6H;AAC7H,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,OAAO,GAA4B,EAAE;IACtF,OAAO;QACL,MAAM,EAAE,IAAI,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC;QAC5C,SAAS,EAAE,IAAI,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC;QAClD,WAAW,EAAE,IAAI,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC;QACtD,WAAW,EAAE,IAAI,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC;KACvD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { Appended } from '../../../application/event-sourcing/appended.js';
+import type { EventToAppend } from '../../../application/event-sourcing/event-to-append.js';
+import type { StoredEvent } from '../../../application/event-sourcing/stored-event.js';
+import type { EventStore } from '../../../application/ports/event-store.js';
+import type { SqlRun } from '../../read-model/sql-run.js';
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/**
+ * The event store on PostgreSQL, shared by the ORM adapters, which differ only in how they run a
+ * statement. An append is one statement on the executor of the unit of work: it takes the head of
+ * the store, a row locked until the transaction ends, only when the stream still has the expected
+ * version, and inserts the events after it. Appends therefore commit in the order of their
+ * positions, and a subscription that read up to a position never meets a smaller one later; the
+ * price is that two appends never run side by side, whatever their streams. A conflict that slips
+ * between the check and the insert hits the unique (stream, version) and is a ConcurrencyError too,
+ * and so are a serialization failure (a unit of work at REPEATABLE READ or SERIALIZABLE) and a
+ * deadlock with row locks the same transaction took in another order: the caller retries.
+ */
+export declare class PostgresEventStore implements EventStore {
+    private readonly run;
+    private readonly events;
+    private readonly headRow;
+    constructor(run: SqlRun, options?: EventStoreTablesOptions);
+    append(stream: string, expectedVersion: number, events: readonly EventToAppend[]): Promise<Appended>;
+    readStream(stream: string, after?: number): Promise<readonly StoredEvent[]>;
+    readAll(after: number, limit: number): Promise<readonly StoredEvent[]>;
+    head(): Promise<number>;
+    private inserted;
+    private appendStatement;
+    private unchanged;
+}
+//# sourceMappingURL=postgres-event-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-event-store.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iDAAiD,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAE5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAa/E;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IAMjD,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,YACmB,GAAG,EAAE,MAAM,EAC5B,OAAO,GAAE,uBAA4B,EAItC;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiBzG;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAO3E;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAO3E;IAEK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAI5B;YAEa,QAAQ;IAYtB,OAAO,CAAC,eAAe;YAmBT,SAAS;CAYxB"}

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

@@ -0,0 +1,120 @@
+import { ConcurrencyError } from '../../../domain/errors/concurrency-error.js';
+import { isAppendConflict } from './is-append-conflict.js';
+import { qualifiedTable } from './qualified-table.js';
+import { storedDataFrom } from './stored-data-from.js';
+const COLUMNS = 'position, stream, version, event_id, type, schema_version, data, metadata, occurred_at';
+// The instant as UTC text: drivers disagree on the zone they read a timestamptz in.
+const SELECTED = `position, stream, version, event_id, type, schema_version, data, metadata,
+  to_char(occurred_at at time zone 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"') as occurred_at`;
+/**
+ * The event store on PostgreSQL, shared by the ORM adapters, which differ only in how they run a
+ * statement. An append is one statement on the executor of the unit of work: it takes the head of
+ * the store, a row locked until the transaction ends, only when the stream still has the expected
+ * version, and inserts the events after it. Appends therefore commit in the order of their
+ * positions, and a subscription that read up to a position never meets a smaller one later; the
+ * price is that two appends never run side by side, whatever their streams. A conflict that slips
+ * between the check and the insert hits the unique (stream, version) and is a ConcurrencyError too,
+ * and so are a serialization failure (a unit of work at REPEATABLE READ or SERIALIZABLE) and a
+ * deadlock with row locks the same transaction took in another order: the caller retries.
+ */
+export class PostgresEventStore {
+    run;
+    events;
+    headRow;
+    constructor(run, options = {}) {
+        this.run = run;
+        this.events = qualifiedTable(options.schema, 'events');
+        this.headRow = qualifiedTable(options.schema, 'head');
+    }
+    async append(stream, expectedVersion, events) {
+        if (events.length === 0) {
+            return this.unchanged(stream, expectedVersion);
+        }
+        await this.run(`insert into ${this.headRow} (id, position) values (1, 0) on conflict (id) do nothing`, []);
+        const inserted = await this.inserted(stream, expectedVersion, events);
+        if (inserted.length === 0) {
+            throw new ConcurrencyError(stream);
+        }
+        return {
+            version: Math.max(...inserted.map((row) => Number(row['version']))),
+            position: Math.max(...inserted.map((row) => Number(row['position']))),
+        };
+    }
+    async readStream(stream, after = 0) {
+        const rows = await this.run(`select ${SELECTED} from ${this.events} where stream = $1::text and version > $2::integer order by version`, [stream, after]);
+        return rows.map(storedEventOf);
+    }
+    async readAll(after, limit) {
+        const rows = await this.run(`select ${SELECTED} from ${this.events} where position > $1::bigint order by position limit $2::integer`, [after, limit]);
+        return rows.map(storedEventOf);
+    }
+    async head() {
+        const [row] = await this.run(`select position from ${this.headRow} where id = 1`, []);
+        return Number(row?.['position'] ?? 0);
+    }
+    async inserted(stream, expected, events) {
+        try {
+            return await this.run(this.appendStatement(), [stream, expected, JSON.stringify(events.map(recordOf))]);
+        }
+        catch (error) {
+            if (isAppendConflict(error)) {
+                throw new ConcurrencyError(stream);
+            }
+            throw error;
+        }
+    }
+    appendStatement() {
+        return `with input as (
+  select $1::text as stream, $2::integer as expected, $3::jsonb as events
+), held as (
+  select coalesce(max(e.version), 0) as version from ${this.events} e, input where e.stream = input.stream
+), moved as (
+  update ${this.headRow} h set position = h.position + jsonb_array_length(input.events)
+  from input, held
+  where h.id = 1 and held.version = input.expected
+  returning h.position - jsonb_array_length(input.events) as base
+)
+insert into ${this.events} (${COLUMNS})
+select moved.base + e.n, input.stream, input.expected + e.n, e.id, e.type, e.schema_version, e.data, e.metadata, e.occurred_at
+from moved, input, jsonb_to_recordset(input.events)
+  as e(n integer, id text, type text, schema_version integer, data jsonb, metadata jsonb, occurred_at timestamptz)
+order by e.n
+returning position, version`;
+    }
+    async unchanged(stream, expected) {
+        const [row] = await this.run(`select coalesce(max(version), 0) as version from ${this.events} where stream = $1::text`, [stream]);
+        if (Number(row?.['version'] ?? 0) !== expected) {
+            throw new ConcurrencyError(stream);
+        }
+        return { version: expected, position: await this.head() };
+    }
+}
+function recordOf(event, index) {
+    return {
+        n: index + 1,
+        id: event.id,
+        type: event.type,
+        schema_version: event.schemaVersion,
+        data: event.data,
+        metadata: event.metadata ?? {},
+        occurred_at: event.occurredAt.toISOString(),
+    };
+}
+function storedEventOf(row) {
+    const id = String(row['event_id']);
+    return {
+        id,
+        stream: String(row['stream']),
+        version: Number(row['version']),
+        position: Number(row['position']),
+        type: String(row['type']),
+        schemaVersion: Number(row['schema_version']),
+        data: storedDataFrom(row['data'], `The data of stored event ${id}`),
+        metadata: storedDataFrom(row['metadata'], `The metadata of stored event ${id}`),
+        occurredAt: instantOf(row['occurred_at']),
+    };
+}
+function instantOf(value) {
+    return value instanceof Date ? value : new Date(String(value));
+}
+//# sourceMappingURL=postgres-event-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-event-store.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-event-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,OAAO,GAAG,wFAAwF,CAAC;AAEzG,oFAAoF;AACpF,MAAM,QAAQ,GAAG;0FACyE,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAMV,GAAG;IALL,MAAM,CAAS;IAEf,OAAO,CAAS;IAEjC,YACmB,GAAW,EAC5B,OAAO,GAA4B,EAAE;mBADpB,GAAG;QAGpB,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,eAAuB,EAAE,MAAgC;QACpF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,OAAO,2DAA2D,EAAE,EAAE,CAAC,CAAC;QAE3G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QAEtE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACnE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,KAAK,GAAG,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,UAAU,QAAQ,SAAS,IAAI,CAAC,MAAM,qEAAqE,EAC3G,CAAC,MAAM,EAAE,KAAK,CAAC,CAChB,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,KAAa;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,UAAU,QAAQ,SAAS,IAAI,CAAC,MAAM,kEAAkE,EACxG,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,OAAO,eAAe,EAAE,EAAE,CAAC,CAAC;QAEtF,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,QAAgB,EAAE,MAAgC;QACvF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,OAAO;;;uDAG4C,IAAI,CAAC,MAAM;;WAEvD,IAAI,CAAC,OAAO;;;;;cAKT,IAAI,CAAC,MAAM,KAAK,OAAO;;;;;4BAKT,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,QAAgB;QACtD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAC1B,oDAAoD,IAAI,CAAC,MAAM,0BAA0B,EACzF,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5D,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAoB,EAAE,KAAa;IACnD,OAAO;QACL,CAAC,EAAE,KAAK,GAAG,CAAC;QACZ,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,cAAc,EAAE,KAAK,CAAC,aAAa;QACnC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAQ;IAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnC,OAAO;QACL,EAAE;QACF,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC5C,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,4BAA4B,EAAE,EAAE,CAAC;QACnE,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,gCAAgC,EAAE,EAAE,CAAC;QAC/E,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { StoredSnapshot } from '../../../application/event-sourcing/stored-snapshot.js';
+import type { SnapshotStore } from '../../../application/ports/snapshot-store.js';
+import type { SqlRun } from '../../read-model/sql-run.js';
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/** The snapshots of the streams on PostgreSQL: one row per stream, never replaced by an older version. */
+export declare class PostgresSnapshotStore implements SnapshotStore {
+    private readonly run;
+    private readonly table;
+    constructor(run: SqlRun, options?: EventStoreTablesOptions);
+    find(stream: string): Promise<StoredSnapshot | undefined>;
+    save(snapshot: StoredSnapshot): Promise<void>;
+}
+//# sourceMappingURL=postgres-snapshot-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-snapshot-store.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAI/E,0GAA0G;AAC1G,qBAAa,qBAAsB,YAAW,aAAa;IAIvD,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YACmB,GAAG,EAAE,MAAM,EAC5B,OAAO,GAAE,uBAA4B,EAGtC;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAc9D;IAEK,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlD;CACF"}

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

@@ -0,0 +1,28 @@
+import { qualifiedTable } from './qualified-table.js';
+import { storedDataFrom } from './stored-data-from.js';
+/** The snapshots of the streams on PostgreSQL: one row per stream, never replaced by an older version. */
+export class PostgresSnapshotStore {
+    run;
+    table;
+    constructor(run, options = {}) {
+        this.run = run;
+        this.table = qualifiedTable(options.schema, 'snapshots');
+    }
+    async find(stream) {
+        const [row] = await this.run(`select stream, version, schema_version, data from ${this.table} where stream = $1::text`, [stream]);
+        return row === undefined
+            ? undefined
+            : {
+                stream,
+                version: Number(row['version']),
+                schemaVersion: Number(row['schema_version']),
+                data: storedDataFrom(row['data'], `The snapshot of ${stream}`),
+            };
+    }
+    async save(snapshot) {
+        await this.run(`insert into ${this.table} as s (stream, version, schema_version, data) values ($1::text, $2::integer, $3::integer, $4::jsonb)
+on conflict (stream) do update set version = excluded.version, schema_version = excluded.schema_version, data = excluded.data, taken_at = now()
+where s.version < excluded.version`, [snapshot.stream, snapshot.version, snapshot.schemaVersion, JSON.stringify(snapshot.data)]);
+    }
+}
+//# sourceMappingURL=postgres-snapshot-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-snapshot-store.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-snapshot-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,0GAA0G;AAC1G,MAAM,OAAO,qBAAqB;IAIb,GAAG;IAHL,KAAK,CAAS;IAE/B,YACmB,GAAW,EAC5B,OAAO,GAA4B,EAAE;mBADpB,GAAG;QAGpB,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAC1B,qDAAqD,IAAI,CAAC,KAAK,0BAA0B,EACzF,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,OAAO,GAAG,KAAK,SAAS;YACtB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,MAAM;gBACN,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC/B,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBAC5C,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,mBAAmB,MAAM,EAAE,CAAC;aAC/D,CAAC;IACR,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAwB;QACjC,MAAM,IAAI,CAAC,GAAG,CACZ,eAAe,IAAI,CAAC,KAAK;;mCAEI,EAC7B,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAC3F,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import type { SubjectKey } from '../../../application/event-sourcing/subject-key.js';
+import type { SubjectKeyStore } from '../../../application/ports/subject-key-store.js';
+import type { SqlRun } from '../../read-model/sql-run.js';
+import type { EventStoreTablesOptions } from './event-store-tables-options.js';
+/**
+ * The keys of the data subjects on PostgreSQL: one row per subject, deleted by an erasure. A
+ * deleted row is gone from the table at once, and from the backups as they expire. In the
+ * database of the events, a backup older than an erasure holds both the sealed values and their
+ * key: in production give this store a `SqlRun` of another database, backed up with a shorter
+ * retention than the events.
+ */
+export declare class PostgresSubjectKeyStore implements SubjectKeyStore {
+    private readonly run;
+    private readonly table;
+    constructor(run: SqlRun, options?: EventStoreTablesOptions);
+    keyFor(subject: string): Promise<SubjectKey>;
+    find(keyId: string): Promise<SubjectKey | undefined>;
+    erase(subject: string): Promise<boolean>;
+    private held;
+}
+//# sourceMappingURL=postgres-subject-key-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-subject-key-store.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-subject-key-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAK/E;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAI3D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YACmB,GAAG,EAAE,MAAM,EAC5B,OAAO,GAAE,uBAA4B,EAGtC;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBjD;IAEK,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAMzD;IAEK,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI7C;YAEa,IAAI;CAOnB"}

package/dist/infrastructure/event-sourcing/postgres/postgres-subject-key-store.js

@@ -0,0 +1,48 @@
+import { randomBytes, randomUUID } from 'node:crypto';
+import { qualifiedTable } from './qualified-table.js';
+/**
+ * The keys of the data subjects on PostgreSQL: one row per subject, deleted by an erasure. A
+ * deleted row is gone from the table at once, and from the backups as they expire. In the
+ * database of the events, a backup older than an erasure holds both the sealed values and their
+ * key: in production give this store a `SqlRun` of another database, backed up with a shorter
+ * retention than the events.
+ */
+export class PostgresSubjectKeyStore {
+    run;
+    table;
+    constructor(run, options = {}) {
+        this.run = run;
+        this.table = qualifiedTable(options.schema, 'subjectKeys');
+    }
+    async keyFor(subject) {
+        const held = await this.held(subject);
+        if (held !== undefined) {
+            return held;
+        }
+        await this.run(`insert into ${this.table} (subject, key_id, material) values ($1::text, $2::text, $3::text) on conflict (subject) do nothing`, [subject, randomUUID(), randomBytes(32).toString('base64')]);
+        const created = await this.held(subject);
+        if (created === undefined) {
+            throw new TypeError(`The key of ${subject} was erased while it was being created`);
+        }
+        return created;
+    }
+    async find(keyId) {
+        const [row] = await this.run(`select subject, key_id, material from ${this.table} where key_id = $1::text`, [
+            keyId,
+        ]);
+        return row === undefined ? undefined : keyOf(row);
+    }
+    async erase(subject) {
+        return ((await this.run(`delete from ${this.table} where subject = $1::text returning subject`, [subject])).length > 0);
+    }
+    async held(subject) {
+        const [row] = await this.run(`select subject, key_id, material from ${this.table} where subject = $1::text`, [
+            subject,
+        ]);
+        return row === undefined ? undefined : keyOf(row);
+    }
+}
+function keyOf(row) {
+    return { id: String(row['key_id']), subject: String(row['subject']), material: String(row['material']) };
+}
+//# sourceMappingURL=postgres-subject-key-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-subject-key-store.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/postgres-subject-key-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAIf,GAAG;IAHL,KAAK,CAAS;IAE/B,YACmB,GAAW,EAC5B,OAAO,GAA4B,EAAE;mBADpB,GAAG;QAGpB,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CACZ,eAAe,IAAI,CAAC,KAAK,qGAAqG,EAC9H,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAC5D,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,cAAc,OAAO,wCAAwC,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,yCAAyC,IAAI,CAAC,KAAK,0BAA0B,EAAE;YAC1G,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,OAAO,CACL,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,KAAK,6CAA6C,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAC/G,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAe;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,yCAAyC,IAAI,CAAC,KAAK,2BAA2B,EAAE;YAC3G,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;CACF;AAED,SAAS,KAAK,CAAC,GAAQ;IACrB,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;AAC3G,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/qualified-table.d.ts

@@ -0,0 +1,4 @@
+import { EVENT_STORE_TABLES } from './event-store-tables.js';
+/** A table of the event store, quoted and in its schema when it has one. */
+export declare function qualifiedTable(schema: string | undefined, table: keyof typeof EVENT_STORE_TABLES): string;
+//# sourceMappingURL=qualified-table.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/qualified-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-table.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/qualified-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,OAAO,kBAAkB,GAAG,MAAM,CAIzG"}

package/dist/infrastructure/event-sourcing/postgres/qualified-table.js

@@ -0,0 +1,10 @@
+import { EVENT_STORE_TABLES } from './event-store-tables.js';
+/** A table of the event store, quoted and in its schema when it has one. */
+export function qualifiedTable(schema, table) {
+    const name = quoted(EVENT_STORE_TABLES[table]);
+    return schema === undefined ? name : `${quoted(schema)}.${name}`;
+}
+function quoted(identifier) {
+    return `"${identifier.replaceAll('"', '""')}"`;
+}
+//# sourceMappingURL=qualified-table.js.map

package/dist/infrastructure/event-sourcing/postgres/qualified-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-table.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/qualified-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,MAA0B,EAAE,KAAsC;IAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE/C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,MAAM,CAAC,UAAkB;IAChC,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC"}

package/dist/infrastructure/event-sourcing/postgres/stored-data-from.d.ts

@@ -0,0 +1,4 @@
+import type { StoredData } from '../../../application/event-sourcing/stored-data.js';
+/** A `jsonb` column as the driver answered it, parsed when it came back as text, checked to be a JSON object. */
+export declare function storedDataFrom(value: unknown, where: string): StoredData;
+//# sourceMappingURL=stored-data-from.d.ts.map

package/dist/infrastructure/event-sourcing/postgres/stored-data-from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-data-from.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/stored-data-from.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAIrF,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAQxE"}

package/dist/infrastructure/event-sourcing/postgres/stored-data-from.js

@@ -0,0 +1,23 @@
+import { UnreadableEventError } from '../../../application/event-sourcing/unreadable-event-error.js';
+/** A `jsonb` column as the driver answered it, parsed when it came back as text, checked to be a JSON object. */
+export function storedDataFrom(value, where) {
+    const parsed = typeof value === 'string' ? JSON.parse(value) : value;
+    if (!isJsonObject(parsed)) {
+        throw new UnreadableEventError(`${where} is not a JSON object`);
+    }
+    return parsed;
+}
+function isJsonObject(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return (prototype === Object.prototype || prototype === null) && Object.values(value).every(isJson);
+}
+function isJson(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') {
+        return true;
+    }
+    return Array.isArray(value) ? value.every(isJson) : isJsonObject(value);
+}
+//# sourceMappingURL=stored-data-from.js.map

package/dist/infrastructure/event-sourcing/postgres/stored-data-from.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-data-from.js","sourceRoot":"","sources":["../../../../src/infrastructure/event-sourcing/postgres/stored-data-from.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AAErG,iHAAiH;AACjH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAa;IAC1D,MAAM,MAAM,GAAY,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE9E,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAExD,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3G,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/infrastructure/event-sourcing/rewrite-objects.d.ts

@@ -0,0 +1,8 @@
+import type { StoredData } from '../../application/event-sourcing/stored-data.js';
+import type { StoredJson } from '../../application/event-sourcing/stored-json.js';
+/** Answers what replaces an object of the data, or `undefined` to keep it and look inside. */
+type Rewrite = (object: StoredData) => Promise<StoredJson> | undefined;
+/** A copy of the data where `rewrite` replaced the objects it recognised, at any depth. */
+export declare function rewriteObjects(data: StoredData, rewrite: Rewrite): Promise<StoredData>;
+export {};
+//# sourceMappingURL=rewrite-objects.d.ts.map

package/dist/infrastructure/event-sourcing/rewrite-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-objects.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/rewrite-objects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAElF,8FAA8F;AAC9F,KAAK,OAAO,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;AAEvE,2FAA2F;AAC3F,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAM5F"}

package/dist/infrastructure/event-sourcing/rewrite-objects.js

@@ -0,0 +1,16 @@
+import { isStoredData } from '../../application/event-sourcing/is-stored-data.js';
+/** A copy of the data where `rewrite` replaced the objects it recognised, at any depth. */
+export async function rewriteObjects(data, rewrite) {
+    const entries = await Promise.all(Object.entries(data).map(async ([key, value]) => [key, await rewritten(value, rewrite)]));
+    return Object.fromEntries(entries);
+}
+async function rewritten(value, rewrite) {
+    if (Array.isArray(value)) {
+        return Promise.all(value.map((item) => rewritten(item, rewrite)));
+    }
+    if (!isStoredData(value)) {
+        return value;
+    }
+    return (await rewrite(value)) ?? rewriteObjects(value, rewrite);
+}
+//# sourceMappingURL=rewrite-objects.js.map

package/dist/infrastructure/event-sourcing/rewrite-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-objects.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/rewrite-objects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAOlF,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAgB,EAAE,OAAgB;IACrE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAU,CAAC,CAClG,CAAC;IAEF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAiB,EAAE,OAAgB;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/infrastructure/event-sourcing/snapshot-policy.d.ts

@@ -0,0 +1,14 @@
+import type { StoredEventData } from '../../application/event-sourcing/stored-event-data.js';
+import type { SnapshotStore } from '../../application/ports/snapshot-store.js';
+/** When and how an event-sourced repository keeps snapshots of its aggregates: a choice per aggregate. */
+export interface SnapshotPolicy<A, S> {
+    readonly store: SnapshotStore;
+    /** A snapshot is taken by the save that makes the stream reach a multiple of this many events. */
+    readonly every: number;
+    /** The version of the shape `encode` writes: a snapshot of another version is ignored, the stream replayed from its start. */
+    readonly version: number;
+    /** The state to keep, as plain data. */
+    encode(aggregate: A): object;
+    decode(data: StoredEventData): S;
+}
+//# sourceMappingURL=snapshot-policy.d.ts.map

package/dist/infrastructure/event-sourcing/snapshot-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-policy.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/snapshot-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,0GAA0G;AAC1G,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8HAA8H;IAC9H,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7B,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,CAAC,CAAC;CAClC"}

package/dist/infrastructure/event-sourcing/snapshot-policy.js

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

package/dist/infrastructure/event-sourcing/snapshot-policy.js.map

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

package/dist/infrastructure/event-sourcing/stored-origins.d.ts

@@ -0,0 +1,5 @@
+import type { StoredEvent } from '../../application/event-sourcing/stored-event.js';
+import type { DomainEvent } from '../../domain/domain-event.js';
+/** The stored event each domain event was read from, for `storedStampOf`. */
+export declare const storedOrigins: WeakMap<DomainEvent, StoredEvent>;
+//# sourceMappingURL=stored-origins.d.ts.map

package/dist/infrastructure/event-sourcing/stored-origins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-origins.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/stored-origins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,6EAA6E;AAC7E,eAAO,MAAM,aAAa,mCAA0C,CAAC"}

package/dist/infrastructure/event-sourcing/stored-origins.js

@@ -0,0 +1,3 @@
+/** The stored event each domain event was read from, for `storedStampOf`. */
+export const storedOrigins = new WeakMap();
+//# sourceMappingURL=stored-origins.js.map

package/dist/infrastructure/event-sourcing/stored-origins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-origins.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/stored-origins.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,EAA4B,CAAC"}

package/dist/infrastructure/event-sourcing/stored-stamp-of.d.ts

@@ -0,0 +1,10 @@
+import type { EventStamp } from '../../application/read-model/event-stamp.js';
+import type { DomainEvent } from '../../domain/domain-event.js';
+/**
+ * The stamp of a domain event read from an event store, for the row of a read model it changes:
+ * the id of the stored event, its instant and its version in its stream, so that the rows of one
+ * stream are ordered by the stream and not by clocks. `undefined` for an event that was not read
+ * from a store (dispatched by a save): a projection fed both ways falls back to `stampOf`.
+ */
+export declare function storedStampOf(event: DomainEvent): EventStamp | undefined;
+//# sourceMappingURL=stored-stamp-of.d.ts.map

package/dist/infrastructure/event-sourcing/stored-stamp-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-stamp-of.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/stored-stamp-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAMxE"}

package/dist/infrastructure/event-sourcing/stored-stamp-of.js

@@ -0,0 +1,14 @@
+import { storedOrigins } from './stored-origins.js';
+/**
+ * The stamp of a domain event read from an event store, for the row of a read model it changes:
+ * the id of the stored event, its instant and its version in its stream, so that the rows of one
+ * stream are ordered by the stream and not by clocks. `undefined` for an event that was not read
+ * from a store (dispatched by a save): a projection fed both ways falls back to `stampOf`.
+ */
+export function storedStampOf(event) {
+    const stored = storedOrigins.get(event);
+    return stored === undefined
+        ? undefined
+        : { eventId: stored.id, occurredAt: stored.occurredAt, version: stored.version };
+}
+//# sourceMappingURL=stored-stamp-of.js.map

package/dist/infrastructure/event-sourcing/stored-stamp-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-stamp-of.js","sourceRoot":"","sources":["../../../src/infrastructure/event-sourcing/stored-stamp-of.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAExC,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACrF,CAAC"}

package/dist/infrastructure/files/accept-every-file-scanner.d.ts

@@ -0,0 +1,7 @@
+import type { ScanVerdict } from '../../application/files/scan-verdict.js';
+import type { FileScanner } from '../../application/ports/file-scanner.js';
+/** The scanner of a project that has none yet: accepts every file without reading it. Bind a real one before accepting files from strangers. */
+export declare class AcceptEveryFileScanner implements FileScanner {
+    scan(): Promise<ScanVerdict>;
+}
+//# sourceMappingURL=accept-every-file-scanner.d.ts.map

package/dist/infrastructure/files/accept-every-file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept-every-file-scanner.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/files/accept-every-file-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,gJAAgJ;AAChJ,qBAAa,sBAAuB,YAAW,WAAW;IACxD,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3B;CACF"}

package/dist/infrastructure/files/accept-every-file-scanner.js

@@ -0,0 +1,7 @@
+/** The scanner of a project that has none yet: accepts every file without reading it. Bind a real one before accepting files from strangers. */
+export class AcceptEveryFileScanner {
+    scan() {
+        return Promise.resolve({ accepted: true });
+    }
+}
+//# sourceMappingURL=accept-every-file-scanner.js.map

package/dist/infrastructure/files/accept-every-file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept-every-file-scanner.js","sourceRoot":"","sources":["../../../src/infrastructure/files/accept-every-file-scanner.ts"],"names":[],"mappings":"AAGA,gJAAgJ;AAChJ,MAAM,OAAO,sBAAsB;IACjC,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/infrastructure/files/collect.d.ts

@@ -0,0 +1,4 @@
+import { Writable } from 'node:stream';
+/** The end of a pipeline that keeps every chunk: for the storage of the tests only. */
+export declare function collect(chunks: Buffer[]): Writable;
+//# sourceMappingURL=collect.d.ts.map

package/dist/infrastructure/files/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/files/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAOlD"}

package/dist/infrastructure/files/collect.js

@@ -0,0 +1,11 @@
+import { Writable } from 'node:stream';
+/** The end of a pipeline that keeps every chunk: for the storage of the tests only. */
+export function collect(chunks) {
+    return new Writable({
+        write(chunk, _encoding, done) {
+            chunks.push(chunk);
+            done();
+        },
+    });
+}
+//# sourceMappingURL=collect.js.map