index.cjs 57 KB

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