indusagi-coding-agent 0.1.23 → 0.1.24

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/utils/file-operations.d.ts

@@ -0,0 +1,297 @@
+/**
+ * @fileoverview Safe file and directory operations with comprehensive error handling
+ *
+ * This module provides:
+ * - Safe file read/write/append operations
+ * - Directory listing and management
+ * - File metadata operations (size, modification time, permissions)
+ * - Cross-platform path handling
+ * - Error recovery and fallback mechanisms
+ * - Atomic file operations
+ * - Batch operations on multiple files
+ * - Safe deletion with backup support
+ *
+ * @example
+ * import { readFile, writeFile, exists, listFiles } from './file-operations';
+ *
+ * const content = await readFile('./data.json');
+ * await writeFile('./backup.json', content);
+ * const files = await listFiles('./src');
+ *
+ * @author indusagi
+ * @version 1.0.0
+ */
+/** File operation options interface */
+export interface FileOptions {
+    /** File encoding (default: 'utf-8') */
+    encoding?: BufferEncoding;
+    /** Create directories if they don't exist */
+    createDirs?: boolean;
+    /** File permissions in octal (e.g., 0o644) */
+    mode?: number;
+    /** Throw error if file exists on write */
+    exclusive?: boolean;
+    /** Maximum file size to read (bytes) */
+    maxSize?: number;
+}
+/** File metadata interface */
+export interface FileMetadata {
+    /** File size in bytes */
+    size: number;
+    /** Last modification time */
+    modTime: Date;
+    /** File permissions */
+    mode: number;
+    /** Whether it's a directory */
+    isDirectory: boolean;
+    /** Whether it's a file */
+    isFile: boolean;
+    /** Absolute path */
+    absolutePath: string;
+    /** File hash (SHA-256) */
+    hash?: string;
+}
+/** Directory listing options */
+export interface ListFilesOptions {
+    /** Recursive listing */
+    recursive?: boolean;
+    /** File extension filter (e.g., '.ts') */
+    extension?: string;
+    /** Include hidden files */
+    includeHidden?: boolean;
+    /** Exclude directories */
+    filesOnly?: boolean;
+}
+/** File operation error with context */
+export declare class FileOperationError extends Error {
+    operation: string;
+    filePath: string;
+    originalError: Error;
+    constructor(operation: string, filePath: string, originalError: Error);
+}
+/**
+ * Safely read file contents
+ * @param filePath - Path to file
+ * @param options - Read options
+ * @returns File contents
+ * @throws FileOperationError if read fails
+ *
+ * @example
+ * const content = await readFile('./config.json');
+ *
+ * @example
+ * const content = await readFile('./data.txt', { encoding: 'utf-8', maxSize: 10000 });
+ *
+ * @example
+ * try {
+ *   const content = await readFile('./missing.txt');
+ * } catch (error) {
+ *   if (error instanceof FileOperationError) {
+ *     console.error(`Failed to read: ${error.operation}`);
+ *   }
+ * }
+ */
+export declare function readFile(filePath: string, options?: FileOptions): Promise<string>;
+/**
+ * Safely read file as buffer
+ * @param filePath - Path to file
+ * @param options - Read options
+ * @returns File buffer
+ *
+ * @example
+ * const buffer = await readFileBuffer('./image.png');
+ * const base64 = buffer.toString('base64');
+ */
+export declare function readFileBuffer(filePath: string, options?: FileOptions): Promise<Buffer>;
+/**
+ * Safely write file contents
+ * @param filePath - Path to file
+ * @param content - Content to write
+ * @param options - Write options
+ *
+ * @example
+ * await writeFile('./config.json', JSON.stringify(config, null, 2));
+ *
+ * @example
+ * await writeFile('./output.txt', 'Hello World', { createDirs: true });
+ *
+ * @example
+ * await writeFile('./exclusive.txt', 'Data', { exclusive: true });
+ * // Throws if file already exists
+ */
+export declare function writeFile(filePath: string, content: string, options?: FileOptions): Promise<void>;
+/**
+ * Safely append to file
+ * @param filePath - Path to file
+ * @param content - Content to append
+ * @param options - Append options
+ *
+ * @example
+ * await appendFile('./log.txt', 'New log entry\n');
+ *
+ * @example
+ * await appendFile('./data.jsonl', JSON.stringify(record) + '\n', { createDirs: true });
+ */
+export declare function appendFile(filePath: string, content: string, options?: FileOptions): Promise<void>;
+/**
+ * Check if file or directory exists
+ * @param filePath - Path to check
+ * @returns True if exists, false otherwise
+ *
+ * @example
+ * if (await exists('./config.json')) {
+ *   const config = await readFile('./config.json');
+ * }
+ *
+ * @example
+ * const fileExists = await exists('./data.txt');
+ * const dirExists = await exists('./src/');
+ */
+export declare function exists(filePath: string): Promise<boolean>;
+/**
+ * Delete file or directory
+ * @param filePath - Path to delete
+ * @param createBackup - Create backup before deleting
+ * @returns Backup path if created
+ *
+ * @example
+ * await deleteFile('./temp.txt');
+ *
+ * @example
+ * const backup = await deleteFile('./important.txt', true);
+ * console.log(`Backup created at: ${backup}`);
+ */
+export declare function deleteFile(filePath: string, createBackup?: boolean): Promise<string | undefined>;
+/**
+ * Get file size in bytes
+ * @param filePath - Path to file
+ * @returns File size in bytes
+ *
+ * @example
+ * const size = await getSize('./data.txt');
+ * console.log(`File size: ${(size / 1024).toFixed(2)} KB`);
+ *
+ * @example
+ * const size = await getSize('./large-file.bin');
+ * const sizeInMB = size / (1024 * 1024);
+ */
+export declare function getSize(filePath: string): Promise<number>;
+/**
+ * Get file modification time
+ * @param filePath - Path to file
+ * @returns Modification date
+ *
+ * @example
+ * const modTime = await getModTime('./config.json');
+ * console.log(`Last modified: ${modTime.toISOString()}`);
+ */
+export declare function getModTime(filePath: string): Promise<Date>;
+/**
+ * Check if path is a directory
+ * @param filePath - Path to check
+ * @returns True if directory
+ *
+ * @example
+ * if (await isDirectory('./src')) {
+ *   const files = await listFiles('./src');
+ * }
+ */
+export declare function isDirectory(filePath: string): Promise<boolean>;
+/**
+ * Check if path is a file
+ * @param filePath - Path to check
+ * @returns True if file
+ *
+ * @example
+ * if (await isFile('./data.json')) {
+ *   const data = await readFile('./data.json');
+ * }
+ */
+export declare function isFile(filePath: string): Promise<boolean>;
+/**
+ * List files in directory
+ * @param dirPath - Directory path
+ * @param options - List options
+ * @returns Array of file paths
+ *
+ * @example
+ * const files = await listFiles('./src');
+ *
+ * @example
+ * const tsFiles = await listFiles('./src', { extension: '.ts', recursive: true });
+ *
+ * @example
+ * const allFiles = await listFiles('./src', { recursive: true, filesOnly: true });
+ */
+export declare function listFiles(dirPath: string, options?: ListFilesOptions): Promise<string[]>;
+/**
+ * Get comprehensive file metadata
+ * @param filePath - Path to file
+ * @param includeHash - Include file hash (slower)
+ * @returns File metadata
+ *
+ * @example
+ * const meta = await getMetadata('./data.json');
+ * console.log(`Size: ${meta.size} bytes, Modified: ${meta.modTime}`);
+ *
+ * @example
+ * const meta = await getMetadata('./config.json', true);
+ * console.log(`Hash: ${meta.hash}`);
+ */
+export declare function getMetadata(filePath: string, includeHash?: boolean): Promise<FileMetadata>;
+/**
+ * Read file line by line
+ * @param filePath - Path to file
+ * @param callback - Callback for each line
+ *
+ * @example
+ * await readLinesSync('./data.txt', (line, index) => {
+ *   console.log(`Line ${index}: ${line}`);
+ * });
+ */
+export declare function readLinesSync(filePath: string, callback: (line: string, index: number) => void): Promise<void>;
+/**
+ * Copy file with optional verification
+ * @param sourcePath - Source file path
+ * @param destPath - Destination path
+ * @param verify - Verify copy with hash comparison
+ *
+ * @example
+ * await copyFile('./original.txt', './backup.txt');
+ *
+ * @example
+ * await copyFile('./data.bin', './data.backup', true);
+ * // Verifies file integrity after copy
+ */
+export declare function copyFile(sourcePath: string, destPath: string, verify?: boolean): Promise<void>;
+/**
+ * Batch process files
+ * @param pattern - Glob pattern or directory
+ * @param processor - Processor function
+ * @param options - List options
+ *
+ * @example
+ * await batchProcessFiles('./src', async (filePath) => {
+ *   const content = await readFile(filePath);
+ *   console.log(`Processing ${filePath}: ${content.length} bytes`);
+ * }, { extension: '.ts', recursive: true });
+ */
+export declare function batchProcessFiles(pattern: string, processor: (filePath: string) => Promise<void>, options?: ListFilesOptions): Promise<number>;
+/**
+ * Ensure directory exists
+ * @param dirPath - Directory path
+ *
+ * @example
+ * await ensureDir('./output/data');
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Resolve glob patterns (simple implementation)
+ * @param pattern - File path or directory
+ * @returns Array of matching files
+ *
+ * @example
+ * const files = await glob('./src/**\/*.ts');
+ */
+export declare function glob(pattern: string): Promise<string[]>;
+//# sourceMappingURL=file-operations.d.ts.map

package/dist/utils/file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.d.ts","sourceRoot":"","sources":["../../src/utils/file-operations.ts"],"names":[],"mappings":"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"}