@e22m4u/js-trie-router 0.7.5 → 0.7.7

package/README.md

@@ -16,6 +16,7 @@ HTTP маршрутизатор для Node.js на основе
 ## Содержание
 
 - [Установка](#установка)
+- [Расширения](#расширения)
 - [Использование](#использование)
   - [Параметры маршрутизатора](#параметры-маршрутизатора)
   - [Контекст запроса](#контекст-запроса)
@@ -54,6 +55,15 @@ import {TrieRouter} from '@e22m4u/js-trie-router';
 const {TrieRouter} = require('@e22m4u/js-trie-router');
 ```
 
+## Расширения
+
+Расширение функционала выполняется с помощью NPM модулей.
+
+| модуль                                                                                         | описание                                       |
+|------------------------------------------------------------------------------------------------|------------------------------------------------|
+| [@e22m4u/js-trie-router-cors](https://www.npmjs.com/package/@e22m4u/js-trie-router-cors)       | Модуль поддержки CORS (кросс-доменные запросы) |
+| [@e22m4u/js-trie-router-openapi](https://www.npmjs.com/package/@e22m4u/js-trie-router-openapi) | Генерация OpenAPI документа и валидация данных |
+
 ## Использование
 
 Базовый пример создания экземпляра роутера, объявления маршрута

package/build-cjs.js

@@ -6,7 +6,7 @@ await esbuild.build({
   outfile: 'dist/cjs/index.cjs',
   format: 'cjs',
   platform: 'node',
-  target: ['node16'],
+  target: ['node18'],
   bundle: true,
   keepNames: true,
   external: [

package/dist/cjs/index.cjs

@@ -43,6 +43,7 @@ __export(index_exports, {
   RequestQueryParser: () => RequestQueryParser,
   Route: () => Route,
   RouteRegistry: () => RouteRegistry,
+  RouterBranch: () => RouterBranch,
   RouterDataSender: () => RouterDataSender,
   RouterErrorSender: () => RouterErrorSender,
   RouterHookInvoker: () => RouterHookInvoker,
@@ -65,12 +66,14 @@ __export(index_exports, {
   isResponseSent: () => isResponseSent,
   isWritableStream: () => isWritableStream,
   mergeDeep: () => mergeDeep,
+  mergeRouterBranchDefinitions: () => mergeRouterBranchDefinitions,
   parseContentType: () => parseContentType,
   parseCookieString: () => parseCookieString,
   parseJsonBody: () => parseJsonBody,
   toCamelCase: () => toCamelCase,
   toPascalCase: () => toPascalCase,
-  validateRouteDefinition: () => validateRouteDefinition
+  validateRouteDefinition: () => validateRouteDefinition,
+  validateRouterBranchDefinition: () => validateRouterBranchDefinition
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -83,7 +86,10 @@ var import_js_debug = require("@e22m4u/js-debug");
 // src/debuggable-service.js
 var import_js_service = require("@e22m4u/js-service");
 var MODULE_DEBUG_NAMESPACE = "jsTrieRouter";
-var _DebuggableService = class _DebuggableService extends import_js_service.DebuggableService {
+var DebuggableService = class extends import_js_service.DebuggableService {
+  static {
+    __name(this, "DebuggableService");
+  }
   /**
    * Constructor.
    *
@@ -96,8 +102,6 @@ var _DebuggableService = class _DebuggableService extends import_js_service.Debu
     });
   }
 };
-__name(_DebuggableService, "DebuggableService");
-var DebuggableService = _DebuggableService;
 
 // src/utils/clone-deep.js
 function cloneDeep(value) {
@@ -950,7 +954,10 @@ __name(getRequestPathname, "getRequestPathname");
 // src/request-context.js
 var import_js_format11 = require("@e22m4u/js-format");
 var import_js_service2 = require("@e22m4u/js-service");
-var _RequestContext = class _RequestContext {
+var RequestContext = class {
+  static {
+    __name(this, "RequestContext");
+  }
   /**
    * Service container.
    *
@@ -1136,8 +1143,6 @@ var _RequestContext = class _RequestContext {
     this._route = route;
   }
 };
-__name(_RequestContext, "RequestContext");
-var RequestContext = _RequestContext;
 
 // src/hooks/router-hook-invoker.js
 var import_js_format13 = require("@e22m4u/js-format");
@@ -1151,7 +1156,10 @@ var RouterHookType = {
   POST_HANDLER: "postHandler"
 };
 var ROUTER_HOOK_TYPES = Object.values(RouterHookType);
-var _RouterHookRegistry = class _RouterHookRegistry {
+var RouterHookRegistry = class {
+  static {
+    __name(this, "RouterHookRegistry");
+  }
   /**
    * Hooks.
    *
@@ -1234,11 +1242,12 @@ var _RouterHookRegistry = class _RouterHookRegistry {
     return this._hooks.get(type) || [];
   }
 };
-__name(_RouterHookRegistry, "RouterHookRegistry");
-var RouterHookRegistry = _RouterHookRegistry;
 
 // src/hooks/router-hook-invoker.js
-var _RouterHookInvoker = class _RouterHookInvoker extends DebuggableService {
+var RouterHookInvoker = class extends DebuggableService {
+  static {
+    __name(this, "RouterHookInvoker");
+  }
   /**
    * Invoke on-request hooks.
    *
@@ -1499,8 +1508,6 @@ var _RouterHookInvoker = class _RouterHookInvoker extends DebuggableService {
     return currentData;
   }
 };
-__name(_RouterHookInvoker, "RouterHookInvoker");
-var RouterHookInvoker = _RouterHookInvoker;
 
 // src/route/validate-route-definition.js
 var import_js_format14 = require("@e22m4u/js-format");
@@ -1583,6 +1590,7 @@ __name(validateRouteDefinition, "validateRouteDefinition");
 // src/route/route.js
 var HttpMethod = {
   GET: "GET",
+  HEAD: "HEAD",
   POST: "POST",
   PUT: "PUT",
   PATCH: "PATCH",
@@ -1590,7 +1598,10 @@ var HttpMethod = {
   OPTIONS: "OPTIONS"
 };
 var DEFAULT_META = Object.freeze({});
-var _Route = class _Route extends import_js_debug.Debuggable {
+var Route = class extends import_js_debug.Debuggable {
+  static {
+    __name(this, "Route");
+  }
   /**
    * Definition.
    *
@@ -1692,14 +1703,15 @@ var _Route = class _Route extends import_js_debug.Debuggable {
     return this.handler(context);
   }
 };
-__name(_Route, "Route");
-var Route = _Route;
 
 // src/route/route-registry.js
 var import_js_path_trie = require("@e22m4u/js-path-trie");
 var import_js_service3 = require("@e22m4u/js-service");
 var import_js_format15 = require("@e22m4u/js-format");
-var _RouteRegistry = class _RouteRegistry extends DebuggableService {
+var RouteRegistry = class extends DebuggableService {
+  static {
+    __name(this, "RouteRegistry");
+  }
   /**
    * Constructor.
    *
@@ -1789,38 +1801,7 @@ var _RouteRegistry = class _RouteRegistry extends DebuggableService {
       requestPath
     );
   }
-  /**
-   * Get allowed methods for request path.
-   *
-   * @param {string} requestPath
-   * @returns {string[]}
-   */
-  getAllowedMethodsForRequestPath(requestPath) {
-    if (typeof requestPath !== "string") {
-      throw new import_js_format15.InvalidArgumentError(
-        'Parameter "requestPath" must be a String, but %v was given.',
-        requestPath
-      );
-    }
-    const debug = this.getDebuggerFor(this.getAllowedMethodsForRequestPath);
-    const allowedMethods = [];
-    for (const method of Object.values(HttpMethod)) {
-      const rawTriePath = `${method}/${requestPath}`;
-      const triePath = rawTriePath.replace(/\/+/g, "/");
-      if (this._trie.match(triePath)) {
-        allowedMethods.push(method);
-      }
-    }
-    if (allowedMethods.length) {
-      debug("Allowed methods for %v are: %l.", requestPath, allowedMethods);
-    } else {
-      debug("Path %v does not have allowed methods.", requestPath);
-    }
-    return allowedMethods;
-  }
 };
-__name(_RouteRegistry, "RouteRegistry");
-var RouteRegistry = _RouteRegistry;
 
 // src/branch/router-branch.js
 var import_js_format17 = require("@e22m4u/js-format");
@@ -1931,7 +1912,10 @@ function mergeRouterBranchDefinitions(firstDef, secondDef) {
 __name(mergeRouterBranchDefinitions, "mergeRouterBranchDefinitions");
 
 // src/branch/router-branch.js
-var _RouterBranch = class _RouterBranch extends DebuggableService {
+var RouterBranch = class _RouterBranch extends DebuggableService {
+  static {
+    __name(this, "RouterBranch");
+  }
   /**
    * Router.
    *
@@ -2050,8 +2034,6 @@ var _RouterBranch = class _RouterBranch extends DebuggableService {
     return new _RouterBranch(this._router, branchDef, this);
   }
 };
-__name(_RouterBranch, "RouterBranch");
-var RouterBranch = _RouterBranch;
 
 // src/parsers/request-parser.js
 var import_http3 = require("http");
@@ -2063,7 +2045,10 @@ var import_js_format19 = require("@e22m4u/js-format");
 
 // src/trie-router-options.js
 var import_js_format18 = require("@e22m4u/js-format");
-var _TrieRouterOptions = class _TrieRouterOptions {
+var TrieRouterOptions = class {
+  static {
+    __name(this, "TrieRouterOptions");
+  }
   /**
    * Request body bytes limit.
    *
@@ -2138,11 +2123,12 @@ var _TrieRouterOptions = class _TrieRouterOptions {
     }
   }
 };
-__name(_TrieRouterOptions, "TrieRouterOptions");
-var TrieRouterOptions = _TrieRouterOptions;
 
 // src/parsers/request-body-parser.js
-var _RequestBodyParser = class _RequestBodyParser extends DebuggableService {
+var RequestBodyParser = class extends DebuggableService {
+  static {
+    __name(this, "RequestBodyParser");
+  }
   /**
    * Parsers.
    *
@@ -2285,8 +2271,6 @@ var _RequestBodyParser = class _RequestBodyParser extends DebuggableService {
     });
   }
 };
-__name(_RequestBodyParser, "RequestBodyParser");
-var RequestBodyParser = _RequestBodyParser;
 function parseJsonBody(input) {
   if (typeof input !== "string") {
     return void 0;
@@ -2301,7 +2285,10 @@ __name(parseJsonBody, "parseJsonBody");
 
 // src/parsers/request-query-parser.js
 var import_querystring2 = __toESM(require("querystring"), 1);
-var _RequestQueryParser = class _RequestQueryParser extends DebuggableService {
+var RequestQueryParser = class extends DebuggableService {
+  static {
+    __name(this, "RequestQueryParser");
+  }
   /**
    * Parse
    *
@@ -2327,11 +2314,12 @@ var _RequestQueryParser = class _RequestQueryParser extends DebuggableService {
     return query;
   }
 };
-__name(_RequestQueryParser, "RequestQueryParser");
-var RequestQueryParser = _RequestQueryParser;
 
 // src/parsers/request-cookies-parser.js
-var _RequestCookiesParser = class _RequestCookiesParser extends DebuggableService {
+var RequestCookiesParser = class extends DebuggableService {
+  static {
+    __name(this, "RequestCookiesParser");
+  }
   /**
    * Parse
    *
@@ -2357,11 +2345,12 @@ var _RequestCookiesParser = class _RequestCookiesParser extends DebuggableServic
     return cookies;
   }
 };
-__name(_RequestCookiesParser, "RequestCookiesParser");
-var RequestCookiesParser = _RequestCookiesParser;
 
 // src/parsers/request-parser.js
-var _RequestParser = class _RequestParser extends DebuggableService {
+var RequestParser = class extends DebuggableService {
+  static {
+    __name(this, "RequestParser");
+  }
   /**
    * Parse.
    *
@@ -2399,15 +2388,16 @@ var _RequestParser = class _RequestParser extends DebuggableService {
     return promises.length ? Promise.all(promises).then(() => data) : data;
   }
 };
-__name(_RequestParser, "RequestParser");
-var RequestParser = _RequestParser;
 
 // src/trie-router.js
 var import_http4 = require("http");
 
 // src/senders/router-data-sender.js
 var import_js_format21 = require("@e22m4u/js-format");
-var _RouterDataSender = class _RouterDataSender extends DebuggableService {
+var RouterDataSender = class extends DebuggableService {
+  static {
+    __name(this, "RouterDataSender");
+  }
   /**
    * Send.
    *
@@ -2428,8 +2418,8 @@ var _RouterDataSender = class _RouterDataSender extends DebuggableService {
       return;
     }
     if (isReadableStream(data)) {
-      if (!response.getHeader("content-type")) {
-        response.setHeader("content-type", "application/octet-stream");
+      if (!response.getHeader("Content-Type")) {
+        response.setHeader("Content-Type", "application/octet-stream");
       }
       data.pipe(response);
       debug("Sending response with a Stream.");
@@ -2441,13 +2431,13 @@ var _RouterDataSender = class _RouterDataSender extends DebuggableService {
       case "boolean":
       case "object":
         if (Buffer.isBuffer(data)) {
-          if (!response.getHeader("content-type")) {
-            response.setHeader("content-type", "application/octet-stream");
+          if (!response.getHeader("Content-Type")) {
+            response.setHeader("Content-Type", "application/octet-stream");
           }
           debugMsg = "Buffer has been sent as binary data.";
         } else {
-          if (!response.getHeader("content-type")) {
-            response.setHeader("content-type", "application/json");
+          if (!response.getHeader("Content-Type")) {
+            response.setHeader("Content-Type", "application/json");
           }
           debugMsg = (0, import_js_format21.format)(
             "%v has been sent as JSON.",
@@ -2457,8 +2447,8 @@ var _RouterDataSender = class _RouterDataSender extends DebuggableService {
         }
         break;
       default:
-        if (!response.getHeader("content-type")) {
-          response.setHeader("content-type", "text/plain");
+        if (!response.getHeader("Content-Type")) {
+          response.setHeader("Content-Type", "text/plain");
         }
         debugMsg = "Response data has been sent as plain text.";
         data = String(data);
@@ -2468,14 +2458,15 @@ var _RouterDataSender = class _RouterDataSender extends DebuggableService {
     debug(debugMsg);
   }
 };
-__name(_RouterDataSender, "RouterDataSender");
-var RouterDataSender = _RouterDataSender;
 
 // src/senders/router-error-sender.js
 var import_util = require("util");
 var import_statuses = __toESM(require("statuses"), 1);
 var EXPOSED_ERROR_PROPERTIES = ["code", "details"];
-var _RouterErrorSender = class _RouterErrorSender extends DebuggableService {
+var RouterErrorSender = class extends DebuggableService {
+  static {
+    __name(this, "RouterErrorSender");
+  }
   /**
    * Handle.
    *
@@ -2525,7 +2516,7 @@ var _RouterErrorSender = class _RouterErrorSender extends DebuggableService {
       console.error(error);
     }
     response.statusCode = statusCode;
-    response.setHeader("content-type", "application/json; charset=utf-8");
+    response.setHeader("Content-Type", "application/json; charset=utf-8");
     response.end(JSON.stringify(body, null, 2), "utf-8");
     debug(
       "%s error has been sent for the request %s %v.",
@@ -2544,7 +2535,7 @@ var _RouterErrorSender = class _RouterErrorSender extends DebuggableService {
   send404(request, response) {
     const debug = this.getDebuggerFor(this.send404);
     response.statusCode = 404;
-    response.setHeader("content-type", "text/plain; charset=utf-8");
+    response.setHeader("Content-Type", "text/plain; charset=utf-8");
     response.end("404 Not Found", "utf-8");
     debug(
       "404 error has been sent for the request %s %v.",
@@ -2553,12 +2544,13 @@ var _RouterErrorSender = class _RouterErrorSender extends DebuggableService {
     );
   }
 };
-__name(_RouterErrorSender, "RouterErrorSender");
-var RouterErrorSender = _RouterErrorSender;
 
 // src/trie-router.js
 var import_js_service4 = require("@e22m4u/js-service");
-var _TrieRouter = class _TrieRouter extends DebuggableService {
+var TrieRouter = class extends DebuggableService {
+  static {
+    __name(this, "TrieRouter");
+  }
   /**
    * Constructor.
    *
@@ -2613,7 +2605,7 @@ var _TrieRouter = class _TrieRouter extends DebuggableService {
    * Example:
    * ```js
    * const router = new TrieRouter();
-   * const apiBranch = router.createBranch({path: 'api'});
+   * const apiBranch = router.createBranch({path: '/api'});
    *
    * // GET /api/hello
    * apiBranch.defineRoute({
@@ -2680,22 +2672,6 @@ var _TrieRouter = class _TrieRouter extends DebuggableService {
       }
       const resolved = this.getService(RouteRegistry).matchRouteByRequest(request);
       if (!resolved) {
-        if (request.method.toUpperCase() === HttpMethod.OPTIONS) {
-          const allowedMethods = this.getService(RouteRegistry).getAllowedMethodsForRequestPath(
-            requestPath
-          );
-          if (allowedMethods.length > 0) {
-            debug("Auto-handling OPTIONS request.");
-            if (!allowedMethods.includes("OPTIONS")) {
-              allowedMethods.push("OPTIONS");
-            }
-            const allowHeader = allowedMethods.join(", ");
-            response.statusCode = 204;
-            response.setHeader("Allow", allowHeader);
-            response.end();
-            return;
-          }
-        }
         debug(
           "No route found for the request %s %v.",
           request.method,
@@ -2781,8 +2757,6 @@ var _TrieRouter = class _TrieRouter extends DebuggableService {
     return this.getService(RouterHookRegistry).hasHook(type, hook);
   }
 };
-__name(_TrieRouter, "TrieRouter");
-var TrieRouter = _TrieRouter;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CHARACTER_ENCODING_LIST,
@@ -2797,6 +2771,7 @@ var TrieRouter = _TrieRouter;
   RequestQueryParser,
   Route,
   RouteRegistry,
+  RouterBranch,
   RouterDataSender,
   RouterErrorSender,
   RouterHookInvoker,
@@ -2819,10 +2794,12 @@ var TrieRouter = _TrieRouter;
   isResponseSent,
   isWritableStream,
   mergeDeep,
+  mergeRouterBranchDefinitions,
   parseContentType,
   parseCookieString,
   parseJsonBody,
   toCamelCase,
   toPascalCase,
-  validateRouteDefinition
+  validateRouteDefinition,
+  validateRouterBranchDefinition
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e22m4u/js-trie-router",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "HTTP маршрутизатор для Node.js на основе префиксного дерева",
   "author": "Mikhail Evstropov <e22m4u@yandex.ru>",
   "license": "MIT",
@@ -11,10 +11,10 @@
     "server",
     "nodejs"
   ],
-  "homepage": "https://gitrepos.ru/e22m4u/js-trie-router",
+  "homepage": "https://gitverse.ru/e22m4u/js-trie-router",
   "repository": {
     "type": "git",
-    "url": "git+https://gitrepos.ru/e22m4u/js-trie-router.git"
+    "url": "git+https://gitverse.ru/e22m4u/js-trie-router.git"
   },
   "type": "module",
   "types": "./src/index.d.ts",
@@ -26,7 +26,7 @@
     "require": "./dist/cjs/index.cjs"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
   "scripts": {
     "lint": "tsc && eslint ./src",
@@ -41,19 +41,19 @@
     "@e22m4u/js-debug": "~0.4.1",
     "@e22m4u/js-format": "~0.4.0",
     "@e22m4u/js-path-trie": "~0.2.0",
-    "@e22m4u/js-service": "~0.5.1",
+    "@e22m4u/js-service": "~0.6.1",
     "debug": "~4.4.3",
     "http-errors": "~2.0.1",
     "statuses": "~2.0.2"
   },
   "devDependencies": {
-    "@commitlint/cli": "~20.4.2",
-    "@commitlint/config-conventional": "~20.4.2",
+    "@commitlint/cli": "~20.4.3",
+    "@commitlint/config-conventional": "~20.4.3",
     "@eslint/js": "~9.39.2",
     "@types/chai": "~5.2.3",
     "@types/chai-as-promised": "~8.0.2",
     "@types/mocha": "~10.0.10",
-    "c8": "~10.1.3",
+    "c8": "~11.0.0",
     "chai": "~6.2.2",
     "chai-as-promised": "~8.0.2",
     "esbuild": "~0.27.3",
@@ -61,9 +61,9 @@
     "eslint-config-prettier": "~10.1.8",
     "eslint-plugin-chai-expect": "~3.1.0",
     "eslint-plugin-import": "~2.32.0",
-    "eslint-plugin-jsdoc": "~62.7.0",
+    "eslint-plugin-jsdoc": "~62.7.1",
     "eslint-plugin-mocha": "~11.2.0",
-    "globals": "~17.3.0",
+    "globals": "~17.4.0",
     "husky": "~9.1.7",
     "mocha": "~11.7.5",
     "prettier": "~3.8.1",

package/src/index.d.ts

@@ -3,6 +3,7 @@ export * from './route/index.js';
 export * from './utils/index.js';
 export * from './hooks/index.js';
 export * from './trie-router.js';
+export * from './branch/index.js';
 export * from './parsers/index.js';
 export * from './senders/index.js';
 export * from './request-context.js';

package/src/index.js

@@ -3,6 +3,7 @@ export * from './route/index.js';
 export * from './utils/index.js';
 export * from './hooks/index.js';
 export * from './trie-router.js';
+export * from './branch/index.js';
 export * from './parsers/index.js';
 export * from './senders/index.js';
 export * from './request-context.js';

package/src/route/route-registry.d.ts

@@ -36,11 +36,4 @@ export declare class RouteRegistry extends DebuggableService {
    * @param request
    */
   matchRouteByRequest(request: IncomingMessage): ResolvedRoute | undefined;
-
-  /**
-   * Get allowed methods for request path.
-   *
-   * @param requestPath
-   */
-  getAllowedMethodsForRequestPath(requestPath: string): string[];
 }

package/src/route/route-registry.js

@@ -1,4 +1,4 @@
-import {HttpMethod, Route} from './route.js';
+import {Route} from './route.js';
 import {PathTrie} from '@e22m4u/js-path-trie';
 import {ServiceContainer} from '@e22m4u/js-service';
 import {getRequestPathname} from '../utils/index.js';
@@ -124,34 +124,4 @@ export class RouteRegistry extends DebuggableService {
       requestPath,
     );
   }
-
-  /**
-   * Get allowed methods for request path.
-   *
-   * @param {string} requestPath
-   * @returns {string[]}
-   */
-  getAllowedMethodsForRequestPath(requestPath) {
-    if (typeof requestPath !== 'string') {
-      throw new InvalidArgumentError(
-        'Parameter "requestPath" must be a String, but %v was given.',
-        requestPath,
-      );
-    }
-    const debug = this.getDebuggerFor(this.getAllowedMethodsForRequestPath);
-    const allowedMethods = [];
-    for (const method of Object.values(HttpMethod)) {
-      const rawTriePath = `${method}/${requestPath}`;
-      const triePath = rawTriePath.replace(/\/+/g, '/');
-      if (this._trie.match(triePath)) {
-        allowedMethods.push(method);
-      }
-    }
-    if (allowedMethods.length) {
-      debug('Allowed methods for %v are: %l.', requestPath, allowedMethods);
-    } else {
-      debug('Path %v does not have allowed methods.', requestPath);
-    }
-    return allowedMethods;
-  }
 }

package/src/route/route-registry.spec.js

@@ -2,7 +2,6 @@ import {expect} from 'chai';
 import {format} from '@e22m4u/js-format';
 import {Route, HttpMethod} from './route.js';
 import {RouteRegistry} from './route-registry.js';
-import {ServiceContainer} from '@e22m4u/js-service';
 import {RouterHookRegistry, RouterHookType} from '../hooks/index.js';
 
 describe('RouteRegistry', function () {
@@ -153,95 +152,4 @@ describe('RouteRegistry', function () {
       expect(res.params).to.be.eql({p1: 'baz', p2: 'qux'});
     });
   });
-
-  describe('getAllowedMethodsForRequestPath', function () {
-    it('should require the parameter "requestPath" to be a String', function () {
-      const S = new RouteRegistry();
-      const throwable = v => () => S.getAllowedMethodsForRequestPath(v);
-      const error = v =>
-        format(
-          'Parameter "requestPath" must be a String, but %s was given.',
-          v,
-        );
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(true)).to.throw(error('true'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      expect(throwable(() => undefined)).to.throw(error('Function'));
-      throwable('str')();
-      throwable('')();
-    });
-
-    it('should return an empty array if no routes match the path', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      S.defineRoute({
-        method: HttpMethod.GET,
-        path: '/foo',
-        handler: () => undefined,
-      });
-      const res = S.getAllowedMethodsForRequestPath('/bar');
-      expect(res).to.be.eql([]);
-    });
-
-    it('should return an array with a single method if only one matches', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      S.defineRoute({
-        method: HttpMethod.POST,
-        path: '/foo',
-        handler: () => undefined,
-      });
-      const res = S.getAllowedMethodsForRequestPath('/foo');
-      expect(res).to.be.eql([HttpMethod.POST]);
-    });
-
-    it('should return an array with multiple methods if several routes match the path', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      const handler = () => undefined;
-      S.defineRoute({method: HttpMethod.GET, path: '/foo', handler});
-      S.defineRoute({method: HttpMethod.POST, path: '/foo', handler});
-      S.defineRoute({method: HttpMethod.DELETE, path: '/foo', handler});
-      const res = S.getAllowedMethodsForRequestPath('/foo');
-      expect(res).to.be.eql([
-        HttpMethod.GET,
-        HttpMethod.POST,
-        HttpMethod.DELETE,
-      ]);
-    });
-
-    it('should correctly resolve allowed methods for paths with parameters', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      const handler = () => undefined;
-      S.defineRoute({method: HttpMethod.GET, path: '/users/:id', handler});
-      S.defineRoute({method: HttpMethod.PUT, path: '/users/:id', handler});
-      S.defineRoute({method: HttpMethod.POST, path: '/users', handler});
-      const res = S.getAllowedMethodsForRequestPath('/users/123');
-      expect(res).to.be.eql([HttpMethod.GET, HttpMethod.PUT]);
-    });
-
-    it('should distinguish between paths with and without trailing slash', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      const handler = () => undefined;
-      S.defineRoute({method: HttpMethod.GET, path: '/foo', handler});
-      S.defineRoute({method: HttpMethod.POST, path: '/foo/', handler});
-      const res1 = S.getAllowedMethodsForRequestPath('/foo');
-      expect(res1).to.be.eql([HttpMethod.GET]);
-      const res2 = S.getAllowedMethodsForRequestPath('/foo/');
-      expect(res2).to.be.eql([HttpMethod.POST]);
-    });
-
-    it('should check for the explicitly defined OPTIONS method', function () {
-      const S = new RouteRegistry(new ServiceContainer());
-      S.defineRoute({
-        method: HttpMethod.OPTIONS,
-        path: '/api',
-        handler: () => undefined,
-      });
-      const res = S.getAllowedMethodsForRequestPath('/api');
-      expect(res).to.be.eql([HttpMethod.OPTIONS]);
-    });
-  });
 });

package/src/route/route.d.ts

@@ -7,6 +7,7 @@ import {RouterHookRegistry} from '../hooks/index.js';
  */
 export declare const HttpMethod: {
   GET: 'GET';
+  HEAD: 'HEAD';
   POST: 'POST';
   PUT: 'PUT';
   PATCH: 'PATCH';

package/src/route/route.js

@@ -24,6 +24,7 @@ import {validateRouteDefinition} from './validate-route-definition.js';
  *
  * @type {{
  *   GET: 'GET',
+ *   HEAD: 'HEAD',
  *   POST: 'POST',
  *   PUT: 'PUT',
  *   PATCH: 'PATCH',
@@ -33,6 +34,7 @@ import {validateRouteDefinition} from './validate-route-definition.js';
  */
 export const HttpMethod = {
   GET: 'GET',
+  HEAD: 'HEAD',
   POST: 'POST',
   PUT: 'PUT',
   PATCH: 'PATCH',

package/src/senders/router-data-sender.js

@@ -33,10 +33,10 @@ export class RouterDataSender extends DebuggableService {
     // если ответ контроллера является стримом,
     // то поток отправляет бинарные данные
     if (isReadableStream(data)) {
-      // если заголовок "content-type" не определен ранее,
+      // если заголовок "Content-Type" не определен ранее,
       // то устанавливается заголовок потоковых данных
-      if (!response.getHeader('content-type')) {
-        response.setHeader('content-type', 'application/octet-stream');
+      if (!response.getHeader('Content-Type')) {
+        response.setHeader('Content-Type', 'application/octet-stream');
       }
       data.pipe(response);
       debug('Sending response with a Stream.');
@@ -49,21 +49,21 @@ export class RouterDataSender extends DebuggableService {
       case 'number':
       case 'boolean':
       case 'object':
-        // для бинарных данных предусмотрен специальный "content-type",
+        // для бинарных данных предусмотрен специальный "Content-Type",
         // который устанавливается автоматически, если не был определен
         // ранее (к примеру, в обработчике маршрута)
         if (Buffer.isBuffer(data)) {
-          if (!response.getHeader('content-type')) {
-            response.setHeader('content-type', 'application/octet-stream');
+          if (!response.getHeader('Content-Type')) {
+            response.setHeader('Content-Type', 'application/octet-stream');
           }
           debugMsg = 'Buffer has been sent as binary data.';
         }
         // объекты, массивы, числа и логические значения
         // отправляются в виде JSON строки, с соответствующим
-        // заголовком "content-type" (если не был определен)
+        // заголовком "Content-Type" (если не был определен)
         else {
-          if (!response.getHeader('content-type')) {
-            response.setHeader('content-type', 'application/json');
+          if (!response.getHeader('Content-Type')) {
+            response.setHeader('Content-Type', 'application/json');
           }
           debugMsg = format(
             '%v has been sent as JSON.',
@@ -73,8 +73,8 @@ export class RouterDataSender extends DebuggableService {
         }
         break;
       default:
-        if (!response.getHeader('content-type')) {
-          response.setHeader('content-type', 'text/plain');
+        if (!response.getHeader('Content-Type')) {
+          response.setHeader('Content-Type', 'text/plain');
         }
         debugMsg = 'Response data has been sent as plain text.';
         data = String(data);

package/src/senders/router-data-sender.spec.js

@@ -80,7 +80,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks).toString('utf-8');
         expect(sentData).to.be.eq(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/octet-stream');
         callback();
         done();
@@ -90,7 +90,7 @@ describe('RouterDataSender', function () {
       S.send(res, stream);
     });
 
-    it('should allow override the "content-type" header for a readable stream', function (done) {
+    it('should allow override the "Content-Type" header for a readable stream', function (done) {
       const data = 'text';
       const stream = new Readable();
       stream._read = () => {};
@@ -98,7 +98,7 @@ describe('RouterDataSender', function () {
       stream.push(null);
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -108,7 +108,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks).toString('utf-8');
         expect(sentData).to.be.eq(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();
@@ -131,7 +131,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/json');
         callback();
         done();
@@ -141,11 +141,11 @@ describe('RouterDataSender', function () {
       S.send(res, data);
     });
 
-    it('should allow override the "content-type" header for a number value', function (done) {
+    it('should allow override the "Content-Type" header for a number value', function (done) {
       const data = 10;
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -156,7 +156,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();
@@ -179,7 +179,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/json');
         callback();
         done();
@@ -189,11 +189,11 @@ describe('RouterDataSender', function () {
       S.send(res, data);
     });
 
-    it('should allow override the "content-type" header for a boolean value', function (done) {
+    it('should allow override the "Content-Type" header for a boolean value', function (done) {
       const data = true;
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -204,7 +204,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();
@@ -226,7 +226,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks);
         expect(sentData).to.be.eql(sentData);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/octet-stream');
         callback();
         done();
@@ -236,11 +236,11 @@ describe('RouterDataSender', function () {
       S.send(res, data);
     });
 
-    it('should allow override the "content-type" header for a Buffer', function (done) {
+    it('should allow override the "Content-Type" header for a Buffer', function (done) {
       const data = Buffer.from('text');
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -250,7 +250,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks);
         expect(sentData).to.be.eql(sentData);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();
@@ -273,7 +273,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/json');
         callback();
         done();
@@ -283,11 +283,11 @@ describe('RouterDataSender', function () {
       S.send(res, data);
     });
 
-    it('should allow override the "content-type" header for an object value', function (done) {
+    it('should allow override the "Content-Type" header for an object value', function (done) {
       const data = {foo: 'bar'};
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -298,7 +298,7 @@ describe('RouterDataSender', function () {
         const sentJson = Buffer.concat(chunks).toString('utf-8');
         const sentData = JSON.parse(sentJson);
         expect(sentData).to.be.eql(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();
@@ -320,7 +320,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks).toString('utf-8');
         expect(sentData).to.be.eq(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('text/plain');
         callback();
         done();
@@ -330,11 +330,11 @@ describe('RouterDataSender', function () {
       S.send(res, data);
     });
 
-    it('should allow override the "content-type" header for a string value', function (done) {
+    it('should allow override the "Content-Type" header for a string value', function (done) {
       const data = 'text';
       const res = createResponseMock();
       const contentType = 'custom/type';
-      res.setHeader('content-type', contentType);
+      res.setHeader('Content-Type', contentType);
       const writable = new Writable();
       const chunks = [];
       writable._write = function (chunk, encoding, done) {
@@ -344,7 +344,7 @@ describe('RouterDataSender', function () {
       writable._final = function (callback) {
         const sentData = Buffer.concat(chunks).toString('utf-8');
         expect(sentData).to.be.eq(data);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq(contentType);
         callback();
         done();

package/src/senders/router-error-sender.js

@@ -63,7 +63,7 @@ export class RouterErrorSender extends DebuggableService {
       console.error(error);
     }
     response.statusCode = statusCode;
-    response.setHeader('content-type', 'application/json; charset=utf-8');
+    response.setHeader('Content-Type', 'application/json; charset=utf-8');
     response.end(JSON.stringify(body, null, 2), 'utf-8');
     debug(
       '%s error has been sent for the request %s %v.',
@@ -83,7 +83,7 @@ export class RouterErrorSender extends DebuggableService {
   send404(request, response) {
     const debug = this.getDebuggerFor(this.send404);
     response.statusCode = 404;
-    response.setHeader('content-type', 'text/plain; charset=utf-8');
+    response.setHeader('Content-Type', 'text/plain; charset=utf-8');
     response.end('404 Not Found', 'utf-8');
     debug(
       '404 error has been sent for the request %s %v.',

package/src/senders/router-error-sender.spec.js

@@ -25,7 +25,7 @@ describe('RouterErrorSender', function () {
         const data = JSON.parse(json);
         expect(data).to.be.eql({error: {message: 'Unauthorized'}});
         expect(res.statusCode).to.be.eq(401);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/json; charset=utf-8');
         callback();
         done();
@@ -57,7 +57,7 @@ describe('RouterErrorSender', function () {
         expect(data.error).not.to.have.property('shouldNotBeExposedProp');
         expect(data).to.be.eql(expectedData);
         expect(res.statusCode).to.be.eq(401);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('application/json; charset=utf-8');
         callback();
         done();
@@ -82,7 +82,7 @@ describe('RouterErrorSender', function () {
         const body = Buffer.concat(chunks).toString('utf-8');
         expect(body).to.be.eql('404 Not Found');
         expect(res.statusCode).to.be.eq(404);
-        const ct = res.getHeader('content-type');
+        const ct = res.getHeader('Content-Type');
         expect(ct).to.be.eq('text/plain; charset=utf-8');
         callback();
         done();

package/src/trie-router.js

@@ -1,10 +1,10 @@
 import {RouterBranch} from './branch/index.js';
+import {RouteRegistry} from './route/index.js';
 import {RequestParser} from './parsers/index.js';
 import {RequestContext} from './request-context.js';
 import {ServerResponse, IncomingMessage} from 'http';
 import {DebuggableService} from './debuggable-service.js';
 import {TrieRouterOptions} from './trie-router-options.js';
-import {HttpMethod, RouteRegistry} from './route/index.js';
 import {RouterDataSender, RouterErrorSender} from './senders/index.js';
 import {isServiceContainer, ServiceContainer} from '@e22m4u/js-service';
 import {isPromise, isResponseSent, getRequestPathname} from './utils/index.js';
@@ -83,7 +83,7 @@ export class TrieRouter extends DebuggableService {
    * Example:
    * ```js
    * const router = new TrieRouter();
-   * const apiBranch = router.createBranch({path: 'api'});
+   * const apiBranch = router.createBranch({path: '/api'});
    *
    * // GET /api/hello
    * apiBranch.defineRoute({
@@ -165,27 +165,6 @@ export class TrieRouter extends DebuggableService {
       const resolved =
         this.getService(RouteRegistry).matchRouteByRequest(request);
       if (!resolved) {
-        // обработка метода OPTIONS выполняется автоматически
-        // перед отправкой ошибки 404, если для пути запроса
-        // имеются другие методы, то вместо ошибки 404 будет
-        // отправлен ответ с "Allow*" заголовками
-        if (request.method.toUpperCase() === HttpMethod.OPTIONS) {
-          const allowedMethods =
-            this.getService(RouteRegistry).getAllowedMethodsForRequestPath(
-              requestPath,
-            );
-          if (allowedMethods.length > 0) {
-            debug('Auto-handling OPTIONS request.');
-            if (!allowedMethods.includes('OPTIONS')) {
-              allowedMethods.push('OPTIONS');
-            }
-            const allowHeader = allowedMethods.join(', ');
-            response.statusCode = 204;
-            response.setHeader('Allow', allowHeader);
-            response.end();
-            return;
-          }
-        }
         debug(
           'No route found for the request %s %v.',
           request.method,

package/src/trie-router.spec.js

@@ -1625,64 +1625,6 @@ describe('TrieRouter', function () {
         });
       });
     });
-
-    describe('OPTIONS method handling', function () {
-      it('should automatically return 204 with specific headers for an unhandled OPTIONS request', async function () {
-        const router = new TrieRouter();
-        router.defineRoute({
-          method: HttpMethod.GET,
-          path: '/api/resource',
-          handler: () => 'OK',
-        });
-        router.defineRoute({
-          method: HttpMethod.POST,
-          path: '/api/resource',
-          handler: () => 'OK',
-        });
-        const req = createRequestMock({
-          method: HttpMethod.OPTIONS,
-          path: '/api/resource',
-        });
-        const res = createResponseMock();
-        await router.handleRequest(req, res);
-        expect(res.statusCode).to.be.eq(204);
-        expect(res.getHeader('Allow')).to.be.eq('GET, POST, OPTIONS');
-      });
-
-      it('should execute a custom OPTIONS handler when it is explicitly defined', async function () {
-        const router = new TrieRouter();
-        let customOptionsCalled = false;
-        router.defineRoute({
-          method: HttpMethod.OPTIONS,
-          path: '/api/resource',
-          handler: () => {
-            customOptionsCalled = true;
-            return 'Custom OPTIONS response';
-          },
-        });
-        const req = createRequestMock({
-          method: HttpMethod.OPTIONS,
-          path: '/api/resource',
-        });
-        const res = createResponseMock();
-        await router.handleRequest(req, res);
-        const body = await res.getBody();
-        expect(customOptionsCalled).to.be.true;
-        expect(res.statusCode).to.be.eq(200);
-        expect(body).to.be.eq('Custom OPTIONS response');
-      });
-
-      it('should return 404 for an OPTIONS request if the path does not exist for any method', async function () {
-        const router = new TrieRouter();
-        const req = createRequestMock({
-          method: HttpMethod.OPTIONS,
-          path: '/unknown',
-        });
-        const res = createResponseMock();
-        await router.handleRequest(req, res);
-        expect(res.statusCode).to.be.eq(404);
-      });
-    });
   });
 
   describe('addHook', function () {