@emseepea/server 0.24.0 → 0.25.0

package/dist/events-postgres-dispatch.js

@@ -0,0 +1,270 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { performance } from 'node:perf_hooks';
+import { ExternalMcpEventError } from './events-external.js';
+import { createDeliverySessionOwner } from './events-postgres-delivery-owned.js';
+const names = ['namespace', 'source_kind', 'source_id', 'subscription_id', 'generation'];
+const key = (row) => names.map(name => row[name]);
+const equal = (alias) => names.map((name, i) => `${alias}.${name}=$${i + 1}`).join(' AND ');
+const join = (a, b) => names.map(name => `${a}.${name}=${b}.${name}`).join(' AND ');
+const dbNow = "pg_catalog.floor(EXTRACT(epoch FROM pg_catalog.clock_timestamp())*1000)::pg_catalog.float8";
+const invalid = () => { throw new ExternalMcpEventError('INVALID_INPUT'); };
+const validId = (value) => typeof value === 'string' && value.length > 0 && Buffer.byteLength(value) <= 240 &&
+    !value.includes('\u0000') && !/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(value);
+const eligible = `i.state='pending' AND i.event_id=s.event_id AND s.owner_key=c.owner_key AND c.owner_key=h.owner_key
+ AND s.event_name=c.event_name AND h.generation=c.generation AND h.url IS NOT NULL AND c.active
+ AND c.expires_at>pg_catalog.clock_timestamp() AND (w.terminal IS NULL)`;
+const joins = `JOIN public.emseepea_event_sources s ON s.namespace=i.namespace AND s.source_kind=i.source_kind AND s.source_id=i.source_id
+ JOIN public.emseepea_event_capture_subscriptions c ON c.namespace=i.namespace AND c.subscription_id=i.subscription_id AND c.generation=i.generation
+ JOIN public.emseepea_event_heads h ON h.namespace=i.namespace AND h.subscription_id=i.subscription_id
+ LEFT JOIN public.emseepea_event_delivery_state w ON ${join('w', 'i')}`;
+/** Internal implementation seam; no route, provider credentials, timer or adopter callback API. */
+export function createPostgresEventDispatchRuntime(options) {
+    const namespace = options?.namespace, transport = options?.transport, fingerprint = transport?.fingerprint;
+    if (!validId(namespace) ||
+        !options.pool || typeof options.pool.connect !== 'function' || typeof options.isPaused !== 'function' ||
+        typeof fingerprint !== 'string' || !/^[0-9a-f]{64}$/.test(fingerprint) ||
+        typeof transport.queue !== 'function' || typeof transport.inspect !== 'function' || typeof transport.create !== 'function')
+        invalid();
+    const owner = createDeliverySessionOwner(options.pool), pending = new Set();
+    let busy = false, closing = false;
+    function track(promise) {
+        pending.add(promise);
+        void promise.then(() => pending.delete(promise), () => pending.delete(promise));
+        return promise;
+    }
+    function paused() { const value = options.isPaused(); if (typeof value !== 'boolean')
+        return invalid(); return value; }
+    async function operation(target, input) {
+        const result = { selected: 0, created: 0, observed: 0, conflicts: 0, unknown: 0, deferred: 0, status: 'complete' };
+        if (!input?.signal || !Number.isFinite(input.deadlineMs))
+            return invalid();
+        if (target !== undefined && !validId(target))
+            return invalid();
+        if (closing)
+            return { ...result, status: 'stopping' };
+        if (busy)
+            return { ...result, status: 'retry_pending' };
+        busy = true;
+        const end = performance.now() + Math.min(25000, input.deadlineMs - Date.now());
+        function check(required = 0) {
+            if (closing || input.signal.aborted)
+                throw new ExternalMcpEventError('ABORTED');
+            if (paused())
+                throw new Error('DISPATCH_PAUSED');
+            if (end - performance.now() < required)
+                throw new ExternalMcpEventError('DEADLINE');
+        }
+        const invocation = () => ({ signal: input.signal, deadlineMs: Date.now() + Math.max(0, end - performance.now() - 1000) });
+        async function sql(work) {
+            check(5000);
+            return owner.run(invocation(), session => session.transaction(work));
+        }
+        async function provider(work) {
+            check(4000);
+            let timer, stop;
+            const controller = new AbortController(), until = Math.min(end - 1000, performance.now() + 3000);
+            try {
+                const actual = track(Promise.resolve().then(() => { check(4000); return work({ signal: controller.signal, deadlineMs: Date.now() + Math.max(0, until - performance.now()) }); }));
+                const value = await Promise.race([actual, new Promise((_resolve, reject) => {
+                        timer = setTimeout(() => { controller.abort(); reject(new ExternalMcpEventError('DEADLINE')); }, Math.max(1, until - performance.now()));
+                        stop = () => { controller.abort(); reject(new ExternalMcpEventError('ABORTED')); };
+                        input.signal.addEventListener('abort', stop, { once: true });
+                        if (input.signal.aborted)
+                            stop();
+                    })]);
+                check();
+                if (performance.now() >= until)
+                    throw new ExternalMcpEventError('DEADLINE');
+                return value;
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+                if (stop)
+                    input.signal.removeEventListener('abort', stop);
+            }
+        }
+        async function seed() {
+            await sql(async (run) => {
+                await run(`INSERT INTO public.emseepea_event_dispatch_state(${names.join(',')},config_hash)
+     SELECT ${names.map(name => `i.${name}`).join(',')},$2 FROM public.emseepea_event_intents i ${joins}
+     WHERE i.namespace=$1 AND ${eligible} AND ($3::pg_catalog.text IS NULL OR i.delivery_id=$3)
+     AND NOT EXISTS(SELECT 1 FROM public.emseepea_event_dispatch_state d WHERE ${join('d', 'i')})
+     ORDER BY i.delivery_id LIMIT 100 ON CONFLICT(${names.join(',')}) DO NOTHING`, [namespace, fingerprint, target ?? null]);
+            });
+        }
+        async function claim() {
+            return sql(async (run) => {
+                const row = (await run(`SELECT d.*,i.delivery_id FROM public.emseepea_event_dispatch_state d
+     JOIN public.emseepea_event_intents i ON ${join('d', 'i')}
+     WHERE d.namespace=$1 AND NOT d.terminal AND d.due_at<=pg_catalog.clock_timestamp()
+     AND (d.lease_until IS NULL OR d.lease_until<=pg_catalog.clock_timestamp())
+     AND ($2::pg_catalog.text IS NULL OR i.delivery_id=$2)
+     ORDER BY d.due_at,i.delivery_id FOR UPDATE OF d SKIP LOCKED LIMIT 1`, [namespace, target ?? null])).rows[0];
+                if (!row)
+                    return null;
+                if (names.some(name => typeof row[name] !== 'string') || typeof row.delivery_id !== 'string' || !Number.isInteger(row.transport_generation) ||
+                    Number(row.transport_generation) < 0 || Number(row.transport_generation) > 2147483646 || !Number.isInteger(row.recovery_count) ||
+                    typeof row.config_hash !== 'string')
+                    throw new ExternalMcpEventError('UNAVAILABLE');
+                const lease = randomUUID();
+                await run(`UPDATE public.emseepea_event_dispatch_state d SET lease_id=$6,lease_until=pg_catalog.clock_timestamp()+interval '30 seconds',
+     recovery_count=CASE WHEN recovery_count<2147483647 THEN recovery_count+1 ELSE recovery_count END,
+     due_at=pg_catalog.clock_timestamp()+pg_catalog.make_interval(secs=>(CASE WHEN recovery_count>=6 THEN 60 ELSE pg_catalog.power(2,recovery_count)::pg_catalog.int4 END)::pg_catalog.float8)
+     WHERE ${equal('d')}`, [...key(row), lease]);
+                row.lease_id = lease;
+                const fresh = (await run(`SELECT ${eligible} AS eligible,${dbNow} AS now,
+     pg_catalog.ceil(EXTRACT(epoch FROM w.lease_until)*1000)::pg_catalog.float8 AS worker_lease_until,
+     pg_catalog.ceil(EXTRACT(epoch FROM w.due_at)*1000)::pg_catalog.float8 AS worker_due_at
+     FROM public.emseepea_event_intents i ${joins} WHERE ${equal('i')}`, key(row))).rows[0];
+                row.eligible = fresh?.eligible === true;
+                if (fresh) {
+                    if (!Number.isSafeInteger(fresh.now))
+                        throw new ExternalMcpEventError('UNAVAILABLE');
+                    for (const name of ['worker_lease_until', 'worker_due_at'])
+                        if (fresh[name] !== null && !Number.isSafeInteger(fresh[name]))
+                            throw new ExternalMcpEventError('UNAVAILABLE');
+                    const until = Math.max(Number(fresh.worker_lease_until ?? 0), Number(fresh.worker_due_at ?? 0));
+                    row.waitUntil = until > Number(fresh.now) ? until : null;
+                }
+                else
+                    row.waitUntil = null;
+                return row;
+            });
+        }
+        async function finish(row, category, terminal = false, deferUntil = null) {
+            check(5000);
+            const found = await sql(async (run) => (await run(`UPDATE public.emseepea_event_dispatch_state d
+    SET category=$8,terminal=$9,lease_id=NULL,lease_until=NULL,
+    due_at=CASE WHEN $12::pg_catalog.float8 IS NULL THEN due_at ELSE
+     GREATEST(due_at,pg_catalog.clock_timestamp()+interval '1 second',pg_catalog.to_timestamp($12::pg_catalog.float8/1000)) END
+    WHERE ${equal('d')} AND lease_id=$6 AND config_hash=$7 AND lease_until>pg_catalog.clock_timestamp()
+    AND transport_generation=$10 AND task_id IS NOT DISTINCT FROM $11 RETURNING namespace`, [...key(row), row.lease_id, row.config_hash, category, terminal, row.transport_generation, row.task_id ?? null, deferUntil])).rows);
+            if (found.length !== 1)
+                throw new ExternalMcpEventError('OUTCOME_UNKNOWN');
+        }
+        async function reserve(row) {
+            check(12000);
+            const previous = Number(row.transport_generation);
+            if (previous >= 2147483646)
+                throw new ExternalMcpEventError('UNAVAILABLE');
+            const generation = previous + 1, taskId = 'emseepea-' + createHash('sha256').update(JSON.stringify([fingerprint, namespace, row.delivery_id, generation])).digest('hex');
+            const found = await sql(async (run) => (await run(`UPDATE public.emseepea_event_dispatch_state d SET transport_generation=$8,task_id=$9,category='unknown'
+    WHERE ${equal('d')} AND lease_id=$6 AND config_hash=$7 AND lease_until>pg_catalog.clock_timestamp()
+    AND transport_generation=$10 AND task_id IS NOT DISTINCT FROM $11 RETURNING namespace`, [...key(row), row.lease_id, fingerprint, generation, taskId, previous, row.task_id ?? null])).rows);
+            if (found.length !== 1)
+                throw new ExternalMcpEventError('OUTCOME_UNKNOWN');
+            row.transport_generation = generation;
+            row.task_id = taskId;
+        }
+        try {
+            check(5000);
+            if (await provider(inv => transport.queue(inv)) !== 'present') {
+                result.status = 'retry_pending';
+                result.deferred++;
+                return result;
+            }
+            await seed();
+            while (result.selected < 100) {
+                check(18000);
+                const row = await claim();
+                if (!row)
+                    break;
+                result.selected++;
+                if (row.config_hash !== fingerprint) {
+                    await finish(row, 'conflict');
+                    result.conflicts++;
+                    continue;
+                }
+                if (!row.eligible) {
+                    await finish(row, 'ineligible', true);
+                    result.deferred++;
+                    continue;
+                }
+                if (typeof row.waitUntil === 'number') {
+                    await finish(row, 'unavailable', false, row.waitUntil);
+                    result.deferred++;
+                    continue;
+                }
+                let create = Number(row.transport_generation) === 0;
+                if (!create) {
+                    if (typeof row.task_id !== 'string' || !/^emseepea-[0-9a-f]{64}$/.test(row.task_id))
+                        throw new ExternalMcpEventError('UNAVAILABLE');
+                    const state = await provider(inv => transport.inspect({ deliveryId: String(row.delivery_id), taskId: String(row.task_id) }, inv));
+                    if (state === 'matching') {
+                        await finish(row, 'present');
+                        result.observed++;
+                        continue;
+                    }
+                    if (state === 'conflict') {
+                        await finish(row, 'conflict');
+                        result.conflicts++;
+                        continue;
+                    }
+                    if (state !== 'missing') {
+                        await finish(row, 'unknown');
+                        result.unknown++;
+                        continue;
+                    }
+                    check(15000);
+                    if (await provider(inv => transport.queue(inv)) !== 'present') {
+                        await finish(row, 'unavailable');
+                        result.deferred++;
+                        continue;
+                    }
+                    create = true;
+                }
+                if (create) {
+                    await reserve(row);
+                    check(8000);
+                    const state = await provider(inv => transport.create({ deliveryId: String(row.delivery_id), taskId: String(row.task_id) }, inv));
+                    await finish(row, state === 'created' ? 'present' : 'unknown');
+                    if (state === 'created')
+                        result.created++;
+                    else
+                        result.unknown++;
+                }
+                if (target !== undefined)
+                    break;
+            }
+            return result;
+        }
+        catch (error) {
+            result.status = error instanceof Error && error.message === 'DISPATCH_PAUSED' ? 'paused' : closing ? 'stopping' : 'retry_pending';
+            result.unknown++;
+            return result;
+        }
+        finally {
+            // A visible timeout never frees the single slot while raw SDK/SQL or disposal is outstanding.
+            const drained = owner.quiesce();
+            const held = track(Promise.allSettled([...pending, drained]));
+            void held.then(async () => { if (await drained)
+                busy = false; });
+        }
+    }
+    return Object.freeze({
+        reconcile: (invocation) => operation(undefined, invocation),
+        dispatch: (deliveryId, invocation) => operation(deliveryId, invocation),
+        async settle(invocation) {
+            closing = true;
+            const end = performance.now() + Math.max(0, invocation.deadlineMs - Date.now());
+            const settling = owner.settle(invocation);
+            while (pending.size) {
+                if (invocation.signal.aborted || performance.now() >= end)
+                    return false;
+                let timer;
+                try {
+                    const done = await Promise.race([Promise.allSettled(pending).then(() => true), new Promise(resolve => { timer = setTimeout(() => resolve(false), Math.max(1, end - performance.now())); })]);
+                    if (!done)
+                        return false;
+                }
+                finally {
+                    if (timer)
+                        clearTimeout(timer);
+                }
+            }
+            return settling;
+        },
+    });
+}
+//# sourceMappingURL=events-postgres-dispatch.js.map

package/dist/events-postgres-dispatch.js.map

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

package/dist/events-postgres-lifecycle-migrations.d.ts

@@ -0,0 +1,17 @@
+import { type PostgresEventMigrationPool } from './events-postgres-migrations.js';
+import type { PostgresEventInvocation } from './events-postgres.js';
+export declare class PostgresEventLifecycleMigrationError extends Error {
+    readonly code: 'INCOMPATIBLE_SCHEMA' | 'UNAVAILABLE' | 'OUTCOME_UNKNOWN';
+    readonly phase: 'capture' | 'lifecycle';
+    readonly captureCommitted: boolean;
+    constructor(code: 'INCOMPATIBLE_SCHEMA' | 'UNAVAILABLE' | 'OUTCOME_UNKNOWN', phase?: 'capture' | 'lifecycle', captureCommitted?: boolean);
+}
+/** Runs the capture migration before the lifecycle migration. If the lifecycle migration fails, `capture-v1` can remain installed.
+ * The lifecycle migration rejects an existing populated capture-only subscription store because it cannot establish verification state safely.
+ * Serving constructors never call this function. The deployment owner must configure database grants.
+ */
+export declare function createPostgresEventLifecycleMigrator(pool: PostgresEventMigrationPool): Readonly<{
+    migrate(invocation: PostgresEventInvocation): Promise<void>;
+    settle(invocation: PostgresEventInvocation): Promise<boolean>;
+}>;
+//# sourceMappingURL=events-postgres-lifecycle-migrations.d.ts.map

package/dist/events-postgres-lifecycle-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-postgres-lifecycle-migrations.d.ts","sourceRoot":"","sources":["../src/events-postgres-lifecycle-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AACtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,qBAAa,oCAAqC,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAC,qBAAqB,GAAC,aAAa,GAAC,iBAAiB;IAC7E,QAAQ,CAAC,KAAK,EAAC,SAAS,GAAC,WAAW;IAAc,QAAQ,CAAC,gBAAgB;gBADxD,IAAI,EAAC,qBAAqB,GAAC,aAAa,GAAC,iBAAiB,EACpE,KAAK,GAAC,SAAS,GAAC,WAAuB,EAAW,gBAAgB,UAAM;CACpF;AAuDD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAC,0BAA0B;wBA6B7D,uBAAuB;uBAClB,uBAAuB;GAMlD"}

package/dist/events-postgres-lifecycle-migrations.js

@@ -0,0 +1,125 @@
+import { createPostgresEventCaptureMigrator } from './events-postgres-migrations.js';
+import { createOwnedEventOperations } from './events-postgres-owned.js';
+export class PostgresEventLifecycleMigrationError extends Error {
+    code;
+    phase;
+    captureCommitted;
+    constructor(code, phase = 'lifecycle', captureCommitted = false) {
+        super(code);
+        this.code = code;
+        this.phase = phase;
+        this.captureCommitted = captureCommitted;
+        this.name = 'PostgresEventLifecycleMigrationError';
+    }
+}
+const incompatible = () => { throw new PostgresEventLifecycleMigrationError('INCOMPATIBLE_SCHEMA'); };
+const tables = ['emseepea_event_lifecycle_migrations', 'emseepea_event_heads', 'emseepea_event_keys'];
+const ddl = [
+    `CREATE TABLE public.emseepea_event_lifecycle_migrations(singleton pg_catalog.bool PRIMARY KEY DEFAULT true CHECK(singleton),version pg_catalog.int4 NOT NULL,revision pg_catalog.text NOT NULL)`,
+    `CREATE TABLE public.emseepea_event_heads(namespace pg_catalog.text NOT NULL,subscription_id pg_catalog.text NOT NULL,owner_key pg_catalog.text NOT NULL,url pg_catalog.text,revision pg_catalog.text NOT NULL,generation pg_catalog.text,PRIMARY KEY(namespace,subscription_id))`,
+    `CREATE TABLE public.emseepea_event_keys(namespace pg_catalog.text NOT NULL,subscription_id pg_catalog.text NOT NULL,generation pg_catalog.text NOT NULL,secret pg_catalog.text NOT NULL,previous_secret pg_catalog.text,previous_until pg_catalog.timestamptz,verified_until pg_catalog.timestamptz NOT NULL,
+ PRIMARY KEY(namespace,subscription_id,generation),FOREIGN KEY(namespace,subscription_id,generation) REFERENCES public.emseepea_event_capture_subscriptions(namespace,subscription_id,generation),CHECK((previous_secret IS NULL)=(previous_until IS NULL)))`,
+];
+const expected = {
+    emseepea_event_lifecycle_migrations: ['singleton:16:-1:true', 'version:23:-1:true', 'revision:25:-1:true'],
+    emseepea_event_heads: ['namespace:25:-1:true', 'subscription_id:25:-1:true', 'owner_key:25:-1:true', 'url:25:-1:false', 'revision:25:-1:true', 'generation:25:-1:false'],
+    emseepea_event_keys: ['namespace:25:-1:true', 'subscription_id:25:-1:true', 'generation:25:-1:true', 'secret:25:-1:true', 'previous_secret:25:-1:false', 'previous_until:1184:-1:false', 'verified_until:1184:-1:true'],
+};
+const catalog = `SELECT c.relname,c.relkind,c.relrowsecurity,c.relforcerowsecurity,pg_catalog.pg_get_userbyid(c.relowner)=current_user AS owned,
+ pg_catalog.array_agg(a.attname::pg_catalog.text||':'||a.atttypid::pg_catalog.text||':'||a.atttypmod::pg_catalog.text||':'||a.attnotnull::pg_catalog.text ORDER BY a.attnum) AS columns,
+ pg_catalog.jsonb_object_agg(a.attname,pg_catalog.pg_get_expr(d.adbin,d.adrelid)) AS defaults
+ FROM pg_catalog.pg_class c JOIN pg_catalog.pg_namespace n ON n.oid=c.relnamespace
+ JOIN pg_catalog.pg_attribute a ON a.attrelid=c.oid AND a.attnum>0 AND NOT a.attisdropped
+ LEFT JOIN pg_catalog.pg_attrdef d ON d.adrelid=c.oid AND d.adnum=a.attnum
+ WHERE n.nspname='public' AND c.relname=ANY($1::pg_catalog.text[]) GROUP BY c.oid,c.relname,c.relkind,c.relrowsecurity,c.relforcerowsecurity,c.relowner`;
+async function verify(run) {
+    const rows = (await run(catalog, [tables])).rows;
+    if (rows.length !== 3)
+        incompatible();
+    for (const row of rows) {
+        if (typeof row.relname !== 'string' || row.relkind !== 'r' || row.owned !== true || row.relrowsecurity !== false || row.relforcerowsecurity !== false || JSON.stringify(row.columns) !== JSON.stringify(expected[row.relname]))
+            incompatible();
+        const defaults = row.defaults;
+        if (!defaults || typeof defaults !== 'object')
+            incompatible();
+        for (const item of expected[String(row.relname)] ?? []) {
+            const column = item.split(':')[0];
+            if (defaults[column] !== (row.relname === tables[0] && column === 'singleton' ? 'true' : null))
+                incompatible();
+        }
+    }
+    const wanted = new Set([
+        [tables[0], 'p', 'PRIMARY KEY (singleton)'], [tables[0], 'c', 'CHECK (singleton)'],
+        [tables[1], 'p', 'PRIMARY KEY (namespace, subscription_id)'],
+        [tables[2], 'p', 'PRIMARY KEY (namespace, subscription_id, generation)'],
+        [tables[2], 'f', 'FOREIGN KEY (namespace, subscription_id, generation) REFERENCES emseepea_event_capture_subscriptions(namespace, subscription_id, generation)'],
+        [tables[2], 'c', 'CHECK (((previous_secret IS NULL) = (previous_until IS NULL)))'],
+    ].map(value => JSON.stringify(value)));
+    const constraints = (await run(`SELECT c.relname,t.contype,pg_catalog.pg_get_constraintdef(t.oid) AS definition,t.convalidated,t.condeferrable,t.condeferred,
+    CASE WHEN t.contype='p' THEN i.indisvalid AND i.indisready AND i.indisunique ELSE true END AS key_valid
+    FROM pg_catalog.pg_constraint t JOIN pg_catalog.pg_class c ON c.oid=t.conrelid JOIN pg_catalog.pg_namespace n ON n.oid=c.relnamespace
+    LEFT JOIN pg_catalog.pg_index i ON i.indexrelid=t.conindid WHERE n.nspname='public' AND c.relname=ANY($1::pg_catalog.text[])`, [tables])).rows;
+    for (const row of constraints)
+        if (row.convalidated !== true || row.condeferrable !== false || row.condeferred !== false || row.key_valid !== true || !wanted.delete(JSON.stringify([row.relname, row.contype, row.definition])))
+            incompatible();
+    if (wanted.size)
+        incompatible();
+    const indexes = (await run(`SELECT i.indexrelid FROM pg_catalog.pg_index i JOIN pg_catalog.pg_class c ON c.oid=i.indrelid JOIN pg_catalog.pg_namespace n ON n.oid=c.relnamespace
+    WHERE n.nspname='public' AND c.relname=ANY($1::pg_catalog.text[])`, [tables])).rows;
+    if (indexes.length !== 3)
+        incompatible();
+    const triggers = (await run(`SELECT t.oid FROM pg_catalog.pg_trigger t JOIN pg_catalog.pg_class c ON c.oid=t.tgrelid JOIN pg_catalog.pg_namespace n ON n.oid=c.relnamespace
+    WHERE n.nspname='public' AND c.relname=ANY($1::pg_catalog.text[]) AND NOT t.tgisinternal`, [tables])).rows;
+    if (triggers.length)
+        incompatible();
+    const marker = (await run('SELECT singleton,version,revision FROM public.emseepea_event_lifecycle_migrations')).rows;
+    if (marker.length !== 1 || marker[0]?.singleton !== true || marker[0].version !== 1 || marker[0].revision !== 'lifecycle-v1')
+        incompatible();
+}
+/** Runs the capture migration before the lifecycle migration. If the lifecycle migration fails, `capture-v1` can remain installed.
+ * The lifecycle migration rejects an existing populated capture-only subscription store because it cannot establish verification state safely.
+ * Serving constructors never call this function. The deployment owner must configure database grants.
+ */
+export function createPostgresEventLifecycleMigrator(pool) {
+    if (!pool || typeof pool.connect !== 'function')
+        throw new PostgresEventLifecycleMigrationError('UNAVAILABLE');
+    const owned = createOwnedEventOperations();
+    let closing = false;
+    const prerequisite = createPostgresEventCaptureMigrator(pool);
+    async function migrate(invocation) {
+        if (closing)
+            throw new PostgresEventLifecycleMigrationError('UNAVAILABLE');
+        let captureCommitted = false;
+        try {
+            await prerequisite.migrate(invocation);
+            captureCommitted = true;
+            await owned.run(pool, invocation, async (run) => {
+                await run('SELECT pg_catalog.pg_advisory_xact_lock(1740126,1)');
+                const found = (await run(catalog, [tables])).rows;
+                if (found.length === 0) {
+                    await run('LOCK TABLE public.emseepea_event_capture_subscriptions IN SHARE ROW EXCLUSIVE MODE');
+                    const present = (await run('SELECT 1 FROM public.emseepea_event_capture_subscriptions LIMIT 1')).rows;
+                    if (present.length)
+                        incompatible();
+                    for (const statement of ddl)
+                        await run(statement);
+                    await run("INSERT INTO public.emseepea_event_lifecycle_migrations VALUES(true,1,'lifecycle-v1')");
+                }
+                await verify(run);
+            }, false, error => error instanceof PostgresEventLifecycleMigrationError);
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error ? error.code : undefined;
+            throw new PostgresEventLifecycleMigrationError(code === 'OUTCOME_UNKNOWN' ? 'OUTCOME_UNKNOWN' : code === 'INCOMPATIBLE_SCHEMA' ? 'INCOMPATIBLE_SCHEMA' : 'UNAVAILABLE', captureCommitted ? 'lifecycle' : 'capture', captureCommitted);
+        }
+    }
+    return Object.freeze({
+        migrate(invocation) { return owned.track(migrate(invocation)); },
+        async settle(invocation) {
+            closing = true;
+            const results = await Promise.all([prerequisite.settle(invocation), owned.settle(invocation)]);
+            return results.every(Boolean);
+        },
+    });
+}
+//# sourceMappingURL=events-postgres-lifecycle-migrations.js.map

package/dist/events-postgres-lifecycle-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-postgres-lifecycle-migrations.js","sourceRoot":"","sources":["../src/events-postgres-lifecycle-migrations.ts"],"names":[],"mappings":"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"}

package/dist/events-postgres-lifecycle.d.ts

@@ -0,0 +1,13 @@
+import { type ExternalMcpEventLifecycle } from './events-external.js';
+import { type OwnedEventPool } from './events-postgres-owned.js';
+export { createPostgresEventLifecycleMigrator } from './events-postgres-lifecycle-migrations.js';
+export interface PostgresEventLifecycleOptions {
+    readonly namespace: string;
+    /** The observation pool must have `SELECT` access to subscription heads and subscriptions only. It must not have access to signing keys. */
+    readonly observationPool: OwnedEventPool;
+    /** The mutation pool must allow only the required lifecycle data changes. Keep it separate from the caller-owned capture role. */
+    readonly mutationPool: OwnedEventPool;
+}
+/** Creates the experimental PostgreSQL lifecycle implementation. Run the explicit migration first and configure finite timeouts on both PostgreSQL pools. */
+export declare function createPostgresEventLifecycle(options: PostgresEventLifecycleOptions): ExternalMcpEventLifecycle;
+//# sourceMappingURL=events-postgres-lifecycle.d.ts.map

package/dist/events-postgres-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-postgres-lifecycle.d.ts","sourceRoot":"","sources":["../src/events-postgres-lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,yBAAyB,EAAmE,MAAM,sBAAsB,CAAC;AAE9J,OAAO,EAA8B,KAAK,cAAc,EAAiB,MAAM,4BAA4B,CAAC;AAC5G,OAAO,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AACjG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAC,MAAM,CAAC;IAC1B,4IAA4I;IAC5I,QAAQ,CAAC,eAAe,EAAC,cAAc,CAAC;IACxC,kIAAkI;IAClI,QAAQ,CAAC,YAAY,EAAC,cAAc,CAAC;CACtC;AAuCD,6JAA6J;AAC7J,wBAAgB,4BAA4B,CAAC,OAAO,EAAC,6BAA6B,GAAE,yBAAyB,CAuF5G"}