/**
 * @module helpers/logger-helpers
 * @description Helper functions for logger integration
 */
import type { ILogger } from '../types/logger.types.js';
/**
 * Initialize logger for a component
 * Only supports direct logger instance (not LoggerBinder - use binder.bind() externally instead)
 *
 * @param target - Target component to bind logger to
 * @param logger - Optional logger instance
 * @returns Logger instance or undefined
 */
export declare function initializeLogger(target: {
    logger?: ILogger;
}, logger?: ILogger): ILogger | undefined;
/**
 * Safe context wrapper for logger calls
 * Handles undefined/null/primitive values by wrapping them in an object
 *
 * @param context - Context value (can be any type)
 * @returns Safe object for logger
 */
export declare function safeLogContext(context: unknown): object;
/**
 * Log error with context
 *
 * @param logger - Logger instance
 * @param error - Error object or message
 * @param message - Additional message
 * @param context - Additional context
 */
export declare function logError(logger: ILogger | undefined, error: Error | string, message: string, context?: Record<string, unknown>): void;
/**
 * Create a child logger with prefix
 *
 * @param logger - Parent logger
 * @param prefix - Prefix for child logger
 * @returns Child logger or undefined
 */
export declare function createChildLogger(logger: ILogger | undefined, prefix: string): ILogger | undefined;