@navios/core 0.5.1 → 0.7.0

package/src/legacy-compat/decorators/use-guards.decorator.mts

@@ -0,0 +1,80 @@
+import type {
+  ClassType,
+  ClassTypeWithInstance,
+  InjectionToken,
+} from '@navios/di'
+
+import type { CanActivate } from '../../interfaces/index.mjs'
+
+import { UseGuards as OriginalUseGuards } from '../../decorators/use-guards.decorator.mjs'
+import { createClassContext, createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Legacy-compatible UseGuards decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Can be applied to classes or methods.
+ *
+ * @param guards - Guard classes or injection tokens to apply
+ * @returns A class or method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * // Apply to a controller
+ * @Controller()
+ * @UseGuards(AuthGuard, RoleGuard)
+ * export class UserController { }
+ *
+ * // Apply to a specific endpoint
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   @UseGuards(AuthGuard)
+ *   async getUser() { }
+ * }
+ * ```
+ */
+export function UseGuards(
+  ...guards: (
+    | ClassTypeWithInstance<CanActivate>
+    | InjectionToken<CanActivate, undefined>
+  )[]
+) {
+  // Create the decorator function
+  // Note: TypeScript's legacy decorator system has strict type checking for decorators
+  // We use a flexible implementation that works for both class and method decorators
+  function decoratorImpl(
+    target: ClassType | Function,
+    propertyKey?: string | symbol,
+    descriptor?: PropertyDescriptor,
+  ): any {
+    // Determine if this is a class or method decorator
+    if (propertyKey !== undefined && descriptor !== undefined) {
+      // Method decorator
+      const context = createMethodContext(
+        target as Function,
+        propertyKey,
+        descriptor,
+      )
+      const originalDecorator = OriginalUseGuards(...guards)
+      const result = originalDecorator(descriptor.value, context)
+      if (result !== descriptor.value) {
+        descriptor.value = result
+      }
+      return descriptor
+    } else {
+      // Class decorator
+      const context = createClassContext(target as ClassType)
+      const originalDecorator = OriginalUseGuards(...guards)
+      return originalDecorator(target as ClassType, context)
+    }
+  }
+
+  // Return with 'any' type to work around TypeScript's strict decorator checking
+  // TypeScript's legacy decorator system cannot properly type-check decorators
+  // that work as both class and method decorators. The runtime behavior is correct.
+  // When used as a class decorator, it returns the class (preserving type at runtime)
+  // When used as a method decorator, it returns the PropertyDescriptor
+  // @ts-ignore - TypeScript limitation with dual-purpose legacy decorators
+  return decoratorImpl as any
+}

package/src/legacy-compat/index.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Legacy-compatible decorators for projects that cannot use Stage 3 decorators.
+ *
+ * These decorators use the TypeScript experimental decorator API and convert
+ * the arguments to Stage 3 format internally.
+ *
+ * @example
+ * ```typescript
+ * import { Module, Controller, Endpoint } from '@navios/core/legacy-compat'
+ *
+ * @Module({
+ *   controllers: [UserController],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export type { ModuleOptions, ControllerOptions, EndpointParams, EndpointResult, MultipartParams, MultipartResult, StreamParams, } from '../decorators/index.mjs';
+export { Module, Controller, Endpoint, UseGuards, Header, HttpCode, Multipart, Stream, } from './decorators/index.mjs';
+//# sourceMappingURL=index.d.mts.map

package/src/legacy-compat/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EACL,MAAM,EACN,UAAU,EACV,QAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,MAAM,GACP,MAAM,wBAAwB,CAAA"}

package/src/legacy-compat/index.mts

@@ -0,0 +1,40 @@
+/**
+ * Legacy-compatible decorators for projects that cannot use Stage 3 decorators.
+ * 
+ * These decorators use the TypeScript experimental decorator API and convert
+ * the arguments to Stage 3 format internally.
+ * 
+ * @example
+ * ```typescript
+ * import { Module, Controller, Endpoint } from '@navios/core/legacy-compat'
+ * 
+ * @Module({
+ *   controllers: [UserController],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+
+// Re-export types
+export type {
+  ModuleOptions,
+  ControllerOptions,
+  EndpointParams,
+  EndpointResult,
+  MultipartParams,
+  MultipartResult,
+  StreamParams,
+} from '../decorators/index.mjs'
+
+// Export legacy-compatible decorators
+export {
+  Module,
+  Controller,
+  Endpoint,
+  UseGuards,
+  Header,
+  HttpCode,
+  Multipart,
+  Stream,
+} from './decorators/index.mjs'
+

package/src/logger/console-logger.service.d.mts

@@ -0,0 +1,196 @@
+import type { InspectOptions } from 'util';
+import type { LogLevel } from './log-levels.mjs';
+import type { LoggerService } from './logger-service.interface.mjs';
+/**
+ * @publicApi
+ */
+export interface ConsoleLoggerOptions {
+    /**
+     * Enabled log levels.
+     */
+    logLevels?: LogLevel[];
+    /**
+     * If enabled, will print timestamp (time difference) between current and previous log message.
+     * Note: This option is not used when `json` is enabled.
+     */
+    timestamp?: boolean;
+    /**
+     * A prefix to be used for each log message.
+     * Note: This option is not used when `json` is enabled.
+     */
+    prefix?: string;
+    /**
+     * If enabled, will add a request ID to the log message.
+     */
+    requestId?: boolean;
+    /**
+     * If enabled, will print the log message in JSON format.
+     */
+    json?: boolean;
+    /**
+     * If enabled, will print the log message in color.
+     * Default true if json is disabled, false otherwise
+     */
+    colors?: boolean;
+    /**
+     * The context of the logger.
+     */
+    context?: string;
+    /**
+     * If enabled, will print the log message in a single line, even if it is an object with multiple properties.
+     * If set to a number, the most n inner elements are united on a single line as long as all properties fit into breakLength. Short array elements are also grouped together.
+     * Default true when `json` is enabled, false otherwise.
+     */
+    compact?: boolean | number;
+    /**
+     * Specifies the maximum number of Array, TypedArray, Map, Set, WeakMap, and WeakSet elements to include when formatting.
+     * Set to null or Infinity to show all elements. Set to 0 or negative to show no elements.
+     * Ignored when `json` is enabled, colors are disabled, and `compact` is set to true as it produces a parseable JSON output.
+     * @default 100
+     */
+    maxArrayLength?: number;
+    /**
+     * Specifies the maximum number of characters to include when formatting.
+     * Set to null or Infinity to show all elements. Set to 0 or negative to show no characters.
+     * Ignored when `json` is enabled, colors are disabled, and `compact` is set to true as it produces a parseable JSON output.
+     * @default 10000.
+     */
+    maxStringLength?: number;
+    /**
+     * If enabled, will sort keys while formatting objects.
+     * Can also be a custom sorting function.
+     * Ignored when `json` is enabled, colors are disabled, and `compact` is set to true as it produces a parseable JSON output.
+     * @default false
+     */
+    sorted?: boolean | ((a: string, b: string) => number);
+    /**
+     * Specifies the number of times to recurse while formatting object. T
+     * This is useful for inspecting large objects. To recurse up to the maximum call stack size pass Infinity or null.
+     * Ignored when `json` is enabled, colors are disabled, and `compact` is set to true as it produces a parseable JSON output.
+     * @default 5
+     */
+    depth?: number;
+    /**
+     * If true, object's non-enumerable symbols and properties are included in the formatted result.
+     * WeakMap and WeakSet entries are also included as well as user defined prototype properties
+     * @default false
+     */
+    showHidden?: boolean;
+    /**
+     * The length at which input values are split across multiple lines. Set to Infinity to format the input as a single line (in combination with "compact" set to true).
+     * Default Infinity when "compact" is true, 80 otherwise.
+     * Ignored when `json` is enabled, colors are disabled, and `compact` is set to true as it produces a parseable JSON output.
+     */
+    breakLength?: number;
+}
+/**
+ * @publicApi
+ */
+export declare class ConsoleLogger implements LoggerService {
+    /**
+     * The options of the logger.
+     */
+    protected options: ConsoleLoggerOptions;
+    /**
+     * The context of the logger (can be set manually or automatically inferred).
+     */
+    protected context?: string;
+    /**
+     * The original context of the logger (set in the constructor).
+     */
+    protected originalContext?: string;
+    /**
+     * The options used for the "inspect" method.
+     */
+    protected inspectOptions: InspectOptions;
+    /**
+     * The last timestamp at which the log message was printed.
+     */
+    protected lastTimestampAt?: number;
+    setup(): void;
+    setup(context: string): void;
+    setup(options: ConsoleLoggerOptions): void;
+    setup(context: string, options: ConsoleLoggerOptions): void;
+    /**
+     * Write a 'log' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    log(message: any, context?: string): void;
+    log(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write an 'error' level log, if the configured level allows for it.
+     * Prints to `stderr` with newline.
+     */
+    error(message: any, stackOrContext?: string): void;
+    error(message: any, stack?: string, context?: string): void;
+    error(message: any, ...optionalParams: [...any, string?, string?]): void;
+    /**
+     * Write a 'warn' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    warn(message: any, context?: string): void;
+    warn(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'debug' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    debug(message: any, context?: string): void;
+    debug(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'verbose' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    verbose(message: any, context?: string): void;
+    verbose(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'fatal' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    fatal(message: any, context?: string): void;
+    fatal(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Set log levels
+     * @param levels log levels
+     */
+    setLogLevels(levels: LogLevel[]): void;
+    /**
+     * Set logger context
+     * @param context context
+     */
+    setContext(context: string): void;
+    /**
+     * Resets the logger context to the value that was passed in the constructor.
+     */
+    resetContext(): void;
+    isLevelEnabled(level: LogLevel): boolean;
+    /**
+     * Gets the current request ID from the AsyncLocalStorage store.
+     * Only returns a value if the requestId option is enabled.
+     */
+    protected getCurrentRequestId(): string | undefined;
+    protected getTimestamp(): string;
+    protected printMessages(messages: unknown[], context?: string, logLevel?: LogLevel, requestId?: string, writeStreamType?: 'stdout' | 'stderr', errorStack?: unknown): void;
+    protected printAsJson(message: unknown, options: {
+        context: string;
+        logLevel: LogLevel;
+        writeStreamType?: 'stdout' | 'stderr';
+        errorStack?: unknown;
+        requestId?: string;
+    }): void;
+    protected formatPid(pid: number): string;
+    protected formatContext(context: string): string;
+    protected formatMessage(logLevel: LogLevel, message: unknown, pidMessage: string, formattedLogLevel: string, contextMessage: string, timestampDiff: string, requestId?: string): string;
+    protected getRequestId(requestId?: string): string;
+    protected stringifyMessage(message: unknown, logLevel: LogLevel): string;
+    protected colorize(message: string, logLevel: LogLevel): string;
+    protected printStackTrace(stack: string): void;
+    protected updateAndGetTimestampDiff(): string;
+    protected formatTimestampDiff(timestampDiff: number): string;
+    protected getInspectOptions(): InspectOptions;
+    protected stringifyReplacer(key: string, value: unknown): unknown;
+    private getContextAndMessagesToPrint;
+    private getContextAndStackAndMessagesToPrint;
+    private isStackFormat;
+    private getColorByLogLevel;
+}
+//# sourceMappingURL=console-logger.service.d.mts.map

package/src/logger/console-logger.service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.service.d.mts","sourceRoot":"","sources":["console-logger.service.mts"],"names":[],"mappings":"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"}

package/src/logger/console-logger.service.mts

@@ -7,6 +7,7 @@ import { Injectable } from '@navios/di'
 import type { LogLevel } from './log-levels.mjs'
 import type { LoggerService } from './logger-service.interface.mjs'
 
+import { getRequestId } from '../stores/request-id.store.mjs'
 import { LoggerOutput } from './logger.tokens.mjs'
 import {
   clc,
@@ -312,6 +313,17 @@ export class ConsoleLogger implements LoggerService {
     return isLogLevelEnabled(level, logLevels)
   }
 
+  /**
+   * Gets the current request ID from the AsyncLocalStorage store.
+   * Only returns a value if the requestId option is enabled.
+   */
+  protected getCurrentRequestId(): string | undefined {
+    if (!this.options.requestId) {
+      return undefined
+    }
+    return getRequestId()
+  }
+
   protected getTimestamp(): string {
     return dateTimeFormatter.format(Date.now())
   }
@@ -324,6 +336,7 @@ export class ConsoleLogger implements LoggerService {
     writeStreamType?: 'stdout' | 'stderr',
     errorStack?: unknown,
   ) {
+    const resolvedRequestId = requestId ?? this.getCurrentRequestId()
     messages.forEach((message) => {
       if (this.options.json) {
         this.printAsJson(message, {
@@ -331,7 +344,7 @@ export class ConsoleLogger implements LoggerService {
           logLevel,
           writeStreamType,
           errorStack,
-          requestId,
+          requestId: resolvedRequestId,
         })
         return
       }
@@ -346,7 +359,7 @@ export class ConsoleLogger implements LoggerService {
         formattedLogLevel,
         contextMessage,
         timestampDiff,
-        requestId,
+        resolvedRequestId,
       )
 
       process[writeStreamType ?? 'stdout'].write(formattedMessage)

package/src/logger/index.d.mts

@@ -0,0 +1,7 @@
+export * from './utils/index.mjs';
+export * from './console-logger.service.mjs';
+export * from './log-levels.mjs';
+export * from './logger.tokens.mjs';
+export * from './logger.service.mjs';
+export * from './logger-service.interface.mjs';
+//# sourceMappingURL=index.d.mts.map

package/src/logger/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA"}

package/src/logger/log-levels.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Available log levels in order of severity (lowest to highest).
+ */
+export declare const LOG_LEVELS: ["verbose", "debug", "log", "warn", "error", "fatal"];
+/**
+ * Log level type.
+ *
+ * Represents the severity level of a log message.
+ * Levels are: 'verbose', 'debug', 'log', 'warn', 'error', 'fatal'
+ *
+ * @publicApi
+ */
+export type LogLevel = (typeof LOG_LEVELS)[number];
+//# sourceMappingURL=log-levels.d.mts.map

package/src/logger/log-levels.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-levels.d.mts","sourceRoot":"","sources":["log-levels.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU,uDAOM,CAAA;AAE7B;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/src/logger/log-levels.mts

@@ -1,3 +1,6 @@
+/**
+ * Available log levels in order of severity (lowest to highest).
+ */
 export const LOG_LEVELS = [
   'verbose',
   'debug',
@@ -6,7 +9,13 @@ export const LOG_LEVELS = [
   'error',
   'fatal',
 ] as const satisfies string[]
+
 /**
+ * Log level type.
+ * 
+ * Represents the severity level of a log message.
+ * Levels are: 'verbose', 'debug', 'log', 'warn', 'error', 'fatal'
+ * 
  * @publicApi
  */
 export type LogLevel = (typeof LOG_LEVELS)[number]

package/src/logger/logger-service.interface.d.mts

@@ -0,0 +1,36 @@
+import type { LogLevel } from './log-levels.mjs';
+/**
+ * @publicApi
+ */
+export interface LoggerService {
+    /**
+     * Write a 'log' level log.
+     */
+    log(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write an 'error' level log.
+     */
+    error(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write a 'warn' level log.
+     */
+    warn(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write a 'debug' level log.
+     */
+    debug?(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write a 'verbose' level log.
+     */
+    verbose?(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write a 'fatal' level log.
+     */
+    fatal?(message: any, ...optionalParams: any[]): any;
+    /**
+     * Set log levels.
+     * @param levels log levels
+     */
+    setLogLevels?(levels: LogLevel[]): any;
+}
+//# sourceMappingURL=logger-service.interface.d.mts.map

package/src/logger/logger-service.interface.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-service.interface.d.mts","sourceRoot":"","sources":["logger-service.interface.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAEhD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAElD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAEjD;;OAEG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAEnD;;OAEG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAErD;;OAEG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAEnD;;;OAGG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAA;CACvC"}

package/src/logger/logger.service.d.mts

@@ -0,0 +1,57 @@
+import type { LoggerService } from './logger-service.interface.mjs';
+import type { LoggerOptions } from './logger.tokens.mjs';
+/**
+ * Logger service instance that can be injected into services and controllers.
+ *
+ * Provides contextualized logging with automatic context injection.
+ * The context is set when the logger is injected using the `inject` function.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   private logger = inject(Logger, { context: UserService.name })
+ *
+ *   async findUser(id: string) {
+ *     this.logger.log(`Finding user ${id}`)
+ *     // Logs with context: [UserService]
+ *   }
+ * }
+ * ```
+ */
+export declare class LoggerInstance implements LoggerService {
+    protected localInstance: LoggerService;
+    protected context?: string;
+    constructor(config?: LoggerOptions);
+    /**
+     * Write an 'error' level log.
+     */
+    error(message: any, stack?: string, context?: string): void;
+    error(message: any, ...optionalParams: [...any, string?, string?]): void;
+    /**
+     * Write a 'log' level log.
+     */
+    log(message: any, context?: string): void;
+    log(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'warn' level log.
+     */
+    warn(message: any, context?: string): void;
+    warn(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'debug' level log.
+     */
+    debug(message: any, context?: string): void;
+    debug(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'verbose' level log.
+     */
+    verbose(message: any, context?: string): void;
+    verbose(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'fatal' level log.
+     */
+    fatal(message: any, context?: string): void;
+    fatal(message: any, ...optionalParams: [...any, string?]): void;
+}
+//# sourceMappingURL=logger.service.d.mts.map

package/src/logger/logger.service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.service.d.mts","sourceRoot":"","sources":["logger.service.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAIxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAGa,cAAe,YAAW,aAAa;IAClD,SAAS,CAAC,aAAa,gBAAuB;IAE9C,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;gBAEd,MAAM,GAAE,aAAkB;IAItC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAC3D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAWxE;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IACzC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAQ7D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAC1C,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAQ9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAC3C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAQ/D;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAC7C,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAQjE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAC3C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;CAOhE"}

package/src/logger/logger.service.mts

@@ -5,6 +5,25 @@ import type { LoggerOptions } from './logger.tokens.mjs'
 
 import { Logger, LoggerOutput } from './logger.tokens.mjs'
 
+/**
+ * Logger service instance that can be injected into services and controllers.
+ * 
+ * Provides contextualized logging with automatic context injection.
+ * The context is set when the logger is injected using the `inject` function.
+ * 
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   private logger = inject(Logger, { context: UserService.name })
+ *   
+ *   async findUser(id: string) {
+ *     this.logger.log(`Finding user ${id}`)
+ *     // Logs with context: [UserService]
+ *   }
+ * }
+ * ```
+ */
 @Injectable({
   token: Logger,
 })

package/src/logger/logger.tokens.d.mts

@@ -0,0 +1,36 @@
+import { InjectionToken } from '@navios/di';
+import z from 'zod/v4';
+import type { LoggerService } from './logger-service.interface.mjs';
+import type { LoggerInstance } from './logger.service.mjs';
+/**
+ * Injection token for the logger output service.
+ *
+ * This token is used to provide a custom logger implementation.
+ * By default, it's bound to ConsoleLogger.
+ */
+export declare const LoggerOutput: InjectionToken<LoggerService, undefined, false>;
+/**
+ * Schema for logger options.
+ */
+export declare const loggerOptionsSchema: z.ZodOptional<z.ZodObject<{
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Options for creating a logger instance.
+ */
+export type LoggerOptions = z.infer<typeof loggerOptionsSchema>;
+/**
+ * Injection token for the Logger service.
+ *
+ * Use this token to inject a contextualized logger instance.
+ *
+ * @example
+ * ```typescript
+ * const logger = inject(Logger, { context: 'MyService' })
+ * logger.log('Hello world') // Logs with context: [MyService]
+ * ```
+ */
+export declare const Logger: InjectionToken<LoggerInstance, z.ZodOptional<z.ZodObject<{
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>, false>;
+//# sourceMappingURL=logger.tokens.d.mts.map

package/src/logger/logger.tokens.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.tokens.d.mts","sourceRoot":"","sources":["logger.tokens.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iDAAuD,CAAA;AAEhF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;kBAInB,CAAA;AAEb;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM;;0BAGa,CAAA"}

package/src/logger/logger.tokens.mts

@@ -5,16 +5,39 @@ import z from 'zod/v4'
 import type { LoggerService } from './logger-service.interface.mjs'
 import type { LoggerInstance } from './logger.service.mjs'
 
+/**
+ * Injection token for the logger output service.
+ * 
+ * This token is used to provide a custom logger implementation.
+ * By default, it's bound to ConsoleLogger.
+ */
 export const LoggerOutput = InjectionToken.create<LoggerService>('LoggerOutput')
 
+/**
+ * Schema for logger options.
+ */
 export const loggerOptionsSchema = z
   .object({
     context: z.string().optional(),
   })
   .optional()
 
+/**
+ * Options for creating a logger instance.
+ */
 export type LoggerOptions = z.infer<typeof loggerOptionsSchema>
 
+/**
+ * Injection token for the Logger service.
+ * 
+ * Use this token to inject a contextualized logger instance.
+ * 
+ * @example
+ * ```typescript
+ * const logger = inject(Logger, { context: 'MyService' })
+ * logger.log('Hello world') // Logs with context: [MyService]
+ * ```
+ */
 export const Logger = InjectionToken.create<
   LoggerInstance,
   typeof loggerOptionsSchema