@catbee/utils 0.0.1 → 0.0.3

package/build/esm/utils/fs.utils.d.ts

@@ -1,3 +1,5 @@
+import { BufferEncoding } from './crypto.utils';
+import { Stats } from 'fs';
 /**
  * Checks whether a file or directory exists at the given path.
  *
@@ -29,4 +31,134 @@ export declare function writeJsonFile(path: string, data: any, space?: number):
  * @returns {Promise<boolean>} Resolves to `true` if the file was deleted or didn't exist, `false` if deletion failed.
  */
 export declare function deleteFileIfExists(path: string): Promise<boolean>;
+/**
+ * Reads a text file from the specified path.
+ *
+ * @param {string} path - The path to the text file.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<string | null>} The file contents, or `null` if reading fails.
+ */
+export declare function readTextFile(path: string, encoding?: BufferEncoding): Promise<string | null>;
+/**
+ * Writes text content to a file.
+ *
+ * @param {string} path - The destination file path.
+ * @param {string} content - The text content to write.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export declare function writeTextFile(path: string, content: string, encoding?: BufferEncoding): Promise<boolean>;
+/**
+ * Appends text content to a file.
+ *
+ * @param {string} path - The file path to append to.
+ * @param {string} content - The text content to append.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export declare function appendTextFile(path: string, content: string, encoding?: BufferEncoding): Promise<boolean>;
+/**
+ * Copies a file from source to destination.
+ *
+ * @param {string} source - Source file path.
+ * @param {string} destination - Destination file path.
+ * @param {boolean} [overwrite=false] - Whether to overwrite if destination exists.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export declare function copyFile(source: string, destination: string, overwrite?: boolean): Promise<boolean>;
+/**
+ * Renames/moves a file.
+ *
+ * @param {string} oldPath - Current file path.
+ * @param {string} newPath - New file path.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export declare function moveFile(oldPath: string, newPath: string): Promise<boolean>;
+/**
+ * Gets file stats if the file exists.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<fs.Stats | null>} File stats object or null if file doesn't exist.
+ */
+export declare function getFileStats(path: string): Promise<Stats | null>;
+/**
+ * Creates a temporary file with optional content.
+ *
+ * @param {object} [options] - Options for creating the temp file.
+ * @param {string} [options.prefix="tmp-"] - Filename prefix.
+ * @param {string} [options.extension=""] - File extension.
+ * @param {string} [options.dir] - Directory to create the file in (defaults to OS temp dir).
+ * @param {string | Buffer} [options.content] - Optional content to write to the file.
+ * @returns {Promise<string>} Path to the created temporary file.
+ */
+export declare function createTempFile({ prefix, extension, dir, content }?: {
+    prefix?: string;
+    extension?: string;
+    dir?: string;
+    content?: string | Buffer;
+}): Promise<string>;
+/**
+ * Streams a file from source to destination.
+ * Useful for large files to avoid loading the entire file into memory.
+ *
+ * @param {string} source - Source file path.
+ * @param {string} destination - Destination file path.
+ * @returns {Promise<void>} Resolves when streaming completes.
+ * @throws {Error} If streaming fails.
+ */
+export declare function streamFile(source: string, destination: string): Promise<void>;
+/**
+ * Reads a directory and returns file names.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @param {object} [options] - Options for reading the directory.
+ * @param {boolean} [options.fullPaths=false] - Whether to return full paths.
+ * @param {RegExp} [options.filter] - Optional regex to filter files.
+ * @returns {Promise<string[]>} Array of file names or paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function readDirectory(dirPath: string, options?: {
+    fullPaths?: boolean;
+    filter?: RegExp;
+}): Promise<string[]>;
+/**
+ * Creates a directory if it doesn't exist.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @param {boolean} [recursive=true] - Whether to create parent directories.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export declare function createDirectory(dirPath: string, recursive?: boolean): Promise<boolean>;
+/**
+ * Safely reads and parses a JSON file with error details.
+ *
+ * @typeParam T - The expected type of the parsed JSON object.
+ * @param {string} path - The path to the JSON file.
+ * @returns {Promise<{ data: T | null; error: Error | null }>} Object with data and error properties.
+ */
+export declare function safeReadJsonFile<T = any>(path: string): Promise<{
+    data: T | null;
+    error: Error | null;
+}>;
+/**
+ * Checks if a path points to a file (not a directory).
+ *
+ * @param {string} path - Path to check.
+ * @returns {Promise<boolean>} True if the path is a file, false otherwise.
+ */
+export declare function isFile(path: string): Promise<boolean>;
+/**
+ * Gets the size of a file in bytes.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<number>} Size in bytes or -1 if file doesn't exist.
+ */
+export declare function getFileSize(path: string): Promise<number>;
+/**
+ * Reads a file as a Buffer.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<Buffer | null>} File contents as Buffer or null if reading fails.
+ */
+export declare function readFileBuffer(path: string): Promise<Buffer | null>;
 //# sourceMappingURL=fs.utils.d.ts.map

package/build/esm/utils/fs.utils.js

@@ -34,7 +34,12 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-import fs from "fs/promises";
+import fs from 'fs/promises';
+import { createReadStream, createWriteStream } from 'fs';
+import { tmpdir } from 'os';
+import path from 'path';
+import { pipeline } from 'stream/promises';
+import { randomUUID } from 'crypto';
 /**
  * Checks whether a file or directory exists at the given path.
  *
@@ -74,7 +79,7 @@ export function readJsonFile(path) {
             switch (_b.label) {
                 case 0:
                     _b.trys.push([0, 2, , 3]);
-                    return [4 /*yield*/, fs.readFile(path, "utf-8")];
+                    return [4 /*yield*/, fs.readFile(path, 'utf-8')];
                 case 1:
                     data = _b.sent();
                     return [2 /*return*/, JSON.parse(data)];
@@ -102,7 +107,7 @@ export function writeJsonFile(path_1, data_1) {
             switch (_a.label) {
                 case 0:
                     json = JSON.stringify(data, null, space);
-                    return [4 /*yield*/, fs.writeFile(path, json, "utf-8")];
+                    return [4 /*yield*/, fs.writeFile(path, json, 'utf-8')];
                 case 1:
                     _a.sent();
                     return [2 /*return*/];
@@ -129,7 +134,7 @@ export function deleteFileIfExists(path) {
                     return [2 /*return*/, true];
                 case 2:
                     err_1 = _a.sent();
-                    if (err_1.code === "ENOENT")
+                    if (err_1.code === 'ENOENT')
                         return [2 /*return*/, true];
                     return [2 /*return*/, false];
                 case 3: return [2 /*return*/];
@@ -137,4 +142,416 @@ export function deleteFileIfExists(path) {
         });
     });
 }
+/**
+ * Reads a text file from the specified path.
+ *
+ * @param {string} path - The path to the text file.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<string | null>} The file contents, or `null` if reading fails.
+ */
+export function readTextFile(path_1) {
+    return __awaiter(this, arguments, void 0, function (path, encoding) {
+        var _a;
+        if (encoding === void 0) { encoding = 'utf-8'; }
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.readFile(path, encoding)];
+                case 1: return [2 /*return*/, _b.sent()];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, null];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Writes text content to a file.
+ *
+ * @param {string} path - The destination file path.
+ * @param {string} content - The text content to write.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export function writeTextFile(path_1, content_1) {
+    return __awaiter(this, arguments, void 0, function (path, content, encoding) {
+        var _a;
+        if (encoding === void 0) { encoding = 'utf-8'; }
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.writeFile(path, content, encoding)];
+                case 1:
+                    _b.sent();
+                    return [2 /*return*/, true];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, false];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Appends text content to a file.
+ *
+ * @param {string} path - The file path to append to.
+ * @param {string} content - The text content to append.
+ * @param {BufferEncoding} [encoding="utf-8"] - The encoding to use.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export function appendTextFile(path_1, content_1) {
+    return __awaiter(this, arguments, void 0, function (path, content, encoding) {
+        var _a;
+        if (encoding === void 0) { encoding = 'utf-8'; }
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.appendFile(path, content, encoding)];
+                case 1:
+                    _b.sent();
+                    return [2 /*return*/, true];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, false];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Copies a file from source to destination.
+ *
+ * @param {string} source - Source file path.
+ * @param {string} destination - Destination file path.
+ * @param {boolean} [overwrite=false] - Whether to overwrite if destination exists.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export function copyFile(source_1, destination_1) {
+    return __awaiter(this, arguments, void 0, function (source, destination, overwrite) {
+        var flags, _a;
+        if (overwrite === void 0) { overwrite = false; }
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    flags = overwrite ? 0 : fs.constants.COPYFILE_EXCL;
+                    return [4 /*yield*/, fs.copyFile(source, destination, flags)];
+                case 1:
+                    _b.sent();
+                    return [2 /*return*/, true];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, false];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Renames/moves a file.
+ *
+ * @param {string} oldPath - Current file path.
+ * @param {string} newPath - New file path.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export function moveFile(oldPath, newPath) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _c.trys.push([0, 2, , 8]);
+                    return [4 /*yield*/, fs.rename(oldPath, newPath)];
+                case 1:
+                    _c.sent();
+                    return [2 /*return*/, true];
+                case 2:
+                    _a = _c.sent();
+                    _c.label = 3;
+                case 3:
+                    _c.trys.push([3, 6, , 7]);
+                    return [4 /*yield*/, fs.copyFile(oldPath, newPath)];
+                case 4:
+                    _c.sent();
+                    return [4 /*yield*/, fs.unlink(oldPath)];
+                case 5:
+                    _c.sent();
+                    return [2 /*return*/, true];
+                case 6:
+                    _b = _c.sent();
+                    return [2 /*return*/, false];
+                case 7: return [3 /*break*/, 8];
+                case 8: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Gets file stats if the file exists.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<fs.Stats | null>} File stats object or null if file doesn't exist.
+ */
+export function getFileStats(path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.stat(path)];
+                case 1: return [2 /*return*/, _b.sent()];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, null];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Creates a temporary file with optional content.
+ *
+ * @param {object} [options] - Options for creating the temp file.
+ * @param {string} [options.prefix="tmp-"] - Filename prefix.
+ * @param {string} [options.extension=""] - File extension.
+ * @param {string} [options.dir] - Directory to create the file in (defaults to OS temp dir).
+ * @param {string | Buffer} [options.content] - Optional content to write to the file.
+ * @returns {Promise<string>} Path to the created temporary file.
+ */
+export function createTempFile() {
+    return __awaiter(this, arguments, void 0, function (_a) {
+        var ext, filename, filepath;
+        var _b = _a === void 0 ? {} : _a, _c = _b.prefix, prefix = _c === void 0 ? 'tmp-' : _c, _d = _b.extension, extension = _d === void 0 ? '' : _d, _e = _b.dir, dir = _e === void 0 ? tmpdir() : _e, content = _b.content;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    ext = extension ? (extension.startsWith('.') ? extension : ".".concat(extension)) : '';
+                    filename = "".concat(prefix).concat(randomUUID()).concat(ext);
+                    filepath = path.join(dir, filename);
+                    if (!content) return [3 /*break*/, 2];
+                    return [4 /*yield*/, fs.writeFile(filepath, content)];
+                case 1:
+                    _f.sent();
+                    return [3 /*break*/, 4];
+                case 2: return [4 /*yield*/, fs.writeFile(filepath, '')];
+                case 3:
+                    _f.sent();
+                    _f.label = 4;
+                case 4: return [2 /*return*/, filepath];
+            }
+        });
+    });
+}
+/**
+ * Streams a file from source to destination.
+ * Useful for large files to avoid loading the entire file into memory.
+ *
+ * @param {string} source - Source file path.
+ * @param {string} destination - Destination file path.
+ * @returns {Promise<void>} Resolves when streaming completes.
+ * @throws {Error} If streaming fails.
+ */
+export function streamFile(source, destination) {
+    return __awaiter(this, void 0, void 0, function () {
+        var readStream, writeStream, error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    readStream = createReadStream(source);
+                    writeStream = createWriteStream(destination);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, pipeline(readStream, writeStream)];
+                case 2:
+                    _a.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    error_1 = _a.sent();
+                    // Ensure both streams are closed in case of error
+                    readStream.destroy();
+                    writeStream.destroy();
+                    throw error_1;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Reads a directory and returns file names.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @param {object} [options] - Options for reading the directory.
+ * @param {boolean} [options.fullPaths=false] - Whether to return full paths.
+ * @param {RegExp} [options.filter] - Optional regex to filter files.
+ * @returns {Promise<string[]>} Array of file names or paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export function readDirectory(dirPath_1) {
+    return __awaiter(this, arguments, void 0, function (dirPath, options) {
+        var files, result;
+        if (options === void 0) { options = {}; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, fs.readdir(dirPath)];
+                case 1:
+                    files = _a.sent();
+                    result = files;
+                    if (options.filter) {
+                        result = result.filter(function (file) { return options.filter.test(file); });
+                    }
+                    if (options.fullPaths) {
+                        result = result.map(function (file) { return path.join(dirPath, file); });
+                    }
+                    return [2 /*return*/, result];
+            }
+        });
+    });
+}
+/**
+ * Creates a directory if it doesn't exist.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @param {boolean} [recursive=true] - Whether to create parent directories.
+ * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.
+ */
+export function createDirectory(dirPath_1) {
+    return __awaiter(this, arguments, void 0, function (dirPath, recursive) {
+        var err_2;
+        if (recursive === void 0) { recursive = true; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.mkdir(dirPath, { recursive: recursive })];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/, true];
+                case 2:
+                    err_2 = _a.sent();
+                    // Consider it success if directory already exists
+                    return [2 /*return*/, err_2.code === 'EEXIST'];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Safely reads and parses a JSON file with error details.
+ *
+ * @typeParam T - The expected type of the parsed JSON object.
+ * @param {string} path - The path to the JSON file.
+ * @returns {Promise<{ data: T | null; error: Error | null }>} Object with data and error properties.
+ */
+export function safeReadJsonFile(path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var content, data, error_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.readFile(path, 'utf-8')];
+                case 1:
+                    content = _a.sent();
+                    try {
+                        data = JSON.parse(content);
+                        return [2 /*return*/, { data: data, error: null }];
+                    }
+                    catch (error) {
+                        return [2 /*return*/, {
+                                data: null,
+                                error: new Error("Invalid JSON in file ".concat(path, ": ").concat(error.message))
+                            }];
+                    }
+                    return [3 /*break*/, 3];
+                case 2:
+                    error_2 = _a.sent();
+                    return [2 /*return*/, {
+                            data: null,
+                            error: new Error("Failed to read file ".concat(path, ": ").concat(error_2.message))
+                        }];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Checks if a path points to a file (not a directory).
+ *
+ * @param {string} path - Path to check.
+ * @returns {Promise<boolean>} True if the path is a file, false otherwise.
+ */
+export function isFile(path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var stat, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.stat(path)];
+                case 1:
+                    stat = _b.sent();
+                    return [2 /*return*/, stat.isFile()];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, false];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Gets the size of a file in bytes.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<number>} Size in bytes or -1 if file doesn't exist.
+ */
+export function getFileSize(path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var stat, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.stat(path)];
+                case 1:
+                    stat = _b.sent();
+                    return [2 /*return*/, stat.size];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, -1];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Reads a file as a Buffer.
+ *
+ * @param {string} path - Path to the file.
+ * @returns {Promise<Buffer | null>} File contents as Buffer or null if reading fails.
+ */
+export function readFileBuffer(path) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fs.readFile(path)];
+                case 1: return [2 /*return*/, _b.sent()];
+                case 2:
+                    _a = _b.sent();
+                    return [2 /*return*/, null];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
 //# sourceMappingURL=fs.utils.js.map

package/build/esm/utils/fs.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.utils.js","sourceRoot":"","sources":["../../../src/utils/fs.utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,UAAgB,UAAU,CAAC,IAAY;;;;;;;oBAEzC,qBAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAA;;oBAArB,SAAqB,CAAC;oBACtB,sBAAO,IAAI,EAAC;;;oBAEZ,sBAAO,KAAK,EAAC;;;;;CAEhB;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,YAAY,CAAU,IAAY;;;;;;;oBAEvC,qBAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAA;;oBAAvC,IAAI,GAAG,SAAgC;oBAC7C,sBAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,EAAC;;;oBAE7B,sBAAO,IAAI,EAAC;;;;;CAEf;AAED;;;;;;;GAOG;AACH,MAAM,UAAgB,aAAa;wDACjC,IAAY,EACZ,IAAS,EACT,KAAS;;QAAT,sBAAA,EAAA,SAAS;;;;oBAEH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC/C,qBAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAA;;oBAAvC,SAAuC,CAAC;;;;;CACzC;AAED;;;;;GAKG;AACH,MAAM,UAAgB,kBAAkB,CAAC,IAAY;;;;;;;oBAEjD,qBAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAA;;oBAArB,SAAqB,CAAC;oBACtB,sBAAO,IAAI,EAAC;;;oBAEZ,IAAI,KAAG,CAAC,IAAI,KAAK,QAAQ;wBAAE,sBAAO,IAAI,EAAC;oBACvC,sBAAO,KAAK,EAAC;;;;;CAEhB","sourcesContent":["import fs from \"fs/promises\";\n\n/**\n * Checks whether a file or directory exists at the given path.\n *\n * @param {string} path - The file or directory path to check.\n * @returns {Promise<boolean>} Resolves to `true` if the path exists, `false` otherwise.\n */\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await fs.access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Reads and parses a JSON file from the specified path.\n *\n * @typeParam T - The expected type of the parsed JSON object.\n * @param {string} path - The path to the JSON file.\n * @returns {Promise<T | null>} The parsed object, or `null` if reading or parsing fails.\n */\nexport async function readJsonFile<T = any>(path: string): Promise<T | null> {\n  try {\n    const data = await fs.readFile(path, \"utf-8\");\n    return JSON.parse(data) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Writes a JavaScript object to a file as formatted JSON.\n *\n * @param {string} path - The destination file path.\n * @param {any} data - The object to serialize and write.\n * @param {number} [space=2] - Number of spaces for JSON formatting.\n * @returns {Promise<void>} Resolves when writing is complete.\n */\nexport async function writeJsonFile(\n  path: string,\n  data: any,\n  space = 2,\n): Promise<void> {\n  const json = JSON.stringify(data, null, space);\n  await fs.writeFile(path, json, \"utf-8\");\n}\n\n/**\n * Deletes a file if it exists.\n *\n * @param {string} path - The file path to delete.\n * @returns {Promise<boolean>} Resolves to `true` if the file was deleted or didn't exist, `false` if deletion failed.\n */\nexport async function deleteFileIfExists(path: string): Promise<boolean> {\n  try {\n    await fs.unlink(path);\n    return true;\n  } catch (err: any) {\n    if (err.code === \"ENOENT\") return true;\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"fs.utils.js","sourceRoot":"","sources":["../../../src/utils/fs.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { BufferEncoding } from './crypto.utils';\nimport fs from 'fs/promises';\nimport { createReadStream, createWriteStream, Stats } from 'fs';\nimport { tmpdir } from 'os';\nimport path from 'path';\nimport { pipeline } from 'stream/promises';\nimport { randomUUID } from 'crypto';\n\n/**\n * Checks whether a file or directory exists at the given path.\n *\n * @param {string} path - The file or directory path to check.\n * @returns {Promise<boolean>} Resolves to `true` if the path exists, `false` otherwise.\n */\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await fs.access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Reads and parses a JSON file from the specified path.\n *\n * @typeParam T - The expected type of the parsed JSON object.\n * @param {string} path - The path to the JSON file.\n * @returns {Promise<T | null>} The parsed object, or `null` if reading or parsing fails.\n */\nexport async function readJsonFile<T = any>(path: string): Promise<T | null> {\n  try {\n    const data = await fs.readFile(path, 'utf-8');\n    return JSON.parse(data) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Writes a JavaScript object to a file as formatted JSON.\n *\n * @param {string} path - The destination file path.\n * @param {any} data - The object to serialize and write.\n * @param {number} [space=2] - Number of spaces for JSON formatting.\n * @returns {Promise<void>} Resolves when writing is complete.\n */\nexport async function writeJsonFile(path: string, data: any, space = 2): Promise<void> {\n  const json = JSON.stringify(data, null, space);\n  await fs.writeFile(path, json, 'utf-8');\n}\n\n/**\n * Deletes a file if it exists.\n *\n * @param {string} path - The file path to delete.\n * @returns {Promise<boolean>} Resolves to `true` if the file was deleted or didn't exist, `false` if deletion failed.\n */\nexport async function deleteFileIfExists(path: string): Promise<boolean> {\n  try {\n    await fs.unlink(path);\n    return true;\n  } catch (err: any) {\n    if (err.code === 'ENOENT') return true;\n    return false;\n  }\n}\n\n/**\n * Reads a text file from the specified path.\n *\n * @param {string} path - The path to the text file.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<string | null>} The file contents, or `null` if reading fails.\n */\nexport async function readTextFile(path: string, encoding: BufferEncoding = 'utf-8'): Promise<string | null> {\n  try {\n    return await fs.readFile(path, encoding);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Writes text content to a file.\n *\n * @param {string} path - The destination file path.\n * @param {string} content - The text content to write.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function writeTextFile(\n  path: string,\n  content: string,\n  encoding: BufferEncoding = 'utf-8'\n): Promise<boolean> {\n  try {\n    await fs.writeFile(path, content, encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Appends text content to a file.\n *\n * @param {string} path - The file path to append to.\n * @param {string} content - The text content to append.\n * @param {BufferEncoding} [encoding=\"utf-8\"] - The encoding to use.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function appendTextFile(\n  path: string,\n  content: string,\n  encoding: BufferEncoding = 'utf-8'\n): Promise<boolean> {\n  try {\n    await fs.appendFile(path, content, encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Copies a file from source to destination.\n *\n * @param {string} source - Source file path.\n * @param {string} destination - Destination file path.\n * @param {boolean} [overwrite=false] - Whether to overwrite if destination exists.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function copyFile(source: string, destination: string, overwrite = false): Promise<boolean> {\n  try {\n    const flags = overwrite ? 0 : fs.constants.COPYFILE_EXCL;\n    await fs.copyFile(source, destination, flags);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Renames/moves a file.\n *\n * @param {string} oldPath - Current file path.\n * @param {string} newPath - New file path.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function moveFile(oldPath: string, newPath: string): Promise<boolean> {\n  try {\n    await fs.rename(oldPath, newPath);\n    return true;\n  } catch {\n    // If rename fails (e.g., across devices), try copy+delete\n    try {\n      await fs.copyFile(oldPath, newPath);\n      await fs.unlink(oldPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\n/**\n * Gets file stats if the file exists.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<fs.Stats | null>} File stats object or null if file doesn't exist.\n */\nexport async function getFileStats(path: string): Promise<Stats | null> {\n  try {\n    return await fs.stat(path);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Creates a temporary file with optional content.\n *\n * @param {object} [options] - Options for creating the temp file.\n * @param {string} [options.prefix=\"tmp-\"] - Filename prefix.\n * @param {string} [options.extension=\"\"] - File extension.\n * @param {string} [options.dir] - Directory to create the file in (defaults to OS temp dir).\n * @param {string | Buffer} [options.content] - Optional content to write to the file.\n * @returns {Promise<string>} Path to the created temporary file.\n */\nexport async function createTempFile({\n  prefix = 'tmp-',\n  extension = '',\n  dir = tmpdir(),\n  content\n}: {\n  prefix?: string;\n  extension?: string;\n  dir?: string;\n  content?: string | Buffer;\n} = {}): Promise<string> {\n  const ext = extension ? (extension.startsWith('.') ? extension : `.${extension}`) : '';\n  const filename = `${prefix}${randomUUID()}${ext}`;\n  const filepath = path.join(dir, filename);\n\n  if (content) {\n    await fs.writeFile(filepath, content);\n  } else {\n    await fs.writeFile(filepath, '');\n  }\n\n  return filepath;\n}\n\n/**\n * Streams a file from source to destination.\n * Useful for large files to avoid loading the entire file into memory.\n *\n * @param {string} source - Source file path.\n * @param {string} destination - Destination file path.\n * @returns {Promise<void>} Resolves when streaming completes.\n * @throws {Error} If streaming fails.\n */\nexport async function streamFile(source: string, destination: string): Promise<void> {\n  const readStream = createReadStream(source);\n  const writeStream = createWriteStream(destination);\n\n  try {\n    await pipeline(readStream, writeStream);\n  } catch (error) {\n    // Ensure both streams are closed in case of error\n    readStream.destroy();\n    writeStream.destroy();\n    throw error;\n  }\n}\n\n/**\n * Reads a directory and returns file names.\n *\n * @param {string} dirPath - Path to the directory.\n * @param {object} [options] - Options for reading the directory.\n * @param {boolean} [options.fullPaths=false] - Whether to return full paths.\n * @param {RegExp} [options.filter] - Optional regex to filter files.\n * @returns {Promise<string[]>} Array of file names or paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function readDirectory(\n  dirPath: string,\n  options: { fullPaths?: boolean; filter?: RegExp } = {}\n): Promise<string[]> {\n  const files = await fs.readdir(dirPath);\n\n  let result = files;\n\n  if (options.filter) {\n    result = result.filter(file => options.filter!.test(file));\n  }\n\n  if (options.fullPaths) {\n    result = result.map(file => path.join(dirPath, file));\n  }\n\n  return result;\n}\n\n/**\n * Creates a directory if it doesn't exist.\n *\n * @param {string} dirPath - Path to the directory.\n * @param {boolean} [recursive=true] - Whether to create parent directories.\n * @returns {Promise<boolean>} Resolves to `true` if successful, `false` otherwise.\n */\nexport async function createDirectory(dirPath: string, recursive = true): Promise<boolean> {\n  try {\n    await fs.mkdir(dirPath, { recursive });\n    return true;\n  } catch (err: any) {\n    // Consider it success if directory already exists\n    return err.code === 'EEXIST';\n  }\n}\n\n/**\n * Safely reads and parses a JSON file with error details.\n *\n * @typeParam T - The expected type of the parsed JSON object.\n * @param {string} path - The path to the JSON file.\n * @returns {Promise<{ data: T | null; error: Error | null }>} Object with data and error properties.\n */\nexport async function safeReadJsonFile<T = any>(path: string): Promise<{ data: T | null; error: Error | null }> {\n  try {\n    const content = await fs.readFile(path, 'utf-8');\n    try {\n      const data = JSON.parse(content) as T;\n      return { data, error: null };\n    } catch (error: any) {\n      return {\n        data: null,\n        error: new Error(`Invalid JSON in file ${path}: ${error.message}`)\n      };\n    }\n  } catch (error: any) {\n    return {\n      data: null,\n      error: new Error(`Failed to read file ${path}: ${error.message}`)\n    };\n  }\n}\n\n/**\n * Checks if a path points to a file (not a directory).\n *\n * @param {string} path - Path to check.\n * @returns {Promise<boolean>} True if the path is a file, false otherwise.\n */\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Gets the size of a file in bytes.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<number>} Size in bytes or -1 if file doesn't exist.\n */\nexport async function getFileSize(path: string): Promise<number> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.size;\n  } catch {\n    return -1;\n  }\n}\n\n/**\n * Reads a file as a Buffer.\n *\n * @param {string} path - Path to the file.\n * @returns {Promise<Buffer | null>} File contents as Buffer or null if reading fails.\n */\nexport async function readFileBuffer(path: string): Promise<Buffer | null> {\n  try {\n    return await fs.readFile(path);\n  } catch {\n    return null;\n  }\n}\n"]}