Native Fetch Frameworks

Taser is built entirely on Web Standard Request and Response interfaces. Using the Host Pass-Through Architecture, you can pair Taser's file-based routing and cascading type safety with any Web Standard / Fetch-native framework or existing fetch handler.

Supported Fetch-Native Hosts

Because Taser evaluates standard Web Request objects, any framework or library exposing a standard .fetch(request) interface or { fetch: (req: Request) => Response | Promise<Response> } handler is supported out of the box:

• Hono: Ultra-fast web standard framework for Node, Bun, Deno, and Cloudflare.
• Elysia: Ergonomic, type-safe web framework for Bun.
• HatTip: Minimalist set of modular web-standard packages.
• Itty Router: Tiny router for JavaScript environments.
• Pure Web Standard Fetch: Any plain function receiving Request and returning Response.

How Host Pass-Through Works

When an incoming HTTP request reaches your server:

1. Taser Route Check: If the URL matches a file route in src/routes/, Taser dispatches the request with complete compile-time type safety.
2. Host App Pass-Through: If no Taser route matches, the request falls through directly to your exported application in src/server.ts.
3. 404 Not Found: If neither Taser nor the host framework handles the request, Taser returns a standard 404 response.

[Incoming Request]
       │
       ▼
[Taser File Routes] ── Match? ──► [Execute Taser Route Handler]
       │ (No match)
       ▼
[Fetch Host App] ───── Match? ──► [Execute Host App (Hono / Elysia / Web Fetch)]
       │ (No match)
       ▼
[404 Not Found]

Quickstart

import { Hono } from "hono";

const app = new Hono();

// Existing or custom Hono endpoints:
app.get("/host-info", (c) => {
  return c.json({ framework: "Hono", status: "online" });
});

export default app;

import { json } from "@taserjs/router/reply";
import { t } from "@taserjs/router";

const GET = t.get("/users");

export default GET.handler(() => {
  return json({ users: ["Alice", "Bob"] });
});

pnpm dev

Reusing Web Standard Middleware in Taser

Using the honoMw() helper, you can adapt any native Web Standard and Fetch-native middleware function into Taser:

import { middleware, honoMw, t } from "@taserjs/router";
import { secureHeaders } from "hono/secure-headers";

// Wrap any Web Standard middleware seamlessly using honoMw()
const securityHeadersMiddleware = middleware(honoMw(secureHeaders()));

export default t.layout("/*").use(securityHeadersMiddleware);

Next Steps