@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
@@ -5,21 +5,46 @@ 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>(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;
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;
25
50
  }
@@ -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;
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);
12
23
  }
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];
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]);
48
43
  }
44
+ return meta.hydrateProps;
45
+ }
46
+ hydrateProperty(entity, prop, data, factory, newEntity, convertCustomTypes) {
47
+ entity[prop.name] = data[prop.name];
48
+ }
49
49
  }
@@ -1,24 +1,57 @@
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> = (entity: T, data: EntityData<T>, factory: EntityFactory, newEntity: boolean, convertCustomTypes: boolean, schema?: string, parentSchema?: string, normalizeAccessors?: boolean) => void;
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;
5
14
  /** @internal JIT-compiled hydrator that converts raw database rows into entity instances with optimized generated code. */
6
15
  export declare class ObjectHydrator extends Hydrator {
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;
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;
23
56
  }
24
57
  export {};