@rsdk/db 5.15.0-next.9 → 5.16.0-next.0

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 (141) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/dist/index.d.ts +1 -0
  3. package/dist/index.js +15 -0
  4. package/dist/index.js.map +1 -1
  5. package/dist/metrics/call-then.d.ts +30 -0
  6. package/dist/metrics/call-then.js +91 -0
  7. package/dist/metrics/call-then.js.map +1 -0
  8. package/dist/metrics/clock.d.ts +2 -0
  9. package/dist/metrics/clock.js +9 -0
  10. package/dist/metrics/clock.js.map +1 -0
  11. package/dist/metrics/db-client-metrics.d.ts +85 -0
  12. package/dist/metrics/db-client-metrics.js +164 -0
  13. package/dist/metrics/db-client-metrics.js.map +1 -0
  14. package/dist/metrics/db-metric.d.ts +41 -0
  15. package/dist/metrics/db-metric.js +99 -0
  16. package/dist/metrics/db-metric.js.map +1 -0
  17. package/dist/metrics/db-metrics.config.d.ts +7 -0
  18. package/dist/metrics/db-metrics.config.js +60 -0
  19. package/dist/metrics/db-metrics.config.js.map +1 -0
  20. package/dist/metrics/db-metrics.module-base.d.ts +61 -0
  21. package/dist/metrics/db-metrics.module-base.js +61 -0
  22. package/dist/metrics/db-metrics.module-base.js.map +1 -0
  23. package/dist/metrics/db-metrics.providers.d.ts +66 -0
  24. package/dist/metrics/db-metrics.providers.js +83 -0
  25. package/dist/metrics/db-metrics.providers.js.map +1 -0
  26. package/dist/metrics/detach-group.d.ts +19 -0
  27. package/dist/metrics/detach-group.js +31 -0
  28. package/dist/metrics/detach-group.js.map +1 -0
  29. package/dist/metrics/detach.d.ts +24 -0
  30. package/dist/metrics/detach.js +45 -0
  31. package/dist/metrics/detach.js.map +1 -0
  32. package/dist/metrics/entity-operations.recorder.d.ts +17 -0
  33. package/dist/metrics/entity-operations.recorder.js +28 -0
  34. package/dist/metrics/entity-operations.recorder.js.map +1 -0
  35. package/dist/metrics/events.d.ts +11 -0
  36. package/dist/metrics/events.js +20 -0
  37. package/dist/metrics/events.js.map +1 -0
  38. package/dist/metrics/guards.d.ts +12 -0
  39. package/dist/metrics/guards.js +19 -0
  40. package/dist/metrics/guards.js.map +1 -0
  41. package/dist/metrics/index.d.ts +1 -0
  42. package/dist/metrics/index.js +11 -0
  43. package/dist/metrics/index.js.map +1 -0
  44. package/dist/metrics/instrumentation/pg-pool.instrumentation.d.ts +48 -0
  45. package/dist/metrics/instrumentation/pg-pool.instrumentation.js +117 -0
  46. package/dist/metrics/instrumentation/pg-pool.instrumentation.js.map +1 -0
  47. package/dist/metrics/instrumentation/pool-adapters.d.ts +22 -0
  48. package/dist/metrics/instrumentation/pool-adapters.js +16 -0
  49. package/dist/metrics/instrumentation/pool-adapters.js.map +1 -0
  50. package/dist/metrics/instrumentation/pool-close.d.ts +10 -0
  51. package/dist/metrics/instrumentation/pool-close.js +43 -0
  52. package/dist/metrics/instrumentation/pool-close.js.map +1 -0
  53. package/dist/metrics/instrumentation/pool-scope.d.ts +13 -0
  54. package/dist/metrics/instrumentation/pool-scope.js +3 -0
  55. package/dist/metrics/instrumentation/pool-scope.js.map +1 -0
  56. package/dist/metrics/instrumentation/pool.adapter.d.ts +50 -0
  57. package/dist/metrics/instrumentation/pool.adapter.js +3 -0
  58. package/dist/metrics/instrumentation/pool.adapter.js.map +1 -0
  59. package/dist/metrics/instrumentation/pool.recorder.d.ts +74 -0
  60. package/dist/metrics/instrumentation/pool.recorder.js +125 -0
  61. package/dist/metrics/instrumentation/pool.recorder.js.map +1 -0
  62. package/dist/metrics/instrumentation/query-completion.d.ts +12 -0
  63. package/dist/metrics/instrumentation/query-completion.js +76 -0
  64. package/dist/metrics/instrumentation/query-completion.js.map +1 -0
  65. package/dist/metrics/instrumentation/query.instrumentation.d.ts +35 -0
  66. package/dist/metrics/instrumentation/query.instrumentation.js +85 -0
  67. package/dist/metrics/instrumentation/query.instrumentation.js.map +1 -0
  68. package/dist/metrics/instrumentation/tarn-pool.instrumentation.d.ts +44 -0
  69. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js +95 -0
  70. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js.map +1 -0
  71. package/dist/metrics/instrumentation/transaction-tracker.d.ts +32 -0
  72. package/dist/metrics/instrumentation/transaction-tracker.js +64 -0
  73. package/dist/metrics/instrumentation/transaction-tracker.js.map +1 -0
  74. package/dist/metrics/metric-types.d.ts +17 -0
  75. package/dist/metrics/metric-types.js +3 -0
  76. package/dist/metrics/metric-types.js.map +1 -0
  77. package/dist/metrics/metrics.d.ts +82 -0
  78. package/dist/metrics/metrics.js +269 -0
  79. package/dist/metrics/metrics.js.map +1 -0
  80. package/dist/metrics/plugin-kit.d.ts +12 -0
  81. package/dist/metrics/plugin-kit.js +42 -0
  82. package/dist/metrics/plugin-kit.js.map +1 -0
  83. package/dist/metrics/pool-names.d.ts +47 -0
  84. package/dist/metrics/pool-names.js +44 -0
  85. package/dist/metrics/pool-names.js.map +1 -0
  86. package/dist/metrics/pool-stats.registry.d.ts +25 -0
  87. package/dist/metrics/pool-stats.registry.js +32 -0
  88. package/dist/metrics/pool-stats.registry.js.map +1 -0
  89. package/dist/metrics/scrape-source.registry.d.ts +29 -0
  90. package/dist/metrics/scrape-source.registry.js +55 -0
  91. package/dist/metrics/scrape-source.registry.js.map +1 -0
  92. package/dist/metrics/sql.d.ts +34 -0
  93. package/dist/metrics/sql.js +132 -0
  94. package/dist/metrics/sql.js.map +1 -0
  95. package/package.json +2 -2
  96. package/src/index.ts +1 -0
  97. package/src/metrics/call-then.ts +134 -0
  98. package/src/metrics/clock.ts +5 -0
  99. package/src/metrics/db-client-metrics.spec.ts +1894 -0
  100. package/src/metrics/db-client-metrics.ts +206 -0
  101. package/src/metrics/db-metric.spec.ts +185 -0
  102. package/src/metrics/db-metric.ts +186 -0
  103. package/src/metrics/db-metrics.config.ts +46 -0
  104. package/src/metrics/db-metrics.module-base.spec.ts +91 -0
  105. package/src/metrics/db-metrics.module-base.ts +77 -0
  106. package/src/metrics/db-metrics.providers.spec.ts +182 -0
  107. package/src/metrics/db-metrics.providers.ts +134 -0
  108. package/src/metrics/detach-group.spec.ts +41 -0
  109. package/src/metrics/detach-group.ts +30 -0
  110. package/src/metrics/detach.spec.ts +61 -0
  111. package/src/metrics/detach.ts +57 -0
  112. package/src/metrics/entity-operations.recorder.ts +26 -0
  113. package/src/metrics/events.spec.ts +19 -0
  114. package/src/metrics/events.ts +28 -0
  115. package/src/metrics/guards.spec.ts +20 -0
  116. package/src/metrics/guards.ts +19 -0
  117. package/src/metrics/index.ts +6 -0
  118. package/src/metrics/instrumentation/pg-pool.instrumentation.ts +177 -0
  119. package/src/metrics/instrumentation/pool-adapters.ts +35 -0
  120. package/src/metrics/instrumentation/pool-close.ts +59 -0
  121. package/src/metrics/instrumentation/pool-guards.spec.ts +318 -0
  122. package/src/metrics/instrumentation/pool-scope.ts +14 -0
  123. package/src/metrics/instrumentation/pool.adapter.ts +67 -0
  124. package/src/metrics/instrumentation/pool.recorder.ts +167 -0
  125. package/src/metrics/instrumentation/query-completion.spec.ts +209 -0
  126. package/src/metrics/instrumentation/query-completion.ts +107 -0
  127. package/src/metrics/instrumentation/query.instrumentation.ts +136 -0
  128. package/src/metrics/instrumentation/tarn-pool.instrumentation.ts +138 -0
  129. package/src/metrics/instrumentation/transaction-tracker.ts +103 -0
  130. package/src/metrics/metric-types.ts +36 -0
  131. package/src/metrics/metrics.ts +233 -0
  132. package/src/metrics/plugin-kit.ts +39 -0
  133. package/src/metrics/pool-names.spec.ts +79 -0
  134. package/src/metrics/pool-names.ts +77 -0
  135. package/src/metrics/pool-stats.registry.spec.ts +81 -0
  136. package/src/metrics/pool-stats.registry.ts +54 -0
  137. package/src/metrics/public-api.spec.ts +104 -0
  138. package/src/metrics/scrape-source.registry.spec.ts +59 -0
  139. package/src/metrics/scrape-source.registry.ts +55 -0
  140. package/src/metrics/sql.spec.ts +110 -0
  141. package/src/metrics/sql.ts +172 -0
@@ -0,0 +1,132 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.extractSqlText = exports.extractSqlState = exports.classifyQuery = void 0;
4
+ const guards_1 = require("./guards");
5
+ const LEADING_NOISE = /^(?:\s+|\(+|--[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/)*/;
6
+ const FIRST_WORDS = /^([a-z]+)(?:\s+([a-z]+))?(?:\s+([a-z]+))?/i;
7
+ /**
8
+ * Пробелы, комментарии и лишние `;` — то, что может стоять после
9
+ * единственного оператора и не делает строку многооператорной. Без якоря
10
+ * `$`: совпадение всегда находится, и движку не приходится перебирать
11
+ * варианты на длинной строке
12
+ */
13
+ const TRAILING_NOISE = /^(?:\s+|;|--[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/)*/;
14
+ const SIMPLE_OPERATIONS = {
15
+ SELECT: 'SELECT',
16
+ INSERT: 'INSERT',
17
+ UPDATE: 'UPDATE',
18
+ DELETE: 'DELETE',
19
+ };
20
+ /**
21
+ * После первого `;` в строке есть ещё оператор. Проверяется только для
22
+ * границ транзакции: в их тексте нет строковых литералов, где `;` мог бы
23
+ * стоять внутри одного оператора
24
+ */
25
+ const hasMoreStatements = (sql) => {
26
+ const end = sql.indexOf(';');
27
+ return end !== -1 && sql.slice(end + 1).replace(TRAILING_NOISE, '') !== '';
28
+ };
29
+ /**
30
+ * Граница транзакции по первым словам оператора
31
+ */
32
+ const classifyBoundary = (first, second, third) => {
33
+ switch (first) {
34
+ case 'BEGIN':
35
+ return { operation: 'BEGIN', boundary: 'begin' };
36
+ case 'START':
37
+ return second === 'TRANSACTION'
38
+ ? { operation: 'BEGIN', boundary: 'begin' }
39
+ : undefined;
40
+ case 'COMMIT':
41
+ case 'END':
42
+ return { operation: 'COMMIT', boundary: 'commit' };
43
+ case 'ROLLBACK':
44
+ // ROLLBACK TO [SAVEPOINT] x откатывает только вложенную транзакцию
45
+ return second === 'TO' || third === 'TO'
46
+ ? undefined
47
+ : { operation: 'OTHER', boundary: 'rollback' };
48
+ case 'ABORT':
49
+ // Синоним ROLLBACK в PostgreSQL, формы с TO SAVEPOINT у него нет
50
+ return { operation: 'OTHER', boundary: 'rollback' };
51
+ default:
52
+ return undefined;
53
+ }
54
+ };
55
+ /**
56
+ * Определяет тип запроса по первому ключевому слову.
57
+ * `WITH ...` относится к OTHER: по началу запроса не понять, читает он или пишет.
58
+ *
59
+ * Граница транзакции (`BEGIN`/`START TRANSACTION`, `COMMIT`/`END`,
60
+ * `ROLLBACK`/`ABORT`) учитывается, только если это единственный оператор
61
+ * в строке; `BEGIN;` от knex — один оператор. В строке из нескольких
62
+ * операторов (`BEGIN; …; COMMIT`) видно только начало, а чем всё кончилось
63
+ * на сервере, неизвестно, поэтому такая строка — OTHER без границы:
64
+ * транзакция не учитывается, но и не остаётся открытой в метриках
65
+ */
66
+ const classifyQuery = (sql) => {
67
+ if (!sql) {
68
+ return { operation: 'OTHER' };
69
+ }
70
+ const statement = sql.replace(LEADING_NOISE, '');
71
+ const words = FIRST_WORDS.exec(statement);
72
+ if (!words) {
73
+ return { operation: 'OTHER' };
74
+ }
75
+ const [, first = '', second = '', third = ''] = words.map((x) => x?.toUpperCase());
76
+ const simple = SIMPLE_OPERATIONS[first];
77
+ if (simple) {
78
+ return { operation: simple };
79
+ }
80
+ const boundary = classifyBoundary(first, second, third);
81
+ if (!boundary || hasMoreStatements(statement)) {
82
+ return { operation: 'OTHER' };
83
+ }
84
+ return boundary;
85
+ };
86
+ exports.classifyQuery = classifyQuery;
87
+ // Ни один класс SQLSTATE в Postgres не начинается с `E`, а коды errno Node
88
+ // (`EPIPE`, `EPERM`, `EBADF`) начинаются. Без этого исключения они проходили
89
+ // бы как SQLSTATE
90
+ const SQLSTATE = /^[\dA-DF-Z][\dA-Z]{4}$/;
91
+ /**
92
+ * SQLSTATE из ошибки драйвера: `code` у pg, `sqlState` у pg-native.
93
+ * Всё остальное (таймауты клиента, обрыв сокета) сводится к `unknown`,
94
+ * чтобы не плодить значения лейбла
95
+ */
96
+ const extractSqlState = (error) => {
97
+ if (!(0, guards_1.isObject)(error)) {
98
+ return 'unknown';
99
+ }
100
+ for (const candidate of [error.code, error.sqlState]) {
101
+ if (typeof candidate === 'string' && SQLSTATE.test(candidate)) {
102
+ return candidate;
103
+ }
104
+ }
105
+ return 'unknown';
106
+ };
107
+ exports.extractSqlState = extractSqlState;
108
+ /**
109
+ * Текст запроса из аргумента `client.query()`: строка, `QueryConfig`
110
+ * с полем `text` (или `sql`), Cursor с полем `text` или QueryStream,
111
+ * у которого текст лежит в `cursor.text`
112
+ */
113
+ const extractSqlText = (arg) => {
114
+ if (typeof arg === 'string') {
115
+ return arg;
116
+ }
117
+ if ((0, guards_1.isObject)(arg)) {
118
+ const { text, sql, cursor } = arg;
119
+ for (const candidate of [
120
+ text,
121
+ sql,
122
+ (0, guards_1.isObject)(cursor) ? cursor.text : undefined,
123
+ ]) {
124
+ if (typeof candidate === 'string') {
125
+ return candidate;
126
+ }
127
+ }
128
+ }
129
+ return undefined;
130
+ };
131
+ exports.extractSqlText = extractSqlText;
132
+ //# sourceMappingURL=sql.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/metrics/sql.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rsdk/db",
3
- "version": "5.15.0-next.9",
3
+ "version": "5.16.0-next.0",
4
4
  "description": "Common functionality and interfaces for relational database plugins",
5
5
  "main": "dist/index.js",
6
6
  "publishConfig": {
@@ -19,5 +19,5 @@
19
19
  "@rsdk/logging": "*",
20
20
  "reflect-metadata": "^0.1.12 || ^0.2.0"
21
21
  },
22
- "gitHead": "f8da4799d92dd62e259de4c774792cf2ae2788a5"
22
+ "gitHead": "3a41021e6309c074bb5d7df283209e2df1c13c41"
23
23
  }
package/src/index.ts CHANGED
@@ -32,3 +32,4 @@ export type {
32
32
  ResolveDbConnectionOptions,
33
33
  ResolvedDbConnection,
34
34
  } from './multi-host-url';
35
+ export * from './metrics';
@@ -0,0 +1,134 @@
1
+ import { isThenable } from './guards';
2
+
3
+ /**
4
+ * Сообщает, что вызов закончился: с ошибкой или с результатом
5
+ */
6
+ export type CallDone = (error?: unknown, result?: unknown) => void;
7
+
8
+ export interface CallThenOptions {
9
+ /**
10
+ * Где метод ждёт callback: первым аргументом (`pool.connect(cb)`) или
11
+ * последней функцией среди аргументов (`client.query(sql, values, cb)`)
12
+ */
13
+ callbackAt: 'first' | 'last';
14
+
15
+ /**
16
+ * Результат пришёл без callback и это не promise. Если вызов на самом
17
+ * деле ещё идёт (например, поток), `watchResult` сам вызовет `done`,
18
+ * когда он закончится, и вернёт `true`. Без него или при `false` вызов
19
+ * считается законченным сразу
20
+ */
21
+ watchResult?: (result: unknown, done: CallDone) => boolean;
22
+ }
23
+
24
+ const callbackIndexOf = (
25
+ args: readonly unknown[],
26
+ callbackAt: CallThenOptions['callbackAt'],
27
+ ): number => {
28
+ if (callbackAt === 'first') {
29
+ return typeof args[0] === 'function' ? 0 : -1;
30
+ }
31
+
32
+ return args.findLastIndex((arg) => typeof arg === 'function');
33
+ };
34
+
35
+ /**
36
+ * Promise-результат: вызывающему отдаётся производный promise с тем же
37
+ * значением или той же ошибкой, а исходный больше никому не достаётся.
38
+ *
39
+ * Обработчик, повешенный прямо на исходный promise, считался бы обработкой
40
+ * отказа: ошибка, которую вызывающий не обработал, молча пропала бы вместо
41
+ * `unhandledRejection`. Производный promise отклоняется той же ошибкой,
42
+ * поэтому без обработчика у вызывающего процесс видит `unhandledRejection`,
43
+ * как и без метрик.
44
+ *
45
+ * `then` у thenable не обязан вернуть promise с `catch`/`finally` — тогда
46
+ * результат оборачивается в `Promise.resolve`
47
+ */
48
+ const thenWithDone = (
49
+ result: PromiseLike<unknown>,
50
+ done: CallDone,
51
+ ): PromiseLike<unknown> => {
52
+ const derived = result.then(
53
+ (value) => {
54
+ done(undefined, value);
55
+ return value;
56
+ },
57
+ (error: unknown) => {
58
+ done(error);
59
+ throw error;
60
+ },
61
+ );
62
+
63
+ return typeof (derived as Partial<Promise<unknown>> | undefined)?.catch ===
64
+ 'function'
65
+ ? derived
66
+ : Promise.resolve(derived);
67
+ };
68
+
69
+ /**
70
+ * Вызывает метод, который сообщает о завершении callback-ом, promise или
71
+ * (через `watchResult`) чем-то ещё, и вызывает `done`, когда вызов
72
+ * закончился, — при ошибке тоже. `done` вызывается один раз.
73
+ *
74
+ * Исход вызова не меняется: callback получает те же аргументы, вызывающий —
75
+ * тот же результат, promise с тем же значением или той же ошибкой (см.
76
+ * {@link thenWithDone}), синхронное исключение бросается дальше. Исключение
77
+ * из самого `done` проглатывается: сбой учёта не должен менять исход вызова
78
+ * и мешать вызвать callback
79
+ */
80
+ export const callThen = (
81
+ method: (...args: any[]) => any,
82
+ thisArg: unknown,
83
+ args: readonly unknown[],
84
+ done: CallDone,
85
+ { callbackAt, watchResult }: CallThenOptions,
86
+ ): unknown => {
87
+ let finished = false;
88
+ const finish: CallDone = (...outcome) => {
89
+ if (finished) {
90
+ return;
91
+ }
92
+
93
+ finished = true;
94
+ try {
95
+ done(...outcome);
96
+ } catch {
97
+ // Метрика не записалась: вызов и вызывающий код важнее
98
+ }
99
+ };
100
+ const callbackIndex = callbackIndexOf(args, callbackAt);
101
+ const callArgs = [...args];
102
+
103
+ if (callbackIndex !== -1) {
104
+ const callback = args[callbackIndex] as (...outcome: unknown[]) => void;
105
+
106
+ callArgs[callbackIndex] = (...outcome: unknown[]): void => {
107
+ finish(outcome[0], outcome[1]);
108
+ callback(...outcome);
109
+ };
110
+ }
111
+
112
+ let result: unknown;
113
+
114
+ try {
115
+ result = method.apply(thisArg, callArgs);
116
+ } catch (error) {
117
+ finish(error);
118
+ throw error;
119
+ }
120
+
121
+ if (callbackIndex !== -1) {
122
+ return result;
123
+ }
124
+
125
+ if (isThenable(result)) {
126
+ return thenWithDone(result, finish);
127
+ }
128
+
129
+ if (!watchResult?.(result, finish)) {
130
+ finish();
131
+ }
132
+
133
+ return result;
134
+ };
@@ -0,0 +1,5 @@
1
+ import { performance } from 'node:perf_hooks';
2
+
3
+ export const now = (): number => performance.now();
4
+
5
+ export const secondsSince = (start: number): number => (now() - start) / 1000;