---

📘 File Management System - TypeScript

A powerful, flexible, and chainable file management system for Node.js.

📘 File Management System - TypeScript

A powerful, flexible, and chainable file management system for Node.js.
This system provides an easy way to manage files and directories while supporting:

• Custom error handling
• Custom chainable methods
• Advanced file operations like compression, metadata retrieval, and content manipulation.

---

📌 Key Features

🚀 File Operations

✔ Rename, Move, Copy, and Delete files
✔ Append content to files
✔ Retrieve compressed file content (getInfo())
✔ Retrieve file metadata (getMetaInfo())

📂 Directory Operations

✔ Create, Delete, and List directories
✔ Check if a file/folder exists (syncExist())

⚙ Customization & Error Handling

✔ Custom error handling (e.g., auto-create missing files on error)
✔ Add custom chainable methods (addMethod())
✔ Invoke custom chain methods dynamically (invokeMethod())

---

📥 Installation

To install and use this package, run:

1git clone https://github.com/Whitzzscott/FileManagement.git
2cd FileManagement
3npm install

---

🛠 Usage Example

This example demonstrates:

• Error handling: Automatically creating a missing file if an error occurs.
• Custom chainable methods: Adding a method that logs the file path.
• File operations: Renaming, moving, copying, appending, and deleting a file.

1import { FileWrapper } from "./wrappers/FileWrapper";
2
3const file = new FileWrapper("./testFolder/sample.txt");
4
5// ✅ Custom error handling: Auto-create missing files when they are not found
6file.errorOnFound = (error) => {
7    if (error.code === "ENOENT") {
8        file.sync().writeFile("Default content");
9        console.log(`📄 File created: ${file.getPath()}`);
10    }
11};
12
13// ✅ Add a custom method (e.g., logging the file path)
14file.addMethod("logPath", function () {
15    console.log("File is at:", this.getPath());
16    return this;
17});
18
19// ✅ Chainable file operations
20(async () => {
21    file
22        .rename("renamed.txt")  // Renames file
23        .invokeMethod("logPath") // Logs new file path
24        .move("./testFolder/moved") // Moves file to a new folder
25        .copy("./backup")  // Creates a copy in the backup folder
26        .append("\nMore content added.") // Appends text to the file
27        .delete();  // Deletes the file
28
29    console.log("📄 Compressed File Content:", file.getInfo());
30    console.log("📑 File Metadata:", file.getMetaInfo());
31    console.log("📂 Files in directory:", file.list());
32})();

---

📜 API Reference

This file management system offers multiple operations for handling files and folders.

📂 File Operations

Method	Description	Example
rename(newName: string)	Renames the file	file.rename("newName.txt")
move(destination: string)	Moves the file to a new directory	file.move("./newFolder")
copy(destination: string)	Copies the file to a new location	file.copy("./backup")
delete()	Deletes the file permanently	file.delete()
writeFile(content: string)	Writes new content to the file (overwrites existing content)	file.writeFile("Hello, world!")
append(content: string)	Appends new content to the file	file.append("\nNew content")

📁 Directory Operations

Method	Description	Example
syncExist()	Checks if a file or folder exists	if (file.syncExist()) {...}
sync()	Ensures the directory exists (creates it if missing)	file.sync()
list()	Lists all files in the directory	console.log(file.list())

📊 File Info & Metadata

Method	Description	Example
getInfo()	Reads and compresses the entire file content	console.log(file.getInfo())
getMetaInfo()	Retrieves metadata such as size, creation date, and modification date	console.log(file.getMetaInfo())

⚙ Customization & Error Handling

Method	Description	Example
errorOnFound = (error) => {...}	Custom error handling (e.g., auto-create files)	file.errorOnFound = (err) => {...}
addMethod(name, method)	Adds a custom chainable method	file.addMethod("customMethod", function () {...})
invokeMethod(name, ...args)	Calls a custom method dynamically	file.invokeMethod("customMethod")

---

🔧 How to Use This Project

1. Install the package

   1npm install filemanagementsystemfornode

2. Run the script

   1npm run start

3. Modify settings
   • Change file paths in src/main.ts to test different operations.
   • Modify core functionality in src/Wrapper if necessary.

---

📜 License

This project is open-source and free to use.

---

💡 Future Enhancements

We plan to add:

• 🔹 File encryption support (AES, RSA encryption for file security)
• 🔹 File versioning (track changes over time)
• 🔹 Logging & monitoring system (track operations in a log file)

---

🚀 Enjoy simplified file management with powerful chaining!
Feel free to suggest new features or improvements! 🎯

---

👨‍💻 Author

WhitzScott - Developer of the File Management System.
If you have questions or ideas, feel free to reach out!