@starbemtech/star-db-query-builder 1.0.32 → 1.0.33

package/README.md

@@ -4,10 +4,10 @@
 
 ## Features
 
-- **TypeScript Declarations**: Ensure type safety and better autocompletion in your IDE.
-- **Flexible Configuration**: Easily initialize and configure the database client.
-- **Comprehensive CRUD Operations**: Perform Create, Read, Update, Delete operations with ease.
-- **Join Queries**: Execute complex join queries effortlessly.
+- **Multi-Connection Support:** Simultaneously connect to multiple MySQL and PostgreSQL databases.
+- **Automatic Retry:** Automatically retries queries in case of transient errors (e.g. connection loss or timeouts).
+- **External Configuration:** Customize connection pool settings and retry parameters through external configuration.
+- **Monitoring and Logging:** Emits events during the connection and query lifecycle, making it easier to integrate with your logging and monitoring systems.
 
 ## Installation
 
@@ -29,26 +29,57 @@ $ pnpm install star-db-query-builder
 First, initialize the database with the appropriate configuration.
 
 ```typescript
-import { initDb, getDbClient } from 'star-db-query-builder';
+import { initDb, getDbClient, PoolConfig } from 'star-db-query-builder';
 
 // Use PostgresSQL
+const pgPoolOptions: PoolConfig = {
+  host: process.env.PG_HOST,
+  user: process.env.PG_USER,
+  password: process.env.PG_PASS,
+  database: process.env.PG_DB,
+  // OR
+  connectionURL: 'YOUR POSTGRES CONNECTION URL'
+  max: Number(process.env.PG_POOL_MAX) || 10,
+  connectionTimeoutMillis: Number(process.env.PG_CONN_TIMEOUT) || 0,
+  // Other pool options as needed
+}
+
 initDb({
+  name: 'pg-prod',
   type: 'pg',
-  options: {
-     connectionURL: 'YOUR POSTGRES CONNECTION URL'
-  },
+  options: pgPoolOptions,
+  retryOptions: {
+    retries: 3,
+    factor: 2,
+    minTimeout: 1000,
+    // Other retry parameters if needed
+  }
 });
 
 // User MySQL
 initDb({
+  name: 'mysql-prod',
   type: 'mysql',
   options: {
-     url: 'YOUR MYSQL CONNECTION URL'
+    host: process.env.MYSQL_HOST,
+    user: process.env.MYSQL_USER,
+    password: process.env.MYSQL_PASS,
+    database: process.env.MYSQL_DB,
+    connectionLimit: Number(process.env.MYSQL_CONN_LIMIT) || 10,
+    // OR
+    url: 'YOUR MYSQL CONNECTION URL'
+    // Other pool options as needed
   },
+  retryOptions: {
+    retries: 3,
+    factor: 2,
+    minTimeout: 1000,
+    // Other retry parameters if needed
+  }
 });
 
 // In your service, create an instance of getDbClient
-const dbClient = getDbClient();
+const dbClient = getDbClient('pg-prod');
 ```
 
 ### Methods
@@ -58,18 +89,18 @@ const dbClient = getDbClient();
 Retrieve the first matching record from a table.
 
 ```typescript
-import { findFirst } from 'star-db-query-builder';
+import { findFirst } from 'star-db-query-builder'
 
 const result = await findFirst({
   tableName: 'users',
   dbClient,
   select: ['id', 'name', 'email'],
   where: {
-    id: { operator: '=', value: 1 }
-  }
-});
+    id: { operator: '=', value: 1 },
+  },
+})
 
-console.log(result);
+console.log(result)
 ```
 
 #### findMany
@@ -77,20 +108,20 @@ console.log(result);
 Retrieve multiple records from a table.
 
 ```typescript
-import { findMany } from 'star-db-query-builder';
+import { findMany } from 'star-db-query-builder'
 
 const results = await findMany({
   tableName: 'users',
   dbClient,
   select: ['id', 'name', 'email'],
   where: {
-    status: { operator: '= ', value: 'active' }
+    status: { operator: '= ', value: 'active' },
   },
   limit: 10,
   offset: 0,
-});
+})
 
-console.log(results);
+console.log(results)
 ```
 
 #### insert
@@ -98,18 +129,18 @@ console.log(results);
 Insert a new record into a table.
 
 ```typescript
-import { insert } from 'star-db-query-builder';
+import { insert } from 'star-db-query-builder'
 
-const newUser = { name: 'John Doe', email: 'john@example.com' };
+const newUser = { name: 'John Doe', email: 'john@example.com' }
 
 const insertedUser = await insert({
   tableName: 'users',
   dbClient,
   data: newUser,
   returning: ['id', 'name', 'email'],
-});
+})
 
-console.log(insertedUser);
+console.log(insertedUser)
 ```
 
 #### update
@@ -117,9 +148,9 @@ console.log(insertedUser);
 Update an existing record in a table.
 
 ```typescript
-import { update } from 'star-db-query-builder';
+import { update } from 'star-db-query-builder'
 
-const updatedUser = { name: 'John Smith' };
+const updatedUser = { name: 'John Smith' }
 
 const result = await update({
   tableName: 'users',
@@ -127,9 +158,9 @@ const result = await update({
   id: 1,
   data: updatedUser,
   returning: ['id', 'name', 'email'],
-});
+})
 
-console.log(result);
+console.log(result)
 ```
 
 #### deleteOne
@@ -137,16 +168,16 @@ console.log(result);
 Delete a record from a table.
 
 ```typescript
-import { deleteOne } from 'star-db-query-builder';
+import { deleteOne } from 'star-db-query-builder'
 
 await deleteOne({
   tableName: 'users',
   dbClient,
   id: 1,
   permanently: true,
-});
+})
 
-console.log('User deleted');
+console.log('User deleted')
 ```
 
 #### joins
@@ -154,7 +185,7 @@ console.log('User deleted');
 Execute a join query.
 
 ```typescript
-import { joins } from 'star-db-query-builder';
+import { joins } from 'star-db-query-builder'
 
 const joinResults = await joins({
   tableName: 'orders',
@@ -169,19 +200,71 @@ const joinResults = await joins({
   where: {
     JOINS: [
       {
-        'users.id': { operator: '=', value: exist.user_id }
-      }
-    ]
-  }
-});
+        'users.id': { operator: '=', value: exist.user_id },
+      },
+    ],
+  },
+})
 
-console.log(joinResults);
+console.log(joinResults)
 ```
 
+### Monitoring and Logging
+
+The library provides a monitoring module that emits key events during the lifecycle of connections and queries. You can subscribe to these events to integrate with your logging or monitoring system.
+
+#### Available Events
+
+CONNECTION_CREATED: Emitted when a new connection (pool) is established.
+QUERY_START: Emitted just before a query starts executing.
+QUERY_END: Emitted after a query completes, including its execution time.
+QUERY_ERROR: Emitted when an error occurs during query execution.
+RETRY_ATTEMPT: Emitted when a query is retried due to a transient error.
+
+```ts
+import { monitor, MonitorEvents } from '@starbemtech/star-db-query-builder'
+
+monitor.on(MonitorEvents.CONNECTION_CREATED, (data) => {
+  console.log('Connection created:', data)
+})
+
+monitor.on(MonitorEvents.QUERY_START, (data) => {
+  console.log('Query started:', data)
+})
+
+monitor.on(MonitorEvents.QUERY_END, (data) => {
+  console.log('Query finished:', data)
+})
+
+monitor.on(MonitorEvents.QUERY_ERROR, (data) => {
+  console.error('Query error:', data)
+})
+
+monitor.on(MonitorEvents.RETRY_ATTEMPT, (data) => {
+  console.warn('Retrying query:', data)
+})
+```
+
+## Customizing the Retry Strategy
+
+The automatic retry mechanism leverages the promise-retry library. You can customize the following parameters:
+
+- retries: Number of retry attempts.
+- factor: Exponential backoff factor.
+- minTimeout: Minimum time (in milliseconds) to wait between retry attempts.
+
+These parameters are passed via the retryOptions property when initializing the connection.
+
+## Contributing
+
+Feel free to contribute by opening pull requests or issues with improvements and bug fixes.
+
 ## License
 
 This project is licensed under the MIT License.
 
+This documentation explains how to set up connections with external configuration for both connection pool and retry options, retrieve clients to execute queries, and monitor events for logging and diagnostics.
+
 ---
 
 👨‍💻 Happy Coding!

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1738470741089" clover="3.2.0">
-  <project timestamp="1738470741089" name="All files">
+<coverage generated="1740003061166" clover="3.2.0">
+  <project timestamp="1740003061166" name="All files">
     <metrics statements="0" coveredstatements="0" conditionals="0" coveredconditionals="0" methods="0" coveredmethods="0" elements="0" coveredelements="0" complexity="0" loc="0" ncloc="0" packages="0" files="0" classes="0"/>
   </project>
 </coverage>

package/coverage/lcov-report/index.html

@@ -86,7 +86,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-02-02T04:32:21.085Z
+                at 2025-02-19T22:11:01.160Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/dist/index.d.ts

@@ -3,5 +3,4 @@ import { PoolOptions as MySqlPoolOptions } from 'mysql2';
 import { Conditions as TypeConditions } from './src/default/types';
 export * from './src/db/initDb';
 export * from './src/default/genericRepository';
-export * from './src/services/payment';
 export type { PgPoolConfig, MySqlPoolOptions, TypeConditions };

package/dist/index.js

@@ -18,6 +18,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./src/db/initDb"), exports);
 // Generic Repository
 __exportStar(require("./src/default/genericRepository"), exports);
-// Services Repository
-__exportStar(require("./src/services/payment"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,UAAU;AACV,kDAA+B;AAE/B,qBAAqB;AACrB,kEAA+C;AAE/C,sBAAsB;AACtB,yDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,UAAU;AACV,kDAA+B;AAE/B,qBAAqB;AACrB,kEAA+C"}

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

@@ -1,7 +1,10 @@
 import { IDatabaseClient } from './IDatabaseClient';
-import { DBClients } from '../default/types';
+import { DBClients, RetryOptions } from '../default/types';
 export declare const initDb: <T>(config: {
+    name: string;
     type: DBClients;
     options: T;
+    retryOptions?: RetryOptions;
 }) => Promise<void>;
-export declare const getDbClient: () => IDatabaseClient;
+export declare const getDbClient: (name: string) => IDatabaseClient;
+export declare const getAllDbClients: () => Record<string, IDatabaseClient>;

package/dist/src/db/initDb.js

@@ -1,36 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDbClient = exports.initDb = void 0;
+exports.getAllDbClients = exports.getDbClient = exports.initDb = void 0;
 const pg_1 = require("pg");
 const promise_1 = require("mysql2/promise");
 const pgClient_1 = require("./pgClient");
 const mysqlClient_1 = require("./mysqlClient");
-let dbClient = null;
+const dbClients = {};
 const initDb = async (config) => {
     if (!config.type)
         throw new Error('Type is required. Accept values: pg | mysql');
     if (!config.options)
         throw new Error('Connection options is required');
     if (config.type === 'pg') {
+        const poolConfig = config.options;
         const pool = new pg_1.Pool(config.options);
-        dbClient = await (0, pgClient_1.createPgClient)(pool);
-        console.log(`@starbemtech/star-db-query-builder: Postgres db client created success`);
+        dbClients[config.name] = await (0, pgClient_1.createPgClient)(pool, config.retryOptions, poolConfig);
+        console.log(`@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`);
     }
     else if (config.type === 'mysql') {
         const pool = (0, promise_1.createPool)(config.options);
-        dbClient = (0, mysqlClient_1.createMysqlClient)(pool);
-        console.info(`@starbemtech/star-db-query-builder: MySQL db client created success.`);
+        dbClients[config.name] = (0, mysqlClient_1.createMysqlClient)(pool, config.retryOptions);
+        console.info(`@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`);
     }
     else {
         throw new Error('Unsupported database type');
     }
 };
 exports.initDb = initDb;
-const getDbClient = () => {
-    if (!dbClient) {
-        throw new Error('Database client is not initialized');
+const getDbClient = (name) => {
+    const client = dbClients[name];
+    if (!client) {
+        throw new Error(`Database client "${name}" is not initialized`);
     }
-    return dbClient;
+    return client;
 };
 exports.getDbClient = getDbClient;
+const getAllDbClients = () => {
+    return dbClients;
+};
+exports.getAllDbClients = getAllDbClients;
 //# sourceMappingURL=initDb.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"initDb.js","sourceRoot":"","sources":["../../../src/db/initDb.ts"],"names":[],"mappings":";;;AAAA,2BAAmC;AACnC,4CAA8D;AAC9D,yCAA2C;AAC3C,+CAAiD;AAIjD,IAAI,QAAQ,GAA2B,IAAI,CAAA;AAEpC,MAAM,MAAM,GAAG,KAAK,EAAK,MAG/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,IAAI,GAAG,IAAI,SAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACvC,QAAQ,GAAG,MAAM,IAAA,yBAAc,EAAC,IAAI,CAAC,CAAA;QAErC,OAAO,CAAC,GAAG,CACT,wEAAwE,CACzE,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,QAAQ,GAAG,IAAA,+BAAiB,EAAC,IAAI,CAAC,CAAA;QAElC,OAAO,CAAC,IAAI,CACV,sEAAsE,CACvE,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AA1BY,QAAA,MAAM,UA0BlB;AAEM,MAAM,WAAW,GAAG,GAAoB,EAAE;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AANY,QAAA,WAAW,eAMvB"}
+{"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;AAE9C,MAAM,MAAM,GAAG,KAAK,EAAK,MAK/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,CAAC,GAAG,MAAM,IAAA,yBAAc,EAC3C,IAAI,EACJ,MAAM,CAAC,YAAY,EACnB,UAAU,CACX,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,CAAC,GAAG,IAAA,+BAAiB,EAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QAErE,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;AAjCY,QAAA,MAAM,UAiClB;AAEM,MAAM,WAAW,GAAG,CAAC,IAAY,EAAmB,EAAE;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9B,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"}

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

@@ -1,3 +1,4 @@
 import { Pool } from 'mysql2/promise';
 import { IDatabaseClient } from './IDatabaseClient';
-export declare const createMysqlClient: (pool: Pool) => IDatabaseClient;
+import { RetryOptions } from '../default/types';
+export declare const createMysqlClient: (pool: Pool, retryOptions?: RetryOptions) => IDatabaseClient;

package/dist/src/db/mysqlClient.js

@@ -1,12 +1,74 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMysqlClient = void 0;
-const createMysqlClient = (pool) => ({
-    clientType: 'mysql',
-    query: async (sql, params) => {
-        const [rows] = await pool.execute(sql, params);
-        return rows;
-    },
-});
+const promise_retry_1 = __importDefault(require("promise-retry"));
+const monitor_1 = require("../monitor/monitor");
+const transientErrorCodes = new Set([
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'PROTOCOL_CONNECTION_LOST',
+    'ECONNREFUSED',
+]);
+function isTransientError(error) {
+    return error && error.code && transientErrorCodes.has(error.code);
+}
+const createMysqlClient = (pool, retryOptions) => {
+    monitor_1.monitor.emit(monitor_1.MonitorEvents.CONNECTION_CREATED, {
+        clientType: 'mysql',
+        poolOptions: pool.config,
+    });
+    return {
+        clientType: 'mysql',
+        query: async (sql, params) => {
+            return (0, promise_retry_1.default)(async (retry, attempt) => {
+                const startTime = Date.now();
+                try {
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_START, {
+                        clientType: 'mysql',
+                        sql,
+                        params,
+                        attempt,
+                    });
+                    const [rows] = await pool.execute(sql, params);
+                    const elapsedTime = Date.now() - startTime;
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
+                        clientType: 'mysql',
+                        sql,
+                        params,
+                        attempt,
+                        elapsedTime,
+                    });
+                    return rows;
+                }
+                catch (error) {
+                    const elapsedTime = Date.now() - startTime;
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_ERROR, {
+                        clientType: 'mysql',
+                        sql,
+                        params,
+                        attempt,
+                        elapsedTime,
+                        error,
+                    });
+                    if (isTransientError(error)) {
+                        console.warn(`MySQL query attempt ${attempt} failed, retrying...`, error);
+                        monitor_1.monitor.emit(monitor_1.MonitorEvents.RETRY_ATTEMPT, {
+                            clientType: 'mysql',
+                            sql,
+                            params,
+                            attempt,
+                            error,
+                        });
+                        return retry(error);
+                    }
+                    throw error;
+                }
+            }, retryOptions);
+        },
+    };
+};
 exports.createMysqlClient = createMysqlClient;
 //# sourceMappingURL=mysqlClient.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mysqlClient.js","sourceRoot":"","sources":["../../../src/db/mysqlClient.ts"],"names":[],"mappings":";;;AAGO,MAAM,iBAAiB,GAAG,CAAC,IAAU,EAAmB,EAAE,CAAC,CAAC;IACjE,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,KAAK,EAAK,GAAW,EAAE,MAAc,EAAc,EAAE;QAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC9C,OAAO,IAAoB,CAAA;IAC7B,CAAC;CACF,CAAC,CAAA;AANW,QAAA,iBAAiB,qBAM5B"}
+{"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"}

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

@@ -1,3 +1,4 @@
-import { Pool } from 'pg';
+import { Pool, PoolConfig } from 'pg';
 import { IDatabaseClient } from './IDatabaseClient';
-export declare const createPgClient: (pool: Pool) => Promise<IDatabaseClient>;
+import { RetryOptions } from '../default/types';
+export declare const createPgClient: (pool: Pool, retryOptions?: RetryOptions, poolConfig?: PoolConfig) => Promise<IDatabaseClient>;

package/dist/src/db/pgClient.js

@@ -1,6 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 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']);
+function isTransientError(error) {
+    return error && error.code && transientErrorCodes.has(error.code);
+}
 async function ensureUnaccentExtension(pool) {
     try {
         const checkResult = await pool.query(`
@@ -8,21 +17,77 @@ async function ensureUnaccentExtension(pool) {
     `);
         if (checkResult.rows.length === 0) {
             await pool.query('CREATE EXTENSION IF NOT EXISTS unaccent');
-            throw new Error('@starbemtech/star-db-query-builder: Extensão unaccent instalada com sucesso.');
+            monitor_1.monitor.emit(monitor_1.MonitorEvents.CONNECTION_CREATED, {
+                clientType: 'pg',
+                extension: 'unaccent',
+                status: 'installed',
+            });
+            console.info('@starbemtech/star-db-query-builder: Extensão unaccent instalada com sucesso.');
         }
     }
     catch (error) {
+        monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_ERROR, {
+            clientType: 'pg',
+            action: 'install_unaccent',
+            error,
+        });
         throw new Error(`@starbemtech/star-db-query-builder: Não foi possível instalar a extensão unaccent:
       ${error}`);
     }
 }
-const createPgClient = async (pool) => {
+const createPgClient = async (pool, retryOptions, poolConfig) => {
     await ensureUnaccentExtension(pool);
+    monitor_1.monitor.emit(monitor_1.MonitorEvents.CONNECTION_CREATED, {
+        clientType: 'pg',
+        poolOptions: poolConfig,
+    });
     return {
         clientType: 'pg',
         query: async (sql, params) => {
-            const { rows } = await pool.query(sql, params);
-            return rows;
+            return (0, promise_retry_1.default)(async (retry, attempt) => {
+                const startTime = Date.now();
+                try {
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_START, {
+                        clientType: 'pg',
+                        sql,
+                        params,
+                        attempt,
+                    });
+                    const { rows } = await pool.query(sql, params);
+                    const elapsedTime = Date.now() - startTime;
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
+                        clientType: 'pg',
+                        sql,
+                        params,
+                        attempt,
+                        elapsedTime,
+                    });
+                    return rows;
+                }
+                catch (error) {
+                    const elapsedTime = Date.now() - startTime;
+                    monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_ERROR, {
+                        clientType: 'pg',
+                        sql,
+                        params,
+                        attempt,
+                        elapsedTime,
+                        error,
+                    });
+                    if (isTransientError(error)) {
+                        console.warn(`Postgres query attempt ${attempt} failed, retrying...`, error);
+                        monitor_1.monitor.emit(monitor_1.MonitorEvents.RETRY_ATTEMPT, {
+                            clientType: 'pg',
+                            sql,
+                            params,
+                            attempt,
+                            error,
+                        });
+                        return retry(error);
+                    }
+                    throw error;
+                }
+            }, retryOptions);
         },
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"pgClient.js","sourceRoot":"","sources":["../../../src/db/pgClient.ts"],"names":[],"mappings":";;;AAGA,KAAK,UAAU,uBAAuB,CAAC,IAAU;IAC/C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;;KAEpC,CAAC,CAAA;QAEF,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAA;YAC3D,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb;QACE,KAAK,EAAE,CACV,CAAA;IACH,CAAC;AACH,CAAC;AAEM,MAAM,cAAc,GAAG,KAAK,EAAE,IAAU,EAA4B,EAAE;IAC3E,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAEnC,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,KAAK,EAAK,GAAW,EAAE,MAAc,EAAc,EAAE;YAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YAC9C,OAAO,IAAoB,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAVY,QAAA,cAAc,kBAU1B"}
+{"version":3,"file":"pgClient.js","sourceRoot":"","sources":["../../../src/db/pgClient.ts"],"names":[],"mappings":";;;;;;AACA,kEAAwC;AAGxC,gDAA2D;AAE3D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA;AAEhF,SAAS,gBAAgB,CAAC,KAAU;IAClC,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACnE,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAAU;IAC/C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;;KAEpC,CAAC,CAAA;QAEF,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAA;YAE3D,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,kBAAkB,EAAE;gBAC7C,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,WAAW;aACpB,CAAC,CAAA;YAEF,OAAO,CAAC,IAAI,CACV,8EAA8E,CAC/E,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,WAAW,EAAE;YACtC,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,kBAAkB;YAC1B,KAAK;SACN,CAAC,CAAA;QACF,MAAM,IAAI,KAAK,CACb;QACE,KAAK,EAAE,CACV,CAAA;IACH,CAAC;AACH,CAAC;AAEM,MAAM,cAAc,GAAG,KAAK,EACjC,IAAU,EACV,YAA2B,EAC3B,UAAuB,EACG,EAAE;IAC5B,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAEnC,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,kBAAkB,EAAE;QAC7C,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAA;IAEF,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,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,IAAI;wBAChB,GAAG;wBACH,MAAM;wBACN,OAAO;qBACR,CAAC,CAAA;oBAEF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,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,IAAI;wBAChB,GAAG;wBACH,MAAM;wBACN,OAAO;wBACP,WAAW;qBACZ,CAAC,CAAA;oBAEF,OAAO,IAAoB,CAAA;gBAC7B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;oBAC1C,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,WAAW,EAAE;wBACtC,UAAU,EAAE,IAAI;wBAChB,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,0BAA0B,OAAO,sBAAsB,EACvD,KAAK,CACN,CAAA;wBAED,iBAAO,CAAC,IAAI,CAAC,uBAAa,CAAC,aAAa,EAAE;4BACxC,UAAU,EAAE,IAAI;4BAChB,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;AAtEY,QAAA,cAAc,kBAsE1B"}

package/dist/src/default/types.d.ts

@@ -1,4 +1,11 @@
 import { IDatabaseClient } from '../db/IDatabaseClient';
+export interface RetryOptions {
+    retries?: number;
+    factor?: number;
+    minTimeout?: number;
+    maxTimeout?: number;
+    randomize?: boolean;
+}
 export interface QueryExec {
     text: string;
     values?: any[];

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

@@ -0,0 +1,9 @@
+import { EventEmitter } from 'stream';
+export declare enum MonitorEvents {
+    CONNECTION_CREATED = "connection_created",
+    QUERY_START = "query_start",
+    QUERY_END = "query_end",
+    QUERY_ERROR = "query_error",
+    RETRY_ATTEMPT = "retry_attempt"
+}
+export declare const monitor: EventEmitter<[never]>;

package/dist/src/monitor/monitor.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.monitor = exports.MonitorEvents = void 0;
+const stream_1 = require("stream");
+var MonitorEvents;
+(function (MonitorEvents) {
+    MonitorEvents["CONNECTION_CREATED"] = "connection_created";
+    MonitorEvents["QUERY_START"] = "query_start";
+    MonitorEvents["QUERY_END"] = "query_end";
+    MonitorEvents["QUERY_ERROR"] = "query_error";
+    MonitorEvents["RETRY_ATTEMPT"] = "retry_attempt";
+})(MonitorEvents || (exports.MonitorEvents = MonitorEvents = {}));
+exports.monitor = new stream_1.EventEmitter();
+//# sourceMappingURL=monitor.js.map

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

@@ -0,0 +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"}

package/index.ts

@@ -9,7 +9,7 @@ export * from './src/db/initDb'
 export * from './src/default/genericRepository'
 
 // Services Repository
-export * from './src/services/payment'
+// export * from './src/services/payment'
 
 // Types Definition
 export type { PgPoolConfig, MySqlPoolOptions, TypeConditions }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starbemtech/star-db-query-builder",
-  "version": "1.0.32",
+  "version": "1.0.33",
   "description": "A query builder to be used with mysql or postgres",
   "author": "Julio Sousa <julio.sousa@starbem.app>",
   "main": "./dist/index.js",
@@ -33,7 +33,8 @@
     "@types/jest": "^29.5.12",
     "@types/mysql": "^2.15.26",
     "@types/node": "^20.11.30",
-    "@types/pg": "^8.11.4",
+    "@types/pg": "^8.11.11",
+    "@types/promise-retry": "^1.1.6",
     "@types/uuid": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "^7.4.0",
     "@typescript-eslint/parser": "^7.4.0",
@@ -46,13 +47,14 @@
     "lint-staged": "^15.2.2",
     "prettier": "^3.2.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.4.3"
+    "typescript": "^5.8.2"
   },
   "dependencies": {
     "@starbemtech/star-db-query-builder": "link:",
-    "mysql2": "^3.9.3",
-    "pg": "^8.11.3",
-    "uuid": "^9.0.1"
+    "mysql2": "^3.13.0",
+    "pg": "^8.13.3",
+    "promise-retry": "^2.0.1",
+    "uuid": "^11.1.0"
   },
   "lint-staged": {
     "*.{ts}": [

package/src/db/initDb.ts

@@ -1,15 +1,17 @@
-import { Pool as PgPool } from 'pg'
+import { Pool, PoolConfig } from 'pg'
 import { createPool as createMySqlPool } from 'mysql2/promise'
 import { createPgClient } from './pgClient'
 import { createMysqlClient } from './mysqlClient'
 import { IDatabaseClient } from './IDatabaseClient'
-import { DBClients } from '../default/types'
+import { DBClients, RetryOptions } from '../default/types'
 
-let dbClient: IDatabaseClient | null = null
+const dbClients: Record<string, IDatabaseClient> = {}
 
 export const initDb = async <T>(config: {
+  name: string
   type: DBClients
   options: T
+  retryOptions?: RetryOptions
 }): Promise<void> => {
   if (!config.type)
     throw new Error('Type is required. Accept values: pg | mysql')
@@ -17,28 +19,38 @@ export const initDb = async <T>(config: {
   if (!config.options) throw new Error('Connection options is required')
 
   if (config.type === 'pg') {
-    const pool = new PgPool(config.options)
-    dbClient = await createPgClient(pool)
+    const poolConfig = config.options as unknown as PoolConfig
+    const pool = new Pool(config.options)
+    dbClients[config.name] = await createPgClient(
+      pool,
+      config.retryOptions,
+      poolConfig
+    )
 
     console.log(
-      `@starbemtech/star-db-query-builder: Postgres db client created success`
+      `@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`
     )
   } else if (config.type === 'mysql') {
     const pool = createMySqlPool(config.options)
-    dbClient = createMysqlClient(pool)
+    dbClients[config.name] = createMysqlClient(pool, config.retryOptions)
 
     console.info(
-      `@starbemtech/star-db-query-builder: MySQL db client created success.`
+      `@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`
     )
   } else {
     throw new Error('Unsupported database type')
   }
 }
 
-export const getDbClient = (): IDatabaseClient => {
-  if (!dbClient) {
-    throw new Error('Database client is not initialized')
+export const getDbClient = (name: string): IDatabaseClient => {
+  const client = dbClients[name]
+  if (!client) {
+    throw new Error(`Database client "${name}" is not initialized`)
   }
 
-  return dbClient
+  return client
+}
+
+export const getAllDbClients = (): Record<string, IDatabaseClient> => {
+  return dbClients
 }

package/src/db/mysqlClient.ts

@@ -1,10 +1,84 @@
 import { Pool } from 'mysql2/promise'
+import promiseRetry from 'promise-retry'
 import { IDatabaseClient } from './IDatabaseClient'
+import { RetryOptions } from '../default/types'
+import { monitor, MonitorEvents } from '../monitor/monitor'
 
-export const createMysqlClient = (pool: Pool): IDatabaseClient => ({
-  clientType: 'mysql',
-  query: async <T>(sql: string, params?: any[]): Promise<T> => {
-    const [rows] = await pool.execute(sql, params)
-    return rows as unknown as T
-  },
-})
+const transientErrorCodes = new Set([
+  'ECONNRESET',
+  'ETIMEDOUT',
+  'PROTOCOL_CONNECTION_LOST',
+  'ECONNREFUSED',
+])
+
+function isTransientError(error: any): boolean {
+  return error && error.code && transientErrorCodes.has(error.code)
+}
+
+export const createMysqlClient = (
+  pool: Pool,
+  retryOptions?: RetryOptions
+): IDatabaseClient => {
+  monitor.emit(MonitorEvents.CONNECTION_CREATED, {
+    clientType: 'mysql',
+    poolOptions: pool.config,
+  })
+
+  return {
+    clientType: 'mysql',
+    query: async <T>(sql: string, params?: any[]): Promise<T> => {
+      return promiseRetry(async (retry, attempt) => {
+        const startTime = Date.now()
+        try {
+          monitor.emit(MonitorEvents.QUERY_START, {
+            clientType: 'mysql',
+            sql,
+            params,
+            attempt,
+          })
+
+          const [rows] = await pool.execute(sql, params)
+
+          const elapsedTime = Date.now() - startTime
+          monitor.emit(MonitorEvents.QUERY_END, {
+            clientType: 'mysql',
+            sql,
+            params,
+            attempt,
+            elapsedTime,
+          })
+
+          return rows as unknown as T
+        } catch (error: any) {
+          const elapsedTime = Date.now() - startTime
+          monitor.emit(MonitorEvents.QUERY_ERROR, {
+            clientType: 'mysql',
+            sql,
+            params,
+            attempt,
+            elapsedTime,
+            error,
+          })
+
+          if (isTransientError(error)) {
+            console.warn(
+              `MySQL query attempt ${attempt} failed, retrying...`,
+              error
+            )
+            monitor.emit(MonitorEvents.RETRY_ATTEMPT, {
+              clientType: 'mysql',
+              sql,
+              params,
+              attempt,
+              error,
+            })
+
+            return retry(error)
+          }
+
+          throw error
+        }
+      }, retryOptions)
+    },
+  }
+}

package/src/db/pgClient.ts

@@ -1,5 +1,14 @@
-import { Pool } from 'pg'
+import { Pool, PoolConfig } from 'pg'
+import promiseRetry from 'promise-retry'
 import { IDatabaseClient } from './IDatabaseClient'
+import { RetryOptions } from '../default/types'
+import { monitor, MonitorEvents } from '../monitor/monitor'
+
+const transientErrorCodes = new Set(['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED'])
+
+function isTransientError(error: any): boolean {
+  return error && error.code && transientErrorCodes.has(error.code)
+}
 
 async function ensureUnaccentExtension(pool: Pool): Promise<void> {
   try {
@@ -9,11 +18,23 @@ async function ensureUnaccentExtension(pool: Pool): Promise<void> {
 
     if (checkResult.rows.length === 0) {
       await pool.query('CREATE EXTENSION IF NOT EXISTS unaccent')
-      throw new Error(
+
+      monitor.emit(MonitorEvents.CONNECTION_CREATED, {
+        clientType: 'pg',
+        extension: 'unaccent',
+        status: 'installed',
+      })
+
+      console.info(
         '@starbemtech/star-db-query-builder: Extensão unaccent instalada com sucesso.'
       )
     }
   } catch (error) {
+    monitor.emit(MonitorEvents.QUERY_ERROR, {
+      clientType: 'pg',
+      action: 'install_unaccent',
+      error,
+    })
     throw new Error(
       `@starbemtech/star-db-query-builder: Não foi possível instalar a extensão unaccent:
       ${error}`
@@ -21,14 +42,74 @@ async function ensureUnaccentExtension(pool: Pool): Promise<void> {
   }
 }
 
-export const createPgClient = async (pool: Pool): Promise<IDatabaseClient> => {
+export const createPgClient = async (
+  pool: Pool,
+  retryOptions?: RetryOptions,
+  poolConfig?: PoolConfig
+): Promise<IDatabaseClient> => {
   await ensureUnaccentExtension(pool)
 
+  monitor.emit(MonitorEvents.CONNECTION_CREATED, {
+    clientType: 'pg',
+    poolOptions: poolConfig,
+  })
+
   return {
     clientType: 'pg',
     query: async <T>(sql: string, params?: any[]): Promise<T> => {
-      const { rows } = await pool.query(sql, params)
-      return rows as unknown as T
+      return promiseRetry(async (retry, attempt) => {
+        const startTime = Date.now()
+        try {
+          monitor.emit(MonitorEvents.QUERY_START, {
+            clientType: 'pg',
+            sql,
+            params,
+            attempt,
+          })
+
+          const { rows } = await pool.query(sql, params)
+
+          const elapsedTime = Date.now() - startTime
+          monitor.emit(MonitorEvents.QUERY_END, {
+            clientType: 'pg',
+            sql,
+            params,
+            attempt,
+            elapsedTime,
+          })
+
+          return rows as unknown as T
+        } catch (error) {
+          const elapsedTime = Date.now() - startTime
+          monitor.emit(MonitorEvents.QUERY_ERROR, {
+            clientType: 'pg',
+            sql,
+            params,
+            attempt,
+            elapsedTime,
+            error,
+          })
+
+          if (isTransientError(error)) {
+            console.warn(
+              `Postgres query attempt ${attempt} failed, retrying...`,
+              error
+            )
+
+            monitor.emit(MonitorEvents.RETRY_ATTEMPT, {
+              clientType: 'pg',
+              sql,
+              params,
+              attempt,
+              error,
+            })
+
+            return retry(error)
+          }
+
+          throw error
+        }
+      }, retryOptions)
     },
   }
 }

package/src/default/types.ts

@@ -1,5 +1,13 @@
 import { IDatabaseClient } from '../db/IDatabaseClient'
 
+export interface RetryOptions {
+  retries?: number
+  factor?: number
+  minTimeout?: number
+  maxTimeout?: number
+  randomize?: boolean
+}
+
 export interface QueryExec {
   text: string
   values?: any[]

package/src/monitor/monitor.ts

@@ -0,0 +1,11 @@
+import { EventEmitter } from 'stream'
+
+export enum MonitorEvents {
+  CONNECTION_CREATED = 'connection_created',
+  QUERY_START = 'query_start',
+  QUERY_END = 'query_end',
+  QUERY_ERROR = 'query_error',
+  RETRY_ATTEMPT = 'retry_attempt',
+}
+
+export const monitor = new EventEmitter()

package/src/services/payment/index.ts

@@ -1,31 +0,0 @@
-import { createSelectFields, createWhereClause } from '../../default/utils'
-import { QueryParams } from '../../default/types'
-
-export const getByUserAndSubscription = async <T>({
-  tableName,
-  dbClient,
-  select,
-  where,
-}: QueryParams<T>): Promise<T | null> => {
-  if (!tableName) throw new Error('Table name is required')
-  if (!dbClient) throw new Error('DB client is required')
-
-  const fields = createSelectFields(select, dbClient.clientType)
-  const [whereClause, params] = createWhereClause<T>(
-    where,
-    1,
-    dbClient.clientType
-  )
-
-  const rows = await dbClient.query<T>(
-    `SELECT 
-        ${fields}
-      FROM payments.plan_association_users pa
-      LEFT JOIN payments.plans ON pa.plan_id = plans.id
-        ${whereClause}
-        AND pa.status IN ('active', 'cancelation_requested', 'blocked')`,
-    params
-  )
-
-  return rows || null
-}