@miqro/core 3.0.6 → 5.0.2

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 (395) hide show
  1. package/README.md +0 -204
  2. package/build/app.d.ts +23 -0
  3. package/build/app.js +101 -0
  4. package/build/app.js.map +1 -0
  5. package/build/common.d.ts +106 -0
  6. package/build/common.js +477 -0
  7. package/build/common.js.map +1 -0
  8. package/build/lib.d.ts +7 -0
  9. package/build/lib.js +8 -0
  10. package/build/lib.js.map +1 -0
  11. package/build/middleware/body-parser.d.ts +78 -0
  12. package/build/middleware/body-parser.js +552 -0
  13. package/build/middleware/body-parser.js.map +1 -0
  14. package/build/middleware/router.d.ts +114 -0
  15. package/build/middleware/router.js +704 -0
  16. package/build/middleware/router.js.map +1 -0
  17. package/build/{esm/common/session/service.d.ts → middleware/session.d.ts} +10 -9
  18. package/build/middleware/session.js +369 -0
  19. package/build/middleware/session.js.map +1 -0
  20. package/build/types.d.ts +309 -0
  21. package/build/types.js +455 -0
  22. package/build/types.js.map +1 -0
  23. package/build/websocket.d.ts +31 -0
  24. package/build/websocket.js +316 -0
  25. package/build/websocket.js.map +1 -0
  26. package/package.json +13 -14
  27. package/src/app.ts +64 -29
  28. package/src/common.ts +528 -0
  29. package/src/lib.ts +82 -0
  30. package/src/middleware/body-parser.ts +597 -0
  31. package/src/middleware/router.ts +840 -0
  32. package/src/middleware/session.ts +271 -37
  33. package/src/types.ts +785 -0
  34. package/src/websocket.ts +356 -0
  35. package/build/cjs/api-router.d.ts +0 -34
  36. package/build/cjs/api-router.js +0 -52
  37. package/build/cjs/api-router.js.map +0 -1
  38. package/build/cjs/app-utils.d.ts +0 -13
  39. package/build/cjs/app-utils.js +0 -82
  40. package/build/cjs/app-utils.js.map +0 -1
  41. package/build/cjs/app.d.ts +0 -12
  42. package/build/cjs/app.js +0 -79
  43. package/build/cjs/app.js.map +0 -1
  44. package/build/cjs/common/api-router-types.d.ts +0 -28
  45. package/build/cjs/common/api-router-types.js +0 -17
  46. package/build/cjs/common/api-router-types.js.map +0 -1
  47. package/build/cjs/common/api-router-utils.d.ts +0 -3
  48. package/build/cjs/common/api-router-utils.js +0 -115
  49. package/build/cjs/common/api-router-utils.js.map +0 -1
  50. package/build/cjs/common/config/config.d.ts +0 -15
  51. package/build/cjs/common/config/config.js +0 -45
  52. package/build/cjs/common/config/config.js.map +0 -1
  53. package/build/cjs/common/config/featuretoggle.d.ts +0 -1
  54. package/build/cjs/common/config/featuretoggle.js +0 -10
  55. package/build/cjs/common/config/featuretoggle.js.map +0 -1
  56. package/build/cjs/common/config/index.d.ts +0 -3
  57. package/build/cjs/common/config/index.js +0 -20
  58. package/build/cjs/common/config/index.js.map +0 -1
  59. package/build/cjs/common/config/loader.d.ts +0 -13
  60. package/build/cjs/common/config/loader.js +0 -70
  61. package/build/cjs/common/config/loader.js.map +0 -1
  62. package/build/cjs/common/context.d.ts +0 -57
  63. package/build/cjs/common/context.js +0 -141
  64. package/build/cjs/common/context.js.map +0 -1
  65. package/build/cjs/common/error/badrequesterror.d.ts +0 -3
  66. package/build/cjs/common/error/badrequesterror.js +0 -11
  67. package/build/cjs/common/error/badrequesterror.js.map +0 -1
  68. package/build/cjs/common/error/configfilenotfound.d.ts +0 -3
  69. package/build/cjs/common/error/configfilenotfound.js +0 -11
  70. package/build/cjs/common/error/configfilenotfound.js.map +0 -1
  71. package/build/cjs/common/error/forbiddenerror.d.ts +0 -3
  72. package/build/cjs/common/error/forbiddenerror.js +0 -11
  73. package/build/cjs/common/error/forbiddenerror.js.map +0 -1
  74. package/build/cjs/common/error/index.d.ts +0 -6
  75. package/build/cjs/common/error/index.js +0 -23
  76. package/build/cjs/common/error/index.js.map +0 -1
  77. package/build/cjs/common/error/notfound.d.ts +0 -3
  78. package/build/cjs/common/error/notfound.js +0 -11
  79. package/build/cjs/common/error/notfound.js.map +0 -1
  80. package/build/cjs/common/error/notimplemented.d.ts +0 -3
  81. package/build/cjs/common/error/notimplemented.js +0 -11
  82. package/build/cjs/common/error/notimplemented.js.map +0 -1
  83. package/build/cjs/common/error/unauthorizederror.d.ts +0 -3
  84. package/build/cjs/common/error/unauthorizederror.js +0 -11
  85. package/build/cjs/common/error/unauthorizederror.js.map +0 -1
  86. package/build/cjs/common/index.d.ts +0 -11
  87. package/build/cjs/common/index.js +0 -34
  88. package/build/cjs/common/index.js.map +0 -1
  89. package/build/cjs/common/logger/constants.d.ts +0 -14
  90. package/build/cjs/common/logger/constants.js +0 -27
  91. package/build/cjs/common/logger/constants.js.map +0 -1
  92. package/build/cjs/common/logger/factory.d.ts +0 -16
  93. package/build/cjs/common/logger/factory.js +0 -53
  94. package/build/cjs/common/logger/factory.js.map +0 -1
  95. package/build/cjs/common/logger/index.d.ts +0 -5
  96. package/build/cjs/common/logger/index.js +0 -22
  97. package/build/cjs/common/logger/index.js.map +0 -1
  98. package/build/cjs/common/logger/interfaces.d.ts +0 -18
  99. package/build/cjs/common/logger/interfaces.js +0 -3
  100. package/build/cjs/common/logger/interfaces.js.map +0 -1
  101. package/build/cjs/common/logger/logger.d.ts +0 -35
  102. package/build/cjs/common/logger/logger.js +0 -100
  103. package/build/cjs/common/logger/logger.js.map +0 -1
  104. package/build/cjs/common/logger/transport/console.d.ts +0 -5
  105. package/build/cjs/common/logger/transport/console.js +0 -41
  106. package/build/cjs/common/logger/transport/console.js.map +0 -1
  107. package/build/cjs/common/logger/transport/file.d.ts +0 -2
  108. package/build/cjs/common/logger/transport/file.js +0 -29
  109. package/build/cjs/common/logger/transport/file.js.map +0 -1
  110. package/build/cjs/common/router-default-logger-factory.d.ts +0 -4
  111. package/build/cjs/common/router-default-logger-factory.js +0 -42
  112. package/build/cjs/common/router-default-logger-factory.js.map +0 -1
  113. package/build/cjs/common/router-handler.d.ts +0 -21
  114. package/build/cjs/common/router-handler.js +0 -161
  115. package/build/cjs/common/router-handler.js.map +0 -1
  116. package/build/cjs/common/router-types.d.ts +0 -58
  117. package/build/cjs/common/router-types.js +0 -58
  118. package/build/cjs/common/router-types.js.map +0 -1
  119. package/build/cjs/common/router-utils.d.ts +0 -3
  120. package/build/cjs/common/router-utils.js +0 -51
  121. package/build/cjs/common/router-utils.js.map +0 -1
  122. package/build/cjs/common/session/common.d.ts +0 -37
  123. package/build/cjs/common/session/common.js +0 -3
  124. package/build/cjs/common/session/common.js.map +0 -1
  125. package/build/cjs/common/session/index.d.ts +0 -2
  126. package/build/cjs/common/session/index.js +0 -19
  127. package/build/cjs/common/session/index.js.map +0 -1
  128. package/build/cjs/common/session/service.d.ts +0 -26
  129. package/build/cjs/common/session/service.js +0 -149
  130. package/build/cjs/common/session/service.js.map +0 -1
  131. package/build/cjs/common/tokenize-match.d.ts +0 -19
  132. package/build/cjs/common/tokenize-match.js +0 -79
  133. package/build/cjs/common/tokenize-match.js.map +0 -1
  134. package/build/cjs/common/url-utils.d.ts +0 -6
  135. package/build/cjs/common/url-utils.js +0 -54
  136. package/build/cjs/common/url-utils.js.map +0 -1
  137. package/build/cjs/index.d.ts +0 -7
  138. package/build/cjs/index.js +0 -24
  139. package/build/cjs/index.js.map +0 -1
  140. package/build/cjs/middleware/buffer.d.ts +0 -6
  141. package/build/cjs/middleware/buffer.js +0 -81
  142. package/build/cjs/middleware/buffer.js.map +0 -1
  143. package/build/cjs/middleware/cookie.d.ts +0 -4
  144. package/build/cjs/middleware/cookie.js +0 -19
  145. package/build/cjs/middleware/cookie.js.map +0 -1
  146. package/build/cjs/middleware/cors.d.ts +0 -8
  147. package/build/cjs/middleware/cors.js +0 -92
  148. package/build/cjs/middleware/cors.js.map +0 -1
  149. package/build/cjs/middleware/form.d.ts +0 -6
  150. package/build/cjs/middleware/form.js +0 -61
  151. package/build/cjs/middleware/form.js.map +0 -1
  152. package/build/cjs/middleware/group.d.ts +0 -2
  153. package/build/cjs/middleware/group.js +0 -79
  154. package/build/cjs/middleware/group.js.map +0 -1
  155. package/build/cjs/middleware/index.d.ts +0 -14
  156. package/build/cjs/middleware/index.js +0 -65
  157. package/build/cjs/middleware/index.js.map +0 -1
  158. package/build/cjs/middleware/json.d.ts +0 -6
  159. package/build/cjs/middleware/json.js +0 -58
  160. package/build/cjs/middleware/json.js.map +0 -1
  161. package/build/cjs/middleware/logger.d.ts +0 -4
  162. package/build/cjs/middleware/logger.js +0 -20
  163. package/build/cjs/middleware/logger.js.map +0 -1
  164. package/build/cjs/middleware/parse.d.ts +0 -13
  165. package/build/cjs/middleware/parse.js +0 -82
  166. package/build/cjs/middleware/parse.js.map +0 -1
  167. package/build/cjs/middleware/result.d.ts +0 -8
  168. package/build/cjs/middleware/result.js +0 -58
  169. package/build/cjs/middleware/result.js.map +0 -1
  170. package/build/cjs/middleware/session.d.ts +0 -2
  171. package/build/cjs/middleware/session.js +0 -151
  172. package/build/cjs/middleware/session.js.map +0 -1
  173. package/build/cjs/middleware/tag.d.ts +0 -4
  174. package/build/cjs/middleware/tag.js +0 -14
  175. package/build/cjs/middleware/tag.js.map +0 -1
  176. package/build/cjs/middleware/text.d.ts +0 -5
  177. package/build/cjs/middleware/text.js +0 -49
  178. package/build/cjs/middleware/text.js.map +0 -1
  179. package/build/cjs/proxy.d.ts +0 -19
  180. package/build/cjs/proxy.js +0 -78
  181. package/build/cjs/proxy.js.map +0 -1
  182. package/build/cjs/router.d.ts +0 -26
  183. package/build/cjs/router.js +0 -120
  184. package/build/cjs/router.js.map +0 -1
  185. package/build/cjs/static.d.ts +0 -14
  186. package/build/cjs/static.js +0 -212
  187. package/build/cjs/static.js.map +0 -1
  188. package/build/esm/api-router.d.ts +0 -34
  189. package/build/esm/api-router.js +0 -48
  190. package/build/esm/api-router.js.map +0 -1
  191. package/build/esm/app-utils.d.ts +0 -13
  192. package/build/esm/app-utils.js +0 -78
  193. package/build/esm/app-utils.js.map +0 -1
  194. package/build/esm/app.d.ts +0 -12
  195. package/build/esm/app.js +0 -74
  196. package/build/esm/app.js.map +0 -1
  197. package/build/esm/common/api-router-types.d.ts +0 -28
  198. package/build/esm/common/api-router-types.js +0 -14
  199. package/build/esm/common/api-router-types.js.map +0 -1
  200. package/build/esm/common/api-router-utils.d.ts +0 -3
  201. package/build/esm/common/api-router-utils.js +0 -111
  202. package/build/esm/common/api-router-utils.js.map +0 -1
  203. package/build/esm/common/config/config.d.ts +0 -15
  204. package/build/esm/common/config/config.js +0 -38
  205. package/build/esm/common/config/config.js.map +0 -1
  206. package/build/esm/common/config/featuretoggle.d.ts +0 -1
  207. package/build/esm/common/config/featuretoggle.js +0 -6
  208. package/build/esm/common/config/featuretoggle.js.map +0 -1
  209. package/build/esm/common/config/index.d.ts +0 -3
  210. package/build/esm/common/config/index.js +0 -4
  211. package/build/esm/common/config/index.js.map +0 -1
  212. package/build/esm/common/config/loader.d.ts +0 -13
  213. package/build/esm/common/config/loader.js +0 -64
  214. package/build/esm/common/config/loader.js.map +0 -1
  215. package/build/esm/common/context.d.ts +0 -57
  216. package/build/esm/common/context.js +0 -137
  217. package/build/esm/common/context.js.map +0 -1
  218. package/build/esm/common/error/badrequesterror.d.ts +0 -3
  219. package/build/esm/common/error/badrequesterror.js +0 -7
  220. package/build/esm/common/error/badrequesterror.js.map +0 -1
  221. package/build/esm/common/error/configfilenotfound.d.ts +0 -3
  222. package/build/esm/common/error/configfilenotfound.js +0 -7
  223. package/build/esm/common/error/configfilenotfound.js.map +0 -1
  224. package/build/esm/common/error/forbiddenerror.d.ts +0 -3
  225. package/build/esm/common/error/forbiddenerror.js +0 -7
  226. package/build/esm/common/error/forbiddenerror.js.map +0 -1
  227. package/build/esm/common/error/index.d.ts +0 -6
  228. package/build/esm/common/error/index.js +0 -7
  229. package/build/esm/common/error/index.js.map +0 -1
  230. package/build/esm/common/error/notfound.d.ts +0 -3
  231. package/build/esm/common/error/notfound.js +0 -7
  232. package/build/esm/common/error/notfound.js.map +0 -1
  233. package/build/esm/common/error/notimplemented.d.ts +0 -3
  234. package/build/esm/common/error/notimplemented.js +0 -7
  235. package/build/esm/common/error/notimplemented.js.map +0 -1
  236. package/build/esm/common/error/unauthorizederror.d.ts +0 -3
  237. package/build/esm/common/error/unauthorizederror.js +0 -7
  238. package/build/esm/common/error/unauthorizederror.js.map +0 -1
  239. package/build/esm/common/index.d.ts +0 -11
  240. package/build/esm/common/index.js +0 -12
  241. package/build/esm/common/index.js.map +0 -1
  242. package/build/esm/common/logger/constants.d.ts +0 -14
  243. package/build/esm/common/logger/constants.js +0 -22
  244. package/build/esm/common/logger/constants.js.map +0 -1
  245. package/build/esm/common/logger/factory.d.ts +0 -16
  246. package/build/esm/common/logger/factory.js +0 -47
  247. package/build/esm/common/logger/factory.js.map +0 -1
  248. package/build/esm/common/logger/index.d.ts +0 -5
  249. package/build/esm/common/logger/index.js +0 -6
  250. package/build/esm/common/logger/index.js.map +0 -1
  251. package/build/esm/common/logger/interfaces.d.ts +0 -18
  252. package/build/esm/common/logger/interfaces.js +0 -2
  253. package/build/esm/common/logger/interfaces.js.map +0 -1
  254. package/build/esm/common/logger/logger.d.ts +0 -35
  255. package/build/esm/common/logger/logger.js +0 -95
  256. package/build/esm/common/logger/logger.js.map +0 -1
  257. package/build/esm/common/logger/transport/console.d.ts +0 -5
  258. package/build/esm/common/logger/transport/console.js +0 -37
  259. package/build/esm/common/logger/transport/console.js.map +0 -1
  260. package/build/esm/common/logger/transport/file.d.ts +0 -2
  261. package/build/esm/common/logger/transport/file.js +0 -25
  262. package/build/esm/common/logger/transport/file.js.map +0 -1
  263. package/build/esm/common/router-default-logger-factory.d.ts +0 -4
  264. package/build/esm/common/router-default-logger-factory.js +0 -37
  265. package/build/esm/common/router-default-logger-factory.js.map +0 -1
  266. package/build/esm/common/router-handler.d.ts +0 -21
  267. package/build/esm/common/router-handler.js +0 -157
  268. package/build/esm/common/router-handler.js.map +0 -1
  269. package/build/esm/common/router-types.d.ts +0 -58
  270. package/build/esm/common/router-types.js +0 -54
  271. package/build/esm/common/router-types.js.map +0 -1
  272. package/build/esm/common/router-utils.d.ts +0 -3
  273. package/build/esm/common/router-utils.js +0 -46
  274. package/build/esm/common/router-utils.js.map +0 -1
  275. package/build/esm/common/session/common.d.ts +0 -37
  276. package/build/esm/common/session/common.js +0 -2
  277. package/build/esm/common/session/common.js.map +0 -1
  278. package/build/esm/common/session/index.d.ts +0 -2
  279. package/build/esm/common/session/index.js +0 -3
  280. package/build/esm/common/session/index.js.map +0 -1
  281. package/build/esm/common/session/service.js +0 -145
  282. package/build/esm/common/session/service.js.map +0 -1
  283. package/build/esm/common/tokenize-match.d.ts +0 -19
  284. package/build/esm/common/tokenize-match.js +0 -73
  285. package/build/esm/common/tokenize-match.js.map +0 -1
  286. package/build/esm/common/url-utils.d.ts +0 -6
  287. package/build/esm/common/url-utils.js +0 -48
  288. package/build/esm/common/url-utils.js.map +0 -1
  289. package/build/esm/index.d.ts +0 -7
  290. package/build/esm/index.js +0 -8
  291. package/build/esm/index.js.map +0 -1
  292. package/build/esm/middleware/buffer.d.ts +0 -6
  293. package/build/esm/middleware/buffer.js +0 -77
  294. package/build/esm/middleware/buffer.js.map +0 -1
  295. package/build/esm/middleware/cookie.d.ts +0 -4
  296. package/build/esm/middleware/cookie.js +0 -15
  297. package/build/esm/middleware/cookie.js.map +0 -1
  298. package/build/esm/middleware/cors.d.ts +0 -8
  299. package/build/esm/middleware/cors.js +0 -88
  300. package/build/esm/middleware/cors.js.map +0 -1
  301. package/build/esm/middleware/form.d.ts +0 -6
  302. package/build/esm/middleware/form.js +0 -57
  303. package/build/esm/middleware/form.js.map +0 -1
  304. package/build/esm/middleware/group.d.ts +0 -2
  305. package/build/esm/middleware/group.js +0 -75
  306. package/build/esm/middleware/group.js.map +0 -1
  307. package/build/esm/middleware/index.d.ts +0 -14
  308. package/build/esm/middleware/index.js +0 -46
  309. package/build/esm/middleware/index.js.map +0 -1
  310. package/build/esm/middleware/json.d.ts +0 -6
  311. package/build/esm/middleware/json.js +0 -54
  312. package/build/esm/middleware/json.js.map +0 -1
  313. package/build/esm/middleware/logger.d.ts +0 -4
  314. package/build/esm/middleware/logger.js +0 -16
  315. package/build/esm/middleware/logger.js.map +0 -1
  316. package/build/esm/middleware/parse.d.ts +0 -13
  317. package/build/esm/middleware/parse.js +0 -78
  318. package/build/esm/middleware/parse.js.map +0 -1
  319. package/build/esm/middleware/result.d.ts +0 -8
  320. package/build/esm/middleware/result.js +0 -54
  321. package/build/esm/middleware/result.js.map +0 -1
  322. package/build/esm/middleware/session.d.ts +0 -2
  323. package/build/esm/middleware/session.js +0 -147
  324. package/build/esm/middleware/session.js.map +0 -1
  325. package/build/esm/middleware/tag.d.ts +0 -4
  326. package/build/esm/middleware/tag.js +0 -10
  327. package/build/esm/middleware/tag.js.map +0 -1
  328. package/build/esm/middleware/text.d.ts +0 -5
  329. package/build/esm/middleware/text.js +0 -45
  330. package/build/esm/middleware/text.js.map +0 -1
  331. package/build/esm/proxy.d.ts +0 -19
  332. package/build/esm/proxy.js +0 -74
  333. package/build/esm/proxy.js.map +0 -1
  334. package/build/esm/router.d.ts +0 -26
  335. package/build/esm/router.js +0 -116
  336. package/build/esm/router.js.map +0 -1
  337. package/build/esm/static.d.ts +0 -14
  338. package/build/esm/static.js +0 -208
  339. package/build/esm/static.js.map +0 -1
  340. package/src/api-router.ts +0 -50
  341. package/src/app-utils.ts +0 -82
  342. package/src/app-utils.unit.test.js +0 -101
  343. package/src/app.unit.test.js +0 -334
  344. package/src/common/api-router-types.ts +0 -42
  345. package/src/common/api-router-utils.ts +0 -121
  346. package/src/common/config/config.ts +0 -49
  347. package/src/common/config/featuretoggle.ts +0 -6
  348. package/src/common/config/index.ts +0 -3
  349. package/src/common/config/loader.ts +0 -81
  350. package/src/common/context.ts +0 -192
  351. package/src/common/context.unit.test.js +0 -295
  352. package/src/common/error/badrequesterror.ts +0 -6
  353. package/src/common/error/configfilenotfound.ts +0 -6
  354. package/src/common/error/forbiddenerror.ts +0 -6
  355. package/src/common/error/index.ts +0 -6
  356. package/src/common/error/notfound.ts +0 -6
  357. package/src/common/error/notimplemented.ts +0 -6
  358. package/src/common/error/unauthorizederror.ts +0 -6
  359. package/src/common/index.ts +0 -11
  360. package/src/common/logger/constants.ts +0 -28
  361. package/src/common/logger/factory.ts +0 -53
  362. package/src/common/logger/index.ts +0 -6
  363. package/src/common/logger/interfaces.ts +0 -19
  364. package/src/common/logger/logger.ts +0 -136
  365. package/src/common/logger/transport/console.ts +0 -36
  366. package/src/common/logger/transport/file.ts +0 -26
  367. package/src/common/router-default-logger-factory.ts +0 -42
  368. package/src/common/router-handler.ts +0 -186
  369. package/src/common/router-types.ts +0 -117
  370. package/src/common/router-utils.ts +0 -47
  371. package/src/common/session/common.ts +0 -40
  372. package/src/common/session/index.ts +0 -2
  373. package/src/common/session/service.ts +0 -163
  374. package/src/common/tokenize-match.ts +0 -98
  375. package/src/common/url-utils.ts +0 -46
  376. package/src/index.ts +0 -7
  377. package/src/middleware/buffer.ts +0 -80
  378. package/src/middleware/cookie.ts +0 -20
  379. package/src/middleware/cors.ts +0 -96
  380. package/src/middleware/form.ts +0 -59
  381. package/src/middleware/group.ts +0 -70
  382. package/src/middleware/index.ts +0 -48
  383. package/src/middleware/json.ts +0 -55
  384. package/src/middleware/logger.ts +0 -18
  385. package/src/middleware/parse.ts +0 -94
  386. package/src/middleware/result.ts +0 -63
  387. package/src/middleware/tag.ts +0 -15
  388. package/src/middleware/text.ts +0 -45
  389. package/src/proxy.ts +0 -99
  390. package/src/proxy.unit.test.js +0 -160
  391. package/src/router.ts +0 -134
  392. package/src/router.unit.test.js +0 -412
  393. package/src/static.ts +0 -239
  394. package/test.out.txt +0 -3535
  395. package/tsconfig-esm.json +0 -26
package/src/router.ts DELETED
@@ -1,134 +0,0 @@
1
- import { RequestListener } from "http";
2
- import { Logger } from "./common/logger";
3
- import { Context, ErrorHandler, Handler, Method } from "./common/context";
4
- import { HandlerWithOptions, MinimalRouter, RouterHandlerOptions, RouterJSONDoc, RouterOptions } from "./common/router-types";
5
- import { PathPart, PathPartToken, splitPath } from "./common/tokenize-match";
6
- import { defaultLoggerFactory } from "./common/router-default-logger-factory";
7
- import { RouterHandler } from "./common/router-handler";
8
- import { randomUUID } from "crypto";
9
- import { normalizePath } from "./common/url-utils";
10
-
11
- export class Router implements MinimalRouter {
12
- protected readonly handlers: RouterHandler[] = [];
13
- protected readonly errorHandlers: ErrorHandler[] = [];
14
- public readonly listener: RequestListener;
15
-
16
- constructor(protected config?: RouterOptions) {
17
- const loggerFactory = this.config && this.config.loggerFactory ? this.config.loggerFactory : defaultLoggerFactory;
18
- this.listener = async (req, res) => {
19
- const uuid = randomUUID();
20
- const logger = loggerFactory(uuid, req);
21
- const ctx = new Context(uuid, req, res, logger);
22
- ctx.logger.trace(`request received`);
23
- await this.run(ctx);
24
- };
25
- }
26
-
27
- public get(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
28
- return this.use(handler, path, "get", options);
29
- }
30
-
31
- public post(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
32
- return this.use(handler, path, "post", options);
33
- }
34
-
35
- public patch(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
36
- return this.use(handler, path, "patch", options);
37
- }
38
-
39
- public delete(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
40
- return this.use(handler, path, "delete", options);
41
- }
42
-
43
- public put(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
44
- return this.use(handler, path, "put", options);
45
- }
46
-
47
- public options(path: string | undefined, handler: Array<Handler> | Handler | MinimalRouter | HandlerWithOptions, options?: RouterHandlerOptions): Router {
48
- return this.use(handler, path, "options", options);
49
- }
50
-
51
- public use(handler: Array<Handler> | HandlerWithOptions | Handler | MinimalRouter, path?: string, method?: Method, options?: RouterHandlerOptions): Router {
52
- const nPath = path !== undefined ? normalizePath(path) : undefined;
53
- const nMethod = method ? method.toUpperCase() as Method : method;
54
- this.handlers.push(new RouterHandler(handler, nPath, nMethod, options));
55
- return this;
56
- }
57
-
58
- public catch(errorHandler: Array<ErrorHandler> | ErrorHandler): Router {
59
- const errorHandlers = errorHandler instanceof Array ? errorHandler : [errorHandler];
60
- for (const e of errorHandlers) {
61
- if (typeof e !== "function") {
62
- throw new Error(`errorHandler ${e} not a function!`);
63
- }
64
- this.errorHandlers.push(e);
65
- }
66
- return this;
67
- }
68
-
69
- public async run(ctx: Context, pathTokens?: PathPart[], prePathTokens: PathPartToken[] = []): Promise<boolean> {
70
- pathTokens = pathTokens ? pathTokens : splitPath(ctx.path);
71
- try {
72
- for (const h of this.handlers) {
73
- if (ctx.res.headersSent) {
74
- break;
75
- }
76
- const isMatch = h.isMatch(ctx.method, pathTokens, prePathTokens);
77
- if (isMatch.match) {
78
- if (isMatch.params) {
79
- ctx.params = ctx.params ? {
80
- ...ctx.params,
81
- ...isMatch.params
82
- } : isMatch.params;
83
- }
84
- const shouldContinue = await h.invoke(ctx, pathTokens, prePathTokens);
85
- if (!shouldContinue) {
86
- break;
87
- }
88
- }
89
- }
90
- return !ctx.res.headersSent;
91
- } catch (e: any) {
92
- for (const eH of this.errorHandlers) {
93
- const ret = await eH(e, ctx);
94
- if (ret === false || ctx.res.headersSent) {
95
- return false;
96
- }
97
- }
98
- throw e; // pass the error along
99
- }
100
- }
101
-
102
- public getJSONDoc(doc: RouterJSONDoc = {}, prePath = "/"): RouterJSONDoc {
103
- for (const h of this.handlers) {
104
- doc = h.getJSONDoc(doc, prePath);
105
- }
106
- return doc;
107
- }
108
-
109
- public logPaths(logger: Logger): void {
110
- this.toString().split("\n").forEach(l=>logger.info(l));
111
- }
112
-
113
- public toString(): string {
114
- let ret = "";
115
- const doc = this.getJSONDoc();
116
- const paths = Object.keys(doc);
117
-
118
- for(const path of paths) {
119
- if (path) {
120
- const pathData = doc[path];
121
-
122
- const methods = Object.keys(pathData);
123
-
124
- for (const method of methods) {
125
- if (method) {
126
- const methodData = pathData[method];
127
- ret += `${ret === "" ? "" : "\n"}${method}:${path}\n\t${methodData.identifier}${methodData.name ? `\n\t\t${methodData.name}` : ""}${methodData.description ? `\n\t\t${methodData.description}` : ""}`;
128
- }
129
- }
130
- }
131
- }
132
- return ret;
133
- }
134
- }
@@ -1,412 +0,0 @@
1
- const { fake, requireMock } = require("@miqro/test");
2
- const { resolve } = require("path");
3
- const { strictEqual } = require("assert");
4
- const { format } = require("util");
5
- const { distPath, basePath } = require("./setup-test.js");
6
- const { describe, it, before } = require("node:test");
7
-
8
- const testFilePath = resolve(distPath, "router.js");
9
-
10
- describe("router unit tests", () => {
11
-
12
- describe("this.run", () => {
13
- [
14
- { prePathTokens: undefined },
15
- { prePathTokens: ["prePathTokens1"] }
16
- ].forEach(({ prePathTokens }) => {
17
- [
18
- {
19
- pathTokens: undefined
20
- },
21
- {
22
- pathTokens: "pathTokens"
23
- }
24
- ].forEach(({ pathTokens }) => {
25
- let router, splitPath;
26
- const splitPathRet = "splitPathRet";
27
-
28
- function createFakeHandler({ isMatch, invokeEnds, throws }) {
29
- return {
30
- invoke: fake((ctx) => {
31
- if (throws) {
32
- throw new Error("fakeHandlerError");
33
- }
34
- if (invokeEnds) {
35
- ctx.res.headersSent = true;
36
- }
37
- return invokeEnds ? false : true;
38
- }),
39
- isMatch: fake(() => {
40
- return {
41
- match: isMatch
42
- };
43
- })
44
- };
45
- }
46
-
47
- function createFakeContext() {
48
- return {
49
- method: "method",
50
- res: {
51
- headersSent: false
52
- }
53
- };
54
- }
55
-
56
-
57
- splitPath = fake(() => {
58
- return splitPathRet;
59
- });
60
- function beforeCB() {
61
- splitPath.reset();
62
- const { Router } = requireMock(testFilePath, {
63
- "http": {},
64
-
65
- "./common/logger": {},
66
- "./common/context": {},
67
- "./common/router-utils": {},
68
- "./common/router-default-logger-factory": {},
69
- "./common/router-handler": {},
70
- "./common/tokenize-match": {
71
- splitPath
72
- }
73
- }, distPath);
74
- router = new Router();
75
- }
76
- //before(beforeCB);
77
- describe("some handlers match with " + prePathTokens + " " + pathTokens, () => {
78
- it("one handler ends response", async () => {
79
- beforeCB()
80
- router.handlers = [
81
- createFakeHandler({ invokeEnds: false, isMatch: true }),
82
- createFakeHandler({ invokeEnds: false, isMatch: true }),
83
- createFakeHandler({ invokeEnds: false, isMatch: false }),
84
- createFakeHandler({ invokeEnds: true, isMatch: true }),
85
- createFakeHandler({ invokeEnds: true, isMatch: true })
86
- ];
87
- const context = createFakeContext();
88
- const ret = await router.run(context, pathTokens, prePathTokens);
89
- strictEqual(router.handlers.filter(r => r.isMatch.callCount === 1).length, router.handlers.length - 1);
90
- strictEqual(splitPath.callCount, pathTokens ? 0 : 1);
91
- strictEqual(router.handlers[0].isMatch.callArgs[0][0], context.method);
92
- strictEqual(router.handlers[0].isMatch.callArgs[0][1], pathTokens ? pathTokens : splitPathRet);
93
- strictEqual(router.handlers[0].isMatch.callArgs[0][2].length, prePathTokens ? prePathTokens.length : 0);
94
- if (prePathTokens) {
95
- strictEqual(router.handlers[0].isMatch.callArgs[0][2], prePathTokens);
96
- }
97
- strictEqual(router.handlers[0].invoke.callCount, 1);
98
- strictEqual(router.handlers[0].invoke.callArgs[0][0], context);
99
- strictEqual(router.handlers[0].invoke.callArgs[0][1], pathTokens ? pathTokens : splitPathRet);
100
- strictEqual(router.handlers[0].invoke.callArgs[0][2].length, prePathTokens ? prePathTokens.length : 0);
101
- if (prePathTokens) {
102
- strictEqual(router.handlers[0].invoke.callArgs[0][2], prePathTokens);
103
- }
104
- strictEqual(router.handlers[1].invoke.callCount, 1);
105
- strictEqual(router.handlers[2].invoke.callCount, 0);
106
- strictEqual(router.handlers[3].invoke.callCount, 1);
107
- strictEqual(router.handlers[4].invoke.callCount, 0);
108
- });
109
-
110
- it("no handler ends response", async () => {
111
- beforeCB();
112
- router.handlers = [
113
- createFakeHandler({ invokeEnds: false, isMatch: true }),
114
- createFakeHandler({ invokeEnds: false, isMatch: true }),
115
- createFakeHandler({ invokeEnds: false, isMatch: false }),
116
- createFakeHandler({ invokeEnds: false, isMatch: true }),
117
- createFakeHandler({ invokeEnds: false, isMatch: true })
118
- ];
119
- const context = createFakeContext();
120
- const ret = await router.run(context, pathTokens, prePathTokens);
121
- strictEqual(router.handlers.filter(r => r.isMatch.callCount === 1).length, router.handlers.length);
122
- strictEqual(splitPath.callCount, pathTokens ? 0 : 1);
123
- strictEqual(router.handlers[0].invoke.callCount, 1);
124
- strictEqual(router.handlers[1].invoke.callCount, 1);
125
- strictEqual(router.handlers[2].invoke.callCount, 0);
126
- strictEqual(router.handlers[3].invoke.callCount, 1);
127
- strictEqual(router.handlers[4].invoke.callCount, 1);
128
- });
129
-
130
- it("one handler throws second errorHandler catches", async () => {
131
- beforeCB();
132
- router.handlers = [
133
- createFakeHandler({ invokeEnds: false, isMatch: true }),
134
- createFakeHandler({ invokeEnds: false, isMatch: true, throws: true }),
135
- createFakeHandler({ invokeEnds: false, isMatch: false }),
136
- createFakeHandler({ invokeEnds: true, isMatch: true }),
137
- createFakeHandler({ invokeEnds: false, isMatch: true })
138
- ];
139
- const errorHandlerMisses = fake(() => {
140
-
141
- });
142
- const errorHandler = fake((e, ctx) => {
143
- ctx.res.headersSent = true;
144
- });
145
- const context = createFakeContext();
146
- router.catch([errorHandlerMisses, errorHandler]);
147
- const ret = await router.run(context, pathTokens, prePathTokens);
148
- strictEqual(router.handlers.filter(r => r.isMatch.callCount === 1).length, 2);
149
- strictEqual(splitPath.callCount, pathTokens ? 0 : 1);
150
- strictEqual(router.handlers[0].invoke.callCount, 1);
151
- strictEqual(router.handlers[1].invoke.callCount, 1);
152
- strictEqual(router.handlers[2].invoke.callCount, 0);
153
- strictEqual(router.handlers[3].invoke.callCount, 0);
154
- strictEqual(router.handlers[4].invoke.callCount, 0);
155
- strictEqual(errorHandlerMisses.callCount, 1);
156
- strictEqual(errorHandler.callCount, 1);
157
- });
158
-
159
- it("one handler throws first errorHandler catches", async () => {
160
- beforeCB();
161
- router.handlers = [
162
- createFakeHandler({ invokeEnds: false, isMatch: true }),
163
- createFakeHandler({ invokeEnds: false, isMatch: true, throws: true }),
164
- createFakeHandler({ invokeEnds: false, isMatch: false }),
165
- createFakeHandler({ invokeEnds: true, isMatch: true }),
166
- createFakeHandler({ invokeEnds: false, isMatch: true })
167
- ];
168
- const errorHandlerMisses = fake(() => {
169
-
170
- });
171
- const errorHandler = fake((e, ctx) => {
172
- ctx.res.headersSent = true;
173
- });
174
- const context = createFakeContext();
175
- router.catch([errorHandler, errorHandlerMisses]);
176
- const ret = await router.run(context, pathTokens, prePathTokens);
177
- strictEqual(router.handlers.filter(r => r.isMatch.callCount === 1).length, 2);
178
- strictEqual(splitPath.callCount, pathTokens ? 0 : 1);
179
- strictEqual(router.handlers[0].invoke.callCount, 1);
180
- strictEqual(router.handlers[1].invoke.callCount, 1);
181
- strictEqual(router.handlers[2].invoke.callCount, 0);
182
- strictEqual(router.handlers[3].invoke.callCount, 0);
183
- strictEqual(router.handlers[4].invoke.callCount, 0);
184
- strictEqual(errorHandlerMisses.callCount, 0);
185
- strictEqual(errorHandler.callCount, 1);
186
- });
187
-
188
- it("one handler throws errorHandler doesn't catch", async () => {
189
- beforeCB();
190
- router.handlers = [
191
- createFakeHandler({ invokeEnds: false, isMatch: true }),
192
- createFakeHandler({ invokeEnds: false, isMatch: true, throws: true }),
193
- createFakeHandler({ invokeEnds: false, isMatch: false }),
194
- createFakeHandler({ invokeEnds: true, isMatch: true }),
195
- createFakeHandler({ invokeEnds: false, isMatch: true })
196
- ];
197
- const context = createFakeContext();
198
- try {
199
- const ret = await router.run(context, pathTokens, prePathTokens);
200
- strictEqual(false, true);
201
- } catch (e) {
202
- strictEqual(e.message, "fakeHandlerError")
203
- }
204
- strictEqual(router.handlers.filter(r => r.isMatch.callCount === 1).length, 2);
205
- strictEqual(splitPath.callCount, pathTokens ? 0 : 1);
206
- strictEqual(router.handlers[0].invoke.callCount, 1);
207
- strictEqual(router.handlers[1].invoke.callCount, 1);
208
- strictEqual(router.handlers[2].invoke.callCount, 0);
209
- strictEqual(router.handlers[3].invoke.callCount, 0);
210
- strictEqual(router.handlers[4].invoke.callCount, 0);
211
- });
212
- });
213
- });
214
- });
215
- });
216
-
217
- [
218
- { method: "options" },
219
- { method: "put" },
220
- { method: "patch" },
221
- { method: "delete" },
222
- { method: "post" },
223
- { method: "get" }
224
- ].forEach(({ method }) => {
225
- let router;
226
- function beforeCB() {
227
- const { Router } = requireMock(testFilePath, {
228
- "http": {},
229
-
230
- "./common/logger": {},
231
- "./common/context": {},
232
- "./common/router-utils": {},
233
- "./common/router-default-logger-factory": {},
234
- "./common/router-handler": {},
235
- "./common/tokenize-match": {}
236
- }, distPath);
237
- router = new Router();
238
- }
239
- //before(beforeCB);
240
- it(method + " just alias for use", async () => {
241
- beforeCB();
242
- router.use = fake(() => {
243
- });
244
- const path = "path";
245
- const handler = "handler";
246
- const options = "options";
247
- router[method](path, handler, options);
248
- strictEqual(router.use.callCount, 1);
249
- strictEqual(router.use.callArgs[0][0], handler);
250
- strictEqual(router.use.callArgs[0][1], path);
251
- strictEqual(router.use.callArgs[0][2], method);
252
- strictEqual(router.use.callArgs[0][3], options);
253
- });
254
- });
255
-
256
- describe("this.catch", () => {
257
-
258
- let router;
259
- function beforeCB() {
260
- const { Router } = requireMock(testFilePath, {
261
- "http": {},
262
-
263
- "./common/logger": {},
264
- "./common/context": {},
265
- "./common/router-utils": {},
266
- "./common/router-default-logger-factory": {},
267
- "./common/router-handler": {},
268
- "./common/tokenize-match": {}
269
- }, distPath);
270
- router = new Router();
271
- }
272
- //before(beforeCB);
273
- [
274
- {
275
- errorHandler: [
276
- () => {
277
- },
278
- () => {
279
- }
280
- ]
281
- },
282
- {
283
- errorHandler: () => {
284
- }
285
- },
286
- {
287
- errorHandler: undefined,
288
- throws: true,
289
- },
290
- {
291
- errorHandler: [
292
- () => {
293
- },
294
- undefined
295
- ],
296
- throws: true
297
- }
298
- ].forEach(({ errorHandler, throws }) => {
299
- it(format("errorHandler %o throws %o", errorHandler, throws), () => {
300
- beforeCB();
301
- router.errorHandlers = {
302
- push: fake(() => {
303
-
304
- })
305
- };
306
- try {
307
- const ret = router.catch(errorHandler);
308
- strictEqual(undefined, throws);
309
- strictEqual(ret, router);
310
- } catch (e) {
311
- strictEqual(true, throws);
312
- } finally {
313
- const count = (!errorHandler ? [] : (errorHandler instanceof Array ? errorHandler : [errorHandler])).filter(m => typeof m === "function").length;
314
- strictEqual(router.errorHandlers.push.callCount, count);
315
- }
316
- });
317
- });
318
- });
319
-
320
- describe("this.use", () => {
321
- let RouterHandler, router, routerHandlerCtr, normalizePath, splitPath;
322
- const normalizePathRet = "normalizePathRet";
323
-
324
- function beforeCB() {
325
- routerHandlerCtr = fake(() => {
326
-
327
- });
328
-
329
- normalizePath = fake(() => {
330
- return normalizePathRet;
331
- });
332
-
333
- splitPath = fake(() => {
334
-
335
- });
336
-
337
- RouterHandler = class {
338
- constructor() {
339
- routerHandlerCtr(...arguments);
340
- }
341
- }
342
-
343
- const { Router } = requireMock(testFilePath, {
344
- "http": {},
345
- "./common/logger": {},
346
- "./common/context": {},
347
- "./common/router-utils": {},
348
- "./common/router-default-logger-factory": {},
349
- "./common/router-handler": {
350
- RouterHandler
351
- },
352
- "./common/url-utils": {
353
- normalizePath
354
- },
355
- "./common/tokenize-match": {
356
- splitPath
357
- }
358
- }, distPath);
359
- router = new Router();
360
- }
361
-
362
- //before(beforeCB);
363
-
364
- [
365
- { handler: "handler" },
366
- { handler: undefined },
367
- { handler: ["handler1", "handler2"] }
368
- ].forEach(({ handler }) => {
369
- [
370
- { options: "options" },
371
- { options: undefined }
372
- ].forEach(({ options }) => {
373
- [
374
- {
375
- path: "path",
376
- method: "method"
377
- },
378
- {
379
- path: "path"
380
- },
381
- {}
382
- ].forEach(
383
- ({
384
- path,
385
- method
386
- }) => {
387
- it(`use with handler ${handler} path ${path} method ${method} options ${options}`, async () => {
388
- beforeCB();
389
- router.handlers = {
390
- push: fake(() => {
391
-
392
- })
393
- }
394
- const ret = router.use(handler, path, method, options);
395
- strictEqual(ret, router);
396
- strictEqual(normalizePath.callCount, path !== undefined ? 1 : 0);
397
- if (path) {
398
- strictEqual(normalizePath.callArgs[0][0], path);
399
- }
400
- strictEqual(routerHandlerCtr.callCount, 1);
401
- strictEqual(routerHandlerCtr.callArgs[0][0], handler);
402
- strictEqual(routerHandlerCtr.callArgs[0][1], path ? normalizePathRet : path);
403
- strictEqual(routerHandlerCtr.callArgs[0][2], method ? method.toUpperCase() : method);
404
- strictEqual(routerHandlerCtr.callArgs[0][3], options);
405
- strictEqual(router.handlers.push.callCount, 1);
406
- strictEqual(router.handlers.push.callArgs[0][0] instanceof RouterHandler, true);
407
- });
408
- });
409
- });
410
- });
411
- });
412
- });