@e22m4u/js-trie-router 0.5.0 → 0.5.1

package/dist/cjs/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/eslint.config.js

@@ -28,6 +28,7 @@ export default [{
     ...eslintChaiExpectPlugin.configs['recommended-flat'].rules,
     ...eslintJsdocPlugin.configs['flat/recommended-error'].rules,
     'no-duplicate-imports': 'error',
+    'import/export': 0,
     'jsdoc/reject-any-type': 0,
     'jsdoc/reject-function-type': 0,
     'jsdoc/require-param-description': 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e22m4u/js-trie-router",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "HTTP маршрутизатор для Node.js на основе префиксного дерева",
   "author": "Mikhail Evstropov <e22m4u@yandex.ru>",
   "license": "MIT",
@@ -17,9 +17,11 @@
     "url": "git+https://gitrepos.ru/e22m4u/js-trie-router.git"
   },
   "type": "module",
+  "types": "./src/index.d.ts",
   "module": "./src/index.js",
   "main": "./dist/cjs/index.cjs",
   "exports": {
+    "types": "./src/index.d.ts",
     "import": "./src/index.js",
     "require": "./dist/cjs/index.cjs"
   },
@@ -27,8 +29,8 @@
     "node": ">=16"
   },
   "scripts": {
-    "lint": "eslint ./src",
-    "lint:fix": "eslint ./src --fix",
+    "lint": "tsc && eslint ./src",
+    "lint:fix": "tsc && eslint ./src --fix",
     "format": "prettier --write \"./src/**/*.{js,ts}\"",
     "test": "npm run lint && c8 --reporter=text-summary mocha --bail",
     "test:coverage": "npm run lint && c8 --reporter=text mocha",
@@ -36,10 +38,10 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@e22m4u/js-debug": "~0.4.0",
-    "@e22m4u/js-format": "~0.3.0",
-    "@e22m4u/js-path-trie": "~0.1.0",
-    "@e22m4u/js-service": "~0.5.0",
+    "@e22m4u/js-debug": "~0.4.1",
+    "@e22m4u/js-format": "~0.3.1",
+    "@e22m4u/js-path-trie": "~0.1.1",
+    "@e22m4u/js-service": "~0.5.1",
     "debug": "~4.4.3",
     "http-errors": "~2.0.1",
     "statuses": "~2.0.2"
@@ -48,6 +50,9 @@
     "@commitlint/cli": "~20.1.0",
     "@commitlint/config-conventional": "~20.0.0",
     "@eslint/js": "~9.39.1",
+    "@types/chai": "~5.2.3",
+    "@types/chai-as-promised": "~8.0.2",
+    "@types/mocha": "~10.0.10",
     "c8": "~10.1.3",
     "chai": "~6.2.1",
     "chai-as-promised": "~8.0.2",
@@ -61,7 +66,8 @@
     "globals": "~16.5.0",
     "husky": "~9.1.7",
     "mocha": "~11.7.5",
-    "prettier": "~3.7.3",
-    "rimraf": "~6.1.2"
+    "prettier": "~3.7.4",
+    "rimraf": "~6.1.2",
+    "typescript": "~5.9.3"
   }
 }

package/src/debuggable-service.d.ts

@@ -0,0 +1,6 @@
+import {DebuggableService as BaseDebuggableService} from '@e22m4u/js-service';
+
+/**
+ * Debuggable service.
+ */
+declare class DebuggableService extends BaseDebuggableService {}

package/src/hooks/hook-invoker.d.ts

@@ -0,0 +1,25 @@
+import {Route} from '../route.js';
+import {ServerResponse} from 'http';
+import {ValueOrPromise} from '../types.js';
+import {RouterHookType} from './hook-registry.js';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Hook invoker.
+ */
+export declare class HookInvoker extends DebuggableService {
+  /**
+   * Invoke and continue until value received.
+   *
+   * @param route
+   * @param hookType
+   * @param response
+   * @param args
+   */
+  invokeAndContinueUntilValueReceived(
+    route: Route,
+    hookType: RouterHookType,
+    response: ServerResponse,
+    ...args: unknown[]
+  ): ValueOrPromise<unknown>;
+}

package/src/hooks/hook-registry.d.ts

@@ -0,0 +1,93 @@
+import {Callable} from '../types.js';
+import {RequestContext} from '../request-context.js';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Hook type.
+ */
+export declare const RouterHookType: {
+  PRE_HANDLER: 'preHandler';
+  POST_HANDLER: 'postHandler';
+};
+
+/**
+ * Type of RouterHookType.
+ */
+export type RouterHookType =
+  (typeof RouterHookType)[keyof typeof RouterHookType];
+
+/**
+ * Router hook.
+ */
+export type RouterHook = Callable;
+
+/**
+ * Pre handler hook.
+ */
+export type PreHandlerHook = (ctx: RequestContext) => unknown;
+
+/**
+ * Post handler hook.
+ */
+export type PostHandlerHook = (ctx: RequestContext, data: unknown) => unknown;
+
+/**
+ * Hook registry.
+ */
+export declare class HookRegistry extends DebuggableService {
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(type: typeof RouterHookType.PRE_HANDLER, hook: PreHandlerHook): this;
+
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(
+    type: typeof RouterHookType.POST_HANDLER,
+    hook: PostHandlerHook,
+  ): this;
+
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(type: RouterHookType, hook: RouterHook): this;
+
+  /**
+   * Has hook.
+   *
+   * @param type
+   * @param hook
+   */
+  hasHook(type: RouterHookType, hook: RouterHook): boolean;
+
+  /**
+   * Get hooks.
+   *
+   * @param type
+   */
+  getHooks(type: typeof RouterHookType.PRE_HANDLER): PreHandlerHook[];
+
+  /**
+   * Get hooks.
+   *
+   * @param type
+   */
+  getHooks(type: typeof RouterHookType.POST_HANDLER): PostHandlerHook[];
+
+  /**
+   * Get hooks.
+   *
+   * @param type
+   */
+  getHooks(type: RouterHookType): RouterHook[];
+}

package/src/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './hook-invoker.js';
+export * from './hook-registry.js';

package/src/index.d.ts

@@ -0,0 +1,9 @@
+export * from './route.js';
+export * from './utils/index.js';
+export * from './hooks/index.js';
+export * from './trie-router.js';
+export * from './parsers/index.js';
+export * from './senders/index.js';
+export * from './route-registry.js';
+export * from './router-options.js';
+export * from './request-context.js';

package/src/parsers/body-parser.d.ts

@@ -0,0 +1,52 @@
+import {IncomingMessage} from 'http';
+import {ValueOrPromise} from '../types.js';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Method names to be parsed.
+ */
+export type METHODS_WITH_BODY = string[];
+
+/**
+ * Unparsable media types.
+ */
+export type UNPARSABLE_MEDIA_TYPES = string[];
+
+/**
+ * Body parser function.
+ */
+export type BodyParserFunction = <T = unknown>(input: string) => T;
+
+/**
+ * Body parser.
+ */
+export declare class BodyParser extends DebuggableService {
+  /**
+   * Define parser.
+   *
+   * @param mediaType
+   * @param parser
+   */
+  defineParser(mediaType: string, parser: BodyParserFunction): this;
+
+  /**
+   * Has parser.
+   *
+   * @param mediaType
+   */
+  hasParser(mediaType: string): boolean;
+
+  /**
+   * Delete parser.
+   *
+   * @param mediaType
+   */
+  deleteParser(mediaType: string): this;
+
+  /**
+   * Parse.
+   *
+   * @param request
+   */
+  parse<T = unknown>(request: IncomingMessage): ValueOrPromise<T>;
+}

package/src/parsers/cookies-parser.d.ts

@@ -0,0 +1,15 @@
+import {IncomingMessage} from 'http';
+import {ParsedCookies} from '../utils/index.js';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Cookies parser.
+ */
+export declare class CookiesParser extends DebuggableService {
+  /**
+   * Parse.
+   *
+   * @param request
+   */
+  parse(request: IncomingMessage): ParsedCookies;
+}

package/src/parsers/index.d.ts

@@ -0,0 +1,4 @@
+export * from './body-parser.js';
+export * from './query-parser.js';
+export * from './cookies-parser.js';
+export * from './request-parser.js';

package/src/parsers/query-parser.d.ts

@@ -0,0 +1,21 @@
+import {IncomingMessage} from 'http';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Parsed query.
+ */
+export type ParsedQuery = {
+  [key: string]: string | undefined;
+};
+
+/**
+ * Query parser.
+ */
+export declare class QueryParser extends DebuggableService {
+  /**
+   * Parse.
+   *
+   * @param request
+   */
+  parse(request: IncomingMessage): ParsedQuery;
+}

package/src/parsers/request-parser.d.ts

@@ -0,0 +1,34 @@
+import {IncomingMessage} from 'http';
+import {ValueOrPromise} from '../types.js';
+import {ParsedQuery} from './query-parser.js';
+import {ParsedCookies} from '../utils/index.js';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Parsed headers.
+ */
+export type ParsedHeaders = {
+  [key: string]: string | undefined;
+};
+
+/**
+ * Parsed request.
+ */
+type ParsedRequestData = {
+  query: ParsedQuery;
+  cookies: ParsedCookies;
+  body: unknown;
+  headers: ParsedHeaders;
+};
+
+/**
+ * Request parser.
+ */
+export declare class RequestParser extends DebuggableService {
+  /**
+   * Parse.
+   *
+   * @param request
+   */
+  parse(request: IncomingMessage): ValueOrPromise<ParsedRequestData>;
+}

package/src/request-context.d.ts

@@ -0,0 +1,101 @@
+import {Route, RouteMeta} from './route.js';
+import {ParsedCookies} from './utils/index.js';
+import {ServiceContainer} from '@e22m4u/js-service';
+import {IncomingMessage, ServerResponse} from 'http';
+import {ParsedQuery, ParsedHeaders} from './parsers/index.js';
+
+/**
+ * Parsed params.
+ */
+export type ParsedParams = {
+  [key: string]: string | undefined;
+};
+
+/**
+ * Request context.
+ */
+export declare class RequestContext {
+  /**
+   * Container.
+   */
+  get container(): ServiceContainer;
+
+  /**
+   * Request.
+   */
+  get request(): IncomingMessage;
+
+  /**
+   * Response.
+   */
+  get response(): ServerResponse;
+
+  /**
+   * Route.
+   */
+  get route(): Route;
+
+  /**
+   * Query.
+   */
+  query: ParsedQuery;
+
+  /**
+   * Params.
+   */
+  params: ParsedParams;
+
+  /**
+   * Headers.
+   */
+  headers: ParsedHeaders;
+
+  /**
+   * Cookies.
+   */
+  cookies: ParsedCookies;
+
+  /**
+   * Body.
+   */
+  body: unknown;
+
+  /**
+   * State.
+   */
+  state: Record<string, any>;
+
+  /**
+   * Route meta.
+   */
+  get meta(): RouteMeta;
+
+  /**
+   * Method.
+   */
+  get method(): string;
+
+  /**
+   * Path.
+   */
+  get path(): string;
+
+  /**
+   * Pathname.
+   */
+  get pathname(): string;
+
+  /**
+   * Constructor.
+   *
+   * @param container
+   * @param request
+   * @param response
+   */
+  constructor(
+    container: ServiceContainer,
+    request: IncomingMessage,
+    response: ServerResponse,
+    route: Route,
+  );
+}

package/src/route-registry.d.ts

@@ -0,0 +1,39 @@
+import {Route} from './route.js';
+import {IncomingMessage} from 'http';
+import {RouteDefinition} from './route.js';
+import {ServiceContainer} from '@e22m4u/js-service';
+import {DebuggableService} from './debuggable-service.js';
+
+/**
+ * Resolved route.
+ */
+export type ResolvedRoute = {
+  route: Route;
+  params: {[key: string]: string | undefined};
+};
+
+/**
+ * Route registry.
+ */
+export declare class RouteRegistry extends DebuggableService {
+  /**
+   * Constructor.
+   *
+   * @param container
+   */
+  constructor(container: ServiceContainer);
+
+  /**
+   * Define route.
+   *
+   * @param routeDef
+   */
+  defineRoute(routeDef: RouteDefinition): Route;
+
+  /**
+   * Match route by request.
+   *
+   * @param request
+   */
+  matchRouteByRequest(request: IncomingMessage): ResolvedRoute | undefined;
+}

package/src/route.d.ts

@@ -0,0 +1,100 @@
+import {ValueOrPromise} from './types.js';
+import {HookRegistry} from './hooks/index.js';
+import {RequestContext} from './request-context.js';
+
+/**
+ * Http method.
+ */
+export declare const HttpMethod: {
+  GET: 'GET';
+  POST: 'POST';
+  PUT: 'PUT';
+  PATCH: 'PATCH';
+  DELETE: 'DELETE';
+};
+
+/**
+ * Type of HttpMethod.
+ */
+export type HttpMethod = (typeof HttpMethod)[keyof typeof HttpMethod];
+
+/**
+ * Route handler.
+ */
+export type RouteHandler = (ctx: RequestContext) => ValueOrPromise<unknown>;
+
+/**
+ * Route pre-handler.
+ */
+export type RoutePreHandler = RouteHandler;
+
+/**
+ * Route post-handler.
+ */
+export type RoutePostHandler<T = unknown, U = unknown> = (
+  ctx: RequestContext,
+  data: T,
+) => ValueOrPromise<U>;
+
+/**
+ * Route meta.
+ */
+export type RouteMeta = {
+  [key: string]: unknown;
+};
+
+/**
+ * Route definition.
+ */
+export type RouteDefinition = {
+  method: string;
+  path: string;
+  handler: RouteHandler;
+  preHandler?: RoutePreHandler | RoutePreHandler[];
+  postHandler?: RoutePostHandler | RoutePostHandler[];
+  meta?: RouteMeta;
+};
+
+/**
+ * Route.
+ */
+export declare class Route {
+  /**
+   * Method.
+   */
+  get method(): string;
+
+  /**
+   * Path.
+   */
+  get path(): string;
+
+  /**
+   * Meta.
+   */
+  get meta(): RouteMeta;
+
+  /**
+   * Handler.
+   */
+  get handler(): RouteHandler;
+
+  /**
+   * Hook registry.
+   */
+  get hookRegistry(): HookRegistry;
+
+  /**
+   * Constructor.
+   *
+   * @param routeDef
+   */
+  constructor(routeDef: RouteDefinition);
+
+  /**
+   * Handle.
+   *
+   * @param context
+   */
+  handle(context: RequestContext): ValueOrPromise<unknown>;
+}

package/src/router-options.d.ts

@@ -0,0 +1,18 @@
+import {DebuggableService} from './debuggable-service.js';
+
+/**
+ * Router options.
+ */
+export declare class RouterOptions extends DebuggableService {
+  /**
+   * Request body bytes limit.
+   */
+  get requestBodyBytesLimit(): number;
+
+  /**
+   * Set request body bytes limit.
+   *
+   * @param input
+   */
+  setRequestBodyBytesLimit(input: number): this;
+}

package/src/senders/data-sender.d.ts

@@ -0,0 +1,15 @@
+import {ServerResponse} from 'http';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Data sender.
+ */
+export declare class DataSender extends DebuggableService {
+  /**
+   * Send.
+   *
+   * @param response
+   * @param data
+   */
+  send(response: ServerResponse, data: unknown): void;
+}

package/src/senders/error-sender.d.ts

@@ -0,0 +1,30 @@
+import {ServerResponse} from 'http';
+import {IncomingMessage} from 'http';
+import {DebuggableService} from '../debuggable-service.js';
+
+/**
+ * Exposed error properties.
+ */
+export const EXPOSED_ERROR_PROPERTIES: ['code', 'details'];
+
+/**
+ * Error sender.
+ */
+export declare class ErrorSender extends DebuggableService {
+  /**
+   * Send.
+   *
+   * @param request
+   * @param response
+   * @param error
+   */
+  send(request: IncomingMessage, response: ServerResponse, error: Error): void;
+
+  /**
+   * Send 404.
+   *
+   * @param request
+   * @param response
+   */
+  send404(request: IncomingMessage, response: ServerResponse): void;
+}

package/src/senders/index.d.ts

@@ -0,0 +1,2 @@
+export * from './data-sender.js';
+export * from './error-sender.js';

package/src/trie-router.d.ts

@@ -0,0 +1,104 @@
+import {Route} from './route.js';
+import {RequestListener} from 'http';
+import {RouteDefinition} from './route.js';
+import {DebuggableService} from './debuggable-service.js';
+
+import {
+  RouterHook,
+  RouterHookType,
+  PostHandlerHook,
+  PreHandlerHook,
+} from './hooks/index.js';
+
+/**
+ * Trie router.
+ */
+export declare class TrieRouter extends DebuggableService {
+  /**
+   * Define route.
+   *
+   * Example 1:
+   * ```
+   * const router = new TrieRouter();
+   * router.defineRoute({
+   *   method: HttpMethod.GET,        // Request method.
+   *   path: '/',                      // Path template.
+   *   handler: ctx => 'Hello world!', // Request handler.
+   * });
+   * ```
+   *
+   * Example 2:
+   * ```
+   * const router = new TrieRouter();
+   * router.defineRoute({
+   *   method: HttpMethod.POST,       // Request method.
+   *   path: '/users/:id',             // The path template may have parameters.
+   *   preHandler(ctx) { ... },        // The "preHandler" is executed before a route handler.
+   *   handler(ctx) { ... },           // Request handler function.
+   *   postHandler(ctx, data) { ... }, // The "postHandler" is executed after a route handler
+   * });
+   * ```
+   *
+   * @param routeDef
+   */
+  defineRoute(routeDef: RouteDefinition): Route;
+
+  /**
+   * Request listener.
+   *
+   * Example:
+   * ```
+   * import http from 'http';
+   * import {TrieRouter} from '@e22m4u/js-trie-router';
+   *
+   * const router = new TrieRouter();
+   * const server = new http.Server();
+   * server.on('request', router.requestListener); // Sets the request listener.
+   * server.listen(3000);                          // Starts listening for connections.
+   * ```
+   *
+   * @returns {Function}
+   */
+  get requestListener(): RequestListener;
+
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(type: typeof RouterHookType.PRE_HANDLER, hook: PreHandlerHook): this;
+
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(
+    type: typeof RouterHookType.POST_HANDLER,
+    hook: PostHandlerHook,
+  ): this;
+
+  /**
+   * Add hook.
+   *
+   * @param type
+   * @param hook
+   */
+  addHook(type: RouterHookType, hook: RouterHook): this;
+
+  /**
+   * Add pre-handler hook.
+   *
+   * @param hook
+   */
+  addPreHandler(hook: PreHandlerHook): this;
+
+  /**
+   * Add post-handler hook.
+   *
+   * @param hook
+   */
+  addPostHandler(hook: PostHandlerHook): this;
+}

package/src/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A callable type with the "new" operator
+ * allows class and constructor.
+ */
+export interface Constructor<T = unknown> {
+  new (...args: any[]): T;
+}
+
+/**
+ * A function type without class and constructor.
+ */
+export type Callable<T = unknown> = (...args: any[]) => T;
+
+/**
+ * Representing a value or promise. This type is used
+ * to represent results of synchronous/asynchronous
+ * resolution of values.
+ */
+export type ValueOrPromise<T> = T | PromiseLike<T>;

package/src/utils/clone-deep.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clone deep.
+ *
+ * @param value
+ */
+export declare function cloneDeep<T>(value: T): T;

package/src/utils/create-cookies-string.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Create cookies string.
+ *
+ * @param data
+ */
+export declare function createCookiesString(data: object): string;

package/src/utils/create-debugger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Debugger.
+ */
+export type Debugger = (message: string, ...args: unknown[]) => void;
+
+/**
+ * Create debugger.
+ *
+ * @param name
+ */
+export declare function createDebugger(name: string): Debugger;

package/src/utils/create-error.d.ts

@@ -0,0 +1,14 @@
+import {Constructor} from '../types.js';
+
+/**
+ * Create error.
+ *
+ * @param errorCtor
+ * @param message
+ * @param args
+ */
+export declare function createError<T>(
+  errorCtor: Constructor<T>,
+  message: string,
+  ...args: unknown[]
+): T;

package/src/utils/create-request-mock.d.ts

@@ -0,0 +1,27 @@
+import {Readable} from 'stream';
+import {IncomingMessage} from 'http';
+
+/**
+ * Request patch.
+ */
+type RequestPatch = {
+  host?: string;
+  method?: string;
+  secure?: boolean;
+  path?: string;
+  query?: object;
+  cookies?: object;
+  headers?: object;
+  body?: string;
+  stream?: Readable;
+  encoding?: BufferEncoding;
+};
+
+/**
+ * Create request mock.
+ *
+ * @param patch
+ */
+export declare function createRequestMock(
+  patch?: RequestPatch,
+): IncomingMessage;

package/src/utils/create-response-mock.d.ts

@@ -0,0 +1,17 @@
+import {ServerResponse} from 'http';
+
+/**
+ * Server response mock.
+ */
+export type ServerResponseMock = ServerResponse & {
+  _headersSent: boolean;
+  _headers: {[name: string]: string | undefined};
+  setEncoding(encoding: string): ServerResponseMock;
+  getEncoding(): string | undefined;
+  getBody(): Promise<string>;
+};
+
+/**
+ * Create response mock.
+ */
+export declare function createResponseMock(): ServerResponseMock;

package/src/utils/create-route-mock.d.ts

@@ -0,0 +1,18 @@
+import {Route, HttpMethod} from '../route.js';
+import type {RouteHandler} from '../route.js';
+
+/**
+ * Route mock options.
+ */
+type RouteMockOptions = {
+  method?: HttpMethod;
+  path?: string;
+  handler?: RouteHandler;
+};
+
+/**
+ * Create route mock.
+ *
+ * @param options
+ */
+export function createRouteMock(options?: RouteMockOptions): Route;

package/src/utils/fetch-request-body.d.ts

@@ -0,0 +1,26 @@
+import {IncomingMessage} from 'http';
+
+/**
+ * Character encoding list.
+ */
+export const CHARACTER_ENCODING_LIST: (
+  | 'ascii'
+  | 'utf8'
+  | 'utf-8'
+  | 'utf16le'
+  | 'utf-16le'
+  | 'ucs2'
+  | 'ucs-2'
+  | 'latin1'
+)[];
+
+/**
+ * Fetch request body.
+ *
+ * @param request
+ * @param bodyBytesLimit
+ */
+export declare function fetchRequestBody(
+  request: IncomingMessage,
+  bodyBytesLimit?: number,
+): Promise<string>;

package/src/utils/get-request-pathname.d.ts

@@ -0,0 +1,8 @@
+import {IncomingMessage} from 'http';
+
+/**
+ * Get request pathname.
+ *
+ * @param request
+ */
+export declare function getRequestPathname(request: IncomingMessage): string;

package/src/utils/index.d.ts

@@ -0,0 +1,16 @@
+export * from './clone-deep.js';
+export * from './is-promise.js';
+export * from './create-error.js';
+export * from './parse-cookies.js';
+export * from './to-camel-case.js';
+export * from './create-debugger.js';
+export * from './is-response-sent.js';
+export * from './create-route-mock.js';
+export * from './is-readable-stream.js';
+export * from './parse-content-type.js';
+export * from './is-writable-stream.js';
+export * from './fetch-request-body.js';
+export * from './create-request-mock.js';
+export * from './create-response-mock.js';
+export * from './create-cookies-string.js';
+export * from './get-request-pathname.js';

package/src/utils/is-promise.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check whether a value is a Promise-like
+ * instance. Recognizes both native promises
+ * and third-party promise libraries.
+ *
+ * @param value
+ */
+export declare function isPromise<T = unknown>(
+  value: unknown,
+): value is Promise<T>;

package/src/utils/is-readable-stream.d.ts

@@ -0,0 +1,9 @@
+import {Readable} from 'stream';
+
+/**
+ * Check whether a value has a pipe
+ * method.
+ *
+ * @param value
+ */
+export declare function isReadableStream(value: unknown): value is Readable;

package/src/utils/is-response-sent.d.ts

@@ -0,0 +1,8 @@
+import {ServerResponse} from 'http';
+
+/**
+ * Is response sent.
+ *
+ * @param response
+ */
+export declare function isResponseSent(response: ServerResponse): boolean;

package/src/utils/is-writable-stream.d.ts

@@ -0,0 +1,9 @@
+import {Writable} from 'stream';
+
+/**
+ * Check whether a value has an end
+ * method.
+ *
+ * @param value
+ */
+export declare function isWritableStream(value: unknown): value is Writable;

package/src/utils/parse-content-type.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parsed content type.
+ */
+export type ParsedContentType = {
+  boundary: string | undefined;
+  charset: string | undefined;
+  mediaType: string | undefined;
+};
+
+/**
+ * Parse content type.
+ *
+ * @param input
+ */
+export declare function parseContentType(input: string): ParsedContentType;

package/src/utils/parse-cookies.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parsed cookies.
+ */
+type ParsedCookies = {
+  [key: string]: string | undefined;
+};
+
+/**
+ * Parse cookies.
+ *
+ * @example
+ * ```ts
+ * parseCookies('pkg=math; equation=E%3Dmc%5E2');
+ * // {pkg: 'math', equation: 'E=mc^2'}
+ * ```
+ *
+ * @param input
+ */
+export declare function parseCookies(input: string): ParsedCookies;

package/src/utils/to-camel-case.d.ts

@@ -0,0 +1,6 @@
+/**
+ * To camel case.
+ *
+ * @param input
+ */
+export declare function toCamelCase(input: string): string;

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "es2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "noEmit": true,
+    "allowJs": true
+  },
+  "include": [
+    "./src/**/*.ts",
+    "./src/**/*.js"
+  ]
+}

package/jsconfig.json

@@ -1,7 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext"
-  }
-}