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

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 (207) hide show
  1. package/EntityManager.d.ts +883 -579
  2. package/EntityManager.js +1897 -1865
  3. package/MikroORM.d.ts +103 -72
  4. package/MikroORM.js +178 -177
  5. package/README.md +128 -294
  6. package/cache/CacheAdapter.d.ts +38 -36
  7. package/cache/FileCacheAdapter.d.ts +30 -24
  8. package/cache/FileCacheAdapter.js +80 -78
  9. package/cache/GeneratedCacheAdapter.d.ts +19 -20
  10. package/cache/GeneratedCacheAdapter.js +31 -30
  11. package/cache/MemoryCacheAdapter.d.ts +19 -20
  12. package/cache/MemoryCacheAdapter.js +36 -36
  13. package/cache/NullCacheAdapter.d.ts +17 -16
  14. package/cache/NullCacheAdapter.js +25 -24
  15. package/connections/Connection.d.ts +99 -75
  16. package/connections/Connection.js +166 -160
  17. package/drivers/DatabaseDriver.d.ts +187 -69
  18. package/drivers/DatabaseDriver.js +451 -432
  19. package/drivers/IDatabaseDriver.d.ts +464 -281
  20. package/drivers/IDatabaseDriver.js +1 -0
  21. package/entity/BaseEntity.d.ts +121 -73
  22. package/entity/BaseEntity.js +44 -33
  23. package/entity/Collection.d.ts +216 -157
  24. package/entity/Collection.js +728 -707
  25. package/entity/EntityAssigner.d.ts +90 -76
  26. package/entity/EntityAssigner.js +232 -229
  27. package/entity/EntityFactory.d.ts +68 -40
  28. package/entity/EntityFactory.js +427 -366
  29. package/entity/EntityHelper.d.ts +34 -22
  30. package/entity/EntityHelper.js +280 -267
  31. package/entity/EntityIdentifier.d.ts +4 -4
  32. package/entity/EntityIdentifier.js +10 -10
  33. package/entity/EntityLoader.d.ts +105 -56
  34. package/entity/EntityLoader.js +754 -722
  35. package/entity/EntityRepository.d.ts +317 -200
  36. package/entity/EntityRepository.js +214 -212
  37. package/entity/PolymorphicRef.d.ts +5 -5
  38. package/entity/PolymorphicRef.js +10 -10
  39. package/entity/Reference.d.ts +130 -66
  40. package/entity/Reference.js +280 -260
  41. package/entity/WrappedEntity.d.ts +116 -53
  42. package/entity/WrappedEntity.js +169 -147
  43. package/entity/defineEntity.d.ts +1290 -614
  44. package/entity/defineEntity.js +521 -511
  45. package/entity/utils.d.ts +13 -3
  46. package/entity/utils.js +71 -73
  47. package/entity/validators.js +43 -43
  48. package/entity/wrap.js +8 -8
  49. package/enums.d.ts +275 -138
  50. package/enums.js +268 -137
  51. package/errors.d.ts +120 -72
  52. package/errors.js +356 -253
  53. package/events/EventManager.d.ts +27 -10
  54. package/events/EventManager.js +80 -73
  55. package/events/EventSubscriber.d.ts +33 -29
  56. package/events/TransactionEventBroadcaster.d.ts +16 -7
  57. package/events/TransactionEventBroadcaster.js +15 -13
  58. package/exceptions.d.ts +23 -40
  59. package/exceptions.js +35 -52
  60. package/hydration/Hydrator.d.ts +43 -16
  61. package/hydration/Hydrator.js +44 -42
  62. package/hydration/ObjectHydrator.d.ts +51 -17
  63. package/hydration/ObjectHydrator.js +480 -416
  64. package/index.d.ts +116 -2
  65. package/index.js +10 -1
  66. package/logging/DefaultLogger.d.ts +35 -30
  67. package/logging/DefaultLogger.js +87 -84
  68. package/logging/Logger.d.ts +45 -40
  69. package/logging/SimpleLogger.d.ts +13 -11
  70. package/logging/SimpleLogger.js +22 -22
  71. package/logging/colors.d.ts +6 -6
  72. package/logging/colors.js +11 -10
  73. package/logging/inspect.js +7 -7
  74. package/metadata/EntitySchema.d.ts +214 -108
  75. package/metadata/EntitySchema.js +398 -379
  76. package/metadata/MetadataDiscovery.d.ts +115 -111
  77. package/metadata/MetadataDiscovery.js +1948 -1857
  78. package/metadata/MetadataProvider.d.ts +25 -14
  79. package/metadata/MetadataProvider.js +83 -77
  80. package/metadata/MetadataStorage.d.ts +39 -19
  81. package/metadata/MetadataStorage.js +119 -106
  82. package/metadata/MetadataValidator.d.ts +39 -39
  83. package/metadata/MetadataValidator.js +381 -338
  84. package/metadata/discover-entities.d.ts +5 -2
  85. package/metadata/discover-entities.js +27 -27
  86. package/metadata/types.d.ts +615 -531
  87. package/naming-strategy/AbstractNamingStrategy.d.ts +55 -39
  88. package/naming-strategy/AbstractNamingStrategy.js +91 -85
  89. package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
  90. package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
  91. package/naming-strategy/MongoNamingStrategy.d.ts +7 -6
  92. package/naming-strategy/MongoNamingStrategy.js +19 -18
  93. package/naming-strategy/NamingStrategy.d.ts +109 -99
  94. package/naming-strategy/UnderscoreNamingStrategy.d.ts +8 -7
  95. package/naming-strategy/UnderscoreNamingStrategy.js +22 -21
  96. package/not-supported.js +7 -4
  97. package/package.json +1 -1
  98. package/platforms/ExceptionConverter.d.ts +2 -1
  99. package/platforms/ExceptionConverter.js +5 -4
  100. package/platforms/Platform.d.ts +310 -236
  101. package/platforms/Platform.js +661 -573
  102. package/serialization/EntitySerializer.d.ts +49 -25
  103. package/serialization/EntitySerializer.js +224 -216
  104. package/serialization/EntityTransformer.d.ts +11 -5
  105. package/serialization/EntityTransformer.js +220 -216
  106. package/serialization/SerializationContext.d.ts +27 -18
  107. package/serialization/SerializationContext.js +105 -100
  108. package/types/ArrayType.d.ts +9 -8
  109. package/types/ArrayType.js +34 -33
  110. package/types/BigIntType.d.ts +17 -10
  111. package/types/BigIntType.js +37 -37
  112. package/types/BlobType.d.ts +4 -3
  113. package/types/BlobType.js +14 -13
  114. package/types/BooleanType.d.ts +5 -4
  115. package/types/BooleanType.js +13 -12
  116. package/types/CharacterType.d.ts +3 -2
  117. package/types/CharacterType.js +7 -6
  118. package/types/DateTimeType.d.ts +6 -5
  119. package/types/DateTimeType.js +16 -15
  120. package/types/DateType.d.ts +6 -5
  121. package/types/DateType.js +16 -15
  122. package/types/DecimalType.d.ts +7 -7
  123. package/types/DecimalType.js +26 -26
  124. package/types/DoubleType.d.ts +3 -3
  125. package/types/DoubleType.js +12 -12
  126. package/types/EnumArrayType.d.ts +6 -5
  127. package/types/EnumArrayType.js +25 -24
  128. package/types/EnumType.d.ts +4 -3
  129. package/types/EnumType.js +12 -11
  130. package/types/FloatType.d.ts +4 -3
  131. package/types/FloatType.js +10 -9
  132. package/types/IntegerType.d.ts +4 -3
  133. package/types/IntegerType.js +10 -9
  134. package/types/IntervalType.d.ts +5 -4
  135. package/types/IntervalType.js +13 -12
  136. package/types/JsonType.d.ts +9 -8
  137. package/types/JsonType.js +33 -32
  138. package/types/MediumIntType.d.ts +2 -1
  139. package/types/MediumIntType.js +4 -3
  140. package/types/SmallIntType.d.ts +4 -3
  141. package/types/SmallIntType.js +10 -9
  142. package/types/StringType.d.ts +5 -4
  143. package/types/StringType.js +13 -12
  144. package/types/TextType.d.ts +4 -3
  145. package/types/TextType.js +10 -9
  146. package/types/TimeType.d.ts +6 -5
  147. package/types/TimeType.js +18 -17
  148. package/types/TinyIntType.d.ts +4 -3
  149. package/types/TinyIntType.js +11 -10
  150. package/types/Type.d.ts +88 -73
  151. package/types/Type.js +85 -74
  152. package/types/Uint8ArrayType.d.ts +5 -4
  153. package/types/Uint8ArrayType.js +22 -21
  154. package/types/UnknownType.d.ts +5 -4
  155. package/types/UnknownType.js +13 -12
  156. package/types/UuidType.d.ts +6 -5
  157. package/types/UuidType.js +20 -19
  158. package/types/index.d.ts +77 -49
  159. package/types/index.js +64 -26
  160. package/typings.d.ts +1388 -729
  161. package/typings.js +255 -231
  162. package/unit-of-work/ChangeSet.d.ts +28 -24
  163. package/unit-of-work/ChangeSet.js +58 -54
  164. package/unit-of-work/ChangeSetComputer.d.ts +13 -11
  165. package/unit-of-work/ChangeSetComputer.js +180 -159
  166. package/unit-of-work/ChangeSetPersister.d.ts +64 -41
  167. package/unit-of-work/ChangeSetPersister.js +443 -418
  168. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  169. package/unit-of-work/CommitOrderCalculator.js +89 -88
  170. package/unit-of-work/IdentityMap.d.ts +32 -25
  171. package/unit-of-work/IdentityMap.js +106 -99
  172. package/unit-of-work/UnitOfWork.d.ts +182 -127
  173. package/unit-of-work/UnitOfWork.js +1201 -1169
  174. package/utils/AbstractMigrator.d.ts +111 -91
  175. package/utils/AbstractMigrator.js +275 -275
  176. package/utils/AbstractSchemaGenerator.d.ts +43 -34
  177. package/utils/AbstractSchemaGenerator.js +121 -122
  178. package/utils/AsyncContext.d.ts +3 -3
  179. package/utils/AsyncContext.js +34 -35
  180. package/utils/Configuration.d.ts +853 -801
  181. package/utils/Configuration.js +360 -337
  182. package/utils/Cursor.d.ts +40 -22
  183. package/utils/Cursor.js +135 -127
  184. package/utils/DataloaderUtils.d.ts +58 -43
  185. package/utils/DataloaderUtils.js +203 -198
  186. package/utils/EntityComparator.d.ts +99 -80
  187. package/utils/EntityComparator.js +825 -727
  188. package/utils/NullHighlighter.d.ts +2 -1
  189. package/utils/NullHighlighter.js +4 -3
  190. package/utils/QueryHelper.d.ts +79 -51
  191. package/utils/QueryHelper.js +372 -361
  192. package/utils/RawQueryFragment.d.ts +54 -28
  193. package/utils/RawQueryFragment.js +110 -99
  194. package/utils/RequestContext.d.ts +33 -32
  195. package/utils/RequestContext.js +52 -53
  196. package/utils/TransactionContext.d.ts +17 -16
  197. package/utils/TransactionContext.js +28 -27
  198. package/utils/TransactionManager.d.ts +58 -58
  199. package/utils/TransactionManager.js +199 -197
  200. package/utils/Utils.d.ts +210 -145
  201. package/utils/Utils.js +820 -813
  202. package/utils/clone.js +104 -113
  203. package/utils/env-vars.js +90 -88
  204. package/utils/fs-utils.d.ts +15 -15
  205. package/utils/fs-utils.js +180 -181
  206. package/utils/upsert-utils.d.ts +20 -5
  207. package/utils/upsert-utils.js +114 -116
@@ -1,101 +1,121 @@
1
- import type { Constructor, IMigrationGenerator, IMigrationRunner, IMigrator, IMigratorStorage, MaybePromise, Migration, MigrationInfo, MigrationRow, MigratorEvent } from '../typings.js';
1
+ import type {
2
+ Constructor,
3
+ IMigrationGenerator,
4
+ IMigrationRunner,
5
+ IMigrator,
6
+ IMigratorStorage,
7
+ MaybePromise,
8
+ Migration,
9
+ MigrationInfo,
10
+ MigrationRow,
11
+ MigratorEvent,
12
+ } from '../typings.js';
2
13
  import type { Transaction } from '../connections/Connection.js';
3
14
  import type { Configuration, MigrationsOptions } from './Configuration.js';
4
15
  import type { EntityManagerType, IDatabaseDriver } from '../drivers/IDatabaseDriver.js';
5
16
  interface RunnableMigration {
6
- name: string;
7
- path?: string;
8
- up: () => MaybePromise<void>;
9
- down: () => MaybePromise<void>;
17
+ name: string;
18
+ path?: string;
19
+ up: () => MaybePromise<void>;
20
+ down: () => MaybePromise<void>;
10
21
  }
11
22
  type MigrateOptions = {
12
- from?: string | number;
13
- to?: string | number;
14
- migrations?: string[];
15
- transaction?: Transaction;
23
+ from?: string | number;
24
+ to?: string | number;
25
+ migrations?: string[];
26
+ transaction?: Transaction;
16
27
  };
17
28
  export declare abstract class AbstractMigrator<D extends IDatabaseDriver> implements IMigrator {
18
- #private;
19
- protected readonly em: D[typeof EntityManagerType];
20
- protected runner: IMigrationRunner;
21
- protected storage: IMigratorStorage;
22
- protected generator: IMigrationGenerator;
23
- protected readonly driver: D;
24
- protected readonly config: Configuration;
25
- protected readonly options: MigrationsOptions;
26
- protected absolutePath: string;
27
- protected initialized: boolean;
28
- constructor(em: D[typeof EntityManagerType]);
29
- protected abstract createRunner(): IMigrationRunner;
30
- protected abstract createStorage(): IMigratorStorage;
31
- protected abstract getDefaultGenerator(): IMigrationGenerator;
32
- abstract create(path?: string, blank?: boolean, initial?: boolean, name?: string): Promise<{
33
- fileName: string;
34
- code: string;
35
- diff: {
36
- up: string[];
37
- down: string[];
38
- };
39
- }>;
40
- abstract checkSchema(): Promise<boolean>;
41
- abstract createInitial(path?: string, name?: string, blank?: boolean): Promise<{
42
- fileName: string;
43
- code: string;
44
- diff: {
45
- up: string[];
46
- down: string[];
47
- };
48
- }>;
49
- /**
50
- * @inheritDoc
51
- */
52
- on(eventName: MigratorEvent, listener: (event: MigrationInfo) => MaybePromise<void>): this;
53
- /**
54
- * @inheritDoc
55
- */
56
- off(eventName: MigratorEvent, listener: (event: MigrationInfo) => MaybePromise<void>): this;
57
- /**
58
- * @inheritDoc
59
- */
60
- getExecuted(): Promise<MigrationRow[]>;
61
- /**
62
- * @inheritDoc
63
- */
64
- getPending(): Promise<MigrationInfo[]>;
65
- /**
66
- * @inheritDoc
67
- */
68
- up(options?: string | string[] | MigrateOptions): Promise<MigrationInfo[]>;
69
- /**
70
- * @inheritDoc
71
- */
72
- down(options?: string | string[] | Omit<MigrateOptions, 'from'>): Promise<MigrationInfo[]>;
73
- abstract getStorage(): IMigratorStorage;
74
- protected init(): Promise<void>;
75
- protected initServices(): void;
76
- protected resolve(params: {
77
- name: string;
78
- path: string;
79
- }): RunnableMigration;
80
- protected initialize(MigrationClass: Constructor<Migration>, name: string): RunnableMigration;
81
- /**
82
- * Checks if `src` folder exists, it so, tries to adjust the migrations and seeders paths automatically to use it.
83
- * If there is a `dist` or `build` folder, it will be used for the JS variant (`path` option), while the `src` folder will be
84
- * used for the TS variant (`pathTs` option).
85
- *
86
- * If the default folder exists (e.g. `/migrations`), the config will respect that, so this auto-detection should not
87
- * break existing projects, only help with the new ones.
88
- */
89
- private detectSourceFolder;
90
- private registerDefaultListeners;
91
- private emit;
92
- private discoverMigrations;
93
- private executeMigrations;
94
- private filterUp;
95
- private filterDown;
96
- private getMigrationFilename;
97
- private prefix;
98
- protected runMigrations(method: 'up' | 'down', options?: string | string[] | MigrateOptions): Promise<MigrationInfo[]>;
99
- private runInTransaction;
29
+ #private;
30
+ protected readonly em: D[typeof EntityManagerType];
31
+ protected runner: IMigrationRunner;
32
+ protected storage: IMigratorStorage;
33
+ protected generator: IMigrationGenerator;
34
+ protected readonly driver: D;
35
+ protected readonly config: Configuration;
36
+ protected readonly options: MigrationsOptions;
37
+ protected absolutePath: string;
38
+ protected initialized: boolean;
39
+ constructor(em: D[typeof EntityManagerType]);
40
+ protected abstract createRunner(): IMigrationRunner;
41
+ protected abstract createStorage(): IMigratorStorage;
42
+ protected abstract getDefaultGenerator(): IMigrationGenerator;
43
+ abstract create(
44
+ path?: string,
45
+ blank?: boolean,
46
+ initial?: boolean,
47
+ name?: string,
48
+ ): Promise<{
49
+ fileName: string;
50
+ code: string;
51
+ diff: {
52
+ up: string[];
53
+ down: string[];
54
+ };
55
+ }>;
56
+ abstract checkSchema(): Promise<boolean>;
57
+ abstract createInitial(
58
+ path?: string,
59
+ name?: string,
60
+ blank?: boolean,
61
+ ): Promise<{
62
+ fileName: string;
63
+ code: string;
64
+ diff: {
65
+ up: string[];
66
+ down: string[];
67
+ };
68
+ }>;
69
+ /**
70
+ * @inheritDoc
71
+ */
72
+ on(eventName: MigratorEvent, listener: (event: MigrationInfo) => MaybePromise<void>): this;
73
+ /**
74
+ * @inheritDoc
75
+ */
76
+ off(eventName: MigratorEvent, listener: (event: MigrationInfo) => MaybePromise<void>): this;
77
+ /**
78
+ * @inheritDoc
79
+ */
80
+ getExecuted(): Promise<MigrationRow[]>;
81
+ /**
82
+ * @inheritDoc
83
+ */
84
+ getPending(): Promise<MigrationInfo[]>;
85
+ /**
86
+ * @inheritDoc
87
+ */
88
+ up(options?: string | string[] | MigrateOptions): Promise<MigrationInfo[]>;
89
+ /**
90
+ * @inheritDoc
91
+ */
92
+ down(options?: string | string[] | Omit<MigrateOptions, 'from'>): Promise<MigrationInfo[]>;
93
+ abstract getStorage(): IMigratorStorage;
94
+ protected init(): Promise<void>;
95
+ protected initServices(): void;
96
+ protected resolve(params: { name: string; path: string }): RunnableMigration;
97
+ protected initialize(MigrationClass: Constructor<Migration>, name: string): RunnableMigration;
98
+ /**
99
+ * Checks if `src` folder exists, it so, tries to adjust the migrations and seeders paths automatically to use it.
100
+ * If there is a `dist` or `build` folder, it will be used for the JS variant (`path` option), while the `src` folder will be
101
+ * used for the TS variant (`pathTs` option).
102
+ *
103
+ * If the default folder exists (e.g. `/migrations`), the config will respect that, so this auto-detection should not
104
+ * break existing projects, only help with the new ones.
105
+ */
106
+ private detectSourceFolder;
107
+ private registerDefaultListeners;
108
+ private emit;
109
+ private discoverMigrations;
110
+ private executeMigrations;
111
+ private filterUp;
112
+ private filterDown;
113
+ private getMigrationFilename;
114
+ private prefix;
115
+ protected runMigrations(
116
+ method: 'up' | 'down',
117
+ options?: string | string[] | MigrateOptions,
118
+ ): Promise<MigrationInfo[]>;
119
+ private runInTransaction;
100
120
  }
101
121
  export {};