@forinda/kickjs 2.0.1 → 2.2.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 (238) hide show
  1. package/README.md +63 -20
  2. package/dist/adapter-wuoBNkNs.d.mts +122 -0
  3. package/dist/adapter-wuoBNkNs.d.mts.map +1 -0
  4. package/dist/app-module-DOBmxARW.d.mts +40 -0
  5. package/dist/app-module-DOBmxARW.d.mts.map +1 -0
  6. package/dist/application-C5Q720a2.mjs +449 -0
  7. package/dist/application-C5Q720a2.mjs.map +1 -0
  8. package/dist/bootstrap-dEN6SjBl.mjs +205 -0
  9. package/dist/bootstrap-dEN6SjBl.mjs.map +1 -0
  10. package/dist/{core/cache.d.ts → cache-PufEhr0n.d.mts} +33 -31
  11. package/dist/cache-PufEhr0n.d.mts.map +1 -0
  12. package/dist/chunk-C9tIbwLT.mjs +15 -0
  13. package/dist/container-B7jFEbPE.mjs +496 -0
  14. package/dist/container-B7jFEbPE.mjs.map +1 -0
  15. package/dist/container-CcgV8eHL.d.mts +253 -0
  16. package/dist/container-CcgV8eHL.d.mts.map +1 -0
  17. package/dist/core/adapter.d.mts +3 -0
  18. package/dist/core/adapter.mjs +11 -0
  19. package/dist/core/app-module.d.mts +3 -0
  20. package/dist/core/app-module.mjs +11 -0
  21. package/dist/core/cache.d.mts +3 -0
  22. package/dist/core/cache.mjs +113 -0
  23. package/dist/core/cache.mjs.map +1 -0
  24. package/dist/core/container.d.mts +3 -0
  25. package/dist/core/container.mjs +12 -0
  26. package/dist/core/cron.d.mts +3 -0
  27. package/dist/core/cron.mjs +42 -0
  28. package/dist/core/cron.mjs.map +1 -0
  29. package/dist/core/decorators.d.mts +3 -0
  30. package/dist/core/decorators.mjs +219 -0
  31. package/dist/core/decorators.mjs.map +1 -0
  32. package/dist/core/errors.d.mts +3 -0
  33. package/dist/core/errors.mjs +97 -0
  34. package/dist/core/errors.mjs.map +1 -0
  35. package/dist/core/interfaces.d.mts +3 -0
  36. package/dist/core/interfaces.mjs +44 -0
  37. package/dist/core/interfaces.mjs.map +1 -0
  38. package/dist/core/logger.d.mts +3 -0
  39. package/dist/core/logger.mjs +217 -0
  40. package/dist/core/logger.mjs.map +1 -0
  41. package/dist/core/path.d.mts +3 -0
  42. package/dist/core/path.mjs +45 -0
  43. package/dist/core/path.mjs.map +1 -0
  44. package/dist/core/plugin.d.mts +3 -0
  45. package/dist/core/plugin.mjs +11 -0
  46. package/dist/core/reactivity.d.mts +3 -0
  47. package/dist/core/reactivity.mjs +189 -0
  48. package/dist/core/reactivity.mjs.map +1 -0
  49. package/dist/core-CMgIoRvg.mjs +121 -0
  50. package/dist/core-CMgIoRvg.mjs.map +1 -0
  51. package/dist/{core/cron.d.ts → cron-C29iHvHT.d.mts} +16 -14
  52. package/dist/cron-C29iHvHT.d.mts.map +1 -0
  53. package/dist/decorators-D3lBlmud.d.mts +204 -0
  54. package/dist/decorators-D3lBlmud.d.mts.map +1 -0
  55. package/dist/errors-BZUdxtjC.d.mts +68 -0
  56. package/dist/errors-BZUdxtjC.d.mts.map +1 -0
  57. package/dist/http/application.d.mts +220 -0
  58. package/dist/http/application.d.mts.map +1 -0
  59. package/dist/http/application.mjs +12 -0
  60. package/dist/http/bootstrap.d.mts +43 -0
  61. package/dist/http/bootstrap.d.mts.map +1 -0
  62. package/dist/http/bootstrap.mjs +12 -0
  63. package/dist/http/context.d.mts +190 -0
  64. package/dist/http/context.d.mts.map +1 -0
  65. package/dist/http/context.mjs +225 -0
  66. package/dist/http/context.mjs.map +1 -0
  67. package/dist/http/middleware/cors.d.mts +48 -0
  68. package/dist/http/middleware/cors.d.mts.map +1 -0
  69. package/dist/http/middleware/cors.mjs +83 -0
  70. package/dist/http/middleware/cors.mjs.map +1 -0
  71. package/dist/http/middleware/csrf.d.mts +52 -0
  72. package/dist/http/middleware/csrf.d.mts.map +1 -0
  73. package/dist/http/middleware/csrf.mjs +72 -0
  74. package/dist/http/middleware/csrf.mjs.map +1 -0
  75. package/dist/http/middleware/error-handler.d.mts +11 -0
  76. package/dist/http/middleware/error-handler.d.mts.map +1 -0
  77. package/dist/http/middleware/error-handler.mjs +52 -0
  78. package/dist/http/middleware/error-handler.mjs.map +1 -0
  79. package/dist/http/middleware/helmet.d.mts +41 -0
  80. package/dist/http/middleware/helmet.d.mts.map +1 -0
  81. package/dist/http/middleware/helmet.mjs +51 -0
  82. package/dist/http/middleware/helmet.mjs.map +1 -0
  83. package/dist/http/middleware/rate-limit.d.mts +56 -0
  84. package/dist/http/middleware/rate-limit.d.mts.map +1 -0
  85. package/dist/http/middleware/rate-limit.mjs +101 -0
  86. package/dist/http/middleware/rate-limit.mjs.map +1 -0
  87. package/dist/http/middleware/request-id.d.mts +10 -0
  88. package/dist/http/middleware/request-id.d.mts.map +1 -0
  89. package/dist/http/middleware/request-id.mjs +26 -0
  90. package/dist/http/middleware/request-id.mjs.map +1 -0
  91. package/dist/http/middleware/request-logger.d.mts +32 -0
  92. package/dist/http/middleware/request-logger.d.mts.map +1 -0
  93. package/dist/http/middleware/request-logger.mjs +49 -0
  94. package/dist/http/middleware/request-logger.mjs.map +1 -0
  95. package/dist/http/middleware/session.d.mts +67 -0
  96. package/dist/http/middleware/session.d.mts.map +1 -0
  97. package/dist/http/middleware/session.mjs +152 -0
  98. package/dist/http/middleware/session.mjs.map +1 -0
  99. package/dist/http/middleware/spa.d.mts +101 -0
  100. package/dist/http/middleware/spa.d.mts.map +1 -0
  101. package/dist/http/middleware/spa.mjs +108 -0
  102. package/dist/http/middleware/spa.mjs.map +1 -0
  103. package/dist/http/middleware/{upload.d.ts → upload.d.mts} +21 -17
  104. package/dist/http/middleware/upload.d.mts.map +1 -0
  105. package/dist/http/middleware/upload.mjs +191 -0
  106. package/dist/http/middleware/upload.mjs.map +1 -0
  107. package/dist/http/middleware/validate.d.mts +18 -0
  108. package/dist/http/middleware/validate.d.mts.map +1 -0
  109. package/dist/http/middleware/validate.mjs +62 -0
  110. package/dist/http/middleware/validate.mjs.map +1 -0
  111. package/dist/http/middleware/views.d.mts +62 -0
  112. package/dist/http/middleware/views.d.mts.map +1 -0
  113. package/dist/http/middleware/views.mjs +65 -0
  114. package/dist/http/middleware/views.mjs.map +1 -0
  115. package/dist/http/query/index.d.mts +3 -0
  116. package/dist/http/query/index.mjs +12 -0
  117. package/dist/http/{router-builder.d.ts → router-builder.d.mts} +9 -5
  118. package/dist/http/router-builder.d.mts.map +1 -0
  119. package/dist/http/router-builder.mjs +67 -0
  120. package/dist/http/router-builder.mjs.map +1 -0
  121. package/dist/index-4VM4dUJf.d.mts +107 -0
  122. package/dist/index-4VM4dUJf.d.mts.map +1 -0
  123. package/dist/index-rnK23QBD.d.mts +184 -0
  124. package/dist/index-rnK23QBD.d.mts.map +1 -0
  125. package/dist/index.d.mts +133 -0
  126. package/dist/index.d.mts.map +1 -0
  127. package/dist/index.mjs +126 -0
  128. package/dist/index.mjs.map +1 -0
  129. package/dist/interfaces-D5ohYl6D.d.mts +52 -0
  130. package/dist/interfaces-D5ohYl6D.d.mts.map +1 -0
  131. package/dist/logger-BLdfUF5b.d.mts +119 -0
  132. package/dist/logger-BLdfUF5b.d.mts.map +1 -0
  133. package/dist/metadata-BqXgNTOf.mjs +76 -0
  134. package/dist/metadata-BqXgNTOf.mjs.map +1 -0
  135. package/dist/{core/path.d.ts → path-Dq5V-i-x.d.mts} +7 -3
  136. package/dist/path-Dq5V-i-x.d.mts.map +1 -0
  137. package/dist/plugin-D20muJwC.d.mts +95 -0
  138. package/dist/plugin-D20muJwC.d.mts.map +1 -0
  139. package/dist/query-vljPDFaZ.mjs +164 -0
  140. package/dist/query-vljPDFaZ.mjs.map +1 -0
  141. package/dist/{core/reactivity.d.ts → reactivity-CMAQh0gi.d.mts} +21 -20
  142. package/dist/reactivity-CMAQh0gi.d.mts.map +1 -0
  143. package/package.json +73 -43
  144. package/dist/chunk-DVVP7zzD.js +0 -7
  145. package/dist/core/adapter.d.ts +0 -109
  146. package/dist/core/adapter.d.ts.map +0 -1
  147. package/dist/core/adapter.js +0 -0
  148. package/dist/core/app-module.d.ts +0 -28
  149. package/dist/core/app-module.d.ts.map +0 -1
  150. package/dist/core/app-module.js +0 -0
  151. package/dist/core/cache.d.ts.map +0 -1
  152. package/dist/core/cache.js +0 -57
  153. package/dist/core/container.d.ts +0 -63
  154. package/dist/core/container.d.ts.map +0 -1
  155. package/dist/core/container.js +0 -117
  156. package/dist/core/cron.d.ts.map +0 -1
  157. package/dist/core/cron.js +0 -22
  158. package/dist/core/decorators.d.ts +0 -153
  159. package/dist/core/decorators.d.ts.map +0 -1
  160. package/dist/core/decorators.js +0 -141
  161. package/dist/core/errors.d.ts +0 -64
  162. package/dist/core/errors.d.ts.map +0 -1
  163. package/dist/core/errors.js +0 -67
  164. package/dist/core/index.d.ts +0 -14
  165. package/dist/core/index.d.ts.map +0 -1
  166. package/dist/core/interfaces.d.ts +0 -44
  167. package/dist/core/interfaces.d.ts.map +0 -1
  168. package/dist/core/interfaces.js +0 -25
  169. package/dist/core/logger.d.ts +0 -43
  170. package/dist/core/logger.d.ts.map +0 -1
  171. package/dist/core/logger.js +0 -54
  172. package/dist/core/path.d.ts.map +0 -1
  173. package/dist/core/path.js +0 -12
  174. package/dist/core/plugin.d.ts +0 -90
  175. package/dist/core/plugin.d.ts.map +0 -1
  176. package/dist/core/plugin.js +0 -0
  177. package/dist/core/reactivity.d.ts.map +0 -1
  178. package/dist/core/reactivity.js +0 -101
  179. package/dist/core-B6Okew3W.js +0 -7
  180. package/dist/http/application.d.ts +0 -103
  181. package/dist/http/application.d.ts.map +0 -1
  182. package/dist/http/application.js +0 -167
  183. package/dist/http/bootstrap.d.ts +0 -22
  184. package/dist/http/bootstrap.d.ts.map +0 -1
  185. package/dist/http/bootstrap.js +0 -40
  186. package/dist/http/context.d.ts +0 -129
  187. package/dist/http/context.d.ts.map +0 -1
  188. package/dist/http/context.js +0 -115
  189. package/dist/http/index.d.ts +0 -16
  190. package/dist/http/index.d.ts.map +0 -1
  191. package/dist/http/middleware/cors.d.ts +0 -43
  192. package/dist/http/middleware/cors.d.ts.map +0 -1
  193. package/dist/http/middleware/cors.js +0 -31
  194. package/dist/http/middleware/csrf.d.ts +0 -47
  195. package/dist/http/middleware/csrf.d.ts.map +0 -1
  196. package/dist/http/middleware/csrf.js +0 -25
  197. package/dist/http/middleware/error-handler.d.ts +0 -6
  198. package/dist/http/middleware/error-handler.d.ts.map +0 -1
  199. package/dist/http/middleware/error-handler.js +0 -37
  200. package/dist/http/middleware/helmet.d.ts +0 -36
  201. package/dist/http/middleware/helmet.d.ts.map +0 -1
  202. package/dist/http/middleware/helmet.js +0 -20
  203. package/dist/http/middleware/rate-limit.d.ts +0 -51
  204. package/dist/http/middleware/rate-limit.d.ts.map +0 -1
  205. package/dist/http/middleware/rate-limit.js +0 -46
  206. package/dist/http/middleware/request-id.d.ts +0 -5
  207. package/dist/http/middleware/request-id.d.ts.map +0 -1
  208. package/dist/http/middleware/request-id.js +0 -12
  209. package/dist/http/middleware/request-logger.d.ts +0 -27
  210. package/dist/http/middleware/request-logger.d.ts.map +0 -1
  211. package/dist/http/middleware/request-logger.js +0 -16
  212. package/dist/http/middleware/session.d.ts +0 -62
  213. package/dist/http/middleware/session.d.ts.map +0 -1
  214. package/dist/http/middleware/session.js +0 -76
  215. package/dist/http/middleware/spa.d.ts +0 -93
  216. package/dist/http/middleware/spa.d.ts.map +0 -1
  217. package/dist/http/middleware/spa.js +0 -52
  218. package/dist/http/middleware/upload.d.ts.map +0 -1
  219. package/dist/http/middleware/upload.js +0 -119
  220. package/dist/http/middleware/validate.d.ts +0 -13
  221. package/dist/http/middleware/validate.d.ts.map +0 -1
  222. package/dist/http/middleware/validate.js +0 -45
  223. package/dist/http/middleware/views.d.ts +0 -56
  224. package/dist/http/middleware/views.d.ts.map +0 -1
  225. package/dist/http/middleware/views.js +0 -18
  226. package/dist/http/query/index.d.ts +0 -4
  227. package/dist/http/query/index.d.ts.map +0 -1
  228. package/dist/http/query/index.js +0 -10
  229. package/dist/http/query/parse-query.d.ts +0 -44
  230. package/dist/http/query/parse-query.d.ts.map +0 -1
  231. package/dist/http/query/types.d.ts +0 -100
  232. package/dist/http/query/types.d.ts.map +0 -1
  233. package/dist/http/router-builder.d.ts.map +0 -1
  234. package/dist/http/router-builder.js +0 -37
  235. package/dist/index.d.ts +0 -25
  236. package/dist/index.d.ts.map +0 -1
  237. package/dist/index.js +0 -103
  238. package/dist/query-Bym31XRp.js +0 -88
@@ -0,0 +1,184 @@
1
+
2
+ //#region src/http/query/types.d.ts
3
+ /** Supported filter operators for query string parsing */
4
+ type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'in' | 'contains' | 'starts' | 'ends';
5
+ declare const FILTER_OPERATORS: Set<string>;
6
+ interface FilterItem {
7
+ field: string;
8
+ operator: FilterOperator;
9
+ value: string;
10
+ }
11
+ interface SortItem {
12
+ field: string;
13
+ direction: 'asc' | 'desc';
14
+ }
15
+ interface PaginationParams {
16
+ page: number;
17
+ limit: number;
18
+ offset: number;
19
+ }
20
+ /**
21
+ * The result of parsing a query string. ORM-agnostic — pass this to
22
+ * a query builder adapter (Drizzle, Prisma, Sequelize, etc.) to produce
23
+ * database-specific query objects.
24
+ */
25
+ interface ParsedQuery {
26
+ filters: FilterItem[];
27
+ sort: SortItem[];
28
+ pagination: PaginationParams;
29
+ search: string;
30
+ }
31
+ /**
32
+ * Helper that extracts the literal field union from a `QueryFieldConfig`
33
+ * key. When the user passes `{ filterable: ['status', 'category'] } as const`,
34
+ * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.
35
+ *
36
+ * Without `as const`, the arrays widen to `string[]` and the union falls
37
+ * back to `string`. This is the documented escape hatch.
38
+ */
39
+ type FieldsOf<TConfig extends QueryFieldConfig | undefined, K extends 'filterable' | 'sortable' | 'searchable'> = TConfig extends { readonly [P in K]: readonly (infer F)[] } ? F extends string ? F : string : TConfig extends {
40
+ columns: infer C;
41
+ } ? K extends 'filterable' ? keyof C & string : string : string;
42
+ /**
43
+ * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`
44
+ * unions are constrained to the literal whitelist passed to
45
+ * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function
46
+ * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically
47
+ * (subtype assignment, no codegen, backward compatible).
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * const parsed = ctx.qs({
52
+ * filterable: ['status', 'priority'],
53
+ * sortable: ['createdAt'],
54
+ * } as const)
55
+ * parsed.filters[0]?.field // 'status' | 'priority'
56
+ * parsed.sort[0]?.field // 'createdAt'
57
+ * ```
58
+ */
59
+ interface TypedParsedQuery<TConfig extends QueryFieldConfig | undefined> extends ParsedQuery {
60
+ filters: Array<FilterItem & {
61
+ field: FieldsOf<TConfig, 'filterable'>;
62
+ }>;
63
+ sort: Array<SortItem & {
64
+ field: FieldsOf<TConfig, 'sortable'>;
65
+ }>;
66
+ }
67
+ /**
68
+ * Restrict which fields can be filtered, sorted, or searched.
69
+ * Fields not in the allow-list are silently ignored.
70
+ *
71
+ * Accepts two forms:
72
+ * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`
73
+ * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`
74
+ *
75
+ * When column-object maps are provided, `Object.keys()` is used to derive the field names.
76
+ */
77
+ type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig;
78
+ interface StringQueryFieldConfig {
79
+ filterable?: string[];
80
+ sortable?: string[];
81
+ searchable?: string[];
82
+ }
83
+ /**
84
+ * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).
85
+ * Keys are the field names used in query strings; values are ORM column references.
86
+ */
87
+ interface ColumnQueryFieldConfig {
88
+ columns: Record<string, any>;
89
+ sortable?: Record<string, any>;
90
+ searchColumns?: any[];
91
+ [key: string]: any;
92
+ }
93
+ /** Standardized paginated response shape */
94
+ interface PaginatedResponse<T = any> {
95
+ data: T[];
96
+ meta: {
97
+ page: number;
98
+ limit: number;
99
+ total: number;
100
+ totalPages: number;
101
+ hasNext: boolean;
102
+ hasPrev: boolean;
103
+ };
104
+ }
105
+ /**
106
+ * Interface for ORM-specific query builder adapters.
107
+ * Implement this to translate a `ParsedQuery` into your ORM's query format.
108
+ *
109
+ * @example
110
+ * ```ts
111
+ * // Drizzle adapter
112
+ * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {
113
+ * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {
114
+ * // Convert filters → Drizzle SQL conditions
115
+ * // Convert sort → Drizzle orderBy
116
+ * return { where, orderBy, limit, offset }
117
+ * }
118
+ * }
119
+ *
120
+ * // Prisma adapter
121
+ * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {
122
+ * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {
123
+ * return { where, orderBy, skip, take }
124
+ * }
125
+ * }
126
+ * ```
127
+ */
128
+ interface QueryBuilderAdapter<TResult = any, TConfig = any> {
129
+ /** Human-readable name for debugging */
130
+ readonly name: string;
131
+ /**
132
+ * Convert a ParsedQuery into an ORM-specific query object.
133
+ * @param parsed - The ORM-agnostic parsed query
134
+ * @param config - ORM-specific configuration (column maps, search columns, etc.)
135
+ */
136
+ build(parsed: ParsedQuery, config: TConfig): TResult;
137
+ }
138
+ //#endregion
139
+ //#region src/http/query/parse-query.d.ts
140
+ /** Parse filter strings like "status:eq:active" into structured objects */
141
+ declare function parseFilters(filterParam: string | string[] | undefined, allowedFields?: string[]): FilterItem[];
142
+ /** Parse sort strings like "firstName:asc" into structured objects */
143
+ declare function parseSort(sortParam: string | string[] | undefined, allowedFields?: string[]): SortItem[];
144
+ /** Parse page/limit into pagination with computed offset */
145
+ declare function parsePagination(params: {
146
+ page?: string | number;
147
+ limit?: string | number;
148
+ }): PaginationParams;
149
+ /** Sanitize and truncate search query */
150
+ declare function parseSearchQuery(q: string | undefined): string;
151
+ /**
152
+ * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.
153
+ *
154
+ * @param query - Raw query string object from `req.query` or Zod-validated object
155
+ * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).
156
+ * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and
157
+ * column-object configs (`{ columns, sortable, searchColumns }`).
158
+ *
159
+ * @example
160
+ * ```ts
161
+ * // String-based config
162
+ * const parsed = parseQuery(ctx.query, {
163
+ * filterable: ['status', 'priority'],
164
+ * sortable: ['createdAt', 'title'],
165
+ * })
166
+ *
167
+ * // Column-object config (DrizzleQueryParamsConfig)
168
+ * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)
169
+ * ```
170
+ *
171
+ * Query string format:
172
+ * - Filters: `?filter=field:operator:value` (repeatable)
173
+ * - Sort: `?sort=field:asc|desc` (repeatable)
174
+ * - Pagination: `?page=1&limit=20`
175
+ * - Search: `?q=search+term`
176
+ *
177
+ * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends
178
+ */
179
+ declare function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(query: Record<string, any>, fieldConfig?: TConfig): TypedParsedQuery<TConfig>;
180
+ /** Convert ParsedQuery back into query string parameters */
181
+ declare function buildQueryParams(parsed: Partial<ParsedQuery>): Record<string, string | string[] | number>;
182
+ //#endregion
183
+ export { SortItem as _, parseSearchQuery as a, FILTER_OPERATORS as c, FilterOperator as d, PaginatedResponse as f, QueryFieldConfig as g, QueryBuilderAdapter as h, parseQuery as i, FieldsOf as l, ParsedQuery as m, parseFilters as n, parseSort as o, PaginationParams as p, parsePagination as r, ColumnQueryFieldConfig as s, buildQueryParams as t, FilterItem as u, StringQueryFieldConfig as v, TypedParsedQuery as y };
184
+ //# sourceMappingURL=index-rnK23QBD.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-rnK23QBD.d.mts","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"mappings":";;;KACY,cAAA;AAAA,cAaC,gBAAA,EAAgB,GAAA;AAAA,UAcZ,UAAA;EACf,KAAA;EACA,QAAA,EAAU,cAAA;EACV,KAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,SAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;AARF;UAgBiB,WAAA;EACf,OAAA,EAAS,UAAA;EACT,IAAA,EAAM,QAAA;EACN,UAAA,EAAY,gBAAA;EACZ,MAAA;AAAA;;;;;;;;AAJF;KAeY,QAAA,iBACM,gBAAA,oEAEd,OAAA,0BAAiC,CAAA,4BACjC,CAAA,kBACE,CAAA,YAEF,OAAA;EAAkB,OAAA;AAAA,IAChB,CAAA,8BACQ,CAAA;;;;;;;;;;;;AATd;;;;;;UA8BiB,gBAAA,iBACC,gBAAA,sBACR,WAAA;EACR,OAAA,EAAS,KAAA,CAAM,UAAA;IAAe,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;EAC9C,IAAA,EAAM,KAAA,CAAM,QAAA;IAAa,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;AAAA;;;;;;;;;;;KAa/B,gBAAA,GAAmB,sBAAA,GAAyB,sBAAA;AAAA,UAEvC,sBAAA;EACf,UAAA;EACA,QAAA;EACA,UAAA;AAAA;;;;;UAOe,sBAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;UAIc,iBAAA;EACf,IAAA,EAAM,CAAA;EACN,IAAA;IACE,IAAA;IACA,KAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,OAAA;EAAA;AAAA;;;;;;;;AA5BJ;;;;;AAEA;;;;;;;;;AAUA;;UA2CiB,mBAAA;EAzCE;EAAA,SA2CR,IAAA;EA5CA;;;;;EAmDT,KAAA,CAAM,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ,OAAA,GAAU,OAAA;AAAA;;;AA/K/C;AAAA,iBCmBgB,YAAA,CACd,WAAA,iCACA,aAAA,cACC,UAAA;;iBA8Ba,SAAA,CACd,SAAA,iCACA,aAAA,cACC,QAAA;;iBA0Ba,eAAA,CAAgB,MAAA;EAC9B,IAAA;EACA,KAAA;AAAA,IACE,gBAAA;;iBAkBY,gBAAA,CAAiB,CAAA;;;;;;;;;;ADrEjC;;;;;AAKA;;;;;;;;;AAWA;;;;;iBC+GgB,UAAA,iBAA2B,gBAAA,yBAAA,CACzC,KAAA,EAAO,MAAA,eACP,WAAA,GAAc,OAAA,GACb,gBAAA,CAAiB,OAAA;;iBAaJ,gBAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,WAAA,IACf,MAAA"}
@@ -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-D5ohYl6D.mjs";
3
+ import { a as tokenName, c as createToken, i as KickJsRegistry, l as isInjectionToken, n as ContainerChangeEvent, o as INJECTION_TOKEN, r as ContainerChangeListener, s as InjectionToken, t as Container } from "./container-CcgV8eHL.mjs";
4
+ import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-wuoBNkNs.mjs";
5
+ import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-DOBmxARW.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-PufEhr0n.mjs";
7
+ import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-C29iHvHT.mjs";
8
+ import { C as Put, D as Value, E as Service, O as normalizeApiQueryParamsConfig, S as PostConstruct, T as RouteDefinition, _ as Injectable, a as Builder, b as Patch, c as Controller, d as EnvKey, f as FileTypeFilter, g as Inject, h as Get, i as BaseUploadOptions, l as Delete, m as FileUploadConfig, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as FileUpload, r as Autowired, s as Component, t as ApiQueryParams, u as Env, v as Middleware, w as Repository, x as Post, y as MiddlewareHandler } from "./decorators-D3lBlmud.mjs";
9
+ import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-BZUdxtjC.mjs";
10
+ import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-BLdfUF5b.mjs";
11
+ import { n as normalizePath, t as joinPaths } from "./path-Dq5V-i-x.mjs";
12
+ import { t as KickPlugin } from "./plugin-D20muJwC.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-CMAQh0gi.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-4VM4dUJf.mjs";
15
+ import { Application, ApplicationOptions, MiddlewareEntry } from "./http/application.mjs";
16
+ import { bootstrap } from "./http/bootstrap.mjs";
17
+ import { _ as SortItem, a as parseSearchQuery, c as FILTER_OPERATORS, d as FilterOperator, f as PaginatedResponse, g as QueryFieldConfig, h as QueryBuilderAdapter, i as parseQuery, l as FieldsOf, m as ParsedQuery, n as parseFilters, o as parseSort, p as PaginationParams, r as parsePagination, t as buildQueryParams, u as FilterItem, y as TypedParsedQuery } from "./index-rnK23QBD.mjs";
18
+ import { Ctx, RequestContext, RouteShape } 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, type Ctx, Delete, Env, EnvKey, FILTER_OPERATORS, type FieldsOf, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, INJECTION_TOKEN, Inject, Injectable, InjectionToken, KickJsRegistry, 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, type RouteShape, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type TypedParsedQuery, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, createToken, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, 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.2.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-BqXgNTOf.mjs";
14
+ import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-B7jFEbPE.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-CMgIoRvg.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-C5Q720a2.mjs";
25
+ import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-dEN6SjBl.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-vljPDFaZ.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, INJECTION_TOKEN, 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, createToken, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, 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-D5ohYl6D.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interfaces-D5ohYl6D.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-BLdfUF5b.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger-BLdfUF5b.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"}