index.cjs 59 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045
  1. "use strict";
  2. var __create = Object.create;
  3. var __defProp = Object.defineProperty;
  4. var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
  5. var __getOwnPropNames = Object.getOwnPropertyNames;
  6. var __getProtoOf = Object.getPrototypeOf;
  7. var __hasOwnProp = Object.prototype.hasOwnProperty;
  8. var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
  9. var __export = (target, all) => {
  10. for (var name in all)
  11. __defProp(target, name, { get: all[name], enumerable: true });
  12. };
  13. var __copyProps = (to, from, except, desc) => {
  14. if (from && typeof from === "object" || typeof from === "function") {
  15. for (let key of __getOwnPropNames(from))
  16. if (!__hasOwnProp.call(to, key) && key !== except)
  17. __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  18. }
  19. return to;
  20. };
  21. var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
  22. // If the importer is in node compatibility mode or this is not an ESM
  23. // file that has been converted to a CommonJS file using a Babel-
  24. // compatible transform (i.e. "__esModule" has not been set), then set
  25. // "default" to the CommonJS "module.exports" for node compatibility.
  26. isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
  27. mod
  28. ));
  29. var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
  30. // src/index.js
  31. var index_exports = {};
  32. __export(index_exports, {
  33. BodyParser: () => BodyParser,
  34. CHARACTER_ENCODING_LIST: () => CHARACTER_ENCODING_LIST,
  35. CookiesParser: () => CookiesParser,
  36. DataSender: () => DataSender,
  37. EXPOSED_ERROR_PROPERTIES: () => EXPOSED_ERROR_PROPERTIES,
  38. ErrorSender: () => ErrorSender,
  39. HookInvoker: () => HookInvoker,
  40. HookRegistry: () => HookRegistry,
  41. HttpMethod: () => HttpMethod,
  42. METHODS_WITH_BODY: () => METHODS_WITH_BODY,
  43. QueryParser: () => QueryParser,
  44. RequestContext: () => RequestContext,
  45. RequestParser: () => RequestParser,
  46. Route: () => Route,
  47. RouteRegistry: () => RouteRegistry,
  48. RouterHookType: () => RouterHookType,
  49. RouterOptions: () => RouterOptions,
  50. TrieRouter: () => TrieRouter,
  51. UNPARSABLE_MEDIA_TYPES: () => UNPARSABLE_MEDIA_TYPES,
  52. cloneDeep: () => cloneDeep,
  53. createCookieString: () => createCookieString,
  54. createError: () => createError,
  55. createRequestMock: () => createRequestMock,
  56. createResponseMock: () => createResponseMock,
  57. createRouteMock: () => createRouteMock,
  58. fetchRequestBody: () => fetchRequestBody,
  59. getRequestPathname: () => getRequestPathname,
  60. isPromise: () => isPromise,
  61. isReadableStream: () => isReadableStream,
  62. isResponseSent: () => isResponseSent,
  63. isWritableStream: () => isWritableStream,
  64. parseContentType: () => parseContentType,
  65. parseCookieString: () => parseCookieString,
  66. parseJsonBody: () => parseJsonBody,
  67. toCamelCase: () => toCamelCase,
  68. validateRouteDefinition: () => validateRouteDefinition
  69. });
  70. module.exports = __toCommonJS(index_exports);
  71. // src/route/route.js
  72. var import_js_debug = require("@e22m4u/js-debug");
  73. // src/hooks/hook-invoker.js
  74. var import_js_format11 = require("@e22m4u/js-format");
  75. // src/debuggable-service.js
  76. var import_js_service = require("@e22m4u/js-service");
  77. var MODULE_DEBUG_NAMESPACE = "jsTrieRouter";
  78. var _DebuggableService = class _DebuggableService extends import_js_service.DebuggableService {
  79. /**
  80. * Constructor.
  81. *
  82. * @param {ServiceContainer} container
  83. */
  84. constructor(container = void 0) {
  85. super(container, {
  86. namespace: MODULE_DEBUG_NAMESPACE,
  87. noEnvironmentNamespace: true
  88. });
  89. }
  90. };
  91. __name(_DebuggableService, "DebuggableService");
  92. var DebuggableService = _DebuggableService;
  93. // src/utils/clone-deep.js
  94. function cloneDeep(value) {
  95. if (value == null || typeof value !== "object") {
  96. return value;
  97. }
  98. if (value instanceof Date) {
  99. return new Date(value.getTime());
  100. }
  101. if (Array.isArray(value)) {
  102. return value.map((item) => cloneDeep(item));
  103. }
  104. const proto = Object.getPrototypeOf(value);
  105. if (proto === Object.prototype || proto === null) {
  106. const newObj = proto === null ? /* @__PURE__ */ Object.create(null) : {};
  107. for (const key in value) {
  108. if (Object.prototype.hasOwnProperty.call(value, key)) {
  109. newObj[key] = cloneDeep(value[key]);
  110. }
  111. }
  112. return newObj;
  113. }
  114. return value;
  115. }
  116. __name(cloneDeep, "cloneDeep");
  117. // src/utils/is-promise.js
  118. function isPromise(value) {
  119. if (!value) {
  120. return false;
  121. }
  122. if (typeof value !== "object") {
  123. return false;
  124. }
  125. return typeof value.then === "function";
  126. }
  127. __name(isPromise, "isPromise");
  128. // src/utils/create-error.js
  129. var import_js_format = require("@e22m4u/js-format");
  130. function createError(errorCtor, message, ...args) {
  131. if (typeof errorCtor !== "function") {
  132. throw new import_js_format.InvalidArgumentError(
  133. 'The first parameter of "createError" must be a constructor, but %v was given.',
  134. errorCtor
  135. );
  136. }
  137. if (message != null && typeof message !== "string") {
  138. throw new import_js_format.InvalidArgumentError(
  139. 'The second parameter of "createError" must be a String, but %v was given.',
  140. message
  141. );
  142. }
  143. if (message == null) {
  144. return new errorCtor();
  145. }
  146. const interpolatedMessage = (0, import_js_format.format)(message, ...args);
  147. return new errorCtor(interpolatedMessage);
  148. }
  149. __name(createError, "createError");
  150. // src/utils/to-camel-case.js
  151. var import_js_format2 = require("@e22m4u/js-format");
  152. function toCamelCase(input) {
  153. if (typeof input !== "string") {
  154. throw new import_js_format2.InvalidArgumentError(
  155. 'The first parameter of "toCamelCase" must be a String, but %v was given.',
  156. input
  157. );
  158. }
  159. return input.replace(/(^\w|[A-Z]|\b\w)/g, (c) => c.toUpperCase()).replace(/\W+/g, "").replace(/(^\w)/g, (c) => c.toLowerCase());
  160. }
  161. __name(toCamelCase, "toCamelCase");
  162. // src/utils/is-response-sent.js
  163. var import_js_format3 = require("@e22m4u/js-format");
  164. function isResponseSent(response) {
  165. if (!response || typeof response !== "object" || Array.isArray(response) || typeof response.headersSent !== "boolean") {
  166. throw new import_js_format3.InvalidArgumentError(
  167. 'The first parameter of "isResponseSent" must be an instance of ServerResponse, but %v was given.',
  168. response
  169. );
  170. }
  171. return response.headersSent;
  172. }
  173. __name(isResponseSent, "isResponseSent");
  174. // src/utils/create-route-mock.js
  175. function createRouteMock(options = {}) {
  176. return new Route({
  177. method: options.method || HttpMethod.GET,
  178. path: options.path || "/",
  179. handler: options.handler || (() => "OK")
  180. });
  181. }
  182. __name(createRouteMock, "createRouteMock");
  183. // src/utils/is-readable-stream.js
  184. function isReadableStream(value) {
  185. if (!value || typeof value !== "object") {
  186. return false;
  187. }
  188. return typeof value.pipe === "function";
  189. }
  190. __name(isReadableStream, "isReadableStream");
  191. // src/utils/parse-content-type.js
  192. var import_js_format4 = require("@e22m4u/js-format");
  193. function parseContentType(input) {
  194. if (typeof input !== "string") {
  195. throw new import_js_format4.InvalidArgumentError(
  196. "The first parameter of `parseContentType` must be a String, but %v was given.",
  197. input
  198. );
  199. }
  200. const res = { mediaType: void 0, charset: void 0, boundary: void 0 };
  201. const re = /^\s*([^\s;/]+\/[^\s;/]+)(?:;\s*charset=([^\s;]+))?(?:;\s*boundary=([^\s;]+))?.*$/i;
  202. const matches = re.exec(input);
  203. if (matches && matches[1]) {
  204. res.mediaType = matches[1];
  205. if (matches[2]) {
  206. res.charset = matches[2];
  207. }
  208. if (matches[3]) {
  209. res.boundary = matches[3];
  210. }
  211. }
  212. return res;
  213. }
  214. __name(parseContentType, "parseContentType");
  215. // src/utils/is-writable-stream.js
  216. function isWritableStream(value) {
  217. if (!value || typeof value !== "object") {
  218. return false;
  219. }
  220. return typeof value.end === "function";
  221. }
  222. __name(isWritableStream, "isWritableStream");
  223. // src/utils/fetch-request-body.js
  224. var import_http_errors = __toESM(require("http-errors"), 1);
  225. var import_http = require("http");
  226. var import_js_format5 = require("@e22m4u/js-format");
  227. var CHARACTER_ENCODING_LIST = [
  228. "ascii",
  229. "utf8",
  230. "utf-8",
  231. "utf16le",
  232. "utf-16le",
  233. "ucs2",
  234. "ucs-2",
  235. "latin1"
  236. ];
  237. function fetchRequestBody(request, bodyBytesLimit = 0) {
  238. if (!(request instanceof import_http.IncomingMessage)) {
  239. throw new import_js_format5.InvalidArgumentError(
  240. 'The first parameter of "fetchRequestBody" must be an IncomingMessage instance, but %v was given.',
  241. request
  242. );
  243. }
  244. if (typeof bodyBytesLimit !== "number") {
  245. throw new import_js_format5.InvalidArgumentError(
  246. 'The parameter "bodyBytesLimit" of "fetchRequestBody" must be a number, but %v was given.',
  247. bodyBytesLimit
  248. );
  249. }
  250. return new Promise((resolve, reject) => {
  251. const contentLength = parseInt(
  252. request.headers["content-length"] || "0",
  253. 10
  254. );
  255. if (bodyBytesLimit && contentLength && contentLength > bodyBytesLimit) {
  256. throw createError(
  257. import_http_errors.default.PayloadTooLarge,
  258. "Request body limit is %s bytes, but %s bytes given.",
  259. bodyBytesLimit,
  260. contentLength
  261. );
  262. }
  263. let encoding = "utf-8";
  264. const contentType = request.headers["content-type"] || "";
  265. if (contentType) {
  266. const parsedContentType = parseContentType(contentType);
  267. if (parsedContentType && parsedContentType.charset) {
  268. encoding = parsedContentType.charset.toLowerCase();
  269. if (!CHARACTER_ENCODING_LIST.includes(encoding)) {
  270. throw createError(
  271. import_http_errors.default.UnsupportedMediaType,
  272. "Request encoding %v is not supported.",
  273. encoding
  274. );
  275. }
  276. }
  277. }
  278. const data = [];
  279. let receivedLength = 0;
  280. const onData = /* @__PURE__ */ __name((chunk) => {
  281. receivedLength += chunk.length;
  282. if (bodyBytesLimit && receivedLength > bodyBytesLimit) {
  283. request.removeAllListeners();
  284. const error = createError(
  285. import_http_errors.default.PayloadTooLarge,
  286. "Request body limit is %v bytes, but %v bytes given.",
  287. bodyBytesLimit,
  288. receivedLength
  289. );
  290. reject(error);
  291. return;
  292. }
  293. data.push(chunk);
  294. }, "onData");
  295. const onEnd = /* @__PURE__ */ __name(() => {
  296. request.removeAllListeners();
  297. if (contentLength && contentLength !== receivedLength) {
  298. const error = createError(
  299. import_http_errors.default.BadRequest,
  300. 'Received bytes do not match the "content-length" header.'
  301. );
  302. reject(error);
  303. return;
  304. }
  305. const buffer = Buffer.concat(data);
  306. const body = buffer.toString(encoding);
  307. resolve(body || void 0);
  308. }, "onEnd");
  309. const onError = /* @__PURE__ */ __name((error) => {
  310. request.removeAllListeners();
  311. reject((0, import_http_errors.default)(400, error));
  312. }, "onError");
  313. request.on("data", onData);
  314. request.on("end", onEnd);
  315. request.on("error", onError);
  316. request.resume();
  317. });
  318. }
  319. __name(fetchRequestBody, "fetchRequestBody");
  320. // src/utils/parse-cookie-string.js
  321. var import_js_format6 = require("@e22m4u/js-format");
  322. function parseCookieString(input) {
  323. if (typeof input !== "string") {
  324. throw new import_js_format6.InvalidArgumentError(
  325. 'The first parameter of "parseCookieString" must be a String, but %v was given.',
  326. input
  327. );
  328. }
  329. return input.split(";").filter((v) => v !== "").map((v) => v.split("=")).reduce((cookies, tuple) => {
  330. const key = decodeURIComponent(tuple[0]).trim();
  331. if (key === "__proto__" || key === "constructor" || key === "prototype") {
  332. return cookies;
  333. }
  334. const value = tuple[1] !== void 0 ? decodeURIComponent(tuple[1]).trim() : "";
  335. cookies[key] = value;
  336. return cookies;
  337. }, {});
  338. }
  339. __name(parseCookieString, "parseCookieString");
  340. // src/utils/create-request-mock.js
  341. var import_net = require("net");
  342. var import_tls = require("tls");
  343. var import_http2 = require("http");
  344. var import_querystring = __toESM(require("querystring"), 1);
  345. var import_js_format8 = require("@e22m4u/js-format");
  346. // src/utils/create-cookie-string.js
  347. var import_js_format7 = require("@e22m4u/js-format");
  348. function createCookieString(data) {
  349. if (!data || typeof data !== "object" || Array.isArray(data)) {
  350. throw new import_js_format7.InvalidArgumentError(
  351. 'The first parameter of "createCookieString" must be an Object, but %v was given.',
  352. data
  353. );
  354. }
  355. let cookies = "";
  356. for (const key in data) {
  357. if (!Object.prototype.hasOwnProperty.call(data, key)) {
  358. continue;
  359. }
  360. const val = data[key];
  361. if (val == null) {
  362. continue;
  363. }
  364. cookies += `${key}=${val}; `;
  365. }
  366. return cookies.trim();
  367. }
  368. __name(createCookieString, "createCookieString");
  369. // src/utils/create-request-mock.js
  370. function createRequestMock(patch) {
  371. if (patch != null && typeof patch !== "object" || Array.isArray(patch)) {
  372. throw new import_js_format8.InvalidArgumentError(
  373. 'The first parameter of "createRequestMock" must be an Object, but %v was given.',
  374. patch
  375. );
  376. }
  377. patch = patch || {};
  378. if (patch.host != null && typeof patch.host !== "string") {
  379. throw new import_js_format8.InvalidArgumentError(
  380. 'The parameter "host" of "createRequestMock" must be a String, but %v was given.',
  381. patch.host
  382. );
  383. }
  384. if (patch.method != null && typeof patch.method !== "string") {
  385. throw new import_js_format8.InvalidArgumentError(
  386. 'The parameter "method" of "createRequestMock" must be a String, but %v was given.',
  387. patch.method
  388. );
  389. }
  390. if (patch.secure != null && typeof patch.secure !== "boolean") {
  391. throw new import_js_format8.InvalidArgumentError(
  392. 'The parameter "secure" of "createRequestMock" must be a Boolean, but %v was given.',
  393. patch.secure
  394. );
  395. }
  396. if (patch.path != null && typeof patch.path !== "string") {
  397. throw new import_js_format8.InvalidArgumentError(
  398. 'The parameter "path" of "createRequestMock" must be a String, but %v was given.',
  399. patch.path
  400. );
  401. }
  402. if (patch.query != null && typeof patch.query !== "object" && typeof patch.query !== "string" || Array.isArray(patch.query)) {
  403. throw new import_js_format8.InvalidArgumentError(
  404. 'The parameter "query" of "createRequestMock" must be a String or Object, but %v was given.',
  405. patch.query
  406. );
  407. }
  408. if (patch.cookies != null && typeof patch.cookies !== "string" && typeof patch.cookies !== "object" || Array.isArray(patch.cookies)) {
  409. throw new import_js_format8.InvalidArgumentError(
  410. 'The parameter "cookies" of "createRequestMock" must be a String or Object, but %v was given.',
  411. patch.cookies
  412. );
  413. }
  414. if (patch.headers != null && typeof patch.headers !== "object" || Array.isArray(patch.headers)) {
  415. throw new import_js_format8.InvalidArgumentError(
  416. 'The parameter "headers" of "createRequestMock" must be an Object, but %v was given.',
  417. patch.headers
  418. );
  419. }
  420. if (patch.stream != null && !isReadableStream(patch.stream)) {
  421. throw new import_js_format8.InvalidArgumentError(
  422. 'The parameter "stream" of "createRequestMock" must be a Stream, but %v was given.',
  423. patch.stream
  424. );
  425. }
  426. if (patch.encoding != null) {
  427. if (typeof patch.encoding !== "string") {
  428. throw new import_js_format8.InvalidArgumentError(
  429. 'The parameter "encoding" of "createRequestMock" must be a String, but %v was given.',
  430. patch.encoding
  431. );
  432. }
  433. if (!CHARACTER_ENCODING_LIST.includes(patch.encoding)) {
  434. throw new import_js_format8.InvalidArgumentError(
  435. "Character encoding %v is not supported.",
  436. patch.encoding
  437. );
  438. }
  439. }
  440. if (patch.stream) {
  441. if (patch.secure != null) {
  442. throw new import_js_format8.InvalidArgumentError(
  443. 'The "createRequestMock" does not allow specifying the "stream" and "secure" options simultaneously.'
  444. );
  445. }
  446. if (patch.body != null) {
  447. throw new import_js_format8.InvalidArgumentError(
  448. 'The "createRequestMock" does not allow specifying the "stream" and "body" options simultaneously.'
  449. );
  450. }
  451. if (patch.encoding != null) {
  452. throw new import_js_format8.InvalidArgumentError(
  453. 'The "createRequestMock" does not allow specifying the "stream" and "encoding" options simultaneously.'
  454. );
  455. }
  456. }
  457. const request = patch.stream || createRequestStream(patch.secure, patch.body, patch.encoding);
  458. request.url = createRequestUrl(patch.path || "/", patch.query);
  459. request.headers = createRequestHeaders(
  460. patch.host,
  461. patch.secure,
  462. patch.body,
  463. patch.cookies,
  464. patch.encoding,
  465. patch.headers
  466. );
  467. request.method = (patch.method || "get").toUpperCase();
  468. return request;
  469. }
  470. __name(createRequestMock, "createRequestMock");
  471. function createRequestStream(secure, body, encoding) {
  472. if (encoding != null && typeof encoding !== "string") {
  473. throw new import_js_format8.InvalidArgumentError(
  474. 'The parameter "encoding" of "createRequestStream" must be a String, but %v was given.',
  475. encoding
  476. );
  477. }
  478. encoding = encoding || "utf-8";
  479. let socket = new import_net.Socket();
  480. if (secure) {
  481. socket = new import_tls.TLSSocket(socket);
  482. }
  483. const request = new import_http2.IncomingMessage(socket);
  484. if (body != null) {
  485. if (typeof body === "string") {
  486. request.push(body, encoding);
  487. } else if (Buffer.isBuffer(body)) {
  488. request.push(body);
  489. } else {
  490. request.push(JSON.stringify(body));
  491. }
  492. }
  493. request.push(null);
  494. return request;
  495. }
  496. __name(createRequestStream, "createRequestStream");
  497. function createRequestUrl(path, query) {
  498. if (typeof path !== "string") {
  499. throw new import_js_format8.InvalidArgumentError(
  500. 'The parameter "path" of "createRequestUrl" must be a String, but %v was given.',
  501. path
  502. );
  503. }
  504. if (query != null && typeof query !== "string" && typeof query !== "object" || Array.isArray(query)) {
  505. throw new import_js_format8.InvalidArgumentError(
  506. 'The parameter "query" of "createRequestUrl" must be a String or Object, but %v was given.',
  507. query
  508. );
  509. }
  510. let url = ("/" + path).replace("//", "/");
  511. if (typeof query === "object") {
  512. const qs = import_querystring.default.stringify(query);
  513. if (qs) {
  514. url += `?${qs}`;
  515. }
  516. } else if (typeof query === "string") {
  517. url += `?${query.replace(/^\?/, "")}`;
  518. }
  519. return url;
  520. }
  521. __name(createRequestUrl, "createRequestUrl");
  522. function createRequestHeaders(host, secure, body, cookies, encoding, headers) {
  523. if (host != null && typeof host !== "string") {
  524. throw new import_js_format8.InvalidArgumentError(
  525. 'The parameter "host" of "createRequestHeaders" a non-empty String, but %v was given.',
  526. host
  527. );
  528. }
  529. host = host || "localhost";
  530. if (secure != null && typeof secure !== "boolean") {
  531. throw new import_js_format8.InvalidArgumentError(
  532. 'The parameter "secure" of "createRequestHeaders" must be a String, but %v was given.',
  533. secure
  534. );
  535. }
  536. secure = Boolean(secure);
  537. if (cookies != null && typeof cookies !== "object" && typeof cookies !== "string" || Array.isArray(cookies)) {
  538. throw new import_js_format8.InvalidArgumentError(
  539. 'The parameter "cookies" of "createRequestHeaders" must be a String or Object, but %v was given.',
  540. cookies
  541. );
  542. }
  543. if (headers != null && typeof headers !== "object" || Array.isArray(headers)) {
  544. throw new import_js_format8.InvalidArgumentError(
  545. 'The parameter "headers" of "createRequestHeaders" must be an Object, but %v was given.',
  546. headers
  547. );
  548. }
  549. headers = headers || {};
  550. if (encoding != null && typeof encoding !== "string") {
  551. throw new import_js_format8.InvalidArgumentError(
  552. 'The parameter "encoding" of "createRequestHeaders" must be a String, but %v was given.',
  553. encoding
  554. );
  555. }
  556. encoding = encoding || "utf-8";
  557. const obj = { ...headers };
  558. obj["host"] = host;
  559. if (secure) {
  560. obj["x-forwarded-proto"] = "https";
  561. }
  562. if (cookies != null) {
  563. if (typeof cookies === "string") {
  564. obj["cookie"] = obj["cookie"] ? obj["cookie"] : "";
  565. obj["cookie"] += obj["cookie"] ? `; ${cookies}` : cookies;
  566. } else if (typeof cookies === "object") {
  567. obj["cookie"] = obj["cookie"] ? obj["cookie"] : "";
  568. const newCookies = createCookieString(cookies);
  569. obj["cookie"] += obj["cookie"] ? `; ${newCookies}` : newCookies;
  570. }
  571. }
  572. if (obj["content-type"] == null) {
  573. if (typeof body === "string") {
  574. obj["content-type"] = "text/plain";
  575. } else if (Buffer.isBuffer(body)) {
  576. obj["content-type"] = "application/octet-stream";
  577. } else if (typeof body === "object" || typeof body === "boolean" || typeof body === "number") {
  578. obj["content-type"] = "application/json";
  579. }
  580. }
  581. if (body != null && obj["content-length"] == null) {
  582. if (typeof body === "string") {
  583. const length = Buffer.byteLength(body, encoding);
  584. obj["content-length"] = String(length);
  585. } else if (Buffer.isBuffer(body)) {
  586. const length = Buffer.byteLength(body);
  587. obj["content-length"] = String(length);
  588. } else if (typeof body === "object" || typeof body === "boolean" || typeof body === "number") {
  589. const json = JSON.stringify(body);
  590. const length = Buffer.byteLength(json, encoding);
  591. obj["content-length"] = String(length);
  592. }
  593. }
  594. return obj;
  595. }
  596. __name(createRequestHeaders, "createRequestHeaders");
  597. // src/utils/create-response-mock.js
  598. var import_stream = require("stream");
  599. function createResponseMock() {
  600. const response = new import_stream.PassThrough();
  601. patchEncoding(response);
  602. patchHeaders(response);
  603. patchBody(response);
  604. return response;
  605. }
  606. __name(createResponseMock, "createResponseMock");
  607. function patchEncoding(response) {
  608. Object.defineProperty(response, "_encoding", {
  609. configurable: true,
  610. writable: true,
  611. value: void 0
  612. });
  613. Object.defineProperty(response, "setEncoding", {
  614. configurable: true,
  615. value: /* @__PURE__ */ __name(function(enc) {
  616. this._encoding = enc;
  617. return this;
  618. }, "value")
  619. });
  620. Object.defineProperty(response, "getEncoding", {
  621. configurable: true,
  622. value: /* @__PURE__ */ __name(function() {
  623. return this._encoding;
  624. }, "value")
  625. });
  626. }
  627. __name(patchEncoding, "patchEncoding");
  628. function patchHeaders(response) {
  629. Object.defineProperty(response, "_headersSent", {
  630. configurable: true,
  631. writable: true,
  632. value: false
  633. });
  634. Object.defineProperty(response, "headersSent", {
  635. configurable: true,
  636. get() {
  637. return this._headersSent;
  638. }
  639. });
  640. Object.defineProperty(response, "_headers", {
  641. configurable: true,
  642. writable: true,
  643. value: {}
  644. });
  645. Object.defineProperty(response, "setHeader", {
  646. configurable: true,
  647. value: /* @__PURE__ */ __name(function(name, value) {
  648. if (this.headersSent) {
  649. throw new Error(
  650. "Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client"
  651. );
  652. }
  653. const key = name.toLowerCase();
  654. this._headers[key] = String(value);
  655. return this;
  656. }, "value")
  657. });
  658. Object.defineProperty(response, "getHeader", {
  659. configurable: true,
  660. value: /* @__PURE__ */ __name(function(name) {
  661. return this._headers[name.toLowerCase()];
  662. }, "value")
  663. });
  664. Object.defineProperty(response, "getHeaders", {
  665. configurable: true,
  666. value: /* @__PURE__ */ __name(function() {
  667. return JSON.parse(JSON.stringify(this._headers));
  668. }, "value")
  669. });
  670. }
  671. __name(patchHeaders, "patchHeaders");
  672. function patchBody(response) {
  673. let resolve, reject;
  674. const promise = new Promise((rsv, rej) => {
  675. resolve = rsv;
  676. reject = rej;
  677. });
  678. const data = [];
  679. response.on("data", (c) => data.push(c));
  680. response.on("error", (e) => reject(e));
  681. response.on("end", () => {
  682. resolve(Buffer.concat(data));
  683. });
  684. const originalEnd = response.end.bind(response);
  685. response.end = function(...args) {
  686. this._headersSent = true;
  687. return originalEnd(...args);
  688. };
  689. Object.defineProperty(response, "getBody", {
  690. configurable: true,
  691. value: /* @__PURE__ */ __name(function() {
  692. return promise.then((buffer) => {
  693. const enc = this.getEncoding();
  694. const str = buffer.toString(enc);
  695. return data.length ? str : void 0;
  696. });
  697. }, "value")
  698. });
  699. }
  700. __name(patchBody, "patchBody");
  701. // src/utils/get-request-pathname.js
  702. var import_js_format9 = require("@e22m4u/js-format");
  703. function getRequestPathname(request) {
  704. if (!request || typeof request !== "object" || Array.isArray(request) || typeof request.url !== "string") {
  705. throw new import_js_format9.InvalidArgumentError(
  706. 'The first parameter of "getRequestPathname" must be an instance of IncomingMessage, but %v was given.',
  707. request
  708. );
  709. }
  710. return (request.url || "/").replace(/\?.*$/, "");
  711. }
  712. __name(getRequestPathname, "getRequestPathname");
  713. // src/hooks/hook-registry.js
  714. var import_js_format10 = require("@e22m4u/js-format");
  715. var RouterHookType = {
  716. PRE_HANDLER: "preHandler",
  717. POST_HANDLER: "postHandler"
  718. };
  719. var _HookRegistry = class _HookRegistry {
  720. /**
  721. * Hooks.
  722. *
  723. * @type {Map<string, Function[]>}
  724. * @private
  725. */
  726. _hooks = /* @__PURE__ */ new Map();
  727. /**
  728. * Add hook.
  729. *
  730. * @param {string} type
  731. * @param {Function} hook
  732. * @returns {this}
  733. */
  734. addHook(type, hook) {
  735. if (!type || typeof type !== "string") {
  736. throw new import_js_format10.InvalidArgumentError(
  737. "The hook type is required, but %v was given.",
  738. type
  739. );
  740. }
  741. if (!Object.values(RouterHookType).includes(type)) {
  742. throw new import_js_format10.InvalidArgumentError(
  743. "The hook type %v is not supported.",
  744. type
  745. );
  746. }
  747. if (!hook || typeof hook !== "function") {
  748. throw new import_js_format10.InvalidArgumentError(
  749. "The hook %v must be a Function, but %v was given.",
  750. type,
  751. hook
  752. );
  753. }
  754. const hooks = this._hooks.get(type) || [];
  755. hooks.push(hook);
  756. this._hooks.set(type, hooks);
  757. return this;
  758. }
  759. /**
  760. * Has hook.
  761. *
  762. * @param {string} type
  763. * @param {Function} hook
  764. * @returns {boolean}
  765. */
  766. hasHook(type, hook) {
  767. if (!type || typeof type !== "string") {
  768. throw new import_js_format10.InvalidArgumentError(
  769. "The hook type is required, but %v was given.",
  770. type
  771. );
  772. }
  773. if (!Object.values(RouterHookType).includes(type)) {
  774. throw new import_js_format10.InvalidArgumentError(
  775. "The hook type %v is not supported.",
  776. type
  777. );
  778. }
  779. if (!hook || typeof hook !== "function") {
  780. throw new import_js_format10.InvalidArgumentError(
  781. "The hook %v must be a Function, but %v was given.",
  782. type,
  783. hook
  784. );
  785. }
  786. const hooks = this._hooks.get(type) || [];
  787. return hooks.indexOf(hook) > -1;
  788. }
  789. /**
  790. * Get hooks.
  791. *
  792. * @param {string} type
  793. * @returns {Function[]}
  794. */
  795. getHooks(type) {
  796. if (!type || typeof type !== "string") {
  797. throw new import_js_format10.InvalidArgumentError(
  798. "The hook type is required, but %v was given.",
  799. type
  800. );
  801. }
  802. if (!Object.values(RouterHookType).includes(type)) {
  803. throw new import_js_format10.InvalidArgumentError(
  804. "The hook type %v is not supported.",
  805. type
  806. );
  807. }
  808. return this._hooks.get(type) || [];
  809. }
  810. };
  811. __name(_HookRegistry, "HookRegistry");
  812. var HookRegistry = _HookRegistry;
  813. // src/hooks/hook-invoker.js
  814. var _HookInvoker = class _HookInvoker extends DebuggableService {
  815. /**
  816. * Invoke and continue until value received.
  817. *
  818. * @param {Route} route
  819. * @param {string} hookType
  820. * @param {import('http').ServerResponse} response
  821. * @param {*[]} args
  822. * @returns {Promise<*>|*}
  823. */
  824. invokeAndContinueUntilValueReceived(route, hookType, response, ...args) {
  825. if (!route || !(route instanceof Route)) {
  826. throw new import_js_format11.InvalidArgumentError(
  827. 'The parameter "route" of the HookInvoker.invokeAndContinueUntilValueReceived must be a Route instance, but %v was given.',
  828. route
  829. );
  830. }
  831. if (!hookType || typeof hookType !== "string") {
  832. throw new import_js_format11.InvalidArgumentError(
  833. 'The parameter "hookType" of the HookInvoker.invokeAndContinueUntilValueReceived must be a non-empty String, but %v was given.',
  834. hookType
  835. );
  836. }
  837. if (!Object.values(RouterHookType).includes(hookType)) {
  838. throw new import_js_format11.InvalidArgumentError(
  839. "The hook type %v is not supported.",
  840. hookType
  841. );
  842. }
  843. if (!response || typeof response !== "object" || Array.isArray(response) || typeof response.headersSent !== "boolean") {
  844. throw new import_js_format11.InvalidArgumentError(
  845. 'The parameter "response" of the HookInvoker.invokeAndContinueUntilValueReceived must be a ServerResponse instance, but %v was given.',
  846. response
  847. );
  848. }
  849. if (isResponseSent(response)) {
  850. return response;
  851. }
  852. const hooks = [
  853. ...this.getService(HookRegistry).getHooks(hookType),
  854. ...route.hookRegistry.getHooks(hookType)
  855. ];
  856. let result = void 0;
  857. for (let i = 0; i < hooks.length; i++) {
  858. const hook = hooks[i];
  859. result = hook(...args);
  860. if (isResponseSent(response)) {
  861. return response;
  862. }
  863. if (result != null) {
  864. if (isPromise(result)) {
  865. return (async () => {
  866. let asyncResult = await result;
  867. if (isResponseSent(response)) {
  868. return response;
  869. }
  870. if (asyncResult != null) {
  871. return asyncResult;
  872. }
  873. for (let j = i + 1; j < hooks.length; j++) {
  874. asyncResult = await hooks[j](...args);
  875. if (isResponseSent(response)) {
  876. return response;
  877. }
  878. if (asyncResult != null) {
  879. return asyncResult;
  880. }
  881. }
  882. return;
  883. })();
  884. }
  885. return result;
  886. }
  887. }
  888. return;
  889. }
  890. };
  891. __name(_HookInvoker, "HookInvoker");
  892. var HookInvoker = _HookInvoker;
  893. // src/route/validate-route-definition.js
  894. var import_js_format12 = require("@e22m4u/js-format");
  895. function validateRouteDefinition(routeDef) {
  896. if (!routeDef || typeof routeDef !== "object" || Array.isArray(routeDef)) {
  897. throw new import_js_format12.InvalidArgumentError(
  898. "Route definition must be an Object, but %v was given.",
  899. routeDef
  900. );
  901. }
  902. if (!routeDef.method || typeof routeDef.method !== "string") {
  903. throw new import_js_format12.InvalidArgumentError(
  904. 'Option "method" must be a non-empty String, but %v was given.',
  905. routeDef.method
  906. );
  907. }
  908. if (routeDef.path !== void 0 && typeof routeDef.path !== "string") {
  909. throw new import_js_format12.InvalidArgumentError(
  910. 'Option "path" must be a String, but %v was given.',
  911. routeDef.path
  912. );
  913. }
  914. if (typeof routeDef.handler !== "function") {
  915. throw new import_js_format12.InvalidArgumentError(
  916. 'Option "handler" must be a Function, but %v was given.',
  917. routeDef.handler
  918. );
  919. }
  920. if (routeDef.preHandler !== void 0) {
  921. if (Array.isArray(routeDef.preHandler)) {
  922. routeDef.preHandler.forEach((preHandler) => {
  923. if (typeof preHandler !== "function") {
  924. throw new import_js_format12.InvalidArgumentError(
  925. "Route pre-handler must be a Function, but %v was given.",
  926. preHandler
  927. );
  928. }
  929. });
  930. } else if (typeof routeDef.preHandler !== "function") {
  931. throw new import_js_format12.InvalidArgumentError(
  932. 'Option "preHandler" must be a Function or an Array, but %v was given.',
  933. routeDef.preHandler
  934. );
  935. }
  936. }
  937. if (routeDef.postHandler !== void 0) {
  938. if (Array.isArray(routeDef.postHandler)) {
  939. routeDef.postHandler.forEach((postHandler) => {
  940. if (typeof postHandler !== "function") {
  941. throw new import_js_format12.InvalidArgumentError(
  942. "Route post-handler must be a Function, but %v was given.",
  943. postHandler
  944. );
  945. }
  946. });
  947. } else if (typeof routeDef.postHandler !== "function") {
  948. throw new import_js_format12.InvalidArgumentError(
  949. 'Option "postHandler" must be a Function or an Array, but %v was given.',
  950. routeDef.postHandler
  951. );
  952. }
  953. }
  954. if (routeDef.meta !== void 0) {
  955. if (!routeDef.meta || typeof routeDef.meta !== "object" || Array.isArray(routeDef.meta)) {
  956. throw new import_js_format12.InvalidArgumentError(
  957. 'Option "meta" must be an Object, but %v was given.',
  958. routeDef.meta
  959. );
  960. }
  961. }
  962. }
  963. __name(validateRouteDefinition, "validateRouteDefinition");
  964. // src/route/route.js
  965. var HttpMethod = {
  966. GET: "GET",
  967. POST: "POST",
  968. PUT: "PUT",
  969. PATCH: "PATCH",
  970. DELETE: "DELETE"
  971. };
  972. var _Route = class _Route extends import_js_debug.Debuggable {
  973. /**
  974. * Method.
  975. *
  976. * @type {string}
  977. * @private
  978. */
  979. _method;
  980. /**
  981. * Getter of the method.
  982. *
  983. * @returns {string}
  984. */
  985. get method() {
  986. return this._method;
  987. }
  988. /**
  989. * Path template.
  990. *
  991. * @type {string}
  992. * @private
  993. */
  994. _path;
  995. /**
  996. * Getter of the path.
  997. *
  998. * @returns {string}
  999. */
  1000. get path() {
  1001. return this._path;
  1002. }
  1003. /**
  1004. * Meta.
  1005. *
  1006. * @type {object}
  1007. */
  1008. _meta = {};
  1009. /**
  1010. * Getter of the meta.
  1011. *
  1012. * @returns {object}
  1013. */
  1014. get meta() {
  1015. return this._meta;
  1016. }
  1017. /**
  1018. * Handler.
  1019. *
  1020. * @type {RouteHandler}
  1021. * @private
  1022. */
  1023. _handler;
  1024. /**
  1025. * Getter of the handler.
  1026. *
  1027. * @returns {*}
  1028. */
  1029. get handler() {
  1030. return this._handler;
  1031. }
  1032. /**
  1033. * Hook registry.
  1034. *
  1035. * @type {HookRegistry}
  1036. * @private
  1037. */
  1038. _hookRegistry = new HookRegistry();
  1039. /**
  1040. * Getter of the hook registry.
  1041. *
  1042. * @returns {HookRegistry}
  1043. */
  1044. get hookRegistry() {
  1045. return this._hookRegistry;
  1046. }
  1047. /**
  1048. * Constructor.
  1049. *
  1050. * @param {RouteDefinition} routeDef
  1051. */
  1052. constructor(routeDef) {
  1053. super({
  1054. namespace: MODULE_DEBUG_NAMESPACE,
  1055. noEnvironmentNamespace: true,
  1056. noInstantiationMessage: true
  1057. });
  1058. validateRouteDefinition(routeDef);
  1059. this._method = routeDef.method.toUpperCase();
  1060. this._path = routeDef.path || "";
  1061. if (routeDef.meta !== void 0) {
  1062. this._meta = cloneDeep(routeDef.meta);
  1063. }
  1064. this._handler = routeDef.handler;
  1065. if (routeDef.preHandler !== void 0) {
  1066. const preHandlerHooks = Array.isArray(routeDef.preHandler) ? routeDef.preHandler : [routeDef.preHandler];
  1067. preHandlerHooks.forEach((hook) => {
  1068. this._hookRegistry.addHook(RouterHookType.PRE_HANDLER, hook);
  1069. });
  1070. }
  1071. if (routeDef.postHandler !== void 0) {
  1072. const postHandlerHooks = Array.isArray(routeDef.postHandler) ? routeDef.postHandler : [routeDef.postHandler];
  1073. postHandlerHooks.forEach((hook) => {
  1074. this._hookRegistry.addHook(RouterHookType.POST_HANDLER, hook);
  1075. });
  1076. }
  1077. this.ctorDebug("A new route %s %v was created.", this._method, this._path);
  1078. }
  1079. /**
  1080. * Handle request.
  1081. *
  1082. * @param {RequestContext} context
  1083. * @returns {*}
  1084. */
  1085. handle(context) {
  1086. const debug = this.getDebuggerFor(this.handle);
  1087. const requestPath = getRequestPathname(context.request);
  1088. debug(
  1089. "Invoking the Route handler for the request %s %v.",
  1090. this.method.toUpperCase(),
  1091. requestPath
  1092. );
  1093. return this._handler(context);
  1094. }
  1095. };
  1096. __name(_Route, "Route");
  1097. var Route = _Route;
  1098. // src/parsers/body-parser.js
  1099. var import_http_errors2 = __toESM(require("http-errors"), 1);
  1100. // src/router-options.js
  1101. var import_js_format13 = require("@e22m4u/js-format");
  1102. var _RouterOptions = class _RouterOptions extends DebuggableService {
  1103. /**
  1104. * Request body bytes limit.
  1105. *
  1106. * @type {number}
  1107. * @private
  1108. */
  1109. _requestBodyBytesLimit = 512e3;
  1110. // 512kb
  1111. /**
  1112. * Getter of request body bytes limit.
  1113. *
  1114. * @returns {number}
  1115. */
  1116. get requestBodyBytesLimit() {
  1117. return this._requestBodyBytesLimit;
  1118. }
  1119. /**
  1120. * Set request body bytes limit.
  1121. *
  1122. * @param {number} input
  1123. * @returns {RouterOptions}
  1124. */
  1125. setRequestBodyBytesLimit(input) {
  1126. if (typeof input !== "number" || input < 0) {
  1127. throw new import_js_format13.InvalidArgumentError(
  1128. 'The option "requestBodyBytesLimit" must be a positive Number or 0, but %v was given.',
  1129. input
  1130. );
  1131. }
  1132. this._requestBodyBytesLimit = input;
  1133. return this;
  1134. }
  1135. };
  1136. __name(_RouterOptions, "RouterOptions");
  1137. var RouterOptions = _RouterOptions;
  1138. // src/parsers/body-parser.js
  1139. var import_js_format14 = require("@e22m4u/js-format");
  1140. var METHODS_WITH_BODY = ["POST", "PUT", "PATCH", "DELETE"];
  1141. var UNPARSABLE_MEDIA_TYPES = ["multipart/form-data"];
  1142. var _BodyParser = class _BodyParser extends DebuggableService {
  1143. /**
  1144. * Parsers.
  1145. *
  1146. * @type {{[mime: string]: Function}}
  1147. */
  1148. _parsers = {
  1149. "text/plain": /* @__PURE__ */ __name((v) => String(v), "text/plain"),
  1150. "application/json": parseJsonBody
  1151. };
  1152. /**
  1153. * Set parser.
  1154. *
  1155. * @param {string} mediaType
  1156. * @param {Function} parser
  1157. * @returns {this}
  1158. */
  1159. defineParser(mediaType, parser) {
  1160. if (!mediaType || typeof mediaType !== "string") {
  1161. throw new import_js_format14.InvalidArgumentError(
  1162. 'The parameter "mediaType" of BodyParser.defineParser must be a non-empty String, but %v was given.',
  1163. mediaType
  1164. );
  1165. }
  1166. if (!parser || typeof parser !== "function") {
  1167. throw new import_js_format14.InvalidArgumentError(
  1168. 'The parameter "parser" of BodyParser.defineParser must be a Function, but %v was given.',
  1169. parser
  1170. );
  1171. }
  1172. this._parsers[mediaType] = parser;
  1173. return this;
  1174. }
  1175. /**
  1176. * Has parser.
  1177. *
  1178. * @param {string} mediaType
  1179. * @returns {boolean}
  1180. */
  1181. hasParser(mediaType) {
  1182. if (!mediaType || typeof mediaType !== "string") {
  1183. throw new import_js_format14.InvalidArgumentError(
  1184. 'The parameter "mediaType" of BodyParser.hasParser must be a non-empty String, but %v was given.',
  1185. mediaType
  1186. );
  1187. }
  1188. return Boolean(this._parsers[mediaType]);
  1189. }
  1190. /**
  1191. * Delete parser.
  1192. *
  1193. * @param {string} mediaType
  1194. * @returns {this}
  1195. */
  1196. deleteParser(mediaType) {
  1197. if (!mediaType || typeof mediaType !== "string") {
  1198. throw new import_js_format14.InvalidArgumentError(
  1199. 'The parameter "mediaType" of BodyParser.deleteParser must be a non-empty String, but %v was given.',
  1200. mediaType
  1201. );
  1202. }
  1203. const parser = this._parsers[mediaType];
  1204. if (!parser) {
  1205. throw new import_js_format14.InvalidArgumentError(
  1206. "The parser of %v is not found.",
  1207. mediaType
  1208. );
  1209. }
  1210. delete this._parsers[mediaType];
  1211. return this;
  1212. }
  1213. /**
  1214. * Parse.
  1215. *
  1216. * @param {import('http').IncomingMessage} request
  1217. * @returns {Promise<*>|undefined}
  1218. */
  1219. parse(request) {
  1220. const debug = this.getDebuggerFor(this.parse);
  1221. if (!METHODS_WITH_BODY.includes(request.method.toUpperCase())) {
  1222. debug(
  1223. "Body parsing was skipped for the %s request.",
  1224. request.method.toUpperCase()
  1225. );
  1226. return;
  1227. }
  1228. const contentType = (request.headers["content-type"] || "").replace(
  1229. /^([^;]+);.*$/,
  1230. "$1"
  1231. );
  1232. if (!contentType) {
  1233. debug(
  1234. "Body parsing was skipped because the request had no content type."
  1235. );
  1236. return;
  1237. }
  1238. const { mediaType } = parseContentType(contentType);
  1239. if (!mediaType) {
  1240. throw createError(
  1241. import_http_errors2.default.BadRequest,
  1242. 'Unable to parse the "content-type" header.'
  1243. );
  1244. }
  1245. const parser = this._parsers[mediaType];
  1246. if (!parser) {
  1247. if (UNPARSABLE_MEDIA_TYPES.includes(mediaType)) {
  1248. debug("Body parsing was skipped for %v.", mediaType);
  1249. return;
  1250. }
  1251. throw createError(
  1252. import_http_errors2.default.UnsupportedMediaType,
  1253. "Media type %v is not supported.",
  1254. mediaType
  1255. );
  1256. }
  1257. const bodyBytesLimit = this.getService(RouterOptions).requestBodyBytesLimit;
  1258. return fetchRequestBody(request, bodyBytesLimit).then((rawBody) => {
  1259. if (rawBody != null) {
  1260. return parser(rawBody);
  1261. }
  1262. return rawBody;
  1263. });
  1264. }
  1265. };
  1266. __name(_BodyParser, "BodyParser");
  1267. var BodyParser = _BodyParser;
  1268. function parseJsonBody(input) {
  1269. if (typeof input !== "string") {
  1270. return void 0;
  1271. }
  1272. try {
  1273. return JSON.parse(input);
  1274. } catch (error) {
  1275. throw createError(import_http_errors2.default.BadRequest, error.message);
  1276. }
  1277. }
  1278. __name(parseJsonBody, "parseJsonBody");
  1279. // src/parsers/query-parser.js
  1280. var import_querystring2 = __toESM(require("querystring"), 1);
  1281. var _QueryParser = class _QueryParser extends DebuggableService {
  1282. /**
  1283. * Parse
  1284. *
  1285. * @param {import('http').IncomingMessage} request
  1286. * @returns {object}
  1287. */
  1288. parse(request) {
  1289. const debug = this.getDebuggerFor(this.parse);
  1290. const queryStr = request.url.replace(/^[^?]*\??/, "");
  1291. const query = queryStr ? import_querystring2.default.parse(queryStr) : {};
  1292. const queryKeys = Object.keys(query);
  1293. if (queryKeys.length) {
  1294. queryKeys.forEach((key) => {
  1295. debug("The query parameter %v had the value %v.", key, query[key]);
  1296. });
  1297. } else {
  1298. debug(
  1299. "The request %s %v had no query parameters.",
  1300. request.method,
  1301. getRequestPathname(request)
  1302. );
  1303. }
  1304. return query;
  1305. }
  1306. };
  1307. __name(_QueryParser, "QueryParser");
  1308. var QueryParser = _QueryParser;
  1309. // src/parsers/cookies-parser.js
  1310. var _CookiesParser = class _CookiesParser extends DebuggableService {
  1311. /**
  1312. * Parse
  1313. *
  1314. * @param {import('http').IncomingMessage} request
  1315. * @returns {object}
  1316. */
  1317. parse(request) {
  1318. const debug = this.getDebuggerFor(this.parse);
  1319. const cookiesString = request.headers["cookie"] || "";
  1320. const cookies = parseCookieString(cookiesString);
  1321. const cookiesKeys = Object.keys(cookies);
  1322. if (cookiesKeys.length) {
  1323. cookiesKeys.forEach((key) => {
  1324. debug("The cookie %v had the value %v.", key, cookies[key]);
  1325. });
  1326. } else {
  1327. debug(
  1328. "The request %s %v had no cookies.",
  1329. request.method,
  1330. getRequestPathname(request)
  1331. );
  1332. }
  1333. return cookies;
  1334. }
  1335. };
  1336. __name(_CookiesParser, "CookiesParser");
  1337. var CookiesParser = _CookiesParser;
  1338. // src/parsers/request-parser.js
  1339. var import_http3 = require("http");
  1340. var import_js_format15 = require("@e22m4u/js-format");
  1341. var _RequestParser = class _RequestParser extends DebuggableService {
  1342. /**
  1343. * Parse.
  1344. *
  1345. * @param {IncomingMessage} request
  1346. * @returns {Promise<object>|object}
  1347. */
  1348. parse(request) {
  1349. if (!(request instanceof import_http3.IncomingMessage)) {
  1350. throw new import_js_format15.InvalidArgumentError(
  1351. "The first parameter of RequestParser.parse must be an instance of IncomingMessage, but %v was given.",
  1352. request
  1353. );
  1354. }
  1355. const data = {};
  1356. const promises = [];
  1357. const parsedQuery = this.getService(QueryParser).parse(request);
  1358. if (isPromise(parsedQuery)) {
  1359. promises.push(parsedQuery.then((v) => data.query = v));
  1360. } else {
  1361. data.query = parsedQuery;
  1362. }
  1363. const parsedCookies = this.getService(CookiesParser).parse(request);
  1364. if (isPromise(parsedCookies)) {
  1365. promises.push(parsedCookies.then((v) => data.cookies = v));
  1366. } else {
  1367. data.cookies = parsedCookies;
  1368. }
  1369. const parsedBody = this.getService(BodyParser).parse(request);
  1370. if (isPromise(parsedBody)) {
  1371. promises.push(parsedBody.then((v) => data.body = v));
  1372. } else {
  1373. data.body = parsedBody;
  1374. }
  1375. data.headers = Object.assign({}, request.headers);
  1376. return promises.length ? Promise.all(promises).then(() => data) : data;
  1377. }
  1378. };
  1379. __name(_RequestParser, "RequestParser");
  1380. var RequestParser = _RequestParser;
  1381. // src/route-registry.js
  1382. var import_js_path_trie = require("@e22m4u/js-path-trie");
  1383. var import_js_service2 = require("@e22m4u/js-service");
  1384. var import_js_format16 = require("@e22m4u/js-format");
  1385. var _RouteRegistry = class _RouteRegistry extends DebuggableService {
  1386. /**
  1387. * Constructor.
  1388. *
  1389. * @param {ServiceContainer} container
  1390. */
  1391. constructor(container) {
  1392. super(container);
  1393. this._trie = new import_js_path_trie.PathTrie();
  1394. }
  1395. /**
  1396. * Define route.
  1397. *
  1398. * @param {import('./route/index.js').RouteDefinition} routeDef
  1399. * @returns {Route}
  1400. */
  1401. defineRoute(routeDef) {
  1402. const debug = this.getDebuggerFor(this.defineRoute);
  1403. if (!routeDef || typeof routeDef !== "object" || Array.isArray(routeDef)) {
  1404. throw new import_js_format16.InvalidArgumentError(
  1405. "The route definition must be an Object, but %v was given.",
  1406. routeDef
  1407. );
  1408. }
  1409. const route = new Route(routeDef);
  1410. const triePath = `${route.method}/${route.path}`;
  1411. this._trie.add(triePath, route);
  1412. debug(
  1413. "The route %s %v was registered.",
  1414. route.method.toUpperCase(),
  1415. route.path
  1416. );
  1417. return route;
  1418. }
  1419. /**
  1420. * Match route by request.
  1421. *
  1422. * @param {import('http').IncomingRequest} request
  1423. * @returns {ResolvedRoute|undefined}
  1424. */
  1425. matchRouteByRequest(request) {
  1426. const debug = this.getDebuggerFor(this.matchRouteByRequest);
  1427. const requestPath = (request.url || "/").replace(/\?.*$/, "");
  1428. debug(
  1429. "Matching routes with the request %s %v.",
  1430. request.method.toUpperCase(),
  1431. requestPath
  1432. );
  1433. const rawTriePath = `${request.method.toUpperCase()}/${requestPath}`;
  1434. const triePath = rawTriePath.replace(/\/+/g, "/");
  1435. const resolved = this._trie.match(triePath);
  1436. if (resolved) {
  1437. const route = resolved.value;
  1438. debug(
  1439. "The route %s %v was matched.",
  1440. route.method.toUpperCase(),
  1441. route.path
  1442. );
  1443. const paramNames = Object.keys(resolved.params);
  1444. if (paramNames.length) {
  1445. paramNames.forEach((name) => {
  1446. debug(
  1447. "The path parameter %v had the value %v.",
  1448. name,
  1449. resolved.params[name]
  1450. );
  1451. });
  1452. } else {
  1453. debug("No path parameters found.");
  1454. }
  1455. return { route, params: resolved.params };
  1456. }
  1457. debug(
  1458. "No matched route for the request %s %v.",
  1459. request.method.toUpperCase(),
  1460. requestPath
  1461. );
  1462. }
  1463. };
  1464. __name(_RouteRegistry, "RouteRegistry");
  1465. var RouteRegistry = _RouteRegistry;
  1466. // src/request-context.js
  1467. var import_js_format17 = require("@e22m4u/js-format");
  1468. var import_js_service3 = require("@e22m4u/js-service");
  1469. var _RequestContext = class _RequestContext {
  1470. /**
  1471. * Service container.
  1472. *
  1473. * @type {ServiceContainer}
  1474. */
  1475. _container;
  1476. /**
  1477. * Getter of service container.
  1478. *
  1479. * @type {ServiceContainer}
  1480. */
  1481. get container() {
  1482. return this._container;
  1483. }
  1484. /**
  1485. * Request.
  1486. *
  1487. * @type {import('http').IncomingMessage}
  1488. */
  1489. _request;
  1490. /**
  1491. * Getter of request.
  1492. *
  1493. * @type {import('http').IncomingMessage}
  1494. */
  1495. get request() {
  1496. return this._request;
  1497. }
  1498. /**
  1499. * Response.
  1500. *
  1501. * @type {import('http').ServerResponse}
  1502. */
  1503. _response;
  1504. /**
  1505. * Getter of response.
  1506. *
  1507. * @type {import('http').ServerResponse}
  1508. */
  1509. get response() {
  1510. return this._response;
  1511. }
  1512. /**
  1513. * Route
  1514. *
  1515. * @type {Route}
  1516. */
  1517. _route;
  1518. /**
  1519. * Getter of route.
  1520. *
  1521. * @type {Route}
  1522. */
  1523. get route() {
  1524. return this._route;
  1525. }
  1526. /**
  1527. * Query.
  1528. *
  1529. * @type {object}
  1530. */
  1531. query = {};
  1532. /**
  1533. * Path parameters.
  1534. *
  1535. * @type {object}
  1536. */
  1537. params = {};
  1538. /**
  1539. * Headers.
  1540. *
  1541. * @type {object}
  1542. */
  1543. headers = {};
  1544. /**
  1545. * Parsed cookies.
  1546. *
  1547. * @type {object}
  1548. */
  1549. cookies = {};
  1550. /**
  1551. * Parsed body.
  1552. *
  1553. * @type {*}
  1554. */
  1555. body;
  1556. /**
  1557. * State.
  1558. *
  1559. * @type {object}
  1560. */
  1561. state = {};
  1562. /**
  1563. * Route meta.
  1564. *
  1565. * @type {import('./route/index.js').RouteMeta}
  1566. */
  1567. get meta() {
  1568. return this.route.meta;
  1569. }
  1570. /**
  1571. * Method.
  1572. *
  1573. * @returns {string}
  1574. */
  1575. get method() {
  1576. return this.request.method.toUpperCase();
  1577. }
  1578. /**
  1579. * Path.
  1580. *
  1581. * @returns {string}
  1582. */
  1583. get path() {
  1584. return this.request.url;
  1585. }
  1586. /**
  1587. * Pathname.
  1588. *
  1589. * @type {string|undefined}
  1590. * @private
  1591. */
  1592. _pathname = void 0;
  1593. /**
  1594. * Pathname.
  1595. *
  1596. * @returns {string}
  1597. */
  1598. get pathname() {
  1599. if (this._pathname != null) {
  1600. return this._pathname;
  1601. }
  1602. this._pathname = getRequestPathname(this.request);
  1603. return this._pathname;
  1604. }
  1605. /**
  1606. * Constructor.
  1607. *
  1608. * @param {ServiceContainer} container
  1609. * @param {import('http').IncomingMessage} request
  1610. * @param {import('http').ServerResponse} response
  1611. * @param {Route} route
  1612. */
  1613. constructor(container, request, response, route) {
  1614. if (!(0, import_js_service3.isServiceContainer)(container)) {
  1615. throw new import_js_format17.InvalidArgumentError(
  1616. 'The parameter "container" of RequestContext.constructor must be an instance of ServiceContainer, but %v was given.',
  1617. container
  1618. );
  1619. }
  1620. this._container = container;
  1621. if (!request || typeof request !== "object" || Array.isArray(request) || !isReadableStream(request)) {
  1622. throw new import_js_format17.InvalidArgumentError(
  1623. 'The parameter "request" of RequestContext.constructor must be an instance of IncomingMessage, but %v was given.',
  1624. request
  1625. );
  1626. }
  1627. this._request = request;
  1628. if (!response || typeof response !== "object" || Array.isArray(response) || !isWritableStream(response)) {
  1629. throw new import_js_format17.InvalidArgumentError(
  1630. 'The parameter "response" of RequestContext.constructor must be an instance of ServerResponse, but %v was given.',
  1631. response
  1632. );
  1633. }
  1634. this._response = response;
  1635. if (!(route instanceof Route)) {
  1636. throw new import_js_format17.InvalidArgumentError(
  1637. 'The parameter "route" of RequestContext.constructor must be an instance of Route, but %v was given.',
  1638. route
  1639. );
  1640. }
  1641. this._route = route;
  1642. }
  1643. };
  1644. __name(_RequestContext, "RequestContext");
  1645. var RequestContext = _RequestContext;
  1646. // src/trie-router.js
  1647. var import_js_service4 = require("@e22m4u/js-service");
  1648. var import_http4 = require("http");
  1649. // src/senders/data-sender.js
  1650. var import_js_format18 = require("@e22m4u/js-format");
  1651. var _DataSender = class _DataSender extends DebuggableService {
  1652. /**
  1653. * Send.
  1654. *
  1655. * @param {import('http').ServerResponse} response
  1656. * @param {*} data
  1657. * @returns {undefined}
  1658. */
  1659. send(response, data) {
  1660. const debug = this.getDebuggerFor(this.send);
  1661. if (data === response || response.headersSent) {
  1662. debug(
  1663. "Response sending was skipped because its headers where sent already."
  1664. );
  1665. return;
  1666. }
  1667. if (data == null) {
  1668. response.statusCode = 204;
  1669. response.end();
  1670. debug("The empty response was sent.");
  1671. return;
  1672. }
  1673. if (isReadableStream(data)) {
  1674. response.setHeader("Content-Type", "application/octet-stream");
  1675. data.pipe(response);
  1676. debug("The stream response was sent.");
  1677. return;
  1678. }
  1679. let debugMsg;
  1680. switch (typeof data) {
  1681. case "object":
  1682. case "boolean":
  1683. case "number":
  1684. if (Buffer.isBuffer(data)) {
  1685. response.setHeader("content-type", "application/octet-stream");
  1686. debugMsg = "The Buffer was sent as binary data.";
  1687. } else {
  1688. response.setHeader("content-type", "application/json");
  1689. debugMsg = (0, import_js_format18.format)("The %v was sent as JSON.", typeof data);
  1690. data = JSON.stringify(data);
  1691. }
  1692. break;
  1693. default:
  1694. response.setHeader("content-type", "text/plain");
  1695. debugMsg = "The response data was sent as plain text.";
  1696. data = String(data);
  1697. break;
  1698. }
  1699. response.end(data);
  1700. debug(debugMsg);
  1701. }
  1702. };
  1703. __name(_DataSender, "DataSender");
  1704. var DataSender = _DataSender;
  1705. // src/senders/error-sender.js
  1706. var import_util = require("util");
  1707. var import_statuses = __toESM(require("statuses"), 1);
  1708. var EXPOSED_ERROR_PROPERTIES = ["code", "details"];
  1709. var _ErrorSender = class _ErrorSender extends DebuggableService {
  1710. /**
  1711. * Handle.
  1712. *
  1713. * @param {import('http').IncomingMessage} request
  1714. * @param {import('http').ServerResponse} response
  1715. * @param {Error} error
  1716. * @returns {undefined}
  1717. */
  1718. send(request, response, error) {
  1719. const debug = this.getDebuggerFor(this.send);
  1720. let safeError = {};
  1721. if (error) {
  1722. if (typeof error === "object") {
  1723. safeError = error;
  1724. } else {
  1725. safeError = { message: String(error) };
  1726. }
  1727. }
  1728. const statusCode = error.statusCode || error.status || 500;
  1729. const body = { error: {} };
  1730. if (safeError.message && typeof safeError.message === "string") {
  1731. body.error.message = safeError.message;
  1732. } else {
  1733. body.error.message = (0, import_statuses.default)(statusCode);
  1734. }
  1735. EXPOSED_ERROR_PROPERTIES.forEach((name) => {
  1736. if (name in safeError) {
  1737. body.error[name] = safeError[name];
  1738. }
  1739. });
  1740. const requestData = {
  1741. url: request.url,
  1742. method: request.method,
  1743. headers: request.headers
  1744. };
  1745. const inspectOptions = {
  1746. showHidden: false,
  1747. depth: null,
  1748. colors: true,
  1749. compact: false
  1750. };
  1751. console.warn((0, import_util.inspect)(requestData, inspectOptions));
  1752. console.warn((0, import_util.inspect)(body, inspectOptions));
  1753. if (error.stack) {
  1754. console.log(error.stack);
  1755. } else {
  1756. console.error(error);
  1757. }
  1758. response.statusCode = statusCode;
  1759. response.setHeader("content-type", "application/json; charset=utf-8");
  1760. response.end(JSON.stringify(body, null, 2), "utf-8");
  1761. debug(
  1762. "The %s error was sent for the request %s %v.",
  1763. statusCode,
  1764. request.method,
  1765. getRequestPathname(request)
  1766. );
  1767. }
  1768. /**
  1769. * Send 404.
  1770. *
  1771. * @param {import('http').IncomingMessage} request
  1772. * @param {import('http').ServerResponse} response
  1773. * @returns {undefined}
  1774. */
  1775. send404(request, response) {
  1776. const debug = this.getDebuggerFor(this.send404);
  1777. response.statusCode = 404;
  1778. response.setHeader("content-type", "text/plain; charset=utf-8");
  1779. response.end("404 Not Found", "utf-8");
  1780. debug(
  1781. "The 404 error was sent for the request %s %v.",
  1782. request.method,
  1783. getRequestPathname(request)
  1784. );
  1785. }
  1786. };
  1787. __name(_ErrorSender, "ErrorSender");
  1788. var ErrorSender = _ErrorSender;
  1789. // src/trie-router.js
  1790. var _TrieRouter = class _TrieRouter extends DebuggableService {
  1791. /**
  1792. * Define route.
  1793. *
  1794. * Example 1:
  1795. * ```
  1796. * const router = new TrieRouter();
  1797. * router.defineRoute({
  1798. * method: HttpMethod.GET, // Request method.
  1799. * path: '/', // Path template.
  1800. * handler: ctx => 'Hello world!', // Request handler.
  1801. * });
  1802. * ```
  1803. *
  1804. * Example 2:
  1805. * ```
  1806. * const router = new TrieRouter();
  1807. * router.defineRoute({
  1808. * method: HttpMethod.POST, // Request method.
  1809. * path: '/users/:id', // The path template may have parameters.
  1810. * preHandler(ctx) { ... }, // The "preHandler" executes before a route handler.
  1811. * handler(ctx) { ... }, // Request handler function.
  1812. * postHandler(ctx, data) { ... }, // The "postHandler" executes after a route handler.
  1813. * });
  1814. * ```
  1815. *
  1816. * @param {import('./route-registry.js').RouteDefinition} routeDef
  1817. * @returns {import('./route/index.js').Route}
  1818. */
  1819. defineRoute(routeDef) {
  1820. return this.getService(RouteRegistry).defineRoute(routeDef);
  1821. }
  1822. /**
  1823. * Request listener.
  1824. *
  1825. * Example:
  1826. * ```
  1827. * import http from 'http';
  1828. * import {TrieRouter} from '@e22m4u/js-trie-router';
  1829. *
  1830. * const router = new TrieRouter();
  1831. * const server = new http.Server();
  1832. * server.on('request', router.requestListener); // Sets the request listener.
  1833. * server.listen(3000); // Starts listening for connections.
  1834. * ```
  1835. *
  1836. * @returns {Function}
  1837. */
  1838. get requestListener() {
  1839. return this._handleRequest.bind(this);
  1840. }
  1841. /**
  1842. * Handle incoming request.
  1843. *
  1844. * @param {import('http').IncomingMessage} request
  1845. * @param {import('http').ServerResponse} response
  1846. * @returns {Promise<undefined>}
  1847. * @private
  1848. */
  1849. async _handleRequest(request, response) {
  1850. const debug = this.getDebuggerFor(this._handleRequest);
  1851. const requestPath = (request.url || "/").replace(/\?.*$/, "");
  1852. debug(
  1853. "Preparing to handle an incoming request %s %v.",
  1854. request.method,
  1855. requestPath
  1856. );
  1857. const resolved = this.getService(RouteRegistry).matchRouteByRequest(request);
  1858. if (!resolved) {
  1859. debug("No route for the request %s %v.", request.method, requestPath);
  1860. this.getService(ErrorSender).send404(request, response);
  1861. } else {
  1862. const { route, params } = resolved;
  1863. const container = new import_js_service4.ServiceContainer(this.container);
  1864. const context = new RequestContext(container, request, response, route);
  1865. container.set(RequestContext, context);
  1866. container.set(import_http4.IncomingMessage, request);
  1867. container.set(import_http4.ServerResponse, response);
  1868. context.params = params;
  1869. let data;
  1870. try {
  1871. const reqDataOrPromise = this.getService(RequestParser).parse(request);
  1872. if (isPromise(reqDataOrPromise)) {
  1873. const reqData = await reqDataOrPromise;
  1874. Object.assign(context, reqData);
  1875. } else {
  1876. Object.assign(context, reqDataOrPromise);
  1877. }
  1878. const hookInvoker = this.getService(HookInvoker);
  1879. data = hookInvoker.invokeAndContinueUntilValueReceived(
  1880. route,
  1881. RouterHookType.PRE_HANDLER,
  1882. response,
  1883. context
  1884. );
  1885. if (isPromise(data)) {
  1886. data = await data;
  1887. }
  1888. if (!isResponseSent(response) && data == null) {
  1889. data = route.handle(context);
  1890. if (isPromise(data)) {
  1891. data = await data;
  1892. }
  1893. let postHandlerData = hookInvoker.invokeAndContinueUntilValueReceived(
  1894. route,
  1895. RouterHookType.POST_HANDLER,
  1896. response,
  1897. context,
  1898. data
  1899. );
  1900. if (isPromise(postHandlerData)) {
  1901. postHandlerData = await postHandlerData;
  1902. }
  1903. if (postHandlerData != null) {
  1904. data = postHandlerData;
  1905. }
  1906. }
  1907. } catch (error) {
  1908. this.getService(ErrorSender).send(request, response, error);
  1909. return;
  1910. }
  1911. if (!isResponseSent(response)) {
  1912. this.getService(DataSender).send(response, data);
  1913. }
  1914. }
  1915. }
  1916. /**
  1917. * Add hook.
  1918. *
  1919. * Example:
  1920. * ```
  1921. * import {TrieRouter} from '@e22m4u/js-trie-router';
  1922. * import {RouterHookType} from '@e22m4u/js-trie-router';
  1923. *
  1924. * // Router instance.
  1925. * const router = new TrieRouter();
  1926. *
  1927. * // Adds the "preHandler" hook for each route.
  1928. * router.addHook(
  1929. * RouterHookType.PRE_HANDLER,
  1930. * ctx => { ... },
  1931. * );
  1932. *
  1933. * // Adds the "postHandler" hook for each route.
  1934. * router.addHook(
  1935. * RouterHookType.POST_HANDLER,
  1936. * ctx => { ... },
  1937. * );
  1938. * ```
  1939. *
  1940. * @param {string} type
  1941. * @param {Function} hook
  1942. * @returns {this}
  1943. */
  1944. addHook(type, hook) {
  1945. this.getService(HookRegistry).addHook(type, hook);
  1946. return this;
  1947. }
  1948. /**
  1949. * Add pre-handler hook.
  1950. *
  1951. * @param {Function} hook
  1952. * @returns {this}
  1953. */
  1954. addPreHandler(hook) {
  1955. this.getService(HookRegistry).addHook(RouterHookType.PRE_HANDLER, hook);
  1956. return this;
  1957. }
  1958. /**
  1959. * Add post-handler hook.
  1960. *
  1961. * @param {Function} hook
  1962. * @returns {this}
  1963. */
  1964. addPostHandler(hook) {
  1965. this.getService(HookRegistry).addHook(RouterHookType.POST_HANDLER, hook);
  1966. return this;
  1967. }
  1968. };
  1969. __name(_TrieRouter, "TrieRouter");
  1970. var TrieRouter = _TrieRouter;
  1971. // Annotate the CommonJS export names for ESM import in node:
  1972. 0 && (module.exports = {
  1973. BodyParser,
  1974. CHARACTER_ENCODING_LIST,
  1975. CookiesParser,
  1976. DataSender,
  1977. EXPOSED_ERROR_PROPERTIES,
  1978. ErrorSender,
  1979. HookInvoker,
  1980. HookRegistry,
  1981. HttpMethod,
  1982. METHODS_WITH_BODY,
  1983. QueryParser,
  1984. RequestContext,
  1985. RequestParser,
  1986. Route,
  1987. RouteRegistry,
  1988. RouterHookType,
  1989. RouterOptions,
  1990. TrieRouter,
  1991. UNPARSABLE_MEDIA_TYPES,
  1992. cloneDeep,
  1993. createCookieString,
  1994. createError,
  1995. createRequestMock,
  1996. createResponseMock,
  1997. createRouteMock,
  1998. fetchRequestBody,
  1999. getRequestPathname,
  2000. isPromise,
  2001. isReadableStream,
  2002. isResponseSent,
  2003. isWritableStream,
  2004. parseContentType,
  2005. parseCookieString,
  2006. parseJsonBody,
  2007. toCamelCase,
  2008. validateRouteDefinition
  2009. });