@starbemtech/star-db-query-builder 1.0.38 → 1.2.1

package/dist/src/db/initDb.js

@@ -7,6 +7,53 @@ const pgClient_1 = require("./pgClient");
 const mysqlClient_1 = require("./mysqlClient");
 const dbClients = {};
 const defaultName = 'default';
+/**
+ * Initialize a database client with the specified configuration
+ *
+ * @template T - The type of connection options (PoolConfig for PostgreSQL or PoolOptions for MySQL)
+ * @param config - Configuration object for database initialization
+ * @param config.name - Optional name for the database client (defaults to 'default')
+ * @param config.type - Database type ('pg' for PostgreSQL or 'mysql' for MySQL)
+ * @param config.options - Connection options specific to the database type
+ * @param config.retryOptions - Optional retry configuration for failed queries
+ * @param config.installUnaccentExtension - Optional flag to install unaccent extension (PostgreSQL only)
+ * @returns Promise<void> - Resolves when the database client is successfully initialized
+ *
+ * @throws {Error} When type is not provided or is invalid
+ * @throws {Error} When connection options are not provided
+ * @throws {Error} When an unsupported database type is specified
+ *
+ * @example
+ * // Initialize PostgreSQL client
+ * await initDb({
+ *   name: 'myPostgresDb',
+ *   type: 'pg',
+ *   options: {
+ *     host: 'localhost',
+ *     port: 5432,
+ *     database: 'mydb',
+ *     user: 'user',
+ *     password: 'password'
+ *   },
+ *   retryOptions: { maxRetries: 3, delay: 1000 },
+ *   installUnaccentExtension: true
+ * });
+ *
+ * @example
+ * // Initialize MySQL client
+ * await initDb({
+ *   name: 'myMysqlDb',
+ *   type: 'mysql',
+ *   options: {
+ *     host: 'localhost',
+ *     port: 3306,
+ *     database: 'mydb',
+ *     user: 'user',
+ *     password: 'password'
+ *   },
+ *   retryOptions: { maxRetries: 3, delay: 1000 }
+ * });
+ */
 const initDb = async (config) => {
     if (!config.type)
         throw new Error('Type is required. Accept values: pg | mysql');
@@ -28,6 +75,53 @@ const initDb = async (config) => {
     }
 };
 exports.initDb = initDb;
+/**
+ * Initialize a database client with the specified configuration
+ *
+ * @template T - The type of connection options (PoolConfig for PostgreSQL or PoolOptions for MySQL)
+ * @param config - Configuration object for database initialization
+ * @param config.name - Optional name for the database client (defaults to 'default')
+ * @param config.type - Database type ('pg' for PostgreSQL or 'mysql' for MySQL)
+ * @param config.options - Connection options specific to the database type
+ * @param config.retryOptions - Optional retry configuration for failed queries
+ * @param config.installUnaccentExtension - Optional flag to install unaccent extension (PostgreSQL only)
+ * @returns Promise<void> - Resolves when the database client is successfully initialized
+ *
+ * @throws {Error} When database type is not provided or is invalid
+ * @throws {Error} When connection options are not provided
+ * @throws {Error} When an unsupported database type is specified
+ *
+ * @example
+ * // Initialize PostgreSQL client
+ * await initDb({
+ *   name: 'myPostgresDb',
+ *   type: 'pg',
+ *   options: {
+ *     host: 'localhost',
+ *     port: 5432,
+ *     database: 'mydb',
+ *     user: 'user',
+ *     password: 'password'
+ *   },
+ *   retryOptions: { maxRetries: 3, delay: 1000 },
+ *   installUnaccentExtension: true
+ * });
+ *
+ * @example
+ * // Initialize MySQL client
+ * await initDb({
+ *   name: 'myMysqlDb',
+ *   type: 'mysql',
+ *   options: {
+ *     host: 'localhost',
+ *     port: 3306,
+ *     database: 'mydb',
+ *     user: 'user',
+ *     password: 'password'
+ *   },
+ *   retryOptions: { maxRetries: 3, delay: 1000 }
+ * });
+ */
 const getDbClient = (name) => {
     const client = dbClients[name || defaultName];
     if (!client) {
@@ -36,6 +130,31 @@ const getDbClient = (name) => {
     return client;
 };
 exports.getDbClient = getDbClient;
+/**
+ * Retrieves a specific database client by name
+ *
+ * @param name - Optional name of the database client to retrieve. If not provided, returns the default client
+ * @returns IDatabaseClient - The requested database client instance
+ *
+ * @throws {Error} When the specified database client name is not found or not initialized
+ *
+ * @example
+ * // Get default database client
+ * const defaultClient = getDbClient();
+ *
+ * @example
+ * // Get specific database client by name
+ * const postgresClient = getDbClient('myPostgresDb');
+ * const mysqlClient = getDbClient('myMysqlDb');
+ *
+ * @example
+ * // Handle error when client is not found
+ * try {
+ *   const client = getDbClient('nonExistentDb');
+ * } catch (error) {
+ *   console.error('Database client not found:', error.message);
+ * }
+ */
 const getAllDbClients = () => {
     return dbClients;
 };

package/dist/src/db/initDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"initDb.js","sourceRoot":"","sources":["../../../src/db/initDb.ts"],"names":[],"mappings":";;;AAAA,2BAAqC;AACrC,4CAA8D;AAC9D,yCAA2C;AAC3C,+CAAiD;AAIjD,MAAM,SAAS,GAAoC,EAAE,CAAA;AACrD,MAAM,WAAW,GAAG,SAAS,CAAA;AAEtB,MAAM,MAAM,GAAG,KAAK,EAAK,MAM/B,EAAiB,EAAE;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAEhE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IAEtE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAgC,CAAA;QAC1D,MAAM,IAAI,GAAG,IAAI,SAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACrC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,MAAM,IAAA,yBAAc,EAC1D,IAAI,EACJ,MAAM,CAAC,YAAY,EACnB,UAAU,EACV,MAAM,CAAC,wBAAwB,CAChC,CAAA;QAED,OAAO,CAAC,GAAG,CACT,2DAA2D,MAAM,CAAC,IAAI,wBAAwB,CAC/F,CAAA;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAA,oBAAe,EAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC5C,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,IAAA,+BAAiB,EACvD,IAAI,EACJ,MAAM,CAAC,YAAY,CACpB,CAAA;QAED,OAAO,CAAC,IAAI,CACV,2DAA2D,MAAM,CAAC,IAAI,wBAAwB,CAC/F,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAtCY,QAAA,MAAM,UAsClB;AAEM,MAAM,WAAW,GAAG,CAAC,IAAa,EAAmB,EAAE;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,IAAI,WAAW,CAAC,CAAA;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,sBAAsB,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB;AAEM,MAAM,eAAe,GAAG,GAAoC,EAAE;IACnE,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B"}
+{"version":3,"file":"initDb.js","sourceRoot":"","sources":["../../../src/db/initDb.ts"],"names":[],"mappings":";;;AAAA,2BAAqC;AACrC,4CAA8D;AAC9D,yCAA2C;AAC3C,+CAAiD;AAIjD,MAAM,SAAS,GAAoC,EAAE,CAAA;AACrD,MAAM,WAAW,GAAG,SAAS,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACI,MAAM,MAAM,GAAG,KAAK,EAAK,MAM/B,EAAiB,EAAE;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAEhE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IAEtE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAgC,CAAA;QAC1D,MAAM,IAAI,GAAG,IAAI,SAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACrC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,MAAM,IAAA,yBAAc,EAC1D,IAAI,EACJ,MAAM,CAAC,YAAY,EACnB,UAAU,EACV,MAAM,CAAC,wBAAwB,CAChC,CAAA;QAED,OAAO,CAAC,GAAG,CACT,2DAA2D,MAAM,CAAC,IAAI,wBAAwB,CAC/F,CAAA;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAA,oBAAe,EAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC5C,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,IAAA,+BAAiB,EACvD,IAAI,EACJ,MAAM,CAAC,YAAY,CACpB,CAAA;QAED,OAAO,CAAC,IAAI,CACV,2DAA2D,MAAM,CAAC,IAAI,wBAAwB,CAC/F,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAtCY,QAAA,MAAM,UAsClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACI,MAAM,WAAW,GAAG,CAAC,IAAa,EAAmB,EAAE;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,IAAI,WAAW,CAAC,CAAA;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,sBAAsB,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,MAAM,eAAe,GAAG,GAAoC,EAAE;IACnE,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B"}

package/dist/src/db/mysqlClient.d.ts

@@ -1,4 +1,26 @@
 import { Pool } from 'mysql2/promise';
 import { IDatabaseClient } from './IDatabaseClient';
-import { RetryOptions } from '../default/types';
+import { RetryOptions } from '../core/types';
+/**
+ * Creates a MySQL database client
+ *
+ * This function initializes a MySQL database client with the provided pool configuration
+ * and optional retry options. It sets up monitoring for connection events and query operations.
+ *
+ * @param pool - The MySQL pool instance
+ * @param retryOptions - Optional retry options for failed queries
+ * @returns IDatabaseClient - The MySQL database client instance
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ */
 export declare const createMysqlClient: (pool: Pool, retryOptions?: RetryOptions) => IDatabaseClient;

package/dist/src/db/mysqlClient.js

@@ -12,9 +12,54 @@ const transientErrorCodes = new Set([
     'PROTOCOL_CONNECTION_LOST',
     'ECONNREFUSED',
 ]);
+/**
+ * Checks if the given error is a transient error that can be retried
+ *
+ * Transient errors are temporary network or connection issues that typically
+ * resolve themselves and can be safely retried. This function checks if the
+ * error code matches known transient error patterns for MySQL connections.
+ *
+ * @param error - The error object to check
+ * @returns boolean - True if the error is transient and can be retried, false otherwise
+ *
+ * @example
+ * try {
+ *   const result = await pool.execute(sql, params);
+ * } catch (error) {
+ *   if (isTransientError(error)) {
+ *     // Retry the operation
+ *     console.log('Transient error detected, retrying...');
+ *   } else {
+ *     // Handle permanent error
+ *     throw error;
+ *   }
+ * }
+ */
 function isTransientError(error) {
     return error && error.code && transientErrorCodes.has(error.code);
 }
+/**
+ * Creates a MySQL database client
+ *
+ * This function initializes a MySQL database client with the provided pool configuration
+ * and optional retry options. It sets up monitoring for connection events and query operations.
+ *
+ * @param pool - The MySQL pool instance
+ * @param retryOptions - Optional retry options for failed queries
+ * @returns IDatabaseClient - The MySQL database client instance
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const mysqlClient = createMysqlClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ */
 const createMysqlClient = (pool, retryOptions) => {
     monitor_1.monitor.emit(monitor_1.MonitorEvents.CONNECTION_CREATED, {
         clientType: 'mysql',
@@ -68,6 +113,76 @@ const createMysqlClient = (pool, retryOptions) => {
                 }
             }, retryOptions);
         },
+        beginTransaction: async () => {
+            const connection = await pool.getConnection();
+            try {
+                await connection.beginTransaction();
+                return {
+                    query: async (sql, params) => {
+                        const startTime = Date.now();
+                        try {
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_START, {
+                                clientType: 'mysql',
+                                sql,
+                                params,
+                                attempt: 1,
+                                inTransaction: true,
+                            });
+                            const [rows] = await connection.execute(sql, params);
+                            const elapsedTime = Date.now() - startTime;
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
+                                clientType: 'mysql',
+                                sql,
+                                params,
+                                attempt: 1,
+                                elapsedTime,
+                                inTransaction: true,
+                            });
+                            return rows;
+                        }
+                        catch (error) {
+                            const elapsedTime = Date.now() - startTime;
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_ERROR, {
+                                clientType: 'mysql',
+                                sql,
+                                params,
+                                attempt: 1,
+                                elapsedTime,
+                                error,
+                                inTransaction: true,
+                            });
+                            throw error;
+                        }
+                    },
+                    commit: async () => {
+                        try {
+                            await connection.commit();
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.TRANSACTION_COMMIT, {
+                                clientType: 'mysql',
+                            });
+                        }
+                        finally {
+                            connection.release();
+                        }
+                    },
+                    rollback: async () => {
+                        try {
+                            await connection.rollback();
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.TRANSACTION_ROLLBACK, {
+                                clientType: 'mysql',
+                            });
+                        }
+                        finally {
+                            connection.release();
+                        }
+                    },
+                };
+            }
+            catch (error) {
+                connection.release();
+                throw error;
+            }
+        },
     };
 };
 exports.createMysqlClient = createMysqlClient;

package/dist/src/db/mysqlClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"mysqlClient.js","sourceRoot":"","sources":["../../../src/db/mysqlClient.ts"],"names":[],"mappings":";;;;;;AACA,kEAAwC;AAGxC,gDAA2D;AAE3D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,YAAY;IACZ,WAAW;IACX,0BAA0B;IAC1B,cAAc;CACf,CAAC,CAAA;AAEF,SAAS,gBAAgB,CAAC,KAAU;IAClC,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACnE,CAAC;AAEM,MAAM,iBAAiB,GAAG,CAC/B,IAAU,EACV,YAA2B,EACV,EAAE;IACnB,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,kBAAkB,EAAE;QAC7C,UAAU,EAAE,OAAO;QACnB,WAAW,EAAE,IAAI,CAAC,MAAM;KACzB,CAAC,CAAA;IAEF,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,KAAK,EAAK,GAAW,EAAE,MAAc,EAAc,EAAE;YAC1D,OAAO,IAAA,uBAAY,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,IAAI,CAAC;oBACH,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,WAAW,EAAE;wBACtC,UAAU,EAAE,OAAO;wBACnB,GAAG;wBACH,MAAM;wBACN,OAAO;qBACR,CAAC,CAAA;oBAEF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;oBAE9C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;oBAC1C,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,SAAS,EAAE;wBACpC,UAAU,EAAE,OAAO;wBACnB,GAAG;wBACH,MAAM;wBACN,OAAO;wBACP,WAAW;qBACZ,CAAC,CAAA;oBAEF,OAAO,IAAoB,CAAA;gBAC7B,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;oBAC1C,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,WAAW,EAAE;wBACtC,UAAU,EAAE,OAAO;wBACnB,GAAG;wBACH,MAAM;wBACN,OAAO;wBACP,WAAW;wBACX,KAAK;qBACN,CAAC,CAAA;oBAEF,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC5B,OAAO,CAAC,IAAI,CACV,uBAAuB,OAAO,sBAAsB,EACpD,KAAK,CACN,CAAA;wBACD,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,aAAa,EAAE;4BACxC,UAAU,EAAE,OAAO;4BACnB,GAAG;4BACH,MAAM;4BACN,OAAO;4BACP,KAAK;yBACN,CAAC,CAAA;wBAEF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;oBACrB,CAAC;oBAED,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,EAAE,YAAY,CAAC,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAlEY,QAAA,iBAAiB,qBAkE7B"}
+{"version":3,"file":"mysqlClient.js","sourceRoot":"","sources":["../../../src/db/mysqlClient.ts"],"names":[],"mappings":"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"}

package/dist/src/db/pgClient.d.ts

@@ -1,4 +1,25 @@
 import { Pool, PoolConfig } from 'pg';
 import { IDatabaseClient } from './IDatabaseClient';
-import { RetryOptions } from '../default/types';
+import { RetryOptions } from '../core/types';
+/**
+ * Creates a PostgreSQL database client
+ *
+ * This function initializes a PostgreSQL database client with the provided pool configuration
+ * and optional retry options. It sets up monitoring for connection events and query operations.
+ *
+ * @param pool - The PostgreSQL pool instance
+ * @param retryOptions - Optional retry options for failed queries
+ * @param poolConfig - Optional pool configuration
+ * @param installUnaccentExtension - Optional flag to install unaccent extension
+ * @returns IDatabaseClient - The PostgreSQL database client instance
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ */
 export declare const createPgClient: (pool: Pool, retryOptions?: RetryOptions, poolConfig?: PoolConfig, installUnaccentExtension?: boolean) => Promise<IDatabaseClient>;

package/dist/src/db/pgClient.js

@@ -7,9 +7,45 @@ exports.createPgClient = void 0;
 const promise_retry_1 = __importDefault(require("promise-retry"));
 const monitor_1 = require("../monitor/monitor");
 const transientErrorCodes = new Set(['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED']);
+/**
+ * Checks if the given error is a transient error that can be retried
+ *
+ * Transient errors are temporary network or connection issues that typically
+ * resolve themselves and can be safely retried. This function checks if the
+ * error code matches known transient error patterns for PostgreSQL connections.
+ *
+ * @param error - The error object to check
+ * @returns boolean - True if the error is transient and can be retried, false otherwise
+ *
+ * @example
+ * try {
+ *   const result = await pool.query(sql, params);
+ * } catch (error) {
+ *   if (isTransientError(error)) {
+ *     // Retry the operation
+ *     console.log('Transient error detected, retrying...');
+ *   } else {
+ *     // Handle permanent error
+ *     throw error;
+ *   }
+ * }
+ */
 function isTransientError(error) {
     return error && error.code && transientErrorCodes.has(error.code);
 }
+/**
+ * Ensures that the unaccent extension is installed in the PostgreSQL database
+ *
+ * This function checks if the unaccent extension is installed in the database
+ * and installs it if it is not. It also emits a connection created event to
+ * the monitor.
+ *
+ * @param pool - The PostgreSQL pool instance
+ * @returns Promise<void> - Resolves when the unaccent extension is installed or already exists
+ *
+ * @example
+ * await ensureUnaccentExtension(pool);
+ */
 async function ensureUnaccentExtension(pool) {
     try {
         const checkResult = await pool.query(`
@@ -35,6 +71,27 @@ async function ensureUnaccentExtension(pool) {
       ${error}`);
     }
 }
+/**
+ * Creates a PostgreSQL database client
+ *
+ * This function initializes a PostgreSQL database client with the provided pool configuration
+ * and optional retry options. It sets up monitoring for connection events and query operations.
+ *
+ * @param pool - The PostgreSQL pool instance
+ * @param retryOptions - Optional retry options for failed queries
+ * @param poolConfig - Optional pool configuration
+ * @param installUnaccentExtension - Optional flag to install unaccent extension
+ * @returns IDatabaseClient - The PostgreSQL database client instance
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ *
+ * @example
+ * const pgClient = await createPgClient(pool, { retries: 3, factor: 2, minTimeout: 1000 });
+ */
 const createPgClient = async (pool, retryOptions, poolConfig, installUnaccentExtension) => {
     if (installUnaccentExtension) {
         await ensureUnaccentExtension(pool);
@@ -91,6 +148,76 @@ const createPgClient = async (pool, retryOptions, poolConfig, installUnaccentExt
                 }
             }, retryOptions);
         },
+        beginTransaction: async () => {
+            const client = await pool.connect();
+            try {
+                await client.query('BEGIN');
+                return {
+                    query: async (sql, params) => {
+                        const startTime = Date.now();
+                        try {
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_START, {
+                                clientType: 'pg',
+                                sql,
+                                params,
+                                attempt: 1,
+                                inTransaction: true,
+                            });
+                            const { rows } = await client.query(sql, params);
+                            const elapsedTime = Date.now() - startTime;
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
+                                clientType: 'pg',
+                                sql,
+                                params,
+                                attempt: 1,
+                                elapsedTime,
+                                inTransaction: true,
+                            });
+                            return rows;
+                        }
+                        catch (error) {
+                            const elapsedTime = Date.now() - startTime;
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_ERROR, {
+                                clientType: 'pg',
+                                sql,
+                                params,
+                                attempt: 1,
+                                elapsedTime,
+                                error,
+                                inTransaction: true,
+                            });
+                            throw error;
+                        }
+                    },
+                    commit: async () => {
+                        try {
+                            await client.query('COMMIT');
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.TRANSACTION_COMMIT, {
+                                clientType: 'pg',
+                            });
+                        }
+                        finally {
+                            client.release();
+                        }
+                    },
+                    rollback: async () => {
+                        try {
+                            await client.query('ROLLBACK');
+                            monitor_1.monitor.emit(monitor_1.MonitorEvents.TRANSACTION_ROLLBACK, {
+                                clientType: 'pg',
+                            });
+                        }
+                        finally {
+                            client.release();
+                        }
+                    },
+                };
+            }
+            catch (error) {
+                client.release();
+                throw error;
+            }
+        },
     };
 };
 exports.createPgClient = createPgClient;

package/dist/src/db/pgClient.js.map

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

package/dist/src/monitor/monitor.d.ts

@@ -1,9 +1,14 @@
 import { EventEmitter } from 'stream';
+/**
+ * Monitor events
+ */
 export declare enum MonitorEvents {
     CONNECTION_CREATED = "connection_created",
     QUERY_START = "query_start",
     QUERY_END = "query_end",
     QUERY_ERROR = "query_error",
-    RETRY_ATTEMPT = "retry_attempt"
+    RETRY_ATTEMPT = "retry_attempt",
+    TRANSACTION_COMMIT = "transaction_commit",
+    TRANSACTION_ROLLBACK = "transaction_rollback"
 }
 export declare const monitor: EventEmitter<[never]>;

package/dist/src/monitor/monitor.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.monitor = exports.MonitorEvents = void 0;
 const stream_1 = require("stream");
+/**
+ * Monitor events
+ */
 var MonitorEvents;
 (function (MonitorEvents) {
     MonitorEvents["CONNECTION_CREATED"] = "connection_created";
@@ -9,6 +12,8 @@ var MonitorEvents;
     MonitorEvents["QUERY_END"] = "query_end";
     MonitorEvents["QUERY_ERROR"] = "query_error";
     MonitorEvents["RETRY_ATTEMPT"] = "retry_attempt";
+    MonitorEvents["TRANSACTION_COMMIT"] = "transaction_commit";
+    MonitorEvents["TRANSACTION_ROLLBACK"] = "transaction_rollback";
 })(MonitorEvents || (exports.MonitorEvents = MonitorEvents = {}));
 exports.monitor = new stream_1.EventEmitter();
 //# sourceMappingURL=monitor.js.map

package/dist/src/monitor/monitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../../src/monitor/monitor.ts"],"names":[],"mappings":";;;AAAA,mCAAqC;AAErC,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,0DAAyC,CAAA;IACzC,4CAA2B,CAAA;IAC3B,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,gDAA+B,CAAA;AACjC,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB;AAEY,QAAA,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAA"}
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../../src/monitor/monitor.ts"],"names":[],"mappings":";;;AAAA,mCAAqC;AAErC;;GAEG;AACH,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,0DAAyC,CAAA;IACzC,4CAA2B,CAAA;IAC3B,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,gDAA+B,CAAA;IAC/B,0DAAyC,CAAA;IACzC,8DAA6C,CAAA;AAC/C,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB;AAEY,QAAA,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAA"}

package/dist/src/setupTests.d.ts

@@ -0,0 +1,26 @@
+export declare const testUtils: {
+    createMockDbClient: (clientType?: "pg" | "mysql") => {
+        clientType: "pg" | "mysql";
+        query: jest.Mock<any, any, any>;
+        connect: jest.Mock<any, any, any>;
+        end: jest.Mock<any, any, any>;
+    };
+    createSampleUser: () => {
+        id: string;
+        name: string;
+        email: string;
+        status: string;
+        created_at: Date;
+        updated_at: Date;
+    };
+    createSampleConditions: () => {
+        status: {
+            operator: string;
+            value: string;
+        };
+        email: {
+            operator: string;
+            value: string;
+        };
+    };
+};

package/dist/src/setupTests.js

@@ -0,0 +1,43 @@
+"use strict";
+// Jest setup file for star-db-query-builder tests
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testUtils = void 0;
+// Mock console methods to reduce noise in tests
+const originalConsole = { ...console };
+beforeAll(() => {
+    // Suppress console.log, console.warn, and console.error during tests
+    jest.spyOn(console, 'log').mockImplementation(() => { });
+    jest.spyOn(console, 'warn').mockImplementation(() => { });
+    jest.spyOn(console, 'error').mockImplementation(() => { });
+});
+afterAll(() => {
+    // Restore original console methods
+    console.log = originalConsole.log;
+    console.warn = originalConsole.warn;
+    console.error = originalConsole.error;
+});
+// Export test utilities for use in test files
+exports.testUtils = {
+    // Helper to create mock database client
+    createMockDbClient: (clientType = 'pg') => ({
+        clientType,
+        query: jest.fn(),
+        connect: jest.fn(),
+        end: jest.fn(),
+    }),
+    // Helper to create sample data
+    createSampleUser: () => ({
+        id: '123e4567-e89b-12d3-a456-426614174000',
+        name: 'John Doe',
+        email: 'john.doe@example.com',
+        status: 'active',
+        created_at: new Date('2023-01-01'),
+        updated_at: new Date('2023-01-01'),
+    }),
+    // Helper to create sample conditions
+    createSampleConditions: () => ({
+        status: { operator: '=', value: 'active' },
+        email: { operator: 'ILIKE', value: '%example.com' },
+    }),
+};
+//# sourceMappingURL=setupTests.js.map

package/dist/src/setupTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTests.js","sourceRoot":"","sources":["../../src/setupTests.ts"],"names":[],"mappings":";AAAA,kDAAkD;;;AAElD,gDAAgD;AAChD,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;AAEtC,SAAS,CAAC,GAAG,EAAE;IACb,qEAAqE;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAC3D,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,GAAG,EAAE;IACZ,mCAAmC;IACnC,OAAO,CAAC,GAAG,GAAG,eAAe,CAAC,GAAG,CAAA;IACjC,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAA;IACnC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAA;AACvC,CAAC,CAAC,CAAA;AAEF,8CAA8C;AACjC,QAAA,SAAS,GAAG;IACvB,wCAAwC;IACxC,kBAAkB,EAAE,CAAC,aAA6B,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1D,UAAU;QACV,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;QAClB,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;KACf,CAAC;IAEF,+BAA+B;IAC/B,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;QACvB,EAAE,EAAE,sCAAsC;QAC1C,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC;QAClC,UAAU,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC;KACnC,CAAC;IAEF,qCAAqC;IACrC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7B,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC1C,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;KACpD,CAAC;CACH,CAAA"}