@trap_stevo/filetide 0.0.28 → 0.0.31

package/dist/cjs/FileMessager.js

@@ -11,7 +11,10 @@ const {
   FileTransferManager
 } = require("./HUDManagers/FileTransferManager");
 class FileMessager {
-  constructor(options = {}, transportOptions = {
+  constructor(options = {
+    pingTimeout: 3600000,
+    pingInterval: 60000
+  }, transportOptions = {
     parallelChunks: 3,
     maxRetries: 3
   }) {

package/dist/cjs/FileMessagerClient.js

@@ -71,14 +71,18 @@ class FileMessagerClient {
    * @param {string} destinationPath - The path to which the files should be sent.
    */
   sendDirectoryFiles(clientID, recipientId, filesData, baseDirectory, destinationPath) {
-    const baseDirectoryName = path.basename(baseDirectory);
-    const adjustedDestinationPath = FileUtilityManager.normalizePath(path.join(destinationPath, baseDirectoryName));
-    const sendFilePromises = filesData.map((fileInfo, index) => {
-      const relativeFilePath = path.dirname(path.relative(baseDirectory, fileInfo.filePath));
-      const fileDestinationPath = FileUtilityManager.normalizePath(path.join(adjustedDestinationPath, relativeFilePath));
-      return this.sendFile(clientID, recipientId, fileInfo.fileName, fileInfo.fileData, fileDestinationPath, fileInfo.size, adjustedDestinationPath, index);
-    });
-    Promise.all(sendFilePromises).then(() => console.log("\nAll files in directory transferred successfully!")).catch(error => console.error("Did not transfer files: ", error));
+    try {
+      const baseDirectoryName = path.basename(baseDirectory);
+      const adjustedDestinationPath = FileUtilityManager.normalizePath(path.join(destinationPath, baseDirectoryName));
+      const sendFilePromises = filesData.map((fileInfo, index) => {
+        const relativeFilePath = path.dirname(path.relative(baseDirectory, fileInfo.filePath));
+        const fileDestinationPath = FileUtilityManager.normalizePath(path.join(adjustedDestinationPath, relativeFilePath));
+        return this.sendFile(clientID, recipientId, fileInfo.fileName, fileInfo.fileData, fileDestinationPath, fileInfo.size, adjustedDestinationPath, index);
+      });
+      Promise.all(sendFilePromises).then(() => console.log("\nAll files in directory transferred successfully!")).catch(error => console.error("Did not transfer directory: ", error));
+    } catch (error) {
+      FileNetUtilityManager.outputGradient(`[FileTide ~ File Messager] ~ Refused directory transfer: ${error}`, errorMessageColors);
+    }
   }
   sendFile(clientID, recipientId, fileName, file, filePath = process.cwd(), fileSize, directoryPath = null, index = 0) {
     if (!file) {
@@ -140,45 +144,8 @@ class FileMessagerClient {
         path: filePath,
         size: fileSize
       }
-    }).then(() => FileNetUtilityManager.outputGradient(`[FileTide ~ File Messager] ~ File ~ ${fileName} transfer complete!`, significantMessageColors)).catch(error => FileNetUtilityManager.outputGradient(`Refused file transfer: ${error}`, errorMessageColors));
+    }).then(() => FileNetUtilityManager.outputGradient(`[FileTide ~ File Messager] ~ File ~ ${fileName} transfer complete!`, significantMessageColors)).catch(error => FileNetUtilityManager.outputGradient(`[FileTide ~ File Messager] ~ Refused file transfer: ${error}`, errorMessageColors));
   }
-
-  /*onFileChunkReceived(userID) 
-  {
-      this.clientTide.onEvent(userID, "transfer-progress", (data) => {
-           console.log(`\n[FileTide ~ File Messager] ~ Receiving file chunk for client ~ ${userID}: `, data.fileChunk);
-           
-           console.log("\n[FileTide ~ File Messager] ~ Progress: ", data.progress);
-           
-           FileUtilityManager.saveChunk(userID, data.fileChunk, data.path, data.name);
-      });
-  }
-  
-  onFileTransferComplete(userID) {
-      this.clientTide.onEvent(userID, "transfer-complete", (data) => {
-           console.log(`\n[FileTide ~ File Messager] ~ File transfer completed for user ${userID}.`);
-           
-           FileUtilityManager.assembleFile(userID);
-      });
-  }
-  
-  handleIncomingFile(userID) 
-  {
-      this.clientTide.onEvent(userID, "incoming-file", (data) => {
-           console.log(`\n[FileTide ~ File Messager] ~ Received file for user ${userID}: ${data.fileName}.`);
-           
-           FileUtilityManager.saveFile(data.fileName, data.fileData, data.path, data.name);
-      });
-  }
-  
-  handleMultipleClientsTransfer() 
-  {
-      this.clients.forEach((userID, roomData) => {
-           this.onFileChunkReceived(userID);
-           
-           this.onFileTransferComplete(userID);
-      });
-  }*/
 }
 ;
 module.exports = FileMessagerClient;

package/dist/cjs/FileTide.js

@@ -33,6 +33,7 @@ class FileTide {
     this.progressBarManager = new ConsoleProgressBarManager([], {
       completionMessageColor: chalk.blue.bold
     });
+    this.clientShorePolicies = new Map();
     this.clients = new Map();
     this.currentUserID = "";
     return;
@@ -71,9 +72,7 @@ class FileTide {
     }
     const newClient = new FileMessagerClient(clientOptions);
     newClient.joinRoom(userID, roomName, connectionOptions);
-
-    //newClient.handleMultipleClientsTransfer();
-
+    this.clientShorePolicies.set(userID, [FileUtilityManager.getTidePath(">CurrentUser"), FileUtilityManager.getTidePath(">Downloads"), FileUtilityManager.getTidePath(">Documents")]);
     this.clients.set(userID, newClient);
     FileTide.outputGradient(`[FileTide] ~ Messager launched successfully for client ~ ${userID}!`, significantMessageColors);
     _assertClassBrand(_FileTide_brand, this, _setupFileEventListeners).call(this, userID, newClient, onIncomingFile);
@@ -94,6 +93,29 @@ class FileTide {
   getTidePath(inputPath) {
     return FileUtilityManager.getTidePath(inputPath);
   }
+  clearShorePolicies(clientID, shores = []) {
+    let clientShorePolicies = this.clientShorePolicies.get(clientID);
+    if (!shores || shores.length <= 0 || !clientShorePolicies || !clientID) {
+      FileTide.outputGradient(`[FileTide] Did not clear from client ~ ${clientID} shore policies.`, ["#F94144", "#F3722C"]);
+      return false;
+    }
+    const shorePolicies = Array.from(clientShorePolicies.values());
+    const currentShores = new Set(clientShorePolicies);
+    this.clientShorePolicies.set(clientID, shorePolicies.filter(shorePolicy => !currentShores.has(shorePolicy)));
+    return true;
+  }
+  addShorePolicies(clientID, shores = []) {
+    const clientShorePolicies = this.clientShorePolicies.get(clientID);
+    if (!shores || shores.length <= 0 || !clientShorePolicies || !clientID) {
+      FileTide.outputGradient(`[FileTide] Did not add to client ~ ${clientID} shore policies.`, ["#F94144", "#F3722C"]);
+      return false;
+    }
+    this.clientShorePolicies.set(clientID, [...new Set([...clientShorePolicies, ...shores])]);
+    return true;
+  }
+  getShorePolicies(clientID) {
+    return this.clientShorePolicies.get(clientID);
+  }
 
   /**
    * Send files / directories directly to a device.
@@ -230,22 +252,26 @@ function _setupFileEventListeners(userID, client, onIncomingFile) {
     this.progressBarManager.listenForInput("Page Number:", "Press 'n' for next page, 'p' for previous page.", chalk.blue, chalk.magenta, chalk.yellow);
   });
   client.clientTide.onEvent(userID, "incoming-file", data => {
-    console.log(`[${userID}] Preparing to receive file : ${data.fileName}`);
-    activeTransfers.set(data.fileName, {
-      receivedChunks: [],
-      totalChunks: data.totalChunks,
-      fileInfo: data
-    });
-    const saveDir = FileUtilityManager.getTidePath(data.path);
-    this.progressBarManager.addTask({
-      name: data.fileName,
-      size: data.fileSize
-    });
-    if (data.senderID && data.senderID !== userID && !fs.existsSync(saveDir)) {
-      fs.mkdirSync(saveDir, {
-        recursive: true
+    try {
+      _FileTide.outputGradient(`[${userID}] Preparing to receive file : ${data.fileName}`, significantMessageColors);
+      activeTransfers.set(data.fileName, {
+        receivedChunks: [],
+        totalChunks: data.totalChunks,
+        fileInfo: data
       });
-      _FileTide.outputGradient(`[${userID}] Created directory : ${saveDir}`, significantMessageColors);
+      const saveDir = FileUtilityManager.getTidePath(data.path);
+      if (data.senderID && data.senderID !== userID && !fs.existsSync(saveDir)) {
+        this.progressBarManager.addTask({
+          name: data.fileName,
+          size: data.fileSize
+        });
+        fs.mkdirSync(saveDir, {
+          recursive: true
+        });
+        _FileTide.outputGradient(`[${userID}] Created directory : ${saveDir}`, significantMessageColors);
+      }
+    } catch (error) {
+      _FileTide.outputGradient(`[${userID}] Halted file recieval preparation : ${data.fileName}\n${error}`, errorMessageColors);
     }
   });
   client.clientTide.onEvent(userID, "transfer-progress", data => {
@@ -256,30 +282,29 @@ function _setupFileEventListeners(userID, client, onIncomingFile) {
     if (!transferState) {
       return;
     }
-
-    //console.log(`[${userID}] Receiving chunk ${data.chunkIndex + 1}/${transferState.totalChunks} for file : ${data.fileName}`);
-
     transferState.receivedChunks[data.chunkIndex] = Buffer.from(data.fileChunk);
     const progress = (data.chunkIndex + 1) / transferState.totalChunks * 100;
-
-    //console.log(`[${userID}] Progress : ${progress.toFixed(2)}%`);
-
     this.progressBarManager.updateTaskProgress(data.fileName, 512 * 1024);
     if (onIncomingFile) {
       onIncomingFile(data);
     }
   });
   client.clientTide.onEvent(userID, "transfer-complete", data => {
-    console.log(`[${userID}] File transfer complete : ${data.fileName}`);
-    const transferState = activeTransfers.get(data.fileName);
-    if (!transferState) {
-      return;
+    try {
+      _FileTide.outputGradient(`[${userID}] File transfer complete : ${data.fileName}`, significantMessageColors);
+      const transferState = activeTransfers.get(data.fileName);
+      if (!transferState) {
+        return;
+      }
+      const savePath = FileUtilityManager.getTidePath(path.join(data.filePath, data.fileName));
+      const fullFile = Buffer.concat(transferState.receivedChunks);
+      fs.writeFileSync(savePath, fullFile);
+      _FileTide.outputGradient(`[${userID}] File saved at : ${savePath}`, significantMessageColors);
+      activeTransfers.delete(data.fileName);
+    } catch (error) {
+      _FileTide.outputGradient(`[${userID}] Did not save file at : ${savePath}\n${error}`, errorMessageColors);
+      activeTransfers.delete(data.fileName);
     }
-    const savePath = FileUtilityManager.getTidePath(path.join(data.filePath, data.fileName));
-    const fullFile = Buffer.concat(transferState.receivedChunks);
-    fs.writeFileSync(savePath, fullFile);
-    _FileTide.outputGradient(`[${userID}] File saved at : ${savePath}`, significantMessageColors);
-    activeTransfers.delete(data.fileName);
   });
   client.clientTide.onEvent(userID, "transfer-requested", data => {
     _FileTide.outputGradient(`[${userID}] Transfer requested from: ${data.requesterID}`, significantMessageColors);

package/dist/cjs/HUDManagers/FileMessagerConfigManager.js

@@ -3,6 +3,8 @@
 class FileMessagerConfigManager {
   static getServerOptions({
     maxHttpBufferSize = 1e9,
+    pingTimeout = 3600000,
+    pingInterval = 60000,
     useHTTPS = false,
     corsOrigin = "*",
     useCors = true,
@@ -24,7 +26,7 @@ class FileMessagerConfigManager {
     };
   }
   static getClientOptions({
-    serverUrl = 'http://localhost:3000'
+    serverUrl = "http://localhost:3000"
   } = {}) {
     return {
       url: serverUrl

package/dist/cjs/HUDManagers/FileUtilityManager.js

@@ -24,15 +24,83 @@ class FileUtilityManager {
     });
     return totalSize;
   }
+
+  /**
+   * Function to filter files and directories.
+   * @param {string} dirPath - The directory path to scan
+   * @param {Array} filterContent - Array of paths (files, directories, extensions) to avoid (e.g., ['docs', 'example.txt', '.js'])
+   * @param {function} callback - A callback function to handle the results
+   */
+  static filterFilesAndDirectories(dirPath, filterContent = [], callback) {
+    fs.readdir(dirPath, {
+      withFileTypes: true
+    }, (error, items) => {
+      if (error) {
+        return callback(error);
+      }
+      const results = [];
+      items.forEach(item => {
+        const itemPath = path.join(dirPath, item.name);
+        const filtered = filterContent.some(filterEntry => {
+          const resolvedFilterEntry = path.resolve(filterEntry);
+          const fileExtension = filterEntry.startsWith(".");
+          return itemPath === resolvedFilterEntry || item.name === filterEntry || fileExtension && path.extname(item.name) === filterEntry;
+        });
+        if (!filtered) {
+          fs.stat(itemPath, (error, stats) => {
+            if (error) {
+              return callback(error);
+            }
+            results.push({
+              dateCreated: stats.birthtime,
+              type: item.isDirectory() ? "directory" : "file",
+              size: stats.size,
+              name: item.name,
+              path: itemPath
+            });
+            if (results.length === items.length) {
+              callback(null, results);
+            }
+          });
+        } else if (results.length === items.length) {
+          callback(null, results);
+        }
+      });
+    });
+  }
+
+  /**
+   * Function to check for a path or any of the path's subpaths inside the user's open shore (allowed drop-zone) policy.
+   * Supports a wildcard '*' which allows all paths.
+   * @param {string} shorePath - The file or directory path to check
+   * @param {Array} openShores - Array of paths or '*' to check against
+   * @returns {boolean} - Returns true if openShores found the itemPath or the itemPath's subpath.
+   */
+  static allowedShore(shorePath, openShores = []) {
+    const resolvedShorePath = path.resolve(shorePath);
+    if (openShores.includes("*")) {
+      return true;
+    }
+    return openShores.some(listedShore => {
+      const currentShore = path.resolve(listedShore);
+      return resolvedShorePath === currentShore || resolvedShorePath.startsWith(currentShore + path.sep);
+    });
+  }
   static getTidePath(inputPath) {
-    const homeDir = os.homedir();
+    let homeDir = os.homedir();
     const platform = process.platform;
+    let currentUserDir = homeDir;
+    if (platform === "linux") {
+      const username = process.env.USER || process.env.LOGNAME;
+      homeDir = "/home";
+      currentUserDir = path.join(homeDir, username);
+    }
     const folderMappings = {
       ">Downloads": path.join(homeDir, "Downloads"),
       ">Documents": path.join(homeDir, "Documents"),
       ">Desktop": path.join(homeDir, "Desktop"),
       ">AppData": platform === "win32" ? path.join(homeDir, "AppData", "Roaming") : path.join(homeDir, ".config"),
-      ">LocalAppData": platform === "win32" ? path.join(homeDir, "AppData", "Local") : "/var/local",
+      ">LocalAppData": platform === "win32" ? path.join(homeDir, "AppData", "Local") : path.join(homeDir, ".local", "share"),
       ">Music": path.join(homeDir, "Music"),
       ">Pictures": path.join(homeDir, "Pictures"),
       ">Videos": path.join(homeDir, "Videos"),
@@ -44,6 +112,7 @@ class FileUtilityManager {
       ">Cache": platform === "win32" ? path.join(homeDir, "AppData", "Local", "Cache") : path.join(homeDir, ".cache"),
       ">Config": platform === "win32" ? path.join(homeDir, "AppData", "Local", "Config") : "/etc",
       ">CurrentDirectory": process.cwd(),
+      ">CurrentUser": currentUserDir,
       ">Home": homeDir
     };
     let resolvedPath = inputPath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trap_stevo/filetide",
-  "version": "0.0.28",
+  "version": "0.0.31",
   "description": "Revolutionizing real-time file transfer with seamless, instant communication across any device. Deliver files instantly, regardless of platform, and experience unparalleled speed and control in managing transfers. Elevate your file-sharing capabilities with a tool designed for precision, efficiency, and effortless connectivity.",
   "main": "dist/cjs/FileTide.js",
   "scripts": {
@@ -29,7 +29,7 @@
   "author": "Steven Compton",
   "license": "ISC",
   "dependencies": {
-    "@trap_stevo/iotide": "^0.0.36",
+    "@trap_stevo/iotide": "^0.0.37",
     "@trap_stevo/iotide-client": "^0.0.15",
     "@trap_stevo/legendarybuilderpronodejs-utilities": "^1.0.40",
     "chalk": "^4.1.2",