@mikro-orm/core 7.0.4-dev.9 → 7.0.4

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 +884 -583
  2. package/EntityManager.js +1922 -1895
  3. package/MikroORM.d.ts +103 -74
  4. package/MikroORM.js +178 -179
  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 +440 -301
  20. package/entity/BaseEntity.d.ts +120 -83
  21. package/entity/BaseEntity.js +43 -43
  22. package/entity/Collection.d.ts +212 -179
  23. package/entity/Collection.js +727 -721
  24. package/entity/EntityAssigner.d.ts +88 -77
  25. package/entity/EntityAssigner.js +231 -230
  26. package/entity/EntityFactory.d.ts +66 -54
  27. package/entity/EntityFactory.js +425 -383
  28. package/entity/EntityHelper.d.ts +34 -22
  29. package/entity/EntityHelper.js +280 -267
  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 +753 -723
  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 +126 -82
  39. package/entity/Reference.js +278 -274
  40. package/entity/WrappedEntity.d.ts +115 -72
  41. package/entity/WrappedEntity.js +168 -166
  42. package/entity/defineEntity.d.ts +1315 -636
  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 +481 -416
  63. package/index.d.ts +116 -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 +211 -127
  74. package/metadata/EntitySchema.js +397 -398
  75. package/metadata/MetadataDiscovery.d.ts +114 -114
  76. package/metadata/MetadataDiscovery.js +1951 -1863
  77. package/metadata/MetadataProvider.d.ts +24 -21
  78. package/metadata/MetadataProvider.js +82 -84
  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 +381 -338
  83. package/metadata/discover-entities.d.ts +5 -2
  84. package/metadata/discover-entities.js +35 -27
  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 +310 -299
  100. package/platforms/Platform.js +663 -636
  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 +1250 -737
  160. package/typings.js +244 -231
  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 +178 -170
  165. package/unit-of-work/ChangeSetPersister.d.ts +63 -44
  166. package/unit-of-work/ChangeSetPersister.js +442 -421
  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 +1200 -1183
  173. package/utils/AbstractMigrator.d.ts +111 -91
  174. package/utils/AbstractMigrator.js +275 -275
  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 +98 -81
  186. package/utils/EntityComparator.js +828 -728
  187. package/utils/NullHighlighter.d.ts +1 -1
  188. package/utils/NullHighlighter.js +3 -3
  189. package/utils/QueryHelper.d.ts +79 -51
  190. package/utils/QueryHelper.js +372 -361
  191. package/utils/RawQueryFragment.d.ts +50 -34
  192. package/utils/RawQueryFragment.js +107 -105
  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 +199 -197
  199. package/utils/Utils.d.ts +204 -145
  200. package/utils/Utils.js +812 -810
  201. package/utils/clone.js +104 -113
  202. package/utils/env-vars.js +90 -88
  203. package/utils/fs-utils.d.ts +15 -15
  204. package/utils/fs-utils.js +180 -181
  205. package/utils/upsert-utils.d.ts +20 -5
  206. package/utils/upsert-utils.js +114 -116
@@ -3,8 +3,8 @@ import type { IPrimaryKey } from '../typings.js';
3
3
  * @internal
4
4
  */
5
5
  export declare class EntityIdentifier {
6
- private value?;
7
- constructor(value?: IPrimaryKey | undefined);
8
- setValue(value: IPrimaryKey): void;
9
- getValue<T extends IPrimaryKey = IPrimaryKey>(): T;
6
+ private value?;
7
+ constructor(value?: IPrimaryKey | undefined);
8
+ setValue(value: IPrimaryKey): void;
9
+ getValue<T extends IPrimaryKey = IPrimaryKey>(): T;
10
10
  }
@@ -2,14 +2,14 @@
2
2
  * @internal
3
3
  */
4
4
  export class EntityIdentifier {
5
- value;
6
- constructor(value) {
7
- this.value = value;
8
- }
9
- setValue(value) {
10
- this.value = value;
11
- }
12
- getValue() {
13
- return this.value;
14
- }
5
+ value;
6
+ constructor(value) {
7
+ this.value = value;
8
+ }
9
+ setValue(value) {
10
+ this.value = value;
11
+ }
12
+ getValue() {
13
+ return this.value;
14
+ }
15
15
  }
@@ -1,82 +1,108 @@
1
- import type { AnyEntity, AutoPath, ConnectionType, EntityName, EntityProperty, FilterQuery, PopulateOptions } from '../typings.js';
1
+ import type {
2
+ AnyEntity,
3
+ AutoPath,
4
+ ConnectionType,
5
+ EntityName,
6
+ EntityProperty,
7
+ FilterQuery,
8
+ PopulateOptions,
9
+ } from '../typings.js';
2
10
  import type { EntityManager } from '../EntityManager.js';
3
11
  import { LoadStrategy, type LockMode, type PopulateHint, PopulatePath, type QueryOrderMap } from '../enums.js';
4
12
  import type { FilterOptions } from '../drivers/IDatabaseDriver.js';
5
13
  import type { LoggingOptions } from '../logging/Logger.js';
6
14
  /** Options for controlling how relations are loaded by the EntityLoader. */
7
15
  export interface EntityLoaderOptions<Entity, Fields extends string = never, Excludes extends string = never> {
8
- /** Select specific fields to load (partial loading). */
9
- fields?: readonly AutoPath<Entity, Fields, `${PopulatePath.ALL}`>[];
10
- /** Fields to exclude from loading. */
11
- exclude?: readonly AutoPath<Entity, Excludes>[];
12
- /** Additional filtering conditions applied to populated relations. */
13
- where?: FilterQuery<Entity>;
14
- /** Controls how `where` conditions are applied to populated relations. */
15
- populateWhere?: PopulateHint | `${PopulateHint}`;
16
- /** Ordering for populated relations. */
17
- orderBy?: QueryOrderMap<Entity> | QueryOrderMap<Entity>[];
18
- /** Whether to reload already loaded entities. */
19
- refresh?: boolean;
20
- /** Whether to validate the populate hint against the entity metadata. */
21
- validate?: boolean;
22
- /** Whether to look up eager-loaded relationships automatically. */
23
- lookup?: boolean;
24
- /** Whether to convert custom types during hydration. */
25
- convertCustomTypes?: boolean;
26
- /** Whether to skip loading lazy scalar properties. */
27
- ignoreLazyScalarProperties?: boolean;
28
- /** Filter options to apply when loading relations. */
29
- filters?: FilterOptions;
30
- /** Loading strategy to use (select-in, joined, or balanced). */
31
- strategy?: LoadStrategy | `${LoadStrategy}`;
32
- /** Lock mode for the query (pessimistic locking). */
33
- lockMode?: Exclude<LockMode, LockMode.OPTIMISTIC>;
34
- /** Database schema override. */
35
- schema?: string;
36
- /** Connection type (read or write replica). */
37
- connectionType?: ConnectionType;
38
- /** Logging options for the query. */
39
- logging?: LoggingOptions;
16
+ /** Select specific fields to load (partial loading). */
17
+ fields?: readonly AutoPath<Entity, Fields, `${PopulatePath.ALL}`>[];
18
+ /** Fields to exclude from loading. */
19
+ exclude?: readonly AutoPath<Entity, Excludes>[];
20
+ /** Additional filtering conditions applied to populated relations. */
21
+ where?: FilterQuery<Entity>;
22
+ /** Controls how `where` conditions are applied to populated relations. */
23
+ populateWhere?: PopulateHint | `${PopulateHint}`;
24
+ /** Ordering for populated relations. */
25
+ orderBy?: QueryOrderMap<Entity> | QueryOrderMap<Entity>[];
26
+ /** Whether to reload already loaded entities. */
27
+ refresh?: boolean;
28
+ /** Whether to validate the populate hint against the entity metadata. */
29
+ validate?: boolean;
30
+ /** Whether to look up eager-loaded relationships automatically. */
31
+ lookup?: boolean;
32
+ /** Whether to convert custom types during hydration. */
33
+ convertCustomTypes?: boolean;
34
+ /** Whether to skip loading lazy scalar properties. */
35
+ ignoreLazyScalarProperties?: boolean;
36
+ /** Filter options to apply when loading relations. */
37
+ filters?: FilterOptions;
38
+ /** Loading strategy to use (select-in, joined, or balanced). */
39
+ strategy?: LoadStrategy | `${LoadStrategy}`;
40
+ /** Lock mode for the query (pessimistic locking). */
41
+ lockMode?: Exclude<LockMode, LockMode.OPTIMISTIC>;
42
+ /** Database schema override. */
43
+ schema?: string;
44
+ /** Connection type (read or write replica). */
45
+ connectionType?: ConnectionType;
46
+ /** Logging options for the query. */
47
+ logging?: LoggingOptions;
40
48
  }
41
49
  /** Responsible for batch-loading entity relations using either select-in or joined loading strategies. */
42
50
  export declare class EntityLoader {
43
- #private;
44
- constructor(em: EntityManager);
45
- /**
46
- * Loads specified relations in batch.
47
- * This will execute one query for each relation, that will populate it on all the specified entities.
48
- */
49
- populate<Entity extends object, Fields extends string = never>(entityName: EntityName<Entity>, entities: Entity[], populate: PopulateOptions<Entity>[] | boolean, options: EntityLoaderOptions<Entity, Fields>): Promise<void>;
50
- /** Normalizes populate hints into a structured array of PopulateOptions, expanding dot paths and eager relations. */
51
- normalizePopulate<Entity>(entityName: EntityName<Entity>, populate: (PopulateOptions<Entity> | boolean)[] | PopulateOptions<Entity> | boolean, strategy?: LoadStrategy, lookup?: boolean, exclude?: string[]): PopulateOptions<Entity>[];
52
- private setSerializationContext;
53
- /**
54
- * Merge multiple populates for the same entity with different children. Also skips `*` fields, those can come from
55
- * partial loading hints (`fields`) that are used to infer the `populate` hint if missing.
56
- */
57
- private mergeNestedPopulate;
58
- /**
59
- * preload everything in one call (this will update already existing references in IM)
60
- */
61
- private populateMany;
62
- private populateScalar;
63
- private populatePolymorphic;
64
- private initializeCollections;
65
- private initializeOneToMany;
66
- private initializeManyToMany;
67
- private findChildren;
68
- private mergePrimaryCondition;
69
- private populateField;
70
- /** @internal */
71
- findChildrenFromPivotTable<Entity extends object>(filtered: Entity[], prop: EntityProperty<Entity>, options: Required<EntityLoaderOptions<Entity>>, orderBy?: QueryOrderMap<Entity>[], populate?: PopulateOptions<Entity>, pivotJoin?: boolean): Promise<AnyEntity[][]>;
72
- private extractChildCondition;
73
- private buildFields;
74
- private getChildReferences;
75
- private filterCollections;
76
- private isPropertyLoaded;
77
- private filterReferences;
78
- private filterByReferences;
79
- private lookupAllRelationships;
80
- private getRelationName;
81
- private lookupEagerLoadedRelationships;
51
+ #private;
52
+ constructor(em: EntityManager);
53
+ /**
54
+ * Loads specified relations in batch.
55
+ * This will execute one query for each relation, that will populate it on all the specified entities.
56
+ */
57
+ populate<Entity extends object, Fields extends string = never>(
58
+ entityName: EntityName<Entity>,
59
+ entities: Entity[],
60
+ populate: PopulateOptions<Entity>[] | boolean,
61
+ options: EntityLoaderOptions<Entity, Fields>,
62
+ ): Promise<void>;
63
+ /** Normalizes populate hints into a structured array of PopulateOptions, expanding dot paths and eager relations. */
64
+ normalizePopulate<Entity>(
65
+ entityName: EntityName<Entity>,
66
+ populate: (PopulateOptions<Entity> | boolean)[] | PopulateOptions<Entity> | boolean,
67
+ strategy?: LoadStrategy,
68
+ lookup?: boolean,
69
+ exclude?: string[],
70
+ ): PopulateOptions<Entity>[];
71
+ private setSerializationContext;
72
+ /**
73
+ * Merge multiple populates for the same entity with different children. Also skips `*` fields, those can come from
74
+ * partial loading hints (`fields`) that are used to infer the `populate` hint if missing.
75
+ */
76
+ private mergeNestedPopulate;
77
+ /**
78
+ * preload everything in one call (this will update already existing references in IM)
79
+ */
80
+ private populateMany;
81
+ private populateScalar;
82
+ private populatePolymorphic;
83
+ private initializeCollections;
84
+ private initializeOneToMany;
85
+ private initializeManyToMany;
86
+ private findChildren;
87
+ private mergePrimaryCondition;
88
+ private populateField;
89
+ /** @internal */
90
+ findChildrenFromPivotTable<Entity extends object>(
91
+ filtered: Entity[],
92
+ prop: EntityProperty<Entity>,
93
+ options: Required<EntityLoaderOptions<Entity>>,
94
+ orderBy?: QueryOrderMap<Entity>[],
95
+ populate?: PopulateOptions<Entity>,
96
+ pivotJoin?: boolean,
97
+ ): Promise<AnyEntity[][]>;
98
+ private extractChildCondition;
99
+ private buildFields;
100
+ private getChildReferences;
101
+ private filterCollections;
102
+ private isPropertyLoaded;
103
+ private filterReferences;
104
+ private filterByReferences;
105
+ private lookupAllRelationships;
106
+ private getRelationName;
107
+ private lookupEagerLoadedRelationships;
82
108
  }