@trap_stevo/filetide 0.0.88 → 0.0.90

package/dist/cjs/FileMessagerClient.js

@@ -77,7 +77,7 @@ class FileMessagerClient {
     }, options, headers, onConnect, onDisconnect, authURL, authHeaders, useAuthentication, queryAuthToken);
     return () => {
       this.clientTide.joinChannel(socketName, roomName, userID, () => {
-        FileTideDebugUtilityManager.outputGradient(`\n[FileTide ~ Tider] ~ Client ~ ${userID} joined room ${roomName} successfully!`, significantMessageColors);
+        FileTideDebugUtilityManager.outputGradient(`\n[FileTide ~ Tider] ~ ${userID} joined room ${roomName} successfully!`, significantMessageColors);
         this.clients.set(userID, {
           roomName
         });
@@ -363,7 +363,7 @@ function _createClientInstance(clientID, clientOptions, options = {}, headers =
       await onDisconnect(...disconnectArguments);
     }
   });
-  FileTideDebugUtilityManager.outputGradient(`\n[FileTide ~ Tider] ~ Created client with ID ${clientID} and socket ${clientID}!`, significantMessageColors);
+  FileTideDebugUtilityManager.outputGradient(`\n[FileTide ~ Tider] ~ Created with ID '${clientID}' and origin '${clientID}'!`, significantMessageColors);
   return clientID;
 }
 function _getAdaptiveTideSize(chunkSize, tideSize = 500, minTideSize = 10, maxTideSize = 2000) {
@@ -373,11 +373,6 @@ function _getAdaptiveTideSize(chunkSize, tideSize = 500, minTideSize = 10, maxTi
   if (networkStatus.state === NETWORK_TRAFFIC_STATES.CONGESTED) {
     tideDurationMs *= 0.50;
   }
-
-  /*
-   * Determine how many chunks current network conditions
-   * can reasonably support during one Tide duration.
-   */
   const networkTideBytes = Math.max(sendRateBps * (tideDurationMs / 1000), chunkSize);
   const networkTideSize = Math.max(1, Math.floor(networkTideBytes / chunkSize));
   const normalizedMinTideSize = Math.max(1, minTideSize);

package/dist/cjs/FileTide.js

@@ -48,6 +48,8 @@ class FileTide {
     /**
      * Set up file transfer event listeners natively.
      * Automatically checks and creates directories as needed.
+     * @param {Object} [options = {}] - Additional messager and transfer lifecycle options.
+     * @param {Boolean} [options.displayTransferOutput=true] - Whether FileTide should render transfer lifecycle output directly to the terminal.
      */
     _classPrivateMethodInitSpec(this, _FileTide_brand);
     this.transferStatsManager = new FileTransferStatsManager();
@@ -434,7 +436,27 @@ class FileTide {
 
   // --- FileTide Display Management ---
 
-  static outputGradient(text, colors) {
+  static setOutputHandler(handler = null) {
+    FileTide.outputHandler = typeof handler === "function" ? handler : null;
+    return FileTide.outputHandler;
+  }
+  static getOutputHandler() {
+    return FileTide.outputHandler;
+  }
+  static clearOutputHandler() {
+    FileTide.outputHandler = null;
+    return true;
+  }
+  static outputGradient(text, colors, metadata = {}) {
+    if (typeof FileTide.outputHandler === "function") {
+      FileTide.outputHandler({
+        text: String(text ?? ""),
+        colors,
+        type: "gradient",
+        metadata: metadata || {}
+      });
+      return;
+    }
     FileTideDebugUtilityManager.outputGradient(text, colors);
     return;
   }
@@ -463,7 +485,8 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
     onCurrentClientIDAlreadyOnline,
     onCurrentClientUnauthorized,
     onBeforeCurrentClientUnauthorizedDisconnect,
-    onCurrentClientUnauthorizedDisconnect
+    onCurrentClientUnauthorizedDisconnect,
+    displayTransferOutput = true
   } = options;
   const fileTransferReceiver = new FileTransferReceiverManager();
   client.clientTide.onEvent(userID, "current-online-clients", data => {
@@ -581,7 +604,7 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
     const {
       currentSender
     } = data;
-    if (currentSender && currentSender === userID) {
+    if (currentSender && currentSender === userID && displayTransferOutput) {
       _FileTide.outputGradient(`[${userID}] Transfer successfully sent to ${data.recipientID}`, significantMessageColors);
       return;
     }
@@ -721,7 +744,9 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
   client.clientTide.onEvent(userID, "transfer-complete", data => {
     const savePath = FileUtilityManager.getTidePath(path.join(data.filePath, data.fileName));
     try {
-      _FileTide.outputGradient(`[${userID}] File transfer complete ~ ${data.fileName}`, significantMessageColors);
+      if (displayTransferOutput) {
+        _FileTide.outputGradient(`[${userID}] File transfer complete ~ ${data.fileName}`, significantMessageColors);
+      }
       const transferState = FileTransferTrackingManager.getTransfer(data.fileName);
       FileTideDebugUtilityManager.log("notice", true, `Transfer state ~ ${data.fileName} active | ${transferState !== null && transferState !== undefined ? true : false}`);
       if (!transferState) {
@@ -729,9 +754,9 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
       }
       if (transferState.fileStream) {
         fileTransferReceiver.completeTransfer(data, (transferData, transfers, success, error) => {
-          if (success) {
+          if (success && displayTransferOutput) {
             _FileTide.outputGradient(`[${userID}] File saved at ~ ${savePath}\n`, significantMessageColors);
-          } else if (!success) {
+          } else if (!success && displayTransferOutput) {
             _FileTide.outputGradient(`[${userID}] Did not save file at ~ ${savePath}\n\t${error}\n`, errorMessageColors);
           }
           const transferStats = success ? this.transferStatsManager.completeTransfer(data.transferId || data.fileName) : this.transferStatsManager.failTransfer(data.transferId || data.fileName);
@@ -747,7 +772,9 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
         return;
       }
       FileTransferTrackingManager.untrackTransfer(data.fileName);
-      _FileTide.outputGradient(`[${userID}] Transfer successfully sent to ~ ${data.recipientId} and saved at ~ ${path.join(data.filePath, data.fileName)}\n`, significantMessageColors);
+      if (displayTransferOutput) {
+        _FileTide.outputGradient(`[${userID}] Transfer successfully sent to ~ ${data.recipientId} and saved at ~ ${path.join(data.filePath, data.fileName)}\n`, significantMessageColors);
+      }
       const transferStats = this.transferStatsManager.completeTransfer(data.transferId || data.fileName);
       if (onTransferComplete) {
         onTransferComplete({
@@ -755,10 +782,14 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
           stats: transferStats
         }, FileTransferTrackingManager.activeTransfers, true);
       }
-      FileTransferTrackingManager.outputCurrentTransfers();
+      if (displayTransferOutput) {
+        FileTransferTrackingManager.outputCurrentTransfers();
+      }
       this.transferStatsManager.clearTransfer(data.transferId || data.fileName);
     } catch (error) {
-      _FileTide.outputGradient(`[${userID}] Did not save file at ~ ${savePath}\n${error}`, errorMessageColors);
+      if (displayTransferOutput) {
+        _FileTide.outputGradient(`[${userID}] Did not save file at ~ ${savePath}\n${error}`, errorMessageColors);
+      }
       const transferStats = this.transferStatsManager.failTransfer(data.transferId || data.fileName);
       if (onTransferComplete) {
         onTransferComplete({
@@ -766,13 +797,17 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
           stats: transferStats
         }, FileTransferTrackingManager.activeTransfers, false);
       }
-      FileTransferTrackingManager.outputCurrentTransfers();
+      if (displayTransferOutput) {
+        FileTransferTrackingManager.outputCurrentTransfers();
+      }
       this.transferStatsManager.clearTransfer(data.transferId || data.fileName);
     }
   });
   client.clientTide.onEvent(userID, "transfer-failed", async data => {
     const transferState = FileTransferTrackingManager.getTransfer(data.fileName);
-    _FileTide.outputGradient(`[${userID}] File transfer failed ~ ${data.fileName}${data.reason ? `\n${data.reason}` : ""}`, errorMessageColors);
+    if (displayTransferOutput) {
+      _FileTide.outputGradient(`[${userID}] File transfer failed ~ ${data.fileName}${data.reason ? `\n${data.reason}` : ""}`, errorMessageColors);
+    }
     if (transferState?.fileStream) {
       try {
         await new Promise(resolve => {
@@ -794,7 +829,9 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
     if (onTransferComplete) {
       onTransferComplete(failureData, FileTransferTrackingManager.activeTransfers, false);
     }
-    FileTransferTrackingManager.outputCurrentTransfers();
+    if (displayTransferOutput) {
+      FileTransferTrackingManager.outputCurrentTransfers();
+    }
     this.transferStatsManager.clearTransfer(data.transferId || data.fileName);
   });
   client.clientTide.onEvent(userID, "transfer-requested", async data => {
@@ -838,7 +875,6 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
     _FileTide.outputGradient(`[${userID} | FileTide Error] ${error}`, errorMessageColors);
   });
   client.clientTide.onEvent(userID, "client-file-list-received", async data => {
-    _FileTide.outputGradient(`[${userID}] Successfully received all ${HUDUtilityManager.convertNumberToMoneyFormat(data.totalItemsSent, false)} contents in ${data.senderID}'s file list!`, significantMessageColors);
     if (onFileListReceived) {
       onFileListReceived(data);
     }
@@ -848,7 +884,6 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
       clientID: userID,
       tideID: client.clientTide.sockets[userID].tideID
     });
-    _FileTide.outputGradient(`[${userID}] Received ${HUDUtilityManager.convertNumberToMoneyFormat(data.totalItems, false)} directory contents from ${data.senderID}'s file list!`, significantMessageColors);
     if (onListFiles) {
       onListFiles(data);
     }
@@ -857,4 +892,5 @@ function _setupFileEventListeners(userID, client, onTransferProgress, onIncoming
   return;
 }
 ;
+FileTide.outputHandler = null;
 module.exports = FileTide;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trap_stevo/filetide",
-  "version": "0.0.88",
+  "version": "0.0.90",
   "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": {