@siglo/postgres 0.0.0-stage → 1.0.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,260 @@
-# Temporary Holding Version
+# @siglo/postgres Adapter Guide
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@siglo/postgres` provides an enterprise ACID-compliant persistence adapter for `Siglo` workflows using PostgreSQL. It offers durable execution checkpointing, immutable context mutation audit event logging, automated table initialization, schema indexing, retention policy cleanup, and distributed atomic idempotency claim locking.
+
+---
+
+## 1. Overview & Architecture
+
+When workflows coordinate mission-critical financial, compliance, or enterprise transactions, state persistence must survive node failures and network partitions:
+
+```mermaid
+flowchart TD
+    Engine["Siglo Engine"]
+
+    subgraph Adapters["@siglo/postgres"]
+        direction LR
+        SA["PostgresStorageAdapter<br/>• saveCheckpoint()<br/>• getCheckpoint()<br/>• onContextChange()<br/>• cleanupOldCheckpoints()"]
+        IS["PostgresIdempotencyStore<br/>• claim()<br/>• complete()<br/>• fail()<br/>• cleanupExpired()"]
+    end
+
+    subgraph DB["PostgreSQL Database"]
+        direction LR
+        T1["siglo_checkpoints<br/>• stack_id (PK)<br/>• namespace<br/>• state (JSONB)<br/>• created_at / updated"]
+        T2["siglo_context_events<br/>• id (BIGSERIAL PK)<br/>• stack_id, step_id<br/>• namespace, field<br/>• value (JSONB), created_at"]
+        T3["siglo_idempotency<br/>• key (VARCHAR(512) PK)<br/>• status, result (JSONB)<br/>• expires_at, created_at"]
+    end
+
+    Engine --> SA
+    Engine --> IS
+    SA --> T1
+    SA --> T2
+    IS --> T3
+```
+
+---
+
+## 2. Installation & Requirements
+
+Install `@siglo/postgres` and `pg`:
+
+```bash
+npm install @siglo/core @siglo/postgres pg
+npm install --save-dev @types/pg
+```
+
+Peer dependency matrix:
+- `Siglo`: `*` (v1.0.0+)
+- `pg`: `^8.0.0`
+
+---
+
+## 3. Database Schema
+
+Both `PostgresStorageAdapter` and `PostgresIdempotencyStore` support automated table creation via `ensureTables()` / `ensureTable()`.
+
+### DDL Definitions:
+
+```sql
+-- 1. Checkpoint Storage Table
+CREATE TABLE IF NOT EXISTS siglo_checkpoints (
+    stack_id VARCHAR(255) PRIMARY KEY,
+    namespace VARCHAR(255),
+    state JSONB NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_siglo_checkpoints_namespace ON siglo_checkpoints(namespace);
+
+-- 2. Context Mutation Audit Log
+CREATE TABLE IF NOT EXISTS siglo_context_events (
+    id BIGSERIAL PRIMARY KEY,
+    stack_id VARCHAR(255) NOT NULL,
+    step_id VARCHAR(255) NOT NULL,
+    namespace VARCHAR(255),
+    field VARCHAR(255) NOT NULL,
+    value JSONB,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_siglo_context_events_stack ON siglo_context_events(stack_id);
+
+-- 3. Distributed Idempotency Table
+CREATE TABLE IF NOT EXISTS siglo_idempotency (
+    key VARCHAR(512) PRIMARY KEY,
+    status VARCHAR(50) NOT NULL,
+    result JSONB,
+    expires_at TIMESTAMPTZ NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_siglo_idempotency_expires ON siglo_idempotency(expires_at);
+```
+
+---
+
+## 4. `PostgresStorageAdapter` API Reference
+
+Implements the standard `StorageAdapter` interface.
+
+```typescript
+import { PostgresStorageAdapter } from '@siglo/postgres';
+```
+
+### Constructor Options (`PostgresStorageAdapterOptions`)
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `client` | `PostgresClientInterface \| Pool` | *Required* | Active PostgreSQL `Pool` or `Client` instance. |
+| `checkpointsTable` | `string` | `'siglo_checkpoints'` | Name of checkpoints table. Must match `/^[a-zA-Z_][a-zA-Z0-9_]*$/` (up to 63 chars) for SQL injection protection. |
+| `eventsTable` | `string` | `'siglo_context_events'` | Name of context change audit table. Must match `/^[a-zA-Z_][a-zA-Z0-9_]*$/` (up to 63 chars) for SQL injection protection. |
+| `recordContextChanges` | `boolean` | `true` | If `true`, writes all step context mutations into `eventsTable`. |
+
+### Methods
+
+#### `ensureTables(): Promise<void>`
+Executes DDL statements to create tables and indexes if they do not already exist.
+
+#### `saveCheckpoint(checkpoint: SerializedExecutionStack): Promise<void>`
+Upserts a serialized execution stack by `stackId`, updating the `state` JSONB and `updated_at` timestamp.
+
+#### `getCheckpoint(stackId: string): Promise<SerializedExecutionStack | undefined>`
+Fetches the checkpoint by `stackId`. Returns `undefined` if no checkpoint is found.
+
+#### `onContextChange(entry): Promise<void>`
+Streams a field modification into `siglo_context_events` with step ID, field name, JSONB value, and high-resolution timestamp.
+
+#### `cleanupOldCheckpoints(retentionDays?: number): Promise<number>`
+Deletes checkpoints older than `retentionDays` (default `30` days). Returns the count of deleted rows.
+
+#### `cleanupOldEvents(retentionDays?: number): Promise<number>`
+Deletes audit records older than `retentionDays` (default `30` days). Returns the count of deleted rows.
+
+---
+
+## 5. `PostgresIdempotencyStore` API Reference
+
+Implements the standard `IdempotencyStore` interface.
+
+```typescript
+import { PostgresIdempotencyStore } from '@siglo/postgres';
+```
+
+### Constructor Options (`PostgresIdempotencyOptions`)
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `client` | `PostgresClientInterface \| Pool` | *Required* | Active PostgreSQL `Pool` or `Client` instance. |
+| `tableName` | `string` | `'siglo_idempotency'` | Name of idempotency table. Must match `/^[a-zA-Z_][a-zA-Z0-9_]*$/` (up to 63 chars) for SQL injection protection. |
+| `defaultTtlMs` | `number` | `86400000` (24h) | Fallback expiration TTL in milliseconds. |
+
+### Methods
+
+#### `ensureTable(): Promise<void>`
+Initializes the idempotency schema and expiration index.
+
+#### `claim(key: string, ttlMs?: number): Promise<'claimed' | 'completed' | 'in-progress'>`
+Atomically attempts to insert an `'in-progress'` record. If the key exists:
+- If expired, reclaims the lock and returns `'claimed'`.
+- If completed, returns `'completed'`.
+- If currently running, returns `'in-progress'`.
+
+#### `complete(key: string, result: unknown, ttlMs?: number): Promise<void>`
+Transitions key status to `'completed'`, serializes the result into JSONB, and sets expiration.
+
+#### `fail(key: string, error: unknown): Promise<void>`
+Deletes in-progress claims so subsequent retries can proceed.
+
+#### `getResult(key: string): Promise<unknown | undefined>`
+Retrieves the stored JSONB result for completed keys.
+
+#### `cleanupExpired(): Promise<number>`
+Prunes expired idempotency records (`WHERE expires_at < NOW()`).
+
+---
+
+## 6. Complete Production Example
+
+```typescript
+import { Pool } from 'pg';
+import { Step, flow } from '@siglo/core';
+import { PostgresStorageAdapter, PostgresIdempotencyStore } from '@siglo/postgres';
+
+// 1. Initialize PostgreSQL Connection Pool
+const pool = new Pool({
+    connectionString: process.env.DATABASE_URL || 'postgresql://postgres:postgres@localhost:5432/orders_db',
+    max: 20,
+    idleTimeoutMillis: 30000,
+});
+
+// 2. Initialize and Register Storage Adapter
+const storageAdapter = new PostgresStorageAdapter({
+    client: pool,
+    recordContextChanges: true,
+});
+await storageAdapter.ensureTables();
+Step.useStorage(storageAdapter);
+
+// 3. Initialize Idempotency Store
+const idempotencyStore = new PostgresIdempotencyStore({
+    client: pool,
+    defaultTtlMs: 86400000, // 24 hours
+});
+await idempotencyStore.ensureTable();
+
+// 4. Define Payment Settlement Workflow
+interface SettlementInput {
+    settlementId: string;
+    accountId: string;
+    amount: number;
+}
+
+const debitSender = Step.create('debitSender', async (param: SettlementInput) => {
+    // Perform database debit operation within pool
+    return { debitReference: `dr_${param.settlementId}`, debited: true };
+});
+
+const creditReceiver = Step.create('creditReceiver', async (param: any) => {
+    // Perform receiver credit
+    return { creditReference: `cr_${param.settlementId}`, credited: true };
+});
+
+const settlementFlow = flow(debitSender, creditReceiver);
+
+// 5. Execute with Distributed Idempotency Guard
+async function runIdempotentSettlement(input: SettlementInput) {
+    const idempKey = `settle:${input.settlementId}`;
+    const claimStatus = await idempotencyStore.claim(idempKey, 30000); // 30s claim lock
+
+    if (claimStatus === 'completed') {
+        console.log('Settlement already processed. Returning cached result.');
+        return await idempotencyStore.getResult(idempKey);
+    }
+
+    if (claimStatus === 'in-progress') {
+        throw new Error(`Settlement ${input.settlementId} is already running concurrently.`);
+    }
+
+    try {
+        const result = await settlementFlow.run(input, {
+            namespace: 'finance-prod',
+        });
+        const clean = {
+            settlementId: input.settlementId,
+            debitReference: result.debitReference(),
+            creditReference: result.creditReference(),
+        };
+        await idempotencyStore.complete(idempKey, clean);
+        return clean;
+    } catch (err) {
+        await idempotencyStore.fail(idempKey, err);
+        throw err;
+    }
+}
+
+// 6. Maintenance Routine: Automated Data Retention
+async function runRetentionCleanup() {
+    const prunedCheckpoints = await storageAdapter.cleanupOldCheckpoints(14); // Retain 14 days
+    const prunedEvents = await storageAdapter.cleanupOldEvents(30);           // Retain 30 days
+    const prunedIdemp = await idempotencyStore.cleanupExpired();
+    console.log(`Pruned: ${prunedCheckpoints} checkpoints, ${prunedEvents} events, ${prunedIdemp} idemp keys`);
+}
+```

package/dist/adapter.d.ts

@@ -0,0 +1,47 @@
+import { StorageAdapter, SerializedExecutionStack } from '@siglo/core';
+import { PostgresStorageAdapterOptions } from './types';
+export declare class PostgresStorageAdapter implements StorageAdapter {
+    readonly name = "postgres";
+    private baseClient;
+    private scope;
+    private directClientBusy;
+    private get client();
+    private checkpointsTable;
+    private eventsTable;
+    private waitRecordsTable;
+    private recordContextChanges;
+    constructor(options: PostgresStorageAdapterOptions);
+    /**
+     * Initializes the necessary PostgreSQL schema and tables if they do not exist.
+     */
+    ensureTables(): Promise<void>;
+    private trackWrite;
+    saveCheckpoint(checkpoint: SerializedExecutionStack, expectedVersion?: number): Promise<void>;
+    private persistCheckpoint;
+    getCheckpoint(stackId: string): Promise<SerializedExecutionStack | undefined>;
+    onContextChange(entry: {
+        namespace?: string;
+        stackId: string;
+        stepId: string;
+        field: string;
+        value: any;
+        timestamp: number;
+    }): Promise<void>;
+    cleanExpiredCheckpoints(): Promise<number>;
+    saveWaitRecord(record: any): Promise<void>;
+    private persistWaitRecord;
+    /** A database-session lock serializes continuation and compensation. Process death releases it. */
+    withWorkflowLock<T>(stackId: string, action: () => Promise<T>): Promise<T>;
+    cancelWaitRecord(correlationKey: string): Promise<void>;
+    cancelWorkflow(stackId: string): Promise<void>;
+    completeWaitRecord(correlationKey: string, claimantId: string): Promise<void>;
+    claimWaitRecord(correlationKey: string, claimantId?: string, options?: {
+        allowExpired?: boolean;
+        eventPayload?: any;
+    }): Promise<any>;
+    getWaitRecord(correlationKeyOrStackId: string): Promise<any | undefined>;
+    cleanupOldCheckpoints(retentionDays?: number): Promise<number>;
+    cleanupOldEvents(retentionDays?: number): Promise<number>;
+    cleanupOldWaitRecords(retentionDays?: number): Promise<number>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAA0E,MAAM,aAAa,CAAC;AAC/I,OAAO,EAAE,6BAA6B,EAA2B,MAAM,SAAS,CAAC;AASjF,qBAAa,sBAAuB,YAAW,cAAc;IACzD,SAAgB,IAAI,cAAc;IAClC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,KAAK,CAA0H;IACvI,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,KAAK,MAAM,GAAuH;IACzI,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAU;gBAE1B,OAAO,EAAE,6BAA6B;IAWlD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CnC,OAAO,CAAC,UAAU;IASlB,cAAc,CAAC,UAAU,EAAE,wBAAwB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI/E,iBAAiB;IA8EzB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAqB7E,eAAe,CAAC,KAAK,EAAE;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,GAAG,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBX,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAShD,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAI5B,iBAAiB;IAgD/B,mGAAmG;IAC7F,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyB1E,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAuC9I,aAAa,CAAC,uBAAuB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IA2CxE,qBAAqB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,gBAAgB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ7D,qBAAqB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAO3E"}

package/dist/adapter.js

@@ -0,0 +1,380 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresStorageAdapter = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const core_1 = require("@siglo/core");
+function validateIdentifier(name, paramName) {
+    if (!name || typeof name !== 'string' || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name) || name.length > 63) {
+        throw new Error(`Invalid SQL identifier for ${paramName}: "${name}". Must be 1-63 alphanumeric characters or underscores, starting with a letter or underscore.`);
+    }
+    return name;
+}
+class PostgresStorageAdapter {
+    name = 'postgres';
+    baseClient;
+    scope = new node_async_hooks_1.AsyncLocalStorage();
+    directClientBusy = false;
+    get client() { return this.scope.getStore()?.active ? this.scope.getStore().client : this.baseClient; }
+    checkpointsTable;
+    eventsTable;
+    waitRecordsTable;
+    recordContextChanges;
+    constructor(options) {
+        if (!options || !options.client) {
+            throw new Error('PostgresStorageAdapter requires a valid Postgres client or pool instance.');
+        }
+        this.baseClient = options.client;
+        this.checkpointsTable = validateIdentifier(options.checkpointsTable || 'siglo_checkpoints', 'checkpointsTable');
+        this.eventsTable = validateIdentifier(options.eventsTable || 'siglo_context_events', 'eventsTable');
+        this.waitRecordsTable = validateIdentifier(options.waitRecordsTable || 'siglo_wait_records', 'waitRecordsTable');
+        this.recordContextChanges = options.recordContextChanges ?? true;
+    }
+    /**
+     * Initializes the necessary PostgreSQL schema and tables if they do not exist.
+     */
+    async ensureTables() {
+        await this.client.query(`
+            CREATE TABLE IF NOT EXISTS ${this.checkpointsTable} (
+                stack_id VARCHAR(255) PRIMARY KEY,
+                namespace VARCHAR(255),
+                state JSONB NOT NULL,
+                version BIGINT NOT NULL DEFAULT 1,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            );
+            ALTER TABLE ${this.checkpointsTable} ADD COLUMN IF NOT EXISTS version BIGINT NOT NULL DEFAULT 1;
+            CREATE INDEX IF NOT EXISTS idx_${this.checkpointsTable}_namespace ON ${this.checkpointsTable}(namespace);
+
+            CREATE TABLE IF NOT EXISTS ${this.eventsTable} (
+                id BIGSERIAL PRIMARY KEY,
+                stack_id VARCHAR(255) NOT NULL,
+                step_id VARCHAR(255) NOT NULL,
+                namespace VARCHAR(255),
+                field VARCHAR(255) NOT NULL,
+                value JSONB,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            );
+            CREATE INDEX IF NOT EXISTS idx_${this.eventsTable}_stack ON ${this.eventsTable}(stack_id);
+
+            CREATE TABLE IF NOT EXISTS ${this.waitRecordsTable} (
+                correlation_key VARCHAR(255) PRIMARY KEY,
+                stack_id VARCHAR(255) NOT NULL,
+                namespace VARCHAR(255),
+                event_name VARCHAR(255),
+                status VARCHAR(50) NOT NULL DEFAULT 'WAITING',
+                continuation_step_index INT NOT NULL DEFAULT 0,
+                version VARCHAR(50),
+                data JSONB,
+                resumed_by VARCHAR(255),
+                resumed_at TIMESTAMPTZ,
+                expires_at TIMESTAMPTZ,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            );
+            ALTER TABLE ${this.waitRecordsTable} ADD COLUMN IF NOT EXISTS resume_payload JSONB;
+            ALTER TABLE ${this.waitRecordsTable} ADD COLUMN IF NOT EXISTS locked_by TEXT;
+            ALTER TABLE ${this.waitRecordsTable} ADD COLUMN IF NOT EXISTS locked_at TIMESTAMPTZ;
+            CREATE INDEX IF NOT EXISTS idx_${this.waitRecordsTable}_stack ON ${this.waitRecordsTable}(stack_id);
+            CREATE INDEX IF NOT EXISTS idx_${this.waitRecordsTable}_status ON ${this.waitRecordsTable}(status);
+        `);
+    }
+    trackWrite(action) {
+        const scope = this.scope.getStore();
+        if (!scope?.active)
+            return action();
+        const pending = scope.tail.then(action);
+        scope.tail = pending;
+        pending.catch(() => { });
+        return pending;
+    }
+    saveCheckpoint(checkpoint, expectedVersion) {
+        return this.trackWrite(() => this.persistCheckpoint(checkpoint, expectedVersion));
+    }
+    async persistCheckpoint(checkpoint, expectedVersion) {
+        if (!checkpoint || !checkpoint.stackId) {
+            return;
+        }
+        const stateJson = JSON.stringify(checkpoint);
+        const namespace = checkpoint.namespace || null;
+        const versionToExpect = expectedVersion !== undefined
+            ? expectedVersion
+            : (checkpoint.occVersion !== undefined ? checkpoint.occVersion : undefined);
+        if (versionToExpect !== undefined) {
+            const updateRes = await this.client.query(`UPDATE ${this.checkpointsTable}
+                 SET state = CASE WHEN state->>'status' = 'cancelled' THEN jsonb_set($1::jsonb, '{status}', '"cancelled"') ELSE $1::jsonb END, namespace = $2, version = version + 1, updated_at = NOW()
+                 WHERE stack_id = $3 AND version = $4
+                 RETURNING version`, [stateJson, namespace, checkpoint.stackId, versionToExpect]);
+            if ((updateRes.rowCount || 0) === 0) {
+                const existingRes = await this.client.query(`SELECT version FROM ${this.checkpointsTable} WHERE stack_id = $1`, [checkpoint.stackId]);
+                const currentVersion = existingRes.rows && existingRes.rows.length > 0
+                    ? Number(existingRes.rows[0].version)
+                    : undefined;
+                throw new core_1.OptimisticLockException(checkpoint.stackId, currentVersion, versionToExpect);
+            }
+            if (updateRes.rows && updateRes.rows.length > 0) {
+                checkpoint.occVersion = Number(updateRes.rows[0].version);
+                checkpoint.revision = checkpoint.occVersion;
+            }
+            return;
+        }
+        const insertRes = await this.client.query(`INSERT INTO ${this.checkpointsTable} (stack_id, namespace, state, version, updated_at)
+             VALUES ($1, $2, $3::jsonb, 1, NOW())
+             ON CONFLICT (stack_id) DO NOTHING`, [checkpoint.stackId, namespace, stateJson]);
+        if ((insertRes.rowCount || 0) > 0) {
+            checkpoint.occVersion = 1;
+            checkpoint.revision = 1;
+            return;
+        }
+        const existingRes = await this.client.query(`SELECT version FROM ${this.checkpointsTable} WHERE stack_id = $1`, [checkpoint.stackId]);
+        if (existingRes.rows && existingRes.rows.length > 0) {
+            const curr = Number(existingRes.rows[0].version);
+            const updateRes = await this.client.query(`UPDATE ${this.checkpointsTable}
+                 SET state = CASE WHEN state->>'status' = 'cancelled' THEN jsonb_set($1::jsonb, '{status}', '"cancelled"') ELSE $1::jsonb END, namespace = $2, version = version + 1, updated_at = NOW()
+                 WHERE stack_id = $3 AND version = $4
+                 RETURNING version`, [stateJson, namespace, checkpoint.stackId, curr]);
+            if ((updateRes.rowCount || 0) === 0) {
+                const refreshed = await this.client.query(`SELECT version FROM ${this.checkpointsTable} WHERE stack_id = $1`, [checkpoint.stackId]);
+                const actual = refreshed.rows && refreshed.rows.length > 0 ? Number(refreshed.rows[0].version) : undefined;
+                throw new core_1.OptimisticLockException(checkpoint.stackId, actual, curr);
+            }
+            if (updateRes.rows && updateRes.rows.length > 0) {
+                checkpoint.occVersion = Number(updateRes.rows[0].version);
+                checkpoint.revision = checkpoint.occVersion;
+            }
+        }
+    }
+    async getCheckpoint(stackId) {
+        if (!stackId) {
+            return undefined;
+        }
+        const res = await this.client.query(`SELECT state, version FROM ${this.checkpointsTable} WHERE stack_id = $1`, [stackId]);
+        if (!res.rows || res.rows.length === 0) {
+            return undefined;
+        }
+        const row = res.rows[0];
+        const rowState = row.state;
+        const checkpoint = typeof rowState === 'string' ? JSON.parse(rowState) : rowState;
+        if (checkpoint && row.version !== undefined) {
+            checkpoint.occVersion = Number(row.version);
+            checkpoint.revision = Number(row.version);
+        }
+        return checkpoint;
+    }
+    async onContextChange(entry) {
+        if (!this.recordContextChanges) {
+            return;
+        }
+        try {
+            const valJson = typeof entry.value === 'object' && entry.value !== null
+                ? JSON.stringify(entry.value)
+                : JSON.stringify({ value: entry.value });
+            await this.client.query(`INSERT INTO ${this.eventsTable} (stack_id, step_id, namespace, field, value, created_at)
+                 VALUES ($1, $2, $3, $4, $5::jsonb, to_timestamp($6 / 1000.0))`, [entry.stackId, entry.stepId, entry.namespace || null, entry.field, valJson, entry.timestamp]);
+        }
+        catch {
+            // Non-blocking telemetry stream
+        }
+    }
+    async cleanExpiredCheckpoints() {
+        const res = await this.client.query(`DELETE FROM ${this.checkpointsTable} 
+             WHERE (state->>'expiresAt') IS NOT NULL 
+               AND (state->>'expiresAt')::bigint <= (EXTRACT(EPOCH FROM NOW()) * 1000)::bigint`);
+        return res.rowCount || 0;
+    }
+    saveWaitRecord(record) {
+        return this.trackWrite(() => this.persistWaitRecord(record));
+    }
+    async persistWaitRecord(record) {
+        if (!record || (!record.correlationKey && !record.stackId)) {
+            return;
+        }
+        const corrKey = record.correlationKey || record.stackId;
+        const stackId = record.stackId || record.correlationKey;
+        const dataJson = record.data ? JSON.stringify(record.data) : null;
+        const expiresAt = record.expiresAt ? new Date(record.expiresAt) : null;
+        const status = (record.status || 'WAITING').toUpperCase();
+        await this.client.query(`INSERT INTO ${this.waitRecordsTable} 
+             (correlation_key, stack_id, namespace, event_name, status, continuation_step_index, version, data, expires_at, created_at, updated_at)
+             VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9, NOW(), NOW())
+             ON CONFLICT (correlation_key)
+             DO UPDATE SET 
+                 stack_id = EXCLUDED.stack_id,
+                 namespace = EXCLUDED.namespace,
+                 event_name = EXCLUDED.event_name,
+                 status = EXCLUDED.status,
+                 continuation_step_index = EXCLUDED.continuation_step_index,
+                 version = EXCLUDED.version,
+                 data = EXCLUDED.data,
+                 expires_at = EXCLUDED.expires_at,
+                 updated_at = NOW()
+             WHERE ${this.waitRecordsTable}.status = 'WAITING' AND ${this.waitRecordsTable}.stack_id = EXCLUDED.stack_id`, [
+            corrKey,
+            stackId,
+            record.namespace || null,
+            record.eventName || null,
+            status,
+            record.continuationStepIndex || 0,
+            record.version !== undefined ? String(record.version) : null,
+            dataJson,
+            expiresAt
+        ]);
+        if (stackId) {
+            const cp = await this.getCheckpoint(stackId);
+            if (cp) {
+                cp.metadata = { ...(cp.metadata || {}), waitRecord: record };
+                await this.persistCheckpoint(cp);
+            }
+        }
+    }
+    /** A database-session lock serializes continuation and compensation. Process death releases it. */
+    async withWorkflowLock(stackId, action) {
+        if (this.scope.getStore()?.active && this.scope.getStore()?.stackId === stackId)
+            return action();
+        const pool = this.baseClient;
+        const pooled = 'totalCount' in pool;
+        if (!pooled && this.directClientBusy)
+            throw new core_1.DuplicateEventException(stackId);
+        if (!pooled)
+            this.directClientBusy = true;
+        let client;
+        let locked = false;
+        try {
+            client = pooled ? await pool.connect() : pool;
+            const result = await client.query('SELECT pg_try_advisory_lock(hashtextextended($1, 0)) AS locked', [`siglo:workflow:${stackId}`]);
+            locked = result.rows[0]?.locked === true;
+            if (!locked)
+                throw new core_1.DuplicateEventException(stackId);
+            const scope = { stackId, client, tail: Promise.resolve(), active: true };
+            return await this.scope.run(scope, async () => {
+                try {
+                    return await action();
+                }
+                finally {
+                    try {
+                        await scope.tail;
+                    }
+                    finally {
+                        scope.active = false;
+                    }
+                }
+            });
+        }
+        finally {
+            try {
+                if (locked)
+                    await client.query('SELECT pg_advisory_unlock(hashtextextended($1, 0))', [`siglo:workflow:${stackId}`]);
+            }
+            catch (error) {
+                if (pooled) {
+                    client?.release(error);
+                    client = undefined;
+                }
+                throw error;
+            }
+            finally {
+                if (pooled)
+                    client?.release();
+                else
+                    this.directClientBusy = false;
+            }
+        }
+    }
+    async cancelWaitRecord(correlationKey) {
+        await this.client.query(`UPDATE ${this.waitRecordsTable} SET status = 'CANCELLED', updated_at = NOW() WHERE correlation_key = $1`, [correlationKey]);
+    }
+    async cancelWorkflow(stackId) {
+        // Drain earlier checkpoint/wait writes before setting the cancellation barrier.
+        await this.scope.getStore()?.tail;
+        await this.client.query(`UPDATE ${this.waitRecordsTable} SET status = 'CANCELLED', updated_at = NOW() WHERE stack_id = $1`, [stackId]);
+        await this.client.query(`UPDATE ${this.checkpointsTable} SET state = jsonb_set(state, '{status}', '"cancelled"'), version = version + 1 WHERE stack_id = $1`, [stackId]);
+    }
+    async completeWaitRecord(correlationKey, claimantId) {
+        await this.scope.getStore()?.tail;
+        await this.client.query(`UPDATE ${this.waitRecordsTable} SET status = 'RESUMED', resumed_at = NOW(), resumed_by = $1, updated_at = NOW()
+            WHERE correlation_key = $2 AND status = 'RESUMING' AND locked_by = $1`, [claimantId, correlationKey]);
+    }
+    async claimWaitRecord(correlationKey, claimantId = 'worker', options) {
+        if (!correlationKey) {
+            throw new Error('claimWaitRecord requires a valid correlationKey.');
+        }
+        const res = await this.client.query(`UPDATE ${this.waitRecordsTable}
+             SET status = 'RESUMING', locked_at = NOW(), locked_by = $1,
+                 resume_payload = COALESCE(resume_payload, $3::jsonb), updated_at = NOW()
+             WHERE correlation_key = $2
+               AND (status = 'WAITING' OR (status = 'RESUMING' AND $5))
+               AND (resume_payload IS NOT NULL OR $4 OR expires_at IS NULL OR expires_at > NOW())
+             RETURNING *`, [claimantId, correlationKey, JSON.stringify(options?.eventPayload ?? {}), options?.allowExpired === true, this.scope.getStore()?.active === true]);
+        if (!res.rows || res.rows.length === 0) {
+            const record = await this.getWaitRecord(correlationKey);
+            if (record?.status === 'WAITING' && record.expiresAt !== undefined && record.expiresAt <= Date.now()) {
+                throw new core_1.ExpiredWaitException(correlationKey, record.expiresAt, record.eventName);
+            }
+            throw new core_1.DuplicateEventException(correlationKey);
+        }
+        const row = res.rows[0];
+        return {
+            stackId: row.stack_id,
+            correlationKey: row.correlation_key,
+            namespace: row.namespace,
+            eventName: row.event_name,
+            status: row.status,
+            continuationStepIndex: row.continuation_step_index !== undefined ? Number(row.continuation_step_index) : 0,
+            version: row.version,
+            data: typeof row.data === 'string' ? JSON.parse(row.data) : row.data,
+            resumePayload: typeof row.resume_payload === 'string' ? JSON.parse(row.resume_payload) : row.resume_payload,
+            expiresAt: row.expires_at ? new Date(row.expires_at).getTime() : undefined,
+            resumedBy: row.resumed_by,
+            resumedAt: row.resumed_at ? new Date(row.resumed_at).toISOString() : undefined,
+            createdAt: row.created_at ? new Date(row.created_at).getTime() : undefined
+        };
+    }
+    async getWaitRecord(correlationKeyOrStackId) {
+        if (!correlationKeyOrStackId) {
+            return undefined;
+        }
+        const res = await this.client.query(`SELECT * FROM ${this.waitRecordsTable} 
+             WHERE correlation_key = $1 OR stack_id = $1 LIMIT 1`, [correlationKeyOrStackId]);
+        if (res.rows && res.rows.length > 0) {
+            const row = res.rows[0];
+            return {
+                stackId: row.stack_id,
+                correlationKey: row.correlation_key,
+                namespace: row.namespace,
+                eventName: row.event_name,
+                status: row.status,
+                continuationStepIndex: row.continuation_step_index !== undefined ? Number(row.continuation_step_index) : 0,
+                version: row.version,
+                data: typeof row.data === 'string' ? JSON.parse(row.data) : row.data,
+                resumePayload: typeof row.resume_payload === 'string' ? JSON.parse(row.resume_payload) : row.resume_payload,
+                resumedBy: row.resumed_by,
+                resumedAt: row.resumed_at ? new Date(row.resumed_at).toISOString() : undefined,
+                expiresAt: row.expires_at ? new Date(row.expires_at).getTime() : undefined,
+                createdAt: row.created_at ? new Date(row.created_at).getTime() : undefined
+            };
+        }
+        const cpRes = await this.client.query(`SELECT state FROM ${this.checkpointsTable} 
+             WHERE stack_id = $1 
+                OR state->'metadata'->'waitRecord'->>'correlationKey' = $1 
+                OR state->'metadata'->'waitRecord'->>'stackId' = $1 LIMIT 1`, [correlationKeyOrStackId]);
+        if (!cpRes.rows || cpRes.rows.length === 0) {
+            return undefined;
+        }
+        const rowState = cpRes.rows[0].state;
+        const checkpoint = typeof rowState === 'string' ? JSON.parse(rowState) : rowState;
+        return checkpoint?.metadata?.waitRecord;
+    }
+    async cleanupOldCheckpoints(retentionDays = 30) {
+        const res = await this.client.query(`DELETE FROM ${this.checkpointsTable} WHERE updated_at < NOW() - make_interval(days => $1)`, [retentionDays]);
+        return res.rowCount || 0;
+    }
+    async cleanupOldEvents(retentionDays = 30) {
+        const res = await this.client.query(`DELETE FROM ${this.eventsTable} WHERE created_at < NOW() - make_interval(days => $1)`, [retentionDays]);
+        return res.rowCount || 0;
+    }
+    async cleanupOldWaitRecords(retentionDays = 30) {
+        const res = await this.client.query(`DELETE FROM ${this.waitRecordsTable} WHERE updated_at < NOW() - make_interval(days => $1)`, [retentionDays]);
+        return res.rowCount || 0;
+    }
+}
+exports.PostgresStorageAdapter = PostgresStorageAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/idempotency.d.ts

@@ -0,0 +1,17 @@
+import { IdempotencyStore } from '@siglo/core';
+import { PostgresIdempotencyOptions } from './types';
+export declare class PostgresIdempotencyStore implements IdempotencyStore {
+    private client;
+    private tableName;
+    private defaultTtlMs;
+    constructor(options: PostgresIdempotencyOptions);
+    ensureTable(): Promise<void>;
+    claim(key: string, ttlMs?: number): Promise<'claimed' | 'completed' | 'in-progress'>;
+    complete(key: string, result: unknown, ttlMs?: number): Promise<void>;
+    fail(key: string, _error: unknown): Promise<void>;
+    getResult(key: string): Promise<unknown | undefined>;
+    get(key: string): Promise<unknown | undefined>;
+    getRecord(key: string): Promise<any | undefined>;
+    cleanupExpired(): Promise<number>;
+}
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAA2B,MAAM,SAAS,CAAC;AAS9E,qBAAa,wBAAyB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,0BAA0B;IASzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;IAkDpF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAYpD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAI9C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IAkBhD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAM1C"}

package/dist/idempotency.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresIdempotencyStore = void 0;
+function validateIdentifier(name, paramName = 'tableName') {
+    if (!name || typeof name !== 'string' || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name) || name.length > 63) {
+        throw new Error(`Invalid SQL identifier for ${paramName}: "${name}". Must be 1-63 alphanumeric characters or underscores, starting with a letter or underscore.`);
+    }
+    return name;
+}
+class PostgresIdempotencyStore {
+    client;
+    tableName;
+    defaultTtlMs;
+    constructor(options) {
+        if (!options || !options.client) {
+            throw new Error('PostgresIdempotencyStore requires a valid Postgres client or pool instance.');
+        }
+        this.client = options.client;
+        this.tableName = validateIdentifier(options.tableName || 'siglo_idempotency', 'tableName');
+        this.defaultTtlMs = options.defaultTtlMs || 86400000; // 24 hours
+    }
+    async ensureTable() {
+        await this.client.query(`
+            CREATE TABLE IF NOT EXISTS ${this.tableName} (
+                key VARCHAR(512) PRIMARY KEY,
+                status VARCHAR(50) NOT NULL,
+                result JSONB,
+                expires_at TIMESTAMPTZ NOT NULL,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            );
+            CREATE INDEX IF NOT EXISTS idx_${this.tableName}_expires ON ${this.tableName}(expires_at);
+        `);
+    }
+    async claim(key, ttlMs) {
+        const effectiveTtl = ttlMs || this.defaultTtlMs;
+        const now = Date.now();
+        const expiresAt = new Date(now + effectiveTtl);
+        // Attempt initial insert
+        const insertRes = await this.client.query(`INSERT INTO ${this.tableName} (key, status, expires_at, created_at)
+             VALUES ($1, 'in-progress', $2, NOW())
+             ON CONFLICT (key) DO NOTHING`, [key, expiresAt]);
+        if ((insertRes.rowCount || 0) > 0) {
+            return 'claimed';
+        }
+        // Key exists, inspect current status and expiration
+        const selectRes = await this.client.query(`SELECT status, result, expires_at FROM ${this.tableName} WHERE key = $1`, [key]);
+        if (!selectRes.rows || selectRes.rows.length === 0) {
+            return 'claimed';
+        }
+        const row = selectRes.rows[0];
+        const rowExpiresAt = new Date(row.expires_at).getTime();
+        // If previous claim expired, reclaim it
+        if (rowExpiresAt <= now) {
+            const updateRes = await this.client.query(`UPDATE ${this.tableName}
+                 SET status = 'in-progress', expires_at = $2, result = NULL
+                 WHERE key = $1 AND expires_at <= NOW()`, [key, expiresAt]);
+            if ((updateRes.rowCount || 0) > 0) {
+                return 'claimed';
+            }
+        }
+        if (row.status === 'completed') {
+            return 'completed';
+        }
+        return 'in-progress';
+    }
+    async complete(key, result, ttlMs) {
+        const effectiveTtl = ttlMs || this.defaultTtlMs;
+        const expiresAt = new Date(Date.now() + effectiveTtl);
+        const resultJson = JSON.stringify(result ?? null);
+        await this.client.query(`UPDATE ${this.tableName}
+             SET status = 'completed', result = $2::jsonb, expires_at = $3
+             WHERE key = $1`, [key, resultJson, expiresAt]);
+    }
+    async fail(key, _error) {
+        // Clear in-flight claim to permit retry
+        await this.client.query(`DELETE FROM ${this.tableName} WHERE key = $1 AND status = 'in-progress'`, [key]);
+    }
+    async getResult(key) {
+        const res = await this.client.query(`SELECT result FROM ${this.tableName} WHERE key = $1 AND status = 'completed'`, [key]);
+        if (!res.rows || res.rows.length === 0) {
+            return undefined;
+        }
+        const resData = res.rows[0].result;
+        return typeof resData === 'string' ? JSON.parse(resData) : resData;
+    }
+    async get(key) {
+        return this.getResult(key);
+    }
+    async getRecord(key) {
+        const res = await this.client.query(`SELECT status, result, expires_at, created_at FROM ${this.tableName} WHERE key = $1`, [key]);
+        if (!res.rows || res.rows.length === 0) {
+            return undefined;
+        }
+        const row = res.rows[0];
+        const resData = typeof row.result === 'string' ? JSON.parse(row.result) : row.result;
+        return {
+            status: row.status,
+            result: resData,
+            expiresAt: row.expires_at ? new Date(row.expires_at).getTime() : undefined,
+            claimedAt: row.created_at ? new Date(row.created_at).getTime() : Date.now()
+        };
+    }
+    async cleanupExpired() {
+        const res = await this.client.query(`DELETE FROM ${this.tableName} WHERE expires_at < NOW()`);
+        return res.rowCount || 0;
+    }
+}
+exports.PostgresIdempotencyStore = PostgresIdempotencyStore;
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './adapter';
+export * from './idempotency';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./adapter"), exports);
+__exportStar(require("./idempotency"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,4CAA0B;AAC1B,gDAA8B"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+export interface PostgresQueryResult<T = any> {
+    rows: T[];
+    rowCount: number | null;
+}
+export interface PostgresClientInterface {
+    query<T = any>(queryText: string, values?: any[]): Promise<PostgresQueryResult<T>>;
+}
+export interface PostgresStorageAdapterOptions {
+    client: PostgresClientInterface;
+    checkpointsTable?: string;
+    eventsTable?: string;
+    waitRecordsTable?: string;
+    recordContextChanges?: boolean;
+}
+export interface PostgresIdempotencyOptions {
+    client: PostgresClientInterface;
+    tableName?: string;
+    defaultTtlMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IACxC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,6BAA6B;IAC1C,MAAM,EAAE,uBAAuB,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACvC,MAAM,EAAE,uBAAuB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@siglo/postgres",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Production PostgreSQL durable checkpoint, event audit, and idempotency adapter for Siglo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/postgres"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@siglo/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "pg": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}