framework-do-dede 6.2.3 → 6.3.0

package/README.md

@@ -317,6 +317,26 @@ const app = await Dede.create({
 Com `framework.tracer: true`, todos os controllers/metodos passam a usar tracer por padrao.
 `@Tracing(new MeuTracer())` ainda sobrescreve por controller/metodo.
 
+Para ignorar tracing em um controller/rota especifica quando o tracing global estiver ligado, use `@NoTracing()`:
+
+```ts
+import { NoTracing } from './src';
+
+@NoTracing()
+@Controller('/health')
+class HealthController {
+  @Get('/ping')
+  async ping() { return { ok: true }; }
+}
+
+@Controller('/users')
+class UserController {
+  @NoTracing()
+  @Get('/public')
+  async publicRoute() { return { ok: true }; }
+}
+```
+
 ### UseCase e Decorators
 
 UseCase provê `data` e `context` do request.

package/dist/application/controller.d.ts

@@ -35,6 +35,7 @@ export interface Input<T, K = any> {
 type BodyFilter = "restrict" | "none";
 export declare function Controller(basePath?: string): (target: any) => void;
 export declare function Tracing<R>(tracer?: Tracer<R>): (target: any, propertyKey?: string) => void;
+export declare function NoTracing(): (target: any, propertyKey?: string) => void;
 export declare function Version(version: number): (target: any, propertyKey?: string) => void;
 export declare function PresetIgnore(ignorePrefix?: boolean, ignoreVersion?: boolean): (target: any, propertyKey?: string) => void;
 export declare function UseMiddleware(middlewareClass: MiddlewareDefinition): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/application/controller.js

@@ -22,6 +22,16 @@ export function Tracing(tracer) {
         }
     };
 }
+export function NoTracing() {
+    return function (target, propertyKey) {
+        if (!propertyKey) {
+            Reflect.defineMetadata('noTracing', true, target);
+        }
+        else {
+            Reflect.defineMetadata('noTracing', true, target, propertyKey);
+        }
+    };
+}
 export function Version(version) {
     return function (target, propertyKey) {
         if (!Number.isInteger(version) || version <= 0) {

package/dist/application/index.d.ts

@@ -1,8 +1,8 @@
-import { Controller, Post, Get, Put, Delete, Patch, UseMiddleware, UseMiddlewares, Tracing, Version, PresetIgnore, type Middleware, type Input, type Tracer, type TracerData } from './controller';
+import { Controller, Post, Get, Put, Delete, Patch, UseMiddleware, UseMiddlewares, Tracing, NoTracing, Version, PresetIgnore, type Middleware, type Input, type Tracer, type TracerData } from './controller';
 import { Entity, Restrict, VirtualProperty, GetterPrefix, Transform } from '../infra/serialization/entity';
 import { Model, column } from '../infra/model/model';
 import { DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter } from './usecase';
-export { Controller, UseMiddleware, UseMiddlewares, Post, Get, Put, Delete, Patch, Tracing, Version, PresetIgnore, DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter, Entity, Restrict, VirtualProperty, GetterPrefix, Transform, Model, column, };
+export { Controller, UseMiddleware, UseMiddlewares, Post, Get, Put, Delete, Patch, Tracing, NoTracing, Version, PresetIgnore, DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter, Entity, Restrict, VirtualProperty, GetterPrefix, Transform, Model, column, };
 export { Storage, CacheGateway, EventDispatcher } from './services';
 export type { Middleware, Input, Tracer, TracerData };
 export type { StorageGateway } from './services';

package/dist/application/index.js

@@ -1,6 +1,6 @@
-import { Controller, Post, Get, Put, Delete, Patch, UseMiddleware, UseMiddlewares, Tracing, Version, PresetIgnore } from './controller';
+import { Controller, Post, Get, Put, Delete, Patch, UseMiddleware, UseMiddlewares, Tracing, NoTracing, Version, PresetIgnore } from './controller';
 import { Entity, Restrict, VirtualProperty, GetterPrefix, Transform } from '../infra/serialization/entity';
 import { Model, column } from '../infra/model/model';
 import { DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter, } from './usecase';
-export { Controller, UseMiddleware, UseMiddlewares, Post, Get, Put, Delete, Patch, Tracing, Version, PresetIgnore, DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter, Entity, Restrict, VirtualProperty, GetterPrefix, Transform, Model, column, };
+export { Controller, UseMiddleware, UseMiddlewares, Post, Get, Put, Delete, Patch, Tracing, NoTracing, Version, PresetIgnore, DecorateUseCase, UseCase, Hook, BeforeHook, AfterHook, HookBefore, HookAfter, Entity, Restrict, VirtualProperty, GetterPrefix, Transform, Model, column, };
 export { Storage, CacheGateway, EventDispatcher } from './services';

package/dist/http/controller.handler.js

@@ -99,6 +99,7 @@ export default class ControllerHandler {
         for (const controller of controllersList) {
             const basePath = Reflect.getMetadata('basePath', controller);
             const methodNames = Object.getOwnPropertyNames(controller.prototype).filter(method => method !== 'constructor');
+            const controllerNoTracing = Reflect.getMetadata('noTracing', controller) === true;
             const controllerTracerMetadata = Reflect.getMetadata('tracer', controller)
                 || (this.tracerEnabled ? { fromContainer: true, token: DEFAULT_TRACER_TOKEN } : null);
             const controllerVersion = Reflect.getMetadata('version', controller);
@@ -111,7 +112,10 @@ export default class ControllerHandler {
                 const middlewares = [...controllerMiddlewares, ...methodMiddlewares];
                 const responseType = routeConfig.responseType || 'json';
                 const methodTracerMetadata = Reflect.getMetadata('tracer', controller.prototype, methodName);
-                const tracerMetadata = methodTracerMetadata || controllerTracerMetadata;
+                const methodNoTracing = Reflect.getMetadata('noTracing', controller.prototype, methodName) === true;
+                const tracerMetadata = (methodNoTracing || controllerNoTracing)
+                    ? null
+                    : methodTracerMetadata || controllerTracerMetadata;
                 const tracer = this.resolveTracer(tracerMetadata);
                 const methodVersion = Reflect.getMetadata('version', controller.prototype, methodName);
                 const methodPresetIgnore = Reflect.getMetadata('presetIgnore', controller.prototype, methodName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framework-do-dede",
-  "version": "6.2.3",
+  "version": "6.3.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",