@catbee/utils 0.0.7 → 0.0.8-next.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 (285) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +26 -1
  3. package/build/index.cjs +6888 -0
  4. package/build/index.d.ts +5242 -0
  5. package/build/index.mjs +6615 -0
  6. package/package.json +26 -99
  7. package/build/esm/config.d.ts +0 -122
  8. package/build/esm/config.js +0 -133
  9. package/build/esm/config.js.map +0 -1
  10. package/build/esm/index.d.ts +0 -27
  11. package/build/esm/index.js +0 -50
  12. package/build/esm/index.js.map +0 -1
  13. package/build/esm/servers/server.builder.d.ts +0 -508
  14. package/build/esm/servers/server.builder.js +0 -702
  15. package/build/esm/servers/server.builder.js.map +0 -1
  16. package/build/esm/servers/server.d.ts +0 -256
  17. package/build/esm/servers/server.js +0 -1201
  18. package/build/esm/servers/server.js.map +0 -1
  19. package/build/esm/types/api-response.d.ts +0 -152
  20. package/build/esm/types/api-response.js +0 -34
  21. package/build/esm/types/api-response.js.map +0 -1
  22. package/build/esm/types/index.d.ts +0 -125
  23. package/build/esm/types/index.js +0 -25
  24. package/build/esm/types/index.js.map +0 -1
  25. package/build/esm/types/server.d.ts +0 -268
  26. package/build/esm/types/server.js +0 -25
  27. package/build/esm/types/server.js.map +0 -1
  28. package/build/esm/utils/array.utils.d.ts +0 -168
  29. package/build/esm/utils/array.utils.js +0 -382
  30. package/build/esm/utils/array.utils.js.map +0 -1
  31. package/build/esm/utils/async.utils.d.ts +0 -265
  32. package/build/esm/utils/async.utils.js +0 -896
  33. package/build/esm/utils/async.utils.js.map +0 -1
  34. package/build/esm/utils/cache.utils.d.ts +0 -153
  35. package/build/esm/utils/cache.utils.js +0 -499
  36. package/build/esm/utils/cache.utils.js.map +0 -1
  37. package/build/esm/utils/context-store.utils.d.ts +0 -189
  38. package/build/esm/utils/context-store.utils.js +0 -307
  39. package/build/esm/utils/context-store.utils.js.map +0 -1
  40. package/build/esm/utils/crypto.utils.d.ts +0 -160
  41. package/build/esm/utils/crypto.utils.js +0 -375
  42. package/build/esm/utils/crypto.utils.js.map +0 -1
  43. package/build/esm/utils/date.utils.d.ts +0 -159
  44. package/build/esm/utils/date.utils.js +0 -389
  45. package/build/esm/utils/date.utils.js.map +0 -1
  46. package/build/esm/utils/decorators.utils.d.ts +0 -315
  47. package/build/esm/utils/decorators.utils.js +0 -666
  48. package/build/esm/utils/decorators.utils.js.map +0 -1
  49. package/build/esm/utils/dir.utils.d.ts +0 -196
  50. package/build/esm/utils/dir.utils.js +0 -998
  51. package/build/esm/utils/dir.utils.js.map +0 -1
  52. package/build/esm/utils/env.utils.d.ts +0 -377
  53. package/build/esm/utils/env.utils.js +0 -873
  54. package/build/esm/utils/env.utils.js.map +0 -1
  55. package/build/esm/utils/exception.utils.d.ts +0 -230
  56. package/build/esm/utils/exception.utils.js +0 -559
  57. package/build/esm/utils/exception.utils.js.map +0 -1
  58. package/build/esm/utils/fs.utils.d.ts +0 -164
  59. package/build/esm/utils/fs.utils.js +0 -580
  60. package/build/esm/utils/fs.utils.js.map +0 -1
  61. package/build/esm/utils/http-status-codes.d.ts +0 -266
  62. package/build/esm/utils/http-status-codes.js +0 -295
  63. package/build/esm/utils/http-status-codes.js.map +0 -1
  64. package/build/esm/utils/id.utils.d.ts +0 -36
  65. package/build/esm/utils/id.utils.js +0 -87
  66. package/build/esm/utils/id.utils.js.map +0 -1
  67. package/build/esm/utils/logger.utils.d.ts +0 -160
  68. package/build/esm/utils/logger.utils.js +0 -341
  69. package/build/esm/utils/logger.utils.js.map +0 -1
  70. package/build/esm/utils/middleware.utils.d.ts +0 -83
  71. package/build/esm/utils/middleware.utils.js +0 -206
  72. package/build/esm/utils/middleware.utils.js.map +0 -1
  73. package/build/esm/utils/obj.utils.d.ts +0 -124
  74. package/build/esm/utils/obj.utils.js +0 -519
  75. package/build/esm/utils/obj.utils.js.map +0 -1
  76. package/build/esm/utils/performance.utils.d.ts +0 -136
  77. package/build/esm/utils/performance.utils.js +0 -376
  78. package/build/esm/utils/performance.utils.js.map +0 -1
  79. package/build/esm/utils/request.utils.d.ts +0 -86
  80. package/build/esm/utils/request.utils.js +0 -223
  81. package/build/esm/utils/request.utils.js.map +0 -1
  82. package/build/esm/utils/response.utils.d.ts +0 -163
  83. package/build/esm/utils/response.utils.js +0 -284
  84. package/build/esm/utils/response.utils.js.map +0 -1
  85. package/build/esm/utils/stream.utils.d.ts +0 -88
  86. package/build/esm/utils/stream.utils.js +0 -284
  87. package/build/esm/utils/stream.utils.js.map +0 -1
  88. package/build/esm/utils/string.utils.d.ts +0 -93
  89. package/build/esm/utils/string.utils.js +0 -169
  90. package/build/esm/utils/string.utils.js.map +0 -1
  91. package/build/esm/utils/type.utils.d.ts +0 -90
  92. package/build/esm/utils/type.utils.js +0 -190
  93. package/build/esm/utils/type.utils.js.map +0 -1
  94. package/build/esm/utils/url.utils.d.ts +0 -141
  95. package/build/esm/utils/url.utils.js +0 -381
  96. package/build/esm/utils/url.utils.js.map +0 -1
  97. package/build/esm/utils/validate.utils.d.ts +0 -177
  98. package/build/esm/utils/validate.utils.js +0 -336
  99. package/build/esm/utils/validate.utils.js.map +0 -1
  100. package/build/esnext/config.d.ts +0 -122
  101. package/build/esnext/config.js +0 -133
  102. package/build/esnext/config.js.map +0 -1
  103. package/build/esnext/index.d.ts +0 -27
  104. package/build/esnext/index.js +0 -50
  105. package/build/esnext/index.js.map +0 -1
  106. package/build/esnext/servers/server.builder.d.ts +0 -508
  107. package/build/esnext/servers/server.builder.js +0 -657
  108. package/build/esnext/servers/server.builder.js.map +0 -1
  109. package/build/esnext/servers/server.d.ts +0 -256
  110. package/build/esnext/servers/server.js +0 -908
  111. package/build/esnext/servers/server.js.map +0 -1
  112. package/build/esnext/types/api-response.d.ts +0 -152
  113. package/build/esnext/types/api-response.js +0 -34
  114. package/build/esnext/types/api-response.js.map +0 -1
  115. package/build/esnext/types/index.d.ts +0 -125
  116. package/build/esnext/types/index.js +0 -25
  117. package/build/esnext/types/index.js.map +0 -1
  118. package/build/esnext/types/server.d.ts +0 -268
  119. package/build/esnext/types/server.js +0 -25
  120. package/build/esnext/types/server.js.map +0 -1
  121. package/build/esnext/utils/array.utils.d.ts +0 -168
  122. package/build/esnext/utils/array.utils.js +0 -345
  123. package/build/esnext/utils/array.utils.js.map +0 -1
  124. package/build/esnext/utils/async.utils.d.ts +0 -265
  125. package/build/esnext/utils/async.utils.js +0 -620
  126. package/build/esnext/utils/async.utils.js.map +0 -1
  127. package/build/esnext/utils/cache.utils.d.ts +0 -153
  128. package/build/esnext/utils/cache.utils.js +0 -293
  129. package/build/esnext/utils/cache.utils.js.map +0 -1
  130. package/build/esnext/utils/context-store.utils.d.ts +0 -189
  131. package/build/esnext/utils/context-store.utils.js +0 -289
  132. package/build/esnext/utils/context-store.utils.js.map +0 -1
  133. package/build/esnext/utils/crypto.utils.d.ts +0 -160
  134. package/build/esnext/utils/crypto.utils.js +0 -276
  135. package/build/esnext/utils/crypto.utils.js.map +0 -1
  136. package/build/esnext/utils/date.utils.d.ts +0 -159
  137. package/build/esnext/utils/date.utils.js +0 -384
  138. package/build/esnext/utils/date.utils.js.map +0 -1
  139. package/build/esnext/utils/decorators.utils.d.ts +0 -315
  140. package/build/esnext/utils/decorators.utils.js +0 -504
  141. package/build/esnext/utils/decorators.utils.js.map +0 -1
  142. package/build/esnext/utils/dir.utils.d.ts +0 -196
  143. package/build/esnext/utils/dir.utils.js +0 -477
  144. package/build/esnext/utils/dir.utils.js.map +0 -1
  145. package/build/esnext/utils/env.utils.d.ts +0 -377
  146. package/build/esnext/utils/env.utils.js +0 -785
  147. package/build/esnext/utils/env.utils.js.map +0 -1
  148. package/build/esnext/utils/exception.utils.d.ts +0 -230
  149. package/build/esnext/utils/exception.utils.js +0 -381
  150. package/build/esnext/utils/exception.utils.js.map +0 -1
  151. package/build/esnext/utils/fs.utils.d.ts +0 -164
  152. package/build/esnext/utils/fs.utils.js +0 -349
  153. package/build/esnext/utils/fs.utils.js.map +0 -1
  154. package/build/esnext/utils/http-status-codes.d.ts +0 -266
  155. package/build/esnext/utils/http-status-codes.js +0 -295
  156. package/build/esnext/utils/http-status-codes.js.map +0 -1
  157. package/build/esnext/utils/id.utils.d.ts +0 -36
  158. package/build/esnext/utils/id.utils.js +0 -84
  159. package/build/esnext/utils/id.utils.js.map +0 -1
  160. package/build/esnext/utils/logger.utils.d.ts +0 -160
  161. package/build/esnext/utils/logger.utils.js +0 -300
  162. package/build/esnext/utils/logger.utils.js.map +0 -1
  163. package/build/esnext/utils/middleware.utils.d.ts +0 -83
  164. package/build/esnext/utils/middleware.utils.js +0 -199
  165. package/build/esnext/utils/middleware.utils.js.map +0 -1
  166. package/build/esnext/utils/obj.utils.d.ts +0 -124
  167. package/build/esnext/utils/obj.utils.js +0 -413
  168. package/build/esnext/utils/obj.utils.js.map +0 -1
  169. package/build/esnext/utils/performance.utils.d.ts +0 -136
  170. package/build/esnext/utils/performance.utils.js +0 -271
  171. package/build/esnext/utils/performance.utils.js.map +0 -1
  172. package/build/esnext/utils/request.utils.d.ts +0 -86
  173. package/build/esnext/utils/request.utils.js +0 -186
  174. package/build/esnext/utils/request.utils.js.map +0 -1
  175. package/build/esnext/utils/response.utils.d.ts +0 -163
  176. package/build/esnext/utils/response.utils.js +0 -247
  177. package/build/esnext/utils/response.utils.js.map +0 -1
  178. package/build/esnext/utils/stream.utils.d.ts +0 -88
  179. package/build/esnext/utils/stream.utils.js +0 -210
  180. package/build/esnext/utils/stream.utils.js.map +0 -1
  181. package/build/esnext/utils/string.utils.d.ts +0 -93
  182. package/build/esnext/utils/string.utils.js +0 -165
  183. package/build/esnext/utils/string.utils.js.map +0 -1
  184. package/build/esnext/utils/type.utils.d.ts +0 -90
  185. package/build/esnext/utils/type.utils.js +0 -187
  186. package/build/esnext/utils/type.utils.js.map +0 -1
  187. package/build/esnext/utils/url.utils.d.ts +0 -141
  188. package/build/esnext/utils/url.utils.js +0 -304
  189. package/build/esnext/utils/url.utils.js.map +0 -1
  190. package/build/esnext/utils/validate.utils.d.ts +0 -177
  191. package/build/esnext/utils/validate.utils.js +0 -320
  192. package/build/esnext/utils/validate.utils.js.map +0 -1
  193. package/build/src/config.d.ts +0 -122
  194. package/build/src/config.js +0 -138
  195. package/build/src/config.js.map +0 -1
  196. package/build/src/index.d.ts +0 -27
  197. package/build/src/index.js +0 -69
  198. package/build/src/index.js.map +0 -1
  199. package/build/src/servers/server.builder.d.ts +0 -508
  200. package/build/src/servers/server.builder.js +0 -661
  201. package/build/src/servers/server.builder.js.map +0 -1
  202. package/build/src/servers/server.d.ts +0 -256
  203. package/build/src/servers/server.js +0 -948
  204. package/build/src/servers/server.js.map +0 -1
  205. package/build/src/types/api-response.d.ts +0 -152
  206. package/build/src/types/api-response.js +0 -37
  207. package/build/src/types/api-response.js.map +0 -1
  208. package/build/src/types/index.d.ts +0 -125
  209. package/build/src/types/index.js +0 -26
  210. package/build/src/types/index.js.map +0 -1
  211. package/build/src/types/server.d.ts +0 -268
  212. package/build/src/types/server.js +0 -26
  213. package/build/src/types/server.js.map +0 -1
  214. package/build/src/utils/array.utils.d.ts +0 -168
  215. package/build/src/utils/array.utils.js +0 -364
  216. package/build/src/utils/array.utils.js.map +0 -1
  217. package/build/src/utils/async.utils.d.ts +0 -265
  218. package/build/src/utils/async.utils.js +0 -641
  219. package/build/src/utils/async.utils.js.map +0 -1
  220. package/build/src/utils/cache.utils.d.ts +0 -153
  221. package/build/src/utils/cache.utils.js +0 -297
  222. package/build/src/utils/cache.utils.js.map +0 -1
  223. package/build/src/utils/context-store.utils.d.ts +0 -189
  224. package/build/src/utils/context-store.utils.js +0 -296
  225. package/build/src/utils/context-store.utils.js.map +0 -1
  226. package/build/src/utils/crypto.utils.d.ts +0 -160
  227. package/build/src/utils/crypto.utils.js +0 -293
  228. package/build/src/utils/crypto.utils.js.map +0 -1
  229. package/build/src/utils/date.utils.d.ts +0 -159
  230. package/build/src/utils/date.utils.js +0 -396
  231. package/build/src/utils/date.utils.js.map +0 -1
  232. package/build/src/utils/decorators.utils.d.ts +0 -315
  233. package/build/src/utils/decorators.utils.js +0 -516
  234. package/build/src/utils/decorators.utils.js.map +0 -1
  235. package/build/src/utils/dir.utils.d.ts +0 -196
  236. package/build/src/utils/dir.utils.js +0 -501
  237. package/build/src/utils/dir.utils.js.map +0 -1
  238. package/build/src/utils/env.utils.d.ts +0 -377
  239. package/build/src/utils/env.utils.js +0 -789
  240. package/build/src/utils/env.utils.js.map +0 -1
  241. package/build/src/utils/exception.utils.d.ts +0 -230
  242. package/build/src/utils/exception.utils.js +0 -407
  243. package/build/src/utils/exception.utils.js.map +0 -1
  244. package/build/src/utils/fs.utils.d.ts +0 -164
  245. package/build/src/utils/fs.utils.js +0 -372
  246. package/build/src/utils/fs.utils.js.map +0 -1
  247. package/build/src/utils/http-status-codes.d.ts +0 -266
  248. package/build/src/utils/http-status-codes.js +0 -298
  249. package/build/src/utils/http-status-codes.js.map +0 -1
  250. package/build/src/utils/id.utils.d.ts +0 -36
  251. package/build/src/utils/id.utils.js +0 -91
  252. package/build/src/utils/id.utils.js.map +0 -1
  253. package/build/src/utils/logger.utils.d.ts +0 -160
  254. package/build/src/utils/logger.utils.js +0 -346
  255. package/build/src/utils/logger.utils.js.map +0 -1
  256. package/build/src/utils/middleware.utils.d.ts +0 -83
  257. package/build/src/utils/middleware.utils.js +0 -206
  258. package/build/src/utils/middleware.utils.js.map +0 -1
  259. package/build/src/utils/obj.utils.d.ts +0 -124
  260. package/build/src/utils/obj.utils.js +0 -429
  261. package/build/src/utils/obj.utils.js.map +0 -1
  262. package/build/src/utils/performance.utils.d.ts +0 -136
  263. package/build/src/utils/performance.utils.js +0 -278
  264. package/build/src/utils/performance.utils.js.map +0 -1
  265. package/build/src/utils/request.utils.d.ts +0 -86
  266. package/build/src/utils/request.utils.js +0 -195
  267. package/build/src/utils/request.utils.js.map +0 -1
  268. package/build/src/utils/response.utils.d.ts +0 -163
  269. package/build/src/utils/response.utils.js +0 -260
  270. package/build/src/utils/response.utils.js.map +0 -1
  271. package/build/src/utils/stream.utils.d.ts +0 -88
  272. package/build/src/utils/stream.utils.js +0 -218
  273. package/build/src/utils/stream.utils.js.map +0 -1
  274. package/build/src/utils/string.utils.d.ts +0 -93
  275. package/build/src/utils/string.utils.js +0 -179
  276. package/build/src/utils/string.utils.js.map +0 -1
  277. package/build/src/utils/type.utils.d.ts +0 -90
  278. package/build/src/utils/type.utils.js +0 -196
  279. package/build/src/utils/type.utils.js.map +0 -1
  280. package/build/src/utils/url.utils.d.ts +0 -141
  281. package/build/src/utils/url.utils.js +0 -317
  282. package/build/src/utils/url.utils.js.map +0 -1
  283. package/build/src/utils/validate.utils.d.ts +0 -177
  284. package/build/src/utils/validate.utils.js +0 -345
  285. package/build/src/utils/validate.utils.js.map +0 -1
@@ -1,666 +0,0 @@
1
- /*
2
- * The MIT License
3
- *
4
- * Copyright (c) 2025 Catbee Technologies
5
- *
6
- * Permission is hereby granted, free of charge, to any person obtaining a copy
7
- * of this software and associated documentation files (the "Software"), to deal
8
- * in the Software without restriction, including without limitation the rights
9
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- * copies of the Software, and to permit persons to whom the Software is
11
- * furnished to do so, subject to the following conditions:
12
- *
13
- * The above copyright notice and this permission notice shall be included in all
14
- * copies or substantial portions of the Software.
15
- *
16
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- * SOFTWARE.
23
- */
24
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
25
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
26
- return new (P || (P = Promise))(function (resolve, reject) {
27
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
28
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
29
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
30
- step((generator = generator.apply(thisArg, _arguments || [])).next());
31
- });
32
- };
33
- var __generator = (this && this.__generator) || function (thisArg, body) {
34
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
35
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
36
- function verb(n) { return function (v) { return step([n, v]); }; }
37
- function step(op) {
38
- if (f) throw new TypeError("Generator is already executing.");
39
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
40
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
41
- if (y = 0, t) op = [op[0] & 2, t.value];
42
- switch (op[0]) {
43
- case 0: case 1: t = op; break;
44
- case 4: _.label++; return { value: op[1], done: false };
45
- case 5: _.label++; y = op[1]; op = [0]; continue;
46
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
47
- default:
48
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
49
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
50
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
51
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
52
- if (t[2]) _.ops.pop();
53
- _.trys.pop(); continue;
54
- }
55
- op = body.call(thisArg, _);
56
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
57
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
58
- }
59
- };
60
- var __read = (this && this.__read) || function (o, n) {
61
- var m = typeof Symbol === "function" && o[Symbol.iterator];
62
- if (!m) return o;
63
- var i = m.call(o), r, ar = [], e;
64
- try {
65
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
66
- }
67
- catch (error) { e = { error: error }; }
68
- finally {
69
- try {
70
- if (r && !r.done && (m = i["return"])) m.call(i);
71
- }
72
- finally { if (e) throw e.error; }
73
- }
74
- return ar;
75
- };
76
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
77
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
78
- if (ar || !(i in from)) {
79
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
80
- ar[i] = from[i];
81
- }
82
- }
83
- return to.concat(ar || Array.prototype.slice.call(from));
84
- };
85
- var __values = (this && this.__values) || function(o) {
86
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
87
- if (m) return m.call(o);
88
- if (o && typeof o.length === "number") return {
89
- next: function () {
90
- if (o && i >= o.length) o = void 0;
91
- return { value: o && o[i++], done: !o };
92
- }
93
- };
94
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
95
- };
96
- import 'reflect-metadata';
97
- import { HttpStatusCodes } from './http-status-codes';
98
- import { ForbiddenException } from './exception.utils';
99
- // Metadata keys
100
- var ROUTES_KEY = Symbol('routes');
101
- var MIDDLEWARE_KEY = Symbol('middlewares');
102
- var PARAMS_KEY = Symbol('params');
103
- var HTTP_CODE_KEY = Symbol('httpCode');
104
- var HEADER_KEY = Symbol('headers');
105
- var BEFORE_KEY = Symbol('before');
106
- var AFTER_KEY = Symbol('after');
107
- var ROLES_KEY = Symbol('roles');
108
- var REDIRECT_KEY = Symbol('redirect');
109
- /**
110
- * Factory function that creates HTTP method decorators.
111
- *
112
- * @param method - HTTP method to create decorator for
113
- * @returns A method decorator function
114
- */
115
- function createRouteDecorator(method) {
116
- return function (path) {
117
- return function (target, propertyKey, descriptor) {
118
- var routes = Reflect.getMetadata(ROUTES_KEY, target.constructor) || [];
119
- routes.push({
120
- path: path,
121
- method: method,
122
- handlerName: propertyKey
123
- });
124
- Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);
125
- };
126
- };
127
- }
128
- /**
129
- * Decorator for GET HTTP method routes.
130
- *
131
- * @param path - URL path for the route
132
- * @returns Method decorator
133
- *
134
- * @example
135
- * ```ts
136
- * @Get('/users')
137
- * getUsers() {
138
- * return this.userService.findAll();
139
- * }
140
- * ```
141
- */
142
- export var Get = createRouteDecorator('get');
143
- /**
144
- * Decorator for POST HTTP method routes.
145
- *
146
- * @param path - URL path for the route
147
- * @returns Method decorator
148
- *
149
- * @example
150
- * ```ts
151
- * @Post('/users')
152
- * createUser(@Body() userData: any) {
153
- * return this.userService.create(userData);
154
- * }
155
- * ```
156
- */
157
- export var Post = createRouteDecorator('post');
158
- /**
159
- * Decorator for PUT HTTP method routes.
160
- *
161
- * @param path - URL path for the route
162
- * @returns Method decorator
163
- */
164
- export var Put = createRouteDecorator('put');
165
- /**
166
- * Decorator for PATCH HTTP method routes.
167
- *
168
- * @param path - URL path for the route
169
- * @returns Method decorator
170
- */
171
- export var Patch = createRouteDecorator('patch');
172
- /**
173
- * Decorator for DELETE HTTP method routes.
174
- *
175
- * @param path - URL path for the route
176
- * @returns Method decorator
177
- */
178
- export var Delete = createRouteDecorator('delete');
179
- /**
180
- * Decorator for OPTIONS HTTP method routes.
181
- *
182
- * @param path - URL path for the route
183
- * @returns Method decorator
184
- */
185
- export var Options = createRouteDecorator('options');
186
- /**
187
- * Decorator for HEAD HTTP method routes.
188
- *
189
- * @param path - URL path for the route
190
- * @returns Method decorator
191
- */
192
- export var Head = createRouteDecorator('head');
193
- /**
194
- * Decorator for TRACE HTTP method routes.
195
- *
196
- * @param path - URL path for the route
197
- * @returns Method decorator
198
- */
199
- export var Trace = createRouteDecorator('trace');
200
- /**
201
- * Decorator for CONNECT HTTP method routes.
202
- *
203
- * @param path - URL path for the route
204
- * @returns Method decorator
205
- */
206
- export var Connect = createRouteDecorator('connect');
207
- /**
208
- * Decorator that marks a class as a controller with a base path.
209
- * Used as the entry point for routing configuration.
210
- *
211
- * @param basePath - Base URL path for all routes in this controller
212
- * @returns Class decorator
213
- *
214
- * @example
215
- * ```ts
216
- * @Controller('/api/users')
217
- * class UserController {
218
- * // Controller methods...
219
- * }
220
- * ```
221
- */
222
- export function Controller(basePath) {
223
- return function (target) {
224
- Reflect.defineMetadata('basePath', basePath, target);
225
- };
226
- }
227
- /**
228
- * Decorator that applies middleware to a controller method.
229
- * Multiple middlewares can be applied and will execute in order.
230
- *
231
- * @param middlewares - Express middleware functions to apply
232
- * @returns Method decorator
233
- *
234
- * @example
235
- * ```ts
236
- * @Get('/protected')
237
- * @Use(authMiddleware, loggingMiddleware)
238
- * getProtectedResource() {
239
- * // This route is protected by auth middleware
240
- * }
241
- * ```
242
- */
243
- export function Use() {
244
- var middlewares = [];
245
- for (var _i = 0; _i < arguments.length; _i++) {
246
- middlewares[_i] = arguments[_i];
247
- }
248
- return function (target, propertyKey, _descriptor) {
249
- var existing = Reflect.getMetadata(MIDDLEWARE_KEY, target, propertyKey) || [];
250
- Reflect.defineMetadata(MIDDLEWARE_KEY, __spreadArray(__spreadArray([], __read(existing), false), __read(middlewares), false), target, propertyKey);
251
- };
252
- }
253
- /**
254
- * Factory function that creates parameter decorators.
255
- *
256
- * @param type - Parameter type to extract from request
257
- * @param key - Optional fixed key for extraction
258
- * @returns Parameter decorator function
259
- */
260
- function createParamDecorator(type, key) {
261
- return function (paramKey) {
262
- return function (target, propertyKey, parameterIndex) {
263
- var params = Reflect.getMetadata(PARAMS_KEY, target, propertyKey) || [];
264
- // Ensure parameters are ordered by index
265
- params.push({ index: parameterIndex, type: type, key: paramKey || key });
266
- params.sort(function (a, b) { return a.index - b.index; });
267
- Reflect.defineMetadata(PARAMS_KEY, params, target, propertyKey);
268
- };
269
- };
270
- }
271
- /**
272
- * Decorator that extracts query parameters from request.
273
- *
274
- * @param paramKey - Optional key to extract specific query parameter
275
- * @returns Parameter decorator
276
- *
277
- * @example
278
- * ```ts
279
- * @Get('/search')
280
- * search(@Query('term') searchTerm: string) {
281
- * // searchTerm will contain the value of req.query.term
282
- * }
283
- * ```
284
- */
285
- export var Query = createParamDecorator('query');
286
- /**
287
- * Decorator that extracts route parameters from request.
288
- *
289
- * @param paramKey - Optional key to extract specific route parameter
290
- * @returns Parameter decorator
291
- *
292
- * @example
293
- * ```ts
294
- * @Get('/users/:id')
295
- * getUser(@Param('id') userId: string) {
296
- * // userId will contain the value of req.params.id
297
- * }
298
- * ```
299
- */
300
- export var Param = createParamDecorator('param');
301
- /**
302
- * Decorator that extracts body or body property from request.
303
- *
304
- * @param paramKey - Optional key to extract specific body property
305
- * @returns Parameter decorator
306
- *
307
- * @example
308
- * ```ts
309
- * @Post('/users')
310
- * createUser(@Body() userData: any) {
311
- * // userData will contain the entire req.body
312
- * }
313
- *
314
- * @Post('/update')
315
- * updateName(@Body('name') name: string) {
316
- * // name will contain the value of req.body.name
317
- * }
318
- * ```
319
- */
320
- export var Body = createParamDecorator('body');
321
- /**
322
- * Decorator that injects the entire request object.
323
- *
324
- * @returns Parameter decorator
325
- *
326
- * @example
327
- * ```ts
328
- * @Get('/complex')
329
- * complex(@Req() req: Request) {
330
- * // Access the full request object
331
- * console.log(req.headers);
332
- * }
333
- * ```
334
- */
335
- export var Req = createParamDecorator('req');
336
- /**
337
- * Decorator that injects the response object.
338
- *
339
- * @returns Parameter decorator
340
- *
341
- * @example
342
- * ```ts
343
- * @Get('/custom')
344
- * custom(@Res() res: Response) {
345
- * // Direct access to response object
346
- * return res.status(201).send('Created');
347
- * }
348
- * ```
349
- */
350
- export var Res = createParamDecorator('res');
351
- /**
352
- * Decorator that sets a custom HTTP status code for a response.
353
- *
354
- * @param status - HTTP status code to use
355
- * @returns Method decorator
356
- *
357
- * @example
358
- * ```ts
359
- * @Post('/users')
360
- * @HttpCode(201)
361
- * createUser(@Body() userData: any) {
362
- * // Response will have 201 Created status code
363
- * return { id: '123', ...userData };
364
- * }
365
- * ```
366
- */
367
- export function HttpCode(status) {
368
- return function (target, propertyKey, _descriptor) {
369
- Reflect.defineMetadata(HTTP_CODE_KEY, status, target, propertyKey);
370
- };
371
- }
372
- /**
373
- * Decorator that adds a custom HTTP header to the response.
374
- *
375
- * @param name - Header name
376
- * @param value - Header value
377
- * @returns Method decorator
378
- *
379
- * @example
380
- * ```ts
381
- * @Get('/data')
382
- * @Header('Cache-Control', 'max-age=60')
383
- * getData() {
384
- * // Response will include the Cache-Control header
385
- * return { data: '...' };
386
- * }
387
- * ```
388
- */
389
- export function Header(name, value) {
390
- return function (target, propertyKey, _descriptor) {
391
- var headers = Reflect.getMetadata(HEADER_KEY, target, propertyKey) || {};
392
- headers[name] = value;
393
- Reflect.defineMetadata(HEADER_KEY, headers, target, propertyKey);
394
- };
395
- }
396
- /**
397
- * Decorator that registers a function to run before route handler execution.
398
- * Useful for pre-processing or logging.
399
- *
400
- * @param fn - Function to execute before the handler
401
- * @returns Method decorator
402
- *
403
- * @example
404
- * ```ts
405
- * @Get('/users/:id')
406
- * @Before((req, res) => console.log(`Accessing user ${req.params.id}`))
407
- * getUser(@Param('id') id: string) {
408
- * // Function will log before this handler runs
409
- * }
410
- * ```
411
- */
412
- export function Before(fn) {
413
- return function (target, propertyKey, _descriptor) {
414
- var hooks = Reflect.getMetadata(BEFORE_KEY, target, propertyKey) || [];
415
- hooks.push(fn);
416
- Reflect.defineMetadata(BEFORE_KEY, hooks, target, propertyKey);
417
- };
418
- }
419
- /**
420
- * Decorator that registers a function to run after route handler execution.
421
- * Can access the handler's result.
422
- *
423
- * @param fn - Function to execute after the handler
424
- * @returns Method decorator
425
- *
426
- * @example
427
- * ```ts
428
- * @Get('/users/:id')
429
- * @After((req, res, result) => console.log(`User data sent: ${JSON.stringify(result)}`))
430
- * getUser(@Param('id') id: string) {
431
- * // After this handler, the function will log the returned data
432
- * return { id, name: 'Example' };
433
- * }
434
- * ```
435
- */
436
- export function After(fn) {
437
- return function (target, propertyKey, _descriptor) {
438
- var hooks = Reflect.getMetadata(AFTER_KEY, target, propertyKey) || [];
439
- hooks.push(fn);
440
- Reflect.defineMetadata(AFTER_KEY, hooks, target, propertyKey);
441
- };
442
- }
443
- /**
444
- * Decorator that requires specific roles for accessing a route.
445
- * Must be used with authentication middleware.
446
- *
447
- * @param roles - List of roles that can access this route
448
- * @returns Method decorator
449
- *
450
- * @example
451
- * ```ts
452
- * @Get('/admin/settings')
453
- * @Roles('admin', 'superuser')
454
- * getSettings() {
455
- * // Only admins and superusers can access
456
- * return { settings: [...] };
457
- * }
458
- * ```
459
- */
460
- export function Roles() {
461
- var roles = [];
462
- for (var _i = 0; _i < arguments.length; _i++) {
463
- roles[_i] = arguments[_i];
464
- }
465
- return function (target, propertyKey, _descriptor) {
466
- Reflect.defineMetadata(ROLES_KEY, roles, target, propertyKey);
467
- };
468
- }
469
- /**
470
- * Decorator that redirects to another URL.
471
- *
472
- * @param url - URL to redirect to (can be absolute or relative)
473
- * @param statusCode - HTTP status code for redirect (default: 302)
474
- * @returns Method decorator
475
- *
476
- * @example
477
- * ```ts
478
- * @Get('/old-path')
479
- * @Redirect('/new-path', 301)
480
- * redirectToNewPath() {
481
- * // This method won't be executed; automatic redirect happens
482
- * }
483
- *
484
- * @Get('/dynamic-redirect')
485
- * @Redirect()
486
- * getDynamicRedirect() {
487
- * // Return an object with url and optionally statusCode
488
- * return { url: '/calculated-path', statusCode: 307 };
489
- * }
490
- * ```
491
- */
492
- export function Redirect(url, statusCode) {
493
- if (statusCode === void 0) { statusCode = 302; }
494
- return function (target, propertyKey, descriptor) {
495
- // Store the redirect information in metadata
496
- Reflect.defineMetadata(REDIRECT_KEY, { url: url, statusCode: statusCode }, target, propertyKey);
497
- return descriptor;
498
- };
499
- }
500
- /**
501
- * Registers all controller classes with the provided router.
502
- * This function processes all decorators and sets up the Express routes.
503
- *
504
- * @param router - Express router instance
505
- * @param controllers - Array of controller classes
506
- */
507
- export function registerControllers(router, controllers) {
508
- var _this = this;
509
- controllers.forEach(function (ControllerClass) {
510
- var instance = new ControllerClass();
511
- var basePath = Reflect.getMetadata('basePath', ControllerClass) || '';
512
- var routes = Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];
513
- routes.forEach(function (_a) {
514
- var _b;
515
- var path = _a.path, method = _a.method, handlerName = _a.handlerName;
516
- var middlewares = Reflect.getMetadata(MIDDLEWARE_KEY, instance, handlerName) || [];
517
- var params = Reflect.getMetadata(PARAMS_KEY, instance, handlerName) || [];
518
- var httpCode = Reflect.getMetadata(HTTP_CODE_KEY, instance, handlerName);
519
- var headers = Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};
520
- var beforeHooks = Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];
521
- var afterHooks = Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];
522
- var roles = Reflect.getMetadata(ROLES_KEY, instance, handlerName) || [];
523
- var redirect = Reflect.getMetadata(REDIRECT_KEY, instance, handlerName);
524
- var handler = function (req, res, next) { return __awaiter(_this, void 0, void 0, function () {
525
- var beforeHooks_1, beforeHooks_1_1, fn, e_1_1, args_1, result, awaited, _a, redirectUrl, redirectStatus, _b, _c, _d, k, v, afterHooks_1, afterHooks_1_1, fn, e_2_1, err_1;
526
- var e_1, _e, _f, e_3, _g, e_2, _h;
527
- var _j, _k, _l, _m;
528
- return __generator(this, function (_o) {
529
- switch (_o.label) {
530
- case 0:
531
- _o.trys.push([0, 20, , 21]);
532
- // Handle roles-based access control
533
- if (roles.length && !((_k = (_j = req === null || req === void 0 ? void 0 : req.user) === null || _j === void 0 ? void 0 : _j.roles) === null || _k === void 0 ? void 0 : _k.some(function (role) { return roles.includes(role); }))) {
534
- res.status(HttpStatusCodes.FORBIDDEN).json(new ForbiddenException('Forbidden Insufficient Roles'));
535
- return [2 /*return*/];
536
- }
537
- // Process static redirect if configured
538
- if (redirect && redirect.url) {
539
- return [2 /*return*/, res.redirect(redirect.statusCode, redirect.url)];
540
- }
541
- _o.label = 1;
542
- case 1:
543
- _o.trys.push([1, 6, 7, 8]);
544
- beforeHooks_1 = __values(beforeHooks), beforeHooks_1_1 = beforeHooks_1.next();
545
- _o.label = 2;
546
- case 2:
547
- if (!!beforeHooks_1_1.done) return [3 /*break*/, 5];
548
- fn = beforeHooks_1_1.value;
549
- return [4 /*yield*/, fn(req, res)];
550
- case 3:
551
- _o.sent();
552
- _o.label = 4;
553
- case 4:
554
- beforeHooks_1_1 = beforeHooks_1.next();
555
- return [3 /*break*/, 2];
556
- case 5: return [3 /*break*/, 8];
557
- case 6:
558
- e_1_1 = _o.sent();
559
- e_1 = { error: e_1_1 };
560
- return [3 /*break*/, 8];
561
- case 7:
562
- try {
563
- if (beforeHooks_1_1 && !beforeHooks_1_1.done && (_e = beforeHooks_1.return)) _e.call(beforeHooks_1);
564
- }
565
- finally { if (e_1) throw e_1.error; }
566
- return [7 /*endfinally*/];
567
- case 8:
568
- args_1 = [];
569
- if (params.length) {
570
- params.forEach(function (_a) {
571
- var _b;
572
- var index = _a.index, type = _a.type, key = _a.key;
573
- switch (type) {
574
- case 'query':
575
- args_1[index] = key ? req.query[key] : req.query;
576
- break;
577
- case 'param':
578
- args_1[index] = key ? req.params[key] : req.params;
579
- break;
580
- case 'body':
581
- args_1[index] = key ? (_b = req.body) === null || _b === void 0 ? void 0 : _b[key] : req.body;
582
- break;
583
- case 'req':
584
- args_1[index] = req;
585
- break;
586
- case 'res':
587
- args_1[index] = res;
588
- break;
589
- }
590
- });
591
- }
592
- result = (_f = instance)[handlerName].apply(_f, __spreadArray([], __read(args_1), false));
593
- if (!(result instanceof Promise)) return [3 /*break*/, 10];
594
- return [4 /*yield*/, result];
595
- case 9:
596
- _a = _o.sent();
597
- return [3 /*break*/, 11];
598
- case 10:
599
- _a = result;
600
- _o.label = 11;
601
- case 11:
602
- awaited = _a;
603
- // Handle dynamic redirects
604
- if (redirect && awaited && typeof awaited === 'object' && 'url' in awaited) {
605
- redirectUrl = awaited.url;
606
- redirectStatus = awaited.statusCode || redirect.statusCode;
607
- return [2 /*return*/, res.redirect(redirectStatus, redirectUrl)];
608
- }
609
- if (!res.headersSent && typeof awaited !== 'undefined') {
610
- if (httpCode)
611
- (_l = res.status) === null || _l === void 0 ? void 0 : _l.call(res, httpCode);
612
- try {
613
- for (_b = __values(Object.entries(headers)), _c = _b.next(); !_c.done; _c = _b.next()) {
614
- _d = __read(_c.value, 2), k = _d[0], v = _d[1];
615
- (_m = res.set) === null || _m === void 0 ? void 0 : _m.call(res, k, v);
616
- }
617
- }
618
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
619
- finally {
620
- try {
621
- if (_c && !_c.done && (_g = _b.return)) _g.call(_b);
622
- }
623
- finally { if (e_3) throw e_3.error; }
624
- }
625
- res.json(awaited);
626
- }
627
- _o.label = 12;
628
- case 12:
629
- _o.trys.push([12, 17, 18, 19]);
630
- afterHooks_1 = __values(afterHooks), afterHooks_1_1 = afterHooks_1.next();
631
- _o.label = 13;
632
- case 13:
633
- if (!!afterHooks_1_1.done) return [3 /*break*/, 16];
634
- fn = afterHooks_1_1.value;
635
- return [4 /*yield*/, fn(req, res, awaited)];
636
- case 14:
637
- _o.sent();
638
- _o.label = 15;
639
- case 15:
640
- afterHooks_1_1 = afterHooks_1.next();
641
- return [3 /*break*/, 13];
642
- case 16: return [3 /*break*/, 19];
643
- case 17:
644
- e_2_1 = _o.sent();
645
- e_2 = { error: e_2_1 };
646
- return [3 /*break*/, 19];
647
- case 18:
648
- try {
649
- if (afterHooks_1_1 && !afterHooks_1_1.done && (_h = afterHooks_1.return)) _h.call(afterHooks_1);
650
- }
651
- finally { if (e_2) throw e_2.error; }
652
- return [7 /*endfinally*/];
653
- case 19: return [3 /*break*/, 21];
654
- case 20:
655
- err_1 = _o.sent();
656
- next(err_1);
657
- return [3 /*break*/, 21];
658
- case 21: return [2 /*return*/];
659
- }
660
- });
661
- }); };
662
- (_b = router)[method].apply(_b, __spreadArray(__spreadArray([basePath + path], __read(middlewares), false), [handler], false));
663
- });
664
- });
665
- }
666
- //# sourceMappingURL=decorators.utils.js.map