@rsdk/db 5.15.0-next.9 → 5.15.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,26 @@
1
+ import { resolveDbMetric } from './db-metric';
2
+ import type { CounterLike } from './metric-types';
3
+ import { OrmEntityOperations } from './metrics';
4
+
5
+ export type EntityOperation = 'load' | 'insert' | 'update' | 'delete';
6
+
7
+ /**
8
+ * Пишет `orm_entity_operations_total`. Общий для ORM, чтобы значения
9
+ * label `op` совпадали
10
+ */
11
+ export class EntityOperationsRecorder {
12
+ constructor(private readonly counter: CounterLike<'entity' | 'op'>) {}
13
+
14
+ /**
15
+ * Запись на метрике prom-client. Модуль метрик ORM сам её не вызывает:
16
+ * экземпляр (или `null`, если метрика выключена) приходит через DI из
17
+ * провайдера `dbMetricsModuleProviders`
18
+ */
19
+ static create(): EntityOperationsRecorder {
20
+ return new EntityOperationsRecorder(resolveDbMetric(OrmEntityOperations));
21
+ }
22
+
23
+ record(entity: string, op: EntityOperation): void {
24
+ this.counter.inc({ entity, op });
25
+ }
26
+ }
@@ -0,0 +1,19 @@
1
+ /* eslint-disable unicorn/prefer-event-target -- источники событий в пакете построены на EventEmitter */
2
+ import { EventEmitter } from 'node:events';
3
+
4
+ import { listen } from './events';
5
+
6
+ describe('listen', () => {
7
+ it('removes listeners only on the first call', () => {
8
+ const source = new EventEmitter();
9
+ const removeListener = jest.spyOn(source, 'removeListener');
10
+ const detach = listen(source, { a: jest.fn(), b: jest.fn() });
11
+
12
+ detach();
13
+ detach();
14
+
15
+ expect(removeListener).toHaveBeenCalledTimes(2);
16
+ expect(source.listenerCount('a')).toBe(0);
17
+ expect(source.listenerCount('b')).toBe(0);
18
+ });
19
+ });
@@ -0,0 +1,28 @@
1
+ import type { Detach } from './detach';
2
+ import { once } from './detach';
3
+
4
+ export type Listener = (...args: any[]) => void;
5
+
6
+ export interface EventSource {
7
+ on(event: string | symbol, listener: Listener): unknown;
8
+ removeListener(event: string | symbol, listener: Listener): unknown;
9
+ }
10
+
11
+ /**
12
+ * Подписывает обработчики на события и возвращает отписку от всех сразу.
13
+ * Отписка срабатывает один раз
14
+ */
15
+ export const listen = (
16
+ source: EventSource,
17
+ listeners: Record<string, Listener>,
18
+ ): Detach => {
19
+ for (const [event, listener] of Object.entries(listeners)) {
20
+ source.on(event, listener);
21
+ }
22
+
23
+ return once(() => {
24
+ for (const [event, listener] of Object.entries(listeners)) {
25
+ source.removeListener(event, listener);
26
+ }
27
+ });
28
+ };
@@ -0,0 +1,20 @@
1
+ /* eslint-disable unicorn/prefer-event-target -- источники событий в пакете построены на EventEmitter */
2
+ import { EventEmitter } from 'node:events';
3
+
4
+ import { isObject } from './guards';
5
+
6
+ describe('isObject', () => {
7
+ it.each([{}, [], new EventEmitter(), Object.create(null)])(
8
+ 'accepts %p',
9
+ (value) => {
10
+ expect(isObject(value)).toBe(true);
11
+ },
12
+ );
13
+
14
+ it.each([null, undefined, 0, 'text', true, Symbol('s'), (): void => {}])(
15
+ 'rejects %p',
16
+ (value) => {
17
+ expect(isObject(value)).toBe(false);
18
+ },
19
+ );
20
+ });
@@ -0,0 +1,19 @@
1
+ import type { EventSource } from './events';
2
+
3
+ /**
4
+ * Значение — объект (не `null`): с его полями можно работать как
5
+ * с записью и проверять их по одному
6
+ */
7
+ export const isObject = (value: unknown): value is Record<string, unknown> =>
8
+ typeof value === 'object' && value !== null;
9
+
10
+ export const isThenable = (value: unknown): value is PromiseLike<unknown> =>
11
+ typeof (value as PromiseLike<unknown> | undefined)?.then === 'function';
12
+
13
+ /**
14
+ * Проверяет оба метода, которые нужны подписке: `on` и `removeListener`.
15
+ * Без второго отписка упала бы с ошибкой
16
+ */
17
+ export const isEventSource = (value: unknown): value is EventSource =>
18
+ typeof (value as EventSource | undefined)?.on === 'function' &&
19
+ typeof (value as EventSource).removeListener === 'function';
@@ -0,0 +1,6 @@
1
+ /*
2
+ * Публичный API метрик БД для пользователя пакета: только `DbMetricsConfig`.
3
+ * Всё, что нужно ORM-плагинам rsdk, лежит в `plugin-kit.ts` и в корень
4
+ * `@rsdk/db` не попадает. Состав закреплён в `public-api.spec.ts`
5
+ */
6
+ export { DbMetricsConfig } from './db-metrics.config';
@@ -0,0 +1,177 @@
1
+ import { callThen } from '../call-then';
2
+ import { now } from '../clock';
3
+ import type { Detach } from '../detach';
4
+ import { once, replaceMethod } from '../detach';
5
+ import type { EventSource } from '../events';
6
+ import { listen } from '../events';
7
+ import { isEventSource, isObject } from '../guards';
8
+
9
+ import type { PoolAdapter, PoolEvents } from './pool.adapter';
10
+
11
+ /**
12
+ * Пул из `pg-pool` (`pg.Pool` и `pg.native.Pool`): публичные члены, которые
13
+ * читает инструментирование
14
+ */
15
+ export interface PgPoolLike extends EventSource {
16
+ readonly totalCount: number;
17
+ readonly idleCount: number;
18
+ readonly waitingCount: number;
19
+ readonly options: { max?: number };
20
+ connect(...args: any[]): any;
21
+ end?(...args: any[]): any;
22
+ }
23
+
24
+ /**
25
+ * Пул `pg-pool` вместе с внутренним `_clients`: по нему инструментирование
26
+ * находит соединения, открытые до подключения метрик. Элементы не
27
+ * проверены, их разбирает {@link connectedClients}
28
+ */
29
+ export type PgPoolInternals = PgPoolLike & {
30
+ readonly _clients?: readonly unknown[];
31
+ };
32
+
33
+ /**
34
+ * Проверяет каждый член пула, который использует
35
+ * {@link pgPoolAdapter}, в том числе необязательные: `end`, если есть,
36
+ * — функция, `_clients`, если есть, — массив. Пул другого драйвера (tarn,
37
+ * mysql2) или объект с частью полей не проходит
38
+ */
39
+ export const isPgPoolLike = (value: unknown): value is PgPoolInternals => {
40
+ if (!isEventSource(value)) {
41
+ return false;
42
+ }
43
+
44
+ const pool = value as EventSource & Partial<Record<string, unknown>>;
45
+ const options = pool.options;
46
+
47
+ return (
48
+ typeof pool.totalCount === 'number' &&
49
+ typeof pool.idleCount === 'number' &&
50
+ typeof pool.waitingCount === 'number' &&
51
+ isObject(options) &&
52
+ (options.max === undefined || typeof options.max === 'number') &&
53
+ typeof pool.connect === 'function' &&
54
+ (pool.end === undefined || typeof pool.end === 'function') &&
55
+ (pool._clients === undefined || Array.isArray(pool._clients))
56
+ );
57
+ };
58
+
59
+ /**
60
+ * Соединения пула, которые уже подключились. Пул кладёт клиента `pg`
61
+ * в `_clients` до подключения, а `_connected` становится `true` после него.
62
+ * По ним считаются открытые соединения в `stats` и соединения, открытые до
63
+ * подключения метрик. Всё, что не объект, пропускается
64
+ */
65
+ export const connectedClients = (pool: PgPoolInternals): object[] =>
66
+ (pool._clients ?? []).filter(
67
+ (client): client is object =>
68
+ isObject(client) && client._connected === true,
69
+ );
70
+
71
+ /**
72
+ * Сообщения, которыми pg-pool отклоняет `connect` по `connectionTimeoutMillis`.
73
+ * Тип ошибки у них общий (`Error`), отличить таймаут можно только по тексту
74
+ */
75
+ const ACQUIRE_TIMEOUT_MESSAGES: ReadonlySet<string> = new Set([
76
+ // Пул полон, запрос не дождался свободного соединения в очереди (`connect`)
77
+ 'timeout exceeded when trying to connect',
78
+
79
+ // Пул не полон, новое соединение не успело открыться: `newClient` рвёт сокет
80
+ // и подменяет сообщение ошибки
81
+ 'Connection terminated due to connection timeout',
82
+ ]);
83
+
84
+ /**
85
+ * Таймаут получения соединения — и в очереди, и при открытии нового. Так же
86
+ * считает tarn: его `TimeoutError` покрывает оба случая
87
+ */
88
+ const isAcquireTimeout = (error: unknown): boolean => {
89
+ const message = (error as Error | undefined)?.message;
90
+
91
+ return typeof message === 'string' && ACQUIRE_TIMEOUT_MESSAGES.has(message);
92
+ };
93
+
94
+ /**
95
+ * `connect` сообщает о соединении callback-ом первым аргументом или promise:
96
+ * обёртка мерит ожидание соединения и отличает таймаут
97
+ */
98
+ const wrapConnect = (pool: PgPoolInternals, events: PoolEvents): Detach => {
99
+ const originalConnect = pool.connect;
100
+
101
+ return replaceMethod(
102
+ pool,
103
+ 'connect',
104
+ function (this: PgPoolInternals, ...args: unknown[]): any {
105
+ const startedAt = now();
106
+
107
+ return callThen(
108
+ originalConnect,
109
+ this,
110
+ args,
111
+ (error): void =>
112
+ events.acquireFinished(startedAt, isAcquireTimeout(error)),
113
+ { callbackAt: 'first' },
114
+ );
115
+ },
116
+ );
117
+ };
118
+
119
+ /**
120
+ * Пул `pg-pool`. Подключённые до вызова соединения берутся из `_clients`;
121
+ * соединение, которое в момент вызова ещё подключается, учитывается по
122
+ * событию `connect`, когда подключится. В `stats` оно до этого тоже не
123
+ * считается открытым.
124
+ *
125
+ * Ошибки соединений считает `PoolRecorder` по самим соединениям:
126
+ * событие пула `error` приходит только для простаивающих соединений
127
+ */
128
+ export const pgPoolAdapter: PoolAdapter<PgPoolInternals> = {
129
+ isPool: isPgPoolLike,
130
+
131
+ // Итог — когда закончился первый вызов `end`: к этому моменту пул закрыл
132
+ // все соединения и о каждом сообщил событием `remove`. Повторный `end`
133
+ // pg-pool отклоняет сразу, пока первый ещё идёт
134
+ closeMethod: 'end',
135
+
136
+ openConnections: connectedClients,
137
+
138
+ // `totalCount` — длина `_clients`, а туда клиент попадает до подключения.
139
+ // Поэтому открытыми считаются только подключённые клиенты, как у tarn.
140
+ // Каждый подключающийся клиент pg-pool создаёт для одного вызова `connect`,
141
+ // и этого вызывающего нет в `waitingCount`: он добавляется к ждущим, как
142
+ // `numPendingAcquires` у tarn. Без `_clients` подключённых не отличить,
143
+ // и счётчики берутся как есть
144
+ stats: (pool) => {
145
+ if (pool._clients === undefined) {
146
+ return {
147
+ total: pool.totalCount,
148
+ idle: pool.idleCount,
149
+ active: pool.totalCount - pool.idleCount,
150
+ waiting: pool.waitingCount,
151
+ max: pool.options.max ?? 0,
152
+ };
153
+ }
154
+
155
+ const connected = connectedClients(pool).length;
156
+
157
+ return {
158
+ total: connected,
159
+ idle: pool.idleCount,
160
+ active: connected - pool.idleCount,
161
+ waiting: pool.waitingCount + (pool.totalCount - connected),
162
+ max: pool.options.max ?? 0,
163
+ };
164
+ },
165
+
166
+ attach: (pool, events, onConnectionCreated) =>
167
+ once(
168
+ listen(pool, {
169
+ connect: onConnectionCreated,
170
+ acquire: (client: object) => events.connectionAcquired(client),
171
+ release: (_error: unknown, client: object) =>
172
+ events.connectionReleased(client),
173
+ remove: (client: object) => events.connectionClosed(client),
174
+ }),
175
+ wrapConnect(pool, events),
176
+ ),
177
+ };
@@ -0,0 +1,35 @@
1
+ import type { PgPoolInternals } from './pg-pool.instrumentation';
2
+ import { pgPoolAdapter } from './pg-pool.instrumentation';
3
+ import type { PoolAdapter } from './pool.adapter';
4
+ import type { TarnPoolInternals } from './tarn-pool.instrumentation';
5
+ import { tarnPoolAdapter } from './tarn-pool.instrumentation';
6
+
7
+ /**
8
+ * Вид пула: `pg` — `pg-pool` (TypeORM), `tarn` — пул knex (MikroORM).
9
+ * Записан литералами, а не через `keyof PoolTypes`: тип входит в
10
+ * `plugin-kit` и не должен ссылаться на внутренние типы пулов
11
+ */
12
+ export type DbPoolKind = 'pg' | 'tarn';
13
+
14
+ /**
15
+ * Вид пула → тип, к которому его сужает проверка адаптера
16
+ */
17
+ interface PoolTypes {
18
+ pg: PgPoolInternals;
19
+ tarn: TarnPoolInternals;
20
+ }
21
+
22
+ const POOL_ADAPTERS: {
23
+ readonly [K in DbPoolKind]: PoolAdapter<PoolTypes[K]>;
24
+ } = {
25
+ pg: pgPoolAdapter,
26
+ tarn: tarnPoolAdapter,
27
+ };
28
+
29
+ /**
30
+ * Адаптер пула этого вида. Отдельная функция, а не обращение к таблице:
31
+ * так TypeScript связывает вид пула с типом, к которому сужает его проверка
32
+ */
33
+ export const poolAdapter = <K extends DbPoolKind>(
34
+ kind: K,
35
+ ): PoolAdapter<PoolTypes[K]> => POOL_ADAPTERS[kind];
@@ -0,0 +1,59 @@
1
+ import { callThen } from '../call-then';
2
+ import type { Detach } from '../detach';
3
+ import { noop, once, replaceMethod } from '../detach';
4
+
5
+ /**
6
+ * Оборачивает метод, которым пул закрывается (`end` у pg-pool, `destroy`
7
+ * у tarn), чтобы вызвать `finish`, когда закончился первый его вызов.
8
+ * Повторные вызовы идут мимо учёта: и pg-pool, и tarn к этому моменту уже
9
+ * закрывают пул по первому вызову. Если метода нет, оборачивать нечего
10
+ */
11
+ const wrapClose = <TPool extends object>(
12
+ pool: TPool,
13
+ methodName: keyof TPool & string,
14
+ finish: () => void,
15
+ ): Detach => {
16
+ const original: unknown = pool[methodName];
17
+
18
+ if (typeof original !== 'function') {
19
+ return noop;
20
+ }
21
+
22
+ let closing = false;
23
+
24
+ return replaceMethod(pool, methodName, function (
25
+ this: unknown,
26
+ ...args: unknown[]
27
+ ): unknown {
28
+ if (closing) {
29
+ return original.apply(this, args);
30
+ }
31
+
32
+ closing = true;
33
+
34
+ return callThen(original as (...a: any[]) => any, this, args, finish, {
35
+ callbackAt: 'last',
36
+ });
37
+ } as TPool[keyof TPool & string]);
38
+ };
39
+
40
+ /**
41
+ * Итог по пулу: шаги выполняются один раз, когда закончился первый вызов
42
+ * метода закрытия или вызван возвращённый detach, — что наступит раньше.
43
+ * Обёртка метода закрытия снимается перед шагами
44
+ *
45
+ * @param steps что сделать при итоге, по порядку
46
+ * @returns detach, который подводит итог
47
+ */
48
+ export const finishOnClose = <TPool extends object>(
49
+ pool: TPool,
50
+ methodName: keyof TPool & string,
51
+ steps: readonly Detach[],
52
+ ): Detach => {
53
+ let restoreClose: Detach = noop;
54
+ const finish = once(() => restoreClose(), ...steps);
55
+
56
+ restoreClose = wrapClose(pool, methodName, finish);
57
+
58
+ return finish;
59
+ };