plutin 1.5.4 → 1.6.0

package/dist/index.d.cts

@@ -269,13 +269,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 +297,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 +329,18 @@ declare class SentryNotifier implements IErrorNotifier {
     notify(error: Error, context: ContextError): Promise<void>;
 }
 
+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 +348,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, ZodSchema, baseEnvSchema, getTakeAndSkip, logger, zodValidator };

package/dist/index.d.ts

@@ -269,13 +269,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 +297,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 +329,18 @@ declare class SentryNotifier implements IErrorNotifier {
     notify(error: Error, context: ContextError): Promise<void>;
 }
 
+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 +348,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, ZodSchema, baseEnvSchema, getTakeAndSkip, logger, zodValidator };

package/dist/index.mjs

@@ -1456,6 +1456,91 @@ function zodValidator(schema) {
 }
 __name(zodValidator, "zodValidator");
 
+// src/infra/adapters/observability/otel/span-decorator.ts
+import opentelemetry, { 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 = opentelemetry.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 opentelemetry2 from "@opentelemetry/api";
+var TracerGatewayOpentelemetry = class {
+  static {
+    __name(this, "TracerGatewayOpentelemetry");
+  }
+  addEvent(name, attributes) {
+    if (!process.env.OTEL_ENABLE) {
+      return;
+    }
+    const span = opentelemetry2.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 = opentelemetry2.trace.getActiveSpan();
+    if (span) {
+      span.setAttribute(key, value);
+    }
+  }
+};
+
 // src/infra/env/index.ts
 import { z } from "zod";
 
@@ -1480,7 +1565,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,6 +1596,8 @@ export {
   NotificationErrorInMemory,
   NotificationFactory,
   SentryNotifier,
+  Span,
+  TracerGatewayOpentelemetry,
   UniqueEntityId,
   UniqueObjectId,
   ValueObject,