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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/EntityManager.d.ts +583 -883
  2. package/EntityManager.js +1869 -1897
  3. package/MikroORM.d.ts +74 -103
  4. package/MikroORM.js +179 -178
  5. package/cache/CacheAdapter.d.ts +36 -36
  6. package/cache/FileCacheAdapter.d.ts +24 -30
  7. package/cache/FileCacheAdapter.js +78 -80
  8. package/cache/GeneratedCacheAdapter.d.ts +20 -18
  9. package/cache/GeneratedCacheAdapter.js +30 -30
  10. package/cache/MemoryCacheAdapter.d.ts +20 -18
  11. package/cache/MemoryCacheAdapter.js +36 -35
  12. package/cache/NullCacheAdapter.d.ts +16 -16
  13. package/cache/NullCacheAdapter.js +24 -24
  14. package/connections/Connection.d.ts +84 -95
  15. package/connections/Connection.js +168 -165
  16. package/drivers/DatabaseDriver.d.ts +80 -186
  17. package/drivers/DatabaseDriver.js +443 -450
  18. package/drivers/IDatabaseDriver.d.ts +301 -440
  19. package/entity/BaseEntity.d.ts +83 -120
  20. package/entity/BaseEntity.js +43 -43
  21. package/entity/Collection.d.ts +179 -212
  22. package/entity/Collection.js +721 -727
  23. package/entity/EntityAssigner.d.ts +77 -88
  24. package/entity/EntityAssigner.js +230 -231
  25. package/entity/EntityFactory.d.ts +54 -66
  26. package/entity/EntityFactory.js +383 -425
  27. package/entity/EntityHelper.d.ts +22 -34
  28. package/entity/EntityHelper.js +267 -280
  29. package/entity/EntityIdentifier.d.ts +4 -4
  30. package/entity/EntityIdentifier.js +10 -10
  31. package/entity/EntityLoader.d.ts +73 -103
  32. package/entity/EntityLoader.js +723 -753
  33. package/entity/EntityRepository.d.ts +201 -316
  34. package/entity/EntityRepository.js +213 -213
  35. package/entity/PolymorphicRef.d.ts +5 -5
  36. package/entity/PolymorphicRef.js +10 -10
  37. package/entity/Reference.d.ts +82 -126
  38. package/entity/Reference.js +274 -278
  39. package/entity/WrappedEntity.d.ts +72 -115
  40. package/entity/WrappedEntity.js +166 -168
  41. package/entity/defineEntity.d.ts +614 -1280
  42. package/entity/defineEntity.js +511 -520
  43. package/entity/utils.d.ts +3 -13
  44. package/entity/utils.js +73 -71
  45. package/entity/validators.js +43 -43
  46. package/entity/wrap.js +8 -8
  47. package/enums.d.ts +253 -258
  48. package/enums.js +252 -251
  49. package/errors.d.ts +72 -114
  50. package/errors.js +253 -350
  51. package/events/EventManager.d.ts +14 -26
  52. package/events/EventManager.js +77 -79
  53. package/events/EventSubscriber.d.ts +29 -29
  54. package/events/TransactionEventBroadcaster.d.ts +8 -15
  55. package/events/TransactionEventBroadcaster.js +14 -14
  56. package/exceptions.d.ts +40 -23
  57. package/exceptions.js +52 -35
  58. package/hydration/Hydrator.d.ts +17 -42
  59. package/hydration/Hydrator.js +43 -43
  60. package/hydration/ObjectHydrator.d.ts +17 -50
  61. package/hydration/ObjectHydrator.js +416 -479
  62. package/index.d.ts +2 -116
  63. package/index.js +1 -10
  64. package/logging/DefaultLogger.d.ts +32 -34
  65. package/logging/DefaultLogger.js +86 -86
  66. package/logging/Logger.d.ts +41 -41
  67. package/logging/SimpleLogger.d.ts +11 -13
  68. package/logging/SimpleLogger.js +22 -22
  69. package/logging/colors.d.ts +6 -6
  70. package/logging/colors.js +10 -11
  71. package/logging/inspect.js +7 -7
  72. package/metadata/EntitySchema.d.ts +127 -211
  73. package/metadata/EntitySchema.js +398 -397
  74. package/metadata/MetadataDiscovery.d.ts +114 -114
  75. package/metadata/MetadataDiscovery.js +1863 -1947
  76. package/metadata/MetadataProvider.d.ts +21 -24
  77. package/metadata/MetadataProvider.js +84 -82
  78. package/metadata/MetadataStorage.d.ts +32 -38
  79. package/metadata/MetadataStorage.js +118 -118
  80. package/metadata/MetadataValidator.d.ts +39 -39
  81. package/metadata/MetadataValidator.js +338 -381
  82. package/metadata/discover-entities.d.ts +2 -5
  83. package/metadata/discover-entities.js +27 -27
  84. package/metadata/types.d.ts +531 -615
  85. package/naming-strategy/AbstractNamingStrategy.d.ts +39 -54
  86. package/naming-strategy/AbstractNamingStrategy.js +85 -90
  87. package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
  88. package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
  89. package/naming-strategy/MongoNamingStrategy.d.ts +6 -6
  90. package/naming-strategy/MongoNamingStrategy.js +18 -18
  91. package/naming-strategy/NamingStrategy.d.ts +99 -109
  92. package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
  93. package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
  94. package/not-supported.js +4 -7
  95. package/package.json +1 -1
  96. package/platforms/ExceptionConverter.d.ts +1 -1
  97. package/platforms/ExceptionConverter.js +4 -4
  98. package/platforms/Platform.d.ts +299 -308
  99. package/platforms/Platform.js +636 -659
  100. package/serialization/EntitySerializer.d.ts +26 -48
  101. package/serialization/EntitySerializer.js +218 -224
  102. package/serialization/EntityTransformer.d.ts +6 -10
  103. package/serialization/EntityTransformer.js +217 -219
  104. package/serialization/SerializationContext.d.ts +23 -27
  105. package/serialization/SerializationContext.js +105 -105
  106. package/types/ArrayType.d.ts +8 -8
  107. package/types/ArrayType.js +33 -33
  108. package/types/BigIntType.d.ts +10 -17
  109. package/types/BigIntType.js +37 -37
  110. package/types/BlobType.d.ts +3 -3
  111. package/types/BlobType.js +13 -13
  112. package/types/BooleanType.d.ts +4 -4
  113. package/types/BooleanType.js +12 -12
  114. package/types/CharacterType.d.ts +2 -2
  115. package/types/CharacterType.js +6 -6
  116. package/types/DateTimeType.d.ts +5 -5
  117. package/types/DateTimeType.js +15 -15
  118. package/types/DateType.d.ts +5 -5
  119. package/types/DateType.js +15 -15
  120. package/types/DecimalType.d.ts +7 -7
  121. package/types/DecimalType.js +26 -26
  122. package/types/DoubleType.d.ts +3 -3
  123. package/types/DoubleType.js +12 -12
  124. package/types/EnumArrayType.d.ts +5 -5
  125. package/types/EnumArrayType.js +24 -24
  126. package/types/EnumType.d.ts +3 -3
  127. package/types/EnumType.js +11 -11
  128. package/types/FloatType.d.ts +3 -3
  129. package/types/FloatType.js +9 -9
  130. package/types/IntegerType.d.ts +3 -3
  131. package/types/IntegerType.js +9 -9
  132. package/types/IntervalType.d.ts +4 -4
  133. package/types/IntervalType.js +12 -12
  134. package/types/JsonType.d.ts +8 -8
  135. package/types/JsonType.js +32 -32
  136. package/types/MediumIntType.d.ts +1 -1
  137. package/types/MediumIntType.js +3 -3
  138. package/types/SmallIntType.d.ts +3 -3
  139. package/types/SmallIntType.js +9 -9
  140. package/types/StringType.d.ts +4 -4
  141. package/types/StringType.js +12 -12
  142. package/types/TextType.d.ts +3 -3
  143. package/types/TextType.js +9 -9
  144. package/types/TimeType.d.ts +5 -5
  145. package/types/TimeType.js +17 -17
  146. package/types/TinyIntType.d.ts +3 -3
  147. package/types/TinyIntType.js +10 -10
  148. package/types/Type.d.ts +79 -83
  149. package/types/Type.js +82 -82
  150. package/types/Uint8ArrayType.d.ts +4 -4
  151. package/types/Uint8ArrayType.js +21 -21
  152. package/types/UnknownType.d.ts +4 -4
  153. package/types/UnknownType.js +12 -12
  154. package/types/UuidType.d.ts +5 -5
  155. package/types/UuidType.js +19 -19
  156. package/types/index.d.ts +49 -75
  157. package/types/index.js +26 -52
  158. package/typings.d.ts +729 -1211
  159. package/typings.js +231 -244
  160. package/unit-of-work/ChangeSet.d.ts +26 -26
  161. package/unit-of-work/ChangeSet.js +56 -56
  162. package/unit-of-work/ChangeSetComputer.d.ts +12 -12
  163. package/unit-of-work/ChangeSetComputer.js +170 -178
  164. package/unit-of-work/ChangeSetPersister.d.ts +44 -63
  165. package/unit-of-work/ChangeSetPersister.js +421 -442
  166. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  167. package/unit-of-work/CommitOrderCalculator.js +88 -89
  168. package/unit-of-work/IdentityMap.d.ts +31 -31
  169. package/unit-of-work/IdentityMap.js +105 -105
  170. package/unit-of-work/UnitOfWork.d.ts +141 -181
  171. package/unit-of-work/UnitOfWork.js +1183 -1200
  172. package/utils/AbstractMigrator.d.ts +91 -111
  173. package/utils/AbstractMigrator.js +275 -275
  174. package/utils/AbstractSchemaGenerator.d.ts +34 -43
  175. package/utils/AbstractSchemaGenerator.js +122 -121
  176. package/utils/AsyncContext.d.ts +3 -3
  177. package/utils/AsyncContext.js +35 -34
  178. package/utils/Configuration.d.ts +808 -852
  179. package/utils/Configuration.js +344 -359
  180. package/utils/Cursor.d.ts +22 -40
  181. package/utils/Cursor.js +127 -135
  182. package/utils/DataloaderUtils.d.ts +43 -58
  183. package/utils/DataloaderUtils.js +198 -203
  184. package/utils/EntityComparator.d.ts +81 -98
  185. package/utils/EntityComparator.js +728 -824
  186. package/utils/NullHighlighter.d.ts +1 -1
  187. package/utils/NullHighlighter.js +3 -3
  188. package/utils/QueryHelper.d.ts +51 -79
  189. package/utils/QueryHelper.js +361 -372
  190. package/utils/RawQueryFragment.d.ts +34 -50
  191. package/utils/RawQueryFragment.js +105 -107
  192. package/utils/RequestContext.d.ts +32 -32
  193. package/utils/RequestContext.js +53 -52
  194. package/utils/TransactionContext.d.ts +16 -16
  195. package/utils/TransactionContext.js +27 -27
  196. package/utils/TransactionManager.d.ts +58 -58
  197. package/utils/TransactionManager.js +197 -199
  198. package/utils/Utils.d.ts +145 -204
  199. package/utils/Utils.js +813 -814
  200. package/utils/clone.js +113 -104
  201. package/utils/env-vars.js +88 -90
  202. package/utils/fs-utils.d.ts +15 -15
  203. package/utils/fs-utils.js +181 -180
  204. package/utils/upsert-utils.d.ts +5 -20
  205. package/utils/upsert-utils.js +116 -114
package/enums.js CHANGED
@@ -1,325 +1,326 @@
1
1
  /** Controls when the `EntityManager` flushes pending changes to the database. */
2
2
  export var FlushMode;
3
3
  (function (FlushMode) {
4
- /** The `EntityManager` delays the flush until the current Transaction is committed. */
5
- FlushMode['COMMIT'] = 'commit';
6
- /** This is the default mode, and it flushes the `EntityManager` only if necessary. */
7
- FlushMode['AUTO'] = 'auto';
8
- /** Flushes the `EntityManager` before every query. */
9
- FlushMode['ALWAYS'] = 'always';
4
+ /** The `EntityManager` delays the flush until the current Transaction is committed. */
5
+ FlushMode["COMMIT"] = "commit";
6
+ /** This is the default mode, and it flushes the `EntityManager` only if necessary. */
7
+ FlushMode["AUTO"] = "auto";
8
+ /** Flushes the `EntityManager` before every query. */
9
+ FlushMode["ALWAYS"] = "always";
10
10
  })(FlushMode || (FlushMode = {}));
11
11
  /** Controls how populate hints are resolved when using `FindOptions.populateWhere`. */
12
12
  export var PopulateHint;
13
13
  (function (PopulateHint) {
14
- /** Infer population hints from the `where` condition. */
15
- PopulateHint['INFER'] = 'infer';
16
- /** Apply population hints to all relations. */
17
- PopulateHint['ALL'] = 'all';
14
+ /** Infer population hints from the `where` condition. */
15
+ PopulateHint["INFER"] = "infer";
16
+ /** Apply population hints to all relations. */
17
+ PopulateHint["ALL"] = "all";
18
18
  })(PopulateHint || (PopulateHint = {}));
19
19
  /** Special tokens used as populate path values in `FindOptions.populate`. */
20
20
  export var PopulatePath;
21
21
  (function (PopulatePath) {
22
- /** Infer which relations to populate based on fields accessed in the `where` or `orderBy` clause. */
23
- PopulatePath['INFER'] = '$infer';
24
- /** Populate all relations. */
25
- PopulatePath['ALL'] = '*';
22
+ /** Infer which relations to populate based on fields accessed in the `where` or `orderBy` clause. */
23
+ PopulatePath["INFER"] = "$infer";
24
+ /** Populate all relations. */
25
+ PopulatePath["ALL"] = "*";
26
26
  })(PopulatePath || (PopulatePath = {}));
27
27
  /** Logical grouping operators for combining query conditions. */
28
28
  export var GroupOperator;
29
29
  (function (GroupOperator) {
30
- /** Logical AND — all conditions must match. */
31
- GroupOperator['$and'] = 'and';
32
- /** Logical OR — at least one condition must match. */
33
- GroupOperator['$or'] = 'or';
30
+ /** Logical AND — all conditions must match. */
31
+ GroupOperator["$and"] = "and";
32
+ /** Logical OR — at least one condition must match. */
33
+ GroupOperator["$or"] = "or";
34
34
  })(GroupOperator || (GroupOperator = {}));
35
35
  /** Comparison and filtering operators used in query conditions. */
36
36
  export var QueryOperator;
37
37
  (function (QueryOperator) {
38
- /** Equal. */
39
- QueryOperator['$eq'] = '=';
40
- /** Included in the given list. */
41
- QueryOperator['$in'] = 'in';
42
- /** Not included in the given list. */
43
- QueryOperator['$nin'] = 'not in';
44
- /** Greater than. */
45
- QueryOperator['$gt'] = '>';
46
- /** Greater than or equal to. */
47
- QueryOperator['$gte'] = '>=';
48
- /** Less than. */
49
- QueryOperator['$lt'] = '<';
50
- /** Less than or equal to. */
51
- QueryOperator['$lte'] = '<=';
52
- /** Not equal. */
53
- QueryOperator['$ne'] = '!=';
54
- /** Negation wrapper. */
55
- QueryOperator['$not'] = 'not';
56
- /** SQL LIKE pattern matching. */
57
- QueryOperator['$like'] = 'like';
58
- /** Regular expression matching. */
59
- QueryOperator['$re'] = 'regexp';
60
- /** Full-text search. */
61
- QueryOperator['$fulltext'] = 'fulltext';
62
- /** Checks that the value is not null (i.e., exists). */
63
- QueryOperator['$exists'] = 'not null';
64
- /** Case-insensitive LIKE (PostgreSQL only). */
65
- QueryOperator['$ilike'] = 'ilike';
66
- /** Array overlap operator (PostgreSQL only). */
67
- QueryOperator['$overlap'] = '&&';
68
- /** Array/JSON contains operator (PostgreSQL only). */
69
- QueryOperator['$contains'] = '@>';
70
- /** Array/JSON contained-by operator (PostgreSQL only). */
71
- QueryOperator['$contained'] = '<@';
72
- /** No element in the collection matches (SQL only). */
73
- QueryOperator['$none'] = 'none';
74
- /** At least one element in the collection matches (SQL only). */
75
- QueryOperator['$some'] = 'some';
76
- /** Every element in the collection matches (SQL only). */
77
- QueryOperator['$every'] = 'every';
78
- /** Matches collections by their size (SQL only). */
79
- QueryOperator['$size'] = 'size';
80
- /** JSON object has the given key (PostgreSQL only). */
81
- QueryOperator['$hasKey'] = '?';
82
- /** JSON object has all of the given keys (PostgreSQL only). */
83
- QueryOperator['$hasKeys'] = '?&';
84
- /** JSON object has at least one of the given keys (PostgreSQL only). */
85
- QueryOperator['$hasSomeKeys'] = '?|';
86
- /** Matches an element inside a JSON array (SQL only). */
87
- QueryOperator['$elemMatch'] = 'elemMatch';
38
+ /** Equal. */
39
+ QueryOperator["$eq"] = "=";
40
+ /** Included in the given list. */
41
+ QueryOperator["$in"] = "in";
42
+ /** Not included in the given list. */
43
+ QueryOperator["$nin"] = "not in";
44
+ /** Greater than. */
45
+ QueryOperator["$gt"] = ">";
46
+ /** Greater than or equal to. */
47
+ QueryOperator["$gte"] = ">=";
48
+ /** Less than. */
49
+ QueryOperator["$lt"] = "<";
50
+ /** Less than or equal to. */
51
+ QueryOperator["$lte"] = "<=";
52
+ /** Not equal. */
53
+ QueryOperator["$ne"] = "!=";
54
+ /** Negation wrapper. */
55
+ QueryOperator["$not"] = "not";
56
+ /** SQL LIKE pattern matching. */
57
+ QueryOperator["$like"] = "like";
58
+ /** Regular expression matching. */
59
+ QueryOperator["$re"] = "regexp";
60
+ /** Full-text search. */
61
+ QueryOperator["$fulltext"] = "fulltext";
62
+ /** Checks that the value is not null (i.e., exists). */
63
+ QueryOperator["$exists"] = "not null";
64
+ /** Case-insensitive LIKE (PostgreSQL only). */
65
+ QueryOperator["$ilike"] = "ilike";
66
+ /** Array overlap operator (PostgreSQL only). */
67
+ QueryOperator["$overlap"] = "&&";
68
+ /** Array/JSON contains operator (PostgreSQL only). */
69
+ QueryOperator["$contains"] = "@>";
70
+ /** Array/JSON contained-by operator (PostgreSQL only). */
71
+ QueryOperator["$contained"] = "<@";
72
+ /** No element in the collection matches (SQL only). */
73
+ QueryOperator["$none"] = "none";
74
+ /** At least one element in the collection matches (SQL only). */
75
+ QueryOperator["$some"] = "some";
76
+ /** Every element in the collection matches (SQL only). */
77
+ QueryOperator["$every"] = "every";
78
+ /** Matches collections by their size (SQL only). */
79
+ QueryOperator["$size"] = "size";
80
+ /** JSON object has the given key (PostgreSQL only). */
81
+ QueryOperator["$hasKey"] = "?";
82
+ /** JSON object has all of the given keys (PostgreSQL only). */
83
+ QueryOperator["$hasKeys"] = "?&";
84
+ /** JSON object has at least one of the given keys (PostgreSQL only). */
85
+ QueryOperator["$hasSomeKeys"] = "?|";
86
+ /** Matches an element inside a JSON array (SQL only). */
87
+ QueryOperator["$elemMatch"] = "elemMatch";
88
88
  })(QueryOperator || (QueryOperator = {}));
89
89
  export const ARRAY_OPERATORS = ['$eq', '$gt', '$gte', '$lt', '$lte', '$ne', '$overlap', '$contains', '$contained'];
90
90
  export const JSON_KEY_OPERATORS = ['$hasKey', '$hasKeys', '$hasSomeKeys'];
91
91
  /** Sort direction for query results. Both upper- and lower-case variants are accepted. */
92
92
  export var QueryOrder;
93
93
  (function (QueryOrder) {
94
- /** Ascending order. */
95
- QueryOrder['ASC'] = 'ASC';
96
- /** Ascending order with nulls sorted last. */
97
- QueryOrder['ASC_NULLS_LAST'] = 'ASC NULLS LAST';
98
- /** Ascending order with nulls sorted first. */
99
- QueryOrder['ASC_NULLS_FIRST'] = 'ASC NULLS FIRST';
100
- /** Descending order. */
101
- QueryOrder['DESC'] = 'DESC';
102
- /** Descending order with nulls sorted last. */
103
- QueryOrder['DESC_NULLS_LAST'] = 'DESC NULLS LAST';
104
- /** Descending order with nulls sorted first. */
105
- QueryOrder['DESC_NULLS_FIRST'] = 'DESC NULLS FIRST';
106
- /** Ascending order (lower-case variant). */
107
- QueryOrder['asc'] = 'asc';
108
- /** Ascending order with nulls sorted last (lower-case variant). */
109
- QueryOrder['asc_nulls_last'] = 'asc nulls last';
110
- /** Ascending order with nulls sorted first (lower-case variant). */
111
- QueryOrder['asc_nulls_first'] = 'asc nulls first';
112
- /** Descending order (lower-case variant). */
113
- QueryOrder['desc'] = 'desc';
114
- /** Descending order with nulls sorted last (lower-case variant). */
115
- QueryOrder['desc_nulls_last'] = 'desc nulls last';
116
- /** Descending order with nulls sorted first (lower-case variant). */
117
- QueryOrder['desc_nulls_first'] = 'desc nulls first';
94
+ /** Ascending order. */
95
+ QueryOrder["ASC"] = "ASC";
96
+ /** Ascending order with nulls sorted last. */
97
+ QueryOrder["ASC_NULLS_LAST"] = "ASC NULLS LAST";
98
+ /** Ascending order with nulls sorted first. */
99
+ QueryOrder["ASC_NULLS_FIRST"] = "ASC NULLS FIRST";
100
+ /** Descending order. */
101
+ QueryOrder["DESC"] = "DESC";
102
+ /** Descending order with nulls sorted last. */
103
+ QueryOrder["DESC_NULLS_LAST"] = "DESC NULLS LAST";
104
+ /** Descending order with nulls sorted first. */
105
+ QueryOrder["DESC_NULLS_FIRST"] = "DESC NULLS FIRST";
106
+ /** Ascending order (lower-case variant). */
107
+ QueryOrder["asc"] = "asc";
108
+ /** Ascending order with nulls sorted last (lower-case variant). */
109
+ QueryOrder["asc_nulls_last"] = "asc nulls last";
110
+ /** Ascending order with nulls sorted first (lower-case variant). */
111
+ QueryOrder["asc_nulls_first"] = "asc nulls first";
112
+ /** Descending order (lower-case variant). */
113
+ QueryOrder["desc"] = "desc";
114
+ /** Descending order with nulls sorted last (lower-case variant). */
115
+ QueryOrder["desc_nulls_last"] = "desc nulls last";
116
+ /** Descending order with nulls sorted first (lower-case variant). */
117
+ QueryOrder["desc_nulls_first"] = "desc nulls first";
118
118
  })(QueryOrder || (QueryOrder = {}));
119
119
  /** Numeric sort direction, compatible with MongoDB-style ordering. */
120
120
  export var QueryOrderNumeric;
121
121
  (function (QueryOrderNumeric) {
122
- /** Ascending order. */
123
- QueryOrderNumeric[(QueryOrderNumeric['ASC'] = 1)] = 'ASC';
124
- /** Descending order. */
125
- QueryOrderNumeric[(QueryOrderNumeric['DESC'] = -1)] = 'DESC';
122
+ /** Ascending order. */
123
+ QueryOrderNumeric[QueryOrderNumeric["ASC"] = 1] = "ASC";
124
+ /** Descending order. */
125
+ QueryOrderNumeric[QueryOrderNumeric["DESC"] = -1] = "DESC";
126
126
  })(QueryOrderNumeric || (QueryOrderNumeric = {}));
127
127
  /** Flags that modify query builder behavior. */
128
128
  export var QueryFlag;
129
129
  (function (QueryFlag) {
130
- /** Add a DISTINCT clause to the SELECT statement. */
131
- QueryFlag['DISTINCT'] = 'DISTINCT';
132
- /** Enable result pagination via a sub-query for the primary keys. */
133
- QueryFlag['PAGINATE'] = 'PAGINATE';
134
- /** Disable the automatic pagination sub-query. */
135
- QueryFlag['DISABLE_PAGINATE'] = 'DISABLE_PAGINATE';
136
- /** Wrap UPDATE statements in a sub-query. */
137
- QueryFlag['UPDATE_SUB_QUERY'] = 'UPDATE_SUB_QUERY';
138
- /** Wrap DELETE statements in a sub-query. */
139
- QueryFlag['DELETE_SUB_QUERY'] = 'DELETE_SUB_QUERY';
140
- /** Convert values through custom type mappings when reading results. */
141
- QueryFlag['CONVERT_CUSTOM_TYPES'] = 'CONVERT_CUSTOM_TYPES';
142
- /** Include lazy formula properties in the SELECT clause. */
143
- QueryFlag['INCLUDE_LAZY_FORMULAS'] = 'INCLUDE_LAZY_FORMULAS';
144
- /** Automatically join the owning side of one-to-one relations. */
145
- QueryFlag['AUTO_JOIN_ONE_TO_ONE_OWNER'] = 'AUTO_JOIN_ONE_TO_ONE_OWNER';
146
- /** Infer the populate hint from the query fields. */
147
- QueryFlag['INFER_POPULATE'] = 'INFER_POPULATE';
148
- /** Prevent nested conditions from being promoted to INNER JOINs. */
149
- QueryFlag['DISABLE_NESTED_INNER_JOIN'] = 'DISABLE_NESTED_INNER_JOIN';
150
- /** Enable IDENTITY_INSERT for explicit PK values (MSSQL only). */
151
- QueryFlag['IDENTITY_INSERT'] = 'IDENTITY_INSERT';
152
- /** Use an OUTPUT...INTO temp table for returning rows (MSSQL only). */
153
- QueryFlag['OUTPUT_TABLE'] = 'OUTPUT_TABLE';
130
+ /** Add a DISTINCT clause to the SELECT statement. */
131
+ QueryFlag["DISTINCT"] = "DISTINCT";
132
+ /** Enable result pagination via a sub-query for the primary keys. */
133
+ QueryFlag["PAGINATE"] = "PAGINATE";
134
+ /** Disable the automatic pagination sub-query. */
135
+ QueryFlag["DISABLE_PAGINATE"] = "DISABLE_PAGINATE";
136
+ /** Wrap UPDATE statements in a sub-query. */
137
+ QueryFlag["UPDATE_SUB_QUERY"] = "UPDATE_SUB_QUERY";
138
+ /** Wrap DELETE statements in a sub-query. */
139
+ QueryFlag["DELETE_SUB_QUERY"] = "DELETE_SUB_QUERY";
140
+ /** Convert values through custom type mappings when reading results. */
141
+ QueryFlag["CONVERT_CUSTOM_TYPES"] = "CONVERT_CUSTOM_TYPES";
142
+ /** Include lazy formula properties in the SELECT clause. */
143
+ QueryFlag["INCLUDE_LAZY_FORMULAS"] = "INCLUDE_LAZY_FORMULAS";
144
+ /** Automatically join the owning side of one-to-one relations. */
145
+ QueryFlag["AUTO_JOIN_ONE_TO_ONE_OWNER"] = "AUTO_JOIN_ONE_TO_ONE_OWNER";
146
+ /** Infer the populate hint from the query fields. */
147
+ QueryFlag["INFER_POPULATE"] = "INFER_POPULATE";
148
+ /** Prevent nested conditions from being promoted to INNER JOINs. */
149
+ QueryFlag["DISABLE_NESTED_INNER_JOIN"] = "DISABLE_NESTED_INNER_JOIN";
150
+ /** Enable IDENTITY_INSERT for explicit PK values (MSSQL only). */
151
+ QueryFlag["IDENTITY_INSERT"] = "IDENTITY_INSERT";
152
+ /** Use an OUTPUT...INTO temp table for returning rows (MSSQL only). */
153
+ QueryFlag["OUTPUT_TABLE"] = "OUTPUT_TABLE";
154
154
  })(QueryFlag || (QueryFlag = {}));
155
155
  export const SCALAR_TYPES = new Set([
156
- 'string',
157
- 'number',
158
- 'boolean',
159
- 'bigint',
160
- 'Uint8Array',
161
- 'Date',
162
- 'Buffer',
163
- 'RegExp',
156
+ 'string',
157
+ 'number',
158
+ 'boolean',
159
+ 'bigint',
160
+ 'Uint8Array',
161
+ 'Date',
162
+ 'Buffer',
163
+ 'RegExp',
164
164
  ]);
165
165
  /** Describes the kind of relationship a property represents. */
166
166
  export var ReferenceKind;
167
167
  (function (ReferenceKind) {
168
- /** A plain scalar property (not a relation). */
169
- ReferenceKind['SCALAR'] = 'scalar';
170
- /** A one-to-one relation. */
171
- ReferenceKind['ONE_TO_ONE'] = '1:1';
172
- /** A one-to-many relation (inverse side of a many-to-one). */
173
- ReferenceKind['ONE_TO_MANY'] = '1:m';
174
- /** A many-to-one relation (owning side). */
175
- ReferenceKind['MANY_TO_ONE'] = 'm:1';
176
- /** A many-to-many relation. */
177
- ReferenceKind['MANY_TO_MANY'] = 'm:n';
178
- /** An embedded entity (inline object stored within the parent). */
179
- ReferenceKind['EMBEDDED'] = 'embedded';
168
+ /** A plain scalar property (not a relation). */
169
+ ReferenceKind["SCALAR"] = "scalar";
170
+ /** A one-to-one relation. */
171
+ ReferenceKind["ONE_TO_ONE"] = "1:1";
172
+ /** A one-to-many relation (inverse side of a many-to-one). */
173
+ ReferenceKind["ONE_TO_MANY"] = "1:m";
174
+ /** A many-to-one relation (owning side). */
175
+ ReferenceKind["MANY_TO_ONE"] = "m:1";
176
+ /** A many-to-many relation. */
177
+ ReferenceKind["MANY_TO_MANY"] = "m:n";
178
+ /** An embedded entity (inline object stored within the parent). */
179
+ ReferenceKind["EMBEDDED"] = "embedded";
180
180
  })(ReferenceKind || (ReferenceKind = {}));
181
181
  /** Cascade operations that propagate from a parent entity to its relations. */
182
182
  export var Cascade;
183
183
  (function (Cascade) {
184
- /** Cascade persist — new related entities are automatically persisted. */
185
- Cascade['PERSIST'] = 'persist';
186
- /** Cascade merge — detached related entities are merged into the identity map. */
187
- Cascade['MERGE'] = 'merge';
188
- /** Cascade remove — removing the parent also removes related entities. */
189
- Cascade['REMOVE'] = 'remove';
190
- /** Enable all cascade operations (persist, merge, remove). */
191
- Cascade['ALL'] = 'all';
192
- /** @internal */
193
- Cascade['SCHEDULE_ORPHAN_REMOVAL'] = 'schedule_orphan_removal';
194
- /** @internal */
195
- Cascade['CANCEL_ORPHAN_REMOVAL'] = 'cancel_orphan_removal';
184
+ /** Cascade persist — new related entities are automatically persisted. */
185
+ Cascade["PERSIST"] = "persist";
186
+ /** Cascade merge — detached related entities are merged into the identity map. */
187
+ Cascade["MERGE"] = "merge";
188
+ /** Cascade remove — removing the parent also removes related entities. */
189
+ Cascade["REMOVE"] = "remove";
190
+ /** Enable all cascade operations (persist, merge, remove). */
191
+ Cascade["ALL"] = "all";
192
+ /** @internal */
193
+ Cascade["SCHEDULE_ORPHAN_REMOVAL"] = "schedule_orphan_removal";
194
+ /** @internal */
195
+ Cascade["CANCEL_ORPHAN_REMOVAL"] = "cancel_orphan_removal";
196
196
  })(Cascade || (Cascade = {}));
197
197
  /** Strategy used to load related entities when populating. */
198
198
  export var LoadStrategy;
199
199
  (function (LoadStrategy) {
200
- /** Load relations with a separate SELECT ... WHERE pk IN (...) query. */
201
- LoadStrategy['SELECT_IN'] = 'select-in';
202
- /** Load relations via SQL JOINs in a single query. */
203
- LoadStrategy['JOINED'] = 'joined';
204
- /** Use joined strategy for to-one relations and select-in for to-many. */
205
- LoadStrategy['BALANCED'] = 'balanced';
200
+ /** Load relations with a separate SELECT ... WHERE pk IN (...) query. */
201
+ LoadStrategy["SELECT_IN"] = "select-in";
202
+ /** Load relations via SQL JOINs in a single query. */
203
+ LoadStrategy["JOINED"] = "joined";
204
+ /** Use joined strategy for to-one relations and select-in for to-many. */
205
+ LoadStrategy["BALANCED"] = "balanced";
206
206
  })(LoadStrategy || (LoadStrategy = {}));
207
207
  /** Controls which relation types use the dataloader for batched loading. */
208
208
  export var DataloaderType;
209
209
  (function (DataloaderType) {
210
- /** Dataloader is disabled. */
211
- DataloaderType[(DataloaderType['NONE'] = 0)] = 'NONE';
212
- /** Use the dataloader for Reference (to-one) relations only. */
213
- DataloaderType[(DataloaderType['REFERENCE'] = 1)] = 'REFERENCE';
214
- /** Use the dataloader for Collection (to-many) relations only. */
215
- DataloaderType[(DataloaderType['COLLECTION'] = 2)] = 'COLLECTION';
216
- /** Use the dataloader for both Reference and Collection relations. */
217
- DataloaderType[(DataloaderType['ALL'] = 3)] = 'ALL';
210
+ /** Dataloader is disabled. */
211
+ DataloaderType[DataloaderType["NONE"] = 0] = "NONE";
212
+ /** Use the dataloader for Reference (to-one) relations only. */
213
+ DataloaderType[DataloaderType["REFERENCE"] = 1] = "REFERENCE";
214
+ /** Use the dataloader for Collection (to-many) relations only. */
215
+ DataloaderType[DataloaderType["COLLECTION"] = 2] = "COLLECTION";
216
+ /** Use the dataloader for both Reference and Collection relations. */
217
+ DataloaderType[DataloaderType["ALL"] = 3] = "ALL";
218
218
  })(DataloaderType || (DataloaderType = {}));
219
219
  /** Locking strategy for concurrency control. */
220
220
  export var LockMode;
221
221
  (function (LockMode) {
222
- /** No locking. */
223
- LockMode[(LockMode['NONE'] = 0)] = 'NONE';
224
- /** Optimistic locking via a version column. */
225
- LockMode[(LockMode['OPTIMISTIC'] = 1)] = 'OPTIMISTIC';
226
- /** Pessimistic shared lock (FOR SHARE). */
227
- LockMode[(LockMode['PESSIMISTIC_READ'] = 2)] = 'PESSIMISTIC_READ';
228
- /** Pessimistic exclusive lock (FOR UPDATE). */
229
- LockMode[(LockMode['PESSIMISTIC_WRITE'] = 3)] = 'PESSIMISTIC_WRITE';
230
- /** Pessimistic exclusive lock that skips already-locked rows (FOR UPDATE SKIP LOCKED). */
231
- LockMode[(LockMode['PESSIMISTIC_PARTIAL_WRITE'] = 4)] = 'PESSIMISTIC_PARTIAL_WRITE';
232
- /** Pessimistic exclusive lock that fails immediately if the row is locked (FOR UPDATE NOWAIT). */
233
- LockMode[(LockMode['PESSIMISTIC_WRITE_OR_FAIL'] = 5)] = 'PESSIMISTIC_WRITE_OR_FAIL';
234
- /** Pessimistic shared lock that skips already-locked rows (FOR SHARE SKIP LOCKED). */
235
- LockMode[(LockMode['PESSIMISTIC_PARTIAL_READ'] = 6)] = 'PESSIMISTIC_PARTIAL_READ';
236
- /** Pessimistic shared lock that fails immediately if the row is locked (FOR SHARE NOWAIT). */
237
- LockMode[(LockMode['PESSIMISTIC_READ_OR_FAIL'] = 7)] = 'PESSIMISTIC_READ_OR_FAIL';
222
+ /** No locking. */
223
+ LockMode[LockMode["NONE"] = 0] = "NONE";
224
+ /** Optimistic locking via a version column. */
225
+ LockMode[LockMode["OPTIMISTIC"] = 1] = "OPTIMISTIC";
226
+ /** Pessimistic shared lock (FOR SHARE). */
227
+ LockMode[LockMode["PESSIMISTIC_READ"] = 2] = "PESSIMISTIC_READ";
228
+ /** Pessimistic exclusive lock (FOR UPDATE). */
229
+ LockMode[LockMode["PESSIMISTIC_WRITE"] = 3] = "PESSIMISTIC_WRITE";
230
+ /** Pessimistic exclusive lock that skips already-locked rows (FOR UPDATE SKIP LOCKED). */
231
+ LockMode[LockMode["PESSIMISTIC_PARTIAL_WRITE"] = 4] = "PESSIMISTIC_PARTIAL_WRITE";
232
+ /** Pessimistic exclusive lock that fails immediately if the row is locked (FOR UPDATE NOWAIT). */
233
+ LockMode[LockMode["PESSIMISTIC_WRITE_OR_FAIL"] = 5] = "PESSIMISTIC_WRITE_OR_FAIL";
234
+ /** Pessimistic shared lock that skips already-locked rows (FOR SHARE SKIP LOCKED). */
235
+ LockMode[LockMode["PESSIMISTIC_PARTIAL_READ"] = 6] = "PESSIMISTIC_PARTIAL_READ";
236
+ /** Pessimistic shared lock that fails immediately if the row is locked (FOR SHARE NOWAIT). */
237
+ LockMode[LockMode["PESSIMISTIC_READ_OR_FAIL"] = 7] = "PESSIMISTIC_READ_OR_FAIL";
238
238
  })(LockMode || (LockMode = {}));
239
239
  /** Transaction isolation levels as defined by the SQL standard (plus vendor extensions). */
240
240
  export var IsolationLevel;
241
241
  (function (IsolationLevel) {
242
- /** Allows dirty reads, non-repeatable reads, and phantom reads. */
243
- IsolationLevel['READ_UNCOMMITTED'] = 'read uncommitted';
244
- /** Prevents dirty reads; non-repeatable and phantom reads are still possible. */
245
- IsolationLevel['READ_COMMITTED'] = 'read committed';
246
- /** Snapshot isolation — each transaction sees a consistent snapshot of the database (MSSQL). */
247
- IsolationLevel['SNAPSHOT'] = 'snapshot';
248
- /** Prevents dirty and non-repeatable reads; phantom reads are still possible. */
249
- IsolationLevel['REPEATABLE_READ'] = 'repeatable read';
250
- /** Full isolation — transactions are executed as if they were run sequentially. */
251
- IsolationLevel['SERIALIZABLE'] = 'serializable';
242
+ /** Allows dirty reads, non-repeatable reads, and phantom reads. */
243
+ IsolationLevel["READ_UNCOMMITTED"] = "read uncommitted";
244
+ /** Prevents dirty reads; non-repeatable and phantom reads are still possible. */
245
+ IsolationLevel["READ_COMMITTED"] = "read committed";
246
+ /** Snapshot isolation — each transaction sees a consistent snapshot of the database (MSSQL). */
247
+ IsolationLevel["SNAPSHOT"] = "snapshot";
248
+ /** Prevents dirty and non-repeatable reads; phantom reads are still possible. */
249
+ IsolationLevel["REPEATABLE_READ"] = "repeatable read";
250
+ /** Full isolation — transactions are executed as if they were run sequentially. */
251
+ IsolationLevel["SERIALIZABLE"] = "serializable";
252
252
  })(IsolationLevel || (IsolationLevel = {}));
253
253
  /** Lifecycle and transaction events emitted by the ORM. */
254
254
  export var EventType;
255
255
  (function (EventType) {
256
- /** Fired when an entity instance is created (via constructor or `em.create`). */
257
- EventType['onInit'] = 'onInit';
258
- /** Fired after an entity is loaded from the database. */
259
- EventType['onLoad'] = 'onLoad';
260
- /** Fired before a new entity is inserted into the database. */
261
- EventType['beforeCreate'] = 'beforeCreate';
262
- /** Fired after a new entity has been inserted into the database. */
263
- EventType['afterCreate'] = 'afterCreate';
264
- /** Fired before an existing entity is updated in the database. */
265
- EventType['beforeUpdate'] = 'beforeUpdate';
266
- /** Fired after an existing entity has been updated in the database. */
267
- EventType['afterUpdate'] = 'afterUpdate';
268
- /** Fired before an upsert operation. */
269
- EventType['beforeUpsert'] = 'beforeUpsert';
270
- /** Fired after an upsert operation. */
271
- EventType['afterUpsert'] = 'afterUpsert';
272
- /** Fired before an entity is deleted from the database. */
273
- EventType['beforeDelete'] = 'beforeDelete';
274
- /** Fired after an entity has been deleted from the database. */
275
- EventType['afterDelete'] = 'afterDelete';
276
- /** Fired at the very beginning of `em.flush()`, before change detection. */
277
- EventType['beforeFlush'] = 'beforeFlush';
278
- /** Fired during `em.flush()` after change detection but before database writes. */
279
- EventType['onFlush'] = 'onFlush';
280
- /** Fired after `em.flush()` has completed all database writes. */
281
- EventType['afterFlush'] = 'afterFlush';
282
- /** Fired before a new database transaction is started. */
283
- EventType['beforeTransactionStart'] = 'beforeTransactionStart';
284
- /** Fired after a new database transaction has been started. */
285
- EventType['afterTransactionStart'] = 'afterTransactionStart';
286
- /** Fired before a database transaction is committed. */
287
- EventType['beforeTransactionCommit'] = 'beforeTransactionCommit';
288
- /** Fired after a database transaction has been committed. */
289
- EventType['afterTransactionCommit'] = 'afterTransactionCommit';
290
- /** Fired before a database transaction is rolled back. */
291
- EventType['beforeTransactionRollback'] = 'beforeTransactionRollback';
292
- /** Fired after a database transaction has been rolled back. */
293
- EventType['afterTransactionRollback'] = 'afterTransactionRollback';
256
+ /** Fired when an entity instance is created (via constructor or `em.create`). */
257
+ EventType["onInit"] = "onInit";
258
+ /** Fired after an entity is loaded from the database. */
259
+ EventType["onLoad"] = "onLoad";
260
+ /** Fired before a new entity is inserted into the database. */
261
+ EventType["beforeCreate"] = "beforeCreate";
262
+ /** Fired after a new entity has been inserted into the database. */
263
+ EventType["afterCreate"] = "afterCreate";
264
+ /** Fired before an existing entity is updated in the database. */
265
+ EventType["beforeUpdate"] = "beforeUpdate";
266
+ /** Fired after an existing entity has been updated in the database. */
267
+ EventType["afterUpdate"] = "afterUpdate";
268
+ /** Fired before an upsert operation. */
269
+ EventType["beforeUpsert"] = "beforeUpsert";
270
+ /** Fired after an upsert operation. */
271
+ EventType["afterUpsert"] = "afterUpsert";
272
+ /** Fired before an entity is deleted from the database. */
273
+ EventType["beforeDelete"] = "beforeDelete";
274
+ /** Fired after an entity has been deleted from the database. */
275
+ EventType["afterDelete"] = "afterDelete";
276
+ /** Fired at the very beginning of `em.flush()`, before change detection. */
277
+ EventType["beforeFlush"] = "beforeFlush";
278
+ /** Fired during `em.flush()` after change detection but before database writes. */
279
+ EventType["onFlush"] = "onFlush";
280
+ /** Fired after `em.flush()` has completed all database writes. */
281
+ EventType["afterFlush"] = "afterFlush";
282
+ /** Fired before a new database transaction is started. */
283
+ EventType["beforeTransactionStart"] = "beforeTransactionStart";
284
+ /** Fired after a new database transaction has been started. */
285
+ EventType["afterTransactionStart"] = "afterTransactionStart";
286
+ /** Fired before a database transaction is committed. */
287
+ EventType["beforeTransactionCommit"] = "beforeTransactionCommit";
288
+ /** Fired after a database transaction has been committed. */
289
+ EventType["afterTransactionCommit"] = "afterTransactionCommit";
290
+ /** Fired before a database transaction is rolled back. */
291
+ EventType["beforeTransactionRollback"] = "beforeTransactionRollback";
292
+ /** Fired after a database transaction has been rolled back. */
293
+ EventType["afterTransactionRollback"] = "afterTransactionRollback";
294
294
  })(EventType || (EventType = {}));
295
295
  export const EventTypeMap = Object.keys(EventType).reduce((a, b, i) => {
296
- a[b] = i;
297
- return a;
296
+ a[b] = i;
297
+ return a;
298
298
  }, {});
299
299
  /** Controls how a transactional operation interacts with an existing transaction. */
300
300
  export var TransactionPropagation;
301
301
  (function (TransactionPropagation) {
302
- /** Join the current transaction or create a new one if none exists. */
303
- TransactionPropagation['REQUIRED'] = 'required';
304
- /** Always create a new transaction, suspending the current one if it exists. */
305
- TransactionPropagation['REQUIRES_NEW'] = 'requires_new';
306
- /** Create a nested savepoint within the current transaction, or a new transaction if none exists. */
307
- TransactionPropagation['NESTED'] = 'nested';
308
- /** Execute non-transactionally, suspending the current transaction if one exists. */
309
- TransactionPropagation['NOT_SUPPORTED'] = 'not_supported';
310
- /** Join the current transaction if one exists, otherwise execute non-transactionally. */
311
- TransactionPropagation['SUPPORTS'] = 'supports';
312
- /** Join the current transaction; throw if no transaction is active. */
313
- TransactionPropagation['MANDATORY'] = 'mandatory';
314
- /** Execute non-transactionally; throw if a transaction is active. */
315
- TransactionPropagation['NEVER'] = 'never';
302
+ /** Join the current transaction or create a new one if none exists. */
303
+ TransactionPropagation["REQUIRED"] = "required";
304
+ /** Always create a new transaction, suspending the current one if it exists. */
305
+ TransactionPropagation["REQUIRES_NEW"] = "requires_new";
306
+ /** Create a nested savepoint within the current transaction, or a new transaction if none exists. */
307
+ TransactionPropagation["NESTED"] = "nested";
308
+ /** Execute non-transactionally, suspending the current transaction if one exists. */
309
+ TransactionPropagation["NOT_SUPPORTED"] = "not_supported";
310
+ /** Join the current transaction if one exists, otherwise execute non-transactionally. */
311
+ TransactionPropagation["SUPPORTS"] = "supports";
312
+ /** Join the current transaction; throw if no transaction is active. */
313
+ TransactionPropagation["MANDATORY"] = "mandatory";
314
+ /** Execute non-transactionally; throw if a transaction is active. */
315
+ TransactionPropagation["NEVER"] = "never";
316
316
  })(TransactionPropagation || (TransactionPropagation = {}));
317
- export class PlainObject {}
317
+ export class PlainObject {
318
+ }
318
319
  /** Constraint deferral mode for database constraints (e.g., foreign keys, unique). */
319
320
  export var DeferMode;
320
321
  (function (DeferMode) {
321
- /** The constraint is checked immediately by default, but can be deferred within a transaction. */
322
- DeferMode['INITIALLY_IMMEDIATE'] = 'immediate';
323
- /** The constraint is deferred until the transaction is committed. */
324
- DeferMode['INITIALLY_DEFERRED'] = 'deferred';
322
+ /** The constraint is checked immediately by default, but can be deferred within a transaction. */
323
+ DeferMode["INITIALLY_IMMEDIATE"] = "immediate";
324
+ /** The constraint is deferred until the transaction is committed. */
325
+ DeferMode["INITIALLY_DEFERRED"] = "deferred";
325
326
  })(DeferMode || (DeferMode = {}));