browser-debugger-cli/dist/utils/file.d.ts

DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.

/**
 * File system utilities for safe file operations.
 *
 * Provides wrapper functions that handle errors gracefully and log failures
 * at debug level instead of throwing exceptions.
 */
import type { Logger } from '../ui/logging/index.js';
/**
 * Safely remove a file, logging any errors at debug level.
 *
 * Uses `fs.rmSync` with `force: true` to avoid errors if the file doesn't exist.
 * Any errors during removal are logged at debug level instead of thrown.
 *
 * @param path - Absolute path to the file to remove
 * @param context - Human-readable description for debug logging (e.g., "metadata file")
 * @param log - Logger instance to use for debug output
 * @returns True if file was removed or didn't exist, false if removal failed
 *
 * @example
 * ```typescript
 * const log = createLogger('cleanup');
 * safeRemoveFile('/path/to/session.pid', 'session PID file', log);
 * // On error logs: [cleanup] Failed to remove session PID file: EACCES: permission denied
 * ```
 */
export declare function safeRemoveFile(path: string, context: string, log: Logger): boolean;
//# sourceMappingURL=file.d.ts.map