@ddd-ts-kit/kernel 0.9.0 → 0.10.0

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

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":"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"}

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"}