@breadstone-infrastructure/utilities 0.0.12-beta.0

package/IO/File.js

@@ -0,0 +1,314 @@
+"use strict";
+// #region Imports
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.File = void 0;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const fse = __importStar(require("fs-extra"));
+const xml2js = __importStar(require("xml2js"));
+const Error_1 = require("../System/Error");
+const String_1 = require("../System/String");
+const Languages_1 = require("../Intl/Languages");
+const Directory_1 = require("./Directory");
+const Path_1 = require("./Path");
+const Json_1 = require("./Json");
+// #endregion
+class File {
+    // #region Methods
+    /**
+     * Determines whether the specified file exists.
+     * @public
+     * @static
+     * @param {string} path The file to check.
+     * @returns {boolean} `true` if the caller has the required permissions and path contains the name of an existing file; otherwise, `false`. This method also returns `false` if `path` is `null`, an invalid path, or a zero-length string. If the caller does not have sufficient permissions to read the specified file, no exception is thrown and the method returns `false` regardless of the existence of `path`.
+     */
+    static exists(path) {
+        if (typeof path !== 'string') {
+            throw new Error('Argument \'path\' is not of type string.');
+        }
+        return fs.existsSync(path);
+    }
+    /**
+     * Copies an existing file to a new file.
+     * @public
+     * @static
+     * @param {string} sourceFileName The file to copy.
+     * @param {string} destFileName The name of the destination file.
+     * @param {boolean} overwrite `true` if the destination file can be overwritten. Otherwise, `false`.
+     * @returns {void}
+     */
+    static copy(sourceFileName, destFileName, overwrite = false) {
+        fse.copySync(sourceFileName, destFileName, { overwrite: overwrite });
+    }
+    /**
+     * Opens a file, reads all text in the file with the specified encoding, and then closes the file.
+     * @public
+     * @static
+     * @param {string} path The file to open for reading.
+     * @param {Encoding} encoding The encoding applied to the contents of the file.
+     * @returns {string} A string containing all text in the file.
+     */
+    static readAllText(path, encoding = 'utf8') {
+        if (fs.existsSync(path)) {
+            let content = fs.readFileSync(path, encoding);
+            if (content.charCodeAt(0) === 0xFEFF) {
+                content = content.slice(1);
+            }
+            return content;
+        }
+        throw new Error(`Unable to read path '${path}'.`);
+    }
+    /**
+     * Opens a binary file, reads the contents of the file into a byte array, and then closes the file.
+     * @public
+     * @static
+     * @param {string} path - The file to open for reading.
+     * @returns {Buffer} A buffer containing the contents of the file.
+     */
+    static readAllBytes(path) {
+        return fs.readFileSync(path);
+    }
+    /**
+     * Creates a new file, write the contents to the file, and then closes the file. If the target file already exists, it is overwritten.
+     * @public
+     * @static
+     * @param {string} path The file to write to.
+     * @param {string} contents The string to write to the file.
+     * @param {Encoding} encoding The encoding to apply to the string.
+     * @returns {void}
+     */
+    static writeAllText(path, contents, encoding = 'utf8') {
+        const dirname = Path_1.Path.getDirectoryName(path);
+        if (!fs.existsSync(dirname)) {
+            fse.mkdirsSync(dirname);
+            File.writeAllText(path, contents);
+        }
+        else {
+            if (fs.existsSync(path)) {
+                const stat = fs.statSync(path);
+                // Check readonly
+                if ((stat.mode & 146) === 0) {
+                    throw new Error(`Path '${path}' could not be written, because it's ready only.`);
+                }
+            }
+            fs.writeFileSync(path, contents, encoding);
+        }
+    }
+    /**
+     * Creates a new file, write the contents to the file, and then closes the file. If the target file already exists, it is overwritten.
+     * @public
+     * @static
+     * @param {string} path The file to write to.
+     * @param {unknown} data The json data to write
+     * @param {Encoding} encoding The encoding to apply to the string.
+     * @returns {void}
+     */
+    static writeAllJson(path, data, encoding = 'utf8') {
+        try {
+            File.writeAllText(path, JSON.stringify(data, null, 4), encoding);
+        }
+        catch (error) {
+            throw new Error(`Unable to write file '${path}'.${String_1.StringExtensions.newLine}${(0, Error_1.extractError)(error)}`);
+        }
+    }
+    /**
+     * Deletes the specified file.
+     * @public
+     * @static
+     * @param {string} path The name of the file to be deleted. Wildcard characters are not supported.
+     * @returns {void}
+     */
+    static delete(path) {
+        if (path === '') {
+            throw new Error('thThe path cannot be empty.');
+        }
+        fs.unlinkSync(path);
+    }
+    /**
+     * Moves a specified file to a new location, providing the option to specify a new file name.
+     * @public
+     * @static
+     * @param {string} sourceFileName The name of the file to move. Can include a relative or absolute path.
+     * @param {string} destFileName The new path and name for the file.
+     * @returns {void}
+     */
+    static move(sourceFileName, destFileName) {
+        fs.renameSync(sourceFileName, destFileName);
+    }
+    // #endregion
+    /**
+     * @public
+     * @static
+     * @param {string} file The json file to read
+     * @returns {object} a json object
+     */
+    static readAllJson(file) {
+        try {
+            const data = File.readAllText(file);
+            return Json_1.Json.parse(data).entries;
+        }
+        catch (error) {
+            throw new Error(`Unable to parse file '${file}'.${String_1.StringExtensions.newLine}${(0, Error_1.extractError)(error)}`);
+        }
+    }
+    /**
+     * @public
+     * @static
+     * @param {string} file The resx file to read
+     * @returns {Array<IResxEntry>} a resx object
+     */
+    static readAllResx(file) {
+        try {
+            let elements = new Array();
+            const data = File.readAllText(file);
+            new xml2js.Parser().parseString(data, (err, result) => {
+                if (err) {
+                    throw err;
+                }
+                if (result?.root?.data) {
+                    elements = result.root.data.map((x) => ({
+                        key: x.$.name,
+                        value: (x.value ?? [])[0],
+                        comment: (x.comment ?? [])[0] ?? ''
+                    }), {});
+                }
+            });
+            return elements;
+        }
+        catch (error) {
+            throw new Error(`Unable to parse file '${file}'.${String_1.StringExtensions.newLine}${(0, Error_1.extractError)(error)}`);
+        }
+    }
+    /**
+     * @public
+     * @static
+     * @param {string} file The xml file to read
+     * @returns {T} a xml object
+     */
+    static readAllXml(file) {
+        try {
+            let result = null;
+            const data = File.readAllText(file);
+            new xml2js.Parser().parseString(data, (err, r) => {
+                if (err) {
+                    throw err;
+                }
+                result = r;
+            });
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Unable to parse file '${file}'.${String_1.StringExtensions.newLine}${(0, Error_1.extractError)(error)}`);
+        }
+    }
+    /**
+     * @public
+     * @static
+     * @param {string} file The file to hash
+     * @param {string} algorithm The crypto hash algorithm
+     * @param {string} encoding The crypto hash encoding
+     * @description Creates a hash from a file.
+     * @returns {Promise<string | Buffer>} A promise with hash object as string or buffer
+     */
+    static hash(file, algorithm = 'md5', encoding = 'hex') {
+        const hash = crypto.createHash(algorithm).setEncoding(encoding);
+        const stream = fs.createReadStream(file);
+        return new Promise((resolve, reject) => {
+            stream.on('end', () => {
+                hash.end();
+                resolve(hash.read());
+            });
+            stream.on('error', reject);
+            stream.pipe(hash);
+        });
+    }
+    /**
+     * Find files using glob patterns.
+     *
+     * @public
+     * @static
+     * @param {string | string[]} pattern - The globbing pattern
+     * @returns {string[]} The Files
+     */
+    static glob(pattern) {
+        return Path_1.Path.glob(pattern, { onlyFiles: true });
+    }
+    /**
+     * Extracts the local from a file.
+     *
+     * @public
+     * @static
+     * @param {string} file The file
+     * @param {string} defaultLocale The default locale
+     * @returns {string[]} The Files
+     */
+    static getLocale(file, defaultLocale = 'en') {
+        let index = file.lastIndexOf('.');
+        const fileNameWithoutExt = file.substring(0, index);
+        index = fileNameWithoutExt.lastIndexOf('.');
+        let match = '';
+        if (index >= 0) {
+            match = fileNameWithoutExt.substring(index + 1, fileNameWithoutExt.length);
+        }
+        if (!Languages_1.Languages.has(match)) {
+            match = defaultLocale;
+        }
+        return match;
+    }
+    /**
+     * Gets the size of a file.
+     *
+     * @public
+     * @static
+     * @param {string} file The file
+     * @returns {number} The file size.
+     */
+    static size(file) {
+        const stats = fs.statSync(file);
+        return stats.size;
+    }
+    /**
+     * Create a new symbolic link to an existing file, directory or junction.
+     *
+     * @public
+     * @static
+     * @param {string} src The source file or directory.
+     * @param {string} dest The destination file or directory.
+     * @param {SymbolicLink} symbolicLink The type of symbolic should create.
+     */
+    static createSymbolicLink(src, dest, symbolicLink) {
+        if (!Directory_1.Directory.exists(dest)) {
+            Directory_1.Directory.create(dest);
+            Directory_1.Directory.delete(dest);
+        }
+        else {
+            Directory_1.Directory.delete(dest);
+        }
+        fse.symlinkSync(src, dest, symbolicLink);
+    }
+}
+exports.File = File;
+//# sourceMappingURL=File.js.map

package/IO/File.js.map

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

package/IO/FileSystemInfo.d.ts

@@ -0,0 +1,46 @@
+export declare class FileSystemInfo {
+    private readonly _fullPath;
+    /**
+     * Constructs a new `FileSystemInfo` instance.
+     *
+     * @param fullPath - The full path to the file or directory.
+     */
+    constructor(fullPath: string);
+    /**
+     * Gets the full path of the file or directory.
+     */
+    get fullPath(): string;
+    /**
+     * Gets the directory path of the file or directory.
+     */
+    get directoryPath(): string;
+    /**
+     * Gets the name of the file or directory.
+     */
+    get name(): string;
+    /**
+     * Determines whether the path represents a file.
+     */
+    isFile(): boolean;
+    /**
+     * Determines whether the path represents a directory.
+     */
+    isDirectory(): boolean;
+    /**
+     * Gets the creation time of the file or directory.
+     */
+    get creationTime(): Date | null;
+    /**
+     * Gets the last modification time of the file or directory.
+     */
+    get lastModifiedTime(): Date | null;
+    /**
+     * Gets the size of the file or directory (in bytes).
+     */
+    get size(): number | null;
+    /**
+     * Determines if the path exists.
+     */
+    exists(): boolean;
+}
+//# sourceMappingURL=FileSystemInfo.d.ts.map

package/IO/FileSystemInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemInfo.d.ts","sourceRoot":"","sources":["../../src/IO/FileSystemInfo.ts"],"names":[],"mappings":"AAOA,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAMnC;;;;OAIG;gBACgB,QAAQ,EAAE,MAAM;IAQnC;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACI,MAAM,IAAI,OAAO;IAQxB;;OAEG;IACI,WAAW,IAAI,OAAO;IAQ7B;;OAEG;IACH,IAAW,YAAY,IAAI,IAAI,GAAG,IAAI,CAMrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,IAAI,GAAG,IAAI,CAMzC;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,GAAG,IAAI,CAM/B;IAMD;;OAEG;IACI,MAAM,IAAI,OAAO;CAM3B"}

package/IO/FileSystemInfo.js

@@ -0,0 +1,129 @@
+"use strict";
+// #region Imports
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemInfo = void 0;
+const fs = __importStar(require("fs"));
+const Path_1 = require("./Path");
+// #endregion
+class FileSystemInfo {
+    // #region Fields
+    _fullPath;
+    // #endregion
+    // #region Ctor
+    /**
+     * Constructs a new `FileSystemInfo` instance.
+     *
+     * @param fullPath - The full path to the file or directory.
+     */
+    constructor(fullPath) {
+        this._fullPath = Path_1.Path.resolve(fullPath);
+    }
+    // #endregion
+    // #region Properties
+    /**
+     * Gets the full path of the file or directory.
+     */
+    get fullPath() {
+        return this._fullPath;
+    }
+    /**
+     * Gets the directory path of the file or directory.
+     */
+    get directoryPath() {
+        return Path_1.Path.getDirectoryName(this._fullPath);
+    }
+    /**
+     * Gets the name of the file or directory.
+     */
+    get name() {
+        return Path_1.Path.getFileName(this._fullPath);
+    }
+    /**
+     * Determines whether the path represents a file.
+     */
+    isFile() {
+        try {
+            return fs.statSync(this._fullPath).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Determines whether the path represents a directory.
+     */
+    isDirectory() {
+        try {
+            return fs.statSync(this._fullPath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Gets the creation time of the file or directory.
+     */
+    get creationTime() {
+        try {
+            return fs.statSync(this._fullPath).birthtime;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Gets the last modification time of the file or directory.
+     */
+    get lastModifiedTime() {
+        try {
+            return fs.statSync(this._fullPath).mtime;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Gets the size of the file or directory (in bytes).
+     */
+    get size() {
+        try {
+            return this.isFile() ? fs.statSync(this._fullPath).size : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // #endregion
+    // #region Imports
+    /**
+     * Determines if the path exists.
+     */
+    exists() {
+        return fs.existsSync(this._fullPath);
+    }
+}
+exports.FileSystemInfo = FileSystemInfo;
+//# sourceMappingURL=FileSystemInfo.js.map

package/IO/FileSystemInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemInfo.js","sourceRoot":"","sources":["../../src/IO/FileSystemInfo.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;AAElB,uCAAyB;AACzB,iCAA8B;AAE9B,aAAa;AAEb,MAAa,cAAc;IAEvB,iBAAiB;IAEA,SAAS,CAAS;IAEnC,aAAa;IAEb,eAAe;IAEf;;;;OAIG;IACH,YAAmB,QAAgB;QAC/B,IAAI,CAAC,SAAS,GAAG,WAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,aAAa;QACpB,OAAO,WAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,MAAM;QACT,IAAI,CAAC;YACD,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;OAEG;IACI,WAAW;QACd,IAAI,CAAC;YACD,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACnB,IAAI,CAAC;YACD,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACvB,IAAI,CAAC;YACD,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;OAEG;IACI,MAAM;QACT,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CAIJ;AAhHD,wCAgHC"}

package/IO/FileSystemWatcher.d.ts

@@ -0,0 +1,49 @@
+import { EventEmitter } from 'events';
+/**
+ * Options for the FileSystemWatcher.
+ */
+export interface IFileSystemWatcherOptions {
+    path: string;
+    includeSubdirectories?: boolean;
+    filter?: string | Array<string>;
+}
+/**
+ * Events for file system changes.
+ */
+export interface IFileSystemWatcherEventMap {
+    created: [filePath: string];
+    changed: [filePath: string];
+    deleted: [filePath: string];
+}
+/**
+ * A class to monitor file system changes, inspired by .NET's FileSystemWatcher.
+ */
+export declare class FileSystemWatcher extends EventEmitter<IFileSystemWatcherEventMap> {
+    private _watcher?;
+    private readonly _options;
+    private readonly _filteredPaths;
+    /**
+     * Constructs a new FileSystemWatcher.
+     * @param options - The options for the watcher.
+     */
+    constructor(options: IFileSystemWatcherOptions);
+    /**
+     * Starts watching the file system for changes.
+     */
+    start(): void;
+    /**
+     * Stops watching the file system.
+     */
+    stop(): void;
+    /**
+     * Initializes the filtered paths based on the provided glob patterns.
+     */
+    private initializeFilteredPaths;
+    /**
+     * Determines if a file path matches the filter criteria.
+     * @param filePath - The file path to check.
+     * @returns `true` if the path matches the filter, otherwise `false`.
+     */
+    private isFiltered;
+}
+//# sourceMappingURL=FileSystemWatcher.d.ts.map

package/IO/FileSystemWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemWatcher.d.ts","sourceRoot":"","sources":["../../src/IO/FileSystemWatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAQtC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,0BAA0B,CAAC;IAE3E,OAAO,CAAC,QAAQ,CAAC,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;IAE7C;;;OAGG;gBACgB,OAAO,EAAE,yBAAyB;IAerD;;OAEG;IACI,KAAK,IAAI,IAAI;IA6BpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAKnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAIrB"}

package/IO/FileSystemWatcher.js

@@ -0,0 +1,93 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemWatcher = void 0;
+const events_1 = require("events");
+const fs_1 = require("fs");
+const File_1 = require("./File");
+const Directory_1 = require("./Directory");
+const Path_1 = require("./Path");
+/**
+ * A class to monitor file system changes, inspired by .NET's FileSystemWatcher.
+ */
+class FileSystemWatcher extends events_1.EventEmitter {
+    _watcher;
+    _options;
+    _filteredPaths;
+    /**
+     * Constructs a new FileSystemWatcher.
+     * @param options - The options for the watcher.
+     */
+    constructor(options) {
+        super();
+        this._filteredPaths = new Set();
+        this._options = {
+            includeSubdirectories: true,
+            ...options
+        };
+        if (!Directory_1.Directory.exists(this._options.path)) {
+            throw new Error(`Path does not exist: ${this._options.path}`);
+        }
+        this.initializeFilteredPaths();
+    }
+    /**
+     * Starts watching the file system for changes.
+     */
+    start() {
+        const { path, includeSubdirectories } = this._options;
+        this._watcher = (0, fs_1.watch)(path, { recursive: includeSubdirectories }, (eventType, filename) => {
+            if (!filename) {
+                return;
+            }
+            const fullPath = Path_1.Path.combine(path, filename);
+            if (this.isFiltered(fullPath)) {
+                switch (eventType) {
+                    case 'rename':
+                        if (File_1.File.exists(fullPath)) {
+                            this.emit('created', fullPath);
+                        }
+                        else {
+                            this.emit('deleted', fullPath);
+                        }
+                        break;
+                    case 'change':
+                        this.emit('changed', fullPath);
+                        break;
+                    default:
+                        break;
+                }
+            }
+        });
+        console.log(`FileSystemWatcher started for path: ${path}`);
+    }
+    /**
+     * Stops watching the file system.
+     */
+    stop() {
+        this._watcher?.close();
+        console.log('FileSystemWatcher stopped.');
+    }
+    /**
+     * Initializes the filtered paths based on the provided glob patterns.
+     */
+    initializeFilteredPaths() {
+        const { path, filter } = this._options;
+        if (filter) {
+            const patterns = Array.isArray(filter) ? filter : [filter];
+            const resolvedPaths = Path_1.Path.glob(patterns.map((pattern) => Path_1.Path.combine(path, pattern)));
+            for (const resolvedPath of resolvedPaths) {
+                this._filteredPaths.add(resolvedPath);
+            }
+        }
+    }
+    /**
+     * Determines if a file path matches the filter criteria.
+     * @param filePath - The file path to check.
+     * @returns `true` if the path matches the filter, otherwise `false`.
+     */
+    isFiltered(filePath) {
+        return this._filteredPaths.size === 0 || this._filteredPaths.has(filePath);
+    }
+}
+exports.FileSystemWatcher = FileSystemWatcher;
+//# sourceMappingURL=FileSystemWatcher.js.map

package/IO/FileSystemWatcher.js.map

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