@rsdk/db 2.5.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 (149) hide show
  1. package/CHANGELOG.md +118 -0
  2. package/README.md +3 -0
  3. package/db/dist/context.base.d.ts +30 -0
  4. package/db/dist/context.base.js +52 -0
  5. package/db/dist/context.base.js.map +1 -0
  6. package/db/dist/context.storage.d.ts +22 -0
  7. package/db/dist/context.storage.js +32 -0
  8. package/db/dist/context.storage.js.map +1 -0
  9. package/db/dist/exceptions.d.ts +10 -0
  10. package/db/dist/exceptions.js +25 -0
  11. package/db/dist/exceptions.js.map +1 -0
  12. package/db/dist/index.d.ts +6 -0
  13. package/db/dist/index.js +16 -0
  14. package/db/dist/index.js.map +1 -0
  15. package/db/dist/propagation.enum.d.ts +30 -0
  16. package/db/dist/propagation.enum.js +35 -0
  17. package/db/dist/propagation.enum.js.map +1 -0
  18. package/db/dist/transactional.runner.d.ts +29 -0
  19. package/db/dist/transactional.runner.js +119 -0
  20. package/db/dist/transactional.runner.js.map +1 -0
  21. package/db/dist/types.d.ts +10 -0
  22. package/db/dist/types.js +3 -0
  23. package/db/dist/types.js.map +1 -0
  24. package/db.knex/dist/index.d.ts +9 -0
  25. package/db.knex/dist/index.js +15 -0
  26. package/db.knex/dist/index.js.map +1 -0
  27. package/db.knex/dist/inject-knex.decorator.d.ts +2 -0
  28. package/db.knex/dist/inject-knex.decorator.js +8 -0
  29. package/db.knex/dist/inject-knex.decorator.js.map +1 -0
  30. package/db.knex/dist/internal/context.d.ts +78 -0
  31. package/db.knex/dist/internal/context.js +233 -0
  32. package/db.knex/dist/internal/context.js.map +1 -0
  33. package/db.knex/dist/internal/exceptions.d.ts +65 -0
  34. package/db.knex/dist/internal/exceptions.js +94 -0
  35. package/db.knex/dist/internal/exceptions.js.map +1 -0
  36. package/db.knex/dist/internal/initializer.d.ts +9 -0
  37. package/db.knex/dist/internal/initializer.js +48 -0
  38. package/db.knex/dist/internal/initializer.js.map +1 -0
  39. package/db.knex/dist/internal/strategy.d.ts +18 -0
  40. package/db.knex/dist/internal/strategy.js +75 -0
  41. package/db.knex/dist/internal/strategy.js.map +1 -0
  42. package/db.knex/dist/internal/test.e2e/strategy.test.d.ts +1 -0
  43. package/db.knex/dist/internal/test.e2e/strategy.test.js +762 -0
  44. package/db.knex/dist/internal/test.e2e/strategy.test.js.map +1 -0
  45. package/db.knex/dist/internal/test.e2e/utils.d.ts +17 -0
  46. package/db.knex/dist/internal/test.e2e/utils.js +21 -0
  47. package/db.knex/dist/internal/test.e2e/utils.js.map +1 -0
  48. package/db.knex/dist/knex.module.d.ts +5 -0
  49. package/db.knex/dist/knex.module.js +34 -0
  50. package/db.knex/dist/knex.module.js.map +1 -0
  51. package/db.knex/dist/knex.plugin.d.ts +10 -0
  52. package/db.knex/dist/knex.plugin.js +20 -0
  53. package/db.knex/dist/knex.plugin.js.map +1 -0
  54. package/db.knex/dist/providers/index.d.ts +4 -0
  55. package/db.knex/dist/providers/index.js +21 -0
  56. package/db.knex/dist/providers/index.js.map +1 -0
  57. package/db.knex/dist/providers/knex-logger.adapter.d.ts +10 -0
  58. package/db.knex/dist/providers/knex-logger.adapter.js +45 -0
  59. package/db.knex/dist/providers/knex-logger.adapter.js.map +1 -0
  60. package/db.knex/dist/providers/knex.config.d.ts +10 -0
  61. package/db.knex/dist/providers/knex.config.js +76 -0
  62. package/db.knex/dist/providers/knex.config.js.map +1 -0
  63. package/db.knex/dist/providers/knex.factory.d.ts +13 -0
  64. package/db.knex/dist/providers/knex.factory.js +96 -0
  65. package/db.knex/dist/providers/knex.factory.js.map +1 -0
  66. package/db.knex/dist/providers/knex.indicator.d.ts +8 -0
  67. package/db.knex/dist/providers/knex.indicator.js +41 -0
  68. package/db.knex/dist/providers/knex.indicator.js.map +1 -0
  69. package/db.knex/dist/types.d.ts +12 -0
  70. package/db.knex/dist/types.js +20 -0
  71. package/db.knex/dist/types.js.map +1 -0
  72. package/db.typeorm/dist/data-source-extractor.d.ts +20 -0
  73. package/db.typeorm/dist/data-source-extractor.js +43 -0
  74. package/db.typeorm/dist/data-source-extractor.js.map +1 -0
  75. package/db.typeorm/dist/index.d.ts +8 -0
  76. package/db.typeorm/dist/index.js +12 -0
  77. package/db.typeorm/dist/index.js.map +1 -0
  78. package/db.typeorm/dist/internal/context.d.ts +46 -0
  79. package/db.typeorm/dist/internal/context.js +123 -0
  80. package/db.typeorm/dist/internal/context.js.map +1 -0
  81. package/db.typeorm/dist/internal/exceptions.d.ts +67 -0
  82. package/db.typeorm/dist/internal/exceptions.js +99 -0
  83. package/db.typeorm/dist/internal/exceptions.js.map +1 -0
  84. package/db.typeorm/dist/internal/initializer.d.ts +15 -0
  85. package/db.typeorm/dist/internal/initializer.js +158 -0
  86. package/db.typeorm/dist/internal/initializer.js.map +1 -0
  87. package/db.typeorm/dist/internal/strategy.d.ts +54 -0
  88. package/db.typeorm/dist/internal/strategy.js +108 -0
  89. package/db.typeorm/dist/internal/strategy.js.map +1 -0
  90. package/db.typeorm/dist/internal/test/strategy.test.e2e.d.ts +5 -0
  91. package/db.typeorm/dist/internal/test/strategy.test.e2e.js +779 -0
  92. package/db.typeorm/dist/internal/test/strategy.test.e2e.js.map +1 -0
  93. package/db.typeorm/dist/internal/test/util.d.ts +22 -0
  94. package/db.typeorm/dist/internal/test/util.js +72 -0
  95. package/db.typeorm/dist/internal/test/util.js.map +1 -0
  96. package/db.typeorm/dist/modules/migration-checker.module.d.ts +9 -0
  97. package/db.typeorm/dist/modules/migration-checker.module.js +42 -0
  98. package/db.typeorm/dist/modules/migration-checker.module.js.map +1 -0
  99. package/db.typeorm/dist/providers/index.d.ts +3 -0
  100. package/db.typeorm/dist/providers/index.js +20 -0
  101. package/db.typeorm/dist/providers/index.js.map +1 -0
  102. package/db.typeorm/dist/providers/typeorm-logger.adapter.d.ts +13 -0
  103. package/db.typeorm/dist/providers/typeorm-logger.adapter.js +61 -0
  104. package/db.typeorm/dist/providers/typeorm-logger.adapter.js.map +1 -0
  105. package/db.typeorm/dist/providers/typeorm.config.d.ts +10 -0
  106. package/db.typeorm/dist/providers/typeorm.config.js +79 -0
  107. package/db.typeorm/dist/providers/typeorm.config.js.map +1 -0
  108. package/db.typeorm/dist/providers/typeorm.healthcheck.d.ts +8 -0
  109. package/db.typeorm/dist/providers/typeorm.healthcheck.js +36 -0
  110. package/db.typeorm/dist/providers/typeorm.healthcheck.js.map +1 -0
  111. package/db.typeorm/dist/typeorm.errors-transformer.d.ts +5 -0
  112. package/db.typeorm/dist/typeorm.errors-transformer.js +32 -0
  113. package/db.typeorm/dist/typeorm.errors-transformer.js.map +1 -0
  114. package/db.typeorm/dist/typeorm.plugin.d.ts +17 -0
  115. package/db.typeorm/dist/typeorm.plugin.js +81 -0
  116. package/db.typeorm/dist/typeorm.plugin.js.map +1 -0
  117. package/db.typeorm/dist/types.d.ts +14 -0
  118. package/db.typeorm/dist/types.js +18 -0
  119. package/db.typeorm/dist/types.js.map +1 -0
  120. package/dist/context.base.d.ts +30 -0
  121. package/dist/context.base.js +52 -0
  122. package/dist/context.base.js.map +1 -0
  123. package/dist/context.storage.d.ts +22 -0
  124. package/dist/context.storage.js +32 -0
  125. package/dist/context.storage.js.map +1 -0
  126. package/dist/exceptions.d.ts +10 -0
  127. package/dist/exceptions.js +25 -0
  128. package/dist/exceptions.js.map +1 -0
  129. package/dist/index.d.ts +6 -0
  130. package/dist/index.js +16 -0
  131. package/dist/index.js.map +1 -0
  132. package/dist/propagation.enum.d.ts +30 -0
  133. package/dist/propagation.enum.js +35 -0
  134. package/dist/propagation.enum.js.map +1 -0
  135. package/dist/transactional.runner.d.ts +29 -0
  136. package/dist/transactional.runner.js +119 -0
  137. package/dist/transactional.runner.js.map +1 -0
  138. package/dist/types.d.ts +10 -0
  139. package/dist/types.js +3 -0
  140. package/dist/types.js.map +1 -0
  141. package/package.json +21 -0
  142. package/src/context.base.ts +61 -0
  143. package/src/context.storage.ts +34 -0
  144. package/src/exceptions.ts +21 -0
  145. package/src/index.ts +10 -0
  146. package/src/propagation.enum.ts +36 -0
  147. package/src/transactional.runner.ts +222 -0
  148. package/src/types.ts +37 -0
  149. package/tsconfig.json +11 -0
@@ -0,0 +1,43 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DataSourceExtractor = void 0;
4
+ const core_1 = require("@nestjs/core");
5
+ const typeorm_core_module_1 = require("@nestjs/typeorm/dist/typeorm-core.module");
6
+ const core_2 = require("@rsdk/core");
7
+ const nest_tools_1 = require("@rsdk/nest-tools");
8
+ const typeorm_1 = require("typeorm");
9
+ /**
10
+ * Нужен прежде всего для использования в связке с typeorm cli и указания результата вывода в файле
11
+ * Структура файлов
12
+ * ```
13
+ * src
14
+ * typeorm
15
+ * data-source.ts
16
+ * ```
17
+ *
18
+ * ```ts
19
+ * // src/typeorm/data-source.ts
20
+ * import { app } from '../app'
21
+ * export default DataSourceExtractor.extract(app)
22
+ * ```
23
+ */
24
+ class DataSourceExtractor {
25
+ static async extract(app) {
26
+ const root = await app.context.getRoot();
27
+ const iterator = new nest_tools_1.NestDefinitionIterator(root);
28
+ const nestModule = await iterator.find((definition) => definition === typeorm_core_module_1.TypeOrmCoreModule ||
29
+ ('module' in definition && definition.module === typeorm_core_module_1.TypeOrmCoreModule), nest_tools_1.NestDefinitionType.Module);
30
+ if (!nestModule) {
31
+ throw new core_2.InternalException('Datasource not found');
32
+ }
33
+ const applicationContext = await core_1.NestFactory.createApplicationContext(new core_2.PlatformContext({
34
+ modules: [nestModule],
35
+ }).getRoot());
36
+ const dataSource = applicationContext.get(typeorm_1.DataSource);
37
+ // typeorm cli always call `initialize()`, dont check isInitialized
38
+ dataSource.isInitialized && (await dataSource.destroy());
39
+ return dataSource;
40
+ }
41
+ }
42
+ exports.DataSourceExtractor = DataSourceExtractor;
43
+ //# sourceMappingURL=data-source-extractor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-source-extractor.js","sourceRoot":"","sources":["../src/data-source-extractor.ts"],"names":[],"mappings":";;;AAAA,uCAA2C;AAC3C,kFAA6E;AAG7E,qCAAgE;AAChE,iDAA8E;AAC9E,qCAAqC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAa,mBAAmB;IAC9B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAgB;QACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,mCAAsB,CAAC,IAAI,CAAC,CAAC;QAElD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,CACpC,CAAC,UAAU,EAAE,EAAE,CACb,UAAU,KAAK,uCAAiB;YAChC,CAAC,QAAQ,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,uCAAiB,CAAC,EACrE,+BAAkB,CAAC,MAAM,CAC1B,CAAC;QACF,IAAI,CAAC,UAAU,EAAE;YACf,MAAM,IAAI,wBAAiB,CAAC,sBAAsB,CAAC,CAAC;SACrD;QACD,MAAM,kBAAkB,GAAG,MAAM,kBAAW,CAAC,wBAAwB,CACnE,IAAI,sBAAe,CAAC;YAClB,OAAO,EAAE,CAAC,UAAU,CAAC;SACtB,CAAC,CAAC,OAAO,EAAE,CACb,CAAC;QAEF,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,oBAAU,CAAC,CAAC;QAEtD,mEAAmE;QACnE,UAAU,CAAC,aAAa,IAAI,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AA1BD,kDA0BC"}
@@ -0,0 +1,8 @@
1
+ import { TransactionRunner } from '@rsdk/db';
2
+ export { TypeOrmPlugin } from './typeorm.plugin';
3
+ export { IsolationLevel } from './types';
4
+ export declare const Runner: TransactionRunner<import("./types").IsolationLevel, import("./internal/context").TypeOrmContext>;
5
+ export declare const Transactional: (payload?: {
6
+ isolation?: import("./types").IsolationLevel;
7
+ propagation?: import("@rsdk/db").Propagation;
8
+ } | undefined) => MethodDecorator;
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Transactional = exports.Runner = exports.IsolationLevel = exports.TypeOrmPlugin = void 0;
4
+ const db_1 = require("@rsdk/db");
5
+ const strategy_1 = require("./internal/strategy");
6
+ var typeorm_plugin_1 = require("./typeorm.plugin");
7
+ Object.defineProperty(exports, "TypeOrmPlugin", { enumerable: true, get: function () { return typeorm_plugin_1.TypeOrmPlugin; } });
8
+ var types_1 = require("./types");
9
+ Object.defineProperty(exports, "IsolationLevel", { enumerable: true, get: function () { return types_1.IsolationLevel; } });
10
+ exports.Runner = new db_1.TransactionRunner(new strategy_1.TypeormTransactionalStrategy());
11
+ exports.Transactional = exports.Runner.Transactional.bind(exports.Runner);
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6C;AAE7C,kDAAmE;AAEnE,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA;AAEV,QAAA,MAAM,GAAG,IAAI,sBAAiB,CAAC,IAAI,uCAA4B,EAAE,CAAC,CAAC;AACnE,QAAA,aAAa,GAAG,cAAM,CAAC,aAAa,CAAC,IAAI,CAAC,cAAM,CAAC,CAAC"}
@@ -0,0 +1,46 @@
1
+ import { BaseContext } from '@rsdk/db';
2
+ import type { QueryRunner } from 'typeorm';
3
+ import type { IsolationLevel } from '../types';
4
+ export declare class TypeOrmContext extends BaseContext<IsolationLevel> {
5
+ readonly isolationLevels: readonly IsolationLevel[];
6
+ /**
7
+ * TypeOrm queryRunner который будет использоваться для выполнения запросов и инициализации транзакции
8
+ * @private
9
+ */
10
+ private _queryRunner?;
11
+ /**
12
+ * Текущая глубина на которую должна быть проинициализирована транзакция
13
+ * @private
14
+ */
15
+ private transactionInitializedDepth;
16
+ /**
17
+ * Глубина вложенности
18
+ * Не путать с индексом вложенности
19
+ * По сути является необходимым количеством проинициализированных слоев
20
+ * @private
21
+ */
22
+ private nestDepth;
23
+ /**
24
+ * Завершена ли работа с этим контекстом
25
+ * Необходимо для контроля за тем чтобы не было переиспользований этого контекста
26
+ * @private
27
+ */
28
+ private _isReleased;
29
+ private constructor();
30
+ private constructor();
31
+ get isReleased(): boolean;
32
+ get queryRunner(): QueryRunner | undefined;
33
+ static create(isolationLevel: IsolationLevel): TypeOrmContext;
34
+ static createSuspended(): TypeOrmContext;
35
+ /**
36
+ * Устанавливаем queryRunner который будет использоваться для инициализации транзакции
37
+ * @param queryRunner
38
+ */
39
+ attach(queryRunner: QueryRunner): void;
40
+ initialize(): Promise<void>;
41
+ isInitialized(): boolean;
42
+ addNestLayer(): void;
43
+ rollbackTransaction(): Promise<void>;
44
+ commitTransaction(): Promise<void>;
45
+ finalize(mustRelease: boolean): Promise<void>;
46
+ }
@@ -0,0 +1,123 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.TypeOrmContext = void 0;
4
+ const db_1 = require("@rsdk/db");
5
+ const types_1 = require("../types");
6
+ const exceptions_1 = require("./exceptions");
7
+ class TypeOrmContext extends db_1.BaseContext {
8
+ isolationLevels = types_1.isolationLevels;
9
+ /**
10
+ * TypeOrm queryRunner который будет использоваться для выполнения запросов и инициализации транзакции
11
+ * @private
12
+ */
13
+ _queryRunner;
14
+ /**
15
+ * Текущая глубина на которую должна быть проинициализирована транзакция
16
+ * @private
17
+ */
18
+ transactionInitializedDepth = 0;
19
+ /**
20
+ * Глубина вложенности
21
+ * Не путать с индексом вложенности
22
+ * По сути является необходимым количеством проинициализированных слоев
23
+ * @private
24
+ */
25
+ nestDepth = 1;
26
+ /**
27
+ * Завершена ли работа с этим контекстом
28
+ * Необходимо для контроля за тем чтобы не было переиспользований этого контекста
29
+ * @private
30
+ */
31
+ _isReleased = false;
32
+ constructor(arg) {
33
+ super(arg ?? types_1.DEFAULT_ISOLATION_LEVEL);
34
+ }
35
+ get isReleased() {
36
+ return this._isReleased;
37
+ }
38
+ get queryRunner() {
39
+ return this._queryRunner;
40
+ }
41
+ static create(isolationLevel) {
42
+ return new TypeOrmContext(isolationLevel);
43
+ }
44
+ static createSuspended() {
45
+ return new TypeOrmContext(true);
46
+ }
47
+ /**
48
+ * Устанавливаем queryRunner который будет использоваться для инициализации транзакции
49
+ * @param queryRunner
50
+ */
51
+ attach(queryRunner) {
52
+ if (this._queryRunner) {
53
+ throw new exceptions_1.AlreadyAttached();
54
+ }
55
+ if (queryRunner.isTransactionActive) {
56
+ throw new exceptions_1.QueryRunnerIsTransactionActive();
57
+ }
58
+ if (queryRunner.isReleased) {
59
+ throw new exceptions_1.QueryRunnerIsReleased();
60
+ }
61
+ this._queryRunner = queryRunner;
62
+ }
63
+ async initialize() {
64
+ if (this.suspended) {
65
+ return;
66
+ }
67
+ if (!this._queryRunner) {
68
+ throw new exceptions_1.QueryRunnerMustBeAttached();
69
+ }
70
+ /**
71
+ * Инициализируем нужное количество `savepoint`
72
+ */
73
+ for (this.transactionInitializedDepth; this.transactionInitializedDepth < this.nestDepth; this.transactionInitializedDepth++) {
74
+ await this._queryRunner.startTransaction();
75
+ }
76
+ }
77
+ isInitialized() {
78
+ return this.nestDepth === this.transactionInitializedDepth;
79
+ }
80
+ addNestLayer() {
81
+ if (this.suspended) {
82
+ throw new Error('unsupported nesting muted ');
83
+ }
84
+ this.nestDepth += 1;
85
+ }
86
+ async rollbackTransaction() {
87
+ if (!this._queryRunner) {
88
+ return;
89
+ }
90
+ if (this.isInitialized()) {
91
+ await this._queryRunner.rollbackTransaction();
92
+ }
93
+ }
94
+ async commitTransaction() {
95
+ if (!this._queryRunner) {
96
+ return;
97
+ }
98
+ if (this.isInitialized()) {
99
+ await this._queryRunner.commitTransaction();
100
+ }
101
+ }
102
+ async finalize(mustRelease) {
103
+ this.nestDepth -= 1;
104
+ this.transactionInitializedDepth = this.nestDepth;
105
+ const isReleased = this.nestDepth === 0;
106
+ /**
107
+ * В обоих случаях в идеале завершать работу приложения так как часть операция может быть не выполнена, хотя должна была и наоборот
108
+ * И в качестве бонуса получим висящее соединение к СУБД которое нельзя использовать
109
+ */
110
+ if (!isReleased && mustRelease) {
111
+ throw new exceptions_1.MustReleased();
112
+ }
113
+ if (isReleased && !mustRelease) {
114
+ throw new exceptions_1.UnexpectedRelease();
115
+ }
116
+ if (isReleased) {
117
+ this._isReleased = true;
118
+ await this._queryRunner?.release();
119
+ }
120
+ }
121
+ }
122
+ exports.TypeOrmContext = TypeOrmContext;
123
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ import { InternalException } from '@rsdk/core';
2
+ export declare class TypeormdbException extends InternalException {
3
+ }
4
+ export declare class ProxiedMethodIsNotFunction extends TypeormdbException {
5
+ constructor();
6
+ }
7
+ export declare class AlreadyAttached extends TypeormdbException {
8
+ constructor();
9
+ }
10
+ export declare class QueryRunnerMustBeAttached extends TypeormdbException {
11
+ constructor();
12
+ }
13
+ export declare class ContextMustBeProvided extends TypeormdbException {
14
+ constructor();
15
+ }
16
+ /**
17
+ * Неожиданный релиз (закрытие/возвращение в пул) соединения
18
+ */
19
+ export declare class UnexpectedRelease extends TypeormdbException {
20
+ constructor();
21
+ }
22
+ /**
23
+ * Ожидалось завершение работы с транзакцией, но не удовлетворены условия завершения (например транзакция не может быть закрыта из-за наличия незакрытых `savepoint`)
24
+ */
25
+ export declare class MustReleased extends TypeormdbException {
26
+ constructor();
27
+ }
28
+ /**
29
+ * Попытка использовать контекст когда работа с ним была завершена
30
+ * Например если не дождались завершения промиса использующего соединение
31
+ * @example
32
+ * runInContext(()=> {
33
+ * Promise.resolve().then(() => manager.query('SELECT 1'))
34
+ * })
35
+ *
36
+ * @example
37
+ * class UserController {
38
+ * constructor(
39
+ * private registerAttemptService: { registerAttemptToDb(): Promise<void> },
40
+ * private userService: { fetchUser(userId: UserId): Promise<User | null> }
41
+ * ) {}
42
+ *
43
+ * // @Get('/user')
44
+ * // @Transactional()
45
+ * async sum(@Query() query: { userId: UserId }): Promise<void> {
46
+ * this.registerAttemptService.registerAttemptToDb();
47
+ * return this.userService.fetchUser(query.userId);
48
+ * }
49
+ * }
50
+ */
51
+ export declare class ContextIsReleased extends InternalException {
52
+ constructor();
53
+ }
54
+ /**
55
+ * QueryRunner переданный для аттача уже в состоянии isReleased
56
+ * Такой queryRunner не может быть использован для работы контекста
57
+ */
58
+ export declare class QueryRunnerIsReleased extends InternalException {
59
+ constructor();
60
+ }
61
+ /**
62
+ * QueryRunner переданный для аттача уже внутри транзакции
63
+ * Такой queryRunner не может быть использован для работы контекста
64
+ */
65
+ export declare class QueryRunnerIsTransactionActive extends InternalException {
66
+ constructor();
67
+ }
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.QueryRunnerIsTransactionActive = exports.QueryRunnerIsReleased = exports.ContextIsReleased = exports.MustReleased = exports.UnexpectedRelease = exports.ContextMustBeProvided = exports.QueryRunnerMustBeAttached = exports.AlreadyAttached = exports.ProxiedMethodIsNotFunction = exports.TypeormdbException = void 0;
4
+ const core_1 = require("@rsdk/core");
5
+ class TypeormdbException extends core_1.InternalException {
6
+ }
7
+ exports.TypeormdbException = TypeormdbException;
8
+ class ProxiedMethodIsNotFunction extends TypeormdbException {
9
+ constructor() {
10
+ super('Proxied method non function value');
11
+ }
12
+ }
13
+ exports.ProxiedMethodIsNotFunction = ProxiedMethodIsNotFunction;
14
+ class AlreadyAttached extends TypeormdbException {
15
+ constructor() {
16
+ super('Already attached');
17
+ }
18
+ }
19
+ exports.AlreadyAttached = AlreadyAttached;
20
+ class QueryRunnerMustBeAttached extends TypeormdbException {
21
+ constructor() {
22
+ super('QueryRunner must be attached');
23
+ }
24
+ }
25
+ exports.QueryRunnerMustBeAttached = QueryRunnerMustBeAttached;
26
+ class ContextMustBeProvided extends TypeormdbException {
27
+ constructor() {
28
+ super('Incorrect call, context must be provided');
29
+ }
30
+ }
31
+ exports.ContextMustBeProvided = ContextMustBeProvided;
32
+ /**
33
+ * Неожиданный релиз (закрытие/возвращение в пул) соединения
34
+ */
35
+ class UnexpectedRelease extends TypeormdbException {
36
+ constructor() {
37
+ super('Unexpected release connection');
38
+ }
39
+ }
40
+ exports.UnexpectedRelease = UnexpectedRelease;
41
+ /**
42
+ * Ожидалось завершение работы с транзакцией, но не удовлетворены условия завершения (например транзакция не может быть закрыта из-за наличия незакрытых `savepoint`)
43
+ */
44
+ class MustReleased extends TypeormdbException {
45
+ constructor() {
46
+ super('Must released but conditions not satisfied');
47
+ }
48
+ }
49
+ exports.MustReleased = MustReleased;
50
+ /**
51
+ * Попытка использовать контекст когда работа с ним была завершена
52
+ * Например если не дождались завершения промиса использующего соединение
53
+ * @example
54
+ * runInContext(()=> {
55
+ * Promise.resolve().then(() => manager.query('SELECT 1'))
56
+ * })
57
+ *
58
+ * @example
59
+ * class UserController {
60
+ * constructor(
61
+ * private registerAttemptService: { registerAttemptToDb(): Promise<void> },
62
+ * private userService: { fetchUser(userId: UserId): Promise<User | null> }
63
+ * ) {}
64
+ *
65
+ * // @Get('/user')
66
+ * // @Transactional()
67
+ * async sum(@Query() query: { userId: UserId }): Promise<void> {
68
+ * this.registerAttemptService.registerAttemptToDb();
69
+ * return this.userService.fetchUser(query.userId);
70
+ * }
71
+ * }
72
+ */
73
+ class ContextIsReleased extends core_1.InternalException {
74
+ constructor() {
75
+ super("Trying to use a context when it's already released (the function started in the context has been ended)");
76
+ }
77
+ }
78
+ exports.ContextIsReleased = ContextIsReleased;
79
+ /**
80
+ * QueryRunner переданный для аттача уже в состоянии isReleased
81
+ * Такой queryRunner не может быть использован для работы контекста
82
+ */
83
+ class QueryRunnerIsReleased extends core_1.InternalException {
84
+ constructor() {
85
+ super('queryRunner.isReleased must be false for attach');
86
+ }
87
+ }
88
+ exports.QueryRunnerIsReleased = QueryRunnerIsReleased;
89
+ /**
90
+ * QueryRunner переданный для аттача уже внутри транзакции
91
+ * Такой queryRunner не может быть использован для работы контекста
92
+ */
93
+ class QueryRunnerIsTransactionActive extends core_1.InternalException {
94
+ constructor() {
95
+ super('queryRunner.isTransactionActive must be false for attach');
96
+ }
97
+ }
98
+ exports.QueryRunnerIsTransactionActive = QueryRunnerIsTransactionActive;
99
+ //# sourceMappingURL=exceptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/internal/exceptions.ts"],"names":[],"mappings":";;;AAAA,qCAA+C;AAE/C,MAAa,kBAAmB,SAAQ,wBAAiB;CAAG;AAA5D,gDAA4D;AAE5D,MAAa,0BAA2B,SAAQ,kBAAkB;IAChE;QACE,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,gEAIC;AAED,MAAa,eAAgB,SAAQ,kBAAkB;IACrD;QACE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;CACF;AAJD,0CAIC;AAED,MAAa,yBAA0B,SAAQ,kBAAkB;IAC/D;QACE,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACxC,CAAC;CACF;AAJD,8DAIC;AAED,MAAa,qBAAsB,SAAQ,kBAAkB;IAC3D;QACE,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACpD,CAAC;CACF;AAJD,sDAIC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,kBAAkB;IACvD;QACE,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACzC,CAAC;CACF;AAJD,8CAIC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,kBAAkB;IAClD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF;AAJD,oCAIC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,iBAAkB,SAAQ,wBAAiB;IACtD;QACE,KAAK,CACH,yGAAyG,CAC1G,CAAC;IACJ,CAAC;CACF;AAND,8CAMC;AAED;;;GAGG;AACH,MAAa,qBAAsB,SAAQ,wBAAiB;IAC1D;QACE,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC3D,CAAC;CACF;AAJD,sDAIC;AAED;;;GAGG;AACH,MAAa,8BAA+B,SAAQ,wBAAiB;IACnE;QACE,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACpE,CAAC;CACF;AAJD,wEAIC"}
@@ -0,0 +1,15 @@
1
+ import { ContextStorage } from '@rsdk/db';
2
+ import type { TypeOrmContext } from './context';
3
+ export declare class Initializer {
4
+ static readonly storage: ContextStorage<TypeOrmContext>;
5
+ /**
6
+ * Патчинг всех необходимых методов из typeorm
7
+ */
8
+ static initialize(): void;
9
+ private static wrappedCreateQueryRunner;
10
+ private static getValidQueryRunner;
11
+ private static getWrappedRelease;
12
+ private static getProxiesMethod;
13
+ private static warnOnBusyQueryRunner;
14
+ private static getWarnMessage;
15
+ }
@@ -0,0 +1,158 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Initializer = void 0;
4
+ const db_1 = require("@rsdk/db");
5
+ const typeorm_1 = require("typeorm");
6
+ const exceptions_1 = require("./exceptions");
7
+ const originalCreateQueryRunner = typeorm_1.DataSource.prototype.createQueryRunner;
8
+ class Initializer {
9
+ static storage = new db_1.ContextStorage();
10
+ /**
11
+ * Патчинг всех необходимых методов из typeorm
12
+ */
13
+ static initialize() {
14
+ Object.defineProperty(typeorm_1.DataSource.prototype, 'createQueryRunner', {
15
+ value: Initializer.wrappedCreateQueryRunner,
16
+ });
17
+ }
18
+ static wrappedCreateQueryRunner(...args) {
19
+ const originalQueryRunner = originalCreateQueryRunner.call(this, ...args);
20
+ // eslint-disable-next-line @typescript-eslint/no-this-alias
21
+ const dataSource = this;
22
+ const proxiesQueryRunner = new Proxy(originalQueryRunner, {
23
+ get(target, propertyKey) {
24
+ const originalQueryRunnerProp = target[propertyKey];
25
+ /**
26
+ * Мы сами контролируем то когда будет освобожден queryRunner
27
+ * Даже сейчас есть проблема с тем что в пул может попасть соединение в котором не была завершена транзакция
28
+ */
29
+ if (propertyKey === 'release') {
30
+ return Initializer.getWrappedRelease(target);
31
+ }
32
+ /**
33
+ * ATTENTION: Очень важна последовательность, потому что ряд драйверов (postgres например) делает так
34
+ * @see https://github.com/typeorm/typeorm/blob/f5b93c14b5efa1a55aed0211a4757af1b3d6e66b/src/driver/postgres/PostgresQueryRunner.ts#L148
35
+ * Ничего сверх критичного не происходит, или по крайней мере я не нашёл этого
36
+ * Единственное, уходит в бесконечную проверку коннекты к бд не висят, но `DataSource.destroy` уходит в бесконечный цикл
37
+ * @see https://github.com/typeorm/typeorm/blob/f5b93c14b5efa1a55aed0211a4757af1b3d6e66b/src/driver/postgres/PostgresDriver.ts#L1532
38
+ */
39
+ /**
40
+ * Защита от дурака
41
+ */
42
+ /**
43
+ * class A {
44
+ * queryRunner: QueryRunner
45
+ *
46
+ * constructor(private dataSource: DataSource) {
47
+ * this.queryRunner = this.dataSource.createQueryRunner()
48
+ * }
49
+ *
50
+ * @Transactional()
51
+ * transactionDo() {
52
+ * // wtf -_-
53
+ * this.queryRunner.query('drop database')
54
+ * }
55
+ * }
56
+ */
57
+ if (typeof originalQueryRunnerProp === 'function') {
58
+ return Initializer.getProxiesMethod(dataSource, originalQueryRunnerProp, target);
59
+ }
60
+ const context = Initializer.storage.getContext();
61
+ if (!context) {
62
+ return originalQueryRunnerProp;
63
+ }
64
+ if (context.isReleased) {
65
+ throw new exceptions_1.ContextIsReleased();
66
+ }
67
+ /**
68
+ * Если кто-то обратился к любому queryRunner во время исполнения функции контекста, а в контексте ещё нет queryRunner
69
+ * Этот queryRunner добавляем в контекст
70
+ */
71
+ if (!context.queryRunner &&
72
+ /**
73
+ * Дополнительно проверяем не является ли этот queryRunner релизнутым/с активной транзакцией
74
+ */
75
+ target.isTransactionActive &&
76
+ !target.isReleased) {
77
+ context.attach(originalQueryRunner);
78
+ }
79
+ if (propertyKey === 'manager') {
80
+ /**
81
+ * Из-за того что у manager должен быть линк на queryRunner
82
+ */
83
+ return dataSource.createEntityManager(proxiesQueryRunner);
84
+ }
85
+ return originalQueryRunnerProp;
86
+ },
87
+ });
88
+ return proxiesQueryRunner;
89
+ }
90
+ static getValidQueryRunner(dataSource, originalQueryRunner) {
91
+ /**
92
+ * Теоретически может быть ситуация в которой оригинальный
93
+ * queryRunner уже кто-то использует в транзакции или его уже релизнули
94
+ */
95
+ if (originalQueryRunner.isTransactionActive ||
96
+ originalQueryRunner.isReleased) {
97
+ /**
98
+ * Так как это нежелательное поведение показываем варнинг
99
+ */
100
+ Initializer.warnOnBusyQueryRunner(originalQueryRunner);
101
+ return originalCreateQueryRunner.call(dataSource, originalQueryRunner.getReplicationMode());
102
+ }
103
+ return originalQueryRunner;
104
+ }
105
+ static getWrappedRelease(originalQueryRunner) {
106
+ return async function () {
107
+ const ctx = Initializer.storage.getContext();
108
+ const contextQueryRunner = ctx?.queryRunner;
109
+ if (ctx && contextQueryRunner === originalQueryRunner) {
110
+ return;
111
+ }
112
+ return originalQueryRunner.release.call(originalQueryRunner);
113
+ };
114
+ }
115
+ static getProxiesMethod(dataSource, originalQueryRunnerProp, originalQueryRunner) {
116
+ // Чтобы ts не нервничал
117
+ if (typeof originalQueryRunnerProp !== 'function') {
118
+ throw new exceptions_1.ProxiedMethodIsNotFunction();
119
+ }
120
+ const originalQueryRunnerFunc = originalQueryRunnerProp;
121
+ return async function (...args) {
122
+ const context = Initializer.storage.getContext();
123
+ if (!context) {
124
+ /**
125
+ * Если мы не в контексте просто даём делать свою работу
126
+ */
127
+ return originalQueryRunnerFunc.call(originalQueryRunner, ...args);
128
+ }
129
+ /**
130
+ * Если у нас уже есть проинициализированный queryRunner делегируем работу ему
131
+ */
132
+ if (context.isInitialized()) {
133
+ return originalQueryRunnerFunc.call(context.queryRunner, ...args);
134
+ }
135
+ /**
136
+ * Если в контексте нет queryRunner его надо установить перед тем как инициализировать транзакцию
137
+ */
138
+ if (!context.queryRunner) {
139
+ const resultedQueryRunner = Initializer.getValidQueryRunner(dataSource, originalQueryRunner);
140
+ context.attach(resultedQueryRunner);
141
+ }
142
+ await context.initialize();
143
+ return await originalQueryRunnerFunc.call(context.queryRunner, ...args);
144
+ };
145
+ }
146
+ static warnOnBusyQueryRunner(potentialQueryRunner) {
147
+ const warnMessage = Initializer.getWarnMessage(potentialQueryRunner);
148
+ console.warn(warnMessage);
149
+ }
150
+ static getWarnMessage(potentialQueryRunner) {
151
+ return `[Initializer -> getProxiesMethod] originalQueryRunner already - ${[
152
+ potentialQueryRunner.isTransactionActive && 'used in transaction',
153
+ potentialQueryRunner.isReleased && 'released',
154
+ ].join(' and ')}`;
155
+ }
156
+ }
157
+ exports.Initializer = Initializer;
158
+ //# sourceMappingURL=initializer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/internal/initializer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,54 @@
1
+ import type { CallBack, TransactionalStrategy } from '@rsdk/db';
2
+ import type { IsolationLevel } from '../types';
3
+ import { TypeOrmContext } from './context';
4
+ export declare class TypeormTransactionalStrategy implements TransactionalStrategy<IsolationLevel, TypeOrmContext> {
5
+ /**
6
+ * Возвращает текущий контекст если вызвано внутри него
7
+ */
8
+ getContext(): TypeOrmContext | undefined;
9
+ /**
10
+ * Возвращает обернутую в контекст функцию
11
+ * @param fn
12
+ * @param options
13
+ */
14
+ bindContext<TResult, TArgs extends any[]>(fn: CallBack<TArgs, TResult>, options?: IsolationLevel): CallBack<TArgs, Promise<TResult>>;
15
+ /**
16
+ * Находимся ли мы в контексте и не является ли он suspend
17
+ */
18
+ isRunning(): boolean;
19
+ /**
20
+ * Вызывает функцию, обернутую внутри контекста с заданными параметрами и корректной обработкой транзакции
21
+ * @param isolation
22
+ * @param fn
23
+ * @param args
24
+ */
25
+ runInContext<TResult, TArgs extends any[]>(isolation: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
26
+ /**
27
+ * Вызывает функцию в новом контексте, игнорируя внешний если он существует
28
+ * @param isolationLevel
29
+ * @param fn
30
+ * @param args
31
+ */
32
+ runFromNewContext<TResult, TArgs extends any[]>(isolationLevel: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
33
+ /**
34
+ * Создаёт новый контекст внутри которого не будет создаваться/использоваться транзакция и игнорироваться внешняя
35
+ * @param fn
36
+ * @param args
37
+ */
38
+ runOutTransactionalContext<TResult, TArgs extends any[]>(fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
39
+ /**
40
+ * Вызывает функцию во вложенном уровне контекста
41
+ * @param context
42
+ * @param isolationLevel
43
+ * @param fn
44
+ * @param args
45
+ */
46
+ nestedExecute<TResult, TArgs extends any[]>(context: TypeOrmContext, isolationLevel: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
47
+ /**
48
+ * Оборачивает функцию для корректного завершения транзакции, если она была проинициализирована внутри функции
49
+ * Важно - не оборачивает в вызов с контекстом
50
+ * @param mustReleased
51
+ * @param fn
52
+ */
53
+ private wrapInTransactionContext;
54
+ }