@tstdl/base 0.92.145 → 0.92.147

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 (251) hide show
  1. package/ai/ai-file.service.d.ts +29 -1
  2. package/ai/ai-file.service.js +66 -23
  3. package/ai/ai-session.d.ts +28 -1
  4. package/ai/ai-session.js +27 -0
  5. package/ai/ai.service.d.ts +89 -5
  6. package/ai/ai.service.js +130 -27
  7. package/ai/functions.d.ts +7 -1
  8. package/ai/functions.js +7 -1
  9. package/ai/module.d.ts +8 -0
  10. package/ai/module.js +4 -0
  11. package/ai/types.d.ts +115 -2
  12. package/ai/types.js +16 -0
  13. package/api/client/client.d.ts +1 -1
  14. package/api/client/client.js +1 -1
  15. package/api/default-error-handlers.d.ts +1 -1
  16. package/api/index.d.ts +1 -9
  17. package/api/index.js +1 -9
  18. package/api/response.d.ts +1 -1
  19. package/api/server/api-controller.d.ts +1 -1
  20. package/api/server/error-handler.d.ts +1 -1
  21. package/api/server/gateway.d.ts +1 -5
  22. package/api/server/gateway.js +0 -4
  23. package/api/server/middlewares/catch-error.middleware.d.ts +1 -1
  24. package/api/server/module.d.ts +1 -1
  25. package/api/types.d.ts +1 -1
  26. package/application/application.d.ts +1 -1
  27. package/authentication/authentication.api.d.ts +36 -1
  28. package/authentication/authentication.api.js +28 -0
  29. package/authentication/client/api.client.d.ts +14 -1
  30. package/authentication/client/api.client.js +13 -0
  31. package/authentication/client/authentication.service.d.ts +104 -1
  32. package/authentication/client/authentication.service.js +103 -0
  33. package/authentication/client/http-client.middleware.d.ts +5 -0
  34. package/authentication/client/http-client.middleware.js +6 -2
  35. package/authentication/client/module.d.ts +20 -1
  36. package/authentication/client/module.js +6 -1
  37. package/authentication/client/tokens.d.ts +6 -0
  38. package/authentication/client/tokens.js +6 -0
  39. package/authentication/models/authentication-credentials.model.d.ts +6 -0
  40. package/authentication/models/authentication-credentials.model.js +6 -0
  41. package/authentication/models/authentication-session.model.d.ts +6 -0
  42. package/authentication/models/authentication-session.model.js +6 -0
  43. package/authentication/models/init-secret-reset-data.model.d.ts +10 -1
  44. package/authentication/models/init-secret-reset-data.model.js +10 -1
  45. package/authentication/models/token-payload-base.model.d.ts +24 -4
  46. package/authentication/models/token-payload-base.model.js +24 -4
  47. package/authentication/models/token.model.d.ts +33 -2
  48. package/authentication/server/authentication-ancillary.service.d.ts +27 -4
  49. package/authentication/server/authentication-ancillary.service.js +7 -0
  50. package/authentication/server/authentication-api-request-token.provider.d.ts +3 -0
  51. package/authentication/server/authentication-api-request-token.provider.js +3 -0
  52. package/authentication/server/authentication-secret-requirements.validator.d.ts +37 -0
  53. package/authentication/server/authentication-secret-requirements.validator.js +22 -0
  54. package/authentication/server/authentication.api-controller.d.ts +66 -1
  55. package/authentication/server/authentication.api-controller.js +65 -0
  56. package/authentication/server/authentication.service.d.ts +191 -11
  57. package/authentication/server/authentication.service.js +157 -8
  58. package/authentication/server/helper.d.ts +44 -5
  59. package/authentication/server/helper.js +43 -4
  60. package/authentication/server/module.d.ts +23 -1
  61. package/authentication/server/module.js +23 -1
  62. package/browser/browser-context-controller.d.ts +1 -1
  63. package/browser/browser-controller.d.ts +1 -1
  64. package/browser/browser-controller.js +1 -1
  65. package/browser/element-controller.d.ts +1 -1
  66. package/browser/locator-controller.d.ts +1 -1
  67. package/context/context.d.ts +1 -1
  68. package/data-structures/context-data-map.d.ts +1 -1
  69. package/database/mongo/mongo-base.repository.d.ts +1 -1
  70. package/database/mongo/types.d.ts +1 -1
  71. package/database/query.d.ts +1 -1
  72. package/document-management/models/document-management-table.d.ts +1 -1
  73. package/document-management/models/document-validation-definition.model.d.ts +1 -1
  74. package/document-management/server/schemas.d.ts +1 -1
  75. package/document-management/server/services/document-collection.service.d.ts +1 -1
  76. package/document-management/server/services/document-management-observation.service.d.ts +1 -1
  77. package/document-management/server/services/document-management.service.d.ts +1 -1
  78. package/document-management/server/services/document-property.service.d.ts +3 -3
  79. package/document-management/server/services/document-request.service.d.ts +1 -1
  80. package/document-management/server/services/document-validation.service.d.ts +1 -1
  81. package/document-management/server/services/document-workflow.service.d.ts +1 -1
  82. package/document-management/server/services/document.service.d.ts +1 -1
  83. package/document-management/server/services/singleton.d.ts +1 -1
  84. package/document-management/service-models/document-management.view-model.d.ts +1 -1
  85. package/document-management/service-models/enriched/enriched-document-assignment.view.d.ts +1 -1
  86. package/document-management/service-models/enriched/enriched-document-category.view.d.ts +1 -1
  87. package/document-management/service-models/enriched/enriched-document-collection.view.d.ts +1 -1
  88. package/document-management/service-models/enriched/enriched-document-request.view.d.ts +1 -1
  89. package/document-management/service-models/enriched/enriched-document-type.view.d.ts +1 -1
  90. package/document-management/service-models/enriched/enriched-document.view.d.ts +1 -1
  91. package/document-management/service-models/enriched/enriched-requests-template-data.model.d.ts +1 -1
  92. package/dom/file-select-dialog.d.ts +1 -1
  93. package/enumeration/enumeration.d.ts +1 -1
  94. package/errors/custom.error.d.ts +3 -0
  95. package/errors/custom.error.js +0 -1
  96. package/errors/errors.localization.d.ts +1 -1
  97. package/errors/not-supported.error.d.ts +1 -1
  98. package/{formats.js → formats/formats.js} +3 -3
  99. package/formats/index.d.ts +1 -0
  100. package/formats/index.js +1 -0
  101. package/http/client/http-client-request.d.ts +1 -1
  102. package/http/client/http-client-response.d.ts +1 -1
  103. package/http/client/http-client.d.ts +1 -1
  104. package/http/client/module.d.ts +1 -1
  105. package/http/http-body.d.ts +1 -1
  106. package/http/http-value-map.d.ts +1 -1
  107. package/http/http.error.d.ts +1 -1
  108. package/http/server/http-server-request.d.ts +1 -1
  109. package/http/server/http-server-response.d.ts +1 -1
  110. package/http/types.d.ts +1 -1
  111. package/http/utils.d.ts +1 -1
  112. package/injector/decorators.d.ts +1 -1
  113. package/injector/index.d.ts +1 -1
  114. package/injector/index.js +1 -1
  115. package/injector/injector.d.ts +10 -1
  116. package/injector/injector.js +6 -0
  117. package/injector/interfaces.d.ts +1 -1
  118. package/injector/provider.d.ts +1 -1
  119. package/injector/resolution.d.ts +10 -5
  120. package/injector/resolve-chain.d.ts +2 -2
  121. package/injector/resolve-chain.js +1 -1
  122. package/injector/resolve.error.js +1 -1
  123. package/injector/token.d.ts +8 -1
  124. package/injector/token.js +7 -0
  125. package/injector/types.d.ts +1 -1
  126. package/key-value-store/key-value-store.provider.d.ts +2 -2
  127. package/key-value-store/key-value.store.d.ts +2 -2
  128. package/key-value-store/mongo/mongo-key-value-store.provider.d.ts +1 -1
  129. package/key-value-store/mongo/mongo-key-value.store.d.ts +1 -1
  130. package/key-value-store/postgres/key-value-store.service.d.ts +1 -1
  131. package/mail/mail.service.d.ts +1 -1
  132. package/mail/models/mail-data.model.d.ts +1 -1
  133. package/mail/models/mail-template.model.d.ts +1 -1
  134. package/mail/module.d.ts +1 -1
  135. package/module/index.d.ts +0 -1
  136. package/module/index.js +0 -1
  137. package/module/module-base.d.ts +1 -1
  138. package/module/module-metric-reporter.js +1 -1
  139. package/module/module.d.ts +1 -1
  140. package/module/modules/function.module.js +1 -1
  141. package/object-storage/object.d.ts +1 -1
  142. package/openid-connect/mongo-oidc-state.repository.d.ts +1 -1
  143. package/openid-connect/oidc.service.d.ts +1 -1
  144. package/orm/decorators.d.ts +2 -2
  145. package/orm/entity.d.ts +1 -1
  146. package/orm/index.d.ts +3 -3
  147. package/orm/index.js +3 -3
  148. package/orm/query.d.ts +1 -1
  149. package/orm/repository.types.d.ts +1 -1
  150. package/orm/schemas/json.d.ts +1 -1
  151. package/orm/server/database-schema.d.ts +1 -1
  152. package/orm/server/drizzle/schema-converter.d.ts +1 -1
  153. package/orm/server/repository.d.ts +1 -1
  154. package/orm/server/transaction.d.ts +1 -1
  155. package/orm/server/transactional.d.ts +3 -3
  156. package/orm/server/types.d.ts +1 -1
  157. package/orm/types.d.ts +1 -1
  158. package/package.json +23 -20
  159. package/queue/mongo/job.d.ts +1 -1
  160. package/queue/mongo/queue.js +31 -31
  161. package/queue/postgres/job.model.d.ts +1 -1
  162. package/queue/postgres/queue.d.ts +1 -1
  163. package/queue/postgres/queue.provider.d.ts +1 -1
  164. package/queue/provider.d.ts +1 -1
  165. package/reflection/decorators.d.ts +1 -1
  166. package/reflection/registry.d.ts +1 -1
  167. package/reflection/types.d.ts +1 -1
  168. package/reflection/utils.d.ts +1 -1
  169. package/rpc/model.d.ts +1 -1
  170. package/rxjs-utils/retry-backoff.js +2 -2
  171. package/schema/converters/openapi-converter.d.ts +1 -1
  172. package/schema/decorators/schema.d.ts +1 -1
  173. package/schema/decorators/utils.d.ts +1 -1
  174. package/schema/schema.d.ts +1 -1
  175. package/schema/schema.error.d.ts +1 -1
  176. package/schema/schemas/array.d.ts +1 -1
  177. package/schema/schemas/enumeration.d.ts +1 -1
  178. package/schema/schemas/function.d.ts +1 -1
  179. package/schema/schemas/instance.d.ts +1 -1
  180. package/schema/schemas/nullable.d.ts +1 -1
  181. package/schema/schemas/number.d.ts +1 -1
  182. package/schema/schemas/object.d.ts +1 -1
  183. package/schema/schemas/one-or-many.d.ts +1 -1
  184. package/schema/schemas/optional.d.ts +1 -1
  185. package/schema/schemas/simple.d.ts +1 -1
  186. package/search-index/elastic/model/index-mapping.d.ts +1 -1
  187. package/search-index/elastic/search-index.js +3 -4
  188. package/search-index/memory/memory-search-index.d.ts +1 -1
  189. package/search-index/memory/memory-search-index.js +1 -1
  190. package/serializer/handlers/binary.d.ts +1 -1
  191. package/serializer/serializable.d.ts +1 -1
  192. package/serializer/types.d.ts +1 -1
  193. package/templates/module.d.ts +1 -1
  194. package/templates/renderers/handlebars.template-renderer.d.ts +1 -1
  195. package/templates/renderers/jsx.template-renderer.d.ts +1 -1
  196. package/templates/renderers/mjml.template-renderer.d.ts +1 -1
  197. package/templates/renderers/string.template-renderer.d.ts +1 -1
  198. package/templates/resolvers/file.template-resolver.d.ts +1 -1
  199. package/templates/resolvers/jsx.template-resolver.d.ts +1 -1
  200. package/templates/resolvers/string.template-resolver.d.ts +1 -1
  201. package/templates/template.model.d.ts +1 -1
  202. package/templates/template.renderer.d.ts +1 -1
  203. package/templates/template.service.d.ts +1 -1
  204. package/text/dynamic-text.model.d.ts +1 -1
  205. package/text/localization.service.d.ts +1 -1
  206. package/types/geo-json.d.ts +1 -1
  207. package/types/index.d.ts +2 -0
  208. package/types/tagged.d.ts +1 -1
  209. package/{types.d.ts → types/types.d.ts} +2 -1
  210. package/utils/async-hook/async-hook.d.ts +109 -0
  211. package/utils/async-hook/async-hook.js +77 -3
  212. package/utils/backoff.d.ts +125 -43
  213. package/utils/backoff.js +140 -65
  214. package/utils/base64.d.ts +1 -1
  215. package/utils/base64.js +1 -2
  216. package/utils/binary.d.ts +1 -1
  217. package/utils/comparison.d.ts +5 -5
  218. package/utils/comparison.js +5 -3
  219. package/utils/cryptography.d.ts +1 -1
  220. package/utils/encoding.d.ts +1 -1
  221. package/utils/enum.d.ts +1 -1
  222. package/utils/equals.d.ts +1 -1
  223. package/utils/format-error.d.ts +1 -1
  224. package/utils/function/class.d.ts +1 -1
  225. package/utils/function/memoize.d.ts +1 -1
  226. package/utils/helpers.d.ts +1 -1
  227. package/utils/helpers.js +2 -2
  228. package/utils/jwt.d.ts +3 -3
  229. package/utils/merge.d.ts +1 -1
  230. package/utils/middleware.js +3 -3
  231. package/utils/object/decycle.d.ts +1 -1
  232. package/utils/object/forward-ref.d.ts +1 -1
  233. package/utils/object/lazy-property.d.ts +1 -1
  234. package/utils/object/object.d.ts +1 -1
  235. package/utils/object/property-name.d.ts +1 -1
  236. package/utils/patch-worker.d.ts +1 -1
  237. package/utils/reactive-value-to-signal.d.ts +1 -1
  238. package/utils/reflection.d.ts +1 -1
  239. package/utils/repl.d.ts +1 -1
  240. package/utils/singleton.d.ts +1 -1
  241. package/utils/stream/size-limited-stream.d.ts +1 -1
  242. package/utils/type/extends.d.ts +1 -1
  243. package/utils/type-guards.d.ts +1 -1
  244. package/utils/url-builder.d.ts +1 -1
  245. package/utils/z-base32.d.ts +1 -1
  246. package/module/utils.d.ts +0 -4
  247. package/module/utils.js +0 -21
  248. /package/{formats.d.ts → formats/formats.d.ts} +0 -0
  249. /package/{types.js → types/types.js} +0 -0
  250. /package/{web-types.d.ts → types/web-types.d.ts} +0 -0
  251. /package/{web-types.js → types/web-types.js} +0 -0
@@ -1,4 +1,4 @@
1
- import type { OneOrMany, Record } from '../types.js';
1
+ import type { OneOrMany, Record } from '../types/index.js';
2
2
  import type { HttpValue, NormalizedHttpValue, NormalizedHttpValueObject } from './types.js';
3
3
  export type HttpValueMapInput = Record<string, OneOrMany<HttpValue> | undefined> | Iterable<[string, OneOrMany<HttpValue> | undefined]>;
4
4
  export declare abstract class HttpValueMap<TThis extends HttpValueMap<any>> implements Iterable<[string, OneOrMany<HttpValue>]> {
@@ -1,4 +1,4 @@
1
- import type { TypedOmit, UndefinableJson } from '../types.js';
1
+ import type { TypedOmit, UndefinableJson } from '../types/index.js';
2
2
  import type { ErrorExtraInfo } from '../utils/format-error.js';
3
3
  import { CustomError } from '../errors/custom.error.js';
4
4
  import type { HttpClientRequest, HttpClientRequestObject, HttpClientResponse, HttpClientResponseObject } from './client/index.js';
@@ -1,4 +1,4 @@
1
- import type { StringMap } from '../../types.js';
1
+ import type { StringMap } from '../../types/index.js';
2
2
  import { CookieParser } from '../cookie-parser.js';
3
3
  import type { HttpBodySource } from '../http-body.js';
4
4
  import { HttpBody } from '../http-body.js';
@@ -1,6 +1,6 @@
1
1
  import type { SetCookieOptions } from '../../cookie/cookie.js';
2
2
  import type { ServerSentEventsSource } from '../../sse/server-sent-events-source.js';
3
- import type { Record } from '../../types.js';
3
+ import type { Record } from '../../types/index.js';
4
4
  import type { HttpHeadersInput } from '../http-headers.js';
5
5
  import { HttpHeaders } from '../http-headers.js';
6
6
  export type SetCookieObject = SetCookieOptions & {
package/http/types.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { OneOrMany, WritableOneOrMany } from '../types.js';
1
+ import type { OneOrMany, WritableOneOrMany } from '../types/index.js';
2
2
  export type HttpValue = string | number | boolean | null;
3
3
  export type NormalizedHttpValue = string;
4
4
  export type HttpValueObject = Record<string, OneOrMany<HttpValue>>;
package/http/utils.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import type { HttpHeaders } from '../http/http-headers.js';
2
- import type { UndefinableJson } from '../types.js';
2
+ import type { UndefinableJson } from '../types/index.js';
3
3
  import type { AnyIterable } from '../utils/any-iterable-iterator.js';
4
4
  type Body = Uint8Array | Blob | AnyIterable<Uint8Array> | ReadableStream<Uint8Array>;
5
5
  export type ReadBodyOptions = {
@@ -1,5 +1,5 @@
1
1
  import { type Decorator } from '../reflection/index.js';
2
- import type { Constructor, OneOrMany, Record, Simplify, TypedOmit } from '../types.js';
2
+ import type { Constructor, OneOrMany, Record, Simplify, TypedOmit } from '../types/index.js';
3
3
  import type { Provider } from './provider.js';
4
4
  import type { InjectionToken } from './token.js';
5
5
  import type { InjectMetadata } from './type-info.js';
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Dependency Injection
2
+ * {@include ./README.md}
3
3
  *
4
4
  * @module Injector
5
5
  */
package/injector/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Dependency Injection
2
+ * {@include ./README.md}
3
3
  *
4
4
  * @module Injector
5
5
  */
@@ -1,5 +1,5 @@
1
1
  import { type AsyncDisposable } from '../disposable/disposable.js';
2
- import type { OneOrMany, Record, TypedOmit } from '../types.js';
2
+ import type { OneOrMany, Record, TypedOmit } from '../types/index.js';
3
3
  import { type InjectOptions } from './inject.js';
4
4
  import { type ResolveArgument } from './interfaces.js';
5
5
  import { type Provider } from './provider.js';
@@ -16,6 +16,9 @@ export type GlobalRegistration<T = any, A = any> = {
16
16
  options: RegistrationOptions<T, A>;
17
17
  };
18
18
  export type Registration<T = any, A = any> = GlobalRegistration<T, A> & {
19
+ /**
20
+ * A map associating argument identities to their resolved instances of type `T`.
21
+ */
19
22
  resolutions: Map<any, T>;
20
23
  };
21
24
  export type GetRegistrationOptions = {
@@ -52,6 +55,12 @@ export declare class Injector implements AsyncDisposable {
52
55
  static registerSingleton<T, A = undefined, C extends Record = Record>(token: InjectionToken<T, A>, providers: OneOrMany<Provider<T, A, C>>, options?: TypedOmit<RegistrationOptions<T, A, C>, 'lifecycle'>): void;
53
56
  dispose(): Promise<void>;
54
57
  [Symbol.asyncDispose](): Promise<void>;
58
+ /**
59
+ * Creates a new child `Injector` instance with the specified name.
60
+ *
61
+ * @param name - The name to assign to the child injector.
62
+ * @returns The newly created child `Injector` instance.
63
+ */
55
64
  fork(name: string): Injector;
56
65
  /**
57
66
  * Register a provider for a token
@@ -82,6 +82,12 @@ export class Injector {
82
82
  async [Symbol.asyncDispose]() {
83
83
  await this.dispose();
84
84
  }
85
+ /**
86
+ * Creates a new child `Injector` instance with the specified name.
87
+ *
88
+ * @param name - The name to assign to the child injector.
89
+ * @returns The newly created child `Injector` instance.
90
+ */
85
91
  fork(name) {
86
92
  const child = new Injector(name, this);
87
93
  this.#children.push(child);
@@ -1,4 +1,4 @@
1
- import type { Record, Type } from '../types.js';
1
+ import type { Record, Type } from '../types/index.js';
2
2
  import type { ArgumentedInjectionToken, InjectionTokenArgument, ReifyingInjectionToken } from './token.js';
3
3
  import type { AfterResolveContext } from './types.js';
4
4
  export declare const resolveArgumentType: unique symbol;
@@ -1,4 +1,4 @@
1
- import type { Constructor, Record, TypedOmit } from '../types.js';
1
+ import type { Constructor, Record, TypedOmit } from '../types/index.js';
2
2
  import type { ResolveArgument } from './interfaces.js';
3
3
  import type { InjectionToken } from './token.js';
4
4
  import type { AfterResolveContext, ResolveContext } from './types.js';
@@ -1,15 +1,20 @@
1
- import type { Record } from '../types.js';
1
+ import type { Record } from '../types/index.js';
2
2
  import type { Resolvable } from './interfaces.js';
3
3
  import type { AfterResolveContext } from './types.js';
4
4
  export type AfterResolveHandler<A, D extends Record> = (argument: A, context: AfterResolveContext<D>) => void | Promise<void>;
5
5
  export type ResolutionContext<A> = {
6
6
  afterResolveRegistrations: AfterResolveHandler<A, any>[];
7
7
  };
8
- declare const assertInResolutionContext: (debugFnOrMessage: import("../types.js").Function | string) => void, getCurrentResolutionContext: {
9
- (required: true, debugFn: import("../types.js").Function): ResolutionContext<any>;
10
- (required?: false, debugFn?: import("../types.js").Function): ResolutionContext<any> | null;
11
- (required: boolean, debugFn: import("../types.js").Function): ResolutionContext<any> | null;
8
+ declare const assertInResolutionContext: (debugFnOrMessage: import("../types/index.js").Function | string) => void, getCurrentResolutionContext: {
9
+ (required: true, debugFn: import("../types/index.js").Function): ResolutionContext<any>;
10
+ (required?: false, debugFn?: import("../types/index.js").Function): ResolutionContext<any> | null;
11
+ (required: boolean, debugFn: import("../types/index.js").Function): ResolutionContext<any> | null;
12
12
  }, runInResolutionContext: <ReturnT>(context: ResolutionContext<any>, fn: () => ReturnT) => ReturnT;
13
+ /**
14
+ * Registers a handler function to be called after a dependency has been resolved.
15
+ *
16
+ * @param handler - The function to execute after resolution. It receives the resolved instance and the associated record.
17
+ */
13
18
  export declare function registerAfterResolve(handler: AfterResolveHandler<unknown, Record>): void;
14
19
  export declare function registerAfterResolve<A, D extends Record>(_this: Resolvable<A, D>, handler: AfterResolveHandler<A, D>): void;
15
20
  export { assertInResolutionContext, getCurrentResolutionContext, runInResolutionContext };
@@ -1,4 +1,4 @@
1
- import type { AbstractConstructor } from '../types.js';
1
+ import type { AbstractConstructor } from '../types/index.js';
2
2
  import type { InjectionToken } from './token.js';
3
3
  export type ResolveChainNodeBase<Type extends string> = {
4
4
  type: Type;
@@ -21,7 +21,7 @@ export type ResolveChainNode = ResolveChainNodeBase<'token'> & {
21
21
  export declare class ResolveChain {
22
22
  readonly nodes: readonly ResolveChainNode[];
23
23
  get length(): number;
24
- /** @deprecated internal */
24
+ /** @deprecated for internal use only */
25
25
  constructor(nodes: ResolveChainNode[]);
26
26
  static startWith(token: InjectionToken): ResolveChain;
27
27
  addToken(token: InjectionToken): ResolveChain;
@@ -6,7 +6,7 @@ export class ResolveChain {
6
6
  get length() {
7
7
  return this.nodes.length;
8
8
  }
9
- /** @deprecated internal */
9
+ /** @deprecated for internal use only */
10
10
  constructor(nodes) {
11
11
  this.nodes = nodes;
12
12
  }
@@ -6,7 +6,7 @@ export class ResolveError extends CustomError {
6
6
  super({
7
7
  message: `${message}${causeMessage}\n chain: ${chain.format(15)}`,
8
8
  cause,
9
- stack: cause?.stack
9
+ stack: cause?.stack,
10
10
  });
11
11
  }
12
12
  }
@@ -1,4 +1,4 @@
1
- import type { AbstractConstructor } from '../types.js';
1
+ import type { AbstractConstructor } from '../types/index.js';
2
2
  declare const type: unique symbol;
3
3
  declare const argument: unique symbol;
4
4
  export type SimpleInjectionToken<T> = AbstractConstructor<T>;
@@ -20,6 +20,13 @@ export declare class ReifyingInjectionToken<T = any, A = any> {
20
20
  constructor(description: string);
21
21
  toString(): string;
22
22
  }
23
+ /**
24
+ * Creates a new injection token.
25
+ *
26
+ * @template T The type that will be provided by the token.
27
+ * @template A Optional type for additional arguments.
28
+ * @param description A string describing the purpose of the injection token.
29
+ */
23
30
  export declare function injectionToken<T, A = never>(description: string): InjectionToken<T, A>;
24
31
  export declare function getTokenName(token: InjectionToken | undefined): string;
25
32
  export {};
package/injector/token.js CHANGED
@@ -8,6 +8,13 @@ export class ReifyingInjectionToken {
8
8
  return `InjectionToken["${this.description}"]`;
9
9
  }
10
10
  }
11
+ /**
12
+ * Creates a new injection token.
13
+ *
14
+ * @template T The type that will be provided by the token.
15
+ * @template A Optional type for additional arguments.
16
+ * @param description A string describing the purpose of the injection token.
17
+ */
11
18
  export function injectionToken(description) {
12
19
  return new ReifyingInjectionToken(description);
13
20
  }
@@ -1,6 +1,6 @@
1
1
  import type { CancellationSignal } from '../cancellation/index.js';
2
2
  import type { AsyncDisposeHandler } from '../disposable/async-disposer.js';
3
- import type { Record } from '../types.js';
3
+ import type { Record } from '../types/index.js';
4
4
  import type { ForwardRefTypeHint } from '../utils/object/forward-ref.js';
5
5
  import type { Injector, ProvidersItem } from './injector.js';
6
6
  import type { ResolveArgument } from './interfaces.js';
@@ -1,5 +1,5 @@
1
- import type { StringMap } from '../types.js';
1
+ import type { Record } from '../types/index.js';
2
2
  import type { KeyValueStore } from './key-value.store.js';
3
3
  export declare abstract class KeyValueStoreProvider {
4
- abstract get<KV extends StringMap>(module: string): KeyValueStore<KV>;
4
+ abstract get<KV extends Record<string>>(module: string): KeyValueStore<KV>;
5
5
  }
@@ -1,8 +1,8 @@
1
1
  import { type Resolvable, resolveArgumentType } from '../injector/interfaces.js';
2
- import type { StringMap } from '../types.js';
2
+ import type { Record } from '../types/index.js';
3
3
  /** Key value store module */
4
4
  export type KeyValueStoreArgument = string;
5
- export declare abstract class KeyValueStore<KV extends StringMap> implements Resolvable<KeyValueStoreArgument> {
5
+ export declare abstract class KeyValueStore<KV extends Record<string>> implements Resolvable<KeyValueStoreArgument> {
6
6
  readonly module: string;
7
7
  readonly [resolveArgumentType]: KeyValueStoreArgument;
8
8
  constructor(module: string);
@@ -1,5 +1,5 @@
1
1
  import type { KeyValueStore, KeyValueStoreProvider } from '../../key-value-store/index.js';
2
- import type { StringMap } from '../../types.js';
2
+ import type { StringMap } from '../../types/index.js';
3
3
  import { MongoKeyValueRepository } from './mongo-key-value.repository.js';
4
4
  export declare class MongoKeyValueStoreProvider implements KeyValueStoreProvider {
5
5
  private readonly keyValueRepository;
@@ -1,5 +1,5 @@
1
1
  import { KeyValueStore } from '../../key-value-store/index.js';
2
- import type { StringMap } from '../../types.js';
2
+ import type { StringMap } from '../../types/index.js';
3
3
  import { MongoKeyValueRepository } from './mongo-key-value.repository.js';
4
4
  export declare class MongoKeyValueStore<KV extends StringMap> extends KeyValueStore<KV> {
5
5
  private readonly keyValueRepository;
@@ -1,6 +1,6 @@
1
1
  import { type resolveArgumentType } from '../../injector/index.js';
2
2
  import { Transactional } from '../../orm/server/index.js';
3
- import type { Record } from '../../types.js';
3
+ import type { Record } from '../../types/index.js';
4
4
  import { KeyValueStore, type KeyValueStoreArgument } from '../key-value.store.js';
5
5
  export declare class PostgresKeyValueStore<KV extends Record<string, unknown>> extends Transactional implements KeyValueStore<KV> {
6
6
  #private;
@@ -1,4 +1,4 @@
1
- import type { TypedOmit } from '../types.js';
1
+ import type { TypedOmit } from '../types/index.js';
2
2
  import { MailClientConfig } from './mail.client.js';
3
3
  import { type MailData, type MailSendResult, type MailTemplate } from './models/index.js';
4
4
  export declare class MailService {
@@ -1,4 +1,4 @@
1
- import type { OneOrMany } from '../../types.js';
1
+ import type { OneOrMany } from '../../types/index.js';
2
2
  import type { MailAddress } from './mail-address.model.js';
3
3
  import type { MailContent } from './mail-content.model.js';
4
4
  export type MailData = {
@@ -1,5 +1,5 @@
1
1
  import type { Template, TemplateField } from '../../templates/template.model.js';
2
- import type { Record } from '../../types.js';
2
+ import type { Record } from '../../types/index.js';
3
3
  export type MailTemplate<Context extends Record = any> = Template<{
4
4
  subject: false;
5
5
  html: false;
package/mail/module.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { type DatabaseConfig } from '../orm/server/index.js';
2
- import type { Type } from '../types.js';
2
+ import type { Type } from '../types/index.js';
3
3
  import { MailClient, MailClientConfig } from './mail.client.js';
4
4
  import type { DefaultMailData } from './models/index.js';
5
5
  export declare class MailModuleConfig {
package/module/index.d.ts CHANGED
@@ -7,4 +7,3 @@ export * from './module-base.js';
7
7
  export * from './module-metric-reporter.js';
8
8
  export * from './module.js';
9
9
  export * from './modules/index.js';
10
- export * from './utils.js';
package/module/index.js CHANGED
@@ -7,4 +7,3 @@ export * from './module-base.js';
7
7
  export * from './module-metric-reporter.js';
8
8
  export * from './module.js';
9
9
  export * from './modules/index.js';
10
- export * from './utils.js';
@@ -1,6 +1,6 @@
1
1
  import type { CancellationSignal } from '../cancellation/index.js';
2
2
  import { CancellationToken } from '../cancellation/index.js';
3
- import type { StringMap } from '../types.js';
3
+ import type { StringMap } from '../types/index.js';
4
4
  import type { Module, ModuleMetric } from './module.js';
5
5
  import { ModuleState } from './module.js';
6
6
  export declare abstract class ModuleBase implements Module {
@@ -22,7 +22,7 @@ export class ModuleMetricReporter {
22
22
  const registration = {
23
23
  metric,
24
24
  moving: new MovingMetric(this.sampleCount * this.sampleInterval),
25
- reports
25
+ reports,
26
26
  };
27
27
  return registration;
28
28
  });
@@ -1,4 +1,4 @@
1
- import type { StringMap } from '../types.js';
1
+ import type { StringMap } from '../types/index.js';
2
2
  export declare enum ModuleMetricType {
3
3
  Counter = 0,
4
4
  Gauge = 1
@@ -7,6 +7,6 @@ export class FunctionModule extends ModuleBase {
7
7
  this.fn = fn;
8
8
  }
9
9
  async _run(cancellationSignal) {
10
- return this.fn(cancellationSignal);
10
+ await this.fn(cancellationSignal);
11
11
  }
12
12
  }
@@ -1,4 +1,4 @@
1
- import type { Record } from '../types.js';
1
+ import type { Record } from '../types/index.js';
2
2
  export type ObjectMetadata = Record<string>;
3
3
  export declare abstract class ObjectStorageObject {
4
4
  readonly module: string;
@@ -3,7 +3,7 @@ import { Collection, MongoEntityRepository } from '../database/mongo/index.js';
3
3
  import type { Resolvable } from '../injector/index.js';
4
4
  import { resolveArgumentType } from '../injector/index.js';
5
5
  import { Logger } from '../logger/index.js';
6
- import type { TypedOmit } from '../types.js';
6
+ import type { TypedOmit } from '../types/index.js';
7
7
  import type { OidcState } from './oidc-state.model.js';
8
8
  import { OidcStateRepository } from './oidc-state.repository.js';
9
9
  export type MongoOidcState = TypedOmit<OidcState, 'expiration'> & {
@@ -1,5 +1,5 @@
1
1
  import { HttpClient } from '../http/client/index.js';
2
- import type { Record } from '../types.js';
2
+ import type { Record } from '../types/index.js';
3
3
  import { OidcConfigurationService } from './oidc-configuration.service.js';
4
4
  import type { OidcState } from './oidc-state.model.js';
5
5
  import { OidcStateRepository } from './oidc-state.repository.js';
@@ -4,7 +4,7 @@
4
4
  */
5
5
  import type { SQL } from 'drizzle-orm';
6
6
  import type { LiteralUnion } from 'type-fest';
7
- import type { AbstractConstructor, TypedOmit } from '../types.js';
7
+ import type { AbstractConstructor, TypedOmit } from '../types/index.js';
8
8
  import type { AnyEntity, Entity, EntityType, EntityWithoutMetadata } from './entity.js';
9
9
  import type { Query } from './query.js';
10
10
  import type { TargetColumnPaths } from './repository.types.js';
@@ -121,7 +121,7 @@ export declare function createColumnDecorator(data?: OrmColumnReflectionData): P
121
121
  * @param data - The ORM reflection data to add.
122
122
  * @returns A class or property decorator.
123
123
  */
124
- export declare function createTableAndColumnDecorator(data?: OrmColumnReflectionData): ClassDecorator & PropertyDecorator;
124
+ export declare function createTableAndColumnDecorator(data?: OrmColumnReflectionData): PropertyDecorator & ClassDecorator;
125
125
  /**
126
126
  * Decorator to specify ORM column options.
127
127
  * @param options - Column configuration options.
package/orm/entity.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { Type } from '../types.js';
1
+ import type { Type } from '../types/index.js';
2
2
  import { Embedded, type HasDefault, type IsPrimaryKey, Json, Timestamp, Uuid } from './types.js';
3
3
  /**
4
4
  * Represents the type (constructor) of an entity, potentially holding an entity name.
package/orm/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
- * @module
3
- * Barrel file exporting core ORM functionalities including data types,
4
- * base entities, query types, repository types, SQL helpers, and utility types.
2
+ * {@include ./README.md}
3
+ *
4
+ * @module ORM
5
5
  */
6
6
  export * from './data-types/index.js';
7
7
  export * from './entity.js';
package/orm/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
- * @module
3
- * Barrel file exporting core ORM functionalities including data types,
4
- * base entities, query types, repository types, SQL helpers, and utility types.
2
+ * {@include ./README.md}
3
+ *
4
+ * @module ORM
5
5
  */
6
6
  export * from './data-types/index.js';
7
7
  export * from './entity.js';
package/orm/query.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * Supports logical operators, comparison operators, and specialized queries like text search and geospatial queries.
5
5
  */
6
6
  import type { SQLWrapper } from 'drizzle-orm';
7
- import type { Flatten, Record } from '../types.js';
7
+ import type { Flatten, Record } from '../types/index.js';
8
8
  import type { Geometry } from '../types/geo-json.js';
9
9
  import type { UntaggedDeep } from '../types/tagged.js';
10
10
  /** Represents a logical query combining multiple sub-queries (e.g., $and, $or, $nor). */
@@ -3,7 +3,7 @@
3
3
  * Defines types used by ORM repositories for operations like loading, updating, and creating entities.
4
4
  * Includes types for ordering, loading options, and entity data structures for create/update operations.
5
5
  */
6
- import type { Paths, Record, TypedOmit } from '../types.js';
6
+ import type { Paths, Record, TypedOmit } from '../types/index.js';
7
7
  import type { UntaggedDeep } from '../types/tagged.js';
8
8
  import type { SQL, SQLWrapper } from 'drizzle-orm';
9
9
  import type { PartialDeep } from 'type-fest';
@@ -1,7 +1,7 @@
1
1
  import type { JsonPath } from '../../json-path/json-path.js';
2
2
  import { type Decorator } from '../../reflection/index.js';
3
3
  import { Schema, type SchemaDecoratorOptions, type SchemaTestable, type SchemaTestOptions, type SchemaTestResult } from '../../schema/index.js';
4
- import type { TypedOmit } from '../../types.js';
4
+ import type { TypedOmit } from '../../types/index.js';
5
5
  export type JsonSchemaOptions<T> = {
6
6
  schema?: SchemaTestable<T>;
7
7
  };
@@ -4,7 +4,7 @@
4
4
  * within a specific PostgreSQL schema.
5
5
  */
6
6
  import type { PgEnum } from 'drizzle-orm/pg-core';
7
- import type { Enumeration, EnumerationValue, UnionToTuple } from '../../types.js';
7
+ import type { Enumeration, EnumerationValue, UnionToTuple } from '../../types/index.js';
8
8
  import type { EntityType } from '../entity.js';
9
9
  import type { PgTableFromType } from './types.js';
10
10
  /**
@@ -1,5 +1,5 @@
1
1
  import { type PgEnum, type PgSchema, type PgTableWithColumns } from 'drizzle-orm/pg-core';
2
- import type { AbstractConstructor, Enumeration } from '../../../types.js';
2
+ import type { AbstractConstructor, Enumeration } from '../../../types/index.js';
3
3
  import type { EntityType } from '../../entity.js';
4
4
  import type { ColumnDefinition, ColumnDefinitionsMap, PgTableFromType } from '../types.js';
5
5
  type ConverterContext = {
@@ -1,7 +1,7 @@
1
1
  import { SQL } from 'drizzle-orm';
2
2
  import type { PgColumn, PgInsertValue, PgUpdateSetSource } from 'drizzle-orm/pg-core';
3
3
  import { type Resolvable, resolveArgumentType } from '../../injector/interfaces.js';
4
- import type { DeepPartial, OneOrMany, Paths, Type } from '../../types.js';
4
+ import type { DeepPartial, OneOrMany, Paths, Type } from '../../types/index.js';
5
5
  import type { UntaggedDeep } from '../../types/index.js';
6
6
  import { Entity, type EntityMetadataAttributes, type EntityType, type EntityWithoutMetadata } from '../entity.js';
7
7
  import type { Query } from '../query.js';
@@ -1,6 +1,6 @@
1
1
  import { PgTransaction as DrizzlePgTransaction, type PgQueryResultHKT, type PgTransactionConfig } from 'drizzle-orm/pg-core';
2
2
  import { DeferredPromise } from '../../promise/deferred-promise.js';
3
- import type { Record } from '../../types.js';
3
+ import type { Record } from '../../types/index.js';
4
4
  import type { Database } from './database.js';
5
5
  export type PgTransaction = DrizzlePgTransaction<PgQueryResultHKT, Record, Record>;
6
6
  export { DrizzlePgTransaction };
@@ -15,9 +15,9 @@ type TransactionalContext<ContextData = unknown> = {
15
15
  data: ContextData;
16
16
  };
17
17
  declare const getCurrentTransactionalContext: {
18
- (required: true, debugFn: import("../../types.js").Function): TransactionalContext<unknown>;
19
- (required?: false, debugFn?: import("../../types.js").Function): TransactionalContext<unknown> | null;
20
- (required: boolean, debugFn: import("../../types.js").Function): TransactionalContext<unknown> | null;
18
+ (required: true, debugFn: import("../../types/index.js").Function): TransactionalContext<unknown>;
19
+ (required?: false, debugFn?: import("../../types/index.js").Function): TransactionalContext<unknown> | null;
20
+ (required: boolean, debugFn: import("../../types/index.js").Function): TransactionalContext<unknown> | null;
21
21
  }, runInTransactionalContext: <ReturnT>(context: TransactionalContext<unknown>, fn: () => ReturnT) => ReturnT, isInTransactionalContext: () => boolean;
22
22
  export { getCurrentTransactionalContext, isInTransactionalContext, runInTransactionalContext };
23
23
  export declare abstract class Transactional<ContextData = unknown> {
@@ -3,7 +3,7 @@ import type { PgColumnBuilder, PgTableWithColumns } from 'drizzle-orm/pg-core';
3
3
  import type { CamelCase, ConditionalPick, SnakeCase } from 'type-fest';
4
4
  import type { JsonPath } from '../../json-path/json-path.js';
5
5
  import type { Record } from '../../schema/index.js';
6
- import type { UnionToIntersection } from '../../types.js';
6
+ import type { UnionToIntersection } from '../../types/index.js';
7
7
  import type { Tagged } from '../../types/index.js';
8
8
  import type { OrmColumnReflectionData } from '../decorators.js';
9
9
  import type { EntityType } from '../entity.js';
package/orm/types.d.ts CHANGED
@@ -7,7 +7,7 @@
7
7
  import type { $Type, HasDefault as DrizzleHasDefault, IsPrimaryKey as DrizzleIsPrimaryKey } from 'drizzle-orm';
8
8
  import type { boolean, doublePrecision, integer, jsonb, PgColumnBuilder, PgColumnBuilderBase, PgEnumColumnBuilderInitial, text, uuid } from 'drizzle-orm/pg-core';
9
9
  import { Array, Integer } from '../schema/index.js';
10
- import type { AbstractConstructor, EnumerationObject, EnumerationValue, ObjectLiteral, UnionToTuple } from '../types.js';
10
+ import type { AbstractConstructor, EnumerationObject, EnumerationValue, ObjectLiteral, UnionToTuple } from '../types/index.js';
11
11
  import type { GetTagMetadata, HasTag, Tagged, UnwrapTagged } from '../types/index.js';
12
12
  import type { bytea, numericDate, timestamp } from './data-types/index.js';
13
13
  import { Check, Column, Embedded, Encrypted, Index, PrimaryKey, References, Table, Unique } from './decorators.js';