/**
 * Debug Logging Utility
 *
 * Cross-platform debug logging that writes to temp directory.
 * Controlled via environment variables for easy enable/disable.
 *
 * Usage:
 *   import { createDebugLogger } from './debugLog.js';
 *   const debug = createDebugLogger('stream');
 *   debug.log('EVENT', { foo: 'bar' });
 *
 * Enable via environment:
 *   DEXTO_DEBUG_STREAM=true dexto
 *   DEXTO_DEBUG_ALL=true dexto  (enables all debug loggers)
 */
export interface DebugLogger {
    /** Log a message with optional data */
    log: (msg: string, data?: Record<string, unknown>) => void;
    /** Check if debug logging is enabled */
    isEnabled: () => boolean;
    /** Get the log file path */
    getLogPath: () => string;
    /** Clear the log file and write a header */
    reset: (header?: string) => void;
}
/**
 * Creates a debug logger for a specific component.
 *
 * @param name Component name (used in env var and filename)
 * @returns Debug logger instance
 *
 * @example
 * const debug = createDebugLogger('stream');
 * // Enabled via DEXTO_DEBUG_STREAM=true or DEXTO_DEBUG_ALL=true
 * // Writes to: {tmpdir}/dexto-debug-stream.log
 */
export declare function createDebugLogger(name: string): DebugLogger;
//# sourceMappingURL=debugLog.d.ts.map