import { LogLevel, consoleSink, type LoggerContextBase } from "./config.js";
/**
 * Lazy message supplier function for expensive log computations.
 * Only evaluated when the log level is enabled.
 *
 * @returns {[string, Record<string, unknown>?]} Tuple of [message, optional data]
 */
type MessageSupplier = () => [string, Record<string, unknown>?];
/**
 * Diagnostics logger instance for developer-facing debugging output.
 * Provides level-based logging (error, warn, info, debug, verbose) with structured data.
 */
export type DiagnosticsLogger = {
    /** Log debug messages for development and troubleshooting */
    debug: (msg: string | MessageSupplier, data?: Record<string, unknown>) => void;
    /** Log informational messages for key operations */
    info: (msg: string | MessageSupplier, data?: Record<string, unknown>) => void;
    /** Log warnings for recoverable issues */
    warn: (msg: string | MessageSupplier, data?: Record<string, unknown>) => void;
    /** Log errors for failures */
    error: (msg: string | MessageSupplier, data?: Record<string, unknown>) => void;
    /** Log verbose details for very detailed tracing */
    verbose: (msg: string | MessageSupplier, data?: Record<string, unknown>) => void;
    /** Create a child logger with additional context merged into all log entries */
    withContext: (extra: Record<string, unknown>) => DiagnosticsLogger;
    /**
     * Wrap a function to measure and log its execution time at DEBUG level.
     * Supports both synchronous and asynchronous functions.
     *
     * @template TArgs - Function argument types
     * @template TRet - Function return type
     * @param name - Name for profiling logs
     * @param func - Function to profile
     * @returns Wrapped function that logs execution time
     */
    profiled<TArgs extends any[], TRet>(name: string, func: (...args: TArgs) => TRet): (...args: TArgs) => TRet;
};
/**
 * Parameters for creating a diagnostics logger instance.
 */
export type CreateLoggerParams = LoggerContextBase & {
    /** Optional namespace for filtering/grouping (e.g., "aa-infra", "wallet-apis") */
    namespace?: string;
    /** Optional base context merged into all log entries from this logger */
    baseContext?: Record<string, unknown>;
};
/**
 * Creates a diagnostics logger instance for a package.
 * Loggers emit structured log entries to configured sinks (default: console).
 *
 * All log methods support:
 * - String messages: `logger.info("message", { data })`
 * - Lazy suppliers: `logger.debug(() => ["expensive", computeData()])` (only evaluated when level enabled)
 *
 * @param {CreateLoggerParams} params - Logger configuration
 * @returns {DiagnosticsLogger} A logger instance
 * @example
 * ```ts
 * import { createLogger } from "@alchemy/common";
 *
 * const logger = createLogger({
 *   package: "@alchemy/aa-infra",
 *   version: "1.0.0",
 *   namespace: "aa-infra"
 * });
 *
 * logger.info("processing request", { chainId: 1 });
 * logger.debug("detailed state", { userOp: op });
 *
 * // Child logger with additional context
 * const childLogger = logger.withContext({ requestId: "123" });
 * childLogger.info("step complete"); // includes requestId in all logs
 *
 * // Profile a function
 * const sendWithProfiling = logger.profiled("sendUserOp", sendUserOp);
 * await sendWithProfiling(op); // logs execution time at DEBUG level
 * ```
 */
export declare function createLogger(params: CreateLoggerParams): DiagnosticsLogger;
export { LogLevel, consoleSink };
//# sourceMappingURL=logger.d.ts.map