import { compose } from './compose.ts' import { Context } from './context.ts' import type { ExecutionContext } from './context.ts' import { HTTPException } from './http-exception.ts' import { HonoRequest } from './request.ts' import type { Router } from './router.ts' import { METHOD_NAME_ALL, METHOD_NAME_ALL_LOWERCASE, METHODS } from './router.ts' import type { Env, ErrorHandler, H, HandlerInterface, MiddlewareHandler, MiddlewareHandlerInterface, Next, NotFoundHandler, OnHandlerInterface, MergePath, MergeSchemaPath, FetchEventLike, Schema, RouterRoute, } from './types.ts' import { getPath, getPathNoStrict, getQueryStrings, mergePath } from './utils/url.ts' type Methods = typeof METHODS[number] | typeof METHOD_NAME_ALL_LOWERCASE function defineDynamicClass(): { new (): { [M in Methods]: HandlerInterface } & { on: OnHandlerInterface } & { use: MiddlewareHandlerInterface } } { return class {} as never } const notFoundHandler = (c: Context) => { return c.text('404 Not Found', 404) } const errorHandler = (err: Error, c: Context) => { if (err instanceof HTTPException) { return err.getResponse() } console.error(err) const message = 'Internal Server Error' return c.text(message, 500) } type GetPath = (request: Request, options?: { env?: E['Bindings'] }) => string export type HonoOptions = { strict?: boolean router?: Router<[H, RouterRoute]> getPath?: GetPath } class Hono< E extends Env = Env, S extends Schema = {}, BasePath extends string = '/' > extends defineDynamicClass() { /* This class is like an abstract class and does not have a router. To use it, inherit the class and implement router in the constructor. */ router!: Router<[H, RouterRoute]> readonly getPath: GetPath // Cannot use `#` because it requires visibility at JavaScript runtime. private _basePath: string = '/' #path: string = '/' routes: RouterRoute[] = [] constructor(options: HonoOptions = {}) { super() // Implementation of app.get(...handlers[]) or app.get(path, ...handlers[]) const allMethods = [...METHODS, METHOD_NAME_ALL_LOWERCASE] allMethods.map((method) => { this[method] = (args1: string | H, ...args: H[]) => { if (typeof args1 === 'string') { this.#path = args1 } else { this.addRoute(method, this.#path, args1) } args.map((handler) => { if (typeof handler !== 'string') { this.addRoute(method, this.#path, handler) } }) // eslint-disable-next-line @typescript-eslint/no-explicit-any return this as any } }) // Implementation of app.on(method, path, ...handlers[]) this.on = (method: string | string[], path: string, ...handlers: H[]) => { if (!method) return this this.#path = path for (const m of [method].flat()) { handlers.map((handler) => { this.addRoute(m.toUpperCase(), this.#path, handler) }) } // eslint-disable-next-line @typescript-eslint/no-explicit-any return this as any } // Implementation of app.use(...handlers[]) or app.get(path, ...handlers[]) // eslint-disable-next-line @typescript-eslint/no-explicit-any this.use = (arg1: string | MiddlewareHandler, ...handlers: MiddlewareHandler[]) => { if (typeof arg1 === 'string') { this.#path = arg1 } else { handlers.unshift(arg1) } handlers.map((handler) => { this.addRoute(METHOD_NAME_ALL, this.#path, handler) }) return this } const strict = options.strict ?? true delete options.strict Object.assign(this, options) this.getPath = strict ? options.getPath ?? getPath : getPathNoStrict } private clone(): Hono { const clone = new Hono({ router: this.router, getPath: this.getPath, }) clone.routes = this.routes return clone } private notFoundHandler: NotFoundHandler = notFoundHandler private errorHandler: ErrorHandler = errorHandler route< SubPath extends string, SubEnv extends Env, SubSchema extends Schema, SubBasePath extends string >( path: SubPath, app?: Hono ): Hono> & S, BasePath> { const subApp = this.basePath(path) if (!app) { return subApp } app.routes.map((r) => { const handler = app.errorHandler === errorHandler ? r.handler : async (c: Context, next: Next) => (await compose([], app.errorHandler)(c, () => r.handler(c, next))).res subApp.addRoute(r.method, r.path, handler) }) return this } basePath(path: SubPath): Hono> { const subApp = this.clone() subApp._basePath = mergePath(this._basePath, path) return subApp } onError = (handler: ErrorHandler) => { this.errorHandler = handler return this } notFound = (handler: NotFoundHandler) => { this.notFoundHandler = handler return this } /** * @deprecated * Use `showRoutes()` utility methods provided by 'hono/dev' instead of `app.showRoutes()`. * `app.showRoutes()` will be removed in v4. * @example * You could rewrite `app.showRoutes()` as follows * import { showRoutes } from 'hono/dev' * showRoutes(app) */ showRoutes() { const length = 8 this.routes.map((route) => { console.log( `\x1b[32m${route.method}\x1b[0m ${' '.repeat(length - route.method.length)} ${route.path}` ) }) } mount( path: string, // eslint-disable-next-line @typescript-eslint/no-explicit-any applicationHandler: (request: Request, ...args: any) => Response | Promise, optionHandler?: (c: Context) => unknown ): Hono { const mergedPath = mergePath(this._basePath, path) const pathPrefixLength = mergedPath === '/' ? 0 : mergedPath.length const handler: MiddlewareHandler = async (c, next) => { let executionContext: ExecutionContext | undefined = undefined try { executionContext = c.executionCtx } catch {} // Do nothing const options = optionHandler ? optionHandler(c) : [c.env, executionContext] const optionsArray = Array.isArray(options) ? options : [options] const queryStrings = getQueryStrings(c.req.url) const res = await applicationHandler( new Request( new URL((c.req.path.slice(pathPrefixLength) || '/') + queryStrings, 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 } /** * @deprecated * `app.head()` is no longer used. * `app.get()` implicitly handles the HEAD method. */ head = () => { console.warn('`app.head()` is no longer used. `app.get()` implicitly handles the HEAD method.') return this } private addRoute(method: string, path: string, handler: H) { method = method.toUpperCase() path = mergePath(this._basePath, path) const r: RouterRoute = { path: path, method: method, handler: handler } this.router.add(method, path, [handler, r]) this.routes.push(r) } private matchRoute(method: string, path: string) { return this.router.match(method, path) } private handleError(err: unknown, c: Context) { if (err instanceof Error) { return this.errorHandler(err, c) } throw err } private dispatch( request: Request, executionCtx: ExecutionContext | FetchEventLike | undefined, env: E['Bindings'], method: string ): Response | Promise { // Handle HEAD method if (method === 'HEAD') { return (async () => new Response(null, await this.dispatch(request, executionCtx, env, 'GET')))() } const path = this.getPath(request, { env }) const matchResult = this.matchRoute(method, path) const c = new Context(new HonoRequest(request, path, matchResult), { env, executionCtx, notFoundHandler: this.notFoundHandler, }) // Do not `compose` if it has only one handler if (matchResult[0].length === 1) { let res: ReturnType try { res = matchResult[0][0][0][0](c, async () => {}) if (!res) { return this.notFoundHandler(c) } } catch (err) { return this.handleError(err, c) } if (res instanceof Response) return res return (async () => { let awaited: Response | void try { awaited = await res if (!awaited) { return this.notFoundHandler(c) } } catch (err) { return this.handleError(err, c) } return awaited })() } const composed = compose(matchResult[0], this.errorHandler, this.notFoundHandler) return (async () => { try { const context = await composed(c) if (!context.finalized) { throw new Error( 'Context is not finalized. You may forget returning Response object or `await next()`' ) } return context.res } catch (err) { return this.handleError(err, c) } })() } /** * @deprecated * `app.handleEvent()` will be removed in v4. * Use `app.fetch()` instead of `app.handleEvent()`. */ handleEvent = (event: FetchEventLike) => { return this.dispatch(event.request, event, undefined, event.request.method) } fetch = (request: Request, Env?: E['Bindings'] | {}, executionCtx?: ExecutionContext) => { return this.dispatch(request, executionCtx, Env, request.method) } request = ( input: RequestInfo | URL, requestInit?: RequestInit, Env?: E['Bindings'] | {}, executionCtx?: ExecutionContext ) => { if (input instanceof Request) { if (requestInit !== undefined) { input = new Request(input, requestInit) } return this.fetch(input, Env, executionCtx) } input = input.toString() const path = /^https?:\/\//.test(input) ? input : `http://localhost${mergePath('/', input)}` const req = new Request(path, requestInit) return this.fetch(req, Env, executionCtx) } fire = () => { // eslint-disable-next-line @typescript-eslint/ban-ts-comment // @ts-ignore addEventListener('fetch', (event: FetchEventLike): void => { event.respondWith(this.dispatch(event.request, event, undefined, event.request.method)) }) } } export { Hono as HonoBase }