debug method

void debug(dynamic message, { LogEvent? event, Map<String, Object>? context, })

Adds debug level logging.

Auto-initializes with ConsoleLogStrategy if not yet initialized.

message - The message to log. Can be a String, any object, or a Function returning the message (lazy evaluation).

Example:

// Eager (always evaluates)
logger.debug('Users: ${expensiveQuery()}');

// Lazy (only evaluates if debug level is active)
logger.debug(() => 'Users: ${expensiveQuery()}');

Implementation

void debug(dynamic message, {LogEvent? event, Map<String, Object>? context}) {
  _ensureInitialized();

  final entry = LogEntry.fromParams(
    message: _resolveMessage(message),
    level: LogLevel.debug,
    event: event,
    context: context,
  );

  _logQueue!.enqueue(entry);
}