Skip to content

LoggerDecorator

katanakit-js / LoggerDecorator

function LoggerDecorator<T>(fn, label?, level?): T;

Defined in: infrastructure/decorators/logger.decorator.ts:39

LoggerDecorator - Decorator Pattern para trazado de llamadas.

Envuelve una función (sync o async) y registra cada invocación con sus argumentos, el resultado y la duración. No modifica la función original: el logging se añade en tiempo de composición (Open/Closed).

Nota: el nombre usa mayúscula inicial porque es un decorador composible, no una función utilitaria (use*) del API pública.

Type Parameter Description
T extends (…args) => unknown Tipo de la función envuelta.
Parameter Type Default value Description
fn T undefined La función a decorar.
label? string undefined Nombre legible que aparece en los logs (default: fn.name).
level? "error" | "log" | "warn" "log" Nivel de log para el resultado (default: "log").

T

La función decorada con logging.

import { LoggerDecorator } from "katanakit-js";
const traced = LoggerDecorator(fetchUser, "fetchUser");
await traced(1);
// [fetchUser] start { args: [1] }
// [fetchUser] ok (12ms) { result: {...} }

Composición

const robust = RetryDecorator(LoggerDecorator(flakyRequest, "flaky"), 2);

Security: arguments and results are logged verbatim. Do NOT decorate functions that receive secrets (API keys, tokens, passwords) — wrap a redacting adapter instead, or strip sensitive fields before calling.