hono 3.2.0-rc.3 → 3.2.0

package/README.md

@@ -47,11 +47,11 @@ npm create hono@latest my-app
 
 ## Features
 
-- **Ultrafast** - The router _RegExpRouter_ is really fast. Not using linear loops. Fast.
-- **Multi-runtime** - Works on Cloudflare Workers, Fastly Compute@Edge, Deno, Bun, Lagon, AWS Lambda or Node.js. The same code runs on all platforms.
-- **Batteries Included** - Hono has built-in middleware, custom middleware, and third-party middleware. Batteries included.
-- **Delightful DX** - First-class TypeScript support. Now, we've got "Types".
-- **Small** - The `hono/tiny` preset is under 12kB. Hono has zero dependencies and uses only the Web Standard API.
+- **Ultrafast** 🚀 - The router `RegExpRouter` is really fast. Not using linear loops. Fast.
+- **Lightweight** 🪶 - The `hono/tiny` preset is under 12kB. Hono has zero dependencies and uses only the Web Standard API.
+- **Multi-runtime** 🌍 - Works on Cloudflare Workers, Fastly Compute@Edge, Deno, Bun, Lagon, AWS Lambda, or Node.js. The same code runs on all platforms.
+- **Batteries Included** 🔋 - Hono has built-in middleware, custom middleware, and third-party middleware. Batteries included.
+- **Delightful DX** 🛠️ - Super clean APIs. First-class TypeScript support. Now, we've got "Types".
 
 ## Benchmarks
 

package/dist/cjs/hono-base.js

@@ -67,6 +67,11 @@ class Hono extends defineDynamicClass() {
       const req = new Request(path, requestInit);
       return await this.fetch(req);
     };
+    this.fire = () => {
+      addEventListener("fetch", (event) => {
+        void event.respondWith(this.handleEvent(event));
+      });
+    };
     const allMethods = [...import_router.METHODS, import_router.METHOD_NAME_ALL_LOWERCASE];
     allMethods.map((method) => {
       this[method] = (args1, ...args) => {
@@ -150,6 +155,31 @@ class Hono extends defineDynamicClass() {
       );
     });
   }
+  mount(path, applicationHandler, optionHandler) {
+    const pathPrefixLength = (0, import_url.mergePath)(this._basePath, path).length;
+    const handler = async (c, next) => {
+      let executionContext = void 0;
+      try {
+        executionContext = c.executionCtx;
+      } catch {
+      }
+      const options = optionHandler ? optionHandler(c) : [c.env, executionContext];
+      const optionsArray = Array.isArray(options) ? options : [options];
+      const res = await applicationHandler(
+        new Request(new URL(c.req.path.slice(pathPrefixLength) || "/", c.req.url), c.req.raw),
+        ...optionsArray
+      );
+      if (res)
+        return res;
+      await next();
+    };
+    this.addRoute(import_router.METHOD_NAME_ALL, (0, import_url.mergePath)(path, "*"), handler);
+    return this;
+  }
+  get routerName() {
+    this.matchRoute("GET", "/");
+    return this.router.name;
+  }
   addRoute(method, path, handler) {
     method = method.toUpperCase();
     if (this._basePath) {

package/dist/cjs/index.js

@@ -22,11 +22,6 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 var import_hono = require("./hono");
-import_hono.Hono.prototype.fire = function() {
-  addEventListener("fetch", (event) => {
-    void event.respondWith(this.handleEvent(event));
-  });
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Hono

package/dist/cjs/preset/quick.js

@@ -24,8 +24,8 @@ module.exports = __toCommonJS(quick_exports);
 var import_hono_base = require("../hono-base");
 var import_linear_router = require("../router/linear-router");
 class Hono extends import_hono_base.HonoBase {
-  constructor() {
-    super();
+  constructor(init = {}) {
+    super(init);
     this.router = new import_linear_router.LinearRouter();
   }
 }

package/dist/cjs/preset/tiny.js

@@ -24,8 +24,8 @@ module.exports = __toCommonJS(tiny_exports);
 var import_hono_base = require("../hono-base");
 var import_pattern_router = require("../router/pattern-router");
 class Hono extends import_hono_base.HonoBase {
-  constructor() {
-    super();
+  constructor(init = {}) {
+    super(init);
     this.router = new import_pattern_router.PatternRouter();
   }
 }

package/dist/cjs/router/linear-router/router.js

@@ -26,6 +26,7 @@ const splitPathRe = /\/(:\w+(?:{[^}]+})?)|\/[^\/\?]+|(\?)/g;
 const splitByStarRe = /\*/;
 class LinearRouter {
   constructor() {
+    this.name = "LinearRouter";
     this.routes = [];
   }
   add(method, path, handler) {

package/dist/cjs/router/pattern-router/router.js

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(router_exports);
 var import_router = require("../../router");
 class PatternRouter {
   constructor() {
+    this.name = "PatternRouter";
     this.routes = [];
     this.dNames = {};
   }
@@ -32,7 +33,7 @@ class PatternRouter {
     if (endsWithWildcard) {
       path = path.slice(0, -2);
     }
-    const parts = path.match(/\/(:\w+(?:{[^}]+})?)|\/[^\/\?]+|(\?)/g) || [];
+    const parts = path.match(/\/?(:\w+(?:{[^}]+})?)|\/?[^\/\?]+|(\?)/g) || [];
     if (parts[parts.length - 1] === "?") {
       this.add(method, parts.slice(0, parts.length - 2).join(""), handler);
       parts.pop();

package/dist/cjs/router/reg-exp-router/router.js

@@ -93,6 +93,7 @@ function findMiddleware(middleware, path) {
 }
 class RegExpRouter {
   constructor() {
+    this.name = "RegExpRouter";
     this.middleware = { [import_router.METHOD_NAME_ALL]: {} };
     this.routes = { [import_router.METHOD_NAME_ALL]: {} };
   }

package/dist/cjs/router/smart-router/router.js

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(router_exports);
 var import_router = require("../../router");
 class SmartRouter {
   constructor(init) {
+    this.name = "SmartRouter";
     this.routers = [];
     this.routes = [];
     Object.assign(this, init);
@@ -63,6 +64,7 @@ class SmartRouter {
     if (i === len) {
       throw new Error("Fatal error");
     }
+    this.name = `SmartRouter + ${this.activeRouter.name}`;
     return res || null;
   }
   get activeRouter() {

package/dist/cjs/router/trie-router/router.js

@@ -25,6 +25,7 @@ var import_url = require("../../utils/url");
 var import_node = require("./node");
 class TrieRouter {
   constructor() {
+    this.name = "TrieRouter";
     this.node = new import_node.Node();
   }
   add(method, path, handler) {

package/dist/hono-base.js

@@ -45,6 +45,11 @@ var Hono = class extends defineDynamicClass() {
       const req = new Request(path, requestInit);
       return await this.fetch(req);
     };
+    this.fire = () => {
+      addEventListener("fetch", (event) => {
+        void event.respondWith(this.handleEvent(event));
+      });
+    };
     const allMethods = [...METHODS, METHOD_NAME_ALL_LOWERCASE];
     allMethods.map((method) => {
       this[method] = (args1, ...args) => {
@@ -128,6 +133,31 @@ var Hono = class extends defineDynamicClass() {
       );
     });
   }
+  mount(path, applicationHandler, optionHandler) {
+    const pathPrefixLength = mergePath(this._basePath, path).length;
+    const handler = async (c, next) => {
+      let executionContext = void 0;
+      try {
+        executionContext = c.executionCtx;
+      } catch {
+      }
+      const options = optionHandler ? optionHandler(c) : [c.env, executionContext];
+      const optionsArray = Array.isArray(options) ? options : [options];
+      const res = await applicationHandler(
+        new Request(new URL(c.req.path.slice(pathPrefixLength) || "/", c.req.url), c.req.raw),
+        ...optionsArray
+      );
+      if (res)
+        return res;
+      await next();
+    };
+    this.addRoute(METHOD_NAME_ALL, mergePath(path, "*"), handler);
+    return this;
+  }
+  get routerName() {
+    this.matchRoute("GET", "/");
+    return this.router.name;
+  }
   addRoute(method, path, handler) {
     method = method.toUpperCase();
     if (this._basePath) {

package/dist/index.js

@@ -1,10 +1,5 @@
 // src/index.ts
 import { Hono } from "./hono.js";
-Hono.prototype.fire = function() {
-  addEventListener("fetch", (event) => {
-    void event.respondWith(this.handleEvent(event));
-  });
-};
 export {
   Hono
 };

package/dist/preset/quick.js

@@ -2,8 +2,8 @@
 import { HonoBase } from "../hono-base.js";
 import { LinearRouter } from "../router/linear-router/index.js";
 var Hono = class extends HonoBase {
-  constructor() {
-    super();
+  constructor(init = {}) {
+    super(init);
     this.router = new LinearRouter();
   }
 };

package/dist/preset/tiny.js

@@ -2,8 +2,8 @@
 import { HonoBase } from "../hono-base.js";
 import { PatternRouter } from "../router/pattern-router/index.js";
 var Hono = class extends HonoBase {
-  constructor() {
-    super();
+  constructor(init = {}) {
+    super(init);
     this.router = new PatternRouter();
   }
 };

package/dist/router/linear-router/router.js

@@ -4,6 +4,7 @@ var splitPathRe = /\/(:\w+(?:{[^}]+})?)|\/[^\/\?]+|(\?)/g;
 var splitByStarRe = /\*/;
 var LinearRouter = class {
   constructor() {
+    this.name = "LinearRouter";
     this.routes = [];
   }
   add(method, path, handler) {

package/dist/router/pattern-router/router.js

@@ -2,6 +2,7 @@
 import { METHOD_NAME_ALL } from "../../router.js";
 var PatternRouter = class {
   constructor() {
+    this.name = "PatternRouter";
     this.routes = [];
     this.dNames = {};
   }
@@ -10,7 +11,7 @@ var PatternRouter = class {
     if (endsWithWildcard) {
       path = path.slice(0, -2);
     }
-    const parts = path.match(/\/(:\w+(?:{[^}]+})?)|\/[^\/\?]+|(\?)/g) || [];
+    const parts = path.match(/\/?(:\w+(?:{[^}]+})?)|\/?[^\/\?]+|(\?)/g) || [];
     if (parts[parts.length - 1] === "?") {
       this.add(method, parts.slice(0, parts.length - 2).join(""), handler);
       parts.pop();

package/dist/router/reg-exp-router/router.js

@@ -71,6 +71,7 @@ function findMiddleware(middleware, path) {
 }
 var RegExpRouter = class {
   constructor() {
+    this.name = "RegExpRouter";
     this.middleware = { [METHOD_NAME_ALL]: {} };
     this.routes = { [METHOD_NAME_ALL]: {} };
   }

package/dist/router/smart-router/router.js

@@ -2,6 +2,7 @@
 import { UnsupportedPathError } from "../../router.js";
 var SmartRouter = class {
   constructor(init) {
+    this.name = "SmartRouter";
     this.routers = [];
     this.routes = [];
     Object.assign(this, init);
@@ -41,6 +42,7 @@ var SmartRouter = class {
     if (i === len) {
       throw new Error("Fatal error");
     }
+    this.name = `SmartRouter + ${this.activeRouter.name}`;
     return res || null;
   }
   get activeRouter() {

package/dist/router/trie-router/router.js

@@ -3,6 +3,7 @@ import { checkOptionalParameter } from "../../utils/url.js";
 import { Node } from "./node.js";
 var TrieRouter = class {
   constructor() {
+    this.name = "TrieRouter";
     this.node = new Node();
   }
   add(method, path, handler) {

package/dist/types/hono-base.d.ts

@@ -1,3 +1,4 @@
+import { Context } from './context';
 import type { ExecutionContext } from './context';
 import type { Router } from './router';
 import type { Env, ErrorHandler, H, HandlerInterface, MiddlewareHandlerInterface, NotFoundHandler, OnHandlerInterface, MergePath, MergeSchemaPath } from './types';
@@ -43,6 +44,13 @@ declare class Hono<E extends Env = Env, S = {}, BasePath extends string = '/'> e
     onError(handler: ErrorHandler<E>): this;
     notFound(handler: NotFoundHandler<E>): this;
     showRoutes(): void;
+    /**
+     * @experimental
+     * `app.mount()` is an experimental feature.
+     * The API might be changed.
+     */
+    mount(path: string, applicationHandler: (request: Request, ...args: any) => Response | Promise<Response>, optionHandler?: (c: Context) => unknown): Hono<E, S, BasePath>;
+    get routerName(): string;
     private addRoute;
     private matchRoute;
     private handleError;
@@ -50,5 +58,6 @@ declare class Hono<E extends Env = Env, S = {}, BasePath extends string = '/'> e
     handleEvent: (event: FetchEvent) => Response | Promise<Response>;
     fetch: (request: Request, Env?: E['Bindings'] | {}, executionCtx?: ExecutionContext) => Response | Promise<Response>;
     request: (input: Request | string | URL, requestInit?: RequestInit) => Promise<Response>;
+    fire: () => void;
 }
 export { Hono as HonoBase };

package/dist/types/index.d.ts

@@ -2,9 +2,4 @@ import { Hono } from './hono';
 export type { Env, ErrorHandler, Handler, MiddlewareHandler, Next, NotFoundHandler, ValidationTargets, Input, } from './types';
 export type { Context, ContextVariableMap } from './context';
 export type { HonoRequest } from './request';
-declare module './hono-base' {
-    interface HonoBase {
-        fire(): void;
-    }
-}
 export { Hono };

package/dist/types/preset/quick.d.ts

@@ -1,5 +1,7 @@
 import { HonoBase } from '../hono-base';
 import type { Env } from '../types';
 export declare class Hono<E extends Env = Env, S = {}, BasePath extends string = '/'> extends HonoBase<E, S, BasePath> {
-    constructor();
+    constructor(init?: Partial<Pick<Hono, 'getPath'> & {
+        strict: boolean;
+    }>);
 }

package/dist/types/preset/tiny.d.ts

@@ -1,5 +1,7 @@
 import { HonoBase } from '../hono-base';
 import type { Env } from '../types';
 export declare class Hono<E extends Env = Env, S = {}, BasePath extends string = '/'> extends HonoBase<E, S, BasePath> {
-    constructor();
+    constructor(init?: Partial<Pick<Hono, 'getPath'> & {
+        strict: boolean;
+    }>);
 }

package/dist/types/router/linear-router/router.d.ts

@@ -1,5 +1,6 @@
 import type { Router, Result } from '../../router';
 export declare class LinearRouter<T> implements Router<T> {
+    name: string;
     routes: [string, string, T][];
     add(method: string, path: string, handler: T): void;
     match(method: string, path: string): Result<T> | null;

package/dist/types/router/pattern-router/router.d.ts

@@ -1,5 +1,6 @@
 import type { Result, Router } from '../../router';
 export declare class PatternRouter<T> implements Router<T> {
+    name: string;
     private routes;
     private dNames;
     add(method: string, path: string, handler: T): void;

package/dist/types/router/reg-exp-router/router.d.ts

@@ -1,5 +1,6 @@
 import type { Router, Result } from '../../router';
 export declare class RegExpRouter<T> implements Router<T> {
+    name: string;
     middleware?: Record<string, Record<string, T[]>>;
     routes?: Record<string, Record<string, T[]>>;
     constructor();

package/dist/types/router/smart-router/router.d.ts

@@ -1,5 +1,6 @@
 import type { Router, Result } from '../../router';
 export declare class SmartRouter<T> implements Router<T> {
+    name: string;
     routers: Router<T>[];
     routes?: [string, string, T][];
     constructor(init: Pick<SmartRouter<T>, 'routers'>);

package/dist/types/router/trie-router/router.d.ts

@@ -1,6 +1,7 @@
 import type { Result, Router } from '../../router';
 import { Node } from './node';
 export declare class TrieRouter<T> implements Router<T> {
+    name: string;
     node: Node<T>;
     constructor();
     add(method: string, path: string, handler: T): void;

package/dist/types/router.d.ts

@@ -2,6 +2,7 @@ export declare const METHOD_NAME_ALL: "ALL";
 export declare const METHOD_NAME_ALL_LOWERCASE: "all";
 export declare const METHODS: readonly ["get", "post", "put", "delete", "head", "options", "patch"];
 export interface Router<T> {
+    name: string;
     add(method: string, path: string, handler: T): void;
     match(method: string, path: string): Result<T> | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono",
-  "version": "3.2.0-rc.3",
+  "version": "3.2.0",
   "description": "Ultrafast web framework for the Edges",
   "main": "dist/cjs/index.js",
   "type": "module",