terabox-upload-tool 1.1.0 → 1.2.1

package/README.md

@@ -8,11 +8,16 @@ A simple and efficient Node.js library for uploading files and fetching file lis
 * Custom Directory Support: Specify the directory where the file should be uploaded.
 * Progress Tracking: Monitor the upload progress in real-time.
 * Fetch File List: Fetch file list from any directory.
+* Get direct file download link
 
 ## Coming Soon (Open for Collaboration)
 
-* Fetch Files: Retrieve the resources download URL and add URL Path in JSON  object returned by exiting [fetchFileList() ](./lib/index.js)method .
+* Fetch Files: Retrieve the resources download URL and add URL Path in JSON  object returned by existing [fetchFileList() ](./lib/index.js)method . ✅
 * Delete Files: Remove files from your Terabox storage directly using this library.
+* Video Streaming: Support for streaming videos.
+* Fetch Upload History
+* Fetch Download History
+* Restructure code and files
 
 ## Installation
 
@@ -79,21 +84,17 @@ Future Enhancements (Open Collaboration)
 
 We are actively seeking contributors to add the following features:
 
-1. Fetch Files:
-
-   * Provide options to filter by file types, size, or date modified.
-   * Need to Implement add resouces URL in file list objects.
-2. Delete Files:
+1. Delete Files:
 
    * Enable users to delete specific files or directories from their Terabox storage.
    * Include safeguards like confirmation prompts before deletion.
-3. Error Handling Enhancements:
+2. Error Handling Enhancements:
 
    * Improve error messages for easier debugging and user guidance.
-4. Automated Tests:
+3. Automated Tests:
 
    * Add test cases to ensure reliability and robustness.
-5. Documentation Updates:
+4. Documentation Updates:
 
    * Expand guides with screenshots and example workflows.
 
@@ -160,3 +161,5 @@ Get the 'ndus' from cookies in the header section
 ## Licence
 
 This project is licensed under the [MIT License.](./LICENSE)
+
+[Github](https://github.com/Pahadi10/terabox-upload-tool)

package/lib/helpers/download/download.js

@@ -0,0 +1,41 @@
+const { generateSign, fetchHomeInfo, generateDownload } = require('./downloadHelper');
+
+/**
+ * Generates a direct download link for a file from Terabox.
+ * @param {string} ndus - User authentication token.
+ * @param {string} fid - File ID of the file to be downloaded.
+ * @returns {Promise<{success: boolean, message: string, downloadLink?: string}>} - A promise that resolves to an object containing success status, message, and the direct download link if successful.
+ */
+async function getDownloadLink(ndus, fid) {
+    try {
+        // Fetch home information to retrieve necessary parameters for signing
+        const homeInfo = await fetchHomeInfo(ndus);
+        
+        if (!homeInfo || !homeInfo.data.sign3 || !homeInfo.data.sign1 || !homeInfo.data.timestamp) {
+            return { success: false, message: "Invalid home information received." };
+        }
+
+        const sign1 = homeInfo.data.sign3;
+        const sign2 = homeInfo.data.sign1;
+        const timestamp = homeInfo.data.timestamp;
+
+        // Generate the required sign using sign1 and sign2
+        const sign = generateSign(sign1, sign2);
+        if (!sign) {
+            return { success: false, message: "Failed to generate sign." };
+        }
+
+        // Fetch the download link
+        const responseDownload = await generateDownload(sign, fid, timestamp, ndus);
+        if (!responseDownload || !responseDownload.downloadLink[0]?.dlink) {
+            return { success: false, message: "Failed to retrieve download link." };
+        }
+
+        return { success: true, message: "Download link retrieved successfully.", downloadLink: responseDownload.downloadLink[0].dlink};
+    } catch (error) {
+        console.error("Error getting download link:", error);
+        return { success: false, message: error.message || "Unknown error occurred while fetching download link." };
+    }
+}
+
+module.exports = getDownloadLink;

package/lib/helpers/download/downloadHelper.js

@@ -0,0 +1,131 @@
+const axios = require('axios');
+
+/**
+ * Generates a cryptographic sign using RC4-like encryption.
+ * @param {string} s1 - First input string (key).
+ * @param {string} s2 - Second input string (data).
+ * @returns {string} - Base64 encoded signed string.
+ */
+function generateSign(s1, s2) {
+    try {
+        if (!s1 || !s2) {
+            return { success: false, message: "Provide both the signs" };
+        }
+        
+        const p = new Uint8Array(256);
+        const a = new Uint8Array(256);
+        const result = [];
+
+        for (let i = 0; i < 256; i++) {
+            a[i] = s1.charCodeAt(i % s1.length);
+            p[i] = i;
+        }
+
+        let j = 0;
+        for (let i = 0; i < 256; i++) {
+            j = (j + p[i] + a[i]) % 256;
+            [p[i], p[j]] = [p[j], p[i]];
+        }
+
+        let i = 0;
+        j = 0;
+        for (let q = 0; q < s2.length; q++) {
+            i = (i + 1) % 256;
+            j = (j + p[i]) % 256;
+            [p[i], p[j]] = [p[j], p[i]];
+            const k = p[(p[i] + p[j]) % 256];
+            result.push(s2.charCodeAt(q) ^ k);
+        }
+
+        return Buffer.from(result).toString('base64');
+    } catch (error) {
+        console.error("Error generating sign:", error.message);
+        return null;
+    }
+}
+
+/**
+ * Fetches home information from Terabox API.
+ * @param {string} ndus - User authentication token.
+ * @returns {Promise<{success: boolean, message: string, data?: object}>} - The response data from the API.
+ */
+async function fetchHomeInfo(ndus) {
+    const url = "https://www.1024terabox.com/api/home/info";
+
+    try {
+        if (!ndus) {
+            return { success: false, message: "User authentication token (ndus) is required" };
+        }
+        
+        const response = await axios.get(url, {
+            params: {
+                app_id: "250528",
+                web: "1",
+                channel: "dubox",
+                clienttype: "0",
+            },
+            headers: {
+                "User-Agent": "Mozilla/5.0",
+                "Accept": "application/json",
+                "Cookie": `ndus=${ndus}`,
+            },
+        });
+        return { success: true, message: "Home info retrieved successfully.", data: response.data.data };
+    } catch (error) {
+        console.error("Error fetching home info:", error.response?.data || error.message);
+        return { success: false, message: error.message || "Failed to fetch home info." };
+    }
+}
+
+/**
+ * Generates a download link for a file from Terabox.
+ * @param {string} sign - Encrypted sign generated using `generateSign`.
+ * @param {string} fid - File ID of the file to be downloaded.
+ * @param {number} timestamp - Timestamp of the request.
+ * @param {string} ndus - User authentication token.
+ * @returns {Promise<{success: boolean, message: string, downloadLink?: string}>}
+ */
+async function generateDownload(sign, fid, timestamp, ndus) {
+    const url = "https://www.1024terabox.com/api/download";
+
+    try {
+        if (!sign || !fid || !timestamp || !ndus) {
+            return { success: false, message: "Missing required parameters for generating download link." };
+        }
+        
+        const response = await axios.get(url, {
+            params: {
+                app_id: "250528",
+                web: "1",
+                channel: "dubox",
+                clienttype: "0",
+                fidlist: `[${fid}]`,
+                type: "dlink",
+                vip: "2",
+                sign,
+                timestamp,
+                need_speed: "0",
+            },
+            headers: {
+                "User-Agent": "Mozilla/5.0",
+                "Accept": "application/json",
+                "Cookie": `ndus=${ndus}`,
+            },
+        });
+
+        if (!response.data.dlink) {
+            return { success: false, message: "No download link received." };
+        }
+
+        return { success: true, message: "Download link generated successfully.", downloadLink: response.data.dlink };
+    } catch (error) {
+        console.error("Error generating download link:", error.response?.data || error.message);
+        return { success: false, message: error.message || "Failed to generate download link." };
+    }
+}
+
+module.exports = {
+    generateSign,
+    fetchHomeInfo,
+    generateDownload,
+};

package/lib/helpers/getFileDetails.js

@@ -0,0 +1,47 @@
+/**
+ * Fetches file details from Terabox using a short URL.
+ * @param {string} shortUrl - The short URL of the file.
+ * @returns {Promise<object|null>} - A promise that resolves to an object containing file details, or null if retrieval fails.
+ */
+async function getFileDetails(shortUrl) {
+    // API Endpoint
+    const apiUrl = `https://www.terabox.com/api/shorturlinfo?app_id=250528&shorturl=${shortUrl}&root=1`;
+
+    // Request Headers
+    const headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
+        "Referer": "https://www.terabox.com/",
+        "Accept": "application/json, text/javascript, */*; q=0.01",
+        "X-Requested-With": "XMLHttpRequest"
+    };
+
+    try {
+        // Send GET request to fetch file details
+        const response = await fetch(apiUrl, { method: "GET", headers: headers });
+        const data = await response.json();
+
+        // Validate response
+        if (!data || !data.sign) {
+            console.error("Failed to retrieve file details. Response:", data);
+            return null;
+        }
+
+        // Extract relevant file details
+        const fileDetails = {
+            status: "success",
+            sign: data.sign,
+            timestamp: data.timestamp,
+            shareid: data.shareid,
+            uk: data.uk,
+            list: data.list || []
+        };
+
+        return fileDetails;
+
+    } catch (error) {
+        console.error("Error fetching file details:", error);
+        return null;
+    }
+}
+
+module.exports = getFileDetails;

package/lib/helpers/getShortUrl.js

@@ -0,0 +1,52 @@
+const axios = require('axios');
+
+/**
+ * Generates a short URL for a file in Terabox.
+ * @param {string} ndus - User authentication token.
+ * @param {string} path - The file path in Terabox.
+ * @param {string} fid - The file ID.
+ * @returns {Promise<object|null>} - A promise that resolves to the API response containing the short URL or null if an error occurs.
+ */
+const getShortUrl = async (ndus, path, fid) => {
+    try {
+        // API Endpoint
+        const url = 'https://www.1024terabox.com/share/pset';
+        const cookies = `ndus=${ndus}`;
+
+        // Form Data Parameters
+        const formData = new URLSearchParams({
+            app_id: '250528',
+            web: '1',
+            channel: 'dubox',
+            clienttype: '0',
+            app: 'universe',
+            schannel: '0',
+            channel_list: '[0]',
+            period: '0',
+            path_list: `["${path}"]`,
+            fid_list: `[${fid}]`,
+            pwd: '',
+            public: '1',
+            scene: ''
+        });
+
+        // Request Headers
+        const headers = {
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Cookie': cookies,
+            'Referer': 'https://www.1024terabox.com/',
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36'
+        };
+
+        // Send POST request to generate a short URL
+        const response = await axios.post(url, formData.toString(), { headers });
+
+        // Return the API response containing the short URL
+        return response.data;
+    } catch (error) {
+        console.error('Error generating short link:', error);
+        return null;
+    }
+};
+
+module.exports = getShortUrl;

package/lib/{utils.js → helpers/utils.js}

@@ -27,4 +27,15 @@ function buildListUrl(appId, directory) {
   return `https://www.1024terabox.com/api/list?app_id=${appId}&web=1&channel=dubox&clienttype=0&order=time&desc=1&dir=${encodeURIComponent(directory)}&num=100&page=1&showempty=0`;
 }
 
-module.exports = { buildUploadUrl, buildCreateUrl, buildListUrl };
+
+/**
+ * Builds the downloadable link for videos.
+ * @param {string} appId - The application ID
+ * @param {string} videoPath - The directory path to fetch the file list from
+ * @returns {string} - The file list URL
+ */
+function buildVideoDownloadUrl(appId, videoPath) {
+  return `https://www.1024terabox.com/api/streaming?path=${encodeURIComponent(videoPath)}&app_id=${appId}&clienttype=0&type=M3U8_FLV_264_480&vip=1`;
+}
+
+module.exports = { buildUploadUrl, buildCreateUrl, buildListUrl, buildVideoDownloadUrl };

package/lib/index.js

@@ -2,7 +2,8 @@ const axios = require('axios');
 const path = require('path');
 const fs = require('fs');
 const FormData = require('form-data');
-const { buildUploadUrl, buildCreateUrl, buildListUrl } = require('./utils');
+const { buildUploadUrl, buildCreateUrl, buildListUrl} = require('./helpers/utils');
+const getDownloadLink = require('./helpers/download/download')
 
 /**
  * Class to handle Terabox file operations
@@ -94,7 +95,7 @@ class TeraboxUploader {
   /**
    * Fetches the file list from Terabox
    * @param {string} directory - Directory to fetch the file list from (e.g., "/")
-   * @returns {Promise<object>} - JSON response from the API
+   * @returns {Promise<object>} - JSON response with file details along with download link
    */
   async fetchFileList(directory = '/') {
     try {
@@ -105,11 +106,19 @@ class TeraboxUploader {
           Cookie: this.credentials.cookies,
         },
       });
-
-      return response.data;
+      const finalDataArray = response.data.list;
+      for (const file of finalDataArray) {
+        const fid = file.fs_id;
+        file.downloadLink = await getDownloadLink(this.credentials.ndus, fid);
+      }
+      
+      return { success: true, message: 'File list retrieved successfully.', data: finalDataArray };
     } catch (error) {
-      console.error('Error fetching file list:', error.response?.data || error.message);
-      throw error;
+      console.error('Error fetching file list:', error);
+      return {
+        success: false,
+        message: error.response?.data?.error || error.message || 'Failed to fetch file list.',
+      };
     }
   }
 }

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "terabox-upload-tool",
-  "version": "1.1.0",
-  "description": "git add",
+  "version": "1.2.1",
+  "description": "A simple and efficient Node.js library for uploading files and fetching file list with download links from TeraBox storage. This tool streamlines the process of file uploads while offering customization options such as directory selection.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pahadi10/terabox-upload-tool"
+  },
   "main": "lib/index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -13,6 +17,7 @@
     "storage",
     "node"
   ],
+  "homepage": "https://github.com/Pahadi10/terabox-upload-tool#readme",
   "author": "Nitesh Singh Bhandari",
   "license": "MIT",
   "dependencies": {