@starbemtech/star-db-query-builder 1.3.0 → 1.4.0

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

@@ -10,6 +10,7 @@ import { DBClients, RetryOptions } from '../core/types';
  * @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)
+ * @param config.queryTimeout - Optional query timeout in milliseconds, applied to every query run through this client. For PostgreSQL this maps onto the pool's `query_timeout` (an explicit `query_timeout` in `options` takes precedence). For MySQL, since mysql2 has no pool-wide query timeout, it is passed as the `timeout` option on every individual query.
  * @returns Promise<void> - Resolves when the database client is successfully initialized
  *
  * @throws {Error} When type is not provided or is invalid
@@ -29,7 +30,8 @@ import { DBClients, RetryOptions } from '../core/types';
  *     password: 'password'
  *   },
  *   retryOptions: { maxRetries: 3, delay: 1000 },
- *   installUnaccentExtension: true
+ *   installUnaccentExtension: true,
+ *   queryTimeout: 5000
  * });
  *
  * @example
@@ -44,7 +46,8 @@ import { DBClients, RetryOptions } from '../core/types';
  *     user: 'user',
  *     password: 'password'
  *   },
- *   retryOptions: { maxRetries: 3, delay: 1000 }
+ *   retryOptions: { maxRetries: 3, delay: 1000 },
+ *   queryTimeout: 5000
  * });
  */
 export declare const initDb: <T>(config: {
@@ -53,55 +56,8 @@ export declare const initDb: <T>(config: {
     options: T;
     retryOptions?: RetryOptions;
     installUnaccentExtension?: boolean;
+    queryTimeout?: number;
 }) => Promise<void>;
-/**
- * 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 }
- * });
- */
-export declare const getDbClient: (name?: string) => IDatabaseClient;
 /**
  * Retrieves a specific database client by name
  *
@@ -127,4 +83,58 @@ export declare const getDbClient: (name?: string) => IDatabaseClient;
  *   console.error('Database client not found:', error.message);
  * }
  */
+export declare const getDbClient: (name?: string) => IDatabaseClient;
+/**
+ * Retrieves every registered database client, keyed by name
+ *
+ * @returns Record<string, IDatabaseClient> - A map of all initialized database clients, keyed by the name they were registered under (including 'default')
+ *
+ * @example
+ * const clients = getAllDbClients();
+ * const names = Object.keys(clients); // ['default', 'myPostgresDb', 'myMysqlDb']
+ */
 export declare const getAllDbClients: () => Record<string, IDatabaseClient>;
+/**
+ * Closes a database client's connection pool and removes it from the registry
+ *
+ * Use this to release connections gracefully on application shutdown or
+ * between tests, since `initDb` has no other way to release the pools it
+ * creates.
+ *
+ * @param name - Optional name of the database client to close. If not provided, closes the default client
+ * @returns Promise<void> - Resolves when the pool has been closed
+ *
+ * @throws {Error} When the specified database client name is not found or not initialized
+ *
+ * @example
+ * await closeDb() // closes the default client
+ *
+ * @example
+ * await closeDb('myPostgresDb')
+ */
+export declare const closeDb: (name?: string) => Promise<void>;
+/**
+ * Closes every registered database client's connection pool
+ *
+ * @returns Promise<void> - Resolves when all pools have been closed
+ *
+ * @example
+ * await closeAllDbClients()
+ */
+export declare const closeAllDbClients: () => Promise<void>;
+/**
+ * Clears the in-memory client/pool registry without closing any connection
+ *
+ * This is a synchronous escape hatch for test suites and hot-reload tooling
+ * that need a clean registry between runs (e.g. calling `initDb` again with
+ * the same name without first awaiting a real `closeDb`). It does NOT call
+ * `pool.end()`, so any real (non-mocked) connection pool that was registered
+ * is orphaned — leaked, not released. Production code that wants to release
+ * connections should use `closeDb`/`closeAllDbClients` instead.
+ *
+ * @example
+ * afterEach(() => {
+ *   resetDbClients() // test isolation only — pools here are mocked
+ * })
+ */
+export declare const resetDbClients: () => void;

package/dist/src/db/initDb.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAllDbClients = exports.getDbClient = exports.initDb = void 0;
+exports.resetDbClients = exports.closeAllDbClients = exports.closeDb = 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");
 const dbClients = {};
+const dbPools = {};
 const defaultName = 'default';
 /**
  * Initialize a database client with the specified configuration
@@ -17,6 +18,7 @@ const defaultName = 'default';
  * @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)
+ * @param config.queryTimeout - Optional query timeout in milliseconds, applied to every query run through this client. For PostgreSQL this maps onto the pool's `query_timeout` (an explicit `query_timeout` in `options` takes precedence). For MySQL, since mysql2 has no pool-wide query timeout, it is passed as the `timeout` option on every individual query.
  * @returns Promise<void> - Resolves when the database client is successfully initialized
  *
  * @throws {Error} When type is not provided or is invalid
@@ -36,7 +38,8 @@ const defaultName = 'default';
  *     password: 'password'
  *   },
  *   retryOptions: { maxRetries: 3, delay: 1000 },
- *   installUnaccentExtension: true
+ *   installUnaccentExtension: true,
+ *   queryTimeout: 5000
  * });
  *
  * @example
@@ -51,7 +54,8 @@ const defaultName = 'default';
  *     user: 'user',
  *     password: 'password'
  *   },
- *   retryOptions: { maxRetries: 3, delay: 1000 }
+ *   retryOptions: { maxRetries: 3, delay: 1000 },
+ *   queryTimeout: 5000
  * });
  */
 const initDb = async (config) => {
@@ -59,77 +63,26 @@ const initDb = async (config) => {
         throw new Error('Type is required. Accept values: pg | mysql');
     if (!config.options)
         throw new Error('Connection options is required');
+    const key = config.name || defaultName;
     if (config.type === 'pg') {
-        const poolConfig = config.options;
-        const pool = new pg_1.Pool(config.options);
-        dbClients[config.name || defaultName] = await (0, pgClient_1.createPgClient)(pool, config.retryOptions, poolConfig, config.installUnaccentExtension);
-        console.log(`@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`);
+        const options = config.options;
+        const poolConfig = config.queryTimeout && options.query_timeout === undefined
+            ? { ...options, query_timeout: config.queryTimeout }
+            : options;
+        const pool = new pg_1.Pool(poolConfig);
+        dbClients[key] = await (0, pgClient_1.createPgClient)(pool, config.retryOptions, poolConfig, config.installUnaccentExtension);
+        dbPools[key] = pool;
     }
     else if (config.type === 'mysql') {
         const pool = (0, promise_1.createPool)(config.options);
-        dbClients[config.name || defaultName] = (0, mysqlClient_1.createMysqlClient)(pool, config.retryOptions);
-        console.info(`@starbemtech/star-db-query-builder: Postgres db client "${config.name}" created successfully`);
+        dbClients[key] = (0, mysqlClient_1.createMysqlClient)(pool, config.retryOptions, config.queryTimeout);
+        dbPools[key] = pool;
     }
     else {
         throw new Error('Unsupported database type');
     }
 };
 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) {
-        throw new Error(`Database client "${name}" is not initialized`);
-    }
-    return client;
-};
-exports.getDbClient = getDbClient;
 /**
  * Retrieves a specific database client by name
  *
@@ -155,8 +108,87 @@ exports.getDbClient = getDbClient;
  *   console.error('Database client not found:', error.message);
  * }
  */
+const getDbClient = (name) => {
+    const key = name || defaultName;
+    const client = dbClients[key];
+    if (!client) {
+        throw new Error(`Database client "${key}" is not initialized`);
+    }
+    return client;
+};
+exports.getDbClient = getDbClient;
+/**
+ * Retrieves every registered database client, keyed by name
+ *
+ * @returns Record<string, IDatabaseClient> - A map of all initialized database clients, keyed by the name they were registered under (including 'default')
+ *
+ * @example
+ * const clients = getAllDbClients();
+ * const names = Object.keys(clients); // ['default', 'myPostgresDb', 'myMysqlDb']
+ */
 const getAllDbClients = () => {
     return dbClients;
 };
 exports.getAllDbClients = getAllDbClients;
+/**
+ * Closes a database client's connection pool and removes it from the registry
+ *
+ * Use this to release connections gracefully on application shutdown or
+ * between tests, since `initDb` has no other way to release the pools it
+ * creates.
+ *
+ * @param name - Optional name of the database client to close. If not provided, closes the default client
+ * @returns Promise<void> - Resolves when the pool has been closed
+ *
+ * @throws {Error} When the specified database client name is not found or not initialized
+ *
+ * @example
+ * await closeDb() // closes the default client
+ *
+ * @example
+ * await closeDb('myPostgresDb')
+ */
+const closeDb = async (name) => {
+    const key = name || defaultName;
+    const pool = dbPools[key];
+    if (!pool) {
+        throw new Error(`Database client "${key}" is not initialized`);
+    }
+    await pool.end();
+    delete dbPools[key];
+    delete dbClients[key];
+};
+exports.closeDb = closeDb;
+/**
+ * Closes every registered database client's connection pool
+ *
+ * @returns Promise<void> - Resolves when all pools have been closed
+ *
+ * @example
+ * await closeAllDbClients()
+ */
+const closeAllDbClients = async () => {
+    await Promise.all(Object.keys(dbPools).map((key) => (0, exports.closeDb)(key)));
+};
+exports.closeAllDbClients = closeAllDbClients;
+/**
+ * Clears the in-memory client/pool registry without closing any connection
+ *
+ * This is a synchronous escape hatch for test suites and hot-reload tooling
+ * that need a clean registry between runs (e.g. calling `initDb` again with
+ * the same name without first awaiting a real `closeDb`). It does NOT call
+ * `pool.end()`, so any real (non-mocked) connection pool that was registered
+ * is orphaned — leaked, not released. Production code that wants to release
+ * connections should use `closeDb`/`closeAllDbClients` instead.
+ *
+ * @example
+ * afterEach(() => {
+ *   resetDbClients() // test isolation only — pools here are mocked
+ * })
+ */
+const resetDbClients = () => {
+    Object.keys(dbClients).forEach((key) => delete dbClients[key]);
+    Object.keys(dbPools).forEach((key) => delete dbPools[key]);
+};
+exports.resetDbClients = resetDbClients;
 //# 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,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"}
+{"version":3,"file":"initDb.js","sourceRoot":"","sources":["../../../src/db/initDb.ts"],"names":[],"mappings":"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"}

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

@@ -9,18 +9,13 @@ import { RetryOptions } from '../core/types';
  *
  * @param pool - The MySQL pool instance
  * @param retryOptions - Optional retry options for failed queries
+ * @param queryTimeout - Optional query timeout in milliseconds, applied to every query since mysql2 has no pool-wide timeout option (only a per-query one)
  * @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 mysqlClient = createMysqlClient(pool, undefined, 5000); // 5s query timeout
  */
-export declare const createMysqlClient: (pool: Pool, retryOptions?: RetryOptions) => IDatabaseClient;
+export declare const createMysqlClient: (pool: Pool, retryOptions?: RetryOptions, queryTimeout?: number) => IDatabaseClient;

package/dist/src/db/mysqlClient.js

@@ -46,21 +46,16 @@ function isTransientError(error) {
  *
  * @param pool - The MySQL pool instance
  * @param retryOptions - Optional retry options for failed queries
+ * @param queryTimeout - Optional query timeout in milliseconds, applied to every query since mysql2 has no pool-wide timeout option (only a per-query one)
  * @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 mysqlClient = createMysqlClient(pool, undefined, 5000); // 5s query timeout
  */
-const createMysqlClient = (pool, retryOptions) => {
+const createMysqlClient = (pool, retryOptions, queryTimeout) => {
     monitor_1.monitor.emit(monitor_1.MonitorEvents.CONNECTION_CREATED, {
         clientType: 'mysql',
         poolOptions: pool.config,
@@ -77,7 +72,9 @@ const createMysqlClient = (pool, retryOptions) => {
                         params,
                         attempt,
                     });
-                    const [rows] = await pool.execute(sql, params);
+                    const [rows] = queryTimeout
+                        ? await pool.execute({ sql, timeout: queryTimeout }, params)
+                        : await pool.execute(sql, params);
                     const elapsedTime = Date.now() - startTime;
                     monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
                         clientType: 'mysql',
@@ -99,7 +96,6 @@ const createMysqlClient = (pool, retryOptions) => {
                         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,
@@ -128,7 +124,9 @@ const createMysqlClient = (pool, retryOptions) => {
                                 attempt: 1,
                                 inTransaction: true,
                             });
-                            const [rows] = await connection.execute(sql, params);
+                            const [rows] = queryTimeout
+                                ? await connection.execute({ sql, timeout: queryTimeout }, params)
+                                : await connection.execute(sql, params);
                             const elapsedTime = Date.now() - startTime;
                             monitor_1.monitor.emit(monitor_1.MonitorEvents.QUERY_END, {
                                 clientType: 'mysql',

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

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

package/dist/src/db/pgClient.js

@@ -58,7 +58,6 @@ async function ensureUnaccentExtension(pool) {
                 extension: 'unaccent',
                 status: 'installed',
             });
-            console.info('@starbemtech/star-db-query-builder: Extensão unaccent instalada com sucesso.');
         }
     }
     catch (error) {
@@ -134,7 +133,6 @@ const createPgClient = async (pool, retryOptions, poolConfig, installUnaccentExt
                         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,

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.js

@@ -16,4 +16,11 @@ var MonitorEvents;
     MonitorEvents["TRANSACTION_ROLLBACK"] = "transaction_rollback";
 })(MonitorEvents || (exports.MonitorEvents = MonitorEvents = {}));
 exports.monitor = new stream_1.EventEmitter();
+// This is a shared singleton: an app using multiple named db clients
+// (see initDb's `name` option) can easily attach more than the default 10
+// listeners per event (e.g. one logger/metrics/tracing consumer per client),
+// without that being a real leak. Raise the cap instead of letting Node warn
+// on a legitimate multi-client setup; still bounded (not 0/Infinity) so an
+// actual listener leak keeps surfacing a warning.
+exports.monitor.setMaxListeners(20);
 //# 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;;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"}
+{"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;AAEzC,qEAAqE;AACrE,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,kDAAkD;AAClD,eAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA"}

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "@starbemtech/star-db-query-builder",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A query builder to be used with mysql or postgres",
   "author": "Julio Sousa <julio.sousa@starbem.app>",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "star-db-query-builder-install-skill": "./bin/install-skill.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    ".claude",
+    "CHANGELOG.md"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=18"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/starbem/star-db-query-builder.git"
+    "url": "git+https://github.com/Starbem/star-db-query-builder.git"
   },
   "bugs": {
-    "url": "https://github.com/starbem/star-db-query-builder/issues"
+    "url": "https://github.com/Starbem/star-db-query-builder/issues"
   },
   "keywords": [
     "javascript",
@@ -36,6 +45,7 @@
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
     "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
     "type:check": "tsc --noEmit",
     "clean": "rm -rf dist coverage",
     "prebuild": "npm run clean",
@@ -49,34 +59,32 @@
     "prepublishOnly": "npm run clean && npm run build && npm run test:ci"
   },
   "dependencies": {
-    "mysql2": "^3.14.5",
-    "pg": "^8.16.3",
+    "mysql2": "^3.24.3",
+    "pg": "^8.23.0",
     "promise-retry": "^2.0.1",
-    "uuid": "^11.1.0"
+    "uuid": "^11.1.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.35.0",
+    "@eslint/js": "^9.39.5",
     "@types/jest": "^29.5.14",
     "@types/mysql": "^2.15.27",
-    "@types/node": "^24.3.1",
-    "@types/pg": "^8.15.5",
+    "@types/node": "^24.13.3",
+    "@types/pg": "^8.23.1",
     "@types/promise-retry": "^1.1.6",
     "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^9.35.0",
+    "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jest": "^28.14.0",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.3.0",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^16.5.0",
     "husky": "^9.1.7",
     "jest": "^29.7.0",
-    "lint-staged": "^16.1.6",
-    "prettier": "^3.6.2",
-    "ts-jest": "^29.4.1",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.9.6",
+    "ts-jest": "^29.4.12",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.43.0"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.69.0"
   },
   "lint-staged": {
     "*.{ts}": [
@@ -90,4 +98,4 @@
     }
   },
   "packageManager": "pnpm@8.6.2"
-}
+}