Add docs from gofiber/fiber@d8da941

Author: github-actions[bot]

docs/core/addon/retry.md

@@ -107,6 +107,11 @@ type Config struct {
     //
     // Optional. Default: 10
     MaxRetryCount int
+
+    // currentInterval tracks the current waiting time.
+    //
+    // Optional. Default: 1 * time.Second
+    currentInterval time.Duration
 }
 ```
 

docs/core/api/constants.md

@@ -1568,7 +1568,11 @@ app.Get("/", func(c fiber.Ctx) error {
 
 ### Protocol
 
-Contains the request protocol string: `http` or `https` for **TLS** requests.
+Returns the HTTP protocol version of the request: `HTTP/1.1` or `HTTP/2`.
+
+:::info
+To get the request scheme (`http` or `https`), use [`Scheme`](#scheme) instead.
+:::
 
 ```go title="Signature"
 func (c fiber.Ctx) Protocol() string
@@ -1578,7 +1582,7 @@ func (c fiber.Ctx) Protocol() string
 // GET http://example.com
 
 app.Get("/", func(c fiber.Ctx) error {
-  c.Protocol() // "http"
+  c.Protocol() // "HTTP/1.1"
 
   // ...
 })
@@ -1832,7 +1836,7 @@ app.Post("/", func(c fiber.Ctx) error {
 })
 ```
 
-### Schema
+### Scheme
 
 Contains the request protocol string: `http` or `https` for TLS requests.
 
@@ -1841,14 +1845,14 @@ Please use [`Config.TrustProxy`](fiber.md#trustproxy) to prevent header spoofing
 :::
 
 ```go title="Signature"
-func (c fiber.Ctx) Schema() string
+func (c fiber.Ctx) Scheme() string
 ```
 
 ```go title="Example"
 // GET http://example.com
 
 app.Get("/", func(c fiber.Ctx) error {
-  c.Schema() // "http"
+  c.Scheme() // "http"
 
   // ...
 })
@@ -1864,7 +1868,7 @@ func (c fiber.Ctx) Secure() bool
 
 ```go title="Example"
 // Secure() method is equivalent to:
-c.Protocol() == "https"
+c.Scheme() == "https"
 ```
 
 ### Stale

docs/core/api/ctx.md

@@ -164,7 +164,7 @@ Similar to [Laravel](https://laravel.com/docs/11.x/redirects#redirecting-with-fl
 Retrieve all flash messages. See [With](#with) for details.
 
 ```go title="Signature"
-func (r *Redirect) Messages() map[string]string
+func (r *Redirect) Messages() []FlashMessage
 ```
 
 ```go title="Example"
@@ -179,13 +179,13 @@ app.Get("/", func(c fiber.Ctx) error {
 Get a flash message by key; see [With](#with).
 
 ```go title="Signature"
-func (r *Redirect) Message(key string) *Redirect
+func (r *Redirect) Message(key string) FlashMessage
 ```
 
 ```go title="Example"
 app.Get("/", func(c fiber.Ctx) error {
   message := c.Redirect().Message("status")
-  return c.SendString(message)
+  return c.SendString(message.Value)
 })
 ```
 
@@ -194,7 +194,7 @@ app.Get("/", func(c fiber.Ctx) error {
 Retrieve stored input data. See [WithInput](#withinput).
 
 ```go title="Signature"
-func (r *Redirect) OldInputs() map[string]string
+func (r *Redirect) OldInputs() []OldInputData
 ```
 
 ```go title="Example"
@@ -209,13 +209,13 @@ app.Get("/", func(c fiber.Ctx) error {
 Get stored input data by key; see [WithInput](#withinput).
 
 ```go title="Signature"
-func (r *Redirect) OldInput(key string) string
+func (r *Redirect) OldInput(key string) OldInputData
 ```
 
 ```go title="Example"
 app.Get("/name", func(c fiber.Ctx) error {
   oldInput := c.Redirect().OldInput("name")
-  return c.SendString(oldInput)
+  return c.SendString(oldInput.Value)
 })
 ```
 

docs/core/api/redirect.md

@@ -18,28 +18,32 @@ This structure is designed to be both flexible and efficient, allowing you to ea
 
 ```go
 type Request struct {
-    url       string
-    method    string
-    userAgent string
-    boundary  string
-    referer   string
-    ctx       context.Context
-    header    *Header
-    params    *QueryParam
-    cookies   *Cookie
-    path      *PathParam
+    ctx context.Context
 
-    timeout      time.Duration
-    maxRedirects int
+    body    any
+    header  Header
+    params  QueryParam
+    cookies Cookie
+    path    PathParam
 
     client *Client
 
-    body     any
-    formData *FormData
-    files    []*File
-    bodyType bodyType
+    formData FormData
 
     RawRequest *fasthttp.Request
+    url        string
+    method     string
+    userAgent  string
+    boundary   string
+    referer    string
+    files      []*File
+
+    timeout      time.Duration
+    maxRedirects int
+
+    bodyType bodyType
+
+    isPathNormalizingDisabled bool
 }
 ```
 

docs/core/client/request.md

@@ -49,33 +49,13 @@ See [examples](examples.md) for more detailed usage.
 
 ```go
 type Client struct {
-    mu sync.RWMutex
+    logger    log.CommonLogger
+    transport httpClientTransport
 
-    fasthttp *fasthttp.Client
-
-    baseURL   string
-    userAgent string
-    referer   string
-    header    *Header
-    params    *QueryParam
-    cookies   *Cookie
-    path      *PathParam
-
-    debug bool
-
-    timeout time.Duration
-
-    // user-defined request hooks
-    userRequestHooks []RequestHook
-
-    // client package-defined request hooks
-    builtinRequestHooks []RequestHook
-
-    // user-defined response hooks
-    userResponseHooks []ResponseHook
-
-    // client package-defined response hooks
-    builtinResponseHooks []ResponseHook
+    header  *Header
+    params  *QueryParam
+    cookies *Cookie
+    path    *PathParam
 
     jsonMarshal   utils.JSONMarshal
     jsonUnmarshal utils.JSONUnmarshal
@@ -84,16 +64,20 @@ type Client struct {
     cborMarshal   utils.CBORMarshal
     cborUnmarshal utils.CBORUnmarshal
 
-    cookieJar *CookieJar
-
-    // proxy
-    proxyURL string
-
-    // retry
-    retryConfig *RetryConfig
+    cookieJar            *CookieJar
+    retryConfig          *RetryConfig
+    baseURL              string
+    userAgent            string
+    referer              string
+    userRequestHooks     []RequestHook
+    builtinRequestHooks  []RequestHook
+    userResponseHooks    []ResponseHook
+    builtinResponseHooks []ResponseHook
 
-    // logger
-    logger log.CommonLogger
+    timeout                   time.Duration
+    mu                        sync.RWMutex
+    isDebug                   bool
+    isPathNormalizingDisabled bool
 }
 ```
 

docs/core/client/rest.md

@@ -401,7 +401,8 @@ Fiber provides a comprehensive hook system that allows you to run custom functio
 - OnName: Invoked when a route is assigned a name.
 - OnGroup: Triggered when a group is created.
 - OnListen: Runs when the server starts listening.
-- OnShutdown: Called during graceful shutdown.
+- OnPreShutdown: Runs before the application shuts down.
+- OnPostShutdown: Runs after shutdown and receives the shutdown result.
 - OnFork: Invoked when a child process is forked.
 - OnMount: Used when a sub‑application is mounted.
 
@@ -412,15 +413,17 @@ flowchart TD
     ON[OnName]
     OG[OnGroup]
     OL[OnListen]
-    OS[OnShutdown]
+    OPRS[OnPreShutdown]
+    OPOS[OnPostShutdown]
     OF[OnFork]
     OM[OnMount]
 
     H --> OR
     H --> ON
     H --> OG
     H --> OL
-    H --> OS
+    H --> OPRS
+    H --> OPOS
     H --> OF
     H --> OM
 ```

docs/core/extra/internal.md

@@ -257,6 +257,8 @@ Writing to `os.File` is goroutine-safe, but custom streams may require locking t
 | TimeZone      | `string`                                          | TimeZone can be specified, such as "UTC" and "America/New_York" and "Asia/Chongqing", etc                                                     | `"Local"`                                                             |
 | TimeInterval  | `time.Duration`                                   | TimeInterval is the delay before the timestamp is updated.                                                                                    | `500 * time.Millisecond`                                              |
 | Stream        | `io.Writer`                                       | Stream is a writer where logs are written.                                                                                                    | `os.Stdout`                                                           |
+| TimeDone      | `<-chan struct{}`                                 | TimeDone stops the background timestamp updater when it is closed.                                                                            | `nil`                                                                 |
+| BeforeHandlerFunc | `func(*Config)`                               | BeforeHandlerFunc runs once before the handler is built, letting you customize colors, template, etc.                                         | `beforeHandlerFunc`                                                   |
 | LoggerFunc    | `func(c fiber.Ctx, data *Data, cfg *Config) error` | Custom logger function for integration with logging libraries (Zerolog, Zap, Logrus, etc). Defaults to Fiber's default logger if not defined. | `see default_logger.go defaultLoggerInstance`                         |
 | DisableColors | `bool`                                            | DisableColors defines if the logs output should be colorized.                                                                                 | `false`                                                               |
 | ForceColors   | `bool`                                            | ForceColors defines if the logs output should be colorized even when the output is not a terminal.                                             | `false`                                                               |