@mikro-orm/core 7.0.4-dev.8 → 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
@@ -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,96 +16,97 @@ 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);
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;
28
47
  }
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() });
48
+ const propertyType = prop.targetMeta?.root._id;
49
+ if (propertyType == null || !this.hasNode(propertyType)) {
50
+ return;
34
51
  }
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 });
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);
40
66
  }
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);
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
+ }
52
90
  }
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;
91
+ if (node.state !== 2 /* NodeState.VISITED */) {
92
+ node.state = 2 /* NodeState.VISITED */;
93
+ this.#sortedNodeList.push(node.hash);
70
94
  }
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
- }
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;
94
102
  }
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);
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
+ }
110
108
  }
109
+ target.state = 2 /* NodeState.VISITED */;
110
+ this.#sortedNodeList.push(target.hash);
111
+ }
111
112
  }
@@ -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;
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);
9
26
  }
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);
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);
13
41
  }
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);
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;
28
53
  }
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
- }
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());
42
66
  }
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;
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
+ }
47
74
  }
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;
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}`));
57
81
  }
58
- clear() {
59
- this.#registry.clear();
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;
60
92
  }
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;
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;
68
103
  }
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;
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;
116
114
  }
115
+ return hash;
116
+ }
117
117
  }