azurajs 3.0.1 → 3.0.2

package/{dist/chunk-EYAHUNC7.mjs → src/core/server.ts}

@@ -1,699 +1,590 @@
-import { Logger, parseCookies, resolveIp, serializeCookie, clearCookieHeader, parseUrl, parseQueryString, HttpError, parseBody } from './chunk-REJDZUZ5.mjs';
-import { createServer as createServer$1 } from 'http';
-import { createServer } from 'https';
-import { readFileSync } from 'fs';
-
-// src/core/router.ts
-var PARAM_PREFIX = 58;
-function createNode(segment = "") {
-  return {
-    segment,
-    children: /* @__PURE__ */ new Map(),
-    paramChild: null,
-    paramName: "",
-    handlers: /* @__PURE__ */ new Map(),
-    wildcardHandler: null
-  };
-}
-var LRUCache = class {
-  capacity;
-  map;
-  head;
-  tail;
-  constructor(capacity) {
-    this.capacity = capacity;
-    this.map = /* @__PURE__ */ new Map();
-    this.head = { prev: null, next: null };
-    this.tail = { prev: null, next: null };
-    this.head.next = this.tail;
-    this.tail.prev = this.head;
-  }
-  get(key) {
-    const node = this.map.get(key);
-    if (!node) return void 0;
-    this.moveToHead(node);
-    return node.value;
-  }
-  set(key, value) {
-    const existing = this.map.get(key);
-    if (existing) {
-      existing.value = value;
-      this.moveToHead(existing);
-      return;
-    }
-    const node = { value, key, prev: null, next: null };
-    this.map.set(key, node);
-    this.addToHead(node);
-    if (this.map.size > this.capacity) {
-      const removed = this.removeTail();
-      if (removed) this.map.delete(removed.key);
-    }
-  }
-  addToHead(node) {
-    node.prev = this.head;
-    node.next = this.head.next;
-    this.head.next.prev = node;
-    this.head.next = node;
-  }
-  removeNode(node) {
-    node.prev.next = node.next;
-    node.next.prev = node.prev;
-  }
-  moveToHead(node) {
-    this.removeNode(node);
-    this.addToHead(node);
-  }
-  removeTail() {
-    const node = this.tail.prev;
-    if (node === this.head) return null;
-    this.removeNode(node);
-    return node;
-  }
-  clear() {
-    this.map.clear();
-    this.head.next = this.tail;
-    this.tail.prev = this.head;
-  }
-};
-var Router = class {
-  root = createNode();
-  cache;
-  staticRoutes = /* @__PURE__ */ new Map();
-  constructor(cacheSize = 1024) {
-    this.cache = new LRUCache(cacheSize);
-  }
-  add(method, path, handler, middlewares = [], meta) {
-    this.cache.clear();
-    const normalizedPath = this.normalizePath(path);
-    const stored = { handler, middlewares, meta };
-    if (!normalizedPath.includes(":") && !normalizedPath.includes("*")) {
-      const key = `${method}:${normalizedPath}`;
-      this.staticRoutes.set(key, stored);
-      return;
-    }
-    const segments = normalizedPath.split("/").filter(Boolean);
-    let node = this.root;
-    for (let i = 0; i < segments.length; i++) {
-      const seg = segments[i];
-      if (seg === "*") {
-        if (!node.wildcardHandler) {
-          node.wildcardHandler = /* @__PURE__ */ new Map();
-        }
-        node.wildcardHandler.set(method, stored);
-        return;
-      }
-      if (seg.charCodeAt(0) === PARAM_PREFIX) {
-        if (!node.paramChild) {
-          node.paramChild = createNode(seg);
-          node.paramChild.paramName = seg.slice(1);
-        }
-        node = node.paramChild;
-        continue;
-      }
-      let child = node.children.get(seg);
-      if (!child) {
-        child = createNode(seg);
-        node.children.set(seg, child);
-      }
-      node = child;
-    }
-    node.handlers.set(method, stored);
-  }
-  find(method, path) {
-    const normalizedPath = this.normalizePath(path);
-    const staticKey = `${method}:${normalizedPath}`;
-    const staticRoute = this.staticRoutes.get(staticKey);
-    if (staticRoute) {
-      return {
-        handler: staticRoute.handler,
-        params: {},
-        middlewares: staticRoute.middlewares,
-        meta: staticRoute.meta
-      };
-    }
-    const cacheKey = staticKey;
-    const cached = this.cache.get(cacheKey);
-    if (cached !== void 0) {
-      return cached ? { ...cached, params: { ...cached.params } } : null;
-    }
-    const segments = normalizedPath.split("/").filter(Boolean);
-    const params = {};
-    const result = this.matchNode(this.root, segments, 0, params, method);
-    if (result) {
-      const match = {
-        handler: result.handler,
-        params,
-        middlewares: result.middlewares,
-        meta: result.meta
-      };
-      this.cache.set(cacheKey, match);
-      return { ...match, params: { ...params } };
-    }
-    this.cache.set(cacheKey, null);
-    return null;
-  }
-  matchNode(node, segments, idx, params, method) {
-    if (idx === segments.length) {
-      return node.handlers.get(method) ?? null;
-    }
-    const seg = segments[idx];
-    const child = node.children.get(seg);
-    if (child) {
-      const result = this.matchNode(child, segments, idx + 1, params, method);
-      if (result) return result;
-    }
-    if (node.paramChild) {
-      params[node.paramChild.paramName] = seg;
-      const result = this.matchNode(node.paramChild, segments, idx + 1, params, method);
-      if (result) return result;
-      delete params[node.paramChild.paramName];
-    }
-    if (node.wildcardHandler) {
-      const route = node.wildcardHandler.get(method);
-      if (route) return route;
-    }
-    return null;
-  }
-  normalizePath(path) {
-    if (path === "/") return "/";
-    if (path.endsWith("/") && path.length > 1) return path.slice(0, -1);
-    return path;
-  }
-  getAllRoutes() {
-    const routes = [];
-    for (const [key] of this.staticRoutes) {
-      const [method, path] = key.split(":", 2);
-      routes.push({ method, path });
-    }
-    this.collectRoutes(this.root, "", routes);
-    return routes;
-  }
-  collectRoutes(node, prefix, routes) {
-    for (const [method] of node.handlers) {
-      routes.push({ method, path: prefix || "/" });
-    }
-    for (const [seg, child] of node.children) {
-      this.collectRoutes(child, `${prefix}/${seg}`, routes);
-    }
-    if (node.paramChild) {
-      this.collectRoutes(
-        node.paramChild,
-        `${prefix}/:${node.paramChild.paramName}`,
-        routes
-      );
-    }
-    if (node.wildcardHandler) {
-      for (const [method] of node.wildcardHandler) {
-        routes.push({ method, path: `${prefix}/*` });
-      }
-    }
-  }
-};
-var CONTROLLER_META_KEY = "azura:controller";
-var ROUTES_META_KEY = "azura:routes";
-var PARAMS_META_KEY = "azura:params";
-var AzuraServer = class {
-  server = null;
-  router;
-  logger;
-  middlewares = [];
-  plugins = [];
-  errorHandler = null;
-  config;
-  compiledChain = null;
-  constructor(config = {}) {
-    this.config = {
-      environment: config.environment ?? process.env.NODE_ENV ?? "development",
-      server: {
-        port: config.server?.port ?? 3e3,
-        host: config.server?.host ?? "0.0.0.0",
-        keepAliveTimeout: config.server?.keepAliveTimeout ?? 72e3,
-        headersTimeout: config.server?.headersTimeout ?? 75e3,
-        requestTimeout: config.server?.requestTimeout ?? 3e4,
-        ...config.server
-      },
-      logging: {
-        enabled: config.logging?.enabled ?? true,
-        level: config.logging?.level ?? "info",
-        timestamp: config.logging?.timestamp ?? true,
-        colors: config.logging?.colors ?? true,
-        requestLogging: config.logging?.requestLogging ?? true,
-        ...config.logging
-      },
-      plugins: config.plugins ?? {},
-      debug: config.debug ?? false
-    };
-    this.router = new Router();
-    this.logger = new Logger({
-      level: this.config.logging?.enabled === false ? "silent" : this.config.logging?.level,
-      colors: this.config.logging?.colors,
-      timestamp: this.config.logging?.timestamp
-    });
-  }
-  use(handler) {
-    this.compiledChain = null;
-    if (handler.length <= 2) {
-      this.plugins.push(handler);
-    } else {
-      this.middlewares.push(handler);
-    }
-    return this;
-  }
-  plugin(handler) {
-    this.compiledChain = null;
-    this.plugins.push(handler);
-    return this;
-  }
-  onError(handler) {
-    this.errorHandler = handler;
-    return this;
-  }
-  get(path, ...handlers) {
-    return this.route("GET", path, handlers);
-  }
-  post(path, ...handlers) {
-    return this.route("POST", path, handlers);
-  }
-  put(path, ...handlers) {
-    return this.route("PUT", path, handlers);
-  }
-  delete(path, ...handlers) {
-    return this.route("DELETE", path, handlers);
-  }
-  patch(path, ...handlers) {
-    return this.route("PATCH", path, handlers);
-  }
-  head(path, ...handlers) {
-    return this.route("HEAD", path, handlers);
-  }
-  options(path, ...handlers) {
-    return this.route("OPTIONS", path, handlers);
-  }
-  all(path, ...handlers) {
-    const methods = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
-    for (const method of methods) {
-      this.route(method, path, handlers);
-    }
-    return this;
-  }
-  route(method, path, handlers) {
-    const routeHandler = handlers[handlers.length - 1];
-    const middlewares = handlers.slice(0, -1);
-    this.router.add(method, path, routeHandler, middlewares);
-    return this;
-  }
-  register(...controllers) {
-    for (const Controller of controllers) {
-      this.registerController(Controller);
-    }
-    return this;
-  }
-  registerController(Controller) {
-    const instance = new Controller();
-    const prefix = Reflect.getMetadata?.(CONTROLLER_META_KEY, Controller) ?? "";
-    const controllerMiddlewares = Reflect.getMetadata?.("azura:middlewares", Controller) ?? [];
-    const prototype = Controller.prototype;
-    const propertyNames = Object.getOwnPropertyNames(prototype).filter(
-      (p) => p !== "constructor"
-    );
-    for (const propertyKey of propertyNames) {
-      const routeMeta = Reflect.getMetadata?.(
-        ROUTES_META_KEY,
-        prototype,
-        propertyKey
-      );
-      if (!routeMeta) continue;
-      const fullPath = this.joinPaths(prefix, routeMeta.path);
-      const paramsMeta = Reflect.getMetadata?.(PARAMS_META_KEY, prototype, propertyKey) ?? [];
-      const routeMiddlewares = Reflect.getMetadata?.("azura:middlewares", prototype, propertyKey) ?? [];
-      const allMiddlewares = [...controllerMiddlewares, ...routeMiddlewares];
-      const handler = async (req, res) => {
-        const args = this.resolveParams(paramsMeta, req, res);
-        const result = await instance[propertyKey](...args);
-        if (result !== void 0 && !res.sent) {
-          if (typeof result === "object") {
-            res.json(result);
-          } else {
-            res.send(String(result));
-          }
-        }
-      };
-      this.router.add(routeMeta.method, fullPath, handler, allMiddlewares, routeMeta.meta);
-    }
-  }
-  resolveParams(paramsMeta, req, res) {
-    if (!paramsMeta || paramsMeta.length === 0) return [req, res];
-    const sorted = [...paramsMeta].sort((a, b) => a.index - b.index);
-    const args = new Array(sorted.length);
-    for (const meta of sorted) {
-      let value;
-      switch (meta.type) {
-        case "body":
-          value = meta.name ? req.body?.[meta.name] : req.body;
-          break;
-        case "query":
-          value = meta.name ? req.query[meta.name] : req.query;
-          break;
-        case "param":
-          value = meta.name ? req.params[meta.name] : req.params;
-          break;
-        case "header":
-          value = meta.name ? req.headers[meta.name.toLowerCase()] : req.headers;
-          break;
-        case "cookie":
-          value = meta.name ? req.cookies[meta.name] : req.cookies;
-          break;
-        case "req":
-          value = req;
-          break;
-        case "res":
-          value = res;
-          break;
-        case "next":
-          value = () => {
-          };
-          break;
-        case "ip":
-          value = req.ip;
-          break;
-        case "session":
-          value = req.session;
-          break;
-        default:
-          value = void 0;
-      }
-      if (meta.pipes) {
-        for (const pipe of meta.pipes) {
-          value = pipe(value);
-        }
-      }
-      args[meta.index] = value;
-    }
-    return args;
-  }
-  joinPaths(prefix, path) {
-    const p = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
-    const s = path.startsWith("/") ? path : `/${path}`;
-    return `${p}${s}`;
-  }
-  extendRequest(req, pathname, query) {
-    const azReq = req;
-    azReq.pathname = pathname;
-    azReq.query = query;
-    azReq.params = {};
-    azReq.cookies = parseCookies(req.headers.cookie);
-    azReq.ip = resolveIp(req);
-    azReq.protocol = req.socket.encrypted ? "https" : "http";
-    azReq.secure = azReq.protocol === "https";
-    azReq.hostname = (req.headers.host ?? "localhost").split(":")[0];
-    azReq.startTime = process.hrtime.bigint();
-    azReq.raw = req;
-    return azReq;
-  }
-  extendResponse(res) {
-    const azRes = res;
-    azRes.locals = {};
-    azRes.sent = false;
-    azRes.status = function(code) {
-      this.statusCode = code;
-      return this;
-    };
-    azRes.json = function(data) {
-      if (this.sent) return;
-      this.sent = true;
-      const body = JSON.stringify(data);
-      this.setHeader("Content-Type", "application/json; charset=utf-8");
-      this.setHeader("Content-Length", Buffer.byteLength(body));
-      this.end(body);
-    };
-    azRes.send = function(body) {
-      if (this.sent) return;
-      this.sent = true;
-      if (!this.getHeader("Content-Type")) {
-        this.setHeader("Content-Type", typeof body === "string" ? "text/plain; charset=utf-8" : "application/octet-stream");
-      }
-      const buf = typeof body === "string" ? Buffer.from(body) : body;
-      this.setHeader("Content-Length", buf.length);
-      this.end(buf);
-    };
-    azRes.html = function(body) {
-      if (this.sent) return;
-      this.sent = true;
-      this.setHeader("Content-Type", "text/html; charset=utf-8");
-      this.setHeader("Content-Length", Buffer.byteLength(body));
-      this.end(body);
-    };
-    azRes.redirect = function(url, code = 302) {
-      if (this.sent) return;
-      this.sent = true;
-      this.statusCode = code;
-      this.setHeader("Location", url);
-      this.end();
-    };
-    azRes.cookie = function(name, value, options) {
-      const header = serializeCookie(name, value, options);
-      const existing = this.getHeader("Set-Cookie");
-      if (existing) {
-        const arr = Array.isArray(existing) ? existing : [String(existing)];
-        arr.push(header);
-        this.setHeader("Set-Cookie", arr);
-      } else {
-        this.setHeader("Set-Cookie", header);
-      }
-      return this;
-    };
-    azRes.clearCookie = function(name, options) {
-      const header = clearCookieHeader(name, options);
-      const existing = this.getHeader("Set-Cookie");
-      if (existing) {
-        const arr = Array.isArray(existing) ? existing : [String(existing)];
-        arr.push(header);
-        this.setHeader("Set-Cookie", arr);
-      } else {
-        this.setHeader("Set-Cookie", header);
-      }
-      return this;
-    };
-    azRes.header = function(name, value) {
-      this.setHeader(name, value);
-      return this;
-    };
-    azRes.type = function(contentType) {
-      this.setHeader("Content-Type", contentType);
-      return this;
-    };
-    azRes.attachment = function(filename) {
-      if (filename) {
-        this.setHeader("Content-Disposition", `attachment; filename="${filename}"`);
-      } else {
-        this.setHeader("Content-Disposition", "attachment");
-      }
-      return this;
-    };
-    azRes.download = function(_path, _filename) {
-    };
-    return azRes;
-  }
-  compileMiddlewareChain() {
-    if (this.compiledChain) return this.compiledChain;
-    const self = this;
-    const globalMiddlewares = [...this.middlewares];
-    this.compiledChain = async (req, res) => {
-      for (const plugin of self.plugins) {
-        if (res.sent) return;
-        await new Promise((resolve, reject) => {
-          try {
-            const result = plugin({ req, res }, (err) => {
-              if (err) reject(err);
-              else resolve();
-            });
-            if (result && typeof result.then === "function") {
-              result.then(resolve, reject);
-            }
-          } catch (e) {
-            reject(e);
-          }
-        });
-      }
-      if (res.sent) return;
-      let idx = 0;
-      const runMiddleware = async () => {
-        if (idx >= globalMiddlewares.length || res.sent) return;
-        const mw = globalMiddlewares[idx++];
-        await new Promise((resolve, reject) => {
-          try {
-            const result = mw(req, res, (err) => {
-              if (err) reject(err);
-              else resolve();
-            });
-            if (result && typeof result.then === "function") {
-              result.then(resolve, reject);
-            }
-          } catch (e) {
-            reject(e);
-          }
-        });
-        await runMiddleware();
-      };
-      await runMiddleware();
-    };
-    return this.compiledChain;
-  }
-  async handleRequest(req, res) {
-    const { pathname, search } = parseUrl(req.url ?? "/");
-    const query = parseQueryString(search);
-    const azReq = this.extendRequest(req, pathname, query);
-    const azRes = this.extendResponse(res);
-    try {
-      const chain = this.compileMiddlewareChain();
-      await chain(azReq, azRes);
-      if (azRes.sent) return;
-      const method = (req.method ?? "GET").toUpperCase();
-      const match = this.router.find(method, pathname);
-      if (!match) {
-        if (pathname === "/favicon.ico") {
-          azRes.status(204).send("");
-          return;
-        }
-        throw HttpError.notFound(`Route ${method} ${pathname} not found`);
-      }
-      azReq.params = match.params;
-      if (method !== "GET" && method !== "HEAD" && method !== "OPTIONS") {
-        azReq.body = await parseBody(req);
-      }
-      for (const mw of match.middlewares) {
-        if (azRes.sent) return;
-        await new Promise((resolve, reject) => {
-          try {
-            const result2 = mw(azReq, azRes, (err) => {
-              if (err) reject(err);
-              else resolve();
-            });
-            if (result2 && typeof result2.then === "function") {
-              result2.then(resolve, reject);
-            }
-          } catch (e) {
-            reject(e);
-          }
-        });
-      }
-      if (azRes.sent) return;
-      const result = await match.handler(azReq, azRes);
-      if (result !== void 0 && !azRes.sent) {
-        if (typeof result === "object" && result !== null) {
-          azRes.json(result);
-        } else {
-          azRes.send(String(result));
-        }
-      }
-    } catch (err) {
-      this.handleError(err, azReq, azRes);
-    } finally {
-      if (this.config.logging?.requestLogging) {
-        const duration = process.hrtime.bigint() - azReq.startTime;
-        this.logger.request(
-          req.method ?? "GET",
-          pathname,
-          res.statusCode,
-          duration
-        );
-      }
-    }
-  }
-  handleError(err, req, res) {
-    if (res.sent) return;
-    if (this.errorHandler) {
-      try {
-        this.errorHandler(err, req, res, () => {
-        });
-        return;
-      } catch (handlerErr) {
-        this.logger.error("Error handler threw:", handlerErr);
-      }
-    }
-    if (err instanceof HttpError) {
-      res.status(err.statusCode).json(err.toJSON());
-      return;
-    }
-    const statusCode = err?.statusCode ?? err?.status ?? 500;
-    const message = this.config.environment === "production" ? "Internal Server Error" : err?.message ?? "Internal Server Error";
-    this.logger.error(`Unhandled error: ${err?.message ?? err}`);
-    if (this.config.debug && err?.stack) {
-      this.logger.error(err.stack);
-    }
-    res.status(statusCode).json({
-      error: {
-        statusCode,
-        message,
-        ...this.config.debug ? { stack: err?.stack } : {}
-      }
-    });
-  }
-  async listen(port, callback) {
-    const serverPort = port ?? this.config.server?.port ?? 3e3;
-    const host = this.config.server?.host ?? "0.0.0.0";
-    const handler = (req, res) => {
-      this.handleRequest(req, res).catch((err) => {
-        this.logger.error("Fatal request error:", err);
-        if (!res.headersSent) {
-          res.statusCode = 500;
-          res.end('{"error":{"statusCode":500,"message":"Internal Server Error"}}');
-        }
-      });
-    };
-    if (this.config.server?.https) {
-      const httpsConfig = this.config.server.https;
-      this.server = createServer(
-        {
-          key: readFileSync(httpsConfig.key),
-          cert: readFileSync(httpsConfig.cert),
-          ...httpsConfig.ca ? { ca: readFileSync(httpsConfig.ca) } : {}
-        },
-        handler
-      );
-    } else {
-      this.server = createServer$1(handler);
-    }
-    if (this.config.server?.keepAliveTimeout) {
-      this.server.keepAliveTimeout = this.config.server.keepAliveTimeout;
-    }
-    if (this.config.server?.headersTimeout) {
-      this.server.headersTimeout = this.config.server.headersTimeout;
-    }
-    return new Promise((resolve) => {
-      this.server.listen(serverPort, host, () => {
-        this.logger.banner(serverPort, host);
-        callback?.();
-        resolve(this.server);
-      });
-    });
-  }
-  async close() {
-    return new Promise((resolve, reject) => {
-      if (!this.server) {
-        resolve();
-        return;
-      }
-      this.server.close((err) => {
-        if (err) reject(err);
-        else resolve();
-      });
-    });
-  }
-  getRouter() {
-    return this.router;
-  }
-  getLogger() {
-    return this.logger;
-  }
-  getConfig() {
-    return this.config;
-  }
-  getRoutes() {
-    return this.router.getAllRoutes();
-  }
-};
-
-export { AzuraServer, Router };
-//# sourceMappingURL=chunk-EYAHUNC7.mjs.map
-//# sourceMappingURL=chunk-EYAHUNC7.mjs.map
+import { createServer, type Server, type IncomingMessage, type ServerResponse } from "node:http";
+import { createServer as createHttpsServer } from "node:https";
+import { readFileSync } from "node:fs";
+import { Router } from "./router.js";
+import { Logger } from "../utils/Logger.js";
+import { HttpError } from "../utils/HttpError.js";
+import { parseQueryString, parseCookies, parseBody, parseUrl } from "../utils/Parser.js";
+import { resolveIp } from "../utils/IpResolver.js";
+import { serializeCookie, clearCookieHeader } from "../utils/cookies/CookieManager.js";
+import type {
+  AzuraRequest,
+  AzuraResponse,
+  NextFunction,
+  MiddlewareHandler,
+  ErrorHandler,
+  HttpMethod,
+  CookieOptions,
+} from "../types/common.type.js";
+import type { AzuraConfig } from "../types/config.type.js";
+import type { PluginHandler } from "../types/plugins/plugin.type.js";
+import type { ControllerMetadata, RouteMetadata } from "../types/routes.type.js";
+
+const CONTROLLER_META_KEY = "azura:controller";
+const ROUTES_META_KEY = "azura:routes";
+const PARAMS_META_KEY = "azura:params";
+
+export class AzuraServer {
+  private server: Server | null = null;
+  private router: Router;
+  private logger: Logger;
+  private middlewares: MiddlewareHandler[] = [];
+  private plugins: PluginHandler[] = [];
+  private errorHandler: ErrorHandler | null = null;
+  private config: AzuraConfig;
+  private compiledChain: ((req: AzuraRequest, res: AzuraResponse) => Promise<void>) | null = null;
+
+  constructor(config: AzuraConfig = {}) {
+    this.config = {
+      environment: config.environment ?? (process.env.NODE_ENV as any) ?? "development",
+      server: {
+        port: config.server?.port ?? 3000,
+        host: config.server?.host ?? "0.0.0.0",
+        keepAliveTimeout: config.server?.keepAliveTimeout ?? 72000,
+        headersTimeout: config.server?.headersTimeout ?? 75000,
+        requestTimeout: config.server?.requestTimeout ?? 30000,
+        ...config.server,
+      },
+      logging: {
+        enabled: config.logging?.enabled ?? true,
+        level: config.logging?.level ?? "info",
+        timestamp: config.logging?.timestamp ?? true,
+        colors: config.logging?.colors ?? true,
+        requestLogging: config.logging?.requestLogging ?? true,
+        ...config.logging,
+      },
+      plugins: config.plugins ?? {},
+      debug: config.debug ?? false,
+    };
+
+    this.router = new Router();
+    this.logger = new Logger({
+      level: this.config.logging?.enabled === false ? "silent" : this.config.logging?.level,
+      colors: this.config.logging?.colors,
+      timestamp: this.config.logging?.timestamp,
+    });
+  }
+
+  use(handler: MiddlewareHandler | PluginHandler): this {
+    this.compiledChain = null;
+    if (handler.length <= 2) {
+      this.plugins.push(handler as PluginHandler);
+    } else {
+      this.middlewares.push(handler as MiddlewareHandler);
+    }
+    return this;
+  }
+
+  plugin(handler: PluginHandler): this {
+    this.compiledChain = null;
+    this.plugins.push(handler);
+    return this;
+  }
+
+  onError(handler: ErrorHandler): this {
+    this.errorHandler = handler;
+    return this;
+  }
+
+  get(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("GET", path, handlers);
+  }
+
+  post(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("POST", path, handlers);
+  }
+
+  put(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("PUT", path, handlers);
+  }
+
+  delete(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("DELETE", path, handlers);
+  }
+
+  patch(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("PATCH", path, handlers);
+  }
+
+  head(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("HEAD", path, handlers);
+  }
+
+  options(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    return this.route("OPTIONS", path, handlers);
+  }
+
+  all(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+    const methods: HttpMethod[] = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+    for (const method of methods) {
+      this.route(method, path, handlers);
+    }
+    return this;
+  }
+
+  private route(method: HttpMethod, path: string, handlers: (MiddlewareHandler | Function)[]): this {
+    const routeHandler = handlers[handlers.length - 1] as any;
+    const middlewares = handlers.slice(0, -1) as MiddlewareHandler[];
+    this.router.add(method, path, routeHandler, middlewares);
+    return this;
+  }
+
+  register(...controllers: (new (...args: any[]) => any)[]): this {
+    for (const Controller of controllers) {
+      this.registerController(Controller);
+    }
+    return this;
+  }
+
+  private registerController(Controller: new (...args: any[]) => any): void {
+    const instance = new Controller();
+    const prefix: string = Reflect.getMetadata?.(CONTROLLER_META_KEY, Controller) ?? "";
+    const controllerMiddlewares: MiddlewareHandler[] =
+      Reflect.getMetadata?.("azura:middlewares", Controller) ?? [];
+
+    const prototype = Controller.prototype;
+    const propertyNames = Object.getOwnPropertyNames(prototype).filter(
+      (p) => p !== "constructor",
+    );
+
+    for (const propertyKey of propertyNames) {
+      const routeMeta: RouteMetadata | undefined = Reflect.getMetadata?.(
+        ROUTES_META_KEY,
+        prototype,
+        propertyKey,
+      );
+
+      if (!routeMeta) continue;
+
+      const fullPath = this.joinPaths(prefix, routeMeta.path);
+      const paramsMeta = Reflect.getMetadata?.(PARAMS_META_KEY, prototype, propertyKey) ?? [];
+      const routeMiddlewares: MiddlewareHandler[] =
+        Reflect.getMetadata?.("azura:middlewares", prototype, propertyKey) ?? [];
+
+      const allMiddlewares = [...controllerMiddlewares, ...routeMiddlewares];
+
+      const handler = async (req: AzuraRequest, res: AzuraResponse) => {
+        const args = this.resolveParams(paramsMeta, req, res);
+        const result = await instance[propertyKey](...args);
+        if (result !== undefined && !res.sent) {
+          if (typeof result === "object") {
+            res.json(result);
+          } else {
+            res.send(String(result));
+          }
+        }
+      };
+
+      this.router.add(routeMeta.method, fullPath, handler, allMiddlewares, routeMeta.meta);
+    }
+  }
+
+  private resolveParams(paramsMeta: any[], req: AzuraRequest, res: AzuraResponse): any[] {
+    if (!paramsMeta || paramsMeta.length === 0) return [req, res];
+
+    const sorted = [...paramsMeta].sort((a, b) => a.index - b.index);
+    const args: any[] = new Array(sorted.length);
+
+    for (const meta of sorted) {
+      let value: any;
+
+      switch (meta.type) {
+        case "body":
+          value = meta.name ? req.body?.[meta.name] : req.body;
+          break;
+        case "query":
+          value = meta.name ? req.query[meta.name] : req.query;
+          break;
+        case "param":
+          value = meta.name ? req.params[meta.name] : req.params;
+          break;
+        case "header":
+          value = meta.name ? req.headers[meta.name.toLowerCase()] : req.headers;
+          break;
+        case "cookie":
+          value = meta.name ? req.cookies[meta.name] : req.cookies;
+          break;
+        case "req":
+          value = req;
+          break;
+        case "res":
+          value = res;
+          break;
+        case "next":
+          value = () => {};
+          break;
+        case "ip":
+          value = req.ip;
+          break;
+        case "session":
+          value = req.session;
+          break;
+        default:
+          value = undefined;
+      }
+
+      if (meta.pipes) {
+        for (const pipe of meta.pipes) {
+          value = pipe(value);
+        }
+      }
+
+      args[meta.index] = value;
+    }
+
+    return args;
+  }
+
+  private joinPaths(prefix: string, path: string): string {
+    const p = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+    const s = path.startsWith("/") ? path : `/${path}`;
+    return `${p}${s}`;
+  }
+
+  private extendRequest(req: IncomingMessage, pathname: string, query: Record<string, string | string[]>): AzuraRequest {
+    const azReq = req as AzuraRequest;
+    azReq.pathname = pathname;
+    azReq.query = query;
+    azReq.params = {};
+    azReq.cookies = parseCookies(req.headers.cookie);
+    azReq.ip = resolveIp(req);
+    azReq.protocol = (req.socket as any).encrypted ? "https" : "http";
+    azReq.secure = azReq.protocol === "https";
+    azReq.hostname = (req.headers.host ?? "localhost").split(":")[0];
+    azReq.startTime = process.hrtime.bigint();
+    azReq.raw = req;
+    return azReq;
+  }
+
+  private extendResponse(res: ServerResponse): AzuraResponse {
+    const azRes = res as AzuraResponse;
+    azRes.locals = {};
+    azRes.sent = false;
+
+    azRes.status = function (code: number) {
+      this.statusCode = code;
+      return this;
+    };
+
+    azRes.json = function (data: unknown) {
+      if (this.sent) return;
+      this.sent = true;
+      const body = JSON.stringify(data);
+      this.setHeader("Content-Type", "application/json; charset=utf-8");
+      this.setHeader("Content-Length", Buffer.byteLength(body));
+      this.end(body);
+    };
+
+    azRes.send = function (body: string | Buffer) {
+      if (this.sent) return;
+      this.sent = true;
+      if (!this.getHeader("Content-Type")) {
+        this.setHeader("Content-Type", typeof body === "string" ? "text/plain; charset=utf-8" : "application/octet-stream");
+      }
+      const buf = typeof body === "string" ? Buffer.from(body) : body;
+      this.setHeader("Content-Length", buf.length);
+      this.end(buf);
+    };
+
+    azRes.html = function (body: string) {
+      if (this.sent) return;
+      this.sent = true;
+      this.setHeader("Content-Type", "text/html; charset=utf-8");
+      this.setHeader("Content-Length", Buffer.byteLength(body));
+      this.end(body);
+    };
+
+    azRes.redirect = function (url: string, code = 302) {
+      if (this.sent) return;
+      this.sent = true;
+      this.statusCode = code;
+      this.setHeader("Location", url);
+      this.end();
+    };
+
+    azRes.cookie = function (name: string, value: string, options?: CookieOptions) {
+      const header = serializeCookie(name, value, options);
+      const existing = this.getHeader("Set-Cookie");
+      if (existing) {
+        const arr = Array.isArray(existing) ? existing : [String(existing)];
+        arr.push(header);
+        this.setHeader("Set-Cookie", arr);
+      } else {
+        this.setHeader("Set-Cookie", header);
+      }
+      return this;
+    };
+
+    azRes.clearCookie = function (name: string, options?: CookieOptions) {
+      const header = clearCookieHeader(name, options);
+      const existing = this.getHeader("Set-Cookie");
+      if (existing) {
+        const arr = Array.isArray(existing) ? existing : [String(existing)];
+        arr.push(header);
+        this.setHeader("Set-Cookie", arr);
+      } else {
+        this.setHeader("Set-Cookie", header);
+      }
+      return this;
+    };
+
+    azRes.header = function (name: string, value: string | number | string[]) {
+      this.setHeader(name, value as any);
+      return this;
+    };
+
+    azRes.type = function (contentType: string) {
+      this.setHeader("Content-Type", contentType);
+      return this;
+    };
+
+    azRes.attachment = function (filename?: string) {
+      if (filename) {
+        this.setHeader("Content-Disposition", `attachment; filename="${filename}"`);
+      } else {
+        this.setHeader("Content-Disposition", "attachment");
+      }
+      return this;
+    };
+
+    azRes.download = function (_path: string, _filename?: string) {
+      // TODO: implement file streaming
+    };
+
+    return azRes;
+  }
+
+  private compileMiddlewareChain(): (req: AzuraRequest, res: AzuraResponse) => Promise<void> {
+    if (this.compiledChain) return this.compiledChain;
+
+    const self = this;
+    const globalMiddlewares = [...this.middlewares];
+
+    this.compiledChain = async (req: AzuraRequest, res: AzuraResponse) => {
+      for (const plugin of self.plugins) {
+        if (res.sent) return;
+        await new Promise<void>((resolve, reject) => {
+          try {
+            const result = plugin({ req, res }, (err) => {
+              if (err) reject(err);
+              else resolve();
+            });
+            if (result && typeof (result as any).then === "function") {
+              (result as Promise<void>).then(resolve, reject);
+            }
+          } catch (e) {
+            reject(e);
+          }
+        });
+      }
+
+      if (res.sent) return;
+
+      let idx = 0;
+      const runMiddleware = async (): Promise<void> => {
+        if (idx >= globalMiddlewares.length || res.sent) return;
+        const mw = globalMiddlewares[idx++];
+        await new Promise<void>((resolve, reject) => {
+          try {
+            const result = mw(req, res, (err) => {
+              if (err) reject(err);
+              else resolve();
+            });
+            if (result && typeof (result as any).then === "function") {
+              (result as Promise<void>).then(resolve, reject);
+            }
+          } catch (e) {
+            reject(e);
+          }
+        });
+        await runMiddleware();
+      };
+
+      await runMiddleware();
+    };
+
+    return this.compiledChain;
+  }
+
+  private async handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void> {
+    const { pathname, search } = parseUrl(req.url ?? "/");
+    const query = parseQueryString(search);
+
+    const azReq = this.extendRequest(req, pathname, query);
+    const azRes = this.extendResponse(res);
+
+    try {
+      const chain = this.compileMiddlewareChain();
+      await chain(azReq, azRes);
+
+      if (azRes.sent) return;
+
+      const method = (req.method ?? "GET").toUpperCase() as HttpMethod;
+      const match = this.router.find(method, pathname);
+
+      if (!match) {
+        if (pathname === "/favicon.ico") {
+          azRes.status(204).send("");
+          return;
+        }
+        throw HttpError.notFound(`Route ${method} ${pathname} not found`);
+      }
+
+      azReq.params = match.params;
+
+      if (method !== "GET" && method !== "HEAD" && method !== "OPTIONS") {
+        azReq.body = await parseBody(req);
+      }
+
+      for (const mw of match.middlewares) {
+        if (azRes.sent) return;
+        await new Promise<void>((resolve, reject) => {
+          try {
+            const result = mw(azReq, azRes, (err) => {
+              if (err) reject(err);
+              else resolve();
+            });
+            if (result && typeof (result as any).then === "function") {
+              (result as Promise<void>).then(resolve, reject);
+            }
+          } catch (e) {
+            reject(e);
+          }
+        });
+      }
+
+      if (azRes.sent) return;
+
+      const result = await match.handler(azReq, azRes);
+
+      if (result !== undefined && !azRes.sent) {
+        if (typeof result === "object" && result !== null) {
+          azRes.json(result);
+        } else {
+          azRes.send(String(result));
+        }
+      }
+    } catch (err) {
+      this.handleError(err, azReq, azRes);
+    } finally {
+      if (this.config.logging?.requestLogging) {
+        const duration = process.hrtime.bigint() - azReq.startTime;
+        this.logger.request(
+          req.method ?? "GET",
+          pathname,
+          res.statusCode,
+          duration,
+        );
+      }
+    }
+  }
+
+  private handleError(err: any, req: AzuraRequest, res: AzuraResponse): void {
+    if (res.sent) return;
+
+    if (this.errorHandler) {
+      try {
+        this.errorHandler(err, req, res, () => {});
+        return;
+      } catch (handlerErr) {
+        this.logger.error("Error handler threw:", handlerErr);
+      }
+    }
+
+    if (err instanceof HttpError) {
+      res.status(err.statusCode).json(err.toJSON());
+      return;
+    }
+
+    const statusCode = err?.statusCode ?? err?.status ?? 500;
+    const message = this.config.environment === "production"
+      ? "Internal Server Error"
+      : err?.message ?? "Internal Server Error";
+
+    this.logger.error(`Unhandled error: ${err?.message ?? err}`);
+    if (this.config.debug && err?.stack) {
+      this.logger.error(err.stack);
+    }
+
+    res.status(statusCode).json({
+      error: {
+        statusCode,
+        message,
+        ...(this.config.debug ? { stack: err?.stack } : {}),
+      },
+    });
+  }
+
+  async listen(port?: number, callback?: () => void): Promise<Server> {
+    const serverPort = port ?? this.config.server?.port ?? 3000;
+    const host = this.config.server?.host ?? "0.0.0.0";
+
+    const handler = (req: IncomingMessage, res: ServerResponse) => {
+      this.handleRequest(req, res).catch((err) => {
+        this.logger.error("Fatal request error:", err);
+        if (!res.headersSent) {
+          res.statusCode = 500;
+          res.end('{"error":{"statusCode":500,"message":"Internal Server Error"}}');
+        }
+      });
+    };
+
+    if (this.config.server?.https) {
+      const httpsConfig = this.config.server.https;
+      this.server = createHttpsServer(
+        {
+          key: readFileSync(httpsConfig.key),
+          cert: readFileSync(httpsConfig.cert),
+          ...(httpsConfig.ca ? { ca: readFileSync(httpsConfig.ca) } : {}),
+        },
+        handler,
+      );
+    } else {
+      this.server = createServer(handler);
+    }
+
+    if (this.config.server?.keepAliveTimeout) {
+      this.server.keepAliveTimeout = this.config.server.keepAliveTimeout;
+    }
+    if (this.config.server?.headersTimeout) {
+      this.server.headersTimeout = this.config.server.headersTimeout;
+    }
+
+    return new Promise((resolve) => {
+      this.server!.listen(serverPort, host, () => {
+        this.logger.banner(serverPort, host);
+        callback?.();
+        resolve(this.server!);
+      });
+    });
+  }
+
+  async close(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      if (!this.server) {
+        resolve();
+        return;
+      }
+      this.server.close((err) => {
+        if (err) reject(err);
+        else resolve();
+      });
+    });
+  }
+
+  getRouter(): Router {
+    return this.router;
+  }
+
+  getLogger(): Logger {
+    return this.logger;
+  }
+
+  getConfig(): AzuraConfig {
+    return this.config;
+  }
+
+  getRoutes(): Array<{ method: HttpMethod; path: string }> {
+    return this.router.getAllRoutes();
+  }
+}