@mikro-orm/core 7.0.4 → 7.0.5-dev.0

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 +583 -884
  2. package/EntityManager.js +1895 -1922
  3. package/MikroORM.d.ts +74 -103
  4. package/MikroORM.js +179 -178
  5. package/README.md +1 -1
  6. package/cache/CacheAdapter.d.ts +36 -36
  7. package/cache/FileCacheAdapter.d.ts +24 -30
  8. package/cache/FileCacheAdapter.js +78 -80
  9. package/cache/GeneratedCacheAdapter.d.ts +20 -18
  10. package/cache/GeneratedCacheAdapter.js +30 -30
  11. package/cache/MemoryCacheAdapter.d.ts +20 -18
  12. package/cache/MemoryCacheAdapter.js +36 -35
  13. package/cache/NullCacheAdapter.d.ts +16 -16
  14. package/cache/NullCacheAdapter.js +24 -24
  15. package/connections/Connection.d.ts +84 -95
  16. package/connections/Connection.js +168 -165
  17. package/drivers/DatabaseDriver.d.ts +80 -186
  18. package/drivers/DatabaseDriver.js +443 -450
  19. package/drivers/IDatabaseDriver.d.ts +301 -440
  20. package/entity/BaseEntity.d.ts +83 -120
  21. package/entity/BaseEntity.js +43 -43
  22. package/entity/Collection.d.ts +179 -212
  23. package/entity/Collection.js +721 -727
  24. package/entity/EntityAssigner.d.ts +77 -88
  25. package/entity/EntityAssigner.js +230 -231
  26. package/entity/EntityFactory.d.ts +54 -66
  27. package/entity/EntityFactory.js +383 -425
  28. package/entity/EntityHelper.d.ts +22 -34
  29. package/entity/EntityHelper.js +267 -280
  30. package/entity/EntityIdentifier.d.ts +4 -4
  31. package/entity/EntityIdentifier.js +10 -10
  32. package/entity/EntityLoader.d.ts +72 -98
  33. package/entity/EntityLoader.js +723 -753
  34. package/entity/EntityRepository.d.ts +201 -316
  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 +82 -126
  39. package/entity/Reference.js +274 -278
  40. package/entity/WrappedEntity.d.ts +72 -115
  41. package/entity/WrappedEntity.js +166 -168
  42. package/entity/defineEntity.d.ts +636 -1315
  43. package/entity/defineEntity.js +518 -527
  44. package/entity/utils.d.ts +3 -13
  45. package/entity/utils.js +73 -71
  46. package/entity/validators.js +43 -43
  47. package/entity/wrap.js +8 -8
  48. package/enums.d.ts +253 -258
  49. package/enums.js +252 -251
  50. package/errors.d.ts +72 -114
  51. package/errors.js +253 -350
  52. package/events/EventManager.d.ts +14 -26
  53. package/events/EventManager.js +77 -79
  54. package/events/EventSubscriber.d.ts +29 -29
  55. package/events/TransactionEventBroadcaster.d.ts +8 -15
  56. package/events/TransactionEventBroadcaster.js +14 -14
  57. package/exceptions.d.ts +40 -23
  58. package/exceptions.js +52 -35
  59. package/hydration/Hydrator.d.ts +17 -42
  60. package/hydration/Hydrator.js +43 -43
  61. package/hydration/ObjectHydrator.d.ts +17 -50
  62. package/hydration/ObjectHydrator.js +416 -481
  63. package/index.d.ts +2 -116
  64. package/index.js +1 -10
  65. package/logging/DefaultLogger.d.ts +32 -34
  66. package/logging/DefaultLogger.js +86 -86
  67. package/logging/Logger.d.ts +41 -41
  68. package/logging/SimpleLogger.d.ts +11 -13
  69. package/logging/SimpleLogger.js +22 -22
  70. package/logging/colors.d.ts +6 -6
  71. package/logging/colors.js +10 -11
  72. package/logging/inspect.js +7 -7
  73. package/metadata/EntitySchema.d.ts +127 -211
  74. package/metadata/EntitySchema.js +398 -397
  75. package/metadata/MetadataDiscovery.d.ts +114 -114
  76. package/metadata/MetadataDiscovery.js +1870 -1951
  77. package/metadata/MetadataProvider.d.ts +21 -24
  78. package/metadata/MetadataProvider.js +84 -82
  79. package/metadata/MetadataStorage.d.ts +32 -38
  80. package/metadata/MetadataStorage.js +118 -118
  81. package/metadata/MetadataValidator.d.ts +39 -39
  82. package/metadata/MetadataValidator.js +338 -381
  83. package/metadata/discover-entities.d.ts +2 -5
  84. package/metadata/discover-entities.js +37 -35
  85. package/metadata/types.d.ts +531 -615
  86. package/naming-strategy/AbstractNamingStrategy.d.ts +39 -54
  87. package/naming-strategy/AbstractNamingStrategy.js +85 -90
  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 +99 -109
  93. package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
  94. package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
  95. package/not-supported.js +4 -7
  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 +301 -310
  100. package/platforms/Platform.js +640 -663
  101. package/serialization/EntitySerializer.d.ts +26 -49
  102. package/serialization/EntitySerializer.js +218 -224
  103. package/serialization/EntityTransformer.d.ts +6 -10
  104. package/serialization/EntityTransformer.js +217 -219
  105. package/serialization/SerializationContext.d.ts +23 -27
  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 +10 -17
  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 +79 -83
  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 +49 -75
  158. package/types/index.js +26 -52
  159. package/typings.d.ts +737 -1250
  160. package/typings.js +231 -244
  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 +170 -178
  165. package/unit-of-work/ChangeSetPersister.d.ts +44 -63
  166. package/unit-of-work/ChangeSetPersister.js +421 -442
  167. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  168. package/unit-of-work/CommitOrderCalculator.js +88 -89
  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 +141 -181
  172. package/unit-of-work/UnitOfWork.js +1183 -1200
  173. package/utils/AbstractMigrator.d.ts +91 -111
  174. package/utils/AbstractMigrator.js +275 -275
  175. package/utils/AbstractSchemaGenerator.d.ts +34 -43
  176. package/utils/AbstractSchemaGenerator.js +122 -121
  177. package/utils/AsyncContext.d.ts +3 -3
  178. package/utils/AsyncContext.js +35 -34
  179. package/utils/Configuration.d.ts +808 -852
  180. package/utils/Configuration.js +344 -359
  181. package/utils/Cursor.d.ts +22 -40
  182. package/utils/Cursor.js +127 -135
  183. package/utils/DataloaderUtils.d.ts +43 -58
  184. package/utils/DataloaderUtils.js +198 -203
  185. package/utils/EntityComparator.d.ts +81 -98
  186. package/utils/EntityComparator.js +732 -828
  187. package/utils/NullHighlighter.d.ts +1 -1
  188. package/utils/NullHighlighter.js +3 -3
  189. package/utils/QueryHelper.d.ts +51 -79
  190. package/utils/QueryHelper.js +361 -372
  191. package/utils/RawQueryFragment.d.ts +34 -50
  192. package/utils/RawQueryFragment.js +105 -107
  193. package/utils/RequestContext.d.ts +32 -32
  194. package/utils/RequestContext.js +53 -52
  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 +197 -199
  199. package/utils/Utils.d.ts +145 -204
  200. package/utils/Utils.js +812 -812
  201. package/utils/clone.js +113 -104
  202. package/utils/env-vars.js +88 -90
  203. package/utils/fs-utils.d.ts +15 -15
  204. package/utils/fs-utils.js +181 -180
  205. package/utils/upsert-utils.d.ts +5 -20
  206. package/utils/upsert-utils.js +116 -114
@@ -5,118 +5,118 @@ import { EntitySchema } from './EntitySchema.js';
5
5
  import type { Platform } from '../platforms/Platform.js';
6
6
  /** Discovers, validates, and processes entity metadata from configured sources. */
7
7
  export declare class MetadataDiscovery {
8
- #private;
9
- constructor(metadata: MetadataStorage, platform: Platform, config: Configuration);
10
- /** Discovers all entities asynchronously and returns the populated MetadataStorage. */
11
- discover(preferTs?: boolean): Promise<MetadataStorage>;
12
- /** Discovers all entities synchronously and returns the populated MetadataStorage. */
13
- discoverSync(): MetadataStorage;
14
- private mapDiscoveredEntities;
15
- private initAccessors;
16
- /** Processes discovered entities: initializes relations, embeddables, indexes, and inheritance. */
17
- processDiscoveredEntities(discovered: EntityMetadata[]): EntityMetadata[];
18
- private findEntities;
19
- private discoverMissingTargets;
20
- private tryDiscoverTargets;
21
- discoverReferences<T>(refs: Iterable<EntityClass<T> | EntitySchema<T>>, validate?: boolean): EntityMetadata<T>[];
22
- reset<T>(entityName: EntityName<T>): void;
23
- private getSchema;
24
- private getRootEntity;
25
- private discoverEntity;
26
- private initNullability;
27
- private applyNamingStrategy;
28
- private initOwnColumns;
29
- private initFieldName;
30
- private initManyToOneFieldName;
31
- private initManyToManyFieldName;
32
- private initManyToManyFields;
33
- private isExplicitTableName;
34
- private initManyToOneFields;
35
- private initOneToManyFields;
36
- private processEntity;
37
- private findReferencingProperties;
38
- private initFactoryField;
39
- private ensureCorrectFKOrderInPivotEntity;
40
- private definePivotTableEntity;
41
- /**
42
- * Create a scalar property for a pivot table column.
43
- */
44
- private createPivotScalarProperty;
45
- /**
46
- * Get column types for an entity's primary keys, initializing them if needed.
47
- */
48
- private getPrimaryKeyColumnTypes;
49
- /**
50
- * Add missing FK columns for a polymorphic entity to an existing pivot table.
51
- */
52
- private addPolymorphicPivotColumns;
53
- /**
54
- * Define properties for a polymorphic pivot table.
55
- */
56
- private definePolymorphicPivotProperties;
57
- /**
58
- * Create a virtual M:1 relation from pivot to a polymorphic owner entity.
59
- * This enables single-query join loading for inverse-side polymorphic M:N.
60
- */
61
- private definePolymorphicOwnerRelation;
62
- private defineFixedOrderProperty;
63
- private definePivotProperty;
64
- private autoWireBidirectionalProperties;
65
- private defineBaseEntityProperties;
66
- private initPolyEmbeddables;
67
- private initPolymorphicRelation;
68
- private initEmbeddables;
69
- private initSingleTableInheritance;
70
- /**
71
- * First pass of TPT initialization: sets up hierarchy relationships
72
- * (inheritanceType, tptParent, tptChildren) before properties have fieldNames.
73
- */
74
- private initTPTRelationships;
75
- /**
76
- * Second pass of TPT initialization: re-resolves metadata references after fieldNames
77
- * are set, syncs to registry metadata, and sets up discriminators.
78
- */
79
- private finalizeTPTInheritance;
80
- /**
81
- * Initialize TPT discriminator map and virtual discriminator property.
82
- * Unlike STI where the discriminator is a persisted column, TPT discriminator is computed
83
- * at query time using CASE WHEN expressions based on which child table has data.
84
- */
85
- private initTPTDiscriminator;
86
- /**
87
- * Recursively collect all TPT descendants (children, grandchildren, etc.)
88
- */
89
- private collectAllTPTDescendants;
90
- /**
91
- * Computes ownProps for TPT entities - only properties defined in THIS entity,
92
- * not inherited from parent. Also creates synthetic join properties for parent/child relationships.
93
- *
94
- * Called multiple times during discovery as metadata is progressively built.
95
- * Each pass overwrites earlier results to reflect the final state of properties.
96
- */
97
- private computeTPTOwnProps;
98
- /** Returns the depth of a TPT entity in its hierarchy (0 for root). */
99
- private getTPTDepth;
100
- /**
101
- * Find the direct TPT parent entity for the given entity.
102
- */
103
- private getTPTParent;
104
- private createDiscriminatorProperty;
105
- private initAutoincrement;
106
- private createSchemaTable;
107
- private initCheckConstraints;
108
- private initGeneratedColumn;
109
- private getDefaultVersionValue;
110
- private inferDefaultValue;
111
- private initDefaultValue;
112
- private inferTypeFromDefault;
113
- private initVersionProperty;
114
- private initCustomType;
115
- private initRelation;
116
- private initColumnType;
117
- private getMappedType;
118
- private getPrefix;
119
- private initUnsigned;
120
- private initIndexes;
121
- private shouldForceConstructorUsage;
8
+ #private;
9
+ constructor(metadata: MetadataStorage, platform: Platform, config: Configuration);
10
+ /** Discovers all entities asynchronously and returns the populated MetadataStorage. */
11
+ discover(preferTs?: boolean): Promise<MetadataStorage>;
12
+ /** Discovers all entities synchronously and returns the populated MetadataStorage. */
13
+ discoverSync(): MetadataStorage;
14
+ private mapDiscoveredEntities;
15
+ private initAccessors;
16
+ /** Processes discovered entities: initializes relations, embeddables, indexes, and inheritance. */
17
+ processDiscoveredEntities(discovered: EntityMetadata[]): EntityMetadata[];
18
+ private findEntities;
19
+ private discoverMissingTargets;
20
+ private tryDiscoverTargets;
21
+ discoverReferences<T>(refs: Iterable<EntityClass<T> | EntitySchema<T>>, validate?: boolean): EntityMetadata<T>[];
22
+ reset<T>(entityName: EntityName<T>): void;
23
+ private getSchema;
24
+ private getRootEntity;
25
+ private discoverEntity;
26
+ private initNullability;
27
+ private applyNamingStrategy;
28
+ private initOwnColumns;
29
+ private initFieldName;
30
+ private initManyToOneFieldName;
31
+ private initManyToManyFieldName;
32
+ private initManyToManyFields;
33
+ private isExplicitTableName;
34
+ private initManyToOneFields;
35
+ private initOneToManyFields;
36
+ private processEntity;
37
+ private findReferencingProperties;
38
+ private initFactoryField;
39
+ private ensureCorrectFKOrderInPivotEntity;
40
+ private definePivotTableEntity;
41
+ /**
42
+ * Create a scalar property for a pivot table column.
43
+ */
44
+ private createPivotScalarProperty;
45
+ /**
46
+ * Get column types for an entity's primary keys, initializing them if needed.
47
+ */
48
+ private getPrimaryKeyColumnTypes;
49
+ /**
50
+ * Add missing FK columns for a polymorphic entity to an existing pivot table.
51
+ */
52
+ private addPolymorphicPivotColumns;
53
+ /**
54
+ * Define properties for a polymorphic pivot table.
55
+ */
56
+ private definePolymorphicPivotProperties;
57
+ /**
58
+ * Create a virtual M:1 relation from pivot to a polymorphic owner entity.
59
+ * This enables single-query join loading for inverse-side polymorphic M:N.
60
+ */
61
+ private definePolymorphicOwnerRelation;
62
+ private defineFixedOrderProperty;
63
+ private definePivotProperty;
64
+ private autoWireBidirectionalProperties;
65
+ private defineBaseEntityProperties;
66
+ private initPolyEmbeddables;
67
+ private initPolymorphicRelation;
68
+ private initEmbeddables;
69
+ private initSingleTableInheritance;
70
+ /**
71
+ * First pass of TPT initialization: sets up hierarchy relationships
72
+ * (inheritanceType, tptParent, tptChildren) before properties have fieldNames.
73
+ */
74
+ private initTPTRelationships;
75
+ /**
76
+ * Second pass of TPT initialization: re-resolves metadata references after fieldNames
77
+ * are set, syncs to registry metadata, and sets up discriminators.
78
+ */
79
+ private finalizeTPTInheritance;
80
+ /**
81
+ * Initialize TPT discriminator map and virtual discriminator property.
82
+ * Unlike STI where the discriminator is a persisted column, TPT discriminator is computed
83
+ * at query time using CASE WHEN expressions based on which child table has data.
84
+ */
85
+ private initTPTDiscriminator;
86
+ /**
87
+ * Recursively collect all TPT descendants (children, grandchildren, etc.)
88
+ */
89
+ private collectAllTPTDescendants;
90
+ /**
91
+ * Computes ownProps for TPT entities - only properties defined in THIS entity,
92
+ * not inherited from parent. Also creates synthetic join properties for parent/child relationships.
93
+ *
94
+ * Called multiple times during discovery as metadata is progressively built.
95
+ * Each pass overwrites earlier results to reflect the final state of properties.
96
+ */
97
+ private computeTPTOwnProps;
98
+ /** Returns the depth of a TPT entity in its hierarchy (0 for root). */
99
+ private getTPTDepth;
100
+ /**
101
+ * Find the direct TPT parent entity for the given entity.
102
+ */
103
+ private getTPTParent;
104
+ private createDiscriminatorProperty;
105
+ private initAutoincrement;
106
+ private createSchemaTable;
107
+ private initCheckConstraints;
108
+ private initGeneratedColumn;
109
+ private getDefaultVersionValue;
110
+ private inferDefaultValue;
111
+ private initDefaultValue;
112
+ private inferTypeFromDefault;
113
+ private initVersionProperty;
114
+ private initCustomType;
115
+ private initRelation;
116
+ private initColumnType;
117
+ private getMappedType;
118
+ private getPrefix;
119
+ private initUnsigned;
120
+ private initIndexes;
121
+ private shouldForceConstructorUsage;
122
122
  }