@bepalo/router 1.2.14 → 1.6.21

package/README.md

@@ -10,6 +10,20 @@
 
 **A fast, feature-rich HTTP router for modern JavaScript runtimes.** [jump to example](#example)
 
+## What is new in this version
+
+Please refer to the [change-log](CHANGELOG.md).
+
+Added `ALL` and `CRUD` shortcuts to method-path definition.
+
+```js
+router.handle("ALL /.**", ...); // HEAD|OPTIONS|GET|POST|PUT|PATCH|DELETE
+router.handle("CRUD /api/.**", ...); // GET|POST|PUT|PATCH|DELETE
+// instead of
+router.handle(["HEAD /", "OPTIONS /", ...], ...); // "ALL /"
+router.handle(["GET /api", "POST /api", ...], ...); // "CRUD /api"
+```
+
 ## 📑 Table of Contents
 
 1. [🏆 @bepalo/router](#-bepalorouter)
@@ -49,16 +63,16 @@
 ## ✨ Features
 
 - ⚡ **High Performance** - Built on a radix tree for O(k) route matching (where k is path length)
-- 🎯 **Flexible Routing** - Support for path parameters, wildcards (`*`, `.*`, `**`, `.**`), and all HTTP methods
-- 🎭 **Multiple Handler Types** - Filters, hooks, handlers, fallbacks, and catchers
+- 🎯 **Flexible Routing Engine** - Support for path parameters, wildcards (`*`, `.*`, `**`, `.**`), and all HTTP methods
+- 🎭 **Multiple Handler Types** - Filters, hooks, afters, handlers, fallbacks, and catchers
 - 🔌 **Middleware Pipeline** - Chain multiple handlers with early exit capability
 - 🛡️ **Error Handling** - Built-in error catching with contextual error handlers
 - 🔄 **Method-Based Routing** - Separate routing trees for each HTTP method
-- 📦 **Local Dependencies** - Only @bepalo dependencies
+- 📦 **Local Dependencies** - Minimal Dependencies — Only internal @bepalo packages
 - 🌐 **Runtime Agnostic** - Works with Bun, Deno, Node.js, and other runtimes
 - 🔧 **TypeScript Ready** - Full type definitions included
-- 🧩 **Router Composition** - Append one router to another with a path prefix.
-- 🛠️ **Helper Functions** - Built-in response helpers (json, html, parseBody, upload, etc.)
+- 🧩 **Composable Router Architecture** - Append one router to another with a path prefix.
+- 🛠️ **Built-in Helper Utilities** - Built-in response helpers (json, html, parseBody, upload, etc.)
 - 🔐 **Middleware Integration** - CORS, rate limiting, authentication helpers
 
 ## 🚀 Get Started
@@ -183,8 +197,8 @@ const router = new Router<CTXAddress>({
   ///...
 });
 
-// Global CORS
-router.filter("GET /.**", [
+// Global rate-limit and CORS
+router.filter("ALL /.**", [
   limitRate({
     key: (req, ctx) => ctx.address.address, // used to identify client
     maxTokens: 30,
@@ -198,35 +212,26 @@ router.filter("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,
-    }),
-  ],
-);
+router.filter("CRUD /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>"),
+  html("<h1>Welcome! Enjoy using @bepalo/router</h1>"),
 );
 router.handle("GET /status", () => status(200));
 
@@ -351,7 +356,7 @@ Deno.serve(
 #### Nodejs
 
 ```js
-// Nodejs example. very slow
+// Node.js compatibility example (uses Fetch bridge; not optimized)
 http
   .createServer(async (req, res) => {
     const url = new URL(req.url || "/", `http://${req.headers.host}`);
@@ -541,6 +546,7 @@ router.respond(
 
 ```ts
 import {
+  Status, // Status enum
   status, // HTTP status response
   redirect, // Redirect response with location header set
   forward, // forward to other path within the router.
@@ -568,10 +574,45 @@ const router = new Router();
 router.handle("GET /text", () => text("Hello World"));
 router.handle("GET /html", () => html("<h1>Title</h1>"));
 router.handle("GET /json", () => json({ data: "value" }));
-router.handle("GET /status", () => status(204, null)); // No Content
+router.handle("GET /status", () => status(Status._204_NoContent, null)); // No Content
 router.handle("GET /intro.mp4", () => blob(Bun.file("./intro.mp4")));
 router.handle("GET /download", () => octetStream(Bun.file("./intro.mp4")));
 
+router.handle("GET /new-location", () => html("GET new-location"));
+// router.handle("POST /new-location", () => html("POST new-location"));
+router.handle<CTXBody>("POST /new-location", [
+  parseBody({ once: true, clone: true }),
+  (req, { body }) => console.log(body),
+  forward("/new-location2"),
+]);
+router.handle<CTXBody>("POST /new-location2", [
+  parseBody({ once: true, clone: false }),
+  (req, { body }) => console.log(body),
+  () => html("POST new-location2"),
+]);
+router.handle("GET /redirected", () => redirect("/new-location"));
+router.handle("GET /forwarded", forward("/new-location"));
+// this would set the headers:
+// "x-forwarded-path": "/forwarded"
+// "x-original-path": "/forwarded"
+router.handle<CTXBody>("PUT /forwarded-with-new-method", [
+  parseBody({ once: true, clone: true }),
+  (req, { body }) => console.log(body),
+  forward("/new-location", { method: "POST" }),
+]);
+// this would set the headers:
+// "x-forwarded-method": "PUT"
+// "x-forwarded-path": "/new-location"
+// "x-original-path": "/forwarded-with-new-method"
+router.handle("GET /forwarded-conditional", function (this: Router, req, ctx) {
+  if (req.headers.get("authorization"))
+    return forward("/new-location").bind(this)(req, ctx);
+  // or return forward("/new-location").apply(this, [req, ctx]);
+  // NOTE: be careful when binding instance `router` instead of `this`
+  //   as it might be called from a different router due to append.
+  return status(Status._401_Unauthorized);
+});
+
 router.handle<CTXCookie>("GET /cookie", [
   parseCookie(),
   (req, { cookie }) => json({ cookie }),
@@ -580,7 +621,8 @@ router.handle<CTXCookie>("GET /cookie", [
 router.handle<CTXBody>("POST /cookie", [
   parseBody(),
   (req, { body }) => {
-    return status(200, "OK", {
+    return status(Status._200_OK, "OK", {
+      // or `, undefined, {` and the status text will be set
       headers: [
         ...Object.entries(body).map(([name, value]) =>
           setCookie(name, String(value), {
@@ -595,24 +637,55 @@ router.handle<CTXBody>("POST /cookie", [
 
 router.handle("DELETE /cookie/:name", [
   (req, ctx) =>
-    status(200, "OK", {
+    status(Status._200_OK, undefined, {
       headers: [clearCookie(ctx.params.name, { path: "/" })],
     }),
 ]);
 
+// be sure to create ./upload folder for this example
 router.handle<CTXUpload>("POST /upload", [
   (req, ctx) => {
     let file: Bun.BunFile;
     let fileWriter: Bun.FileSink;
     return parseUploadStreaming({
       allowedTypes: ["image/jpeg"],
-      async onFileStart(uploadId, fieldName, fileName, contentType, fileSize) {
-        console.log(fileSize);
+      maxFileSize: 5 * 1024 * 1024,
+      maxTotalSize: 5 * 1024 * 1024 + 1024,
+      maxFields: 1,
+      maxFiles: 1,
+      // uploadIdGenerator: () =>
+      //   `upload_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+      async onUploadStart(uploadId, totalSize) {
+        console.log("onUploadStart", { uploadId, totalSize });
+      },
+      async onError(uploadId, error) {
+        console.error("onError", uploadId, error);
+      },
+      async onFileError(uploadId, fieldName, fileName, error) {
+        console.error("onFileError", uploadId, error);
+      },
+      async onField(uploadId, fieldName, value) {
+        console.log("onField", { uploadId, fieldName, value });
+      },
+      async onFileStart(uploadId, fieldName, fileName, contentType) {
+        console.log("onFileStart", {
+          uploadId,
+          fieldName,
+          fileName,
+          contentType,
+        });
         const ext = fileName.substring(fileName.lastIndexOf("."));
-        file = Bun.file("./uploads/" + uploadId + ext);
+        const customFilename = uploadId + ext;
+        file = Bun.file("./uploads/" + customFilename);
         fileWriter = file.writer();
+        return {
+          customFilename,
+          // metadata
+        };
       },
       async onFileChunk(uploadId, fieldName, fileName, chunk, offset, isLast) {
+        const chunkSize = chunk.byteLength;
+        console.log("onFileChunk", { uploadId, chunkSize, offset, isLast });
         fileWriter.write(chunk);
       },
       async onFileComplete(
@@ -623,17 +696,26 @@ router.handle<CTXUpload>("POST /upload", [
         customFilename,
         metadata,
       ) {
-        console.log({ uploadId, fieldName, fileName, fileSize });
+        console.log("onFileComplete", {
+          uploadId,
+          fieldName,
+          fileName,
+          fileSize,
+          customFilename,
+          metadata,
+        });
+        if (fileWriter) {
+          fileWriter.end();
+        }
       },
       async onUploadComplete(uploadId, success) {
-        console.log({ uploadId, success });
+        console.log("onUploadComplete", { uploadId, success });
       },
     })(req, ctx);
   },
   (req, { uploadId, fields, files }) => {
     console.log({ uploadId, fields, files });
-    console.log(files.get("profile"));
-    return status(200);
+    return status(Status._200_OK);
   },
 ]);
 ```
@@ -642,12 +724,21 @@ router.handle<CTXUpload>("POST /upload", [
 
 ```ts
 import {
+  type CTXCookie,
+  type CTXBody,
+  type CTXAuth,
+  type CTXUpload,
+  parseCookie, // Cookie parser
+  parseBody, // Body parser
+  parseUploadStreaming, // multi-part-form-data and file upload stream parser
   cors, // CORS middleware
   limitRate, // Rate limiting
+  authenticate, // Generic authentication middleware
+  authorize, // Generic authorization middleware
   authBasic, // Basic authentication
   authAPIKey, // API key authentication
   authJWT, // JWT authentication
-} from "@bepalo/router/middlewares";
+} from "@bepalo/router";
 ```
 
 ### 🔧 Advanced Usage
@@ -768,13 +859,14 @@ The router uses a radix tree (trie) data structure for route matching, providing
 | Feature                         | @bepalo/router | Express | Hono | Fastify |
 | ------------------------------- | -------------- | ------- | ---- | ------- |
 | Radix Tree Routing              | ✅             | ❌      | ✅   | ✅      |
-| Few Dependencies                | ✅             | ❌      | ❌   | ❌      |
+| Few Dependencies                | ✅             | ❌      | ⚠️   | ⚠️      |
 | TypeScript Native               | ✅             | ❌      | ✅   | ✅      |
-| Extended Handler Phases         | ✅             | ⚠️      | ⚠️   | ⚠️      |
-| Built-in Middleware             | ✅             | ❌      | ✅   | ✅      |
-| Runtime Agnostic                | ✅             | ❌      | ✅   | ❌      |
+| Extended Handler Phases         | ✅             | ❌      | ❌   | ⚠️      |
+| Built-in Middleware             | ✅             | ⚠️      | ✅   | ✅      |
+| Runtime Agnostic                | ✅             | ❌      | ✅   | ⚠️      |
 | Router Composition              | ✅             | ✅      | ✅   | ✅      |
 | Structured Multi-Phase Pipeline | ✅             | ❌      | ❌   | ❌      |
+| Server                          | ❌             | ✅      | ⚠️   | ✅      |
 
 ## 📄 License
 

package/dist/cjs/helpers.d.ts

@@ -1,17 +1,80 @@
-import { RouterContext } from "./router";
-import { Handler } from "./types";
+import type { BoundHandler, HttpMethod } from "./types";
 export * from "./upload-stream";
-export interface SocketAddress {
-    address: string;
-    family: string;
-    port: number;
+export declare enum Status {
+    _100_Continue = 100,
+    _101_SwitchingProtocols = 101,
+    _102_Processing = 102,
+    _103_EarlyHints = 103,
+    _200_OK = 200,
+    _201_Created = 201,
+    _202_Accepted = 202,
+    _203_NonAuthoritativeInformation = 203,
+    _204_NoContent = 204,
+    _205_ResetContent = 205,
+    _206_PartialContent = 206,
+    _207_MultiStatus = 207,
+    _208_AlreadyReported = 208,
+    _226_IMUsed = 226,
+    _300_MultipleChoices = 300,
+    _301_MovedPermanently = 301,
+    _302_Found = 302,
+    _303_SeeOther = 303,
+    _304_NotModified = 304,
+    _305_UseProxy = 305,
+    _307_TemporaryRedirect = 307,
+    _308_PermanentRedirect = 308,
+    _400_BadRequest = 400,
+    _401_Unauthorized = 401,
+    _402_PaymentRequired = 402,
+    _403_Forbidden = 403,
+    _404_NotFound = 404,
+    _405_MethodNotAllowed = 405,
+    _406_NotAcceptable = 406,
+    _407_ProxyAuthenticationRequired = 407,
+    _408_RequestTimeout = 408,
+    _409_Conflict = 409,
+    _410_Gone = 410,
+    _411_LengthRequired = 411,
+    _412_PreconditionFailed = 412,
+    _413_PayloadTooLarge = 413,
+    _414_URITooLong = 414,
+    _415_UnsupportedMediaType = 415,
+    _416_RangeNotSatisfiable = 416,
+    _417_ExpectationFailed = 417,
+    _418_IMATeapot = 418,
+    _421_MisdirectedRequest = 421,
+    _422_UnprocessableEntity = 422,
+    _423_Locked = 423,
+    _424_FailedDependency = 424,
+    _425_TooEarly = 425,
+    _426_UpgradeRequired = 426,
+    _428_PreconditionRequired = 428,
+    _429_TooManyRequests = 429,
+    _431_RequestHeaderFieldsTooLarge = 431,
+    _451_UnavailableForLegalReasons = 451,
+    _500_InternalServerError = 500,
+    _501_NotImplemented = 501,
+    _502_BadGateway = 502,
+    _503_ServiceUnavailable = 503,
+    _504_GatewayTimeout = 504,
+    _505_HTTPVersionNotSupported = 505,
+    _506_VariantAlsoNegotiates = 506,
+    _507_InsufficientStorage = 507,
+    _508_LoopDetected = 508,
+    _510_NotExtended = 510,
+    _511_NetworkAuthenticationRequired = 511,
+    _419_PageExpired = 419,
+    _420_EnhanceYourCalm = 420,
+    _450_BlockedbyWindowsParentalControls = 450,
+    _498_InvalidToken = 498,
+    _499_TokenRequired = 499,
+    _509_BandwidthLimitExceeded = 509,
+    _526_InvalidSSLCertificate = 526,
+    _529_Siteisoverloaded = 529,
+    _530_Siteisfrozen = 530,
+    _598_NetworkReadTimeoutError = 598,
+    _599_NetworkConnectTimeoutError = 599
 }
-export type CTXError = {
-    error: Error;
-};
-export type CTXAddress = {
-    address: SocketAddress;
-};
 export declare function getHttpStatusText(code: number): string;
 /**
  * Creates a Response with the specified status code.
@@ -36,14 +99,18 @@ export declare const status: (status: number, content?: string | null, init?: Re
  */
 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.
+ * Forwards the request to another route internally.
+ * Does not send a redirect to the client but changes the path and method,
+ * adds X-Forwarded-[Method|Path] and X-Original-Path headers and calls
+ * `(this as Router).respond(newReq, ctx)`.
+ * NOTE: parse body only once at the first handler using `parseBody({once: true})`
+ *   as the body will be consumed at the first parseBody call.
  * @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>>;
+    method?: HttpMethod;
+}) => BoundHandler<XContext>;
 /**
  * Creates a text/plain Response.
  * Defaults to status 200 and text/plain content-type if not specified.
@@ -194,53 +261,6 @@ export declare const clearCookie: (name: string, options?: CookieOptions) => Coo
  * // Returns: { session: "abc123", theme: "dark" }
  */
 export declare const parseCookieFromRequest: <Expected extends Record<string, string>>(req: Request) => Expected | undefined;
-/**
- * Context object containing parsed cookies.
- * @typedef {Object} CTXCookie
- * @property {Record<string, string>} cookie - Parsed cookies from the request
- */
-export type CTXCookie = {
-    cookie: Record<string, string>;
-};
-/**
- * Creates middleware that parses cookies from the request and adds them to the context.
- * @returns {Function} A middleware function that adds parsed cookies to context.cookie
- * @example
- * const cookieParser = parseCookie();
- * // Use in respondWith: respondWith({}, cookieParser(), ...otherHandlers)
- */
-export declare const parseCookie: <Context extends CTXCookie>() => Handler<Context>;
-/**
- * Context object containing parsed request body.
- * @typedef {Object} CTXBody
- * @property {Record<string, unknown>} body - Parsed request body data
- */
-export type CTXBody = {
-    body: Record<string, unknown>;
-};
-/**
- * Supported media types for request body parsing.
- * @typedef {"application/x-www-form-urlencoded"|"application/json"|"text/plain"} SupportedBodyMediaTypes
- */
-export type SupportedBodyMediaTypes = "application/x-www-form-urlencoded" | "application/json" | "text/plain";
-/**
- * Creates middleware that parses the request body based on Content-Type.
- * Supports url-encoded forms, JSON, and plain text.
- * @param {Object} [options] - Configuration options for body parsing
- * @param {SupportedBodyMediaTypes|SupportedBodyMediaTypes[]} [options.accept] - Media types to accept (defaults to all supported)
- * @param {number} [options.maxSize] - Maximum body size in bytes (defaults to 1MB)
- * @returns {Function} A middleware function that adds parsed body to context.body
- * @throws {Response} Returns a 415 response if content-type is not accepted
- * @throws {Response} Returns a 413 response if body exceeds maxSize
- * @throws {Response} Returns a 400 response if body is malformed
- * @example
- * const bodyParser = parseBody({ maxSize: 5000 });
- * // Use in respondWith: respondWith({}, bodyParser(), ...otherHandlers)
- */
-export declare const parseBody: <Context extends CTXBody>(options?: {
-    accept?: SupportedBodyMediaTypes | SupportedBodyMediaTypes[];
-    maxSize?: number;
-}) => Handler<Context>;
 /**
  * Request handler function type.
  * @callback RequestHandler

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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"}