browser-debugger-cli/dist/utils/file.js

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 * as fs from 'fs';
import { logDebugError } 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 function safeRemoveFile(path, context, log) {
    try {
        fs.rmSync(path, { force: true });
        return true;
    }
    catch (error) {
        logDebugError(log, `remove ${context}`, error);
        return false;
    }
}
//# sourceMappingURL=file.js.map