@bepalo/router 1.1.11 → 1.2.13

package/README.md

@@ -8,7 +8,43 @@
 
 [![Vitest](https://img.shields.io/badge/vitest-6E9F18?style=for-the-badge&logo=vitest&logoColor=white)](test-result.md)
 
-**A fast, feature-rich HTTP router for modern JavaScript runtimes.**
+**A fast, feature-rich HTTP router for modern JavaScript runtimes.** [jump to example](#example)
+
+## 📑 Table of Contents
+
+1. [🏆 @bepalo/router](#-bepalorouter)
+2. [✨ Features](#-features)
+3. [🚀 Get Started](#-get-started)
+   - [📥 Installation](#-installation)
+   - [📦 Basic Usage](#-basic-usage)
+   - [Example](#example)
+   - [Serve with client address](#serve-with-client-address)
+     - [Bun](#bun)
+     - [Deno](#deno)
+     - [Nodejs](#nodejs)
+4. [📚 Core Concepts](#-core-concepts)
+   - [Handler Types & Execution Order](#handler-types--execution-order)
+   - [Router Context](#router-context)
+5. [📖 API Reference](#-api-reference)
+   - [Router Class](#router-class)
+     - [Constructor](#constructor)
+     - [Configuration Options](#configuration-options)
+     - [Handler Registration Methods](#handler-registration-methods)
+     - [Handler Options](#handler-options)
+     - [Router Composition](#router-composition)
+     - [Request Processing](#request-processing)
+     - [Helper Functions](#helper-functions)
+     - [Provided Middleware](#provided-middleware)
+   - [🔧 Advanced Usage](#-advanced-usage)
+     - [Pipeline (Multiple Handlers)](#pipeline-multiple-handlers)
+     - [Path Patterns](#path-patterns)
+     - [Route Priority](#route-priority)
+     - [Router Composition Example](#router-composition-example)
+6. [🎯 Performance](#-performance)
+   - [Comparison with Other Routers](#comparison-with-other-routers)
+7. [📄 License](#-license)
+8. [🕊️ Thanks and Enjoy](#-thanks-and-enjoy)
+9. [💖 Be a Sponsor](#-be-a-sponsor)
 
 ## ✨ Features
 
@@ -63,6 +99,7 @@ import {
   type CTXUpload,
   parseUploadStreaming,
 } from "@bepalo/router";
+// } from "jsr:@bepalo/router"; // for deno
 
 // Create a router instance
 const router = new Router();
@@ -94,9 +131,274 @@ Bun.serve({
   fetch: (req) => router.respond(req),
 });
 
+// Start server (Deno example)
+Deno.serve(
+  {
+    port: 3000,
+    onListen: () => console.log("Server listening on http://localhost:3000"),
+  },
+  router.respond.bind(router),
+);
+
+console.log("Server running at http://localhost:3000");
+```
+
+### Example
+
+```js
+import {
+  Router,
+  status,
+  html,
+  json,
+  cors,
+  limitRate,
+  parseBody,
+  type CTXBody,
+  type CTXAddress,
+  type SocketAddress,
+} from "@bepalo/router";
+import { z } from "zod";
+
+const router = new Router<CTXAddress>({
+  // Default headers can accept static headers or dynamic headers
+  //   as a function like this
+  defaultHeaders: () => [
+    ["X-Powered-By", "@bepalo/router"],
+    ["Date", new Date().toUTCString()],
+  ],
+  // Errors are caught by defualt but not logged
+  defaultCatcher: (req, ctx) => {
+    console.error("Error:", ctx.error);
+    return json({ error: "Something went wrong" }, { status: 500 });
+  },
+  // For crude optimizations
+  enable: {
+    hooks: false,
+    afters: false,
+    filters: true,
+    fallbacks: true,
+    catchers: true,
+  },
+  ///...
+});
+
+// Global CORS
+router.filter("GET /.**", [
+  limitRate({
+    key: (req, ctx) => ctx.address.address, // used to identify client
+    maxTokens: 30,
+    refillRate: 3, // 3 tokens every second
+    setXRateLimitHeaders: true,
+  }),
+  cors({
+    origins: "*",
+    methods: ["GET"],
+  }),
+]);
+
+// Rate limiting for API
+router.filter(
+  [
+    "GET /api/.**",
+    "POST /api/.**",
+    "PUT /api/.**",
+    "PATCH /api/.**",
+    "DELETE /api/.**",
+  ],
+  [
+    limitRate({
+      key: (req, ctx) => ctx.address.address, // used to identify client
+      maxTokens: 100,
+      refillInterval: 30_000, // every 30 seconds
+      refillRate: 50, // 50 tokens every refillInterval
+      setXRateLimitHeaders: true,
+    }),
+    cors({
+      origins: ["http://localhost:3000", "https://example.com"],
+      methods: ["GET", "POST", "PUT", "DELETE"],
+      allowedHeaders: ["Content-Type", "Authorization"],
+      credentials: true,
+      endHere: true,
+    }),
+  ],
+);
+
+// Main route
+router.handle("GET /", () =>
+  html("<h1>Welcome! Enjoy using @beplao/router</h1>"),
+);
+router.handle("GET /status", () => status(200));
+
+// Sample sub-route `/api/user`
+////////////////////////////////////////
+// eg. inside routes/api/user.ts
+const userRepo = new Map();
+const userAPI = new Router();
+let topId = 1000;
+
+const postUserBodySchema = z.object({
+  name: z.string(),
+  password: z.string().min(4),
+});
+
+userAPI.filter<CTXBody>("POST /", [
+  parseBody(),
+  (req, { body }) => {
+    const { success, error } = postUserBodySchema.safeParse(body);
+    const errors = error?.issues ?? [];
+    if (!success) return json({ errors }, { status: 400 });
+  },
+]);
+userAPI.handle<CTXBody>("POST /", [
+  (req, { body }) => {
+    const id = topId++;
+    const { name, password } = body;
+    const user = { id, name, password };
+    userRepo.set(id, user);
+    return json({ success: true, id }, { status: 201 });
+  },
+]);
+
+userAPI.handle("GET /", () =>
+  json({ users: Object.fromEntries(userRepo.entries()) }),
+);
+
+userAPI.handle("GET /:userId", (req, { params }) => {
+  const { userId } = params;
+  const user = userRepo.get(parseInt(userId));
+  if (!user) return json({ error: "User not found" }, { status: 404 });
+  return json({ user });
+});
+
+////////////////////////////////////////
+
+router.append("/api/user", userAPI);
+
+// fallback handling
+router.fallback("GET /api/.**", () =>
+  json({ error: "Not found" }, { status: 404 }),
+);
+
+// Error handling
+router.catch(
+  [
+    "GET /api/.**",
+    "POST /api/.**",
+    "PUT /api/.**",
+    "PATCH /api/.**",
+    "DELETE /api/.**",
+  ],
+  [
+    (req, ctx) => {
+      console.error("APIError:", ctx.error);
+      return json({ error: "Something went wrong" }, { status: 500 });
+    },
+  ],
+);
+
+// Start server
+Bun.serve({
+  port: 3000,
+  async fetch(req, server) {
+    const address = server.requestIP(req) as SocketAddress | null;
+    if (!address) throw new Error("null client address");
+    /// best to log request and response here...
+    return await router.respond(req, { address });
+  },
+});
+
+console.log("Server listening on http://localhost:3000");
+```
+
+### Serve with client address
+
+#### Bun
+
+```js
+// Bun example
+Bun.serve({
+  port: 3000,
+  async fetch(req, server) {
+    const address = server.requestIP(req) as SocketAddress;
+    return await router.respond(req, { address });
+  },
+});
 console.log("Server running at http://localhost:3000");
 ```
 
+#### Deno
+
+```js
+// Deno example
+Deno.serve(
+  {
+    port: 3000,
+    onListen: () => console.log("Server listening on http://localhost:3000"),
+  },
+  async (req, { remoteAddr }) => {
+    const address = {
+      family: remoteAddr.transport,
+      address: remoteAddr.hostname,
+      port: remoteAddr.port,
+    } as SocketAddress;
+    return router.respond(req, { address });
+  },
+  // router.respond.bind(router),
+);
+```
+
+#### Nodejs
+
+```js
+// Nodejs example. very slow
+http
+  .createServer(async (req, res) => {
+    const url = new URL(req.url || "/", `http://${req.headers.host}`);
+
+    // Build fetch request
+    const headers = new Headers();
+    Object.entries(req.headers).forEach(
+      ([k, v]) => v && headers.set(k, v.toString()),
+    );
+
+    const request = new Request(url, {
+      method: req.method,
+      headers,
+      body: ["GET", "HEAD"].includes(req.method) ? undefined : req,
+      duplex: "half",
+    });
+
+    const address = {
+      family: req.socket.remoteFamily,
+      address: req.socket.remoteAddress,
+      port: req.socket.remotePort,
+    };
+    try {
+      const response = await router.respond(request, { address });
+
+      res.writeHead(
+        response.status,
+        response.statusText,
+        Object.fromEntries(response.headers.entries()),
+      );
+      if (response.body) {
+        const reader = response.body.getReader();
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          res.write(value);
+        }
+      }
+      res.end();
+    } catch {
+      res.writeHead(500).end();
+    }
+  })
+  .on("connection", (socket) => socket.setNoDelay(true))
+  .listen(3000, () => console.log("Server running on port 3000"));
+```
+
 ## 📚 Core Concepts
 
 ### Handler Types & Execution Order
@@ -240,6 +542,8 @@ router.respond(
 ```ts
 import {
   status, // HTTP status response
+  redirect, // Redirect response with location header set
+  forward, // forward to other path within the router.
   text, // Plain text response
   html, // HTML response
   json, // JSON response
@@ -411,129 +715,40 @@ Routes are matched in this order of priority:
 ### Router Composition Example
 
 ```js
-const apiRouter = new Router();
-
-// API routes
-apiRouter.handle("GET /users", () => json({ users: [] }));
-apiRouter.handle("POST /users", async (req) => {
-  const body = await req.json();
-  return json({ created: true, data: body }, { status: 201 });
-});
-
-// Nested router
-const v1Router = new Router();
-v1Router.handle("GET /status", () => json({ version: "1.0", status: "ok" }));
-apiRouter.append("/v1", v1Router);
-
-// Mount API router under /api
-const mainRouter = new Router();
-mainRouter.append("/api", apiRouter);
-
-// Add some frontend routes
-mainRouter.handle("GET /", () => html("<h1>Home</h1>"));
-mainRouter.handle("GET /about", () => html("<h1>About</h1>"));
-```
-
-### Complete Example with Middleware
-
-```js
-import {
-  Router,
-  text,
-  json,
-  cors,
-  limitRate,
-  type CTXAddress,
-  type SocketAddress,
-  type RouterContext,
-} from "@bepalo/router";
-
-const router = new Router<RouterContext & CTXAddress>({
-  defaultHeaders: () => [
-    ["X-Powered-By", "@bepalo/router"],
-    ["Date", new Date().toUTCString()]
-  ],
-});
-
-// Global CORS
-router.filter("*", [
-  cors({
-    origins: ["http://localhost:3000", "https://example.com"],
-    methods: ["GET", "POST", "PUT", "DELETE"],
-    allowedHeaders: ["Content-Type", "Authorization"],
-    credentials: true,
-  }),
-]);
-
-// Rate limiting for API
-router.filter(
+// User API routes
+const userAPIRouter = new Router();
+userAPIRouter.handle("GET /", () => json({ user: {} }));
+userAPIRouter.handle <
+  CTXBody >
+  ("POST /",
   [
-    "GET /api/.**",
-    "POST /api/.**",
-    "PUT /api/.**",
-    "PATCH /api/.**",
-    "DELETE /api/.**",
-  ],
-  [
-    limitRate({
-      key: (req, ctx) => ctx.address.address,
-      maxTokens: 100,
-      refillRate: 10, // 10 tokens per second
-      setXRateLimitHeaders: true,
-    }),
+    parseBody(),
+    async (req, { body }) => {
+      return json({ success: true, data: body }, { status: 201 });
+    },
+  ]);
+
+// Session API routes
+const sessionAPIRouter = new Router();
+sessionAPIRouter.handle("GET /", () => json({ session: {} }));
+sessionAPIRouter.handle("POST /", [
+  parseBody(),
+  async (req, { body }) => {
+    return json({ success: true, data: body }, { status: 201 });
+  },
 ]);
 
-// Routes
-router.handle("GET /", () => text("Welcome to the API"));
+// API v1 router
+const v1APIRouter = new Router();
+v1APIRouter.handle("GET /status", () => json({ version: "1.0", status: "ok" }));
 
-// users API `/api/users` router
-{
-  const usersAPI = new Router();
-
-  usersAPI.handle("POST /", async (req) => {
-    const body = await req.json();
-    return json({ id: Date.now(), ...body }, { status: 201 });
-  });
-
-  usersAPI.handle("GET /", () =>
-    json({
-      users: [
-        { id: 1, name: "Abebe" },
-        { id: 2, name: "Derartu" },
-      ],
-    }),
-  );
-
-  usersAPI.handle("GET /:id", (req, { params }) =>
-    json({ user: { id: params.id, name: "User " + params.id } }),
-  );
-
-  router.append("/api/users", usersAPI);
-}
-
-// Custom Error handling
-router.catch("*", (req, ctx) => {
-  console.error("Error:", ctx.error);
-  return json({ error: "Internal server error" }, { status: 500 });
-});
-
-// Custom fallback handler
-router.fallback("*", () => json({ error: "Not found" }, { status: 404 }));
-
-// Start server
-Bun.serve({
-  port: 3000,
-  async fetch(req, server) {
-    const address = server.requestIP(req) as SocketAddress | null;
-    if(!address) {
-      throw new Error("null client address");
-    }
-    return await router.respond(req, { address });
-  },
-});
-
-console.log("Server listening on http://localhost:3000");
+// Composition is useful for defining routes in multiple files
+//  and appending them in other routes.
+v1APIRouter.append("/user", userAPIRouter);
+v1APIRouter.append("/session", sessionAPIRouter);
 
+const mainRouter = new Router();
+mainRouter.append("/api/v1", v1APIRouter);
 ```
 
 ## 🎯 Performance
@@ -553,7 +768,7 @@ The router uses a radix tree (trie) data structure for route matching, providing
 | Feature                         | @bepalo/router | Express | Hono | Fastify |
 | ------------------------------- | -------------- | ------- | ---- | ------- |
 | Radix Tree Routing              | ✅             | ❌      | ✅   | ✅      |
-| Zero Dependencies               | ✅             | ❌      | ❌   | ❌      |
+| Few Dependencies                | ✅             | ❌      | ❌   | ❌      |
 | TypeScript Native               | ✅             | ❌      | ✅   | ✅      |
 | Extended Handler Phases         | ✅             | ⚠️      | ⚠️   | ⚠️      |
 | Built-in Middleware             | ✅             | ❌      | ✅   | ✅      |

package/dist/cjs/helpers.d.ts

@@ -1,12 +1,14 @@
+import { RouterContext } from "./router";
 import { Handler } from "./types";
 export * from "./upload-stream";
-type SURecord = Record<string, unknown>;
-type SSRecord = Record<string, string>;
 export interface SocketAddress {
     address: string;
     family: string;
     port: number;
 }
+export type CTXError = {
+    error: Error;
+};
 export type CTXAddress = {
     address: SocketAddress;
 };
@@ -24,6 +26,24 @@ export declare function getHttpStatusText(code: number): string;
  * status(204, null); // No content response
  */
 export declare const status: (status: number, content?: string | null, init?: ResponseInit) => Response;
+/**
+ * Creates a redirect Response.
+ * Defaults to 302 Found unless another status is provided.
+ * @param {string} location - The URL to redirect to
+ * @param {number} [code=302] - The HTTP status code (301, 302, 303, 307, 308)
+ * @param {ResponseInit} [init] - Additional response initialization options
+ * @returns {Response} A Response object with Location header
+ */
+export declare const redirect: (location: string, init?: ResponseInit) => Response;
+/**
+ * Forwards the request to another handler internally.
+ * Does not change the URL or send a redirect to the client.
+ * @param {string} path - The new path to forward to
+ * @returns {Response} A Response object with the forwarded request's response
+ */
+export declare const forward: <XContext = {}>(path: string, options?: {
+    method: string;
+}) => Handler<RouterContext<XContext>>;
 /**
  * Creates a text/plain Response.
  * Defaults to status 200 and text/plain content-type if not specified.
@@ -177,10 +197,10 @@ export declare const parseCookieFromRequest: <Expected extends Record<string, st
 /**
  * Context object containing parsed cookies.
  * @typedef {Object} CTXCookie
- * @property {SSRecord} cookie - Parsed cookies from the request
+ * @property {Record<string, string>} cookie - Parsed cookies from the request
  */
 export type CTXCookie = {
-    cookie: SSRecord;
+    cookie: Record<string, string>;
 };
 /**
  * Creates middleware that parses cookies from the request and adds them to the context.
@@ -193,10 +213,10 @@ export declare const parseCookie: <Context extends CTXCookie>() => Handler<Conte
 /**
  * Context object containing parsed request body.
  * @typedef {Object} CTXBody
- * @property {SURecord} body - Parsed request body data
+ * @property {Record<string, unknown>} body - Parsed request body data
  */
 export type CTXBody = {
-    body: SURecord;
+    body: Record<string, unknown>;
 };
 /**
  * Supported media types for request body parsing.

package/dist/cjs/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"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"}