@flightdev/http 0.0.4

package/dist/adapters/deno.js

@@ -0,0 +1,28 @@
+// src/adapters/deno.ts
+function serve(app, options = {}) {
+  const {
+    port = 3e3,
+    hostname = "0.0.0.0",
+    onListen
+  } = options;
+  const server = Deno.serve(
+    (request) => app.fetch(request),
+    {
+      port,
+      hostname,
+      onListen: onListen ? (params) => onListen({ port: params.port, hostname: params.hostname }) : (params) => {
+        console.log(`
+  \u2708\uFE0F  Flight HTTP Server (Deno) running!
+  
+  \u279C  Local:   http://localhost:${params.port}/
+  \u279C  Network: http://${params.hostname}:${params.port}/
+`);
+      }
+    }
+  );
+  return server;
+}
+
+export { serve };
+//# sourceMappingURL=deno.js.map
+//# sourceMappingURL=deno.js.map

package/dist/adapters/deno.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/deno.ts"],"names":[],"mappings":";AAmDO,SAAS,KAAA,CACZ,GAAA,EACA,OAAA,GAAwB,EAAC,EACQ;AACjC,EAAA,MAAM;AAAA,IACF,IAAA,GAAO,GAAA;AAAA,IACP,QAAA,GAAW,SAAA;AAAA,IACX;AAAA,GACJ,GAAI,OAAA;AAEJ,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA;AAAA,IAChB,CAAC,OAAA,KAAY,GAAA,CAAI,KAAA,CAAM,OAAO,CAAA;AAAA,IAC9B;AAAA,MACI,IAAA;AAAA,MACA,QAAA;AAAA,MACA,QAAA,EAAU,QAAA,GACJ,CAAC,MAAA,KAAW,SAAS,EAAE,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,UAAU,MAAA,CAAO,QAAA,EAAU,CAAA,GACrE,CAAC,MAAA,KAAW;AACV,QAAA,OAAA,CAAQ,GAAA,CAAI;AAAA;AAAA;AAAA,oCAAA,EAGC,OAAO,IAAI,CAAA;AAAA,0BAAA,EACrB,MAAA,CAAO,QAAQ,CAAA,CAAA,EAAI,MAAA,CAAO,IAAI,CAAA;AAAA,CACpD,CAAA;AAAA,MACe;AAAA;AACR,GACJ;AAEA,EAAA,OAAO,MAAA;AACX","file":"deno.js","sourcesContent":["/**\r\n * @flightdev/http - Deno Adapter\r\n * \r\n * Allows running Flight HTTP server on Deno runtime.\r\n * Deno natively supports Web Standard Request/Response.\r\n */\r\n\r\nimport type { FlightHttpServer, Env } from '../types.js';\r\n\r\n// ============================================================================\r\n// Deno Server Types\r\n// ============================================================================\r\n\r\ninterface DenoServeOptions {\r\n    port?: number;\r\n    hostname?: string;\r\n    onListen?: (params: { hostname: string; port: number }) => void;\r\n}\r\n\r\n// We don't import Deno types directly to avoid build issues\r\ndeclare const Deno: {\r\n    serve: (\r\n        handler: (request: Request) => Response | Promise<Response>,\r\n        options?: DenoServeOptions\r\n    ) => { shutdown: () => Promise<void> };\r\n};\r\n\r\n// ============================================================================\r\n// serve() Function\r\n// ============================================================================\r\n\r\nexport interface ServeOptions {\r\n    port?: number;\r\n    hostname?: string;\r\n    onListen?: (info: { port: number; hostname: string }) => void;\r\n}\r\n\r\n/**\r\n * Start a Deno server with the Flight app\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createServer } from '@flightdev/http';\r\n * import { serve } from '@flightdev/http/deno';\r\n * \r\n * const app = createServer();\r\n * app.get('/', (c) => c.json({ hello: 'world' }));\r\n * \r\n * serve(app, { port: 3000 });\r\n * ```\r\n */\r\nexport function serve<E extends Env = Env>(\r\n    app: FlightHttpServer<E>,\r\n    options: ServeOptions = {}\r\n): { shutdown: () => Promise<void> } {\r\n    const {\r\n        port = 3000,\r\n        hostname = '0.0.0.0',\r\n        onListen,\r\n    } = options;\r\n\r\n    const server = Deno.serve(\r\n        (request) => app.fetch(request),\r\n        {\r\n            port,\r\n            hostname,\r\n            onListen: onListen\r\n                ? (params) => onListen({ port: params.port, hostname: params.hostname })\r\n                : (params) => {\r\n                    console.log(`\r\n  ✈️  Flight HTTP Server (Deno) running!\r\n  \r\n  ➜  Local:   http://localhost:${params.port}/\r\n  ➜  Network: http://${params.hostname}:${params.port}/\r\n`);\r\n                },\r\n        }\r\n    );\r\n\r\n    return server;\r\n}\r\n\r\n// Re-export useful types\r\nexport type { FlightHttpServer } from '../types.js';\r\n"]}

package/dist/adapters/node.d.ts

@@ -0,0 +1,34 @@
+import { createServer } from 'node:http';
+import { E as Env, F as FlightHttpServer } from '../types-CtqOEBIR.js';
+
+/**
+ * @flightdev/http - Node.js Adapter
+ *
+ * Allows running Flight HTTP server on Node.js.
+ */
+
+interface ServeOptions {
+    port?: number;
+    hostname?: string;
+    onListen?: (info: {
+        port: number;
+        hostname: string;
+    }) => void;
+}
+/**
+ * Start a Node.js HTTP server with the Flight app
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from '@flightdev/http';
+ * import { serve } from '@flightdev/http/node';
+ *
+ * const app = createServer();
+ * app.get('/', (c) => c.json({ hello: 'world' }));
+ *
+ * serve(app, { port: 3000 });
+ * ```
+ */
+declare function serve<E extends Env = Env>(app: FlightHttpServer<E>, options?: ServeOptions): ReturnType<typeof createServer>;
+
+export { FlightHttpServer, type ServeOptions, serve };

package/dist/adapters/node.js

@@ -0,0 +1,89 @@
+import { createServer } from 'http';
+
+// src/adapters/node.ts
+async function toWebRequest(req) {
+  const host = req.headers.host || "localhost";
+  const protocol = "http";
+  const url = new URL(req.url || "/", `${protocol}://${host}`);
+  let body = null;
+  if (req.method !== "GET" && req.method !== "HEAD") {
+    const chunks = [];
+    for await (const chunk of req) {
+      chunks.push(chunk);
+    }
+    body = Buffer.concat(chunks);
+  }
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    if (value) {
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          headers.append(key, v);
+        }
+      } else {
+        headers.set(key, value);
+      }
+    }
+  }
+  return new Request(url.toString(), {
+    method: req.method || "GET",
+    headers,
+    body
+  });
+}
+async function writeWebResponse(webResponse, res) {
+  res.statusCode = webResponse.status;
+  res.statusMessage = webResponse.statusText;
+  webResponse.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+  if (webResponse.body) {
+    const reader = webResponse.body.getReader();
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        res.write(value);
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  res.end();
+}
+function serve(app, options = {}) {
+  const {
+    port = 3e3,
+    hostname = "0.0.0.0",
+    onListen
+  } = options;
+  const server = createServer(async (req, res) => {
+    try {
+      const webRequest = await toWebRequest(req);
+      const webResponse = await app.fetch(webRequest);
+      await writeWebResponse(webResponse, res);
+    } catch (error) {
+      console.error("[Flight HTTP Node] Error:", error);
+      res.statusCode = 500;
+      res.end("Internal Server Error");
+    }
+  });
+  server.listen(port, hostname, () => {
+    const info = { port, hostname };
+    if (onListen) {
+      onListen(info);
+    } else {
+      console.log(`
+  \u2708\uFE0F  Flight HTTP Server running!
+  
+  \u279C  Local:   http://${hostname === "0.0.0.0" ? "localhost" : hostname}:${port}/
+  \u279C  Network: http://${hostname}:${port}/
+`);
+    }
+  });
+  return server;
+}
+
+export { serve };
+//# sourceMappingURL=node.js.map
+//# sourceMappingURL=node.js.map

package/dist/adapters/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/node.ts"],"names":["createNodeServer"],"mappings":"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","file":"node.js","sourcesContent":["/**\r\n * @flightdev/http - Node.js Adapter\r\n * \r\n * Allows running Flight HTTP server on Node.js.\r\n */\r\n\r\nimport { createServer as createNodeServer, type IncomingMessage, type ServerResponse } from 'node:http';\r\nimport type { FlightHttpServer, Env } from '../types.js';\r\n\r\n// ============================================================================\r\n// Node.js Request Converter\r\n// ============================================================================\r\n\r\nasync function toWebRequest(req: IncomingMessage): Promise<Request> {\r\n    const host = req.headers.host || 'localhost';\r\n    const protocol = 'http'; // Simplified, use https detection in production\r\n    const url = new URL(req.url || '/', `${protocol}://${host}`);\r\n\r\n    // Collect body for non-GET/HEAD requests\r\n    let body: BodyInit | null = null;\r\n\r\n    if (req.method !== 'GET' && req.method !== 'HEAD') {\r\n        const chunks: Buffer[] = [];\r\n        for await (const chunk of req) {\r\n            chunks.push(chunk as Buffer);\r\n        }\r\n        body = Buffer.concat(chunks);\r\n    }\r\n\r\n    // Convert headers\r\n    const headers = new Headers();\r\n    for (const [key, value] of Object.entries(req.headers)) {\r\n        if (value) {\r\n            if (Array.isArray(value)) {\r\n                for (const v of value) {\r\n                    headers.append(key, v);\r\n                }\r\n            } else {\r\n                headers.set(key, value);\r\n            }\r\n        }\r\n    }\r\n\r\n    return new Request(url.toString(), {\r\n        method: req.method || 'GET',\r\n        headers,\r\n        body,\r\n    });\r\n}\r\n\r\n// ============================================================================\r\n// Node.js Response Writer\r\n// ============================================================================\r\n\r\nasync function writeWebResponse(webResponse: Response, res: ServerResponse): Promise<void> {\r\n    // Set status\r\n    res.statusCode = webResponse.status;\r\n    res.statusMessage = webResponse.statusText;\r\n\r\n    // Set headers\r\n    webResponse.headers.forEach((value, key) => {\r\n        res.setHeader(key, value);\r\n    });\r\n\r\n    // Send body\r\n    if (webResponse.body) {\r\n        const reader = webResponse.body.getReader();\r\n\r\n        try {\r\n            while (true) {\r\n                const { done, value } = await reader.read();\r\n                if (done) break;\r\n                res.write(value);\r\n            }\r\n        } finally {\r\n            reader.releaseLock();\r\n        }\r\n    }\r\n\r\n    res.end();\r\n}\r\n\r\n// ============================================================================\r\n// serve() Function\r\n// ============================================================================\r\n\r\nexport interface ServeOptions {\r\n    port?: number;\r\n    hostname?: string;\r\n    onListen?: (info: { port: number; hostname: string }) => void;\r\n}\r\n\r\n/**\r\n * Start a Node.js HTTP server with the Flight app\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createServer } from '@flightdev/http';\r\n * import { serve } from '@flightdev/http/node';\r\n * \r\n * const app = createServer();\r\n * app.get('/', (c) => c.json({ hello: 'world' }));\r\n * \r\n * serve(app, { port: 3000 });\r\n * ```\r\n */\r\nexport function serve<E extends Env = Env>(\r\n    app: FlightHttpServer<E>,\r\n    options: ServeOptions = {}\r\n): ReturnType<typeof createNodeServer> {\r\n    const {\r\n        port = 3000,\r\n        hostname = '0.0.0.0',\r\n        onListen,\r\n    } = options;\r\n\r\n    const server = createNodeServer(async (req, res) => {\r\n        try {\r\n            const webRequest = await toWebRequest(req);\r\n            const webResponse = await app.fetch(webRequest);\r\n            await writeWebResponse(webResponse, res);\r\n        } catch (error) {\r\n            console.error('[Flight HTTP Node] Error:', error);\r\n            res.statusCode = 500;\r\n            res.end('Internal Server Error');\r\n        }\r\n    });\r\n\r\n    server.listen(port, hostname, () => {\r\n        const info = { port, hostname };\r\n\r\n        if (onListen) {\r\n            onListen(info);\r\n        } else {\r\n            console.log(`\r\n  ✈️  Flight HTTP Server running!\r\n  \r\n  ➜  Local:   http://${hostname === '0.0.0.0' ? 'localhost' : hostname}:${port}/\r\n  ➜  Network: http://${hostname}:${port}/\r\n`);\r\n        }\r\n    });\r\n\r\n    return server;\r\n}\r\n\r\n// Re-export useful types\r\nexport type { FlightHttpServer } from '../types.js';\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+import { E as Env, S as ServerOptions, F as FlightHttpServer, H as HandlerOrMiddleware, M as Middleware, a as Handler, C as Context, b as FetchOptions, L as ListenOptions, c as HttpMethod, R as Route } from './types-CtqOEBIR.js';
+
+/**
+ * @flightdev/http - Server
+ *
+ * Main server class that implements the FlightHttpServer interface.
+ *
+ * PERFORMANCE OPTIMIZATIONS (2026):
+ * - Middleware chains pre-compiled at route registration (not per-request)
+ * - Minimal allocations in fetch() hot path
+ * - Uses optimized class-based Context
+ */
+
+declare class FlightHttp<E extends Env = Env> implements FlightHttpServer<E> {
+    private router;
+    private globalMiddleware;
+    private notFoundHandler;
+    private errorHandler;
+    private basePath;
+    private compiledNotFoundHandler?;
+    private middlewareVersion;
+    private lastCompiledVersion;
+    constructor(options?: ServerOptions);
+    get(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    post(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    put(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    delete(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    patch(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    options(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    head(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    all(path: string, ...handlers: HandlerOrMiddleware<E>[]): FlightHttpServer<E>;
+    use(...handlers: Middleware<E>[]): FlightHttpServer<E>;
+    route(path: string, router: FlightHttpServer<E>): FlightHttpServer<E>;
+    notFound(handler: Handler<E>): FlightHttpServer<E>;
+    onError(handler: (error: Error, c: Context<E>) => Response | Promise<Response>): FlightHttpServer<E>;
+    fetch(request: Request, options?: FetchOptions): Promise<Response>;
+    listen(options?: ListenOptions | number): void;
+    private addRoute;
+    /**
+     * Get pre-compiled not found handler (with global middleware)
+     */
+    private getCompiledNotFoundHandler;
+}
+/**
+ * Create a new Flight HTTP server
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from '@flightdev/http';
+ *
+ * const app = createServer();
+ *
+ * app.get('/', (c) => c.json({ message: 'Hello Flight!' }));
+ *
+ * export default app;
+ * ```
+ */
+declare function createServer<E extends Env = Env>(options?: ServerOptions): FlightHttpServer<E>;
+
+/**
+ * @flightdev/http - Context
+ *
+ * Request/Response context object passed to handlers.
+ *
+ * PERFORMANCE OPTIMIZATIONS (2026):
+ * - Class-based implementation (methods on prototype, not recreated per request)
+ * - Lazy URL parsing (parsed once, cached)
+ * - Lazy cookie parsing (parsed once, cached)
+ * - Minimal allocations in hot path
+ */
+
+/**
+ * Create a new Context instance.
+ * Uses class-based implementation for optimal performance.
+ */
+declare function createContext<E extends Env = Env>(request: Request, params?: Record<string, string>, env?: E['Bindings']): Context<E>;
+
+/**
+ * @flightdev/http - Router
+ *
+ * Radix-tree based router for ultra-fast path matching.
+ * Uses radix3 under the hood.
+ */
+
+interface MatchResult<E extends Env = Env> {
+    handler: Handler<E>;
+    params: Record<string, string>;
+}
+declare class Router<E extends Env = Env> {
+    private radix;
+    private routes;
+    constructor();
+    /**
+     * Add a route
+     */
+    add(method: HttpMethod | '*', path: string, handler: Handler<E>): void;
+    /**
+     * Match a request to a route
+     */
+    match(method: HttpMethod, path: string): MatchResult<E> | null;
+    /**
+     * Get all registered routes
+     */
+    getRoutes(): Route<E>[];
+    /**
+     * Normalize path
+     */
+    private normalizePath;
+    /**
+     * Extract params from matched path
+     * @deprecated radix3 handles param extraction internally
+     */
+    private _extractParams;
+}
+
+export { Context, Env, FetchOptions, FlightHttp, FlightHttpServer, Handler, HandlerOrMiddleware, HttpMethod, ListenOptions, Middleware, Route, Router, ServerOptions, createContext, createServer };

package/dist/index.js

@@ -0,0 +1,377 @@
+import { createRouter } from 'radix3';
+
+// src/router.ts
+var Router = class {
+  radix;
+  routes = [];
+  constructor() {
+    this.radix = createRouter();
+  }
+  /**
+   * Add a route
+   */
+  add(method, path, handler) {
+    const normalizedPath = this.normalizePath(path);
+    let node = this.radix.lookup(normalizedPath);
+    if (!node) {
+      node = { handlers: /* @__PURE__ */ new Map() };
+      this.radix.insert(normalizedPath, node);
+    }
+    node.handlers.set(method, handler);
+    this.routes.push({
+      method,
+      path: normalizedPath,
+      handler,
+      middleware: []
+    });
+  }
+  /**
+   * Match a request to a route
+   */
+  match(method, path) {
+    const normalizedPath = this.normalizePath(path);
+    const result = this.radix.lookup(normalizedPath);
+    if (!result) {
+      return null;
+    }
+    let handler = result.handlers.get(method);
+    if (!handler) {
+      handler = result.handlers.get("*");
+    }
+    if (!handler) {
+      return null;
+    }
+    const params = result.params || {};
+    return { handler, params };
+  }
+  /**
+   * Get all registered routes
+   */
+  getRoutes() {
+    return [...this.routes];
+  }
+  /**
+   * Normalize path
+   */
+  normalizePath(path) {
+    if (!path.startsWith("/")) {
+      path = "/" + path;
+    }
+    if (path !== "/" && path.endsWith("/")) {
+      path = path.slice(0, -1);
+    }
+    path = path.replace(/\[([^\]]+)\]/g, ":$1");
+    path = path.replace(/\[\.\.\.([\w]+)\]/g, "**");
+    return path;
+  }
+  /**
+   * Extract params from matched path
+   * @deprecated radix3 handles param extraction internally
+   */
+  _extractParams(pattern, actualPath) {
+    const params = {};
+    const patternParts = pattern.split("/");
+    const actualParts = actualPath.split("/");
+    for (let i = 0; i < patternParts.length; i++) {
+      const patternPart = patternParts[i];
+      if (!patternPart) continue;
+      if (patternPart.startsWith(":")) {
+        const paramName = patternPart.slice(1);
+        params[paramName] = actualParts[i] || "";
+      } else if (patternPart === "**") {
+        const paramName = "slug";
+        params[paramName] = actualParts.slice(i).join("/");
+        break;
+      }
+    }
+    return params;
+  }
+};
+
+// src/context.ts
+var ContextImpl = class {
+  // Core properties
+  req;
+  env;
+  params;
+  variables;
+  // Cached values (lazy initialization)
+  _url;
+  _cookies;
+  _variables;
+  constructor(request, params, env) {
+    this.req = request;
+    this.params = params;
+    this.env = env;
+    this._variables = {};
+    this.variables = this._variables;
+  }
+  // ========================================================================
+  // Cached Getters (Lazy initialization)
+  // ========================================================================
+  /**
+   * Get parsed URL (cached after first access)
+   */
+  get url() {
+    return this._url ??= new URL(this.req.url);
+  }
+  /**
+   * Get pathname from cached URL
+   */
+  get pathname() {
+    return this.url.pathname;
+  }
+  /**
+   * Get query string from cached URL
+   */
+  get query() {
+    return this.url.searchParams;
+  }
+  // ========================================================================
+  // Response Helpers (on prototype, not recreated)
+  // ========================================================================
+  json(data, status = 200) {
+    return new Response(JSON.stringify(data), {
+      status,
+      headers: { "Content-Type": "application/json; charset=utf-8" }
+    });
+  }
+  text(text, status = 200) {
+    return new Response(text, {
+      status,
+      headers: { "Content-Type": "text/plain; charset=utf-8" }
+    });
+  }
+  html(html, status = 200) {
+    return new Response(html, {
+      status,
+      headers: { "Content-Type": "text/html; charset=utf-8" }
+    });
+  }
+  redirect(url, status = 302) {
+    return new Response(null, {
+      status,
+      headers: { Location: url }
+    });
+  }
+  // ========================================================================
+  // Variable Getter/Setter
+  // ========================================================================
+  get(key) {
+    return this._variables[key];
+  }
+  set(key, value) {
+    this._variables[key] = value;
+  }
+  // ========================================================================
+  // Request Helpers
+  // ========================================================================
+  header(name) {
+    return this.req.headers.get(name);
+  }
+  /**
+   * Get cookie value (cookies parsed once, cached)
+   */
+  cookie(name) {
+    if (!this._cookies) {
+      const cookieHeader = this.req.headers.get("cookie");
+      this._cookies = cookieHeader ? parseCookies(cookieHeader) : {};
+    }
+    return this._cookies[name];
+  }
+};
+function parseCookies(cookieHeader) {
+  const cookies = {};
+  const pairs = cookieHeader.split(";");
+  for (let i = 0; i < pairs.length; i++) {
+    const pair = pairs[i].trim();
+    const eqIdx = pair.indexOf("=");
+    if (eqIdx > 0) {
+      const name = pair.slice(0, eqIdx);
+      const value = pair.slice(eqIdx + 1);
+      cookies[name] = value;
+    }
+  }
+  return cookies;
+}
+function createContext(request, params = {}, env = {}) {
+  return new ContextImpl(request, params, env);
+}
+
+// src/server.ts
+function compileMiddlewareChain(middlewares, handler) {
+  if (middlewares.length === 0) {
+    return handler;
+  }
+  if (middlewares.length === 1) {
+    const mw = middlewares[0];
+    return (c) => mw(c, () => Promise.resolve(handler(c)));
+  }
+  return (c) => {
+    let index = 0;
+    const dispatch = () => {
+      if (index < middlewares.length) {
+        const middleware = middlewares[index++];
+        return Promise.resolve(middleware(c, dispatch));
+      }
+      return Promise.resolve(handler(c));
+    };
+    return dispatch();
+  };
+}
+var FlightHttp = class _FlightHttp {
+  router;
+  globalMiddleware = [];
+  notFoundHandler;
+  errorHandler;
+  basePath;
+  // Pre-compiled handlers cache (updated when middleware changes)
+  compiledNotFoundHandler;
+  middlewareVersion = 0;
+  lastCompiledVersion = -1;
+  constructor(options = {}) {
+    this.router = new Router();
+    this.basePath = options.basePath || "";
+    this.notFoundHandler = (c) => c.json(
+      { error: "Not Found", path: c.pathname },
+      404
+    );
+    this.errorHandler = (error, c) => c.json(
+      { error: error.message || "Internal Server Error" },
+      500
+    );
+  }
+  // ========================================================================
+  // Route Registration
+  // ========================================================================
+  get(path, ...handlers) {
+    return this.addRoute("GET", path, handlers);
+  }
+  post(path, ...handlers) {
+    return this.addRoute("POST", path, handlers);
+  }
+  put(path, ...handlers) {
+    return this.addRoute("PUT", path, handlers);
+  }
+  delete(path, ...handlers) {
+    return this.addRoute("DELETE", path, handlers);
+  }
+  patch(path, ...handlers) {
+    return this.addRoute("PATCH", path, handlers);
+  }
+  options(path, ...handlers) {
+    return this.addRoute("OPTIONS", path, handlers);
+  }
+  head(path, ...handlers) {
+    return this.addRoute("HEAD", path, handlers);
+  }
+  all(path, ...handlers) {
+    return this.addRoute("*", path, handlers);
+  }
+  // ========================================================================
+  // Middleware
+  // ========================================================================
+  use(...handlers) {
+    this.globalMiddleware.push(...handlers);
+    this.middlewareVersion++;
+    return this;
+  }
+  // ========================================================================
+  // Sub-routing
+  // ========================================================================
+  route(path, router) {
+    if (router instanceof _FlightHttp) {
+      const routes = router.router.getRoutes();
+      for (const route of routes) {
+        const fullPath = this.basePath + path + route.path;
+        this.router.add(route.method, fullPath, route.handler);
+      }
+    }
+    return this;
+  }
+  // ========================================================================
+  // Error Handling
+  // ========================================================================
+  notFound(handler) {
+    this.notFoundHandler = handler;
+    this.compiledNotFoundHandler = void 0;
+    return this;
+  }
+  onError(handler) {
+    this.errorHandler = handler;
+    return this;
+  }
+  // ========================================================================
+  // Core Fetch Handler (Optimized Hot Path)
+  // ========================================================================
+  async fetch(request, options = {}) {
+    const url = request.url;
+    const pathStart = url.indexOf("/", url.indexOf("//") + 2);
+    const queryStart = url.indexOf("?", pathStart);
+    const path = queryStart === -1 ? url.slice(pathStart) : url.slice(pathStart, queryStart);
+    const method = request.method;
+    const match = this.router.match(method, path);
+    const context = createContext(
+      request,
+      match?.params || {},
+      options.env || {}
+    );
+    try {
+      if (match) {
+        if (this.globalMiddleware.length === 0) {
+          return await match.handler(context);
+        } else {
+          const composed = compileMiddlewareChain(
+            this.globalMiddleware,
+            match.handler
+          );
+          return await composed(context);
+        }
+      } else {
+        return await this.getCompiledNotFoundHandler()(context);
+      }
+    } catch (error) {
+      console.error("[Flight HTTP] Error:", error);
+      return await this.errorHandler(
+        error instanceof Error ? error : new Error(String(error)),
+        context
+      );
+    }
+  }
+  // ========================================================================
+  // Listen (Node.js adapter will override this)
+  // ========================================================================
+  listen(options) {
+    const port = typeof options === "number" ? options : options?.port || 3e3;
+    console.log(`[Flight HTTP] Call adapter-specific listen() to start server on port ${port}`);
+    console.log('[Flight HTTP] Import from "@flightdev/http/node" or "@flightdev/http/bun"');
+  }
+  // ========================================================================
+  // Private Methods
+  // ========================================================================
+  addRoute(method, path, handlers) {
+    const mainHandler = handlers[handlers.length - 1];
+    const routeMiddleware = handlers.slice(0, -1);
+    const fullPath = this.basePath + path;
+    const compiledHandler = routeMiddleware.length > 0 ? compileMiddlewareChain(routeMiddleware, mainHandler) : mainHandler;
+    this.router.add(method, fullPath, compiledHandler);
+    return this;
+  }
+  /**
+   * Get pre-compiled not found handler (with global middleware)
+   */
+  getCompiledNotFoundHandler() {
+    if (this.lastCompiledVersion !== this.middlewareVersion || !this.compiledNotFoundHandler) {
+      this.compiledNotFoundHandler = this.globalMiddleware.length > 0 ? compileMiddlewareChain(this.globalMiddleware, this.notFoundHandler) : this.notFoundHandler;
+      this.lastCompiledVersion = this.middlewareVersion;
+    }
+    return this.compiledNotFoundHandler;
+  }
+};
+function createServer(options = {}) {
+  return new FlightHttp(options);
+}
+
+export { FlightHttp, Router, createContext, createServer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map