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

package/build/{chunk-7ROFCP6L.js → chunk-3XEJZ4S4.js}

@@ -739,7 +739,7 @@ var RouteResource = class extends Macroable2 {
     return this;
   }
   /**
-   * @alias use
+   * Alias for {@link RouteResource.use}
    * @param actions - Action name(s) or '*' for all actions
    * @param middleware - Middleware function(s) to apply
    * @returns Current RouteResource instance for method chaining
@@ -958,7 +958,7 @@ var RouteGroup = class _RouteGroup extends Macroable3 {
     return this;
   }
   /**
-   * @alias use
+   * Alias for {@link RouteGroup.use}
    * @param middleware - Middleware function(s) to apply to all routes in the group
    * @returns Current RouteGroup instance for method chaining
    */
@@ -1290,7 +1290,7 @@ var Route = class extends Macroable4 {
     return this;
   }
   /**
-   * @alias use
+   * Alias for {@link Route.use}
    */
   middleware(middleware) {
     return this.use(middleware);
@@ -4097,8 +4097,7 @@ var UrlBuilder = class {
   }
   /**
    * Prefix a custom base URL to the final URI
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    */
   prefixUrl(url) {
     this.#baseUrl = url;
@@ -4107,8 +4106,7 @@ var UrlBuilder = class {
   /**
    * Disable route lookup. Calling this method considers
    * the "identifier" as the route pattern
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    */
   disableRouteLookup() {
     this.#shouldPerformLookup = false;
@@ -4116,8 +4114,7 @@ var UrlBuilder = class {
   }
   /**
    * Append query string to the final URI
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    */
   qs(queryString) {
     if (!queryString) {
@@ -4128,8 +4125,7 @@ var UrlBuilder = class {
   }
   /**
    * Specify params to apply to the route pattern
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    */
   params(params) {
     if (!params) {
@@ -4143,8 +4139,7 @@ var UrlBuilder = class {
    * route name, controller.method name or the route pattern
    * itself.
    *
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    * @param identifier - Route identifier to generate URL for
    * @returns Generated URL string
    */
@@ -4161,8 +4156,7 @@ var UrlBuilder = class {
    * route name, controller.method name or the route pattern
    * itself.
    *
-   * @deprecated
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    *
    */
   makeSigned(identifier, options) {
@@ -4810,9 +4804,7 @@ var Router = class {
   }
   /**
    * Create URL builder instance.
-   * @deprecated
-   *
-   * Instead use "@adonisjs/core/services/url_builder" instead
+   * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
    */
   builder() {
     return new UrlBuilder(this);

package/build/factories/main.js

@@ -6,7 +6,7 @@ import {
   Router,
   Server,
   defineConfig
-} from "../chunk-7ROFCP6L.js";
+} from "../chunk-3XEJZ4S4.js";
 import "../chunk-NQNHMINZ.js";
 
 // factories/router.ts

package/build/index.js

@@ -22,7 +22,7 @@ import {
   errors_exports,
   parseRange,
   tracing_channels_exports
-} from "./chunk-7ROFCP6L.js";
+} from "./chunk-3XEJZ4S4.js";
 import "./chunk-NQNHMINZ.js";
 
 // src/exception_handler.ts

package/build/src/cookies/serializer.d.ts

@@ -31,8 +31,7 @@ export declare class CookieSerializer {
      */
     encode(key: string, value: any, options?: Partial<CookieOptions & {
         /**
-         * @depreacted
-         * Instead use stringify option
+         * @depreacted Instead use stringify option
          */
         encode: boolean;
         stringify: boolean;

package/build/src/redirect.d.ts

@@ -28,16 +28,53 @@ export declare class Redirect {
      */
     clearQs(): this;
     /**
-     * Defines query string parameters for the redirect URL
-     * - No arguments: forwards current request query string
-     * - Object argument: adds multiple key-value pairs
-     * - String arguments: adds single key-value pair
-     * @param name - Query parameter name or object of parameters
-     * @param value - Value for the query parameter (when name is string)
-     * @returns {this} The Redirect instance for method chaining
+     * Forwards the current request's query string to the redirect URL
+     *
+     * Use this overload when you want to preserve all existing query parameters
+     * from the current request in the redirect URL.
+     *
+     * @returns The Redirect instance for method chaining
+     *
+     * @example
+     * ```ts
+     * // If current URL is '/search?q=hello&page=2'
+     * response.redirect().withQs().toPath('/results')
+     * // Redirects to: '/results?q=hello&page=2'
+     * ```
      */
     withQs(): this;
+    /**
+     * Adds multiple query string parameters to the redirect URL
+     *
+     * Use this overload when you want to add several query parameters at once
+     * using an object with key-value pairs.
+     *
+     * @param values - Object containing query parameter names and values
+     * @returns The Redirect instance for method chaining
+     *
+     * @example
+     * ```ts
+     * response.redirect().withQs({ page: 1, sort: 'name' }).toPath('/users')
+     * // Redirects to: '/users?page=1&sort=name'
+     * ```
+     */
     withQs(values: Record<string, any>): this;
+    /**
+     * Adds a single query string parameter to the redirect URL
+     *
+     * Use this overload when you want to add just one query parameter
+     * with a specific name and value.
+     *
+     * @param name - The query parameter name
+     * @param value - The query parameter value
+     * @returns The Redirect instance for method chaining
+     *
+     * @example
+     * ```ts
+     * response.redirect().withQs('success', 'true').toPath('/dashboard')
+     * // Redirects to: '/dashboard?success=true'
+     * ```
+     */
     withQs(name: string, value: any): this;
     /**
      * Redirects to the previous path using the Referer header

package/build/src/response.d.ts

@@ -458,21 +458,38 @@ export declare class Response extends Macroable {
      */
     location(url: string): this;
     /**
-     * Redirects the request to a different URL
+     * Returns a Redirect instance for fluent API usage
      *
-     * @param path - Optional path to redirect to
-     * @param forwardQueryString - Whether to forward current query string
-     * @param statusCode - HTTP status code for redirect (default: 302)
-     * @returns Redirect instance when called without path, void when redirecting
+     * Use this overload when you want to use methods like `.toRoute()`, `.back()`,
+     * `.withQs()`, or other redirect builder methods.
+     *
+     * @returns Redirect instance for chaining redirect methods
      *
      * @example
      * ```ts
-     * response.redirect('/dashboard')
      * response.redirect().toRoute('users.show', { id: 1 })
      * response.redirect().back()
+     * response.redirect().withQs().toPath('/dashboard')
      * ```
      */
     redirect(): Redirect;
+    /**
+     * Performs an immediate redirect to the specified path
+     *
+     * This overload directly redirects the request with the provided parameters.
+     * Use this when you have a simple redirect without needing the fluent API.
+     *
+     * @param path - The path or URL to redirect to (use 'back' for referrer redirect)
+     * @param forwardQueryString - Whether to forward current query string parameters
+     * @param statusCode - HTTP status code for redirect (defaults to 302 Found)
+     *
+     * @example
+     * ```ts
+     * response.redirect('/dashboard')
+     * response.redirect('/users', true, 301) // with query forwarding and 301 status
+     * response.redirect('back') // redirect to referrer
+     * ```
+     */
     redirect(path: string, forwardQueryString?: boolean, statusCode?: number): void;
     /**
      * Aborts the request with a custom response body and status code

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

@@ -74,7 +74,7 @@ export declare class RouteGroup extends Macroable {
      */
     use(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
-     * @alias use
+     * Alias for {@link RouteGroup.use}
      * @param middleware - Middleware function(s) to apply to all routes in the group
      * @returns Current RouteGroup instance for method chaining
      */

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

@@ -12,8 +12,7 @@ import { type Router } from '../main.ts';
  *  .make('categories.posts.index')
  * ```
  *
- * @deprecated
- * Instead use "@adonisjs/core/services/url_builder" instead
+ * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
  */
 export declare class UrlBuilder {
     #private;
@@ -25,27 +24,23 @@ export declare class UrlBuilder {
     constructor(router: Router, domain?: string);
     /**
      * Prefix a custom base URL to the final URI
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
     prefixUrl(url: string): this;
     /**
      * Disable route lookup. Calling this method considers
      * the "identifier" as the route pattern
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
     disableRouteLookup(): this;
     /**
      * Append query string to the final URI
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
     qs(queryString?: Record<string, any>): this;
     /**
      * Specify params to apply to the route pattern
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
     params(params?: any[] | Record<string, any>): this;
     /**
@@ -53,8 +48,7 @@ export declare class UrlBuilder {
      * route name, controller.method name or the route pattern
      * itself.
      *
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      * @param identifier - Route identifier to generate URL for
      * @returns Generated URL string
      */
@@ -64,8 +58,7 @@ export declare class UrlBuilder {
      * route name, controller.method name or the route pattern
      * itself.
      *
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      *
      */
     makeSigned(identifier: string, options?: {

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

@@ -261,9 +261,7 @@ export declare class Router {
     match(uri: string, method: string, shouldDecodeParam: boolean, hostname?: string | null): null | MatchedRoute;
     /**
      * Create URL builder instance.
-     * @deprecated
-     *
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
     builder(): UrlBuilder;
     /**

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

@@ -83,7 +83,7 @@ export declare class RouteResource<ActionNames extends ResourceActionNames = Res
      */
     use(actions: ActionNames | ActionNames[] | '*', middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
-     * @alias use
+     * Alias for {@link RouteResource.use}
      * @param actions - Action name(s) or '*' for all actions
      * @param middleware - Middleware function(s) to apply
      * @returns Current RouteResource instance for method chaining

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

@@ -57,7 +57,7 @@ export declare class Route<Controller extends Constructor<any> = any> extends Ma
      */
     use(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**
-     * @alias use
+     * Alias for {@link Route.use}
      */
     middleware(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;
     /**

package/build/src/types/middleware.d.ts

@@ -2,6 +2,7 @@ import type { ContainerResolver } from '@adonisjs/fold';
 import type { NextFn } from '@poppinss/middleware/types';
 import type { Constructor, LazyImport } from '@poppinss/utils/types';
 import type { HttpContext } from '../http_context/main.ts';
+export { NextFn };
 /**
  * Middleware represented as a class constructor that implements a handle method
  */
@@ -92,4 +93,3 @@ export type RouteHandlerInfo = {
     /** Module name or file path for the controller */
     moduleNameOrPath: string;
 };
-export {};

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

@@ -168,8 +168,7 @@ export type RouteJSON = {
  */
 export type ResourceActionNames = 'create' | 'index' | 'store' | 'show' | 'edit' | 'update' | 'destroy';
 /**
- * Options for URL generation (deprecated - use URLBuilder instead)
- * @deprecated
+ * @deprecated Options for URL generation (use URLBuilder instead)
  */
 export type MakeUrlOptions = {
     /** Query string parameters to append */
@@ -182,8 +181,7 @@ export type MakeUrlOptions = {
     disableRouteLookup?: boolean;
 };
 /**
- * Options for signed URL generation (deprecated - use URLBuilder instead)
- * @deprecated
+ * @deprecated Options for signed URL generation (use URLBuilder instead)
  */
 export type MakeSignedUrlOptions = MakeUrlOptions & {
     /** Expiration time for the signed URL */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonisjs/http-server",
-  "version": "8.0.0-next.6",
+  "version": "8.0.0-next.7",
   "description": "AdonisJS HTTP server with support packed with Routing and Cookies",
   "main": "build/index.js",
   "type": "module",
@@ -66,7 +66,7 @@
     "@types/fresh": "^0.5.3",
     "@types/fs-extra": "^11.0.4",
     "@types/mime-types": "^3.0.1",
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.3.1",
     "@types/on-finished": "^2.3.5",
     "@types/pem": "^1.14.4",
     "@types/proxy-addr": "^2.0.3",
@@ -79,7 +79,7 @@
     "c8": "^10.1.3",
     "cross-env": "^10.0.0",
     "eslint": "^9.34.0",
-    "fastify": "^5.5.0",
+    "fastify": "^5.6.0",
     "fs-extra": "^11.3.1",
     "get-port": "^7.1.0",
     "http-status-codes": "^2.3.0",
@@ -89,7 +89,7 @@
     "release-it": "^19.0.4",
     "supertest": "^7.1.4",
     "tsup": "^8.5.0",
-    "typedoc": "^0.28.11",
+    "typedoc": "^0.28.12",
     "typescript": "^5.9.2",
     "youch": "^4.1.0-beta.11"
   },