@mikro-orm/core 7.0.15-dev.8 → 7.0.15

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 (206) hide show
  1. package/EntityManager.d.ts +885 -584
  2. package/EntityManager.js +1939 -1911
  3. package/MikroORM.d.ts +103 -74
  4. package/MikroORM.js +177 -178
  5. package/README.md +1 -1
  6. package/cache/CacheAdapter.d.ts +36 -36
  7. package/cache/FileCacheAdapter.d.ts +30 -24
  8. package/cache/FileCacheAdapter.js +80 -78
  9. package/cache/GeneratedCacheAdapter.d.ts +18 -20
  10. package/cache/GeneratedCacheAdapter.js +30 -30
  11. package/cache/MemoryCacheAdapter.d.ts +18 -20
  12. package/cache/MemoryCacheAdapter.js +35 -36
  13. package/cache/NullCacheAdapter.d.ts +16 -16
  14. package/cache/NullCacheAdapter.js +24 -24
  15. package/connections/Connection.d.ts +95 -84
  16. package/connections/Connection.js +165 -168
  17. package/drivers/DatabaseDriver.d.ts +186 -80
  18. package/drivers/DatabaseDriver.js +450 -443
  19. package/drivers/IDatabaseDriver.d.ts +444 -305
  20. package/entity/BaseEntity.d.ts +120 -83
  21. package/entity/BaseEntity.js +43 -43
  22. package/entity/Collection.d.ts +215 -181
  23. package/entity/Collection.js +730 -724
  24. package/entity/EntityAssigner.d.ts +88 -77
  25. package/entity/EntityAssigner.js +231 -230
  26. package/entity/EntityFactory.d.ts +67 -55
  27. package/entity/EntityFactory.js +454 -413
  28. package/entity/EntityHelper.d.ts +35 -23
  29. package/entity/EntityHelper.js +302 -290
  30. package/entity/EntityIdentifier.d.ts +4 -4
  31. package/entity/EntityIdentifier.js +10 -10
  32. package/entity/EntityLoader.d.ts +98 -72
  33. package/entity/EntityLoader.js +815 -786
  34. package/entity/EntityRepository.d.ts +316 -201
  35. package/entity/EntityRepository.js +213 -213
  36. package/entity/PolymorphicRef.d.ts +5 -5
  37. package/entity/PolymorphicRef.js +10 -10
  38. package/entity/Reference.d.ts +127 -83
  39. package/entity/Reference.js +281 -277
  40. package/entity/WrappedEntity.d.ts +115 -72
  41. package/entity/WrappedEntity.js +168 -166
  42. package/entity/defineEntity.d.ts +1412 -659
  43. package/entity/defineEntity.js +527 -518
  44. package/entity/utils.d.ts +13 -3
  45. package/entity/utils.js +71 -73
  46. package/entity/validators.js +43 -43
  47. package/entity/wrap.js +8 -8
  48. package/enums.d.ts +258 -253
  49. package/enums.js +251 -252
  50. package/errors.d.ts +114 -72
  51. package/errors.js +350 -253
  52. package/events/EventManager.d.ts +26 -14
  53. package/events/EventManager.js +79 -77
  54. package/events/EventSubscriber.d.ts +29 -29
  55. package/events/TransactionEventBroadcaster.d.ts +15 -8
  56. package/events/TransactionEventBroadcaster.js +14 -14
  57. package/exceptions.d.ts +23 -40
  58. package/exceptions.js +35 -52
  59. package/hydration/Hydrator.d.ts +42 -17
  60. package/hydration/Hydrator.js +43 -43
  61. package/hydration/ObjectHydrator.d.ts +50 -17
  62. package/hydration/ObjectHydrator.js +483 -418
  63. package/index.d.ts +118 -2
  64. package/index.js +10 -1
  65. package/logging/DefaultLogger.d.ts +34 -32
  66. package/logging/DefaultLogger.js +86 -86
  67. package/logging/Logger.d.ts +41 -41
  68. package/logging/SimpleLogger.d.ts +13 -11
  69. package/logging/SimpleLogger.js +22 -22
  70. package/logging/colors.d.ts +6 -6
  71. package/logging/colors.js +11 -10
  72. package/logging/inspect.js +7 -7
  73. package/metadata/EntitySchema.d.ts +214 -130
  74. package/metadata/EntitySchema.js +411 -412
  75. package/metadata/MetadataDiscovery.d.ts +115 -115
  76. package/metadata/MetadataDiscovery.js +2013 -1931
  77. package/metadata/MetadataProvider.d.ts +29 -26
  78. package/metadata/MetadataProvider.js +95 -97
  79. package/metadata/MetadataStorage.d.ts +38 -32
  80. package/metadata/MetadataStorage.js +118 -118
  81. package/metadata/MetadataValidator.d.ts +39 -39
  82. package/metadata/MetadataValidator.js +385 -340
  83. package/metadata/discover-entities.d.ts +5 -2
  84. package/metadata/discover-entities.js +35 -37
  85. package/metadata/types.d.ts +615 -531
  86. package/naming-strategy/AbstractNamingStrategy.d.ts +54 -39
  87. package/naming-strategy/AbstractNamingStrategy.js +90 -85
  88. package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
  89. package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
  90. package/naming-strategy/MongoNamingStrategy.d.ts +6 -6
  91. package/naming-strategy/MongoNamingStrategy.js +18 -18
  92. package/naming-strategy/NamingStrategy.d.ts +109 -99
  93. package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
  94. package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
  95. package/not-supported.js +7 -4
  96. package/package.json +1 -1
  97. package/platforms/ExceptionConverter.d.ts +1 -1
  98. package/platforms/ExceptionConverter.js +4 -4
  99. package/platforms/Platform.d.ts +312 -303
  100. package/platforms/Platform.js +715 -695
  101. package/serialization/EntitySerializer.d.ts +49 -26
  102. package/serialization/EntitySerializer.js +224 -218
  103. package/serialization/EntityTransformer.d.ts +10 -6
  104. package/serialization/EntityTransformer.js +219 -217
  105. package/serialization/SerializationContext.d.ts +27 -23
  106. package/serialization/SerializationContext.js +105 -105
  107. package/types/ArrayType.d.ts +8 -8
  108. package/types/ArrayType.js +33 -33
  109. package/types/BigIntType.d.ts +17 -10
  110. package/types/BigIntType.js +37 -37
  111. package/types/BlobType.d.ts +3 -3
  112. package/types/BlobType.js +13 -13
  113. package/types/BooleanType.d.ts +4 -4
  114. package/types/BooleanType.js +12 -12
  115. package/types/CharacterType.d.ts +2 -2
  116. package/types/CharacterType.js +6 -6
  117. package/types/DateTimeType.d.ts +5 -5
  118. package/types/DateTimeType.js +15 -15
  119. package/types/DateType.d.ts +5 -5
  120. package/types/DateType.js +15 -15
  121. package/types/DecimalType.d.ts +7 -7
  122. package/types/DecimalType.js +26 -26
  123. package/types/DoubleType.d.ts +3 -3
  124. package/types/DoubleType.js +12 -12
  125. package/types/EnumArrayType.d.ts +5 -5
  126. package/types/EnumArrayType.js +24 -24
  127. package/types/EnumType.d.ts +3 -3
  128. package/types/EnumType.js +11 -11
  129. package/types/FloatType.d.ts +3 -3
  130. package/types/FloatType.js +9 -9
  131. package/types/IntegerType.d.ts +3 -3
  132. package/types/IntegerType.js +9 -9
  133. package/types/IntervalType.d.ts +4 -4
  134. package/types/IntervalType.js +12 -12
  135. package/types/JsonType.d.ts +8 -8
  136. package/types/JsonType.js +32 -32
  137. package/types/MediumIntType.d.ts +1 -1
  138. package/types/MediumIntType.js +3 -3
  139. package/types/SmallIntType.d.ts +3 -3
  140. package/types/SmallIntType.js +9 -9
  141. package/types/StringType.d.ts +4 -4
  142. package/types/StringType.js +12 -12
  143. package/types/TextType.d.ts +3 -3
  144. package/types/TextType.js +9 -9
  145. package/types/TimeType.d.ts +5 -5
  146. package/types/TimeType.js +17 -17
  147. package/types/TinyIntType.d.ts +3 -3
  148. package/types/TinyIntType.js +10 -10
  149. package/types/Type.d.ts +83 -79
  150. package/types/Type.js +82 -82
  151. package/types/Uint8ArrayType.d.ts +4 -4
  152. package/types/Uint8ArrayType.js +21 -21
  153. package/types/UnknownType.d.ts +4 -4
  154. package/types/UnknownType.js +12 -12
  155. package/types/UuidType.d.ts +5 -5
  156. package/types/UuidType.js +19 -19
  157. package/types/index.d.ts +75 -49
  158. package/types/index.js +52 -26
  159. package/typings.d.ts +1268 -746
  160. package/typings.js +246 -233
  161. package/unit-of-work/ChangeSet.d.ts +26 -26
  162. package/unit-of-work/ChangeSet.js +56 -56
  163. package/unit-of-work/ChangeSetComputer.d.ts +12 -12
  164. package/unit-of-work/ChangeSetComputer.js +187 -179
  165. package/unit-of-work/ChangeSetPersister.d.ts +69 -50
  166. package/unit-of-work/ChangeSetPersister.js +469 -446
  167. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  168. package/unit-of-work/CommitOrderCalculator.js +89 -88
  169. package/unit-of-work/IdentityMap.d.ts +31 -31
  170. package/unit-of-work/IdentityMap.js +105 -105
  171. package/unit-of-work/UnitOfWork.d.ts +181 -141
  172. package/unit-of-work/UnitOfWork.js +1240 -1226
  173. package/utils/AbstractMigrator.d.ts +112 -92
  174. package/utils/AbstractMigrator.js +286 -288
  175. package/utils/AbstractSchemaGenerator.d.ts +43 -34
  176. package/utils/AbstractSchemaGenerator.js +121 -122
  177. package/utils/AsyncContext.d.ts +3 -3
  178. package/utils/AsyncContext.js +34 -35
  179. package/utils/Configuration.d.ts +852 -808
  180. package/utils/Configuration.js +359 -344
  181. package/utils/Cursor.d.ts +40 -22
  182. package/utils/Cursor.js +135 -127
  183. package/utils/DataloaderUtils.d.ts +58 -43
  184. package/utils/DataloaderUtils.js +203 -198
  185. package/utils/EntityComparator.d.ts +99 -82
  186. package/utils/EntityComparator.js +836 -744
  187. package/utils/NullHighlighter.d.ts +1 -1
  188. package/utils/NullHighlighter.js +3 -3
  189. package/utils/QueryHelper.d.ts +85 -57
  190. package/utils/QueryHelper.js +404 -392
  191. package/utils/RawQueryFragment.d.ts +50 -34
  192. package/utils/RawQueryFragment.js +122 -121
  193. package/utils/RequestContext.d.ts +32 -32
  194. package/utils/RequestContext.js +52 -53
  195. package/utils/TransactionContext.d.ts +16 -16
  196. package/utils/TransactionContext.js +27 -27
  197. package/utils/TransactionManager.d.ts +58 -58
  198. package/utils/TransactionManager.js +202 -200
  199. package/utils/Utils.d.ts +204 -145
  200. package/utils/Utils.js +826 -826
  201. package/utils/clone.js +105 -114
  202. package/utils/env-vars.js +90 -88
  203. package/utils/fs-utils.d.ts +15 -15
  204. package/utils/fs-utils.js +181 -182
  205. package/utils/upsert-utils.d.ts +20 -5
  206. package/utils/upsert-utils.js +114 -116
@@ -1,315 +1,313 @@
1
1
  import { Utils } from './Utils.js';
2
2
  export class AbstractMigrator {
3
- em;
4
- runner;
5
- storage;
6
- generator;
7
- driver;
8
- config;
9
- options;
10
- absolutePath;
11
- initialized = false;
12
- #listeners = new Map();
13
- constructor(em) {
14
- this.em = em;
15
- this.driver = this.em.getDriver();
16
- this.config = this.em.config;
17
- this.options = this.config.get('migrations');
18
- this.initServices();
19
- this.registerDefaultListeners();
3
+ em;
4
+ runner;
5
+ storage;
6
+ generator;
7
+ driver;
8
+ config;
9
+ options;
10
+ absolutePath;
11
+ initialized = false;
12
+ #listeners = new Map();
13
+ constructor(em) {
14
+ this.em = em;
15
+ this.driver = this.em.getDriver();
16
+ this.config = this.em.config;
17
+ this.options = this.config.get('migrations');
18
+ this.initServices();
19
+ this.registerDefaultListeners();
20
+ }
21
+ /**
22
+ * @inheritDoc
23
+ */
24
+ on(eventName, listener) {
25
+ if (!this.#listeners.has(eventName)) {
26
+ this.#listeners.set(eventName, new Set());
20
27
  }
21
- /**
22
- * @inheritDoc
23
- */
24
- on(eventName, listener) {
25
- if (!this.#listeners.has(eventName)) {
26
- this.#listeners.set(eventName, new Set());
27
- }
28
- this.#listeners.get(eventName).add(listener);
29
- return this;
28
+ this.#listeners.get(eventName).add(listener);
29
+ return this;
30
+ }
31
+ /**
32
+ * @inheritDoc
33
+ */
34
+ off(eventName, listener) {
35
+ this.#listeners.get(eventName)?.delete(listener);
36
+ return this;
37
+ }
38
+ /**
39
+ * @inheritDoc
40
+ */
41
+ async getExecuted() {
42
+ await this.init();
43
+ return this.storage.getExecutedMigrations();
44
+ }
45
+ /**
46
+ * @inheritDoc
47
+ */
48
+ async getPending() {
49
+ await this.init();
50
+ const all = await this.discoverMigrations();
51
+ const executed = new Set(await this.storage.executed());
52
+ return all.filter(m => !executed.has(m.name)).map(m => ({ name: m.name, path: m.path }));
53
+ }
54
+ /**
55
+ * @inheritDoc
56
+ */
57
+ async up(options) {
58
+ return this.runMigrations('up', options);
59
+ }
60
+ /**
61
+ * @inheritDoc
62
+ */
63
+ async down(options) {
64
+ return this.runMigrations('down', options);
65
+ }
66
+ async init() {
67
+ if (this.initialized) {
68
+ return;
30
69
  }
31
- /**
32
- * @inheritDoc
33
- */
34
- off(eventName, listener) {
35
- this.#listeners.get(eventName)?.delete(listener);
36
- return this;
70
+ this.initialized = true;
71
+ await this.initPaths();
72
+ }
73
+ async initPaths() {
74
+ if (this.absolutePath || this.options.migrationsList) {
75
+ return;
37
76
  }
38
- /**
39
- * @inheritDoc
40
- */
41
- async getExecuted() {
42
- await this.init();
43
- return this.storage.getExecutedMigrations();
77
+ const { fs } = await import('@mikro-orm/core/fs-utils');
78
+ this.detectSourceFolder(fs);
79
+ /* v8 ignore next */
80
+ const key = this.config.get('preferTs', Utils.detectTypeScriptSupport()) && this.options.pathTs ? 'pathTs' : 'path';
81
+ this.absolutePath = fs.absolutePath(this.options[key], this.config.get('baseDir'));
82
+ try {
83
+ fs.ensureDir(this.absolutePath);
84
+ } catch {
85
+ // read-only filesystem — read-only operations (e.g. `getPending` with a
86
+ // snapshot) may still succeed; write operations will fail on their own
44
87
  }
45
- /**
46
- * @inheritDoc
47
- */
48
- async getPending() {
49
- await this.init();
50
- const all = await this.discoverMigrations();
51
- const executed = new Set(await this.storage.executed());
52
- return all.filter(m => !executed.has(m.name)).map(m => ({ name: m.name, path: m.path }));
88
+ }
89
+ initServices() {
90
+ this.runner = this.createRunner();
91
+ this.storage = this.createStorage();
92
+ if (this.options.generator) {
93
+ this.generator = new this.options.generator(this.driver, this.config.getNamingStrategy(), this.options);
94
+ } else {
95
+ this.generator = this.getDefaultGenerator();
53
96
  }
54
- /**
55
- * @inheritDoc
56
- */
57
- async up(options) {
58
- return this.runMigrations('up', options);
97
+ }
98
+ resolve(params) {
99
+ const createMigrationHandler = async (method, afterRun) => {
100
+ const { fs } = await import('@mikro-orm/core/fs-utils');
101
+ const migration = await fs.dynamicImport(params.path);
102
+ const MigrationClass = Object.values(migration).find(
103
+ cls => typeof cls === 'function' && typeof cls.constructor === 'function',
104
+ );
105
+ const instance = new MigrationClass(this.driver, this.config);
106
+ await this.runner.run(instance, method, afterRun);
107
+ };
108
+ return {
109
+ name: this.storage.getMigrationName(params.name),
110
+ path: params.path,
111
+ up: afterRun => createMigrationHandler('up', afterRun),
112
+ down: afterRun => createMigrationHandler('down', afterRun),
113
+ };
114
+ }
115
+ initialize(MigrationClass, name) {
116
+ const instance = new MigrationClass(this.driver, this.config);
117
+ return {
118
+ name: this.storage.getMigrationName(name),
119
+ up: afterRun => this.runner.run(instance, 'up', afterRun),
120
+ down: afterRun => this.runner.run(instance, 'down', afterRun),
121
+ };
122
+ }
123
+ /**
124
+ * Checks if `src` folder exists, it so, tries to adjust the migrations and seeders paths automatically to use it.
125
+ * If there is a `dist` or `build` folder, it will be used for the JS variant (`path` option), while the `src` folder will be
126
+ * used for the TS variant (`pathTs` option).
127
+ *
128
+ * If the default folder exists (e.g. `/migrations`), the config will respect that, so this auto-detection should not
129
+ * break existing projects, only help with the new ones.
130
+ */
131
+ detectSourceFolder(fs) {
132
+ const baseDir = this.config.get('baseDir');
133
+ const defaultPath = './migrations';
134
+ if (!fs.pathExists(baseDir + '/src')) {
135
+ this.options.path ??= defaultPath;
136
+ return;
59
137
  }
60
- /**
61
- * @inheritDoc
62
- */
63
- async down(options) {
64
- return this.runMigrations('down', options);
138
+ const exists = fs.pathExists(`${baseDir}/${defaultPath}`);
139
+ const distDir = fs.pathExists(baseDir + '/dist');
140
+ const buildDir = fs.pathExists(baseDir + '/build');
141
+ // if neither `dist` nor `build` exist, we use the `src` folder as it might be a JS project without building, but with `src` folder
142
+ /* v8 ignore next */
143
+ const path = distDir ? './dist' : buildDir ? './build' : './src';
144
+ // only if the user did not provide any values and if the default path does not exist
145
+ if (!this.options.path && !this.options.pathTs && !exists) {
146
+ this.options.path = `${path}/migrations`;
147
+ this.options.pathTs = './src/migrations';
65
148
  }
66
- async init() {
67
- if (this.initialized) {
68
- return;
69
- }
70
- this.initialized = true;
71
- await this.initPaths();
149
+ }
150
+ registerDefaultListeners() {
151
+ /* v8 ignore else */
152
+ if (!this.options.silent) {
153
+ const logger = this.config.getLogger();
154
+ this.on('migrating', event => logger.log('migrator', `Processing '${event.name}'`, { enabled: true }));
155
+ this.on('migrated', event => logger.log('migrator', `Applied '${event.name}'`, { enabled: true }));
156
+ this.on('reverting', event => logger.log('migrator', `Processing '${event.name}'`, { enabled: true }));
157
+ this.on('reverted', event => logger.log('migrator', `Reverted '${event.name}'`, { enabled: true }));
72
158
  }
73
- async initPaths() {
74
- if (this.absolutePath || this.options.migrationsList) {
75
- return;
76
- }
77
- const { fs } = await import('@mikro-orm/core/fs-utils');
78
- this.detectSourceFolder(fs);
79
- /* v8 ignore next */
80
- const key = this.config.get('preferTs', Utils.detectTypeScriptSupport()) && this.options.pathTs ? 'pathTs' : 'path';
81
- this.absolutePath = fs.absolutePath(this.options[key], this.config.get('baseDir'));
82
- try {
83
- fs.ensureDir(this.absolutePath);
84
- }
85
- catch {
86
- // read-only filesystem — read-only operations (e.g. `getPending` with a
87
- // snapshot) may still succeed; write operations will fail on their own
88
- }
159
+ }
160
+ async emit(event, data) {
161
+ for (const listener of this.#listeners.get(event) ?? []) {
162
+ await listener(data);
89
163
  }
90
- initServices() {
91
- this.runner = this.createRunner();
92
- this.storage = this.createStorage();
93
- if (this.options.generator) {
94
- this.generator = new this.options.generator(this.driver, this.config.getNamingStrategy(), this.options);
95
- }
96
- else {
97
- this.generator = this.getDefaultGenerator();
164
+ }
165
+ async discoverMigrations() {
166
+ if (this.options.migrationsList) {
167
+ return this.options.migrationsList.map(migration => {
168
+ if (typeof migration === 'function') {
169
+ return this.initialize(migration, migration.name);
170
+ }
171
+ return this.initialize(migration.class, migration.name);
172
+ });
173
+ }
174
+ const { fs } = await import('@mikro-orm/core/fs-utils');
175
+ const pattern = fs.normalizePath(this.absolutePath, this.options.glob);
176
+ const files = fs.glob(pattern).sort();
177
+ return files.map(filePath =>
178
+ this.resolve({
179
+ name: filePath.replace(/\\/g, '/').split('/').pop(),
180
+ path: filePath,
181
+ }),
182
+ );
183
+ }
184
+ async executeMigrations(method, options = {}) {
185
+ const all = await this.discoverMigrations();
186
+ const executed = await this.storage.executed();
187
+ const executedSet = new Set(executed);
188
+ let toRun;
189
+ if (method === 'up') {
190
+ toRun = this.filterUp(all, executedSet, options);
191
+ } else {
192
+ toRun = this.filterDown(all, executed, options);
193
+ }
194
+ const result = [];
195
+ const eventBefore = method === 'up' ? 'migrating' : 'reverting';
196
+ const eventAfter = method === 'up' ? 'migrated' : 'reverted';
197
+ for (const migration of toRun) {
198
+ const event = { name: migration.name, path: migration.path };
199
+ await this.emit(eventBefore, event);
200
+ // log inside the runner's tx (if any) so a logMigration failure rolls the migration back
201
+ await migration[method](async tx => {
202
+ if (method === 'up') {
203
+ await this.storage.logMigration({ name: migration.name }, tx);
204
+ } else {
205
+ await this.storage.unlogMigration({ name: migration.name }, tx);
98
206
  }
207
+ });
208
+ await this.emit(eventAfter, event);
209
+ result.push(event);
99
210
  }
100
- resolve(params) {
101
- const createMigrationHandler = async (method, afterRun) => {
102
- const { fs } = await import('@mikro-orm/core/fs-utils');
103
- const migration = await fs.dynamicImport(params.path);
104
- const MigrationClass = Object.values(migration).find(cls => typeof cls === 'function' && typeof cls.constructor === 'function');
105
- const instance = new MigrationClass(this.driver, this.config);
106
- await this.runner.run(instance, method, afterRun);
107
- };
108
- return {
109
- name: this.storage.getMigrationName(params.name),
110
- path: params.path,
111
- up: afterRun => createMigrationHandler('up', afterRun),
112
- down: afterRun => createMigrationHandler('down', afterRun),
113
- };
211
+ return result;
212
+ }
213
+ filterUp(all, executed, options) {
214
+ let pending = all.filter(m => !executed.has(m.name));
215
+ if (options.migrations) {
216
+ const set = new Set(options.migrations);
217
+ return pending.filter(m => set.has(m.name));
114
218
  }
115
- initialize(MigrationClass, name) {
116
- const instance = new MigrationClass(this.driver, this.config);
117
- return {
118
- name: this.storage.getMigrationName(name),
119
- up: afterRun => this.runner.run(instance, 'up', afterRun),
120
- down: afterRun => this.runner.run(instance, 'down', afterRun),
121
- };
219
+ if (options.from) {
220
+ const idx = all.findIndex(m => m.name === options.from);
221
+ if (idx >= 0) {
222
+ const names = new Set(all.slice(idx + 1).map(m => m.name));
223
+ pending = pending.filter(m => names.has(m.name));
224
+ }
122
225
  }
123
- /**
124
- * Checks if `src` folder exists, it so, tries to adjust the migrations and seeders paths automatically to use it.
125
- * If there is a `dist` or `build` folder, it will be used for the JS variant (`path` option), while the `src` folder will be
126
- * used for the TS variant (`pathTs` option).
127
- *
128
- * If the default folder exists (e.g. `/migrations`), the config will respect that, so this auto-detection should not
129
- * break existing projects, only help with the new ones.
130
- */
131
- detectSourceFolder(fs) {
132
- const baseDir = this.config.get('baseDir');
133
- const defaultPath = './migrations';
134
- if (!fs.pathExists(baseDir + '/src')) {
135
- this.options.path ??= defaultPath;
136
- return;
137
- }
138
- const exists = fs.pathExists(`${baseDir}/${defaultPath}`);
139
- const distDir = fs.pathExists(baseDir + '/dist');
140
- const buildDir = fs.pathExists(baseDir + '/build');
141
- // if neither `dist` nor `build` exist, we use the `src` folder as it might be a JS project without building, but with `src` folder
142
- /* v8 ignore next */
143
- const path = distDir ? './dist' : buildDir ? './build' : './src';
144
- // only if the user did not provide any values and if the default path does not exist
145
- if (!this.options.path && !this.options.pathTs && !exists) {
146
- this.options.path = `${path}/migrations`;
147
- this.options.pathTs = './src/migrations';
148
- }
226
+ if (options.to && typeof options.to === 'string') {
227
+ const idx = all.findIndex(m => m.name === options.to);
228
+ if (idx >= 0) {
229
+ const names = new Set(all.slice(0, idx + 1).map(m => m.name));
230
+ pending = pending.filter(m => names.has(m.name));
231
+ }
149
232
  }
150
- registerDefaultListeners() {
151
- /* v8 ignore else */
152
- if (!this.options.silent) {
153
- const logger = this.config.getLogger();
154
- this.on('migrating', event => logger.log('migrator', `Processing '${event.name}'`, { enabled: true }));
155
- this.on('migrated', event => logger.log('migrator', `Applied '${event.name}'`, { enabled: true }));
156
- this.on('reverting', event => logger.log('migrator', `Processing '${event.name}'`, { enabled: true }));
157
- this.on('reverted', event => logger.log('migrator', `Reverted '${event.name}'`, { enabled: true }));
158
- }
233
+ return pending;
234
+ }
235
+ filterDown(all, executed, options) {
236
+ const migrationMap = new Map(all.map(m => [m.name, m]));
237
+ const executedReversed = [...executed].reverse();
238
+ if (options.migrations) {
239
+ const set = new Set(options.migrations);
240
+ return executedReversed
241
+ .filter(name => set.has(name))
242
+ .map(name => migrationMap.get(name))
243
+ .filter(Boolean);
159
244
  }
160
- async emit(event, data) {
161
- for (const listener of this.#listeners.get(event) ?? []) {
162
- await listener(data);
163
- }
245
+ if (options.to === 0) {
246
+ return executedReversed.map(name => migrationMap.get(name)).filter(Boolean);
164
247
  }
165
- async discoverMigrations() {
166
- if (this.options.migrationsList) {
167
- return this.options.migrationsList.map(migration => {
168
- if (typeof migration === 'function') {
169
- return this.initialize(migration, migration.name);
170
- }
171
- return this.initialize(migration.class, migration.name);
172
- });
173
- }
174
- const { fs } = await import('@mikro-orm/core/fs-utils');
175
- const pattern = fs.normalizePath(this.absolutePath, this.options.glob);
176
- const files = fs.glob(pattern).sort();
177
- return files.map(filePath => this.resolve({
178
- name: filePath.replace(/\\/g, '/').split('/').pop(),
179
- path: filePath,
180
- }));
248
+ if (options.to) {
249
+ const result = [];
250
+ for (const name of executedReversed) {
251
+ if (name === String(options.to)) {
252
+ break;
253
+ }
254
+ const m = migrationMap.get(name);
255
+ if (m) {
256
+ result.push(m);
257
+ }
258
+ }
259
+ return result;
181
260
  }
182
- async executeMigrations(method, options = {}) {
183
- const all = await this.discoverMigrations();
184
- const executed = await this.storage.executed();
185
- const executedSet = new Set(executed);
186
- let toRun;
187
- if (method === 'up') {
188
- toRun = this.filterUp(all, executedSet, options);
189
- }
190
- else {
191
- toRun = this.filterDown(all, executed, options);
192
- }
193
- const result = [];
194
- const eventBefore = method === 'up' ? 'migrating' : 'reverting';
195
- const eventAfter = method === 'up' ? 'migrated' : 'reverted';
196
- for (const migration of toRun) {
197
- const event = { name: migration.name, path: migration.path };
198
- await this.emit(eventBefore, event);
199
- // log inside the runner's tx (if any) so a logMigration failure rolls the migration back
200
- await migration[method](async (tx) => {
201
- if (method === 'up') {
202
- await this.storage.logMigration({ name: migration.name }, tx);
203
- }
204
- else {
205
- await this.storage.unlogMigration({ name: migration.name }, tx);
206
- }
207
- });
208
- await this.emit(eventAfter, event);
209
- result.push(event);
210
- }
211
- return result;
261
+ // Default: revert last 1
262
+ if (executedReversed.length > 0) {
263
+ const m = migrationMap.get(executedReversed[0]);
264
+ return m ? [m] : [];
212
265
  }
213
- filterUp(all, executed, options) {
214
- let pending = all.filter(m => !executed.has(m.name));
215
- if (options.migrations) {
216
- const set = new Set(options.migrations);
217
- return pending.filter(m => set.has(m.name));
218
- }
219
- if (options.from) {
220
- const idx = all.findIndex(m => m.name === options.from);
221
- if (idx >= 0) {
222
- const names = new Set(all.slice(idx + 1).map(m => m.name));
223
- pending = pending.filter(m => names.has(m.name));
224
- }
225
- }
226
- if (options.to && typeof options.to === 'string') {
227
- const idx = all.findIndex(m => m.name === options.to);
228
- if (idx >= 0) {
229
- const names = new Set(all.slice(0, idx + 1).map(m => m.name));
230
- pending = pending.filter(m => names.has(m.name));
231
- }
232
- }
233
- return pending;
266
+ return [];
267
+ }
268
+ getMigrationFilename(name) {
269
+ name = name.replace(/\.[jt]s$/, '');
270
+ return /^\d{14}$/.exec(name) ? this.options.fileName(name) : name;
271
+ }
272
+ prefix(options) {
273
+ if (typeof options === 'string' || Array.isArray(options)) {
274
+ return { migrations: Utils.asArray(options).map(name => this.getMigrationFilename(name)) };
234
275
  }
235
- filterDown(all, executed, options) {
236
- const migrationMap = new Map(all.map(m => [m.name, m]));
237
- const executedReversed = [...executed].reverse();
238
- if (options.migrations) {
239
- const set = new Set(options.migrations);
240
- return executedReversed
241
- .filter(name => set.has(name))
242
- .map(name => migrationMap.get(name))
243
- .filter(Boolean);
244
- }
245
- if (options.to === 0) {
246
- return executedReversed.map(name => migrationMap.get(name)).filter(Boolean);
247
- }
248
- if (options.to) {
249
- const result = [];
250
- for (const name of executedReversed) {
251
- if (name === String(options.to)) {
252
- break;
253
- }
254
- const m = migrationMap.get(name);
255
- if (m) {
256
- result.push(m);
257
- }
258
- }
259
- return result;
260
- }
261
- // Default: revert last 1
262
- if (executedReversed.length > 0) {
263
- const m = migrationMap.get(executedReversed[0]);
264
- return m ? [m] : [];
265
- }
266
- return [];
276
+ if (!options) {
277
+ return {};
267
278
  }
268
- getMigrationFilename(name) {
269
- name = name.replace(/\.[jt]s$/, '');
270
- return /^\d{14}$/.exec(name) ? this.options.fileName(name) : name;
279
+ const result = {};
280
+ if (options.migrations) {
281
+ result.migrations = options.migrations.map(name => this.getMigrationFilename(name));
271
282
  }
272
- prefix(options) {
273
- if (typeof options === 'string' || Array.isArray(options)) {
274
- return { migrations: Utils.asArray(options).map(name => this.getMigrationFilename(name)) };
275
- }
276
- if (!options) {
277
- return {};
278
- }
279
- const result = {};
280
- if (options.migrations) {
281
- result.migrations = options.migrations.map(name => this.getMigrationFilename(name));
282
- }
283
- if (options.from) {
284
- result.from = this.getMigrationFilename(String(options.from));
285
- }
286
- if (options.to && options.to !== 0) {
287
- result.to = this.getMigrationFilename(String(options.to));
288
- }
289
- else if (options.to === 0) {
290
- result.to = 0;
291
- }
292
- return result;
283
+ if (options.from) {
284
+ result.from = this.getMigrationFilename(String(options.from));
293
285
  }
294
- async runMigrations(method, options) {
295
- await this.init();
296
- if (!this.options.transactional || !this.options.allOrNothing) {
297
- return this.executeMigrations(method, this.prefix(options));
298
- }
299
- if (Utils.isObject(options) && options.transaction) {
300
- return this.runInTransaction(options.transaction, method, options);
301
- }
302
- return this.driver.getConnection().transactional(trx => this.runInTransaction(trx, method, options));
286
+ if (options.to && options.to !== 0) {
287
+ result.to = this.getMigrationFilename(String(options.to));
288
+ } else if (options.to === 0) {
289
+ result.to = 0;
303
290
  }
304
- async runInTransaction(trx, method, options) {
305
- this.runner.setMasterMigration(trx);
306
- this.storage.setMasterMigration(trx);
307
- try {
308
- return await this.executeMigrations(method, this.prefix(options));
309
- }
310
- finally {
311
- this.runner.unsetMasterMigration();
312
- this.storage.unsetMasterMigration();
313
- }
291
+ return result;
292
+ }
293
+ async runMigrations(method, options) {
294
+ await this.init();
295
+ if (!this.options.transactional || !this.options.allOrNothing) {
296
+ return this.executeMigrations(method, this.prefix(options));
297
+ }
298
+ if (Utils.isObject(options) && options.transaction) {
299
+ return this.runInTransaction(options.transaction, method, options);
300
+ }
301
+ return this.driver.getConnection().transactional(trx => this.runInTransaction(trx, method, options));
302
+ }
303
+ async runInTransaction(trx, method, options) {
304
+ this.runner.setMasterMigration(trx);
305
+ this.storage.setMasterMigration(trx);
306
+ try {
307
+ return await this.executeMigrations(method, this.prefix(options));
308
+ } finally {
309
+ this.runner.unsetMasterMigration();
310
+ this.storage.unsetMasterMigration();
314
311
  }
312
+ }
315
313
  }