@mikro-orm/core 7.0.4 → 7.0.5-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.
- package/EntityManager.d.ts +583 -884
- package/EntityManager.js +1895 -1922
- package/MikroORM.d.ts +74 -103
- package/MikroORM.js +179 -178
- package/README.md +1 -1
- package/cache/CacheAdapter.d.ts +36 -36
- package/cache/FileCacheAdapter.d.ts +24 -30
- package/cache/FileCacheAdapter.js +78 -80
- package/cache/GeneratedCacheAdapter.d.ts +20 -18
- package/cache/GeneratedCacheAdapter.js +30 -30
- package/cache/MemoryCacheAdapter.d.ts +20 -18
- package/cache/MemoryCacheAdapter.js +36 -35
- package/cache/NullCacheAdapter.d.ts +16 -16
- package/cache/NullCacheAdapter.js +24 -24
- package/connections/Connection.d.ts +84 -95
- package/connections/Connection.js +168 -165
- package/drivers/DatabaseDriver.d.ts +80 -186
- package/drivers/DatabaseDriver.js +443 -450
- package/drivers/IDatabaseDriver.d.ts +301 -440
- package/entity/BaseEntity.d.ts +83 -120
- package/entity/BaseEntity.js +43 -43
- package/entity/Collection.d.ts +179 -212
- package/entity/Collection.js +721 -727
- package/entity/EntityAssigner.d.ts +77 -88
- package/entity/EntityAssigner.js +230 -231
- package/entity/EntityFactory.d.ts +54 -66
- package/entity/EntityFactory.js +383 -425
- package/entity/EntityHelper.d.ts +22 -34
- package/entity/EntityHelper.js +267 -280
- package/entity/EntityIdentifier.d.ts +4 -4
- package/entity/EntityIdentifier.js +10 -10
- package/entity/EntityLoader.d.ts +72 -98
- package/entity/EntityLoader.js +723 -753
- package/entity/EntityRepository.d.ts +201 -316
- package/entity/EntityRepository.js +213 -213
- package/entity/PolymorphicRef.d.ts +5 -5
- package/entity/PolymorphicRef.js +10 -10
- package/entity/Reference.d.ts +82 -126
- package/entity/Reference.js +274 -278
- package/entity/WrappedEntity.d.ts +72 -115
- package/entity/WrappedEntity.js +166 -168
- package/entity/defineEntity.d.ts +636 -1315
- package/entity/defineEntity.js +518 -527
- package/entity/utils.d.ts +3 -13
- package/entity/utils.js +73 -71
- package/entity/validators.js +43 -43
- package/entity/wrap.js +8 -8
- package/enums.d.ts +253 -258
- package/enums.js +252 -251
- package/errors.d.ts +72 -114
- package/errors.js +253 -350
- package/events/EventManager.d.ts +14 -26
- package/events/EventManager.js +77 -79
- package/events/EventSubscriber.d.ts +29 -29
- package/events/TransactionEventBroadcaster.d.ts +8 -15
- package/events/TransactionEventBroadcaster.js +14 -14
- package/exceptions.d.ts +40 -23
- package/exceptions.js +52 -35
- package/hydration/Hydrator.d.ts +17 -42
- package/hydration/Hydrator.js +43 -43
- package/hydration/ObjectHydrator.d.ts +17 -50
- package/hydration/ObjectHydrator.js +416 -481
- package/index.d.ts +2 -116
- package/index.js +1 -10
- package/logging/DefaultLogger.d.ts +32 -34
- package/logging/DefaultLogger.js +86 -86
- package/logging/Logger.d.ts +41 -41
- package/logging/SimpleLogger.d.ts +11 -13
- package/logging/SimpleLogger.js +22 -22
- package/logging/colors.d.ts +6 -6
- package/logging/colors.js +10 -11
- package/logging/inspect.js +7 -7
- package/metadata/EntitySchema.d.ts +127 -211
- package/metadata/EntitySchema.js +398 -397
- package/metadata/MetadataDiscovery.d.ts +114 -114
- package/metadata/MetadataDiscovery.js +1870 -1951
- package/metadata/MetadataProvider.d.ts +21 -24
- package/metadata/MetadataProvider.js +84 -82
- package/metadata/MetadataStorage.d.ts +32 -38
- package/metadata/MetadataStorage.js +118 -118
- package/metadata/MetadataValidator.d.ts +39 -39
- package/metadata/MetadataValidator.js +338 -381
- package/metadata/discover-entities.d.ts +2 -5
- package/metadata/discover-entities.js +37 -35
- package/metadata/types.d.ts +531 -615
- package/naming-strategy/AbstractNamingStrategy.d.ts +39 -54
- package/naming-strategy/AbstractNamingStrategy.js +85 -90
- package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
- package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
- package/naming-strategy/MongoNamingStrategy.d.ts +6 -6
- package/naming-strategy/MongoNamingStrategy.js +18 -18
- package/naming-strategy/NamingStrategy.d.ts +99 -109
- package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
- package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
- package/not-supported.js +4 -7
- package/package.json +1 -1
- package/platforms/ExceptionConverter.d.ts +1 -1
- package/platforms/ExceptionConverter.js +4 -4
- package/platforms/Platform.d.ts +301 -310
- package/platforms/Platform.js +640 -663
- package/serialization/EntitySerializer.d.ts +26 -49
- package/serialization/EntitySerializer.js +218 -224
- package/serialization/EntityTransformer.d.ts +6 -10
- package/serialization/EntityTransformer.js +217 -219
- package/serialization/SerializationContext.d.ts +23 -27
- package/serialization/SerializationContext.js +105 -105
- package/types/ArrayType.d.ts +8 -8
- package/types/ArrayType.js +33 -33
- package/types/BigIntType.d.ts +10 -17
- package/types/BigIntType.js +37 -37
- package/types/BlobType.d.ts +3 -3
- package/types/BlobType.js +13 -13
- package/types/BooleanType.d.ts +4 -4
- package/types/BooleanType.js +12 -12
- package/types/CharacterType.d.ts +2 -2
- package/types/CharacterType.js +6 -6
- package/types/DateTimeType.d.ts +5 -5
- package/types/DateTimeType.js +15 -15
- package/types/DateType.d.ts +5 -5
- package/types/DateType.js +15 -15
- package/types/DecimalType.d.ts +7 -7
- package/types/DecimalType.js +26 -26
- package/types/DoubleType.d.ts +3 -3
- package/types/DoubleType.js +12 -12
- package/types/EnumArrayType.d.ts +5 -5
- package/types/EnumArrayType.js +24 -24
- package/types/EnumType.d.ts +3 -3
- package/types/EnumType.js +11 -11
- package/types/FloatType.d.ts +3 -3
- package/types/FloatType.js +9 -9
- package/types/IntegerType.d.ts +3 -3
- package/types/IntegerType.js +9 -9
- package/types/IntervalType.d.ts +4 -4
- package/types/IntervalType.js +12 -12
- package/types/JsonType.d.ts +8 -8
- package/types/JsonType.js +32 -32
- package/types/MediumIntType.d.ts +1 -1
- package/types/MediumIntType.js +3 -3
- package/types/SmallIntType.d.ts +3 -3
- package/types/SmallIntType.js +9 -9
- package/types/StringType.d.ts +4 -4
- package/types/StringType.js +12 -12
- package/types/TextType.d.ts +3 -3
- package/types/TextType.js +9 -9
- package/types/TimeType.d.ts +5 -5
- package/types/TimeType.js +17 -17
- package/types/TinyIntType.d.ts +3 -3
- package/types/TinyIntType.js +10 -10
- package/types/Type.d.ts +79 -83
- package/types/Type.js +82 -82
- package/types/Uint8ArrayType.d.ts +4 -4
- package/types/Uint8ArrayType.js +21 -21
- package/types/UnknownType.d.ts +4 -4
- package/types/UnknownType.js +12 -12
- package/types/UuidType.d.ts +5 -5
- package/types/UuidType.js +19 -19
- package/types/index.d.ts +49 -75
- package/types/index.js +26 -52
- package/typings.d.ts +737 -1250
- package/typings.js +231 -244
- package/unit-of-work/ChangeSet.d.ts +26 -26
- package/unit-of-work/ChangeSet.js +56 -56
- package/unit-of-work/ChangeSetComputer.d.ts +12 -12
- package/unit-of-work/ChangeSetComputer.js +170 -178
- package/unit-of-work/ChangeSetPersister.d.ts +44 -63
- package/unit-of-work/ChangeSetPersister.js +421 -442
- package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
- package/unit-of-work/CommitOrderCalculator.js +88 -89
- package/unit-of-work/IdentityMap.d.ts +31 -31
- package/unit-of-work/IdentityMap.js +105 -105
- package/unit-of-work/UnitOfWork.d.ts +141 -181
- package/unit-of-work/UnitOfWork.js +1183 -1200
- package/utils/AbstractMigrator.d.ts +91 -111
- package/utils/AbstractMigrator.js +275 -275
- package/utils/AbstractSchemaGenerator.d.ts +34 -43
- package/utils/AbstractSchemaGenerator.js +122 -121
- package/utils/AsyncContext.d.ts +3 -3
- package/utils/AsyncContext.js +35 -34
- package/utils/Configuration.d.ts +808 -852
- package/utils/Configuration.js +344 -359
- package/utils/Cursor.d.ts +22 -40
- package/utils/Cursor.js +127 -135
- package/utils/DataloaderUtils.d.ts +43 -58
- package/utils/DataloaderUtils.js +198 -203
- package/utils/EntityComparator.d.ts +81 -98
- package/utils/EntityComparator.js +732 -828
- package/utils/NullHighlighter.d.ts +1 -1
- package/utils/NullHighlighter.js +3 -3
- package/utils/QueryHelper.d.ts +51 -79
- package/utils/QueryHelper.js +361 -372
- package/utils/RawQueryFragment.d.ts +34 -50
- package/utils/RawQueryFragment.js +105 -107
- package/utils/RequestContext.d.ts +32 -32
- package/utils/RequestContext.js +53 -52
- package/utils/TransactionContext.d.ts +16 -16
- package/utils/TransactionContext.js +27 -27
- package/utils/TransactionManager.d.ts +58 -58
- package/utils/TransactionManager.js +197 -199
- package/utils/Utils.d.ts +145 -204
- package/utils/Utils.js +812 -812
- package/utils/clone.js +113 -104
- package/utils/env-vars.js +88 -90
- package/utils/fs-utils.d.ts +15 -15
- package/utils/fs-utils.js +181 -180
- package/utils/upsert-utils.d.ts +5 -20
- 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
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
NOT_VISITED = 0,
|
|
4
|
+
IN_PROGRESS = 1,
|
|
5
|
+
VISITED = 2
|
|
6
6
|
}
|
|
7
7
|
type Hash = number;
|
|
8
8
|
export interface Node {
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
hash: Hash;
|
|
10
|
+
state: NodeState;
|
|
11
|
+
dependencies: Map<Hash, Edge>;
|
|
12
12
|
}
|
|
13
13
|
export interface Edge {
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
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
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
-
|
|
49
|
-
|
|
50
|
-
|
|
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
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
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
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
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
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
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
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
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
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
28
|
-
|
|
29
|
-
|
|
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
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
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
|
-
|
|
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
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
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
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
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
|
}
|