@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.
- package/CHANGELOG.md +118 -0
- package/README.md +3 -0
- package/db/dist/context.base.d.ts +30 -0
- package/db/dist/context.base.js +52 -0
- package/db/dist/context.base.js.map +1 -0
- package/db/dist/context.storage.d.ts +22 -0
- package/db/dist/context.storage.js +32 -0
- package/db/dist/context.storage.js.map +1 -0
- package/db/dist/exceptions.d.ts +10 -0
- package/db/dist/exceptions.js +25 -0
- package/db/dist/exceptions.js.map +1 -0
- package/db/dist/index.d.ts +6 -0
- package/db/dist/index.js +16 -0
- package/db/dist/index.js.map +1 -0
- package/db/dist/propagation.enum.d.ts +30 -0
- package/db/dist/propagation.enum.js +35 -0
- package/db/dist/propagation.enum.js.map +1 -0
- package/db/dist/transactional.runner.d.ts +29 -0
- package/db/dist/transactional.runner.js +119 -0
- package/db/dist/transactional.runner.js.map +1 -0
- package/db/dist/types.d.ts +10 -0
- package/db/dist/types.js +3 -0
- package/db/dist/types.js.map +1 -0
- package/db.knex/dist/index.d.ts +9 -0
- package/db.knex/dist/index.js +15 -0
- package/db.knex/dist/index.js.map +1 -0
- package/db.knex/dist/inject-knex.decorator.d.ts +2 -0
- package/db.knex/dist/inject-knex.decorator.js +8 -0
- package/db.knex/dist/inject-knex.decorator.js.map +1 -0
- package/db.knex/dist/internal/context.d.ts +78 -0
- package/db.knex/dist/internal/context.js +233 -0
- package/db.knex/dist/internal/context.js.map +1 -0
- package/db.knex/dist/internal/exceptions.d.ts +65 -0
- package/db.knex/dist/internal/exceptions.js +94 -0
- package/db.knex/dist/internal/exceptions.js.map +1 -0
- package/db.knex/dist/internal/initializer.d.ts +9 -0
- package/db.knex/dist/internal/initializer.js +48 -0
- package/db.knex/dist/internal/initializer.js.map +1 -0
- package/db.knex/dist/internal/strategy.d.ts +18 -0
- package/db.knex/dist/internal/strategy.js +75 -0
- package/db.knex/dist/internal/strategy.js.map +1 -0
- package/db.knex/dist/internal/test.e2e/strategy.test.d.ts +1 -0
- package/db.knex/dist/internal/test.e2e/strategy.test.js +762 -0
- package/db.knex/dist/internal/test.e2e/strategy.test.js.map +1 -0
- package/db.knex/dist/internal/test.e2e/utils.d.ts +17 -0
- package/db.knex/dist/internal/test.e2e/utils.js +21 -0
- package/db.knex/dist/internal/test.e2e/utils.js.map +1 -0
- package/db.knex/dist/knex.module.d.ts +5 -0
- package/db.knex/dist/knex.module.js +34 -0
- package/db.knex/dist/knex.module.js.map +1 -0
- package/db.knex/dist/knex.plugin.d.ts +10 -0
- package/db.knex/dist/knex.plugin.js +20 -0
- package/db.knex/dist/knex.plugin.js.map +1 -0
- package/db.knex/dist/providers/index.d.ts +4 -0
- package/db.knex/dist/providers/index.js +21 -0
- package/db.knex/dist/providers/index.js.map +1 -0
- package/db.knex/dist/providers/knex-logger.adapter.d.ts +10 -0
- package/db.knex/dist/providers/knex-logger.adapter.js +45 -0
- package/db.knex/dist/providers/knex-logger.adapter.js.map +1 -0
- package/db.knex/dist/providers/knex.config.d.ts +10 -0
- package/db.knex/dist/providers/knex.config.js +76 -0
- package/db.knex/dist/providers/knex.config.js.map +1 -0
- package/db.knex/dist/providers/knex.factory.d.ts +13 -0
- package/db.knex/dist/providers/knex.factory.js +96 -0
- package/db.knex/dist/providers/knex.factory.js.map +1 -0
- package/db.knex/dist/providers/knex.indicator.d.ts +8 -0
- package/db.knex/dist/providers/knex.indicator.js +41 -0
- package/db.knex/dist/providers/knex.indicator.js.map +1 -0
- package/db.knex/dist/types.d.ts +12 -0
- package/db.knex/dist/types.js +20 -0
- package/db.knex/dist/types.js.map +1 -0
- package/db.typeorm/dist/data-source-extractor.d.ts +20 -0
- package/db.typeorm/dist/data-source-extractor.js +43 -0
- package/db.typeorm/dist/data-source-extractor.js.map +1 -0
- package/db.typeorm/dist/index.d.ts +8 -0
- package/db.typeorm/dist/index.js +12 -0
- package/db.typeorm/dist/index.js.map +1 -0
- package/db.typeorm/dist/internal/context.d.ts +46 -0
- package/db.typeorm/dist/internal/context.js +123 -0
- package/db.typeorm/dist/internal/context.js.map +1 -0
- package/db.typeorm/dist/internal/exceptions.d.ts +67 -0
- package/db.typeorm/dist/internal/exceptions.js +99 -0
- package/db.typeorm/dist/internal/exceptions.js.map +1 -0
- package/db.typeorm/dist/internal/initializer.d.ts +15 -0
- package/db.typeorm/dist/internal/initializer.js +158 -0
- package/db.typeorm/dist/internal/initializer.js.map +1 -0
- package/db.typeorm/dist/internal/strategy.d.ts +54 -0
- package/db.typeorm/dist/internal/strategy.js +108 -0
- package/db.typeorm/dist/internal/strategy.js.map +1 -0
- package/db.typeorm/dist/internal/test/strategy.test.e2e.d.ts +5 -0
- package/db.typeorm/dist/internal/test/strategy.test.e2e.js +779 -0
- package/db.typeorm/dist/internal/test/strategy.test.e2e.js.map +1 -0
- package/db.typeorm/dist/internal/test/util.d.ts +22 -0
- package/db.typeorm/dist/internal/test/util.js +72 -0
- package/db.typeorm/dist/internal/test/util.js.map +1 -0
- package/db.typeorm/dist/modules/migration-checker.module.d.ts +9 -0
- package/db.typeorm/dist/modules/migration-checker.module.js +42 -0
- package/db.typeorm/dist/modules/migration-checker.module.js.map +1 -0
- package/db.typeorm/dist/providers/index.d.ts +3 -0
- package/db.typeorm/dist/providers/index.js +20 -0
- package/db.typeorm/dist/providers/index.js.map +1 -0
- package/db.typeorm/dist/providers/typeorm-logger.adapter.d.ts +13 -0
- package/db.typeorm/dist/providers/typeorm-logger.adapter.js +61 -0
- package/db.typeorm/dist/providers/typeorm-logger.adapter.js.map +1 -0
- package/db.typeorm/dist/providers/typeorm.config.d.ts +10 -0
- package/db.typeorm/dist/providers/typeorm.config.js +79 -0
- package/db.typeorm/dist/providers/typeorm.config.js.map +1 -0
- package/db.typeorm/dist/providers/typeorm.healthcheck.d.ts +8 -0
- package/db.typeorm/dist/providers/typeorm.healthcheck.js +36 -0
- package/db.typeorm/dist/providers/typeorm.healthcheck.js.map +1 -0
- package/db.typeorm/dist/typeorm.errors-transformer.d.ts +5 -0
- package/db.typeorm/dist/typeorm.errors-transformer.js +32 -0
- package/db.typeorm/dist/typeorm.errors-transformer.js.map +1 -0
- package/db.typeorm/dist/typeorm.plugin.d.ts +17 -0
- package/db.typeorm/dist/typeorm.plugin.js +81 -0
- package/db.typeorm/dist/typeorm.plugin.js.map +1 -0
- package/db.typeorm/dist/types.d.ts +14 -0
- package/db.typeorm/dist/types.js +18 -0
- package/db.typeorm/dist/types.js.map +1 -0
- package/dist/context.base.d.ts +30 -0
- package/dist/context.base.js +52 -0
- package/dist/context.base.js.map +1 -0
- package/dist/context.storage.d.ts +22 -0
- package/dist/context.storage.js +32 -0
- package/dist/context.storage.js.map +1 -0
- package/dist/exceptions.d.ts +10 -0
- package/dist/exceptions.js +25 -0
- package/dist/exceptions.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.js +16 -0
- package/dist/index.js.map +1 -0
- package/dist/propagation.enum.d.ts +30 -0
- package/dist/propagation.enum.js +35 -0
- package/dist/propagation.enum.js.map +1 -0
- package/dist/transactional.runner.d.ts +29 -0
- package/dist/transactional.runner.js +119 -0
- package/dist/transactional.runner.js.map +1 -0
- package/dist/types.d.ts +10 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/package.json +21 -0
- package/src/context.base.ts +61 -0
- package/src/context.storage.ts +34 -0
- package/src/exceptions.ts +21 -0
- package/src/index.ts +10 -0
- package/src/propagation.enum.ts +36 -0
- package/src/transactional.runner.ts +222 -0
- package/src/types.ts +37 -0
- package/tsconfig.json +11 -0
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { BaseContext } from '@rsdk/db';
|
|
2
|
+
import type { Knex } from 'knex';
|
|
3
|
+
import type { IsolationLevel } from '../types';
|
|
4
|
+
export type KnexRunner = {
|
|
5
|
+
connection: any;
|
|
6
|
+
builder: Knex;
|
|
7
|
+
client: Knex;
|
|
8
|
+
run(...args: any[]): Promise<any>;
|
|
9
|
+
};
|
|
10
|
+
export declare class KnexContext extends BaseContext<IsolationLevel> {
|
|
11
|
+
readonly isolationLevels: readonly IsolationLevel[];
|
|
12
|
+
/**
|
|
13
|
+
* Массив слоёв в котором каждый trx и runner соответствует вложенности
|
|
14
|
+
* Необходимо для поддержки savepoint
|
|
15
|
+
* @private
|
|
16
|
+
*/
|
|
17
|
+
private layers;
|
|
18
|
+
/**
|
|
19
|
+
* Глубина вложенности
|
|
20
|
+
* Не путать с индексом вложенности
|
|
21
|
+
* По сути является необходимым количеством проинициализированных слоев
|
|
22
|
+
* @private
|
|
23
|
+
*/
|
|
24
|
+
private nestDepth;
|
|
25
|
+
/**
|
|
26
|
+
* Завершена ли работа с этим контекстом
|
|
27
|
+
* Необходимо для контроля за тем чтобы не было переиспользований этого контекста
|
|
28
|
+
* @private
|
|
29
|
+
*/
|
|
30
|
+
private _isReleased;
|
|
31
|
+
private constructor();
|
|
32
|
+
private constructor();
|
|
33
|
+
get isReleased(): boolean;
|
|
34
|
+
/**
|
|
35
|
+
* Служебная функция для проверки проинициализирована ли транзакция.
|
|
36
|
+
* Не касается статуса инициализации текущего уровня вложенности
|
|
37
|
+
* @private
|
|
38
|
+
*/
|
|
39
|
+
get transactionInitialized(): boolean;
|
|
40
|
+
static create(isolationLevel: IsolationLevel): KnexContext;
|
|
41
|
+
/**
|
|
42
|
+
* Создаёт инстанс контекста, который обеспечит изоляцию от внешнего контекста
|
|
43
|
+
* Прежде всего необходимо для имплементации NOT_SUPPORTED propagation
|
|
44
|
+
*/
|
|
45
|
+
static createSuspended(): KnexContext;
|
|
46
|
+
/**
|
|
47
|
+
* Создаём новый runner для запуска метода `run`
|
|
48
|
+
* Необходимо из-за того что builder определяется при создании `runner`
|
|
49
|
+
* @param knexRunner
|
|
50
|
+
*/
|
|
51
|
+
createContextRunner(knexRunner: KnexRunner): Promise<KnexRunner>;
|
|
52
|
+
/**
|
|
53
|
+
* Метод инициализирует необходимые слои для корректной работы savepoint
|
|
54
|
+
* @param settledRunner
|
|
55
|
+
*/
|
|
56
|
+
initialize(settledRunner: KnexRunner): Promise<void>;
|
|
57
|
+
/**
|
|
58
|
+
* Должен быть вызван перед тем как запускать функцию, подразумевающую вложенный уровень транзакционности
|
|
59
|
+
*/
|
|
60
|
+
addNestLayer(): void;
|
|
61
|
+
rollbackTransaction(): Promise<void>;
|
|
62
|
+
commitTransaction(): Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* Завершает обработку вложенности
|
|
65
|
+
* @param mustRelease должны ли быть все транзакции завершены, а соединение возвращено в пул
|
|
66
|
+
*/
|
|
67
|
+
finalize(mustRelease: boolean): Promise<void>;
|
|
68
|
+
/**
|
|
69
|
+
* Проинициализированы ли все необходимые слои транзакций
|
|
70
|
+
* Необходимо для тестов и внутренних процессов
|
|
71
|
+
*/
|
|
72
|
+
isInitialized(): boolean;
|
|
73
|
+
/**
|
|
74
|
+
* Можно ли начать использовать этот контекст
|
|
75
|
+
*/
|
|
76
|
+
assertStart(): void;
|
|
77
|
+
private makeKnex;
|
|
78
|
+
}
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.KnexContext = void 0;
|
|
7
|
+
/* eslint-disable @typescript-eslint/ban-ts-comment */
|
|
8
|
+
const db_1 = require("@rsdk/db");
|
|
9
|
+
/**
|
|
10
|
+
ts-ignore потому что в тайпингах этого нет, а тайпингов нет потому что knex ~~говно~~ написан на js, и тайпинги написаны руками,
|
|
11
|
+
руками которые не написали тайпинги для внутренних вещей
|
|
12
|
+
*/
|
|
13
|
+
// @ts-ignore
|
|
14
|
+
const runner_1 = __importDefault(require("knex/lib/execution/runner"));
|
|
15
|
+
const types_1 = require("../types");
|
|
16
|
+
const exceptions_1 = require("./exceptions");
|
|
17
|
+
class KnexContext extends db_1.BaseContext {
|
|
18
|
+
isolationLevels = types_1.isolationLevels;
|
|
19
|
+
/**
|
|
20
|
+
* Массив слоёв в котором каждый trx и runner соответствует вложенности
|
|
21
|
+
* Необходимо для поддержки savepoint
|
|
22
|
+
* @private
|
|
23
|
+
*/
|
|
24
|
+
layers = [];
|
|
25
|
+
/**
|
|
26
|
+
* Глубина вложенности
|
|
27
|
+
* Не путать с индексом вложенности
|
|
28
|
+
* По сути является необходимым количеством проинициализированных слоев
|
|
29
|
+
* @private
|
|
30
|
+
*/
|
|
31
|
+
nestDepth = 1;
|
|
32
|
+
/**
|
|
33
|
+
* Завершена ли работа с этим контекстом
|
|
34
|
+
* Необходимо для контроля за тем чтобы не было переиспользований этого контекста
|
|
35
|
+
* @private
|
|
36
|
+
*/
|
|
37
|
+
_isReleased = false;
|
|
38
|
+
constructor(arg) {
|
|
39
|
+
super(arg ?? types_1.DEFAULT_ISOLATION_LEVEL);
|
|
40
|
+
}
|
|
41
|
+
get isReleased() {
|
|
42
|
+
return this._isReleased;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Служебная функция для проверки проинициализирована ли транзакция.
|
|
46
|
+
* Не касается статуса инициализации текущего уровня вложенности
|
|
47
|
+
* @private
|
|
48
|
+
*/
|
|
49
|
+
get transactionInitialized() {
|
|
50
|
+
return Boolean(this.layers.at(0)?.trx?.isTransaction);
|
|
51
|
+
}
|
|
52
|
+
static create(isolationLevel) {
|
|
53
|
+
return new KnexContext(isolationLevel);
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Создаёт инстанс контекста, который обеспечит изоляцию от внешнего контекста
|
|
57
|
+
* Прежде всего необходимо для имплементации NOT_SUPPORTED propagation
|
|
58
|
+
*/
|
|
59
|
+
static createSuspended() {
|
|
60
|
+
return new KnexContext(true);
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Создаём новый runner для запуска метода `run`
|
|
64
|
+
* Необходимо из-за того что builder определяется при создании `runner`
|
|
65
|
+
* @param knexRunner
|
|
66
|
+
*/
|
|
67
|
+
async createContextRunner(knexRunner) {
|
|
68
|
+
const layer = this.layers.at(this.nestDepth - 1);
|
|
69
|
+
if (!layer) {
|
|
70
|
+
throw new exceptions_1.LayerMustBeInitialized();
|
|
71
|
+
}
|
|
72
|
+
if (this.suspended) {
|
|
73
|
+
return knexRunner;
|
|
74
|
+
}
|
|
75
|
+
const trx = layer.trx ?? (layer.trx = await this.makeKnex(layer.runner));
|
|
76
|
+
const transactionRunner = new runner_1.default(trx.client, knexRunner.builder);
|
|
77
|
+
/**
|
|
78
|
+
* Для того чтобы он точно использовал подключение уже существующего queryRunner, а не пытался его проинициализировать
|
|
79
|
+
* https://github.com/knex/knex/blob/42b91980b7de281a4c53910f9af32da4462a9c5a/lib/execution/runner.js#L30
|
|
80
|
+
* https://github.com/knex/knex/blob/42b91980b7de281a4c53910f9af32da4462a9c5a/lib/execution/runner.js#L281
|
|
81
|
+
*
|
|
82
|
+
* Такой же хак используется в самом knex
|
|
83
|
+
* https://github.com/knex/knex/blob/42b91980b7de281a4c53910f9af32da4462a9c5a/lib/execution/runner.js#L246
|
|
84
|
+
*
|
|
85
|
+
* Не думаю что есть повод беспокоиться о том что runner может взять подключение у builder, это делается форсировано самим пользователем,
|
|
86
|
+
* по крайней мере на данный момент я не нашёл использования этого внутри `knex`
|
|
87
|
+
*/
|
|
88
|
+
transactionRunner.connection = layer.runner.connection;
|
|
89
|
+
return transactionRunner;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Метод инициализирует необходимые слои для корректной работы savepoint
|
|
93
|
+
* @param settledRunner
|
|
94
|
+
*/
|
|
95
|
+
async initialize(settledRunner) {
|
|
96
|
+
if (this.suspended) {
|
|
97
|
+
if (this.layers.length === 1) {
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
const runner = new runner_1.default(settledRunner.client,
|
|
101
|
+
/**
|
|
102
|
+
* Билдер в данном случае не имеет принципиального значения, сделано больше для соблюдения API, практического значения не имеет
|
|
103
|
+
*/
|
|
104
|
+
settledRunner.builder);
|
|
105
|
+
this.layers = [
|
|
106
|
+
{
|
|
107
|
+
runner: runner,
|
|
108
|
+
},
|
|
109
|
+
];
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Получаем необходимое для инициализации количество слоёв,
|
|
113
|
+
* То есть количество вложенностей которое нам необходимо проинициализировать
|
|
114
|
+
*/
|
|
115
|
+
const requiredLayerCount = this.nestDepth - this.layers.length;
|
|
116
|
+
for (let i = 0; i < requiredLayerCount; i++) {
|
|
117
|
+
const existedLayer = this.layers.at(-1);
|
|
118
|
+
const existedTrx =
|
|
119
|
+
/**
|
|
120
|
+
* Если до этого транзакция уже была проинициализирована, то используем существующей trx для создания `savepoint`
|
|
121
|
+
*/
|
|
122
|
+
existedLayer &&
|
|
123
|
+
(existedLayer?.trx ??
|
|
124
|
+
(existedLayer.trx = await this.makeKnex(existedLayer.runner)));
|
|
125
|
+
/**
|
|
126
|
+
* Если транзакции ещё не было, создаст её,
|
|
127
|
+
* иначе создаст `savepoint`
|
|
128
|
+
*/
|
|
129
|
+
const initializedTrx = await new Promise((resolve, reject) => existedTrx
|
|
130
|
+
? existedTrx?.transaction(resolve).catch(reject)
|
|
131
|
+
: this.makeKnex(settledRunner).then(resolve, reject));
|
|
132
|
+
const transactionRunner = new runner_1.default(initializedTrx.client,
|
|
133
|
+
/**
|
|
134
|
+
* Билдер в данном случае не имеет принципиального значения, сделано больше для соблюдения API, практического значения не имеет
|
|
135
|
+
*/
|
|
136
|
+
settledRunner.builder);
|
|
137
|
+
const newKnexContextLayer = {
|
|
138
|
+
runner: transactionRunner,
|
|
139
|
+
trx: initializedTrx,
|
|
140
|
+
};
|
|
141
|
+
// @ts-ignore
|
|
142
|
+
this.layers.push(newKnexContextLayer);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Должен быть вызван перед тем как запускать функцию, подразумевающую вложенный уровень транзакционности
|
|
147
|
+
*/
|
|
148
|
+
addNestLayer() {
|
|
149
|
+
if (this.suspended) {
|
|
150
|
+
throw new exceptions_1.NestUnavailableOnSuspendedContext();
|
|
151
|
+
}
|
|
152
|
+
this.nestDepth += 1;
|
|
153
|
+
}
|
|
154
|
+
async rollbackTransaction() {
|
|
155
|
+
if (this.suspended) {
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Слой может быть не проинициализирован из-за того что внутри функции не было запросов к бд
|
|
160
|
+
*/
|
|
161
|
+
await this.layers.at(this.nestDepth - 1)?.trx?.rollback();
|
|
162
|
+
}
|
|
163
|
+
async commitTransaction() {
|
|
164
|
+
if (this.suspended) {
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Слой может быть не проинициализирован из-за того что внутри функции не было запросов к бд
|
|
169
|
+
*/
|
|
170
|
+
await this.layers.at(this.nestDepth - 1)?.trx?.commit();
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Завершает обработку вложенности
|
|
174
|
+
* @param mustRelease должны ли быть все транзакции завершены, а соединение возвращено в пул
|
|
175
|
+
*/
|
|
176
|
+
async finalize(mustRelease) {
|
|
177
|
+
if (this.nestDepth < this.layers.length) {
|
|
178
|
+
/**
|
|
179
|
+
* Не должно быть ситуаций при которых мы попадаем сюда с количеством слоев больше чем уровень вложенности
|
|
180
|
+
*/
|
|
181
|
+
throw new exceptions_1.LayersCountMoreThanNestDepth();
|
|
182
|
+
}
|
|
183
|
+
this.nestDepth -= 1;
|
|
184
|
+
/**
|
|
185
|
+
* Удаляем обработанные слои
|
|
186
|
+
*/
|
|
187
|
+
const layers = this.layers.splice(this.nestDepth);
|
|
188
|
+
console.log('removed:', { layers });
|
|
189
|
+
// for (const layer of layers) {
|
|
190
|
+
// await layer.trx?.destroy();
|
|
191
|
+
// }
|
|
192
|
+
/**
|
|
193
|
+
* Релизнули(закрыли) ли мы соединение
|
|
194
|
+
*/
|
|
195
|
+
const isReleased = this.layers.length === 0;
|
|
196
|
+
this._isReleased = isReleased;
|
|
197
|
+
/**
|
|
198
|
+
* В обоих случаях в идеале завершать работу приложения так как часть операция может быть не выполнена, хотя должна была и наоборот
|
|
199
|
+
* И в качестве бонуса получим висящее соединение к СУБД которое нельзя использовать
|
|
200
|
+
*/
|
|
201
|
+
if (mustRelease && !isReleased) {
|
|
202
|
+
throw new exceptions_1.MustReleased();
|
|
203
|
+
}
|
|
204
|
+
if (isReleased && !mustRelease) {
|
|
205
|
+
throw new exceptions_1.UnexpectedRelease();
|
|
206
|
+
}
|
|
207
|
+
if (mustRelease) {
|
|
208
|
+
for (const layer of layers) {
|
|
209
|
+
await layer.trx?.destroy();
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* Проинициализированы ли все необходимые слои транзакций
|
|
215
|
+
* Необходимо для тестов и внутренних процессов
|
|
216
|
+
*/
|
|
217
|
+
isInitialized() {
|
|
218
|
+
return this.layers.length === this.nestDepth;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Можно ли начать использовать этот контекст
|
|
222
|
+
*/
|
|
223
|
+
assertStart() {
|
|
224
|
+
if (this.nestDepth < 1) {
|
|
225
|
+
throw new exceptions_1.StartWithFinalizedContextUnavailable();
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
async makeKnex(settledRunner) {
|
|
229
|
+
return await new Promise((res, rej) => settledRunner.client.transaction(res).catch(rej));
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
exports.KnexContext = KnexContext;
|
|
233
|
+
//# sourceMappingURL=context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAsD;AACtD,iCAAuC;AAEvC;;;GAGG;AACH,aAAa;AACb,uEAA8D;AAG9D,oCAAoE;AAEpE,6CAOsB;AAqBtB,MAAa,WAAY,SAAQ,gBAA2B;IACjD,eAAe,GAAG,uBAAe,CAAC;IAC3C;;;;OAIG;IACK,MAAM,GAAuB,EAAE,CAAC;IACxC;;;;;OAKG;IACK,SAAS,GAAG,CAAC,CAAC;IAEtB;;;;OAIG;IACK,WAAW,GAAG,KAAK,CAAC;IAM5B,YAAoB,GAA2B;QAC7C,KAAK,CAAC,GAAG,IAAI,+BAAuB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,IAAI,sBAAsB;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,cAA8B;QAC1C,OAAO,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,UAAsB;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,mCAAsB,EAAE,CAAC;SACpC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO,UAAU,CAAC;SACnB;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEzE,MAAM,iBAAiB,GAAG,IAAI,gBAAM,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAErE;;;;;;;;;;WAUG;QACH,iBAAiB,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAEvD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,aAAyB;QACxC,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC5B,OAAO;aACR;YAED,MAAM,MAAM,GAAG,IAAI,gBAAM,CACvB,aAAa,CAAC,MAAM;YACpB;;eAEG;YACH,aAAa,CAAC,OAAO,CACtB,CAAC;YAEF,IAAI,CAAC,MAAM,GAAG;gBACZ;oBACE,MAAM,EAAE,MAAM;iBACf;aACF,CAAC;SACH;QAED;;;WAGG;QACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAE/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,UAAU;YACd;;eAEG;YACH,YAAY;gBACZ,CAAC,YAAY,EAAE,GAAG;oBAChB,CAAC,YAAY,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEnE;;;eAGG;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,OAAO,CACtC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAClB,UAAU;gBACR,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CACzD,CAAC;YAEF,MAAM,iBAAiB,GAAG,IAAI,gBAAM,CAClC,cAAc,CAAC,MAAM;YACrB;;eAEG;YACH,aAAa,CAAC,OAAO,CACtB,CAAC;YACF,MAAM,mBAAmB,GAAG;gBAC1B,MAAM,EAAE,iBAAiB;gBACzB,GAAG,EAAE,cAAc;aACpB,CAAC;YAEF,aAAa;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;SACvC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,IAAI,8CAAiC,EAAE,CAAC;SAC/C;QAED,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO;SACR;QAED;;WAEG;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO;SACR;QAED;;WAEG;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,WAAoB;QACjC,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YACvC;;eAEG;YACH,MAAM,IAAI,yCAA4B,EAAE,CAAC;SAC1C;QAED,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QAEpB;;WAEG;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAElD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,gCAAgC;QAChC,gCAAgC;QAChC,IAAI;QACJ;;WAEG;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QAE5C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAE9B;;;WAGG;QACH,IAAI,WAAW,IAAI,CAAC,UAAU,EAAE;YAC9B,MAAM,IAAI,yBAAY,EAAE,CAAC;SAC1B;QAED,IAAI,UAAU,IAAI,CAAC,WAAW,EAAE;YAC9B,MAAM,IAAI,8BAAiB,EAAE,CAAC;SAC/B;QACD,IAAI,WAAW,EAAE;YACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;gBAC1B,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;aAC5B;SACF;IACH,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE;YACtB,MAAM,IAAI,iDAAoC,EAAE,CAAC;SAClD;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,aAAyB;QAC9C,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CACpC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CACjD,CAAC;IACJ,CAAC;CACF;AAvQD,kCAuQC"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { InternalException } from '@rsdk/core';
|
|
2
|
+
/**
|
|
3
|
+
* Попытка начать выполнения функции в контексте при неподходящем состоянии контекста
|
|
4
|
+
*/
|
|
5
|
+
export declare class StartWithFinalizedContextUnavailable extends InternalException {
|
|
6
|
+
constructor();
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Попытка использовать queryRunner в момент когда слой для уровня вложенности ещё не проинициализирован
|
|
10
|
+
*/
|
|
11
|
+
export declare class LayerMustBeInitialized extends InternalException {
|
|
12
|
+
constructor();
|
|
13
|
+
}
|
|
14
|
+
export declare class FinalizeException extends InternalException {
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Ожидалось завершение работы с транзакцией, но не удовлетворены условия завершения (например транзакция не может быть закрыта из-за наличия незакрытых `savepoint`)
|
|
18
|
+
*/
|
|
19
|
+
export declare class MustReleased extends InternalException {
|
|
20
|
+
constructor();
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Проинициализировано больше слоев чем текущий уровень вложенности
|
|
24
|
+
*/
|
|
25
|
+
export declare class LayersCountMoreThanNestDepth extends FinalizeException {
|
|
26
|
+
constructor();
|
|
27
|
+
}
|
|
28
|
+
export declare class ContextMustBeProvided extends InternalException {
|
|
29
|
+
constructor();
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Неожиданный релиз (закрытие/возвращение в пул) соединения
|
|
33
|
+
*/
|
|
34
|
+
export declare class UnexpectedRelease extends InternalException {
|
|
35
|
+
constructor();
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Попытка использовать контекст когда работа с ним была завершена
|
|
39
|
+
* Например если не дождались завершения промиса использующего соединение
|
|
40
|
+
* @example
|
|
41
|
+
* runInContext(()=> {
|
|
42
|
+
* Promise.resolve().then(() => manager.query('SELECT 1'))
|
|
43
|
+
* })
|
|
44
|
+
*
|
|
45
|
+
* @example
|
|
46
|
+
* class UserController {
|
|
47
|
+
* constructor(
|
|
48
|
+
* private registerAttemptService: { registerAttemptToDb(): Promise<void> },
|
|
49
|
+
* private userService: { fetchUser(userId: UserId): Promise<User | null> }
|
|
50
|
+
* ) {}
|
|
51
|
+
*
|
|
52
|
+
* // @Get('/user')
|
|
53
|
+
* // @Transactional()
|
|
54
|
+
* async sum(@Query() query: { userId: UserId }): Promise<void> {
|
|
55
|
+
* this.registerAttemptService.registerAttemptToDb();
|
|
56
|
+
* return this.userService.fetchUser(query.userId);
|
|
57
|
+
* }
|
|
58
|
+
* }
|
|
59
|
+
*/
|
|
60
|
+
export declare class ContextIsReleased extends InternalException {
|
|
61
|
+
constructor();
|
|
62
|
+
}
|
|
63
|
+
export declare class NestUnavailableOnSuspendedContext extends InternalException {
|
|
64
|
+
constructor();
|
|
65
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.NestUnavailableOnSuspendedContext = exports.ContextIsReleased = exports.UnexpectedRelease = exports.ContextMustBeProvided = exports.LayersCountMoreThanNestDepth = exports.MustReleased = exports.FinalizeException = exports.LayerMustBeInitialized = exports.StartWithFinalizedContextUnavailable = void 0;
|
|
4
|
+
const core_1 = require("@rsdk/core");
|
|
5
|
+
/**
|
|
6
|
+
* Попытка начать выполнения функции в контексте при неподходящем состоянии контекста
|
|
7
|
+
*/
|
|
8
|
+
class StartWithFinalizedContextUnavailable extends core_1.InternalException {
|
|
9
|
+
constructor() {
|
|
10
|
+
super('Start with finalized context unavailable');
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
exports.StartWithFinalizedContextUnavailable = StartWithFinalizedContextUnavailable;
|
|
14
|
+
/**
|
|
15
|
+
* Попытка использовать queryRunner в момент когда слой для уровня вложенности ещё не проинициализирован
|
|
16
|
+
*/
|
|
17
|
+
class LayerMustBeInitialized extends core_1.InternalException {
|
|
18
|
+
constructor() {
|
|
19
|
+
super('Layer must be initialized');
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
exports.LayerMustBeInitialized = LayerMustBeInitialized;
|
|
23
|
+
class FinalizeException extends core_1.InternalException {
|
|
24
|
+
}
|
|
25
|
+
exports.FinalizeException = FinalizeException;
|
|
26
|
+
/**
|
|
27
|
+
* Ожидалось завершение работы с транзакцией, но не удовлетворены условия завершения (например транзакция не может быть закрыта из-за наличия незакрытых `savepoint`)
|
|
28
|
+
*/
|
|
29
|
+
class MustReleased extends core_1.InternalException {
|
|
30
|
+
constructor() {
|
|
31
|
+
super('Must released but conditions not satisfied');
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
exports.MustReleased = MustReleased;
|
|
35
|
+
/**
|
|
36
|
+
* Проинициализировано больше слоев чем текущий уровень вложенности
|
|
37
|
+
*/
|
|
38
|
+
class LayersCountMoreThanNestDepth extends FinalizeException {
|
|
39
|
+
constructor() {
|
|
40
|
+
super('Layers count more than nest depth');
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
exports.LayersCountMoreThanNestDepth = LayersCountMoreThanNestDepth;
|
|
44
|
+
class ContextMustBeProvided extends core_1.InternalException {
|
|
45
|
+
constructor() {
|
|
46
|
+
super('Context must be provided');
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
exports.ContextMustBeProvided = ContextMustBeProvided;
|
|
50
|
+
/**
|
|
51
|
+
* Неожиданный релиз (закрытие/возвращение в пул) соединения
|
|
52
|
+
*/
|
|
53
|
+
class UnexpectedRelease extends core_1.InternalException {
|
|
54
|
+
constructor() {
|
|
55
|
+
super('Unexpected release connection');
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
exports.UnexpectedRelease = UnexpectedRelease;
|
|
59
|
+
/**
|
|
60
|
+
* Попытка использовать контекст когда работа с ним была завершена
|
|
61
|
+
* Например если не дождались завершения промиса использующего соединение
|
|
62
|
+
* @example
|
|
63
|
+
* runInContext(()=> {
|
|
64
|
+
* Promise.resolve().then(() => manager.query('SELECT 1'))
|
|
65
|
+
* })
|
|
66
|
+
*
|
|
67
|
+
* @example
|
|
68
|
+
* class UserController {
|
|
69
|
+
* constructor(
|
|
70
|
+
* private registerAttemptService: { registerAttemptToDb(): Promise<void> },
|
|
71
|
+
* private userService: { fetchUser(userId: UserId): Promise<User | null> }
|
|
72
|
+
* ) {}
|
|
73
|
+
*
|
|
74
|
+
* // @Get('/user')
|
|
75
|
+
* // @Transactional()
|
|
76
|
+
* async sum(@Query() query: { userId: UserId }): Promise<void> {
|
|
77
|
+
* this.registerAttemptService.registerAttemptToDb();
|
|
78
|
+
* return this.userService.fetchUser(query.userId);
|
|
79
|
+
* }
|
|
80
|
+
* }
|
|
81
|
+
*/
|
|
82
|
+
class ContextIsReleased extends core_1.InternalException {
|
|
83
|
+
constructor() {
|
|
84
|
+
super("Trying to use a context when it's already released (the function started in the context has been ended)");
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
exports.ContextIsReleased = ContextIsReleased;
|
|
88
|
+
class NestUnavailableOnSuspendedContext extends core_1.InternalException {
|
|
89
|
+
constructor() {
|
|
90
|
+
super('Work with nesting context unavailable on suspended context');
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
exports.NestUnavailableOnSuspendedContext = NestUnavailableOnSuspendedContext;
|
|
94
|
+
//# 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;;GAEG;AACH,MAAa,oCAAqC,SAAQ,wBAAiB;IACzE;QACE,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACpD,CAAC;CACF;AAJD,oFAIC;AAED;;GAEG;AACH,MAAa,sBAAuB,SAAQ,wBAAiB;IAC3D;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;CACF;AAJD,wDAIC;AAED,MAAa,iBAAkB,SAAQ,wBAAiB;CAAG;AAA3D,8CAA2D;AAE3D;;GAEG;AACH,MAAa,YAAa,SAAQ,wBAAiB;IACjD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF;AAJD,oCAIC;AAED;;GAEG;AACH,MAAa,4BAA6B,SAAQ,iBAAiB;IACjE;QACE,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,oEAIC;AAED,MAAa,qBAAsB,SAAQ,wBAAiB;IAC1D;QACE,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACpC,CAAC;CACF;AAJD,sDAIC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,wBAAiB;IACtD;QACE,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACzC,CAAC;CACF;AAJD,8CAIC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,iBAAkB,SAAQ,wBAAiB;IACtD;QACE,KAAK,CACH,yGAAyG,CAC1G,CAAC;IACJ,CAAC;CACF;AAND,8CAMC;AAED,MAAa,iCAAkC,SAAQ,wBAAiB;IACtE;QACE,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACtE,CAAC;CACF;AAJD,8EAIC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { ContextStorage } from '@rsdk/db';
|
|
2
|
+
import type { KnexContext } from './context';
|
|
3
|
+
export declare class Initializer {
|
|
4
|
+
static readonly storage: ContextStorage<KnexContext>;
|
|
5
|
+
/**
|
|
6
|
+
* Патчинг библиотеки для интеграции с асинхронным контекстом
|
|
7
|
+
*/
|
|
8
|
+
static initialize(): void;
|
|
9
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.Initializer = void 0;
|
|
7
|
+
/* eslint-disable @typescript-eslint/ban-ts-comment */
|
|
8
|
+
const db_1 = require("@rsdk/db");
|
|
9
|
+
// @ts-ignore
|
|
10
|
+
const runner_1 = __importDefault(require("knex/lib/execution/runner"));
|
|
11
|
+
const exceptions_1 = require("./exceptions");
|
|
12
|
+
const originalRun = runner_1.default.prototype.run;
|
|
13
|
+
class Initializer {
|
|
14
|
+
static storage = new db_1.ContextStorage();
|
|
15
|
+
/**
|
|
16
|
+
* Патчинг библиотеки для интеграции с асинхронным контекстом
|
|
17
|
+
*/
|
|
18
|
+
static initialize() {
|
|
19
|
+
Object.defineProperty(runner_1.default.prototype, 'run', {
|
|
20
|
+
value: async function (...args) {
|
|
21
|
+
const context = Initializer.storage.getContext();
|
|
22
|
+
if (!context) {
|
|
23
|
+
return originalRun.call(this, ...args);
|
|
24
|
+
}
|
|
25
|
+
if (context.isReleased) {
|
|
26
|
+
throw new exceptions_1.ContextIsReleased();
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Инициализируем контекст
|
|
30
|
+
*/
|
|
31
|
+
await context.initialize(this);
|
|
32
|
+
/**
|
|
33
|
+
* Создаём ранер для выполнения запроса
|
|
34
|
+
*/
|
|
35
|
+
const contextRunner = await context.createContextRunner(this);
|
|
36
|
+
try {
|
|
37
|
+
return await originalRun.call(contextRunner, ...args);
|
|
38
|
+
}
|
|
39
|
+
catch (error) {
|
|
40
|
+
console.error(error);
|
|
41
|
+
throw error;
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
exports.Initializer = Initializer;
|
|
48
|
+
//# sourceMappingURL=initializer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/internal/initializer.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAsD;AACtD,iCAA0C;AAC1C,aAAa;AACb,uEAA8D;AAG9D,6CAAiD;AAEjD,MAAM,WAAW,GAAG,gBAAM,CAAC,SAAS,CAAC,GAAG,CAAC;AAEzC,MAAa,WAAW;IACtB,MAAM,CAAU,OAAO,GAAG,IAAI,mBAAc,EAAe,CAAC;IAE5D;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,MAAM,CAAC,cAAc,CAAC,gBAAM,CAAC,SAAS,EAAE,KAAK,EAAE;YAC7C,KAAK,EAAE,KAAK,WAA6B,GAAG,IAAW;gBACrD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,EAAE;oBACZ,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;iBACxC;gBAED,IAAI,OAAO,CAAC,UAAU,EAAE;oBACtB,MAAM,IAAI,8BAAiB,EAAE,CAAC;iBAC/B;gBAED;;mBAEG;gBACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAE/B;;mBAEG;gBACH,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAE9D,IAAI;oBACF,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;iBACvD;gBAAC,OAAO,KAAK,EAAE;oBACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACrB,MAAM,KAAK,CAAC;iBACb;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;;AApCH,kCAqCC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { CallBack, TransactionalStrategy } from '@rsdk/db';
|
|
2
|
+
import type { IsolationLevel } from '../types';
|
|
3
|
+
import { KnexContext } from './context';
|
|
4
|
+
export declare class KnexTransactionalStrategy implements TransactionalStrategy<IsolationLevel, KnexContext> {
|
|
5
|
+
getContext(): KnexContext | undefined;
|
|
6
|
+
runOutTransactionalContext<TArgs extends any[], TResult>(fn: (...args: TArgs) => TResult, ...args: TArgs): Promise<TResult>;
|
|
7
|
+
bindContext<TResult, TArgs extends any[]>(fn: CallBack<TArgs, TResult>, options?: IsolationLevel): CallBack<TArgs, Promise<TResult>>;
|
|
8
|
+
isRunning(): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* Оборачивает функцию для корректного завершения транзакции, если она была проинициализирована внутри функции
|
|
11
|
+
* @param mustRelease Параметр указывает должны ли мы проверить что соединение было освобождено
|
|
12
|
+
* @param fn
|
|
13
|
+
*/
|
|
14
|
+
wrapInTransactionContext<TResult, TArgs extends any[]>(mustRelease: boolean, fn: CallBack<TArgs, TResult>): CallBack<TArgs, Promise<TResult>>;
|
|
15
|
+
runInContext<TResult, TArgs extends any[]>(options: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
|
|
16
|
+
runFromNewContext<TResult, TArgs extends any[]>(isolationLevel: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
|
|
17
|
+
nestedExecute<TResult, TArgs extends any[]>(context: KnexContext, isolationLevel: IsolationLevel, fn: CallBack<TArgs, TResult>, ...args: TArgs): Promise<TResult>;
|
|
18
|
+
}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.KnexTransactionalStrategy = void 0;
|
|
4
|
+
const types_1 = require("../types");
|
|
5
|
+
const context_1 = require("./context");
|
|
6
|
+
const exceptions_1 = require("./exceptions");
|
|
7
|
+
const initializer_1 = require("./initializer");
|
|
8
|
+
class KnexTransactionalStrategy {
|
|
9
|
+
getContext() {
|
|
10
|
+
return initializer_1.Initializer.storage.getContext();
|
|
11
|
+
}
|
|
12
|
+
runOutTransactionalContext(fn, ...args) {
|
|
13
|
+
const context = context_1.KnexContext.createSuspended();
|
|
14
|
+
const wrapped = this.wrapInTransactionContext(true, fn);
|
|
15
|
+
return initializer_1.Initializer.storage.run(context, wrapped, ...args);
|
|
16
|
+
}
|
|
17
|
+
bindContext(fn, options = types_1.DEFAULT_ISOLATION_LEVEL) {
|
|
18
|
+
return (...args) => this.runInContext(options, fn, ...args);
|
|
19
|
+
}
|
|
20
|
+
isRunning() {
|
|
21
|
+
return Boolean(initializer_1.Initializer.storage.getContext());
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Оборачивает функцию для корректного завершения транзакции, если она была проинициализирована внутри функции
|
|
25
|
+
* @param mustRelease Параметр указывает должны ли мы проверить что соединение было освобождено
|
|
26
|
+
* @param fn
|
|
27
|
+
*/
|
|
28
|
+
wrapInTransactionContext(mustRelease, fn) {
|
|
29
|
+
return async (...args) => {
|
|
30
|
+
const context = initializer_1.Initializer.storage.getContext();
|
|
31
|
+
if (!context) {
|
|
32
|
+
/**
|
|
33
|
+
* Нельзя стартовать так как контекст отсутствует
|
|
34
|
+
*/
|
|
35
|
+
throw new exceptions_1.ContextMustBeProvided();
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Можем ли мы стартовать с таким контекстом
|
|
39
|
+
*/
|
|
40
|
+
context.assertStart();
|
|
41
|
+
try {
|
|
42
|
+
const result = await fn(...args);
|
|
43
|
+
await context.commitTransaction();
|
|
44
|
+
return result;
|
|
45
|
+
}
|
|
46
|
+
catch (error) {
|
|
47
|
+
await context.rollbackTransaction();
|
|
48
|
+
throw error;
|
|
49
|
+
}
|
|
50
|
+
finally {
|
|
51
|
+
await context.finalize(mustRelease);
|
|
52
|
+
}
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
async runInContext(options, fn, ...args) {
|
|
56
|
+
const currentContext = initializer_1.Initializer.storage.getContext();
|
|
57
|
+
if (!currentContext) {
|
|
58
|
+
return await this.runFromNewContext(options, fn, ...args);
|
|
59
|
+
}
|
|
60
|
+
return await this.nestedExecute(currentContext, options, fn, ...args);
|
|
61
|
+
}
|
|
62
|
+
async runFromNewContext(isolationLevel, fn, ...args) {
|
|
63
|
+
const knexAsyncContextContext = context_1.KnexContext.create(isolationLevel);
|
|
64
|
+
const wrapped = this.wrapInTransactionContext(true, fn);
|
|
65
|
+
return initializer_1.Initializer.storage.run(knexAsyncContextContext, wrapped, ...args);
|
|
66
|
+
}
|
|
67
|
+
async nestedExecute(context, isolationLevel, fn, ...args) {
|
|
68
|
+
context.assertIsolationCompatibility(isolationLevel);
|
|
69
|
+
const wrapped = this.wrapInTransactionContext(false, fn);
|
|
70
|
+
context.addNestLayer();
|
|
71
|
+
return wrapped(...args);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
exports.KnexTransactionalStrategy = KnexTransactionalStrategy;
|
|
75
|
+
//# sourceMappingURL=strategy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../src/internal/strategy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|