blendsdk 5.33.0

package/dist/postgresql/database.js

@@ -0,0 +1,321 @@
+import { Database, } from '../dbcore/index.js';
+import { Pool } from 'pg';
+import { pg as named } from 'yesql';
+import { PostgreSQLDeleteStatement } from './delete-statement.js';
+import { PostgreSQLInsertStatement } from './insert-statement.js';
+import { PostgreSQLUpdateStatement } from './update-statement.js';
+/**
+ * Provides PostgreSQL database connectivity and query execution capabilities.
+ * Manages connection pooling, transactions, and statement creation for PostgreSQL databases.
+ * Extends the base Database class with PostgreSQL-specific implementations.
+ *
+ * @export
+ * @class PostgreSQLDatabase
+ * @extends {Database}
+ */
+export class PostgreSQLDatabase extends Database {
+    /**
+     * The PostgreSQL connection pool for managing database connections
+     * @protected
+     * @type {Pool}
+     * @memberof PostgreSQLDatabase
+     */
+    pool;
+    /**
+     * The current transaction client, null when no transaction is active
+     * @protected
+     * @type {(PoolClient | null)}
+     * @memberof PostgreSQLDatabase
+     */
+    transactionClient = null;
+    /**
+     * Flag to prevent new connections during shutdown
+     * @protected
+     * @type {boolean}
+     * @memberof PostgreSQLDatabase
+     */
+    isShuttingDown = false;
+    /**
+     * Creates an instance of PostgreSQLDatabase.
+     * Initializes the connection pool with the provided configuration settings.
+     *
+     * @param {PostgreSQLConfig} config - The database configuration including host, port, credentials, and database name
+     * @memberof PostgreSQLDatabase
+     */
+    constructor(config) {
+        super(config);
+        const { database, host, pass, port, user, poolConfig } = this.config;
+        // Initialize the PostgreSQL connection pool with configuration parameters
+        this.pool = new Pool({
+            database,
+            host,
+            password: pass,
+            port: port ? Number(port) : undefined,
+            user,
+            // Apply optional pool configuration with sensible defaults
+            max: poolConfig?.max,
+            idleTimeoutMillis: poolConfig?.idleTimeoutMillis,
+            connectionTimeoutMillis: poolConfig?.connectionTimeoutMillis,
+        });
+        // Register graceful shutdown handlers if enabled
+        if (config.enableGracefulShutdown) {
+            this.registerShutdownHandlers();
+        }
+    }
+    /**
+     * Executes a function within a database transaction context.
+     * Automatically handles BEGIN, COMMIT, and ROLLBACK operations.
+     * Ensures proper cleanup of transaction resources in all scenarios.
+     *
+     * @template T - The return type of the transaction function
+     * @param {(db: this) => Promise<T>} fn - The function to execute within the transaction context
+     * @return {Promise<T>} Promise resolving to the result of the transaction function
+     * @throws {Error} When the transaction function fails, triggers automatic ROLLBACK
+     * @memberof PostgreSQLDatabase
+     */
+    async withTransaction(fn) {
+        // Prevent new transactions during shutdown
+        if (this.isShuttingDown) {
+            throw new Error('Cannot start transaction: database is shutting down');
+        }
+        // Acquire a client connection if not already in a transaction
+        if (!this.transactionClient) {
+            this.transactionClient = await this.connect();
+        }
+        let committed = false;
+        try {
+            // Begin the transaction
+            await this.transactionClient?.query('BEGIN');
+            // Execute the provided function within the transaction context
+            const result = await fn(this);
+            // Commit the transaction if successful
+            await this.transactionClient?.query('COMMIT');
+            committed = true;
+            return result;
+        }
+        catch (error) {
+            // Rollback the transaction on any error (only if not yet committed)
+            if (this.transactionClient && !committed) {
+                try {
+                    await this.transactionClient.query('ROLLBACK');
+                }
+                catch (rollbackError) {
+                    console.error('Error during transaction rollback:', rollbackError);
+                }
+            }
+            throw error;
+        }
+        finally {
+            // Always release the client connection and reset transaction state
+            if (this.transactionClient) {
+                try {
+                    this.transactionClient.release();
+                }
+                catch (releaseError) {
+                    console.error('Error releasing transaction client:', releaseError);
+                }
+                this.transactionClient = null;
+            }
+        }
+    }
+    /**
+     * Acquires a client connection from the connection pool.
+     * Used internally for transaction management and query execution.
+     *
+     * @return {Promise<PoolClient>} Promise resolving to a PostgreSQL client connection
+     * @memberof PostgreSQLDatabase
+     */
+    connect() {
+        return this.pool.connect();
+    }
+    /**
+     * Closes all connections in the pool and terminates the database connection.
+     * Implements timeout protection to prevent hanging on unreleased connections.
+     * Should be called when the application is shutting down to ensure clean resource cleanup.
+     *
+     * @param {number} [timeoutMs=10000] - Maximum time to wait for graceful shutdown in milliseconds
+     * @return {Promise<void>} Promise that resolves when all connections are closed
+     * @throws {Error} When disconnect times out, after forcing connection closure
+     * @memberof PostgreSQLDatabase
+     */
+    async disconnect(timeoutMs = 10000) {
+        this.isShuttingDown = true;
+        let timeoutHandle;
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(async () => {
+                try {
+                    await this.forceDisconnect();
+                    resolve();
+                }
+                catch (err) {
+                    resolve(); // Still resolve to prevent hanging
+                }
+            }, timeoutMs);
+        });
+        try {
+            await Promise.race([
+                this.pool.end().then(() => clearTimeout(timeoutHandle)),
+                timeoutPromise,
+            ]);
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Forcefully closes all connections in the pool without waiting for graceful shutdown.
+     * This is a last resort method used when normal disconnect times out.
+     * Warning: This may interrupt active queries and transactions.
+     *
+     * @protected
+     * @return {Promise<void>} Promise that resolves when all connections are forcefully closed
+     * @memberof PostgreSQLDatabase
+     */
+    async forceDisconnect() {
+        try {
+            // Read existing clients (not assign empty array)
+            const clients = this.pool._clients || [];
+            for (const client of clients) {
+                try {
+                    client.release(true); // Force release even if in transaction
+                }
+                catch {
+                    // Silently ignore release errors
+                }
+            }
+            // Clear the clients array after releasing
+            this.pool._clients = [];
+        }
+        catch {
+            // Silently ignore any errors
+        }
+    }
+    /**
+     * Registers signal handlers for graceful shutdown on SIGINT and SIGTERM.
+     * Automatically calls disconnect() when these signals are received.
+     * Only registered if enableGracefulShutdown is true in config.
+     *
+     * @protected
+     * @memberof PostgreSQLDatabase
+     */
+    registerShutdownHandlers() {
+        const shutdownHandler = async (signal) => {
+            console.log(`Received ${signal}. Closing database connections...`);
+            try {
+                await this.disconnect();
+                console.log('Database connections closed successfully.');
+                process.exit(0);
+            }
+            catch (error) {
+                console.error('Error during graceful shutdown:', error);
+                process.exit(1);
+            }
+        };
+        process.on('SIGINT', () => shutdownHandler('SIGINT'));
+        process.on('SIGTERM', () => shutdownHandler('SIGTERM'));
+    }
+    /**
+     * Executes a parameterized SQL query against the PostgreSQL database.
+     * Handles named parameter substitution, transaction management, and query hooks.
+     * Automatically manages connection acquisition and release for non-transactional queries.
+     *
+     * @template R - The type of records returned by the query
+     * @param {string} query - The SQL query string with named parameters (e.g., :paramName)
+     * @param {Record<string, any>} [params] - Object containing named parameter values
+     * @param {ExecuteQueryOptions} [options] - Optional query execution options including beforeQuery and afterQuery hooks
+     * @return {Promise<PostgreSQLQueryResult<R>>} Promise resolving to query results including records, row count, and field definitions
+     * @throws {Error} When no database connection is available
+     * @memberof PostgreSQLDatabase
+     */
+    async executeQuery(query, params, options) {
+        let atomic = false;
+        options = options || {};
+        params = params || {};
+        // Prevent new queries during shutdown
+        if (this.isShuttingDown) {
+            throw new Error('Cannot execute query: database is shutting down');
+        }
+        try {
+            // Acquire a connection if not in a transaction (atomic operation)
+            if (!this.transactionClient) {
+                this.transactionClient = await this.connect();
+                atomic = true;
+            }
+            const client = this.transactionClient;
+            if (!client) {
+                throw new Error('No database connection available.');
+            }
+            // Apply beforeQuery hook if provided to transform parameters
+            if (options.beforeQuery) {
+                params = options.beforeQuery(params);
+            }
+            // Convert named parameters to positional parameters for PostgreSQL
+            const { text, values } = named(query)(params);
+            // Execute the query with positional parameters
+            const res = await client.query(text, values);
+            // Return empty result set if no rows were affected
+            if (res.rowCount === 0) {
+                return { records: [], rowCount: 0, fields: [] };
+            }
+            // Apply afterQuery hook if provided to transform result rows
+            if (options.afterQuery) {
+                res.rows = options.afterQuery(res.rows);
+            }
+            return {
+                records: res.rows || [],
+                rowCount: res.rowCount || 0,
+                fields: res?.fields || [],
+            };
+        }
+        finally {
+            // Release connection if this was an atomic operation
+            if (atomic && this.transactionClient) {
+                try {
+                    this.transactionClient.release();
+                }
+                catch (releaseError) {
+                    console.error('Error releasing query client:', releaseError);
+                }
+                this.transactionClient = null;
+            }
+        }
+    }
+    /**
+     * Creates a new INSERT statement builder for the specified table.
+     * Provides a fluent interface for constructing INSERT queries.
+     *
+     * @template T - The type representing the table structure
+     * @param {string} tableName - The name of the table to insert into
+     * @return {InsertStatement<T>} A new INSERT statement builder instance
+     * @memberof PostgreSQLDatabase
+     */
+    insert(tableName) {
+        return new PostgreSQLInsertStatement(tableName, this);
+    }
+    /**
+     * Creates a new UPDATE statement builder for the specified table.
+     * Provides a fluent interface for constructing UPDATE queries with filtering.
+     *
+     * @template T - The type representing the table structure
+     * @template F - The type representing the filter criteria
+     * @param {string} tableName - The name of the table to update
+     * @return {UpdateStatement<T, F>} A new UPDATE statement builder instance
+     * @memberof PostgreSQLDatabase
+     */
+    update(tableName) {
+        return new PostgreSQLUpdateStatement(tableName, this);
+    }
+    /**
+     * Creates a new DELETE statement builder for the specified table.
+     * Provides a fluent interface for constructing DELETE queries with filtering.
+     *
+     * @template F - The type representing the filter criteria
+     * @param {string} tableName - The name of the table to delete from
+     * @return {DeleteStatement<F>} A new DELETE statement builder instance
+     * @memberof PostgreSQLDatabase
+     */
+    delete(tableName) {
+        return new PostgreSQLDeleteStatement(tableName, this);
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/postgresql/database.js.map

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

package/dist/postgresql/delete-statement.d.ts

@@ -0,0 +1,36 @@
+import { DeleteStatement } from '../dbcore/index.js';
+/**
+ * Provides PostgreSQL-specific implementation for DELETE statement construction.
+ * Builds parameterized DELETE queries with WHERE clauses and RETURNING support.
+ * Extends the base DeleteStatement class with PostgreSQL syntax.
+ *
+ * @export
+ * @class PostgreSQLDeleteStatement
+ * @template FilterType - The type representing the filter criteria for the WHERE clause
+ * @extends {DeleteStatement<FilterType>}
+ */
+export declare class PostgreSQLDeleteStatement<FilterType> extends DeleteStatement<FilterType> {
+    /**
+     * Constructs the PostgreSQL DELETE query string with WHERE and RETURNING clauses.
+     * Uses cached compiled expression for complex WHERE conditions with parameterized queries.
+     * Supports optional RETURNING clause to retrieve deleted row data.
+     *
+     * @protected
+     * @return {string} The complete DELETE query string
+     * @memberof PostgreSQLDeleteStatement
+     */
+    protected buildQuery(): string;
+    /**
+     * Builds the parameter object for the DELETE query.
+     * Uses cached compiled expression to generate parameters with proper naming.
+     * Returns an object mapping parameter names to their values for query execution.
+     *
+     * @protected
+     * @return {Object} Object containing named parameters for the WHERE clause
+     * @memberof PostgreSQLDeleteStatement
+     */
+    protected buildParameters(): {
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=delete-statement.d.ts.map

package/dist/postgresql/delete-statement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-statement.d.ts","sourceRoot":"","sources":["../src/delete-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,yBAAyB,CAAC,UAAU,CAAE,SAAQ,eAAe,CAAC,UAAU,CAAC;IACpF;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM;IAiB9B;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe;;;CAW1B"}

package/dist/postgresql/delete-statement.js

@@ -0,0 +1,54 @@
+import { DeleteStatement } from '../dbcore/index.js';
+/**
+ * Provides PostgreSQL-specific implementation for DELETE statement construction.
+ * Builds parameterized DELETE queries with WHERE clauses and RETURNING support.
+ * Extends the base DeleteStatement class with PostgreSQL syntax.
+ *
+ * @export
+ * @class PostgreSQLDeleteStatement
+ * @template FilterType - The type representing the filter criteria for the WHERE clause
+ * @extends {DeleteStatement<FilterType>}
+ */
+export class PostgreSQLDeleteStatement extends DeleteStatement {
+    /**
+     * Constructs the PostgreSQL DELETE query string with WHERE and RETURNING clauses.
+     * Uses cached compiled expression for complex WHERE conditions with parameterized queries.
+     * Supports optional RETURNING clause to retrieve deleted row data.
+     *
+     * @protected
+     * @return {string} The complete DELETE query string
+     * @memberof PostgreSQLDeleteStatement
+     */
+    buildQuery() {
+        let queryStr = `DELETE FROM ${this.tableName}`;
+        // Build WHERE clause from cached compiled expression
+        const compiled = this.getCompiledExpression();
+        if (compiled?.sql) {
+            queryStr += ` WHERE ${compiled.sql}`;
+        }
+        // Add RETURNING clause if specified to retrieve deleted row data
+        if (this._returning.length > 0) {
+            queryStr += ` RETURNING ${this._returning.join(', ')}`;
+        }
+        return queryStr.trim();
+    }
+    /**
+     * Builds the parameter object for the DELETE query.
+     * Uses cached compiled expression to generate parameters with proper naming.
+     * Returns an object mapping parameter names to their values for query execution.
+     *
+     * @protected
+     * @return {Object} Object containing named parameters for the WHERE clause
+     * @memberof PostgreSQLDeleteStatement
+     */
+    buildParameters() {
+        const params = {};
+        // Get parameters from cached compiled expression
+        const compiled = this.getCompiledExpression();
+        if (compiled) {
+            Object.assign(params, compiled.params);
+        }
+        return params;
+    }
+}
+//# sourceMappingURL=delete-statement.js.map

package/dist/postgresql/delete-statement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-statement.js","sourceRoot":"","sources":["../src/delete-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,yBAAsC,SAAQ,eAA2B;IACpF;;;;;;;;OAQG;IACO,UAAU;QAClB,IAAI,QAAQ,GAAG,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC;QAE/C,qDAAqD;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC;YAClB,QAAQ,IAAI,UAAU,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC;QAED,iEAAiE;QACjE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,QAAQ,IAAI,cAAc,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACO,eAAe;QACvB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,iDAAiD;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/postgresql/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PostgreSQL database adapter for BlendSDK.
+ * Provides PostgreSQL-specific implementations for database operations including
+ * connection management, query execution, and statement builders.
+ *
+ * @packageDocumentation
+ */
+export * from './database.js';
+export * from './insert-statement.js';
+export * from './update-statement.js';
+export * from './delete-statement.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/postgresql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/postgresql/index.js

@@ -0,0 +1,12 @@
+/**
+ * PostgreSQL database adapter for BlendSDK.
+ * Provides PostgreSQL-specific implementations for database operations including
+ * connection management, query execution, and statement builders.
+ *
+ * @packageDocumentation
+ */
+export * from './database.js';
+export * from './insert-statement.js';
+export * from './update-statement.js';
+export * from './delete-statement.js';
+//# sourceMappingURL=index.js.map

package/dist/postgresql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/postgresql/insert-statement.d.ts

@@ -0,0 +1,34 @@
+import { InsertStatement } from '../dbcore/index.js';
+/**
+ * Provides PostgreSQL-specific implementation for INSERT statement construction.
+ * Builds parameterized INSERT queries with VALUES and optional RETURNING clauses.
+ * Extends the base InsertStatement class with PostgreSQL syntax.
+ *
+ * @export
+ * @class PostgreSQLInsertStatement
+ * @template TableType - The type representing the table structure for type-safe insertions
+ * @extends {InsertStatement<TableType>}
+ */
+export declare class PostgreSQLInsertStatement<TableType> extends InsertStatement<TableType> {
+    /**
+     * Constructs the PostgreSQL INSERT query string with VALUES and RETURNING clauses.
+     * Generates parameterized query with named parameters matching column names.
+     * Supports optional RETURNING clause to retrieve inserted row data.
+     *
+     * @protected
+     * @return {string} The complete INSERT query string
+     * @memberof PostgreSQLInsertStatement
+     */
+    protected buildQuery(): string;
+    /**
+     * Builds the parameter object for the INSERT query.
+     * Returns the values object directly as parameters are already properly named.
+     * Each key in the values object corresponds to a column name and parameter.
+     *
+     * @protected
+     * @return {Object} Object containing named parameters matching the values to insert
+     * @memberof PostgreSQLInsertStatement
+     */
+    protected buildParameters(): Partial<TableType>;
+}
+//# sourceMappingURL=insert-statement.d.ts.map

package/dist/postgresql/insert-statement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-statement.d.ts","sourceRoot":"","sources":["../src/insert-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,yBAAyB,CAAC,SAAS,CAAE,SAAQ,eAAe,CAAC,SAAS,CAAC;IAClF;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM;IAkB9B;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe;CAG1B"}

package/dist/postgresql/insert-statement.js

@@ -0,0 +1,48 @@
+import { InsertStatement } from '../dbcore/index.js';
+/**
+ * Provides PostgreSQL-specific implementation for INSERT statement construction.
+ * Builds parameterized INSERT queries with VALUES and optional RETURNING clauses.
+ * Extends the base InsertStatement class with PostgreSQL syntax.
+ *
+ * @export
+ * @class PostgreSQLInsertStatement
+ * @template TableType - The type representing the table structure for type-safe insertions
+ * @extends {InsertStatement<TableType>}
+ */
+export class PostgreSQLInsertStatement extends InsertStatement {
+    /**
+     * Constructs the PostgreSQL INSERT query string with VALUES and RETURNING clauses.
+     * Generates parameterized query with named parameters matching column names.
+     * Supports optional RETURNING clause to retrieve inserted row data.
+     *
+     * @protected
+     * @return {string} The complete INSERT query string
+     * @memberof PostgreSQLInsertStatement
+     */
+    buildQuery() {
+        const keys = Object.keys(this._values);
+        // Validate that values are provided — empty INSERT is invalid SQL
+        if (keys.length === 0) {
+            throw new Error(`Cannot build INSERT statement for table "${this.tableName}": no values provided. ` +
+                'Call .values() with at least one column before executing.');
+        }
+        // Build the INSERT query with column names and parameterized values
+        // Format: INSERT INTO table (col1, col2) VALUES (:col1, :col2) RETURNING col1, col2
+        return `INSERT INTO ${this.tableName} (${keys.join(', ')}) VALUES (${keys
+            .map(key => `:${key}`)
+            .join(', ')}) ${this._returning.length ? `RETURNING ${this._returning.join(', ')}` : ''}`.trim();
+    }
+    /**
+     * Builds the parameter object for the INSERT query.
+     * Returns the values object directly as parameters are already properly named.
+     * Each key in the values object corresponds to a column name and parameter.
+     *
+     * @protected
+     * @return {Object} Object containing named parameters matching the values to insert
+     * @memberof PostgreSQLInsertStatement
+     */
+    buildParameters() {
+        return this._values;
+    }
+}
+//# sourceMappingURL=insert-statement.js.map

package/dist/postgresql/insert-statement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-statement.js","sourceRoot":"","sources":["../src/insert-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,yBAAqC,SAAQ,eAA0B;IAClF;;;;;;;;OAQG;IACO,UAAU;QAClB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvC,kEAAkE;QAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,SAAS,yBAAyB;gBACjF,2DAA2D,CAC9D,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,oFAAoF;QACpF,OAAO,eAAe,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI;aACtE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;aACrB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACrG,CAAC;IAED;;;;;;;;OAQG;IACO,eAAe;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/postgresql/update-statement.d.ts

@@ -0,0 +1,38 @@
+import { UpdateStatement } from '../dbcore/index.js';
+/**
+ * Provides PostgreSQL-specific implementation for UPDATE statement construction.
+ * Builds parameterized UPDATE queries with SET, WHERE, and RETURNING clauses.
+ * Extends the base UpdateStatement class with PostgreSQL syntax.
+ *
+ * @export
+ * @class PostgreSQLUpdateStatement
+ * @template TableType - The type representing the table structure for type-safe updates
+ * @template FilterType - The type representing the filter criteria for the WHERE clause
+ * @extends {UpdateStatement<TableType, FilterType>}
+ */
+export declare class PostgreSQLUpdateStatement<TableType, FilterType> extends UpdateStatement<TableType, FilterType> {
+    /**
+     * Constructs the PostgreSQL UPDATE query string with SET, WHERE, and RETURNING clauses.
+     * Generates parameterized query with named parameters for values (prefixed with 'v_')
+     * and uses expression builder for complex WHERE conditions.
+     * Supports optional RETURNING clause to retrieve updated row data.
+     *
+     * @protected
+     * @return {string} The complete UPDATE query string
+     * @memberof PostgreSQLUpdateStatement
+     */
+    protected buildQuery(): string;
+    /**
+     * Builds the parameter object for the UPDATE query.
+     * Combines value parameters (prefixed with 'v_') and expression parameters.
+     * Returns an object mapping parameter names to their values for query execution.
+     *
+     * @protected
+     * @return {Object} Object containing named parameters for both values and WHERE clause
+     * @memberof PostgreSQLUpdateStatement
+     */
+    protected buildParameters(): {
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=update-statement.d.ts.map

package/dist/postgresql/update-statement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-statement.d.ts","sourceRoot":"","sources":["../src/update-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,qBAAa,yBAAyB,CAAC,SAAS,EAAE,UAAU,CAAE,SAAQ,eAAe,CACnF,SAAS,EACT,UAAU,CACX;IACC;;;;;;;;;OASG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM;IAqC9B;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe;;;CAiB1B"}