@mikro-orm/core 7.0.2 → 7.0.3-dev.1

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
@@ -1,19 +1,19 @@
1
1
  import type { EntityProperty } from '../typings.js';
2
2
  export declare const enum NodeState {
3
- NOT_VISITED = 0,
4
- IN_PROGRESS = 1,
5
- VISITED = 2,
3
+ NOT_VISITED = 0,
4
+ IN_PROGRESS = 1,
5
+ VISITED = 2
6
6
  }
7
7
  type Hash = number;
8
8
  export interface Node {
9
- hash: Hash;
10
- state: NodeState;
11
- dependencies: Map<Hash, Edge>;
9
+ hash: Hash;
10
+ state: NodeState;
11
+ dependencies: Map<Hash, Edge>;
12
12
  }
13
13
  export interface Edge {
14
- from: Hash;
15
- to: Hash;
16
- weight: number;
14
+ from: Hash;
15
+ to: Hash;
16
+ weight: number;
17
17
  }
18
18
  /**
19
19
  * CommitOrderCalculator implements topological sorting, which is an ordering
@@ -26,36 +26,36 @@ export interface Edge {
26
26
  * @internal
27
27
  */
28
28
  export declare class CommitOrderCalculator {
29
- #private;
30
- /**
31
- * Checks for node existence in graph.
32
- */
33
- hasNode(hash: Hash): boolean;
34
- /**
35
- * Adds a new node to the graph, assigning its hash.
36
- */
37
- addNode(hash: Hash): void;
38
- /**
39
- * Adds a new dependency (edge) to the graph using their hashes.
40
- */
41
- addDependency(from: Hash, to: Hash, weight: number): void;
42
- discoverProperty(prop: EntityProperty, entityName: Hash): void;
43
- /**
44
- * Return a valid order list of all current nodes.
45
- * The desired topological sorting is the reverse post order of these searches.
46
- *
47
- * @internal Highly performance-sensitive method.
48
- */
49
- sort(): Hash[];
50
- /**
51
- * Visit a given node definition for reordering.
52
- *
53
- * @internal Highly performance-sensitive method.
54
- */
55
- private visit;
56
- /**
57
- * Visits all target's dependencies if in cycle with given node
58
- */
59
- private visitOpenNode;
29
+ #private;
30
+ /**
31
+ * Checks for node existence in graph.
32
+ */
33
+ hasNode(hash: Hash): boolean;
34
+ /**
35
+ * Adds a new node to the graph, assigning its hash.
36
+ */
37
+ addNode(hash: Hash): void;
38
+ /**
39
+ * Adds a new dependency (edge) to the graph using their hashes.
40
+ */
41
+ addDependency(from: Hash, to: Hash, weight: number): void;
42
+ discoverProperty(prop: EntityProperty, entityName: Hash): void;
43
+ /**
44
+ * Return a valid order list of all current nodes.
45
+ * The desired topological sorting is the reverse post order of these searches.
46
+ *
47
+ * @internal Highly performance-sensitive method.
48
+ */
49
+ sort(): Hash[];
50
+ /**
51
+ * Visit a given node definition for reordering.
52
+ *
53
+ * @internal Highly performance-sensitive method.
54
+ */
55
+ private visit;
56
+ /**
57
+ * Visits all target's dependencies if in cycle with given node
58
+ */
59
+ private visitOpenNode;
60
60
  }
61
61
  export {};
@@ -1,9 +1,9 @@
1
1
  import { ReferenceKind } from '../enums.js';
2
2
  export var NodeState;
3
3
  (function (NodeState) {
4
- NodeState[(NodeState['NOT_VISITED'] = 0)] = 'NOT_VISITED';
5
- NodeState[(NodeState['IN_PROGRESS'] = 1)] = 'IN_PROGRESS';
6
- NodeState[(NodeState['VISITED'] = 2)] = 'VISITED';
4
+ NodeState[NodeState["NOT_VISITED"] = 0] = "NOT_VISITED";
5
+ NodeState[NodeState["IN_PROGRESS"] = 1] = "IN_PROGRESS";
6
+ NodeState[NodeState["VISITED"] = 2] = "VISITED";
7
7
  })(NodeState || (NodeState = {}));
8
8
  /**
9
9
  * CommitOrderCalculator implements topological sorting, which is an ordering
@@ -16,97 +16,96 @@ export var NodeState;
16
16
  * @internal
17
17
  */
18
18
  export class CommitOrderCalculator {
19
- /** Matrix of nodes, keys are provided hashes and values are the node definition objects. */
20
- #nodes = new Map();
21
- /** Volatile variable holding calculated nodes during sorting process. */
22
- #sortedNodeList = [];
23
- /**
24
- * Checks for node existence in graph.
25
- */
26
- hasNode(hash) {
27
- return this.#nodes.has(hash);
28
- }
29
- /**
30
- * Adds a new node to the graph, assigning its hash.
31
- */
32
- addNode(hash) {
33
- this.#nodes.set(hash, { hash, state: 0 /* NodeState.NOT_VISITED */, dependencies: new Map() });
34
- }
35
- /**
36
- * Adds a new dependency (edge) to the graph using their hashes.
37
- */
38
- addDependency(from, to, weight) {
39
- this.#nodes.get(from).dependencies.set(to, { from, to, weight });
40
- }
41
- discoverProperty(prop, entityName) {
42
- const toOneOwner =
43
- (prop.kind === ReferenceKind.ONE_TO_ONE && prop.owner) || prop.kind === ReferenceKind.MANY_TO_ONE;
44
- const toManyOwner = prop.kind === ReferenceKind.MANY_TO_MANY && prop.owner && !prop.pivotEntity;
45
- if (!toOneOwner && !toManyOwner) {
46
- return;
19
+ /** Matrix of nodes, keys are provided hashes and values are the node definition objects. */
20
+ #nodes = new Map();
21
+ /** Volatile variable holding calculated nodes during sorting process. */
22
+ #sortedNodeList = [];
23
+ /**
24
+ * Checks for node existence in graph.
25
+ */
26
+ hasNode(hash) {
27
+ return this.#nodes.has(hash);
47
28
  }
48
- const propertyType = prop.targetMeta?.root._id;
49
- if (propertyType == null || !this.hasNode(propertyType)) {
50
- return;
29
+ /**
30
+ * Adds a new node to the graph, assigning its hash.
31
+ */
32
+ addNode(hash) {
33
+ this.#nodes.set(hash, { hash, state: 0 /* NodeState.NOT_VISITED */, dependencies: new Map() });
51
34
  }
52
- this.addDependency(propertyType, entityName, prop.nullable || prop.persist === false ? 0 : 1);
53
- }
54
- /**
55
- * Return a valid order list of all current nodes.
56
- * The desired topological sorting is the reverse post order of these searches.
57
- *
58
- * @internal Highly performance-sensitive method.
59
- */
60
- sort() {
61
- for (const vertex of this.#nodes.values()) {
62
- if (vertex.state !== 0 /* NodeState.NOT_VISITED */) {
63
- continue;
64
- }
65
- this.visit(vertex);
35
+ /**
36
+ * Adds a new dependency (edge) to the graph using their hashes.
37
+ */
38
+ addDependency(from, to, weight) {
39
+ this.#nodes.get(from).dependencies.set(to, { from, to, weight });
66
40
  }
67
- const sortedList = this.#sortedNodeList.reverse();
68
- this.#nodes = new Map();
69
- this.#sortedNodeList = [];
70
- return sortedList;
71
- }
72
- /**
73
- * Visit a given node definition for reordering.
74
- *
75
- * @internal Highly performance-sensitive method.
76
- */
77
- visit(node) {
78
- node.state = 1 /* NodeState.IN_PROGRESS */;
79
- for (const edge of node.dependencies.values()) {
80
- const target = this.#nodes.get(edge.to);
81
- switch (target.state) {
82
- case 2 /* NodeState.VISITED */:
83
- break; // Do nothing, since node was already visited
84
- case 1 /* NodeState.IN_PROGRESS */:
85
- this.visitOpenNode(node, target, edge);
86
- break;
87
- case 0 /* NodeState.NOT_VISITED */:
88
- this.visit(target);
89
- }
41
+ discoverProperty(prop, entityName) {
42
+ const toOneOwner = (prop.kind === ReferenceKind.ONE_TO_ONE && prop.owner) || prop.kind === ReferenceKind.MANY_TO_ONE;
43
+ const toManyOwner = prop.kind === ReferenceKind.MANY_TO_MANY && prop.owner && !prop.pivotEntity;
44
+ if (!toOneOwner && !toManyOwner) {
45
+ return;
46
+ }
47
+ const propertyType = prop.targetMeta?.root._id;
48
+ if (propertyType == null || !this.hasNode(propertyType)) {
49
+ return;
50
+ }
51
+ this.addDependency(propertyType, entityName, prop.nullable || prop.persist === false ? 0 : 1);
90
52
  }
91
- if (node.state !== 2 /* NodeState.VISITED */) {
92
- node.state = 2 /* NodeState.VISITED */;
93
- this.#sortedNodeList.push(node.hash);
53
+ /**
54
+ * Return a valid order list of all current nodes.
55
+ * The desired topological sorting is the reverse post order of these searches.
56
+ *
57
+ * @internal Highly performance-sensitive method.
58
+ */
59
+ sort() {
60
+ for (const vertex of this.#nodes.values()) {
61
+ if (vertex.state !== 0 /* NodeState.NOT_VISITED */) {
62
+ continue;
63
+ }
64
+ this.visit(vertex);
65
+ }
66
+ const sortedList = this.#sortedNodeList.reverse();
67
+ this.#nodes = new Map();
68
+ this.#sortedNodeList = [];
69
+ return sortedList;
94
70
  }
95
- }
96
- /**
97
- * Visits all target's dependencies if in cycle with given node
98
- */
99
- visitOpenNode(node, target, edge) {
100
- if (!target.dependencies.has(node.hash) || target.dependencies.get(node.hash).weight >= edge.weight) {
101
- return;
71
+ /**
72
+ * Visit a given node definition for reordering.
73
+ *
74
+ * @internal Highly performance-sensitive method.
75
+ */
76
+ visit(node) {
77
+ node.state = 1 /* NodeState.IN_PROGRESS */;
78
+ for (const edge of node.dependencies.values()) {
79
+ const target = this.#nodes.get(edge.to);
80
+ switch (target.state) {
81
+ case 2 /* NodeState.VISITED */:
82
+ break; // Do nothing, since node was already visited
83
+ case 1 /* NodeState.IN_PROGRESS */:
84
+ this.visitOpenNode(node, target, edge);
85
+ break;
86
+ case 0 /* NodeState.NOT_VISITED */:
87
+ this.visit(target);
88
+ }
89
+ }
90
+ if (node.state !== 2 /* NodeState.VISITED */) {
91
+ node.state = 2 /* NodeState.VISITED */;
92
+ this.#sortedNodeList.push(node.hash);
93
+ }
102
94
  }
103
- for (const edge of target.dependencies.values()) {
104
- const targetNode = this.#nodes.get(edge.to);
105
- if (targetNode.state === 0 /* NodeState.NOT_VISITED */) {
106
- this.visit(targetNode);
107
- }
95
+ /**
96
+ * Visits all target's dependencies if in cycle with given node
97
+ */
98
+ visitOpenNode(node, target, edge) {
99
+ if (!target.dependencies.has(node.hash) || target.dependencies.get(node.hash).weight >= edge.weight) {
100
+ return;
101
+ }
102
+ for (const edge of target.dependencies.values()) {
103
+ const targetNode = this.#nodes.get(edge.to);
104
+ if (targetNode.state === 0 /* NodeState.NOT_VISITED */) {
105
+ this.visit(targetNode);
106
+ }
107
+ }
108
+ target.state = 2 /* NodeState.VISITED */;
109
+ this.#sortedNodeList.push(target.hash);
108
110
  }
109
- target.state = 2 /* NodeState.VISITED */;
110
- this.#sortedNodeList.push(target.hash);
111
- }
112
111
  }
@@ -1,35 +1,35 @@
1
1
  import type { AnyEntity, EntityMetadata } from '../typings.js';
2
2
  /** @internal Stores managed entity instances keyed by their primary key hash, ensuring each row is loaded once. */
3
3
  export declare class IdentityMap {
4
- #private;
5
- constructor(defaultSchema?: string);
6
- /** Stores an entity in the identity map under its primary key hash. */
7
- store<T>(item: T): void;
8
- /**
9
- * Stores an entity under an alternate key (non-PK property).
10
- * This allows looking up entities by unique properties that are not the primary key.
11
- */
12
- storeByKey<T>(item: T, key: string, value: string, schema?: string): void;
13
- /** Removes an entity and its alternate key entries from the identity map. */
14
- delete<T>(item: T): void;
15
- /** Retrieves an entity by its hash key from the identity map. */
16
- getByHash<T>(meta: EntityMetadata<T>, hash: string): T | undefined;
17
- /** Returns (or creates) the per-entity-class store within the identity map. */
18
- getStore<T>(meta: EntityMetadata<T>): Map<string, T>;
19
- clear(): void;
20
- /** Returns all entities currently in the identity map. */
21
- values(): AnyEntity[];
22
- [Symbol.iterator](): IterableIterator<AnyEntity>;
23
- /** Returns all hash keys currently in the identity map. */
24
- keys(): string[];
25
- /**
26
- * For back compatibility only.
27
- */
28
- get<T>(hash: string): T | undefined;
29
- private getPkHash;
30
- /**
31
- * Creates a hash for an alternate key lookup.
32
- * Format: `[key]value` or `schema:[key]value`
33
- */
34
- getKeyHash(key: string, value: string, schema?: string): string;
4
+ #private;
5
+ constructor(defaultSchema?: string);
6
+ /** Stores an entity in the identity map under its primary key hash. */
7
+ store<T>(item: T): void;
8
+ /**
9
+ * Stores an entity under an alternate key (non-PK property).
10
+ * This allows looking up entities by unique properties that are not the primary key.
11
+ */
12
+ storeByKey<T>(item: T, key: string, value: string, schema?: string): void;
13
+ /** Removes an entity and its alternate key entries from the identity map. */
14
+ delete<T>(item: T): void;
15
+ /** Retrieves an entity by its hash key from the identity map. */
16
+ getByHash<T>(meta: EntityMetadata<T>, hash: string): T | undefined;
17
+ /** Returns (or creates) the per-entity-class store within the identity map. */
18
+ getStore<T>(meta: EntityMetadata<T>): Map<string, T>;
19
+ clear(): void;
20
+ /** Returns all entities currently in the identity map. */
21
+ values(): AnyEntity[];
22
+ [Symbol.iterator](): IterableIterator<AnyEntity>;
23
+ /** Returns all hash keys currently in the identity map. */
24
+ keys(): string[];
25
+ /**
26
+ * For back compatibility only.
27
+ */
28
+ get<T>(hash: string): T | undefined;
29
+ private getPkHash;
30
+ /**
31
+ * Creates a hash for an alternate key lookup.
32
+ * Format: `[key]value` or `schema:[key]value`
33
+ */
34
+ getKeyHash(key: string, value: string, schema?: string): string;
35
35
  }
@@ -1,117 +1,117 @@
1
1
  /** @internal Stores managed entity instances keyed by their primary key hash, ensuring each row is loaded once. */
2
2
  export class IdentityMap {
3
- #defaultSchema;
4
- #registry = new Map();
5
- /** Tracks alternate key hashes for each entity so we can clean them up on delete */
6
- #alternateKeys = new WeakMap();
7
- constructor(defaultSchema) {
8
- this.#defaultSchema = defaultSchema;
9
- }
10
- /** Stores an entity in the identity map under its primary key hash. */
11
- store(item) {
12
- this.getStore(item.__meta.root).set(this.getPkHash(item), item);
13
- }
14
- /**
15
- * Stores an entity under an alternate key (non-PK property).
16
- * This allows looking up entities by unique properties that are not the primary key.
17
- */
18
- storeByKey(item, key, value, schema) {
19
- const hash = this.getKeyHash(key, value, schema);
20
- this.getStore(item.__meta.root).set(hash, item);
21
- // Track this alternate key so we can clean it up when the entity is deleted
22
- let keys = this.#alternateKeys.get(item);
23
- if (!keys) {
24
- keys = new Set();
25
- this.#alternateKeys.set(item, keys);
3
+ #defaultSchema;
4
+ #registry = new Map();
5
+ /** Tracks alternate key hashes for each entity so we can clean them up on delete */
6
+ #alternateKeys = new WeakMap();
7
+ constructor(defaultSchema) {
8
+ this.#defaultSchema = defaultSchema;
26
9
  }
27
- keys.add(hash);
28
- }
29
- /** Removes an entity and its alternate key entries from the identity map. */
30
- delete(item) {
31
- const meta = item.__meta.root;
32
- const store = this.getStore(meta);
33
- store.delete(this.getPkHash(item));
34
- // Also delete any alternate key entries for this entity
35
- const altKeys = this.#alternateKeys.get(item);
36
- if (altKeys) {
37
- for (const hash of altKeys) {
38
- store.delete(hash);
39
- }
40
- this.#alternateKeys.delete(item);
10
+ /** Stores an entity in the identity map under its primary key hash. */
11
+ store(item) {
12
+ this.getStore(item.__meta.root).set(this.getPkHash(item), item);
41
13
  }
42
- }
43
- /** Retrieves an entity by its hash key from the identity map. */
44
- getByHash(meta, hash) {
45
- const store = this.getStore(meta);
46
- return store.has(hash) ? store.get(hash) : undefined;
47
- }
48
- /** Returns (or creates) the per-entity-class store within the identity map. */
49
- getStore(meta) {
50
- const store = this.#registry.get(meta.class);
51
- if (store) {
52
- return store;
14
+ /**
15
+ * Stores an entity under an alternate key (non-PK property).
16
+ * This allows looking up entities by unique properties that are not the primary key.
17
+ */
18
+ storeByKey(item, key, value, schema) {
19
+ const hash = this.getKeyHash(key, value, schema);
20
+ this.getStore(item.__meta.root).set(hash, item);
21
+ // Track this alternate key so we can clean it up when the entity is deleted
22
+ let keys = this.#alternateKeys.get(item);
23
+ if (!keys) {
24
+ keys = new Set();
25
+ this.#alternateKeys.set(item, keys);
26
+ }
27
+ keys.add(hash);
53
28
  }
54
- const newStore = new Map();
55
- this.#registry.set(meta.class, newStore);
56
- return newStore;
57
- }
58
- clear() {
59
- this.#registry.clear();
60
- }
61
- /** Returns all entities currently in the identity map. */
62
- values() {
63
- const ret = [];
64
- for (const store of this.#registry.values()) {
65
- ret.push(...store.values());
29
+ /** Removes an entity and its alternate key entries from the identity map. */
30
+ delete(item) {
31
+ const meta = item.__meta.root;
32
+ const store = this.getStore(meta);
33
+ store.delete(this.getPkHash(item));
34
+ // Also delete any alternate key entries for this entity
35
+ const altKeys = this.#alternateKeys.get(item);
36
+ if (altKeys) {
37
+ for (const hash of altKeys) {
38
+ store.delete(hash);
39
+ }
40
+ this.#alternateKeys.delete(item);
41
+ }
66
42
  }
67
- return ret;
68
- }
69
- *[Symbol.iterator]() {
70
- for (const store of this.#registry.values()) {
71
- for (const item of store.values()) {
72
- yield item;
73
- }
43
+ /** Retrieves an entity by its hash key from the identity map. */
44
+ getByHash(meta, hash) {
45
+ const store = this.getStore(meta);
46
+ return store.has(hash) ? store.get(hash) : undefined;
74
47
  }
75
- }
76
- /** Returns all hash keys currently in the identity map. */
77
- keys() {
78
- const ret = [];
79
- for (const [cls, store] of this.#registry) {
80
- ret.push(...[...store.keys()].map(hash => `${cls.name}-${hash}`));
48
+ /** Returns (or creates) the per-entity-class store within the identity map. */
49
+ getStore(meta) {
50
+ const store = this.#registry.get(meta.class);
51
+ if (store) {
52
+ return store;
53
+ }
54
+ const newStore = new Map();
55
+ this.#registry.set(meta.class, newStore);
56
+ return newStore;
81
57
  }
82
- return ret;
83
- }
84
- /**
85
- * For back compatibility only.
86
- */
87
- get(hash) {
88
- const [name, id] = hash.split('-', 2);
89
- const cls = [...this.#registry.keys()].find(k => k.name === name);
90
- if (!cls) {
91
- return undefined;
58
+ clear() {
59
+ this.#registry.clear();
92
60
  }
93
- const store = this.#registry.get(cls);
94
- return store.has(id) ? store.get(id) : undefined;
95
- }
96
- getPkHash(item) {
97
- const wrapped = item.__helper;
98
- const meta = wrapped.__meta;
99
- const hash = wrapped.getSerializedPrimaryKey();
100
- const schema = wrapped.__schema ?? meta.root.schema ?? this.#defaultSchema;
101
- if (schema) {
102
- return schema + ':' + hash;
61
+ /** Returns all entities currently in the identity map. */
62
+ values() {
63
+ const ret = [];
64
+ for (const store of this.#registry.values()) {
65
+ ret.push(...store.values());
66
+ }
67
+ return ret;
103
68
  }
104
- return hash;
105
- }
106
- /**
107
- * Creates a hash for an alternate key lookup.
108
- * Format: `[key]value` or `schema:[key]value`
109
- */
110
- getKeyHash(key, value, schema) {
111
- const hash = `[${key}]${value}`;
112
- if (schema) {
113
- return schema + ':' + hash;
69
+ *[Symbol.iterator]() {
70
+ for (const store of this.#registry.values()) {
71
+ for (const item of store.values()) {
72
+ yield item;
73
+ }
74
+ }
75
+ }
76
+ /** Returns all hash keys currently in the identity map. */
77
+ keys() {
78
+ const ret = [];
79
+ for (const [cls, store] of this.#registry) {
80
+ ret.push(...[...store.keys()].map(hash => `${cls.name}-${hash}`));
81
+ }
82
+ return ret;
83
+ }
84
+ /**
85
+ * For back compatibility only.
86
+ */
87
+ get(hash) {
88
+ const [name, id] = hash.split('-', 2);
89
+ const cls = [...this.#registry.keys()].find(k => k.name === name);
90
+ if (!cls) {
91
+ return undefined;
92
+ }
93
+ const store = this.#registry.get(cls);
94
+ return store.has(id) ? store.get(id) : undefined;
95
+ }
96
+ getPkHash(item) {
97
+ const wrapped = item.__helper;
98
+ const meta = wrapped.__meta;
99
+ const hash = wrapped.getSerializedPrimaryKey();
100
+ const schema = wrapped.__schema ?? meta.root.schema ?? this.#defaultSchema;
101
+ if (schema) {
102
+ return schema + ':' + hash;
103
+ }
104
+ return hash;
105
+ }
106
+ /**
107
+ * Creates a hash for an alternate key lookup.
108
+ * Format: `[key]value` or `schema:[key]value`
109
+ */
110
+ getKeyHash(key, value, schema) {
111
+ const hash = `[${key}]${value}`;
112
+ if (schema) {
113
+ return schema + ':' + hash;
114
+ }
115
+ return hash;
114
116
  }
115
- return hash;
116
- }
117
117
  }