@rsdk/db 5.15.0-next.1 → 5.15.0-next.10

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 (140) hide show
  1. package/dist/index.d.ts +1 -0
  2. package/dist/index.js +15 -0
  3. package/dist/index.js.map +1 -1
  4. package/dist/metrics/call-then.d.ts +30 -0
  5. package/dist/metrics/call-then.js +91 -0
  6. package/dist/metrics/call-then.js.map +1 -0
  7. package/dist/metrics/clock.d.ts +2 -0
  8. package/dist/metrics/clock.js +9 -0
  9. package/dist/metrics/clock.js.map +1 -0
  10. package/dist/metrics/db-client-metrics.d.ts +85 -0
  11. package/dist/metrics/db-client-metrics.js +164 -0
  12. package/dist/metrics/db-client-metrics.js.map +1 -0
  13. package/dist/metrics/db-metric.d.ts +41 -0
  14. package/dist/metrics/db-metric.js +99 -0
  15. package/dist/metrics/db-metric.js.map +1 -0
  16. package/dist/metrics/db-metrics.config.d.ts +7 -0
  17. package/dist/metrics/db-metrics.config.js +60 -0
  18. package/dist/metrics/db-metrics.config.js.map +1 -0
  19. package/dist/metrics/db-metrics.module-base.d.ts +61 -0
  20. package/dist/metrics/db-metrics.module-base.js +61 -0
  21. package/dist/metrics/db-metrics.module-base.js.map +1 -0
  22. package/dist/metrics/db-metrics.providers.d.ts +66 -0
  23. package/dist/metrics/db-metrics.providers.js +83 -0
  24. package/dist/metrics/db-metrics.providers.js.map +1 -0
  25. package/dist/metrics/detach-group.d.ts +19 -0
  26. package/dist/metrics/detach-group.js +31 -0
  27. package/dist/metrics/detach-group.js.map +1 -0
  28. package/dist/metrics/detach.d.ts +24 -0
  29. package/dist/metrics/detach.js +45 -0
  30. package/dist/metrics/detach.js.map +1 -0
  31. package/dist/metrics/entity-operations.recorder.d.ts +17 -0
  32. package/dist/metrics/entity-operations.recorder.js +28 -0
  33. package/dist/metrics/entity-operations.recorder.js.map +1 -0
  34. package/dist/metrics/events.d.ts +11 -0
  35. package/dist/metrics/events.js +20 -0
  36. package/dist/metrics/events.js.map +1 -0
  37. package/dist/metrics/guards.d.ts +12 -0
  38. package/dist/metrics/guards.js +19 -0
  39. package/dist/metrics/guards.js.map +1 -0
  40. package/dist/metrics/index.d.ts +1 -0
  41. package/dist/metrics/index.js +11 -0
  42. package/dist/metrics/index.js.map +1 -0
  43. package/dist/metrics/instrumentation/pg-pool.instrumentation.d.ts +48 -0
  44. package/dist/metrics/instrumentation/pg-pool.instrumentation.js +117 -0
  45. package/dist/metrics/instrumentation/pg-pool.instrumentation.js.map +1 -0
  46. package/dist/metrics/instrumentation/pool-adapters.d.ts +22 -0
  47. package/dist/metrics/instrumentation/pool-adapters.js +16 -0
  48. package/dist/metrics/instrumentation/pool-adapters.js.map +1 -0
  49. package/dist/metrics/instrumentation/pool-close.d.ts +10 -0
  50. package/dist/metrics/instrumentation/pool-close.js +43 -0
  51. package/dist/metrics/instrumentation/pool-close.js.map +1 -0
  52. package/dist/metrics/instrumentation/pool-scope.d.ts +13 -0
  53. package/dist/metrics/instrumentation/pool-scope.js +3 -0
  54. package/dist/metrics/instrumentation/pool-scope.js.map +1 -0
  55. package/dist/metrics/instrumentation/pool.adapter.d.ts +50 -0
  56. package/dist/metrics/instrumentation/pool.adapter.js +3 -0
  57. package/dist/metrics/instrumentation/pool.adapter.js.map +1 -0
  58. package/dist/metrics/instrumentation/pool.recorder.d.ts +74 -0
  59. package/dist/metrics/instrumentation/pool.recorder.js +125 -0
  60. package/dist/metrics/instrumentation/pool.recorder.js.map +1 -0
  61. package/dist/metrics/instrumentation/query-completion.d.ts +12 -0
  62. package/dist/metrics/instrumentation/query-completion.js +76 -0
  63. package/dist/metrics/instrumentation/query-completion.js.map +1 -0
  64. package/dist/metrics/instrumentation/query.instrumentation.d.ts +35 -0
  65. package/dist/metrics/instrumentation/query.instrumentation.js +85 -0
  66. package/dist/metrics/instrumentation/query.instrumentation.js.map +1 -0
  67. package/dist/metrics/instrumentation/tarn-pool.instrumentation.d.ts +44 -0
  68. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js +95 -0
  69. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js.map +1 -0
  70. package/dist/metrics/instrumentation/transaction-tracker.d.ts +32 -0
  71. package/dist/metrics/instrumentation/transaction-tracker.js +64 -0
  72. package/dist/metrics/instrumentation/transaction-tracker.js.map +1 -0
  73. package/dist/metrics/metric-types.d.ts +17 -0
  74. package/dist/metrics/metric-types.js +3 -0
  75. package/dist/metrics/metric-types.js.map +1 -0
  76. package/dist/metrics/metrics.d.ts +82 -0
  77. package/dist/metrics/metrics.js +269 -0
  78. package/dist/metrics/metrics.js.map +1 -0
  79. package/dist/metrics/plugin-kit.d.ts +12 -0
  80. package/dist/metrics/plugin-kit.js +42 -0
  81. package/dist/metrics/plugin-kit.js.map +1 -0
  82. package/dist/metrics/pool-names.d.ts +47 -0
  83. package/dist/metrics/pool-names.js +44 -0
  84. package/dist/metrics/pool-names.js.map +1 -0
  85. package/dist/metrics/pool-stats.registry.d.ts +25 -0
  86. package/dist/metrics/pool-stats.registry.js +32 -0
  87. package/dist/metrics/pool-stats.registry.js.map +1 -0
  88. package/dist/metrics/scrape-source.registry.d.ts +29 -0
  89. package/dist/metrics/scrape-source.registry.js +55 -0
  90. package/dist/metrics/scrape-source.registry.js.map +1 -0
  91. package/dist/metrics/sql.d.ts +34 -0
  92. package/dist/metrics/sql.js +132 -0
  93. package/dist/metrics/sql.js.map +1 -0
  94. package/package.json +2 -2
  95. package/src/index.ts +1 -0
  96. package/src/metrics/call-then.ts +134 -0
  97. package/src/metrics/clock.ts +5 -0
  98. package/src/metrics/db-client-metrics.spec.ts +1894 -0
  99. package/src/metrics/db-client-metrics.ts +206 -0
  100. package/src/metrics/db-metric.spec.ts +185 -0
  101. package/src/metrics/db-metric.ts +186 -0
  102. package/src/metrics/db-metrics.config.ts +46 -0
  103. package/src/metrics/db-metrics.module-base.spec.ts +91 -0
  104. package/src/metrics/db-metrics.module-base.ts +77 -0
  105. package/src/metrics/db-metrics.providers.spec.ts +182 -0
  106. package/src/metrics/db-metrics.providers.ts +134 -0
  107. package/src/metrics/detach-group.spec.ts +41 -0
  108. package/src/metrics/detach-group.ts +30 -0
  109. package/src/metrics/detach.spec.ts +61 -0
  110. package/src/metrics/detach.ts +57 -0
  111. package/src/metrics/entity-operations.recorder.ts +26 -0
  112. package/src/metrics/events.spec.ts +19 -0
  113. package/src/metrics/events.ts +28 -0
  114. package/src/metrics/guards.spec.ts +20 -0
  115. package/src/metrics/guards.ts +19 -0
  116. package/src/metrics/index.ts +6 -0
  117. package/src/metrics/instrumentation/pg-pool.instrumentation.ts +177 -0
  118. package/src/metrics/instrumentation/pool-adapters.ts +35 -0
  119. package/src/metrics/instrumentation/pool-close.ts +59 -0
  120. package/src/metrics/instrumentation/pool-guards.spec.ts +318 -0
  121. package/src/metrics/instrumentation/pool-scope.ts +14 -0
  122. package/src/metrics/instrumentation/pool.adapter.ts +67 -0
  123. package/src/metrics/instrumentation/pool.recorder.ts +167 -0
  124. package/src/metrics/instrumentation/query-completion.spec.ts +209 -0
  125. package/src/metrics/instrumentation/query-completion.ts +107 -0
  126. package/src/metrics/instrumentation/query.instrumentation.ts +136 -0
  127. package/src/metrics/instrumentation/tarn-pool.instrumentation.ts +138 -0
  128. package/src/metrics/instrumentation/transaction-tracker.ts +103 -0
  129. package/src/metrics/metric-types.ts +36 -0
  130. package/src/metrics/metrics.ts +233 -0
  131. package/src/metrics/plugin-kit.ts +39 -0
  132. package/src/metrics/pool-names.spec.ts +79 -0
  133. package/src/metrics/pool-names.ts +77 -0
  134. package/src/metrics/pool-stats.registry.spec.ts +81 -0
  135. package/src/metrics/pool-stats.registry.ts +54 -0
  136. package/src/metrics/public-api.spec.ts +104 -0
  137. package/src/metrics/scrape-source.registry.spec.ts +59 -0
  138. package/src/metrics/scrape-source.registry.ts +55 -0
  139. package/src/metrics/sql.spec.ts +110 -0
  140. package/src/metrics/sql.ts +172 -0
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.DbMetricsConfig = void 0;
13
+ const common_1 = require("@rsdk/common");
14
+ const core_1 = require("@rsdk/core");
15
+ let DbMetricsConfig = class DbMetricsConfig extends core_1.Config {
16
+ isEnabled;
17
+ slowQueryThreshold;
18
+ ormEntityOperationsTotalEnabled;
19
+ };
20
+ exports.DbMetricsConfig = DbMetricsConfig;
21
+ __decorate([
22
+ (0, core_1.Property)('ENABLED', new core_1.BoolParser(), {
23
+ defaultValue: true,
24
+ description: (0, common_1.text) `
25
+ Enables database metrics. When false, the application registers
26
+ no database metrics and instruments nothing.
27
+ TypeORM: pool, query and transaction metrics only for postgres and cockroachdb;
28
+ for other drivers only ORM metrics.
29
+ MikroORM: pool metrics for any knex driver, query and transaction
30
+ metrics only for PostgreSQL; for MongoDB only ORM metrics.
31
+ `,
32
+ }),
33
+ __metadata("design:type", Boolean)
34
+ ], DbMetricsConfig.prototype, "isEnabled", void 0);
35
+ __decorate([
36
+ (0, core_1.Property)('SLOW_QUERY_THRESHOLD', new core_1.TimespanParser(), {
37
+ defaultValue: new common_1.Timespan(500, 'ms'),
38
+ description: 'Queries longer than this are counted in db_client_slow_queries_total',
39
+ }),
40
+ __metadata("design:type", common_1.Timespan)
41
+ ], DbMetricsConfig.prototype, "slowQueryThreshold", void 0);
42
+ __decorate([
43
+ (0, core_1.Property)('ORM_ENTITY_OPERATIONS_TOTAL_ENABLED', new core_1.BoolParser(), {
44
+ defaultValue: false,
45
+ description: (0, common_1.text) `
46
+ Enables orm_entity_operations_total. Works only with
47
+ DB_METRICS_ENABLED=true. Off by default because the entity label
48
+ multiplies the number of series.
49
+ `,
50
+ }),
51
+ __metadata("design:type", Boolean)
52
+ ], DbMetricsConfig.prototype, "ormEntityOperationsTotalEnabled", void 0);
53
+ exports.DbMetricsConfig = DbMetricsConfig = __decorate([
54
+ (0, core_1.ConfigSection)({
55
+ name: 'Database metrics config',
56
+ tags: [core_1.ConfigTag.infrastructure, core_1.ConfigTag.storage, core_1.ConfigTag.metric],
57
+ prefix: 'DB_METRICS',
58
+ })
59
+ ], DbMetricsConfig);
60
+ //# sourceMappingURL=db-metrics.config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-metrics.config.js","sourceRoot":"","sources":["../../src/metrics/db-metrics.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAA8C;AAC9C,qCAOoB;AAOb,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,aAAM;IAYzC,SAAS,CAAW;IAOpB,kBAAkB,CAAY;IAU9B,+BAA+B,CAAW;CAC3C,CAAA;AA9BY,0CAAe;AAY1B;IAXC,IAAA,eAAQ,EAAC,SAAS,EAAE,IAAI,iBAAU,EAAE,EAAE;QACrC,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAA,aAAI,EAAA;;;;;;;KAOhB;KACF,CAAC;;kDACkB;AAOpB;IALC,IAAA,eAAQ,EAAC,sBAAsB,EAAE,IAAI,qBAAc,EAAE,EAAE;QACtD,YAAY,EAAE,IAAI,iBAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;QACrC,WAAW,EACT,sEAAsE;KACzE,CAAC;8BACmB,iBAAQ;2DAAC;AAU9B;IARC,IAAA,eAAQ,EAAC,qCAAqC,EAAE,IAAI,iBAAU,EAAE,EAAE;QACjE,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,IAAA,aAAI,EAAA;;;;KAIhB;KACF,CAAC;;wEACwC;0BA7B/B,eAAe;IAL3B,IAAA,oBAAa,EAAC;QACb,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,CAAC,gBAAS,CAAC,cAAc,EAAE,gBAAS,CAAC,OAAO,EAAE,gBAAS,CAAC,MAAM,CAAC;QACrE,MAAM,EAAE,YAAY;KACrB,CAAC;GACW,eAAe,CA8B3B"}
@@ -0,0 +1,61 @@
1
+ import type { DbClientMetrics } from './db-client-metrics';
2
+ import type { Detach } from './detach';
3
+ import type { EntityOperationsRecorder } from './entity-operations.recorder';
4
+ /**
5
+ * Базовый класс модуля метрик ORM-плагина. Итог при остановке приложения
6
+ * описан здесь, один раз для всех ORM. Наследник реализует только
7
+ * {@link DbMetricsModuleBase.attach} и не переопределяет `onModuleInit` и
8
+ * `onApplicationShutdown`.
9
+ *
10
+ * Метрики и инструментирование приходят через DI из
11
+ * `dbMetricsModuleProviders`: наследник внедряет `DbClientMetrics` и
12
+ * `EntityOperationsRecorder` через `@Inject(DB_CLIENT_METRICS_TOKEN)` и
13
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)` и передаёт их в конструктор.
14
+ * Классы плагин видит только как типы, так что без токена Nest их не
15
+ * найдёт; к тому же для типа `T | null` он не выводит токен из
16
+ * метаданных. `null` значит, что метрики (или
17
+ * `orm_entity_operations_total`) выключены, — второй проверки конфига здесь
18
+ * нет.
19
+ *
20
+ * Интерфейсы `OnModuleInit` и `OnApplicationShutdown` объявляет наследник:
21
+ * у `@rsdk/db` нет зависимости от Nest, а Nest находит хуки по имени метода
22
+ */
23
+ export declare abstract class DbMetricsModuleBase {
24
+ private readonly client;
25
+ protected readonly entityOperations: EntityOperationsRecorder | null;
26
+ private readonly detaches;
27
+ /**
28
+ * @param client инструментирование пулов, запросов и транзакций или
29
+ * `null`, если метрики выключены (`DB_METRICS_ENABLED=false`)
30
+ * @param entityOperations запись `orm_entity_operations_total` или
31
+ * `null`, если метрика выключена
32
+ * (`DB_METRICS_ORM_ENTITY_OPERATIONS_TOTAL_ENABLED`)
33
+ */
34
+ protected constructor(client: DbClientMetrics | null, entityOperations: EntityOperationsRecorder | null);
35
+ /**
36
+ * Подключает метрики, если они включены
37
+ */
38
+ onModuleInit(): void;
39
+ /**
40
+ * Снимает всё подключённое в обратном порядке: подводит итог по пулам,
41
+ * выключает subscriber-ы и обёртки.
42
+ *
43
+ * Не `onModuleDestroy`: Nest вызывает его до того, как перестаёт принимать
44
+ * запросы, и транзакция, которая ещё идёт, закоммитилась бы уже после итога
45
+ * по пулу и попала бы в rollback. Если ORM закрыл пул раньше, итог уже
46
+ * подведён. Повторный вызов ничего не делает
47
+ */
48
+ onApplicationShutdown(): void;
49
+ /**
50
+ * Подключает метрики ORM: находит пулы и передаёт их в `client`,
51
+ * ставит subscriber-ы и обёртки. Вызывается один раз и только при
52
+ * включённых метриках.
53
+ *
54
+ * @param add принимает detach всего, что подключено: при остановке
55
+ * приложения оно снимается в обратном порядке. `undefined` пропускается,
56
+ * так что можно передать результат подключения, которое не состоялось
57
+ * (например, пул не прошёл проверку)
58
+ * @param client инструментирование, полученное из DI
59
+ */
60
+ protected abstract attach(add: (detach?: Detach) => void, client: DbClientMetrics): void;
61
+ }
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DbMetricsModuleBase = void 0;
4
+ const detach_group_1 = require("./detach-group");
5
+ /**
6
+ * Базовый класс модуля метрик ORM-плагина. Итог при остановке приложения
7
+ * описан здесь, один раз для всех ORM. Наследник реализует только
8
+ * {@link DbMetricsModuleBase.attach} и не переопределяет `onModuleInit` и
9
+ * `onApplicationShutdown`.
10
+ *
11
+ * Метрики и инструментирование приходят через DI из
12
+ * `dbMetricsModuleProviders`: наследник внедряет `DbClientMetrics` и
13
+ * `EntityOperationsRecorder` через `@Inject(DB_CLIENT_METRICS_TOKEN)` и
14
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)` и передаёт их в конструктор.
15
+ * Классы плагин видит только как типы, так что без токена Nest их не
16
+ * найдёт; к тому же для типа `T | null` он не выводит токен из
17
+ * метаданных. `null` значит, что метрики (или
18
+ * `orm_entity_operations_total`) выключены, — второй проверки конфига здесь
19
+ * нет.
20
+ *
21
+ * Интерфейсы `OnModuleInit` и `OnApplicationShutdown` объявляет наследник:
22
+ * у `@rsdk/db` нет зависимости от Nest, а Nest находит хуки по имени метода
23
+ */
24
+ class DbMetricsModuleBase {
25
+ client;
26
+ entityOperations;
27
+ detaches = new detach_group_1.DetachGroup();
28
+ /**
29
+ * @param client инструментирование пулов, запросов и транзакций или
30
+ * `null`, если метрики выключены (`DB_METRICS_ENABLED=false`)
31
+ * @param entityOperations запись `orm_entity_operations_total` или
32
+ * `null`, если метрика выключена
33
+ * (`DB_METRICS_ORM_ENTITY_OPERATIONS_TOTAL_ENABLED`)
34
+ */
35
+ constructor(client, entityOperations) {
36
+ this.client = client;
37
+ this.entityOperations = entityOperations;
38
+ }
39
+ /**
40
+ * Подключает метрики, если они включены
41
+ */
42
+ onModuleInit() {
43
+ if (this.client !== null) {
44
+ this.attach((detach) => this.detaches.add(detach), this.client);
45
+ }
46
+ }
47
+ /**
48
+ * Снимает всё подключённое в обратном порядке: подводит итог по пулам,
49
+ * выключает subscriber-ы и обёртки.
50
+ *
51
+ * Не `onModuleDestroy`: Nest вызывает его до того, как перестаёт принимать
52
+ * запросы, и транзакция, которая ещё идёт, закоммитилась бы уже после итога
53
+ * по пулу и попала бы в rollback. Если ORM закрыл пул раньше, итог уже
54
+ * подведён. Повторный вызов ничего не делает
55
+ */
56
+ onApplicationShutdown() {
57
+ this.detaches.detachAll();
58
+ }
59
+ }
60
+ exports.DbMetricsModuleBase = DbMetricsModuleBase;
61
+ //# sourceMappingURL=db-metrics.module-base.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-metrics.module-base.js","sourceRoot":"","sources":["../../src/metrics/db-metrics.module-base.ts"],"names":[],"mappings":";;;AAEA,iDAA6C;AAG7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAsB,mBAAmB;IAWpB;IACE;IAXJ,QAAQ,GAAG,IAAI,0BAAW,EAAE,CAAC;IAE9C;;;;;;OAMG;IACH,YACmB,MAA8B,EAC5B,gBAAiD;QADnD,WAAM,GAAN,MAAM,CAAwB;QAC5B,qBAAgB,GAAhB,gBAAgB,CAAiC;IACnE,CAAC;IAEJ;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,qBAAqB;QACnB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;CAiBF;AApDD,kDAoDC"}
@@ -0,0 +1,66 @@
1
+ import type { Constructor } from '@rsdk/common';
2
+ import type { AnyMetric } from '@rsdk/core';
3
+ import { DbClientMetrics } from './db-client-metrics';
4
+ import { DbMetricsConfig } from './db-metrics.config';
5
+ import { EntityOperationsRecorder } from './entity-operations.recorder';
6
+ /**
7
+ * Токен DI для {@link DbClientMetrics} из {@link dbMetricsModuleProviders}.
8
+ * Плагин внедряет экземпляр через `@Inject(DB_CLIENT_METRICS_TOKEN)`, а сам
9
+ * класс получает из `plugin-kit` только как тип: так фабрика
10
+ * `DbClientMetrics.create` недоступна в обход проверки `DB_METRICS_ENABLED`
11
+ */
12
+ export declare const DB_CLIENT_METRICS_TOKEN: unique symbol;
13
+ /**
14
+ * Токен DI для {@link EntityOperationsRecorder} из
15
+ * {@link dbMetricsModuleProviders}. Плагин внедряет экземпляр через
16
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)`, а класс получает из
17
+ * `plugin-kit` только как тип, по той же причине, что и
18
+ * {@link DB_CLIENT_METRICS_TOKEN}
19
+ */
20
+ export declare const ENTITY_OPERATIONS_RECORDER_TOKEN: unique symbol;
21
+ /**
22
+ * Nest-провайдер модуля метрик ORM: по `DbMetricsConfig` отдаёт метрику,
23
+ * {@link DbClientMetrics} или {@link EntityOperationsRecorder}, а если они
24
+ * выключены — `null`. Метрика объявляется по своему классу, два последних —
25
+ * по токенам {@link DB_CLIENT_METRICS_TOKEN} и
26
+ * {@link ENTITY_OPERATIONS_RECORDER_TOKEN}.
27
+ *
28
+ * Варианты записаны целиком, без вспомогательного generic: тип входит
29
+ * в `plugin-kit` и не должен ссылаться на неэкспортированные типы
30
+ */
31
+ export type DbMetricProvider = {
32
+ provide: Constructor<AnyMetric>;
33
+ inject: (typeof DbMetricsConfig)[];
34
+ useFactory: (config: DbMetricsConfig) => AnyMetric | null;
35
+ } | {
36
+ provide: typeof DB_CLIENT_METRICS_TOKEN;
37
+ inject: (typeof DbMetricsConfig | symbol)[];
38
+ useFactory: (config: DbMetricsConfig, appName: string) => DbClientMetrics | null;
39
+ } | {
40
+ provide: typeof ENTITY_OPERATIONS_RECORDER_TOKEN;
41
+ inject: (typeof DbMetricsConfig)[];
42
+ useFactory: (config: DbMetricsConfig) => EntityOperationsRecorder | null;
43
+ };
44
+ /**
45
+ * Провайдеры для модуля метрик ORM: общие метрики пула, запросов и
46
+ * транзакций, метрики самого ORM из `extra`, `orm_entity_operations_total`,
47
+ * а также {@link DbClientMetrics} и {@link EntityOperationsRecorder}.
48
+ *
49
+ * Общие метрики, `extra` и `DbClientMetrics` есть при
50
+ * `DB_METRICS_ENABLED=true`, `orm_entity_operations_total` и
51
+ * `EntityOperationsRecorder` — когда к тому же
52
+ * `DB_METRICS_ORM_ENTITY_OPERATIONS_TOTAL_ENABLED=true`. Иначе провайдер
53
+ * отдаёт `null`, но объявлен всё равно: по нему autodoc находит метрику.
54
+ *
55
+ * `DbClientMetrics` получает `APP_NAME` приложения из DI: с него начинается
56
+ * значение метки `pool`, плагин передаёт только ресурс.
57
+ *
58
+ * Условие «включено» записано только здесь. Модуль метрик внедряет
59
+ * метрики из `extra` через `@Inject(<класс метрики>)`, а `DbClientMetrics` и
60
+ * `EntityOperationsRecorder` — через `@Inject(DB_CLIENT_METRICS_TOKEN)` и
61
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)`, и сам их не создаёт: `null`
62
+ * и значит «выключено»
63
+ *
64
+ * @param extra метрики ORM, объявленные через `@DbMetric`
65
+ */
66
+ export declare const dbMetricsModuleProviders: (extra?: readonly Constructor<AnyMetric>[]) => DbMetricProvider[];
@@ -0,0 +1,83 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.dbMetricsModuleProviders = exports.ENTITY_OPERATIONS_RECORDER_TOKEN = exports.DB_CLIENT_METRICS_TOKEN = void 0;
4
+ const core_1 = require("@rsdk/core");
5
+ const db_client_metrics_1 = require("./db-client-metrics");
6
+ const db_metric_1 = require("./db-metric");
7
+ const db_metrics_config_1 = require("./db-metrics.config");
8
+ const entity_operations_recorder_1 = require("./entity-operations.recorder");
9
+ const metrics_1 = require("./metrics");
10
+ /**
11
+ * Токен DI для {@link DbClientMetrics} из {@link dbMetricsModuleProviders}.
12
+ * Плагин внедряет экземпляр через `@Inject(DB_CLIENT_METRICS_TOKEN)`, а сам
13
+ * класс получает из `plugin-kit` только как тип: так фабрика
14
+ * `DbClientMetrics.create` недоступна в обход проверки `DB_METRICS_ENABLED`
15
+ */
16
+ exports.DB_CLIENT_METRICS_TOKEN = Symbol('DbClientMetrics');
17
+ /**
18
+ * Токен DI для {@link EntityOperationsRecorder} из
19
+ * {@link dbMetricsModuleProviders}. Плагин внедряет экземпляр через
20
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)`, а класс получает из
21
+ * `plugin-kit` только как тип, по той же причине, что и
22
+ * {@link DB_CLIENT_METRICS_TOKEN}
23
+ */
24
+ exports.ENTITY_OPERATIONS_RECORDER_TOKEN = Symbol('EntityOperationsRecorder');
25
+ /**
26
+ * Писать ли `orm_entity_operations_total`: отдельный выключатель метрики
27
+ * работает только при включённых метриках БД
28
+ */
29
+ const entityOperationsEnabled = (config) => config.isEnabled && config.ormEntityOperationsTotalEnabled;
30
+ /**
31
+ * Nest-провайдеры метрик: через них метрики попадают в autodoc.
32
+ * Метрика регистрируется в prom-client только когда `when` для конфига
33
+ * приложения вернул `true`, иначе провайдер отдаёт `null`. Сам провайдер
34
+ * объявляется всегда: autodoc читает метрики по объявленным провайдерам.
35
+ *
36
+ * `DbMetricsConfig` в модуль импортировать не нужно: платформа rsdk находит
37
+ * config-секции в `inject` провайдеров и подставляет их сама
38
+ */
39
+ const dbMetricProviders = (ctors, when) => ctors.map((ctor) => ({
40
+ provide: ctor,
41
+ inject: [db_metrics_config_1.DbMetricsConfig],
42
+ useFactory: (config) => when(config) ? (0, db_metric_1.resolveDbMetric)(ctor) : null,
43
+ }));
44
+ /**
45
+ * Провайдеры для модуля метрик ORM: общие метрики пула, запросов и
46
+ * транзакций, метрики самого ORM из `extra`, `orm_entity_operations_total`,
47
+ * а также {@link DbClientMetrics} и {@link EntityOperationsRecorder}.
48
+ *
49
+ * Общие метрики, `extra` и `DbClientMetrics` есть при
50
+ * `DB_METRICS_ENABLED=true`, `orm_entity_operations_total` и
51
+ * `EntityOperationsRecorder` — когда к тому же
52
+ * `DB_METRICS_ORM_ENTITY_OPERATIONS_TOTAL_ENABLED=true`. Иначе провайдер
53
+ * отдаёт `null`, но объявлен всё равно: по нему autodoc находит метрику.
54
+ *
55
+ * `DbClientMetrics` получает `APP_NAME` приложения из DI: с него начинается
56
+ * значение метки `pool`, плагин передаёт только ресурс.
57
+ *
58
+ * Условие «включено» записано только здесь. Модуль метрик внедряет
59
+ * метрики из `extra` через `@Inject(<класс метрики>)`, а `DbClientMetrics` и
60
+ * `EntityOperationsRecorder` — через `@Inject(DB_CLIENT_METRICS_TOKEN)` и
61
+ * `@Inject(ENTITY_OPERATIONS_RECORDER_TOKEN)`, и сам их не создаёт: `null`
62
+ * и значит «выключено»
63
+ *
64
+ * @param extra метрики ORM, объявленные через `@DbMetric`
65
+ */
66
+ const dbMetricsModuleProviders = (extra = []) => [
67
+ ...dbMetricProviders([...metrics_1.DB_CLIENT_METRICS, ...extra], (config) => config.isEnabled),
68
+ ...dbMetricProviders([metrics_1.OrmEntityOperations], entityOperationsEnabled),
69
+ {
70
+ provide: exports.DB_CLIENT_METRICS_TOKEN,
71
+ inject: [db_metrics_config_1.DbMetricsConfig, core_1.APP_NAME],
72
+ useFactory: (config, appName) => config.isEnabled ? db_client_metrics_1.DbClientMetrics.create(config, appName) : null,
73
+ },
74
+ {
75
+ provide: exports.ENTITY_OPERATIONS_RECORDER_TOKEN,
76
+ inject: [db_metrics_config_1.DbMetricsConfig],
77
+ useFactory: (config) => entityOperationsEnabled(config)
78
+ ? entity_operations_recorder_1.EntityOperationsRecorder.create()
79
+ : null,
80
+ },
81
+ ];
82
+ exports.dbMetricsModuleProviders = dbMetricsModuleProviders;
83
+ //# sourceMappingURL=db-metrics.providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-metrics.providers.js","sourceRoot":"","sources":["../../src/metrics/db-metrics.providers.ts"],"names":[],"mappings":";;;AAEA,qCAAsC;AAEtC,2DAAsD;AACtD,2CAA8C;AAC9C,2DAAsD;AACtD,6EAAwE;AACxE,uCAAmE;AAEnE;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEjE;;;;;;GAMG;AACU,QAAA,gCAAgC,GAAG,MAAM,CACpD,0BAA0B,CAC3B,CAAC;AAgCF;;;GAGG;AACH,MAAM,uBAAuB,GAAG,CAAC,MAAuB,EAAW,EAAE,CACnE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,+BAA+B,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,CACxB,KAAwC,EACxC,IAA0C,EACtB,EAAE,CACtB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,CAAC,mCAAe,CAAC;IACzB,UAAU,EAAE,CAAC,MAAuB,EAAoB,EAAE,CACxD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,2BAAe,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;CAC9C,CAAC,CAAC,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,wBAAwB,GAAG,CACtC,QAA2C,EAAE,EACzB,EAAE,CAAC;IACvB,GAAG,iBAAiB,CAClB,CAAC,GAAG,2BAAiB,EAAE,GAAG,KAAK,CAAC,EAChC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAC7B;IACD,GAAG,iBAAiB,CAAC,CAAC,6BAAmB,CAAC,EAAE,uBAAuB,CAAC;IACpE;QACE,OAAO,EAAE,+BAAuB;QAChC,MAAM,EAAE,CAAC,mCAAe,EAAE,eAAQ,CAAC;QACnC,UAAU,EAAE,CACV,MAAuB,EACvB,OAAe,EACS,EAAE,CAC1B,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,mCAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;KACpE;IACD;QACE,OAAO,EAAE,wCAAgC;QACzC,MAAM,EAAE,CAAC,mCAAe,CAAC;QACzB,UAAU,EAAE,CAAC,MAAuB,EAAmC,EAAE,CACvE,uBAAuB,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAC,qDAAwB,CAAC,MAAM,EAAE;YACnC,CAAC,CAAC,IAAI;KACX;CACF,CAAC;AAzBW,QAAA,wBAAwB,4BAyBnC"}
@@ -0,0 +1,19 @@
1
+ import type { Detach } from './detach';
2
+ /**
3
+ * Всё, что модуль метрик подключил на время жизни приложения: при остановке
4
+ * снимается одним вызовом {@link DetachGroup.detachAll}
5
+ */
6
+ export declare class DetachGroup {
7
+ private readonly detaches;
8
+ /**
9
+ * `undefined` пропускается: так можно добавить результат подключения,
10
+ * которое не состоялось (например, пул не прошёл проверку)
11
+ */
12
+ add(detach?: Detach): void;
13
+ /**
14
+ * Снимает всё в обратном порядке: то, что подключили позже, может
15
+ * опираться на подключённое раньше. Повторный вызов снимает только
16
+ * добавленное после предыдущего
17
+ */
18
+ detachAll(): void;
19
+ }
@@ -0,0 +1,31 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DetachGroup = void 0;
4
+ /**
5
+ * Всё, что модуль метрик подключил на время жизни приложения: при остановке
6
+ * снимается одним вызовом {@link DetachGroup.detachAll}
7
+ */
8
+ class DetachGroup {
9
+ detaches = [];
10
+ /**
11
+ * `undefined` пропускается: так можно добавить результат подключения,
12
+ * которое не состоялось (например, пул не прошёл проверку)
13
+ */
14
+ add(detach) {
15
+ if (detach) {
16
+ this.detaches.push(detach);
17
+ }
18
+ }
19
+ /**
20
+ * Снимает всё в обратном порядке: то, что подключили позже, может
21
+ * опираться на подключённое раньше. Повторный вызов снимает только
22
+ * добавленное после предыдущего
23
+ */
24
+ detachAll() {
25
+ for (const detach of this.detaches.splice(0).reverse()) {
26
+ detach();
27
+ }
28
+ }
29
+ }
30
+ exports.DetachGroup = DetachGroup;
31
+ //# sourceMappingURL=detach-group.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detach-group.js","sourceRoot":"","sources":["../../src/metrics/detach-group.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,WAAW;IACL,QAAQ,GAAa,EAAE,CAAC;IAEzC;;;OAGG;IACH,GAAG,CAAC,MAAe;QACjB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;CACF;AAvBD,kCAuBC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Снимает то, что поставил вызов, который его вернул: подписки, обёртки
3
+ * методов, регистрацию. Повторный вызов ничего не делает: это обязана
4
+ * выполнять каждая функция, которая возвращает `Detach`, а не только
5
+ * вызывающий код. Проще всего — обернуть результат в {@link once}.
6
+ *
7
+ * Что именно снимается, описывает функция, которая вернула `Detach`
8
+ */
9
+ export type Detach = () => void;
10
+ export declare const noop: () => void;
11
+ /**
12
+ * Вызывает все шаги по порядку при первом вызове результата. Следующие
13
+ * вызовы ничего не делают
14
+ */
15
+ export declare const once: (...steps: readonly Detach[]) => Detach;
16
+ /**
17
+ * Подменяет метод объекта и возвращает восстановление: собственное свойство
18
+ * получает прежнее значение, а метод из прототипа снова виден через него,
19
+ * потому что подмена удаляется.
20
+ *
21
+ * Восстановление срабатывает один раз: если после него метод подменил
22
+ * кто-то другой, повторный вызов эту подмену не затрёт
23
+ */
24
+ export declare const replaceMethod: <T extends object, K extends keyof T>(target: T, key: K, replacement: T[K]) => Detach;
@@ -0,0 +1,45 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.replaceMethod = exports.once = exports.noop = void 0;
4
+ const noop = () => { };
5
+ exports.noop = noop;
6
+ /**
7
+ * Вызывает все шаги по порядку при первом вызове результата. Следующие
8
+ * вызовы ничего не делают
9
+ */
10
+ const once = (...steps) => {
11
+ let done = false;
12
+ return () => {
13
+ if (done) {
14
+ return;
15
+ }
16
+ done = true;
17
+ for (const step of steps) {
18
+ step();
19
+ }
20
+ };
21
+ };
22
+ exports.once = once;
23
+ /**
24
+ * Подменяет метод объекта и возвращает восстановление: собственное свойство
25
+ * получает прежнее значение, а метод из прототипа снова виден через него,
26
+ * потому что подмена удаляется.
27
+ *
28
+ * Восстановление срабатывает один раз: если после него метод подменил
29
+ * кто-то другой, повторный вызов эту подмену не затрёт
30
+ */
31
+ const replaceMethod = (target, key, replacement) => {
32
+ const original = target[key];
33
+ const own = Object.hasOwn(target, key);
34
+ target[key] = replacement;
35
+ return (0, exports.once)(() => {
36
+ if (own) {
37
+ target[key] = original;
38
+ }
39
+ else {
40
+ delete target[key];
41
+ }
42
+ });
43
+ };
44
+ exports.replaceMethod = replaceMethod;
45
+ //# sourceMappingURL=detach.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detach.js","sourceRoot":"","sources":["../../src/metrics/detach.ts"],"names":[],"mappings":";;;AAUO,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;AAAtB,QAAA,IAAI,QAAkB;AAEnC;;;GAGG;AACI,MAAM,IAAI,GAAG,CAAC,GAAG,KAAwB,EAAU,EAAE;IAC1D,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,OAAO,GAAG,EAAE;QACV,IAAI,IAAI,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,IAAI,GAAG,IAAI,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,IAAI,QAaf;AAEF;;;;;;;GAOG;AACI,MAAM,aAAa,GAAG,CAC3B,MAAS,EACT,GAAM,EACN,WAAiB,EACT,EAAE;IACV,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAE1B,OAAO,IAAA,YAAI,EAAC,GAAG,EAAE;QACf,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAjBW,QAAA,aAAa,iBAiBxB"}
@@ -0,0 +1,17 @@
1
+ import type { CounterLike } from './metric-types';
2
+ export type EntityOperation = 'load' | 'insert' | 'update' | 'delete';
3
+ /**
4
+ * Пишет `orm_entity_operations_total`. Общий для ORM, чтобы значения
5
+ * label `op` совпадали
6
+ */
7
+ export declare class EntityOperationsRecorder {
8
+ private readonly counter;
9
+ constructor(counter: CounterLike<'entity' | 'op'>);
10
+ /**
11
+ * Запись на метрике prom-client. Модуль метрик ORM сам её не вызывает:
12
+ * экземпляр (или `null`, если метрика выключена) приходит через DI из
13
+ * провайдера `dbMetricsModuleProviders`
14
+ */
15
+ static create(): EntityOperationsRecorder;
16
+ record(entity: string, op: EntityOperation): void;
17
+ }
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.EntityOperationsRecorder = void 0;
4
+ const db_metric_1 = require("./db-metric");
5
+ const metrics_1 = require("./metrics");
6
+ /**
7
+ * Пишет `orm_entity_operations_total`. Общий для ORM, чтобы значения
8
+ * label `op` совпадали
9
+ */
10
+ class EntityOperationsRecorder {
11
+ counter;
12
+ constructor(counter) {
13
+ this.counter = counter;
14
+ }
15
+ /**
16
+ * Запись на метрике prom-client. Модуль метрик ORM сам её не вызывает:
17
+ * экземпляр (или `null`, если метрика выключена) приходит через DI из
18
+ * провайдера `dbMetricsModuleProviders`
19
+ */
20
+ static create() {
21
+ return new EntityOperationsRecorder((0, db_metric_1.resolveDbMetric)(metrics_1.OrmEntityOperations));
22
+ }
23
+ record(entity, op) {
24
+ this.counter.inc({ entity, op });
25
+ }
26
+ }
27
+ exports.EntityOperationsRecorder = EntityOperationsRecorder;
28
+ //# sourceMappingURL=entity-operations.recorder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-operations.recorder.js","sourceRoot":"","sources":["../../src/metrics/entity-operations.recorder.ts"],"names":[],"mappings":";;;AAAA,2CAA8C;AAE9C,uCAAgD;AAIhD;;;GAGG;AACH,MAAa,wBAAwB;IACN;IAA7B,YAA6B,OAAqC;QAArC,YAAO,GAAP,OAAO,CAA8B;IAAG,CAAC;IAEtE;;;;OAIG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,wBAAwB,CAAC,IAAA,2BAAe,EAAC,6BAAmB,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,EAAmB;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;CACF;AAfD,4DAeC"}
@@ -0,0 +1,11 @@
1
+ import type { Detach } from './detach';
2
+ export type Listener = (...args: any[]) => void;
3
+ export interface EventSource {
4
+ on(event: string | symbol, listener: Listener): unknown;
5
+ removeListener(event: string | symbol, listener: Listener): unknown;
6
+ }
7
+ /**
8
+ * Подписывает обработчики на события и возвращает отписку от всех сразу.
9
+ * Отписка срабатывает один раз
10
+ */
11
+ export declare const listen: (source: EventSource, listeners: Record<string, Listener>) => Detach;
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.listen = void 0;
4
+ const detach_1 = require("./detach");
5
+ /**
6
+ * Подписывает обработчики на события и возвращает отписку от всех сразу.
7
+ * Отписка срабатывает один раз
8
+ */
9
+ const listen = (source, listeners) => {
10
+ for (const [event, listener] of Object.entries(listeners)) {
11
+ source.on(event, listener);
12
+ }
13
+ return (0, detach_1.once)(() => {
14
+ for (const [event, listener] of Object.entries(listeners)) {
15
+ source.removeListener(event, listener);
16
+ }
17
+ });
18
+ };
19
+ exports.listen = listen;
20
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/metrics/events.ts"],"names":[],"mappings":";;;AACA,qCAAgC;AAShC;;;GAGG;AACI,MAAM,MAAM,GAAG,CACpB,MAAmB,EACnB,SAAmC,EAC3B,EAAE;IACV,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,IAAA,aAAI,EAAC,GAAG,EAAE;QACf,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAbW,QAAA,MAAM,UAajB"}
@@ -0,0 +1,12 @@
1
+ import type { EventSource } from './events';
2
+ /**
3
+ * Значение — объект (не `null`): с его полями можно работать как
4
+ * с записью и проверять их по одному
5
+ */
6
+ export declare const isObject: (value: unknown) => value is Record<string, unknown>;
7
+ export declare const isThenable: (value: unknown) => value is PromiseLike<unknown>;
8
+ /**
9
+ * Проверяет оба метода, которые нужны подписке: `on` и `removeListener`.
10
+ * Без второго отписка упала бы с ошибкой
11
+ */
12
+ export declare const isEventSource: (value: unknown) => value is EventSource;
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isEventSource = exports.isThenable = exports.isObject = void 0;
4
+ /**
5
+ * Значение — объект (не `null`): с его полями можно работать как
6
+ * с записью и проверять их по одному
7
+ */
8
+ const isObject = (value) => typeof value === 'object' && value !== null;
9
+ exports.isObject = isObject;
10
+ const isThenable = (value) => typeof value?.then === 'function';
11
+ exports.isThenable = isThenable;
12
+ /**
13
+ * Проверяет оба метода, которые нужны подписке: `on` и `removeListener`.
14
+ * Без второго отписка упала бы с ошибкой
15
+ */
16
+ const isEventSource = (value) => typeof value?.on === 'function' &&
17
+ typeof value.removeListener === 'function';
18
+ exports.isEventSource = isEventSource;
19
+ //# sourceMappingURL=guards.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/metrics/guards.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC3E,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AADjC,QAAA,QAAQ,YACyB;AAEvC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAiC,EAAE,CAC1E,OAAQ,KAA0C,EAAE,IAAI,KAAK,UAAU,CAAC;AAD7D,QAAA,UAAU,cACmD;AAE1E;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE,CACpE,OAAQ,KAAiC,EAAE,EAAE,KAAK,UAAU;IAC5D,OAAQ,KAAqB,CAAC,cAAc,KAAK,UAAU,CAAC;AAFjD,QAAA,aAAa,iBAEoC"}
@@ -0,0 +1 @@
1
+ export { DbMetricsConfig } from './db-metrics.config';
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DbMetricsConfig = void 0;
4
+ /*
5
+ * Публичный API метрик БД для пользователя пакета: только `DbMetricsConfig`.
6
+ * Всё, что нужно ORM-плагинам rsdk, лежит в `plugin-kit.ts` и в корень
7
+ * `@rsdk/db` не попадает. Состав закреплён в `public-api.spec.ts`
8
+ */
9
+ var db_metrics_config_1 = require("./db-metrics.config");
10
+ Object.defineProperty(exports, "DbMetricsConfig", { enumerable: true, get: function () { return db_metrics_config_1.DbMetricsConfig; } });
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,yDAAsD;AAA7C,oHAAA,eAAe,OAAA"}