@catbee/utils 0.0.8-next.0 → 0.0.8-rc.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 (284) hide show
  1. package/README.md +1 -26
  2. package/build/esm/config.d.ts +122 -0
  3. package/build/esm/config.js +133 -0
  4. package/build/esm/config.js.map +1 -0
  5. package/build/esm/index.d.ts +27 -0
  6. package/build/esm/index.js +50 -0
  7. package/build/esm/index.js.map +1 -0
  8. package/build/esm/servers/server.builder.d.ts +508 -0
  9. package/build/esm/servers/server.builder.js +702 -0
  10. package/build/esm/servers/server.builder.js.map +1 -0
  11. package/build/esm/servers/server.d.ts +256 -0
  12. package/build/esm/servers/server.js +1248 -0
  13. package/build/esm/servers/server.js.map +1 -0
  14. package/build/esm/types/api-response.d.ts +152 -0
  15. package/build/esm/types/api-response.js +34 -0
  16. package/build/esm/types/api-response.js.map +1 -0
  17. package/build/esm/types/index.d.ts +125 -0
  18. package/build/esm/types/index.js +25 -0
  19. package/build/esm/types/index.js.map +1 -0
  20. package/build/esm/types/server.d.ts +268 -0
  21. package/build/esm/types/server.js +25 -0
  22. package/build/esm/types/server.js.map +1 -0
  23. package/build/esm/utils/array.utils.d.ts +168 -0
  24. package/build/esm/utils/array.utils.js +382 -0
  25. package/build/esm/utils/array.utils.js.map +1 -0
  26. package/build/esm/utils/async.utils.d.ts +265 -0
  27. package/build/esm/utils/async.utils.js +896 -0
  28. package/build/esm/utils/async.utils.js.map +1 -0
  29. package/build/esm/utils/cache.utils.d.ts +153 -0
  30. package/build/esm/utils/cache.utils.js +499 -0
  31. package/build/esm/utils/cache.utils.js.map +1 -0
  32. package/build/esm/utils/context-store.utils.d.ts +189 -0
  33. package/build/esm/utils/context-store.utils.js +307 -0
  34. package/build/esm/utils/context-store.utils.js.map +1 -0
  35. package/build/esm/utils/crypto.utils.d.ts +160 -0
  36. package/build/esm/utils/crypto.utils.js +375 -0
  37. package/build/esm/utils/crypto.utils.js.map +1 -0
  38. package/build/esm/utils/date.utils.d.ts +159 -0
  39. package/build/esm/utils/date.utils.js +389 -0
  40. package/build/esm/utils/date.utils.js.map +1 -0
  41. package/build/esm/utils/decorators.utils.d.ts +315 -0
  42. package/build/esm/utils/decorators.utils.js +666 -0
  43. package/build/esm/utils/decorators.utils.js.map +1 -0
  44. package/build/esm/utils/dir.utils.d.ts +196 -0
  45. package/build/esm/utils/dir.utils.js +998 -0
  46. package/build/esm/utils/dir.utils.js.map +1 -0
  47. package/build/esm/utils/env.utils.d.ts +377 -0
  48. package/build/esm/utils/env.utils.js +873 -0
  49. package/build/esm/utils/env.utils.js.map +1 -0
  50. package/build/esm/utils/exception.utils.d.ts +230 -0
  51. package/build/esm/utils/exception.utils.js +559 -0
  52. package/build/esm/utils/exception.utils.js.map +1 -0
  53. package/build/esm/utils/fs.utils.d.ts +164 -0
  54. package/build/esm/utils/fs.utils.js +580 -0
  55. package/build/esm/utils/fs.utils.js.map +1 -0
  56. package/build/esm/utils/http-status-codes.d.ts +266 -0
  57. package/build/esm/utils/http-status-codes.js +295 -0
  58. package/build/esm/utils/http-status-codes.js.map +1 -0
  59. package/build/esm/utils/id.utils.d.ts +36 -0
  60. package/build/esm/utils/id.utils.js +87 -0
  61. package/build/esm/utils/id.utils.js.map +1 -0
  62. package/build/esm/utils/logger.utils.d.ts +160 -0
  63. package/build/esm/utils/logger.utils.js +341 -0
  64. package/build/esm/utils/logger.utils.js.map +1 -0
  65. package/build/esm/utils/middleware.utils.d.ts +100 -0
  66. package/build/esm/utils/middleware.utils.js +325 -0
  67. package/build/esm/utils/middleware.utils.js.map +1 -0
  68. package/build/esm/utils/obj.utils.d.ts +124 -0
  69. package/build/esm/utils/obj.utils.js +519 -0
  70. package/build/esm/utils/obj.utils.js.map +1 -0
  71. package/build/esm/utils/performance.utils.d.ts +136 -0
  72. package/build/esm/utils/performance.utils.js +376 -0
  73. package/build/esm/utils/performance.utils.js.map +1 -0
  74. package/build/esm/utils/request.utils.d.ts +86 -0
  75. package/build/esm/utils/request.utils.js +223 -0
  76. package/build/esm/utils/request.utils.js.map +1 -0
  77. package/build/esm/utils/response.utils.d.ts +163 -0
  78. package/build/esm/utils/response.utils.js +284 -0
  79. package/build/esm/utils/response.utils.js.map +1 -0
  80. package/build/esm/utils/stream.utils.d.ts +88 -0
  81. package/build/esm/utils/stream.utils.js +284 -0
  82. package/build/esm/utils/stream.utils.js.map +1 -0
  83. package/build/esm/utils/string.utils.d.ts +93 -0
  84. package/build/esm/utils/string.utils.js +169 -0
  85. package/build/esm/utils/string.utils.js.map +1 -0
  86. package/build/esm/utils/type.utils.d.ts +90 -0
  87. package/build/esm/utils/type.utils.js +190 -0
  88. package/build/esm/utils/type.utils.js.map +1 -0
  89. package/build/esm/utils/url.utils.d.ts +141 -0
  90. package/build/esm/utils/url.utils.js +381 -0
  91. package/build/esm/utils/url.utils.js.map +1 -0
  92. package/build/esm/utils/validate.utils.d.ts +177 -0
  93. package/build/esm/utils/validate.utils.js +336 -0
  94. package/build/esm/utils/validate.utils.js.map +1 -0
  95. package/build/esnext/config.d.ts +122 -0
  96. package/build/esnext/config.js +133 -0
  97. package/build/esnext/config.js.map +1 -0
  98. package/build/esnext/index.d.ts +27 -0
  99. package/build/esnext/index.js +50 -0
  100. package/build/esnext/index.js.map +1 -0
  101. package/build/esnext/servers/server.builder.d.ts +508 -0
  102. package/build/esnext/servers/server.builder.js +657 -0
  103. package/build/esnext/servers/server.builder.js.map +1 -0
  104. package/build/esnext/servers/server.d.ts +256 -0
  105. package/build/esnext/servers/server.js +955 -0
  106. package/build/esnext/servers/server.js.map +1 -0
  107. package/build/esnext/types/api-response.d.ts +152 -0
  108. package/build/esnext/types/api-response.js +34 -0
  109. package/build/esnext/types/api-response.js.map +1 -0
  110. package/build/esnext/types/index.d.ts +125 -0
  111. package/build/esnext/types/index.js +25 -0
  112. package/build/esnext/types/index.js.map +1 -0
  113. package/build/esnext/types/server.d.ts +268 -0
  114. package/build/esnext/types/server.js +25 -0
  115. package/build/esnext/types/server.js.map +1 -0
  116. package/build/esnext/utils/array.utils.d.ts +168 -0
  117. package/build/esnext/utils/array.utils.js +345 -0
  118. package/build/esnext/utils/array.utils.js.map +1 -0
  119. package/build/esnext/utils/async.utils.d.ts +265 -0
  120. package/build/esnext/utils/async.utils.js +620 -0
  121. package/build/esnext/utils/async.utils.js.map +1 -0
  122. package/build/esnext/utils/cache.utils.d.ts +153 -0
  123. package/build/esnext/utils/cache.utils.js +293 -0
  124. package/build/esnext/utils/cache.utils.js.map +1 -0
  125. package/build/esnext/utils/context-store.utils.d.ts +189 -0
  126. package/build/esnext/utils/context-store.utils.js +289 -0
  127. package/build/esnext/utils/context-store.utils.js.map +1 -0
  128. package/build/esnext/utils/crypto.utils.d.ts +160 -0
  129. package/build/esnext/utils/crypto.utils.js +276 -0
  130. package/build/esnext/utils/crypto.utils.js.map +1 -0
  131. package/build/esnext/utils/date.utils.d.ts +159 -0
  132. package/build/esnext/utils/date.utils.js +384 -0
  133. package/build/esnext/utils/date.utils.js.map +1 -0
  134. package/build/esnext/utils/decorators.utils.d.ts +315 -0
  135. package/build/esnext/utils/decorators.utils.js +504 -0
  136. package/build/esnext/utils/decorators.utils.js.map +1 -0
  137. package/build/esnext/utils/dir.utils.d.ts +196 -0
  138. package/build/esnext/utils/dir.utils.js +477 -0
  139. package/build/esnext/utils/dir.utils.js.map +1 -0
  140. package/build/esnext/utils/env.utils.d.ts +377 -0
  141. package/build/esnext/utils/env.utils.js +785 -0
  142. package/build/esnext/utils/env.utils.js.map +1 -0
  143. package/build/esnext/utils/exception.utils.d.ts +230 -0
  144. package/build/esnext/utils/exception.utils.js +381 -0
  145. package/build/esnext/utils/exception.utils.js.map +1 -0
  146. package/build/esnext/utils/fs.utils.d.ts +164 -0
  147. package/build/esnext/utils/fs.utils.js +349 -0
  148. package/build/esnext/utils/fs.utils.js.map +1 -0
  149. package/build/esnext/utils/http-status-codes.d.ts +266 -0
  150. package/build/esnext/utils/http-status-codes.js +295 -0
  151. package/build/esnext/utils/http-status-codes.js.map +1 -0
  152. package/build/esnext/utils/id.utils.d.ts +36 -0
  153. package/build/esnext/utils/id.utils.js +84 -0
  154. package/build/esnext/utils/id.utils.js.map +1 -0
  155. package/build/esnext/utils/logger.utils.d.ts +160 -0
  156. package/build/esnext/utils/logger.utils.js +300 -0
  157. package/build/esnext/utils/logger.utils.js.map +1 -0
  158. package/build/esnext/utils/middleware.utils.d.ts +100 -0
  159. package/build/esnext/utils/middleware.utils.js +236 -0
  160. package/build/esnext/utils/middleware.utils.js.map +1 -0
  161. package/build/esnext/utils/obj.utils.d.ts +124 -0
  162. package/build/esnext/utils/obj.utils.js +413 -0
  163. package/build/esnext/utils/obj.utils.js.map +1 -0
  164. package/build/esnext/utils/performance.utils.d.ts +136 -0
  165. package/build/esnext/utils/performance.utils.js +271 -0
  166. package/build/esnext/utils/performance.utils.js.map +1 -0
  167. package/build/esnext/utils/request.utils.d.ts +86 -0
  168. package/build/esnext/utils/request.utils.js +186 -0
  169. package/build/esnext/utils/request.utils.js.map +1 -0
  170. package/build/esnext/utils/response.utils.d.ts +163 -0
  171. package/build/esnext/utils/response.utils.js +247 -0
  172. package/build/esnext/utils/response.utils.js.map +1 -0
  173. package/build/esnext/utils/stream.utils.d.ts +88 -0
  174. package/build/esnext/utils/stream.utils.js +210 -0
  175. package/build/esnext/utils/stream.utils.js.map +1 -0
  176. package/build/esnext/utils/string.utils.d.ts +93 -0
  177. package/build/esnext/utils/string.utils.js +165 -0
  178. package/build/esnext/utils/string.utils.js.map +1 -0
  179. package/build/esnext/utils/type.utils.d.ts +90 -0
  180. package/build/esnext/utils/type.utils.js +187 -0
  181. package/build/esnext/utils/type.utils.js.map +1 -0
  182. package/build/esnext/utils/url.utils.d.ts +141 -0
  183. package/build/esnext/utils/url.utils.js +304 -0
  184. package/build/esnext/utils/url.utils.js.map +1 -0
  185. package/build/esnext/utils/validate.utils.d.ts +177 -0
  186. package/build/esnext/utils/validate.utils.js +320 -0
  187. package/build/esnext/utils/validate.utils.js.map +1 -0
  188. package/build/src/config.d.ts +122 -0
  189. package/build/src/config.js +138 -0
  190. package/build/src/config.js.map +1 -0
  191. package/build/src/index.d.ts +27 -0
  192. package/build/src/index.js +69 -0
  193. package/build/src/index.js.map +1 -0
  194. package/build/src/servers/server.builder.d.ts +508 -0
  195. package/build/src/servers/server.builder.js +661 -0
  196. package/build/src/servers/server.builder.js.map +1 -0
  197. package/build/src/servers/server.d.ts +256 -0
  198. package/build/src/servers/server.js +962 -0
  199. package/build/src/servers/server.js.map +1 -0
  200. package/build/src/types/api-response.d.ts +152 -0
  201. package/build/src/types/api-response.js +37 -0
  202. package/build/src/types/api-response.js.map +1 -0
  203. package/build/src/types/index.d.ts +125 -0
  204. package/build/src/types/index.js +26 -0
  205. package/build/src/types/index.js.map +1 -0
  206. package/build/src/types/server.d.ts +268 -0
  207. package/build/src/types/server.js +26 -0
  208. package/build/src/types/server.js.map +1 -0
  209. package/build/src/utils/array.utils.d.ts +168 -0
  210. package/build/src/utils/array.utils.js +364 -0
  211. package/build/src/utils/array.utils.js.map +1 -0
  212. package/build/src/utils/async.utils.d.ts +265 -0
  213. package/build/src/utils/async.utils.js +641 -0
  214. package/build/src/utils/async.utils.js.map +1 -0
  215. package/build/src/utils/cache.utils.d.ts +153 -0
  216. package/build/src/utils/cache.utils.js +297 -0
  217. package/build/src/utils/cache.utils.js.map +1 -0
  218. package/build/src/utils/context-store.utils.d.ts +189 -0
  219. package/build/src/utils/context-store.utils.js +296 -0
  220. package/build/src/utils/context-store.utils.js.map +1 -0
  221. package/build/src/utils/crypto.utils.d.ts +160 -0
  222. package/build/src/utils/crypto.utils.js +293 -0
  223. package/build/src/utils/crypto.utils.js.map +1 -0
  224. package/build/src/utils/date.utils.d.ts +159 -0
  225. package/build/src/utils/date.utils.js +396 -0
  226. package/build/src/utils/date.utils.js.map +1 -0
  227. package/build/src/utils/decorators.utils.d.ts +315 -0
  228. package/build/src/utils/decorators.utils.js +516 -0
  229. package/build/src/utils/decorators.utils.js.map +1 -0
  230. package/build/src/utils/dir.utils.d.ts +196 -0
  231. package/build/src/utils/dir.utils.js +501 -0
  232. package/build/src/utils/dir.utils.js.map +1 -0
  233. package/build/src/utils/env.utils.d.ts +377 -0
  234. package/build/src/utils/env.utils.js +789 -0
  235. package/build/src/utils/env.utils.js.map +1 -0
  236. package/build/src/utils/exception.utils.d.ts +230 -0
  237. package/build/src/utils/exception.utils.js +407 -0
  238. package/build/src/utils/exception.utils.js.map +1 -0
  239. package/build/src/utils/fs.utils.d.ts +164 -0
  240. package/build/src/utils/fs.utils.js +372 -0
  241. package/build/src/utils/fs.utils.js.map +1 -0
  242. package/build/src/utils/http-status-codes.d.ts +266 -0
  243. package/build/src/utils/http-status-codes.js +298 -0
  244. package/build/src/utils/http-status-codes.js.map +1 -0
  245. package/build/src/utils/id.utils.d.ts +36 -0
  246. package/build/src/utils/id.utils.js +91 -0
  247. package/build/src/utils/id.utils.js.map +1 -0
  248. package/build/src/utils/logger.utils.d.ts +160 -0
  249. package/build/src/utils/logger.utils.js +346 -0
  250. package/build/src/utils/logger.utils.js.map +1 -0
  251. package/build/src/utils/middleware.utils.d.ts +100 -0
  252. package/build/src/utils/middleware.utils.js +244 -0
  253. package/build/src/utils/middleware.utils.js.map +1 -0
  254. package/build/src/utils/obj.utils.d.ts +124 -0
  255. package/build/src/utils/obj.utils.js +429 -0
  256. package/build/src/utils/obj.utils.js.map +1 -0
  257. package/build/src/utils/performance.utils.d.ts +136 -0
  258. package/build/src/utils/performance.utils.js +278 -0
  259. package/build/src/utils/performance.utils.js.map +1 -0
  260. package/build/src/utils/request.utils.d.ts +86 -0
  261. package/build/src/utils/request.utils.js +195 -0
  262. package/build/src/utils/request.utils.js.map +1 -0
  263. package/build/src/utils/response.utils.d.ts +163 -0
  264. package/build/src/utils/response.utils.js +260 -0
  265. package/build/src/utils/response.utils.js.map +1 -0
  266. package/build/src/utils/stream.utils.d.ts +88 -0
  267. package/build/src/utils/stream.utils.js +218 -0
  268. package/build/src/utils/stream.utils.js.map +1 -0
  269. package/build/src/utils/string.utils.d.ts +93 -0
  270. package/build/src/utils/string.utils.js +179 -0
  271. package/build/src/utils/string.utils.js.map +1 -0
  272. package/build/src/utils/type.utils.d.ts +90 -0
  273. package/build/src/utils/type.utils.js +196 -0
  274. package/build/src/utils/type.utils.js.map +1 -0
  275. package/build/src/utils/url.utils.d.ts +141 -0
  276. package/build/src/utils/url.utils.js +317 -0
  277. package/build/src/utils/url.utils.js.map +1 -0
  278. package/build/src/utils/validate.utils.d.ts +177 -0
  279. package/build/src/utils/validate.utils.js +345 -0
  280. package/build/src/utils/validate.utils.js.map +1 -0
  281. package/package.json +66 -12
  282. package/build/index.cjs +0 -6888
  283. package/build/index.d.ts +0 -5242
  284. package/build/index.mjs +0 -6615
@@ -0,0 +1,666 @@
1
+ /*
2
+ * The MIT License
3
+ *
4
+ * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
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