@emseepea/server 0.23.1 → 0.24.1

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

package/dist/events-postgres-lifecycle.js

@@ -0,0 +1,176 @@
+import { randomUUID } from 'node:crypto';
+import { isIP } from 'node:net';
+import { ExternalMcpEventError } from './events-external.js';
+import { mcpEventSubscriptionIdentity } from './events.js';
+import { createOwnedEventOperations } from './events-postgres-owned.js';
+export { createPostgresEventLifecycleMigrator } from './events-postgres-lifecycle-migrations.js';
+const fail = (code) => { throw new ExternalMcpEventError(code); };
+function text(value, max = 240) {
+    if (typeof value !== 'string' || !value || Buffer.byteLength(value) > max || /\u0000|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(value))
+        fail('INVALID_INPUT');
+    return value;
+}
+function json(value, depth = 0) {
+    if (depth > 32)
+        fail('INVALID_INPUT');
+    if (value === null || typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value) && !Object.is(value, -0))
+        return value;
+    if (typeof value === 'string') {
+        if (value)
+            text(value, 65536);
+        return value;
+    }
+    if (!value || typeof value !== 'object' || !(Array.isArray(value) ? Object.getPrototypeOf(value) === Array.prototype : [null, Object.prototype].includes(Object.getPrototypeOf(value))))
+        fail('INVALID_INPUT');
+    const fields = Object.getOwnPropertyDescriptors(value), array = Array.isArray(value), result = array ? [] : Object.create(null);
+    if (array && Reflect.ownKeys(fields).length !== value.length + 1)
+        fail('INVALID_INPUT');
+    for (const key of Reflect.ownKeys(fields)) {
+        if (typeof key !== 'string' || /\u0000|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(key))
+            fail('INVALID_INPUT');
+        const item = fields[key];
+        if (!('value' in item) || !item.enumerable && !(array && key === 'length'))
+            fail('INVALID_INPUT');
+        if (array && key === 'length')
+            continue;
+        if (array && !/^(0|[1-9][0-9]*)$/.test(key))
+            fail('INVALID_INPUT');
+        result[key] = json(item.value, depth + 1);
+    }
+    return Object.freeze(result);
+}
+function request(value) {
+    const copy = json(value);
+    if (!copy || Array.isArray(copy) || typeof copy !== 'object' || Buffer.byteLength(JSON.stringify(copy)) > 65536)
+        fail('INVALID_INPUT');
+    return copy;
+}
+function identity(value) {
+    const id = text(value.id), ownerKey = text(value.ownerKey, 256), name = text(value.name), url = text(value.url, 8192), args = value.arguments;
+    if (!args || typeof args !== 'object' || Array.isArray(args))
+        fail('INVALID_INPUT');
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return fail('INVALID_INPUT');
+    }
+    if (parsed.href !== url || parsed.protocol !== 'https:' || parsed.username || parsed.password || parsed.hash || parsed.port && parsed.port !== '443' || isIP(parsed.hostname.replace(/^\[|\]$/g, '')) || parsed.hostname === 'localhost' || parsed.hostname.endsWith('.localhost') || parsed.hostname.endsWith('.local'))
+        fail('INVALID_INPUT');
+    if (mcpEventSubscriptionIdentity(ownerKey, name, args, url) !== id)
+        fail('INVALID_INPUT');
+    return Object.freeze({ id, ownerKey, name, url, arguments: args });
+}
+const dbTime = `pg_catalog.floor(EXTRACT(epoch FROM pg_catalog.clock_timestamp())*1000)::pg_catalog.float8`;
+const conflict = () => fail('SUBSCRIPTION_CHANGED');
+const validMs = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+/** Creates the experimental PostgreSQL lifecycle implementation. Run the explicit migration first and configure finite timeouts on both PostgreSQL pools. */
+export function createPostgresEventLifecycle(options) {
+    const namespace = text(options?.namespace);
+    if (!options.observationPool || !options.mutationPool || typeof options.observationPool.connect !== 'function' || typeof options.mutationPool.connect !== 'function')
+        fail('INVALID_INPUT');
+    const owned = createOwnedEventOperations();
+    async function locked(run, i) {
+        const inserted = (await run(`INSERT INTO public.emseepea_event_heads(namespace,subscription_id,owner_key,url,revision,generation)
+      VALUES($1,$2,$3,NULL,$4,NULL) ON CONFLICT(namespace,subscription_id) DO NOTHING RETURNING revision`, [namespace, i.id, i.ownerKey, randomUUID()])).rows.length === 1;
+        const row = (await run(`SELECT owner_key,url,revision,generation FROM public.emseepea_event_heads WHERE namespace=$1 AND subscription_id=$2 FOR UPDATE`, [namespace, i.id])).rows[0];
+        if (!row || row.owner_key !== i.ownerKey || typeof row.revision !== 'string')
+            return conflict();
+        return { row, inserted };
+    }
+    async function current(run, i, generation) {
+        if (generation === null)
+            return null;
+        const row = (await run(`SELECT owner_key,event_name,arguments,active,pg_catalog.floor(EXTRACT(epoch FROM expires_at)*1000)::pg_catalog.float8 AS expires_at
+      FROM public.emseepea_event_capture_subscriptions WHERE namespace=$1 AND subscription_id=$2 AND generation=$3`, [namespace, i.id, generation])).rows[0];
+        if (!row || row.owner_key !== i.ownerKey || row.event_name !== i.name || mcpEventSubscriptionIdentity(i.ownerKey, i.name, row.arguments, i.url) !== i.id || !validMs(row.expires_at) || typeof row.active !== 'boolean')
+            return fail('UNAVAILABLE');
+        return row;
+    }
+    return Object.freeze({
+        async observe(input, invocation) {
+            const i = identity(request(input));
+            return owned.run(options.observationPool, invocation, async (run) => {
+                const row = (await run(`WITH clock AS MATERIALIZED(SELECT ${dbTime} AS now)
+          SELECT clock.now,h.owner_key,h.url,h.revision,h.generation,s.owner_key AS capture_owner,s.event_name,s.arguments,s.active,
+          pg_catalog.floor(EXTRACT(epoch FROM s.expires_at)*1000)::pg_catalog.float8 AS expires_at
+          FROM clock LEFT JOIN public.emseepea_event_heads h ON h.namespace=$1 AND h.subscription_id=$2
+          LEFT JOIN public.emseepea_event_capture_subscriptions s ON s.namespace=h.namespace AND s.subscription_id=h.subscription_id AND s.generation=h.generation`, [namespace, i.id])).rows[0];
+                if (!row || !validMs(row.now))
+                    return fail('UNAVAILABLE');
+                const base = { id: i.id, ownerKey: i.ownerKey, observedAt: row.now };
+                if (row.revision === null)
+                    return { ...base, revision: null, generation: null, active: false, subscription: null };
+                if (row.owner_key !== i.ownerKey || typeof row.revision !== 'string' || !(row.generation === null || typeof row.generation === 'string'))
+                    return fail('UNAVAILABLE');
+                if (row.url === null)
+                    return { ...base, revision: row.revision, generation: row.generation, active: false, subscription: null };
+                if (row.url !== i.url || row.capture_owner !== i.ownerKey || row.event_name !== i.name || !validMs(row.expires_at) || typeof row.active !== 'boolean' || mcpEventSubscriptionIdentity(i.ownerKey, i.name, row.arguments, i.url) !== i.id)
+                    return fail('UNAVAILABLE');
+                return { ...base, revision: row.revision, generation: row.generation, active: row.active && row.expires_at > row.now,
+                    subscription: { id: i.id, ownerKey: i.ownerKey, name: i.name, arguments: row.arguments, url: i.url, expiresAt: row.expires_at } };
+            }, true);
+        },
+        async activate(input, invocation) {
+            const value = request(input), i = identity(value);
+            const expected = value.expectedRevision;
+            if (!(expected === null || typeof expected === 'string' && text(expected)) || !['new', 'renew'].includes(value.intent) || !Number.isSafeInteger(value.ttlMs) || Number(value.ttlMs) < 1 || Number(value.ttlMs) > 86400000)
+                fail('INVALID_INPUT');
+            const secret = text(value.secret, 100);
+            if (!secret.startsWith('whsec_'))
+                fail('INVALID_INPUT');
+            const decoded = Buffer.from(secret.slice(6), 'base64');
+            if (decoded.length < 24 || decoded.length > 64 || decoded.toString('base64') !== secret.slice(6))
+                fail('INVALID_INPUT');
+            return owned.run(options.mutationPool, invocation, async (run) => {
+                const { row, inserted } = await locked(run, i);
+                if (expected === null ? !inserted : inserted || row.revision !== expected)
+                    return conflict();
+                if (row.url !== null && row.generation === null)
+                    return fail('UNAVAILABLE');
+                const prior = await current(run, i, row.generation);
+                if (row.url !== null && row.url !== i.url)
+                    return fail('UNAVAILABLE');
+                const now = (await run(`SELECT ${dbTime} AS now`)).rows[0]?.now;
+                if (!validMs(now))
+                    return fail('UNAVAILABLE');
+                const active = row.url !== null && prior?.active === true && Number(prior.expires_at) > now;
+                if (value.intent === 'renew' ? !active : active)
+                    return conflict();
+                const expiresAt = now + Number(value.ttlMs), generation = value.intent === 'renew' ? String(row.generation) : randomUUID(), revision = randomUUID();
+                if (value.intent === 'new') {
+                    await run('UPDATE public.emseepea_event_capture_subscriptions SET active=false WHERE namespace=$1 AND subscription_id=$2 AND active', [namespace, i.id]);
+                    await run('DELETE FROM public.emseepea_event_keys WHERE namespace=$1 AND subscription_id=$2', [namespace, i.id]);
+                    await run(`INSERT INTO public.emseepea_event_capture_subscriptions(namespace,subscription_id,generation,owner_key,event_name,arguments,active,expires_at)
+            VALUES($1,$2,$3,$4,$5,$6::pg_catalog.jsonb,true,pg_catalog.to_timestamp($7::pg_catalog.float8/1000))`, [namespace, i.id, generation, i.ownerKey, i.name, JSON.stringify(i.arguments), expiresAt]);
+                    await run(`INSERT INTO public.emseepea_event_keys(namespace,subscription_id,generation,secret,previous_secret,previous_until,verified_until)
+            VALUES($1,$2,$3,$4,NULL,NULL,pg_catalog.to_timestamp($5::pg_catalog.float8/1000))`, [namespace, i.id, generation, secret, Math.min(now + 300000, expiresAt)]);
+                }
+                else {
+                    const key = (await run('SELECT secret FROM public.emseepea_event_keys WHERE namespace=$1 AND subscription_id=$2 AND generation=$3', [namespace, i.id, generation])).rows[0];
+                    if (typeof key?.secret !== 'string')
+                        return fail('UNAVAILABLE');
+                    await run(`UPDATE public.emseepea_event_keys SET previous_secret=CASE WHEN secret=$4 THEN previous_secret ELSE secret END,
+            previous_until=CASE WHEN secret=$4 THEN previous_until ELSE pg_catalog.to_timestamp($5::pg_catalog.float8/1000) END,
+            secret=$4,verified_until=pg_catalog.to_timestamp($5::pg_catalog.float8/1000) WHERE namespace=$1 AND subscription_id=$2 AND generation=$3`, [namespace, i.id, generation, secret, Math.min(now + 300000, expiresAt)]);
+                    await run(`UPDATE public.emseepea_event_capture_subscriptions SET expires_at=pg_catalog.to_timestamp($4::pg_catalog.float8/1000) WHERE namespace=$1 AND subscription_id=$2 AND generation=$3`, [namespace, i.id, generation, expiresAt]);
+                }
+                await run('UPDATE public.emseepea_event_heads SET url=$3,revision=$4,generation=$5 WHERE namespace=$1 AND subscription_id=$2', [namespace, i.id, i.url, revision, generation]);
+                return { id: i.id, revision, generation, observedAt: now, expiresAt };
+            });
+        },
+        async revoke(input, invocation) {
+            const i = identity(request(input));
+            await owned.run(options.mutationPool, invocation, async (run) => {
+                await locked(run, i);
+                await run('UPDATE public.emseepea_event_capture_subscriptions SET active=false WHERE namespace=$1 AND subscription_id=$2 AND active', [namespace, i.id]);
+                await run("UPDATE public.emseepea_event_intents SET state='revoked' WHERE namespace=$1 AND subscription_id=$2 AND state='pending'", [namespace, i.id]);
+                await run('DELETE FROM public.emseepea_event_keys WHERE namespace=$1 AND subscription_id=$2', [namespace, i.id]);
+                await run('UPDATE public.emseepea_event_heads SET url=NULL,revision=$3 WHERE namespace=$1 AND subscription_id=$2', [namespace, i.id, randomUUID()]);
+            });
+        },
+        settle: owned.settle,
+    });
+}
+//# sourceMappingURL=events-postgres-lifecycle.js.map

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

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

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

@@ -0,0 +1,32 @@
+import type { PostgresEventClient, PostgresEventInvocation } from "./events-postgres.js";
+export interface PostgresEventMigrationClient extends PostgresEventClient {
+    release(error?: Error): void;
+}
+export interface PostgresEventMigrationPool {
+    connect(): Promise<PostgresEventMigrationClient>;
+}
+export declare class PostgresEventMigrationError extends Error {
+    readonly code: "INVALID_INPUT" | "DEADLINE" | "ABORTED" | "INCOMPATIBLE_SCHEMA" | "UNAVAILABLE" | "OUTCOME_UNKNOWN";
+    constructor(code: "INVALID_INPUT" | "DEADLINE" | "ABORTED" | "INCOMPATIBLE_SCHEMA" | "UNAVAILABLE" | "OUTCOME_UNKNOWN");
+}
+/** Deployment migrations. `createPostgresEventCapture` never applies them. */
+export declare const postgresEventCaptureMigrations: readonly Readonly<{
+    version: 1;
+    revision: "capture-v1";
+    statements: readonly string[];
+}>[];
+/** Runs deployment migrations using only the acquired connection, which this function owns.
+ * Supported pools must also configure finite acquisition and query timeouts. A local timeout
+ * does not prove that PostgreSQL cancelled the operation. Connections with an uncertain outcome
+ * are discarded.
+ */
+export declare function migratePostgresEventCapture(pool: PostgresEventMigrationPool, invocation: PostgresEventInvocation): Promise<void>;
+/** Creates lifecycle-managed migration operations for composed deployments. The standalone
+ * migration function retains its existing contract. This owner stops accepting work when
+ * shutdown begins, never closes the supplied pool, and does not treat a caller-facing
+ * deadline as proof of SQL cancellation. */
+export declare function createPostgresEventCaptureMigrator(pool: PostgresEventMigrationPool): Readonly<{
+    migrate(invocation: PostgresEventInvocation): Promise<void>;
+    settle(invocation: PostgresEventInvocation): Promise<boolean>;
+}>;
+//# sourceMappingURL=events-postgres-migrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events-postgres-migrations.d.ts","sourceRoot":"","sources":["../src/events-postgres-migrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IAAG,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE;AAC1G,MAAM,WAAW,0BAA0B;IAAG,OAAO,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAA;CAAE;AAChG,qBAAa,2BAA4B,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,qBAAqB,GAAG,aAAa,GAAG,iBAAiB;gBAA1G,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,qBAAqB,GAAG,aAAa,GAAG,iBAAiB;CAGhI;AA2BD,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B;;;;IAAuF,CAAC;AAuFnI;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,0BAA0B,EAAE,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EtI;AAED;;;4CAG4C;AAC5C,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,0BAA0B;wBA8BrD,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;uBAsBxC,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;GAKtE"}