@mikro-orm/core 7.0.2 → 7.0.3-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 (205) hide show
  1. package/EntityManager.d.ts +583 -883
  2. package/EntityManager.js +1869 -1897
  3. package/MikroORM.d.ts +74 -103
  4. package/MikroORM.js +179 -178
  5. package/cache/CacheAdapter.d.ts +36 -36
  6. package/cache/FileCacheAdapter.d.ts +24 -30
  7. package/cache/FileCacheAdapter.js +78 -80
  8. package/cache/GeneratedCacheAdapter.d.ts +20 -18
  9. package/cache/GeneratedCacheAdapter.js +30 -30
  10. package/cache/MemoryCacheAdapter.d.ts +20 -18
  11. package/cache/MemoryCacheAdapter.js +36 -35
  12. package/cache/NullCacheAdapter.d.ts +16 -16
  13. package/cache/NullCacheAdapter.js +24 -24
  14. package/connections/Connection.d.ts +84 -95
  15. package/connections/Connection.js +168 -165
  16. package/drivers/DatabaseDriver.d.ts +80 -186
  17. package/drivers/DatabaseDriver.js +443 -450
  18. package/drivers/IDatabaseDriver.d.ts +301 -440
  19. package/entity/BaseEntity.d.ts +83 -120
  20. package/entity/BaseEntity.js +43 -43
  21. package/entity/Collection.d.ts +179 -212
  22. package/entity/Collection.js +721 -727
  23. package/entity/EntityAssigner.d.ts +77 -88
  24. package/entity/EntityAssigner.js +230 -231
  25. package/entity/EntityFactory.d.ts +54 -66
  26. package/entity/EntityFactory.js +383 -425
  27. package/entity/EntityHelper.d.ts +22 -34
  28. package/entity/EntityHelper.js +267 -280
  29. package/entity/EntityIdentifier.d.ts +4 -4
  30. package/entity/EntityIdentifier.js +10 -10
  31. package/entity/EntityLoader.d.ts +73 -103
  32. package/entity/EntityLoader.js +723 -753
  33. package/entity/EntityRepository.d.ts +201 -316
  34. package/entity/EntityRepository.js +213 -213
  35. package/entity/PolymorphicRef.d.ts +5 -5
  36. package/entity/PolymorphicRef.js +10 -10
  37. package/entity/Reference.d.ts +82 -126
  38. package/entity/Reference.js +274 -278
  39. package/entity/WrappedEntity.d.ts +72 -115
  40. package/entity/WrappedEntity.js +166 -168
  41. package/entity/defineEntity.d.ts +614 -1280
  42. package/entity/defineEntity.js +511 -520
  43. package/entity/utils.d.ts +3 -13
  44. package/entity/utils.js +73 -71
  45. package/entity/validators.js +43 -43
  46. package/entity/wrap.js +8 -8
  47. package/enums.d.ts +253 -258
  48. package/enums.js +252 -251
  49. package/errors.d.ts +72 -114
  50. package/errors.js +253 -350
  51. package/events/EventManager.d.ts +14 -26
  52. package/events/EventManager.js +77 -79
  53. package/events/EventSubscriber.d.ts +29 -29
  54. package/events/TransactionEventBroadcaster.d.ts +8 -15
  55. package/events/TransactionEventBroadcaster.js +14 -14
  56. package/exceptions.d.ts +40 -23
  57. package/exceptions.js +52 -35
  58. package/hydration/Hydrator.d.ts +17 -42
  59. package/hydration/Hydrator.js +43 -43
  60. package/hydration/ObjectHydrator.d.ts +17 -50
  61. package/hydration/ObjectHydrator.js +416 -479
  62. package/index.d.ts +2 -116
  63. package/index.js +1 -10
  64. package/logging/DefaultLogger.d.ts +32 -34
  65. package/logging/DefaultLogger.js +86 -86
  66. package/logging/Logger.d.ts +41 -41
  67. package/logging/SimpleLogger.d.ts +11 -13
  68. package/logging/SimpleLogger.js +22 -22
  69. package/logging/colors.d.ts +6 -6
  70. package/logging/colors.js +10 -11
  71. package/logging/inspect.js +7 -7
  72. package/metadata/EntitySchema.d.ts +127 -211
  73. package/metadata/EntitySchema.js +398 -397
  74. package/metadata/MetadataDiscovery.d.ts +114 -114
  75. package/metadata/MetadataDiscovery.js +1863 -1947
  76. package/metadata/MetadataProvider.d.ts +21 -24
  77. package/metadata/MetadataProvider.js +84 -82
  78. package/metadata/MetadataStorage.d.ts +32 -38
  79. package/metadata/MetadataStorage.js +118 -118
  80. package/metadata/MetadataValidator.d.ts +39 -39
  81. package/metadata/MetadataValidator.js +338 -381
  82. package/metadata/discover-entities.d.ts +2 -5
  83. package/metadata/discover-entities.js +27 -27
  84. package/metadata/types.d.ts +531 -615
  85. package/naming-strategy/AbstractNamingStrategy.d.ts +39 -54
  86. package/naming-strategy/AbstractNamingStrategy.js +85 -90
  87. package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
  88. package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
  89. package/naming-strategy/MongoNamingStrategy.d.ts +6 -6
  90. package/naming-strategy/MongoNamingStrategy.js +18 -18
  91. package/naming-strategy/NamingStrategy.d.ts +99 -109
  92. package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
  93. package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
  94. package/not-supported.js +4 -7
  95. package/package.json +1 -1
  96. package/platforms/ExceptionConverter.d.ts +1 -1
  97. package/platforms/ExceptionConverter.js +4 -4
  98. package/platforms/Platform.d.ts +299 -308
  99. package/platforms/Platform.js +636 -659
  100. package/serialization/EntitySerializer.d.ts +26 -48
  101. package/serialization/EntitySerializer.js +218 -224
  102. package/serialization/EntityTransformer.d.ts +6 -10
  103. package/serialization/EntityTransformer.js +217 -219
  104. package/serialization/SerializationContext.d.ts +23 -27
  105. package/serialization/SerializationContext.js +105 -105
  106. package/types/ArrayType.d.ts +8 -8
  107. package/types/ArrayType.js +33 -33
  108. package/types/BigIntType.d.ts +10 -17
  109. package/types/BigIntType.js +37 -37
  110. package/types/BlobType.d.ts +3 -3
  111. package/types/BlobType.js +13 -13
  112. package/types/BooleanType.d.ts +4 -4
  113. package/types/BooleanType.js +12 -12
  114. package/types/CharacterType.d.ts +2 -2
  115. package/types/CharacterType.js +6 -6
  116. package/types/DateTimeType.d.ts +5 -5
  117. package/types/DateTimeType.js +15 -15
  118. package/types/DateType.d.ts +5 -5
  119. package/types/DateType.js +15 -15
  120. package/types/DecimalType.d.ts +7 -7
  121. package/types/DecimalType.js +26 -26
  122. package/types/DoubleType.d.ts +3 -3
  123. package/types/DoubleType.js +12 -12
  124. package/types/EnumArrayType.d.ts +5 -5
  125. package/types/EnumArrayType.js +24 -24
  126. package/types/EnumType.d.ts +3 -3
  127. package/types/EnumType.js +11 -11
  128. package/types/FloatType.d.ts +3 -3
  129. package/types/FloatType.js +9 -9
  130. package/types/IntegerType.d.ts +3 -3
  131. package/types/IntegerType.js +9 -9
  132. package/types/IntervalType.d.ts +4 -4
  133. package/types/IntervalType.js +12 -12
  134. package/types/JsonType.d.ts +8 -8
  135. package/types/JsonType.js +32 -32
  136. package/types/MediumIntType.d.ts +1 -1
  137. package/types/MediumIntType.js +3 -3
  138. package/types/SmallIntType.d.ts +3 -3
  139. package/types/SmallIntType.js +9 -9
  140. package/types/StringType.d.ts +4 -4
  141. package/types/StringType.js +12 -12
  142. package/types/TextType.d.ts +3 -3
  143. package/types/TextType.js +9 -9
  144. package/types/TimeType.d.ts +5 -5
  145. package/types/TimeType.js +17 -17
  146. package/types/TinyIntType.d.ts +3 -3
  147. package/types/TinyIntType.js +10 -10
  148. package/types/Type.d.ts +79 -83
  149. package/types/Type.js +82 -82
  150. package/types/Uint8ArrayType.d.ts +4 -4
  151. package/types/Uint8ArrayType.js +21 -21
  152. package/types/UnknownType.d.ts +4 -4
  153. package/types/UnknownType.js +12 -12
  154. package/types/UuidType.d.ts +5 -5
  155. package/types/UuidType.js +19 -19
  156. package/types/index.d.ts +49 -75
  157. package/types/index.js +26 -52
  158. package/typings.d.ts +729 -1211
  159. package/typings.js +231 -244
  160. package/unit-of-work/ChangeSet.d.ts +26 -26
  161. package/unit-of-work/ChangeSet.js +56 -56
  162. package/unit-of-work/ChangeSetComputer.d.ts +12 -12
  163. package/unit-of-work/ChangeSetComputer.js +170 -178
  164. package/unit-of-work/ChangeSetPersister.d.ts +44 -63
  165. package/unit-of-work/ChangeSetPersister.js +421 -442
  166. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  167. package/unit-of-work/CommitOrderCalculator.js +88 -89
  168. package/unit-of-work/IdentityMap.d.ts +31 -31
  169. package/unit-of-work/IdentityMap.js +105 -105
  170. package/unit-of-work/UnitOfWork.d.ts +141 -181
  171. package/unit-of-work/UnitOfWork.js +1183 -1200
  172. package/utils/AbstractMigrator.d.ts +91 -111
  173. package/utils/AbstractMigrator.js +275 -275
  174. package/utils/AbstractSchemaGenerator.d.ts +34 -43
  175. package/utils/AbstractSchemaGenerator.js +122 -121
  176. package/utils/AsyncContext.d.ts +3 -3
  177. package/utils/AsyncContext.js +35 -34
  178. package/utils/Configuration.d.ts +808 -852
  179. package/utils/Configuration.js +344 -359
  180. package/utils/Cursor.d.ts +22 -40
  181. package/utils/Cursor.js +127 -135
  182. package/utils/DataloaderUtils.d.ts +43 -58
  183. package/utils/DataloaderUtils.js +198 -203
  184. package/utils/EntityComparator.d.ts +81 -98
  185. package/utils/EntityComparator.js +728 -824
  186. package/utils/NullHighlighter.d.ts +1 -1
  187. package/utils/NullHighlighter.js +3 -3
  188. package/utils/QueryHelper.d.ts +51 -79
  189. package/utils/QueryHelper.js +361 -372
  190. package/utils/RawQueryFragment.d.ts +34 -50
  191. package/utils/RawQueryFragment.js +105 -107
  192. package/utils/RequestContext.d.ts +32 -32
  193. package/utils/RequestContext.js +53 -52
  194. package/utils/TransactionContext.d.ts +16 -16
  195. package/utils/TransactionContext.js +27 -27
  196. package/utils/TransactionManager.d.ts +58 -58
  197. package/utils/TransactionManager.js +197 -199
  198. package/utils/Utils.d.ts +145 -204
  199. package/utils/Utils.js +813 -814
  200. package/utils/clone.js +113 -104
  201. package/utils/env-vars.js +88 -90
  202. package/utils/fs-utils.d.ts +15 -15
  203. package/utils/fs-utils.js +181 -180
  204. package/utils/upsert-utils.d.ts +5 -20
  205. package/utils/upsert-utils.js +116 -114
@@ -5,46 +5,21 @@ import type { MetadataStorage } from '../metadata/MetadataStorage.js';
5
5
  import type { Configuration } from '../utils/Configuration.js';
6
6
  /** Abstract base class for hydrating entity instances from raw database data. */
7
7
  export declare abstract class Hydrator implements IHydrator {
8
- protected readonly metadata: MetadataStorage;
9
- protected readonly platform: Platform;
10
- protected readonly config: Configuration;
11
- protected running: boolean;
12
- constructor(metadata: MetadataStorage, platform: Platform, config: Configuration);
13
- /**
14
- * @inheritDoc
15
- */
16
- hydrate<T extends object>(
17
- entity: T,
18
- meta: EntityMetadata<T>,
19
- data: EntityData<T>,
20
- factory: EntityFactory,
21
- type: 'full' | 'reference',
22
- newEntity?: boolean,
23
- convertCustomTypes?: boolean,
24
- schema?: string,
25
- parentSchema?: string,
26
- ): void;
27
- /**
28
- * @inheritDoc
29
- */
30
- hydrateReference<T extends object>(
31
- entity: T,
32
- meta: EntityMetadata<T>,
33
- data: EntityData<T>,
34
- factory: EntityFactory,
35
- convertCustomTypes?: boolean,
36
- schema?: string,
37
- parentSchema?: string,
38
- ): void;
39
- /** Returns whether the hydrator is currently in the middle of hydrating an entity. */
40
- isRunning(): boolean;
41
- protected getProperties<T extends object>(meta: EntityMetadata<T>, type: 'full' | 'reference'): EntityProperty<T>[];
42
- protected hydrateProperty<T extends object>(
43
- entity: T,
44
- prop: EntityProperty<T>,
45
- data: EntityData<T>,
46
- factory: EntityFactory,
47
- newEntity?: boolean,
48
- convertCustomTypes?: boolean,
49
- ): void;
8
+ protected readonly metadata: MetadataStorage;
9
+ protected readonly platform: Platform;
10
+ protected readonly config: Configuration;
11
+ protected running: boolean;
12
+ constructor(metadata: MetadataStorage, platform: Platform, config: Configuration);
13
+ /**
14
+ * @inheritDoc
15
+ */
16
+ hydrate<T extends object>(entity: T, meta: EntityMetadata<T>, data: EntityData<T>, factory: EntityFactory, type: 'full' | 'reference', newEntity?: boolean, convertCustomTypes?: boolean, schema?: string, parentSchema?: string): void;
17
+ /**
18
+ * @inheritDoc
19
+ */
20
+ hydrateReference<T extends object>(entity: T, meta: EntityMetadata<T>, data: EntityData<T>, factory: EntityFactory, convertCustomTypes?: boolean, schema?: string, parentSchema?: string): void;
21
+ /** Returns whether the hydrator is currently in the middle of hydrating an entity. */
22
+ isRunning(): boolean;
23
+ protected getProperties<T extends object>(meta: EntityMetadata<T>, type: 'full' | 'reference'): EntityProperty<T>[];
24
+ protected hydrateProperty<T extends object>(entity: T, prop: EntityProperty<T>, data: EntityData<T>, factory: EntityFactory, newEntity?: boolean, convertCustomTypes?: boolean): void;
50
25
  }
@@ -1,49 +1,49 @@
1
1
  /** Abstract base class for hydrating entity instances from raw database data. */
2
2
  /* v8 ignore next */
3
3
  export class Hydrator {
4
- metadata;
5
- platform;
6
- config;
7
- running = false;
8
- constructor(metadata, platform, config) {
9
- this.metadata = metadata;
10
- this.platform = platform;
11
- this.config = config;
12
- }
13
- /**
14
- * @inheritDoc
15
- */
16
- hydrate(entity, meta, data, factory, type, newEntity = false, convertCustomTypes = false, schema, parentSchema) {
17
- // the running state is used to consider propagation as hydration, saving the values directly to the entity data,
18
- // but we don't want that for new entities, their propagation should result in entity updates when flushing
19
- this.running = !newEntity;
20
- const props = this.getProperties(meta, type);
21
- for (const prop of props) {
22
- this.hydrateProperty(entity, prop, data, factory, newEntity, convertCustomTypes);
4
+ metadata;
5
+ platform;
6
+ config;
7
+ running = false;
8
+ constructor(metadata, platform, config) {
9
+ this.metadata = metadata;
10
+ this.platform = platform;
11
+ this.config = config;
23
12
  }
24
- this.running = false;
25
- }
26
- /**
27
- * @inheritDoc
28
- */
29
- hydrateReference(entity, meta, data, factory, convertCustomTypes, schema, parentSchema) {
30
- this.running = true;
31
- meta.primaryKeys.forEach(pk => {
32
- this.hydrateProperty(entity, meta.properties[pk], data, factory, false, convertCustomTypes);
33
- });
34
- this.running = false;
35
- }
36
- /** Returns whether the hydrator is currently in the middle of hydrating an entity. */
37
- isRunning() {
38
- return this.running;
39
- }
40
- getProperties(meta, type) {
41
- if (type === 'reference') {
42
- return meta.primaryKeys.map(pk => meta.properties[pk]);
13
+ /**
14
+ * @inheritDoc
15
+ */
16
+ hydrate(entity, meta, data, factory, type, newEntity = false, convertCustomTypes = false, schema, parentSchema) {
17
+ // the running state is used to consider propagation as hydration, saving the values directly to the entity data,
18
+ // but we don't want that for new entities, their propagation should result in entity updates when flushing
19
+ this.running = !newEntity;
20
+ const props = this.getProperties(meta, type);
21
+ for (const prop of props) {
22
+ this.hydrateProperty(entity, prop, data, factory, newEntity, convertCustomTypes);
23
+ }
24
+ this.running = false;
25
+ }
26
+ /**
27
+ * @inheritDoc
28
+ */
29
+ hydrateReference(entity, meta, data, factory, convertCustomTypes, schema, parentSchema) {
30
+ this.running = true;
31
+ meta.primaryKeys.forEach(pk => {
32
+ this.hydrateProperty(entity, meta.properties[pk], data, factory, false, convertCustomTypes);
33
+ });
34
+ this.running = false;
35
+ }
36
+ /** Returns whether the hydrator is currently in the middle of hydrating an entity. */
37
+ isRunning() {
38
+ return this.running;
39
+ }
40
+ getProperties(meta, type) {
41
+ if (type === 'reference') {
42
+ return meta.primaryKeys.map(pk => meta.properties[pk]);
43
+ }
44
+ return meta.hydrateProps;
45
+ }
46
+ hydrateProperty(entity, prop, data, factory, newEntity, convertCustomTypes) {
47
+ entity[prop.name] = data[prop.name];
43
48
  }
44
- return meta.hydrateProps;
45
- }
46
- hydrateProperty(entity, prop, data, factory, newEntity, convertCustomTypes) {
47
- entity[prop.name] = data[prop.name];
48
- }
49
49
  }
@@ -1,57 +1,24 @@
1
1
  import type { EntityData, EntityMetadata } from '../typings.js';
2
2
  import { Hydrator } from './Hydrator.js';
3
3
  import type { EntityFactory } from '../entity/EntityFactory.js';
4
- type EntityHydrator<T extends object> = (
5
- entity: T,
6
- data: EntityData<T>,
7
- factory: EntityFactory,
8
- newEntity: boolean,
9
- convertCustomTypes: boolean,
10
- schema?: string,
11
- parentSchema?: string,
12
- normalizeAccessors?: boolean,
13
- ) => void;
4
+ type EntityHydrator<T extends object> = (entity: T, data: EntityData<T>, factory: EntityFactory, newEntity: boolean, convertCustomTypes: boolean, schema?: string, parentSchema?: string, normalizeAccessors?: boolean) => void;
14
5
  /** @internal JIT-compiled hydrator that converts raw database rows into entity instances with optimized generated code. */
15
6
  export declare class ObjectHydrator extends Hydrator {
16
- #private;
17
- /**
18
- * @inheritDoc
19
- */
20
- hydrate<T extends object>(
21
- entity: T,
22
- meta: EntityMetadata<T>,
23
- data: EntityData<T>,
24
- factory: EntityFactory,
25
- type: 'full' | 'reference',
26
- newEntity?: boolean,
27
- convertCustomTypes?: boolean,
28
- schema?: string,
29
- parentSchema?: string,
30
- normalizeAccessors?: boolean,
31
- ): void;
32
- /**
33
- * @inheritDoc
34
- */
35
- hydrateReference<T extends object>(
36
- entity: T,
37
- meta: EntityMetadata<T>,
38
- data: EntityData<T>,
39
- factory: EntityFactory,
40
- convertCustomTypes?: boolean,
41
- schema?: string,
42
- parentSchema?: string,
43
- normalizeAccessors?: boolean,
44
- ): void;
45
- /**
46
- * @internal Highly performance-sensitive method.
47
- */
48
- getEntityHydrator<T extends object>(
49
- meta: EntityMetadata<T>,
50
- type: 'full' | 'reference',
51
- normalizeAccessors?: boolean,
52
- ): EntityHydrator<T>;
53
- private createCollectionItemMapper;
54
- private wrap;
55
- private safeKey;
7
+ #private;
8
+ /**
9
+ * @inheritDoc
10
+ */
11
+ hydrate<T extends object>(entity: T, meta: EntityMetadata<T>, data: EntityData<T>, factory: EntityFactory, type: 'full' | 'reference', newEntity?: boolean, convertCustomTypes?: boolean, schema?: string, parentSchema?: string, normalizeAccessors?: boolean): void;
12
+ /**
13
+ * @inheritDoc
14
+ */
15
+ hydrateReference<T extends object>(entity: T, meta: EntityMetadata<T>, data: EntityData<T>, factory: EntityFactory, convertCustomTypes?: boolean, schema?: string, parentSchema?: string, normalizeAccessors?: boolean): void;
16
+ /**
17
+ * @internal Highly performance-sensitive method.
18
+ */
19
+ getEntityHydrator<T extends object>(meta: EntityMetadata<T>, type: 'full' | 'reference', normalizeAccessors?: boolean): EntityHydrator<T>;
20
+ private createCollectionItemMapper;
21
+ private wrap;
22
+ private safeKey;
56
23
  }
57
24
  export {};