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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/EntityManager.d.ts +583 -883
  2. package/EntityManager.js +1869 -1897
  3. package/MikroORM.d.ts +74 -103
  4. package/MikroORM.js +179 -178
  5. package/cache/CacheAdapter.d.ts +36 -36
  6. package/cache/FileCacheAdapter.d.ts +24 -30
  7. package/cache/FileCacheAdapter.js +78 -80
  8. package/cache/GeneratedCacheAdapter.d.ts +20 -18
  9. package/cache/GeneratedCacheAdapter.js +30 -30
  10. package/cache/MemoryCacheAdapter.d.ts +20 -18
  11. package/cache/MemoryCacheAdapter.js +36 -35
  12. package/cache/NullCacheAdapter.d.ts +16 -16
  13. package/cache/NullCacheAdapter.js +24 -24
  14. package/connections/Connection.d.ts +84 -95
  15. package/connections/Connection.js +168 -165
  16. package/drivers/DatabaseDriver.d.ts +80 -186
  17. package/drivers/DatabaseDriver.js +443 -450
  18. package/drivers/IDatabaseDriver.d.ts +301 -440
  19. package/entity/BaseEntity.d.ts +83 -120
  20. package/entity/BaseEntity.js +43 -43
  21. package/entity/Collection.d.ts +179 -212
  22. package/entity/Collection.js +721 -727
  23. package/entity/EntityAssigner.d.ts +77 -88
  24. package/entity/EntityAssigner.js +230 -231
  25. package/entity/EntityFactory.d.ts +54 -66
  26. package/entity/EntityFactory.js +383 -425
  27. package/entity/EntityHelper.d.ts +22 -34
  28. package/entity/EntityHelper.js +267 -280
  29. package/entity/EntityIdentifier.d.ts +4 -4
  30. package/entity/EntityIdentifier.js +10 -10
  31. package/entity/EntityLoader.d.ts +73 -103
  32. package/entity/EntityLoader.js +723 -753
  33. package/entity/EntityRepository.d.ts +201 -316
  34. package/entity/EntityRepository.js +213 -213
  35. package/entity/PolymorphicRef.d.ts +5 -5
  36. package/entity/PolymorphicRef.js +10 -10
  37. package/entity/Reference.d.ts +82 -126
  38. package/entity/Reference.js +274 -278
  39. package/entity/WrappedEntity.d.ts +72 -115
  40. package/entity/WrappedEntity.js +166 -168
  41. package/entity/defineEntity.d.ts +614 -1280
  42. package/entity/defineEntity.js +511 -520
  43. package/entity/utils.d.ts +3 -13
  44. package/entity/utils.js +73 -71
  45. package/entity/validators.js +43 -43
  46. package/entity/wrap.js +8 -8
  47. package/enums.d.ts +253 -258
  48. package/enums.js +252 -251
  49. package/errors.d.ts +72 -114
  50. package/errors.js +253 -350
  51. package/events/EventManager.d.ts +14 -26
  52. package/events/EventManager.js +77 -79
  53. package/events/EventSubscriber.d.ts +29 -29
  54. package/events/TransactionEventBroadcaster.d.ts +8 -15
  55. package/events/TransactionEventBroadcaster.js +14 -14
  56. package/exceptions.d.ts +40 -23
  57. package/exceptions.js +52 -35
  58. package/hydration/Hydrator.d.ts +17 -42
  59. package/hydration/Hydrator.js +43 -43
  60. package/hydration/ObjectHydrator.d.ts +17 -50
  61. package/hydration/ObjectHydrator.js +416 -479
  62. package/index.d.ts +2 -116
  63. package/index.js +1 -10
  64. package/logging/DefaultLogger.d.ts +32 -34
  65. package/logging/DefaultLogger.js +86 -86
  66. package/logging/Logger.d.ts +41 -41
  67. package/logging/SimpleLogger.d.ts +11 -13
  68. package/logging/SimpleLogger.js +22 -22
  69. package/logging/colors.d.ts +6 -6
  70. package/logging/colors.js +10 -11
  71. package/logging/inspect.js +7 -7
  72. package/metadata/EntitySchema.d.ts +127 -211
  73. package/metadata/EntitySchema.js +398 -397
  74. package/metadata/MetadataDiscovery.d.ts +114 -114
  75. package/metadata/MetadataDiscovery.js +1863 -1947
  76. package/metadata/MetadataProvider.d.ts +21 -24
  77. package/metadata/MetadataProvider.js +84 -82
  78. package/metadata/MetadataStorage.d.ts +32 -38
  79. package/metadata/MetadataStorage.js +118 -118
  80. package/metadata/MetadataValidator.d.ts +39 -39
  81. package/metadata/MetadataValidator.js +338 -381
  82. package/metadata/discover-entities.d.ts +2 -5
  83. package/metadata/discover-entities.js +27 -27
  84. package/metadata/types.d.ts +531 -615
  85. package/naming-strategy/AbstractNamingStrategy.d.ts +39 -54
  86. package/naming-strategy/AbstractNamingStrategy.js +85 -90
  87. package/naming-strategy/EntityCaseNamingStrategy.d.ts +6 -6
  88. package/naming-strategy/EntityCaseNamingStrategy.js +22 -22
  89. package/naming-strategy/MongoNamingStrategy.d.ts +6 -6
  90. package/naming-strategy/MongoNamingStrategy.js +18 -18
  91. package/naming-strategy/NamingStrategy.d.ts +99 -109
  92. package/naming-strategy/UnderscoreNamingStrategy.d.ts +7 -7
  93. package/naming-strategy/UnderscoreNamingStrategy.js +21 -21
  94. package/not-supported.js +4 -7
  95. package/package.json +1 -1
  96. package/platforms/ExceptionConverter.d.ts +1 -1
  97. package/platforms/ExceptionConverter.js +4 -4
  98. package/platforms/Platform.d.ts +299 -308
  99. package/platforms/Platform.js +636 -659
  100. package/serialization/EntitySerializer.d.ts +26 -48
  101. package/serialization/EntitySerializer.js +218 -224
  102. package/serialization/EntityTransformer.d.ts +6 -10
  103. package/serialization/EntityTransformer.js +217 -219
  104. package/serialization/SerializationContext.d.ts +23 -27
  105. package/serialization/SerializationContext.js +105 -105
  106. package/types/ArrayType.d.ts +8 -8
  107. package/types/ArrayType.js +33 -33
  108. package/types/BigIntType.d.ts +10 -17
  109. package/types/BigIntType.js +37 -37
  110. package/types/BlobType.d.ts +3 -3
  111. package/types/BlobType.js +13 -13
  112. package/types/BooleanType.d.ts +4 -4
  113. package/types/BooleanType.js +12 -12
  114. package/types/CharacterType.d.ts +2 -2
  115. package/types/CharacterType.js +6 -6
  116. package/types/DateTimeType.d.ts +5 -5
  117. package/types/DateTimeType.js +15 -15
  118. package/types/DateType.d.ts +5 -5
  119. package/types/DateType.js +15 -15
  120. package/types/DecimalType.d.ts +7 -7
  121. package/types/DecimalType.js +26 -26
  122. package/types/DoubleType.d.ts +3 -3
  123. package/types/DoubleType.js +12 -12
  124. package/types/EnumArrayType.d.ts +5 -5
  125. package/types/EnumArrayType.js +24 -24
  126. package/types/EnumType.d.ts +3 -3
  127. package/types/EnumType.js +11 -11
  128. package/types/FloatType.d.ts +3 -3
  129. package/types/FloatType.js +9 -9
  130. package/types/IntegerType.d.ts +3 -3
  131. package/types/IntegerType.js +9 -9
  132. package/types/IntervalType.d.ts +4 -4
  133. package/types/IntervalType.js +12 -12
  134. package/types/JsonType.d.ts +8 -8
  135. package/types/JsonType.js +32 -32
  136. package/types/MediumIntType.d.ts +1 -1
  137. package/types/MediumIntType.js +3 -3
  138. package/types/SmallIntType.d.ts +3 -3
  139. package/types/SmallIntType.js +9 -9
  140. package/types/StringType.d.ts +4 -4
  141. package/types/StringType.js +12 -12
  142. package/types/TextType.d.ts +3 -3
  143. package/types/TextType.js +9 -9
  144. package/types/TimeType.d.ts +5 -5
  145. package/types/TimeType.js +17 -17
  146. package/types/TinyIntType.d.ts +3 -3
  147. package/types/TinyIntType.js +10 -10
  148. package/types/Type.d.ts +79 -83
  149. package/types/Type.js +82 -82
  150. package/types/Uint8ArrayType.d.ts +4 -4
  151. package/types/Uint8ArrayType.js +21 -21
  152. package/types/UnknownType.d.ts +4 -4
  153. package/types/UnknownType.js +12 -12
  154. package/types/UuidType.d.ts +5 -5
  155. package/types/UuidType.js +19 -19
  156. package/types/index.d.ts +49 -75
  157. package/types/index.js +26 -52
  158. package/typings.d.ts +729 -1211
  159. package/typings.js +231 -244
  160. package/unit-of-work/ChangeSet.d.ts +26 -26
  161. package/unit-of-work/ChangeSet.js +56 -56
  162. package/unit-of-work/ChangeSetComputer.d.ts +12 -12
  163. package/unit-of-work/ChangeSetComputer.js +170 -178
  164. package/unit-of-work/ChangeSetPersister.d.ts +44 -63
  165. package/unit-of-work/ChangeSetPersister.js +421 -442
  166. package/unit-of-work/CommitOrderCalculator.d.ts +40 -40
  167. package/unit-of-work/CommitOrderCalculator.js +88 -89
  168. package/unit-of-work/IdentityMap.d.ts +31 -31
  169. package/unit-of-work/IdentityMap.js +105 -105
  170. package/unit-of-work/UnitOfWork.d.ts +141 -181
  171. package/unit-of-work/UnitOfWork.js +1183 -1200
  172. package/utils/AbstractMigrator.d.ts +91 -111
  173. package/utils/AbstractMigrator.js +275 -275
  174. package/utils/AbstractSchemaGenerator.d.ts +34 -43
  175. package/utils/AbstractSchemaGenerator.js +122 -121
  176. package/utils/AsyncContext.d.ts +3 -3
  177. package/utils/AsyncContext.js +35 -34
  178. package/utils/Configuration.d.ts +808 -852
  179. package/utils/Configuration.js +344 -359
  180. package/utils/Cursor.d.ts +22 -40
  181. package/utils/Cursor.js +127 -135
  182. package/utils/DataloaderUtils.d.ts +43 -58
  183. package/utils/DataloaderUtils.js +198 -203
  184. package/utils/EntityComparator.d.ts +81 -98
  185. package/utils/EntityComparator.js +728 -824
  186. package/utils/NullHighlighter.d.ts +1 -1
  187. package/utils/NullHighlighter.js +3 -3
  188. package/utils/QueryHelper.d.ts +51 -79
  189. package/utils/QueryHelper.js +361 -372
  190. package/utils/RawQueryFragment.d.ts +34 -50
  191. package/utils/RawQueryFragment.js +105 -107
  192. package/utils/RequestContext.d.ts +32 -32
  193. package/utils/RequestContext.js +53 -52
  194. package/utils/TransactionContext.d.ts +16 -16
  195. package/utils/TransactionContext.js +27 -27
  196. package/utils/TransactionManager.d.ts +58 -58
  197. package/utils/TransactionManager.js +197 -199
  198. package/utils/Utils.d.ts +145 -204
  199. package/utils/Utils.js +813 -814
  200. package/utils/clone.js +113 -104
  201. package/utils/env-vars.js +88 -90
  202. package/utils/fs-utils.d.ts +15 -15
  203. package/utils/fs-utils.js +181 -180
  204. package/utils/upsert-utils.d.ts +5 -20
  205. package/utils/upsert-utils.js +116 -114
@@ -2,40 +2,40 @@ import type { AnyString, Dictionary, EntityKey } from '../typings.js';
2
2
  declare const rawFragmentSymbolBrand: unique symbol;
3
3
  /** Branded symbol type used as a unique key for tracking raw SQL fragments in object properties. */
4
4
  export type RawQueryFragmentSymbol = symbol & {
5
- readonly [rawFragmentSymbolBrand]: true;
5
+ readonly [rawFragmentSymbolBrand]: true;
6
6
  };
7
7
  /** Represents a raw SQL fragment with optional parameters, usable as both a value and an object key via Symbol coercion. */
8
8
  export declare class RawQueryFragment<Alias extends string = string> {
9
- #private;
10
- readonly sql: string;
11
- readonly params: unknown[];
12
- /** @internal Type-level only - used to track the alias for type inference */
13
- private readonly __alias?;
14
- constructor(sql: string, params?: unknown[]);
15
- /** Returns a unique symbol key for this fragment, creating and caching it on first access. */
16
- get key(): RawQueryFragmentSymbol;
17
- /** Creates a new fragment with an alias appended via `as ??`. */
18
- as<A extends string>(alias: A): RawQueryFragment<A>;
19
- [Symbol.toPrimitive](hint: 'string'): RawQueryFragmentSymbol;
20
- get [Symbol.toStringTag](): string;
21
- toJSON(): string;
22
- clone(): this;
23
- /** Checks whether the given value is a symbol that maps to a known raw query fragment. */
24
- static isKnownFragmentSymbol(key: unknown): key is RawQueryFragmentSymbol;
25
- /** Checks whether an object has any symbol keys that are known raw query fragments. */
26
- static hasObjectFragments(object: unknown): boolean;
27
- /** Checks whether the given value is a RawQueryFragment instance or a known fragment symbol. */
28
- static isKnownFragment(key: unknown): key is RawQueryFragment | symbol;
29
- /** Retrieves the RawQueryFragment associated with the given key (instance or symbol). */
30
- static getKnownFragment(key: unknown): RawQueryFragment | undefined;
9
+ #private;
10
+ readonly sql: string;
11
+ readonly params: unknown[];
12
+ /** @internal Type-level only - used to track the alias for type inference */
13
+ private readonly __alias?;
14
+ constructor(sql: string, params?: unknown[]);
15
+ /** Returns a unique symbol key for this fragment, creating and caching it on first access. */
16
+ get key(): RawQueryFragmentSymbol;
17
+ /** Creates a new fragment with an alias appended via `as ??`. */
18
+ as<A extends string>(alias: A): RawQueryFragment<A>;
19
+ [Symbol.toPrimitive](hint: 'string'): RawQueryFragmentSymbol;
20
+ get [Symbol.toStringTag](): string;
21
+ toJSON(): string;
22
+ clone(): this;
23
+ /** Checks whether the given value is a symbol that maps to a known raw query fragment. */
24
+ static isKnownFragmentSymbol(key: unknown): key is RawQueryFragmentSymbol;
25
+ /** Checks whether an object has any symbol keys that are known raw query fragments. */
26
+ static hasObjectFragments(object: unknown): boolean;
27
+ /** Checks whether the given value is a RawQueryFragment instance or a known fragment symbol. */
28
+ static isKnownFragment(key: unknown): key is RawQueryFragment | symbol;
29
+ /** Retrieves the RawQueryFragment associated with the given key (instance or symbol). */
30
+ static getKnownFragment(key: unknown): RawQueryFragment | undefined;
31
31
  }
32
32
  export { RawQueryFragment as Raw };
33
33
  /** Checks whether the given value is a `RawQueryFragment` instance. */
34
34
  export declare function isRaw(value: unknown): value is RawQueryFragment;
35
35
  /** @internal */
36
- export declare const ALIAS_REPLACEMENT = '[::alias::]';
36
+ export declare const ALIAS_REPLACEMENT = "[::alias::]";
37
37
  /** @internal */
38
- export declare const ALIAS_REPLACEMENT_RE = '\\[::alias::\\]';
38
+ export declare const ALIAS_REPLACEMENT_RE = "\\[::alias::\\]";
39
39
  /**
40
40
  * Creates raw SQL query fragment that can be assigned to a property or part of a filter. This fragment is represented
41
41
  * by `RawQueryFragment` class instance that can be serialized to a string, so it can be used both as an object value
@@ -91,10 +91,7 @@ export declare const ALIAS_REPLACEMENT_RE = '\\[::alias::\\]';
91
91
  * export class Author { ... }
92
92
  * ```
93
93
  */
94
- export declare function raw<R = RawQueryFragment & symbol, T extends object = any>(
95
- sql: EntityKey<T> | EntityKey<T>[] | AnyString | ((alias: string) => string) | RawQueryFragment,
96
- params?: readonly unknown[] | Dictionary<unknown>,
97
- ): R;
94
+ export declare function raw<R = RawQueryFragment & symbol, T extends object = any>(sql: EntityKey<T> | EntityKey<T>[] | AnyString | ((alias: string) => string) | RawQueryFragment, params?: readonly unknown[] | Dictionary<unknown>): R;
98
95
  /**
99
96
  * Alternative to the `raw()` helper allowing to use it as a tagged template function for the simple cases.
100
97
  *
@@ -114,20 +111,13 @@ export declare function raw<R = RawQueryFragment & symbol, T extends object = an
114
111
  */
115
112
  export declare function sql<R = RawQueryFragment & symbol>(sql: readonly string[], ...values: unknown[]): R;
116
113
  export declare namespace sql {
117
- var ref: <T extends object = any>(...keys: string[]) => RawQueryFragment & symbol;
118
- var now: (length?: number) => RawQueryFragment & symbol;
119
- var lower: <R = RawQueryFragment<string> & symbol, T extends object = any>(
120
- key: string | ((alias: string) => string),
121
- ) => R;
122
- var upper: <R = RawQueryFragment<string> & symbol, T extends object = any>(
123
- key: string | ((alias: string) => string),
124
- ) => R;
114
+ var ref: <T extends object = any>(...keys: string[]) => RawQueryFragment & symbol;
115
+ var now: (length?: number) => RawQueryFragment & symbol;
116
+ var lower: <R = RawQueryFragment<string> & symbol, T extends object = any>(key: string | ((alias: string) => string)) => R;
117
+ var upper: <R = RawQueryFragment<string> & symbol, T extends object = any>(key: string | ((alias: string) => string)) => R;
125
118
  }
126
119
  /** Creates a raw SQL function expression wrapping the given key (e.g., `lower(name)`). */
127
- export declare function createSqlFunction<R = RawQueryFragment & symbol, T extends object = any>(
128
- func: string,
129
- key: string | ((alias: string) => string),
130
- ): R;
120
+ export declare function createSqlFunction<R = RawQueryFragment & symbol, T extends object = any>(func: string, key: string | ((alias: string) => string)): R;
131
121
  /**
132
122
  * Tag function providing quoting of db identifiers (table name, columns names, index names, ...).
133
123
  *
@@ -141,12 +131,6 @@ export declare function createSqlFunction<R = RawQueryFragment & symbol, T exten
141
131
  * export class Author { ... }
142
132
  * ```
143
133
  */
144
- export declare function quote(
145
- expParts: readonly string[],
146
- ...values: (
147
- | string
148
- | {
149
- toString(): string;
150
- }
151
- )[]
152
- ): RawQueryFragment & symbol;
134
+ export declare function quote(expParts: readonly string[], ...values: (string | {
135
+ toString(): string;
136
+ })[]): RawQueryFragment & symbol;
@@ -1,87 +1,85 @@
1
1
  import { Utils } from './Utils.js';
2
2
  /** Represents a raw SQL fragment with optional parameters, usable as both a value and an object key via Symbol coercion. */
3
3
  export class RawQueryFragment {
4
- sql;
5
- params;
6
- static #rawQueryReferences = new WeakMap();
7
- #key;
8
- constructor(sql, params = []) {
9
- this.sql = sql;
10
- this.params = params;
11
- }
12
- /** Returns a unique symbol key for this fragment, creating and caching it on first access. */
13
- get key() {
14
- if (!this.#key) {
15
- this.#key = Symbol(this.toJSON());
16
- RawQueryFragment.#rawQueryReferences.set(this.#key, this);
17
- }
18
- return this.#key;
19
- }
20
- /** Creates a new fragment with an alias appended via `as ??`. */
21
- as(alias) {
22
- return new RawQueryFragment(`${this.sql} as ??`, [...this.params, alias]);
23
- }
24
- [Symbol.toPrimitive](hint) {
25
- // if a fragment is converted to string (used as an object key), return a unique symbol
26
- // and save a weak reference to map so we can retrieve it when compiling the query
27
- if (hint === 'string') {
28
- return this.key;
29
- }
30
- throw new Error(`Trying to modify raw SQL fragment: '${this.sql}'`);
31
- }
32
- get [Symbol.toStringTag]() {
33
- return this.toJSON();
34
- }
35
- toJSON() {
36
- return `raw('${this.sql}')`;
37
- }
38
- clone() {
39
- return this;
40
- }
41
- /** Checks whether the given value is a symbol that maps to a known raw query fragment. */
42
- static isKnownFragmentSymbol(key) {
43
- return typeof key === 'symbol' && this.#rawQueryReferences.has(key);
44
- }
45
- /** Checks whether an object has any symbol keys that are known raw query fragments. */
46
- static hasObjectFragments(object) {
47
- return (
48
- Utils.isPlainObject(object) &&
49
- Object.getOwnPropertySymbols(object).some(symbol => this.isKnownFragmentSymbol(symbol))
50
- );
51
- }
52
- /** Checks whether the given value is a RawQueryFragment instance or a known fragment symbol. */
53
- static isKnownFragment(key) {
54
- if (key instanceof RawQueryFragment) {
55
- return true;
56
- }
57
- return this.isKnownFragmentSymbol(key);
58
- }
59
- /** Retrieves the RawQueryFragment associated with the given key (instance or symbol). */
60
- static getKnownFragment(key) {
61
- if (key instanceof RawQueryFragment) {
62
- return key;
63
- }
64
- if (typeof key !== 'symbol') {
65
- return;
66
- }
67
- return this.#rawQueryReferences.get(key);
68
- }
69
- /** @ignore */
70
- /* v8 ignore next */
71
- [Symbol.for('nodejs.util.inspect.custom')]() {
72
- if (this.params) {
73
- return { sql: this.sql, params: this.params };
74
- }
75
- return { sql: this.sql };
76
- }
4
+ sql;
5
+ params;
6
+ static #rawQueryReferences = new WeakMap();
7
+ #key;
8
+ constructor(sql, params = []) {
9
+ this.sql = sql;
10
+ this.params = params;
11
+ }
12
+ /** Returns a unique symbol key for this fragment, creating and caching it on first access. */
13
+ get key() {
14
+ if (!this.#key) {
15
+ this.#key = Symbol(this.toJSON());
16
+ RawQueryFragment.#rawQueryReferences.set(this.#key, this);
17
+ }
18
+ return this.#key;
19
+ }
20
+ /** Creates a new fragment with an alias appended via `as ??`. */
21
+ as(alias) {
22
+ return new RawQueryFragment(`${this.sql} as ??`, [...this.params, alias]);
23
+ }
24
+ [Symbol.toPrimitive](hint) {
25
+ // if a fragment is converted to string (used as an object key), return a unique symbol
26
+ // and save a weak reference to map so we can retrieve it when compiling the query
27
+ if (hint === 'string') {
28
+ return this.key;
29
+ }
30
+ throw new Error(`Trying to modify raw SQL fragment: '${this.sql}'`);
31
+ }
32
+ get [Symbol.toStringTag]() {
33
+ return this.toJSON();
34
+ }
35
+ toJSON() {
36
+ return `raw('${this.sql}')`;
37
+ }
38
+ clone() {
39
+ return this;
40
+ }
41
+ /** Checks whether the given value is a symbol that maps to a known raw query fragment. */
42
+ static isKnownFragmentSymbol(key) {
43
+ return typeof key === 'symbol' && this.#rawQueryReferences.has(key);
44
+ }
45
+ /** Checks whether an object has any symbol keys that are known raw query fragments. */
46
+ static hasObjectFragments(object) {
47
+ return (Utils.isPlainObject(object) &&
48
+ Object.getOwnPropertySymbols(object).some(symbol => this.isKnownFragmentSymbol(symbol)));
49
+ }
50
+ /** Checks whether the given value is a RawQueryFragment instance or a known fragment symbol. */
51
+ static isKnownFragment(key) {
52
+ if (key instanceof RawQueryFragment) {
53
+ return true;
54
+ }
55
+ return this.isKnownFragmentSymbol(key);
56
+ }
57
+ /** Retrieves the RawQueryFragment associated with the given key (instance or symbol). */
58
+ static getKnownFragment(key) {
59
+ if (key instanceof RawQueryFragment) {
60
+ return key;
61
+ }
62
+ if (typeof key !== 'symbol') {
63
+ return;
64
+ }
65
+ return this.#rawQueryReferences.get(key);
66
+ }
67
+ /** @ignore */
68
+ /* v8 ignore next */
69
+ [Symbol.for('nodejs.util.inspect.custom')]() {
70
+ if (this.params) {
71
+ return { sql: this.sql, params: this.params };
72
+ }
73
+ return { sql: this.sql };
74
+ }
77
75
  }
78
76
  export { RawQueryFragment as Raw };
79
77
  Object.defineProperties(RawQueryFragment.prototype, {
80
- __raw: { value: true, enumerable: false },
78
+ __raw: { value: true, enumerable: false },
81
79
  });
82
80
  /** Checks whether the given value is a `RawQueryFragment` instance. */
83
81
  export function isRaw(value) {
84
- return typeof value === 'object' && value !== null && '__raw' in value;
82
+ return typeof value === 'object' && value !== null && '__raw' in value;
85
83
  }
86
84
  /** @internal */
87
85
  export const ALIAS_REPLACEMENT = '[::alias::]';
@@ -143,30 +141,30 @@ export const ALIAS_REPLACEMENT_RE = '\\[::alias::\\]';
143
141
  * ```
144
142
  */
145
143
  export function raw(sql, params) {
146
- if (sql instanceof RawQueryFragment) {
147
- return sql;
148
- }
149
- if (sql instanceof Function) {
150
- sql = sql(ALIAS_REPLACEMENT);
151
- }
152
- if (sql === '??' && Array.isArray(params)) {
144
+ if (sql instanceof RawQueryFragment) {
145
+ return sql;
146
+ }
147
+ if (sql instanceof Function) {
148
+ sql = sql(ALIAS_REPLACEMENT);
149
+ }
150
+ if (sql === '??' && Array.isArray(params)) {
151
+ return new RawQueryFragment(sql, params);
152
+ }
153
+ if (Array.isArray(sql)) {
154
+ // for composite FK we return just a simple string
155
+ return Utils.getPrimaryKeyHash(sql);
156
+ }
157
+ if (typeof params === 'object' && !Array.isArray(params)) {
158
+ const pairs = Object.entries(params);
159
+ const objectParams = [];
160
+ for (const [key, value] of pairs) {
161
+ sql = sql.replace(`:${key}:`, '??');
162
+ sql = sql.replace(`:${key}`, '?');
163
+ objectParams.push(value);
164
+ }
165
+ return new RawQueryFragment(sql, objectParams);
166
+ }
153
167
  return new RawQueryFragment(sql, params);
154
- }
155
- if (Array.isArray(sql)) {
156
- // for composite FK we return just a simple string
157
- return Utils.getPrimaryKeyHash(sql);
158
- }
159
- if (typeof params === 'object' && !Array.isArray(params)) {
160
- const pairs = Object.entries(params);
161
- const objectParams = [];
162
- for (const [key, value] of pairs) {
163
- sql = sql.replace(`:${key}:`, '??');
164
- sql = sql.replace(`:${key}`, '?');
165
- objectParams.push(value);
166
- }
167
- return new RawQueryFragment(sql, objectParams);
168
- }
169
- return new RawQueryFragment(sql, params);
170
168
  }
171
169
  /**
172
170
  * Alternative to the `raw()` helper allowing to use it as a tagged template function for the simple cases.
@@ -186,19 +184,19 @@ export function raw(sql, params) {
186
184
  * ```
187
185
  */
188
186
  export function sql(sql, ...values) {
189
- return raw(sql.join('?'), values);
187
+ return raw(sql.join('?'), values);
190
188
  }
191
189
  /** Creates a raw SQL function expression wrapping the given key (e.g., `lower(name)`). */
192
190
  export function createSqlFunction(func, key) {
193
- if (typeof key === 'string') {
194
- return raw(`${func}(${key})`);
195
- }
196
- return raw(a => `${func}(${key(a)})`);
191
+ if (typeof key === 'string') {
192
+ return raw(`${func}(${key})`);
193
+ }
194
+ return raw(a => `${func}(${key(a)})`);
197
195
  }
198
196
  sql.ref = (...keys) => raw('??', [keys.join('.')]);
199
- sql.now = length => raw('current_timestamp' + (length == null ? '' : `(${length})`));
200
- sql.lower = key => createSqlFunction('lower', key);
201
- sql.upper = key => createSqlFunction('upper', key);
197
+ sql.now = (length) => raw('current_timestamp' + (length == null ? '' : `(${length})`));
198
+ sql.lower = (key) => createSqlFunction('lower', key);
199
+ sql.upper = (key) => createSqlFunction('upper', key);
202
200
  /**
203
201
  * Tag function providing quoting of db identifiers (table name, columns names, index names, ...).
204
202
  *
@@ -213,5 +211,5 @@ sql.upper = key => createSqlFunction('upper', key);
213
211
  * ```
214
212
  */
215
213
  export function quote(expParts, ...values) {
216
- return raw(expParts.join('??'), values);
214
+ return raw(expParts.join('??'), values);
217
215
  }
@@ -4,39 +4,39 @@ import { type LoggingOptions } from '../logging/Logger.js';
4
4
  * Uses `AsyncLocalStorage` to create async context that holds the current EM fork.
5
5
  */
6
6
  export declare class RequestContext {
7
- readonly map: Map<string, EntityManager>;
8
- private static storage;
9
- private static counter;
10
- readonly id: number;
11
- constructor(map: Map<string, EntityManager>);
12
- /**
13
- * Returns default EntityManager.
14
- */
15
- get em(): EntityManager | undefined;
16
- /**
17
- * Creates new RequestContext instance and runs the code inside its domain.
18
- * If the handler is async, the return value needs to be awaited.
19
- * Uses `AsyncLocalStorage.run()`, suitable for regular express style middlewares with a `next` callback.
20
- */
21
- static create<T>(em: EntityManager | EntityManager[], next: (...args: any[]) => T, options?: CreateContextOptions): T;
22
- /**
23
- * Creates new RequestContext instance and runs the code inside its domain.
24
- * If the handler is async, the return value needs to be awaited.
25
- * Uses `AsyncLocalStorage.enterWith()`, suitable for elysia style middlewares without a `next` callback.
26
- */
27
- static enter(em: EntityManager | EntityManager[], options?: CreateContextOptions): void;
28
- /**
29
- * Returns current RequestContext (if available).
30
- */
31
- static currentRequestContext(): RequestContext | undefined;
32
- /**
33
- * Returns current EntityManager (if available).
34
- */
35
- static getEntityManager(name?: string): EntityManager | undefined;
36
- private static createContext;
7
+ readonly map: Map<string, EntityManager>;
8
+ private static storage;
9
+ private static counter;
10
+ readonly id: number;
11
+ constructor(map: Map<string, EntityManager>);
12
+ /**
13
+ * Returns default EntityManager.
14
+ */
15
+ get em(): EntityManager | undefined;
16
+ /**
17
+ * Creates new RequestContext instance and runs the code inside its domain.
18
+ * If the handler is async, the return value needs to be awaited.
19
+ * Uses `AsyncLocalStorage.run()`, suitable for regular express style middlewares with a `next` callback.
20
+ */
21
+ static create<T>(em: EntityManager | EntityManager[], next: (...args: any[]) => T, options?: CreateContextOptions): T;
22
+ /**
23
+ * Creates new RequestContext instance and runs the code inside its domain.
24
+ * If the handler is async, the return value needs to be awaited.
25
+ * Uses `AsyncLocalStorage.enterWith()`, suitable for elysia style middlewares without a `next` callback.
26
+ */
27
+ static enter(em: EntityManager | EntityManager[], options?: CreateContextOptions): void;
28
+ /**
29
+ * Returns current RequestContext (if available).
30
+ */
31
+ static currentRequestContext(): RequestContext | undefined;
32
+ /**
33
+ * Returns current EntityManager (if available).
34
+ */
35
+ static getEntityManager(name?: string): EntityManager | undefined;
36
+ private static createContext;
37
37
  }
38
38
  /** Options for creating a new RequestContext, allowing schema and logger overrides. */
39
39
  export interface CreateContextOptions {
40
- schema?: string;
41
- loggerContext?: LoggingOptions;
40
+ schema?: string;
41
+ loggerContext?: LoggingOptions;
42
42
  }
@@ -3,57 +3,58 @@ import { createAsyncContext } from './AsyncContext.js';
3
3
  * Uses `AsyncLocalStorage` to create async context that holds the current EM fork.
4
4
  */
5
5
  export class RequestContext {
6
- map;
7
- static storage = createAsyncContext();
8
- static counter = 1;
9
- id = RequestContext.counter++;
10
- constructor(map) {
11
- this.map = map;
12
- }
13
- /**
14
- * Returns default EntityManager.
15
- */
16
- get em() {
17
- return this.map.get('default');
18
- }
19
- /**
20
- * Creates new RequestContext instance and runs the code inside its domain.
21
- * If the handler is async, the return value needs to be awaited.
22
- * Uses `AsyncLocalStorage.run()`, suitable for regular express style middlewares with a `next` callback.
23
- */
24
- static create(em, next, options = {}) {
25
- const ctx = this.createContext(em, options);
26
- return this.storage.run(ctx, next);
27
- }
28
- /**
29
- * Creates new RequestContext instance and runs the code inside its domain.
30
- * If the handler is async, the return value needs to be awaited.
31
- * Uses `AsyncLocalStorage.enterWith()`, suitable for elysia style middlewares without a `next` callback.
32
- */
33
- static enter(em, options = {}) {
34
- const ctx = this.createContext(em, options);
35
- this.storage.enterWith(ctx);
36
- }
37
- /**
38
- * Returns current RequestContext (if available).
39
- */
40
- static currentRequestContext() {
41
- return this.storage.getStore();
42
- }
43
- /**
44
- * Returns current EntityManager (if available).
45
- */
46
- static getEntityManager(name = 'default') {
47
- const context = RequestContext.currentRequestContext();
48
- return context ? context.map.get(name) : undefined;
49
- }
50
- static createContext(em, options = {}) {
51
- const forks = new Map();
52
- if (Array.isArray(em)) {
53
- em.forEach(em => forks.set(em.name, em.fork({ useContext: true, ...options })));
54
- } else {
55
- forks.set(em.name, em.fork({ useContext: true, ...options }));
6
+ map;
7
+ static storage = createAsyncContext();
8
+ static counter = 1;
9
+ id = RequestContext.counter++;
10
+ constructor(map) {
11
+ this.map = map;
12
+ }
13
+ /**
14
+ * Returns default EntityManager.
15
+ */
16
+ get em() {
17
+ return this.map.get('default');
18
+ }
19
+ /**
20
+ * Creates new RequestContext instance and runs the code inside its domain.
21
+ * If the handler is async, the return value needs to be awaited.
22
+ * Uses `AsyncLocalStorage.run()`, suitable for regular express style middlewares with a `next` callback.
23
+ */
24
+ static create(em, next, options = {}) {
25
+ const ctx = this.createContext(em, options);
26
+ return this.storage.run(ctx, next);
27
+ }
28
+ /**
29
+ * Creates new RequestContext instance and runs the code inside its domain.
30
+ * If the handler is async, the return value needs to be awaited.
31
+ * Uses `AsyncLocalStorage.enterWith()`, suitable for elysia style middlewares without a `next` callback.
32
+ */
33
+ static enter(em, options = {}) {
34
+ const ctx = this.createContext(em, options);
35
+ this.storage.enterWith(ctx);
36
+ }
37
+ /**
38
+ * Returns current RequestContext (if available).
39
+ */
40
+ static currentRequestContext() {
41
+ return this.storage.getStore();
42
+ }
43
+ /**
44
+ * Returns current EntityManager (if available).
45
+ */
46
+ static getEntityManager(name = 'default') {
47
+ const context = RequestContext.currentRequestContext();
48
+ return context ? context.map.get(name) : undefined;
49
+ }
50
+ static createContext(em, options = {}) {
51
+ const forks = new Map();
52
+ if (Array.isArray(em)) {
53
+ em.forEach(em => forks.set(em.name, em.fork({ useContext: true, ...options })));
54
+ }
55
+ else {
56
+ forks.set(em.name, em.fork({ useContext: true, ...options }));
57
+ }
58
+ return new RequestContext(forks);
56
59
  }
57
- return new RequestContext(forks);
58
- }
59
60
  }
@@ -1,20 +1,20 @@
1
1
  import type { EntityManager } from '../EntityManager.js';
2
2
  /** Uses `AsyncLocalStorage` to maintain a transaction-scoped EntityManager context across async operations. */
3
3
  export declare class TransactionContext {
4
- readonly em: EntityManager;
5
- private static storage;
6
- readonly id: number;
7
- constructor(em: EntityManager);
8
- /**
9
- * Creates new TransactionContext instance and runs the code inside its domain.
10
- */
11
- static create<T>(em: EntityManager, next: (...args: any[]) => T): T;
12
- /**
13
- * Returns current TransactionContext (if available).
14
- */
15
- static currentTransactionContext(): TransactionContext | undefined;
16
- /**
17
- * Returns current EntityManager (if available).
18
- */
19
- static getEntityManager(name?: string): EntityManager | undefined;
4
+ readonly em: EntityManager;
5
+ private static storage;
6
+ readonly id: number;
7
+ constructor(em: EntityManager);
8
+ /**
9
+ * Creates new TransactionContext instance and runs the code inside its domain.
10
+ */
11
+ static create<T>(em: EntityManager, next: (...args: any[]) => T): T;
12
+ /**
13
+ * Returns current TransactionContext (if available).
14
+ */
15
+ static currentTransactionContext(): TransactionContext | undefined;
16
+ /**
17
+ * Returns current EntityManager (if available).
18
+ */
19
+ static getEntityManager(name?: string): EntityManager | undefined;
20
20
  }
@@ -1,31 +1,31 @@
1
1
  import { createAsyncContext } from './AsyncContext.js';
2
2
  /** Uses `AsyncLocalStorage` to maintain a transaction-scoped EntityManager context across async operations. */
3
3
  export class TransactionContext {
4
- em;
5
- static storage = createAsyncContext();
6
- id;
7
- constructor(em) {
8
- this.em = em;
9
- this.id = this.em._id;
10
- }
11
- /**
12
- * Creates new TransactionContext instance and runs the code inside its domain.
13
- */
14
- static create(em, next) {
15
- const context = new TransactionContext(em);
16
- return this.storage.run(context, next);
17
- }
18
- /**
19
- * Returns current TransactionContext (if available).
20
- */
21
- static currentTransactionContext() {
22
- return this.storage.getStore();
23
- }
24
- /**
25
- * Returns current EntityManager (if available).
26
- */
27
- static getEntityManager(name = 'default') {
28
- const context = TransactionContext.currentTransactionContext();
29
- return context?.em.name === name ? context.em : undefined;
30
- }
4
+ em;
5
+ static storage = createAsyncContext();
6
+ id;
7
+ constructor(em) {
8
+ this.em = em;
9
+ this.id = this.em._id;
10
+ }
11
+ /**
12
+ * Creates new TransactionContext instance and runs the code inside its domain.
13
+ */
14
+ static create(em, next) {
15
+ const context = new TransactionContext(em);
16
+ return this.storage.run(context, next);
17
+ }
18
+ /**
19
+ * Returns current TransactionContext (if available).
20
+ */
21
+ static currentTransactionContext() {
22
+ return this.storage.getStore();
23
+ }
24
+ /**
25
+ * Returns current EntityManager (if available).
26
+ */
27
+ static getEntityManager(name = 'default') {
28
+ const context = TransactionContext.currentTransactionContext();
29
+ return context?.em.name === name ? context.em : undefined;
30
+ }
31
31
  }