awaitly-postgres 0.1.0

package/README.md

@@ -0,0 +1,139 @@
+# awaitly-postgres
+
+PostgreSQL persistence adapter for [awaitly](https://github.com/jagreehal/awaitly) workflows.
+
+## Installation
+
+```bash
+npm install awaitly-postgres pg
+# or
+pnpm add awaitly-postgres pg
+# or
+yarn add awaitly-postgres pg
+```
+
+## Quick Start
+
+```typescript
+import { createPostgresPersistence } from 'awaitly-postgres';
+import { durable } from 'awaitly/durable';
+
+const store = await createPostgresPersistence({
+  connectionString: process.env.DATABASE_URL,
+});
+
+const result = await durable.run(
+  { fetchUser, createOrder },
+  async (step, { fetchUser, createOrder }) => {
+    const user = await step(() => fetchUser('123'), { key: 'fetch-user' });
+    const order = await step(() => createOrder(user), { key: 'create-order' });
+    return order;
+  },
+  {
+    id: 'checkout-123',
+    store,
+  }
+);
+```
+
+## Configuration
+
+### Connection String
+
+```typescript
+const store = await createPostgresPersistence({
+  connectionString: 'postgresql://user:password@localhost:5432/dbname',
+});
+```
+
+### Individual Options
+
+```typescript
+const store = await createPostgresPersistence({
+  host: 'localhost',
+  port: 5432,
+  database: 'myapp',
+  user: 'postgres',
+  password: 'password',
+  tableName: 'custom_workflow_state', // optional, default: 'awaitly_workflow_state'
+  prefix: 'myapp:workflow:', // optional, default: 'workflow:state:'
+});
+```
+
+### Using Existing Pool
+
+```typescript
+import { Pool } from 'pg';
+import { createPostgresPersistence } from 'awaitly-postgres';
+
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+const store = await createPostgresPersistence({
+  existingPool: pool,
+});
+```
+
+### Pool Configuration
+
+```typescript
+const store = await createPostgresPersistence({
+  connectionString: process.env.DATABASE_URL,
+  pool: {
+    max: 20,
+    idleTimeoutMillis: 30000,
+    connectionTimeoutMillis: 2000,
+  },
+});
+```
+
+## Table Schema
+
+The adapter automatically creates a table with the following schema:
+
+```sql
+CREATE TABLE awaitly_workflow_state (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  expires_at TIMESTAMP
+);
+
+CREATE INDEX idx_awaitly_workflow_state_expires_at 
+ON awaitly_workflow_state(expires_at) 
+WHERE expires_at IS NOT NULL;
+```
+
+The table is created automatically on first use. You can customize the table name via the `tableName` option.
+
+## Advanced Usage
+
+### Direct KeyValueStore Access
+
+If you need more control, you can use the `PostgresKeyValueStore` class directly:
+
+```typescript
+import { PostgresKeyValueStore } from 'awaitly-postgres';
+import { createStatePersistence } from 'awaitly/persistence';
+
+const store = new PostgresKeyValueStore({
+  connectionString: process.env.DATABASE_URL,
+});
+
+const persistence = createStatePersistence(store, 'custom:prefix:');
+```
+
+## Features
+
+- ✅ Automatic table creation
+- ✅ TTL support (automatic expiration)
+- ✅ Connection pooling
+- ✅ Pattern matching for key queries
+- ✅ Zero configuration required
+
+## Requirements
+
+- Node.js >= 22
+- PostgreSQL >= 12
+- `pg` package (peer dependency)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,35 @@
+"use strict";var n=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var g=(r,e)=>{for(var t in e)n(r,t,{get:e[t],enumerable:!0})},P=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of c(e))!y.call(r,s)&&s!==t&&n(r,s,{get:()=>e[s],enumerable:!(i=p(e,s))||i.enumerable});return r};var m=r=>P(n({},"__esModule",{value:!0}),r);var E={};g(E,{PostgresKeyValueStore:()=>a,createPostgresPersistence:()=>h});module.exports=m(E);var l=require("pg"),a=class{pool;tableName;initialized=!1;initPromise=null;constructor(e){e.existingPool?this.pool=e.existingPool:e.connectionString?this.pool=new l.Pool({connectionString:e.connectionString,...e.pool}):this.pool=new l.Pool({host:e.host??"localhost",port:e.port??5432,database:e.database,user:e.user,password:e.password,...e.pool}),this.tableName=e.tableName??"awaitly_workflow_state"}async ensureInitialized(){if(!this.initialized)return this.initPromise?this.initPromise:(this.initPromise=(async()=>{try{await this.createTable(),this.initialized=!0}catch(e){throw this.initPromise=null,e}})(),this.initPromise)}async createTable(){let e=`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        expires_at TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at 
+      ON ${this.tableName}(expires_at) 
+      WHERE expires_at IS NOT NULL;
+    `;await this.pool.query(e)}patternToLike(e){return e.replace(/%/g,"\\%").replace(/_/g,"\\_").replace(/\*/g,"%")}async get(e){await this.ensureInitialized();let t=`
+      SELECT value 
+      FROM ${this.tableName} 
+      WHERE key = $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+    `,i=await this.pool.query(t,[e]);return i.rows.length===0?null:i.rows[0].value}async set(e,t,i){await this.ensureInitialized();let s=i?.ttl?new Date(Date.now()+i.ttl*1e3):null,o=`
+      INSERT INTO ${this.tableName} (key, value, expires_at)
+      VALUES ($1, $2, $3)
+      ON CONFLICT (key) 
+      DO UPDATE SET 
+        value = EXCLUDED.value,
+        expires_at = EXCLUDED.expires_at
+    `;await this.pool.query(o,[e,t,s])}async delete(e){await this.ensureInitialized();let t=`DELETE FROM ${this.tableName} WHERE key = $1`;return((await this.pool.query(t,[e])).rowCount??0)>0}async exists(e){await this.ensureInitialized();let t=`
+      SELECT 1 
+      FROM ${this.tableName} 
+      WHERE key = $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+      LIMIT 1
+    `;return(await this.pool.query(t,[e])).rows.length>0}async keys(e){await this.ensureInitialized();let t=this.patternToLike(e),i=`
+      SELECT key 
+      FROM ${this.tableName} 
+      WHERE key LIKE $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+    `;return(await this.pool.query(i,[t])).rows.map(o=>o.key)}async close(){await this.pool.end()}};var u=require("awaitly/persistence");async function h(r={}){let{prefix:e,...t}=r,i=new a(t);return(0,u.createStatePersistence)(i,e)}0&&(module.exports={PostgresKeyValueStore,createPostgresPersistence});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/postgres-store.ts"],"sourcesContent":["/**\n * awaitly-postgres\n *\n * PostgreSQL persistence adapter for awaitly workflows.\n * Provides ready-to-use StatePersistence backed by PostgreSQL.\n */\n\nimport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions } from \"./postgres-store\";\nimport { createStatePersistence, type StatePersistence } from \"awaitly/persistence\";\n\n/**\n * Options for creating PostgreSQL persistence.\n */\nexport interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {\n  /**\n   * Key prefix for state entries.\n   * @default 'workflow:state:'\n   */\n  prefix?: string;\n}\n\n/**\n * Create a StatePersistence instance backed by PostgreSQL.\n *\n * The table is automatically created on first use.\n *\n * @param options - PostgreSQL connection and configuration options\n * @returns StatePersistence instance ready to use with durable.run()\n *\n * @example\n * ```typescript\n * import { createPostgresPersistence } from 'awaitly-postgres';\n * import { durable } from 'awaitly/durable';\n *\n * const store = await createPostgresPersistence({\n *   connectionString: process.env.DATABASE_URL,\n * });\n *\n * const result = await durable.run(\n *   { fetchUser, createOrder },\n *   async (step, { fetchUser, createOrder }) => {\n *     const user = await step(() => fetchUser('123'), { key: 'fetch-user' });\n *     const order = await step(() => createOrder(user), { key: 'create-order' });\n *     return order;\n *   },\n *   {\n *     id: 'checkout-123',\n *     store,\n *   }\n * );\n * ```\n *\n * @example\n * ```typescript\n * // Using individual connection options\n * const store = await createPostgresPersistence({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'myapp',\n *   user: 'postgres',\n *   password: 'password',\n *   tableName: 'custom_workflow_state',\n * });\n * ```\n */\nexport async function createPostgresPersistence(\n  options: PostgresPersistenceOptions = {}\n): Promise<StatePersistence & { loadRaw(runId: string): Promise<import(\"awaitly/persistence\").SerializedState | undefined> }> {\n  const { prefix, ...storeOptions } = options;\n\n  const store = new PostgresKeyValueStore(storeOptions);\n  return createStatePersistence(store, prefix);\n}\n\n/**\n * PostgreSQL KeyValueStore implementation.\n * Use this directly if you need more control over the store.\n *\n * @example\n * ```typescript\n * import { PostgresKeyValueStore } from 'awaitly-postgres';\n * import { createStatePersistence } from 'awaitly/persistence';\n *\n * const store = new PostgresKeyValueStore({\n *   connectionString: process.env.DATABASE_URL,\n * });\n *\n * const persistence = createStatePersistence(store, 'custom:prefix:');\n * ```\n */\nexport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions };\n","/**\n * awaitly-postgres\n *\n * PostgreSQL KeyValueStore implementation for awaitly persistence.\n */\n\nimport type { Pool, PoolConfig, QueryResult } from \"pg\";\nimport { Pool as PgPool } from \"pg\";\nimport type { KeyValueStore } from \"awaitly/persistence\";\n\n/**\n * Options for PostgreSQL KeyValueStore.\n */\nexport interface PostgresKeyValueStoreOptions {\n  /**\n   * PostgreSQL connection string.\n   * If provided, other connection options are ignored.\n   *\n   * @example 'postgresql://user:password@localhost:5432/dbname'\n   */\n  connectionString?: string;\n\n  /**\n   * Database host.\n   * @default 'localhost'\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 5432\n   */\n  port?: number;\n\n  /**\n   * Database name.\n   */\n  database?: string;\n\n  /**\n   * Database user.\n   */\n  user?: string;\n\n  /**\n   * Database password.\n   */\n  password?: string;\n\n  /**\n   * Table name for storing key-value pairs.\n   * @default 'awaitly_workflow_state'\n   */\n  tableName?: string;\n\n  /**\n   * Additional pool configuration options.\n   * Ignored if `existingPool` is provided.\n   */\n  pool?: PoolConfig;\n\n  /**\n   * Existing PostgreSQL pool to use.\n   * If provided, connection options are ignored.\n   */\n  existingPool?: Pool;\n}\n\n/**\n * PostgreSQL implementation of KeyValueStore.\n *\n * Automatically creates the required table on first use.\n * Supports TTL via expires_at column.\n */\nexport class PostgresKeyValueStore implements KeyValueStore {\n  private pool: Pool;\n  private tableName: string;\n  private initialized: boolean = false;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: PostgresKeyValueStoreOptions) {\n    if (options.existingPool) {\n      // Use provided pool\n      this.pool = options.existingPool;\n    } else if (options.connectionString) {\n      // Create pool from connection string\n      this.pool = new PgPool({\n        connectionString: options.connectionString,\n        ...options.pool,\n      });\n    } else {\n      // Create pool from individual options\n      this.pool = new PgPool({\n        host: options.host ?? \"localhost\",\n        port: options.port ?? 5432,\n        database: options.database,\n        user: options.user,\n        password: options.password,\n        ...options.pool,\n      });\n    }\n\n    this.tableName = options.tableName ?? \"awaitly_workflow_state\";\n  }\n\n  /**\n   * Initialize the store by creating the table if it doesn't exist.\n   * This is called automatically on first use.\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = (async () => {\n      try {\n        await this.createTable();\n        this.initialized = true;\n      } catch (error) {\n        this.initPromise = null;\n        throw error;\n      }\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Create the table if it doesn't exist.\n   */\n  private async createTable(): Promise<void> {\n    const query = `\n      CREATE TABLE IF NOT EXISTS ${this.tableName} (\n        key TEXT PRIMARY KEY,\n        value TEXT NOT NULL,\n        expires_at TIMESTAMP\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at \n      ON ${this.tableName}(expires_at) \n      WHERE expires_at IS NOT NULL;\n    `;\n\n    await this.pool.query(query);\n  }\n\n  /**\n   * Convert glob pattern to SQL LIKE pattern.\n   * Supports * wildcard (matches any characters).\n   */\n  private patternToLike(pattern: string): string {\n    // Escape SQL LIKE special characters and convert * to %\n    return pattern.replace(/%/g, \"\\\\%\").replace(/_/g, \"\\\\_\").replace(/\\*/g, \"%\");\n  }\n\n  async get(key: string): Promise<string | null> {\n    await this.ensureInitialized();\n\n    const query = `\n      SELECT value \n      FROM ${this.tableName} \n      WHERE key = $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n    `;\n\n    const result: QueryResult<{ value: string }> = await this.pool.query(query, [key]);\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return result.rows[0].value;\n  }\n\n  async set(key: string, value: string, options?: { ttl?: number }): Promise<void> {\n    await this.ensureInitialized();\n\n    const expiresAt = options?.ttl\n      ? new Date(Date.now() + options.ttl * 1000)\n      : null;\n\n    const query = `\n      INSERT INTO ${this.tableName} (key, value, expires_at)\n      VALUES ($1, $2, $3)\n      ON CONFLICT (key) \n      DO UPDATE SET \n        value = EXCLUDED.value,\n        expires_at = EXCLUDED.expires_at\n    `;\n\n    await this.pool.query(query, [key, value, expiresAt]);\n  }\n\n  async delete(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const query = `DELETE FROM ${this.tableName} WHERE key = $1`;\n    const result = await this.pool.query(query, [key]);\n\n    return (result.rowCount ?? 0) > 0;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const query = `\n      SELECT 1 \n      FROM ${this.tableName} \n      WHERE key = $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n      LIMIT 1\n    `;\n\n    const result = await this.pool.query(query, [key]);\n    return result.rows.length > 0;\n  }\n\n  async keys(pattern: string): Promise<string[]> {\n    await this.ensureInitialized();\n\n    // Convert glob pattern to SQL LIKE\n    const likePattern = this.patternToLike(pattern);\n\n    const query = `\n      SELECT key \n      FROM ${this.tableName} \n      WHERE key LIKE $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n    `;\n\n    const result: QueryResult<{ key: string }> = await this.pool.query(query, [likePattern]);\n\n    return result.rows.map((row) => row.key);\n  }\n\n  /**\n   * Close the database connection pool.\n   * Call this when done with the store.\n   */\n  async close(): Promise<void> {\n    await this.pool.end();\n  }\n}\n"],"mappings":"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","names":["index_exports","__export","PostgresKeyValueStore","createPostgresPersistence","__toCommonJS","import_pg","PostgresKeyValueStore","options","PgPool","error","query","pattern","key","result","value","expiresAt","likePattern","row","import_persistence","createPostgresPersistence","options","prefix","storeOptions","store","PostgresKeyValueStore"]}

package/dist/index.d.cts

@@ -0,0 +1,158 @@
+import * as awaitly_persistence from 'awaitly/persistence';
+import { KeyValueStore, StatePersistence } from 'awaitly/persistence';
+import { PoolConfig, Pool } from 'pg';
+
+/**
+ * awaitly-postgres
+ *
+ * PostgreSQL KeyValueStore implementation for awaitly persistence.
+ */
+
+/**
+ * Options for PostgreSQL KeyValueStore.
+ */
+interface PostgresKeyValueStoreOptions {
+    /**
+     * PostgreSQL connection string.
+     * If provided, other connection options are ignored.
+     *
+     * @example 'postgresql://user:password@localhost:5432/dbname'
+     */
+    connectionString?: string;
+    /**
+     * Database host.
+     * @default 'localhost'
+     */
+    host?: string;
+    /**
+     * Database port.
+     * @default 5432
+     */
+    port?: number;
+    /**
+     * Database name.
+     */
+    database?: string;
+    /**
+     * Database user.
+     */
+    user?: string;
+    /**
+     * Database password.
+     */
+    password?: string;
+    /**
+     * Table name for storing key-value pairs.
+     * @default 'awaitly_workflow_state'
+     */
+    tableName?: string;
+    /**
+     * Additional pool configuration options.
+     * Ignored if `existingPool` is provided.
+     */
+    pool?: PoolConfig;
+    /**
+     * Existing PostgreSQL pool to use.
+     * If provided, connection options are ignored.
+     */
+    existingPool?: Pool;
+}
+/**
+ * PostgreSQL implementation of KeyValueStore.
+ *
+ * Automatically creates the required table on first use.
+ * Supports TTL via expires_at column.
+ */
+declare class PostgresKeyValueStore implements KeyValueStore {
+    private pool;
+    private tableName;
+    private initialized;
+    private initPromise;
+    constructor(options: PostgresKeyValueStoreOptions);
+    /**
+     * Initialize the store by creating the table if it doesn't exist.
+     * This is called automatically on first use.
+     */
+    private ensureInitialized;
+    /**
+     * Create the table if it doesn't exist.
+     */
+    private createTable;
+    /**
+     * Convert glob pattern to SQL LIKE pattern.
+     * Supports * wildcard (matches any characters).
+     */
+    private patternToLike;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Close the database connection pool.
+     * Call this when done with the store.
+     */
+    close(): Promise<void>;
+}
+
+/**
+ * Options for creating PostgreSQL persistence.
+ */
+interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {
+    /**
+     * Key prefix for state entries.
+     * @default 'workflow:state:'
+     */
+    prefix?: string;
+}
+/**
+ * Create a StatePersistence instance backed by PostgreSQL.
+ *
+ * The table is automatically created on first use.
+ *
+ * @param options - PostgreSQL connection and configuration options
+ * @returns StatePersistence instance ready to use with durable.run()
+ *
+ * @example
+ * ```typescript
+ * import { createPostgresPersistence } from 'awaitly-postgres';
+ * import { durable } from 'awaitly/durable';
+ *
+ * const store = await createPostgresPersistence({
+ *   connectionString: process.env.DATABASE_URL,
+ * });
+ *
+ * const result = await durable.run(
+ *   { fetchUser, createOrder },
+ *   async (step, { fetchUser, createOrder }) => {
+ *     const user = await step(() => fetchUser('123'), { key: 'fetch-user' });
+ *     const order = await step(() => createOrder(user), { key: 'create-order' });
+ *     return order;
+ *   },
+ *   {
+ *     id: 'checkout-123',
+ *     store,
+ *   }
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using individual connection options
+ * const store = await createPostgresPersistence({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password',
+ *   tableName: 'custom_workflow_state',
+ * });
+ * ```
+ */
+declare function createPostgresPersistence(options?: PostgresPersistenceOptions): Promise<StatePersistence & {
+    loadRaw(runId: string): Promise<awaitly_persistence.SerializedState | undefined>;
+}>;
+
+export { PostgresKeyValueStore, type PostgresKeyValueStoreOptions, type PostgresPersistenceOptions, createPostgresPersistence };

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+import * as awaitly_persistence from 'awaitly/persistence';
+import { KeyValueStore, StatePersistence } from 'awaitly/persistence';
+import { PoolConfig, Pool } from 'pg';
+
+/**
+ * awaitly-postgres
+ *
+ * PostgreSQL KeyValueStore implementation for awaitly persistence.
+ */
+
+/**
+ * Options for PostgreSQL KeyValueStore.
+ */
+interface PostgresKeyValueStoreOptions {
+    /**
+     * PostgreSQL connection string.
+     * If provided, other connection options are ignored.
+     *
+     * @example 'postgresql://user:password@localhost:5432/dbname'
+     */
+    connectionString?: string;
+    /**
+     * Database host.
+     * @default 'localhost'
+     */
+    host?: string;
+    /**
+     * Database port.
+     * @default 5432
+     */
+    port?: number;
+    /**
+     * Database name.
+     */
+    database?: string;
+    /**
+     * Database user.
+     */
+    user?: string;
+    /**
+     * Database password.
+     */
+    password?: string;
+    /**
+     * Table name for storing key-value pairs.
+     * @default 'awaitly_workflow_state'
+     */
+    tableName?: string;
+    /**
+     * Additional pool configuration options.
+     * Ignored if `existingPool` is provided.
+     */
+    pool?: PoolConfig;
+    /**
+     * Existing PostgreSQL pool to use.
+     * If provided, connection options are ignored.
+     */
+    existingPool?: Pool;
+}
+/**
+ * PostgreSQL implementation of KeyValueStore.
+ *
+ * Automatically creates the required table on first use.
+ * Supports TTL via expires_at column.
+ */
+declare class PostgresKeyValueStore implements KeyValueStore {
+    private pool;
+    private tableName;
+    private initialized;
+    private initPromise;
+    constructor(options: PostgresKeyValueStoreOptions);
+    /**
+     * Initialize the store by creating the table if it doesn't exist.
+     * This is called automatically on first use.
+     */
+    private ensureInitialized;
+    /**
+     * Create the table if it doesn't exist.
+     */
+    private createTable;
+    /**
+     * Convert glob pattern to SQL LIKE pattern.
+     * Supports * wildcard (matches any characters).
+     */
+    private patternToLike;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Close the database connection pool.
+     * Call this when done with the store.
+     */
+    close(): Promise<void>;
+}
+
+/**
+ * Options for creating PostgreSQL persistence.
+ */
+interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {
+    /**
+     * Key prefix for state entries.
+     * @default 'workflow:state:'
+     */
+    prefix?: string;
+}
+/**
+ * Create a StatePersistence instance backed by PostgreSQL.
+ *
+ * The table is automatically created on first use.
+ *
+ * @param options - PostgreSQL connection and configuration options
+ * @returns StatePersistence instance ready to use with durable.run()
+ *
+ * @example
+ * ```typescript
+ * import { createPostgresPersistence } from 'awaitly-postgres';
+ * import { durable } from 'awaitly/durable';
+ *
+ * const store = await createPostgresPersistence({
+ *   connectionString: process.env.DATABASE_URL,
+ * });
+ *
+ * const result = await durable.run(
+ *   { fetchUser, createOrder },
+ *   async (step, { fetchUser, createOrder }) => {
+ *     const user = await step(() => fetchUser('123'), { key: 'fetch-user' });
+ *     const order = await step(() => createOrder(user), { key: 'create-order' });
+ *     return order;
+ *   },
+ *   {
+ *     id: 'checkout-123',
+ *     store,
+ *   }
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using individual connection options
+ * const store = await createPostgresPersistence({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password',
+ *   tableName: 'custom_workflow_state',
+ * });
+ * ```
+ */
+declare function createPostgresPersistence(options?: PostgresPersistenceOptions): Promise<StatePersistence & {
+    loadRaw(runId: string): Promise<awaitly_persistence.SerializedState | undefined>;
+}>;
+
+export { PostgresKeyValueStore, type PostgresKeyValueStoreOptions, type PostgresPersistenceOptions, createPostgresPersistence };

package/dist/index.js

@@ -0,0 +1,35 @@
+import{Pool as n}from"pg";var r=class{pool;tableName;initialized=!1;initPromise=null;constructor(e){e.existingPool?this.pool=e.existingPool:e.connectionString?this.pool=new n({connectionString:e.connectionString,...e.pool}):this.pool=new n({host:e.host??"localhost",port:e.port??5432,database:e.database,user:e.user,password:e.password,...e.pool}),this.tableName=e.tableName??"awaitly_workflow_state"}async ensureInitialized(){if(!this.initialized)return this.initPromise?this.initPromise:(this.initPromise=(async()=>{try{await this.createTable(),this.initialized=!0}catch(e){throw this.initPromise=null,e}})(),this.initPromise)}async createTable(){let e=`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        expires_at TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at 
+      ON ${this.tableName}(expires_at) 
+      WHERE expires_at IS NOT NULL;
+    `;await this.pool.query(e)}patternToLike(e){return e.replace(/%/g,"\\%").replace(/_/g,"\\_").replace(/\*/g,"%")}async get(e){await this.ensureInitialized();let t=`
+      SELECT value 
+      FROM ${this.tableName} 
+      WHERE key = $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+    `,i=await this.pool.query(t,[e]);return i.rows.length===0?null:i.rows[0].value}async set(e,t,i){await this.ensureInitialized();let o=i?.ttl?new Date(Date.now()+i.ttl*1e3):null,s=`
+      INSERT INTO ${this.tableName} (key, value, expires_at)
+      VALUES ($1, $2, $3)
+      ON CONFLICT (key) 
+      DO UPDATE SET 
+        value = EXCLUDED.value,
+        expires_at = EXCLUDED.expires_at
+    `;await this.pool.query(s,[e,t,o])}async delete(e){await this.ensureInitialized();let t=`DELETE FROM ${this.tableName} WHERE key = $1`;return((await this.pool.query(t,[e])).rowCount??0)>0}async exists(e){await this.ensureInitialized();let t=`
+      SELECT 1 
+      FROM ${this.tableName} 
+      WHERE key = $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+      LIMIT 1
+    `;return(await this.pool.query(t,[e])).rows.length>0}async keys(e){await this.ensureInitialized();let t=this.patternToLike(e),i=`
+      SELECT key 
+      FROM ${this.tableName} 
+      WHERE key LIKE $1 
+        AND (expires_at IS NULL OR expires_at > NOW())
+    `;return(await this.pool.query(i,[t])).rows.map(s=>s.key)}async close(){await this.pool.end()}};import{createStatePersistence as l}from"awaitly/persistence";async function g(a={}){let{prefix:e,...t}=a,i=new r(t);return l(i,e)}export{r as PostgresKeyValueStore,g as createPostgresPersistence};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/postgres-store.ts","../src/index.ts"],"sourcesContent":["/**\n * awaitly-postgres\n *\n * PostgreSQL KeyValueStore implementation for awaitly persistence.\n */\n\nimport type { Pool, PoolConfig, QueryResult } from \"pg\";\nimport { Pool as PgPool } from \"pg\";\nimport type { KeyValueStore } from \"awaitly/persistence\";\n\n/**\n * Options for PostgreSQL KeyValueStore.\n */\nexport interface PostgresKeyValueStoreOptions {\n  /**\n   * PostgreSQL connection string.\n   * If provided, other connection options are ignored.\n   *\n   * @example 'postgresql://user:password@localhost:5432/dbname'\n   */\n  connectionString?: string;\n\n  /**\n   * Database host.\n   * @default 'localhost'\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 5432\n   */\n  port?: number;\n\n  /**\n   * Database name.\n   */\n  database?: string;\n\n  /**\n   * Database user.\n   */\n  user?: string;\n\n  /**\n   * Database password.\n   */\n  password?: string;\n\n  /**\n   * Table name for storing key-value pairs.\n   * @default 'awaitly_workflow_state'\n   */\n  tableName?: string;\n\n  /**\n   * Additional pool configuration options.\n   * Ignored if `existingPool` is provided.\n   */\n  pool?: PoolConfig;\n\n  /**\n   * Existing PostgreSQL pool to use.\n   * If provided, connection options are ignored.\n   */\n  existingPool?: Pool;\n}\n\n/**\n * PostgreSQL implementation of KeyValueStore.\n *\n * Automatically creates the required table on first use.\n * Supports TTL via expires_at column.\n */\nexport class PostgresKeyValueStore implements KeyValueStore {\n  private pool: Pool;\n  private tableName: string;\n  private initialized: boolean = false;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: PostgresKeyValueStoreOptions) {\n    if (options.existingPool) {\n      // Use provided pool\n      this.pool = options.existingPool;\n    } else if (options.connectionString) {\n      // Create pool from connection string\n      this.pool = new PgPool({\n        connectionString: options.connectionString,\n        ...options.pool,\n      });\n    } else {\n      // Create pool from individual options\n      this.pool = new PgPool({\n        host: options.host ?? \"localhost\",\n        port: options.port ?? 5432,\n        database: options.database,\n        user: options.user,\n        password: options.password,\n        ...options.pool,\n      });\n    }\n\n    this.tableName = options.tableName ?? \"awaitly_workflow_state\";\n  }\n\n  /**\n   * Initialize the store by creating the table if it doesn't exist.\n   * This is called automatically on first use.\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = (async () => {\n      try {\n        await this.createTable();\n        this.initialized = true;\n      } catch (error) {\n        this.initPromise = null;\n        throw error;\n      }\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Create the table if it doesn't exist.\n   */\n  private async createTable(): Promise<void> {\n    const query = `\n      CREATE TABLE IF NOT EXISTS ${this.tableName} (\n        key TEXT PRIMARY KEY,\n        value TEXT NOT NULL,\n        expires_at TIMESTAMP\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires_at \n      ON ${this.tableName}(expires_at) \n      WHERE expires_at IS NOT NULL;\n    `;\n\n    await this.pool.query(query);\n  }\n\n  /**\n   * Convert glob pattern to SQL LIKE pattern.\n   * Supports * wildcard (matches any characters).\n   */\n  private patternToLike(pattern: string): string {\n    // Escape SQL LIKE special characters and convert * to %\n    return pattern.replace(/%/g, \"\\\\%\").replace(/_/g, \"\\\\_\").replace(/\\*/g, \"%\");\n  }\n\n  async get(key: string): Promise<string | null> {\n    await this.ensureInitialized();\n\n    const query = `\n      SELECT value \n      FROM ${this.tableName} \n      WHERE key = $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n    `;\n\n    const result: QueryResult<{ value: string }> = await this.pool.query(query, [key]);\n\n    if (result.rows.length === 0) {\n      return null;\n    }\n\n    return result.rows[0].value;\n  }\n\n  async set(key: string, value: string, options?: { ttl?: number }): Promise<void> {\n    await this.ensureInitialized();\n\n    const expiresAt = options?.ttl\n      ? new Date(Date.now() + options.ttl * 1000)\n      : null;\n\n    const query = `\n      INSERT INTO ${this.tableName} (key, value, expires_at)\n      VALUES ($1, $2, $3)\n      ON CONFLICT (key) \n      DO UPDATE SET \n        value = EXCLUDED.value,\n        expires_at = EXCLUDED.expires_at\n    `;\n\n    await this.pool.query(query, [key, value, expiresAt]);\n  }\n\n  async delete(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const query = `DELETE FROM ${this.tableName} WHERE key = $1`;\n    const result = await this.pool.query(query, [key]);\n\n    return (result.rowCount ?? 0) > 0;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    await this.ensureInitialized();\n\n    const query = `\n      SELECT 1 \n      FROM ${this.tableName} \n      WHERE key = $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n      LIMIT 1\n    `;\n\n    const result = await this.pool.query(query, [key]);\n    return result.rows.length > 0;\n  }\n\n  async keys(pattern: string): Promise<string[]> {\n    await this.ensureInitialized();\n\n    // Convert glob pattern to SQL LIKE\n    const likePattern = this.patternToLike(pattern);\n\n    const query = `\n      SELECT key \n      FROM ${this.tableName} \n      WHERE key LIKE $1 \n        AND (expires_at IS NULL OR expires_at > NOW())\n    `;\n\n    const result: QueryResult<{ key: string }> = await this.pool.query(query, [likePattern]);\n\n    return result.rows.map((row) => row.key);\n  }\n\n  /**\n   * Close the database connection pool.\n   * Call this when done with the store.\n   */\n  async close(): Promise<void> {\n    await this.pool.end();\n  }\n}\n","/**\n * awaitly-postgres\n *\n * PostgreSQL persistence adapter for awaitly workflows.\n * Provides ready-to-use StatePersistence backed by PostgreSQL.\n */\n\nimport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions } from \"./postgres-store\";\nimport { createStatePersistence, type StatePersistence } from \"awaitly/persistence\";\n\n/**\n * Options for creating PostgreSQL persistence.\n */\nexport interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {\n  /**\n   * Key prefix for state entries.\n   * @default 'workflow:state:'\n   */\n  prefix?: string;\n}\n\n/**\n * Create a StatePersistence instance backed by PostgreSQL.\n *\n * The table is automatically created on first use.\n *\n * @param options - PostgreSQL connection and configuration options\n * @returns StatePersistence instance ready to use with durable.run()\n *\n * @example\n * ```typescript\n * import { createPostgresPersistence } from 'awaitly-postgres';\n * import { durable } from 'awaitly/durable';\n *\n * const store = await createPostgresPersistence({\n *   connectionString: process.env.DATABASE_URL,\n * });\n *\n * const result = await durable.run(\n *   { fetchUser, createOrder },\n *   async (step, { fetchUser, createOrder }) => {\n *     const user = await step(() => fetchUser('123'), { key: 'fetch-user' });\n *     const order = await step(() => createOrder(user), { key: 'create-order' });\n *     return order;\n *   },\n *   {\n *     id: 'checkout-123',\n *     store,\n *   }\n * );\n * ```\n *\n * @example\n * ```typescript\n * // Using individual connection options\n * const store = await createPostgresPersistence({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'myapp',\n *   user: 'postgres',\n *   password: 'password',\n *   tableName: 'custom_workflow_state',\n * });\n * ```\n */\nexport async function createPostgresPersistence(\n  options: PostgresPersistenceOptions = {}\n): Promise<StatePersistence & { loadRaw(runId: string): Promise<import(\"awaitly/persistence\").SerializedState | undefined> }> {\n  const { prefix, ...storeOptions } = options;\n\n  const store = new PostgresKeyValueStore(storeOptions);\n  return createStatePersistence(store, prefix);\n}\n\n/**\n * PostgreSQL KeyValueStore implementation.\n * Use this directly if you need more control over the store.\n *\n * @example\n * ```typescript\n * import { PostgresKeyValueStore } from 'awaitly-postgres';\n * import { createStatePersistence } from 'awaitly/persistence';\n *\n * const store = new PostgresKeyValueStore({\n *   connectionString: process.env.DATABASE_URL,\n * });\n *\n * const persistence = createStatePersistence(store, 'custom:prefix:');\n * ```\n */\nexport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions };\n"],"mappings":"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","names":["PgPool","PostgresKeyValueStore","options","error","query","pattern","key","result","value","expiresAt","likePattern","row","createStatePersistence","createPostgresPersistence","options","prefix","storeOptions","store","PostgresKeyValueStore"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "awaitly-postgres",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "PostgreSQL persistence adapter for awaitly workflows",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint .",
+    "clean": "rm -rf dist",
+    "quality": "pnpm type-check && pnpm test && pnpm lint"
+  },
+  "keywords": [
+    "awaitly",
+    "workflow",
+    "persistence",
+    "postgres",
+    "postgresql",
+    "database",
+    "durable-execution"
+  ],
+  "author": "Jag Reehal <jag@jagreehal.com>",
+  "homepage": "https://github.com/jagreehal/awaitly#readme",
+  "bugs": {
+    "url": "https://github.com/jagreehal/awaitly/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jagreehal/awaitly.git"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "awaitly": "workspace:^"
+  },
+  "dependencies": {
+    "pg": "^8.13.1"
+  },
+  "devDependencies": {
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@total-typescript/tsconfig": "^1.0.4",
+    "@types/node": "^25.0.10",
+    "@types/pg": "^8.11.10",
+    "awaitly": "workspace:^",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}