enhancement: add context management support to storages

.github/workflows/benchmark.yml

@@ -64,7 +64,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
 
       - name: Install Cloudflare Worker
         if: ${{ matrix.package == 'cloudflarekv' }}
@@ -83,6 +83,23 @@ jobs:
             --env ETCD_ADVERTISE_CLIENT_URLS=http://etcd-server:2379 \
             bitnami/etcd:latest
 
+      - name: Install MSSQL
+        if: ${{ matrix.package == 'mssql' }}
+        run: |
+          docker run -d --name mssql-server \
+            --publish 1433:1433 \
+            --env ACCEPT_EULA=Y \
+            --env SA_PASSWORD=MsSql!1234 \
+            --env MSSQL_DB=master \
+            --env MSSQL_USER=sa \
+            --env MSSQL_PASSWORD=MsSql!1234 \
+            --health-cmd "/opt/mssql-tools/bin/sqlcmd -U sa -P MsSql!1234 -Q 'select 1' -b -o /dev/null" \
+            --health-interval 1s \
+            --health-timeout 30s \
+            --health-start-period 10s \
+            --health-retries 20 \
+            mcmoe/mssqldocker:latest
+
       - name: Run Benchmarks
         working-directory: ${{ matrix.package }}
         run: |
@@ -134,4 +151,4 @@ jobs:
           auto-push: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
           save-data-file: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
 
-      
+

.github/workflows/sync-docs.yml

@@ -25,7 +25,7 @@ jobs:
             - name: Setup Node.js environment
               uses: actions/setup-node@v4
               with:
-                  node-version: '18'
+                  node-version: '20'
 
             - name: Install JQ
               run: sudo apt-get install jq

.github/workflows/test-badger.yml

@@ -14,9 +14,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         runs-on: ubuntu-latest
         steps:
             -   name: Fetch Repository

.github/workflows/test-bbolt.yml

@@ -15,9 +15,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         steps:
             -   name: Fetch Repository
                 uses: actions/checkout@v4

.github/workflows/test-cloudflarekv.yml

@@ -17,8 +17,8 @@ jobs:
     strategy:
       matrix:
           go-version:
-              - 1.21.x
-              - 1.22.x
+              - 1.23.x
+              - 1.24.x
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
@@ -31,7 +31,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
 
       - name: Start Wrangler Dev
         run: |

.github/workflows/test-etcd.yml

@@ -15,9 +15,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         steps:
             -   name: Fetch Repository
                 uses: actions/checkout@v4

.github/workflows/test-memory.yml

@@ -14,9 +14,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         runs-on: ubuntu-latest
         steps:
             -   name: Fetch Repository

.github/workflows/test-mockstorage.yml

@@ -14,8 +14,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.21.x
-                    - 1.22.x
+                    - 1.23.x
+                    - 1.24.x
         runs-on: ubuntu-latest
         steps:
             -   name: Fetch Repository

.github/workflows/test-mssql.yml

@@ -32,9 +32,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         steps:
             -   name: Fetch Repository
                 uses: actions/checkout@v4

.github/workflows/test-neo4j.yml

@@ -16,6 +16,7 @@ jobs:
             matrix:
                 go-version:
                     - 1.23.x
+                    - 1.24.x
         steps:
             -   name: Fetch Repository
                 uses: actions/checkout@v4

.github/workflows/test-pebble.yml

@@ -14,9 +14,8 @@ jobs:
     strategy:
       matrix:
         go-version:
-          - 1.19.x
-          - 1.20.x
-          - 1.21.x
+          - 1.23.x
+          - 1.24.x
     runs-on: ubuntu-latest
     steps:
     -   name: Fetch Repository

.github/workflows/test-ristretto.yml

@@ -15,9 +15,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         steps:
             -   name: Fetch Repository
                 uses: actions/checkout@v4

.github/workflows/test-sqlite3.yml

@@ -14,9 +14,8 @@ jobs:
         strategy:
             matrix:
                 go-version:
-                    - 1.19.x
-                    - 1.20.x
-                    - 1.21.x
+                    - 1.23.x
+                    - 1.24.x
         runs-on: ubuntu-latest
         steps:
             -   name: Fetch Repository

README.md

@@ -22,30 +22,48 @@ sidebar_position: 1
 
 Premade storage drivers that implement the [`Storage`](https://github.com/gofiber/storage/blob/main/storage.go) interface, designed to be used with various [Fiber middlewares](https://github.com/gofiber/fiber/tree/master/middleware).
 
+**Note:** All storages are tested with the latest two [Go version](https://go.dev/doc/devel/release#policy). Older Go versions may  also work, but are not guaranteed to be supported.
+
 ```go
 // Storage interface for communicating with different database/key-value
 // providers. Visit https://github.com/gofiber/storage for more info.
 type Storage interface {
+	// GetWithContext gets the value for the given key with a context.
+	// `nil, nil` is returned when the key does not exist
+	GetWithContext(ctx context.Context, key string) ([]byte, error)
+
 	// Get gets the value for the given key.
 	// `nil, nil` is returned when the key does not exist
 	Get(key string) ([]byte, error)
 
+	// SetWithContext stores the given value for the given key
+	// with an expiration value, 0 means no expiration.
+	SetWithContext(ctx context.Context, key string, val []byte, exp time.Duration) error
+
 	// Set stores the given value for the given key along
 	// with an expiration value, 0 means no expiration.
 	// Empty key or value will be ignored without an error.
 	Set(key string, val []byte, exp time.Duration) error
 
+	// DeleteWithContext deletes the value for the given key with a context.
+	// It returns no error if the storage does not contain the key,
+	DeleteWithContext(ctx context.Context, key string) error
+
 	// Delete deletes the value for the given key.
 	// It returns no error if the storage does not contain the key,
 	Delete(key string) error
 
+	// ResetWithContext resets the storage and deletes all keys with a context.
+	ResetWithContext(ctx context.Context) error
+
 	// Reset resets the storage and delete all keys.
 	Reset() error
 
 	// Close closes the storage and will stop any running garbage
 	// collectors and open connections.
 	Close() error
 }
+
 ```
 
 ## 📑 Storage Implementations

aerospike/README.md

@@ -9,8 +9,6 @@ title: Aerospike
 
 An Aerospike client driver using `aerospike/aerospike-client-go` and [aerospike/aerospike-client-go](https://github.com/aerospike/aerospike-client-go).
 
-**Note: Requires Go 1.23 and above**
-
 ### Table of Contents
 
 - [Signatures](#signatures)
@@ -24,14 +22,20 @@ An Aerospike client driver using `aerospike/aerospike-client-go` and [aerospike/
 ```go
 func New(config ...Config) Storage
 func (s *Storage) Get(key string) ([]byte, error)
+func (s *Storage) GetWithContext(ctx context.Context, key string) ([]byte, error)
 func (s *Storage) Set(key string, val []byte, exp time.Duration) error
+func (s *Storage) SetWithContext(ctx context.Context, key string, val []byte, exp time.Duration) error
 func (s *Storage) Delete(key string) error
+func (s *Storage) DeleteWithContext(ctx context.Context, key string) error
 func (s *Storage) Reset() error
+func (s *Storage) ResetWithContext(ctx context.Context) error
 func (s *Storage) Close() error
 func (s *Storage) Conn() driver.Client
 func (s *Storage) GetSchemaInfo() *SchemaInfo
 ```
 
+**Note:** The context methods are dummy methods and don't have any functionality, as Aerospike does not support context cancellation in its client library. They are provided for compliance with the Fiber storage interface.
+
 ### Installation
 
 Aerospike is tested on the 2 last [Go versions](https://golang.org/dl/) with support for modules. So make sure to initialize one first if you didn't do that yet:

aerospike/aerospike.go

@@ -1,6 +1,7 @@
 package aerospike
 
 import (
+	"context"
 	"log"
 	"time"
 
@@ -216,6 +217,11 @@ func (s *Storage) Get(key string) ([]byte, error) {
 	return data, nil
 }
 
+// GetWithContext gets value by key (dummy context support)
+func (s *Storage) GetWithContext(ctx context.Context, key string) ([]byte, error) {
+	return s.Get(key)
+}
+
 // Set key with value
 func (s *Storage) Set(key string, val []byte, exp time.Duration) error {
 	k, err := aerospike.NewKey(s.namespace, s.setName, key)
@@ -242,6 +248,11 @@ func (s *Storage) Set(key string, val []byte, exp time.Duration) error {
 	return s.client.Put(writePolicy, k, bins)
 }
 
+// SetWithContext sets value by key (dummy context support)
+func (s *Storage) SetWithContext(ctx context.Context, key string, val []byte, exp time.Duration) error {
+	return s.Set(key, val, exp)
+}
+
 // Delete key
 func (s *Storage) Delete(key string) error {
 	k, err := aerospike.NewKey(s.namespace, s.setName, key)
@@ -253,6 +264,11 @@ func (s *Storage) Delete(key string) error {
 	return err
 }
 
+// DeleteWithContext deletes key (dummy context support)
+func (s *Storage) DeleteWithContext(ctx context.Context, key string) error {
+	return s.Delete(key)
+}
+
 // Reset all keys
 func (s *Storage) Reset() error {
 	// Use ScanAll which returns a Recordset
@@ -293,6 +309,11 @@ func (s *Storage) Reset() error {
 	return nil
 }
 
+// ResetWithContext resets all keys (dummy context support)
+func (s *Storage) ResetWithContext(ctx context.Context) error {
+	return s.Reset()
+}
+
 // Close the storage
 func (s *Storage) Close() error {
 	s.client.Close()

arangodb/README.md

@@ -9,8 +9,6 @@ title: ArangoDB
 
 A ArangoDB storage driver using `arangodb/go-driver` and [arangodb/go-driver](https://github.com/arangodb/go-driver).
 
-**Note: Requires Go 1.19 and above**
-
 ### Table of Contents
 - [Signatures](#signatures)
 - [Installation](#installation)
@@ -21,9 +19,13 @@ A ArangoDB storage driver using `arangodb/go-driver` and [arangodb/go-driver](ht
 ### Signatures
 ```go
 func New(config ...Config) Storage
+func (s *Storage) GetWithContext(ctx context.Context, key string) ([]byte, error)
 func (s *Storage) Get(key string) ([]byte, error)
+func (s *Storage) SetWithContext(ctx context.Context, key string, val []byte, exp time.Duration) error
 func (s *Storage) Set(key string, val []byte, exp time.Duration) error
+func (s *Storage) DeleteWithContext(ctx context.Context, key string) error
 func (s *Storage) Delete(key string) error
+func (s *Storage) ResetWithContext(ctx context.Context) error
 func (s *Storage) Reset() error
 func (s *Storage) Close() error
 func (s *Storage) Conn() driver.Client