refactor(deserve): extract response/static/error, pluggable handler, middleware classes ♻️

- Add body parse caching, request state, and replaceRequest to Context
- Add constant-time credential comparison in BasicAuth
- Add error response builder and static handler options to Handler and Router
- Add stream-based body limit with replaceRequest in BodyLimit middleware
- Delegate route scan and pattern creation to Scanner in Handler
- Extend Types with ErrorResponseBuilder, HandlerOptions, SecurityHeadersOptions, Session and WebSocket options, StaticHandler
- Export Handler, Constant, Error, Response, Redirect, Static, Scanner and type namespace from index
- Move response helpers and redirect into dedicated modules; Context.send uses ResponseHelpers
- Refactor Constant to class with static allowedExtensions, contentTypes, httpMethods
- Refactor middleware to class factories (BasicAuth, BodyLimit, Cors, WebSocket) and wrapMiddleware
- Remove SecurityHeaders middleware (replaced by SecHeaders)
- Update deno.json with bench/test tasks, compiler options, and publish excludes
- Update publish workflow to deno-publish, check only, publish with --allow-dirty
- Update README and benchmark README with features, quick start, and run instructions

Author: NeaByteLab

.github/workflows/ci.yaml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-check:
+    name: Build Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.5.4
+
+      - name: Format check
+        run: deno fmt --check src/
+
+      - name: Lint
+        run: deno lint src/
+
+      - name: Type check
+        run: deno check src/
+
+      - name: Test
+        run: deno test tests/ --allow-read

.github/workflows/publish.yml

@@ -6,7 +6,8 @@ on:
       - main
 
 jobs:
-  publish:
+  deno-publish:
+    name: Deno (JSR)
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -18,8 +19,8 @@ jobs:
         with:
           deno-version: v2.5.4
 
-      - name: Run lint and check
-        run: deno lint src/ && deno check src/
+      - name: Check package
+        run: deno check src/
 
-      - name: Publish package
-        run: deno publish
+      - name: Publish to JSR
+        run: deno publish --allow-dirty

.gitignore

@@ -1,5 +1,6 @@
 # Deno
 .deno/
+coverage/
 deno.lock
 
 # IDE
@@ -9,3 +10,8 @@ deno.lock
 # OS
 .DS_Store
 Thumbs.db
+
+# Vite / Node
+.vite/
+node_modules/
+dist/

CHANGELOG.md

@@ -0,0 +1,100 @@
+# Changelog
+
+All notable changes to Deserve. Full commit history in chronological order.
+
+Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+---
+
+## [Unreleased]
+
+### 2026-03-07
+
+**Committed**
+
+- `4d4dcdb` style(handler): enforce braces for control statements
+- `1c80c4e` feat(deserve): optimize framework for streaming and error handling
+
+**Uncommitted (working tree)**
+
+- **Config:** .gitignore, deno.json
+- **Core / refactor:** Constant, Context, Handler, Router, Types, index — cleanup and consolidation
+- **New modules:** Error (error response builder, escapeHtml), Redirect, Response (Send helpers), Scanner (file-based routing), Static (static file serving)
+- **Middleware:** BasicAuth, BodyLimit, CORS, WebSocket, index — refactor; SecurityHeaders removed → SecHeaders (new); Loaders, Session, Utils (wrapMiddleware) added
+- **Docs / meta:** CHANGELOG.md (full commit history)
+- **Tests:** context, handler, middleware, router test files
+
+---
+
+## [0.7.0] - 2025-10-30
+
+### 2025-10-30
+
+- `0ff9118` release(docs): mark features as released and update version to 0.7.0
+- `583106f` docs(static-file): clarify path extraction and wildcard pattern behavior
+- `3675be0` fix(handler): fix route scanning and static file path resolution
+- `010597f` fix(docs): configure search at root level
+- `36f8336` feat(middleware): add security headers middleware
+
+### 2025-10-29
+
+- `a4c8db8` feat(middleware): add body limit middleware
+- `acb560d` feat(middleware): add basic auth and improve error handling
+- `ef190fa` feat(docs): restructure documentation with i18n support
+- `2812d25` feat(router): simplify constructor and add middleware support
+- `5569c43` feat(static): add custom static file serving
+
+### 2025-10-28
+
+- `6fb36b7` refactor(core): migrate to Context-based architecture
+
+### 2025-10-27
+
+- `8a99a21` fix(core): migrate to external router and fix replacement bugs
+
+### 2025-10-26
+
+- `dfd1b35` feat(routing): add case-sensitive routing and filename characters
+- `f4416c3` feat(core): add middleware support for DeserveRequest objects
+
+### 2025-10-25
+
+- `81d5822` feat(middleware): add websocket middleware support
+- `31f35d7` feat(benchmark): add performance benchmarks documentation
+- `984ebad` refactor(router): migrate to FastRouter with radix tree structure
+- `cfa06cd` feat(docs): add request body parsing methods and bump version
+- `3fdacd9` feat(request): add enhanced request handling with automatic parsing
+- `50192b7` refactor(constants): centralize HTTP methods and improve validation
+- `8866020` docs(installation): update deno install link
+- `18db701` ci(deploy): add nojekyll file creation to vitepress build
+- `8e548b3` docs(readme): add installation section
+- `1c0cecb` docs(readme): add server configuration link
+- `2c43a20` feat(router): enhance serve method with hostname and graceful shutdown
+
+### 2025-10-24
+
+- `d00d938` feat(send): add download response methods
+- `5d2821f` docs(rebuild): trigger rebuild for sidebar fix
+- `23e8677` docs(config): update documentation and version
+- `be7fa66` refactor(docs): move CNAME file location
+- `e2f931a` docs(deploy): update build configuration and domain setup
+- `9df2495` docs(project): restructure documentation and simplify README
+- `8e63612` feat(router): add route module validation
+- `aa205ca` feat(utils): add Send utility class for HTTP responses
+- `60e6a8d` feat(router): add route-specific middleware and improve documentation
+- `de1937b` chore(config): bump version to 0.1.5
+- `783b6ba` refactor(router): improve route parsing and scanning logic
+- `ba1c5df` feat(router): add HTTPS URL parsing and update version
+- `25955bf` fix(router): resolve JSR import path issues and improve route handling
+- `99e8696` feat(router): fix module import path resolution
+- `6448d7e` feat(static): improve static file serving and documentation
+- `e4f471c` fix(router): remove hardcoded path prefix from routes directory
+- `c210179` feat(ci): add GitHub Actions workflow and improve router configuration
+- `66895d7` feat(router): add static file serving capability
+- `09b1e4a` feat(middleware): add built-in CORS middleware and enhanced middleware processing
+- `38eaace` feat(error): add error handling middleware
+- `aaa14d2` feat(router): initial implementation of file-based routing library
+
+---
+
+[Unreleased]: https://github.com/neabytelab/deserve/compare/v0.7.0...HEAD

README.md

@@ -1,73 +1,100 @@
-# Deserve [![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](LICENSE) [![Deno](https://img.shields.io/badge/Deno-2.5.4-blue)](https://deno.land) [![JSR](https://jsr.io/badges/@neabyte/deserve)](https://jsr.io/@neabyte/deserve)
+<div align="center">
+
+# Deserve
 
 Build HTTP server effortlessly with zero configuration for productivity.
 
-## Installation
+[![Deno](https://img.shields.io/badge/deno-2.5.4+-000000?logo=deno&logoColor=white)](https://deno.com) [![JSR](https://jsr.io/badges/@neabyte/deserve)](https://jsr.io/@neabyte/deserve) [![CI](https://github.com/NeaByteLab/Deserve/actions/workflows/ci.yaml/badge.svg)](https://github.com/NeaByteLab/Deserve/actions/workflows/ci.yaml) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+</div>
+
+## Features
 
-Install [Deno](https://github.com/denoland/deno_install) 2.5.4+ and run `deno init` for new projects.
+- **Zero config** — No build step for the server. Point to a routes directory and serve.
+- **File-Based Routing** — Drop files in `routes/`; export `GET`, `POST`, etc. File structure is your API.
+- **Context** — Request wrapper: body (JSON/form/text), query, params, cookies, headers, `ctx.send`.
+- **Middleware** — Global, path-specific. CORS, SecHeaders, Body Limit, Basic Auth, Session, WebSocket.
+- **Static files** — `router.static(urlPath, options)` with optional etag and cache-control.
+- **Error handling** — Pluggable error response builder and error middleware; default HTML/JSON by `Accept`.
+- **Frontend optional** — Use any stack (Vite, React, etc.); Deserve stays the server.
 
-Add Deserve using the `deno add` command:
+## Installation
+
+> [!NOTE]
+> **Prerequisites:** [Deno](https://deno.com/) 2.5.4 or later.
 
 ```bash
+# Add Deserve from JSR
 deno add jsr:@neabyte/deserve
 ```
 
-Follow our [installing guide](https://docs-deserve.neabyte.com/en/getting-started/installation) for more information.
-
-## Table of Contents
-
-- **Getting Started**
-  - [Installation](https://docs-deserve.neabyte.com/en/getting-started/installation) - Set up Deserve in your project
-  - [Quick Start](https://docs-deserve.neabyte.com/en/getting-started/quick-start) - Create your first API in minutes
-  - [Server Configuration](https://docs-deserve.neabyte.com/en/getting-started/server-configuration) - Server setup and shutdown
-  - [Routes Configuration](https://docs-deserve.neabyte.com/en/getting-started/routes-configuration) - Configure router options
-
-- **Core Concepts**
-  - [Philosophy](https://docs-deserve.neabyte.com/en/core-concepts/philosophy) - Framework design principles
-  - [File-based Routing](https://docs-deserve.neabyte.com/en/core-concepts/file-based-routing) - How file structure becomes API endpoints
-  - [Route Patterns](https://docs-deserve.neabyte.com/en/core-concepts/route-patterns) - Dynamic routes and parameter matching
-  - [Context Object](https://docs-deserve.neabyte.com/en/core-concepts/context-object) - Request context wrapper with convenient methods
-  - [Request Handling](https://docs-deserve.neabyte.com/en/core-concepts/request-handling) - Enhanced request object with automatic parsing
-
-- **Middleware**
-  - [Use Global](https://docs-deserve.neabyte.com/en/middleware/global) - Cross-cutting functionality
-  - [Use Route-Specific](https://docs-deserve.neabyte.com/en/middleware/route-specific) - Targeted middleware for specific routes
-  - [Basic Auth](https://docs-deserve.neabyte.com/en/middleware/basic-auth) - HTTP Basic Authentication
-  - [Body Limit](https://docs-deserve.neabyte.com/en/middleware/body-limit) - Enforce maximum request body size
-  - [CORS](https://docs-deserve.neabyte.com/en/middleware/cors) - Cross-origin request handling
-  - [Security Headers](https://docs-deserve.neabyte.com/en/middleware/security-headers) - Set HTTP security headers to protect your application
-  - [WebSocket](https://docs-deserve.neabyte.com/en/middleware/websocket) - Real-time bidirectional communication
-
-- **Response Utilities**
-  - [JSON Format](https://docs-deserve.neabyte.com/en/response/json) - Create JSON responses easily
-  - [Text Format](https://docs-deserve.neabyte.com/en/response/text) - Plain text responses
-  - [HTML Format](https://docs-deserve.neabyte.com/en/response/html) - HTML content responses
-  - [File Downloads](https://docs-deserve.neabyte.com/en/response/file) - Download files from filesystem
-  - [Data Downloads](https://docs-deserve.neabyte.com/en/response/data) - Download in-memory content
-  - [Redirects](https://docs-deserve.neabyte.com/en/response/redirect) - Redirect responses
-  - [Custom Responses](https://docs-deserve.neabyte.com/en/response/custom) - Full control over response options
-
-- **Static Files**
-  - [Basic Static Serving](https://docs-deserve.neabyte.com/en/static-file/basic) - Serve static files from directories
-  - [Multiple Directories](https://docs-deserve.neabyte.com/en/static-file/multiple) - Serve from multiple locations
-
-- **Error Handling**
-  - [Default Behavior](https://docs-deserve.neabyte.com/en/error-handling/default-behavior) - Automatic error handling
-  - [Object Details](https://docs-deserve.neabyte.com/en/error-handling/object-details) - Detailed error information
+See the [installation guide](https://docs-deserve.neabyte.com/en/getting-started/installation) for details.
 
-## Contributing
+## Quick Start
+
+Create a routes directory and export HTTP method handlers. Start the server.
+
+```typescript
+import { Router } from 'jsr:@neabyte/deserve'
+
+// Create router and point to your routes directory
+const router = new Router({ routesDir: './routes' })
+
+// Start server on port 8000
+await router.serve(8000)
+```
+
+**Example route** — `routes/hello.ts`:
+
+```typescript
+import type { Context } from 'jsr:@neabyte/deserve'
+
+// Export GET (or POST, PUT, etc.) — path comes from file location
+export function GET(ctx: Context) {
+  return ctx.send.json({ message: 'Hello from Deserve' })
+}
+```
 
-**Help us make Deserve even simpler!** Every contribution helps make building APIs effortless.
+- [Quick Start (docs)](https://docs-deserve.neabyte.com/en/getting-started/quick-start)
+- [File-Based Routing](https://docs-deserve.neabyte.com/en/core-concepts/file-based-routing)
 
-### How to Contribute
+## Build & Test
+
+From the repo root (requires [Deno](https://deno.com/)).
+
+**Check** — format, lint, and typecheck:
+
+```bash
+# Format, lint, and typecheck source
+deno task check
+```
+
+**Test** — run tests (under `tests/`, uses `--allow-read` for fixtures):
+
+```bash
+# Run tests in tests/ (uses --allow-read for fixtures)
+deno task test
+```
+
+**Benchmark** — performance runs with autocannon; see [benchmark/README.md](benchmark/README.md) for how to run and interpret results.
+
+## Documentation
+
+Full docs (EN / ID): **[docs-deserve.neabyte.com](https://docs-deserve.neabyte.com)**
+
+- **Getting Started** — Installation, Quick Start, Server & Routes configuration
+- **Core Concepts** — Philosophy, file-based routing, route patterns, Context, request handling
+- **Middleware** — Global, route-specific, Basic Auth, Body Limit, CORS, Security Headers, WebSocket
+- **Response** — JSON, text, HTML, file/data download, redirect, custom
+- **Static Files** — Basic and multiple directories
+- **Error Handling** — Default behavior, error object details
+
+## Contributing
 
-- **Report Bugs** - Found something broken? Let us know via [GitHub Issues](https://github.com/NeaByteLab/Deserve/issues)
-- **Suggest Features** - Have an idea that aligns with our simplicity-first philosophy? [Create an issue](https://github.com/NeaByteLab/Deserve/issues/new)
-- **Fix & Improve** - Submit [Pull Requests](https://github.com/NeaByteLab/Deserve/pulls) for bug fixes, typos, or code improvements
-- **Build Middleware** - Create and share third-party middleware that extends Deserve's capabilities
-- **Improve Docs** - Help us make the documentation clearer (supports English and Indonesian!)
-- **Use Deserve** - The best contribution? Use it in your projects and share your feedback
+- **Bugs & ideas** — [GitHub Issues](https://github.com/NeaByteLab/Deserve/issues)
+- **Code & docs** — [Pull Requests](https://github.com/NeaByteLab/Deserve/pulls) welcome; docs support English and Indonesian.
+- **Use it** — Try Deserve in your projects and share feedback.
 
 ## License
 
-This project is licensed under the MIT license. See the [LICENSE](LICENSE) file for more info.
+This project is licensed under the MIT license. See [LICENSE](LICENSE) for details.