@adonisjs/http-server - npm Package Compare versions

Comparing version 8.0.0-next.6 to 8.0.0-next.7

build/factories/main.js

@@ -9,3 +9,3 @@ import {
   defineConfig
-} from "../chunk-7ROFCP6L.js";
+} from "../chunk-3XEJZ4S4.js";
 import "../chunk-NQNHMINZ.js";
@@ -12,0 +12,0 @@

build/index.js

@@ -25,3 +25,3 @@ import {
   tracing_channels_exports
-} from "./chunk-7ROFCP6L.js";
+} from "./chunk-3XEJZ4S4.js";
 import "./chunk-NQNHMINZ.js";
@@ -28,0 +28,0 @@

build/src/cookies/serializer.d.ts

@@ -34,4 +34,3 @@ import type { Encryption } from '@adonisjs/encryption';
         /**
-         * @depreacted
-         * Instead use stringify option
+         * @depreacted Instead use stringify option
          */
@@ -38,0 +37,0 @@ encode: boolean;

build/src/redirect.d.ts

@@ -31,12 +31,49 @@ import type { IncomingMessage } from 'node:http';
     /**
-     * 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;
@@ -43,0 +80,0 @@ /**

build/src/response.d.ts

@@ -461,17 +461,34 @@ import Macroable from '@poppinss/macroable';
     /**
-     * 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;
@@ -478,0 +495,0 @@ /**

build/src/router/group.d.ts

@@ -77,3 +77,3 @@ import Macroable from '@poppinss/macroable';
     /**
-     * @alias use
+     * Alias for {@link RouteGroup.use}
      * @param middleware - Middleware function(s) to apply to all routes in the group
@@ -80,0 +80,0 @@ * @returns Current RouteGroup instance for method chaining

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

@@ -15,4 +15,3 @@ import { type Router } from '../main.ts';
  *
- * @deprecated
- * Instead use "@adonisjs/core/services/url_builder" instead
+ * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
  */
@@ -29,4 +28,3 @@ export declare class UrlBuilder {
      * 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
      */
@@ -37,4 +35,3 @@ prefixUrl(url: string): this;
      * the "identifier" as the route pattern
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
@@ -44,4 +41,3 @@ 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
      */
@@ -51,4 +47,3 @@ 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
      */
@@ -61,4 +56,3 @@ params(params?: any[] | Record<string, any>): this;
      *
-     * @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
@@ -73,4 +67,3 @@ * @returns Generated URL string
      *
-     * @deprecated
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      *
@@ -77,0 +70,0 @@ */

build/src/router/main.d.ts

@@ -264,5 +264,3 @@ import type { Encryption } from '@adonisjs/encryption';
      * Create URL builder instance.
-     * @deprecated
-     *
-     * Instead use "@adonisjs/core/services/url_builder" instead
+     * @deprecated Instead use "@adonisjs/core/services/url_builder" instead
      */
@@ -269,0 +267,0 @@ builder(): UrlBuilder;

build/src/router/resource.d.ts

@@ -86,3 +86,3 @@ import Macroable from '@poppinss/macroable';
     /**
-     * @alias use
+     * Alias for {@link RouteResource.use}
      * @param actions - Action name(s) or '*' for all actions
@@ -89,0 +89,0 @@ * @param middleware - Middleware function(s) to apply

build/src/router/route.d.ts

@@ -60,3 +60,3 @@ import Macroable from '@poppinss/macroable';
     /**
-     * @alias use
+     * Alias for {@link Route.use}
      */
@@ -63,0 +63,0 @@ middleware(middleware: OneOrMore<MiddlewareFn | ParsedNamedMiddleware>): this;

build/src/types/middleware.d.ts

@@ -5,2 +5,3 @@ import type { ContainerResolver } from '@adonisjs/fold';
 import type { HttpContext } from '../http_context/main.ts';
+export { NextFn };
 /**
@@ -96,2 +97,1 @@ * Middleware represented as a class constructor that implements a handle method
 };
-export {};

build/src/types/route.d.ts

@@ -171,4 +171,3 @@ import type Middleware from '@poppinss/middleware';
 /**
- * Options for URL generation (deprecated - use URLBuilder instead)
- * @deprecated
+ * @deprecated Options for URL generation (use URLBuilder instead)
  */
@@ -186,4 +185,3 @@ export type MakeUrlOptions = {
 /**
- * Options for signed URL generation (deprecated - use URLBuilder instead)
- * @deprecated
+ * @deprecated Options for signed URL generation (use URLBuilder instead)
  */
@@ -190,0 +188,0 @@ export type MakeSignedUrlOptions = MakeUrlOptions & {

package.json

 {
   "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",
@@ -69,3 +69,3 @@ "main": "build/index.js",
     "@types/mime-types": "^3.0.1",
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.3.1",
     "@types/on-finished": "^2.3.5",
@@ -83,3 +83,3 @@ "@types/pem": "^1.14.4",
     "eslint": "^9.34.0",
-    "fastify": "^5.5.0",
+    "fastify": "^5.6.0",
     "fs-extra": "^11.3.1",
@@ -94,3 +94,3 @@ "get-port": "^7.1.0",
     "tsup": "^8.5.0",
-    "typedoc": "^0.28.11",
+    "typedoc": "^0.28.12",
     "typescript": "^5.9.2",
@@ -97,0 +97,0 @@ "youch": "^4.1.0-beta.11"

New alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Network access

Supply chain risk

This module accesses the network.

Found 3 instances in 1 package

Debug access

Supply chain risk

Uses debug, reflection and dynamic code execution features.

Found 2 instances in 1 package

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 2 instances in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Fixed alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Network access

Supply chain risk

This module accesses the network.

Found 3 instances in 1 package

Debug access

Supply chain risk

Uses debug, reflection and dynamic code execution features.

Found 2 instances in 1 package

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 2 instances in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

362203

0.5%

Lines of code

10832

0.31%

No dependency changes