@adonisjs/http-server 8.0.0-next.4 → 8.0.0-next.6

package/build/src/router/brisk.d.ts

@@ -3,7 +3,7 @@ import type { Application } from '@adonisjs/application';
 import { Route } from './route.ts';
 import type { RouteFn, RouteMatchers } from '../types/route.ts';
 import type { ParsedGlobalMiddleware } from '../types/middleware.ts';
-import type { RoutesList, URLOptions, GetRoutesForMethod, RouteBuilderArguments } from '../types/url_builder.ts';
+import type { RoutesList, LookupList, URLOptions, GetRoutesForMethod, RouteBuilderArguments } from '../types/url_builder.ts';
 /**
  * Brisk routes exposes the API to configure the route handler by chaining
  * one of the pre-defined methods.
@@ -19,23 +19,34 @@ export declare class BriskRoute extends Macroable {
      * Reference to route instance. Set after `setHandler` is called
      */
     route: null | Route;
+    /**
+     * Creates a new BriskRoute instance
+     * @param app - The AdonisJS application instance
+     * @param routerMiddleware - Array of global middleware registered on the router
+     * @param options - Configuration options for the brisk route
+     */
     constructor(app: Application<any>, routerMiddleware: ParsedGlobalMiddleware[], options: {
         pattern: string;
         globalMatchers: RouteMatchers;
     });
     /**
      * Set handler for the brisk route
+     * @param handler - The route handler function
+     * @returns The created route instance
      */
     setHandler(handler: RouteFn): Route;
     /**
      * Redirects to a given route. Params from the original request will
      * be used when no custom params are defined.
+     * @param args - Route identifier, parameters, and options for building the redirect URL
+     * @returns The created route instance
      */
-    redirect<Identifier extends keyof GetRoutesForMethod<'GET'> & string>(...args: RouteBuilderArguments<RoutesList, Identifier, 'GET', URLOptions & {
-        status: number;
-    }>): Route;
+    redirect<Identifier extends keyof GetRoutesForMethod<RoutesList, 'GET'> & string>(...args: RoutesList extends LookupList ? RouteBuilderArguments<Identifier, RoutesList['GET'][Identifier], URLOptions> : []): Route;
     /**
      * Redirect request to a fixed URL
+     * @param url - The URL to redirect to
+     * @param options - Optional redirect options including HTTP status code
+     * @returns The created route instance
      */
     redirectToPath(url: string, options?: {
         status: number;

package/build/src/router/executor.d.ts

@@ -5,5 +5,9 @@ import type { ServerErrorHandler } from '../types/server.ts';
 /**
  * Executor to execute the route middleware pipeline the route
  * handler
+ * @param route - The route JSON object containing route information
+ * @param resolver - Container resolver for dependency injection
+ * @param ctx - The HTTP context instance
+ * @param errorResponder - Error handler function for handling errors
  */
 export declare function execute(route: RouteJSON, resolver: ContainerResolver<any>, ctx: HttpContext, errorResponder: ServerErrorHandler['handle']): Promise<void>;

package/build/src/router/factories/use_return_value.d.ts

@@ -2,10 +2,15 @@ import { type HttpContext } from '../../http_context/main.ts';
 /**
  * Check if the value can be used to write the response body. Returns
  * false when the response body has already been set
+ * @param value - The value to check
+ * @param ctx - The HTTP context instance
+ * @returns True if value can be used for response body
  */
 export declare function canWriteResponseBody(value: any, ctx: HttpContext): boolean;
 /**
  * A factory function that uses the return value of the request
  * pipeline as the response
+ * @param ctx - The HTTP context instance
+ * @returns Function that handles return values
  */
 export declare function useReturnValue(ctx: HttpContext): (value: any) => void;

package/build/src/router/group.d.ts

@@ -12,6 +12,10 @@ import type { MiddlewareFn, ParsedNamedMiddleware } from '../types/middleware.ts
 export declare class RouteGroup extends Macroable {
     #private;
     routes: (Route | RouteGroup | RouteResource | BriskRoute)[];
+    /**
+     * Creates a new RouteGroup instance
+     * @param routes - Array of routes that belong to this group
+     */
     constructor(routes: (Route | RouteGroup | RouteResource | BriskRoute)[]);
     /**
      * Define route param matcher
@@ -20,6 +24,9 @@ export declare class RouteGroup extends Macroable {
      * Route.group(() => {
      * }).where('id', /^[0-9]+/)
      * ```
+     * @param param - The parameter name to match
+     * @param matcher - The matcher pattern (RegExp, string, or RouteMatcher)
+     * @returns Current RouteGroup instance for method chaining
      */
     where(param: string, matcher: RouteMatcher | string | RegExp): this;
     /**
@@ -29,6 +36,8 @@ export declare class RouteGroup extends Macroable {
      * Route.group(() => {
      * }).prefix('v1')
      * ```
+     * @param prefix - The prefix to add to all routes in the group
+     * @returns Current RouteGroup instance for method chaining
      */
     prefix(prefix: string): this;
     /**
@@ -38,6 +47,8 @@ export declare class RouteGroup extends Macroable {
      * Route.group(() => {
      * }).domain(':name.adonisjs.com')
      * ```
+     * @param domain - The domain pattern for all routes in the group
+     * @returns Current RouteGroup instance for method chaining
      */
     domain(domain: string): this;
     /**
@@ -47,6 +58,8 @@ export declare class RouteGroup extends Macroable {
      * Route.group(() => {
      * }).as('version1')
      * ```
+     * @param name - The name to prepend to all route names in the group
+     * @returns Current RouteGroup instance for method chaining
      */
     as(name: string): this;
     /**
@@ -56,10 +69,14 @@ export declare class RouteGroup extends Macroable {
      * Route.group(() => {
      * }).use(middleware.auth())
      * ```
+     * @param middleware - Middleware function(s) to apply to all routes in the group
+     * @returns Current RouteGroup instance for method chaining
      */
     use(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
      * @alias use
+     * @param middleware - Middleware function(s) to apply to all routes in the group
+     * @returns Current RouteGroup instance for method chaining
      */
     middleware(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
 }

package/build/src/router/legacy/url_builder.d.ts

@@ -17,6 +17,11 @@ import { type Router } from '../main.ts';
  */
 export declare class UrlBuilder {
     #private;
+    /**
+     * Creates a new UrlBuilder instance
+     * @param router - The router instance
+     * @param domain - Optional domain for URL generation
+     */
     constructor(router: Router, domain?: string);
     /**
      * Prefix a custom base URL to the final URI
@@ -50,6 +55,8 @@ export declare class UrlBuilder {
      *
      * @deprecated
      * Instead use "@adonisjs/core/services/url_builder" instead
+     * @param identifier - Route identifier to generate URL for
+     * @returns Generated URL string
      */
     make(identifier: string): string;
     /**

package/build/src/router/main.d.ts

@@ -9,7 +9,7 @@ import { RouteResource } from './resource.ts';
 import { UrlBuilder } from './legacy/url_builder.ts';
 import { RouteMatchers as Matchers } from './matchers.ts';
 import type { MiddlewareAsClass, ParsedGlobalMiddleware } from '../types/middleware.ts';
-import type { RouteFn, RouteJSON, MatchedRoute, RouteMatchers, MakeUrlOptions, MakeSignedUrlOptions, GetControllerHandlers, RouteMatcher } from '../types/route.ts';
+import type { RouteFn, RouteJSON, MatchedRoute, RouteMatcher, RouteMatchers, MakeUrlOptions, MakeSignedUrlOptions, GetControllerHandlers } from '../types/route.ts';
 import { type UrlFor, type LookupList, type RoutesList, type SignedURLOptions } from '../types/url_builder.ts';
 /**
  * Router class exposes a unified API to register new routes, group them or
@@ -61,6 +61,12 @@ export declare class Router {
     protected routes: {
         [domain: string]: RouteJSON[];
     };
+    /**
+     * Creates a new Router instance
+     * @param app - The AdonisJS application instance
+     * @param encryption - Encryption service for signed URLs
+     * @param qsParser - Query string parser for URL generation
+     */
     constructor(app: Application<any>, encryption: Encryption, qsParser: Qs);
     /**
      * Register route JSON payload
@@ -68,18 +74,24 @@ export declare class Router {
     protected register(route: RouteJSON): void;
     /**
      * Parses the route pattern
+     * @param pattern - The route pattern to parse
+     * @param matchers - Optional route matchers
      */
     parsePattern(pattern: string, matchers?: RouteMatchers): import("../types/route.ts").MatchItRouteToken[];
     /**
      * Define an array of middleware to use on all the routes.
      * Calling this method multiple times pushes to the
      * existing list of middleware
+     * @param middleware - Array of middleware classes to apply globally
+     * @returns Current Router instance for method chaining
      */
     use(middleware: LazyImport<MiddlewareAsClass>[]): this;
     /**
      * Define a collection of named middleware. The defined collection is
      * not registered anywhere, but instead converted in a new collection
      * of functions you can apply on the routes, or router groups.
+     * @param collection - Object mapping middleware names to middleware classes
+     * @returns Named middleware functions
      */
     named<NamedMiddleware extends Record<string, LazyImport<MiddlewareAsClass>>>(collection: NamedMiddleware): { [K in keyof NamedMiddleware]: <Args extends import("../types/middleware.ts").GetMiddlewareArgs<import("@poppinss/utils/types").UnWrapLazyImport<NamedMiddleware[K]>>>(...args: Args) => {
         name: K;
@@ -89,52 +101,87 @@ export declare class Router {
     }; };
     /**
      * Add route for a given pattern and methods
+     * @param pattern - The route pattern
+     * @param methods - Array of HTTP methods
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     route<T extends Constructor<any>>(pattern: string, methods: string[], handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define a route that handles all common HTTP methods
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     any<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define `GET` route
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     get<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define `POST` route
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     post<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define `PUT` route
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     put<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define `PATCH` route
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     patch<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Define `DELETE` route
+     * @param pattern - The route pattern
+     * @param handler - Route handler (function, string, or controller tuple)
+     * @returns The created route instance
      */
     delete<T extends Constructor<any>>(pattern: string, handler: string | RouteFn | [LazyImport<T> | T, GetControllerHandlers<T>?]): Route<T>;
     /**
      * Creates a group of routes. A route group can apply transforms
      * to routes in bulk
+     * @param callback - Function that defines routes within the group
+     * @returns The created route group instance
      */
     group(callback: () => void): RouteGroup;
     /**
      * Registers a route resource with conventional set of routes
+     * @param resource - The resource name
+     * @param controller - Controller to handle the resource
+     * @returns The created route resource instance
      */
     resource(resource: string, controller: string | LazyImport<Constructor<any>> | Constructor<any>): RouteResource<import("../types/route.ts").ResourceActionNames>;
     /**
      * Register a route resource with shallow nested routes.
+     * @param resource - The resource name
+     * @param controller - Controller to handle the resource
+     * @returns The created route resource instance
      */
     shallowResource(resource: string, controller: string | LazyImport<Constructor<any>> | Constructor<any>): RouteResource<import("../types/route.ts").ResourceActionNames>;
     /**
      * Returns a brisk route instance for a given URL pattern
+     * @param pattern - The route pattern
+     * @returns The created brisk route instance
      */
     on(pattern: string): BriskRoute;
     /**
      * Define matcher for a given param. The global params are applied
      * on all the routes (unless overridden at the route level).
+     * @param param - The parameter name to match
+     * @param matcher - The matcher pattern (RegExp, string, or RouteMatcher)
+     * @returns Current Router instance for method chaining
      */
     where(param: string, matcher: RouteMatcher | string | RegExp): this;
     /**
@@ -149,6 +196,11 @@ export declare class Router {
      *
      * When "disableLegacyLookup" is set, the lookup will be performed
      * only using the route name
+     * @param routeIdentifier - Route name, pattern, or controller reference
+     * @param domain - Optional domain to search within
+     * @param method - Optional HTTP method to filter by
+     * @param disableLegacyLookup - Whether to disable legacy lookup strategies
+     * @returns Found route or null if not found
      */
     find(routeIdentifier: string, domain?: string, method?: string, disableLegacyLookup?: boolean): RouteJSON | null;
     /**
@@ -160,6 +212,12 @@ export declare class Router {
      *
      * When "disableLegacyLookup" is set, the lookup will be performed
      * only using the route name
+     * @param routeIdentifier - Route name, pattern, or controller reference
+     * @param domain - Optional domain to search within
+     * @param method - Optional HTTP method to filter by
+     * @param disableLegacyLookup - Whether to disable legacy lookup strategies
+     * @returns Found route
+     * @throws Error when route is not found
      */
     findOrFail(routeIdentifier: string, domain?: string, method?: string, disableLegacyLookup?: boolean): RouteJSON;
     /**
@@ -170,10 +228,16 @@ export declare class Router {
      * When "followLookupStrategy" is enabled, the lookup will be performed
      * on the basis of the lookup strategy enabled via the "lookupStrategies"
      * method. The default lookupStrategy is "name" and "pattern".
+     * @param routeIdentifier - Route name, pattern, or controller reference
+     * @param domain - Optional domain to search within
+     * @param method - Optional HTTP method to filter by
+     * @param followLookupStrategy - Whether to follow the configured lookup strategy
+     * @returns True if route exists, false otherwise
      */
     has(routeIdentifier: string, domain?: string, method?: string, followLookupStrategy?: boolean): boolean;
     /**
      * Returns a list of routes grouped by their domain names
+     * @returns Object mapping domain names to route arrays
      */
     toJSON(): {
         [domain: string]: RouteJSON[];
@@ -182,10 +246,17 @@ export declare class Router {
      * Generates types for the URL builder. These types must
      * be written inside a file for the URL builder to
      * pick them up.
+     * @param indentation - Indentation level for generated types
+     * @returns Generated TypeScript types as string
      */
     generateTypes(indentation?: number): string;
     /**
      * Find route for a given URL, method and optionally domain
+     * @param uri - The URI to match
+     * @param method - HTTP method
+     * @param shouldDecodeParam - Whether to decode parameters
+     * @param hostname - Optional hostname for domain matching
+     * @returns Matched route or null if no match found
      */
     match(uri: string, method: string, shouldDecodeParam: boolean, hostname?: string | null): null | MatchedRoute;
     /**

package/build/src/router/matchers.d.ts

@@ -6,6 +6,7 @@ export declare class RouteMatchers extends Macroable {
     /**
      * Enforce value to be a number and also casts it to number data
      * type
+     * @returns Route matcher configuration for numeric values
      */
     number(): {
         match: RegExp;
@@ -13,6 +14,7 @@ export declare class RouteMatchers extends Macroable {
     };
     /**
      * Enforce value to be formatted as uuid
+     * @returns Route matcher configuration for UUID values
      */
     uuid(): {
         match: RegExp;
@@ -20,6 +22,7 @@ export declare class RouteMatchers extends Macroable {
     };
     /**
      * Enforce value to be formatted as slug
+     * @returns Route matcher configuration for slug values
      */
     slug(): {
         match: RegExp;

package/build/src/router/resource.d.ts

@@ -13,6 +13,12 @@ export declare class RouteResource<ActionNames extends ResourceActionNames = Res
      * A collection of routes instances that belongs to this resource
      */
     routes: Route[];
+    /**
+     * Creates a new RouteResource instance
+     * @param app - The AdonisJS application instance
+     * @param routerMiddleware - Array of global middleware registered on the router
+     * @param options - Configuration options for the route resource
+     */
     constructor(app: Application<any>, routerMiddleware: ParsedGlobalMiddleware[], options: {
         resource: string;
         controller: string | LazyImport<Constructor<any>> | Constructor<any>;
@@ -21,28 +27,46 @@ export declare class RouteResource<ActionNames extends ResourceActionNames = Res
     });
     /**
      * Register only given routes and remove others
+     * @param names - Array of action names to keep
+     * @returns Current RouteResource instance with filtered actions
      */
     only<Name extends ActionNames>(names: Name[]): RouteResource<Name>;
     /**
      * Register all routes, except the one's defined
+     * @param names - Array of action names to exclude
+     * @returns Current RouteResource instance with filtered actions
      */
     except<Name extends ActionNames>(names: Name[]): RouteResource<Exclude<ActionNames, Name>>;
     /**
      * Register api only routes. The `create` and `edit` routes, which
      * are meant to show forms will not be registered
+     * @returns Current RouteResource instance without create and edit actions
      */
     apiOnly(): RouteResource<Exclude<ActionNames, 'create' | 'edit'>>;
     /**
      * Define matcher for params inside the resource
+     * @param key - The parameter name to match
+     * @param matcher - The matcher pattern (RegExp, string, or RouteMatcher)
+     * @returns Current RouteResource instance for method chaining
      */
     where(key: string, matcher: RouteMatcher | string | RegExp): this;
     /**
      * Tap into multiple routes to configure them by their name
+     * @param callback - Function to configure routes
+     * @returns Current RouteResource instance for method chaining
      */
     tap(callback: (route: Route) => void): this;
+    /**
+     * Tap into multiple routes to configure them by their name
+     * @param actions - Action name(s) to configure
+     * @param callback - Function to configure matching routes
+     * @returns Current RouteResource instance for method chaining
+     */
     tap(actions: ActionNames | ActionNames[], callback: (route: Route) => void): this;
     /**
      * Set the param name for a given resource
+     * @param resources - Object mapping resource names to parameter names
+     * @returns Current RouteResource instance for method chaining
      */
     params(resources: {
         [resource: string]: string;
@@ -53,14 +77,23 @@ export declare class RouteResource<ActionNames extends ResourceActionNames = Res
      *
      * Calling this method multiple times will append middleware
      * to existing list.
+     * @param actions - Action name(s) or '*' for all actions
+     * @param middleware - Middleware function(s) to apply
+     * @returns Current RouteResource instance for method chaining
      */
     use(actions: ActionNames | ActionNames[] | '*', middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
      * @alias use
+     * @param actions - Action name(s) or '*' for all actions
+     * @param middleware - Middleware function(s) to apply
+     * @returns Current RouteResource instance for method chaining
      */
     middleware(actions: ActionNames | ActionNames[] | '*', middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
      * Prepend name to all the routes
+     * @param name - The name to prepend to all route names
+     * @param normalizeName - Whether to normalize the name to snake_case
+     * @returns Current RouteResource instance for method chaining
      */
     as(name: string, normalizeName?: boolean): this;
 }

package/build/src/router/route.d.ts

@@ -9,6 +9,12 @@ import type { RouteFn, RouteJSON, RouteMatcher, RouteMatchers, StoreRouteMiddlew
  */
 export declare class Route<Controller extends Constructor<any> = any> extends Macroable {
     #private;
+    /**
+     * Creates a new Route instance
+     * @param app - The AdonisJS application instance
+     * @param routerMiddleware - Array of global middleware registered on the router
+     * @param options - Configuration options for the route
+     */
     constructor(app: Application<any>, routerMiddleware: ParsedGlobalMiddleware[], options: {
         pattern: string;
         methods: string[];
@@ -33,6 +39,8 @@ export declare class Route<Controller extends Constructor<any> = any> extends Ma
     /**
      * Define prefix for the route. Calling this method multiple times
      * applies multiple prefixes in the reverse order.
+     * @param prefix - The prefix to add to the route
+     * @returns Current Route instance for method chaining
      */
     prefix(prefix: string): this;
     /**

package/build/src/router/signed_url_builder.d.ts

@@ -1,15 +1,11 @@
 import type { Encryption } from '@adonisjs/encryption';
 import { type Router } from './main.ts';
-import { type MatchItRouteToken } from '../types/route.ts';
 import { type UrlFor, type LookupList, type SignedURLOptions } from '../types/url_builder.ts';
-/**
- * Makes signed URL for a given route pattern. The route pattern could be an
- * identifier or an array of tokens.
- */
-export declare function createSignedURL(identifier: string, tokens: MatchItRouteToken[], searchParamsStringifier: (qs: Record<string, any>) => string, encryption: Encryption, params?: any[] | {
-    [param: string]: any;
-}, options?: SignedURLOptions): string;
 /**
  * Creates the URLBuilder helper for making signed URLs
+ * @param router - The router instance
+ * @param encryption - Encryption service for signing URLs
+ * @param searchParamsStringifier - Function to stringify query string parameters
+ * @returns URL builder function for creating signed URLs
  */
 export declare function createSignedUrlBuilder<Routes extends LookupList>(router: Router, encryption: Encryption, searchParamsStringifier: (qs: Record<string, any>) => string): UrlFor<Routes, SignedURLOptions>;

package/build/src/router/store.d.ts

@@ -44,6 +44,8 @@ export declare class RoutesStore {
      *   }
      * })
      * ```
+     * @param route - The route to add to the store
+     * @returns Current RoutesStore instance for method chaining
      */
     add(route: RouteJSON): this;
     /**
@@ -54,6 +56,11 @@ export declare class RoutesStore {
      * The domain parameter has to be a registered pattern and not the fully
      * qualified runtime domain. You must call `matchDomain` first to fetch
      * the pattern for qualified domain
+     * @param url - The URL to match
+     * @param method - HTTP method
+     * @param shouldDecodeParam - Whether to decode parameters
+     * @param domain - Optional domain tokens and hostname
+     * @returns Matched route or null if no match found
      */
     match(url: string, method: string, shouldDecodeParam: boolean, domain?: {
         tokens: MatchItRouteToken[];
@@ -61,6 +68,8 @@ export declare class RoutesStore {
     }): null | MatchedRoute;
     /**
      * Match hostname against registered domains.
+     * @param hostname - The hostname to match
+     * @returns Array of matched domain tokens
      */
     matchDomain(hostname?: string | null): MatchItRouteToken[];
 }

package/build/src/router/url_builder.d.ts

@@ -1,14 +1,9 @@
 import { type Router } from './main.ts';
-import { type MatchItRouteToken } from '../types/route.ts';
-import { type UrlFor, type LookupList, type URLOptions } from '../types/url_builder.ts';
-/**
- * Makes URL for a given route pattern. The route pattern could be an
- * identifier or an array of tokens.
- */
-export declare function createURL(identifier: string, tokens: Pick<MatchItRouteToken, 'val' | 'type' | 'end'>[], searchParamsStringifier: (qs: Record<string, any>) => string, params?: any[] | {
-    [param: string]: any;
-}, options?: URLOptions): string;
+import { type UrlFor, type LookupList } from '../types/url_builder.ts';
 /**
  * Creates the URLBuilder helper
+ * @param router - The router instance
+ * @param searchParamsStringifier - Function to stringify query string parameters
+ * @returns URL builder function for creating URLs
  */
 export declare function createUrlBuilder<Routes extends LookupList>(router: Router, searchParamsStringifier: (qs: Record<string, any>) => string): UrlFor<Routes>;

package/build/src/server/factories/middleware_handler.d.ts

@@ -3,6 +3,15 @@ import type { NextFn } from '@poppinss/middleware/types';
 import type { HttpContext } from '../../http_context/main.ts';
 import { type ParsedGlobalMiddleware } from '../../types/middleware.ts';
 /**
- * The middleware handler invokes the middleware functions.
+ * Creates a middleware execution handler that invokes middleware functions with tracing support
+ *
+ * This factory function returns a middleware execution handler that:
+ * - Executes middleware with debug logging
+ * - Provides distributed tracing through tracing channels
+ * - Passes the container resolver, HTTP context, and next function to middleware
+ *
+ * @param resolver - Container resolver for dependency injection
+ * @param ctx - HTTP context containing request/response data
+ * @returns Middleware execution function
  */
 export declare function middlewareHandler(resolver: ContainerResolver<any>, ctx: HttpContext): (fn: ParsedGlobalMiddleware, next: NextFn) => Promise<any>;

package/build/src/server/factories/route_finder.d.ts

@@ -3,8 +3,18 @@ import type { Router } from '../../router/main.ts';
 import type { HttpContext } from '../../http_context/main.ts';
 import type { ServerErrorHandler } from '../../types/server.ts';
 /**
- * The route finder is executed after the server middleware stack.
- * It looks for a matching route and executes the route middleware
- * stack.
+ * Creates a route finder function that matches HTTP requests to registered routes
+ *
+ * This factory function returns a route handler that:
+ * - Matches incoming requests against registered routes
+ * - Extracts route parameters and subdomains
+ * - Executes the matched route's handler and middleware
+ * - Throws E_ROUTE_NOT_FOUND error for unmatched requests
+ *
+ * @param router - Router instance containing registered routes
+ * @param resolver - Container resolver for dependency injection
+ * @param ctx - HTTP context containing request/response data
+ * @param errorResponder - Error handler for route execution errors
+ * @returns Route execution function
  */
 export declare function routeFinder(router: Router, resolver: ContainerResolver<any>, ctx: HttpContext, errorResponder: ServerErrorHandler['handle']): () => any;

package/build/src/server/factories/write_response.d.ts

@@ -1,6 +1,13 @@
 import type { HttpContext } from '../../http_context/main.ts';
 /**
- * Writes the response to the socket. The "finish" method can
- * raise error when unable to serialize the response.
+ * Creates a response writer function that finalizes HTTP responses with error handling
+ *
+ * This factory function returns a response finalizer that:
+ * - Calls the response.finish() method to send the response
+ * - Catches serialization errors and sends a 500 error response
+ * - Logs fatal errors for debugging and monitoring
+ *
+ * @param ctx - HTTP context containing the response to finalize
+ * @returns Response finalization function
  */
 export declare function writeResponse(ctx: HttpContext): () => void;