npm - awaitly-postgres - Versions diffs - 3.0.0 → 4.0.0 - Mend

awaitly-postgres 3.0.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -103,23 +103,6 @@ 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

package/dist/index.cjs CHANGED Viewed

@@ -1,59 +1,11 @@
-"use strict";var N=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var I=(o,e)=>{for(var t in e)N(o,t,{get:e[t],enumerable:!0})},b=(o,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of _(e))!x.call(o,i)&&i!==t&&N(o,i,{get:()=>e[i],enumerable:!(s=O(e,i))||s.enumerable});return o};var R=o=>b(N({},"__esModule",{value:!0}),o);var A={};I(A,{PostgresKeyValueStore:()=>P,createPostgresPersistence:()=>$});module.exports=R(A);var f=require("pg");var h=require("pg"),P=class{pool;tableName;initialized=!1;initPromise=null;constructor(e){e.existingPool?this.pool=e.existingPool:e.connectionString?this.pool=new h.Pool({connectionString:e.connectionString,...e.pool}):this.pool=new h.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(){await this.pool.query(`
-      CREATE TABLE IF NOT EXISTS ${this.tableName} (
-        key TEXT PRIMARY KEY,
-        value TEXT NOT NULL,
-        expires_at TIMESTAMP,
-        updated_at TIMESTAMPTZ
-      )
-    `),await this.pool.query(`
-      ALTER TABLE ${this.tableName}
-      ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ
-    `),await this.pool.query(`
-      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(`
-      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_updated_at
-      ON ${this.tableName}(updated_at)
-      WHERE updated_at IS NOT NULL
-    `)}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())
-    `,s=await this.pool.query(t,[e]);return s.rows.length===0?null:s.rows[0].value}async set(e,t,s){await this.ensureInitialized();let i=s?.ttl?new Date(Date.now()+s.ttl*1e3):null,n=`
-      INSERT INTO ${this.tableName} (key, value, expires_at, updated_at)
-      VALUES ($1, $2, $3, NOW())
-      ON CONFLICT (key)
-      DO UPDATE SET
-        value = EXCLUDED.value,
-        expires_at = EXCLUDED.expires_at,
-        updated_at = NOW()
-    `;await this.pool.query(n,[e,t,i])}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),s=`
-      SELECT key
-      FROM ${this.tableName}
-      WHERE key LIKE $1
-        AND (expires_at IS NULL OR expires_at > NOW())
-    `;return(await this.pool.query(s,[t])).rows.map(n=>n.key)}async listKeys(e,t={}){await this.ensureInitialized();let s=Math.min(Math.max(0,t.limit??100),1e4),i=Math.max(0,t.offset??0),n=t.orderBy==="key"?"key":"updated_at",g=t.orderDir==="asc"?"ASC":"DESC",p=this.patternToLike(e),u=["key LIKE $1","(expires_at IS NULL OR expires_at > NOW())"],d=[p],r=2;t.updatedBefore!=null&&(u.push(`updated_at < $${r}`),d.push(t.updatedBefore),r++),t.updatedAfter!=null&&(u.push(`updated_at > $${r}`),d.push(t.updatedAfter),r++);let l=u.join(" AND "),a=n==="updated_at"?" NULLS LAST":"",c=`
-      SELECT key
-      FROM ${this.tableName}
-      WHERE ${l}
-      ORDER BY ${n} ${g}${a}
-      LIMIT $${r} OFFSET $${r+1}
-    `,E=[...d,s,i],w=(await this.pool.query(c,E)).rows.map(T=>T.key),y;if(t.includeTotal===!0||i>0){let T=await this.pool.query(`SELECT COUNT(*) AS count FROM ${this.tableName} WHERE ${l}`,d);y=parseInt(T.rows[0]?.count??"0",10)}return{keys:w,total:y}}async deleteMany(e){return e.length===0?0:(await this.ensureInitialized(),(await this.pool.query(`DELETE FROM ${this.tableName} WHERE key = ANY($1::text[])`,[e])).rowCount??0)}async clear(){await this.ensureInitialized(),await this.pool.query(`TRUNCATE TABLE ${this.tableName}`)}async close(){await this.pool.end()}};var k=require("crypto");function L(o,e={}){let t=e.lockTableName??"awaitly_workflow_lock",s=`idx_${t.replace(/[^a-zA-Z0-9_]/g,"_")}_expires_at`;async function i(){await o.query(`
+"use strict";var d=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var y=(o,e)=>{for(var t in e)d(o,t,{get:e[t],enumerable:!0})},P=(o,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of _(e))!S.call(o,s)&&s!==t&&d(o,s,{get:()=>e[s],enumerable:!(r=g(e,s))||r.enumerable});return o};var N=o=>P(d({},"__esModule",{value:!0}),o);var I={};y(I,{postgres:()=>O});module.exports=N(I);var m=require("pg");var f=require("crypto");function k(o,e={}){let t=e.lockTableName??"awaitly_workflow_lock",r=`idx_${t.replace(/[^a-zA-Z0-9_]/g,"_")}_expires_at`;async function s(){await o.query(`
       CREATE TABLE IF NOT EXISTS ${t} (
         workflow_id TEXT PRIMARY KEY,
         owner_token TEXT NOT NULL,
         expires_at TIMESTAMPTZ NOT NULL
       );
-      CREATE INDEX IF NOT EXISTS ${s} ON ${t}(expires_at);
-    `)}async function n(p,u){let d=u?.ttlMs??6e4,r=(0,k.randomUUID)(),l=new Date(Date.now()+d);await i();let a=await o.query(`
+      CREATE INDEX IF NOT EXISTS ${r} ON ${t}(expires_at);
+    `)}async function w(u,l){let c=l?.ttlMs??6e4,p=(0,f.randomUUID)(),n=new Date(Date.now()+c);await s();let i=await o.query(`
       INSERT INTO ${t} (workflow_id, owner_token, expires_at)
       VALUES ($1, $2, $3)
       ON CONFLICT (workflow_id) DO UPDATE SET
@@ -61,5 +13,18 @@
         expires_at = EXCLUDED.expires_at
       WHERE ${t}.expires_at < NOW()
       RETURNING owner_token
-    `,[p,r,l]);return a.rowCount===1&&a.rows[0].owner_token===r?{ownerToken:r}:null}async function g(p,u){await o.query(`DELETE FROM ${t} WHERE workflow_id = $1 AND owner_token = $2`,[p,u])}return{tryAcquire:n,release:g,ensureLockTable:i}}var S=require("awaitly/persistence");async function $(o={}){let{prefix:e,lock:t,...s}=o,i=r=>r.slice((e??"workflow:state:").length),n=e??"workflow:state:",g=r=>`${n}${r}`,p=(r,l)=>Object.assign(r,{async listPage(a={}){let{keys:c,total:E}=await l.listKeys(`${n}*`,a),m=c.map(i),w=Math.min(Math.max(0,a.limit??100),1e4),y=m.length===w?(a.offset??0)+m.length:void 0;return{ids:m,total:E,nextOffset:y}},async deleteMany(a){if(a.length===0)return 0;let c=a.map(g);return l.deleteMany(c)},async clear(){return l.clear()}});if(t!==void 0){let r=s.existingPool??new f.Pool(s.connectionString?{connectionString:s.connectionString,...s.pool}:{host:s.host??"localhost",port:s.port??5432,database:s.database,user:s.user,password:s.password,...s.pool}),l=new P({...s,existingPool:r}),a=(0,S.createStatePersistence)(l,e),c=L(r,{lockTableName:t.lockTableName});return Object.assign(p(a,l),{tryAcquire:c.tryAcquire.bind(c),release:c.release.bind(c)})}let u=new P(s),d=(0,S.createStatePersistence)(u,e);return p(d,u)}0&&(module.exports={PostgresKeyValueStore,createPostgresPersistence});
+    `,[u,p,n]);return i.rowCount===1&&i.rows[0].owner_token===p?{ownerToken:p}:null}async function a(u,l){await o.query(`DELETE FROM ${t} WHERE workflow_id = $1 AND owner_token = $2`,[u,l])}return{tryAcquire:w,release:a,ensureLockTable:s}}var L=/^[a-zA-Z_][a-zA-Z0-9_]*$/;function O(o){let e=typeof o=="string"?{url:o}:o,t=e.table??"awaitly_snapshots";if(!L.test(t))throw new Error(`Invalid table name: ${t}. Must be alphanumeric with underscores.`);let r=e.prefix??"",s=e.autoCreateTable??!0,w=!e.pool,a=e.pool??new m.Pool({connectionString:e.url}),u=!1,l=async()=>{!s||u||(await a.query(`
+      CREATE TABLE IF NOT EXISTS ${t} (
+        id TEXT PRIMARY KEY,
+        snapshot JSONB NOT NULL,
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+      )
+    `),await a.query(`
+      CREATE INDEX IF NOT EXISTS ${t}_updated_at_idx ON ${t} (updated_at DESC)
+    `),u=!0)},c=e.lock?k(a,e.lock):null,p={async save(n,i){await l();let E=r+n;await a.query(`INSERT INTO ${t} (id, snapshot, updated_at)
+         VALUES ($1, $2, NOW())
+         ON CONFLICT (id) DO UPDATE SET snapshot = $2, updated_at = NOW()`,[E,JSON.stringify(i)])},async load(n){await l();let i=r+n,E=await a.query(`SELECT snapshot FROM ${t} WHERE id = $1`,[i]);return E.rows.length===0?null:E.rows[0].snapshot},async delete(n){await l();let i=r+n;await a.query(`DELETE FROM ${t} WHERE id = $1`,[i])},async list(n){await l();let i=r+(n?.prefix??""),E=n?.limit??100;return(await a.query(`SELECT id, updated_at FROM ${t}
+         WHERE id LIKE $1
+         ORDER BY updated_at DESC
+         LIMIT $2`,[i+"%",E])).rows.map(T=>({id:T.id.slice(r.length),updatedAt:T.updated_at.toISOString()}))},async close(){w&&await a.end()}};return c&&(p.tryAcquire=c.tryAcquire.bind(c),p.release=c.release.bind(c)),p}0&&(module.exports={postgres});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/postgres-store.ts","../src/postgres-lock.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 { Pool as PgPool } from \"pg\";\nimport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions } from \"./postgres-store\";\nimport { createPostgresLock } from \"./postgres-lock\";\nimport {\n createStatePersistence,\n type StatePersistence,\n type SerializedState,\n type ListPageOptions,\n type ListPageResult,\n} from \"awaitly/persistence\";\nimport type { WorkflowLock } from \"awaitly/durable\";\n\n/\n Options for cross-process locking (lease + owner token).\n * When set, the returned store implements WorkflowLock so only one process\n * runs a given workflow ID at a time (when durable.run allowConcurrent is false).\n /\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\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 When set, the store implements WorkflowLock for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n lock?: PostgresLockOptions;\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 type PostgresStatePersistence = StatePersistence & {\n loadRaw(runId: string): Promise<SerializedState \| undefined>;\n listPage(options?: ListPageOptions): Promise<ListPageResult>;\n deleteMany(ids: string[]): Promise<number>;\n clear(): Promise<void>;\n};\n\nexport type PostgresStatePersistenceWithLock = PostgresStatePersistence & WorkflowLock;\n\nexport async function createPostgresPersistence(\n options: PostgresPersistenceOptions = {}\n): Promise<PostgresStatePersistence \| PostgresStatePersistenceWithLock> {\n const { prefix, lock: lockOptions, ...storeOptions } = options;\n\n const stripPrefix = (key: string): string =>\n key.slice((prefix ?? \"workflow:state:\").length);\n\n const effectivePrefix = prefix ?? \"workflow:state:\";\n const prefixKey = (runId: string): string => `${effectivePrefix}${runId}`;\n\n const addListPageAndDeleteMany = (\n statePersistence: StatePersistence & { loadRaw(runId: string): Promise<SerializedState \| undefined> },\n store: PostgresKeyValueStore\n ): PostgresStatePersistence => {\n return Object.assign(statePersistence, {\n async listPage(options: ListPageOptions = {}): Promise<ListPageResult> {\n const { keys, total } = await store.listKeys(`${effectivePrefix}`, options);\n const ids = keys.map(stripPrefix);\n const limit = Math.min(Math.max(0, options.limit ?? 100), 10_000);\n const nextOffset =\n ids.length === limit ? (options.offset ?? 0) + ids.length : undefined;\n return { ids, total, nextOffset };\n },\n async deleteMany(ids: string[]): Promise<number> {\n if (ids.length === 0) return 0;\n const keys = ids.map(prefixKey);\n return store.deleteMany(keys);\n },\n async clear(): Promise<void> {\n return store.clear();\n },\n });\n };\n\n if (lockOptions !== undefined) {\n const pool =\n storeOptions.existingPool ??\n new PgPool(\n storeOptions.connectionString\n ? { connectionString: storeOptions.connectionString, ...storeOptions.pool }\n : {\n host: storeOptions.host ?? \"localhost\",\n port: storeOptions.port ?? 5432,\n database: storeOptions.database,\n user: storeOptions.user,\n password: storeOptions.password,\n ...storeOptions.pool,\n }\n );\n const store = new PostgresKeyValueStore({ ...storeOptions, existingPool: pool });\n const statePersistence = createStatePersistence(store, prefix) as PostgresStatePersistence;\n const lock = createPostgresLock(pool, {\n lockTableName: lockOptions.lockTableName,\n });\n return Object.assign(addListPageAndDeleteMany(statePersistence, store), {\n tryAcquire: lock.tryAcquire.bind(lock),\n release: lock.release.bind(lock),\n });\n }\n\n const store = new PostgresKeyValueStore(storeOptions);\n const base = createStatePersistence(store, prefix);\n return addListPageAndDeleteMany(base as StatePersistence & { loadRaw(runId: string): Promise<SerializedState \| undefined> }, store);\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, ListPageOptions } 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 * Adds updated_at column to existing tables for listKeys ordering.\n /\n private async createTable(): Promise<void> {\n await this.pool.query(`\n CREATE TABLE IF NOT EXISTS ${this.tableName} (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL,\n expires_at TIMESTAMP,\n updated_at TIMESTAMPTZ\n )\n `);\n\n // Add updated_at to existing tables that don't have it (before creating index)\n await this.pool.query(`\n ALTER TABLE ${this.tableName} \n ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ\n `);\n\n await this.pool.query(`\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(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_updated_at \n ON ${this.tableName}(updated_at) \n WHERE updated_at IS NOT NULL\n `);\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, updated_at)\n VALUES ($1, $2, $3, NOW())\n ON CONFLICT (key) \n DO UPDATE SET \n value = EXCLUDED.value,\n expires_at = EXCLUDED.expires_at,\n updated_at = NOW()\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 List keys with pagination, filtering, and ordering.\n /\n async listKeys(\n pattern: string,\n options: ListPageOptions = {}\n ): Promise<{ keys: string[]; total?: number }> {\n await this.ensureInitialized();\n\n const limit = Math.min(Math.max(0, options.limit ?? 100), 10_000);\n const offset = Math.max(0, options.offset ?? 0);\n const orderBy = options.orderBy === \"key\" ? \"key\" : \"updated_at\";\n const orderDir = options.orderDir === \"asc\" ? \"ASC\" : \"DESC\";\n const likePattern = this.patternToLike(pattern);\n\n const conditions: string[] = [\n \"key LIKE $1\",\n \"(expires_at IS NULL OR expires_at > NOW())\",\n ];\n const args: unknown[] = [likePattern];\n let paramIndex = 2;\n\n if (options.updatedBefore != null) {\n conditions.push(`updated_at < $${paramIndex}`);\n args.push(options.updatedBefore);\n paramIndex++;\n }\n if (options.updatedAfter != null) {\n conditions.push(`updated_at > $${paramIndex}`);\n args.push(options.updatedAfter);\n paramIndex++;\n }\n\n const whereClause = conditions.join(\" AND \");\n const orderNulls = orderBy === \"updated_at\" ? \" NULLS LAST\" : \"\";\n\n const listQuery = `\n SELECT key \n FROM ${this.tableName} \n WHERE ${whereClause}\n ORDER BY ${orderBy} ${orderDir}${orderNulls}\n LIMIT $${paramIndex} OFFSET $${paramIndex + 1}\n `;\n const listArgs = [...args, limit, offset];\n\n const result: QueryResult<{ key: string }> = await this.pool.query(listQuery, listArgs);\n const keys = result.rows.map((row) => row.key);\n\n let total: number \| undefined;\n if (options.includeTotal === true \|\| offset > 0) {\n const countResult: QueryResult<{ count: string }> = await this.pool.query(\n `SELECT COUNT() AS count FROM ${this.tableName} WHERE ${whereClause}`,\n args\n );\n total = parseInt(countResult.rows[0]?.count ?? \"0\", 10);\n }\n\n return { keys, total };\n }\n\n /*\n Delete multiple keys in one round-trip.\n /\n async deleteMany(keys: string[]): Promise<number> {\n if (keys.length === 0) return 0;\n await this.ensureInitialized();\n const result = await this.pool.query(\n `DELETE FROM ${this.tableName} WHERE key = ANY($1::text[])`,\n [keys]\n );\n return result.rowCount ?? 0;\n }\n\n /\n Remove all entries from the table (clear all workflow state).\n /\n async clear(): Promise<void> {\n await this.ensureInitialized();\n await this.pool.query(`TRUNCATE TABLE ${this.tableName}`);\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 PostgreSQL workflow lock (lease) for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n\nimport type { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\n\n/\n Create tryAcquire and release functions that use a PostgreSQL lock table.\n * Caller must pass the same pool used for state (so one connection pool).\n */\nexport function createPostgresLock(\n pool: Pool,\n options: PostgresLockOptions = {}\n): {\n tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null>;\n release(id: string, ownerToken: string): Promise<void>;\n ensureLockTable(): Promise<void>;\n} {\n const lockTableName = options.lockTableName ?? \"awaitly_workflow_lock\";\n\n const safeIndexName = `idx_${lockTableName.replace(/[^a-zA-Z0-9_]/g, \"_\")}_expires_at`;\n\n async function ensureLockTable(): Promise<void> {\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${lockTableName} (\n workflow_id TEXT PRIMARY KEY,\n owner_token TEXT NOT NULL,\n expires_at TIMESTAMPTZ NOT NULL\n );\n CREATE INDEX IF NOT EXISTS ${safeIndexName} ON ${lockTableName}(expires_at);\n `);\n }\n\n async function tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null> {\n const ttlMs = opts?.ttlMs ?? 60_000;\n const ownerToken = randomUUID();\n const expiresAt = new Date(Date.now() + ttlMs);\n\n await ensureLockTable();\n\n // Insert new row or update only if current row is expired (or missing).\n const result = await pool.query(\n `\n INSERT INTO ${lockTableName} (workflow_id, owner_token, expires_at)\n VALUES ($1, $2, $3)\n ON CONFLICT (workflow_id) DO UPDATE SET\n owner_token = EXCLUDED.owner_token,\n expires_at = EXCLUDED.expires_at\n WHERE ${lockTableName}.expires_at < NOW()\n RETURNING owner_token\n `,\n [id, ownerToken, expiresAt]\n );\n\n if (result.rowCount === 1 && result.rows[0].owner_token === ownerToken) {\n return { ownerToken };\n }\n return null;\n }\n\n async function release(id: string, ownerToken: string): Promise<void> {\n await pool.query(\n `DELETE FROM ${lockTableName} WHERE workflow_id = $1 AND owner_token = $2`,\n [id, ownerToken]\n );\n }\n\n return { tryAcquire, release, ensureLockTable };\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,2BAAAE,EAAA,8BAAAC,IAAA,eAAAC,EAAAJ,GAOA,IAAAK,EAA+B,cCA/B,IAAAC,EAA+B,cAmElBC,EAAN,KAAqD,CAClD,KACA,UACA,YAAuB,GACvB,YAAoC,KAE5C,YAAYC,EAAuC,CAC7CA,EAAQ,aAEV,KAAK,KAAOA,EAAQ,aACXA,EAAQ,iBAEjB,KAAK,KAAO,IAAI,EAAAC,KAAO,CACrB,iBAAkBD,EAAQ,iBAC1B,GAAGA,EAAQ,IACb,CAAC,EAGD,KAAK,KAAO,IAAI,EAAAC,KAAO,CACrB,KAAMD,EAAQ,MAAQ,YACtB,KAAMA,EAAQ,MAAQ,KACtB,SAAUA,EAAQ,SAClB,KAAMA,EAAQ,KACd,SAAUA,EAAQ,SAClB,GAAGA,EAAQ,IACb,CAAC,EAGH,KAAK,UAAYA,EAAQ,WAAa,wBACxC,CAMA,MAAc,mBAAmC,CAC/C,GAAI,MAAK,YAIT,OAAI,KAAK,YACA,KAAK,aAGd,KAAK,aAAe,SAAY,CAC9B,GAAI,CACF,MAAM,KAAK,YAAY,EACvB,KAAK,YAAc,EACrB,OAASE,EAAO,CACd,WAAK,YAAc,KACbA,CACR,CACF,GAAG,EAEI,KAAK,YACd,CAMA,MAAc,aAA6B,CACzC,MAAM,KAAK,KAAK,MAAM;AAAA,mCACS,KAAK,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAM5C,EAGD,MAAM,KAAK,KAAK,MAAM;AAAA,oBACN,KAAK,SAAS;AAAA;AAAA,KAE7B,EAED,MAAM,KAAK,KAAK,MAAM;AAAA,uCACa,KAAK,SAAS;AAAA,WAC1C,KAAK,SAAS;AAAA;AAAA,KAEpB,EAED,MAAM,KAAK,KAAK,MAAM;AAAA,uCACa,KAAK,SAAS;AAAA,WAC1C,KAAK,SAAS;AAAA;AAAA,KAEpB,CACH,CAMQ,cAAcC,EAAyB,CAE7C,OAAOA,EAAQ,QAAQ,KAAM,KAAK,EAAE,QAAQ,KAAM,KAAK,EAAE,QAAQ,MAAO,GAAG,CAC7E,CAEA,MAAM,IAAIC,EAAqC,CAC7C,MAAM,KAAK,kBAAkB,EAE7B,IAAMC,EAAQ;AAAA;AAAA,aAEL,KAAK,SAAS;AAAA;AAAA;AAAA,MAKjBC,EAAyC,MAAM,KAAK,KAAK,MAAMD,EAAO,CAACD,CAAG,CAAC,EAEjF,OAAIE,EAAO,KAAK,SAAW,EAClB,KAGFA,EAAO,KAAK,CAAC,EAAE,KACxB,CAEA,MAAM,IAAIF,EAAaG,EAAeP,EAA2C,CAC/E,MAAM,KAAK,kBAAkB,EAE7B,IAAMQ,EAAYR,GAAS,IACvB,IAAI,KAAK,KAAK,IAAI,EAAIA,EAAQ,IAAM,GAAI,EACxC,KAEEK,EAAQ;AAAA,oBACE,KAAK,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAS9B,MAAM,KAAK,KAAK,MAAMA,EAAO,CAACD,EAAKG,EAAOC,CAAS,CAAC,CACtD,CAEA,MAAM,OAAOJ,EAA+B,CAC1C,MAAM,KAAK,kBAAkB,EAE7B,IAAMC,EAAQ,eAAe,KAAK,SAAS,kBAG3C,QAFe,MAAM,KAAK,KAAK,MAAMA,EAAO,CAACD,CAAG,CAAC,GAElC,UAAY,GAAK,CAClC,CAEA,MAAM,OAAOA,EAA+B,CAC1C,MAAM,KAAK,kBAAkB,EAE7B,IAAMC,EAAQ;AAAA;AAAA,aAEL,KAAK,SAAS;AAAA;AAAA;AAAA;AAAA,MAOvB,OADe,MAAM,KAAK,KAAK,MAAMA,EAAO,CAACD,CAAG,CAAC,GACnC,KAAK,OAAS,CAC9B,CAEA,MAAM,KAAKD,EAAoC,CAC7C,MAAM,KAAK,kBAAkB,EAG7B,IAAMM,EAAc,KAAK,cAAcN,CAAO,EAExCE,EAAQ;AAAA;AAAA,aAEL,KAAK,SAAS;AAAA;AAAA;AAAA,MAOvB,OAF6C,MAAM,KAAK,KAAK,MAAMA,EAAO,CAACI,CAAW,CAAC,GAEzE,KAAK,IAAKC,GAAQA,EAAI,GAAG,CACzC,CAKA,MAAM,SACJP,EACAH,EAA2B,CAAC,EACiB,CAC7C,MAAM,KAAK,kBAAkB,EAE7B,IAAMW,EAAQ,KAAK,IAAI,KAAK,IAAI,EAAGX,EAAQ,OAAS,GAAG,EAAG,GAAM,EAC1DY,EAAS,KAAK,IAAI,EAAGZ,EAAQ,QAAU,CAAC,EACxCa,EAAUb,EAAQ,UAAY,MAAQ,MAAQ,aAC9Cc,EAAWd,EAAQ,WAAa,MAAQ,MAAQ,OAChDS,EAAc,KAAK,cAAcN,CAAO,EAExCY,EAAuB,CAC3B,cACA,4CACF,EACMC,EAAkB,CAACP,CAAW,EAChCQ,EAAa,EAEbjB,EAAQ,eAAiB,OAC3Be,EAAW,KAAK,iBAAiBE,CAAU,EAAE,EAC7CD,EAAK,KAAKhB,EAAQ,aAAa,EAC/BiB,KAEEjB,EAAQ,cAAgB,OAC1Be,EAAW,KAAK,iBAAiBE,CAAU,EAAE,EAC7CD,EAAK,KAAKhB,EAAQ,YAAY,EAC9BiB,KAGF,IAAMC,EAAcH,EAAW,KAAK,OAAO,EACrCI,EAAaN,IAAY,aAAe,cAAgB,GAExDO,EAAY;AAAA;AAAA,aAET,KAAK,SAAS;AAAA,cACbF,CAAW;AAAA,iBACRL,CAAO,IAAIC,CAAQ,GAAGK,CAAU;AAAA,eAClCF,CAAU,YAAYA,EAAa,CAAC;AAAA,MAEzCI,EAAW,CAAC,GAAGL,EAAML,EAAOC,CAAM,EAGlCU,GADuC,MAAM,KAAK,KAAK,MAAMF,EAAWC,CAAQ,GAClE,KAAK,IAAKX,GAAQA,EAAI,GAAG,EAEzCa,EACJ,GAAIvB,EAAQ,eAAiB,IAAQY,EAAS,EAAG,CAC/C,IAAMY,EAA8C,MAAM,KAAK,KAAK,MAClE,iCAAiC,KAAK,SAAS,UAAUN,CAAW,GACpEF,CACF,EACAO,EAAQ,SAASC,EAAY,KAAK,CAAC,GAAG,OAAS,IAAK,EAAE,CACxD,CAEA,MAAO,CAAE,KAAAF,EAAM,MAAAC,CAAM,CACvB,CAKA,MAAM,WAAWD,EAAiC,CAChD,OAAIA,EAAK,SAAW,EAAU,GAC9B,MAAM,KAAK,kBAAkB,GACd,MAAM,KAAK,KAAK,MAC7B,eAAe,KAAK,SAAS,+BAC7B,CAACA,CAAI,CACP,GACc,UAAY,EAC5B,CAKA,MAAM,OAAuB,CAC3B,MAAM,KAAK,kBAAkB,EAC7B,MAAM,KAAK,KAAK,MAAM,kBAAkB,KAAK,SAAS,EAAE,CAC1D,CAMA,MAAM,OAAuB,CAC3B,MAAM,KAAK,KAAK,IAAI,CACtB,CACF,EChVA,IAAAG,EAA2B,kBAcpB,SAASC,EACdC,EACAC,EAA+B,CAAC,EAQhC,CACA,IAAMC,EAAgBD,EAAQ,eAAiB,wBAEzCE,EAAgB,OAAOD,EAAc,QAAQ,iBAAkB,GAAG,CAAC,cAEzE,eAAeE,GAAiC,CAC9C,MAAMJ,EAAK,MAAM;AAAA,mCACcE,CAAa;AAAA;AAAA;AAAA;AAAA;AAAA,mCAKbC,CAAa,OAAOD,CAAa;AAAA,KAC/D,CACH,CAEA,eAAeG,EACbC,EACAC,EACwC,CACxC,IAAMC,EAAQD,GAAM,OAAS,IACvBE,KAAa,cAAW,EACxBC,EAAY,IAAI,KAAK,KAAK,IAAI,EAAIF,CAAK,EAE7C,MAAMJ,EAAgB,EAGtB,IAAMO,EAAS,MAAMX,EAAK,MACxB;AAAA,oBACcE,CAAa;AAAA;AAAA;AAAA;AAAA;AAAA,cAKnBA,CAAa;AAAA;AAAA,MAGrB,CAACI,EAAIG,EAAYC,CAAS,CAC5B,EAEA,OAAIC,EAAO,WAAa,GAAKA,EAAO,KAAK,CAAC,EAAE,cAAgBF,EACnD,CAAE,WAAAA,CAAW,EAEf,IACT,CAEA,eAAeG,EAAQN,EAAYG,EAAmC,CACpE,MAAMT,EAAK,MACT,eAAeE,CAAa,+CAC5B,CAACI,EAAIG,CAAU,CACjB,CACF,CAEA,MAAO,CAAE,WAAAJ,EAAY,QAAAO,EAAS,gBAAAR,CAAgB,CAChD,CF1EA,IAAAS,EAMO,+BAsFP,eAAsBC,EACpBC,EAAsC,CAAC,EAC+B,CACtE,GAAM,CAAE,OAAAC,EAAQ,KAAMC,EAAa,GAAGC,CAAa,EAAIH,EAEjDI,EAAeC,GACnBA,EAAI,OAAOJ,GAAU,mBAAmB,MAAM,EAE1CK,EAAkBL,GAAU,kBAC5BM,EAAaC,GAA0B,GAAGF,CAAe,GAAGE,CAAK,GAEjEC,EAA2B,CAC/BC,EACAC,IAEO,OAAO,OAAOD,EAAkB,CACrC,MAAM,SAASV,EAA2B,CAAC,EAA4B,CACrE,GAAM,CAAE,KAAAY,EAAM,MAAAC,CAAM,EAAI,MAAMF,EAAM,SAAS,GAAGL,CAAe,IAAKN,CAAO,EACrEc,EAAMF,EAAK,IAAIR,CAAW,EAC1BW,EAAQ,KAAK,IAAI,KAAK,IAAI,EAAGf,EAAQ,OAAS,GAAG,EAAG,GAAM,EAC1DgB,EACJF,EAAI,SAAWC,GAASf,EAAQ,QAAU,GAAKc,EAAI,OAAS,OAC9D,MAAO,CAAE,IAAAA,EAAK,MAAAD,EAAO,WAAAG,CAAW,CAClC,EACA,MAAM,WAAWF,EAAgC,CAC/C,GAAIA,EAAI,SAAW,EAAG,MAAO,GAC7B,IAAMF,EAAOE,EAAI,IAAIP,CAAS,EAC9B,OAAOI,EAAM,WAAWC,CAAI,CAC9B,EACA,MAAM,OAAuB,CAC3B,OAAOD,EAAM,MAAM,CACrB,CACF,CAAC,EAGH,GAAIT,IAAgB,OAAW,CAC7B,IAAMe,EACJd,EAAa,cACb,IAAI,EAAAe,KACFf,EAAa,iBACT,CAAE,iBAAkBA,EAAa,iBAAkB,GAAGA,EAAa,IAAK,EACxE,CACE,KAAMA,EAAa,MAAQ,YAC3B,KAAMA,EAAa,MAAQ,KAC3B,SAAUA,EAAa,SACvB,KAAMA,EAAa,KACnB,SAAUA,EAAa,SACvB,GAAGA,EAAa,IAClB,CACN,EACIQ,EAAQ,IAAIQ,EAAsB,CAAE,GAAGhB,EAAc,aAAcc,CAAK,CAAC,EACzEP,KAAmB,0BAAuBC,EAAOV,CAAM,EACvDmB,EAAOC,EAAmBJ,EAAM,CACpC,cAAef,EAAY,aAC7B,CAAC,EACD,OAAO,OAAO,OAAOO,EAAyBC,EAAkBC,CAAK,EAAG,CACtE,WAAYS,EAAK,WAAW,KAAKA,CAAI,EACrC,QAASA,EAAK,QAAQ,KAAKA,CAAI,CACjC,CAAC,CACH,CAEA,IAAMT,EAAQ,IAAIQ,EAAsBhB,CAAY,EAC9CmB,KAAO,0BAAuBX,EAAOV,CAAM,EACjD,OAAOQ,EAAyBa,EAA6FX,CAAK,CACpI","names":["index_exports","__export","PostgresKeyValueStore","createPostgresPersistence","__toCommonJS","import_pg","import_pg","PostgresKeyValueStore","options","PgPool","error","pattern","key","query","result","value","expiresAt","likePattern","row","limit","offset","orderBy","orderDir","conditions","args","paramIndex","whereClause","orderNulls","listQuery","listArgs","keys","total","countResult","import_node_crypto","createPostgresLock","pool","options","lockTableName","safeIndexName","ensureLockTable","tryAcquire","id","opts","ttlMs","ownerToken","expiresAt","result","release","import_persistence","createPostgresPersistence","options","prefix","lockOptions","storeOptions","stripPrefix","key","effectivePrefix","prefixKey","runId","addListPageAndDeleteMany","statePersistence","store","keys","total","ids","limit","nextOffset","pool","PgPool","PostgresKeyValueStore","lock","createPostgresLock","base"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/postgres-lock.ts"],"sourcesContent":["/*\n awaitly-postgres\n \n PostgreSQL persistence adapter for awaitly workflows.\n * Provides ready-to-use SnapshotStore backed by PostgreSQL.\n /\n\nimport { Pool as PgPool } from \"pg\";\nimport type { WorkflowSnapshot, SnapshotStore } from \"awaitly/persistence\";\nimport type { WorkflowLock } from \"awaitly/durable\";\nimport { createPostgresLock, type PostgresLockOptions } from \"./postgres-lock\";\n\n// Re-export types for convenience\nexport type { SnapshotStore, WorkflowSnapshot } from \"awaitly/persistence\";\nexport type { WorkflowLock } from \"awaitly/durable\";\nexport type { PostgresLockOptions } from \"./postgres-lock\";\n\n// =============================================================================\n// PostgresOptions\n// =============================================================================\n\n/\n Options for the postgres() shorthand function.\n /\nexport interface PostgresOptions {\n /* PostgreSQL connection URL. /\n url: string;\n /* Table name for snapshots. @default 'awaitly_snapshots' /\n table?: string;\n /* Key prefix for IDs. @default '' /\n prefix?: string;\n /* Bring your own pool. /\n pool?: PgPool;\n /* Auto-create table on first use. @default true /\n autoCreateTable?: boolean;\n /* Cross-process lock options. When set, the store implements WorkflowLock. /\n lock?: PostgresLockOptions;\n}\n\n// =============================================================================\n// postgres() - One-liner Snapshot Store Setup\n// =============================================================================\n\nconst SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]$/;\n\n/*\n Create a snapshot store backed by PostgreSQL.\n * This is the simplified one-liner API for workflow persistence.\n \n @example\n * ```typescript\n * import { postgres } from 'awaitly-postgres';\n \n // One-liner setup\n * const store = postgres('postgresql://localhost/mydb');\n \n // Execute + persist\n * const wf = createWorkflow(deps);\n * await wf(myWorkflowFn);\n * await store.save('wf-123', wf.getSnapshot());\n \n // Restore\n * const snapshot = await store.load('wf-123');\n * const wf2 = createWorkflow(deps, { snapshot });\n * await wf2(myWorkflowFn);\n * ```\n \n @example\n * ```typescript\n * // With options including cross-process locking\n * const store = postgres({\n * url: 'postgresql://localhost/mydb',\n * table: 'my_workflow_snapshots',\n * prefix: 'orders:',\n * lock: { lockTableName: 'my_workflow_locks' },\n * });\n * ```\n /\nexport function postgres(urlOrOptions: string \| PostgresOptions): SnapshotStore & Partial<WorkflowLock> {\n const opts = typeof urlOrOptions === \"string\" ? { url: urlOrOptions } : urlOrOptions;\n const tableName = opts.table ?? \"awaitly_snapshots\";\n\n if (!SAFE_TABLE_NAME.test(tableName)) {\n throw new Error(`Invalid table name: ${tableName}. Must be alphanumeric with underscores.`);\n }\n\n const prefix = opts.prefix ?? \"\";\n const autoCreateTable = opts.autoCreateTable ?? true;\n\n // Create or use existing pool\n const ownPool = !opts.pool;\n const pool = opts.pool ?? new PgPool({ connectionString: opts.url });\n let tableCreated = false;\n\n const ensureTable = async (): Promise<void> => {\n if (!autoCreateTable \|\| tableCreated) return;\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${tableName} (\n id TEXT PRIMARY KEY,\n snapshot JSONB NOT NULL,\n updated_at TIMESTAMPTZ DEFAULT NOW()\n )\n `);\n await pool.query(`\n CREATE INDEX IF NOT EXISTS ${tableName}_updated_at_idx ON ${tableName} (updated_at DESC)\n `);\n tableCreated = true;\n };\n\n // Create lock if requested\n const lock = opts.lock ? createPostgresLock(pool, opts.lock) : null;\n\n const store: SnapshotStore & Partial<WorkflowLock> = {\n async save(id: string, snapshot: WorkflowSnapshot): Promise<void> {\n await ensureTable();\n const fullId = prefix + id;\n await pool.query(\n `INSERT INTO ${tableName} (id, snapshot, updated_at)\n VALUES ($1, $2, NOW())\n ON CONFLICT (id) DO UPDATE SET snapshot = $2, updated_at = NOW()`,\n [fullId, JSON.stringify(snapshot)]\n );\n },\n\n async load(id: string): Promise<WorkflowSnapshot \| null> {\n await ensureTable();\n const fullId = prefix + id;\n const result = await pool.query(\n `SELECT snapshot FROM ${tableName} WHERE id = $1`,\n [fullId]\n );\n if (result.rows.length === 0) return null;\n return result.rows[0].snapshot as WorkflowSnapshot;\n },\n\n async delete(id: string): Promise<void> {\n await ensureTable();\n const fullId = prefix + id;\n await pool.query(`DELETE FROM ${tableName} WHERE id = $1`, [fullId]);\n },\n\n async list(options?: { prefix?: string; limit?: number }): Promise<Array<{ id: string; updatedAt: string }>> {\n await ensureTable();\n const filterPrefix = prefix + (options?.prefix ?? \"\");\n const limit = options?.limit ?? 100;\n\n const result = await pool.query(\n `SELECT id, updated_at FROM ${tableName}\n WHERE id LIKE $1\n ORDER BY updated_at DESC\n LIMIT $2`,\n [filterPrefix + \"%\", limit]\n );\n\n return result.rows.map(row => ({\n id: (row.id as string).slice(prefix.length),\n updatedAt: (row.updated_at as Date).toISOString(),\n }));\n },\n\n async close(): Promise<void> {\n // Only end pool if we created it\n if (ownPool) {\n await pool.end();\n }\n },\n };\n\n // Add lock methods if lock is configured\n if (lock) {\n store.tryAcquire = lock.tryAcquire.bind(lock);\n store.release = lock.release.bind(lock);\n }\n\n return store;\n}\n","/\n PostgreSQL workflow lock (lease) for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n\nimport type { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\n\n/\n Create tryAcquire and release functions that use a PostgreSQL lock table.\n * Caller must pass the same pool used for state (so one connection pool).\n */\nexport function createPostgresLock(\n pool: Pool,\n options: PostgresLockOptions = {}\n): {\n tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null>;\n release(id: string, ownerToken: string): Promise<void>;\n ensureLockTable(): Promise<void>;\n} {\n const lockTableName = options.lockTableName ?? \"awaitly_workflow_lock\";\n\n const safeIndexName = `idx_${lockTableName.replace(/[^a-zA-Z0-9_]/g, \"_\")}_expires_at`;\n\n async function ensureLockTable(): Promise<void> {\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${lockTableName} (\n workflow_id TEXT PRIMARY KEY,\n owner_token TEXT NOT NULL,\n expires_at TIMESTAMPTZ NOT NULL\n );\n CREATE INDEX IF NOT EXISTS ${safeIndexName} ON ${lockTableName}(expires_at);\n `);\n }\n\n async function tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null> {\n const ttlMs = opts?.ttlMs ?? 60_000;\n const ownerToken = randomUUID();\n const expiresAt = new Date(Date.now() + ttlMs);\n\n await ensureLockTable();\n\n // Insert new row or update only if current row is expired (or missing).\n const result = await pool.query(\n `\n INSERT INTO ${lockTableName} (workflow_id, owner_token, expires_at)\n VALUES ($1, $2, $3)\n ON CONFLICT (workflow_id) DO UPDATE SET\n owner_token = EXCLUDED.owner_token,\n expires_at = EXCLUDED.expires_at\n WHERE ${lockTableName}.expires_at < NOW()\n RETURNING owner_token\n `,\n [id, ownerToken, expiresAt]\n );\n\n if (result.rowCount === 1 && result.rows[0].owner_token === ownerToken) {\n return { ownerToken };\n }\n return null;\n }\n\n async function release(id: string, ownerToken: string): Promise<void> {\n await pool.query(\n `DELETE FROM ${lockTableName} WHERE workflow_id = $1 AND owner_token = $2`,\n [id, ownerToken]\n );\n }\n\n return { tryAcquire, release, ensureLockTable };\n}\n"],"mappings":"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","names":["index_exports","__export","postgres","__toCommonJS","import_pg","import_node_crypto","createPostgresLock","pool","options","lockTableName","safeIndexName","ensureLockTable","tryAcquire","id","opts","ttlMs","ownerToken","expiresAt","result","release","SAFE_TABLE_NAME","postgres","urlOrOptions","opts","tableName","prefix","autoCreateTable","ownPool","pool","PgPool","tableCreated","ensureTable","lock","createPostgresLock","store","id","snapshot","fullId","result","options","filterPrefix","limit","row"]}

package/dist/index.d.cts CHANGED Viewed

@@ -1,203 +1,79 @@
-import { PoolConfig, Pool } from 'pg';
-import { KeyValueStore, ListPageOptions, StatePersistence, SerializedState, ListPageResult } from 'awaitly/persistence';
+import { Pool } from 'pg';
+import { SnapshotStore } from 'awaitly/persistence';
+export { SnapshotStore, WorkflowSnapshot } from 'awaitly/persistence';
 import { WorkflowLock } from 'awaitly/durable';
+export { WorkflowLock } from 'awaitly/durable';
 /**
- * awaitly-postgres
- *
- * PostgreSQL KeyValueStore implementation for awaitly persistence.
+ * PostgreSQL workflow lock (lease) for cross-process concurrency control.
+ * Uses a lease (TTL) + owner token; release verifies the token.
  */
-/**
- * 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.
-     * Adds updated_at column to existing tables for listKeys ordering.
-     */
-    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[]>;
-    /**
-     * List keys with pagination, filtering, and ordering.
-     */
-    listKeys(pattern: string, options?: ListPageOptions): Promise<{
-        keys: string[];
-        total?: number;
-    }>;
-    /**
-     * Delete multiple keys in one round-trip.
-     */
-    deleteMany(keys: string[]): Promise<number>;
-    /**
-     * Remove all entries from the table (clear all workflow state).
-     */
-    clear(): Promise<void>;
+interface PostgresLockOptions {
     /**
-     * Close the database connection pool.
-     * Call this when done with the store.
+     * Table name for workflow locks.
+     * @default 'awaitly_workflow_lock'
      */
-    close(): Promise<void>;
+    lockTableName?: string;
 }
 /**
  * awaitly-postgres
  *
  * PostgreSQL persistence adapter for awaitly workflows.
- * Provides ready-to-use StatePersistence backed by PostgreSQL.
+ * Provides ready-to-use SnapshotStore backed by PostgreSQL.
  */
 /**
- * Options for cross-process locking (lease + owner token).
- * When set, the returned store implements WorkflowLock so only one process
- * runs a given workflow ID at a time (when durable.run allowConcurrent is false).
+ * Options for the postgres() shorthand function.
  */
-interface PostgresLockOptions {
-    /**
-     * Table name for workflow locks.
-     * @default 'awaitly_workflow_lock'
-     */
-    lockTableName?: string;
-}
-/**
- * Options for creating PostgreSQL persistence.
- */
-interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {
-    /**
-     * Key prefix for state entries.
-     * @default 'workflow:state:'
-     */
+interface PostgresOptions {
+    /** PostgreSQL connection URL. */
+    url: string;
+    /** Table name for snapshots. @default 'awaitly_snapshots' */
+    table?: string;
+    /** Key prefix for IDs. @default '' */
     prefix?: string;
-    /**
-     * When set, the store implements WorkflowLock for cross-process concurrency control.
-     * Uses a lease (TTL) + owner token; release verifies the token.
-     */
+    /** Bring your own pool. */
+    pool?: Pool;
+    /** Auto-create table on first use. @default true */
+    autoCreateTable?: boolean;
+    /** Cross-process lock options. When set, the store implements WorkflowLock. */
     lock?: PostgresLockOptions;
 }
 /**
- * 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()
+ * Create a snapshot store backed by PostgreSQL.
+ * This is the simplified one-liner API for workflow persistence.
  *
  * @example
  * ```typescript
- * import { createPostgresPersistence } from 'awaitly-postgres';
- * import { durable } from 'awaitly/durable';
+ * import { postgres } from 'awaitly-postgres';
  *
- * const store = await createPostgresPersistence({
- *   connectionString: process.env.DATABASE_URL,
- * });
+ * // One-liner setup
+ * const store = postgres('postgresql://localhost/mydb');
+ *
+ * // Execute + persist
+ * const wf = createWorkflow(deps);
+ * await wf(myWorkflowFn);
+ * await store.save('wf-123', wf.getSnapshot());
  *
- * 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,
- *   }
- * );
+ * // Restore
+ * const snapshot = await store.load('wf-123');
+ * const wf2 = createWorkflow(deps, { snapshot });
+ * await wf2(myWorkflowFn);
  * ```
  *
  * @example
  * ```typescript
- * // Using individual connection options
- * const store = await createPostgresPersistence({
- *   host: 'localhost',
- *   port: 5432,
- *   database: 'myapp',
- *   user: 'postgres',
- *   password: 'password',
- *   tableName: 'custom_workflow_state',
+ * // With options including cross-process locking
+ * const store = postgres({
+ *   url: 'postgresql://localhost/mydb',
+ *   table: 'my_workflow_snapshots',
+ *   prefix: 'orders:',
+ *   lock: { lockTableName: 'my_workflow_locks' },
  * });
  * ```
  */
-type PostgresStatePersistence = StatePersistence & {
-    loadRaw(runId: string): Promise<SerializedState | undefined>;
-    listPage(options?: ListPageOptions): Promise<ListPageResult>;
-    deleteMany(ids: string[]): Promise<number>;
-    clear(): Promise<void>;
-};
-type PostgresStatePersistenceWithLock = PostgresStatePersistence & WorkflowLock;
-declare function createPostgresPersistence(options?: PostgresPersistenceOptions): Promise<PostgresStatePersistence | PostgresStatePersistenceWithLock>;
+declare function postgres(urlOrOptions: string | PostgresOptions): SnapshotStore & Partial<WorkflowLock>;
-export { PostgresKeyValueStore, type PostgresKeyValueStoreOptions, type PostgresLockOptions, type PostgresPersistenceOptions, type PostgresStatePersistence, type PostgresStatePersistenceWithLock, createPostgresPersistence };
+export { type PostgresLockOptions, type PostgresOptions, postgres };

package/dist/index.d.ts CHANGED Viewed

@@ -1,203 +1,79 @@
-import { PoolConfig, Pool } from 'pg';
-import { KeyValueStore, ListPageOptions, StatePersistence, SerializedState, ListPageResult } from 'awaitly/persistence';
+import { Pool } from 'pg';
+import { SnapshotStore } from 'awaitly/persistence';
+export { SnapshotStore, WorkflowSnapshot } from 'awaitly/persistence';
 import { WorkflowLock } from 'awaitly/durable';
+export { WorkflowLock } from 'awaitly/durable';
 /**
- * awaitly-postgres
- *
- * PostgreSQL KeyValueStore implementation for awaitly persistence.
+ * PostgreSQL workflow lock (lease) for cross-process concurrency control.
+ * Uses a lease (TTL) + owner token; release verifies the token.
  */
-/**
- * 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.
-     * Adds updated_at column to existing tables for listKeys ordering.
-     */
-    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[]>;
-    /**
-     * List keys with pagination, filtering, and ordering.
-     */
-    listKeys(pattern: string, options?: ListPageOptions): Promise<{
-        keys: string[];
-        total?: number;
-    }>;
-    /**
-     * Delete multiple keys in one round-trip.
-     */
-    deleteMany(keys: string[]): Promise<number>;
-    /**
-     * Remove all entries from the table (clear all workflow state).
-     */
-    clear(): Promise<void>;
+interface PostgresLockOptions {
     /**
-     * Close the database connection pool.
-     * Call this when done with the store.
+     * Table name for workflow locks.
+     * @default 'awaitly_workflow_lock'
      */
-    close(): Promise<void>;
+    lockTableName?: string;
 }
 /**
  * awaitly-postgres
  *
  * PostgreSQL persistence adapter for awaitly workflows.
- * Provides ready-to-use StatePersistence backed by PostgreSQL.
+ * Provides ready-to-use SnapshotStore backed by PostgreSQL.
  */
 /**
- * Options for cross-process locking (lease + owner token).
- * When set, the returned store implements WorkflowLock so only one process
- * runs a given workflow ID at a time (when durable.run allowConcurrent is false).
+ * Options for the postgres() shorthand function.
  */
-interface PostgresLockOptions {
-    /**
-     * Table name for workflow locks.
-     * @default 'awaitly_workflow_lock'
-     */
-    lockTableName?: string;
-}
-/**
- * Options for creating PostgreSQL persistence.
- */
-interface PostgresPersistenceOptions extends PostgresKeyValueStoreOptions {
-    /**
-     * Key prefix for state entries.
-     * @default 'workflow:state:'
-     */
+interface PostgresOptions {
+    /** PostgreSQL connection URL. */
+    url: string;
+    /** Table name for snapshots. @default 'awaitly_snapshots' */
+    table?: string;
+    /** Key prefix for IDs. @default '' */
     prefix?: string;
-    /**
-     * When set, the store implements WorkflowLock for cross-process concurrency control.
-     * Uses a lease (TTL) + owner token; release verifies the token.
-     */
+    /** Bring your own pool. */
+    pool?: Pool;
+    /** Auto-create table on first use. @default true */
+    autoCreateTable?: boolean;
+    /** Cross-process lock options. When set, the store implements WorkflowLock. */
     lock?: PostgresLockOptions;
 }
 /**
- * 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()
+ * Create a snapshot store backed by PostgreSQL.
+ * This is the simplified one-liner API for workflow persistence.
  *
  * @example
  * ```typescript
- * import { createPostgresPersistence } from 'awaitly-postgres';
- * import { durable } from 'awaitly/durable';
+ * import { postgres } from 'awaitly-postgres';
  *
- * const store = await createPostgresPersistence({
- *   connectionString: process.env.DATABASE_URL,
- * });
+ * // One-liner setup
+ * const store = postgres('postgresql://localhost/mydb');
+ *
+ * // Execute + persist
+ * const wf = createWorkflow(deps);
+ * await wf(myWorkflowFn);
+ * await store.save('wf-123', wf.getSnapshot());
  *
- * 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,
- *   }
- * );
+ * // Restore
+ * const snapshot = await store.load('wf-123');
+ * const wf2 = createWorkflow(deps, { snapshot });
+ * await wf2(myWorkflowFn);
  * ```
  *
  * @example
  * ```typescript
- * // Using individual connection options
- * const store = await createPostgresPersistence({
- *   host: 'localhost',
- *   port: 5432,
- *   database: 'myapp',
- *   user: 'postgres',
- *   password: 'password',
- *   tableName: 'custom_workflow_state',
+ * // With options including cross-process locking
+ * const store = postgres({
+ *   url: 'postgresql://localhost/mydb',
+ *   table: 'my_workflow_snapshots',
+ *   prefix: 'orders:',
+ *   lock: { lockTableName: 'my_workflow_locks' },
  * });
  * ```
  */
-type PostgresStatePersistence = StatePersistence & {
-    loadRaw(runId: string): Promise<SerializedState | undefined>;
-    listPage(options?: ListPageOptions): Promise<ListPageResult>;
-    deleteMany(ids: string[]): Promise<number>;
-    clear(): Promise<void>;
-};
-type PostgresStatePersistenceWithLock = PostgresStatePersistence & WorkflowLock;
-declare function createPostgresPersistence(options?: PostgresPersistenceOptions): Promise<PostgresStatePersistence | PostgresStatePersistenceWithLock>;
+declare function postgres(urlOrOptions: string | PostgresOptions): SnapshotStore & Partial<WorkflowLock>;
-export { PostgresKeyValueStore, type PostgresKeyValueStoreOptions, type PostgresLockOptions, type PostgresPersistenceOptions, type PostgresStatePersistence, type PostgresStatePersistenceWithLock, createPostgresPersistence };
+export { type PostgresLockOptions, type PostgresOptions, postgres };

package/dist/index.js CHANGED Viewed

@@ -1,59 +1,11 @@
-import{Pool as L}from"pg";import{Pool as N}from"pg";var g=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(){await this.pool.query(`
-      CREATE TABLE IF NOT EXISTS ${this.tableName} (
-        key TEXT PRIMARY KEY,
-        value TEXT NOT NULL,
-        expires_at TIMESTAMP,
-        updated_at TIMESTAMPTZ
-      )
-    `),await this.pool.query(`
-      ALTER TABLE ${this.tableName}
-      ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ
-    `),await this.pool.query(`
-      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(`
-      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_updated_at
-      ON ${this.tableName}(updated_at)
-      WHERE updated_at IS NOT NULL
-    `)}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())
-    `,s=await this.pool.query(t,[e]);return s.rows.length===0?null:s.rows[0].value}async set(e,t,s){await this.ensureInitialized();let n=s?.ttl?new Date(Date.now()+s.ttl*1e3):null,o=`
-      INSERT INTO ${this.tableName} (key, value, expires_at, updated_at)
-      VALUES ($1, $2, $3, NOW())
-      ON CONFLICT (key)
-      DO UPDATE SET
-        value = EXCLUDED.value,
-        expires_at = EXCLUDED.expires_at,
-        updated_at = NOW()
-    `;await this.pool.query(o,[e,t,n])}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),s=`
-      SELECT key
-      FROM ${this.tableName}
-      WHERE key LIKE $1
-        AND (expires_at IS NULL OR expires_at > NOW())
-    `;return(await this.pool.query(s,[t])).rows.map(o=>o.key)}async listKeys(e,t={}){await this.ensureInitialized();let s=Math.min(Math.max(0,t.limit??100),1e4),n=Math.max(0,t.offset??0),o=t.orderBy==="key"?"key":"updated_at",P=t.orderDir==="asc"?"ASC":"DESC",c=this.patternToLike(e),l=["key LIKE $1","(expires_at IS NULL OR expires_at > NOW())"],p=[c],r=2;t.updatedBefore!=null&&(l.push(`updated_at < $${r}`),p.push(t.updatedBefore),r++),t.updatedAfter!=null&&(l.push(`updated_at > $${r}`),p.push(t.updatedAfter),r++);let a=l.join(" AND "),i=o==="updated_at"?" NULLS LAST":"",u=`
-      SELECT key
-      FROM ${this.tableName}
-      WHERE ${a}
-      ORDER BY ${o} ${P}${i}
-      LIMIT $${r} OFFSET $${r+1}
-    `,E=[...p,s,n],w=(await this.pool.query(u,E)).rows.map(T=>T.key),y;if(t.includeTotal===!0||n>0){let T=await this.pool.query(`SELECT COUNT(*) AS count FROM ${this.tableName} WHERE ${a}`,p);y=parseInt(T.rows[0]?.count??"0",10)}return{keys:w,total:y}}async deleteMany(e){return e.length===0?0:(await this.ensureInitialized(),(await this.pool.query(`DELETE FROM ${this.tableName} WHERE key = ANY($1::text[])`,[e])).rowCount??0)}async clear(){await this.ensureInitialized(),await this.pool.query(`TRUNCATE TABLE ${this.tableName}`)}async close(){await this.pool.end()}};import{randomUUID as k}from"crypto";function h(d,e={}){let t=e.lockTableName??"awaitly_workflow_lock",s=`idx_${t.replace(/[^a-zA-Z0-9_]/g,"_")}_expires_at`;async function n(){await d.query(`
+import{Pool as k}from"pg";import{randomUUID as f}from"crypto";function T(n,e={}){let t=e.lockTableName??"awaitly_workflow_lock",i=`idx_${t.replace(/[^a-zA-Z0-9_]/g,"_")}_expires_at`;async function E(){await n.query(`
       CREATE TABLE IF NOT EXISTS ${t} (
         workflow_id TEXT PRIMARY KEY,
         owner_token TEXT NOT NULL,
         expires_at TIMESTAMPTZ NOT NULL
       );
-      CREATE INDEX IF NOT EXISTS ${s} ON ${t}(expires_at);
-    `)}async function o(c,l){let p=l?.ttlMs??6e4,r=k(),a=new Date(Date.now()+p);await n();let i=await d.query(`
+      CREATE INDEX IF NOT EXISTS ${i} ON ${t}(expires_at);
+    `)}async function w(p,a){let l=a?.ttlMs??6e4,c=f(),r=new Date(Date.now()+l);await E();let s=await n.query(`
       INSERT INTO ${t} (workflow_id, owner_token, expires_at)
       VALUES ($1, $2, $3)
       ON CONFLICT (workflow_id) DO UPDATE SET
@@ -61,5 +13,18 @@ import{Pool as L}from"pg";import{Pool as N}from"pg";var g=class{pool;tableName;i
         expires_at = EXCLUDED.expires_at
       WHERE ${t}.expires_at < NOW()
       RETURNING owner_token
-    `,[c,r,a]);return i.rowCount===1&&i.rows[0].owner_token===r?{ownerToken:r}:null}async function P(c,l){await d.query(`DELETE FROM ${t} WHERE workflow_id = $1 AND owner_token = $2`,[c,l])}return{tryAcquire:o,release:P,ensureLockTable:n}}import{createStatePersistence as S}from"awaitly/persistence";async function A(d={}){let{prefix:e,lock:t,...s}=d,n=r=>r.slice((e??"workflow:state:").length),o=e??"workflow:state:",P=r=>`${o}${r}`,c=(r,a)=>Object.assign(r,{async listPage(i={}){let{keys:u,total:E}=await a.listKeys(`${o}*`,i),m=u.map(n),w=Math.min(Math.max(0,i.limit??100),1e4),y=m.length===w?(i.offset??0)+m.length:void 0;return{ids:m,total:E,nextOffset:y}},async deleteMany(i){if(i.length===0)return 0;let u=i.map(P);return a.deleteMany(u)},async clear(){return a.clear()}});if(t!==void 0){let r=s.existingPool??new L(s.connectionString?{connectionString:s.connectionString,...s.pool}:{host:s.host??"localhost",port:s.port??5432,database:s.database,user:s.user,password:s.password,...s.pool}),a=new g({...s,existingPool:r}),i=S(a,e),u=h(r,{lockTableName:t.lockTableName});return Object.assign(c(i,a),{tryAcquire:u.tryAcquire.bind(u),release:u.release.bind(u)})}let l=new g(s),p=S(l,e);return c(p,l)}export{g as PostgresKeyValueStore,A as createPostgresPersistence};
+    `,[p,c,r]);return s.rowCount===1&&s.rows[0].owner_token===c?{ownerToken:c}:null}async function o(p,a){await n.query(`DELETE FROM ${t} WHERE workflow_id = $1 AND owner_token = $2`,[p,a])}return{tryAcquire:w,release:o,ensureLockTable:E}}var m=/^[a-zA-Z_][a-zA-Z0-9_]*$/;function N(n){let e=typeof n=="string"?{url:n}:n,t=e.table??"awaitly_snapshots";if(!m.test(t))throw new Error(`Invalid table name: ${t}. Must be alphanumeric with underscores.`);let i=e.prefix??"",E=e.autoCreateTable??!0,w=!e.pool,o=e.pool??new k({connectionString:e.url}),p=!1,a=async()=>{!E||p||(await o.query(`
+      CREATE TABLE IF NOT EXISTS ${t} (
+        id TEXT PRIMARY KEY,
+        snapshot JSONB NOT NULL,
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+      )
+    `),await o.query(`
+      CREATE INDEX IF NOT EXISTS ${t}_updated_at_idx ON ${t} (updated_at DESC)
+    `),p=!0)},l=e.lock?T(o,e.lock):null,c={async save(r,s){await a();let u=i+r;await o.query(`INSERT INTO ${t} (id, snapshot, updated_at)
+         VALUES ($1, $2, NOW())
+         ON CONFLICT (id) DO UPDATE SET snapshot = $2, updated_at = NOW()`,[u,JSON.stringify(s)])},async load(r){await a();let s=i+r,u=await o.query(`SELECT snapshot FROM ${t} WHERE id = $1`,[s]);return u.rows.length===0?null:u.rows[0].snapshot},async delete(r){await a();let s=i+r;await o.query(`DELETE FROM ${t} WHERE id = $1`,[s])},async list(r){await a();let s=i+(r?.prefix??""),u=r?.limit??100;return(await o.query(`SELECT id, updated_at FROM ${t}
+         WHERE id LIKE $1
+         ORDER BY updated_at DESC
+         LIMIT $2`,[s+"%",u])).rows.map(d=>({id:d.id.slice(i.length),updatedAt:d.updated_at.toISOString()}))},async close(){w&&await o.end()}};return l&&(c.tryAcquire=l.tryAcquire.bind(l),c.release=l.release.bind(l)),c}export{N as postgres};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/postgres-store.ts","../src/postgres-lock.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 { Pool as PgPool } from \"pg\";\nimport { PostgresKeyValueStore, type PostgresKeyValueStoreOptions } from \"./postgres-store\";\nimport { createPostgresLock } from \"./postgres-lock\";\nimport {\n createStatePersistence,\n type StatePersistence,\n type SerializedState,\n type ListPageOptions,\n type ListPageResult,\n} from \"awaitly/persistence\";\nimport type { WorkflowLock } from \"awaitly/durable\";\n\n/\n Options for cross-process locking (lease + owner token).\n * When set, the returned store implements WorkflowLock so only one process\n * runs a given workflow ID at a time (when durable.run allowConcurrent is false).\n /\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\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 When set, the store implements WorkflowLock for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n lock?: PostgresLockOptions;\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 type PostgresStatePersistence = StatePersistence & {\n loadRaw(runId: string): Promise<SerializedState \| undefined>;\n listPage(options?: ListPageOptions): Promise<ListPageResult>;\n deleteMany(ids: string[]): Promise<number>;\n clear(): Promise<void>;\n};\n\nexport type PostgresStatePersistenceWithLock = PostgresStatePersistence & WorkflowLock;\n\nexport async function createPostgresPersistence(\n options: PostgresPersistenceOptions = {}\n): Promise<PostgresStatePersistence \| PostgresStatePersistenceWithLock> {\n const { prefix, lock: lockOptions, ...storeOptions } = options;\n\n const stripPrefix = (key: string): string =>\n key.slice((prefix ?? \"workflow:state:\").length);\n\n const effectivePrefix = prefix ?? \"workflow:state:\";\n const prefixKey = (runId: string): string => `${effectivePrefix}${runId}`;\n\n const addListPageAndDeleteMany = (\n statePersistence: StatePersistence & { loadRaw(runId: string): Promise<SerializedState \| undefined> },\n store: PostgresKeyValueStore\n ): PostgresStatePersistence => {\n return Object.assign(statePersistence, {\n async listPage(options: ListPageOptions = {}): Promise<ListPageResult> {\n const { keys, total } = await store.listKeys(`${effectivePrefix}`, options);\n const ids = keys.map(stripPrefix);\n const limit = Math.min(Math.max(0, options.limit ?? 100), 10_000);\n const nextOffset =\n ids.length === limit ? (options.offset ?? 0) + ids.length : undefined;\n return { ids, total, nextOffset };\n },\n async deleteMany(ids: string[]): Promise<number> {\n if (ids.length === 0) return 0;\n const keys = ids.map(prefixKey);\n return store.deleteMany(keys);\n },\n async clear(): Promise<void> {\n return store.clear();\n },\n });\n };\n\n if (lockOptions !== undefined) {\n const pool =\n storeOptions.existingPool ??\n new PgPool(\n storeOptions.connectionString\n ? { connectionString: storeOptions.connectionString, ...storeOptions.pool }\n : {\n host: storeOptions.host ?? \"localhost\",\n port: storeOptions.port ?? 5432,\n database: storeOptions.database,\n user: storeOptions.user,\n password: storeOptions.password,\n ...storeOptions.pool,\n }\n );\n const store = new PostgresKeyValueStore({ ...storeOptions, existingPool: pool });\n const statePersistence = createStatePersistence(store, prefix) as PostgresStatePersistence;\n const lock = createPostgresLock(pool, {\n lockTableName: lockOptions.lockTableName,\n });\n return Object.assign(addListPageAndDeleteMany(statePersistence, store), {\n tryAcquire: lock.tryAcquire.bind(lock),\n release: lock.release.bind(lock),\n });\n }\n\n const store = new PostgresKeyValueStore(storeOptions);\n const base = createStatePersistence(store, prefix);\n return addListPageAndDeleteMany(base as StatePersistence & { loadRaw(runId: string): Promise<SerializedState \| undefined> }, store);\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, ListPageOptions } 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 * Adds updated_at column to existing tables for listKeys ordering.\n /\n private async createTable(): Promise<void> {\n await this.pool.query(`\n CREATE TABLE IF NOT EXISTS ${this.tableName} (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL,\n expires_at TIMESTAMP,\n updated_at TIMESTAMPTZ\n )\n `);\n\n // Add updated_at to existing tables that don't have it (before creating index)\n await this.pool.query(`\n ALTER TABLE ${this.tableName} \n ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ\n `);\n\n await this.pool.query(`\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(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_updated_at \n ON ${this.tableName}(updated_at) \n WHERE updated_at IS NOT NULL\n `);\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, updated_at)\n VALUES ($1, $2, $3, NOW())\n ON CONFLICT (key) \n DO UPDATE SET \n value = EXCLUDED.value,\n expires_at = EXCLUDED.expires_at,\n updated_at = NOW()\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 List keys with pagination, filtering, and ordering.\n /\n async listKeys(\n pattern: string,\n options: ListPageOptions = {}\n ): Promise<{ keys: string[]; total?: number }> {\n await this.ensureInitialized();\n\n const limit = Math.min(Math.max(0, options.limit ?? 100), 10_000);\n const offset = Math.max(0, options.offset ?? 0);\n const orderBy = options.orderBy === \"key\" ? \"key\" : \"updated_at\";\n const orderDir = options.orderDir === \"asc\" ? \"ASC\" : \"DESC\";\n const likePattern = this.patternToLike(pattern);\n\n const conditions: string[] = [\n \"key LIKE $1\",\n \"(expires_at IS NULL OR expires_at > NOW())\",\n ];\n const args: unknown[] = [likePattern];\n let paramIndex = 2;\n\n if (options.updatedBefore != null) {\n conditions.push(`updated_at < $${paramIndex}`);\n args.push(options.updatedBefore);\n paramIndex++;\n }\n if (options.updatedAfter != null) {\n conditions.push(`updated_at > $${paramIndex}`);\n args.push(options.updatedAfter);\n paramIndex++;\n }\n\n const whereClause = conditions.join(\" AND \");\n const orderNulls = orderBy === \"updated_at\" ? \" NULLS LAST\" : \"\";\n\n const listQuery = `\n SELECT key \n FROM ${this.tableName} \n WHERE ${whereClause}\n ORDER BY ${orderBy} ${orderDir}${orderNulls}\n LIMIT $${paramIndex} OFFSET $${paramIndex + 1}\n `;\n const listArgs = [...args, limit, offset];\n\n const result: QueryResult<{ key: string }> = await this.pool.query(listQuery, listArgs);\n const keys = result.rows.map((row) => row.key);\n\n let total: number \| undefined;\n if (options.includeTotal === true \|\| offset > 0) {\n const countResult: QueryResult<{ count: string }> = await this.pool.query(\n `SELECT COUNT() AS count FROM ${this.tableName} WHERE ${whereClause}`,\n args\n );\n total = parseInt(countResult.rows[0]?.count ?? \"0\", 10);\n }\n\n return { keys, total };\n }\n\n /*\n Delete multiple keys in one round-trip.\n /\n async deleteMany(keys: string[]): Promise<number> {\n if (keys.length === 0) return 0;\n await this.ensureInitialized();\n const result = await this.pool.query(\n `DELETE FROM ${this.tableName} WHERE key = ANY($1::text[])`,\n [keys]\n );\n return result.rowCount ?? 0;\n }\n\n /\n Remove all entries from the table (clear all workflow state).\n /\n async clear(): Promise<void> {\n await this.ensureInitialized();\n await this.pool.query(`TRUNCATE TABLE ${this.tableName}`);\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 PostgreSQL workflow lock (lease) for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n\nimport type { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\n\n/\n Create tryAcquire and release functions that use a PostgreSQL lock table.\n * Caller must pass the same pool used for state (so one connection pool).\n */\nexport function createPostgresLock(\n pool: Pool,\n options: PostgresLockOptions = {}\n): {\n tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null>;\n release(id: string, ownerToken: string): Promise<void>;\n ensureLockTable(): Promise<void>;\n} {\n const lockTableName = options.lockTableName ?? \"awaitly_workflow_lock\";\n\n const safeIndexName = `idx_${lockTableName.replace(/[^a-zA-Z0-9_]/g, \"_\")}_expires_at`;\n\n async function ensureLockTable(): Promise<void> {\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${lockTableName} (\n workflow_id TEXT PRIMARY KEY,\n owner_token TEXT NOT NULL,\n expires_at TIMESTAMPTZ NOT NULL\n );\n CREATE INDEX IF NOT EXISTS ${safeIndexName} ON ${lockTableName}(expires_at);\n `);\n }\n\n async function tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null> {\n const ttlMs = opts?.ttlMs ?? 60_000;\n const ownerToken = randomUUID();\n const expiresAt = new Date(Date.now() + ttlMs);\n\n await ensureLockTable();\n\n // Insert new row or update only if current row is expired (or missing).\n const result = await pool.query(\n `\n INSERT INTO ${lockTableName} (workflow_id, owner_token, expires_at)\n VALUES ($1, $2, $3)\n ON CONFLICT (workflow_id) DO UPDATE SET\n owner_token = EXCLUDED.owner_token,\n expires_at = EXCLUDED.expires_at\n WHERE ${lockTableName}.expires_at < NOW()\n RETURNING owner_token\n `,\n [id, ownerToken, expiresAt]\n );\n\n if (result.rowCount === 1 && result.rows[0].owner_token === ownerToken) {\n return { ownerToken };\n }\n return null;\n }\n\n async function release(id: string, ownerToken: string): Promise<void> {\n await pool.query(\n `DELETE FROM ${lockTableName} WHERE workflow_id = $1 AND owner_token = $2`,\n [id, ownerToken]\n );\n }\n\n return { tryAcquire, release, ensureLockTable };\n}\n"],"mappings":"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","names":["PgPool","PgPool","PostgresKeyValueStore","options","error","pattern","key","query","result","value","expiresAt","likePattern","row","limit","offset","orderBy","orderDir","conditions","args","paramIndex","whereClause","orderNulls","listQuery","listArgs","keys","total","countResult","randomUUID","createPostgresLock","pool","options","lockTableName","safeIndexName","ensureLockTable","tryAcquire","id","opts","ttlMs","ownerToken","expiresAt","result","release","createStatePersistence","createPostgresPersistence","options","prefix","lockOptions","storeOptions","stripPrefix","key","effectivePrefix","prefixKey","runId","addListPageAndDeleteMany","statePersistence","store","keys","total","ids","limit","nextOffset","pool","PgPool","PostgresKeyValueStore","lock","createPostgresLock","base"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/postgres-lock.ts"],"sourcesContent":["/*\n awaitly-postgres\n \n PostgreSQL persistence adapter for awaitly workflows.\n * Provides ready-to-use SnapshotStore backed by PostgreSQL.\n /\n\nimport { Pool as PgPool } from \"pg\";\nimport type { WorkflowSnapshot, SnapshotStore } from \"awaitly/persistence\";\nimport type { WorkflowLock } from \"awaitly/durable\";\nimport { createPostgresLock, type PostgresLockOptions } from \"./postgres-lock\";\n\n// Re-export types for convenience\nexport type { SnapshotStore, WorkflowSnapshot } from \"awaitly/persistence\";\nexport type { WorkflowLock } from \"awaitly/durable\";\nexport type { PostgresLockOptions } from \"./postgres-lock\";\n\n// =============================================================================\n// PostgresOptions\n// =============================================================================\n\n/\n Options for the postgres() shorthand function.\n /\nexport interface PostgresOptions {\n /* PostgreSQL connection URL. /\n url: string;\n /* Table name for snapshots. @default 'awaitly_snapshots' /\n table?: string;\n /* Key prefix for IDs. @default '' /\n prefix?: string;\n /* Bring your own pool. /\n pool?: PgPool;\n /* Auto-create table on first use. @default true /\n autoCreateTable?: boolean;\n /* Cross-process lock options. When set, the store implements WorkflowLock. /\n lock?: PostgresLockOptions;\n}\n\n// =============================================================================\n// postgres() - One-liner Snapshot Store Setup\n// =============================================================================\n\nconst SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]$/;\n\n/*\n Create a snapshot store backed by PostgreSQL.\n * This is the simplified one-liner API for workflow persistence.\n \n @example\n * ```typescript\n * import { postgres } from 'awaitly-postgres';\n \n // One-liner setup\n * const store = postgres('postgresql://localhost/mydb');\n \n // Execute + persist\n * const wf = createWorkflow(deps);\n * await wf(myWorkflowFn);\n * await store.save('wf-123', wf.getSnapshot());\n \n // Restore\n * const snapshot = await store.load('wf-123');\n * const wf2 = createWorkflow(deps, { snapshot });\n * await wf2(myWorkflowFn);\n * ```\n \n @example\n * ```typescript\n * // With options including cross-process locking\n * const store = postgres({\n * url: 'postgresql://localhost/mydb',\n * table: 'my_workflow_snapshots',\n * prefix: 'orders:',\n * lock: { lockTableName: 'my_workflow_locks' },\n * });\n * ```\n /\nexport function postgres(urlOrOptions: string \| PostgresOptions): SnapshotStore & Partial<WorkflowLock> {\n const opts = typeof urlOrOptions === \"string\" ? { url: urlOrOptions } : urlOrOptions;\n const tableName = opts.table ?? \"awaitly_snapshots\";\n\n if (!SAFE_TABLE_NAME.test(tableName)) {\n throw new Error(`Invalid table name: ${tableName}. Must be alphanumeric with underscores.`);\n }\n\n const prefix = opts.prefix ?? \"\";\n const autoCreateTable = opts.autoCreateTable ?? true;\n\n // Create or use existing pool\n const ownPool = !opts.pool;\n const pool = opts.pool ?? new PgPool({ connectionString: opts.url });\n let tableCreated = false;\n\n const ensureTable = async (): Promise<void> => {\n if (!autoCreateTable \|\| tableCreated) return;\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${tableName} (\n id TEXT PRIMARY KEY,\n snapshot JSONB NOT NULL,\n updated_at TIMESTAMPTZ DEFAULT NOW()\n )\n `);\n await pool.query(`\n CREATE INDEX IF NOT EXISTS ${tableName}_updated_at_idx ON ${tableName} (updated_at DESC)\n `);\n tableCreated = true;\n };\n\n // Create lock if requested\n const lock = opts.lock ? createPostgresLock(pool, opts.lock) : null;\n\n const store: SnapshotStore & Partial<WorkflowLock> = {\n async save(id: string, snapshot: WorkflowSnapshot): Promise<void> {\n await ensureTable();\n const fullId = prefix + id;\n await pool.query(\n `INSERT INTO ${tableName} (id, snapshot, updated_at)\n VALUES ($1, $2, NOW())\n ON CONFLICT (id) DO UPDATE SET snapshot = $2, updated_at = NOW()`,\n [fullId, JSON.stringify(snapshot)]\n );\n },\n\n async load(id: string): Promise<WorkflowSnapshot \| null> {\n await ensureTable();\n const fullId = prefix + id;\n const result = await pool.query(\n `SELECT snapshot FROM ${tableName} WHERE id = $1`,\n [fullId]\n );\n if (result.rows.length === 0) return null;\n return result.rows[0].snapshot as WorkflowSnapshot;\n },\n\n async delete(id: string): Promise<void> {\n await ensureTable();\n const fullId = prefix + id;\n await pool.query(`DELETE FROM ${tableName} WHERE id = $1`, [fullId]);\n },\n\n async list(options?: { prefix?: string; limit?: number }): Promise<Array<{ id: string; updatedAt: string }>> {\n await ensureTable();\n const filterPrefix = prefix + (options?.prefix ?? \"\");\n const limit = options?.limit ?? 100;\n\n const result = await pool.query(\n `SELECT id, updated_at FROM ${tableName}\n WHERE id LIKE $1\n ORDER BY updated_at DESC\n LIMIT $2`,\n [filterPrefix + \"%\", limit]\n );\n\n return result.rows.map(row => ({\n id: (row.id as string).slice(prefix.length),\n updatedAt: (row.updated_at as Date).toISOString(),\n }));\n },\n\n async close(): Promise<void> {\n // Only end pool if we created it\n if (ownPool) {\n await pool.end();\n }\n },\n };\n\n // Add lock methods if lock is configured\n if (lock) {\n store.tryAcquire = lock.tryAcquire.bind(lock);\n store.release = lock.release.bind(lock);\n }\n\n return store;\n}\n","/\n PostgreSQL workflow lock (lease) for cross-process concurrency control.\n * Uses a lease (TTL) + owner token; release verifies the token.\n /\n\nimport type { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface PostgresLockOptions {\n /\n Table name for workflow locks.\n * @default 'awaitly_workflow_lock'\n /\n lockTableName?: string;\n}\n\n/\n Create tryAcquire and release functions that use a PostgreSQL lock table.\n * Caller must pass the same pool used for state (so one connection pool).\n */\nexport function createPostgresLock(\n pool: Pool,\n options: PostgresLockOptions = {}\n): {\n tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null>;\n release(id: string, ownerToken: string): Promise<void>;\n ensureLockTable(): Promise<void>;\n} {\n const lockTableName = options.lockTableName ?? \"awaitly_workflow_lock\";\n\n const safeIndexName = `idx_${lockTableName.replace(/[^a-zA-Z0-9_]/g, \"_\")}_expires_at`;\n\n async function ensureLockTable(): Promise<void> {\n await pool.query(`\n CREATE TABLE IF NOT EXISTS ${lockTableName} (\n workflow_id TEXT PRIMARY KEY,\n owner_token TEXT NOT NULL,\n expires_at TIMESTAMPTZ NOT NULL\n );\n CREATE INDEX IF NOT EXISTS ${safeIndexName} ON ${lockTableName}(expires_at);\n `);\n }\n\n async function tryAcquire(\n id: string,\n opts?: { ttlMs?: number }\n ): Promise<{ ownerToken: string } \| null> {\n const ttlMs = opts?.ttlMs ?? 60_000;\n const ownerToken = randomUUID();\n const expiresAt = new Date(Date.now() + ttlMs);\n\n await ensureLockTable();\n\n // Insert new row or update only if current row is expired (or missing).\n const result = await pool.query(\n `\n INSERT INTO ${lockTableName} (workflow_id, owner_token, expires_at)\n VALUES ($1, $2, $3)\n ON CONFLICT (workflow_id) DO UPDATE SET\n owner_token = EXCLUDED.owner_token,\n expires_at = EXCLUDED.expires_at\n WHERE ${lockTableName}.expires_at < NOW()\n RETURNING owner_token\n `,\n [id, ownerToken, expiresAt]\n );\n\n if (result.rowCount === 1 && result.rows[0].owner_token === ownerToken) {\n return { ownerToken };\n }\n return null;\n }\n\n async function release(id: string, ownerToken: string): Promise<void> {\n await pool.query(\n `DELETE FROM ${lockTableName} WHERE workflow_id = $1 AND owner_token = $2`,\n [id, ownerToken]\n );\n }\n\n return { tryAcquire, release, ensureLockTable };\n}\n"],"mappings":"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","names":["PgPool","randomUUID","createPostgresLock","pool","options","lockTableName","safeIndexName","ensureLockTable","tryAcquire","id","opts","ttlMs","ownerToken","expiresAt","result","release","SAFE_TABLE_NAME","postgres","urlOrOptions","opts","tableName","prefix","autoCreateTable","ownPool","pool","PgPool","tableCreated","ensureTable","lock","createPostgresLock","store","id","snapshot","fullId","result","options","filterPrefix","limit","row"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "awaitly-postgres",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "type": "module",
   "description": "PostgreSQL persistence adapter for awaitly workflows",
   "main": "./dist/index.cjs",
@@ -38,20 +38,20 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "awaitly": "^1.13.0"
+    "awaitly": "^1.14.0"
   },
   "dependencies": {
-    "pg": "^8.17.2"
+    "pg": "^8.18.0"
   },
   "devDependencies": {
     "@total-typescript/ts-reset": "^0.6.1",
     "@total-typescript/tsconfig": "^1.0.4",
-    "@types/node": "^25.1.0",
+    "@types/node": "^25.2.0",
     "@types/pg": "^8.16.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "awaitly": "^1.13.0"
+    "awaitly": "^1.14.0"
   },
   "publishConfig": {
     "access": "public",