@photon-grove/evt 0.1.1 → 0.1.2

package/dist/postgres/repository.js

@@ -0,0 +1,527 @@
+// The PostgreSQL repository: events in one table keyed by (entity_id, sequence), snapshots in a
+// second keyed by entity_id, and the engine rows (the feature marker, the rebuild fence, the
+// stream heads) in tables derived from the events table's name (storage format, "PostgreSQL").
+// Every commit is one READ COMMITTED transaction that runs the statements Go and Rust run, in
+// their order: the entity lock, the feature-marker check under its shared lock, the rebuild-lock
+// assertion under its own, the head statement, the event inserts, then the snapshot upsert.
+//
+// Each statement of a transaction needs the one before it, so they await in loops on purpose.
+/* oxlint-disable no-await-in-loop */
+import { CompactionUncoveredError, ConflictError, EvtError, HistoryDependentProjectionError, RebuildInProgressError, SequenceGapError, StreamHeadDriftError, StreamHeadsNotMigratedError, TransientError, } from '../errors.js';
+import { checkSupported, checkWritable, declaresStreamHeads, decodeManifest, encodeManifest, withStreamHeads, } from '../features.js';
+import { int64Argument } from '../fields.js';
+import { decodeMetadata, emptyMetadata, encodeMetadata } from '../metadata.js';
+import { checkBudget, checkNotReserved, commitSizes, validateCommit, } from '../repository.js';
+import { ENGINE_LOCK_EXCLUSIVE, ENGINE_LOCK_SHARED, ENTITY_LOCK, SCHEMA_LOCK, featuresLockKey, featuresTable, pgTables, rebuildGenerationTable, rebuildLockKey, rebuildLockTable, schemaDdl, streamHeadsTable, } from './schema.js';
+/** The backend name a projector group for the PostgreSQL repository would carry. */
+export const POSTGRES_BACKEND = 'postgres';
+// The event columns every read selects, each as text, so no driver parses a stored value.
+const EVENT_COLUMNS = 'event_id, sequence::text AS sequence, event_type, version::text AS version, entity_id, ' +
+    "entity_type, encode(payload, 'hex') AS payload, metadata::text AS metadata";
+// SQLSTATEs for which PostgreSQL rolled the transaction back and a retry may not hit again: a
+// serialization failure and a detected deadlock.
+const TRANSIENT_STATES = new Set(['40001', '40P01']);
+/**
+ * A {@link Repository} on PostgreSQL, through any client shaped like `pg`'s `Pool`
+ * ({@link PgClient}).
+ *
+ * Run {@link PgRepository.ensureSchema} once before the first write. A writer initializes a fresh
+ * store itself on its first write, as Go's and Rust's do: the check is two `EXISTS` probes under
+ * the lock it takes anyway. {@link PgRepository.initialize} is for a deploy step that treats every
+ * backend alike.
+ *
+ * The repository validates the store's feature manifest at its first write and caches the version
+ * it validated. Every commit and snapshot write reads the manifest again under a shared lock that
+ * no declaration can take while the write is open, and validates it again when it changed.
+ */
+export class PgRepository {
+    #client;
+    #tables;
+    // The manifest version this writer validated, or null until it validates.
+    #validated = null;
+    // Whether the rebuild-lock table exists, which a commit's assertion probes for until it does.
+    #rebuildReady = false;
+    /**
+     * Takes the client and the table names, which must be plain identifiers that fit their limits
+     * ({@link pgTables}), or the constructor fails with `invalidArgument`.
+     */
+    constructor(client, options = {}) {
+        this.#client = client;
+        this.#tables = pgTables(options.eventsTable, options.snapshotsTable);
+    }
+    /** The tables this repository reads and writes, folded to lower case. */
+    get tables() {
+        return this.#tables;
+    }
+    /**
+     * Creates the event log's tables if they don't exist, with the DDL Go and Rust run
+     * ({@link schemaDdl}), under the schema lock they take. Safe to call on every start.
+     */
+    async ensureSchema(options) {
+        await this.#transaction(options, async (run) => {
+            await run(SCHEMA_LOCK, [this.#tables.events]);
+            for (const statement of statements(schemaDdl(this.#tables))) {
+                await run(statement);
+            }
+        });
+    }
+    /**
+     * Declares stream-heads on a store whose events and snapshots tables are empty, under the
+     * manifest's exclusive lock, and resolves `true` when this call declared it. A store that
+     * already declares it is left alone. Run {@link PgRepository.ensureSchema} first.
+     */
+    async initialize(options) {
+        try {
+            return await this.#transaction(options, async (run) => {
+                await run(ENGINE_LOCK_EXCLUSIVE, [featuresLockKey(this.#tables)]);
+                const manifest = await this.#readManifest(run);
+                checkSupported(manifest);
+                if (declaresStreamHeads(manifest)) {
+                    return false;
+                }
+                const { events, snapshots } = this.#tables;
+                const populated = await run(`SELECT 1 WHERE EXISTS (SELECT 1 FROM ${events}) OR EXISTS (SELECT 1 FROM ${snapshots})`);
+                if (populated.length > 0) {
+                    throw new StreamHeadsNotMigratedError();
+                }
+                await this.#writeManifest(run, manifest, withStreamHeads(manifest));
+                return true;
+            });
+        }
+        finally {
+            // A declaration moved the version: the next write reads it again.
+            this.#validated = null;
+        }
+    }
+    async commit(commit, options) {
+        options?.signal?.throwIfAborted();
+        validateCommit(commit);
+        checkNotReserved(commit.entityId);
+        if (commit.events.length === 0) {
+            return;
+        }
+        for (const group of commit.projections ?? []) {
+            if (group.backend !== POSTGRES_BACKEND || group.operations.length > 0) {
+                throw new EvtError('invalidCommit', `invalid commit: a PostgreSQL repository can't write a ${group.backend} projector group`);
+            }
+        }
+        // Every backend budgets a commit the same way, so an oversized one fails before any request.
+        checkBudget(commitSizes(commit, () => undefined));
+        await this.#ensureStreamHeads(options);
+        const { entityId, events } = commit;
+        const first = events[0].sequence;
+        const last = events.at(-1).sequence;
+        await this.#transaction(options, async (run) => {
+            await run(ENTITY_LOCK, [entityId]);
+            await this.#checkManifest(run);
+            await this.#assertNoRebuildLock(run);
+            if (!(await this.#moveHead(run, entityId, events[0].entityType, first, last))) {
+                throw await this.#probe(run, entityId, first);
+            }
+            for (const event of events) {
+                if (!(await this.#insertEvent(run, event))) {
+                    // The head statement passed and the row exists: an event sits above the head. The
+                    // entity lock rules out a racing writer.
+                    throw drift(entityId, first - 1n, await this.#derivedHead(run, entityId));
+                }
+            }
+            const snapshot = commit.snapshot;
+            if (snapshot) {
+                const rows = await run(`SELECT sequence::text AS sequence FROM ${this.#tables.snapshots} WHERE entity_id = $1`, [entityId]);
+                const stored = rows[0] === undefined ? null : BigInt(text(rows[0], 'sequence'));
+                if (stored === null && snapshot.sequence !== 1n) {
+                    throw new ConflictError(entityId, `snapshot sequence ${snapshot.sequence} has no stored predecessor`);
+                }
+                if (stored !== null && snapshot.sequence !== stored + 1n) {
+                    throw new ConflictError(entityId, `snapshot sequence moved: stored ${stored}, commit writes ${snapshot.sequence}`);
+                }
+                await this.#upsertSnapshot(run, { ...snapshot, entityId, eventSequence: last });
+            }
+        });
+    }
+    async events(entityId, options) {
+        options?.signal?.throwIfAborted();
+        const rows = await this.#read(`SELECT ${EVENT_COLUMNS} FROM ${this.#tables.events} WHERE entity_id = $1 ` +
+            'ORDER BY sequence ASC', [entityId]);
+        return rows.map(eventFromRow);
+    }
+    async eventsAfter(entityId, after, options) {
+        options?.signal?.throwIfAborted();
+        int64Argument(after, 'after');
+        const rows = await this.#read(`SELECT ${EVENT_COLUMNS} FROM ${this.#tables.events} ` +
+            'WHERE entity_id = $1 AND sequence > $2::bigint ORDER BY sequence ASC', [entityId, after.toString()]);
+        return rows.map(eventFromRow);
+    }
+    async latest(entityId, n, options) {
+        options?.signal?.throwIfAborted();
+        if (!Number.isSafeInteger(n) || n < 1) {
+            throw new EvtError('invalidArgument', `latest(n) requires a whole number of at least one event: got n = ${n}`);
+        }
+        const rows = await this.#read(`SELECT ${EVENT_COLUMNS} FROM ${this.#tables.events} WHERE entity_id = $1 ` +
+            'ORDER BY sequence DESC LIMIT $2::bigint', [entityId, n.toString()]);
+        return rows.map(eventFromRow);
+    }
+    async snapshot(entityId, options) {
+        options?.signal?.throwIfAborted();
+        const rows = await this.#read('SELECT entity_type, entity_id, sequence::text AS sequence, ' +
+            "event_sequence::text AS event_sequence, encode(payload, 'hex') AS payload " +
+            `FROM ${this.#tables.snapshots} WHERE entity_id = $1`, [entityId]);
+        return rows[0] === undefined ? null : snapshotFromRow(rows[0]);
+    }
+    async putSnapshot(snapshot, options) {
+        options?.signal?.throwIfAborted();
+        checkNotReserved(snapshot.entityId);
+        int64Argument(snapshot.sequence, 'snapshot.sequence');
+        const eventSequence = int64Argument(snapshot.eventSequence, 'snapshot.eventSequence');
+        await this.#ensureStreamHeads(options);
+        return this.#transaction(options, async (run) => {
+            const { entityId } = snapshot;
+            await run(ENTITY_LOCK, [entityId]);
+            await this.#checkManifest(run);
+            // The head must cover the snapshot. A snapshot of an empty stream needs no head. The entity
+            // lock holds the head steady.
+            const head = await this.#storedHead(run, entityId);
+            if (eventSequence > 0n && head < eventSequence) {
+                const derived = await this.#derivedHead(run, entityId);
+                throw drift(entityId, head, derived > eventSequence ? derived : eventSequence);
+            }
+            return this.#upsertSnapshot(run, snapshot);
+        });
+    }
+    async compactBelow(entityId, through, options) {
+        options?.signal?.throwIfAborted();
+        checkNotReserved(entityId);
+        if (int64Argument(through, 'through') < 1n) {
+            return 0;
+        }
+        // One transaction under the manifest's shared lock, held through the delete, so no
+        // declaration lands between the check and the delete it authorizes. It never declares
+        // stream-heads, and never touches the head.
+        return this.#transaction(options, async (run) => {
+            await run(ENGINE_LOCK_SHARED, [featuresLockKey(this.#tables)]);
+            const manifest = await this.#readManifest(run);
+            checkWritable(manifest);
+            const rows = await run('SELECT entity_type, event_sequence::text AS event_sequence ' +
+                `FROM ${this.#tables.snapshots} WHERE entity_id = $1`, [entityId]);
+            const covered = rows[0] === undefined ? null : BigInt(text(rows[0], 'event_sequence'));
+            if (covered === null || covered < through) {
+                throw new CompactionUncoveredError(entityId, through, covered);
+            }
+            const entityType = text(rows[0], 'entity_type');
+            if (manifest.historyDependent.includes(entityType)) {
+                throw new HistoryDependentProjectionError(entityType, entityId);
+            }
+            const deleted = await run(`WITH deleted AS (DELETE FROM ${this.#tables.events} ` +
+                'WHERE entity_id = $1 AND sequence >= 1 AND sequence <= $2::bigint RETURNING 1) ' +
+                'SELECT count(*)::text AS deleted FROM deleted', [entityId, through.toString()]);
+            return Number(text(deleted[0], 'deleted'));
+        });
+    }
+    // Makes sure the store is ready for this writer's first write: it declares stream-heads. A
+    // writer initializes a store whose manifest lacks it, which refuses one that holds data. It runs
+    // before the write's transaction, which holds the shared lock a declaration would wait for.
+    async #ensureStreamHeads(options) {
+        if (this.#validated !== null) {
+            return;
+        }
+        const manifest = await this.#readManifest((statement, values) => this.#read(statement, values));
+        checkSupported(manifest);
+        if (!declaresStreamHeads(manifest)) {
+            await this.initialize(options);
+        }
+    }
+    // The commit-time marker check, under the manifest's shared lock held to COMMIT, so a
+    // declaration can't slip between the check and the write. A manifest that changed since this
+    // writer validated it is validated again.
+    async #checkManifest(run) {
+        await run(ENGINE_LOCK_SHARED, [featuresLockKey(this.#tables)]);
+        const manifest = await this.#readManifest(run);
+        if (manifest !== null && manifest.version === this.#validated) {
+            return;
+        }
+        this.#validated = null;
+        checkWritable(manifest);
+        this.#validated = manifest.version;
+    }
+    // The commit-time rebuild-lock assertion, under the rebuild fence's shared lock held to COMMIT:
+    // a lock row, an expired one included, or an odd generation refuses the commit. A schema older
+    // than the fence has no lock table, and nobody can have taken the lock.
+    async #assertNoRebuildLock(run) {
+        await run(ENGINE_LOCK_SHARED, [rebuildLockKey(this.#tables)]);
+        const lock = rebuildLockTable(this.#tables);
+        if (!this.#rebuildReady) {
+            if ((await run('SELECT 1 WHERE to_regclass($1) IS NOT NULL', [lock])).length === 0) {
+                return;
+            }
+            this.#rebuildReady = true;
+        }
+        const generation = rebuildGenerationTable(this.#tables);
+        const held = await run(`SELECT 1 WHERE EXISTS (SELECT 1 FROM ${lock} WHERE id = 0) ` +
+            `OR EXISTS (SELECT 1 FROM ${generation} WHERE id = 0 AND value % 2 <> 0)`);
+        if (held.length > 0) {
+            throw new RebuildInProgressError();
+        }
+    }
+    // The stream's head statement: a create inserts its head row, an append moves it from the
+    // sequence before the commit's first. It passes when it wrote one row.
+    async #moveHead(run, entityId, entityType, first, last) {
+        const heads = streamHeadsTable(this.#tables);
+        const rows = first <= 1n
+            ? await run(`INSERT INTO ${heads} (entity_id, entity_type, head) VALUES ($1, $2, $3::bigint) ` +
+                'ON CONFLICT (entity_id) DO NOTHING RETURNING 1', [entityId, entityType, last.toString()])
+            : await run(`UPDATE ${heads} SET head = $3::bigint WHERE entity_id = $1 AND head = $2::bigint ` +
+                'RETURNING 1', [entityId, (first - 1n).toString(), last.toString()]);
+        return rows.length === 1;
+    }
+    // Classifies a failed head statement under the stream's lock, as Go and Rust do: a stored head
+    // below the head the log derives is drift, an equal one leaves a gap or a conflict, and one
+    // above it is drift unless deriving again catches up with it.
+    async #probe(run, entityId, first) {
+        const derived = await this.#derivedHead(run, entityId);
+        const stored = await this.#storedHead(run, entityId);
+        if (stored < derived) {
+            return drift(entityId, stored, derived);
+        }
+        if (stored > derived) {
+            const again = await this.#derivedHead(run, entityId);
+            return again < stored ? drift(entityId, stored, again) : conflict(entityId);
+        }
+        if (stored < first - 1n) {
+            return new SequenceGapError(entityId, stored, first);
+        }
+        return conflict(entityId);
+    }
+    // The stream's stored head, 0 when it has no head row.
+    async #storedHead(run, entityId) {
+        const rows = await run(`SELECT head::text AS head FROM ${streamHeadsTable(this.#tables)} WHERE entity_id = $1`, [entityId]);
+        return rows[0] === undefined ? 0n : BigInt(text(rows[0], 'head'));
+    }
+    // The head the stream's log derives: the higher of its last event and its snapshot's event
+    // sequence.
+    async #derivedHead(run, entityId) {
+        const { events, snapshots } = this.#tables;
+        const rows = await run('SELECT GREATEST(' +
+            `COALESCE((SELECT MAX(sequence) FROM ${events} WHERE entity_id = $1), 0), ` +
+            `COALESCE((SELECT MAX(event_sequence) FROM ${snapshots} WHERE entity_id = $1), 0)` +
+            ')::text AS head', [entityId]);
+        return BigInt(text(rows[0], 'head'));
+    }
+    // Inserts one event row, and reports whether it was written: false when its sequence exists.
+    async #insertEvent(run, event) {
+        const rows = await run(`INSERT INTO ${this.#tables.events} ` +
+            '(entity_id, sequence, event_id, event_type, version, entity_type, payload, metadata) ' +
+            "VALUES ($1, $2::bigint, $3, $4, $5::bigint, $6, decode($7, 'hex'), $8::text::jsonb) " +
+            'ON CONFLICT (entity_id, sequence) DO NOTHING RETURNING 1', [
+            event.entityId,
+            event.sequence.toString(),
+            event.id,
+            event.type,
+            event.version.toString(),
+            event.entityType,
+            hex(event.payload),
+            encodeMetadata(event.metadata),
+        ]);
+        return rows.length === 1;
+    }
+    // Writes a snapshot unless a newer one is stored, and reports whether it wrote.
+    async #upsertSnapshot(run, snapshot) {
+        const table = this.#tables.snapshots;
+        const rows = await run(`INSERT INTO ${table} ` +
+            '(entity_id, entity_type, sequence, event_sequence, payload, updated_at) ' +
+            "VALUES ($1, $2, $3::bigint, $4::bigint, decode($5, 'hex'), now()) " +
+            'ON CONFLICT (entity_id) DO UPDATE SET entity_type = EXCLUDED.entity_type, ' +
+            'sequence = EXCLUDED.sequence, event_sequence = EXCLUDED.event_sequence, ' +
+            'payload = EXCLUDED.payload, updated_at = now() ' +
+            `WHERE EXCLUDED.event_sequence >= ${table}.event_sequence RETURNING 1`, [
+            snapshot.entityId,
+            snapshot.entityType,
+            snapshot.sequence.toString(),
+            snapshot.eventSequence.toString(),
+            hex(snapshot.payload),
+        ]);
+        return rows.length === 1;
+    }
+    // The manifest row, or null when the store has none. A store older than the marker has no
+    // marker table: the probe doesn't name it, since a failed statement would abort the transaction.
+    async #readManifest(run) {
+        const table = featuresTable(this.#tables);
+        if ((await run('SELECT 1 WHERE to_regclass($1) IS NOT NULL', [table])).length === 0) {
+            return null;
+        }
+        const rows = await run('SELECT version::text AS version, features, history_dependent, retention ' +
+            `FROM ${table} WHERE id = 0`);
+        const row = rows[0];
+        if (row === undefined) {
+            return null;
+        }
+        return decodeManifest(BigInt(text(row, 'version')), {
+            features: text(row, 'features'),
+            historyDependent: text(row, 'history_dependent'),
+            retention: text(row, 'retention'),
+        });
+    }
+    // Writes the next manifest over the stored one, which the caller read under the exclusive lock.
+    async #writeManifest(run, stored, next) {
+        const table = featuresTable(this.#tables);
+        const texts = encodeManifest(next);
+        const { features, historyDependent, retention } = texts;
+        const values = [next.version.toString(), features, historyDependent, retention];
+        const rows = stored === null
+            ? await run(`INSERT INTO ${table} (id, version, features, history_dependent, retention) ` +
+                'VALUES (0, $1::bigint, $2, $3, $4) RETURNING 1', values)
+            : await run(`UPDATE ${table} SET version = $1::bigint, features = $2, history_dependent = $3, ` +
+                'retention = $4 WHERE id = 0 AND version = $5::bigint RETURNING 1', [...values, stored.version.toString()]);
+        if (rows.length !== 1) {
+            // Impossible while the exclusive lock is held: refuse rather than guess.
+            throw new EvtError('invalidRecord', 'the feature manifest moved during its declaration despite the exclusive lock');
+        }
+    }
+    // One statement outside a transaction.
+    async #read(statement, values) {
+        const client = this.#client;
+        if (client.connect !== undefined) {
+            return rowsOf(await client.query(statement, values));
+        }
+        return serialize(client, async () => rowsOf(await client.query(statement, values)));
+    }
+    // Runs `work` in one READ COMMITTED transaction on a connection of its own, and commits it. A
+    // failure, an abort included, rolls it back. A serialization failure or a deadlock is transient.
+    async #transaction(options, work) {
+        const signal = options?.signal;
+        signal?.throwIfAborted();
+        const client = this.#client;
+        if (client.connect === undefined) {
+            return serialize(client, () => inTransaction(client, signal, work));
+        }
+        const connection = await client.connect();
+        if (typeof connection?.query !== 'function' || typeof connection.release !== 'function') {
+            if (typeof connection?.release === 'function') {
+                connection.release();
+            }
+            throw new EvtError('invalidArgument', "the PostgreSQL client's connect() lent no connection: pass a pool, such as pg's Pool");
+        }
+        let broken;
+        try {
+            return await inTransaction(connection, signal, work, (error) => {
+                broken = error;
+            });
+        }
+        finally {
+            connection.release(broken);
+        }
+    }
+}
+// The operations queued on each single-connection client, shared by every repository on it: two
+// transactions on one session would share its locks, and one's ROLLBACK would undo the other.
+const queues = new WeakMap();
+// Runs `task` on a single-connection client after every task queued on it before.
+function serialize(client, task) {
+    const result = (queues.get(client) ?? Promise.resolve()).then(task, task);
+    queues.set(client, result.catch(() => undefined));
+    return result;
+}
+// One transaction on one connection. `broken` hears of a connection that failed to roll back.
+async function inTransaction(connection, signal, work, broken) {
+    const run = async (statement, values) => {
+        signal?.throwIfAborted();
+        return rowsOf(await connection.query(statement, values));
+    };
+    let result;
+    try {
+        await connection.query('START TRANSACTION ISOLATION LEVEL READ COMMITTED');
+        result = await work(run);
+        signal?.throwIfAborted();
+        await connection.query('COMMIT');
+    }
+    catch (error) {
+        try {
+            await connection.query('ROLLBACK');
+        }
+        catch (rollback) {
+            broken?.(rollback instanceof Error ? rollback : new Error(String(rollback)));
+        }
+        throw transient(error);
+    }
+    // An abort while the COMMIT was in flight rejects too, though the commit may have applied, as
+    // CallOptions promises: there is nothing left to roll back.
+    signal?.throwIfAborted();
+    return result;
+}
+// A driver error PostgreSQL raised for a rollback a retry may not hit again, as a TransientError.
+function transient(error) {
+    const code = typeof error === 'object' && error !== null ? error.code : null;
+    if (typeof code === 'string' && TRANSIENT_STATES.has(code)) {
+        return new TransientError(`PostgreSQL rolled the transaction back (${code})`, { cause: error });
+    }
+    return error;
+}
+// The statements of a DDL script, one at a time, since a driver's extended protocol runs one per
+// call. Each ends at a semicolon that ends its line and comes before a blank line, a CREATE, a DO
+// or the end, which no statement inside the DO block's body is followed by.
+function statements(ddl) {
+    return ddl
+        .split(/;\n(?=\n|CREATE |DO |$)/)
+        .map((statement) => statement.trim())
+        .filter((statement) => statement !== '');
+}
+function rowsOf(result) {
+    const rows = result?.rows;
+    if (!Array.isArray(rows)) {
+        throw new EvtError('invalidRecord', 'the PostgreSQL client returned a result without rows');
+    }
+    return rows;
+}
+// A text column of a row.
+function text(row, column) {
+    const value = row[column];
+    if (typeof value !== 'string') {
+        throw new EvtError('invalidRecord', `the PostgreSQL row has no text column ${column}`);
+    }
+    return value;
+}
+function eventFromRow(row) {
+    const metadata = text(row, 'metadata');
+    return {
+        id: text(row, 'event_id'),
+        sequence: BigInt(text(row, 'sequence')),
+        type: text(row, 'event_type'),
+        version: Number(text(row, 'version')),
+        entityId: text(row, 'entity_id'),
+        entityType: text(row, 'entity_type'),
+        payload: unhex(text(row, 'payload')),
+        // A row Go wrote with null metadata reads as the default, as Go and Rust read it.
+        metadata: metadata.trim() === '' || metadata === 'null' ? emptyMetadata() : decodeMetadata(metadata),
+    };
+}
+function snapshotFromRow(row) {
+    return {
+        entityType: text(row, 'entity_type'),
+        entityId: text(row, 'entity_id'),
+        sequence: BigInt(text(row, 'sequence')),
+        eventSequence: BigInt(text(row, 'event_sequence')),
+        payload: unhex(text(row, 'payload')),
+    };
+}
+// Bytes as lowercase hex, which decode(…, 'hex') reads. A null payload is stored empty.
+function hex(bytes) {
+    let out = '';
+    for (const byte of bytes ?? []) {
+        out += byte.toString(16).padStart(2, '0');
+    }
+    return out;
+}
+function unhex(digits) {
+    const bytes = new Uint8Array(digits.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Number.parseInt(digits.slice(2 * i, 2 * i + 2), 16);
+    }
+    return bytes;
+}
+function conflict(entityId) {
+    return new ConflictError(entityId, 'conditional check failed: the sequence or snapshot changed since it was read');
+}
+// A stored head of 0 is an absent head.
+function drift(entityId, stored, derived) {
+    return new StreamHeadDriftError(entityId, stored > 0n ? stored : null, derived);
+}
+//# sourceMappingURL=repository.js.map

package/dist/postgres/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/postgres/repository.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6FAA6F;AAC7F,+FAA+F;AAC/F,8FAA8F;AAC9F,iGAAiG;AACjG,4FAA4F;AAC5F,EAAE;AACF,8FAA8F;AAC9F,qCAAqC;AAErC,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,QAAQ,EACR,+BAA+B,EAC/B,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,GACf,MAAM,cAAc,CAAA;AAErB,OAAO,EAEL,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAC,cAAc,EAAE,aAAa,EAAE,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAKL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EAEX,WAAW,EACX,eAAe,EACf,aAAa,EACb,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAUpB,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C,0FAA0F;AAC1F,MAAM,aAAa,GACjB,yFAAyF;IACzF,4EAA4E,CAAA;AAE9E,8FAA8F;AAC9F,iDAAiD;AACjD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAOpD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACd,OAAO,CAAU;IACjB,OAAO,CAAU;IAE1B,0EAA0E;IAC1E,UAAU,GAAkB,IAAI,CAAA;IAChC,8FAA8F;IAC9F,aAAa,GAAG,KAAK,CAAA;IAErB;;;OAGG;IACH,YAAY,MAAgB,EAAE,OAAO,GAAwB,EAAE;QAC7D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACtE,CAAC;IAED,yEAAyE;IACzE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,OAAqB;QACtC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;YAC7C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBAC5D,MAAM,GAAG,CAAC,SAAS,CAAC,CAAA;YACtB,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAqB;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACpD,MAAM,GAAG,CAAC,qBAAqB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;gBACjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;gBAC9C,cAAc,CAAC,QAAQ,CAAC,CAAA;gBACxB,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClC,OAAO,KAAK,CAAA;gBACd,CAAC;gBAED,MAAM,EAAC,MAAM,EAAE,SAAS,EAAC,GAAG,IAAI,CAAC,OAAO,CAAA;gBACxC,MAAM,SAAS,GAAG,MAAM,GAAG,CACzB,wCAAwC,MAAM,8BAA8B,SAAS,GAAG,CACzF,CAAA;gBACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,2BAA2B,EAAE,CAAA;gBACzC,CAAC;gBAED,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAEnE,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC;gBAAS,CAAC;YACT,kEAAkE;YAClE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAAqB;QAChD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAM;QACR,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,OAAO,KAAK,gBAAgB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,QAAQ,CAChB,eAAe,EACf,yDAAyD,KAAK,CAAC,OAAO,kBAAkB,CACzF,CAAA;YACH,CAAC;QACH,CAAC;QAED,6FAA6F;QAC7F,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;QACjD,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEtC,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,CAAA;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAA;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAA;QACpC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;YAClC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;YAC9B,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAA;YAEpC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC/E,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC/C,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC3C,kFAAkF;oBAClF,yCAAyC;oBACzC,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;gBAC3E,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAChC,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,0CAA0C,IAAI,CAAC,OAAO,CAAC,SAAS,uBAAuB,EACvF,CAAC,QAAQ,CAAC,CACX,CAAA;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAA;gBAC/E,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAChD,MAAM,IAAI,aAAa,CACrB,QAAQ,EACR,qBAAqB,QAAQ,CAAC,QAAQ,4BAA4B,CACnE,CAAA;gBACH,CAAC;gBACD,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,GAAG,EAAE,EAAE,CAAC;oBACzD,MAAM,IAAI,aAAa,CACrB,QAAQ,EACR,mCAAmC,MAAM,mBAAmB,QAAQ,CAAC,QAAQ,EAAE,CAChF,CAAA;gBACH,CAAC;gBAED,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAC,CAAC,CAAA;YAC/E,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAqB;QAClD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAC3B,UAAU,aAAa,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,wBAAwB;YACzE,uBAAuB,EACzB,CAAC,QAAQ,CAAC,CACX,CAAA;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,KAAa,EACb,OAAqB;QAErB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAC3B,UAAU,aAAa,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG;YACpD,sEAAsE,EACxE,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAC7B,CAAA;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,CAAS,EAAE,OAAqB;QAC7D,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,QAAQ,CAChB,iBAAiB,EACjB,oEAAoE,CAAC,EAAE,CACxE,CAAA;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAC3B,UAAU,aAAa,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,wBAAwB;YACzE,yCAAyC,EAC3C,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CACzB,CAAA;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,OAAqB;QACpD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAC3B,6DAA6D;YAC3D,4EAA4E;YAC5E,QAAQ,IAAI,CAAC,OAAO,CAAC,SAAS,uBAAuB,EACvD,CAAC,QAAQ,CAAC,CACX,CAAA;QAED,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAA4B,EAAE,OAAqB;QACnE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACnC,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAA;QACrD,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAA;QACrF,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEtC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC9C,MAAM,EAAC,QAAQ,EAAC,GAAG,QAAQ,CAAA;YAC3B,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;YAClC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;YAE9B,4FAA4F;YAC5F,8BAA8B;YAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAClD,IAAI,aAAa,GAAG,EAAE,IAAI,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;gBACtD,MAAM,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;YAChF,CAAC;YAED,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAqB;QACzE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC1B,IAAI,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC;YAC3C,OAAO,CAAC,CAAA;QACV,CAAC;QAED,mFAAmF;QACnF,sFAAsF;QACtF,4CAA4C;QAC5C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC9C,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;YAC9C,aAAa,CAAC,QAAQ,CAAC,CAAA;YAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,6DAA6D;gBAC3D,QAAQ,IAAI,CAAC,OAAO,CAAC,SAAS,uBAAuB,EACvD,CAAC,QAAQ,CAAC,CACX,CAAA;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAA;YACtF,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBAC1C,MAAM,IAAI,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAChE,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,aAAa,CAAC,CAAA;YAChD,IAAI,QAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,+BAA+B,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;YACjE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,GAAG,CACvB,gCAAgC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG;gBACpD,iFAAiF;gBACjF,+CAA+C,EACjD,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAC/B,CAAA;YAED,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,2FAA2F;IAC3F,iGAAiG;IACjG,4FAA4F;IAC5F,KAAK,CAAC,kBAAkB,CAAC,OAAgC;QACvD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAC9D,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAC9B,CAAA;QACD,cAAc,CAAC,QAAQ,CAAC,CAAA;QACxB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,6FAA6F;IAC7F,0CAA0C;IAC1C,KAAK,CAAC,cAAc,CAAC,GAAc;QACjC,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9D,OAAM;QACR,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACtB,aAAa,CAAC,QAAQ,CAAC,CAAA;QACvB,IAAI,CAAC,UAAU,GAAG,QAAS,CAAC,OAAO,CAAA;IACrC,CAAC;IAED,gGAAgG;IAChG,+FAA+F;IAC/F,wEAAwE;IACxE,KAAK,CAAC,oBAAoB,CAAC,GAAc;QACvC,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC7D,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,CAAC,4CAA4C,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnF,OAAM;YACR,CAAC;YAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QAC3B,CAAC;QAED,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,wCAAwC,IAAI,iBAAiB;YAC3D,4BAA4B,UAAU,mCAAmC,CAC5E,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,sBAAsB,EAAE,CAAA;QACpC,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,uEAAuE;IACvE,KAAK,CAAC,SAAS,CACb,GAAc,EACd,QAAgB,EAChB,UAAkB,EAClB,KAAa,EACb,IAAY;QAEZ,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,IAAI,GACR,KAAK,IAAI,EAAE;YACT,CAAC,CAAC,MAAM,GAAG,CACP,eAAe,KAAK,8DAA8D;gBAChF,gDAAgD,EAClD,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CACxC;YACH,CAAC,CAAC,MAAM,GAAG,CACP,UAAU,KAAK,oEAAoE;gBACjF,aAAa,EACf,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CACrD,CAAA;QAEP,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,+FAA+F;IAC/F,4FAA4F;IAC5F,8DAA8D;IAC9D,KAAK,CAAC,MAAM,CAAC,GAAc,EAAE,QAAgB,EAAE,KAAa;QAC1D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACpD,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACzC,CAAC;QACD,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YACpD,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC7E,CAAC;QACD,IAAI,MAAM,GAAG,KAAK,GAAG,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,WAAW,CAAC,GAAc,EAAE,QAAgB;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,kCAAkC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,EACvF,CAAC,QAAQ,CAAC,CACX,CAAA;QAED,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,2FAA2F;IAC3F,YAAY;IACZ,KAAK,CAAC,YAAY,CAAC,GAAc,EAAE,QAAgB;QACjD,MAAM,EAAC,MAAM,EAAE,SAAS,EAAC,GAAG,IAAI,CAAC,OAAO,CAAA;QACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,kBAAkB;YAChB,uCAAuC,MAAM,8BAA8B;YAC3E,6CAA6C,SAAS,4BAA4B;YAClF,iBAAiB,EACnB,CAAC,QAAQ,CAAC,CACX,CAAA;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,YAAY,CAAC,GAAc,EAAE,KAAsB;QACvD,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,eAAe,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG;YACnC,uFAAuF;YACvF,sFAAsF;YACtF,0DAA0D,EAC5D;YACE,KAAK,CAAC,QAAQ;YACd,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACzB,KAAK,CAAC,EAAE;YACR,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;YACxB,KAAK,CAAC,UAAU;YAChB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;YAClB,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;SAC/B,CACF,CAAA;QAED,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,eAAe,CAAC,GAAc,EAAE,QAA4B;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAA;QACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,eAAe,KAAK,GAAG;YACrB,0EAA0E;YAC1E,oEAAoE;YACpE,4EAA4E;YAC5E,0EAA0E;YAC1E,iDAAiD;YACjD,oCAAoC,KAAK,6BAA6B,EACxE;YACE,QAAQ,CAAC,QAAQ;YACjB,QAAQ,CAAC,UAAU;YACnB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;YAC5B,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE;YACjC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;SACtB,CACF,CAAA;QAED,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,0FAA0F;IAC1F,iGAAiG;IACjG,KAAK,CAAC,aAAa,CAAC,GAAc;QAChC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,CAAC,MAAM,GAAG,CAAC,4CAA4C,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB,0EAA0E;YACxE,QAAQ,KAAK,eAAe,CAC/B,CAAA;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE;YAClD,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC;YAC/B,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC;YAChD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;SAClC,CAAC,CAAA;IACJ,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,cAAc,CAClB,GAAc,EACd,MAA8B,EAC9B,IAAqB;QAErB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,EAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAC,GAAG,KAAK,CAAA;QACrD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;QAC/E,MAAM,IAAI,GACR,MAAM,KAAK,IAAI;YACb,CAAC,CAAC,MAAM,GAAG,CACP,eAAe,KAAK,yDAAyD;gBAC3E,gDAAgD,EAClD,MAAM,CACP;YACH,CAAC,CAAC,MAAM,GAAG,CACP,UAAU,KAAK,oEAAoE;gBACjF,kEAAkE,EACpE,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CACvC,CAAA;QACP,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,yEAAyE;YACzE,MAAM,IAAI,QAAQ,CAChB,eAAe,EACf,8EAA8E,CAC/E,CAAA;QACH,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,MAA0B;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;QACtD,CAAC;QAED,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACrF,CAAC;IAED,8FAA8F;IAC9F,iGAAiG;IACjG,KAAK,CAAC,YAAY,CAChB,OAAgC,EAChC,IAAoC;QAEpC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAA;QAC9B,MAAM,EAAE,cAAc,EAAE,CAAA;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;QACrE,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QACzC,IAAI,OAAO,UAAU,EAAE,KAAK,KAAK,UAAU,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACxF,IAAI,OAAO,UAAU,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC9C,UAAU,CAAC,OAAO,EAAE,CAAA;YACtB,CAAC;YACD,MAAM,IAAI,QAAQ,CAChB,iBAAiB,EACjB,sFAAsF,CACvF,CAAA;QACH,CAAC;QAED,IAAI,MAAyB,CAAA;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC7D,MAAM,GAAG,KAAK,CAAA;YAChB,CAAC,CAAC,CAAA;QACJ,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;CAEF;AAED,gGAAgG;AAChG,8FAA8F;AAC9F,MAAM,MAAM,GAAG,IAAI,OAAO,EAAiC,CAAA;AAE3D,kFAAkF;AAClF,SAAS,SAAS,CAAI,MAAmB,EAAE,IAAsB;IAC/D,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACzE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAEjD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,aAAa,CAC1B,UAAsC,EACtC,MAA+B,EAC/B,IAAoC,EACpC,MAA+B;IAE/B,MAAM,GAAG,GAAc,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,EAAE,cAAc,EAAE,CAAA;QAExB,OAAO,MAAM,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1D,CAAC,CAAA;IAED,IAAI,MAAS,CAAA;IACb,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAA;QAC1E,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAA;QACxB,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,MAAM,EAAE,CAAC,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC9E,CAAC;QAED,MAAM,SAAS,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,8FAA8F;IAC9F,4DAA4D;IAC5D,MAAM,EAAE,cAAc,EAAE,CAAA;IAExB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,kGAAkG;AAClG,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IAClG,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,cAAc,CAAC,2CAA2C,IAAI,GAAG,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAA;IAC/F,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,iGAAiG;AACjG,kGAAkG;AAClG,4EAA4E;AAC5E,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,KAAK,CAAC,yBAAyB,CAAC;SAChC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACpC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,MAAM,CAAC,MAA+C;IAC7D,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAA;IACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,sDAAsD,CAAC,CAAA;IAC7F,CAAC;IAED,OAAO,IAAa,CAAA;AACtB,CAAC;AAED,0BAA0B;AAC1B,SAAS,IAAI,CAAC,GAAQ,EAAE,MAAc;IACpC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,yCAAyC,MAAM,EAAE,CAAC,CAAA;IACxF,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,YAAY,CAAC,GAAQ;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAEtC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;QAChC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;QACpC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACpC,kFAAkF;QAClF,QAAQ,EACN,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC;KAC7F,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAQ;IAC/B,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;QACpC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;KACrC,CAAA;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,GAAG,CAAC,KAAwB;IACnC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC/B,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,KAAK,CAAC,MAAc;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAChE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,IAAI,aAAa,CACtB,QAAQ,EACR,8EAA8E,CAC/E,CAAA;AACH,CAAC;AAED,wCAAwC;AACxC,SAAS,KAAK,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAe;IAC9D,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACjF,CAAC"}

package/dist/postgres/schema.d.ts

@@ -0,0 +1,81 @@
+/** The default events table. */
+export declare const DEFAULT_EVENTS_TABLE = "evt_events";
+/** The default snapshots table. */
+export declare const DEFAULT_SNAPSHOTS_TABLE = "evt_snapshots";
+/**
+ * The infix the engine relations derive from the events table name with, such as
+ * `evt_events__evt_features`. A configured table name may not contain it, in any case, so one
+ * log's tables can never equal another log's derived relation.
+ */
+export declare const RESERVED_INFIX = "__evt_";
+/**
+ * The longest events table name, in bytes. Its longest derived relation,
+ * `{events}__evt_rebuild_generation_pkey`, then fills PostgreSQL's 63-byte identifier limit.
+ */
+export declare const MAX_EVENTS_TABLE_NAME_BYTES: number;
+/** The longest snapshots table name, in bytes, which leaves room for its `_pkey` index. */
+export declare const MAX_SNAPSHOTS_TABLE_NAME_BYTES: number;
+declare const validated: unique symbol;
+/**
+ * An event log's two configured tables, validated and folded to lower case. Only
+ * {@link pgTables} makes one.
+ */
+export interface PgTables {
+    readonly events: string;
+    readonly snapshots: string;
+    readonly [validated]: true;
+}
+/**
+ * Validates an event log's table names and folds them to lower case, as PostgreSQL folds unquoted
+ * identifiers. Each must be a plain identifier that isn't a reserved keyword, within its length
+ * limit, without the {@link RESERVED_INFIX}, and no two relations the schema creates may share a
+ * name. A name that breaks a rule fails with `invalidArgument`, as Go and Rust refuse it at
+ * construction.
+ */
+export declare function pgTables(events?: string, snapshots?: string): PgTables;
+/** The command-outcomes table: `evt_events` yields `evt_events__evt_command_outcomes`. */
+export declare function outcomesTable(tables: PgTables): string;
+/** The feature-marker table: `evt_events` yields `evt_events__evt_features`. */
+export declare function featuresTable(tables: PgTables): string;
+/** The rebuild-lock table: `evt_events` yields `evt_events__evt_rebuild_lock`. */
+export declare function rebuildLockTable(tables: PgTables): string;
+/** The rebuild-generation table: `evt_events` yields `evt_events__evt_rebuild_generation`. */
+export declare function rebuildGenerationTable(tables: PgTables): string;
+/** The stream-heads table: `evt_events` yields `evt_events__evt_stream_heads`. */
+export declare function streamHeadsTable(tables: PgTables): string;
+/** The entity-type index of the events table: `evt_events__evt_entity_type_idx`. */
+export declare function entityTypeIndex(tables: PgTables): string;
+/**
+ * The idempotent DDL of an event log, byte for byte the DDL Go's `EnsureSchema` and Rust's
+ * `ensure_schema` run: the events and snapshots tables, the entity-type index (dropping its
+ * pre-v0.9 name), and the command-outcome, feature-marker, rebuild-fence and stream-heads tables.
+ * Run it inside one transaction, after {@link SCHEMA_LOCK} with the events table name, as Go and
+ * Rust do.
+ */
+export declare function schemaDdl(tables: PgTables): string;
+/**
+ * Serializes schema changes across processes, in every language: `IF NOT EXISTS` alone can still
+ * race in PostgreSQL's catalogs. `$1` is the events table name.
+ */
+export declare const SCHEMA_LOCK = "SELECT pg_advisory_xact_lock(1702261762, hashtext($1))";
+/**
+ * The per-entity transaction lock every commit and snapshot write takes, `$1` being the entity
+ * ID. Go and Rust run this exact statement, so writers in every language exclude each other.
+ */
+export declare const ENTITY_LOCK = "SELECT pg_advisory_xact_lock(1702261760, hashtext($1))";
+/**
+ * The shared engine-row lock a commit takes and holds to `COMMIT`, `$1` being a key from
+ * {@link featuresLockKey} or {@link rebuildLockKey}. Commits don't serialize against each other.
+ */
+export declare const ENGINE_LOCK_SHARED = "SELECT pg_advisory_xact_lock_shared(1702261761, hashtext($1))";
+/**
+ * The exclusive engine-row lock a declaration or a rebuild lifecycle step takes for its short
+ * transaction, so it never slips between a commit's check and its `COMMIT`.
+ */
+export declare const ENGINE_LOCK_EXCLUSIVE = "SELECT pg_advisory_xact_lock(1702261761, hashtext($1))";
+/** The feature marker's engine-row lock key: `{events}:features`. */
+export declare function featuresLockKey(tables: PgTables): string;
+/** The rebuild fence's engine-row lock key: `{events}:rebuild`. */
+export declare function rebuildLockKey(tables: PgTables): string;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/postgres/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/postgres/schema.ts"],"names":[],"mappings":"AAMA,gCAAgC;AAChC,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAEhD,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAA8C,CAAA;AAEtF,2FAA2F;AAC3F,eAAO,MAAM,8BAA8B,QAAsB,CAAA;AAGjE,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAA;AAEtC;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC3B;AAkBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,MAAM,GAAE,MAA6B,EACrC,SAAS,GAAE,MAAgC,GAC1C,QAAQ,CA0BV;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CA6ElD;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,2DAA2D,CAAA;AAEnF;;;GAGG;AACH,eAAO,MAAM,WAAW,2DAA2D,CAAA;AAEnF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kEAAkE,CAAA;AAEjG;;;GAGG;AACH,eAAO,MAAM,qBAAqB,2DAA2D,CAAA;AAE7F,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAEvD"}