@mikro-orm/core 7.0.2-dev.9 → 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
@@ -3,116 +3,120 @@ import type { Configuration } from '../utils/Configuration.js';
3
3
  import { MetadataStorage } from './MetadataStorage.js';
4
4
  import { EntitySchema } from './EntitySchema.js';
5
5
  import type { Platform } from '../platforms/Platform.js';
6
+ /** Discovers, validates, and processes entity metadata from configured sources. */
6
7
  export declare class MetadataDiscovery {
7
- #private;
8
- constructor(metadata: MetadataStorage, platform: Platform, config: Configuration);
9
- discover(preferTs?: boolean): Promise<MetadataStorage>;
10
- discoverSync(): MetadataStorage;
11
- private mapDiscoveredEntities;
12
- private initAccessors;
13
- processDiscoveredEntities(discovered: EntityMetadata[]): EntityMetadata[];
14
- private findEntities;
15
- private discoverMissingTargets;
16
- private tryDiscoverTargets;
17
- discoverReferences<T>(refs: Iterable<EntityClass<T> | EntitySchema<T>>, validate?: boolean): EntityMetadata<T>[];
18
- reset<T>(entityName: EntityName<T>): void;
19
- private getSchema;
20
- private getRootEntity;
21
- private discoverEntity;
22
- private initNullability;
23
- private applyNamingStrategy;
24
- private initOwnColumns;
25
- private initFieldName;
26
- private initManyToOneFieldName;
27
- private initManyToManyFieldName;
28
- private initManyToManyFields;
29
- private isExplicitTableName;
30
- private initManyToOneFields;
31
- private initOneToManyFields;
32
- private processEntity;
33
- private findReferencingProperties;
34
- private initFactoryField;
35
- private ensureCorrectFKOrderInPivotEntity;
36
- private definePivotTableEntity;
37
- /**
38
- * Create a scalar property for a pivot table column.
39
- */
40
- private createPivotScalarProperty;
41
- /**
42
- * Get column types for an entity's primary keys, initializing them if needed.
43
- */
44
- private getPrimaryKeyColumnTypes;
45
- /**
46
- * Add missing FK columns for a polymorphic entity to an existing pivot table.
47
- */
48
- private addPolymorphicPivotColumns;
49
- /**
50
- * Define properties for a polymorphic pivot table.
51
- */
52
- private definePolymorphicPivotProperties;
53
- /**
54
- * Create a virtual M:1 relation from pivot to a polymorphic owner entity.
55
- * This enables single-query join loading for inverse-side polymorphic M:N.
56
- */
57
- private definePolymorphicOwnerRelation;
58
- private defineFixedOrderProperty;
59
- private definePivotProperty;
60
- private autoWireBidirectionalProperties;
61
- private defineBaseEntityProperties;
62
- private initPolyEmbeddables;
63
- private initPolymorphicRelation;
64
- private initEmbeddables;
65
- private initSingleTableInheritance;
66
- /**
67
- * First pass of TPT initialization: sets up hierarchy relationships
68
- * (inheritanceType, tptParent, tptChildren) before properties have fieldNames.
69
- */
70
- private initTPTRelationships;
71
- /**
72
- * Second pass of TPT initialization: re-resolves metadata references after fieldNames
73
- * are set, syncs to registry metadata, and sets up discriminators.
74
- */
75
- private finalizeTPTInheritance;
76
- /**
77
- * Initialize TPT discriminator map and virtual discriminator property.
78
- * Unlike STI where the discriminator is a persisted column, TPT discriminator is computed
79
- * at query time using CASE WHEN expressions based on which child table has data.
80
- */
81
- private initTPTDiscriminator;
82
- /**
83
- * Recursively collect all TPT descendants (children, grandchildren, etc.)
84
- */
85
- private collectAllTPTDescendants;
86
- /**
87
- * Computes ownProps for TPT entities - only properties defined in THIS entity,
88
- * not inherited from parent. Also creates synthetic join properties for parent/child relationships.
89
- *
90
- * Called multiple times during discovery as metadata is progressively built.
91
- * Each pass overwrites earlier results to reflect the final state of properties.
92
- */
93
- private computeTPTOwnProps;
94
- /** Returns the depth of a TPT entity in its hierarchy (0 for root). */
95
- private getTPTDepth;
96
- /**
97
- * Find the direct TPT parent entity for the given entity.
98
- */
99
- private getTPTParent;
100
- private createDiscriminatorProperty;
101
- private initAutoincrement;
102
- private createSchemaTable;
103
- private initCheckConstraints;
104
- private initGeneratedColumn;
105
- private getDefaultVersionValue;
106
- private inferDefaultValue;
107
- private initDefaultValue;
108
- private inferTypeFromDefault;
109
- private initVersionProperty;
110
- private initCustomType;
111
- private initRelation;
112
- private initColumnType;
113
- private getMappedType;
114
- private getPrefix;
115
- private initUnsigned;
116
- private initIndexes;
117
- 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;
118
122
  }