@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 @@
1
+ {"version":3,"file":"upload.mjs","names":[],"sources":["../../../src/http/middleware/upload.ts"],"sourcesContent":["import { unlink } from 'node:fs/promises'\nimport type { Request, Response, NextFunction, RequestHandler } from 'express'\nimport multer, { type Options as MulterOptions } from 'multer'\nimport type { BaseUploadOptions, FileUploadConfig } from '../../core'\n\n/**\n * Maps short file extensions to their MIME types.\n * Users can pass `['jpg', 'png', 'pdf']` instead of full MIME strings.\n */\nconst MIME_MAP: Record<string, string> = {\n // Images\n jpg: 'image/jpeg',\n jpeg: 'image/jpeg',\n png: 'image/png',\n gif: 'image/gif',\n webp: 'image/webp',\n svg: 'image/svg+xml',\n bmp: 'image/bmp',\n ico: 'image/x-icon',\n tiff: 'image/tiff',\n tif: 'image/tiff',\n avif: 'image/avif',\n // Documents\n pdf: 'application/pdf',\n doc: 'application/msword',\n docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n xls: 'application/vnd.ms-excel',\n xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n ppt: 'application/vnd.ms-powerpoint',\n pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n odt: 'application/vnd.oasis.opendocument.text',\n ods: 'application/vnd.oasis.opendocument.spreadsheet',\n odp: 'application/vnd.oasis.opendocument.presentation',\n rtf: 'application/rtf',\n txt: 'text/plain',\n csv: 'text/csv',\n // Archives\n zip: 'application/zip',\n gz: 'application/gzip',\n tar: 'application/x-tar',\n rar: 'application/vnd.rar',\n '7z': 'application/x-7z-compressed',\n // Audio\n mp3: 'audio/mpeg',\n wav: 'audio/wav',\n ogg: 'audio/ogg',\n flac: 'audio/flac',\n aac: 'audio/aac',\n // Video\n mp4: 'video/mp4',\n webm: 'video/webm',\n avi: 'video/x-msvideo',\n mov: 'video/quicktime',\n mkv: 'video/x-matroska',\n // Other\n json: 'application/json',\n xml: 'application/xml',\n html: 'text/html',\n}\n\n/**\n * Resolves a list of file type identifiers to MIME type strings.\n * Accepts short extensions (`'jpg'`, `'pdf'`) or full MIME types (`'image/jpeg'`).\n *\n * @example\n * ```ts\n * resolveMimeTypes(['jpg', 'png', 'application/pdf'])\n * // → ['image/jpeg', 'image/png', 'application/pdf']\n * ```\n */\nexport function resolveMimeTypes(types: string[]): string[] {\n return types.map((t) => {\n const lower = t.toLowerCase().replace(/^\\./, '')\n return MIME_MAP[lower] ?? t\n })\n}\n\n/**\n * Upload options for the middleware.\n * Extends BaseUploadOptions from core (shared with @FileUpload decorator)\n * and adds Multer-specific storage options.\n */\nexport interface UploadOptions extends BaseUploadOptions {\n /** Multer storage config (default: memory storage) */\n storage?: MulterOptions['storage']\n /** Multer dest for disk storage shorthand */\n dest?: string\n}\n\nfunction createMulter(options: UploadOptions) {\n const mimeMap = options.customMimeMap ? { ...MIME_MAP, ...options.customMimeMap } : MIME_MAP\n\n const limits: MulterOptions['limits'] = {\n fileSize: options.maxSize ?? 5 * 1024 * 1024,\n }\n\n let fileFilter: MulterOptions['fileFilter'] | undefined\n\n if (typeof options.allowedTypes === 'function') {\n // Custom filter function\n const filterFn = options.allowedTypes\n fileFilter = (_req, file, cb) => {\n if (filterFn(file.mimetype, file.originalname)) {\n cb(null, true)\n } else {\n cb(new Error(`File type ${file.mimetype} is not allowed`))\n }\n }\n } else if (Array.isArray(options.allowedTypes)) {\n // String array — resolve short extensions using the (possibly extended) MIME map\n const resolvedTypes = options.allowedTypes.map((t) => {\n const lower = t.toLowerCase().replace(/^\\./, '')\n return mimeMap[lower] ?? t\n })\n fileFilter = (_req, file, cb) => {\n const allowed = resolvedTypes.some((type) => {\n if (type.endsWith('/*')) {\n return file.mimetype.startsWith(type.replace('/*', '/'))\n }\n return file.mimetype === type\n })\n if (allowed) {\n cb(null, true)\n } else {\n cb(new Error(`File type ${file.mimetype} is not allowed`))\n }\n }\n }\n\n const multerOptions: MulterOptions = {\n limits,\n ...(fileFilter ? { fileFilter } : {}),\n ...(options.storage ? { storage: options.storage } : {}),\n ...(options.dest ? { dest: options.dest } : {}),\n }\n\n return multer(multerOptions)\n}\n\n/**\n * Single file upload middleware. Attaches the file to `req.file`.\n *\n * @example\n * ```ts\n * @Post('/avatar')\n * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['jpg', 'png'] }))\n * async uploadAvatar(ctx: RequestContext) {\n * ctx.json({ filename: ctx.file.originalname })\n * }\n * ```\n */\nfunction single(fieldName: string, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n return m.single(fieldName) as RequestHandler\n}\n\n/**\n * Multiple file upload middleware. Attaches files to `req.files`.\n */\nfunction array(fieldName: string, maxCount = 10, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n return m.array(fieldName, maxCount) as RequestHandler\n}\n\n/**\n * No file upload — just parse multipart form data without file fields.\n */\nfunction none(options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n return m.none() as RequestHandler\n}\n\n/**\n * Removes temporary files from disk after the response is sent.\n * Attach this as Express middleware after the upload middleware.\n * Works with both `req.file` (single) and `req.files` (array).\n *\n * @example\n * ```ts\n * @Post('/process')\n * @Middleware(upload.single('document', { dest: '/tmp/uploads' }), cleanupFiles())\n * async processDocument(ctx: RequestContext) {\n * ctx.json({ ok: true })\n * }\n * ```\n */\nexport function cleanupFiles() {\n return (req: Request, res: Response, next: NextFunction) => {\n res.on('finish', async () => {\n const files: any[] = []\n\n if ((req as any).file?.path) {\n files.push((req as any).file)\n }\n if (Array.isArray((req as any).files)) {\n for (const f of (req as any).files) {\n if (f?.path) files.push(f)\n }\n }\n\n for (const file of files) {\n try {\n await unlink(file.path)\n } catch {\n // File may already be moved/deleted by the handler — ignore\n }\n }\n })\n\n next()\n }\n}\n\n/**\n * Build upload middleware from a @FileUpload decorator config.\n * Used internally by the router builder when it detects FILE_UPLOAD metadata.\n * Accepts the same FileUploadConfig interface used by the @FileUpload decorator.\n */\nexport function buildUploadMiddleware(config: FileUploadConfig): RequestHandler {\n const options: UploadOptions = {}\n if (config.maxSize) options.maxSize = config.maxSize\n if (config.allowedTypes) options.allowedTypes = config.allowedTypes\n if (config.customMimeMap) options.customMimeMap = config.customMimeMap\n\n const fieldName = config.fieldName ?? 'file'\n\n switch (config.mode) {\n case 'single':\n return single(fieldName, options)\n case 'array':\n return array(fieldName, config.maxCount ?? 10, options)\n case 'none':\n return none(options)\n }\n}\n\n/** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */\nexport const upload = { single, array, none }\n"],"mappings":";;;;;;;;;;;;;;;;;AASA,MAAM,WAAmC;CAEvC,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CAEN,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CAEL,KAAK;CACL,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CAEN,KAAK;CACL,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CAEL,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CAEL,MAAM;CACN,KAAK;CACL,MAAM;CACP;;;;;;;;;;;AAYD,SAAgB,iBAAiB,OAA2B;AAC1D,QAAO,MAAM,KAAK,MAAM;AAEtB,SAAO,SADO,EAAE,aAAa,CAAC,QAAQ,OAAO,GAAG,KACtB;GAC1B;;AAeJ,SAAS,aAAa,SAAwB;CAC5C,MAAM,UAAU,QAAQ,gBAAgB;EAAE,GAAG;EAAU,GAAG,QAAQ;EAAe,GAAG;CAEpF,MAAM,SAAkC,EACtC,UAAU,QAAQ,WAAW,IAAI,OAAO,MACzC;CAED,IAAI;AAEJ,KAAI,OAAO,QAAQ,iBAAiB,YAAY;EAE9C,MAAM,WAAW,QAAQ;AACzB,gBAAc,MAAM,MAAM,OAAO;AAC/B,OAAI,SAAS,KAAK,UAAU,KAAK,aAAa,CAC5C,IAAG,MAAM,KAAK;OAEd,oBAAG,IAAI,MAAM,aAAa,KAAK,SAAS,iBAAiB,CAAC;;YAGrD,MAAM,QAAQ,QAAQ,aAAa,EAAE;EAE9C,MAAM,gBAAgB,QAAQ,aAAa,KAAK,MAAM;AAEpD,UAAO,QADO,EAAE,aAAa,CAAC,QAAQ,OAAO,GAAG,KACvB;IACzB;AACF,gBAAc,MAAM,MAAM,OAAO;AAO/B,OANgB,cAAc,MAAM,SAAS;AAC3C,QAAI,KAAK,SAAS,KAAK,CACrB,QAAO,KAAK,SAAS,WAAW,KAAK,QAAQ,MAAM,IAAI,CAAC;AAE1D,WAAO,KAAK,aAAa;KACzB,CAEA,IAAG,MAAM,KAAK;OAEd,oBAAG,IAAI,MAAM,aAAa,KAAK,SAAS,iBAAiB,CAAC;;;AAYhE,QAAO,OAP8B;EACnC;EACA,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;EACpC,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,GAAG,EAAE;EACvD,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;EAC/C,CAE2B;;;;;;;;;;;;;;AAe9B,SAAS,OAAO,WAAmB,UAAyB,EAAE,EAAkB;AAE9E,QADU,aAAa,QAAQ,CACtB,OAAO,UAAU;;;;;AAM5B,SAAS,MAAM,WAAmB,WAAW,IAAI,UAAyB,EAAE,EAAkB;AAE5F,QADU,aAAa,QAAQ,CACtB,MAAM,WAAW,SAAS;;;;;AAMrC,SAAS,KAAK,UAAyB,EAAE,EAAkB;AAEzD,QADU,aAAa,QAAQ,CACtB,MAAM;;;;;;;;;;;;;;;;AAiBjB,SAAgB,eAAe;AAC7B,SAAQ,KAAc,KAAe,SAAuB;AAC1D,MAAI,GAAG,UAAU,YAAY;GAC3B,MAAM,QAAe,EAAE;AAEvB,OAAK,IAAY,MAAM,KACrB,OAAM,KAAM,IAAY,KAAK;AAE/B,OAAI,MAAM,QAAS,IAAY,MAAM;SAC9B,MAAM,KAAM,IAAY,MAC3B,KAAI,GAAG,KAAM,OAAM,KAAK,EAAE;;AAI9B,QAAK,MAAM,QAAQ,MACjB,KAAI;AACF,UAAM,OAAO,KAAK,KAAK;WACjB;IAIV;AAEF,QAAM;;;;;;;;AASV,SAAgB,sBAAsB,QAA0C;CAC9E,MAAM,UAAyB,EAAE;AACjC,KAAI,OAAO,QAAS,SAAQ,UAAU,OAAO;AAC7C,KAAI,OAAO,aAAc,SAAQ,eAAe,OAAO;AACvD,KAAI,OAAO,cAAe,SAAQ,gBAAgB,OAAO;CAEzD,MAAM,YAAY,OAAO,aAAa;AAEtC,SAAQ,OAAO,MAAf;EACE,KAAK,SACH,QAAO,OAAO,WAAW,QAAQ;EACnC,KAAK,QACH,QAAO,MAAM,WAAW,OAAO,YAAY,IAAI,QAAQ;EACzD,KAAK,OACH,QAAO,KAAK,QAAQ;;;;AAK1B,MAAa,SAAS;CAAE;CAAQ;CAAO;CAAM"}
@@ -0,0 +1,18 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/validate.d.ts
5
+ interface ValidationSchema {
6
+ body?: any;
7
+ query?: any;
8
+ params?: any;
9
+ }
10
+ /**
11
+ * Express middleware that validates request body/query/params against schemas.
12
+ * Works with any validation library that exposes `.safeParse(data)` returning
13
+ * `{ success: true, data }` or `{ success: false, error: { issues } }`.
14
+ */
15
+ declare function validate(schema: ValidationSchema): (req: Request, res: Response, next: NextFunction) => Response<any, Record<string, any>> | undefined;
16
+ //#endregion
17
+ export { ValidationSchema, validate };
18
+ //# sourceMappingURL=validate.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.d.mts","names":[],"sources":["../../../src/http/middleware/validate.ts"],"mappings":";;;;UAEiB,gBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;;iBAQc,QAAA,CAAS,MAAA,EAAQ,gBAAA,IACvB,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAY,QAAA,MAAA,MAAA"}
@@ -0,0 +1,62 @@
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
+ //#region src/http/middleware/validate.ts
12
+ /**
13
+ * Express middleware that validates request body/query/params against schemas.
14
+ * Works with any validation library that exposes `.safeParse(data)` returning
15
+ * `{ success: true, data }` or `{ success: false, error: { issues } }`.
16
+ */
17
+ function validate(schema) {
18
+ return (req, res, next) => {
19
+ try {
20
+ if (schema.body) {
21
+ const result = schema.body.safeParse(req.body);
22
+ if (!result.success) return res.status(422).json({
23
+ message: result.error.issues[0]?.message || "Validation failed",
24
+ errors: result.error.issues.map((i) => ({
25
+ field: i.path.join("."),
26
+ message: i.message
27
+ }))
28
+ });
29
+ req.body = result.data;
30
+ }
31
+ if (schema.query) {
32
+ const result = schema.query.safeParse(req.query);
33
+ if (!result.success) return res.status(422).json({
34
+ message: "Invalid query parameters",
35
+ errors: result.error.issues.map((i) => ({
36
+ field: i.path.join("."),
37
+ message: i.message
38
+ }))
39
+ });
40
+ req.query = result.data;
41
+ }
42
+ if (schema.params) {
43
+ const result = schema.params.safeParse(req.params);
44
+ if (!result.success) return res.status(422).json({
45
+ message: "Invalid path parameters",
46
+ errors: result.error.issues.map((i) => ({
47
+ field: i.path.join("."),
48
+ message: i.message
49
+ }))
50
+ });
51
+ req.params = result.data;
52
+ }
53
+ next();
54
+ } catch (err) {
55
+ next(err);
56
+ }
57
+ };
58
+ }
59
+ //#endregion
60
+ export { validate };
61
+
62
+ //# sourceMappingURL=validate.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.mjs","names":[],"sources":["../../../src/http/middleware/validate.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface ValidationSchema {\n body?: any\n query?: any\n params?: any\n}\n\n/**\n * Express middleware that validates request body/query/params against schemas.\n * Works with any validation library that exposes `.safeParse(data)` returning\n * `{ success: true, data }` or `{ success: false, error: { issues } }`.\n */\nexport function validate(schema: ValidationSchema) {\n return (req: Request, res: Response, next: NextFunction) => {\n try {\n if (schema.body) {\n const result = schema.body.safeParse(req.body)\n if (!result.success) {\n return res.status(422).json({\n message: result.error.issues[0]?.message || 'Validation failed',\n errors: result.error.issues.map((i: any) => ({\n field: i.path.join('.'),\n message: i.message,\n })),\n })\n }\n req.body = result.data\n }\n\n if (schema.query) {\n const result = schema.query.safeParse(req.query)\n if (!result.success) {\n return res.status(422).json({\n message: 'Invalid query parameters',\n errors: result.error.issues.map((i: any) => ({\n field: i.path.join('.'),\n message: i.message,\n })),\n })\n }\n ;(req as any).query = result.data\n }\n\n if (schema.params) {\n const result = schema.params.safeParse(req.params)\n if (!result.success) {\n return res.status(422).json({\n message: 'Invalid path parameters',\n errors: result.error.issues.map((i: any) => ({\n field: i.path.join('.'),\n message: i.message,\n })),\n })\n }\n ;(req as any).params = result.data\n }\n\n next()\n } catch (err) {\n next(err)\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAaA,SAAgB,SAAS,QAA0B;AACjD,SAAQ,KAAc,KAAe,SAAuB;AAC1D,MAAI;AACF,OAAI,OAAO,MAAM;IACf,MAAM,SAAS,OAAO,KAAK,UAAU,IAAI,KAAK;AAC9C,QAAI,CAAC,OAAO,QACV,QAAO,IAAI,OAAO,IAAI,CAAC,KAAK;KAC1B,SAAS,OAAO,MAAM,OAAO,IAAI,WAAW;KAC5C,QAAQ,OAAO,MAAM,OAAO,KAAK,OAAY;MAC3C,OAAO,EAAE,KAAK,KAAK,IAAI;MACvB,SAAS,EAAE;MACZ,EAAE;KACJ,CAAC;AAEJ,QAAI,OAAO,OAAO;;AAGpB,OAAI,OAAO,OAAO;IAChB,MAAM,SAAS,OAAO,MAAM,UAAU,IAAI,MAAM;AAChD,QAAI,CAAC,OAAO,QACV,QAAO,IAAI,OAAO,IAAI,CAAC,KAAK;KAC1B,SAAS;KACT,QAAQ,OAAO,MAAM,OAAO,KAAK,OAAY;MAC3C,OAAO,EAAE,KAAK,KAAK,IAAI;MACvB,SAAS,EAAE;MACZ,EAAE;KACJ,CAAC;AAEF,QAAY,QAAQ,OAAO;;AAG/B,OAAI,OAAO,QAAQ;IACjB,MAAM,SAAS,OAAO,OAAO,UAAU,IAAI,OAAO;AAClD,QAAI,CAAC,OAAO,QACV,QAAO,IAAI,OAAO,IAAI,CAAC,KAAK;KAC1B,SAAS;KACT,QAAQ,OAAO,MAAM,OAAO,KAAK,OAAY;MAC3C,OAAO,EAAE,KAAK,KAAK,IAAI;MACvB,SAAS,EAAE;MACZ,EAAE;KACJ,CAAC;AAEF,QAAY,SAAS,OAAO;;AAGhC,SAAM;WACC,KAAK;AACZ,QAAK,IAAI"}
@@ -0,0 +1,62 @@
1
+
2
+ import { r as AppAdapter, t as AdapterContext } from "../../adapter-BqGjZCSm.mjs";
3
+ //#region src/http/middleware/views.d.ts
4
+ interface ViewAdapterOptions {
5
+ /**
6
+ * Template engine — pass the engine module or a render function.
7
+ * Supported engines: ejs, pug, handlebars, nunjucks, or any
8
+ * Express-compatible engine with a __express property.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import ejs from 'ejs'
13
+ * new ViewAdapter({ engine: ejs, ext: 'ejs' })
14
+ *
15
+ * import pug from 'pug'
16
+ * new ViewAdapter({ engine: pug, ext: 'pug' })
17
+ * ```
18
+ */
19
+ engine: any;
20
+ /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */
21
+ ext: string;
22
+ /** Directory containing template files (default: 'src/views') */
23
+ viewsDir?: string;
24
+ /** Default layout template (optional — depends on engine) */
25
+ layout?: string;
26
+ }
27
+ /**
28
+ * View/template adapter — pluggable template engine support for KickJS.
29
+ *
30
+ * Registers an Express view engine and sets the views directory.
31
+ * Use `ctx.render()` in controllers to render templates.
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * import ejs from 'ejs'
36
+ * import { ViewAdapter } from '@forinda/kickjs-http/views'
37
+ *
38
+ * bootstrap({
39
+ * modules,
40
+ * adapters: [
41
+ * new ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),
42
+ * ],
43
+ * })
44
+ *
45
+ * // In a controller:
46
+ * @Get('/dashboard')
47
+ * async dashboard(ctx: RequestContext) {
48
+ * ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })
49
+ * }
50
+ * ```
51
+ */
52
+ declare class ViewAdapter implements AppAdapter {
53
+ private options;
54
+ name: string;
55
+ constructor(options: ViewAdapterOptions);
56
+ beforeMount({
57
+ app
58
+ }: AdapterContext): void;
59
+ }
60
+ //#endregion
61
+ export { ViewAdapter, ViewAdapterOptions };
62
+ //# sourceMappingURL=views.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"views.d.mts","names":[],"sources":["../../../src/http/middleware/views.ts"],"mappings":";;;UAKiB,kBAAA;;;AAAjB;;;;;;;;;;AAoDA;;EArCE,MAAA;EAwC6B;EArC7B,GAAA;EAuCqB;EApCrB,QAAA;EA+B4C;EA5B5C,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cA4BW,WAAA,YAAuB,UAAA;EAAA,QAGd,OAAA;EAFpB,IAAA;cAEoB,OAAA,EAAS,kBAAA;EAE7B,WAAA,CAAA;IAAc;EAAA,GAAO,cAAA;AAAA"}
@@ -0,0 +1,65 @@
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 { Logger } from "../../core/logger.mjs";
12
+ import "../../core-BL_H8fEZ.mjs";
13
+ import { resolve } from "node:path";
14
+ //#region src/http/middleware/views.ts
15
+ const log = Logger.for("ViewEngine");
16
+ /**
17
+ * View/template adapter — pluggable template engine support for KickJS.
18
+ *
19
+ * Registers an Express view engine and sets the views directory.
20
+ * Use `ctx.render()` in controllers to render templates.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * import ejs from 'ejs'
25
+ * import { ViewAdapter } from '@forinda/kickjs-http/views'
26
+ *
27
+ * bootstrap({
28
+ * modules,
29
+ * adapters: [
30
+ * new ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),
31
+ * ],
32
+ * })
33
+ *
34
+ * // In a controller:
35
+ * @Get('/dashboard')
36
+ * async dashboard(ctx: RequestContext) {
37
+ * ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })
38
+ * }
39
+ * ```
40
+ */
41
+ var ViewAdapter = class {
42
+ name = "ViewAdapter";
43
+ constructor(options) {
44
+ this.options = options;
45
+ }
46
+ beforeMount({ app }) {
47
+ const { engine, ext, viewsDir = "src/views" } = this.options;
48
+ if (engine.__express) app.engine(ext, engine.__express);
49
+ else if (typeof engine.renderFile === "function") app.engine(ext, (path, options, callback) => {
50
+ engine.renderFile(path, options, callback);
51
+ });
52
+ else if (typeof engine === "function") app.engine(ext, engine);
53
+ else {
54
+ log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`);
55
+ app.engine(ext, engine);
56
+ }
57
+ app.set("view engine", ext);
58
+ app.set("views", resolve(viewsDir));
59
+ log.info(`View engine: ${ext} (${resolve(viewsDir)})`);
60
+ }
61
+ };
62
+ //#endregion
63
+ export { ViewAdapter };
64
+
65
+ //# sourceMappingURL=views.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"views.mjs","names":[],"sources":["../../../src/http/middleware/views.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport { Logger, type AppAdapter, type AdapterContext } from '../../core'\n\nconst log = Logger.for('ViewEngine')\n\nexport interface ViewAdapterOptions {\n /**\n * Template engine — pass the engine module or a render function.\n * Supported engines: ejs, pug, handlebars, nunjucks, or any\n * Express-compatible engine with a __express property.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * new ViewAdapter({ engine: ejs, ext: 'ejs' })\n *\n * import pug from 'pug'\n * new ViewAdapter({ engine: pug, ext: 'pug' })\n * ```\n */\n engine: any\n\n /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */\n ext: string\n\n /** Directory containing template files (default: 'src/views') */\n viewsDir?: string\n\n /** Default layout template (optional — depends on engine) */\n layout?: string\n}\n\n/**\n * View/template adapter — pluggable template engine support for KickJS.\n *\n * Registers an Express view engine and sets the views directory.\n * Use `ctx.render()` in controllers to render templates.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * import { ViewAdapter } from '@forinda/kickjs-http/views'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * new ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),\n * ],\n * })\n *\n * // In a controller:\n * @Get('/dashboard')\n * async dashboard(ctx: RequestContext) {\n * ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })\n * }\n * ```\n */\nexport class ViewAdapter implements AppAdapter {\n name = 'ViewAdapter'\n\n constructor(private options: ViewAdapterOptions) {}\n\n beforeMount({ app }: AdapterContext): void {\n const { engine, ext, viewsDir = 'src/views' } = this.options\n\n // Register the engine\n if (engine.__express) {\n // EJS, Pug — have __express method\n app.engine(ext, engine.__express)\n } else if (typeof engine.renderFile === 'function') {\n // Engines with renderFile (nunjucks-style)\n app.engine(ext, (path: string, options: any, callback: Function) => {\n engine.renderFile(path, options, callback)\n })\n } else if (typeof engine === 'function') {\n // Custom render function: (path, options, callback) => void\n app.engine(ext, engine)\n } else {\n log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`)\n app.engine(ext, engine)\n }\n\n app.set('view engine', ext)\n app.set('views', resolve(viewsDir))\n\n log.info(`View engine: ${ext} (${resolve(viewsDir)})`)\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AAGA,MAAM,MAAM,OAAO,IAAI,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDpC,IAAa,cAAb,MAA+C;CAC7C,OAAO;CAEP,YAAY,SAAqC;AAA7B,OAAA,UAAA;;CAEpB,YAAY,EAAE,OAA6B;EACzC,MAAM,EAAE,QAAQ,KAAK,WAAW,gBAAgB,KAAK;AAGrD,MAAI,OAAO,UAET,KAAI,OAAO,KAAK,OAAO,UAAU;WACxB,OAAO,OAAO,eAAe,WAEtC,KAAI,OAAO,MAAM,MAAc,SAAc,aAAuB;AAClE,UAAO,WAAW,MAAM,SAAS,SAAS;IAC1C;WACO,OAAO,WAAW,WAE3B,KAAI,OAAO,KAAK,OAAO;OAClB;AACL,OAAI,KAAK,eAAe,IAAI,uDAAuD;AACnF,OAAI,OAAO,KAAK,OAAO;;AAGzB,MAAI,IAAI,eAAe,IAAI;AAC3B,MAAI,IAAI,SAAS,QAAQ,SAAS,CAAC;AAEnC,MAAI,KAAK,gBAAgB,IAAI,IAAI,QAAQ,SAAS,CAAC,GAAG"}
@@ -0,0 +1,3 @@
1
+
2
+ import { _ as StringQueryFieldConfig, 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, s as ColumnQueryFieldConfig, t as buildQueryParams, u as FilterOperator } from "../../index-Cls52etj.mjs";
3
+ export { ColumnQueryFieldConfig, FILTER_OPERATORS, FilterItem, FilterOperator, PaginatedResponse, PaginationParams, ParsedQuery, QueryBuilderAdapter, QueryFieldConfig, SortItem, StringQueryFieldConfig, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
@@ -0,0 +1,12 @@
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 { 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";
12
+ export { FILTER_OPERATORS, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
@@ -1,7 +1,9 @@
1
- import 'reflect-metadata';
2
- import { Router } from 'express';
1
+
2
+ import { Router } from "express";
3
+
4
+ //#region src/http/router-builder.d.ts
3
5
  /** Get the controller path set by @Controller('/path') */
4
- export declare function getControllerPath(controllerClass: any): string;
6
+ declare function getControllerPath(controllerClass: any): string;
5
7
  /**
6
8
  * Build an Express Router from a controller class decorated with @Get, @Post, etc.
7
9
  * Resolves the controller from the DI container, wraps handlers in RequestContext,
@@ -13,5 +15,7 @@ export declare function getControllerPath(controllerClass: any): string;
13
15
  * The module's routes().path is the single source of truth for the mount prefix,
14
16
  * which avoids path doubling when both the module and controller specify the same path.
15
17
  */
16
- export declare function buildRoutes(controllerClass: any): Router;
17
- //# sourceMappingURL=router-builder.d.ts.map
18
+ declare function buildRoutes(controllerClass: any): Router;
19
+ //#endregion
20
+ export { buildRoutes, getControllerPath };
21
+ //# sourceMappingURL=router-builder.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router-builder.d.mts","names":[],"sources":["../../src/http/router-builder.ts"],"mappings":";;;;;iBAcgB,iBAAA,CAAkB,eAAA;AAAlC;;;;;AAeA;;;;;;AAfA,iBAegB,WAAA,CAAY,eAAA,QAAuB,MAAA"}
@@ -0,0 +1,67 @@
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 } from "../core/interfaces.mjs";
12
+ import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-fmvikBA0.mjs";
13
+ import { Container } from "../core/container.mjs";
14
+ import "../core-BL_H8fEZ.mjs";
15
+ import { RequestContext } from "./context.mjs";
16
+ import { validate } from "./middleware/validate.mjs";
17
+ import { buildUploadMiddleware } from "./middleware/upload.mjs";
18
+ import { Router } from "express";
19
+ //#region src/http/router-builder.ts
20
+ /** Get the controller path set by @Controller('/path') */
21
+ function getControllerPath(controllerClass) {
22
+ return getClassMeta(METADATA.CONTROLLER_PATH, controllerClass, "/");
23
+ }
24
+ /**
25
+ * Build an Express Router from a controller class decorated with @Get, @Post, etc.
26
+ * Resolves the controller from the DI container, wraps handlers in RequestContext,
27
+ * and applies class-level and method-level middleware.
28
+ *
29
+ * Routes are registered using only the method-level decorator paths (e.g. @Get('/me') → '/me').
30
+ * The @Controller path is NOT baked into the router — it serves as metadata only
31
+ * (used by Swagger and other adapters for introspection).
32
+ * The module's routes().path is the single source of truth for the mount prefix,
33
+ * which avoids path doubling when both the module and controller specify the same path.
34
+ */
35
+ function buildRoutes(controllerClass) {
36
+ const router = Router();
37
+ const container = Container.getInstance();
38
+ const routes = getClassMeta(METADATA.ROUTES, controllerClass, []);
39
+ const classMiddlewares = getClassMeta(METADATA.CLASS_MIDDLEWARES, controllerClass, []);
40
+ for (const route of routes) {
41
+ const method = route.method.toLowerCase();
42
+ const fullPath = route.path || "/";
43
+ const methodMiddlewares = getMethodMeta(METADATA.METHOD_MIDDLEWARES, controllerClass, route.handlerName, []);
44
+ const handlers = [];
45
+ if (route.validation) handlers.push(validate(route.validation));
46
+ const fileUploadConfig = getMethodMetaOrUndefined(METADATA.FILE_UPLOAD, controllerClass, route.handlerName);
47
+ if (fileUploadConfig) handlers.push(buildUploadMiddleware(fileUploadConfig));
48
+ for (const mw of [...classMiddlewares, ...methodMiddlewares]) handlers.push((req, res, next) => {
49
+ const ctx = new RequestContext(req, res, next);
50
+ Promise.resolve(mw(ctx, next)).catch(next);
51
+ });
52
+ handlers.push(async (req, res, next) => {
53
+ const ctx = new RequestContext(req, res, next);
54
+ try {
55
+ await container.resolve(controllerClass)[route.handlerName](ctx);
56
+ } catch (err) {
57
+ next(err);
58
+ }
59
+ });
60
+ router[method](fullPath, ...handlers);
61
+ }
62
+ return router;
63
+ }
64
+ //#endregion
65
+ export { buildRoutes, getControllerPath };
66
+
67
+ //# sourceMappingURL=router-builder.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router-builder.mjs","names":[],"sources":["../../src/http/router-builder.ts"],"sourcesContent":["import { Router, type Request, type Response, type NextFunction } from 'express'\nimport {\n Container,\n METADATA,\n type RouteDefinition,\n type MiddlewareHandler,\n type FileUploadConfig,\n} from '../core'\nimport { getClassMeta, getMethodMeta, getMethodMetaOrUndefined } from '../core/metadata'\nimport { RequestContext } from './context'\nimport { validate } from './middleware/validate'\nimport { buildUploadMiddleware } from './middleware/upload'\n\n/** Get the controller path set by @Controller('/path') */\nexport function getControllerPath(controllerClass: any): string {\n return getClassMeta<string>(METADATA.CONTROLLER_PATH, controllerClass, '/')\n}\n\n/**\n * Build an Express Router from a controller class decorated with @Get, @Post, etc.\n * Resolves the controller from the DI container, wraps handlers in RequestContext,\n * and applies class-level and method-level middleware.\n *\n * Routes are registered using only the method-level decorator paths (e.g. @Get('/me') → '/me').\n * The @Controller path is NOT baked into the router — it serves as metadata only\n * (used by Swagger and other adapters for introspection).\n * The module's routes().path is the single source of truth for the mount prefix,\n * which avoids path doubling when both the module and controller specify the same path.\n */\nexport function buildRoutes(controllerClass: any): Router {\n const router = Router()\n const container = Container.getInstance()\n const routes: RouteDefinition[] = getClassMeta<RouteDefinition[]>(\n METADATA.ROUTES,\n controllerClass,\n [],\n )\n\n // Class-level middleware\n const classMiddlewares: MiddlewareHandler[] = getClassMeta<MiddlewareHandler[]>(\n METADATA.CLASS_MIDDLEWARES,\n controllerClass,\n [],\n )\n\n for (const route of routes) {\n const method = route.method.toLowerCase() as 'get' | 'post' | 'put' | 'delete' | 'patch'\n const fullPath = route.path || '/'\n\n // Method-level middleware\n const methodMiddlewares: MiddlewareHandler[] = getMethodMeta<MiddlewareHandler[]>(\n METADATA.METHOD_MIDDLEWARES,\n controllerClass,\n route.handlerName,\n [],\n )\n\n // Build handler chain\n const handlers: any[] = []\n\n // Validation middleware (shared with standalone validate() export)\n if (route.validation) {\n handlers.push(validate(route.validation))\n }\n\n // @FileUpload decorator — auto-attach upload middleware from metadata\n const fileUploadConfig = getMethodMetaOrUndefined<FileUploadConfig>(\n METADATA.FILE_UPLOAD,\n controllerClass,\n route.handlerName,\n )\n if (fileUploadConfig) {\n handlers.push(buildUploadMiddleware(fileUploadConfig))\n }\n\n // Class + method middleware (wrapped as Express middleware with error catching)\n for (const mw of [...classMiddlewares, ...methodMiddlewares]) {\n handlers.push((req: Request, res: Response, next: NextFunction) => {\n const ctx = new RequestContext(req, res, next)\n Promise.resolve(mw(ctx, next)).catch(next)\n })\n }\n\n // Main handler — resolve controller per-request to respect DI scoping\n handlers.push(async (req: Request, res: Response, next: NextFunction) => {\n const ctx = new RequestContext(req, res, next)\n try {\n const controller = container.resolve(controllerClass)\n await controller[route.handlerName](ctx)\n } catch (err: any) {\n next(err)\n }\n })\n ;(router as any)[method](fullPath, ...handlers)\n }\n\n return router\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAcA,SAAgB,kBAAkB,iBAA8B;AAC9D,QAAO,aAAqB,SAAS,iBAAiB,iBAAiB,IAAI;;;;;;;;;;;;;AAc7E,SAAgB,YAAY,iBAA8B;CACxD,MAAM,SAAS,QAAQ;CACvB,MAAM,YAAY,UAAU,aAAa;CACzC,MAAM,SAA4B,aAChC,SAAS,QACT,iBACA,EAAE,CACH;CAGD,MAAM,mBAAwC,aAC5C,SAAS,mBACT,iBACA,EAAE,CACH;AAED,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,SAAS,MAAM,OAAO,aAAa;EACzC,MAAM,WAAW,MAAM,QAAQ;EAG/B,MAAM,oBAAyC,cAC7C,SAAS,oBACT,iBACA,MAAM,aACN,EAAE,CACH;EAGD,MAAM,WAAkB,EAAE;AAG1B,MAAI,MAAM,WACR,UAAS,KAAK,SAAS,MAAM,WAAW,CAAC;EAI3C,MAAM,mBAAmB,yBACvB,SAAS,aACT,iBACA,MAAM,YACP;AACD,MAAI,iBACF,UAAS,KAAK,sBAAsB,iBAAiB,CAAC;AAIxD,OAAK,MAAM,MAAM,CAAC,GAAG,kBAAkB,GAAG,kBAAkB,CAC1D,UAAS,MAAM,KAAc,KAAe,SAAuB;GACjE,MAAM,MAAM,IAAI,eAAe,KAAK,KAAK,KAAK;AAC9C,WAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAC,MAAM,KAAK;IAC1C;AAIJ,WAAS,KAAK,OAAO,KAAc,KAAe,SAAuB;GACvE,MAAM,MAAM,IAAI,eAAe,KAAK,KAAK,KAAK;AAC9C,OAAI;AAEF,UADmB,UAAU,QAAQ,gBAAgB,CACpC,MAAM,aAAa,IAAI;YACjC,KAAU;AACjB,SAAK,IAAI;;IAEX;AACA,SAAe,QAAQ,UAAU,GAAG,SAAS;;AAGjD,QAAO"}
@@ -0,0 +1,107 @@
1
+
2
+ //#region src/core/metadata.d.ts
3
+ /**
4
+ * Typed utilities for reflect-metadata operations.
5
+ *
6
+ * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single
7
+ * source of truth. If we later move to Stage 3 decorators or a WeakMap-based
8
+ * store, only this file changes — all 24+ consumer files stay untouched.
9
+ */
10
+ type MetaKey = symbol | string;
11
+ /** Set metadata on a class (or prototype for property decorators) */
12
+ declare function setClassMeta<T>(key: MetaKey, value: T, target: object): void;
13
+ /** Set metadata on a specific method */
14
+ declare function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void;
15
+ /** Get metadata from a class, returning `fallback` if not set */
16
+ declare function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T;
17
+ /** Get metadata from a specific method, returning `fallback` if not set */
18
+ declare function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T;
19
+ /** Check if metadata exists on a class */
20
+ declare function hasClassMeta(key: MetaKey, target: object): boolean;
21
+ /** Get metadata from a class with no default (returns undefined if absent) */
22
+ declare function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined;
23
+ /** Get metadata from a method with no default (returns undefined if absent) */
24
+ declare function getMethodMetaOrUndefined<T>(key: MetaKey, target: object, method: string): T | undefined;
25
+ /** Append items to an array stored in class metadata */
26
+ declare function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void;
27
+ /** Append items to an array stored in method metadata */
28
+ declare function pushMethodMeta<T>(key: MetaKey, target: object, method: string, ...items: T[]): void;
29
+ /** Set a key/value in a Map stored in class metadata */
30
+ declare function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void;
31
+ /** Get a Map from class metadata (returns empty Map if absent) */
32
+ declare function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V>;
33
+ /** Set a key/value in a Record stored in class metadata */
34
+ declare function setInMetaRecord<V>(key: MetaKey, target: object, recKey: string | number, recValue: V): void;
35
+ /** Get a Record from class metadata (returns empty object if absent) */
36
+ declare function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V>;
37
+ //#endregion
38
+ //#region src/core/circuit-breaker.d.ts
39
+ /**
40
+ * Circuit Breaker pattern for external service calls.
41
+ *
42
+ * Protects your application from cascading failures when downstream
43
+ * services are unhealthy by short-circuiting requests after a
44
+ * configurable failure threshold.
45
+ *
46
+ * @example
47
+ * ```ts
48
+ * const breaker = new CircuitBreaker('payment-api', {
49
+ * failureThreshold: 5,
50
+ * resetTimeout: 30_000,
51
+ * })
52
+ *
53
+ * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))
54
+ * ```
55
+ */
56
+ type CircuitBreakerState = 'closed' | 'open' | 'half_open';
57
+ interface CircuitBreakerOptions {
58
+ /** Number of consecutive failures before the circuit opens. */
59
+ failureThreshold: number;
60
+ /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */
61
+ resetTimeout: number;
62
+ /** Max requests allowed in HALF_OPEN state before deciding (default 1). */
63
+ halfOpenMax?: number;
64
+ }
65
+ interface CircuitBreakerStats {
66
+ failures: number;
67
+ successes: number;
68
+ state: CircuitBreakerState;
69
+ lastFailure?: Date;
70
+ }
71
+ /**
72
+ * Error thrown when the circuit is open and calls are being rejected.
73
+ */
74
+ declare class CircuitOpenError extends Error {
75
+ readonly breakerName: string;
76
+ constructor(breakerName: string);
77
+ }
78
+ declare class CircuitBreaker {
79
+ readonly name: string;
80
+ private state;
81
+ private failures;
82
+ private successes;
83
+ private halfOpenAttempts;
84
+ private lastFailure?;
85
+ private openedAt?;
86
+ private readonly failureThreshold;
87
+ private readonly resetTimeout;
88
+ private readonly halfOpenMax;
89
+ constructor(name: string, options: CircuitBreakerOptions);
90
+ /**
91
+ * Execute an async function through the circuit breaker.
92
+ * Throws `CircuitOpenError` if the circuit is open.
93
+ */
94
+ execute<T>(fn: () => Promise<T>): Promise<T>;
95
+ /** Returns the current circuit state. */
96
+ getState(): CircuitBreakerState;
97
+ /** Returns current statistics. */
98
+ getStats(): CircuitBreakerStats;
99
+ /** Manually reset the circuit breaker to CLOSED state. */
100
+ reset(): void;
101
+ private onSuccess;
102
+ private onFailure;
103
+ private maybeTransitionToHalfOpen;
104
+ }
105
+ //#endregion
106
+ export { setInMetaRecord as _, CircuitOpenError as a, getMetaMap as c, getMethodMetaOrUndefined as d, hasClassMeta as f, setInMetaMap as g, setClassMeta as h, CircuitBreakerStats as i, getMetaRecord as l, pushMethodMeta as m, CircuitBreakerOptions as n, getClassMeta as o, pushClassMeta as p, CircuitBreakerState as r, getClassMetaOrUndefined as s, CircuitBreaker as t, getMethodMeta as u, setMethodMeta as v };
107
+ //# sourceMappingURL=index-C0gbnpSg.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-C0gbnpSg.d.mts","names":[],"sources":["../src/core/metadata.ts","../src/core/circuit-breaker.ts"],"mappings":";;;;;;;;;KAUK,OAAA;;iBAKW,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA;AAf/B;AAAA,iBAoBT,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA,UAAgB,MAAA;;iBAOzD,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK5D,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK7E,YAAA,CAAa,GAAA,EAAK,OAAA,EAAS,MAAA;;iBAK3B,uBAAA,GAAA,CAA2B,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,CAAA;;iBAK1D,wBAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,WACC,CAAA;;iBAOa,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,aAAmB,KAAA,EAAO,CAAA;;iBAMzD,cAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,aACG,KAAA,EAAO,CAAA;;iBASI,YAAA,MAAA,CAAmB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,EAAQ,CAAA,EAAG,QAAA,EAAU,CAAA;;iBAQtE,UAAA,MAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,GAAA,CAAI,CAAA,EAAG,CAAA;;iBAOvD,eAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,mBACA,QAAA,EAAU,CAAA;;iBASI,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,MAAA,kBAAwB,CAAA;;;;;;;;;;;;;;AAzG/D;;;;;AAezB;KCGY,mBAAA;AAAA,UAEK,qBAAA;EDLqC;ECOpD,gBAAA;EDPmC;ECSnC,YAAA;EDTmD;ECWnD,WAAA;AAAA;AAAA,UAGe,mBAAA;EACf,QAAA;EACA,SAAA;EACA,KAAA,EAAO,mBAAA;EACP,WAAA,GAAc,IAAA;AAAA;;;;cAMH,gBAAA,SAAyB,KAAA;EAAA,SACR,WAAA;cAAA,WAAA;AAAA;AAAA,cAMjB,cAAA;EAAA,SAaO,IAAA;EAAA,QAZV,KAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,WAAA;EAAA,QACA,QAAA;EAAA,iBAES,gBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,WAAA;cAGC,IAAA,UAChB,OAAA,EAAS,qBAAA;EDjCmB;;;;EC4CxB,OAAA,GAAA,CAAW,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;ED5C2B;ECsE3E,QAAA,CAAA,GAAY,mBAAA;EDjEE;ECuEd,QAAA,CAAA,GAAY,mBAAA;EDvEe;ECkF3B,KAAA,CAAA;EAAA,QASQ,SAAA;EAAA,QAWA,SAAA;EAAA,QAeA,yBAAA;AAAA"}
@@ -0,0 +1,148 @@
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
+ * Restrict which fields can be filtered, sorted, or searched.
33
+ * Fields not in the allow-list are silently ignored.
34
+ *
35
+ * Accepts two forms:
36
+ * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`
37
+ * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`
38
+ *
39
+ * When column-object maps are provided, `Object.keys()` is used to derive the field names.
40
+ */
41
+ type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig;
42
+ interface StringQueryFieldConfig {
43
+ filterable?: string[];
44
+ sortable?: string[];
45
+ searchable?: string[];
46
+ }
47
+ /**
48
+ * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).
49
+ * Keys are the field names used in query strings; values are ORM column references.
50
+ */
51
+ interface ColumnQueryFieldConfig {
52
+ columns: Record<string, any>;
53
+ sortable?: Record<string, any>;
54
+ searchColumns?: any[];
55
+ [key: string]: any;
56
+ }
57
+ /** Standardized paginated response shape */
58
+ interface PaginatedResponse<T = any> {
59
+ data: T[];
60
+ meta: {
61
+ page: number;
62
+ limit: number;
63
+ total: number;
64
+ totalPages: number;
65
+ hasNext: boolean;
66
+ hasPrev: boolean;
67
+ };
68
+ }
69
+ /**
70
+ * Interface for ORM-specific query builder adapters.
71
+ * Implement this to translate a `ParsedQuery` into your ORM's query format.
72
+ *
73
+ * @example
74
+ * ```ts
75
+ * // Drizzle adapter
76
+ * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {
77
+ * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {
78
+ * // Convert filters → Drizzle SQL conditions
79
+ * // Convert sort → Drizzle orderBy
80
+ * return { where, orderBy, limit, offset }
81
+ * }
82
+ * }
83
+ *
84
+ * // Prisma adapter
85
+ * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {
86
+ * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {
87
+ * return { where, orderBy, skip, take }
88
+ * }
89
+ * }
90
+ * ```
91
+ */
92
+ interface QueryBuilderAdapter<TResult = any, TConfig = any> {
93
+ /** Human-readable name for debugging */
94
+ readonly name: string;
95
+ /**
96
+ * Convert a ParsedQuery into an ORM-specific query object.
97
+ * @param parsed - The ORM-agnostic parsed query
98
+ * @param config - ORM-specific configuration (column maps, search columns, etc.)
99
+ */
100
+ build(parsed: ParsedQuery, config: TConfig): TResult;
101
+ }
102
+ //#endregion
103
+ //#region src/http/query/parse-query.d.ts
104
+ /** Parse filter strings like "status:eq:active" into structured objects */
105
+ declare function parseFilters(filterParam: string | string[] | undefined, allowedFields?: string[]): FilterItem[];
106
+ /** Parse sort strings like "firstName:asc" into structured objects */
107
+ declare function parseSort(sortParam: string | string[] | undefined, allowedFields?: string[]): SortItem[];
108
+ /** Parse page/limit into pagination with computed offset */
109
+ declare function parsePagination(params: {
110
+ page?: string | number;
111
+ limit?: string | number;
112
+ }): PaginationParams;
113
+ /** Sanitize and truncate search query */
114
+ declare function parseSearchQuery(q: string | undefined): string;
115
+ /**
116
+ * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.
117
+ *
118
+ * @param query - Raw query string object from `req.query` or Zod-validated object
119
+ * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).
120
+ * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and
121
+ * column-object configs (`{ columns, sortable, searchColumns }`).
122
+ *
123
+ * @example
124
+ * ```ts
125
+ * // String-based config
126
+ * const parsed = parseQuery(ctx.query, {
127
+ * filterable: ['status', 'priority'],
128
+ * sortable: ['createdAt', 'title'],
129
+ * })
130
+ *
131
+ * // Column-object config (DrizzleQueryParamsConfig)
132
+ * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)
133
+ * ```
134
+ *
135
+ * Query string format:
136
+ * - Filters: `?filter=field:operator:value` (repeatable)
137
+ * - Sort: `?sort=field:asc|desc` (repeatable)
138
+ * - Pagination: `?page=1&limit=20`
139
+ * - Search: `?q=search+term`
140
+ *
141
+ * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends
142
+ */
143
+ declare function parseQuery(query: Record<string, any>, fieldConfig?: QueryFieldConfig): ParsedQuery;
144
+ /** Convert ParsedQuery back into query string parameters */
145
+ declare function buildQueryParams(parsed: Partial<ParsedQuery>): Record<string, string | string[] | number>;
146
+ //#endregion
147
+ export { StringQueryFieldConfig as _, parseSearchQuery as a, FILTER_OPERATORS as c, PaginatedResponse as d, PaginationParams as f, SortItem as g, QueryFieldConfig as h, parseQuery as i, FilterItem as l, QueryBuilderAdapter as m, parseFilters as n, parseSort as o, ParsedQuery as p, parsePagination as r, ColumnQueryFieldConfig as s, buildQueryParams as t, FilterOperator as u };
148
+ //# sourceMappingURL=index-Cls52etj.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-Cls52etj.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;;;KAiBY,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;AAhBJ;;;;;;;;;;;;AAQA;;;;;;;;;;;AARA,UA2CiB,mBAAA;EA5Bb;EAAA,SA8BO,IAAA;EA7BA;;AA2BX;;;EASE,KAAA,CAAM,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ,OAAA,GAAU,OAAA;AAAA;;;AAlI/C;AAAA,iBCkBgB,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;;iBAcY,gBAAA,CAAiB,CAAA;;;;;;;;;;ADhEjC;;;;;AAKA;;;;;;;;;AAWA;;;;;iBC0GgB,UAAA,CACd,KAAA,EAAO,MAAA,eACP,WAAA,GAAc,gBAAA,GACb,WAAA;;iBAaa,gBAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,WAAA,IACf,MAAA"}