@forinda/kickjs 2.0.1 → 2.1.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 (236) hide show
  1. package/dist/adapter-BqGjZCSm.d.mts +122 -0
  2. package/dist/adapter-BqGjZCSm.d.mts.map +1 -0
  3. package/dist/app-module-CcEbAVtB.d.mts +33 -0
  4. package/dist/app-module-CcEbAVtB.d.mts.map +1 -0
  5. package/dist/application-DNHj-_UL.mjs +449 -0
  6. package/dist/application-DNHj-_UL.mjs.map +1 -0
  7. package/dist/bootstrap-DLEZaJ3b.mjs +205 -0
  8. package/dist/bootstrap-DLEZaJ3b.mjs.map +1 -0
  9. package/dist/{core/cache.d.ts → cache-DJeMaGqb.d.mts} +33 -31
  10. package/dist/cache-DJeMaGqb.d.mts.map +1 -0
  11. package/dist/chunk-C5Qp-JxE.mjs +15 -0
  12. package/dist/container-nBSIhyqV.d.mts +141 -0
  13. package/dist/container-nBSIhyqV.d.mts.map +1 -0
  14. package/dist/core/adapter.d.mts +3 -0
  15. package/dist/core/adapter.mjs +11 -0
  16. package/dist/core/app-module.d.mts +3 -0
  17. package/dist/core/app-module.mjs +11 -0
  18. package/dist/core/cache.d.mts +3 -0
  19. package/dist/core/cache.mjs +113 -0
  20. package/dist/core/cache.mjs.map +1 -0
  21. package/dist/core/container.d.mts +3 -0
  22. package/dist/core/container.mjs +426 -0
  23. package/dist/core/container.mjs.map +1 -0
  24. package/dist/core/cron.d.mts +3 -0
  25. package/dist/core/cron.mjs +42 -0
  26. package/dist/core/cron.mjs.map +1 -0
  27. package/dist/core/decorators.d.mts +3 -0
  28. package/dist/core/decorators.mjs +213 -0
  29. package/dist/core/decorators.mjs.map +1 -0
  30. package/dist/core/errors.d.mts +3 -0
  31. package/dist/core/errors.mjs +97 -0
  32. package/dist/core/errors.mjs.map +1 -0
  33. package/dist/core/interfaces.d.mts +3 -0
  34. package/dist/core/interfaces.mjs +44 -0
  35. package/dist/core/interfaces.mjs.map +1 -0
  36. package/dist/core/logger.d.mts +3 -0
  37. package/dist/core/logger.mjs +217 -0
  38. package/dist/core/logger.mjs.map +1 -0
  39. package/dist/core/path.d.mts +3 -0
  40. package/dist/core/path.mjs +45 -0
  41. package/dist/core/path.mjs.map +1 -0
  42. package/dist/core/plugin.d.mts +3 -0
  43. package/dist/core/plugin.mjs +11 -0
  44. package/dist/core/reactivity.d.mts +3 -0
  45. package/dist/core/reactivity.mjs +189 -0
  46. package/dist/core/reactivity.mjs.map +1 -0
  47. package/dist/core-BL_H8fEZ.mjs +121 -0
  48. package/dist/core-BL_H8fEZ.mjs.map +1 -0
  49. package/dist/{core/cron.d.ts → cron-RKhH5TOd.d.mts} +16 -14
  50. package/dist/cron-RKhH5TOd.d.mts.map +1 -0
  51. package/dist/decorators-CQ93ak6Z.d.mts +154 -0
  52. package/dist/decorators-CQ93ak6Z.d.mts.map +1 -0
  53. package/dist/errors-te5Km00o.d.mts +68 -0
  54. package/dist/errors-te5Km00o.d.mts.map +1 -0
  55. package/dist/http/application.d.mts +220 -0
  56. package/dist/http/application.d.mts.map +1 -0
  57. package/dist/http/application.mjs +12 -0
  58. package/dist/http/bootstrap.d.mts +43 -0
  59. package/dist/http/bootstrap.d.mts.map +1 -0
  60. package/dist/http/bootstrap.mjs +12 -0
  61. package/dist/http/context.d.mts +131 -0
  62. package/dist/http/context.d.mts.map +1 -0
  63. package/dist/http/context.mjs +220 -0
  64. package/dist/http/context.mjs.map +1 -0
  65. package/dist/http/middleware/cors.d.mts +48 -0
  66. package/dist/http/middleware/cors.d.mts.map +1 -0
  67. package/dist/http/middleware/cors.mjs +83 -0
  68. package/dist/http/middleware/cors.mjs.map +1 -0
  69. package/dist/http/middleware/csrf.d.mts +52 -0
  70. package/dist/http/middleware/csrf.d.mts.map +1 -0
  71. package/dist/http/middleware/csrf.mjs +72 -0
  72. package/dist/http/middleware/csrf.mjs.map +1 -0
  73. package/dist/http/middleware/error-handler.d.mts +11 -0
  74. package/dist/http/middleware/error-handler.d.mts.map +1 -0
  75. package/dist/http/middleware/error-handler.mjs +52 -0
  76. package/dist/http/middleware/error-handler.mjs.map +1 -0
  77. package/dist/http/middleware/helmet.d.mts +41 -0
  78. package/dist/http/middleware/helmet.d.mts.map +1 -0
  79. package/dist/http/middleware/helmet.mjs +51 -0
  80. package/dist/http/middleware/helmet.mjs.map +1 -0
  81. package/dist/http/middleware/rate-limit.d.mts +56 -0
  82. package/dist/http/middleware/rate-limit.d.mts.map +1 -0
  83. package/dist/http/middleware/rate-limit.mjs +101 -0
  84. package/dist/http/middleware/rate-limit.mjs.map +1 -0
  85. package/dist/http/middleware/request-id.d.mts +10 -0
  86. package/dist/http/middleware/request-id.d.mts.map +1 -0
  87. package/dist/http/middleware/request-id.mjs +26 -0
  88. package/dist/http/middleware/request-id.mjs.map +1 -0
  89. package/dist/http/middleware/request-logger.d.mts +32 -0
  90. package/dist/http/middleware/request-logger.d.mts.map +1 -0
  91. package/dist/http/middleware/request-logger.mjs +49 -0
  92. package/dist/http/middleware/request-logger.mjs.map +1 -0
  93. package/dist/http/middleware/session.d.mts +67 -0
  94. package/dist/http/middleware/session.d.mts.map +1 -0
  95. package/dist/http/middleware/session.mjs +152 -0
  96. package/dist/http/middleware/session.mjs.map +1 -0
  97. package/dist/http/middleware/spa.d.mts +101 -0
  98. package/dist/http/middleware/spa.d.mts.map +1 -0
  99. package/dist/http/middleware/spa.mjs +108 -0
  100. package/dist/http/middleware/spa.mjs.map +1 -0
  101. package/dist/http/middleware/{upload.d.ts → upload.d.mts} +21 -17
  102. package/dist/http/middleware/upload.d.mts.map +1 -0
  103. package/dist/http/middleware/upload.mjs +191 -0
  104. package/dist/http/middleware/upload.mjs.map +1 -0
  105. package/dist/http/middleware/validate.d.mts +18 -0
  106. package/dist/http/middleware/validate.d.mts.map +1 -0
  107. package/dist/http/middleware/validate.mjs +62 -0
  108. package/dist/http/middleware/validate.mjs.map +1 -0
  109. package/dist/http/middleware/views.d.mts +62 -0
  110. package/dist/http/middleware/views.d.mts.map +1 -0
  111. package/dist/http/middleware/views.mjs +65 -0
  112. package/dist/http/middleware/views.mjs.map +1 -0
  113. package/dist/http/query/index.d.mts +3 -0
  114. package/dist/http/query/index.mjs +12 -0
  115. package/dist/http/{router-builder.d.ts → router-builder.d.mts} +9 -5
  116. package/dist/http/router-builder.d.mts.map +1 -0
  117. package/dist/http/router-builder.mjs +67 -0
  118. package/dist/http/router-builder.mjs.map +1 -0
  119. package/dist/index-C0gbnpSg.d.mts +107 -0
  120. package/dist/index-C0gbnpSg.d.mts.map +1 -0
  121. package/dist/index-Cls52etj.d.mts +148 -0
  122. package/dist/index-Cls52etj.d.mts.map +1 -0
  123. package/dist/index.d.mts +133 -0
  124. package/dist/index.d.mts.map +1 -0
  125. package/dist/index.mjs +126 -0
  126. package/dist/index.mjs.map +1 -0
  127. package/dist/interfaces-D-48zotH.d.mts +52 -0
  128. package/dist/interfaces-D-48zotH.d.mts.map +1 -0
  129. package/dist/logger-Dzj-TF0t.d.mts +119 -0
  130. package/dist/logger-Dzj-TF0t.d.mts.map +1 -0
  131. package/dist/metadata-fmvikBA0.mjs +76 -0
  132. package/dist/metadata-fmvikBA0.mjs.map +1 -0
  133. package/dist/{core/path.d.ts → path-LmwfhfyH.d.mts} +7 -3
  134. package/dist/path-LmwfhfyH.d.mts.map +1 -0
  135. package/dist/plugin-DIoPIpSm.d.mts +95 -0
  136. package/dist/plugin-DIoPIpSm.d.mts.map +1 -0
  137. package/dist/query-7cdHF6ry.mjs +164 -0
  138. package/dist/query-7cdHF6ry.mjs.map +1 -0
  139. package/dist/{core/reactivity.d.ts → reactivity-BbS-99ow.d.mts} +21 -20
  140. package/dist/reactivity-BbS-99ow.d.mts.map +1 -0
  141. package/package.json +73 -43
  142. package/dist/chunk-DVVP7zzD.js +0 -7
  143. package/dist/core/adapter.d.ts +0 -109
  144. package/dist/core/adapter.d.ts.map +0 -1
  145. package/dist/core/adapter.js +0 -0
  146. package/dist/core/app-module.d.ts +0 -28
  147. package/dist/core/app-module.d.ts.map +0 -1
  148. package/dist/core/app-module.js +0 -0
  149. package/dist/core/cache.d.ts.map +0 -1
  150. package/dist/core/cache.js +0 -57
  151. package/dist/core/container.d.ts +0 -63
  152. package/dist/core/container.d.ts.map +0 -1
  153. package/dist/core/container.js +0 -117
  154. package/dist/core/cron.d.ts.map +0 -1
  155. package/dist/core/cron.js +0 -22
  156. package/dist/core/decorators.d.ts +0 -153
  157. package/dist/core/decorators.d.ts.map +0 -1
  158. package/dist/core/decorators.js +0 -141
  159. package/dist/core/errors.d.ts +0 -64
  160. package/dist/core/errors.d.ts.map +0 -1
  161. package/dist/core/errors.js +0 -67
  162. package/dist/core/index.d.ts +0 -14
  163. package/dist/core/index.d.ts.map +0 -1
  164. package/dist/core/interfaces.d.ts +0 -44
  165. package/dist/core/interfaces.d.ts.map +0 -1
  166. package/dist/core/interfaces.js +0 -25
  167. package/dist/core/logger.d.ts +0 -43
  168. package/dist/core/logger.d.ts.map +0 -1
  169. package/dist/core/logger.js +0 -54
  170. package/dist/core/path.d.ts.map +0 -1
  171. package/dist/core/path.js +0 -12
  172. package/dist/core/plugin.d.ts +0 -90
  173. package/dist/core/plugin.d.ts.map +0 -1
  174. package/dist/core/plugin.js +0 -0
  175. package/dist/core/reactivity.d.ts.map +0 -1
  176. package/dist/core/reactivity.js +0 -101
  177. package/dist/core-B6Okew3W.js +0 -7
  178. package/dist/http/application.d.ts +0 -103
  179. package/dist/http/application.d.ts.map +0 -1
  180. package/dist/http/application.js +0 -167
  181. package/dist/http/bootstrap.d.ts +0 -22
  182. package/dist/http/bootstrap.d.ts.map +0 -1
  183. package/dist/http/bootstrap.js +0 -40
  184. package/dist/http/context.d.ts +0 -129
  185. package/dist/http/context.d.ts.map +0 -1
  186. package/dist/http/context.js +0 -115
  187. package/dist/http/index.d.ts +0 -16
  188. package/dist/http/index.d.ts.map +0 -1
  189. package/dist/http/middleware/cors.d.ts +0 -43
  190. package/dist/http/middleware/cors.d.ts.map +0 -1
  191. package/dist/http/middleware/cors.js +0 -31
  192. package/dist/http/middleware/csrf.d.ts +0 -47
  193. package/dist/http/middleware/csrf.d.ts.map +0 -1
  194. package/dist/http/middleware/csrf.js +0 -25
  195. package/dist/http/middleware/error-handler.d.ts +0 -6
  196. package/dist/http/middleware/error-handler.d.ts.map +0 -1
  197. package/dist/http/middleware/error-handler.js +0 -37
  198. package/dist/http/middleware/helmet.d.ts +0 -36
  199. package/dist/http/middleware/helmet.d.ts.map +0 -1
  200. package/dist/http/middleware/helmet.js +0 -20
  201. package/dist/http/middleware/rate-limit.d.ts +0 -51
  202. package/dist/http/middleware/rate-limit.d.ts.map +0 -1
  203. package/dist/http/middleware/rate-limit.js +0 -46
  204. package/dist/http/middleware/request-id.d.ts +0 -5
  205. package/dist/http/middleware/request-id.d.ts.map +0 -1
  206. package/dist/http/middleware/request-id.js +0 -12
  207. package/dist/http/middleware/request-logger.d.ts +0 -27
  208. package/dist/http/middleware/request-logger.d.ts.map +0 -1
  209. package/dist/http/middleware/request-logger.js +0 -16
  210. package/dist/http/middleware/session.d.ts +0 -62
  211. package/dist/http/middleware/session.d.ts.map +0 -1
  212. package/dist/http/middleware/session.js +0 -76
  213. package/dist/http/middleware/spa.d.ts +0 -93
  214. package/dist/http/middleware/spa.d.ts.map +0 -1
  215. package/dist/http/middleware/spa.js +0 -52
  216. package/dist/http/middleware/upload.d.ts.map +0 -1
  217. package/dist/http/middleware/upload.js +0 -119
  218. package/dist/http/middleware/validate.d.ts +0 -13
  219. package/dist/http/middleware/validate.d.ts.map +0 -1
  220. package/dist/http/middleware/validate.js +0 -45
  221. package/dist/http/middleware/views.d.ts +0 -56
  222. package/dist/http/middleware/views.d.ts.map +0 -1
  223. package/dist/http/middleware/views.js +0 -18
  224. package/dist/http/query/index.d.ts +0 -4
  225. package/dist/http/query/index.d.ts.map +0 -1
  226. package/dist/http/query/index.js +0 -10
  227. package/dist/http/query/parse-query.d.ts +0 -44
  228. package/dist/http/query/parse-query.d.ts.map +0 -1
  229. package/dist/http/query/types.d.ts +0 -100
  230. package/dist/http/query/types.d.ts.map +0 -1
  231. package/dist/http/router-builder.d.ts.map +0 -1
  232. package/dist/http/router-builder.js +0 -37
  233. package/dist/index.d.ts +0 -25
  234. package/dist/index.d.ts.map +0 -1
  235. package/dist/index.js +0 -103
  236. package/dist/query-Bym31XRp.js +0 -88
@@ -0,0 +1,133 @@
1
+
2
+ import { a as METADATA, c as Scope, i as Constructor, l as ServiceOptions, n as BuilderOf, o as MaybePromise, r as ClassKind, s as PostConstructStatus, t as Buildable } from "./interfaces-D-48zotH.mjs";
3
+ import { i as tokenName, n as ContainerChangeEvent, r as ContainerChangeListener, t as Container } from "./container-nBSIhyqV.mjs";
4
+ import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-BqGjZCSm.mjs";
5
+ import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-CcEbAVtB.mjs";
6
+ import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider } from "./cache-DJeMaGqb.mjs";
7
+ import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-RKhH5TOd.mjs";
8
+ import { C as RouteDefinition, E as normalizeApiQueryParamsConfig, S as Repository, T as Value, _ as MiddlewareHandler, a as Builder, b as PostConstruct, c as Controller, d as FileUpload, f as FileUploadConfig, g as Middleware, h as Injectable, i as BaseUploadOptions, l as Delete, m as Inject, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as Get, r as Autowired, s as Component, t as ApiQueryParams, u as FileTypeFilter, v as Patch, w as Service, x as Put, y as Post } from "./decorators-CQ93ak6Z.mjs";
9
+ import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-te5Km00o.mjs";
10
+ import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-Dzj-TF0t.mjs";
11
+ import { n as normalizePath, t as joinPaths } from "./path-LmwfhfyH.mjs";
12
+ import { t as KickPlugin } from "./plugin-DIoPIpSm.mjs";
13
+ import { a as isRef, c as toRefs, i as computed, l as unref, n as Ref, o as reactive, r as WatchOptions, s as ref, t as ComputedRef, u as watch } from "./reactivity-BbS-99ow.mjs";
14
+ import { _ as setInMetaRecord, a as CircuitOpenError, c as getMetaMap, d as getMethodMetaOrUndefined, f as hasClassMeta, g as setInMetaMap, h as setClassMeta, i as CircuitBreakerStats, l as getMetaRecord, m as pushMethodMeta, n as CircuitBreakerOptions, o as getClassMeta, p as pushClassMeta, r as CircuitBreakerState, s as getClassMetaOrUndefined, t as CircuitBreaker, u as getMethodMeta, v as setMethodMeta } from "./index-C0gbnpSg.mjs";
15
+ import { Application, ApplicationOptions, MiddlewareEntry } from "./http/application.mjs";
16
+ import { bootstrap } from "./http/bootstrap.mjs";
17
+ import { a as parseSearchQuery, c as FILTER_OPERATORS, d as PaginatedResponse, f as PaginationParams, g as SortItem, h as QueryFieldConfig, i as parseQuery, l as FilterItem, m as QueryBuilderAdapter, n as parseFilters, o as parseSort, p as ParsedQuery, r as parsePagination, t as buildQueryParams, u as FilterOperator } from "./index-Cls52etj.mjs";
18
+ import { RequestContext } from "./http/context.mjs";
19
+ import { CorsOptions, cors } from "./http/middleware/cors.mjs";
20
+ import { CsrfOptions, csrf } from "./http/middleware/csrf.mjs";
21
+ import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
22
+ import { HelmetOptions, helmet } from "./http/middleware/helmet.mjs";
23
+ import { RateLimitOptions, RateLimitStore, rateLimit } from "./http/middleware/rate-limit.mjs";
24
+ import { REQUEST_ID_HEADER, requestId } from "./http/middleware/request-id.mjs";
25
+ import { RequestLoggerOptions, requestLogger } from "./http/middleware/request-logger.mjs";
26
+ import { Session, SessionData, SessionOptions, SessionStore, session } from "./http/middleware/session.mjs";
27
+ import { SpaAdapter, SpaAdapterOptions } from "./http/middleware/spa.mjs";
28
+ import { UploadOptions, buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload } from "./http/middleware/upload.mjs";
29
+ import { validate } from "./http/middleware/validate.mjs";
30
+ import { ViewAdapter, ViewAdapterOptions } from "./http/middleware/views.mjs";
31
+ import { buildRoutes, getControllerPath } from "./http/router-builder.mjs";
32
+ import { NextFunction, Request, Response } from "express";
33
+ import { AsyncLocalStorage } from "node:async_hooks";
34
+
35
+ //#region src/http/cluster.d.ts
36
+ interface ClusterOptions {
37
+ /** Number of worker processes (default: os.cpus().length) */
38
+ workers?: number;
39
+ /** Delay before forcefully killing a worker during shutdown (ms), default: 5000 */
40
+ gracefulShutdownTimeout?: number;
41
+ /** Delay between worker restarts (ms), default: 1000 */
42
+ restartDelay?: number;
43
+ /** Max failures in restartWindow before refusing to restart, default: 5 */
44
+ maxFailures?: number;
45
+ /** Time window for counting failures (ms), default: 30000 */
46
+ restartWindow?: number;
47
+ }
48
+ /** Returns true if the current process is the cluster primary */
49
+ declare function isClusterPrimary(): boolean;
50
+ //#endregion
51
+ //#region src/http/request-store.d.ts
52
+ /** Per-request storage for REQUEST-scoped DI and request context propagation */
53
+ interface RequestStore {
54
+ /** Unique request identifier */
55
+ requestId: string;
56
+ /** Per-request singleton cache for REQUEST-scoped services */
57
+ instances: Map<any, any>;
58
+ /** Per-request values set by middleware (auth user, tenant, etc.) */
59
+ values: Map<any, any>;
60
+ }
61
+ /** AsyncLocalStorage instance shared across the framework */
62
+ declare const requestStore: AsyncLocalStorage<RequestStore>;
63
+ /**
64
+ * Get the current request store. Throws if called outside a request context.
65
+ * Used by the Container to resolve REQUEST-scoped dependencies.
66
+ */
67
+ declare function getRequestStore(): RequestStore;
68
+ //#endregion
69
+ //#region src/http/middleware/request-scope.d.ts
70
+ /**
71
+ * Wraps each request in an AsyncLocalStorage context.
72
+ * Enables REQUEST-scoped DI and automatic requestId propagation to logs.
73
+ *
74
+ * Should be mounted early in the middleware pipeline (before route handlers).
75
+ */
76
+ declare function requestScopeMiddleware(): (req: Request, _res: Response, next: NextFunction) => void;
77
+ //#endregion
78
+ //#region src/http/middleware/trace-context.d.ts
79
+ /**
80
+ * W3C Trace Context header name.
81
+ * @see https://www.w3.org/TR/trace-context/#traceparent-header
82
+ */
83
+ declare const TRACEPARENT_HEADER = "traceparent";
84
+ interface TraceContextOptions {
85
+ /**
86
+ * When true, respond with a `traceresponse` header containing the trace ID.
87
+ * Useful for debugging. Default: false.
88
+ */
89
+ propagateResponse?: boolean;
90
+ }
91
+ /**
92
+ * Parsed W3C trace context fields.
93
+ */
94
+ interface TraceContext {
95
+ /** W3C traceparent version (usually '00') */
96
+ version: string;
97
+ /** 32-hex-char distributed trace ID */
98
+ traceId: string;
99
+ /** 16-hex-char parent span ID */
100
+ parentSpanId: string;
101
+ /** 2-hex-char trace flags */
102
+ flags: string;
103
+ }
104
+ /**
105
+ * Parse a W3C traceparent header value.
106
+ * Returns null if the format is invalid.
107
+ */
108
+ declare function parseTraceparent(header: string): TraceContext | null;
109
+ /**
110
+ * Middleware that extracts W3C `traceparent` header and stores trace context
111
+ * in the request's AsyncLocalStorage store.
112
+ *
113
+ * If no valid `traceparent` header is present, a new traceId is generated
114
+ * so that every request always has a trace ID available for correlation.
115
+ *
116
+ * Must be mounted **after** `requestScopeMiddleware()` (which creates the store).
117
+ *
118
+ * @example
119
+ * ```ts
120
+ * bootstrap({
121
+ * middleware: [
122
+ * requestScopeMiddleware(),
123
+ * traceContext(), // extracts or generates traceId
124
+ * requestLogger(),
125
+ * express.json(),
126
+ * ],
127
+ * })
128
+ * ```
129
+ */
130
+ declare function traceContext(options?: TraceContextOptions): (req: Request, res: Response, next: NextFunction) => void;
131
+ //#endregion
132
+ export { AdapterContext, AdapterMiddleware, ApiQueryParams, ApiQueryParamsConfig, ApiQueryParamsConfig as QueryParamsConfig, AppAdapter, AppAdapterClass, AppModule, AppModuleClass, Application, type ApplicationOptions, Autowired, BaseUploadOptions, Buildable, Builder, BuilderOf, CRON_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, CircuitBreaker, CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerStats, CircuitOpenError, ClassKind, type ClusterOptions, ColumnApiQueryParamsConfig, Component, ComputedRef, ConsoleLoggerProvider, Constructor, Container, ContainerChangeEvent, ContainerChangeListener, Controller, type CorsOptions, Cron, CronJobMeta, type CsrfOptions, Delete, FILTER_OPERATORS, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, Inject, Injectable, KickPlugin, Logger, LoggerProvider, METADATA, MaybePromise, MemoryCacheProvider, Middleware, type MiddlewareEntry, MiddlewareHandler, MiddlewarePhase, ModuleRoutes, type PaginatedResponse, type PaginationParams, type ParsedQuery, Patch, Post, PostConstruct, PostConstructStatus, Put, type QueryBuilderAdapter, type QueryFieldConfig, REQUEST_ID_HEADER, type RateLimitOptions, type RateLimitStore, Ref, Repository, RequestContext, type RequestLoggerOptions, type RequestStore, RouteDefinition, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
133
+ //# sourceMappingURL=index.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/http/cluster.ts","../src/http/request-store.ts","../src/http/middleware/request-scope.ts","../src/http/middleware/trace-context.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAOiB,cAAA;;EAEf,OAAA;;EAEA,uBAAA;;EAEA,YAAA;;EAEA,WAAA;;EAEA,aAAA;AAAA;;iBAIc,gBAAA,CAAA;;;;UClBC,YAAA;;EAEf,SAAA;;EAEA,SAAA,EAAW,GAAA;;EAEX,MAAA,EAAQ,GAAA;AAAA;;cAIG,YAAA,EAAY,iBAAA,CAAA,YAAA;;;;;iBAMT,eAAA,CAAA,GAAmB,YAAA;;;;;;;;;iBCTnB,sBAAA,CAAA,IACN,GAAA,EAAK,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,YAAA;;;;;;;cCHjC,kBAAA;AAAA,UAKI,mBAAA;;;;;EAKf,iBAAA;AAAA;;;;UAMe,YAAA;;EAEf,OAAA;;EAEA,OAAA;;EAEA,YAAA;;EAEA,KAAA;AAAA;;;;;iBAqBc,gBAAA,CAAiB,MAAA,WAAiB,YAAA;;;;AH9ClD;;;;;;;;;;;AAcA;;;;;;;iBG0EgB,YAAA,CAAa,OAAA,GAAS,mBAAA,IAC5B,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
package/dist/index.mjs ADDED
@@ -0,0 +1,126 @@
1
+ /**
2
+ * @forinda/kickjs v2.1.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ import { METADATA, Scope } from "./core/interfaces.mjs";
12
+ import { ConsoleLoggerProvider, Logger, createLogger, logger, rootLogger } from "./core/logger.mjs";
13
+ import { a as getMethodMeta, c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, i as getMetaRecord, l as pushMethodMeta, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, p as setMethodMeta, r as getMetaMap, s as hasClassMeta, t as getClassMeta, u as setClassMeta } from "./metadata-fmvikBA0.mjs";
14
+ import { Container, tokenName } from "./core/container.mjs";
15
+ import { ApiQueryParams, Autowired, Builder, Component, Controller, Delete, FileUpload, Get, Inject, Injectable, Middleware, Patch, Post, PostConstruct, Put, Repository, Service, Value, normalizeApiQueryParamsConfig } from "./core/decorators.mjs";
16
+ import { CRON_META, Cron, getCronJobs } from "./core/cron.mjs";
17
+ import { CacheEvict, Cacheable, MemoryCacheProvider, getCacheProvider, setCacheProvider } from "./core/cache.mjs";
18
+ import { HttpException, HttpStatus } from "./core/errors.mjs";
19
+ import { joinPaths, normalizePath } from "./core/path.mjs";
20
+ import { n as CircuitOpenError, t as CircuitBreaker } from "./core-BL_H8fEZ.mjs";
21
+ import { computed, isRef, reactive, ref, toRefs, unref, watch } from "./core/reactivity.mjs";
22
+ import { REQUEST_ID_HEADER, requestId } from "./http/middleware/request-id.mjs";
23
+ import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
24
+ import { i as requestStore, n as requestScopeMiddleware, r as getRequestStore, t as Application } from "./application-DNHj-_UL.mjs";
25
+ import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-DLEZaJ3b.mjs";
26
+ import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "./query-7cdHF6ry.mjs";
27
+ import { RequestContext } from "./http/context.mjs";
28
+ import { validate } from "./http/middleware/validate.mjs";
29
+ import { buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload } from "./http/middleware/upload.mjs";
30
+ import { buildRoutes, getControllerPath } from "./http/router-builder.mjs";
31
+ import { csrf } from "./http/middleware/csrf.mjs";
32
+ import { requestLogger } from "./http/middleware/request-logger.mjs";
33
+ import { helmet } from "./http/middleware/helmet.mjs";
34
+ import { cors } from "./http/middleware/cors.mjs";
35
+ import { rateLimit } from "./http/middleware/rate-limit.mjs";
36
+ import { session } from "./http/middleware/session.mjs";
37
+ import { ViewAdapter } from "./http/middleware/views.mjs";
38
+ import { SpaAdapter } from "./http/middleware/spa.mjs";
39
+ import crypto from "node:crypto";
40
+ //#region src/http/middleware/trace-context.ts
41
+ /**
42
+ * W3C Trace Context header name.
43
+ * @see https://www.w3.org/TR/trace-context/#traceparent-header
44
+ */
45
+ const TRACEPARENT_HEADER = "traceparent";
46
+ /** Regex for a valid W3C traceparent: {version}-{trace-id}-{parent-id}-{flags} */
47
+ const TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
48
+ /**
49
+ * Generate a random 32-hex-character trace ID.
50
+ */
51
+ function generateTraceId() {
52
+ return crypto.randomBytes(16).toString("hex");
53
+ }
54
+ /**
55
+ * Generate a random 16-hex-character span ID.
56
+ */
57
+ function generateSpanId() {
58
+ return crypto.randomBytes(8).toString("hex");
59
+ }
60
+ /**
61
+ * Parse a W3C traceparent header value.
62
+ * Returns null if the format is invalid.
63
+ */
64
+ function parseTraceparent(header) {
65
+ const match = TRACEPARENT_RE.exec(header.trim().toLowerCase());
66
+ if (!match) return null;
67
+ const version = match[1];
68
+ const traceId = match[2];
69
+ const parentSpanId = match[3];
70
+ const flags = match[4];
71
+ if (version === "ff" || traceId === "00000000000000000000000000000000" || parentSpanId === "0000000000000000") return null;
72
+ return {
73
+ version,
74
+ traceId,
75
+ parentSpanId,
76
+ flags
77
+ };
78
+ }
79
+ /**
80
+ * Middleware that extracts W3C `traceparent` header and stores trace context
81
+ * in the request's AsyncLocalStorage store.
82
+ *
83
+ * If no valid `traceparent` header is present, a new traceId is generated
84
+ * so that every request always has a trace ID available for correlation.
85
+ *
86
+ * Must be mounted **after** `requestScopeMiddleware()` (which creates the store).
87
+ *
88
+ * @example
89
+ * ```ts
90
+ * bootstrap({
91
+ * middleware: [
92
+ * requestScopeMiddleware(),
93
+ * traceContext(), // extracts or generates traceId
94
+ * requestLogger(),
95
+ * express.json(),
96
+ * ],
97
+ * })
98
+ * ```
99
+ */
100
+ function traceContext(options = {}) {
101
+ return (req, res, next) => {
102
+ const store = requestStore.getStore();
103
+ const traceparentHeader = req.headers[TRACEPARENT_HEADER];
104
+ const raw = Array.isArray(traceparentHeader) ? traceparentHeader[0] : traceparentHeader;
105
+ const parsed = raw ? parseTraceparent(raw) : null;
106
+ const traceId = parsed?.traceId ?? generateTraceId();
107
+ const spanId = generateSpanId();
108
+ if (store) {
109
+ store.values.set("traceId", traceId);
110
+ store.values.set("spanId", spanId);
111
+ if (parsed) {
112
+ store.values.set("parentSpanId", parsed.parentSpanId);
113
+ store.values.set("traceFlags", parsed.flags);
114
+ store.values.set("traceVersion", parsed.version);
115
+ }
116
+ }
117
+ req.traceId = traceId;
118
+ req.spanId = spanId;
119
+ if (options.propagateResponse) res.setHeader("traceresponse", traceId);
120
+ next();
121
+ };
122
+ }
123
+ //#endregion
124
+ export { ApiQueryParams, Application, Autowired, Builder, CRON_META, CacheEvict, Cacheable, CircuitBreaker, CircuitOpenError, Component, ConsoleLoggerProvider, Container, Controller, Cron, Delete, FILTER_OPERATORS, FileUpload, Get, HttpException, HttpStatus, Inject, Injectable, Logger, METADATA, MemoryCacheProvider, Middleware, Patch, Post, PostConstruct, Put, REQUEST_ID_HEADER, Repository, RequestContext, Scope, Service, SpaAdapter, TRACEPARENT_HEADER, Value, ViewAdapter, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
125
+
126
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/http/middleware/trace-context.ts"],"sourcesContent":["import crypto from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\nimport { requestStore } from '../request-store'\n\n/**\n * W3C Trace Context header name.\n * @see https://www.w3.org/TR/trace-context/#traceparent-header\n */\nexport const TRACEPARENT_HEADER = 'traceparent'\n\n/** Regex for a valid W3C traceparent: {version}-{trace-id}-{parent-id}-{flags} */\nconst TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/\n\nexport interface TraceContextOptions {\n /**\n * When true, respond with a `traceresponse` header containing the trace ID.\n * Useful for debugging. Default: false.\n */\n propagateResponse?: boolean\n}\n\n/**\n * Parsed W3C trace context fields.\n */\nexport interface TraceContext {\n /** W3C traceparent version (usually '00') */\n version: string\n /** 32-hex-char distributed trace ID */\n traceId: string\n /** 16-hex-char parent span ID */\n parentSpanId: string\n /** 2-hex-char trace flags */\n flags: string\n}\n\n/**\n * Generate a random 32-hex-character trace ID.\n */\nfunction generateTraceId(): string {\n return crypto.randomBytes(16).toString('hex')\n}\n\n/**\n * Generate a random 16-hex-character span ID.\n */\nfunction generateSpanId(): string {\n return crypto.randomBytes(8).toString('hex')\n}\n\n/**\n * Parse a W3C traceparent header value.\n * Returns null if the format is invalid.\n */\nexport function parseTraceparent(header: string): TraceContext | null {\n const match = TRACEPARENT_RE.exec(header.trim().toLowerCase())\n if (!match) return null\n\n const version = match[1]\n const traceId = match[2]\n const parentSpanId = match[3]\n const flags = match[4]\n\n // W3C spec: version ff is invalid, all-zero trace-id and parent-id are invalid\n if (\n version === 'ff' ||\n traceId === '00000000000000000000000000000000' ||\n parentSpanId === '0000000000000000'\n ) {\n return null\n }\n\n return { version, traceId, parentSpanId, flags }\n}\n\n/**\n * Middleware that extracts W3C `traceparent` header and stores trace context\n * in the request's AsyncLocalStorage store.\n *\n * If no valid `traceparent` header is present, a new traceId is generated\n * so that every request always has a trace ID available for correlation.\n *\n * Must be mounted **after** `requestScopeMiddleware()` (which creates the store).\n *\n * @example\n * ```ts\n * bootstrap({\n * middleware: [\n * requestScopeMiddleware(),\n * traceContext(), // extracts or generates traceId\n * requestLogger(),\n * express.json(),\n * ],\n * })\n * ```\n */\nexport function traceContext(options: TraceContextOptions = {}) {\n return (req: Request, res: Response, next: NextFunction) => {\n const store = requestStore.getStore()\n\n const traceparentHeader = req.headers[TRACEPARENT_HEADER]\n const raw = Array.isArray(traceparentHeader) ? traceparentHeader[0] : traceparentHeader\n const parsed = raw ? parseTraceparent(raw) : null\n\n const traceId = parsed?.traceId ?? generateTraceId()\n const spanId = generateSpanId()\n\n // Attach to the request store so logger + downstream code can access it\n if (store) {\n store.values.set('traceId', traceId)\n store.values.set('spanId', spanId)\n if (parsed) {\n store.values.set('parentSpanId', parsed.parentSpanId)\n store.values.set('traceFlags', parsed.flags)\n store.values.set('traceVersion', parsed.version)\n }\n }\n\n // Also expose on req for convenience\n ;(req as any).traceId = traceId\n ;(req as any).spanId = spanId\n\n if (options.propagateResponse) {\n res.setHeader('traceresponse', traceId)\n }\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,MAAa,qBAAqB;;AAGlC,MAAM,iBAAiB;;;;AA2BvB,SAAS,kBAA0B;AACjC,QAAO,OAAO,YAAY,GAAG,CAAC,SAAS,MAAM;;;;;AAM/C,SAAS,iBAAyB;AAChC,QAAO,OAAO,YAAY,EAAE,CAAC,SAAS,MAAM;;;;;;AAO9C,SAAgB,iBAAiB,QAAqC;CACpE,MAAM,QAAQ,eAAe,KAAK,OAAO,MAAM,CAAC,aAAa,CAAC;AAC9D,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,UAAU,MAAM;CACtB,MAAM,UAAU,MAAM;CACtB,MAAM,eAAe,MAAM;CAC3B,MAAM,QAAQ,MAAM;AAGpB,KACE,YAAY,QACZ,YAAY,sCACZ,iBAAiB,mBAEjB,QAAO;AAGT,QAAO;EAAE;EAAS;EAAS;EAAc;EAAO;;;;;;;;;;;;;;;;;;;;;;;AAwBlD,SAAgB,aAAa,UAA+B,EAAE,EAAE;AAC9D,SAAQ,KAAc,KAAe,SAAuB;EAC1D,MAAM,QAAQ,aAAa,UAAU;EAErC,MAAM,oBAAoB,IAAI,QAAQ;EACtC,MAAM,MAAM,MAAM,QAAQ,kBAAkB,GAAG,kBAAkB,KAAK;EACtE,MAAM,SAAS,MAAM,iBAAiB,IAAI,GAAG;EAE7C,MAAM,UAAU,QAAQ,WAAW,iBAAiB;EACpD,MAAM,SAAS,gBAAgB;AAG/B,MAAI,OAAO;AACT,SAAM,OAAO,IAAI,WAAW,QAAQ;AACpC,SAAM,OAAO,IAAI,UAAU,OAAO;AAClC,OAAI,QAAQ;AACV,UAAM,OAAO,IAAI,gBAAgB,OAAO,aAAa;AACrD,UAAM,OAAO,IAAI,cAAc,OAAO,MAAM;AAC5C,UAAM,OAAO,IAAI,gBAAgB,OAAO,QAAQ;;;AAKlD,MAAY,UAAU;AACtB,MAAY,SAAS;AAEvB,MAAI,QAAQ,kBACV,KAAI,UAAU,iBAAiB,QAAQ;AAGzC,QAAM"}
@@ -0,0 +1,52 @@
1
+
2
+ //#region src/core/interfaces.d.ts
3
+ /** Lifecycle scope for DI registrations */
4
+ declare enum Scope {
5
+ SINGLETON = "singleton",
6
+ TRANSIENT = "transient",
7
+ /** One instance per HTTP request, cached in AsyncLocalStorage. Throws outside request context. */
8
+ REQUEST = "request"
9
+ }
10
+ /** Generic constructor type */
11
+ type Constructor<T = any> = new (...args: any[]) => T;
12
+ /** A value that may or may not be wrapped in a Promise */
13
+ type MaybePromise<T = void> = T | Promise<T>;
14
+ /** Options for @Service, @Repository, @Component decorators */
15
+ interface ServiceOptions {
16
+ scope?: Scope;
17
+ }
18
+ /** Fluent builder type */
19
+ type BuilderOf<T> = { [K in keyof T as T[K] extends Function ? never : K]-?: (value: T[K]) => BuilderOf<T> } & {
20
+ build(): T;
21
+ };
22
+ /** Class with static builder() method */
23
+ interface Buildable<T> {
24
+ builder(): BuilderOf<T>;
25
+ }
26
+ /** Decorator class kind for devtools introspection */
27
+ type ClassKind = 'service' | 'controller' | 'repository' | 'component' | 'injectable' | 'factory' | 'instance' | 'unknown';
28
+ /** PostConstruct lifecycle status */
29
+ type PostConstructStatus = 'pending' | 'completed' | 'failed' | 'skipped';
30
+ /** Symbol-based metadata keys for the DI system */
31
+ declare const METADATA: {
32
+ readonly INJECTABLE: symbol;
33
+ readonly SCOPE: symbol;
34
+ readonly CLASS_KIND: symbol;
35
+ readonly AUTOWIRED: symbol;
36
+ readonly INJECT: symbol;
37
+ readonly POST_CONSTRUCT: symbol;
38
+ readonly BUILDER: symbol;
39
+ readonly QUERY_PARAMS: symbol;
40
+ readonly CONTROLLER_PATH: symbol;
41
+ readonly ROUTES: symbol;
42
+ readonly CLASS_MIDDLEWARES: symbol;
43
+ readonly METHOD_MIDDLEWARES: symbol;
44
+ readonly FILE_UPLOAD: symbol;
45
+ readonly VALUE: symbol;
46
+ readonly PARAM_TYPES: "design:paramtypes";
47
+ readonly PROPERTY_TYPE: "design:type";
48
+ readonly RETURN_TYPE: "design:returntype";
49
+ };
50
+ //#endregion
51
+ export { METADATA as a, Scope as c, Constructor as i, ServiceOptions as l, BuilderOf as n, MaybePromise as o, ClassKind as r, PostConstructStatus as s, Buildable as t };
52
+ //# sourceMappingURL=interfaces-D-48zotH.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interfaces-D-48zotH.d.mts","names":[],"sources":["../src/core/interfaces.ts"],"mappings":";;;aAGY,KAAA;EACV,SAAA;EACA,SAAA;;EAEA,OAAA;AAAA;;KAIU,WAAA,oBAA+B,IAAA,YAAgB,CAAA;;KAG/C,YAAA,aAAyB,CAAA,GAAI,OAAA,CAAQ,CAAA;AAHjD;AAAA,UAMiB,cAAA;EACf,KAAA,GAAQ,KAAA;AAAA;;KAIE,SAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,QAAA,WAAmB,CAAA,MAAO,KAAA,EAAO,CAAA,CAAE,CAAA,MAAO,SAAA,CAAU,CAAA;EAC9E,KAAA,IAAS,CAAA;AAAA;;UAGE,SAAA;EACf,OAAA,IAAW,SAAA,CAAU,CAAA;AAAA;;KAIX,SAAA;;KAWA,mBAAA;;cAGC,QAAA;EAAA"}
@@ -0,0 +1,119 @@
1
+
2
+ import pino from "pino";
3
+
4
+ //#region src/core/logger.d.ts
5
+ /** Root pino logger instance */
6
+ declare const rootLogger: pino.Logger<never, boolean>;
7
+ /**
8
+ * Pluggable logger backend.
9
+ *
10
+ * Implement this interface to replace the default pino-based logging
11
+ * with any logging library (winston, bunyan, console, etc.).
12
+ */
13
+ interface LoggerProvider {
14
+ info(msg: string, ...args: any[]): void;
15
+ warn(msg: string, ...args: any[]): void;
16
+ error(msg: string, ...args: any[]): void;
17
+ debug(msg: string, ...args: any[]): void;
18
+ trace?(msg: string, ...args: any[]): void;
19
+ fatal?(msg: string, ...args: any[]): void;
20
+ /** Return a child provider scoped to the given component name */
21
+ child(bindings: {
22
+ component: string;
23
+ }): LoggerProvider;
24
+ }
25
+ /**
26
+ * Built-in fallback provider that uses `console.*` methods.
27
+ * Useful for environments where pino is unavailable or undesired.
28
+ */
29
+ declare class ConsoleLoggerProvider implements LoggerProvider {
30
+ private prefix;
31
+ constructor(prefix?: string);
32
+ private fmt;
33
+ info(msg: string, ...args: any[]): void;
34
+ warn(msg: string, ...args: any[]): void;
35
+ error(msg: string, ...args: any[]): void;
36
+ debug(msg: string, ...args: any[]): void;
37
+ trace(msg: string, ...args: any[]): void;
38
+ fatal(msg: string, ...args: any[]): void;
39
+ child(bindings: {
40
+ component: string;
41
+ }): LoggerProvider;
42
+ }
43
+ /**
44
+ * Named logger with component context.
45
+ *
46
+ * @example
47
+ * ```ts
48
+ * // Static factory — preferred
49
+ * const log = Logger.for('UserService')
50
+ * log.info('User created')
51
+ * // Output: [UserService] User created
52
+ *
53
+ * // Shorthand function
54
+ * const log = createLogger('OrderService')
55
+ *
56
+ * // Pluggable backend
57
+ * Logger.setProvider(new ConsoleLoggerProvider())
58
+ *
59
+ * // Injectable — auto-named from class
60
+ * class MyService {
61
+ * @Autowired() private logger!: Logger
62
+ * // or inject a named one:
63
+ * private log = Logger.for('MyService')
64
+ * }
65
+ * ```
66
+ */
67
+ declare class Logger {
68
+ private _provider;
69
+ private _providerVersion;
70
+ private _name?;
71
+ /**
72
+ * Optional context provider for request-scoped log enrichment.
73
+ * Set by the HTTP package to inject requestId from AsyncLocalStorage.
74
+ * Returns extra fields to merge into every log call, or null if outside a request.
75
+ */
76
+ static _contextProvider: (() => Record<string, any> | null) | null;
77
+ /** Incremented on every setProvider/resetProvider so instances know to refresh */
78
+ private static _providerVersion;
79
+ constructor(name?: string);
80
+ /** Re-derive the provider if setProvider() was called since construction/last access */
81
+ private get provider();
82
+ /**
83
+ * Replace the logging backend for **all** Logger instances created after
84
+ * this call. Clears the logger cache so subsequent `Logger.for()` calls
85
+ * pick up the new provider.
86
+ *
87
+ * @example
88
+ * ```ts
89
+ * Logger.setProvider(new ConsoleLoggerProvider())
90
+ * ```
91
+ */
92
+ static setProvider(provider: LoggerProvider): void;
93
+ /** Return the currently active provider (useful for testing) */
94
+ static getProvider(): LoggerProvider;
95
+ /**
96
+ * Reset the provider back to the default pino-based implementation.
97
+ * Primarily intended for test teardown.
98
+ */
99
+ static resetProvider(): void;
100
+ /** Create or retrieve a cached named logger */
101
+ static for(name: string): Logger;
102
+ /** Create a child logger with a sub-component name */
103
+ child(name: string): Logger;
104
+ /** Get request context (requestId, etc.) if inside a request */
105
+ private ctx;
106
+ info(msg: string, ...args: any[]): void;
107
+ warn(msg: string, ...args: any[]): void;
108
+ error(msgOrObj: any, msg?: string, ...args: any[]): void;
109
+ debug(msg: string, ...args: any[]): void;
110
+ trace(msg: string, ...args: any[]): void;
111
+ fatal(msg: string, ...args: any[]): void;
112
+ }
113
+ /** Shorthand for Logger.for(name) */
114
+ declare function createLogger(name: string): Logger;
115
+ /** @deprecated Use rootLogger instead */
116
+ declare const logger: pino.Logger<never, boolean>;
117
+ //#endregion
118
+ export { logger as a, createLogger as i, Logger as n, rootLogger as o, LoggerProvider as r, ConsoleLoggerProvider as t };
119
+ //# sourceMappingURL=logger-Dzj-TF0t.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger-Dzj-TF0t.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;cAKa,UAAA,EAAU,IAAA,CAAA,MAAA;AAAvB;;;;;AA0BA;AA1BA,UA0BiB,cAAA;EACf,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,EAAO,GAAA,aAAgB,IAAA;EACvB,KAAA,EAAO,GAAA,aAAgB,IAAA;EAJlB;EAML,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;cA0C7B,qBAAA,YAAiC,cAAA;EAAA,QACpC,MAAA;cAEI,MAAA;EAAA,QAIJ,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAoC7B,MAAA;EAAA,QACH,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,KAAA;EAvC8C;;AAoCxD;;;EApCwD,OA8C/C,gBAAA,SAAyB,MAAA;EA8BH;EAAA,eA3Bd,gBAAA;cAEH,IAAA;EAyDS;EAAA,YAlDT,QAAA,CAAA;EAkDe;;;;;;;;;;EAAA,OAhCpB,WAAA,CAAY,QAAA,EAAU,cAAA;EAAA;EAAA,OAOtB,WAAA,CAAA,GAAe,cAAA;EAAf;;;;EAAA,OAQA,aAAA,CAAA;EAOmB;EAAA,OAAnB,GAAA,CAAI,IAAA,WAAe,MAAA;EAUpB;EAAN,KAAA,CAAM,IAAA,WAAe,MAAA;EAKb;EAAA,QAAA,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,KAAA,CAAM,QAAA,OAAe,GAAA,cAAiB,IAAA;EAUtC,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;AAAA;;iBAMR,YAAA,CAAa,IAAA,WAAe,MAAA;;cAK/B,MAAA,EAAM,IAAA,CAAA,MAAA"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * @forinda/kickjs v2.1.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ import "reflect-metadata";
12
+ //#region src/core/metadata.ts
13
+ /** Set metadata on a class (or prototype for property decorators) */
14
+ function setClassMeta(key, value, target) {
15
+ Reflect.defineMetadata(key, value, target);
16
+ }
17
+ /** Set metadata on a specific method */
18
+ function setMethodMeta(key, value, target, method) {
19
+ Reflect.defineMetadata(key, value, target, method);
20
+ }
21
+ /** Get metadata from a class, returning `fallback` if not set */
22
+ function getClassMeta(key, target, fallback) {
23
+ return Reflect.getMetadata(key, target) ?? fallback;
24
+ }
25
+ /** Get metadata from a specific method, returning `fallback` if not set */
26
+ function getMethodMeta(key, target, method, fallback) {
27
+ return Reflect.getMetadata(key, target, method) ?? fallback;
28
+ }
29
+ /** Check if metadata exists on a class */
30
+ function hasClassMeta(key, target) {
31
+ return Reflect.hasMetadata(key, target);
32
+ }
33
+ /** Get metadata from a class with no default (returns undefined if absent) */
34
+ function getClassMetaOrUndefined(key, target) {
35
+ return Reflect.getMetadata(key, target);
36
+ }
37
+ /** Get metadata from a method with no default (returns undefined if absent) */
38
+ function getMethodMetaOrUndefined(key, target, method) {
39
+ return Reflect.getMetadata(key, target, method);
40
+ }
41
+ /** Append items to an array stored in class metadata */
42
+ function pushClassMeta(key, target, ...items) {
43
+ const existing = Reflect.getOwnMetadata(key, target) ?? [];
44
+ Reflect.defineMetadata(key, [...existing, ...items], target);
45
+ }
46
+ /** Append items to an array stored in method metadata */
47
+ function pushMethodMeta(key, target, method, ...items) {
48
+ const existing = Reflect.getOwnMetadata(key, target, method) ?? [];
49
+ Reflect.defineMetadata(key, [...existing, ...items], target, method);
50
+ }
51
+ /** Set a key/value in a Map stored in class metadata */
52
+ function setInMetaMap(key, target, mapKey, mapValue) {
53
+ const inherited = Reflect.getOwnMetadata(key, target);
54
+ const map = inherited ? new Map(inherited) : /* @__PURE__ */ new Map();
55
+ map.set(mapKey, mapValue);
56
+ Reflect.defineMetadata(key, map, target);
57
+ }
58
+ /** Get a Map from class metadata (returns empty Map if absent) */
59
+ function getMetaMap(key, target) {
60
+ return Reflect.getMetadata(key, target) ?? /* @__PURE__ */ new Map();
61
+ }
62
+ /** Set a key/value in a Record stored in class metadata */
63
+ function setInMetaRecord(key, target, recKey, recValue) {
64
+ const inherited = Reflect.getOwnMetadata(key, target);
65
+ const rec = inherited ? { ...inherited } : {};
66
+ rec[recKey] = recValue;
67
+ Reflect.defineMetadata(key, rec, target);
68
+ }
69
+ /** Get a Record from class metadata (returns empty object if absent) */
70
+ function getMetaRecord(key, target) {
71
+ return Reflect.getMetadata(key, target) ?? {};
72
+ }
73
+ //#endregion
74
+ export { getMethodMeta as a, pushClassMeta as c, setInMetaMap as d, setInMetaRecord as f, getMetaRecord as i, pushMethodMeta as l, getClassMetaOrUndefined as n, getMethodMetaOrUndefined as o, setMethodMeta as p, getMetaMap as r, hasClassMeta as s, getClassMeta as t, setClassMeta as u };
75
+
76
+ //# sourceMappingURL=metadata-fmvikBA0.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata-fmvikBA0.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n */\n\ntype MetaKey = symbol | string\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
@@ -1,3 +1,5 @@
1
+
2
+ //#region src/core/path.d.ts
1
3
  /**
2
4
  * Normalize a URL path segment:
3
5
  * - '/' or '' or undefined → ''
@@ -5,7 +7,7 @@
5
7
  * - Strips trailing '/'
6
8
  * - Collapses consecutive '//' into single '/'
7
9
  */
8
- export declare function normalizePath(path?: string): string;
10
+ declare function normalizePath(path?: string): string;
9
11
  /**
10
12
  * Join path segments into a single normalized path.
11
13
  * Handles leading/trailing slashes and prevents double slashes.
@@ -17,5 +19,7 @@ export declare function normalizePath(path?: string): string;
17
19
  * joinPaths('/api/v1', '') // '/api/v1'
18
20
  * joinPaths('/api/v1', 'users') // '/api/v1/users'
19
21
  */
20
- export declare function joinPaths(...segments: (string | undefined)[]): string;
21
- //# sourceMappingURL=path.d.ts.map
22
+ declare function joinPaths(...segments: (string | undefined)[]): string;
23
+ //#endregion
24
+ export { normalizePath as n, joinPaths as t };
25
+ //# sourceMappingURL=path-LmwfhfyH.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path-LmwfhfyH.d.mts","names":[],"sources":["../src/core/path.ts"],"mappings":";;;AAOA;;;;;AAsBA;iBAtBgB,aAAA,CAAc,IAAA;;;;;;;;;;;;iBAsBd,SAAA,CAAA,GAAa,QAAA"}