Class Logger

constructor

• new Logger(
      options: {
          bufferLogs: boolean;
          printStrategy: LogPrinterPrintStrategy;
          printThreshold: LogLevels | null;
          useColors?: boolean;
      },
      boundContext?: Record<string, unknown>,
      source?: string,
      printer?: LogPrinter,
  ): Logger

  Parameters

  • options: {
        bufferLogs: boolean;
        printStrategy: LogPrinterPrintStrategy;
        printThreshold: LogLevels | null;
        useColors?: boolean;
    }
  • boundContext: Record<string, unknown> = {}
  • Optionalsource: string
  • Optionalprinter: LogPrinter

  Returns Logger

localListeners

StaticSeverity

critical

• critical(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

debug

• debug(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

error

• error(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

info

• info(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

lock

• lock(): Promise<void>

  Marks the logger as ready. This is used to trigger the local listeners and print the buffered logs (if they exists)

  Returns Promise<void>

  A promise that resolves when the logger is ready.

log

• log(level: LogLevels, message: unknown, logInfo?: ILogInfo): Promise<void>

  Core logging method with structured LogInfo

  Parameters

  • level: LogLevels
  • message: unknown
  • logInfo: ILogInfo = {}

  Returns Promise<void>

onLog

• onLog(listener: (log: ILog) => void | Promise<void>): void

  Parameters

  • listener: (log: ILog) => void | Promise<void>

    A listener that will be triggered for every log.

  Returns void

print

• print(log: ILog): void

  Direct print for tests and advanced scenarios. Delegates to LogPrinter.

  Parameters

  • log: ILog

  Returns void

trace

• trace(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

warn

• warn(message: unknown, logInfo?: ILogInfo): Promise<void>

  Parameters

  • message: unknown
  • OptionallogInfo: ILogInfo

  Returns Promise<void>

with

• with(
      __namedParameters: {
          additionalContext?: Record<string, unknown>;
          source?: string;
      },
  ): Logger

  Creates a new logger instance with additional bound context

  Parameters

  • __namedParameters: { additionalContext?: Record<string, unknown>; source?: string }

  Returns Logger