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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/.github/workflows/publish.yml +118 -0
  2. package/ARCHITECTURE.md +313 -0
  3. package/CHANGELOG.md +65 -0
  4. package/README.md +1275 -210
  5. package/coverage/base.css +224 -0
  6. package/coverage/block-navigation.js +87 -0
  7. package/coverage/favicon.png +0 -0
  8. package/coverage/index.html +131 -0
  9. package/coverage/lcov-report/base.css +224 -0
  10. package/coverage/lcov-report/block-navigation.js +87 -0
  11. package/coverage/lcov-report/favicon.png +0 -0
  12. package/coverage/lcov-report/index.html +131 -0
  13. package/coverage/lcov-report/mysqlClient.ts.html +685 -0
  14. package/coverage/lcov-report/pgClient.ts.html +823 -0
  15. package/coverage/lcov-report/prettify.css +1 -0
  16. package/coverage/lcov-report/prettify.js +2 -0
  17. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  18. package/coverage/lcov-report/sorter.js +210 -0
  19. package/coverage/lcov.info +533 -0
  20. package/coverage/mysqlClient.ts.html +685 -0
  21. package/coverage/pgClient.ts.html +823 -0
  22. package/coverage/prettify.css +1 -0
  23. package/coverage/prettify.js +2 -0
  24. package/coverage/sort-arrow-sprite.png +0 -0
  25. package/coverage/sorter.js +210 -0
  26. package/dist/index.d.ts +5 -4
  27. package/dist/index.js +1 -1
  28. package/dist/index.js.map +1 -1
  29. package/dist/src/core/repository.d.ts +374 -0
  30. package/dist/src/core/repository.js +677 -0
  31. package/dist/src/core/repository.js.map +1 -0
  32. package/dist/src/{default → core}/types.d.ts +9 -1
  33. package/dist/src/{default → core}/types.js.map +1 -1
  34. package/dist/src/core/utils.d.ts +133 -0
  35. package/dist/src/{default → core}/utils.js +167 -0
  36. package/dist/src/core/utils.js.map +1 -0
  37. package/dist/src/db/IDatabaseClient.d.ts +10 -1
  38. package/dist/src/db/initDb.d.ts +120 -1
  39. package/dist/src/db/initDb.js +119 -0
  40. package/dist/src/db/initDb.js.map +1 -1
  41. package/dist/src/db/mysqlClient.d.ts +23 -1
  42. package/dist/src/db/mysqlClient.js +115 -0
  43. package/dist/src/db/mysqlClient.js.map +1 -1
  44. package/dist/src/db/pgClient.d.ts +22 -1
  45. package/dist/src/db/pgClient.js +127 -0
  46. package/dist/src/db/pgClient.js.map +1 -1
  47. package/dist/src/monitor/monitor.d.ts +6 -1
  48. package/dist/src/monitor/monitor.js +5 -0
  49. package/dist/src/monitor/monitor.js.map +1 -1
  50. package/dist/src/setupTests.d.ts +26 -0
  51. package/dist/src/setupTests.js +43 -0
  52. package/dist/src/setupTests.js.map +1 -0
  53. package/docs/INDEX.md +145 -0
  54. package/docs/methods/findFirst.md +394 -0
  55. package/docs/methods/findMany.md +587 -0
  56. package/docs/methods/insert.md +536 -0
  57. package/docs/methods/insertMany.md +627 -0
  58. package/docs/methods/joins.md +781 -0
  59. package/docs/methods/rawQuery.md +284 -0
  60. package/docs/methods/transactions.md +737 -0
  61. package/eslint.config.mjs +77 -0
  62. package/index.ts +5 -4
  63. package/jest.config.ts +23 -28
  64. package/package.json +52 -29
  65. package/scripts/release.sh +123 -0
  66. package/src/core/repository.ts +865 -0
  67. package/src/{default → core}/types.ts +11 -2
  68. package/src/{default → core}/utils.ts +168 -0
  69. package/src/db/IDatabaseClient.ts +11 -1
  70. package/src/db/__tests__/mysqlClient.test.ts +262 -0
  71. package/src/db/__tests__/pgClient.test.ts +260 -0
  72. package/src/db/initDb.ts +120 -1
  73. package/src/db/mysqlClient.ts +119 -3
  74. package/src/db/pgClient.ts +131 -3
  75. package/src/monitor/monitor.ts +5 -0
  76. package/src/setupTests.ts +45 -0
  77. package/tsconfig.test.json +21 -0
  78. package/.eslintignore +0 -4
  79. package/.eslintrc.json +0 -32
  80. package/dist/.eslintrc.json +0 -32
  81. package/dist/src/default/genericRepository.d.ts +0 -28
  82. package/dist/src/default/genericRepository.js +0 -284
  83. package/dist/src/default/genericRepository.js.map +0 -1
  84. package/dist/src/default/utils.d.ts +0 -9
  85. package/dist/src/default/utils.js.map +0 -1
  86. package/index.d.ts +0 -60
  87. package/src/default/genericRepository.ts +0 -461
  88. /package/dist/src/{default → core}/types.js +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/core/repository.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@ export interface QueryExec {
10
10
  text: string;
11
11
  values?: any[];
12
12
  }
13
- type SimpleValue = string | number | boolean | Date;
13
+ type SimpleValue = string | number | boolean | Date | null;
14
14
  export interface OperatorCondition {
15
15
  operator: 'ILIKE' | 'LIKE' | '=' | '>' | '<' | 'IN' | 'BETWEEN' | '!=' | '<=' | '>=' | 'NOT IN' | 'LIKE' | 'NOT LIKE' | 'IS NULL' | 'IS NOT NULL' | 'NOT EXISTS';
16
16
  value: SimpleValue | SimpleValue[];
@@ -59,4 +59,12 @@ export interface QueryBuilder {
59
59
  limit?: string;
60
60
  offset?: string;
61
61
  }
62
+ export interface RawQueryParams {
63
+ dbClient: IDatabaseClient;
64
+ sql: string;
65
+ params?: any[];
66
+ }
67
+ export interface TransactionParams {
68
+ dbClient: IDatabaseClient;
69
+ }
62
70
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/default/types.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,133 @@
1
+ import { Conditions, OrderBy, DBClients } from './types';
2
+ /**
3
+ * Creates a SELECT clause for a query
4
+ *
5
+ * This function creates a SELECT clause for a query. It takes an array of fields
6
+ * and a database client type and returns a string with the fields separated by commas.
7
+ *
8
+ * @param fields - The array of fields to select
9
+ * @param clientType - The type of database client
10
+ * @returns A string with the fields separated by commas
11
+ *
12
+ * @example
13
+ * const fields = ['id', 'name', 'email']
14
+ * const clientType = 'pg'
15
+ * const result = createSelectFields(fields, clientType)
16
+ * // result will be: "id, name, email"
17
+ */
18
+ export declare const createSelectFields: (fields: string[] | undefined, clientType: DBClients) => string;
19
+ /**
20
+ * Generates placeholders for a query
21
+ *
22
+ * This function generates placeholders for a query. It takes an array of keys
23
+ * and a database client type and returns a string with the placeholders separated by commas.
24
+ *
25
+ * @param keys - The array of keys to generate placeholders for
26
+ * @param clientType - The type of database client
27
+ * @returns A string with the placeholders separated by commas
28
+ *
29
+ * @example
30
+ * const keys = ['id', 'name', 'email']
31
+ * const clientType = 'pg'
32
+ * const result = generatePlaceholders(keys, clientType)
33
+ * // result will be: $1, $2, $3
34
+ */
35
+ export declare const generatePlaceholders: (keys: any[], clientType: DBClients) => string;
36
+ /**
37
+ * Generates a SET clause for a query
38
+ *
39
+ * This function generates a SET clause for a query. It takes an array of keys
40
+ * and a database client type and returns a string with the keys and placeholders separated by commas.
41
+ *
42
+ * @param keys - The array of keys to generate SET clause for
43
+ * @param clientType - The type of database client
44
+ * @returns A string with the keys and placeholders separated by commas
45
+ *
46
+ * @example
47
+ * const keys = ['id', 'name', 'email']
48
+ * const clientType = 'pg'
49
+ * const result = generateSetClause(keys, clientType)
50
+ * // result will be: "id = $1, name = $2, email = $3"
51
+ */
52
+ export declare const generateSetClause: (keys: any[], clientType: DBClients) => string;
53
+ /**
54
+ * Creates a WHERE clause for a query
55
+ *
56
+ * This function creates a WHERE clause for a query. It takes an array of conditions
57
+ * and a database client type and returns a string with the conditions separated by AND.
58
+ *
59
+ * @param conditions - The array of conditions to create WHERE clause for
60
+ * @param startIndex - The index of the first parameter
61
+ * @param clientType - The type of database client
62
+ * @param unaccent - Whether to use unaccent function
63
+ * @returns A string with the conditions separated by AND
64
+ *
65
+ * @example
66
+ * const conditions = [{ field: 'name', operator: '=', value: 'John Doe' }]
67
+ * const startIndex = 1
68
+ * const clientType = 'pg'
69
+ * const unaccent = true
70
+ * const result = createWhereClause(conditions, startIndex, clientType, unaccent)
71
+ * // result will be: "name = $1"
72
+ */
73
+ export declare const createWhereClause: <T>(conditions: Conditions<T> | undefined, startIndex: number | undefined, clientType: DBClients, unaccent?: boolean) => [string, any[], number];
74
+ /**
75
+ * Creates an ORDER BY clause for a query
76
+ *
77
+ * This function creates an ORDER BY clause for a query. It takes an array of
78
+ * order by fields and returns a string with the fields separated by commas.
79
+ *
80
+ * @param orderBy - The array of order by fields
81
+ * @returns A string with the fields separated by commas
82
+ *
83
+ * @example
84
+ * const orderBy = [{ field: 'created_at', direction: 'DESC' }]
85
+ * const result = createOrderByClause(orderBy)
86
+ * // result will be: "ORDER BY created_at DESC"
87
+ */
88
+ export declare const createOrderByClause: (orderBy?: OrderBy) => string;
89
+ /**
90
+ * Creates a GROUP BY clause for a query
91
+ *
92
+ * This function creates a GROUP BY clause for a query. It takes an array of
93
+ * group by fields and returns a string with the fields separated by commas.
94
+ *
95
+ * @param groupBy - The array of group by fields
96
+ * @returns A string with the fields separated by commas
97
+ *
98
+ * @example
99
+ * const groupBy = ['status']
100
+ * const result = createGroupByClause(groupBy)
101
+ * // result will be: "GROUP BY status"
102
+ */
103
+ export declare const createGroupByClause: (groupBy?: string[]) => string;
104
+ /**
105
+ * Creates a LIMIT clause for a query
106
+ *
107
+ * This function creates a LIMIT clause for a query. It takes a limit number
108
+ * and returns a string with the limit.
109
+ *
110
+ * @param limit - The limit number
111
+ * @returns A string with the limit
112
+ *
113
+ * @example
114
+ * const limit = 10
115
+ * const result = createLimitClause(limit)
116
+ * // result will be: "LIMIT 10"
117
+ */
118
+ export declare const createLimitClause: (limit?: number) => string;
119
+ /**
120
+ * Creates an OFFSET clause for a query
121
+ *
122
+ * This function creates an OFFSET clause for a query. It takes an offset number
123
+ * and returns a string with the offset.
124
+ *
125
+ * @param offset - The offset number
126
+ * @returns A string with the offset
127
+ *
128
+ * @example
129
+ * const offset = 10
130
+ * const result = createOffsetClause(offset)
131
+ * // result will be: "OFFSET 10"
132
+ */
133
+ export declare const createOffsetClause: (offset?: number) => string;
@@ -1,30 +1,141 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.createOffsetClause = exports.createLimitClause = exports.createGroupByClause = exports.createOrderByClause = exports.createWhereClause = exports.generateSetClause = exports.generatePlaceholders = exports.createSelectFields = void 0;
4
+ /**
5
+ * Converts an array of strings to a comma-separated string with quotes
6
+ *
7
+ * This function takes an array of strings and converts it to a comma-separated string
8
+ * with quotes. It handles the differences between PostgreSQL and MySQL syntax for
9
+ * string arrays.
10
+ *
11
+ * @param items - The array of strings to convert
12
+ * @param clientType - The type of database client
13
+ * @returns A comma-separated string with quotes
14
+ *
15
+ * @example
16
+ * const items = ['item1', 'item2', 'item3']
17
+ * const clientType = 'pg'
18
+ * const result = arrayToStringWithQuotes(items, clientType)
19
+ * // result will be: 'item1', 'item2', 'item3'
20
+ */
4
21
  const arrayToStringWithQuotes = (items, clientType) => {
5
22
  const itemsWithQuotes = items.map((item) => clientType === 'pg' ? `${item}` : `${item}`);
6
23
  return itemsWithQuotes.join(', ');
7
24
  };
25
+ /**
26
+ * Generates a PostgreSQL placeholder for a parameter
27
+ *
28
+ * This function generates a PostgreSQL placeholder for a parameter. It returns
29
+ * a string with a dollar sign and the index of the parameter.
30
+ *
31
+ * @param index - The index of the parameter
32
+ * @returns A PostgreSQL placeholder
33
+ *
34
+ * @example
35
+ * const index = 1
36
+ * const placeholder = pgPlaceholderGenerator(index)
37
+ * // placeholder will be: $1
38
+ */
8
39
  const pgPlaceholderGenerator = (index) => `$${index}`;
40
+ /**
41
+ * Generates a MySQL placeholder for a parameter
42
+ *
43
+ * This function generates a MySQL placeholder for a parameter. It returns
44
+ * a string with a question mark.
45
+ *
46
+ * @returns A MySQL placeholder
47
+ *
48
+ * @example
49
+ * const placeholder = mysqlPlaceholderGenerator()
50
+ * // placeholder will be: ?
51
+ */
9
52
  const mysqlPlaceholderGenerator = () => `?`;
53
+ /**
54
+ * Creates a SELECT clause for a query
55
+ *
56
+ * This function creates a SELECT clause for a query. It takes an array of fields
57
+ * and a database client type and returns a string with the fields separated by commas.
58
+ *
59
+ * @param fields - The array of fields to select
60
+ * @param clientType - The type of database client
61
+ * @returns A string with the fields separated by commas
62
+ *
63
+ * @example
64
+ * const fields = ['id', 'name', 'email']
65
+ * const clientType = 'pg'
66
+ * const result = createSelectFields(fields, clientType)
67
+ * // result will be: "id, name, email"
68
+ */
10
69
  const createSelectFields = (fields = [], clientType) => {
11
70
  return fields && fields.length > 0
12
71
  ? arrayToStringWithQuotes(fields, clientType)
13
72
  : '*';
14
73
  };
15
74
  exports.createSelectFields = createSelectFields;
75
+ /**
76
+ * Generates placeholders for a query
77
+ *
78
+ * This function generates placeholders for a query. It takes an array of keys
79
+ * and a database client type and returns a string with the placeholders separated by commas.
80
+ *
81
+ * @param keys - The array of keys to generate placeholders for
82
+ * @param clientType - The type of database client
83
+ * @returns A string with the placeholders separated by commas
84
+ *
85
+ * @example
86
+ * const keys = ['id', 'name', 'email']
87
+ * const clientType = 'pg'
88
+ * const result = generatePlaceholders(keys, clientType)
89
+ * // result will be: $1, $2, $3
90
+ */
16
91
  const generatePlaceholders = (keys, clientType) => {
17
92
  return keys
18
93
  .map((_, index) => (clientType === 'pg' ? `$${index + 1}` : '?'))
19
94
  .join(', ');
20
95
  };
21
96
  exports.generatePlaceholders = generatePlaceholders;
97
+ /**
98
+ * Generates a SET clause for a query
99
+ *
100
+ * This function generates a SET clause for a query. It takes an array of keys
101
+ * and a database client type and returns a string with the keys and placeholders separated by commas.
102
+ *
103
+ * @param keys - The array of keys to generate SET clause for
104
+ * @param clientType - The type of database client
105
+ * @returns A string with the keys and placeholders separated by commas
106
+ *
107
+ * @example
108
+ * const keys = ['id', 'name', 'email']
109
+ * const clientType = 'pg'
110
+ * const result = generateSetClause(keys, clientType)
111
+ * // result will be: "id = $1, name = $2, email = $3"
112
+ */
22
113
  const generateSetClause = (keys, clientType) => {
23
114
  return keys
24
115
  .map((key, index) => clientType === 'pg' ? `${key} = $${index + 1}` : `${key} = ?`)
25
116
  .join(', ');
26
117
  };
27
118
  exports.generateSetClause = generateSetClause;
119
+ /**
120
+ * Creates a WHERE clause for a query
121
+ *
122
+ * This function creates a WHERE clause for a query. It takes an array of conditions
123
+ * and a database client type and returns a string with the conditions separated by AND.
124
+ *
125
+ * @param conditions - The array of conditions to create WHERE clause for
126
+ * @param startIndex - The index of the first parameter
127
+ * @param clientType - The type of database client
128
+ * @param unaccent - Whether to use unaccent function
129
+ * @returns A string with the conditions separated by AND
130
+ *
131
+ * @example
132
+ * const conditions = [{ field: 'name', operator: '=', value: 'John Doe' }]
133
+ * const startIndex = 1
134
+ * const clientType = 'pg'
135
+ * const unaccent = true
136
+ * const result = createWhereClause(conditions, startIndex, clientType, unaccent)
137
+ * // result will be: "name = $1"
138
+ */
28
139
  const createWhereClause = (conditions = {}, startIndex = 1, clientType, unaccent) => {
29
140
  let index = startIndex;
30
141
  const whereParts = [];
@@ -124,6 +235,20 @@ const createWhereClause = (conditions = {}, startIndex = 1, clientType, unaccent
124
235
  return [whereClause, values, index];
125
236
  };
126
237
  exports.createWhereClause = createWhereClause;
238
+ /**
239
+ * Creates an ORDER BY clause for a query
240
+ *
241
+ * This function creates an ORDER BY clause for a query. It takes an array of
242
+ * order by fields and returns a string with the fields separated by commas.
243
+ *
244
+ * @param orderBy - The array of order by fields
245
+ * @returns A string with the fields separated by commas
246
+ *
247
+ * @example
248
+ * const orderBy = [{ field: 'created_at', direction: 'DESC' }]
249
+ * const result = createOrderByClause(orderBy)
250
+ * // result will be: "ORDER BY created_at DESC"
251
+ */
127
252
  const createOrderByClause = (orderBy) => {
128
253
  if (!orderBy || orderBy.length === 0)
129
254
  return '';
@@ -131,18 +256,60 @@ const createOrderByClause = (orderBy) => {
131
256
  return ` ORDER BY ${clause}`;
132
257
  };
133
258
  exports.createOrderByClause = createOrderByClause;
259
+ /**
260
+ * Creates a GROUP BY clause for a query
261
+ *
262
+ * This function creates a GROUP BY clause for a query. It takes an array of
263
+ * group by fields and returns a string with the fields separated by commas.
264
+ *
265
+ * @param groupBy - The array of group by fields
266
+ * @returns A string with the fields separated by commas
267
+ *
268
+ * @example
269
+ * const groupBy = ['status']
270
+ * const result = createGroupByClause(groupBy)
271
+ * // result will be: "GROUP BY status"
272
+ */
134
273
  const createGroupByClause = (groupBy) => {
135
274
  if (!groupBy || groupBy.length === 0)
136
275
  return '';
137
276
  return ` GROUP BY ${groupBy.join(', ')}`;
138
277
  };
139
278
  exports.createGroupByClause = createGroupByClause;
279
+ /**
280
+ * Creates a LIMIT clause for a query
281
+ *
282
+ * This function creates a LIMIT clause for a query. It takes a limit number
283
+ * and returns a string with the limit.
284
+ *
285
+ * @param limit - The limit number
286
+ * @returns A string with the limit
287
+ *
288
+ * @example
289
+ * const limit = 10
290
+ * const result = createLimitClause(limit)
291
+ * // result will be: "LIMIT 10"
292
+ */
140
293
  const createLimitClause = (limit) => {
141
294
  if (!limit)
142
295
  return '';
143
296
  return ` LIMIT ${limit}`;
144
297
  };
145
298
  exports.createLimitClause = createLimitClause;
299
+ /**
300
+ * Creates an OFFSET clause for a query
301
+ *
302
+ * This function creates an OFFSET clause for a query. It takes an offset number
303
+ * and returns a string with the offset.
304
+ *
305
+ * @param offset - The offset number
306
+ * @returns A string with the offset
307
+ *
308
+ * @example
309
+ * const offset = 10
310
+ * const result = createOffsetClause(offset)
311
+ * // result will be: "OFFSET 10"
312
+ */
146
313
  const createOffsetClause = (offset) => {
147
314
  if (!offset)
148
315
  return '';
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,14 @@
1
- import { DBClients } from '../default/types';
1
+ import { DBClients } from '../core/types';
2
+ export interface ITransactionClient {
3
+ query: <T>(sql: string, params?: any[]) => Promise<T>;
4
+ commit: () => Promise<void>;
5
+ rollback: () => Promise<void>;
6
+ }
7
+ /**
8
+ * Database client interface
9
+ */
2
10
  export type IDatabaseClient = {
3
11
  clientType: DBClients;
4
12
  query: <T>(sql: string, params?: any[]) => Promise<T>;
13
+ beginTransaction: () => Promise<ITransactionClient>;
5
14
  };
@@ -1,5 +1,52 @@
1
1
  import { IDatabaseClient } from './IDatabaseClient';
2
- import { DBClients, RetryOptions } from '../default/types';
2
+ import { DBClients, RetryOptions } from '../core/types';
3
+ /**
4
+ * Initialize a database client with the specified configuration
5
+ *
6
+ * @template T - The type of connection options (PoolConfig for PostgreSQL or PoolOptions for MySQL)
7
+ * @param config - Configuration object for database initialization
8
+ * @param config.name - Optional name for the database client (defaults to 'default')
9
+ * @param config.type - Database type ('pg' for PostgreSQL or 'mysql' for MySQL)
10
+ * @param config.options - Connection options specific to the database type
11
+ * @param config.retryOptions - Optional retry configuration for failed queries
12
+ * @param config.installUnaccentExtension - Optional flag to install unaccent extension (PostgreSQL only)
13
+ * @returns Promise<void> - Resolves when the database client is successfully initialized
14
+ *
15
+ * @throws {Error} When type is not provided or is invalid
16
+ * @throws {Error} When connection options are not provided
17
+ * @throws {Error} When an unsupported database type is specified
18
+ *
19
+ * @example
20
+ * // Initialize PostgreSQL client
21
+ * await initDb({
22
+ * name: 'myPostgresDb',
23
+ * type: 'pg',
24
+ * options: {
25
+ * host: 'localhost',
26
+ * port: 5432,
27
+ * database: 'mydb',
28
+ * user: 'user',
29
+ * password: 'password'
30
+ * },
31
+ * retryOptions: { maxRetries: 3, delay: 1000 },
32
+ * installUnaccentExtension: true
33
+ * });
34
+ *
35
+ * @example
36
+ * // Initialize MySQL client
37
+ * await initDb({
38
+ * name: 'myMysqlDb',
39
+ * type: 'mysql',
40
+ * options: {
41
+ * host: 'localhost',
42
+ * port: 3306,
43
+ * database: 'mydb',
44
+ * user: 'user',
45
+ * password: 'password'
46
+ * },
47
+ * retryOptions: { maxRetries: 3, delay: 1000 }
48
+ * });
49
+ */
3
50
  export declare const initDb: <T>(config: {
4
51
  name?: string;
5
52
  type: DBClients;
@@ -7,5 +54,77 @@ export declare const initDb: <T>(config: {
7
54
  retryOptions?: RetryOptions;
8
55
  installUnaccentExtension?: boolean;
9
56
  }) => Promise<void>;
57
+ /**
58
+ * Initialize a database client with the specified configuration
59
+ *
60
+ * @template T - The type of connection options (PoolConfig for PostgreSQL or PoolOptions for MySQL)
61
+ * @param config - Configuration object for database initialization
62
+ * @param config.name - Optional name for the database client (defaults to 'default')
63
+ * @param config.type - Database type ('pg' for PostgreSQL or 'mysql' for MySQL)
64
+ * @param config.options - Connection options specific to the database type
65
+ * @param config.retryOptions - Optional retry configuration for failed queries
66
+ * @param config.installUnaccentExtension - Optional flag to install unaccent extension (PostgreSQL only)
67
+ * @returns Promise<void> - Resolves when the database client is successfully initialized
68
+ *
69
+ * @throws {Error} When database type is not provided or is invalid
70
+ * @throws {Error} When connection options are not provided
71
+ * @throws {Error} When an unsupported database type is specified
72
+ *
73
+ * @example
74
+ * // Initialize PostgreSQL client
75
+ * await initDb({
76
+ * name: 'myPostgresDb',
77
+ * type: 'pg',
78
+ * options: {
79
+ * host: 'localhost',
80
+ * port: 5432,
81
+ * database: 'mydb',
82
+ * user: 'user',
83
+ * password: 'password'
84
+ * },
85
+ * retryOptions: { maxRetries: 3, delay: 1000 },
86
+ * installUnaccentExtension: true
87
+ * });
88
+ *
89
+ * @example
90
+ * // Initialize MySQL client
91
+ * await initDb({
92
+ * name: 'myMysqlDb',
93
+ * type: 'mysql',
94
+ * options: {
95
+ * host: 'localhost',
96
+ * port: 3306,
97
+ * database: 'mydb',
98
+ * user: 'user',
99
+ * password: 'password'
100
+ * },
101
+ * retryOptions: { maxRetries: 3, delay: 1000 }
102
+ * });
103
+ */
10
104
  export declare const getDbClient: (name?: string) => IDatabaseClient;
105
+ /**
106
+ * Retrieves a specific database client by name
107
+ *
108
+ * @param name - Optional name of the database client to retrieve. If not provided, returns the default client
109
+ * @returns IDatabaseClient - The requested database client instance
110
+ *
111
+ * @throws {Error} When the specified database client name is not found or not initialized
112
+ *
113
+ * @example
114
+ * // Get default database client
115
+ * const defaultClient = getDbClient();
116
+ *
117
+ * @example
118
+ * // Get specific database client by name
119
+ * const postgresClient = getDbClient('myPostgresDb');
120
+ * const mysqlClient = getDbClient('myMysqlDb');
121
+ *
122
+ * @example
123
+ * // Handle error when client is not found
124
+ * try {
125
+ * const client = getDbClient('nonExistentDb');
126
+ * } catch (error) {
127
+ * console.error('Database client not found:', error.message);
128
+ * }
129
+ */
11
130
  export declare const getAllDbClients: () => Record<string, IDatabaseClient>;