@agentuity/postgres 0.1.41

package/dist/transaction.js

@@ -0,0 +1,287 @@
+import { TransactionError } from './errors';
+/**
+ * Represents a PostgreSQL transaction with support for savepoints.
+ *
+ * Transactions are created via `PostgresClient.begin()` and support
+ * tagged template literal syntax for queries.
+ */
+export class Transaction {
+    _sql;
+    _connection;
+    _committed = false;
+    _rolledBack = false;
+    _savepointCounter = 0;
+    constructor(sql, connection) {
+        this._sql = sql;
+        this._connection = connection;
+    }
+    /**
+     * Whether the transaction has been committed.
+     */
+    get committed() {
+        return this._committed;
+    }
+    /**
+     * Whether the transaction has been rolled back.
+     */
+    get rolledBack() {
+        return this._rolledBack;
+    }
+    /**
+     * Whether the transaction is still active (not committed or rolled back).
+     */
+    get active() {
+        return !this._committed && !this._rolledBack;
+    }
+    /**
+     * Execute a query within this transaction using tagged template literal syntax.
+     *
+     * @example
+     * ```typescript
+     * const tx = await client.begin();
+     * const result = await tx`SELECT * FROM users WHERE id = ${userId}`;
+     * await tx.commit();
+     * ```
+     */
+    query(strings, ...values) {
+        this._ensureActive('query');
+        return this._sql(strings, ...values);
+    }
+    /**
+     * Create a savepoint within this transaction.
+     *
+     * @param name - Optional name for the savepoint. If not provided, a unique name is generated.
+     *               If provided, must be a valid SQL identifier (alphanumeric and underscores only,
+     *               starting with a letter or underscore).
+     * @returns A Savepoint object that can be used to rollback to this point.
+     * @throws {TransactionError} If the provided name is not a valid SQL identifier.
+     *
+     * @example
+     * ```typescript
+     * const tx = await client.begin();
+     * await tx`INSERT INTO users (name) VALUES ('Alice')`;
+     *
+     * const sp = await tx.savepoint();
+     * await tx`INSERT INTO users (name) VALUES ('Bob')`;
+     *
+     * // Oops, rollback Bob but keep Alice
+     * await sp.rollback();
+     *
+     * await tx.commit(); // Only Alice is committed
+     * ```
+     */
+    async savepoint(name) {
+        this._ensureActive('savepoint');
+        const savepointName = name ?? `sp_${++this._savepointCounter}`;
+        // Validate savepoint name to prevent SQL injection
+        // Must be a valid SQL identifier: starts with letter or underscore, contains only alphanumeric and underscores
+        const validIdentifierPattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
+        if (!validIdentifierPattern.test(savepointName)) {
+            throw new TransactionError({
+                message: `Invalid savepoint name "${savepointName}": must be a valid SQL identifier (alphanumeric and underscores only, starting with a letter or underscore)`,
+                phase: 'savepoint',
+            });
+        }
+        try {
+            await this._sql `SAVEPOINT ${this._sql.unsafe(savepointName)}`;
+            return new Savepoint(this._sql, savepointName);
+        }
+        catch (error) {
+            throw new TransactionError({
+                message: `Failed to create savepoint: ${error instanceof Error ? error.message : String(error)}`,
+                phase: 'savepoint',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Commit the transaction.
+     *
+     * @throws {TransactionError} If the transaction is not active or commit fails.
+     */
+    async commit() {
+        this._ensureActive('commit');
+        try {
+            await this._sql `COMMIT`;
+            this._committed = true;
+        }
+        catch (error) {
+            throw new TransactionError({
+                message: `Failed to commit transaction: ${error instanceof Error ? error.message : String(error)}`,
+                phase: 'commit',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Rollback the transaction.
+     *
+     * @throws {TransactionError} If the transaction is not active or rollback fails.
+     */
+    async rollback() {
+        this._ensureActive('rollback');
+        try {
+            await this._sql `ROLLBACK`;
+            this._rolledBack = true;
+        }
+        catch (error) {
+            throw new TransactionError({
+                message: `Failed to rollback transaction: ${error instanceof Error ? error.message : String(error)}`,
+                phase: 'rollback',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Ensures the transaction is still active.
+     */
+    _ensureActive(operation) {
+        if (this._committed) {
+            throw new TransactionError({
+                message: `Cannot ${operation}: transaction has been committed`,
+                phase: operation,
+            });
+        }
+        if (this._rolledBack) {
+            throw new TransactionError({
+                message: `Cannot ${operation}: transaction has been rolled back`,
+                phase: operation,
+            });
+        }
+    }
+}
+/**
+ * Represents a savepoint within a transaction.
+ */
+export class Savepoint {
+    _sql;
+    _name;
+    _released = false;
+    _rolledBack = false;
+    constructor(sql, name) {
+        this._sql = sql;
+        this._name = name;
+    }
+    /**
+     * The name of this savepoint.
+     */
+    get name() {
+        return this._name;
+    }
+    /**
+     * Whether the savepoint has been released.
+     */
+    get released() {
+        return this._released;
+    }
+    /**
+     * Whether the savepoint has been rolled back to.
+     */
+    get rolledBack() {
+        return this._rolledBack;
+    }
+    /**
+     * Rollback to this savepoint.
+     * All changes made after this savepoint was created will be undone.
+     *
+     * @throws {TransactionError} If the savepoint has been released or already rolled back.
+     */
+    async rollback() {
+        if (this._released) {
+            throw new TransactionError({
+                message: `Cannot rollback: savepoint "${this._name}" has been released`,
+                phase: 'savepoint',
+            });
+        }
+        if (this._rolledBack) {
+            throw new TransactionError({
+                message: `Cannot rollback: savepoint "${this._name}" has already been rolled back`,
+                phase: 'savepoint',
+            });
+        }
+        try {
+            await this._sql `ROLLBACK TO SAVEPOINT ${this._sql.unsafe(this._name)}`;
+            this._rolledBack = true;
+        }
+        catch (error) {
+            throw new TransactionError({
+                message: `Failed to rollback to savepoint: ${error instanceof Error ? error.message : String(error)}`,
+                phase: 'savepoint',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Release this savepoint.
+     * The savepoint is destroyed but changes are kept.
+     */
+    async release() {
+        if (this._released) {
+            return; // Already released, no-op
+        }
+        try {
+            await this._sql `RELEASE SAVEPOINT ${this._sql.unsafe(this._name)}`;
+            this._released = true;
+        }
+        catch (error) {
+            throw new TransactionError({
+                message: `Failed to release savepoint: ${error instanceof Error ? error.message : String(error)}`,
+                phase: 'savepoint',
+                cause: error,
+            });
+        }
+    }
+}
+/**
+ * Represents a reserved (exclusive) connection from the pool.
+ *
+ * Reserved connections are created via `PostgresClient.reserve()` and support
+ * tagged template literal syntax for queries.
+ */
+export class ReservedConnection {
+    _sql;
+    _released = false;
+    constructor(sql) {
+        this._sql = sql;
+    }
+    /**
+     * Whether the connection has been released back to the pool.
+     */
+    get released() {
+        return this._released;
+    }
+    /**
+     * Execute a query on this reserved connection using tagged template literal syntax.
+     *
+     * @example
+     * ```typescript
+     * const conn = await client.reserve();
+     * try {
+     *   await conn`SET LOCAL timezone = 'UTC'`;
+     *   const result = await conn`SELECT NOW()`;
+     * } finally {
+     *   conn.release();
+     * }
+     * ```
+     */
+    query(strings, ...values) {
+        if (this._released) {
+            throw new TransactionError({
+                message: 'Cannot query: connection has been released',
+            });
+        }
+        return this._sql(strings, ...values);
+    }
+    /**
+     * Release the connection back to the pool.
+     */
+    release() {
+        if (this._released) {
+            return; // Already released, no-op
+        }
+        this._released = true;
+        // The underlying SQL connection will be returned to the pool
+        // when it goes out of scope or is explicitly closed
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,213 @@
+/**
+ * TLS configuration options for PostgreSQL connections.
+ */
+export interface TLSConfig {
+    /**
+     * Whether to require TLS for the connection.
+     * - `true`: Require TLS (fail if not available)
+     * - `false`: Disable TLS
+     * - `'prefer'`: Use TLS if available, fall back to unencrypted
+     */
+    require?: boolean | 'prefer';
+    /**
+     * Whether to reject unauthorized certificates.
+     * Set to `false` to allow self-signed certificates.
+     */
+    rejectUnauthorized?: boolean;
+    /**
+     * CA certificate(s) for verifying the server certificate.
+     */
+    ca?: string | Buffer | (string | Buffer)[];
+    /**
+     * Client certificate for mutual TLS authentication.
+     */
+    cert?: string | Buffer;
+    /**
+     * Client private key for mutual TLS authentication.
+     */
+    key?: string | Buffer;
+}
+/**
+ * Configuration for automatic reconnection behavior.
+ */
+export interface ReconnectConfig {
+    /**
+     * Maximum number of reconnection attempts before giving up.
+     * @default 10
+     */
+    maxAttempts?: number;
+    /**
+     * Initial delay in milliseconds before the first reconnection attempt.
+     * @default 100
+     */
+    initialDelayMs?: number;
+    /**
+     * Maximum delay in milliseconds between reconnection attempts.
+     * @default 30000
+     */
+    maxDelayMs?: number;
+    /**
+     * Multiplier for exponential backoff.
+     * @default 2
+     */
+    multiplier?: number;
+    /**
+     * Maximum random jitter in milliseconds to add to the delay.
+     * Helps prevent thundering herd problems.
+     * @default 1000
+     */
+    jitterMs?: number;
+    /**
+     * Whether to automatically reconnect on connection loss.
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Statistics about the connection state and reconnection history.
+ */
+export interface ConnectionStats {
+    /**
+     * Whether the client is currently connected.
+     */
+    connected: boolean;
+    /**
+     * Whether a reconnection attempt is in progress.
+     */
+    reconnecting: boolean;
+    /**
+     * Total number of successful connections (including reconnections).
+     */
+    totalConnections: number;
+    /**
+     * Total number of reconnection attempts.
+     */
+    reconnectAttempts: number;
+    /**
+     * Total number of failed reconnection attempts.
+     */
+    failedReconnects: number;
+    /**
+     * Timestamp of the last successful connection.
+     */
+    lastConnectedAt: Date | null;
+    /**
+     * Timestamp of the last disconnection.
+     */
+    lastDisconnectedAt: Date | null;
+    /**
+     * Timestamp of the last reconnection attempt.
+     */
+    lastReconnectAttemptAt: Date | null;
+}
+/**
+ * PostgreSQL connection configuration options.
+ * Extends Bun.SQL options with reconnection configuration.
+ */
+export interface PostgresConfig {
+    /**
+     * PostgreSQL connection URL.
+     * If not provided, uses `process.env.DATABASE_URL`.
+     */
+    url?: string;
+    /**
+     * Database hostname.
+     */
+    hostname?: string;
+    /**
+     * Database port.
+     * @default 5432
+     */
+    port?: number;
+    /**
+     * Database username.
+     */
+    username?: string;
+    /**
+     * Database password.
+     */
+    password?: string;
+    /**
+     * Database name.
+     */
+    database?: string;
+    /**
+     * TLS configuration.
+     */
+    tls?: TLSConfig | boolean;
+    /**
+     * Maximum number of connections in the pool.
+     * @default 10
+     */
+    max?: number;
+    /**
+     * Connection timeout in milliseconds.
+     * @default 30000
+     */
+    connectionTimeout?: number;
+    /**
+     * Idle timeout in milliseconds.
+     * @default 0 (no timeout)
+     */
+    idleTimeout?: number;
+    /**
+     * Reconnection configuration.
+     */
+    reconnect?: ReconnectConfig;
+    /**
+     * Whether to establish a connection immediately on client creation.
+     * If true, the client will execute a test query (SELECT 1) to verify
+     * the connection is working. If false (default), the connection is
+     * established lazily on first query.
+     *
+     * Note: Even with preconnect=false, the underlying Bun.SQL client is
+     * created immediately, but the actual TCP connection is deferred.
+     *
+     * @default false
+     */
+    preconnect?: boolean;
+    /**
+     * Callback invoked when the connection is closed.
+     */
+    onclose?: (error?: Error) => void;
+    /**
+     * Callback invoked when reconnection starts.
+     */
+    onreconnect?: (attempt: number) => void;
+    /**
+     * Callback invoked when reconnection succeeds.
+     */
+    onreconnected?: () => void;
+    /**
+     * Callback invoked when reconnection fails permanently.
+     */
+    onreconnectfailed?: (error: Error) => void;
+}
+/**
+ * Options for creating a transaction.
+ */
+export interface TransactionOptions {
+    /**
+     * Transaction isolation level.
+     */
+    isolationLevel?: 'read uncommitted' | 'read committed' | 'repeatable read' | 'serializable';
+    /**
+     * Whether the transaction is read-only.
+     */
+    readOnly?: boolean;
+    /**
+     * Whether the transaction is deferrable.
+     * Only applicable for serializable read-only transactions.
+     */
+    deferrable?: boolean;
+}
+/**
+ * Options for reserving a connection.
+ */
+export interface ReserveOptions {
+    /**
+     * Timeout in milliseconds for acquiring a connection from the pool.
+     */
+    timeout?: 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":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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

@@ -0,0 +1,55 @@
+{
+	"name": "@agentuity/postgres",
+	"version": "0.1.41",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"description": "Resilient PostgreSQL client with automatic reconnection for Agentuity projects",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"exports": {
+		".": "./dist/index.js"
+	},
+	"typesVersions": {
+		"*": {
+			".": [
+				"./dist/index.d.ts"
+			]
+		}
+	},
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "0.1.41"
+	},
+	"peerDependencies": {
+		"@agentuity/runtime": "0.1.41"
+	},
+	"peerDependenciesMeta": {
+		"@agentuity/runtime": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@agentuity/runtime": "0.1.41",
+		"@agentuity/test-utils": "0.1.41",
+		"@types/bun": "latest",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false
+}