@rotorsoft/act-pg 0.9.0 → 0.10.0

package/dist/@types/PostgresStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PostgresStore.d.ts","sourceRoot":"","sources":["../../src/PostgresStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,IAAI,EACJ,KAAK,EACL,OAAO,EACP,KAAK,EACN,MAAM,gBAAgB,CAAC;AAUxB,KAAK,MAAM,GAAG,QAAQ,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAYH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2GG;AACH,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,KAAK,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;OAGG;gBACS,MAAM,GAAE,OAAO,CAAC,MAAM,CAAM;IAOxC;;;OAGG;IACG,OAAO;IAIb;;;;OAIG;IACG,IAAI;IA4EV;;;OAGG;IACG,IAAI;IAoBV;;;;;;;;;OASG;IACG,KAAK,CAAC,CAAC,SAAS,OAAO,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK;IAqEf;;;;;;;;;OASG;IACG,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM;IA+D1B;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAgC3C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA4E9D;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgD5C;;;;OAIG;IACG,KAAK,CACT,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACvC,OAAO,CAAC,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CA6C1C"}
+{"version":3,"file":"PostgresStore.d.ts","sourceRoot":"","sources":["../../src/PostgresStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAK,EACL,OAAO,EACP,KAAK,EACN,MAAM,gBAAgB,CAAC;AAUxB,KAAK,MAAM,GAAG,QAAQ,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAYH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2GG;AACH,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,KAAK,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;OAGG;gBACS,MAAM,GAAE,OAAO,CAAC,MAAM,CAAM;IAOxC;;;OAGG;IACG,OAAO;IAIb;;;;OAIG;IACG,IAAI;IA4EV;;;OAGG;IACG,IAAI;IAoBV;;;;;;;;;OASG;IACG,KAAK,CAAC,CAAC,SAAS,OAAO,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK;IAqEf;;;;;;;;;OASG;IACG,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM;IA+D1B;;;;;;;;;;;;;OAaG;IACG,KAAK,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,EAAE,CAAC;IAmEnB;;;;;OAKG;IACG,SAAS,CACb,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgD5C;;;;OAIG;IACG,KAAK,CACT,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACvC,OAAO,CAAC,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CA6C1C"}

package/dist/index.cjs

@@ -316,105 +316,70 @@ var PostgresStore = class {
     }
   }
   /**
-   * Polls the store for unblocked streams needing processing, ordered by lease watermark ascending.
-   * @param lagging - Max number of streams to poll in ascending order.
-   * @param leading - Max number of streams to poll in descending order.
-   * @returns The polled streams.
-   */
-  async poll(lagging, leading) {
-    const { rows } = await this._pool.query(
-      `
-      WITH
-      lag AS (
-        SELECT stream, source, at, TRUE AS lagging
-        FROM ${this._fqs}
-        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())
-        ORDER BY at ASC
-        LIMIT $1
-      ),
-      lead AS (
-        SELECT stream, source, at, FALSE AS lagging
-        FROM ${this._fqs}
-        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())
-        ORDER BY at DESC
-        LIMIT $2
-      ),
-      combined AS (
-        SELECT * FROM lag
-        UNION ALL
-        SELECT * FROM lead
-      )
-      SELECT DISTINCT ON (stream) stream, source, at, lagging
-      FROM combined
-      ORDER BY stream, at;
-      `,
-      [lagging, leading]
-    );
-    return rows;
-  }
-  /**
-   * Lease streams for reaction processing, marking them as in-progress.
+   * Atomically discovers and leases streams for reaction processing.
+   *
+   * Uses `FOR UPDATE SKIP LOCKED` to implement zero-contention competing consumers:
+   * - Workers never block each other — locked rows are silently skipped
+   * - Discovery and locking happen in a single atomic transaction
+   * - No wasted polls — every returned stream is exclusively owned
    *
-   * @param leases - Lease requests for streams, including end-of-lease watermark, lease holder, and source stream.
-   * @param millis - Lease duration in milliseconds.
-   * @returns Array of leased objects with updated lease info
+   * @param lagging - Max streams from lagging frontier (ascending watermark)
+   * @param leading - Max streams from leading frontier (descending watermark)
+   * @param by - Lease holder identifier (UUID)
+   * @param millis - Lease duration in milliseconds
+   * @returns Leased streams with metadata
    */
-  async lease(leases, millis) {
+  async claim(lagging, leading, by, millis) {
     const client = await this._pool.connect();
     try {
       await client.query("BEGIN");
-      await client.query(
-        `
-        INSERT INTO ${this._fqs} (stream, source)
-        SELECT lease->>'stream', lease->>'source'
-        FROM jsonb_array_elements($1::jsonb) AS lease
-        ON CONFLICT (stream) DO NOTHING
-        `,
-        [JSON.stringify(leases)]
-      );
       const { rows } = await client.query(
         `
-      WITH input AS (
-        SELECT * FROM jsonb_to_recordset($1::jsonb)
-        AS x(stream text, at int, by text, lagging boolean)
-      ), free AS (
-        SELECT s.stream FROM ${this._fqs} s
-        JOIN input i ON s.stream = i.stream
-        WHERE s.leased_by IS NULL OR s.leased_until <= NOW()
-        FOR UPDATE
-      )
-      UPDATE ${this._fqs} s
-      SET
-        leased_by = i.by,
-        leased_at = i.at,
-        leased_until = NOW() + ($2::integer || ' milliseconds')::interval,
-        retry = CASE WHEN $2::integer > 0 THEN s.retry + 1 ELSE s.retry END
-      FROM input i, free f
-      WHERE s.stream = f.stream AND s.stream = i.stream
-      RETURNING s.stream, s.source, s.leased_at, s.leased_by, s.leased_until, s.retry, i.lagging
-      `,
-        [JSON.stringify(leases), millis]
+        WITH
+        available AS (
+          SELECT stream, source, at
+          FROM ${this._fqs}
+          WHERE blocked = false
+            AND (leased_by IS NULL OR leased_until <= NOW())
+          FOR UPDATE SKIP LOCKED
+        ),
+        lag AS (
+          SELECT stream, source, at, TRUE AS lagging
+          FROM available
+          ORDER BY at ASC
+          LIMIT $1
+        ),
+        lead AS (
+          SELECT stream, source, at, FALSE AS lagging
+          FROM available
+          ORDER BY at DESC
+          LIMIT $2
+        ),
+        combined AS (
+          SELECT DISTINCT ON (stream) stream, source, at, lagging
+          FROM (SELECT * FROM lag UNION ALL SELECT * FROM lead) t
+          ORDER BY stream, at
+        )
+        UPDATE ${this._fqs} s
+        SET
+          leased_by = $3,
+          leased_until = NOW() + ($4::integer || ' milliseconds')::interval,
+          retry = s.retry + 1
+        FROM combined c
+        WHERE s.stream = c.stream
+        RETURNING s.stream, s.source, s.at, s.retry, c.lagging
+        `,
+        [lagging, leading, by, millis]
       );
       await client.query("COMMIT");
-      return rows.map(
-        ({
-          stream,
-          source,
-          leased_at,
-          leased_by,
-          leased_until,
-          retry,
-          lagging
-        }) => ({
-          stream,
-          source: source ?? void 0,
-          at: leased_at,
-          by: leased_by,
-          until: new Date(leased_until),
-          retry,
-          lagging
-        })
-      );
+      return rows.map(({ stream, source, at, retry, lagging: lagging2 }) => ({
+        stream,
+        source: source ?? void 0,
+        at,
+        by,
+        retry,
+        lagging: lagging2
+      }));
     } catch (error) {
       await client.query("ROLLBACK").catch(() => {
       });
@@ -424,6 +389,25 @@ var PostgresStore = class {
       client.release();
     }
   }
+  /**
+   * Registers streams for event processing.
+   * Upserts stream entries so they become visible to claim().
+   * @param streams - Streams to register with optional source.
+   * @returns Number of newly registered streams.
+   */
+  async subscribe(streams) {
+    if (!streams.length) return 0;
+    const { rowCount } = await this._pool.query(
+      `
+      INSERT INTO ${this._fqs} (stream, source)
+      SELECT s->>'stream', s->>'source'
+      FROM jsonb_array_elements($1::jsonb) AS s
+      ON CONFLICT (stream) DO NOTHING
+      `,
+      [JSON.stringify(streams)]
+    );
+    return rowCount ?? 0;
+  }
   /**
    * Acknowledge and release leases after processing, updating stream positions.
    *

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/PostgresStore.ts","../src/utils.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * @module act-pg\n * Main entry point for the Act-PG framework. Re-exports all core APIs\n */\nexport * from \"./PostgresStore.js\";\n","import type {\n  Committed,\n  EventMeta,\n  Lease,\n  Message,\n  Poll,\n  Query,\n  Schemas,\n  Store,\n} from \"@rotorsoft/act\";\nimport { ConcurrencyError, SNAP_EVENT, logger } from \"@rotorsoft/act\";\nimport pg from \"pg\";\nimport { dateReviver } from \"./utils.js\";\n\nconst { Pool, types } = pg;\ntypes.setTypeParser(types.builtins.JSONB, (val) =>\n  JSON.parse(val, dateReviver)\n);\n\ntype Config = Readonly<{\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  schema: string;\n  table: string;\n}>;\n\nconst DEFAULT_CONFIG: Config = {\n  host: \"localhost\",\n  port: 5432,\n  database: \"postgres\",\n  user: \"postgres\",\n  password: \"postgres\",\n  schema: \"public\",\n  table: \"events\",\n};\n\n/**\n * Production-ready PostgreSQL event store implementation.\n *\n * PostgresStore provides persistent, scalable event storage using PostgreSQL.\n * It implements the full {@link Store} interface with production-grade features:\n *\n * **Features:**\n * - Persistent event storage with ACID guarantees\n * - Optimistic concurrency control via version numbers\n * - Distributed stream processing with leasing\n * - Snapshot support for performance optimization\n * - Connection pooling for scalability\n * - Automatic table and index creation\n *\n * **Database Schema:**\n * - Events table: Stores all committed events\n * - Streams table: Tracks stream metadata and leases\n * - Indexes on stream, version, and timestamps for fast queries\n *\n * @example Basic setup\n * ```typescript\n * import { store } from \"@rotorsoft/act\";\n * import { PostgresStore } from \"@rotorsoft/act-pg\";\n *\n * store(new PostgresStore({\n *   host: \"localhost\",\n *   port: 5432,\n *   database: \"myapp\",\n *   user: \"postgres\",\n *   password: \"secret\"\n * }));\n *\n * const app = act()\n *   .withState(Counter)\n *   .build();\n * ```\n *\n * @example With custom schema and table\n * ```typescript\n * import { PostgresStore } from \"@rotorsoft/act-pg\";\n *\n * const pgStore = new PostgresStore({\n *   host: process.env.DB_HOST || \"localhost\",\n *   port: parseInt(process.env.DB_PORT || \"5432\"),\n *   database: process.env.DB_NAME || \"myapp\",\n *   user: process.env.DB_USER || \"postgres\",\n *   password: process.env.DB_PASSWORD,\n *   schema: \"events\",      // Custom schema\n *   table: \"act_events\"    // Custom table name\n * });\n *\n * // Initialize tables\n * await pgStore.seed();\n * ```\n *\n * @example Connection pooling configuration\n * ```typescript\n * // PostgresStore uses node-postgres (pg) connection pooling\n * // Pool is created automatically with default settings\n * // For custom pool config, use environment variables:\n * //   PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD\n * //   PGMAXCONNECTIONS, PGIDLETIMEOUT, etc.\n *\n * const pgStore = new PostgresStore({\n *   host: \"db.example.com\",\n *   port: 5432,\n *   database: \"production\",\n *   user: \"app_user\",\n *   password: process.env.DB_PASSWORD\n * });\n * ```\n *\n * @example Multi-tenant setup\n * ```typescript\n * // Use separate schemas per tenant\n * const tenants = [\"tenant1\", \"tenant2\", \"tenant3\"];\n *\n * for (const tenant of tenants) {\n *   const tenantStore = new PostgresStore({\n *     host: \"localhost\",\n *     database: \"multitenant\",\n *     schema: tenant,        // Each tenant gets own schema\n *     table: \"events\"\n *   });\n *   await tenantStore.seed();\n * }\n * ```\n *\n * @example Querying PostgreSQL directly\n * ```typescript\n * // For advanced queries, you can access pg client\n * const pgStore = new PostgresStore(config);\n * await pgStore.seed();\n *\n * // Use the store's query method for standard queries\n * await pgStore.query(\n *   (event) => console.log(event),\n *   { stream: \"user-123\", limit: 100 }\n * );\n * ```\n *\n * @see {@link Store} for the interface definition\n * @see {@link InMemoryStore} for development/testing\n * @see {@link store} for injecting stores\n * @see {@link https://node-postgres.com/ | node-postgres documentation}\n *\n * @category Adapters\n */\nexport class PostgresStore implements Store {\n  private _pool;\n  readonly config: Config;\n  private _fqt: string;\n  private _fqs: string;\n\n  /**\n   * Create a new PostgresStore instance.\n   * @param config Partial configuration (host, port, user, password, schema, table, etc.)\n   */\n  constructor(config: Partial<Config> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this._pool = new Pool(this.config);\n    this._fqt = `\"${this.config.schema}\".\"${this.config.table}\"`;\n    this._fqs = `\"${this.config.schema}\".\"${this.config.table}_streams\"`;\n  }\n\n  /**\n   * Dispose of the store and close all database connections.\n   * @returns Promise that resolves when all connections are closed\n   */\n  async dispose() {\n    await this._pool.end();\n  }\n\n  /**\n   * Seed the database with required tables, indexes, and schema for event storage.\n   * @returns Promise that resolves when seeding is complete\n   * @throws Error if seeding fails\n   */\n  async seed() {\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n\n      // Create schema\n      await client.query(\n        `CREATE SCHEMA IF NOT EXISTS \"${this.config.schema}\";`\n      );\n\n      // Events table\n      await client.query(\n        `CREATE TABLE IF NOT EXISTS ${this._fqt} (\n          id serial PRIMARY KEY,\n          name varchar(100) COLLATE pg_catalog.\"default\" NOT NULL,\n          data jsonb,\n          stream varchar(100) COLLATE pg_catalog.\"default\" NOT NULL,\n          version int NOT NULL,\n          created timestamptz NOT NULL DEFAULT now(),\n          meta jsonb\n        ) TABLESPACE pg_default;`\n      );\n\n      // Indexes on events\n      await client.query(\n        `CREATE UNIQUE INDEX IF NOT EXISTS \"${this.config.table}_stream_ix\" \n        ON ${this._fqt} (stream COLLATE pg_catalog.\"default\", version);`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_name_ix\" \n        ON ${this._fqt} (name COLLATE pg_catalog.\"default\");`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_created_id_ix\" \n        ON ${this._fqt} (created, id);`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_correlation_ix\" \n        ON ${this._fqt} ((meta ->> 'correlation') COLLATE pg_catalog.\"default\");`\n      );\n\n      // Streams table\n      await client.query(\n        `CREATE TABLE IF NOT EXISTS ${this._fqs} (\n          stream varchar(100) COLLATE pg_catalog.\"default\" PRIMARY KEY,\n          source varchar(100) COLLATE pg_catalog.\"default\",\n          at int NOT NULL DEFAULT -1,\n          retry smallint NOT NULL DEFAULT 0,\n          blocked boolean NOT NULL DEFAULT false,\n          error text,\n          leased_at int,\n          leased_by text,\n          leased_until timestamptz\n        ) TABLESPACE pg_default;`\n      );\n\n      // Index for fetching streams\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_streams_fetch_ix\" \n        ON ${this._fqs} (blocked, at);`\n      );\n\n      await client.query(\"COMMIT\");\n      logger.info(\n        `Seeded schema \"${this.config.schema}\" with table \"${this.config.table}\"`\n      );\n    } catch (error) {\n      await client.query(\"ROLLBACK\");\n      logger.error(error);\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Drop all tables and schema created by the store (for testing or cleanup).\n   * @returns Promise that resolves when the schema is dropped\n   */\n  async drop() {\n    await this._pool.query(\n      `\n      DO $$\n      BEGIN\n        IF EXISTS (SELECT 1 FROM information_schema.schemata\n          WHERE schema_name = '${this.config.schema}'\n        ) THEN\n          EXECUTE 'DROP TABLE IF EXISTS ${this._fqt}';\n          EXECUTE 'DROP TABLE IF EXISTS ${this._fqs}';\n          IF '${this.config.schema}' <> 'public' THEN\n            EXECUTE 'DROP SCHEMA \"${this.config.schema}\" CASCADE';\n          END IF;\n        END IF;\n      END\n      $$;\n    `\n    );\n  }\n\n  /**\n   * Query events from the store, optionally filtered by stream, event name, time, etc.\n   *\n   * @param callback Function called for each event found\n   * @param query (Optional) Query filter (stream, names, before, after, etc.)\n   * @returns The number of events found\n   *\n   * @example\n   * await store.query((event) => console.log(event), { stream: \"A\" });\n   */\n  async query<E extends Schemas>(\n    callback: (event: Committed<E, keyof E>) => void,\n    query?: Query\n  ) {\n    const {\n      stream,\n      names,\n      before,\n      after,\n      limit,\n      created_before,\n      created_after,\n      backward,\n      correlation,\n      with_snaps = false,\n    } = query || {};\n\n    let sql = `SELECT * FROM ${this._fqt}`;\n    const conditions: string[] = [];\n    const values: any[] = [];\n\n    if (query) {\n      if (typeof after !== \"undefined\") {\n        values.push(after);\n        conditions.push(`id>$${values.length}`);\n      } else {\n        conditions.push(\"id>-1\");\n      }\n      if (stream) {\n        values.push(stream);\n        conditions.push(`stream ~ $${values.length}`);\n      }\n      if (names && names.length) {\n        values.push(names);\n        conditions.push(`name = ANY($${values.length})`);\n      }\n      if (before) {\n        values.push(before);\n        conditions.push(`id<$${values.length}`);\n      }\n      if (created_after) {\n        values.push(created_after.toISOString());\n        conditions.push(`created>$${values.length}`);\n      }\n      if (created_before) {\n        values.push(created_before.toISOString());\n        conditions.push(`created<$${values.length}`);\n      }\n      if (correlation) {\n        values.push(correlation);\n        conditions.push(`meta->>'correlation'=$${values.length}`);\n      }\n      if (!with_snaps) {\n        conditions.push(`name <> '${SNAP_EVENT}'`);\n      }\n    }\n    if (conditions.length) {\n      sql += \" WHERE \" + conditions.join(\" AND \");\n    }\n    sql += ` ORDER BY id ${backward ? \"DESC\" : \"ASC\"}`;\n    if (limit) {\n      values.push(limit);\n      sql += ` LIMIT $${values.length}`;\n    }\n\n    const result = await this._pool.query<Committed<E, keyof E>>(sql, values);\n    for (const row of result.rows) callback(row);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Commit new events to the store for a given stream, with concurrency control.\n   *\n   * @param stream The stream name\n   * @param msgs Array of messages (event name and data)\n   * @param meta Event metadata (correlation, causation, etc.)\n   * @param expectedVersion (Optional) Expected stream version for concurrency control\n   * @returns Array of committed events\n   * @throws ConcurrencyError if the expected version does not match\n   */\n  async commit<E extends Schemas>(\n    stream: string,\n    msgs: Message<E, keyof E>[],\n    meta: EventMeta,\n    expectedVersion?: number\n  ) {\n    if (msgs.length === 0) return [];\n    const client = await this._pool.connect();\n    let version = -1;\n    try {\n      await client.query(\"BEGIN\");\n\n      const last = await client.query<Committed<E, keyof E>>(\n        `SELECT version\n        FROM ${this._fqt}\n        WHERE stream=$1 ORDER BY version DESC LIMIT 1`,\n        [stream]\n      );\n      version = last.rowCount ? last.rows[0].version : -1;\n      if (typeof expectedVersion === \"number\" && version !== expectedVersion)\n        throw new ConcurrencyError(\n          stream,\n          version,\n          msgs as unknown as Message<Schemas, string>[],\n          expectedVersion\n        );\n\n      const committed: Committed<E, keyof E>[] = [];\n      for (const { name, data } of msgs) {\n        version++;\n        const sql = `\n          INSERT INTO ${this._fqt}(name, data, stream, version, meta)\n          VALUES($1, $2, $3, $4, $5) RETURNING *`;\n        const vals = [name, data, stream, version, meta];\n        const { rows } = await client.query<Committed<E, keyof E>>(sql, vals);\n        committed.push(rows.at(0)!);\n      }\n\n      await client\n        .query(\n          `\n            NOTIFY \"${this.config.table}\", '${JSON.stringify({\n              operation: \"INSERT\",\n              id: committed[0].name,\n              position: committed[0].id,\n            })}';\n            COMMIT;\n            `\n        )\n        .catch((error) => {\n          logger.error(error);\n          throw new ConcurrencyError(\n            stream,\n            version,\n            msgs as unknown as Message<Schemas, string>[],\n            expectedVersion || -1\n          );\n        });\n      return committed;\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Polls the store for unblocked streams needing processing, ordered by lease watermark ascending.\n   * @param lagging - Max number of streams to poll in ascending order.\n   * @param leading - Max number of streams to poll in descending order.\n   * @returns The polled streams.\n   */\n  async poll(lagging: number, leading: number) {\n    const { rows } = await this._pool.query<Poll>(\n      `\n      WITH\n      lag AS (\n        SELECT stream, source, at, TRUE AS lagging\n        FROM ${this._fqs}\n        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())\n        ORDER BY at ASC\n        LIMIT $1\n      ),\n      lead AS (\n        SELECT stream, source, at, FALSE AS lagging\n        FROM ${this._fqs}\n        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())\n        ORDER BY at DESC\n        LIMIT $2\n      ),\n      combined AS (\n        SELECT * FROM lag\n        UNION ALL\n        SELECT * FROM lead\n      )\n      SELECT DISTINCT ON (stream) stream, source, at, lagging\n      FROM combined\n      ORDER BY stream, at;\n      `,\n      [lagging, leading]\n    );\n    return rows;\n  }\n\n  /**\n   * Lease streams for reaction processing, marking them as in-progress.\n   *\n   * @param leases - Lease requests for streams, including end-of-lease watermark, lease holder, and source stream.\n   * @param millis - Lease duration in milliseconds.\n   * @returns Array of leased objects with updated lease info\n   */\n  async lease(leases: Lease[], millis: number): Promise<Lease[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      // insert new streams\n      await client.query(\n        `\n        INSERT INTO ${this._fqs} (stream, source)\n        SELECT lease->>'stream', lease->>'source'\n        FROM jsonb_array_elements($1::jsonb) AS lease\n        ON CONFLICT (stream) DO NOTHING\n        `,\n        [JSON.stringify(leases)]\n      );\n      // set leases\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        leased_at: number;\n        leased_by: string;\n        leased_until: number;\n        retry: number;\n        lagging: boolean;\n      }>(\n        `\n      WITH input AS (\n        SELECT * FROM jsonb_to_recordset($1::jsonb)\n        AS x(stream text, at int, by text, lagging boolean)\n      ), free AS (\n        SELECT s.stream FROM ${this._fqs} s\n        JOIN input i ON s.stream = i.stream\n        WHERE s.leased_by IS NULL OR s.leased_until <= NOW()\n        FOR UPDATE\n      )\n      UPDATE ${this._fqs} s\n      SET\n        leased_by = i.by,\n        leased_at = i.at,\n        leased_until = NOW() + ($2::integer || ' milliseconds')::interval,\n        retry = CASE WHEN $2::integer > 0 THEN s.retry + 1 ELSE s.retry END\n      FROM input i, free f\n      WHERE s.stream = f.stream AND s.stream = i.stream\n      RETURNING s.stream, s.source, s.leased_at, s.leased_by, s.leased_until, s.retry, i.lagging\n      `,\n        [JSON.stringify(leases), millis]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map(\n        ({\n          stream,\n          source,\n          leased_at,\n          leased_by,\n          leased_until,\n          retry,\n          lagging,\n        }) => ({\n          stream,\n          source: source ?? undefined,\n          at: leased_at,\n          by: leased_by,\n          until: new Date(leased_until),\n          retry,\n          lagging,\n        })\n      );\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Acknowledge and release leases after processing, updating stream positions.\n   *\n   * @param leases - Leases to acknowledge, including last processed watermark and lease holder.\n   * @returns Acked leases.\n   */\n  async ack(leases: Lease[]): Promise<Lease[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        at: number;\n        retry: number;\n        lagging: boolean;\n      }>(\n        `\n      WITH input AS (\n        SELECT * FROM jsonb_to_recordset($1::jsonb)\n        AS x(stream text, by text, at int, lagging boolean)\n      )\n      UPDATE ${this._fqs} AS s\n      SET\n        at = i.at,\n        retry = -1,\n        leased_by = NULL,\n        leased_at = NULL,\n        leased_until = NULL\n      FROM input i\n      WHERE s.stream = i.stream AND s.leased_by = i.by\n      RETURNING s.stream, s.source, s.at, s.retry, i.lagging\n      `,\n        [JSON.stringify(leases)]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map((row) => ({\n        stream: row.stream,\n        source: row.source ?? undefined,\n        at: row.at,\n        by: \"\",\n        retry: row.retry,\n        lagging: row.lagging,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Block a stream for processing after failing to process and reaching max retries with blocking enabled.\n   * @param leases - Leases to block, including lease holder and last error message.\n   * @returns Blocked leases.\n   */\n  async block(\n    leases: Array<Lease & { error: string }>\n  ): Promise<(Lease & { error: string })[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        at: number;\n        by: string;\n        retry: number;\n        lagging: boolean;\n        error: string;\n      }>(\n        `\n      WITH input AS (\n        SELECT * FROM jsonb_to_recordset($1::jsonb)\n        AS x(stream text, by text, error text, lagging boolean)\n      )\n      UPDATE ${this._fqs} AS s\n      SET blocked = true, error = i.error\n      FROM input i\n      WHERE s.stream = i.stream AND s.leased_by = i.by AND s.blocked = false\n      RETURNING s.stream, s.source, s.at, i.by, s.retry, s.error, i.lagging\n      `,\n        [JSON.stringify(leases)]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map((row) => ({\n        stream: row.stream,\n        source: row.source ?? undefined,\n        at: row.at,\n        by: row.by,\n        retry: row.retry,\n        lagging: row.lagging,\n        error: row.error,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n}\n","/**\n * @module act-pg\n * Date reviver for JSON.parse to automatically convert ISO 8601 date strings to Date objects.\n *\n * Recognizes the following formats:\n * - YYYY-MM-DDTHH:MM:SS.sssZ\n * - YYYY-MM-DDTHH:MM:SS.sss+HH:MM\n * - YYYY-MM-DDTHH:MM:SS.sss-HH:MM\n *\n * @param key The key being parsed\n * @param value The value being parsed\n * @returns A Date object if the value matches ISO 8601, otherwise the original value\n *\n * @example\n * const obj = JSON.parse(jsonString, dateReviver);\n */\nconst ISO_8601 =\n  /^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])T([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(\\.\\d+)?(Z|[+-][0-2][0-9]:[0-5][0-9])?$/;\nexport const dateReviver = (key: string, value: string): string | Date => {\n  if (typeof value === \"string\" && ISO_8601.test(value)) {\n    return new Date(value);\n  }\n  return value;\n};\n"],"mappings":"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","names":["pg"]}
+{"version":3,"sources":["../src/index.ts","../src/PostgresStore.ts","../src/utils.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * @module act-pg\n * Main entry point for the Act-PG framework. Re-exports all core APIs\n */\nexport * from \"./PostgresStore.js\";\n","import type {\n  Committed,\n  EventMeta,\n  Lease,\n  Message,\n  Query,\n  Schemas,\n  Store,\n} from \"@rotorsoft/act\";\nimport { ConcurrencyError, SNAP_EVENT, logger } from \"@rotorsoft/act\";\nimport pg from \"pg\";\nimport { dateReviver } from \"./utils.js\";\n\nconst { Pool, types } = pg;\ntypes.setTypeParser(types.builtins.JSONB, (val) =>\n  JSON.parse(val, dateReviver)\n);\n\ntype Config = Readonly<{\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  schema: string;\n  table: string;\n}>;\n\nconst DEFAULT_CONFIG: Config = {\n  host: \"localhost\",\n  port: 5432,\n  database: \"postgres\",\n  user: \"postgres\",\n  password: \"postgres\",\n  schema: \"public\",\n  table: \"events\",\n};\n\n/**\n * Production-ready PostgreSQL event store implementation.\n *\n * PostgresStore provides persistent, scalable event storage using PostgreSQL.\n * It implements the full {@link Store} interface with production-grade features:\n *\n * **Features:**\n * - Persistent event storage with ACID guarantees\n * - Optimistic concurrency control via version numbers\n * - Distributed stream processing with leasing\n * - Snapshot support for performance optimization\n * - Connection pooling for scalability\n * - Automatic table and index creation\n *\n * **Database Schema:**\n * - Events table: Stores all committed events\n * - Streams table: Tracks stream metadata and leases\n * - Indexes on stream, version, and timestamps for fast queries\n *\n * @example Basic setup\n * ```typescript\n * import { store } from \"@rotorsoft/act\";\n * import { PostgresStore } from \"@rotorsoft/act-pg\";\n *\n * store(new PostgresStore({\n *   host: \"localhost\",\n *   port: 5432,\n *   database: \"myapp\",\n *   user: \"postgres\",\n *   password: \"secret\"\n * }));\n *\n * const app = act()\n *   .withState(Counter)\n *   .build();\n * ```\n *\n * @example With custom schema and table\n * ```typescript\n * import { PostgresStore } from \"@rotorsoft/act-pg\";\n *\n * const pgStore = new PostgresStore({\n *   host: process.env.DB_HOST || \"localhost\",\n *   port: parseInt(process.env.DB_PORT || \"5432\"),\n *   database: process.env.DB_NAME || \"myapp\",\n *   user: process.env.DB_USER || \"postgres\",\n *   password: process.env.DB_PASSWORD,\n *   schema: \"events\",      // Custom schema\n *   table: \"act_events\"    // Custom table name\n * });\n *\n * // Initialize tables\n * await pgStore.seed();\n * ```\n *\n * @example Connection pooling configuration\n * ```typescript\n * // PostgresStore uses node-postgres (pg) connection pooling\n * // Pool is created automatically with default settings\n * // For custom pool config, use environment variables:\n * //   PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD\n * //   PGMAXCONNECTIONS, PGIDLETIMEOUT, etc.\n *\n * const pgStore = new PostgresStore({\n *   host: \"db.example.com\",\n *   port: 5432,\n *   database: \"production\",\n *   user: \"app_user\",\n *   password: process.env.DB_PASSWORD\n * });\n * ```\n *\n * @example Multi-tenant setup\n * ```typescript\n * // Use separate schemas per tenant\n * const tenants = [\"tenant1\", \"tenant2\", \"tenant3\"];\n *\n * for (const tenant of tenants) {\n *   const tenantStore = new PostgresStore({\n *     host: \"localhost\",\n *     database: \"multitenant\",\n *     schema: tenant,        // Each tenant gets own schema\n *     table: \"events\"\n *   });\n *   await tenantStore.seed();\n * }\n * ```\n *\n * @example Querying PostgreSQL directly\n * ```typescript\n * // For advanced queries, you can access pg client\n * const pgStore = new PostgresStore(config);\n * await pgStore.seed();\n *\n * // Use the store's query method for standard queries\n * await pgStore.query(\n *   (event) => console.log(event),\n *   { stream: \"user-123\", limit: 100 }\n * );\n * ```\n *\n * @see {@link Store} for the interface definition\n * @see {@link InMemoryStore} for development/testing\n * @see {@link store} for injecting stores\n * @see {@link https://node-postgres.com/ | node-postgres documentation}\n *\n * @category Adapters\n */\nexport class PostgresStore implements Store {\n  private _pool;\n  readonly config: Config;\n  private _fqt: string;\n  private _fqs: string;\n\n  /**\n   * Create a new PostgresStore instance.\n   * @param config Partial configuration (host, port, user, password, schema, table, etc.)\n   */\n  constructor(config: Partial<Config> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this._pool = new Pool(this.config);\n    this._fqt = `\"${this.config.schema}\".\"${this.config.table}\"`;\n    this._fqs = `\"${this.config.schema}\".\"${this.config.table}_streams\"`;\n  }\n\n  /**\n   * Dispose of the store and close all database connections.\n   * @returns Promise that resolves when all connections are closed\n   */\n  async dispose() {\n    await this._pool.end();\n  }\n\n  /**\n   * Seed the database with required tables, indexes, and schema for event storage.\n   * @returns Promise that resolves when seeding is complete\n   * @throws Error if seeding fails\n   */\n  async seed() {\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n\n      // Create schema\n      await client.query(\n        `CREATE SCHEMA IF NOT EXISTS \"${this.config.schema}\";`\n      );\n\n      // Events table\n      await client.query(\n        `CREATE TABLE IF NOT EXISTS ${this._fqt} (\n          id serial PRIMARY KEY,\n          name varchar(100) COLLATE pg_catalog.\"default\" NOT NULL,\n          data jsonb,\n          stream varchar(100) COLLATE pg_catalog.\"default\" NOT NULL,\n          version int NOT NULL,\n          created timestamptz NOT NULL DEFAULT now(),\n          meta jsonb\n        ) TABLESPACE pg_default;`\n      );\n\n      // Indexes on events\n      await client.query(\n        `CREATE UNIQUE INDEX IF NOT EXISTS \"${this.config.table}_stream_ix\" \n        ON ${this._fqt} (stream COLLATE pg_catalog.\"default\", version);`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_name_ix\" \n        ON ${this._fqt} (name COLLATE pg_catalog.\"default\");`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_created_id_ix\" \n        ON ${this._fqt} (created, id);`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_correlation_ix\" \n        ON ${this._fqt} ((meta ->> 'correlation') COLLATE pg_catalog.\"default\");`\n      );\n\n      // Streams table\n      await client.query(\n        `CREATE TABLE IF NOT EXISTS ${this._fqs} (\n          stream varchar(100) COLLATE pg_catalog.\"default\" PRIMARY KEY,\n          source varchar(100) COLLATE pg_catalog.\"default\",\n          at int NOT NULL DEFAULT -1,\n          retry smallint NOT NULL DEFAULT 0,\n          blocked boolean NOT NULL DEFAULT false,\n          error text,\n          leased_at int,\n          leased_by text,\n          leased_until timestamptz\n        ) TABLESPACE pg_default;`\n      );\n\n      // Index for fetching streams\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_streams_fetch_ix\" \n        ON ${this._fqs} (blocked, at);`\n      );\n\n      await client.query(\"COMMIT\");\n      logger.info(\n        `Seeded schema \"${this.config.schema}\" with table \"${this.config.table}\"`\n      );\n    } catch (error) {\n      await client.query(\"ROLLBACK\");\n      logger.error(error);\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Drop all tables and schema created by the store (for testing or cleanup).\n   * @returns Promise that resolves when the schema is dropped\n   */\n  async drop() {\n    await this._pool.query(\n      `\n      DO $$\n      BEGIN\n        IF EXISTS (SELECT 1 FROM information_schema.schemata\n          WHERE schema_name = '${this.config.schema}'\n        ) THEN\n          EXECUTE 'DROP TABLE IF EXISTS ${this._fqt}';\n          EXECUTE 'DROP TABLE IF EXISTS ${this._fqs}';\n          IF '${this.config.schema}' <> 'public' THEN\n            EXECUTE 'DROP SCHEMA \"${this.config.schema}\" CASCADE';\n          END IF;\n        END IF;\n      END\n      $$;\n    `\n    );\n  }\n\n  /**\n   * Query events from the store, optionally filtered by stream, event name, time, etc.\n   *\n   * @param callback Function called for each event found\n   * @param query (Optional) Query filter (stream, names, before, after, etc.)\n   * @returns The number of events found\n   *\n   * @example\n   * await store.query((event) => console.log(event), { stream: \"A\" });\n   */\n  async query<E extends Schemas>(\n    callback: (event: Committed<E, keyof E>) => void,\n    query?: Query\n  ) {\n    const {\n      stream,\n      names,\n      before,\n      after,\n      limit,\n      created_before,\n      created_after,\n      backward,\n      correlation,\n      with_snaps = false,\n    } = query || {};\n\n    let sql = `SELECT * FROM ${this._fqt}`;\n    const conditions: string[] = [];\n    const values: any[] = [];\n\n    if (query) {\n      if (typeof after !== \"undefined\") {\n        values.push(after);\n        conditions.push(`id>$${values.length}`);\n      } else {\n        conditions.push(\"id>-1\");\n      }\n      if (stream) {\n        values.push(stream);\n        conditions.push(`stream ~ $${values.length}`);\n      }\n      if (names && names.length) {\n        values.push(names);\n        conditions.push(`name = ANY($${values.length})`);\n      }\n      if (before) {\n        values.push(before);\n        conditions.push(`id<$${values.length}`);\n      }\n      if (created_after) {\n        values.push(created_after.toISOString());\n        conditions.push(`created>$${values.length}`);\n      }\n      if (created_before) {\n        values.push(created_before.toISOString());\n        conditions.push(`created<$${values.length}`);\n      }\n      if (correlation) {\n        values.push(correlation);\n        conditions.push(`meta->>'correlation'=$${values.length}`);\n      }\n      if (!with_snaps) {\n        conditions.push(`name <> '${SNAP_EVENT}'`);\n      }\n    }\n    if (conditions.length) {\n      sql += \" WHERE \" + conditions.join(\" AND \");\n    }\n    sql += ` ORDER BY id ${backward ? \"DESC\" : \"ASC\"}`;\n    if (limit) {\n      values.push(limit);\n      sql += ` LIMIT $${values.length}`;\n    }\n\n    const result = await this._pool.query<Committed<E, keyof E>>(sql, values);\n    for (const row of result.rows) callback(row);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Commit new events to the store for a given stream, with concurrency control.\n   *\n   * @param stream The stream name\n   * @param msgs Array of messages (event name and data)\n   * @param meta Event metadata (correlation, causation, etc.)\n   * @param expectedVersion (Optional) Expected stream version for concurrency control\n   * @returns Array of committed events\n   * @throws ConcurrencyError if the expected version does not match\n   */\n  async commit<E extends Schemas>(\n    stream: string,\n    msgs: Message<E, keyof E>[],\n    meta: EventMeta,\n    expectedVersion?: number\n  ) {\n    if (msgs.length === 0) return [];\n    const client = await this._pool.connect();\n    let version = -1;\n    try {\n      await client.query(\"BEGIN\");\n\n      const last = await client.query<Committed<E, keyof E>>(\n        `SELECT version\n        FROM ${this._fqt}\n        WHERE stream=$1 ORDER BY version DESC LIMIT 1`,\n        [stream]\n      );\n      version = last.rowCount ? last.rows[0].version : -1;\n      if (typeof expectedVersion === \"number\" && version !== expectedVersion)\n        throw new ConcurrencyError(\n          stream,\n          version,\n          msgs as unknown as Message<Schemas, string>[],\n          expectedVersion\n        );\n\n      const committed: Committed<E, keyof E>[] = [];\n      for (const { name, data } of msgs) {\n        version++;\n        const sql = `\n          INSERT INTO ${this._fqt}(name, data, stream, version, meta)\n          VALUES($1, $2, $3, $4, $5) RETURNING *`;\n        const vals = [name, data, stream, version, meta];\n        const { rows } = await client.query<Committed<E, keyof E>>(sql, vals);\n        committed.push(rows.at(0)!);\n      }\n\n      await client\n        .query(\n          `\n            NOTIFY \"${this.config.table}\", '${JSON.stringify({\n              operation: \"INSERT\",\n              id: committed[0].name,\n              position: committed[0].id,\n            })}';\n            COMMIT;\n            `\n        )\n        .catch((error) => {\n          logger.error(error);\n          throw new ConcurrencyError(\n            stream,\n            version,\n            msgs as unknown as Message<Schemas, string>[],\n            expectedVersion || -1\n          );\n        });\n      return committed;\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Atomically discovers and leases streams for reaction processing.\n   *\n   * Uses `FOR UPDATE SKIP LOCKED` to implement zero-contention competing consumers:\n   * - Workers never block each other — locked rows are silently skipped\n   * - Discovery and locking happen in a single atomic transaction\n   * - No wasted polls — every returned stream is exclusively owned\n   *\n   * @param lagging - Max streams from lagging frontier (ascending watermark)\n   * @param leading - Max streams from leading frontier (descending watermark)\n   * @param by - Lease holder identifier (UUID)\n   * @param millis - Lease duration in milliseconds\n   * @returns Leased streams with metadata\n   */\n  async claim(\n    lagging: number,\n    leading: number,\n    by: string,\n    millis: number\n  ): Promise<Lease[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        at: number;\n        retry: number;\n        lagging: boolean;\n      }>(\n        `\n        WITH\n        available AS (\n          SELECT stream, source, at\n          FROM ${this._fqs}\n          WHERE blocked = false\n            AND (leased_by IS NULL OR leased_until <= NOW())\n          FOR UPDATE SKIP LOCKED\n        ),\n        lag AS (\n          SELECT stream, source, at, TRUE AS lagging\n          FROM available\n          ORDER BY at ASC\n          LIMIT $1\n        ),\n        lead AS (\n          SELECT stream, source, at, FALSE AS lagging\n          FROM available\n          ORDER BY at DESC\n          LIMIT $2\n        ),\n        combined AS (\n          SELECT DISTINCT ON (stream) stream, source, at, lagging\n          FROM (SELECT * FROM lag UNION ALL SELECT * FROM lead) t\n          ORDER BY stream, at\n        )\n        UPDATE ${this._fqs} s\n        SET\n          leased_by = $3,\n          leased_until = NOW() + ($4::integer || ' milliseconds')::interval,\n          retry = s.retry + 1\n        FROM combined c\n        WHERE s.stream = c.stream\n        RETURNING s.stream, s.source, s.at, s.retry, c.lagging\n        `,\n        [lagging, leading, by, millis]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map(({ stream, source, at, retry, lagging }) => ({\n        stream,\n        source: source ?? undefined,\n        at,\n        by,\n        retry,\n        lagging,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Registers streams for event processing.\n   * Upserts stream entries so they become visible to claim().\n   * @param streams - Streams to register with optional source.\n   * @returns Number of newly registered streams.\n   */\n  async subscribe(\n    streams: Array<{ stream: string; source?: string }>\n  ): Promise<number> {\n    if (!streams.length) return 0;\n    const { rowCount } = await this._pool.query(\n      `\n      INSERT INTO ${this._fqs} (stream, source)\n      SELECT s->>'stream', s->>'source'\n      FROM jsonb_array_elements($1::jsonb) AS s\n      ON CONFLICT (stream) DO NOTHING\n      `,\n      [JSON.stringify(streams)]\n    );\n    return rowCount ?? 0;\n  }\n\n  /**\n   * Acknowledge and release leases after processing, updating stream positions.\n   *\n   * @param leases - Leases to acknowledge, including last processed watermark and lease holder.\n   * @returns Acked leases.\n   */\n  async ack(leases: Lease[]): Promise<Lease[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        at: number;\n        retry: number;\n        lagging: boolean;\n      }>(\n        `\n      WITH input AS (\n        SELECT * FROM jsonb_to_recordset($1::jsonb)\n        AS x(stream text, by text, at int, lagging boolean)\n      )\n      UPDATE ${this._fqs} AS s\n      SET\n        at = i.at,\n        retry = -1,\n        leased_by = NULL,\n        leased_at = NULL,\n        leased_until = NULL\n      FROM input i\n      WHERE s.stream = i.stream AND s.leased_by = i.by\n      RETURNING s.stream, s.source, s.at, s.retry, i.lagging\n      `,\n        [JSON.stringify(leases)]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map((row) => ({\n        stream: row.stream,\n        source: row.source ?? undefined,\n        at: row.at,\n        by: \"\",\n        retry: row.retry,\n        lagging: row.lagging,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Block a stream for processing after failing to process and reaching max retries with blocking enabled.\n   * @param leases - Leases to block, including lease holder and last error message.\n   * @returns Blocked leases.\n   */\n  async block(\n    leases: Array<Lease & { error: string }>\n  ): Promise<(Lease & { error: string })[]> {\n    const client = await this._pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n      const { rows } = await client.query<{\n        stream: string;\n        source: string | null;\n        at: number;\n        by: string;\n        retry: number;\n        lagging: boolean;\n        error: string;\n      }>(\n        `\n      WITH input AS (\n        SELECT * FROM jsonb_to_recordset($1::jsonb)\n        AS x(stream text, by text, error text, lagging boolean)\n      )\n      UPDATE ${this._fqs} AS s\n      SET blocked = true, error = i.error\n      FROM input i\n      WHERE s.stream = i.stream AND s.leased_by = i.by AND s.blocked = false\n      RETURNING s.stream, s.source, s.at, i.by, s.retry, s.error, i.lagging\n      `,\n        [JSON.stringify(leases)]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map((row) => ({\n        stream: row.stream,\n        source: row.source ?? undefined,\n        at: row.at,\n        by: row.by,\n        retry: row.retry,\n        lagging: row.lagging,\n        error: row.error,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      logger.error(error);\n      return [];\n    } finally {\n      client.release();\n    }\n  }\n}\n","/**\n * @module act-pg\n * Date reviver for JSON.parse to automatically convert ISO 8601 date strings to Date objects.\n *\n * Recognizes the following formats:\n * - YYYY-MM-DDTHH:MM:SS.sssZ\n * - YYYY-MM-DDTHH:MM:SS.sss+HH:MM\n * - YYYY-MM-DDTHH:MM:SS.sss-HH:MM\n *\n * @param key The key being parsed\n * @param value The value being parsed\n * @returns A Date object if the value matches ISO 8601, otherwise the original value\n *\n * @example\n * const obj = JSON.parse(jsonString, dateReviver);\n */\nconst ISO_8601 =\n  /^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])T([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(\\.\\d+)?(Z|[+-][0-2][0-9]:[0-5][0-9])?$/;\nexport const dateReviver = (key: string, value: string): string | Date => {\n  if (typeof value === \"string\" && ISO_8601.test(value)) {\n    return new Date(value);\n  }\n  return value;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSA,iBAAqD;AACrD,gBAAe;;;ACMf,IAAM,WACJ;AACK,IAAM,cAAc,CAAC,KAAa,UAAiC;AACxE,MAAI,OAAO,UAAU,YAAY,SAAS,KAAK,KAAK,GAAG;AACrD,WAAO,IAAI,KAAK,KAAK;AAAA,EACvB;AACA,SAAO;AACT;;;ADVA,IAAM,EAAE,MAAM,MAAM,IAAI,UAAAA;AACxB,MAAM;AAAA,EAAc,MAAM,SAAS;AAAA,EAAO,CAAC,QACzC,KAAK,MAAM,KAAK,WAAW;AAC7B;AAYA,IAAM,iBAAyB;AAAA,EAC7B,MAAM;AAAA,EACN,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AACT;AA8GO,IAAM,gBAAN,MAAqC;AAAA,EAClC;AAAA,EACC;AAAA,EACD;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY,SAA0B,CAAC,GAAG;AACxC,SAAK,SAAS,EAAE,GAAG,gBAAgB,GAAG,OAAO;AAC7C,SAAK,QAAQ,IAAI,KAAK,KAAK,MAAM;AACjC,SAAK,OAAO,IAAI,KAAK,OAAO,MAAM,MAAM,KAAK,OAAO,KAAK;AACzD,SAAK,OAAO,IAAI,KAAK,OAAO,MAAM,MAAM,KAAK,OAAO,KAAK;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAU;AACd,UAAM,KAAK,MAAM,IAAI;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO;AACX,UAAM,SAAS,MAAM,KAAK,MAAM,QAAQ;AAExC,QAAI;AACF,YAAM,OAAO,MAAM,OAAO;AAG1B,YAAM,OAAO;AAAA,QACX,gCAAgC,KAAK,OAAO,MAAM;AAAA,MACpD;AAGA,YAAM,OAAO;AAAA,QACX,8BAA8B,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MASzC;AAGA,YAAM,OAAO;AAAA,QACX,sCAAsC,KAAK,OAAO,KAAK;AAAA,aAClD,KAAK,IAAI;AAAA,MAChB;AACA,YAAM,OAAO;AAAA,QACX,+BAA+B,KAAK,OAAO,KAAK;AAAA,aAC3C,KAAK,IAAI;AAAA,MAChB;AACA,YAAM,OAAO;AAAA,QACX,+BAA+B,KAAK,OAAO,KAAK;AAAA,aAC3C,KAAK,IAAI;AAAA,MAChB;AACA,YAAM,OAAO;AAAA,QACX,+BAA+B,KAAK,OAAO,KAAK;AAAA,aAC3C,KAAK,IAAI;AAAA,MAChB;AAGA,YAAM,OAAO;AAAA,QACX,8BAA8B,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAWzC;AAGA,YAAM,OAAO;AAAA,QACX,+BAA+B,KAAK,OAAO,KAAK;AAAA,aAC3C,KAAK,IAAI;AAAA,MAChB;AAEA,YAAM,OAAO,MAAM,QAAQ;AAC3B,wBAAO;AAAA,QACL,kBAAkB,KAAK,OAAO,MAAM,iBAAiB,KAAK,OAAO,KAAK;AAAA,MACxE;AAAA,IACF,SAAS,OAAO;AACd,YAAM,OAAO,MAAM,UAAU;AAC7B,wBAAO,MAAM,KAAK;AAClB,YAAM;AAAA,IACR,UAAE;AACA,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO;AACX,UAAM,KAAK,MAAM;AAAA,MACf;AAAA;AAAA;AAAA;AAAA,iCAI2B,KAAK,OAAO,MAAM;AAAA;AAAA,0CAET,KAAK,IAAI;AAAA,0CACT,KAAK,IAAI;AAAA,gBACnC,KAAK,OAAO,MAAM;AAAA,oCACE,KAAK,OAAO,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMlD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,MACJ,UACA,OACA;AACA,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa;AAAA,IACf,IAAI,SAAS,CAAC;AAEd,QAAI,MAAM,iBAAiB,KAAK,IAAI;AACpC,UAAM,aAAuB,CAAC;AAC9B,UAAM,SAAgB,CAAC;AAEvB,QAAI,OAAO;AACT,UAAI,OAAO,UAAU,aAAa;AAChC,eAAO,KAAK,KAAK;AACjB,mBAAW,KAAK,OAAO,OAAO,MAAM,EAAE;AAAA,MACxC,OAAO;AACL,mBAAW,KAAK,OAAO;AAAA,MACzB;AACA,UAAI,QAAQ;AACV,eAAO,KAAK,MAAM;AAClB,mBAAW,KAAK,aAAa,OAAO,MAAM,EAAE;AAAA,MAC9C;AACA,UAAI,SAAS,MAAM,QAAQ;AACzB,eAAO,KAAK,KAAK;AACjB,mBAAW,KAAK,eAAe,OAAO,MAAM,GAAG;AAAA,MACjD;AACA,UAAI,QAAQ;AACV,eAAO,KAAK,MAAM;AAClB,mBAAW,KAAK,OAAO,OAAO,MAAM,EAAE;AAAA,MACxC;AACA,UAAI,eAAe;AACjB,eAAO,KAAK,cAAc,YAAY,CAAC;AACvC,mBAAW,KAAK,YAAY,OAAO,MAAM,EAAE;AAAA,MAC7C;AACA,UAAI,gBAAgB;AAClB,eAAO,KAAK,eAAe,YAAY,CAAC;AACxC,mBAAW,KAAK,YAAY,OAAO,MAAM,EAAE;AAAA,MAC7C;AACA,UAAI,aAAa;AACf,eAAO,KAAK,WAAW;AACvB,mBAAW,KAAK,yBAAyB,OAAO,MAAM,EAAE;AAAA,MAC1D;AACA,UAAI,CAAC,YAAY;AACf,mBAAW,KAAK,YAAY,qBAAU,GAAG;AAAA,MAC3C;AAAA,IACF;AACA,QAAI,WAAW,QAAQ;AACrB,aAAO,YAAY,WAAW,KAAK,OAAO;AAAA,IAC5C;AACA,WAAO,gBAAgB,WAAW,SAAS,KAAK;AAChD,QAAI,OAAO;AACT,aAAO,KAAK,KAAK;AACjB,aAAO,WAAW,OAAO,MAAM;AAAA,IACjC;AAEA,UAAM,SAAS,MAAM,KAAK,MAAM,MAA6B,KAAK,MAAM;AACxE,eAAW,OAAO,OAAO,KAAM,UAAS,GAAG;AAE3C,WAAO,OAAO,YAAY;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,OACJ,QACA,MACA,MACA,iBACA;AACA,QAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,UAAM,SAAS,MAAM,KAAK,MAAM,QAAQ;AACxC,QAAI,UAAU;AACd,QAAI;AACF,YAAM,OAAO,MAAM,OAAO;AAE1B,YAAM,OAAO,MAAM,OAAO;AAAA,QACxB;AAAA,eACO,KAAK,IAAI;AAAA;AAAA,QAEhB,CAAC,MAAM;AAAA,MACT;AACA,gBAAU,KAAK,WAAW,KAAK,KAAK,CAAC,EAAE,UAAU;AACjD,UAAI,OAAO,oBAAoB,YAAY,YAAY;AACrD,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAEF,YAAM,YAAqC,CAAC;AAC5C,iBAAW,EAAE,MAAM,KAAK,KAAK,MAAM;AACjC;AACA,cAAM,MAAM;AAAA,wBACI,KAAK,IAAI;AAAA;AAEzB,cAAM,OAAO,CAAC,MAAM,MAAM,QAAQ,SAAS,IAAI;AAC/C,cAAM,EAAE,KAAK,IAAI,MAAM,OAAO,MAA6B,KAAK,IAAI;AACpE,kBAAU,KAAK,KAAK,GAAG,CAAC,CAAE;AAAA,MAC5B;AAEA,YAAM,OACH;AAAA,QACC;AAAA,sBACY,KAAK,OAAO,KAAK,OAAO,KAAK,UAAU;AAAA,UAC/C,WAAW;AAAA,UACX,IAAI,UAAU,CAAC,EAAE;AAAA,UACjB,UAAU,UAAU,CAAC,EAAE;AAAA,QACzB,CAAC,CAAC;AAAA;AAAA;AAAA,MAGN,EACC,MAAM,CAAC,UAAU;AAChB,0BAAO,MAAM,KAAK;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA;AAAA,UACA,mBAAmB;AAAA,QACrB;AAAA,MACF,CAAC;AACH,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,OAAO,MAAM,UAAU,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,YAAM;AAAA,IACR,UAAE;AACA,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,MAAM,MACJ,SACA,SACA,IACA,QACkB;AAClB,UAAM,SAAS,MAAM,KAAK,MAAM,QAAQ;AACxC,QAAI;AACF,YAAM,OAAO,MAAM,OAAO;AAC1B,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO;AAAA,QAO5B;AAAA;AAAA;AAAA;AAAA,iBAIS,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAsBT,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QASlB,CAAC,SAAS,SAAS,IAAI,MAAM;AAAA,MAC/B;AACA,YAAM,OAAO,MAAM,QAAQ;AAE3B,aAAO,KAAK,IAAI,CAAC,EAAE,QAAQ,QAAQ,IAAI,OAAO,SAAAC,SAAQ,OAAO;AAAA,QAC3D;AAAA,QACA,QAAQ,UAAU;AAAA,QAClB;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAAA;AAAA,MACF,EAAE;AAAA,IACJ,SAAS,OAAO;AACd,YAAM,OAAO,MAAM,UAAU,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,wBAAO,MAAM,KAAK;AAClB,aAAO,CAAC;AAAA,IACV,UAAE;AACA,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UACJ,SACiB;AACjB,QAAI,CAAC,QAAQ,OAAQ,QAAO;AAC5B,UAAM,EAAE,SAAS,IAAI,MAAM,KAAK,MAAM;AAAA,MACpC;AAAA,oBACc,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,MAKvB,CAAC,KAAK,UAAU,OAAO,CAAC;AAAA,IAC1B;AACA,WAAO,YAAY;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,QAAmC;AAC3C,UAAM,SAAS,MAAM,KAAK,MAAM,QAAQ;AACxC,QAAI;AACF,YAAM,OAAO,MAAM,OAAO;AAC1B,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO;AAAA,QAO5B;AAAA;AAAA;AAAA;AAAA;AAAA,eAKO,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAWhB,CAAC,KAAK,UAAU,MAAM,CAAC;AAAA,MACzB;AACA,YAAM,OAAO,MAAM,QAAQ;AAE3B,aAAO,KAAK,IAAI,CAAC,SAAS;AAAA,QACxB,QAAQ,IAAI;AAAA,QACZ,QAAQ,IAAI,UAAU;AAAA,QACtB,IAAI,IAAI;AAAA,QACR,IAAI;AAAA,QACJ,OAAO,IAAI;AAAA,QACX,SAAS,IAAI;AAAA,MACf,EAAE;AAAA,IACJ,SAAS,OAAO;AACd,YAAM,OAAO,MAAM,UAAU,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,wBAAO,MAAM,KAAK;AAClB,aAAO,CAAC;AAAA,IACV,UAAE;AACA,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MACJ,QACwC;AACxC,UAAM,SAAS,MAAM,KAAK,MAAM,QAAQ;AACxC,QAAI;AACF,YAAM,OAAO,MAAM,OAAO;AAC1B,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO;AAAA,QAS5B;AAAA;AAAA;AAAA;AAAA;AAAA,eAKO,KAAK,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAMhB,CAAC,KAAK,UAAU,MAAM,CAAC;AAAA,MACzB;AACA,YAAM,OAAO,MAAM,QAAQ;AAE3B,aAAO,KAAK,IAAI,CAAC,SAAS;AAAA,QACxB,QAAQ,IAAI;AAAA,QACZ,QAAQ,IAAI,UAAU;AAAA,QACtB,IAAI,IAAI;AAAA,QACR,IAAI,IAAI;AAAA,QACR,OAAO,IAAI;AAAA,QACX,SAAS,IAAI;AAAA,QACb,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,SAAS,OAAO;AACd,YAAM,OAAO,MAAM,UAAU,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,wBAAO,MAAM,KAAK;AAClB,aAAO,CAAC;AAAA,IACV,UAAE;AACA,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AACF;","names":["pg","lagging"]}

package/dist/index.js

@@ -280,105 +280,70 @@ var PostgresStore = class {
     }
   }
   /**
-   * Polls the store for unblocked streams needing processing, ordered by lease watermark ascending.
-   * @param lagging - Max number of streams to poll in ascending order.
-   * @param leading - Max number of streams to poll in descending order.
-   * @returns The polled streams.
-   */
-  async poll(lagging, leading) {
-    const { rows } = await this._pool.query(
-      `
-      WITH
-      lag AS (
-        SELECT stream, source, at, TRUE AS lagging
-        FROM ${this._fqs}
-        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())
-        ORDER BY at ASC
-        LIMIT $1
-      ),
-      lead AS (
-        SELECT stream, source, at, FALSE AS lagging
-        FROM ${this._fqs}
-        WHERE blocked = false AND (leased_by IS NULL OR leased_until <= NOW())
-        ORDER BY at DESC
-        LIMIT $2
-      ),
-      combined AS (
-        SELECT * FROM lag
-        UNION ALL
-        SELECT * FROM lead
-      )
-      SELECT DISTINCT ON (stream) stream, source, at, lagging
-      FROM combined
-      ORDER BY stream, at;
-      `,
-      [lagging, leading]
-    );
-    return rows;
-  }
-  /**
-   * Lease streams for reaction processing, marking them as in-progress.
+   * Atomically discovers and leases streams for reaction processing.
+   *
+   * Uses `FOR UPDATE SKIP LOCKED` to implement zero-contention competing consumers:
+   * - Workers never block each other — locked rows are silently skipped
+   * - Discovery and locking happen in a single atomic transaction
+   * - No wasted polls — every returned stream is exclusively owned
    *
-   * @param leases - Lease requests for streams, including end-of-lease watermark, lease holder, and source stream.
-   * @param millis - Lease duration in milliseconds.
-   * @returns Array of leased objects with updated lease info
+   * @param lagging - Max streams from lagging frontier (ascending watermark)
+   * @param leading - Max streams from leading frontier (descending watermark)
+   * @param by - Lease holder identifier (UUID)
+   * @param millis - Lease duration in milliseconds
+   * @returns Leased streams with metadata
    */
-  async lease(leases, millis) {
+  async claim(lagging, leading, by, millis) {
     const client = await this._pool.connect();
     try {
       await client.query("BEGIN");
-      await client.query(
-        `
-        INSERT INTO ${this._fqs} (stream, source)
-        SELECT lease->>'stream', lease->>'source'
-        FROM jsonb_array_elements($1::jsonb) AS lease
-        ON CONFLICT (stream) DO NOTHING
-        `,
-        [JSON.stringify(leases)]
-      );
       const { rows } = await client.query(
         `
-      WITH input AS (
-        SELECT * FROM jsonb_to_recordset($1::jsonb)
-        AS x(stream text, at int, by text, lagging boolean)
-      ), free AS (
-        SELECT s.stream FROM ${this._fqs} s
-        JOIN input i ON s.stream = i.stream
-        WHERE s.leased_by IS NULL OR s.leased_until <= NOW()
-        FOR UPDATE
-      )
-      UPDATE ${this._fqs} s
-      SET
-        leased_by = i.by,
-        leased_at = i.at,
-        leased_until = NOW() + ($2::integer || ' milliseconds')::interval,
-        retry = CASE WHEN $2::integer > 0 THEN s.retry + 1 ELSE s.retry END
-      FROM input i, free f
-      WHERE s.stream = f.stream AND s.stream = i.stream
-      RETURNING s.stream, s.source, s.leased_at, s.leased_by, s.leased_until, s.retry, i.lagging
-      `,
-        [JSON.stringify(leases), millis]
+        WITH
+        available AS (
+          SELECT stream, source, at
+          FROM ${this._fqs}
+          WHERE blocked = false
+            AND (leased_by IS NULL OR leased_until <= NOW())
+          FOR UPDATE SKIP LOCKED
+        ),
+        lag AS (
+          SELECT stream, source, at, TRUE AS lagging
+          FROM available
+          ORDER BY at ASC
+          LIMIT $1
+        ),
+        lead AS (
+          SELECT stream, source, at, FALSE AS lagging
+          FROM available
+          ORDER BY at DESC
+          LIMIT $2
+        ),
+        combined AS (
+          SELECT DISTINCT ON (stream) stream, source, at, lagging
+          FROM (SELECT * FROM lag UNION ALL SELECT * FROM lead) t
+          ORDER BY stream, at
+        )
+        UPDATE ${this._fqs} s
+        SET
+          leased_by = $3,
+          leased_until = NOW() + ($4::integer || ' milliseconds')::interval,
+          retry = s.retry + 1
+        FROM combined c
+        WHERE s.stream = c.stream
+        RETURNING s.stream, s.source, s.at, s.retry, c.lagging
+        `,
+        [lagging, leading, by, millis]
       );
       await client.query("COMMIT");
-      return rows.map(
-        ({
-          stream,
-          source,
-          leased_at,
-          leased_by,
-          leased_until,
-          retry,
-          lagging
-        }) => ({
-          stream,
-          source: source ?? void 0,
-          at: leased_at,
-          by: leased_by,
-          until: new Date(leased_until),
-          retry,
-          lagging
-        })
-      );
+      return rows.map(({ stream, source, at, retry, lagging: lagging2 }) => ({
+        stream,
+        source: source ?? void 0,
+        at,
+        by,
+        retry,
+        lagging: lagging2
+      }));
     } catch (error) {
       await client.query("ROLLBACK").catch(() => {
       });
@@ -388,6 +353,25 @@ var PostgresStore = class {
       client.release();
     }
   }
+  /**
+   * Registers streams for event processing.
+   * Upserts stream entries so they become visible to claim().
+   * @param streams - Streams to register with optional source.
+   * @returns Number of newly registered streams.
+   */
+  async subscribe(streams) {
+    if (!streams.length) return 0;
+    const { rowCount } = await this._pool.query(
+      `
+      INSERT INTO ${this._fqs} (stream, source)
+      SELECT s->>'stream', s->>'source'
+      FROM jsonb_array_elements($1::jsonb) AS s
+      ON CONFLICT (stream) DO NOTHING
+      `,
+      [JSON.stringify(streams)]
+    );
+    return rowCount ?? 0;
+  }
   /**
    * Acknowledge and release leases after processing, updating stream positions.
    *