index.cjs 52 KB

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