@saga-bus/store-postgres 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @saga-bus/store-postgres
+
+PostgreSQL saga store using native pg driver.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/store-postgres pg
+```
+
+## Usage
+
+```typescript
+import { Pool } from "pg";
+import { PostgresSagaStore, createSchema } from "@saga-bus/store-postgres";
+import { createBus } from "@saga-bus/core";
+
+const pool = new Pool({
+  connectionString: "postgresql://user:pass@localhost:5432/mydb",
+});
+
+// Initialize schema (run once)
+await createSchema(pool);
+
+const store = new PostgresSagaStore({ pool });
+
+const bus = createBus({
+  sagas: [{ definition: mySaga, store }],
+  transport,
+});
+```
+
+## Database Schema
+
+The `createSchema` function creates:
+
+```sql
+CREATE TABLE saga_instances (
+  id             VARCHAR(128) NOT NULL,
+  saga_name      VARCHAR(128) NOT NULL,
+  correlation_id VARCHAR(256) NOT NULL,
+  version        INTEGER NOT NULL,
+  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,
+  state          JSONB NOT NULL,
+  created_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (saga_name, id)
+);
+```
+
+## Features
+
+- Optimistic concurrency with version column
+- JSONB state storage
+- Connection pooling
+- Indexed lookups by correlation ID
+- Cleanup helpers for completed sagas
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `pool` | `Pool` | required | pg Pool instance |
+| `schema` | `string` | `"public"` | Database schema |
+| `tableName` | `string` | `"saga_instances"` | Table name |
+
+## Sharing Across Sagas
+
+A single store instance can be shared across multiple sagas:
+
+```typescript
+const store = new PostgresSagaStore({ pool });
+
+const bus = createBus({
+  transport,
+  store, // shared by all sagas
+  sagas: [
+    { definition: orderSaga },
+    { definition: paymentSaga },
+  ],
+});
+```
+
+Data is isolated by `saga_name` in the database, so different saga types won't conflict.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,286 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PostgresSagaStore: () => PostgresSagaStore,
+  createSchema: () => createSchema,
+  dropSchema: () => dropSchema,
+  getSchemaSql: () => getSchemaSql
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/PostgresSagaStore.ts
+var import_pg = require("pg");
+var import_core = require("@saga-bus/core");
+var PostgresSagaStore = class {
+  pool;
+  tableName;
+  schema;
+  ownsPool;
+  constructor(options) {
+    if (options.pool instanceof import_pg.Pool) {
+      this.pool = options.pool;
+      this.ownsPool = false;
+    } else {
+      this.pool = new import_pg.Pool(options.pool);
+      this.ownsPool = true;
+    }
+    this.tableName = options.tableName ?? "saga_instances";
+    this.schema = options.schema ?? "public";
+  }
+  /**
+   * Get the full table name with schema.
+   */
+  get fullTableName() {
+    return `${this.schema}.${this.tableName}`;
+  }
+  async getById(sagaName, sagaId) {
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,
+      [sagaId, sagaName]
+    );
+    if (result.rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(result.rows[0]);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1 AND correlation_id = $2`,
+      [sagaName, correlationId]
+    );
+    if (result.rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(result.rows[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO ${this.fullTableName}
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  /**
+   * Insert a saga with explicit correlation ID.
+   */
+  async insertWithCorrelation(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO ${this.fullTableName}
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const result = await this.pool.query(
+      `UPDATE ${this.fullTableName}
+       SET version = $1, is_completed = $2, state = $3, updated_at = $4
+       WHERE id = $5 AND saga_name = $6 AND version = $7`,
+      [
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        updatedAt,
+        sagaId,
+        sagaName,
+        expectedVersion
+      ]
+    );
+    if (result.rowCount === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (existing) {
+        throw new import_core.ConcurrencyError(
+          sagaId,
+          expectedVersion,
+          existing.metadata.version
+        );
+      } else {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    await this.pool.query(
+      `DELETE FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,
+      [sagaId, sagaName]
+    );
+  }
+  /**
+   * Convert a database row to saga state.
+   */
+  rowToState(row) {
+    const state = row.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: row.id,
+        version: row.version,
+        isCompleted: row.is_completed,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at)
+      }
+    };
+  }
+  /**
+   * Close the connection pool (if owned by this store).
+   */
+  async close() {
+    if (this.ownsPool) {
+      await this.pool.end();
+    }
+  }
+  /**
+   * Get the underlying pool for advanced operations.
+   */
+  getPool() {
+    return this.pool;
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    let query = `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = $${params.length + 1}`;
+      params.push(options.completed);
+    }
+    query += ` ORDER BY created_at DESC`;
+    if (options?.limit) {
+      query += ` LIMIT $${params.length + 1}`;
+      params.push(options.limit);
+    }
+    if (options?.offset) {
+      query += ` OFFSET $${params.length + 1}`;
+      params.push(options.offset);
+    }
+    const result = await this.pool.query(query, params);
+    return result.rows.map((row) => this.rowToState(row));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    let query = `SELECT COUNT(*) FROM ${this.fullTableName} WHERE saga_name = $1`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = $${params.length + 1}`;
+      params.push(options.completed);
+    }
+    const result = await this.pool.query(query, params);
+    return parseInt(result.rows[0]?.count ?? "0", 10);
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    const result = await this.pool.query(
+      `DELETE FROM ${this.fullTableName}
+       WHERE saga_name = $1 AND is_completed = true AND updated_at < $2`,
+      [sagaName, before]
+    );
+    return result.rowCount ?? 0;
+  }
+};
+
+// src/schema.ts
+function getSchemaSql() {
+  return `
+-- Saga instances table
+CREATE TABLE IF NOT EXISTS saga_instances (
+  id             VARCHAR(128) NOT NULL,
+  saga_name      VARCHAR(128) NOT NULL,
+  correlation_id VARCHAR(256) NOT NULL,
+  version        INTEGER NOT NULL,
+  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,
+  state          JSONB NOT NULL,
+  created_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (saga_name, id)
+);
+
+-- Index for looking up sagas by name
+CREATE INDEX IF NOT EXISTS idx_saga_instances_saga_name
+  ON saga_instances (saga_name);
+
+-- Index for correlation ID lookups (saga_name + correlation_id)
+CREATE UNIQUE INDEX IF NOT EXISTS idx_saga_instances_correlation
+  ON saga_instances (saga_name, correlation_id);
+
+-- Index for finding incomplete sagas
+CREATE INDEX IF NOT EXISTS idx_saga_instances_incomplete
+  ON saga_instances (saga_name, is_completed)
+  WHERE is_completed = FALSE;
+
+-- Index for cleanup queries (completed + updated_at)
+CREATE INDEX IF NOT EXISTS idx_saga_instances_cleanup
+  ON saga_instances (saga_name, is_completed, updated_at)
+  WHERE is_completed = TRUE;
+`.trim();
+}
+async function createSchema(pool, options) {
+  const schema = options?.schema ?? "public";
+  const tableName = options?.tableName ?? "saga_instances";
+  await pool.query(`SET search_path TO ${schema}`);
+  let sql = getSchemaSql();
+  if (tableName !== "saga_instances") {
+    sql = sql.replace(/saga_instances/g, tableName);
+  }
+  await pool.query(sql);
+}
+async function dropSchema(pool, options) {
+  const schema = options?.schema ?? "public";
+  const tableName = options?.tableName ?? "saga_instances";
+  await pool.query(`DROP TABLE IF EXISTS ${schema}.${tableName} CASCADE`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PostgresSagaStore,
+  createSchema,
+  dropSchema,
+  getSchemaSql
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/PostgresSagaStore.ts","../src/schema.ts"],"sourcesContent":["export { PostgresSagaStore } from \"./PostgresSagaStore.js\";\nexport { createSchema, dropSchema, getSchemaSql } from \"./schema.js\";\nexport type { PostgresSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n","import { Pool } from \"pg\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { PostgresSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n\n/**\n * PostgreSQL-backed saga store using native pg driver.\n *\n * @example\n * ```typescript\n * const store = new PostgresSagaStore<OrderState>({\n *   pool: new Pool({ connectionString: process.env.DATABASE_URL }),\n * });\n *\n * // Or with pool config\n * const store = new PostgresSagaStore<OrderState>({\n *   pool: { connectionString: process.env.DATABASE_URL },\n * });\n * ```\n */\nexport class PostgresSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly pool: Pool;\n  private readonly tableName: string;\n  private readonly schema: string;\n  private readonly ownsPool: boolean;\n\n  constructor(options: PostgresSagaStoreOptions) {\n    if (options.pool instanceof Pool) {\n      this.pool = options.pool;\n      this.ownsPool = false;\n    } else {\n      this.pool = new Pool(options.pool);\n      this.ownsPool = true;\n    }\n\n    this.tableName = options.tableName ?? \"saga_instances\";\n    this.schema = options.schema ?? \"public\";\n  }\n\n  /**\n   * Get the full table name with schema.\n   */\n  private get fullTableName(): string {\n    return `${this.schema}.${this.tableName}`;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const result = await this.pool.query<SagaInstanceRow>(\n      `SELECT * FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,\n      [sagaId, sagaName]\n    );\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(result.rows[0]!);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const result = await this.pool.query<SagaInstanceRow>(\n      `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1 AND correlation_id = $2`,\n      [sagaName, correlationId]\n    );\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(result.rows[0]!);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO ${this.fullTableName}\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  /**\n   * Insert a saga with explicit correlation ID.\n   */\n  async insertWithCorrelation(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO ${this.fullTableName}\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    const result = await this.pool.query(\n      `UPDATE ${this.fullTableName}\n       SET version = $1, is_completed = $2, state = $3, updated_at = $4\n       WHERE id = $5 AND saga_name = $6 AND version = $7`,\n      [\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        updatedAt,\n        sagaId,\n        sagaName,\n        expectedVersion,\n      ]\n    );\n\n    if (result.rowCount === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n      if (existing) {\n        throw new ConcurrencyError(\n          sagaId,\n          expectedVersion,\n          existing.metadata.version\n        );\n      } else {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    await this.pool.query(\n      `DELETE FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,\n      [sagaId, sagaName]\n    );\n  }\n\n  /**\n   * Convert a database row to saga state.\n   */\n  private rowToState(row: SagaInstanceRow): TState {\n    const state = row.state as TState;\n\n    // Ensure metadata dates are Date objects\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: row.id,\n        version: row.version,\n        isCompleted: row.is_completed,\n        createdAt: new Date(row.created_at),\n        updatedAt: new Date(row.updated_at),\n      },\n    };\n  }\n\n  /**\n   * Close the connection pool (if owned by this store).\n   */\n  async close(): Promise<void> {\n    if (this.ownsPool) {\n      await this.pool.end();\n    }\n  }\n\n  /**\n   * Get the underlying pool for advanced operations.\n   */\n  getPool(): Pool {\n    return this.pool;\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Find sagas by name with pagination.\n   */\n  async findByName(\n    sagaName: string,\n    options?: {\n      limit?: number;\n      offset?: number;\n      completed?: boolean;\n    }\n  ): Promise<TState[]> {\n    let query = `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1`;\n    const params: unknown[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = $${params.length + 1}`;\n      params.push(options.completed);\n    }\n\n    query += ` ORDER BY created_at DESC`;\n\n    if (options?.limit) {\n      query += ` LIMIT $${params.length + 1}`;\n      params.push(options.limit);\n    }\n\n    if (options?.offset) {\n      query += ` OFFSET $${params.length + 1}`;\n      params.push(options.offset);\n    }\n\n    const result = await this.pool.query<SagaInstanceRow>(query, params);\n    return result.rows.map((row) => this.rowToState(row));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    let query = `SELECT COUNT(*) FROM ${this.fullTableName} WHERE saga_name = $1`;\n    const params: unknown[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = $${params.length + 1}`;\n      params.push(options.completed);\n    }\n\n    const result = await this.pool.query<{ count: string }>(query, params);\n    return parseInt(result.rows[0]?.count ?? \"0\", 10);\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    const result = await this.pool.query(\n      `DELETE FROM ${this.fullTableName}\n       WHERE saga_name = $1 AND is_completed = true AND updated_at < $2`,\n      [sagaName, before]\n    );\n\n    return result.rowCount ?? 0;\n  }\n}\n","import type { Pool } from \"pg\";\n\n/**\n * Get the schema SQL content.\n */\nexport function getSchemaSql(): string {\n  return `\n-- Saga instances table\nCREATE TABLE IF NOT EXISTS saga_instances (\n  id             VARCHAR(128) NOT NULL,\n  saga_name      VARCHAR(128) NOT NULL,\n  correlation_id VARCHAR(256) NOT NULL,\n  version        INTEGER NOT NULL,\n  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,\n  state          JSONB NOT NULL,\n  created_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n  updated_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n  PRIMARY KEY (saga_name, id)\n);\n\n-- Index for looking up sagas by name\nCREATE INDEX IF NOT EXISTS idx_saga_instances_saga_name\n  ON saga_instances (saga_name);\n\n-- Index for correlation ID lookups (saga_name + correlation_id)\nCREATE UNIQUE INDEX IF NOT EXISTS idx_saga_instances_correlation\n  ON saga_instances (saga_name, correlation_id);\n\n-- Index for finding incomplete sagas\nCREATE INDEX IF NOT EXISTS idx_saga_instances_incomplete\n  ON saga_instances (saga_name, is_completed)\n  WHERE is_completed = FALSE;\n\n-- Index for cleanup queries (completed + updated_at)\nCREATE INDEX IF NOT EXISTS idx_saga_instances_cleanup\n  ON saga_instances (saga_name, is_completed, updated_at)\n  WHERE is_completed = TRUE;\n`.trim();\n}\n\n/**\n * Create the saga_instances table and indexes.\n */\nexport async function createSchema(\n  pool: Pool,\n  options?: { schema?: string; tableName?: string }\n): Promise<void> {\n  const schema = options?.schema ?? \"public\";\n  const tableName = options?.tableName ?? \"saga_instances\";\n\n  // Set search path to the schema\n  await pool.query(`SET search_path TO ${schema}`);\n\n  // Create table with custom name if specified\n  let sql = getSchemaSql();\n  if (tableName !== \"saga_instances\") {\n    sql = sql.replace(/saga_instances/g, tableName);\n  }\n\n  await pool.query(sql);\n}\n\n/**\n * Drop the saga_instances table.\n */\nexport async function dropSchema(\n  pool: Pool,\n  options?: { schema?: string; tableName?: string }\n): Promise<void> {\n  const schema = options?.schema ?? \"public\";\n  const tableName = options?.tableName ?? \"saga_instances\";\n\n  await pool.query(`DROP TABLE IF EXISTS ${schema}.${tableName} CASCADE`);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,120 @@
+import { Pool, PoolConfig } from 'pg';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Options for creating a PostgresSagaStore.
+ */
+interface PostgresSagaStoreOptions {
+    /**
+     * PostgreSQL connection pool or pool configuration.
+     */
+    pool: Pool | PoolConfig;
+    /**
+     * Table name for saga instances. Default: "saga_instances"
+     */
+    tableName?: string;
+    /**
+     * Schema name. Default: "public"
+     */
+    schema?: string;
+}
+/**
+ * Row structure in the saga_instances table.
+ */
+interface SagaInstanceRow {
+    id: string;
+    saga_name: string;
+    correlation_id: string;
+    version: number;
+    is_completed: boolean;
+    state: unknown;
+    created_at: Date;
+    updated_at: Date;
+}
+
+/**
+ * PostgreSQL-backed saga store using native pg driver.
+ *
+ * @example
+ * ```typescript
+ * const store = new PostgresSagaStore<OrderState>({
+ *   pool: new Pool({ connectionString: process.env.DATABASE_URL }),
+ * });
+ *
+ * // Or with pool config
+ * const store = new PostgresSagaStore<OrderState>({
+ *   pool: { connectionString: process.env.DATABASE_URL },
+ * });
+ * ```
+ */
+declare class PostgresSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly pool;
+    private readonly tableName;
+    private readonly schema;
+    private readonly ownsPool;
+    constructor(options: PostgresSagaStoreOptions);
+    /**
+     * Get the full table name with schema.
+     */
+    private get fullTableName();
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    /**
+     * Insert a saga with explicit correlation ID.
+     */
+    insertWithCorrelation(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+    /**
+     * Convert a database row to saga state.
+     */
+    private rowToState;
+    /**
+     * Close the connection pool (if owned by this store).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying pool for advanced operations.
+     */
+    getPool(): Pool;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        offset?: number;
+        completed?: boolean;
+    }): Promise<TState[]>;
+    /**
+     * Count sagas by name.
+     */
+    countByName(sagaName: string, options?: {
+        completed?: boolean;
+    }): Promise<number>;
+    /**
+     * Delete completed sagas older than a given date.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+/**
+ * Get the schema SQL content.
+ */
+declare function getSchemaSql(): string;
+/**
+ * Create the saga_instances table and indexes.
+ */
+declare function createSchema(pool: Pool, options?: {
+    schema?: string;
+    tableName?: string;
+}): Promise<void>;
+/**
+ * Drop the saga_instances table.
+ */
+declare function dropSchema(pool: Pool, options?: {
+    schema?: string;
+    tableName?: string;
+}): Promise<void>;
+
+export { PostgresSagaStore, type PostgresSagaStoreOptions, type SagaInstanceRow, createSchema, dropSchema, getSchemaSql };

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+import { Pool, PoolConfig } from 'pg';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Options for creating a PostgresSagaStore.
+ */
+interface PostgresSagaStoreOptions {
+    /**
+     * PostgreSQL connection pool or pool configuration.
+     */
+    pool: Pool | PoolConfig;
+    /**
+     * Table name for saga instances. Default: "saga_instances"
+     */
+    tableName?: string;
+    /**
+     * Schema name. Default: "public"
+     */
+    schema?: string;
+}
+/**
+ * Row structure in the saga_instances table.
+ */
+interface SagaInstanceRow {
+    id: string;
+    saga_name: string;
+    correlation_id: string;
+    version: number;
+    is_completed: boolean;
+    state: unknown;
+    created_at: Date;
+    updated_at: Date;
+}
+
+/**
+ * PostgreSQL-backed saga store using native pg driver.
+ *
+ * @example
+ * ```typescript
+ * const store = new PostgresSagaStore<OrderState>({
+ *   pool: new Pool({ connectionString: process.env.DATABASE_URL }),
+ * });
+ *
+ * // Or with pool config
+ * const store = new PostgresSagaStore<OrderState>({
+ *   pool: { connectionString: process.env.DATABASE_URL },
+ * });
+ * ```
+ */
+declare class PostgresSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly pool;
+    private readonly tableName;
+    private readonly schema;
+    private readonly ownsPool;
+    constructor(options: PostgresSagaStoreOptions);
+    /**
+     * Get the full table name with schema.
+     */
+    private get fullTableName();
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    /**
+     * Insert a saga with explicit correlation ID.
+     */
+    insertWithCorrelation(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+    /**
+     * Convert a database row to saga state.
+     */
+    private rowToState;
+    /**
+     * Close the connection pool (if owned by this store).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying pool for advanced operations.
+     */
+    getPool(): Pool;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        offset?: number;
+        completed?: boolean;
+    }): Promise<TState[]>;
+    /**
+     * Count sagas by name.
+     */
+    countByName(sagaName: string, options?: {
+        completed?: boolean;
+    }): Promise<number>;
+    /**
+     * Delete completed sagas older than a given date.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+/**
+ * Get the schema SQL content.
+ */
+declare function getSchemaSql(): string;
+/**
+ * Create the saga_instances table and indexes.
+ */
+declare function createSchema(pool: Pool, options?: {
+    schema?: string;
+    tableName?: string;
+}): Promise<void>;
+/**
+ * Drop the saga_instances table.
+ */
+declare function dropSchema(pool: Pool, options?: {
+    schema?: string;
+    tableName?: string;
+}): Promise<void>;
+
+export { PostgresSagaStore, type PostgresSagaStoreOptions, type SagaInstanceRow, createSchema, dropSchema, getSchemaSql };

package/dist/index.js

@@ -0,0 +1,256 @@
+// src/PostgresSagaStore.ts
+import { Pool } from "pg";
+import { ConcurrencyError } from "@saga-bus/core";
+var PostgresSagaStore = class {
+  pool;
+  tableName;
+  schema;
+  ownsPool;
+  constructor(options) {
+    if (options.pool instanceof Pool) {
+      this.pool = options.pool;
+      this.ownsPool = false;
+    } else {
+      this.pool = new Pool(options.pool);
+      this.ownsPool = true;
+    }
+    this.tableName = options.tableName ?? "saga_instances";
+    this.schema = options.schema ?? "public";
+  }
+  /**
+   * Get the full table name with schema.
+   */
+  get fullTableName() {
+    return `${this.schema}.${this.tableName}`;
+  }
+  async getById(sagaName, sagaId) {
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,
+      [sagaId, sagaName]
+    );
+    if (result.rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(result.rows[0]);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1 AND correlation_id = $2`,
+      [sagaName, correlationId]
+    );
+    if (result.rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(result.rows[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO ${this.fullTableName}
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  /**
+   * Insert a saga with explicit correlation ID.
+   */
+  async insertWithCorrelation(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO ${this.fullTableName}
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const result = await this.pool.query(
+      `UPDATE ${this.fullTableName}
+       SET version = $1, is_completed = $2, state = $3, updated_at = $4
+       WHERE id = $5 AND saga_name = $6 AND version = $7`,
+      [
+        version,
+        isCompleted,
+        JSON.stringify(state),
+        updatedAt,
+        sagaId,
+        sagaName,
+        expectedVersion
+      ]
+    );
+    if (result.rowCount === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (existing) {
+        throw new ConcurrencyError(
+          sagaId,
+          expectedVersion,
+          existing.metadata.version
+        );
+      } else {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    await this.pool.query(
+      `DELETE FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,
+      [sagaId, sagaName]
+    );
+  }
+  /**
+   * Convert a database row to saga state.
+   */
+  rowToState(row) {
+    const state = row.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: row.id,
+        version: row.version,
+        isCompleted: row.is_completed,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at)
+      }
+    };
+  }
+  /**
+   * Close the connection pool (if owned by this store).
+   */
+  async close() {
+    if (this.ownsPool) {
+      await this.pool.end();
+    }
+  }
+  /**
+   * Get the underlying pool for advanced operations.
+   */
+  getPool() {
+    return this.pool;
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    let query = `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = $${params.length + 1}`;
+      params.push(options.completed);
+    }
+    query += ` ORDER BY created_at DESC`;
+    if (options?.limit) {
+      query += ` LIMIT $${params.length + 1}`;
+      params.push(options.limit);
+    }
+    if (options?.offset) {
+      query += ` OFFSET $${params.length + 1}`;
+      params.push(options.offset);
+    }
+    const result = await this.pool.query(query, params);
+    return result.rows.map((row) => this.rowToState(row));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    let query = `SELECT COUNT(*) FROM ${this.fullTableName} WHERE saga_name = $1`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = $${params.length + 1}`;
+      params.push(options.completed);
+    }
+    const result = await this.pool.query(query, params);
+    return parseInt(result.rows[0]?.count ?? "0", 10);
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    const result = await this.pool.query(
+      `DELETE FROM ${this.fullTableName}
+       WHERE saga_name = $1 AND is_completed = true AND updated_at < $2`,
+      [sagaName, before]
+    );
+    return result.rowCount ?? 0;
+  }
+};
+
+// src/schema.ts
+function getSchemaSql() {
+  return `
+-- Saga instances table
+CREATE TABLE IF NOT EXISTS saga_instances (
+  id             VARCHAR(128) NOT NULL,
+  saga_name      VARCHAR(128) NOT NULL,
+  correlation_id VARCHAR(256) NOT NULL,
+  version        INTEGER NOT NULL,
+  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,
+  state          JSONB NOT NULL,
+  created_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (saga_name, id)
+);
+
+-- Index for looking up sagas by name
+CREATE INDEX IF NOT EXISTS idx_saga_instances_saga_name
+  ON saga_instances (saga_name);
+
+-- Index for correlation ID lookups (saga_name + correlation_id)
+CREATE UNIQUE INDEX IF NOT EXISTS idx_saga_instances_correlation
+  ON saga_instances (saga_name, correlation_id);
+
+-- Index for finding incomplete sagas
+CREATE INDEX IF NOT EXISTS idx_saga_instances_incomplete
+  ON saga_instances (saga_name, is_completed)
+  WHERE is_completed = FALSE;
+
+-- Index for cleanup queries (completed + updated_at)
+CREATE INDEX IF NOT EXISTS idx_saga_instances_cleanup
+  ON saga_instances (saga_name, is_completed, updated_at)
+  WHERE is_completed = TRUE;
+`.trim();
+}
+async function createSchema(pool, options) {
+  const schema = options?.schema ?? "public";
+  const tableName = options?.tableName ?? "saga_instances";
+  await pool.query(`SET search_path TO ${schema}`);
+  let sql = getSchemaSql();
+  if (tableName !== "saga_instances") {
+    sql = sql.replace(/saga_instances/g, tableName);
+  }
+  await pool.query(sql);
+}
+async function dropSchema(pool, options) {
+  const schema = options?.schema ?? "public";
+  const tableName = options?.tableName ?? "saga_instances";
+  await pool.query(`DROP TABLE IF EXISTS ${schema}.${tableName} CASCADE`);
+}
+export {
+  PostgresSagaStore,
+  createSchema,
+  dropSchema,
+  getSchemaSql
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PostgresSagaStore.ts","../src/schema.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { PostgresSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n\n/**\n * PostgreSQL-backed saga store using native pg driver.\n *\n * @example\n * ```typescript\n * const store = new PostgresSagaStore<OrderState>({\n *   pool: new Pool({ connectionString: process.env.DATABASE_URL }),\n * });\n *\n * // Or with pool config\n * const store = new PostgresSagaStore<OrderState>({\n *   pool: { connectionString: process.env.DATABASE_URL },\n * });\n * ```\n */\nexport class PostgresSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly pool: Pool;\n  private readonly tableName: string;\n  private readonly schema: string;\n  private readonly ownsPool: boolean;\n\n  constructor(options: PostgresSagaStoreOptions) {\n    if (options.pool instanceof Pool) {\n      this.pool = options.pool;\n      this.ownsPool = false;\n    } else {\n      this.pool = new Pool(options.pool);\n      this.ownsPool = true;\n    }\n\n    this.tableName = options.tableName ?? \"saga_instances\";\n    this.schema = options.schema ?? \"public\";\n  }\n\n  /**\n   * Get the full table name with schema.\n   */\n  private get fullTableName(): string {\n    return `${this.schema}.${this.tableName}`;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const result = await this.pool.query<SagaInstanceRow>(\n      `SELECT * FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,\n      [sagaId, sagaName]\n    );\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(result.rows[0]!);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const result = await this.pool.query<SagaInstanceRow>(\n      `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1 AND correlation_id = $2`,\n      [sagaName, correlationId]\n    );\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(result.rows[0]!);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO ${this.fullTableName}\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  /**\n   * Insert a saga with explicit correlation ID.\n   */\n  async insertWithCorrelation(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO ${this.fullTableName}\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    const result = await this.pool.query(\n      `UPDATE ${this.fullTableName}\n       SET version = $1, is_completed = $2, state = $3, updated_at = $4\n       WHERE id = $5 AND saga_name = $6 AND version = $7`,\n      [\n        version,\n        isCompleted,\n        JSON.stringify(state),\n        updatedAt,\n        sagaId,\n        sagaName,\n        expectedVersion,\n      ]\n    );\n\n    if (result.rowCount === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n      if (existing) {\n        throw new ConcurrencyError(\n          sagaId,\n          expectedVersion,\n          existing.metadata.version\n        );\n      } else {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    await this.pool.query(\n      `DELETE FROM ${this.fullTableName} WHERE id = $1 AND saga_name = $2`,\n      [sagaId, sagaName]\n    );\n  }\n\n  /**\n   * Convert a database row to saga state.\n   */\n  private rowToState(row: SagaInstanceRow): TState {\n    const state = row.state as TState;\n\n    // Ensure metadata dates are Date objects\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: row.id,\n        version: row.version,\n        isCompleted: row.is_completed,\n        createdAt: new Date(row.created_at),\n        updatedAt: new Date(row.updated_at),\n      },\n    };\n  }\n\n  /**\n   * Close the connection pool (if owned by this store).\n   */\n  async close(): Promise<void> {\n    if (this.ownsPool) {\n      await this.pool.end();\n    }\n  }\n\n  /**\n   * Get the underlying pool for advanced operations.\n   */\n  getPool(): Pool {\n    return this.pool;\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Find sagas by name with pagination.\n   */\n  async findByName(\n    sagaName: string,\n    options?: {\n      limit?: number;\n      offset?: number;\n      completed?: boolean;\n    }\n  ): Promise<TState[]> {\n    let query = `SELECT * FROM ${this.fullTableName} WHERE saga_name = $1`;\n    const params: unknown[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = $${params.length + 1}`;\n      params.push(options.completed);\n    }\n\n    query += ` ORDER BY created_at DESC`;\n\n    if (options?.limit) {\n      query += ` LIMIT $${params.length + 1}`;\n      params.push(options.limit);\n    }\n\n    if (options?.offset) {\n      query += ` OFFSET $${params.length + 1}`;\n      params.push(options.offset);\n    }\n\n    const result = await this.pool.query<SagaInstanceRow>(query, params);\n    return result.rows.map((row) => this.rowToState(row));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    let query = `SELECT COUNT(*) FROM ${this.fullTableName} WHERE saga_name = $1`;\n    const params: unknown[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = $${params.length + 1}`;\n      params.push(options.completed);\n    }\n\n    const result = await this.pool.query<{ count: string }>(query, params);\n    return parseInt(result.rows[0]?.count ?? \"0\", 10);\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    const result = await this.pool.query(\n      `DELETE FROM ${this.fullTableName}\n       WHERE saga_name = $1 AND is_completed = true AND updated_at < $2`,\n      [sagaName, before]\n    );\n\n    return result.rowCount ?? 0;\n  }\n}\n","import type { Pool } from \"pg\";\n\n/**\n * Get the schema SQL content.\n */\nexport function getSchemaSql(): string {\n  return `\n-- Saga instances table\nCREATE TABLE IF NOT EXISTS saga_instances (\n  id             VARCHAR(128) NOT NULL,\n  saga_name      VARCHAR(128) NOT NULL,\n  correlation_id VARCHAR(256) NOT NULL,\n  version        INTEGER NOT NULL,\n  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,\n  state          JSONB NOT NULL,\n  created_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n  updated_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n  PRIMARY KEY (saga_name, id)\n);\n\n-- Index for looking up sagas by name\nCREATE INDEX IF NOT EXISTS idx_saga_instances_saga_name\n  ON saga_instances (saga_name);\n\n-- Index for correlation ID lookups (saga_name + correlation_id)\nCREATE UNIQUE INDEX IF NOT EXISTS idx_saga_instances_correlation\n  ON saga_instances (saga_name, correlation_id);\n\n-- Index for finding incomplete sagas\nCREATE INDEX IF NOT EXISTS idx_saga_instances_incomplete\n  ON saga_instances (saga_name, is_completed)\n  WHERE is_completed = FALSE;\n\n-- Index for cleanup queries (completed + updated_at)\nCREATE INDEX IF NOT EXISTS idx_saga_instances_cleanup\n  ON saga_instances (saga_name, is_completed, updated_at)\n  WHERE is_completed = TRUE;\n`.trim();\n}\n\n/**\n * Create the saga_instances table and indexes.\n */\nexport async function createSchema(\n  pool: Pool,\n  options?: { schema?: string; tableName?: string }\n): Promise<void> {\n  const schema = options?.schema ?? \"public\";\n  const tableName = options?.tableName ?? \"saga_instances\";\n\n  // Set search path to the schema\n  await pool.query(`SET search_path TO ${schema}`);\n\n  // Create table with custom name if specified\n  let sql = getSchemaSql();\n  if (tableName !== \"saga_instances\") {\n    sql = sql.replace(/saga_instances/g, tableName);\n  }\n\n  await pool.query(sql);\n}\n\n/**\n * Drop the saga_instances table.\n */\nexport async function dropSchema(\n  pool: Pool,\n  options?: { schema?: string; tableName?: string }\n): Promise<void> {\n  const schema = options?.schema ?? \"public\";\n  const tableName = options?.tableName ?? \"saga_instances\";\n\n  await pool.query(`DROP TABLE IF EXISTS ${schema}.${tableName} CASCADE`);\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAErB,SAAS,wBAAwB;AAkB1B,IAAM,oBAAN,MAEP;AAAA,EACmB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAmC;AAC7C,QAAI,QAAQ,gBAAgB,MAAM;AAChC,WAAK,OAAO,QAAQ;AACpB,WAAK,WAAW;AAAA,IAClB,OAAO;AACL,WAAK,OAAO,IAAI,KAAK,QAAQ,IAAI;AACjC,WAAK,WAAW;AAAA,IAClB;AAEA,SAAK,YAAY,QAAQ,aAAa;AACtC,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAY,gBAAwB;AAClC,WAAO,GAAG,KAAK,MAAM,IAAI,KAAK,SAAS;AAAA,EACzC;AAAA,EAEA,MAAM,QAAQ,UAAkB,QAAwC;AACtE,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC7B,iBAAiB,KAAK,aAAa;AAAA,MACnC,CAAC,QAAQ,QAAQ;AAAA,IACnB;AAEA,QAAI,OAAO,KAAK,WAAW,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,WAAW,OAAO,KAAK,CAAC,CAAE;AAAA,EACxC;AAAA,EAEA,MAAM,mBACJ,UACA,eACwB;AACxB,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC7B,iBAAiB,KAAK,aAAa;AAAA,MACnC,CAAC,UAAU,aAAa;AAAA,IAC1B;AAEA,QAAI,OAAO,KAAK,WAAW,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,WAAW,OAAO,KAAK,CAAC,CAAE;AAAA,EACxC;AAAA,EAEA,MAAM,OAAO,UAAkB,eAAuB,OAA8B;AAClF,UAAM,EAAE,QAAQ,SAAS,aAAa,WAAW,UAAU,IAAI,MAAM;AAErE,UAAM,KAAK,KAAK;AAAA,MACd,eAAe,KAAK,aAAa;AAAA;AAAA;AAAA,MAGjC;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,sBACJ,UACA,eACA,OACe;AACf,UAAM,EAAE,QAAQ,SAAS,aAAa,WAAW,UAAU,IAAI,MAAM;AAErE,UAAM,KAAK,KAAK;AAAA,MACd,eAAe,KAAK,aAAa;AAAA;AAAA;AAAA,MAGjC;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,UACA,OACA,iBACe;AACf,UAAM,EAAE,QAAQ,SAAS,aAAa,UAAU,IAAI,MAAM;AAE1D,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC7B,UAAU,KAAK,aAAa;AAAA;AAAA;AAAA,MAG5B;AAAA,QACE;AAAA,QACA;AAAA,QACA,KAAK,UAAU,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,OAAO,aAAa,GAAG;AAEzB,YAAM,WAAW,MAAM,KAAK,QAAQ,UAAU,MAAM;AACpD,UAAI,UAAU;AACZ,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,SAAS,SAAS;AAAA,QACpB;AAAA,MACF,OAAO;AACL,cAAM,IAAI,MAAM,QAAQ,MAAM,YAAY;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,UAAkB,QAA+B;AAC5D,UAAM,KAAK,KAAK;AAAA,MACd,eAAe,KAAK,aAAa;AAAA,MACjC,CAAC,QAAQ,QAAQ;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,WAAW,KAA8B;AAC/C,UAAM,QAAQ,IAAI;AAGlB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU;AAAA,QACR,GAAG,MAAM;AAAA,QACT,QAAQ,IAAI;AAAA,QACZ,SAAS,IAAI;AAAA,QACb,aAAa,IAAI;AAAA,QACjB,WAAW,IAAI,KAAK,IAAI,UAAU;AAAA,QAClC,WAAW,IAAI,KAAK,IAAI,UAAU;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,QAAI,KAAK,UAAU;AACjB,YAAM,KAAK,KAAK,IAAI;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WACJ,UACA,SAKmB;AACnB,QAAI,QAAQ,iBAAiB,KAAK,aAAa;AAC/C,UAAM,SAAoB,CAAC,QAAQ;AAEnC,QAAI,SAAS,cAAc,QAAW;AACpC,eAAS,wBAAwB,OAAO,SAAS,CAAC;AAClD,aAAO,KAAK,QAAQ,SAAS;AAAA,IAC/B;AAEA,aAAS;AAET,QAAI,SAAS,OAAO;AAClB,eAAS,WAAW,OAAO,SAAS,CAAC;AACrC,aAAO,KAAK,QAAQ,KAAK;AAAA,IAC3B;AAEA,QAAI,SAAS,QAAQ;AACnB,eAAS,YAAY,OAAO,SAAS,CAAC;AACtC,aAAO,KAAK,QAAQ,MAAM;AAAA,IAC5B;AAEA,UAAM,SAAS,MAAM,KAAK,KAAK,MAAuB,OAAO,MAAM;AACnE,WAAO,OAAO,KAAK,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,CAAC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YACJ,UACA,SACiB;AACjB,QAAI,QAAQ,wBAAwB,KAAK,aAAa;AACtD,UAAM,SAAoB,CAAC,QAAQ;AAEnC,QAAI,SAAS,cAAc,QAAW;AACpC,eAAS,wBAAwB,OAAO,SAAS,CAAC;AAClD,aAAO,KAAK,QAAQ,SAAS;AAAA,IAC/B;AAEA,UAAM,SAAS,MAAM,KAAK,KAAK,MAAyB,OAAO,MAAM;AACrE,WAAO,SAAS,OAAO,KAAK,CAAC,GAAG,SAAS,KAAK,EAAE;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,sBACJ,UACA,QACiB;AACjB,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC7B,eAAe,KAAK,aAAa;AAAA;AAAA,MAEjC,CAAC,UAAU,MAAM;AAAA,IACnB;AAEA,WAAO,OAAO,YAAY;AAAA,EAC5B;AACF;;;AC9QO,SAAS,eAAuB;AACrC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+BP,KAAK;AACP;AAKA,eAAsB,aACpB,MACA,SACe;AACf,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,YAAY,SAAS,aAAa;AAGxC,QAAM,KAAK,MAAM,sBAAsB,MAAM,EAAE;AAG/C,MAAI,MAAM,aAAa;AACvB,MAAI,cAAc,kBAAkB;AAClC,UAAM,IAAI,QAAQ,mBAAmB,SAAS;AAAA,EAChD;AAEA,QAAM,KAAK,MAAM,GAAG;AACtB;AAKA,eAAsB,WACpB,MACA,SACe;AACf,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,YAAY,SAAS,aAAa;AAExC,QAAM,KAAK,MAAM,wBAAwB,MAAM,IAAI,SAAS,UAAU;AACxE;","names":[]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@saga-bus/store-postgres",
+  "version": "0.1.1",
+  "description": "PostgreSQL saga store for saga-bus using native pg driver",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/store-postgres"
+  },
+  "bugs": {
+    "url": "https://github.com/d-e-a-n-f/saga-bus/issues"
+  },
+  "homepage": "https://github.com/d-e-a-n-f/saga-bus#readme",
+  "keywords": [
+    "saga",
+    "message-bus",
+    "store",
+    "postgres",
+    "postgresql"
+  ],
+  "dependencies": {
+    "pg": "^8.11.0",
+    "@saga-bus/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@testcontainers/postgresql": "^10.0.0",
+    "@types/pg": "^8.11.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@saga-bus/core": ">=0.1.1",
+    "pg": ">=8.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}