plutin 1.5.4 → 1.6.1

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import { Express } from 'express';
-import { FastifyInstance } from 'fastify';
+import { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import { Logger } from '@opentelemetry/api-logs';
+import winston from 'winston';
 
 type AnyObject = Record<string, any>;
 type Request = {
@@ -269,13 +271,27 @@ declare const baseEnvSchema: z.ZodObject<{
     SHOULD_NOTIFY_ERROR: z.ZodDefault<z.ZodBoolean>;
     SENTRY_DSN: z.ZodOptional<z.ZodString>;
     DISCORD_WEBHOOK_URL: z.ZodOptional<z.ZodString>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<["info", "error", "debug", "fatal", "warn"]>>;
+    OTEL_ENABLE: z.ZodDefault<z.ZodBoolean>;
+    OTEL_SERVICE_NAME: z.ZodOptional<z.ZodString>;
+    OTEL_SERVICE_VERSION: z.ZodOptional<z.ZodString>;
+    OTEL_OTLP_TRACES_EXPORTER_URL: z.ZodOptional<z.ZodString>;
+    OTEL_OTLP_LOGS_EXPORTER_URL: z.ZodOptional<z.ZodString>;
+    OTEL_OTLP_METRICS_EXPORTER_URL: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ENVIRONMENT: "test" | "development" | "production" | "staging";
     SHOULD_NOTIFY_ERROR: boolean;
     NODE_ENV: "test" | "development" | "production";
     PORT: number;
+    LOG_LEVEL: "error" | "fatal" | "warn" | "info" | "debug";
+    OTEL_ENABLE: boolean;
     SENTRY_DSN?: string | undefined;
     DISCORD_WEBHOOK_URL?: string | undefined;
+    OTEL_SERVICE_NAME?: string | undefined;
+    OTEL_SERVICE_VERSION?: string | undefined;
+    OTEL_OTLP_TRACES_EXPORTER_URL?: string | undefined;
+    OTEL_OTLP_LOGS_EXPORTER_URL?: string | undefined;
+    OTEL_OTLP_METRICS_EXPORTER_URL?: string | undefined;
 }, {
     ENVIRONMENT?: "test" | "development" | "production" | "staging" | undefined;
     SHOULD_NOTIFY_ERROR?: boolean | undefined;
@@ -283,6 +299,13 @@ declare const baseEnvSchema: z.ZodObject<{
     PORT?: number | undefined;
     SENTRY_DSN?: string | undefined;
     DISCORD_WEBHOOK_URL?: string | undefined;
+    LOG_LEVEL?: "error" | "fatal" | "warn" | "info" | "debug" | undefined;
+    OTEL_ENABLE?: boolean | undefined;
+    OTEL_SERVICE_NAME?: string | undefined;
+    OTEL_SERVICE_VERSION?: string | undefined;
+    OTEL_OTLP_TRACES_EXPORTER_URL?: string | undefined;
+    OTEL_OTLP_LOGS_EXPORTER_URL?: string | undefined;
+    OTEL_OTLP_METRICS_EXPORTER_URL?: string | undefined;
 }>;
 
 type OptionsNotifications = 'console' | 'discord' | 'sentry';
@@ -308,6 +331,52 @@ declare class SentryNotifier implements IErrorNotifier {
     notify(error: Error, context: ContextError): Promise<void>;
 }
 
+declare class WinstonOtelFastify {
+    private readonly env;
+    logger: Logger;
+    consoleLogger: winston.Logger;
+    level: 'info' | 'error' | 'debug' | 'fatal' | 'warn';
+    constructor(env: Record<string, any>);
+    private bodyIsFastifyRequest;
+    private bodyIsFastifyReply;
+    private buildMessage;
+    private logMessage;
+    info(body: string | {
+        req?: FastifyRequest;
+        res?: FastifyReply;
+    }): void;
+    error(body: string | {
+        req?: FastifyRequest;
+        res?: FastifyReply;
+    }): void;
+    debug(body: string | {
+        req?: FastifyRequest;
+        res?: FastifyReply;
+    }): void;
+    fatal(body: string | {
+        req?: FastifyRequest;
+        res?: FastifyReply;
+    }): void;
+    warn(body: string | {
+        req?: FastifyRequest;
+        res?: FastifyReply;
+    }): void;
+    trace(message: string): void;
+    child(): WinstonOtelFastify;
+}
+
+declare function Span(): MethodDecorator;
+
+interface ITracerGateway {
+    addEvent(name: string, attributes?: Record<string, any>): void;
+    setAttribute(key: string, value: string | number | boolean): void;
+}
+
+declare class TracerGatewayOpentelemetry implements ITracerGateway {
+    addEvent(name: string, attributes?: Record<string, any>): void;
+    setAttribute(key: string, value: string | number | boolean): void;
+}
+
 declare const logger: {
     info: (...args: any[]) => void;
     log: (...args: any[]) => void;
@@ -315,4 +384,4 @@ declare const logger: {
     error: (...args: any[]) => void;
 };
 
-export { AggregateObjectRoot, AggregateRoot, BaseController, CommonDTO, ContextError, Controller, CreateCommonDTO, DependencyContainer, DiscordNotifier, DtoResponsePagination, Entity, EntityObject, ExpressAdapter, FastifyAdapter, GlobalErrorHandler, IErrorNotifier, IHealthCheckDB, IHttp, Inject, MethodType, MiddlewareFunction, NotPagination, NotificationErrorInMemory, NotificationFactory, Optional, Pagination, Replace, Request, RequestHttp, Response, SentryNotifier, UniqueEntityId, UniqueObjectId, ValueObject, WatchedList, ZodSchema, baseEnvSchema, getTakeAndSkip, logger, zodValidator };
+export { AggregateObjectRoot, AggregateRoot, BaseController, CommonDTO, ContextError, Controller, CreateCommonDTO, DependencyContainer, DiscordNotifier, DtoResponsePagination, Entity, EntityObject, ExpressAdapter, FastifyAdapter, GlobalErrorHandler, IErrorNotifier, IHealthCheckDB, IHttp, ITracerGateway, Inject, MethodType, MiddlewareFunction, NotPagination, NotificationErrorInMemory, NotificationFactory, Optional, Pagination, Replace, Request, RequestHttp, Response, SentryNotifier, Span, TracerGatewayOpentelemetry, UniqueEntityId, UniqueObjectId, ValueObject, WatchedList, WinstonOtelFastify, ZodSchema, baseEnvSchema, getTakeAndSkip, logger, zodValidator };

package/dist/index.mjs

@@ -1456,6 +1456,198 @@ function zodValidator(schema) {
 }
 __name(zodValidator, "zodValidator");
 
+// src/infra/adapters/logger/winston-otel-fastify.ts
+import opentelemetry from "@opentelemetry/api";
+import { logs, SeverityNumber } from "@opentelemetry/api-logs";
+import winston from "winston";
+var WinstonOtelFastify = class WinstonOtelFastify2 {
+  static {
+    __name(this, "WinstonOtelFastify");
+  }
+  env;
+  logger;
+  consoleLogger;
+  level;
+  constructor(env) {
+    this.env = env;
+    this.level = "info";
+    if (env.OTEL_ENABLE) {
+      this.logger = logs.getLogger(this.env.OTEL_SERVICE_NAME, this.env.OTEL_SERVICE_VERSION);
+      this.level = this.env.LOG_LEVEL;
+      const transports = this.env.NODE_ENV === "test" ? [
+        new winston.transports.Console({
+          silent: true
+        })
+      ] : [
+        new winston.transports.Console()
+      ];
+      this.consoleLogger = winston.createLogger({
+        level: this.level,
+        format: winston.format.combine(winston.format.timestamp({
+          format: "YYYY-MM-DD HH:mm:ss:ms"
+        }), winston.format((info) => {
+          if (this.env.NODE_ENV !== "test") {
+            const span = opentelemetry.trace.getActiveSpan();
+            if (span) {
+              info.spanId = span.spanContext().spanId;
+              info.traceId = span.spanContext().traceId;
+            }
+          }
+          return info;
+        })(), winston.format.json()),
+        transports
+      });
+    } else {
+      this.consoleLogger = winston.createLogger({
+        level: this.level,
+        format: winston.format.combine(winston.format.timestamp({
+          format: "YYYY-MM-DD HH:mm:ss:ms"
+        }), winston.format.json())
+      });
+    }
+  }
+  bodyIsFastifyRequest(body) {
+    return body.method !== void 0;
+  }
+  bodyIsFastifyReply(body) {
+    return body.statusCode !== void 0;
+  }
+  buildMessage(body) {
+    if (typeof body === "object" && body.req && this.bodyIsFastifyRequest(body.req)) {
+      return `${body.req.method} ${body.req.url}`;
+    } else if (typeof body === "object" && body.res && this.bodyIsFastifyReply(body.res)) {
+      return `${body.res.request.method} ${body.res.request.url} ${body.res.statusCode} - ${body.res.elapsedTime} ms`;
+    } else if (typeof body === "string") {
+      return body;
+    } else {
+      return "";
+    }
+  }
+  logMessage(body, severityNumber, severityText) {
+    const message = this.buildMessage(body);
+    this.consoleLogger[severityText.toLowerCase()](message);
+    if (this.env.NODE_ENV !== "test") {
+      this.logger.emit({
+        body: message,
+        severityNumber,
+        severityText
+      });
+    }
+  }
+  info(body) {
+    this.logMessage(body, SeverityNumber.INFO, "INFO");
+  }
+  error(body) {
+    this.logMessage(body, SeverityNumber.ERROR, "ERROR");
+  }
+  debug(body) {
+    this.logMessage(body, SeverityNumber.DEBUG, "DEBUG");
+  }
+  fatal(body) {
+    this.logMessage(body, SeverityNumber.FATAL, "FATAL");
+  }
+  warn(body) {
+    this.logMessage(body, SeverityNumber.WARN, "WARN");
+  }
+  trace(message) {
+    if (this.env.NODE_ENV !== "test") {
+      this.logger.emit({
+        body: message,
+        severityNumber: SeverityNumber.TRACE,
+        severityText: "TRACE"
+      });
+    }
+  }
+  child() {
+    return new WinstonOtelFastify2(process.env);
+  }
+};
+
+// src/infra/adapters/observability/otel/span-decorator.ts
+import opentelemetry2, { SpanStatusCode } from "@opentelemetry/api";
+import "reflect-metadata";
+function Span() {
+  return function(target, propertyKey, descriptor) {
+    if (!process.env.OTEL_ENABLE) {
+      return descriptor;
+    }
+    const originalMethod = descriptor.value;
+    descriptor.value = function(...args) {
+      const tracer = opentelemetry2.trace.getTracer(process.env.OTEL_SERVICE_NAME, process.env.OTEL_SERVICE_VERSION);
+      const className = target.constructor?.name || "UnknownClass";
+      const methodName = String(propertyKey);
+      const spanName = `${className}.${methodName}`;
+      return tracer.startActiveSpan(spanName, async (span) => {
+        try {
+          const result = originalMethod.apply(this, args);
+          if (result instanceof Promise) {
+            try {
+              const awaitedResult = await result;
+              span.addEvent(`Method [${methodName}] executed successfully`);
+              span.end();
+              return awaitedResult;
+            } catch (error) {
+              handleSpanError(span, error);
+              throw error;
+            }
+          } else {
+            span.addEvent(`Method [${methodName}] executed successfully`);
+            span.end();
+            return result;
+          }
+        } catch (error) {
+          handleSpanError(span, error);
+          throw error;
+        }
+      });
+    };
+    return descriptor;
+  };
+}
+__name(Span, "Span");
+function handleSpanError(span, error) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  if (error instanceof Error) {
+    span.recordException(error);
+  } else {
+    span.recordException(new Error(String(error)));
+  }
+  span.setStatus({
+    code: SpanStatusCode.ERROR,
+    message: errorMessage
+  });
+  span.end();
+}
+__name(handleSpanError, "handleSpanError");
+
+// src/infra/adapters/observability/otel/tracer-gateway-opentelemetry.ts
+import opentelemetry3 from "@opentelemetry/api";
+var TracerGatewayOpentelemetry = class {
+  static {
+    __name(this, "TracerGatewayOpentelemetry");
+  }
+  addEvent(name, attributes) {
+    if (!process.env.OTEL_ENABLE) {
+      return;
+    }
+    const span = opentelemetry3.trace.getActiveSpan();
+    if (span && attributes) {
+      span.addEvent(name, attributes);
+    } else if (span) {
+      span.addEvent(name);
+    }
+  }
+  setAttribute(key, value) {
+    if (!process.env.OTEL_ENABLE) {
+      return;
+    }
+    const span = opentelemetry3.trace.getActiveSpan();
+    if (span) {
+      span.setAttribute(key, value);
+    }
+  }
+};
+
 // src/infra/env/index.ts
 import { z } from "zod";
 
@@ -1480,7 +1672,20 @@ var baseEnvSchema = z.object({
   PORT: z.coerce.number().default(3333),
   SHOULD_NOTIFY_ERROR: z.coerce.boolean().default(true),
   SENTRY_DSN: z.string().optional(),
-  DISCORD_WEBHOOK_URL: z.string().optional()
+  DISCORD_WEBHOOK_URL: z.string().optional(),
+  LOG_LEVEL: z.enum([
+    "info",
+    "error",
+    "debug",
+    "fatal",
+    "warn"
+  ]).default("info"),
+  OTEL_ENABLE: z.coerce.boolean().default(false),
+  OTEL_SERVICE_NAME: z.string().optional(),
+  OTEL_SERVICE_VERSION: z.string().optional(),
+  OTEL_OTLP_TRACES_EXPORTER_URL: z.string().url().optional(),
+  OTEL_OTLP_LOGS_EXPORTER_URL: z.string().url().optional(),
+  OTEL_OTLP_METRICS_EXPORTER_URL: z.string().url().optional()
 });
 export {
   AggregateObjectRoot,
@@ -1498,10 +1703,13 @@ export {
   NotificationErrorInMemory,
   NotificationFactory,
   SentryNotifier,
+  Span,
+  TracerGatewayOpentelemetry,
   UniqueEntityId,
   UniqueObjectId,
   ValueObject,
   WatchedList,
+  WinstonOtelFastify,
   baseEnvSchema,
   getTakeAndSkip,
   logger,