azurajs 3.0.2 → 3.0.4

package/dist/validators/index.mjs

@@ -0,0 +1,141 @@
+// src/utils/validators/DTOValidator.ts
+var DTOValidator = class {
+  static validate(data, schema) {
+    const errors = [];
+    if (data == null || typeof data !== "object") {
+      return {
+        valid: false,
+        errors: [{ field: "_root", message: "Request body must be an object" }]
+      };
+    }
+    for (const [field, rule] of Object.entries(schema)) {
+      const value = data[field];
+      if (rule.required && (value === void 0 || value === null || value === "")) {
+        errors.push({
+          field,
+          message: rule.message ?? `${field} is required`,
+          value
+        });
+        continue;
+      }
+      if (value === void 0 || value === null) continue;
+      if (rule.type) {
+        const actualType = Array.isArray(value) ? "array" : typeof value;
+        if (actualType !== rule.type) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must be of type ${rule.type}`,
+            value
+          });
+          continue;
+        }
+      }
+      if (rule.type === "string" || typeof value === "string") {
+        if (rule.min !== void 0 && value.length < rule.min) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must be at least ${rule.min} characters`,
+            value
+          });
+        }
+        if (rule.max !== void 0 && value.length > rule.max) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must be at most ${rule.max} characters`,
+            value
+          });
+        }
+        if (rule.pattern && !rule.pattern.test(value)) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} has invalid format`,
+            value
+          });
+        }
+      }
+      if (rule.type === "number" || typeof value === "number") {
+        if (rule.min !== void 0 && value < rule.min) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must be at least ${rule.min}`,
+            value
+          });
+        }
+        if (rule.max !== void 0 && value > rule.max) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must be at most ${rule.max}`,
+            value
+          });
+        }
+      }
+      if (rule.type === "array" && Array.isArray(value)) {
+        if (rule.min !== void 0 && value.length < rule.min) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must have at least ${rule.min} items`,
+            value
+          });
+        }
+        if (rule.max !== void 0 && value.length > rule.max) {
+          errors.push({
+            field,
+            message: rule.message ?? `${field} must have at most ${rule.max} items`,
+            value
+          });
+        }
+      }
+      if (rule.enum && !rule.enum.includes(value)) {
+        errors.push({
+          field,
+          message: rule.message ?? `${field} must be one of: ${rule.enum.join(", ")}`,
+          value
+        });
+      }
+      if (rule.custom) {
+        const customError = rule.custom(value);
+        if (customError) {
+          errors.push({ field, message: customError, value });
+        }
+      }
+    }
+    return {
+      valid: errors.length === 0,
+      errors,
+      data: errors.length === 0 ? data : void 0
+    };
+  }
+};
+
+// src/utils/validators/SchemaValidator.ts
+var SchemaValidator = class {
+  static validate(data, schema) {
+    if (typeof schema.safeParse === "function") {
+      const result = schema.safeParse(data);
+      if (result.success) {
+        return { valid: true, data: result.data };
+      }
+      return { valid: false, errors: result.error };
+    }
+    if (typeof schema.parse === "function") {
+      try {
+        const parsed = schema.parse(data);
+        return { valid: true, data: parsed };
+      } catch (err) {
+        return { valid: false, errors: err };
+      }
+    }
+    if (typeof schema.validate === "function") {
+      const result = schema.validate(data);
+      if (result.error) {
+        return { valid: false, errors: result.error };
+      }
+      return { valid: true, data: result.value };
+    }
+    return { valid: true, data };
+  }
+};
+
+export { DTOValidator, SchemaValidator };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/validators/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/validators/DTOValidator.ts","../../src/utils/validators/SchemaValidator.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export interface ValidationError {\r\n  field: string;\r\n  message: string;\r\n  value?: any;\r\n}\r\n\r\nexport interface ValidationResult {\r\n  valid: boolean;\r\n  errors: ValidationError[];\r\n  data?: any;\r\n}\r\n\r\ntype RuleType = \"string\" | \"number\" | \"boolean\" | \"object\" | \"array\";\r\n\r\ninterface FieldRule {\r\n  type?: RuleType;\r\n  required?: boolean;\r\n  min?: number;\r\n  max?: number;\r\n  pattern?: RegExp;\r\n  enum?: any[];\r\n  custom?: (value: any) => string | null;\r\n  message?: string;\r\n}\r\n\r\nexport type Schema = Record<string, FieldRule>;\r\n\r\nexport class DTOValidator {\r\n  static validate(data: any, schema: Schema): ValidationResult {\r\n    const errors: ValidationError[] = [];\r\n\r\n    if (data == null || typeof data !== \"object\") {\r\n      return {\r\n        valid: false,\r\n        errors: [{ field: \"_root\", message: \"Request body must be an object\" }],\r\n      };\r\n    }\r\n\r\n    for (const [field, rule] of Object.entries(schema)) {\r\n      const value = data[field];\r\n\r\n      if (rule.required && (value === undefined || value === null || value === \"\")) {\r\n        errors.push({\r\n          field,\r\n          message: rule.message ?? `${field} is required`,\r\n          value,\r\n        });\r\n        continue;\r\n      }\r\n\r\n      if (value === undefined || value === null) continue;\r\n\r\n      if (rule.type) {\r\n        const actualType = Array.isArray(value) ? \"array\" : typeof value;\r\n        if (actualType !== rule.type) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must be of type ${rule.type}`,\r\n            value,\r\n          });\r\n          continue;\r\n        }\r\n      }\r\n\r\n      if (rule.type === \"string\" || typeof value === \"string\") {\r\n        if (rule.min !== undefined && value.length < rule.min) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must be at least ${rule.min} characters`,\r\n            value,\r\n          });\r\n        }\r\n        if (rule.max !== undefined && value.length > rule.max) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must be at most ${rule.max} characters`,\r\n            value,\r\n          });\r\n        }\r\n        if (rule.pattern && !rule.pattern.test(value)) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} has invalid format`,\r\n            value,\r\n          });\r\n        }\r\n      }\r\n\r\n      if (rule.type === \"number\" || typeof value === \"number\") {\r\n        if (rule.min !== undefined && value < rule.min) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must be at least ${rule.min}`,\r\n            value,\r\n          });\r\n        }\r\n        if (rule.max !== undefined && value > rule.max) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must be at most ${rule.max}`,\r\n            value,\r\n          });\r\n        }\r\n      }\r\n\r\n      if (rule.type === \"array\" && Array.isArray(value)) {\r\n        if (rule.min !== undefined && value.length < rule.min) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must have at least ${rule.min} items`,\r\n            value,\r\n          });\r\n        }\r\n        if (rule.max !== undefined && value.length > rule.max) {\r\n          errors.push({\r\n            field,\r\n            message: rule.message ?? `${field} must have at most ${rule.max} items`,\r\n            value,\r\n          });\r\n        }\r\n      }\r\n\r\n      if (rule.enum && !rule.enum.includes(value)) {\r\n        errors.push({\r\n          field,\r\n          message: rule.message ?? `${field} must be one of: ${rule.enum.join(\", \")}`,\r\n          value,\r\n        });\r\n      }\r\n\r\n      if (rule.custom) {\r\n        const customError = rule.custom(value);\r\n        if (customError) {\r\n          errors.push({ field, message: customError, value });\r\n        }\r\n      }\r\n    }\r\n\r\n    return {\r\n      valid: errors.length === 0,\r\n      errors,\r\n      data: errors.length === 0 ? data : undefined,\r\n    };\r\n  }\r\n}\r\n","export interface ExternalSchema {\r\n  parse?: (data: any) => any;\r\n  safeParse?: (data: any) => { success: boolean; data?: any; error?: any };\r\n  validate?: (data: any) => { value?: any; error?: any };\r\n}\r\n\r\nexport interface SchemaValidationResult {\r\n  valid: boolean;\r\n  data?: any;\r\n  errors?: any;\r\n}\r\n\r\nexport class SchemaValidator {\r\n  static validate(data: any, schema: ExternalSchema): SchemaValidationResult {\r\n    // Zod-style schema\r\n    if (typeof schema.safeParse === \"function\") {\r\n      const result = schema.safeParse(data);\r\n      if (result.success) {\r\n        return { valid: true, data: result.data };\r\n      }\r\n      return { valid: false, errors: result.error };\r\n    }\r\n\r\n    // Zod parse (throws on error)\r\n    if (typeof schema.parse === \"function\") {\r\n      try {\r\n        const parsed = schema.parse(data);\r\n        return { valid: true, data: parsed };\r\n      } catch (err) {\r\n        return { valid: false, errors: err };\r\n      }\r\n    }\r\n\r\n    // Joi-style schema\r\n    if (typeof schema.validate === \"function\") {\r\n      const result = schema.validate(data);\r\n      if (result.error) {\r\n        return { valid: false, errors: result.error };\r\n      }\r\n      return { valid: true, data: result.value };\r\n    }\r\n\r\n    return { valid: true, data };\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azurajs",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "Ultra-fast TypeScript-first web framework for Node.js and Bun with decorator-based routing, zero dependencies, and built-in plugin system",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -70,6 +70,79 @@
       "require": "./dist/middleware/index.js",
       "default": "./dist/middleware/index.mjs"
     },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "bun": "./dist/logger/index.mjs",
+      "import": "./dist/logger/index.mjs",
+      "module": "./dist/logger/index.mjs",
+      "require": "./dist/logger/index.js",
+      "default": "./dist/logger/index.mjs"
+    },
+    "./validators": {
+      "types": "./dist/validators/index.d.ts",
+      "bun": "./dist/validators/index.mjs",
+      "import": "./dist/validators/index.mjs",
+      "module": "./dist/validators/index.mjs",
+      "require": "./dist/validators/index.js",
+      "default": "./dist/validators/index.mjs"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "bun": "./dist/router/index.mjs",
+      "import": "./dist/router/index.mjs",
+      "module": "./dist/router/index.mjs",
+      "require": "./dist/router/index.js",
+      "default": "./dist/router/index.mjs"
+    },
+    "./cookies": {
+      "types": "./dist/cookies/index.d.ts",
+      "bun": "./dist/cookies/index.mjs",
+      "import": "./dist/cookies/index.mjs",
+      "module": "./dist/cookies/index.mjs",
+      "require": "./dist/cookies/index.js",
+      "default": "./dist/cookies/index.mjs"
+    },
+    "./http-error": {
+      "types": "./dist/http-error/index.d.ts",
+      "bun": "./dist/http-error/index.mjs",
+      "import": "./dist/http-error/index.mjs",
+      "module": "./dist/http-error/index.mjs",
+      "require": "./dist/http-error/index.js",
+      "default": "./dist/http-error/index.mjs"
+    },
+    "./cors": {
+      "types": "./dist/cors/index.d.ts",
+      "bun": "./dist/cors/index.mjs",
+      "import": "./dist/cors/index.mjs",
+      "module": "./dist/cors/index.mjs",
+      "require": "./dist/cors/index.js",
+      "default": "./dist/cors/index.mjs"
+    },
+    "./rate-limit": {
+      "types": "./dist/rate-limit/index.d.ts",
+      "bun": "./dist/rate-limit/index.mjs",
+      "import": "./dist/rate-limit/index.mjs",
+      "module": "./dist/rate-limit/index.mjs",
+      "require": "./dist/rate-limit/index.js",
+      "default": "./dist/rate-limit/index.mjs"
+    },
+    "./infra": {
+      "types": "./dist/infra/index.d.ts",
+      "bun": "./dist/infra/index.mjs",
+      "import": "./dist/infra/index.mjs",
+      "module": "./dist/infra/index.mjs",
+      "require": "./dist/infra/index.js",
+      "default": "./dist/infra/index.mjs"
+    },
+    "./swagger": {
+      "types": "./dist/swagger/index.d.ts",
+      "bun": "./dist/swagger/index.mjs",
+      "import": "./dist/swagger/index.mjs",
+      "module": "./dist/swagger/index.mjs",
+      "require": "./dist/swagger/index.js",
+      "default": "./dist/swagger/index.mjs"
+    },
+    "./swagger-ui": "./dist/swagger/swagger-ui-modern.html",
     "./package.json": "./package.json"
   },
   "typesVersions": {
@@ -80,7 +153,16 @@
       "types": ["./dist/types/index.d.ts"],
       "utils": ["./dist/utils/index.d.ts"],
       "config": ["./dist/config/index.d.ts"],
-      "middleware": ["./dist/middleware/index.d.ts"]
+      "middleware": ["./dist/middleware/index.d.ts"],
+      "logger": ["./dist/logger/index.d.ts"],
+      "validators": ["./dist/validators/index.d.ts"],
+      "router": ["./dist/router/index.d.ts"],
+      "cookies": ["./dist/cookies/index.d.ts"],
+      "http-error": ["./dist/http-error/index.d.ts"],
+      "cors": ["./dist/cors/index.d.ts"],
+      "rate-limit": ["./dist/rate-limit/index.d.ts"],
+      "infra": ["./dist/infra/index.d.ts"],
+      "swagger": ["./dist/swagger/index.d.ts"]
     }
   },
   "files": [
@@ -90,6 +172,8 @@
     "LICENSE"
   ],
   "scripts": {
+    "generate:swagger-ui": "node scripts/embed-swagger-ui.mjs",
+    "prebuild": "node scripts/embed-swagger-ui.mjs",
     "build": "tsup",
     "build:check": "tsc --noEmit",
     "dev": "tsup --watch",

package/src/cookies/index.ts

@@ -0,0 +1 @@
+export { serializeCookie, clearCookieHeader } from "../utils/cookies/CookieManager.js";

package/src/core/index.ts

@@ -1,2 +1,3 @@
 export { AzuraServer } from "./server.js";
 export { Router } from "./router.js";
+export type { RouteDocument } from "./router.js";

package/src/core/router.ts

@@ -1,4 +1,12 @@
 import type { HttpMethod, RouteHandler, MiddlewareHandler, RouteMatch } from "../types/common.type.js";
+import type { RouteMeta } from "../types/routes.type.js";
+
+/** Rota registada com metadados opcionais (OpenAPI / documentação). */
+export interface RouteDocument {
+  method: HttpMethod;
+  path: string;
+  meta?: RouteMeta;
+}
 
 const PARAM_PREFIX = 58; // ':'
 
@@ -243,32 +251,35 @@ export class Router {
   }
 
   getAllRoutes(): Array<{ method: HttpMethod; path: string }> {
-    const routes: Array<{ method: HttpMethod; path: string }> = [];
+    return this.getRouteDocuments().map(({ method, path }) => ({ method, path }));
+  }
 
-    for (const [key] of this.staticRoutes) {
+  /**
+   * Todas as rotas com metadados (ex.: OpenAPI) associados ao handler.
+   */
+  getRouteDocuments(): RouteDocument[] {
+    const routes: RouteDocument[] = [];
+
+    for (const [key, stored] of this.staticRoutes) {
       const [method, path] = key.split(":", 2) as [HttpMethod, string];
-      routes.push({ method, path });
+      routes.push({ method, path, meta: stored.meta });
     }
 
-    this.collectRoutes(this.root, "", routes);
+    this.collectRoutesWithMeta(this.root, "", routes);
     return routes;
   }
 
-  private collectRoutes(
-    node: RadixNode,
-    prefix: string,
-    routes: Array<{ method: HttpMethod; path: string }>,
-  ): void {
-    for (const [method] of node.handlers) {
-      routes.push({ method, path: prefix || "/" });
+  private collectRoutesWithMeta(node: RadixNode, prefix: string, routes: RouteDocument[]): void {
+    for (const [method, stored] of node.handlers) {
+      routes.push({ method, path: prefix || "/", meta: stored.meta });
     }
 
     for (const [seg, child] of node.children) {
-      this.collectRoutes(child, `${prefix}/${seg}`, routes);
+      this.collectRoutesWithMeta(child, `${prefix}/${seg}`, routes);
     }
 
     if (node.paramChild) {
-      this.collectRoutes(
+      this.collectRoutesWithMeta(
         node.paramChild,
         `${prefix}/:${node.paramChild.paramName}`,
         routes,
@@ -276,8 +287,8 @@ export class Router {
     }
 
     if (node.wildcardHandler) {
-      for (const [method] of node.wildcardHandler) {
-        routes.push({ method, path: `${prefix}/*` });
+      for (const [method, stored] of node.wildcardHandler) {
+        routes.push({ method, path: `${prefix}/*`, meta: stored.meta });
       }
     }
   }

package/src/core/server.ts

@@ -18,7 +18,26 @@ import type {
 } 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";
+import type { ControllerMetadata, RouteMeta, RouteMetadata } from "../types/routes.type.js";
+import type { BuildOpenApiOptions } from "../types/swagger.type.js";
+import { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from "../swagger/constants.js";
+import { buildOpenApiDocument } from "../swagger/openapi-builder.js";
+
+function isRouteDocumentMeta(o: unknown): o is RouteMeta {
+  if (!o || typeof o !== "object" || Array.isArray(o)) return false;
+  const x = o as Record<string, unknown>;
+  return (
+    "summary" in x ||
+    "description" in x ||
+    "tags" in x ||
+    "deprecated" in x ||
+    "parameters" in x ||
+    "responses" in x ||
+    "security" in x ||
+    "produces" in x ||
+    "consumes" in x
+  );
+}
 
 const CONTROLLER_META_KEY = "azura:controller";
 const ROUTES_META_KEY = "azura:routes";
@@ -86,35 +105,35 @@ export class AzuraServer {
     return this;
   }
 
-  get(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  get(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("GET", path, handlers);
   }
 
-  post(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  post(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("POST", path, handlers);
   }
 
-  put(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  put(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("PUT", path, handlers);
   }
 
-  delete(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  delete(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("DELETE", path, handlers);
   }
 
-  patch(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  patch(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("PATCH", path, handlers);
   }
 
-  head(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  head(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("HEAD", path, handlers);
   }
 
-  options(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  options(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     return this.route("OPTIONS", path, handlers);
   }
 
-  all(path: string, ...handlers: (MiddlewareHandler | Function)[]): this {
+  all(path: string, ...handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
     const methods: HttpMethod[] = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
     for (const method of methods) {
       this.route(method, path, handlers);
@@ -122,10 +141,20 @@ export class AzuraServer {
     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);
+  private route(method: HttpMethod, path: string, handlers: (MiddlewareHandler | Function | RouteMeta)[]): this {
+    let meta: RouteMeta | undefined;
+    let list = handlers as unknown[];
+    const last = list[list.length - 1];
+    if (list.length >= 2 && isRouteDocumentMeta(last)) {
+      meta = last;
+      list = list.slice(0, -1);
+    }
+    if (list.length === 0) {
+      throw new Error(`Route ${method} ${path} requires a handler function`);
+    }
+    const routeHandler = list[list.length - 1] as any;
+    const middlewares = list.slice(0, -1) as MiddlewareHandler[];
+    this.router.add(method, path, routeHandler, middlewares, meta);
     return this;
   }
 
@@ -141,6 +170,7 @@ export class AzuraServer {
     const prefix: string = Reflect.getMetadata?.(CONTROLLER_META_KEY, Controller) ?? "";
     const controllerMiddlewares: MiddlewareHandler[] =
       Reflect.getMetadata?.("azura:middlewares", Controller) ?? [];
+    const controllerTags: string[] = Reflect.getMetadata?.(API_TAGS_KEY, Controller) ?? [];
 
     const prototype = Controller.prototype;
     const propertyNames = Object.getOwnPropertyNames(prototype).filter(
@@ -163,6 +193,16 @@ export class AzuraServer {
 
       const allMiddlewares = [...controllerMiddlewares, ...routeMiddlewares];
 
+      const methodTags: string[] = Reflect.getMetadata?.(METHOD_TAGS_KEY, prototype, propertyKey) ?? [];
+      const opExtra = (Reflect.getMetadata?.(API_OPERATION_KEY, prototype, propertyKey) ??
+        {}) as Partial<RouteMeta>;
+      const tagList = [...controllerTags, ...methodTags, ...(routeMeta.meta?.tags ?? [])];
+      const mergedMeta: RouteMeta | undefined = (() => {
+        const m = { ...routeMeta.meta, ...opExtra } as RouteMeta;
+        if (tagList.length) m.tags = tagList;
+        return Object.keys(m).length ? m : undefined;
+      })();
+
       const handler = async (req: AzuraRequest, res: AzuraResponse) => {
         const args = this.resolveParams(paramsMeta, req, res);
         const result = await instance[propertyKey](...args);
@@ -175,7 +215,7 @@ export class AzuraServer {
         }
       };
 
-      this.router.add(routeMeta.method, fullPath, handler, allMiddlewares, routeMeta.meta);
+      this.router.add(routeMeta.method, fullPath, handler, allMiddlewares, mergedMeta);
     }
   }
 
@@ -587,4 +627,14 @@ export class AzuraServer {
   getRoutes(): Array<{ method: HttpMethod; path: string }> {
     return this.router.getAllRoutes();
   }
+
+  /** Rotas com metadados OpenAPI (para Swagger ou export manual). */
+  getRouteDocuments() {
+    return this.router.getRouteDocuments();
+  }
+
+  /** Gera documento OpenAPI 3.0 a partir das rotas registadas. */
+  getOpenApiDocument(options: BuildOpenApiOptions = {}) {
+    return buildOpenApiDocument(this.getRouteDocuments(), options);
+  }
 }

package/src/cors/index.ts

@@ -0,0 +1,2 @@
+export { CORSPlugin } from "../plugins/CORSPlugin.js";
+export type { CORSOptions } from "../types/plugins/plugin.type.js";

package/src/decorators/index.ts

@@ -21,3 +21,5 @@ export {
   applyDecorators,
   Meta,
 } from "./Route.js";
+
+export { ApiTags, ApiOperation } from "../swagger/decorators.js";

package/src/http-error/index.ts

@@ -0,0 +1 @@
+export { HttpError } from "../utils/HttpError.js";

package/src/infra/index.ts

@@ -0,0 +1,3 @@
+/** Utilitários de infraestrutura (compatível com o subpath `azurajs/infra` da v2). */
+export { ConfigModule } from "../config/ConfigModule.js";
+export { resolveIp } from "../utils/IpResolver.js";

package/src/logger/index.ts

@@ -0,0 +1 @@
+export { Logger, logger } from "../utils/Logger.js";

package/src/plugins/SwaggerPlugin.ts

@@ -0,0 +1,45 @@
+import type { PluginHandler } from "../types/plugins/plugin.type.js";
+import type { SwaggerPluginOptions } from "../types/swagger.type.js";
+import { buildOpenApiDocument } from "../swagger/openapi-builder.js";
+import { renderSwaggerUiPage } from "../swagger/swagger-ui-html.js";
+
+export function SwaggerPlugin(options: SwaggerPluginOptions): PluginHandler {
+  const {
+    getDocuments,
+    specPath = "/openapi.json",
+    docsPath = "/docs",
+    deepLinking = true,
+    servers,
+    pathPrefix,
+    info,
+  } = options;
+
+  const title = info?.title ?? "API";
+
+  return async (ctx, next) => {
+    const { req, res } = ctx;
+    const path = req.pathname ?? "";
+
+    if (path === specPath || path === `${specPath}/`) {
+      const doc = buildOpenApiDocument(getDocuments(), {
+        info: info ?? { title, version: "1.0.0" },
+        servers,
+        pathPrefix,
+      });
+      res.json(doc);
+      return;
+    }
+
+    if (path === docsPath || path === `${docsPath}/`) {
+      const html = renderSwaggerUiPage({
+        title,
+        specUrl: specPath,
+        deepLinking,
+      });
+      res.html(html);
+      return;
+    }
+
+    next();
+  };
+}

package/src/plugins/index.ts

@@ -16,3 +16,4 @@ export type { SSEClient } from "./SSEPlugin.js";
 export { ProxyPlugin } from "./ProxyPlugin.js";
 export { MultipartPlugin } from "./MultipartPlugin.js";
 export type { UploadedFile } from "./MultipartPlugin.js";
+export { SwaggerPlugin } from "./SwaggerPlugin.js";

package/src/rate-limit/index.ts

@@ -0,0 +1,2 @@
+export { RateLimitPlugin } from "../plugins/RateLimitPlugin.js";
+export type { RateLimitOptions } from "../types/plugins/plugin.type.js";

package/src/router/index.ts

@@ -0,0 +1 @@
+export { Router } from "../core/router.js";

package/src/swagger/constants.ts

@@ -0,0 +1,8 @@
+/** Tags OpenAPI a nível de controller (todas as rotas do class) */
+export const API_TAGS_KEY = "azura:api-tags";
+
+/** Tags por método (independente da ordem em relação a @Get/@Post) */
+export const METHOD_TAGS_KEY = "azura:swagger-method-tags";
+
+/** Metadados OpenAPI por método (summary, responses, etc.) */
+export const API_OPERATION_KEY = "azura:swagger-operation";

package/src/swagger/decorators.ts

@@ -0,0 +1,35 @@
+import type { RouteMeta } from "../types/routes.type.js";
+import { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from "./constants.js";
+
+/**
+ * Tags OpenAPI no controller (todas as rotas) ou num método específico.
+ * Compatível com `experimentalDecorators` (assinatura legacy de 3 argumentos em métodos).
+ */
+export function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator {
+  return function (
+    target: object,
+    propertyKey?: string | symbol,
+    _descriptor?: PropertyDescriptor,
+  ): void {
+    if (propertyKey === undefined) {
+      Reflect.defineMetadata(API_TAGS_KEY, tags, target);
+    } else {
+      Reflect.defineMetadata(METHOD_TAGS_KEY, tags, target, String(propertyKey));
+    }
+  } as ClassDecorator & MethodDecorator;
+}
+
+/**
+ * Metadados OpenAPI (summary, description, responses, parameters, etc.).
+ */
+export function ApiOperation(meta: Partial<RouteMeta>): MethodDecorator {
+  return function (
+    target: object,
+    propertyKey: string | symbol,
+    _descriptor: PropertyDescriptor,
+  ): void {
+    const key = String(propertyKey);
+    const cur = (Reflect.getMetadata?.(API_OPERATION_KEY, target, key) ?? {}) as Partial<RouteMeta>;
+    Reflect.defineMetadata(API_OPERATION_KEY, { ...cur, ...meta }, target, key);
+  };
+}

package/src/swagger/index.ts

@@ -0,0 +1,10 @@
+/** OpenAPI 3 + UI Swagger (tema escuro minimalista, alinhado ao site AzuraJS). */
+export { buildOpenApiDocument, toOpenApiPath } from "./openapi-builder.js";
+export { SwaggerPlugin } from "../plugins/SwaggerPlugin.js";
+export { renderSwaggerUiPage } from "./swagger-ui-html.js";
+export { ApiTags, ApiOperation } from "./decorators.js";
+export {
+  API_TAGS_KEY,
+  METHOD_TAGS_KEY,
+  API_OPERATION_KEY,
+} from "./constants.js";