azurajs 3.0.6 → 3.0.7

package/dist/decorators/index.d.mts

@@ -3,6 +3,11 @@ export { A as ApiOperation, a as ApiTags } from '../decorators-D5nY109r.mjs';
 import 'node:http';
 import '../routes.type-DZO5VBW2.mjs';
 
+/** App com `register` (evita conflitos de overload com tipos duplicados entre subpaths). */
+type AppRegisterable = {
+    register(...controllers: (new (...args: any[]) => any)[]): unknown;
+    listen(...args: any[]): unknown;
+};
 declare function Controller(prefix?: string): ClassDecorator;
 declare const Get: (path?: string) => MethodDecorator;
 declare const Post: (path?: string) => MethodDecorator;
@@ -22,7 +27,15 @@ declare const NextFunc: (name?: string) => ParameterDecorator;
 declare const Ip: (name?: string) => ParameterDecorator;
 declare const Session: (name?: string) => ParameterDecorator;
 declare function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator;
+/** Compõe vários decorators (estilo NestJS). */
+declare function composeDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator;
+/**
+ * Regista controllers na app (paridade com AzuraJS v2).
+ * Aceita `applyDecorators(app, [A, B])` ou `applyDecorators(app, A, B)`.
+ */
+declare function applyDecorators(app: AppRegisterable, controllers: Array<new (...args: any[]) => any>): void;
+declare function applyDecorators(app: AppRegisterable, ...controllers: (new (...args: any[]) => any)[]): void;
 declare function applyDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator;
 declare function Meta(key: string, value: any): MethodDecorator;
 
-export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators };
+export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators, composeDecorators };

package/dist/decorators/index.d.ts

@@ -3,6 +3,11 @@ export { A as ApiOperation, a as ApiTags } from '../decorators-B6l3CbxC.js';
 import 'node:http';
 import '../routes.type-DzHNkCag.js';
 
+/** App com `register` (evita conflitos de overload com tipos duplicados entre subpaths). */
+type AppRegisterable = {
+    register(...controllers: (new (...args: any[]) => any)[]): unknown;
+    listen(...args: any[]): unknown;
+};
 declare function Controller(prefix?: string): ClassDecorator;
 declare const Get: (path?: string) => MethodDecorator;
 declare const Post: (path?: string) => MethodDecorator;
@@ -22,7 +27,15 @@ declare const NextFunc: (name?: string) => ParameterDecorator;
 declare const Ip: (name?: string) => ParameterDecorator;
 declare const Session: (name?: string) => ParameterDecorator;
 declare function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator;
+/** Compõe vários decorators (estilo NestJS). */
+declare function composeDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator;
+/**
+ * Regista controllers na app (paridade com AzuraJS v2).
+ * Aceita `applyDecorators(app, [A, B])` ou `applyDecorators(app, A, B)`.
+ */
+declare function applyDecorators(app: AppRegisterable, controllers: Array<new (...args: any[]) => any>): void;
+declare function applyDecorators(app: AppRegisterable, ...controllers: (new (...args: any[]) => any)[]): void;
 declare function applyDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator;
 declare function Meta(key: string, value: any): MethodDecorator;
 
-export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators };
+export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators, composeDecorators };

package/dist/decorators/index.js

@@ -75,7 +75,10 @@ function UseMiddleware(...middlewares) {
     }
   };
 }
-function applyDecorators(...decorators) {
+function isAzuraServerLike(x) {
+  return typeof x === "object" && x !== null && typeof x.register === "function" && typeof x.listen === "function";
+}
+function composeDecorators(...decorators) {
   return (target, propertyKey, descriptor) => {
     for (const decorator of decorators) {
       if (propertyKey !== void 0) {
@@ -86,6 +89,19 @@ function applyDecorators(...decorators) {
     }
   };
 }
+function applyDecorators(first, ...rest) {
+  if (isAzuraServerLike(first) && rest.length >= 1) {
+    const second = rest[0];
+    if (Array.isArray(second)) {
+      first.register(...second);
+    } else {
+      first.register(...rest);
+    }
+    return;
+  }
+  const decorators = [first, ...rest];
+  return composeDecorators(...decorators);
+}
 function Meta(key, value) {
   return (target, propertyKey, _descriptor) => {
     const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));
@@ -143,5 +159,6 @@ exports.Res = Res;
 exports.Session = Session;
 exports.UseMiddleware = UseMiddleware;
 exports.applyDecorators = applyDecorators;
+exports.composeDecorators = composeDecorators;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/decorators/Route.ts","../../src/swagger/constants.ts","../../src/swagger/decorators.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { HttpMethod, MiddlewareHandler } from \"../types/common.type.js\";\r\nimport type { ParamMetadata, RouteMeta } from \"../types/routes.type.js\";\r\n\r\nconst CONTROLLER_META_KEY = \"azura:controller\";\r\nconst ROUTES_META_KEY = \"azura:routes\";\r\nconst PARAMS_META_KEY = \"azura:params\";\r\nconst MIDDLEWARES_META_KEY = \"azura:middlewares\";\r\n\r\nfunction ensureReflect(): void {\r\n  if (typeof Reflect === \"undefined\" || !Reflect.getMetadata) {\r\n    const store = new Map<string, Map<any, any>>();\r\n    (Reflect as any).defineMetadata = (key: string, value: any, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      if (!store.has(k)) store.set(k, new Map());\r\n      store.get(k)!.set(target, value);\r\n    };\r\n    (Reflect as any).getMetadata = (key: string, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      return store.get(k)?.get(target);\r\n    };\r\n  }\r\n}\r\n\r\nensureReflect();\r\n\r\nexport function Controller(prefix: string = \"\"): ClassDecorator {\r\n  return (target) => {\r\n    Reflect.defineMetadata(CONTROLLER_META_KEY, prefix, target);\r\n  };\r\n}\r\n\r\nfunction createMethodDecorator(method: HttpMethod) {\r\n  return (path: string = \"\"): MethodDecorator => {\r\n    return (target, propertyKey, _descriptor) => {\r\n      Reflect.defineMetadata(\r\n        ROUTES_META_KEY,\r\n        { method, path, propertyKey: String(propertyKey), middlewares: [], params: [], meta: undefined },\r\n        target,\r\n        String(propertyKey),\r\n      );\r\n    };\r\n  };\r\n}\r\n\r\nexport const Get = createMethodDecorator(\"GET\");\r\nexport const Post = createMethodDecorator(\"POST\");\r\nexport const Put = createMethodDecorator(\"PUT\");\r\nexport const Delete = createMethodDecorator(\"DELETE\");\r\nexport const Patch = createMethodDecorator(\"PATCH\");\r\nexport const Head = createMethodDecorator(\"HEAD\");\r\nexport const Options = createMethodDecorator(\"OPTIONS\");\r\n\r\nfunction createParamDecorator(type: ParamMetadata[\"type\"]) {\r\n  return (name?: string): ParameterDecorator => {\r\n    return (target, propertyKey, parameterIndex) => {\r\n      const key = String(propertyKey);\r\n      const existing: ParamMetadata[] = Reflect.getMetadata(PARAMS_META_KEY, target, key) ?? [];\r\n      existing.push({ index: parameterIndex, type, name });\r\n      Reflect.defineMetadata(PARAMS_META_KEY, existing, target, key);\r\n    };\r\n  };\r\n}\r\n\r\nexport const Body = createParamDecorator(\"body\");\r\nexport const Query = createParamDecorator(\"query\");\r\nexport const Param = createParamDecorator(\"param\");\r\nexport const Headers = createParamDecorator(\"header\");\r\nexport const Cookies = createParamDecorator(\"cookie\");\r\nexport const Req = createParamDecorator(\"req\");\r\nexport const Res = createParamDecorator(\"res\");\r\nexport const NextFunc = createParamDecorator(\"next\");\r\nexport const Ip = createParamDecorator(\"ip\");\r\nexport const Session = createParamDecorator(\"session\");\r\n\r\nexport function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, _descriptor?: PropertyDescriptor) => {\r\n    if (propertyKey) {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target, String(propertyKey)) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target, String(propertyKey));\r\n    } else {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target);\r\n    }\r\n  };\r\n}\r\n\r\nexport function applyDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => {\r\n    for (const decorator of decorators) {\r\n      if (propertyKey !== undefined) {\r\n        (decorator as MethodDecorator)(target, propertyKey, descriptor!);\r\n      } else {\r\n        (decorator as ClassDecorator)(target);\r\n      }\r\n    }\r\n  };\r\n}\r\n\r\nexport function Meta(key: string, value: any): MethodDecorator {\r\n  return (target, propertyKey, _descriptor) => {\r\n    const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));\r\n    if (routeMeta) {\r\n      if (!routeMeta.meta) routeMeta.meta = {};\r\n      routeMeta.meta[key] = value;\r\n      Reflect.defineMetadata(ROUTES_META_KEY, routeMeta, target, String(propertyKey));\r\n    }\r\n  };\r\n}\r\n","/** Tags OpenAPI a nível de controller (todas as rotas do class) */\r\nexport const API_TAGS_KEY = \"azura:api-tags\";\r\n\r\n/** Tags por método (independente da ordem em relação a @Get/@Post) */\r\nexport const METHOD_TAGS_KEY = \"azura:swagger-method-tags\";\r\n\r\n/** Metadados OpenAPI por método (summary, responses, etc.) */\r\nexport const API_OPERATION_KEY = \"azura:swagger-operation\";\r\n","import type { RouteMeta } from \"../types/routes.type.js\";\r\nimport { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from \"./constants.js\";\r\n\r\n/**\r\n * Tags OpenAPI no controller (todas as rotas) ou num método específico.\r\n * Compatível com `experimentalDecorators` (assinatura legacy de 3 argumentos em métodos).\r\n */\r\nexport function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey?: string | symbol,\r\n    _descriptor?: PropertyDescriptor,\r\n  ): void {\r\n    if (propertyKey === undefined) {\r\n      Reflect.defineMetadata(API_TAGS_KEY, tags, target);\r\n    } else {\r\n      Reflect.defineMetadata(METHOD_TAGS_KEY, tags, target, String(propertyKey));\r\n    }\r\n  } as ClassDecorator & MethodDecorator;\r\n}\r\n\r\n/**\r\n * Metadados OpenAPI (summary, description, responses, parameters, etc.).\r\n */\r\nexport function ApiOperation(meta: Partial<RouteMeta>): MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey: string | symbol,\r\n    _descriptor: PropertyDescriptor,\r\n  ): void {\r\n    const key = String(propertyKey);\r\n    const cur = (Reflect.getMetadata?.(API_OPERATION_KEY, target, key) ?? {}) as Partial<RouteMeta>;\r\n    Reflect.defineMetadata(API_OPERATION_KEY, { ...cur, ...meta }, target, key);\r\n  };\r\n}\r\n"]}
+{"version":3,"sources":["../../src/decorators/Route.ts","../../src/swagger/constants.ts","../../src/swagger/decorators.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { HttpMethod, MiddlewareHandler } from \"../types/common.type.js\";\r\nimport type { ParamMetadata, RouteMeta } from \"../types/routes.type.js\";\r\n\r\n/** App com `register` (evita conflitos de overload com tipos duplicados entre subpaths). */\r\ntype AppRegisterable = {\r\n  register(...controllers: (new (...args: any[]) => any)[]): unknown;\r\n  listen(...args: any[]): unknown;\r\n};\r\n\r\nconst CONTROLLER_META_KEY = \"azura:controller\";\r\nconst ROUTES_META_KEY = \"azura:routes\";\r\nconst PARAMS_META_KEY = \"azura:params\";\r\nconst MIDDLEWARES_META_KEY = \"azura:middlewares\";\r\n\r\nfunction ensureReflect(): void {\r\n  if (typeof Reflect === \"undefined\" || !Reflect.getMetadata) {\r\n    const store = new Map<string, Map<any, any>>();\r\n    (Reflect as any).defineMetadata = (key: string, value: any, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      if (!store.has(k)) store.set(k, new Map());\r\n      store.get(k)!.set(target, value);\r\n    };\r\n    (Reflect as any).getMetadata = (key: string, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      return store.get(k)?.get(target);\r\n    };\r\n  }\r\n}\r\n\r\nensureReflect();\r\n\r\nexport function Controller(prefix: string = \"\"): ClassDecorator {\r\n  return (target) => {\r\n    Reflect.defineMetadata(CONTROLLER_META_KEY, prefix, target);\r\n  };\r\n}\r\n\r\nfunction createMethodDecorator(method: HttpMethod) {\r\n  return (path: string = \"\"): MethodDecorator => {\r\n    return (target, propertyKey, _descriptor) => {\r\n      Reflect.defineMetadata(\r\n        ROUTES_META_KEY,\r\n        { method, path, propertyKey: String(propertyKey), middlewares: [], params: [], meta: undefined },\r\n        target,\r\n        String(propertyKey),\r\n      );\r\n    };\r\n  };\r\n}\r\n\r\nexport const Get = createMethodDecorator(\"GET\");\r\nexport const Post = createMethodDecorator(\"POST\");\r\nexport const Put = createMethodDecorator(\"PUT\");\r\nexport const Delete = createMethodDecorator(\"DELETE\");\r\nexport const Patch = createMethodDecorator(\"PATCH\");\r\nexport const Head = createMethodDecorator(\"HEAD\");\r\nexport const Options = createMethodDecorator(\"OPTIONS\");\r\n\r\nfunction createParamDecorator(type: ParamMetadata[\"type\"]) {\r\n  return (name?: string): ParameterDecorator => {\r\n    return (target, propertyKey, parameterIndex) => {\r\n      const key = String(propertyKey);\r\n      const existing: ParamMetadata[] = Reflect.getMetadata(PARAMS_META_KEY, target, key) ?? [];\r\n      existing.push({ index: parameterIndex, type, name });\r\n      Reflect.defineMetadata(PARAMS_META_KEY, existing, target, key);\r\n    };\r\n  };\r\n}\r\n\r\nexport const Body = createParamDecorator(\"body\");\r\nexport const Query = createParamDecorator(\"query\");\r\nexport const Param = createParamDecorator(\"param\");\r\nexport const Headers = createParamDecorator(\"header\");\r\nexport const Cookies = createParamDecorator(\"cookie\");\r\nexport const Req = createParamDecorator(\"req\");\r\nexport const Res = createParamDecorator(\"res\");\r\nexport const NextFunc = createParamDecorator(\"next\");\r\nexport const Ip = createParamDecorator(\"ip\");\r\nexport const Session = createParamDecorator(\"session\");\r\n\r\nexport function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, _descriptor?: PropertyDescriptor) => {\r\n    if (propertyKey) {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target, String(propertyKey)) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target, String(propertyKey));\r\n    } else {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target);\r\n    }\r\n  };\r\n}\r\n\r\nfunction isAzuraServerLike(x: unknown): x is AppRegisterable {\r\n  return (\r\n    typeof x === \"object\" &&\r\n    x !== null &&\r\n    typeof (x as AppRegisterable).register === \"function\" &&\r\n    typeof (x as AppRegisterable).listen === \"function\"\r\n  );\r\n}\r\n\r\n/** Compõe vários decorators (estilo NestJS). */\r\nexport function composeDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => {\r\n    for (const decorator of decorators) {\r\n      if (propertyKey !== undefined) {\r\n        (decorator as MethodDecorator)(target, propertyKey, descriptor!);\r\n      } else {\r\n        (decorator as ClassDecorator)(target);\r\n      }\r\n    }\r\n  };\r\n}\r\n\r\n/**\r\n * Regista controllers na app (paridade com AzuraJS v2).\r\n * Aceita `applyDecorators(app, [A, B])` ou `applyDecorators(app, A, B)`.\r\n */\r\nexport function applyDecorators(\r\n  app: AppRegisterable,\r\n  controllers: Array<new (...args: any[]) => any>,\r\n): void;\r\nexport function applyDecorators(\r\n  app: AppRegisterable,\r\n  ...controllers: (new (...args: any[]) => any)[]\r\n): void;\r\nexport function applyDecorators(\r\n  ...decorators: (MethodDecorator | ClassDecorator)[]\r\n): MethodDecorator & ClassDecorator;\r\nexport function applyDecorators(\r\n  first: AppRegisterable | MethodDecorator | ClassDecorator,\r\n  ...rest: unknown[]\r\n): void | (MethodDecorator & ClassDecorator) {\r\n  if (isAzuraServerLike(first) && rest.length >= 1) {\r\n    const second = rest[0];\r\n    if (Array.isArray(second)) {\r\n      first.register(...(second as (new (...args: any[]) => any)[]));\r\n    } else {\r\n      first.register(...(rest as (new (...args: any[]) => any)[]));\r\n    }\r\n    return;\r\n  }\r\n  const decorators = [first, ...rest] as (MethodDecorator | ClassDecorator)[];\r\n  return composeDecorators(...decorators);\r\n}\r\n\r\nexport function Meta(key: string, value: any): MethodDecorator {\r\n  return (target, propertyKey, _descriptor) => {\r\n    const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));\r\n    if (routeMeta) {\r\n      if (!routeMeta.meta) routeMeta.meta = {};\r\n      routeMeta.meta[key] = value;\r\n      Reflect.defineMetadata(ROUTES_META_KEY, routeMeta, target, String(propertyKey));\r\n    }\r\n  };\r\n}\r\n","/** Tags OpenAPI a nível de controller (todas as rotas do class) */\r\nexport const API_TAGS_KEY = \"azura:api-tags\";\r\n\r\n/** Tags por método (independente da ordem em relação a @Get/@Post) */\r\nexport const METHOD_TAGS_KEY = \"azura:swagger-method-tags\";\r\n\r\n/** Metadados OpenAPI por método (summary, responses, etc.) */\r\nexport const API_OPERATION_KEY = \"azura:swagger-operation\";\r\n","import type { RouteMeta } from \"../types/routes.type.js\";\r\nimport { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from \"./constants.js\";\r\n\r\n/**\r\n * Tags OpenAPI no controller (todas as rotas) ou num método específico.\r\n * Compatível com `experimentalDecorators` (assinatura legacy de 3 argumentos em métodos).\r\n */\r\nexport function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey?: string | symbol,\r\n    _descriptor?: PropertyDescriptor,\r\n  ): void {\r\n    if (propertyKey === undefined) {\r\n      Reflect.defineMetadata(API_TAGS_KEY, tags, target);\r\n    } else {\r\n      Reflect.defineMetadata(METHOD_TAGS_KEY, tags, target, String(propertyKey));\r\n    }\r\n  } as ClassDecorator & MethodDecorator;\r\n}\r\n\r\n/**\r\n * Metadados OpenAPI (summary, description, responses, parameters, etc.).\r\n */\r\nexport function ApiOperation(meta: Partial<RouteMeta>): MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey: string | symbol,\r\n    _descriptor: PropertyDescriptor,\r\n  ): void {\r\n    const key = String(propertyKey);\r\n    const cur = (Reflect.getMetadata?.(API_OPERATION_KEY, target, key) ?? {}) as Partial<RouteMeta>;\r\n    Reflect.defineMetadata(API_OPERATION_KEY, { ...cur, ...meta }, target, key);\r\n  };\r\n}\r\n"]}

package/dist/decorators/index.mjs

@@ -73,7 +73,10 @@ function UseMiddleware(...middlewares) {
     }
   };
 }
-function applyDecorators(...decorators) {
+function isAzuraServerLike(x) {
+  return typeof x === "object" && x !== null && typeof x.register === "function" && typeof x.listen === "function";
+}
+function composeDecorators(...decorators) {
   return (target, propertyKey, descriptor) => {
     for (const decorator of decorators) {
       if (propertyKey !== void 0) {
@@ -84,6 +87,19 @@ function applyDecorators(...decorators) {
     }
   };
 }
+function applyDecorators(first, ...rest) {
+  if (isAzuraServerLike(first) && rest.length >= 1) {
+    const second = rest[0];
+    if (Array.isArray(second)) {
+      first.register(...second);
+    } else {
+      first.register(...rest);
+    }
+    return;
+  }
+  const decorators = [first, ...rest];
+  return composeDecorators(...decorators);
+}
 function Meta(key, value) {
   return (target, propertyKey, _descriptor) => {
     const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));
@@ -118,6 +134,6 @@ function ApiOperation(meta) {
   };
 }
 
-export { ApiOperation, ApiTags, Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators };
+export { ApiOperation, ApiTags, Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators, composeDecorators };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/decorators/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/decorators/Route.ts","../../src/swagger/constants.ts","../../src/swagger/decorators.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { HttpMethod, MiddlewareHandler } from \"../types/common.type.js\";\r\nimport type { ParamMetadata, RouteMeta } from \"../types/routes.type.js\";\r\n\r\nconst CONTROLLER_META_KEY = \"azura:controller\";\r\nconst ROUTES_META_KEY = \"azura:routes\";\r\nconst PARAMS_META_KEY = \"azura:params\";\r\nconst MIDDLEWARES_META_KEY = \"azura:middlewares\";\r\n\r\nfunction ensureReflect(): void {\r\n  if (typeof Reflect === \"undefined\" || !Reflect.getMetadata) {\r\n    const store = new Map<string, Map<any, any>>();\r\n    (Reflect as any).defineMetadata = (key: string, value: any, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      if (!store.has(k)) store.set(k, new Map());\r\n      store.get(k)!.set(target, value);\r\n    };\r\n    (Reflect as any).getMetadata = (key: string, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      return store.get(k)?.get(target);\r\n    };\r\n  }\r\n}\r\n\r\nensureReflect();\r\n\r\nexport function Controller(prefix: string = \"\"): ClassDecorator {\r\n  return (target) => {\r\n    Reflect.defineMetadata(CONTROLLER_META_KEY, prefix, target);\r\n  };\r\n}\r\n\r\nfunction createMethodDecorator(method: HttpMethod) {\r\n  return (path: string = \"\"): MethodDecorator => {\r\n    return (target, propertyKey, _descriptor) => {\r\n      Reflect.defineMetadata(\r\n        ROUTES_META_KEY,\r\n        { method, path, propertyKey: String(propertyKey), middlewares: [], params: [], meta: undefined },\r\n        target,\r\n        String(propertyKey),\r\n      );\r\n    };\r\n  };\r\n}\r\n\r\nexport const Get = createMethodDecorator(\"GET\");\r\nexport const Post = createMethodDecorator(\"POST\");\r\nexport const Put = createMethodDecorator(\"PUT\");\r\nexport const Delete = createMethodDecorator(\"DELETE\");\r\nexport const Patch = createMethodDecorator(\"PATCH\");\r\nexport const Head = createMethodDecorator(\"HEAD\");\r\nexport const Options = createMethodDecorator(\"OPTIONS\");\r\n\r\nfunction createParamDecorator(type: ParamMetadata[\"type\"]) {\r\n  return (name?: string): ParameterDecorator => {\r\n    return (target, propertyKey, parameterIndex) => {\r\n      const key = String(propertyKey);\r\n      const existing: ParamMetadata[] = Reflect.getMetadata(PARAMS_META_KEY, target, key) ?? [];\r\n      existing.push({ index: parameterIndex, type, name });\r\n      Reflect.defineMetadata(PARAMS_META_KEY, existing, target, key);\r\n    };\r\n  };\r\n}\r\n\r\nexport const Body = createParamDecorator(\"body\");\r\nexport const Query = createParamDecorator(\"query\");\r\nexport const Param = createParamDecorator(\"param\");\r\nexport const Headers = createParamDecorator(\"header\");\r\nexport const Cookies = createParamDecorator(\"cookie\");\r\nexport const Req = createParamDecorator(\"req\");\r\nexport const Res = createParamDecorator(\"res\");\r\nexport const NextFunc = createParamDecorator(\"next\");\r\nexport const Ip = createParamDecorator(\"ip\");\r\nexport const Session = createParamDecorator(\"session\");\r\n\r\nexport function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, _descriptor?: PropertyDescriptor) => {\r\n    if (propertyKey) {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target, String(propertyKey)) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target, String(propertyKey));\r\n    } else {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target);\r\n    }\r\n  };\r\n}\r\n\r\nexport function applyDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => {\r\n    for (const decorator of decorators) {\r\n      if (propertyKey !== undefined) {\r\n        (decorator as MethodDecorator)(target, propertyKey, descriptor!);\r\n      } else {\r\n        (decorator as ClassDecorator)(target);\r\n      }\r\n    }\r\n  };\r\n}\r\n\r\nexport function Meta(key: string, value: any): MethodDecorator {\r\n  return (target, propertyKey, _descriptor) => {\r\n    const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));\r\n    if (routeMeta) {\r\n      if (!routeMeta.meta) routeMeta.meta = {};\r\n      routeMeta.meta[key] = value;\r\n      Reflect.defineMetadata(ROUTES_META_KEY, routeMeta, target, String(propertyKey));\r\n    }\r\n  };\r\n}\r\n","/** Tags OpenAPI a nível de controller (todas as rotas do class) */\r\nexport const API_TAGS_KEY = \"azura:api-tags\";\r\n\r\n/** Tags por método (independente da ordem em relação a @Get/@Post) */\r\nexport const METHOD_TAGS_KEY = \"azura:swagger-method-tags\";\r\n\r\n/** Metadados OpenAPI por método (summary, responses, etc.) */\r\nexport const API_OPERATION_KEY = \"azura:swagger-operation\";\r\n","import type { RouteMeta } from \"../types/routes.type.js\";\r\nimport { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from \"./constants.js\";\r\n\r\n/**\r\n * Tags OpenAPI no controller (todas as rotas) ou num método específico.\r\n * Compatível com `experimentalDecorators` (assinatura legacy de 3 argumentos em métodos).\r\n */\r\nexport function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey?: string | symbol,\r\n    _descriptor?: PropertyDescriptor,\r\n  ): void {\r\n    if (propertyKey === undefined) {\r\n      Reflect.defineMetadata(API_TAGS_KEY, tags, target);\r\n    } else {\r\n      Reflect.defineMetadata(METHOD_TAGS_KEY, tags, target, String(propertyKey));\r\n    }\r\n  } as ClassDecorator & MethodDecorator;\r\n}\r\n\r\n/**\r\n * Metadados OpenAPI (summary, description, responses, parameters, etc.).\r\n */\r\nexport function ApiOperation(meta: Partial<RouteMeta>): MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey: string | symbol,\r\n    _descriptor: PropertyDescriptor,\r\n  ): void {\r\n    const key = String(propertyKey);\r\n    const cur = (Reflect.getMetadata?.(API_OPERATION_KEY, target, key) ?? {}) as Partial<RouteMeta>;\r\n    Reflect.defineMetadata(API_OPERATION_KEY, { ...cur, ...meta }, target, key);\r\n  };\r\n}\r\n"]}
+{"version":3,"sources":["../../src/decorators/Route.ts","../../src/swagger/constants.ts","../../src/swagger/decorators.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { HttpMethod, MiddlewareHandler } from \"../types/common.type.js\";\r\nimport type { ParamMetadata, RouteMeta } from \"../types/routes.type.js\";\r\n\r\n/** App com `register` (evita conflitos de overload com tipos duplicados entre subpaths). */\r\ntype AppRegisterable = {\r\n  register(...controllers: (new (...args: any[]) => any)[]): unknown;\r\n  listen(...args: any[]): unknown;\r\n};\r\n\r\nconst CONTROLLER_META_KEY = \"azura:controller\";\r\nconst ROUTES_META_KEY = \"azura:routes\";\r\nconst PARAMS_META_KEY = \"azura:params\";\r\nconst MIDDLEWARES_META_KEY = \"azura:middlewares\";\r\n\r\nfunction ensureReflect(): void {\r\n  if (typeof Reflect === \"undefined\" || !Reflect.getMetadata) {\r\n    const store = new Map<string, Map<any, any>>();\r\n    (Reflect as any).defineMetadata = (key: string, value: any, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      if (!store.has(k)) store.set(k, new Map());\r\n      store.get(k)!.set(target, value);\r\n    };\r\n    (Reflect as any).getMetadata = (key: string, target: any, prop?: string) => {\r\n      const k = prop ? `${key}::${prop}` : key;\r\n      return store.get(k)?.get(target);\r\n    };\r\n  }\r\n}\r\n\r\nensureReflect();\r\n\r\nexport function Controller(prefix: string = \"\"): ClassDecorator {\r\n  return (target) => {\r\n    Reflect.defineMetadata(CONTROLLER_META_KEY, prefix, target);\r\n  };\r\n}\r\n\r\nfunction createMethodDecorator(method: HttpMethod) {\r\n  return (path: string = \"\"): MethodDecorator => {\r\n    return (target, propertyKey, _descriptor) => {\r\n      Reflect.defineMetadata(\r\n        ROUTES_META_KEY,\r\n        { method, path, propertyKey: String(propertyKey), middlewares: [], params: [], meta: undefined },\r\n        target,\r\n        String(propertyKey),\r\n      );\r\n    };\r\n  };\r\n}\r\n\r\nexport const Get = createMethodDecorator(\"GET\");\r\nexport const Post = createMethodDecorator(\"POST\");\r\nexport const Put = createMethodDecorator(\"PUT\");\r\nexport const Delete = createMethodDecorator(\"DELETE\");\r\nexport const Patch = createMethodDecorator(\"PATCH\");\r\nexport const Head = createMethodDecorator(\"HEAD\");\r\nexport const Options = createMethodDecorator(\"OPTIONS\");\r\n\r\nfunction createParamDecorator(type: ParamMetadata[\"type\"]) {\r\n  return (name?: string): ParameterDecorator => {\r\n    return (target, propertyKey, parameterIndex) => {\r\n      const key = String(propertyKey);\r\n      const existing: ParamMetadata[] = Reflect.getMetadata(PARAMS_META_KEY, target, key) ?? [];\r\n      existing.push({ index: parameterIndex, type, name });\r\n      Reflect.defineMetadata(PARAMS_META_KEY, existing, target, key);\r\n    };\r\n  };\r\n}\r\n\r\nexport const Body = createParamDecorator(\"body\");\r\nexport const Query = createParamDecorator(\"query\");\r\nexport const Param = createParamDecorator(\"param\");\r\nexport const Headers = createParamDecorator(\"header\");\r\nexport const Cookies = createParamDecorator(\"cookie\");\r\nexport const Req = createParamDecorator(\"req\");\r\nexport const Res = createParamDecorator(\"res\");\r\nexport const NextFunc = createParamDecorator(\"next\");\r\nexport const Ip = createParamDecorator(\"ip\");\r\nexport const Session = createParamDecorator(\"session\");\r\n\r\nexport function UseMiddleware(...middlewares: MiddlewareHandler[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, _descriptor?: PropertyDescriptor) => {\r\n    if (propertyKey) {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target, String(propertyKey)) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target, String(propertyKey));\r\n    } else {\r\n      const existing: MiddlewareHandler[] =\r\n        Reflect.getMetadata(MIDDLEWARES_META_KEY, target) ?? [];\r\n      Reflect.defineMetadata(MIDDLEWARES_META_KEY, [...existing, ...middlewares], target);\r\n    }\r\n  };\r\n}\r\n\r\nfunction isAzuraServerLike(x: unknown): x is AppRegisterable {\r\n  return (\r\n    typeof x === \"object\" &&\r\n    x !== null &&\r\n    typeof (x as AppRegisterable).register === \"function\" &&\r\n    typeof (x as AppRegisterable).listen === \"function\"\r\n  );\r\n}\r\n\r\n/** Compõe vários decorators (estilo NestJS). */\r\nexport function composeDecorators(...decorators: (MethodDecorator | ClassDecorator)[]): MethodDecorator & ClassDecorator {\r\n  return (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => {\r\n    for (const decorator of decorators) {\r\n      if (propertyKey !== undefined) {\r\n        (decorator as MethodDecorator)(target, propertyKey, descriptor!);\r\n      } else {\r\n        (decorator as ClassDecorator)(target);\r\n      }\r\n    }\r\n  };\r\n}\r\n\r\n/**\r\n * Regista controllers na app (paridade com AzuraJS v2).\r\n * Aceita `applyDecorators(app, [A, B])` ou `applyDecorators(app, A, B)`.\r\n */\r\nexport function applyDecorators(\r\n  app: AppRegisterable,\r\n  controllers: Array<new (...args: any[]) => any>,\r\n): void;\r\nexport function applyDecorators(\r\n  app: AppRegisterable,\r\n  ...controllers: (new (...args: any[]) => any)[]\r\n): void;\r\nexport function applyDecorators(\r\n  ...decorators: (MethodDecorator | ClassDecorator)[]\r\n): MethodDecorator & ClassDecorator;\r\nexport function applyDecorators(\r\n  first: AppRegisterable | MethodDecorator | ClassDecorator,\r\n  ...rest: unknown[]\r\n): void | (MethodDecorator & ClassDecorator) {\r\n  if (isAzuraServerLike(first) && rest.length >= 1) {\r\n    const second = rest[0];\r\n    if (Array.isArray(second)) {\r\n      first.register(...(second as (new (...args: any[]) => any)[]));\r\n    } else {\r\n      first.register(...(rest as (new (...args: any[]) => any)[]));\r\n    }\r\n    return;\r\n  }\r\n  const decorators = [first, ...rest] as (MethodDecorator | ClassDecorator)[];\r\n  return composeDecorators(...decorators);\r\n}\r\n\r\nexport function Meta(key: string, value: any): MethodDecorator {\r\n  return (target, propertyKey, _descriptor) => {\r\n    const routeMeta = Reflect.getMetadata(ROUTES_META_KEY, target, String(propertyKey));\r\n    if (routeMeta) {\r\n      if (!routeMeta.meta) routeMeta.meta = {};\r\n      routeMeta.meta[key] = value;\r\n      Reflect.defineMetadata(ROUTES_META_KEY, routeMeta, target, String(propertyKey));\r\n    }\r\n  };\r\n}\r\n","/** Tags OpenAPI a nível de controller (todas as rotas do class) */\r\nexport const API_TAGS_KEY = \"azura:api-tags\";\r\n\r\n/** Tags por método (independente da ordem em relação a @Get/@Post) */\r\nexport const METHOD_TAGS_KEY = \"azura:swagger-method-tags\";\r\n\r\n/** Metadados OpenAPI por método (summary, responses, etc.) */\r\nexport const API_OPERATION_KEY = \"azura:swagger-operation\";\r\n","import type { RouteMeta } from \"../types/routes.type.js\";\r\nimport { API_OPERATION_KEY, API_TAGS_KEY, METHOD_TAGS_KEY } from \"./constants.js\";\r\n\r\n/**\r\n * Tags OpenAPI no controller (todas as rotas) ou num método específico.\r\n * Compatível com `experimentalDecorators` (assinatura legacy de 3 argumentos em métodos).\r\n */\r\nexport function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey?: string | symbol,\r\n    _descriptor?: PropertyDescriptor,\r\n  ): void {\r\n    if (propertyKey === undefined) {\r\n      Reflect.defineMetadata(API_TAGS_KEY, tags, target);\r\n    } else {\r\n      Reflect.defineMetadata(METHOD_TAGS_KEY, tags, target, String(propertyKey));\r\n    }\r\n  } as ClassDecorator & MethodDecorator;\r\n}\r\n\r\n/**\r\n * Metadados OpenAPI (summary, description, responses, parameters, etc.).\r\n */\r\nexport function ApiOperation(meta: Partial<RouteMeta>): MethodDecorator {\r\n  return function (\r\n    target: object,\r\n    propertyKey: string | symbol,\r\n    _descriptor: PropertyDescriptor,\r\n  ): void {\r\n    const key = String(propertyKey);\r\n    const cur = (Reflect.getMetadata?.(API_OPERATION_KEY, target, key) ?? {}) as Partial<RouteMeta>;\r\n    Reflect.defineMetadata(API_OPERATION_KEY, { ...cur, ...meta }, target, key);\r\n  };\r\n}\r\n"]}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 export { AzuraServer } from './core/index.mjs';
 export { R as Router } from './index-j6QGMhZU.mjs';
-export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators } from './decorators/index.mjs';
+export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators, composeDecorators } from './decorators/index.mjs';
 export { A as ApiOperation, a as ApiTags } from './decorators-D5nY109r.mjs';
 export { CORSPlugin } from './cors/index.mjs';
 export { RateLimitPlugin } from './rate-limit/index.mjs';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AzuraServer } from './core/index.js';
 export { R as Router } from './index-tpPZS_UK.js';
-export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators } from './decorators/index.js';
+export { Body, Controller, Cookies, Delete, Get, Head, Headers, Ip, Meta, NextFunc, Options, Param, Patch, Post, Put, Query, Req, Res, Session, UseMiddleware, applyDecorators, composeDecorators } from './decorators/index.js';
 export { A as ApiOperation, a as ApiTags } from './decorators-B6l3CbxC.js';
 export { CORSPlugin } from './cors/index.js';
 export { RateLimitPlugin } from './rate-limit/index.js';

package/dist/index.js

@@ -1402,7 +1402,10 @@ function UseMiddleware(...middlewares) {
     }
   };
 }
-function applyDecorators(...decorators) {
+function isAzuraServerLike(x) {
+  return typeof x === "object" && x !== null && typeof x.register === "function" && typeof x.listen === "function";
+}
+function composeDecorators(...decorators) {
   return (target, propertyKey, descriptor) => {
     for (const decorator of decorators) {
       if (propertyKey !== void 0) {
@@ -1413,6 +1416,19 @@ function applyDecorators(...decorators) {
     }
   };
 }
+function applyDecorators(first, ...rest) {
+  if (isAzuraServerLike(first) && rest.length >= 1) {
+    const second = rest[0];
+    if (Array.isArray(second)) {
+      first.register(...second);
+    } else {
+      first.register(...rest);
+    }
+    return;
+  }
+  const decorators = [first, ...rest];
+  return composeDecorators(...decorators);
+}
 function Meta(key, value) {
   return (target, propertyKey, _descriptor) => {
     const routeMeta = Reflect.getMetadata(ROUTES_META_KEY2, target, String(propertyKey));
@@ -4578,6 +4594,7 @@ exports.UseMiddleware = UseMiddleware;
 exports.ValidationError = ValidationError;
 exports.applyDecorators = applyDecorators;
 exports.clearCookieHeader = clearCookieHeader;
+exports.composeDecorators = composeDecorators;
 exports.parseBody = parseBody;
 exports.parseCookies = parseCookies;
 exports.parseQueryString = parseQueryString;