@rotorsoft/act-pg 0.4.1 → 0.4.3

package/dist/index.js

@@ -30,13 +30,30 @@ var DEFAULT_CONFIG = {
 var PostgresStore = class {
   _pool;
   config;
+  _fqt;
+  _fqs;
+  /**
+   * Create a new PostgresStore instance.
+   * @param config Partial configuration (host, port, user, password, schema, table, etc.)
+   */
   constructor(config = {}) {
     this.config = { ...DEFAULT_CONFIG, ...config };
     this._pool = new Pool(this.config);
+    this._fqt = `"${this.config.schema}"."${this.config.table}"`;
+    this._fqs = `"${this.config.schema}"."${this.config.table}_streams"`;
   }
+  /**
+   * Dispose of the store and close all database connections.
+   * @returns Promise that resolves when all connections are closed
+   */
   async dispose() {
     await this._pool.end();
   }
+  /**
+   * Seed the database with required tables, indexes, and schema for event storage.
+   * @returns Promise that resolves when seeding is complete
+   * @throws Error if seeding fails
+   */
   async seed() {
     const client = await this._pool.connect();
     try {
@@ -45,7 +62,7 @@ var PostgresStore = class {
         `CREATE SCHEMA IF NOT EXISTS "${this.config.schema}";`
       );
       await client.query(
-        `CREATE TABLE IF NOT EXISTS "${this.config.schema}"."${this.config.table}" (
+        `CREATE TABLE IF NOT EXISTS ${this._fqt} (
           id serial PRIMARY KEY,
           name varchar(100) COLLATE pg_catalog."default" NOT NULL,
           data jsonb,
@@ -57,22 +74,22 @@ var PostgresStore = class {
       );
       await client.query(
         `CREATE UNIQUE INDEX IF NOT EXISTS "${this.config.table}_stream_ix" 
-        ON "${this.config.schema}"."${this.config.table}" (stream COLLATE pg_catalog."default", version);`
+        ON ${this._fqt} (stream COLLATE pg_catalog."default", version);`
       );
       await client.query(
         `CREATE INDEX IF NOT EXISTS "${this.config.table}_name_ix" 
-        ON "${this.config.schema}"."${this.config.table}" (name COLLATE pg_catalog."default");`
+        ON ${this._fqt} (name COLLATE pg_catalog."default");`
       );
       await client.query(
         `CREATE INDEX IF NOT EXISTS "${this.config.table}_created_id_ix" 
-        ON "${this.config.schema}"."${this.config.table}" (created, id);`
+        ON ${this._fqt} (created, id);`
       );
       await client.query(
         `CREATE INDEX IF NOT EXISTS "${this.config.table}_correlation_ix" 
-        ON "${this.config.schema}"."${this.config.table}" ((meta ->> 'correlation') COLLATE pg_catalog."default");`
+        ON ${this._fqt} ((meta ->> 'correlation') COLLATE pg_catalog."default");`
       );
       await client.query(
-        `CREATE TABLE IF NOT EXISTS "${this.config.schema}"."${this.config.table}_streams" (
+        `CREATE TABLE IF NOT EXISTS ${this._fqs} (
           stream varchar(100) COLLATE pg_catalog."default" PRIMARY KEY,
           at int NOT NULL DEFAULT -1,
           retry smallint NOT NULL DEFAULT 0,
@@ -84,7 +101,7 @@ var PostgresStore = class {
       );
       await client.query(
         `CREATE INDEX IF NOT EXISTS "${this.config.table}_streams_fetch_ix" 
-        ON "${this.config.schema}"."${this.config.table}_streams" (blocked, at);`
+        ON ${this._fqs} (blocked, at);`
       );
       await client.query("COMMIT");
       logger.info(
@@ -98,6 +115,10 @@ var PostgresStore = class {
       client.release();
     }
   }
+  /**
+   * Drop all tables and schema created by the store (for testing or cleanup).
+   * @returns Promise that resolves when the schema is dropped
+   */
   async drop() {
     await this._pool.query(
       `
@@ -106,8 +127,8 @@ var PostgresStore = class {
         IF EXISTS (SELECT 1 FROM information_schema.schemata
           WHERE schema_name = '${this.config.schema}'
         ) THEN
-          EXECUTE 'DROP TABLE IF EXISTS "${this.config.schema}"."${this.config.table}"';
-          EXECUTE 'DROP TABLE IF EXISTS "${this.config.schema}"."${this.config.table}_streams"';
+          EXECUTE 'DROP TABLE IF EXISTS ${this._fqt}';
+          EXECUTE 'DROP TABLE IF EXISTS ${this._fqs}';
           IF '${this.config.schema}' <> 'public' THEN
             EXECUTE 'DROP SCHEMA "${this.config.schema}" CASCADE';
           END IF;
@@ -117,6 +138,17 @@ var PostgresStore = class {
     `
     );
   }
+  /**
+   * Query events from the store, optionally filtered by stream, event name, time, etc.
+   *
+   * @param callback Function called for each event found
+   * @param query (Optional) Query filter (stream, names, before, after, etc.)
+   * @param withSnaps (Optional) If true, includes only events after the last snapshot
+   * @returns The number of events found
+   *
+   * @example
+   * await store.query((event) => console.log(event), { stream: "A" });
+   */
   async query(callback, query, withSnaps = false) {
     const {
       stream,
@@ -129,68 +161,82 @@ var PostgresStore = class {
       backward,
       correlation
     } = query || {};
-    let sql = `SELECT * FROM "${this.config.schema}"."${this.config.table}" WHERE`;
+    let sql = `SELECT * FROM ${this._fqt}`;
+    const conditions = [];
     const values = [];
-    if (withSnaps)
-      sql = sql.concat(
-        ` id>=COALESCE((SELECT id
-            FROM "${this.config.schema}"."${this.config.table}"
-            WHERE stream='${stream}' AND name='${SNAP_EVENT}'
-            ORDER BY id DESC LIMIT 1), 0)
-            AND stream='${stream}'`
+    if (withSnaps) {
+      conditions.push(
+        `id>=COALESCE((SELECT id FROM ${this._fqt} WHERE stream='${stream}' AND name='${SNAP_EVENT}' ORDER BY id DESC LIMIT 1), 0)`
       );
-    else if (query) {
+      conditions.push(`stream='${stream}'`);
+    } else if (query) {
       if (typeof after !== "undefined") {
         values.push(after);
-        sql = sql.concat(" id>$1");
-      } else sql = sql.concat(" id>-1");
+        conditions.push(`id>$${values.length}`);
+      } else {
+        conditions.push("id>-1");
+      }
       if (stream) {
         values.push(stream);
-        sql = sql.concat(` AND stream=$${values.length}`);
+        conditions.push(`stream=$${values.length}`);
       }
       if (names && names.length) {
         values.push(names);
-        sql = sql.concat(` AND name = ANY($${values.length})`);
+        conditions.push(`name = ANY($${values.length})`);
       }
       if (before) {
         values.push(before);
-        sql = sql.concat(` AND id<$${values.length}`);
+        conditions.push(`id<$${values.length}`);
       }
       if (created_after) {
         values.push(created_after.toISOString());
-        sql = sql.concat(` AND created>$${values.length}`);
+        conditions.push(`created>$${values.length}`);
       }
       if (created_before) {
         values.push(created_before.toISOString());
-        sql = sql.concat(` AND created<$${values.length}`);
+        conditions.push(`created<$${values.length}`);
       }
       if (correlation) {
         values.push(correlation);
-        sql = sql.concat(` AND meta->>'correlation'=$${values.length}`);
+        conditions.push(`meta->>'correlation'=$${values.length}`);
       }
     }
-    sql = sql.concat(` ORDER BY id ${backward ? "DESC" : "ASC"}`);
+    if (conditions.length) {
+      sql += " WHERE " + conditions.join(" AND ");
+    }
+    sql += ` ORDER BY id ${backward ? "DESC" : "ASC"}`;
     if (limit) {
       values.push(limit);
-      sql = sql.concat(` LIMIT $${values.length}`);
+      sql += ` LIMIT $${values.length}`;
     }
     const result = await this._pool.query(sql, values);
     for (const row of result.rows) callback(row);
     return result.rowCount ?? 0;
   }
+  /**
+   * Commit new events to the store for a given stream, with concurrency control.
+   *
+   * @param stream The stream name
+   * @param msgs Array of messages (event name and data)
+   * @param meta Event metadata (correlation, causation, etc.)
+   * @param expectedVersion (Optional) Expected stream version for concurrency control
+   * @returns Array of committed events
+   * @throws ConcurrencyError if the expected version does not match
+   */
   async commit(stream, msgs, meta, expectedVersion) {
+    if (msgs.length === 0) return [];
     const client = await this._pool.connect();
     let version = -1;
     try {
       await client.query("BEGIN");
       const last = await client.query(
         `SELECT version
-        FROM "${this.config.schema}"."${this.config.table}"
+        FROM ${this._fqt}
         WHERE stream=$1 ORDER BY version DESC LIMIT 1`,
         [stream]
       );
       version = last.rowCount ? last.rows[0].version : -1;
-      if (expectedVersion && version !== expectedVersion)
+      if (typeof expectedVersion === "number" && version !== expectedVersion)
         throw new ConcurrencyError(
           version,
           msgs,
@@ -200,7 +246,7 @@ var PostgresStore = class {
         msgs.map(async ({ name, data }) => {
           version++;
           const sql = `
-          INSERT INTO "${this.config.schema}"."${this.config.table}"(name, data, stream, version, meta) 
+          INSERT INTO ${this._fqt}(name, data, stream, version, meta) 
           VALUES($1, $2, $3, $4, $5) RETURNING *`;
           const vals = [name, data, stream, version, meta];
           const { rows } = await client.query(sql, vals);
@@ -233,11 +279,17 @@ var PostgresStore = class {
       client.release();
     }
   }
+  /**
+   * Fetch a batch of events and streams for processing (drain cycle).
+   *
+   * @param limit The maximum number of events to fetch
+   * @returns An object with arrays of streams and events
+   */
   async fetch(limit) {
     const { rows } = await this._pool.query(
       `
       SELECT stream, at
-      FROM "${this.config.schema}"."${this.config.table}_streams"
+      FROM ${this._fqs}
       WHERE blocked=false
       ORDER BY at ASC
       LIMIT $1::integer
@@ -252,6 +304,12 @@ var PostgresStore = class {
     });
     return { streams: rows.map(({ stream }) => stream), events };
   }
+  /**
+   * Lease streams for reaction processing, marking them as in-progress.
+   *
+   * @param leases Array of lease objects (stream, at, etc.)
+   * @returns Array of leased objects with updated lease info
+   */
   async lease(leases) {
     const { by, at } = leases.at(0);
     const streams = leases.map(({ stream }) => stream);
@@ -260,7 +318,7 @@ var PostgresStore = class {
       await client.query("BEGIN");
       await client.query(
         `
-        INSERT INTO "${this.config.schema}"."${this.config.table}_streams" (stream)
+        INSERT INTO ${this._fqs} (stream)
         SELECT UNNEST($1::text[])
         ON CONFLICT (stream) DO NOTHING
         `,
@@ -269,11 +327,11 @@ var PostgresStore = class {
       const { rows } = await client.query(
         `
         WITH free AS (
-          SELECT * FROM "${this.config.schema}"."${this.config.table}_streams" 
+          SELECT * FROM ${this._fqs} 
           WHERE stream = ANY($1::text[]) AND (leased_by IS NULL OR leased_until <= NOW())
           FOR UPDATE
         )
-        UPDATE "${this.config.schema}"."${this.config.table}_streams" U
+        UPDATE ${this._fqs} U
         SET
           leased_by = $2::uuid,
           leased_at = $3::integer,
@@ -300,13 +358,19 @@ var PostgresStore = class {
       client.release();
     }
   }
+  /**
+   * Acknowledge and release leases after processing, updating stream positions.
+   *
+   * @param leases Array of lease objects to acknowledge
+   * @returns Promise that resolves when leases are acknowledged
+   */
   async ack(leases) {
     const client = await this._pool.connect();
     try {
       await client.query("BEGIN");
       for (const { stream, by, at, retry, block } of leases) {
         await client.query(
-          `UPDATE "${this.config.schema}"."${this.config.table}_streams"
+          `UPDATE ${this._fqs}
           SET
             at = $3::integer,
             retry = $4::integer,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/PostgresStore.ts","../src/utils.ts"],"sourcesContent":["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  leaseMillis: number;\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  leaseMillis: 30_000,\n};\n\nexport class PostgresStore implements Store {\n  private _pool;\n  readonly config: Config;\n\n  constructor(config: Partial<Config> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this._pool = new Pool(this.config);\n  }\n\n  async dispose() {\n    await this._pool.end();\n  }\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.config.schema}\".\"${this.config.table}\" (\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.config.schema}\".\"${this.config.table}\" (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.config.schema}\".\"${this.config.table}\" (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.config.schema}\".\"${this.config.table}\" (created, id);`\n      );\n      await client.query(\n        `CREATE INDEX IF NOT EXISTS \"${this.config.table}_correlation_ix\" \n        ON \"${this.config.schema}\".\"${this.config.table}\" ((meta ->> 'correlation') COLLATE pg_catalog.\"default\");`\n      );\n\n      // Streams table\n      await client.query(\n        `CREATE TABLE IF NOT EXISTS \"${this.config.schema}\".\"${this.config.table}_streams\" (\n          stream varchar(100) COLLATE pg_catalog.\"default\" PRIMARY KEY,\n          at int NOT NULL DEFAULT -1,\n          retry smallint NOT NULL DEFAULT 0,\n          blocked boolean NOT NULL DEFAULT false,\n          leased_at int,\n          leased_by uuid,\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.config.schema}\".\"${this.config.table}_streams\" (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(\"Failed to seed store:\", error);\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\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.config.schema}\".\"${this.config.table}\"';\n          EXECUTE 'DROP TABLE IF EXISTS \"${this.config.schema}\".\"${this.config.table}_streams\"';\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  async query<E extends Schemas>(\n    callback: (event: Committed<E, keyof E>) => void,\n    query?: Query,\n    withSnaps = false\n  ) {\n    const {\n      stream,\n      names,\n      before,\n      after,\n      limit,\n      created_before,\n      created_after,\n      backward,\n      correlation,\n    } = query || {};\n\n    let sql = `SELECT * FROM \"${this.config.schema}\".\"${this.config.table}\" WHERE`;\n    const values: any[] = [];\n\n    if (withSnaps)\n      sql = sql.concat(\n        ` id>=COALESCE((SELECT id\n            FROM \"${this.config.schema}\".\"${this.config.table}\"\n            WHERE stream='${stream}' AND name='${SNAP_EVENT}'\n            ORDER BY id DESC LIMIT 1), 0)\n            AND stream='${stream}'`\n      );\n    else if (query) {\n      if (typeof after !== \"undefined\") {\n        values.push(after);\n        sql = sql.concat(\" id>$1\");\n      } else sql = sql.concat(\" id>-1\");\n      if (stream) {\n        values.push(stream);\n        sql = sql.concat(` AND stream=$${values.length}`);\n      }\n      if (names && names.length) {\n        values.push(names);\n        sql = sql.concat(` AND name = ANY($${values.length})`);\n      }\n      if (before) {\n        values.push(before);\n        sql = sql.concat(` AND id<$${values.length}`);\n      }\n      if (created_after) {\n        values.push(created_after.toISOString());\n        sql = sql.concat(` AND created>$${values.length}`);\n      }\n      if (created_before) {\n        values.push(created_before.toISOString());\n        sql = sql.concat(` AND created<$${values.length}`);\n      }\n      if (correlation) {\n        values.push(correlation);\n        sql = sql.concat(` AND meta->>'correlation'=$${values.length}`);\n      }\n    }\n    sql = sql.concat(` ORDER BY id ${backward ? \"DESC\" : \"ASC\"}`);\n    if (limit) {\n      values.push(limit);\n      sql = sql.concat(` 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  async commit<E extends Schemas>(\n    stream: string,\n    msgs: Message<E, keyof E>[],\n    meta: EventMeta,\n    expectedVersion?: number\n  ) {\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.config.schema}\".\"${this.config.table}\"\n        WHERE stream=$1 ORDER BY version DESC LIMIT 1`,\n        [stream]\n      );\n      version = last.rowCount ? last.rows[0].version : -1;\n      if (expectedVersion && version !== expectedVersion)\n        throw new ConcurrencyError(\n          version,\n          msgs as unknown as Message<Schemas, string>[],\n          expectedVersion\n        );\n\n      const committed = await Promise.all(\n        msgs.map(async ({ name, data }) => {\n          version++;\n          const sql = `\n          INSERT INTO \"${this.config.schema}\".\"${this.config.table}\"(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          return rows.at(0)!;\n        })\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            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  async fetch<E extends Schemas>(limit: number) {\n    const { rows } = await this._pool.query<{ stream: string; at: number }>(\n      `\n      SELECT stream, at\n      FROM \"${this.config.schema}\".\"${this.config.table}_streams\"\n      WHERE blocked=false\n      ORDER BY at ASC\n      LIMIT $1::integer\n      `,\n      [limit]\n    );\n\n    const after = rows.length\n      ? rows.reduce((min, r) => Math.min(min, r.at), Number.MAX_SAFE_INTEGER)\n      : -1;\n\n    const events: Committed<E, keyof E>[] = [];\n    await this.query<E>((e) => e.name !== SNAP_EVENT && events.push(e), {\n      after,\n      limit,\n    });\n    return { streams: rows.map(({ stream }) => stream), events };\n  }\n\n  async lease(leases: Lease[]) {\n    const { by, at } = leases.at(0)!;\n    const streams = leases.map(({ stream }) => stream);\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n      // insert new streams\n      await client.query(\n        `\n        INSERT INTO \"${this.config.schema}\".\"${this.config.table}_streams\" (stream)\n        SELECT UNNEST($1::text[])\n        ON CONFLICT (stream) DO NOTHING\n        `,\n        [streams]\n      );\n      // set leases\n      const { rows } = await client.query<{\n        stream: string;\n        leased_at: number;\n        retry: number;\n      }>(\n        `\n        WITH free AS (\n          SELECT * FROM \"${this.config.schema}\".\"${this.config.table}_streams\" \n          WHERE stream = ANY($1::text[]) AND (leased_by IS NULL OR leased_until <= NOW())\n          FOR UPDATE\n        )\n        UPDATE \"${this.config.schema}\".\"${this.config.table}_streams\" U\n        SET\n          leased_by = $2::uuid,\n          leased_at = $3::integer,\n          leased_until = NOW() + ($4::integer || ' milliseconds')::interval\n        FROM free\n        WHERE U.stream = free.stream\n        RETURNING U.stream, U.leased_at, U.retry\n        `,\n        [streams, by, at, this.config.leaseMillis]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map(({ stream, leased_at, retry }) => ({\n        stream,\n        by,\n        at: leased_at,\n        retry,\n        block: false,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  async ack(leases: Lease[]) {\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n      for (const { stream, by, at, retry, block } of leases) {\n        await client.query(\n          `UPDATE \"${this.config.schema}\".\"${this.config.table}_streams\"\n          SET\n            at = $3::integer,\n            retry = $4::integer,\n            blocked = $5::boolean,\n            leased_by = NULL,\n            leased_at = NULL,\n            leased_until = NULL\n          WHERE\n            stream = $1::text\n            AND leased_by = $2::uuid`,\n          [stream, by, at, retry, block]\n        );\n      }\n      await client.query(\"COMMIT\");\n    } catch {\n      // leased_until fallback\n      await client.query(\"ROLLBACK\").catch(() => {});\n    } finally {\n      client.release();\n    }\n  }\n}\n","/**\n * Date reviver when parsing JSON strings with 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 */\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":[]}
+{"version":3,"sources":["../src/PostgresStore.ts","../src/utils.ts"],"sourcesContent":["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  leaseMillis: number;\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  leaseMillis: 30_000,\n};\n\n/**\n * @category Adapters\n * @see Store\n *\n * PostgresStore is a production-ready event store adapter for Act, using PostgreSQL as the backend.\n *\n * - Supports event sourcing, leasing, snapshots, and concurrency control.\n * - Designed for high-throughput, scalable, and reliable event storage.\n * - Implements the Act Store interface.\n *\n * @example\n * import { PostgresStore } from \"@act/pg\";\n * const store = new PostgresStore({ schema: \"my_schema\", table: \"events\" });\n * await store.seed();\n *\n * @see https://github.com/rotorsoft/act-root\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          at int NOT NULL DEFAULT -1,\n          retry smallint NOT NULL DEFAULT 0,\n          blocked boolean NOT NULL DEFAULT false,\n          leased_at int,\n          leased_by uuid,\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(\"Failed to seed store:\", 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   * @param withSnaps (Optional) If true, includes only events after the last snapshot\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    withSnaps = false\n  ) {\n    const {\n      stream,\n      names,\n      before,\n      after,\n      limit,\n      created_before,\n      created_after,\n      backward,\n      correlation,\n    } = query || {};\n\n    let sql = `SELECT * FROM ${this._fqt}`;\n    const conditions: string[] = [];\n    const values: any[] = [];\n\n    if (withSnaps) {\n      conditions.push(\n        `id>=COALESCE((SELECT id FROM ${this._fqt} WHERE stream='${stream}' AND name='${SNAP_EVENT}' ORDER BY id DESC LIMIT 1), 0)`\n      );\n      conditions.push(`stream='${stream}'`);\n    } else 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    }\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          version,\n          msgs as unknown as Message<Schemas, string>[],\n          expectedVersion\n        );\n\n      const committed = await Promise.all(\n        msgs.map(async ({ name, data }) => {\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          return rows.at(0)!;\n        })\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            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   * Fetch a batch of events and streams for processing (drain cycle).\n   *\n   * @param limit The maximum number of events to fetch\n   * @returns An object with arrays of streams and events\n   */\n  async fetch<E extends Schemas>(limit: number) {\n    const { rows } = await this._pool.query<{ stream: string; at: number }>(\n      `\n      SELECT stream, at\n      FROM ${this._fqs}\n      WHERE blocked=false\n      ORDER BY at ASC\n      LIMIT $1::integer\n      `,\n      [limit]\n    );\n\n    const after = rows.length\n      ? rows.reduce((min, r) => Math.min(min, r.at), Number.MAX_SAFE_INTEGER)\n      : -1;\n\n    const events: Committed<E, keyof E>[] = [];\n    await this.query<E>((e) => e.name !== SNAP_EVENT && events.push(e), {\n      after,\n      limit,\n    });\n    return { streams: rows.map(({ stream }) => stream), events };\n  }\n\n  /**\n   * Lease streams for reaction processing, marking them as in-progress.\n   *\n   * @param leases Array of lease objects (stream, at, etc.)\n   * @returns Array of leased objects with updated lease info\n   */\n  async lease(leases: Lease[]) {\n    const { by, at } = leases.at(0)!;\n    const streams = leases.map(({ stream }) => stream);\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n      // insert new streams\n      await client.query(\n        `\n        INSERT INTO ${this._fqs} (stream)\n        SELECT UNNEST($1::text[])\n        ON CONFLICT (stream) DO NOTHING\n        `,\n        [streams]\n      );\n      // set leases\n      const { rows } = await client.query<{\n        stream: string;\n        leased_at: number;\n        retry: number;\n      }>(\n        `\n        WITH free AS (\n          SELECT * FROM ${this._fqs} \n          WHERE stream = ANY($1::text[]) AND (leased_by IS NULL OR leased_until <= NOW())\n          FOR UPDATE\n        )\n        UPDATE ${this._fqs} U\n        SET\n          leased_by = $2::uuid,\n          leased_at = $3::integer,\n          leased_until = NOW() + ($4::integer || ' milliseconds')::interval\n        FROM free\n        WHERE U.stream = free.stream\n        RETURNING U.stream, U.leased_at, U.retry\n        `,\n        [streams, by, at, this.config.leaseMillis]\n      );\n      await client.query(\"COMMIT\");\n\n      return rows.map(({ stream, leased_at, retry }) => ({\n        stream,\n        by,\n        at: leased_at,\n        retry,\n        block: false,\n      }));\n    } catch (error) {\n      await client.query(\"ROLLBACK\").catch(() => {});\n      throw error;\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Acknowledge and release leases after processing, updating stream positions.\n   *\n   * @param leases Array of lease objects to acknowledge\n   * @returns Promise that resolves when leases are acknowledged\n   */\n  async ack(leases: Lease[]) {\n    const client = await this._pool.connect();\n\n    try {\n      await client.query(\"BEGIN\");\n      for (const { stream, by, at, retry, block } of leases) {\n        await client.query(\n          `UPDATE ${this._fqs}\n          SET\n            at = $3::integer,\n            retry = $4::integer,\n            blocked = $5::boolean,\n            leased_by = NULL,\n            leased_at = NULL,\n            leased_until = NULL\n          WHERE\n            stream = $1::text\n            AND leased_by = $2::uuid`,\n          [stream, by, at, retry, block]\n        );\n      }\n      await client.query(\"COMMIT\");\n    } catch {\n      // leased_until fallback\n      await client.query(\"ROLLBACK\").catch(() => {});\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":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rotorsoft/act-pg",
   "type": "module",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "act pg adapters",
   "author": "rotorsoft",
   "license": "MIT",
@@ -25,15 +25,15 @@
   },
   "sideEffects": false,
   "engines": {
-    "node": ">=18"
+    "node": ">=18.20.8"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "pg": "^8.16.2",
-    "zod": "^3.25.67",
-    "@rotorsoft/act": "0.5.1"
+    "pg": "^8.16.3",
+    "zod": "^3.25.74",
+    "@rotorsoft/act": "0.5.2"
   },
   "devDependencies": {
     "@types/pg": "^8.15.4"