@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,11 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/error-handler.d.ts
5
+ /** Catch-all for unmatched routes */
6
+ declare function notFoundHandler(): (_req: Request, res: Response, _next: NextFunction) => void;
7
+ /** Global error handler */
8
+ declare function errorHandler(): (err: any, req: Request, res: Response, _next: NextFunction) => Response<any, Record<string, any>> | undefined;
9
+ //#endregion
10
+ export { errorHandler, notFoundHandler };
11
+ //# sourceMappingURL=error-handler.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-handler.d.mts","names":[],"sources":["../../../src/http/middleware/error-handler.ts"],"mappings":";;;;;iBAMgB,eAAA,CAAA,IACN,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,KAAA,EAAO,YAAA;AAD/C;AAAA,iBAOgB,YAAA,CAAA,IACN,GAAA,OAAU,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,KAAA,EAAO,YAAA,KAAY,QAAA,MAAA,MAAA"}
@@ -0,0 +1,52 @@
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 { createLogger } from "../../core/logger.mjs";
12
+ import { HttpException } from "../../core/errors.mjs";
13
+ import "../../core-BL_H8fEZ.mjs";
14
+ //#region src/http/middleware/error-handler.ts
15
+ const log = createLogger("ErrorHandler");
16
+ /** Catch-all for unmatched routes */
17
+ function notFoundHandler() {
18
+ return (_req, res, _next) => {
19
+ res.status(404).json({ message: "Not Found" });
20
+ };
21
+ }
22
+ /** Global error handler */
23
+ function errorHandler() {
24
+ return (err, req, res, _next) => {
25
+ if (res.headersSent) {
26
+ log.warn(`Error after headers sent: ${err?.message || "Unknown"}`);
27
+ return;
28
+ }
29
+ if (err?.name === "ZodError") {
30
+ const firstIssue = err.issues?.[0];
31
+ return res.status(422).json({
32
+ message: firstIssue?.message || "Validation failed",
33
+ errors: err.issues
34
+ });
35
+ }
36
+ if (err instanceof HttpException) {
37
+ if (err.status >= 500) log.error(err, err.message);
38
+ return res.status(err.status).json({
39
+ message: err.message,
40
+ ...err.details ? { errors: err.details } : {}
41
+ });
42
+ }
43
+ const status = err.status || err.statusCode || 500;
44
+ log.error(err, `${req.method} ${req.originalUrl} — ${err.message || "Unhandled error"}`);
45
+ const message = status === 500 ? "Internal Server Error" : err.message || "Error";
46
+ res.status(status).json({ message });
47
+ };
48
+ }
49
+ //#endregion
50
+ export { errorHandler, notFoundHandler };
51
+
52
+ //# sourceMappingURL=error-handler.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-handler.mjs","names":[],"sources":["../../../src/http/middleware/error-handler.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport { HttpException, createLogger } from '../../core'\n\nconst log = createLogger('ErrorHandler')\n\n/** Catch-all for unmatched routes */\nexport function notFoundHandler() {\n return (_req: Request, res: Response, _next: NextFunction) => {\n res.status(404).json({ message: 'Not Found' })\n }\n}\n\n/** Global error handler */\nexport function errorHandler() {\n return (err: any, req: Request, res: Response, _next: NextFunction) => {\n // Don't write after headers are already sent\n if (res.headersSent) {\n log.warn(`Error after headers sent: ${err?.message || 'Unknown'}`)\n return\n }\n\n // Zod validation errors\n if (err?.name === 'ZodError') {\n const firstIssue = err.issues?.[0]\n return res.status(422).json({\n message: firstIssue?.message || 'Validation failed',\n errors: err.issues,\n })\n }\n\n // HttpException (expected application errors)\n if (err instanceof HttpException) {\n if (err.status >= 500) {\n log.error(err, err.message)\n }\n return res.status(err.status).json({\n message: err.message,\n ...(err.details ? { errors: err.details } : {}),\n })\n }\n\n // Unexpected errors — always log\n const status = err.status || err.statusCode || 500\n log.error(err, `${req.method} ${req.originalUrl} — ${err.message || 'Unhandled error'}`)\n const message = status === 500 ? 'Internal Server Error' : err.message || 'Error'\n res.status(status).json({ message })\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AAGA,MAAM,MAAM,aAAa,eAAe;;AAGxC,SAAgB,kBAAkB;AAChC,SAAQ,MAAe,KAAe,UAAwB;AAC5D,MAAI,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,CAAC;;;;AAKlD,SAAgB,eAAe;AAC7B,SAAQ,KAAU,KAAc,KAAe,UAAwB;AAErE,MAAI,IAAI,aAAa;AACnB,OAAI,KAAK,6BAA6B,KAAK,WAAW,YAAY;AAClE;;AAIF,MAAI,KAAK,SAAS,YAAY;GAC5B,MAAM,aAAa,IAAI,SAAS;AAChC,UAAO,IAAI,OAAO,IAAI,CAAC,KAAK;IAC1B,SAAS,YAAY,WAAW;IAChC,QAAQ,IAAI;IACb,CAAC;;AAIJ,MAAI,eAAe,eAAe;AAChC,OAAI,IAAI,UAAU,IAChB,KAAI,MAAM,KAAK,IAAI,QAAQ;AAE7B,UAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK;IACjC,SAAS,IAAI;IACb,GAAI,IAAI,UAAU,EAAE,QAAQ,IAAI,SAAS,GAAG,EAAE;IAC/C,CAAC;;EAIJ,MAAM,SAAS,IAAI,UAAU,IAAI,cAAc;AAC/C,MAAI,MAAM,KAAK,GAAG,IAAI,OAAO,GAAG,IAAI,YAAY,KAAK,IAAI,WAAW,oBAAoB;EACxF,MAAM,UAAU,WAAW,MAAM,0BAA0B,IAAI,WAAW;AAC1E,MAAI,OAAO,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC"}
@@ -0,0 +1,41 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/helmet.d.ts
5
+ interface HelmetOptions {
6
+ /** Set Content-Security-Policy header (default: self-only policy) */
7
+ contentSecurityPolicy?: boolean | Record<string, string[]>;
8
+ /** Set X-Content-Type-Options: nosniff (default: true) */
9
+ noSniff?: boolean;
10
+ /** Set X-Frame-Options (default: 'DENY') */
11
+ frameguard?: false | 'DENY' | 'SAMEORIGIN';
12
+ /** Set Strict-Transport-Security (default: max-age=31536000; includeSubDomains) */
13
+ hsts?: false | {
14
+ maxAge?: number;
15
+ includeSubDomains?: boolean;
16
+ preload?: boolean;
17
+ };
18
+ /** Set X-DNS-Prefetch-Control (default: off) */
19
+ dnsPrefetch?: boolean;
20
+ /** Remove X-Powered-By header (default: true) */
21
+ hidePoweredBy?: boolean;
22
+ /** Set Referrer-Policy (default: 'no-referrer') */
23
+ referrerPolicy?: false | string;
24
+ /** Set X-XSS-Protection: 0 (default: true — disables legacy XSS auditor) */
25
+ xssFilter?: boolean;
26
+ }
27
+ /**
28
+ * Security headers middleware. Lightweight alternative to the `helmet` npm package
29
+ * with sensible defaults for API servers.
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * bootstrap({
34
+ * middleware: [helmet(), requestId(), express.json()],
35
+ * })
36
+ * ```
37
+ */
38
+ declare function helmet(options?: HelmetOptions): (req: Request, res: Response, next: NextFunction) => void;
39
+ //#endregion
40
+ export { HelmetOptions, helmet };
41
+ //# sourceMappingURL=helmet.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helmet.d.mts","names":[],"sources":["../../../src/http/middleware/helmet.ts"],"mappings":";;;;UAEiB,aAAA;;EAEf,qBAAA,aAAkC,MAAA;EAFN;EAI5B,OAAA;EAFwC;EAIxC,UAAA;EAJkC;EAMlC,IAAA;IAAiB,MAAA;IAAiB,iBAAA;IAA6B,OAAA;EAAA;EAAA;EAE/D,WAAA;EAEA;EAAA,aAAA;EAIA;EAFA,cAAA;EAES;EAAT,SAAA;AAAA;;;;;;;;;;;;iBAcc,MAAA,CAAO,OAAA,GAAS,aAAA,IAYtB,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
@@ -0,0 +1,51 @@
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/helmet.ts
12
+ /**
13
+ * Security headers middleware. Lightweight alternative to the `helmet` npm package
14
+ * with sensible defaults for API servers.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * bootstrap({
19
+ * middleware: [helmet(), requestId(), express.json()],
20
+ * })
21
+ * ```
22
+ */
23
+ function helmet(options = {}) {
24
+ const { noSniff = true, frameguard = "DENY", hsts = {
25
+ maxAge: 31536e3,
26
+ includeSubDomains: true
27
+ }, dnsPrefetch = false, hidePoweredBy = true, referrerPolicy = "no-referrer", xssFilter = true, contentSecurityPolicy = false } = options;
28
+ return (req, res, next) => {
29
+ if (hidePoweredBy) res.removeHeader("X-Powered-By");
30
+ if (noSniff) res.setHeader("X-Content-Type-Options", "nosniff");
31
+ if (frameguard) res.setHeader("X-Frame-Options", frameguard);
32
+ if (xssFilter) res.setHeader("X-XSS-Protection", "0");
33
+ if (referrerPolicy) res.setHeader("Referrer-Policy", referrerPolicy);
34
+ if (!dnsPrefetch) res.setHeader("X-DNS-Prefetch-Control", "off");
35
+ if (hsts) {
36
+ let value = `max-age=${hsts.maxAge ?? 31536e3}`;
37
+ if (hsts.includeSubDomains) value += "; includeSubDomains";
38
+ if (hsts.preload) value += "; preload";
39
+ res.setHeader("Strict-Transport-Security", value);
40
+ }
41
+ if (contentSecurityPolicy) {
42
+ const policy = typeof contentSecurityPolicy === "object" ? Object.entries(contentSecurityPolicy).map(([key, values]) => `${key} ${values.join(" ")}`).join("; ") : "default-src 'self'";
43
+ res.setHeader("Content-Security-Policy", policy);
44
+ }
45
+ next();
46
+ };
47
+ }
48
+ //#endregion
49
+ export { helmet };
50
+
51
+ //# sourceMappingURL=helmet.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helmet.mjs","names":[],"sources":["../../../src/http/middleware/helmet.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface HelmetOptions {\n /** Set Content-Security-Policy header (default: self-only policy) */\n contentSecurityPolicy?: boolean | Record<string, string[]>\n /** Set X-Content-Type-Options: nosniff (default: true) */\n noSniff?: boolean\n /** Set X-Frame-Options (default: 'DENY') */\n frameguard?: false | 'DENY' | 'SAMEORIGIN'\n /** Set Strict-Transport-Security (default: max-age=31536000; includeSubDomains) */\n hsts?: false | { maxAge?: number; includeSubDomains?: boolean; preload?: boolean }\n /** Set X-DNS-Prefetch-Control (default: off) */\n dnsPrefetch?: boolean\n /** Remove X-Powered-By header (default: true) */\n hidePoweredBy?: boolean\n /** Set Referrer-Policy (default: 'no-referrer') */\n referrerPolicy?: false | string\n /** Set X-XSS-Protection: 0 (default: true — disables legacy XSS auditor) */\n xssFilter?: boolean\n}\n\n/**\n * Security headers middleware. Lightweight alternative to the `helmet` npm package\n * with sensible defaults for API servers.\n *\n * @example\n * ```ts\n * bootstrap({\n * middleware: [helmet(), requestId(), express.json()],\n * })\n * ```\n */\nexport function helmet(options: HelmetOptions = {}) {\n const {\n noSniff = true,\n frameguard = 'DENY',\n hsts = { maxAge: 31536000, includeSubDomains: true },\n dnsPrefetch = false,\n hidePoweredBy = true,\n referrerPolicy = 'no-referrer',\n xssFilter = true,\n contentSecurityPolicy = false,\n } = options\n\n return (req: Request, res: Response, next: NextFunction) => {\n if (hidePoweredBy) res.removeHeader('X-Powered-By')\n if (noSniff) res.setHeader('X-Content-Type-Options', 'nosniff')\n if (frameguard) res.setHeader('X-Frame-Options', frameguard)\n if (xssFilter) res.setHeader('X-XSS-Protection', '0')\n if (referrerPolicy) res.setHeader('Referrer-Policy', referrerPolicy)\n if (!dnsPrefetch) res.setHeader('X-DNS-Prefetch-Control', 'off')\n\n if (hsts) {\n const maxAge = hsts.maxAge ?? 31536000\n let value = `max-age=${maxAge}`\n if (hsts.includeSubDomains) value += '; includeSubDomains'\n if (hsts.preload) value += '; preload'\n res.setHeader('Strict-Transport-Security', value)\n }\n\n if (contentSecurityPolicy) {\n const policy =\n typeof contentSecurityPolicy === 'object'\n ? Object.entries(contentSecurityPolicy)\n .map(([key, values]) => `${key} ${values.join(' ')}`)\n .join('; ')\n : \"default-src 'self'\"\n res.setHeader('Content-Security-Policy', policy)\n }\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,OAAO,UAAyB,EAAE,EAAE;CAClD,MAAM,EACJ,UAAU,MACV,aAAa,QACb,OAAO;EAAE,QAAQ;EAAU,mBAAmB;EAAM,EACpD,cAAc,OACd,gBAAgB,MAChB,iBAAiB,eACjB,YAAY,MACZ,wBAAwB,UACtB;AAEJ,SAAQ,KAAc,KAAe,SAAuB;AAC1D,MAAI,cAAe,KAAI,aAAa,eAAe;AACnD,MAAI,QAAS,KAAI,UAAU,0BAA0B,UAAU;AAC/D,MAAI,WAAY,KAAI,UAAU,mBAAmB,WAAW;AAC5D,MAAI,UAAW,KAAI,UAAU,oBAAoB,IAAI;AACrD,MAAI,eAAgB,KAAI,UAAU,mBAAmB,eAAe;AACpE,MAAI,CAAC,YAAa,KAAI,UAAU,0BAA0B,MAAM;AAEhE,MAAI,MAAM;GAER,IAAI,QAAQ,WADG,KAAK,UAAU;AAE9B,OAAI,KAAK,kBAAmB,UAAS;AACrC,OAAI,KAAK,QAAS,UAAS;AAC3B,OAAI,UAAU,6BAA6B,MAAM;;AAGnD,MAAI,uBAAuB;GACzB,MAAM,SACJ,OAAO,0BAA0B,WAC7B,OAAO,QAAQ,sBAAsB,CAClC,KAAK,CAAC,KAAK,YAAY,GAAG,IAAI,GAAG,OAAO,KAAK,IAAI,GAAG,CACpD,KAAK,KAAK,GACb;AACN,OAAI,UAAU,2BAA2B,OAAO;;AAGlD,QAAM"}
@@ -0,0 +1,56 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/rate-limit.d.ts
5
+ interface RateLimitStore {
6
+ increment(key: string): Promise<{
7
+ totalHits: number;
8
+ resetTime: Date;
9
+ }>;
10
+ decrement(key: string): Promise<void>;
11
+ reset(key: string): Promise<void>;
12
+ }
13
+ interface RateLimitOptions {
14
+ /** Maximum number of requests per window (default: 100) */
15
+ max?: number;
16
+ /** Time window in milliseconds (default: 60_000) */
17
+ windowMs?: number;
18
+ /** Response message when rate limit is exceeded (default: 'Too Many Requests') */
19
+ message?: string;
20
+ /** HTTP status code when rate limit is exceeded (default: 429) */
21
+ statusCode?: number;
22
+ /** Function to generate the key for rate limiting (default: req.ip) */
23
+ keyGenerator?: (req: Request) => string;
24
+ /** Whether to send rate limit headers (default: true) */
25
+ headers?: boolean;
26
+ /** Custom store implementation (default: in-memory Map) */
27
+ store?: RateLimitStore;
28
+ /** Function to skip rate limiting for certain requests */
29
+ skip?: (req: Request) => boolean;
30
+ /** Paths to exclude from rate limiting */
31
+ skipPaths?: string[];
32
+ }
33
+ /**
34
+ * Rate limiting middleware.
35
+ *
36
+ * Limits the number of requests a client can make within a time window.
37
+ * Uses an in-memory store by default, but accepts a custom store for
38
+ * distributed deployments (e.g. Redis).
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * import { rateLimit } from '@forinda/kickjs-http'
43
+ *
44
+ * bootstrap({
45
+ * modules,
46
+ * middleware: [
47
+ * rateLimit({ max: 100, windowMs: 60_000 }),
48
+ * // ... other middleware
49
+ * ],
50
+ * })
51
+ * ```
52
+ */
53
+ declare function rateLimit(options?: RateLimitOptions): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
54
+ //#endregion
55
+ export { RateLimitOptions, RateLimitStore, rateLimit };
56
+ //# sourceMappingURL=rate-limit.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.d.mts","names":[],"sources":["../../../src/http/middleware/rate-limit.ts"],"mappings":";;;;UAEiB,cAAA;EACf,SAAA,CAAU,GAAA,WAAc,OAAA;IAAU,SAAA;IAAmB,SAAA,EAAW,IAAA;EAAA;EAChE,SAAA,CAAU,GAAA,WAAc,OAAA;EACxB,KAAA,CAAM,GAAA,WAAc,OAAA;AAAA;AAAA,UAGL,gBAAA;EAHY;EAK3B,GAAA;EAPA;EASA,QAAA;EATwB;EAWxB,OAAA;EAXqD;EAarD,UAAA;EAZA;EAcA,YAAA,IAAgB,GAAA,EAAK,OAAA;EAdG;EAgBxB,OAAA;EAfM;EAiBN,KAAA,GAAQ,cAAA;EAjBmB;EAmB3B,IAAA,IAAQ,GAAA,EAAK,OAAA;EAhBE;EAkBf,SAAA;AAAA;;;;;;;;;;;;;;;;;;;;;iBA4Ec,SAAA,CAAU,OAAA,GAAS,gBAAA,IAWnB,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAY,OAAA,QAAA,QAAA,MAAA,MAAA"}
@@ -0,0 +1,101 @@
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/rate-limit.ts
12
+ var MemoryStore = class {
13
+ hits = /* @__PURE__ */ new Map();
14
+ cleanupTimer;
15
+ constructor(windowMs) {
16
+ this.windowMs = windowMs;
17
+ this.cleanupTimer = setInterval(() => this.cleanup(), windowMs);
18
+ if (this.cleanupTimer.unref) this.cleanupTimer.unref();
19
+ }
20
+ async increment(key) {
21
+ const now = Date.now();
22
+ const entry = this.hits.get(key);
23
+ if (entry && entry.resetTime.getTime() > now) {
24
+ entry.totalHits++;
25
+ return {
26
+ totalHits: entry.totalHits,
27
+ resetTime: entry.resetTime
28
+ };
29
+ }
30
+ const resetTime = new Date(now + this.windowMs);
31
+ const newEntry = {
32
+ totalHits: 1,
33
+ resetTime
34
+ };
35
+ this.hits.set(key, newEntry);
36
+ return {
37
+ totalHits: 1,
38
+ resetTime
39
+ };
40
+ }
41
+ async decrement(key) {
42
+ const entry = this.hits.get(key);
43
+ if (entry && entry.totalHits > 0) entry.totalHits--;
44
+ }
45
+ async reset(key) {
46
+ this.hits.delete(key);
47
+ }
48
+ cleanup() {
49
+ const now = Date.now();
50
+ for (const [key, entry] of this.hits) if (entry.resetTime.getTime() <= now) this.hits.delete(key);
51
+ }
52
+ };
53
+ /**
54
+ * Rate limiting middleware.
55
+ *
56
+ * Limits the number of requests a client can make within a time window.
57
+ * Uses an in-memory store by default, but accepts a custom store for
58
+ * distributed deployments (e.g. Redis).
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * import { rateLimit } from '@forinda/kickjs-http'
63
+ *
64
+ * bootstrap({
65
+ * modules,
66
+ * middleware: [
67
+ * rateLimit({ max: 100, windowMs: 60_000 }),
68
+ * // ... other middleware
69
+ * ],
70
+ * })
71
+ * ```
72
+ */
73
+ function rateLimit(options = {}) {
74
+ const max = options.max ?? 100;
75
+ const windowMs = options.windowMs ?? 6e4;
76
+ const message = options.message ?? "Too Many Requests";
77
+ const statusCode = options.statusCode ?? 429;
78
+ const keyGenerator = options.keyGenerator ?? ((req) => req.ip ?? "127.0.0.1");
79
+ const sendHeaders = options.headers ?? true;
80
+ const store = options.store ?? new MemoryStore(windowMs);
81
+ const skip = options.skip;
82
+ const skipPaths = new Set(options.skipPaths ?? []);
83
+ return async (req, res, next) => {
84
+ if (skipPaths.has(req.path)) return next();
85
+ if (skip && skip(req)) return next();
86
+ const key = keyGenerator(req);
87
+ const { totalHits, resetTime } = await store.increment(key);
88
+ const remaining = Math.max(0, max - totalHits);
89
+ if (sendHeaders) {
90
+ res.setHeader("RateLimit-Limit", max);
91
+ res.setHeader("RateLimit-Remaining", remaining);
92
+ res.setHeader("RateLimit-Reset", Math.ceil(resetTime.getTime() / 1e3));
93
+ }
94
+ if (totalHits > max) return res.status(statusCode).json({ message });
95
+ next();
96
+ };
97
+ }
98
+ //#endregion
99
+ export { rateLimit };
100
+
101
+ //# sourceMappingURL=rate-limit.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../../src/http/middleware/rate-limit.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface RateLimitStore {\n increment(key: string): Promise<{ totalHits: number; resetTime: Date }>\n decrement(key: string): Promise<void>\n reset(key: string): Promise<void>\n}\n\nexport interface RateLimitOptions {\n /** Maximum number of requests per window (default: 100) */\n max?: number\n /** Time window in milliseconds (default: 60_000) */\n windowMs?: number\n /** Response message when rate limit is exceeded (default: 'Too Many Requests') */\n message?: string\n /** HTTP status code when rate limit is exceeded (default: 429) */\n statusCode?: number\n /** Function to generate the key for rate limiting (default: req.ip) */\n keyGenerator?: (req: Request) => string\n /** Whether to send rate limit headers (default: true) */\n headers?: boolean\n /** Custom store implementation (default: in-memory Map) */\n store?: RateLimitStore\n /** Function to skip rate limiting for certain requests */\n skip?: (req: Request) => boolean\n /** Paths to exclude from rate limiting */\n skipPaths?: string[]\n}\n\ninterface MemoryStoreEntry {\n totalHits: number\n resetTime: Date\n}\n\nclass MemoryStore implements RateLimitStore {\n private hits = new Map<string, MemoryStoreEntry>()\n private cleanupTimer: ReturnType<typeof setInterval>\n\n constructor(private windowMs: number) {\n this.cleanupTimer = setInterval(() => this.cleanup(), windowMs)\n // Allow the process to exit without waiting for the timer\n if (this.cleanupTimer.unref) {\n this.cleanupTimer.unref()\n }\n }\n\n async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {\n const now = Date.now()\n const entry = this.hits.get(key)\n\n if (entry && entry.resetTime.getTime() > now) {\n entry.totalHits++\n return { totalHits: entry.totalHits, resetTime: entry.resetTime }\n }\n\n const resetTime = new Date(now + this.windowMs)\n const newEntry: MemoryStoreEntry = { totalHits: 1, resetTime }\n this.hits.set(key, newEntry)\n return { totalHits: 1, resetTime }\n }\n\n async decrement(key: string): Promise<void> {\n const entry = this.hits.get(key)\n if (entry && entry.totalHits > 0) {\n entry.totalHits--\n }\n }\n\n async reset(key: string): Promise<void> {\n this.hits.delete(key)\n }\n\n private cleanup(): void {\n const now = Date.now()\n for (const [key, entry] of this.hits) {\n if (entry.resetTime.getTime() <= now) {\n this.hits.delete(key)\n }\n }\n }\n}\n\n/**\n * Rate limiting middleware.\n *\n * Limits the number of requests a client can make within a time window.\n * Uses an in-memory store by default, but accepts a custom store for\n * distributed deployments (e.g. Redis).\n *\n * @example\n * ```ts\n * import { rateLimit } from '@forinda/kickjs-http'\n *\n * bootstrap({\n * modules,\n * middleware: [\n * rateLimit({ max: 100, windowMs: 60_000 }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function rateLimit(options: RateLimitOptions = {}) {\n const max = options.max ?? 100\n const windowMs = options.windowMs ?? 60_000\n const message = options.message ?? 'Too Many Requests'\n const statusCode = options.statusCode ?? 429\n const keyGenerator = options.keyGenerator ?? ((req: Request) => req.ip ?? '127.0.0.1')\n const sendHeaders = options.headers ?? true\n const store = options.store ?? new MemoryStore(windowMs)\n const skip = options.skip\n const skipPaths = new Set(options.skipPaths ?? [])\n\n return async (req: Request, res: Response, next: NextFunction) => {\n // Skip if path is in the skip list\n if (skipPaths.has(req.path)) {\n return next()\n }\n\n // Skip if the skip function returns true\n if (skip && skip(req)) {\n return next()\n }\n\n const key = keyGenerator(req)\n const { totalHits, resetTime } = await store.increment(key)\n const remaining = Math.max(0, max - totalHits)\n\n if (sendHeaders) {\n res.setHeader('RateLimit-Limit', max)\n res.setHeader('RateLimit-Remaining', remaining)\n res.setHeader('RateLimit-Reset', Math.ceil(resetTime.getTime() / 1000))\n }\n\n if (totalHits > max) {\n return res.status(statusCode).json({ message })\n }\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;AAkCA,IAAM,cAAN,MAA4C;CAC1C,uBAAe,IAAI,KAA+B;CAClD;CAEA,YAAY,UAA0B;AAAlB,OAAA,WAAA;AAClB,OAAK,eAAe,kBAAkB,KAAK,SAAS,EAAE,SAAS;AAE/D,MAAI,KAAK,aAAa,MACpB,MAAK,aAAa,OAAO;;CAI7B,MAAM,UAAU,KAA8D;EAC5E,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,QAAQ,KAAK,KAAK,IAAI,IAAI;AAEhC,MAAI,SAAS,MAAM,UAAU,SAAS,GAAG,KAAK;AAC5C,SAAM;AACN,UAAO;IAAE,WAAW,MAAM;IAAW,WAAW,MAAM;IAAW;;EAGnE,MAAM,YAAY,IAAI,KAAK,MAAM,KAAK,SAAS;EAC/C,MAAM,WAA6B;GAAE,WAAW;GAAG;GAAW;AAC9D,OAAK,KAAK,IAAI,KAAK,SAAS;AAC5B,SAAO;GAAE,WAAW;GAAG;GAAW;;CAGpC,MAAM,UAAU,KAA4B;EAC1C,MAAM,QAAQ,KAAK,KAAK,IAAI,IAAI;AAChC,MAAI,SAAS,MAAM,YAAY,EAC7B,OAAM;;CAIV,MAAM,MAAM,KAA4B;AACtC,OAAK,KAAK,OAAO,IAAI;;CAGvB,UAAwB;EACtB,MAAM,MAAM,KAAK,KAAK;AACtB,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,KAC9B,KAAI,MAAM,UAAU,SAAS,IAAI,IAC/B,MAAK,KAAK,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;AA0B7B,SAAgB,UAAU,UAA4B,EAAE,EAAE;CACxD,MAAM,MAAM,QAAQ,OAAO;CAC3B,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,eAAe,QAAQ,kBAAkB,QAAiB,IAAI,MAAM;CAC1E,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,QAAQ,QAAQ,SAAS,IAAI,YAAY,SAAS;CACxD,MAAM,OAAO,QAAQ;CACrB,MAAM,YAAY,IAAI,IAAI,QAAQ,aAAa,EAAE,CAAC;AAElD,QAAO,OAAO,KAAc,KAAe,SAAuB;AAEhE,MAAI,UAAU,IAAI,IAAI,KAAK,CACzB,QAAO,MAAM;AAIf,MAAI,QAAQ,KAAK,IAAI,CACnB,QAAO,MAAM;EAGf,MAAM,MAAM,aAAa,IAAI;EAC7B,MAAM,EAAE,WAAW,cAAc,MAAM,MAAM,UAAU,IAAI;EAC3D,MAAM,YAAY,KAAK,IAAI,GAAG,MAAM,UAAU;AAE9C,MAAI,aAAa;AACf,OAAI,UAAU,mBAAmB,IAAI;AACrC,OAAI,UAAU,uBAAuB,UAAU;AAC/C,OAAI,UAAU,mBAAmB,KAAK,KAAK,UAAU,SAAS,GAAG,IAAK,CAAC;;AAGzE,MAAI,YAAY,IACd,QAAO,IAAI,OAAO,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;AAGjD,QAAM"}
@@ -0,0 +1,10 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/request-id.d.ts
5
+ declare const REQUEST_ID_HEADER = "x-request-id";
6
+ /** Middleware that generates or propagates a unique request ID */
7
+ declare function requestId(): (req: Request, res: Response, next: NextFunction) => void;
8
+ //#endregion
9
+ export { REQUEST_ID_HEADER, requestId };
10
+ //# sourceMappingURL=request-id.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-id.d.mts","names":[],"sources":["../../../src/http/middleware/request-id.ts"],"mappings":";;;;cAGa,iBAAA;;iBAGG,SAAA,CAAA,IACN,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
@@ -0,0 +1,26 @@
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 { randomUUID } from "node:crypto";
12
+ //#region src/http/middleware/request-id.ts
13
+ const REQUEST_ID_HEADER = "x-request-id";
14
+ /** Middleware that generates or propagates a unique request ID */
15
+ function requestId() {
16
+ return (req, res, next) => {
17
+ const id = req.headers["x-request-id"] || randomUUID();
18
+ req.requestId = id;
19
+ res.setHeader(REQUEST_ID_HEADER, id);
20
+ next();
21
+ };
22
+ }
23
+ //#endregion
24
+ export { REQUEST_ID_HEADER, requestId };
25
+
26
+ //# sourceMappingURL=request-id.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-id.mjs","names":[],"sources":["../../../src/http/middleware/request-id.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport const REQUEST_ID_HEADER = 'x-request-id'\n\n/** Middleware that generates or propagates a unique request ID */\nexport function requestId() {\n return (req: Request, res: Response, next: NextFunction) => {\n const id = (req.headers[REQUEST_ID_HEADER] as string) || randomUUID()\n // Attach to req as a dedicated property (don't mutate headers)\n ;(req as any).requestId = id\n res.setHeader(REQUEST_ID_HEADER, id)\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;;AAGA,MAAa,oBAAoB;;AAGjC,SAAgB,YAAY;AAC1B,SAAQ,KAAc,KAAe,SAAuB;EAC1D,MAAM,KAAM,IAAI,QAAA,mBAAyC,YAAY;AAEnE,MAAY,YAAY;AAC1B,MAAI,UAAU,mBAAmB,GAAG;AACpC,QAAM"}
@@ -0,0 +1,32 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/request-logger.d.ts
5
+ interface RequestLoggerOptions {
6
+ /** Logger name (default: 'HTTP') */
7
+ name?: string;
8
+ /** Log level for successful requests (default: 'info') */
9
+ level?: 'info' | 'debug' | 'trace';
10
+ /** Skip logging for paths matching these prefixes (e.g. ['/health', '/_debug']) */
11
+ skip?: string[];
12
+ }
13
+ /**
14
+ * Middleware that logs every request with method, URL, status, duration, and request ID.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * bootstrap({
19
+ * middleware: [requestId(), requestLogger(), express.json()],
20
+ * })
21
+ * ```
22
+ *
23
+ * Output:
24
+ * ```
25
+ * [HTTP] GET /api/v1/users 200 12ms req-abc123
26
+ * [HTTP] POST /api/v1/users 201 45ms req-def456
27
+ * ```
28
+ */
29
+ declare function requestLogger(options?: RequestLoggerOptions): (req: Request, res: Response, next: NextFunction) => void;
30
+ //#endregion
31
+ export { RequestLoggerOptions, requestLogger };
32
+ //# sourceMappingURL=request-logger.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-logger.d.mts","names":[],"sources":["../../../src/http/middleware/request-logger.ts"],"mappings":";;;;UAGiB,oBAAA;;EAEf,IAAA;EAFmC;EAInC,KAAA;EAJmC;EAMnC,IAAA;AAAA;;;;AAmBF;;;;;;;;;;;;;iBAAgB,aAAA,CAAc,OAAA,GAAS,oBAAA,IAK7B,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
@@ -0,0 +1,49 @@
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 { createLogger } from "../../core/logger.mjs";
12
+ import "../../core-BL_H8fEZ.mjs";
13
+ //#region src/http/middleware/request-logger.ts
14
+ /**
15
+ * Middleware that logs every request with method, URL, status, duration, and request ID.
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * bootstrap({
20
+ * middleware: [requestId(), requestLogger(), express.json()],
21
+ * })
22
+ * ```
23
+ *
24
+ * Output:
25
+ * ```
26
+ * [HTTP] GET /api/v1/users 200 12ms req-abc123
27
+ * [HTTP] POST /api/v1/users 201 45ms req-def456
28
+ * ```
29
+ */
30
+ function requestLogger(options = {}) {
31
+ const log = createLogger(options.name ?? "HTTP");
32
+ const level = options.level ?? "info";
33
+ const skip = options.skip ?? [];
34
+ return (req, res, next) => {
35
+ if (skip.some((prefix) => req.path.startsWith(prefix))) return next();
36
+ const start = Date.now();
37
+ res.on("finish", () => {
38
+ const duration = Date.now() - start;
39
+ const requestId = req.requestId || req.headers["x-request-id"] || "-";
40
+ const status = res.statusCode;
41
+ log[level](`${req.method} ${req.originalUrl} ${status} ${duration}ms ${requestId}`);
42
+ });
43
+ next();
44
+ };
45
+ }
46
+ //#endregion
47
+ export { requestLogger };
48
+
49
+ //# sourceMappingURL=request-logger.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-logger.mjs","names":[],"sources":["../../../src/http/middleware/request-logger.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport { createLogger } from '../../core'\n\nexport interface RequestLoggerOptions {\n /** Logger name (default: 'HTTP') */\n name?: string\n /** Log level for successful requests (default: 'info') */\n level?: 'info' | 'debug' | 'trace'\n /** Skip logging for paths matching these prefixes (e.g. ['/health', '/_debug']) */\n skip?: string[]\n}\n\n/**\n * Middleware that logs every request with method, URL, status, duration, and request ID.\n *\n * @example\n * ```ts\n * bootstrap({\n * middleware: [requestId(), requestLogger(), express.json()],\n * })\n * ```\n *\n * Output:\n * ```\n * [HTTP] GET /api/v1/users 200 12ms req-abc123\n * [HTTP] POST /api/v1/users 201 45ms req-def456\n * ```\n */\nexport function requestLogger(options: RequestLoggerOptions = {}) {\n const log = createLogger(options.name ?? 'HTTP')\n const level = options.level ?? 'info'\n const skip = options.skip ?? []\n\n return (req: Request, res: Response, next: NextFunction) => {\n // Skip logging for excluded paths\n if (skip.some((prefix) => req.path.startsWith(prefix))) {\n return next()\n }\n\n const start = Date.now()\n\n res.on('finish', () => {\n const duration = Date.now() - start\n const requestId = (req as any).requestId || req.headers['x-request-id'] || '-'\n const status = res.statusCode\n\n log[level](`${req.method} ${req.originalUrl} ${status} ${duration}ms ${requestId}`)\n })\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,cAAc,UAAgC,EAAE,EAAE;CAChE,MAAM,MAAM,aAAa,QAAQ,QAAQ,OAAO;CAChD,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,OAAO,QAAQ,QAAQ,EAAE;AAE/B,SAAQ,KAAc,KAAe,SAAuB;AAE1D,MAAI,KAAK,MAAM,WAAW,IAAI,KAAK,WAAW,OAAO,CAAC,CACpD,QAAO,MAAM;EAGf,MAAM,QAAQ,KAAK,KAAK;AAExB,MAAI,GAAG,gBAAgB;GACrB,MAAM,WAAW,KAAK,KAAK,GAAG;GAC9B,MAAM,YAAa,IAAY,aAAa,IAAI,QAAQ,mBAAmB;GAC3E,MAAM,SAAS,IAAI;AAEnB,OAAI,OAAO,GAAG,IAAI,OAAO,GAAG,IAAI,YAAY,GAAG,OAAO,GAAG,SAAS,KAAK,YAAY;IACnF;AAEF,QAAM"}
@@ -0,0 +1,67 @@
1
+
2
+ import { NextFunction, Request, Response } from "express";
3
+
4
+ //#region src/http/middleware/session.d.ts
5
+ interface SessionData {
6
+ [key: string]: unknown;
7
+ }
8
+ interface SessionStore {
9
+ get(sid: string): Promise<SessionData | null>;
10
+ set(sid: string, data: SessionData, maxAge: number): Promise<void>;
11
+ destroy(sid: string): Promise<void>;
12
+ touch?(sid: string, maxAge: number): Promise<void>;
13
+ }
14
+ interface Session {
15
+ id: string;
16
+ data: SessionData;
17
+ regenerate(): Promise<void>;
18
+ destroy(): Promise<void>;
19
+ save(): Promise<void>;
20
+ }
21
+ interface SessionOptions {
22
+ /** Secret used to sign the session cookie (required) */
23
+ secret: string;
24
+ /** Cookie name (default: 'kick.sid') */
25
+ cookieName?: string;
26
+ /** Session max age in milliseconds (default: 86400000 = 24h) */
27
+ maxAge?: number;
28
+ /** Reset maxAge on every response (default: false) */
29
+ rolling?: boolean;
30
+ /** Save new sessions that have not been modified (default: true) */
31
+ saveUninitialized?: boolean;
32
+ /** Cookie options */
33
+ cookie?: {
34
+ httpOnly?: boolean;
35
+ secure?: boolean;
36
+ sameSite?: 'strict' | 'lax' | 'none';
37
+ path?: string;
38
+ domain?: string;
39
+ };
40
+ /** Custom session store (default: in-memory store with TTL cleanup) */
41
+ store?: SessionStore;
42
+ }
43
+ /**
44
+ * Session management middleware.
45
+ *
46
+ * Attaches a `req.session` object with `id`, `data`, `regenerate()`,
47
+ * `destroy()`, and `save()` methods. Session IDs are signed with
48
+ * HMAC-SHA256 to prevent cookie tampering.
49
+ *
50
+ * @example
51
+ * ```ts
52
+ * import { session } from '@forinda/kickjs-http'
53
+ *
54
+ * bootstrap({
55
+ * modules,
56
+ * middleware: [
57
+ * cookieParser(),
58
+ * session({ secret: process.env.SESSION_SECRET! }),
59
+ * // ... other middleware
60
+ * ],
61
+ * })
62
+ * ```
63
+ */
64
+ declare function session(options: SessionOptions): (req: Request, res: Response, next: NextFunction) => Promise<void>;
65
+ //#endregion
66
+ export { Session, SessionData, SessionOptions, SessionStore, session };
67
+ //# sourceMappingURL=session.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.mts","names":[],"sources":["../../../src/http/middleware/session.ts"],"mappings":";;;;UAGiB,WAAA;EAAA,CACd,GAAA;AAAA;AAAA,UAGc,YAAA;EACf,GAAA,CAAI,GAAA,WAAc,OAAA,CAAQ,WAAA;EAC1B,GAAA,CAAI,GAAA,UAAa,IAAA,EAAM,WAAA,EAAa,MAAA,WAAiB,OAAA;EACrD,OAAA,CAAQ,GAAA,WAAc,OAAA;EACtB,KAAA,EAAO,GAAA,UAAa,MAAA,WAAiB,OAAA;AAAA;AAAA,UAGtB,OAAA;EACf,EAAA;EACA,IAAA,EAAM,WAAA;EACN,UAAA,IAAc,OAAA;EACd,OAAA,IAAW,OAAA;EACX,IAAA,IAAQ,OAAA;AAAA;AAAA,UAGO,cAAA;EAX6B;EAa5C,MAAA;EAhBI;EAkBJ,UAAA;EAlB0B;EAoB1B,MAAA;EAnBI;EAqBJ,OAAA;EArBiB;EAuBjB,iBAAA;EAvBqD;EAyBrD,MAAA;IACE,QAAA;IACA,MAAA;IACA,QAAA;IACA,IAAA;IACA,MAAA;EAAA;EA5B0C;EA+B5C,KAAA,GAAQ,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;AApBV;;iBAwHgB,OAAA,CAAQ,OAAA,EAAS,cAAA,IAoBjB,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAY,OAAA"}