terabox-upload-tool 1.3.1 → 1.4.1

package/README.md

@@ -1,237 +1,75 @@
 # Terabox Upload Tool
 
-**🚀Boost Your Node.js Apps with TeraBox Upload Tool**
-
-Supercharge your Node.js applications with the TeraBox Upload Tool — a powerful library for seamless integration with [TeraBox](https://www.terabox.com/wap), the leading cloud storage platform with 1TB of free space.
-
-✅ Effortlessly:
-
-- Upload, download, retrieve, and delete files
-- Manage directories with ease
-- Fetch file lists for better organization
-
-Ideal for developers and automation enthusiasts looking for an efficient cloud storage solution in Node.js.
+A robust Node.js library for seamless integration with TeraBox. Effortlessly upload, download, manage files and directories, and retrieve file lists.
 
 ## Features
-
-- File Upload: Easily upload files to Terabox storage.
-- Custom Directory Support: Specify the directory where the file should be uploaded.
-- Progress Tracking: Monitor the upload progress in real-time.
-- Retrieve your Files: Retrieve your files from any directory.
-- Download your Files: Get direct file download link.
-- Delete or move your files from any directory.
-
-## Coming Soon (Open for Collaboration)
-
-- Video Streaming: Support for streaming videos.
-- Fetch Upload History
-- Fetch Download History
-- Restructure code and files
+- **Automated Upload Flow**: Handles `precreate`, MD5 calculation, and finalization automatically.
+- **File Management**: Create directories, move, rename, and delete files.
+- **Downloads**: Generate direct download links (`dlink`).
+- **Sharing**: Generate short URLs for file sharing.
+- **Latest API Support**: Includes `jsToken`, `dp-logid`, and `appId` support to bypass modern restrictions.
 
 ## Installation
-
-Install the package using npm:
-
 ```bash
 npm install terabox-upload-tool
 ```
 
-## Getting Started
+## Setup & Credentials
 
-### Setting up credentials
+To use this library, you need to extract three key parameters from your browser while logged into TeraBox:
 
-```javascript
-const TeraboxUploader = require("terabox-upload-tool");
+1.  **ndus**: Found in your Browser Cookies (`Application` -> `Cookies` -> `https://www.terabox.com`).
+2.  **jsToken**: Found in the response or query parameters of API calls (e.g., `api/list` or `api/home/info`) in the `Network` tab.
+3.  **appId**: Usually `250528`, but verify by looking at the `app_id` parameter in any API request in the `Network` tab.
 
-const credentials = {
-  ndus: "valid_ndus", //Required: Get this from your session (See guide below)
-  appId: "valid_appId", //Required: Get this from your session (See guide below)
-  uploadId: "valid_uploadId", //Required: Get this from your session (See guide below)
-  jsToken: "valid_jsToken", //Required: Get this from your session (See guide below)
-  browserId: "valid_browserId", //Required: Get this from your session (See guide below)
-};
+## Usage
 
-const uploader = new TeraboxUploader(credentials);
+### Initialization
+```javascript
+const TeraboxUploader = require('terabox-upload-tool');
+
+const uploader = new TeraboxUploader({
+  ndus: "YOUR_NDUS",
+  jsToken: "YOUR_JS_TOKEN",
+  appId: "250528",
+  bdstoken: "OPTIONAL",
+  browserId: "OPTIONAL"
+});
 ```
 
-### Uploading
-
-To upload a file, use the instance of TeraboxUploader and specify the file path.
-
-#### Example: Save File to a Specific Directory
+### API Methods
 
+#### Upload File
 ```javascript
-
-async function uploadFile() {
-  try {
-    const result = await uploader.uploadFile(
-      filePath,
-      showProgress,
-      "/myUploads"
-    );
-    if (result.success) {
-      console.log("File uploaded successfully!");
-      console.log("File details:", result.fileDetails);
-    } else {
-      console.log("Upload failed:", result.message);
-    }
-  } catch (error) {
-    console.log("An error occurred during the upload:", error.message);
-  }
-}
+const result = await uploader.uploadFile('./myfile.txt', (loaded, total) => {
+  console.log(`Progress: ${Math.round((loaded / total) * 100)}%`);
+}, '/remote/dir');
 ```
 
-### Fetching files
-
-Fetch the files in a directory
-
-#### Example: Fetch a list of files from Terabox
-
+#### Download File
 ```javascript
-async function fetchFileList() {
-  try {
-    const fileList = await uploader.fetchFileList("/myUploads"); //fetching files from 'myuplods' directory, default is '/' directory.
-    console.log("Files in your directory:", fileList);
-  } catch (error) {
-    console.log("Error fetching file list:", error.message);
-  }
-}
+const result = await uploader.downloadFile(fs_id);
+console.log('Download Link:', result.downloadLink);
 ```
 
-### Downloading a file
-
-Download a file by it's fs_id aka fileId
-
+#### File List
 ```javascript
-async function download(fileId) { // fs_id from fetched file information
-  try {
-    const res = await uploader.downloadFile(fileId);
-    console.log(res);
-  } catch (error) {
-    console.log(error);
-  }
-}
+const result = await uploader.fetchFileList('/remote/dir');
+console.log(result.data.list);
 ```
 
-### Delete a file
-
-Delete a list of files, provide an array of path of files to delete
-
+#### Directory Operations
 ```javascript
-async function deleteList() {
-  try {
-    const deleteD = await uploader.deleteFiles([
-      "/FliqloScr.zip",
-      "/Consent Letter.docx",
-    ]);
-    console.log(deleteD);
-  } catch (error) {
-    console.error("Error fetching file list:", error.message);
-  }
-}
+await uploader.createDirectory('/new_folder');
+await uploader.moveFiles('/old/path.txt', '/new/dir', 'newname.txt');
+await uploader.deleteFiles(['/file_to_delete.txt', '/folder_to_delete']);
 ```
 
-### Moving a file
-
-Moves a file from one location to another with a new name.
-
+#### Sharing
 ```javascript
-async function moveFile(){
-  try{
-    const moved = await uploader.moveFiles('/sample_960x540.mkv', '/uploads', 'sample.mkv') //old path, new path, new name
-    console.log(moved);
-  }catch(error){
-    console.log(error);
-  }
-}
+const result = await uploader.generateShortUrl('/path/file.txt', fs_id);
+console.log('Short URL:', result.shortUrl);
 ```
 
-
-## Future Enhancements (Open Collaboration)
-
-We are actively seeking contributors to add the following features:
-
-1. **Error Handling Enhancements:**
-
-   - Improve error messages for easier debugging and user guidance.
-
-2. **Automated Tests:**
-
-   - Add test cases to ensure reliability and robustness.
-
-3. **Documentation Updates:**
-
-   - Expand guides with screenshots and example workflows.
-
-4. **Restructure Code and Files:**
-
-   - Restructure the existing code and files
-
-5. **New Features Addition:**
-   - Addition of new features and enhancements
-
-## Contribution Guidelines
-
-We welcome contributions from the community! Here’s how you can get started:
-
-1. Fork the repository and create a new branch for your feature or bugfix.
-2. Make your changes and ensure the code adheres to the project's style guide.
-3. Submit a pull request detailing your changes and their purpose.
-4. Feel free to open issues for feature requests or bug reports.
-
-## Resources for Developers
-
-- [Node.js File System Documentation](https://nodejs.org/api/fs.html)
-- [Chrome Dev-Tools (Networks)](https://developer.chrome.com/docs/devtools/network)
-
-<br>
-
-Terabox Node.js Library
-
-Upload Files to Terabox
-
-Terabox API Integration
-
-Terabox File Management
-
-Node.js Terabox SDK
-
-## Guide
-
-For getting your credentials, go to the terabox, create an account and follow the steps:
-
-![Login you account and open the developer tools](https://res.cloudinary.com/djjq0ds7o/image/upload/v1736944135/Screenshot_2025-01-15_164342_lqev64.png)
-Login you account and open the developer tools
-<br>
-<br>
-<br>
-
-![Go to network tab](https://res.cloudinary.com/djjq0ds7o/image/upload/v1736944135/Screenshot_2025-01-15_164430_clhj2j.png)
-Go to network tab
-<br>
-<br>
-<br>
-
-![Upload an image from left of your screen](https://res.cloudinary.com/djjq0ds7o/image/upload/v1736944135/Screenshot_2025-01-15_164628_hutnsg.png)
-Upload an image from left of your screen
-<br>
-<br>
-<br>
-
-![Look for the following appId and uploadId from following request ](https://res.cloudinary.com/djjq0ds7o/image/upload/v1736945073/Screenshot_2025-01-15_164845_1_fxuvj9.png)
-Look for 'appId' and 'uploadId' from following request
-<br>
-<br>
-<br>
-
-![Get the 'ndus' from the cookies in header section](https://res.cloudinary.com/djjq0ds7o/image/upload/v1736945222/Screenshot_2025-01-15_181119_zvnbt5.png)
-Get the 'ndus' from cookies in the header section
-<br>
-<br>
-<br>
-
-## Licence
-
-This project is licensed under the [MIT License.](./LICENSE)
-
-[Github](https://github.com/Pahadi10/terabox-upload-tool)
+## License
+MIT

package/lib/helpers/download/download.js

@@ -1,41 +1,24 @@
 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." };
-        }
+async function getDownloadLink(ndus, fid, appId, jsToken, dpLogId) {
+  try {
+    const homeInfo = await fetchHomeInfo(ndus);
+    if (!homeInfo || !homeInfo.data.sign3 || !homeInfo.data.sign1 || !homeInfo.data.timestamp) {
+      return { success: false, message: "Invalid home information received." };
+    }
 
-        // 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." };
-        }
+    const sign = generateSign(homeInfo.data.sign3, homeInfo.data.sign1);
+    if (!sign) return { success: false, message: "Failed to generate sign." };
 
-        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." };
+    const res = await generateDownload(sign, fid, homeInfo.data.timestamp, ndus, appId, jsToken, dpLogId);
+    if (!res || !res.downloadLink[0]?.dlink) {
+      return { success: false, message: res.message || "Failed to retrieve download link." };
     }
+
+    return { success: true, message: "Download link retrieved successfully.", downloadLink: res.downloadLink[0].dlink };
+  } catch (error) {
+    return { success: false, message: error.message || "Unknown error occurred." };
+  }
 }
 
 module.exports = getDownloadLink;

package/lib/helpers/download/downloadHelper.js

@@ -1,131 +1,51 @@
 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;
+  try {
+    const p = new Uint8Array(256), a = new Uint8Array(256), 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]];
+      result.push(s2.charCodeAt(q) ^ p[(p[i] + p[j]) % 256]);
     }
+    return Buffer.from(result).toString('base64');
+  } catch (e) { 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." };
-    }
+  try {
+    const res = await axios.get("https://www.1024terabox.com/api/home/info", {
+      params: { app_id: "250528", web: "1", channel: "dubox", clienttype: "0" },
+      headers: { "Cookie": `ndus=${ndus}` }
+    });
+    return { success: true, data: res.data.data };
+  } catch (e) { return { success: false, message: e.message }; }
 }
 
-/**
- * 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." };
-    }
+async function generateDownload(sign, fid, timestamp, ndus, appId, jsToken, dpLogId) {
+  try {
+    const res = await axios.get("https://www.1024terabox.com/api/download", {
+      params: {
+        app_id: appId || "250528", web: "1", channel: "dubox", clienttype: "0",
+        jsToken, "dp-logid": dpLogId, fidlist: `[${fid}]`, type: "dlink",
+        vip: "2", sign, timestamp, need_speed: "0"
+      },
+      headers: { "Cookie": `ndus=${ndus}` }
+    });
+    if (!res.data.dlink) return { success: false, message: res.data.errmsg };
+    return { success: true, downloadLink: res.data.dlink };
+  } catch (e) { return { success: false, message: e.message }; }
 }
 
-module.exports = {
-    generateSign,
-    fetchHomeInfo,
-    generateDownload,
-};
+module.exports = { generateSign, fetchHomeInfo, generateDownload };

package/lib/helpers/fileDelete.js

@@ -1,45 +1,32 @@
 const axios = require("axios");
 
-// ファイル削除APIリクエスト関数
 const deleteFile = async (filelist, config) => {
-  // config が { credentials: { ... } } か、直接 { ndus, appId, jsToken, browserId } かを判定
-  const { appId, jsToken, browserId, ndus } = config.credentials || config;
-  const url = "https://www.1024terabox.com/api/filemanager"; // URLを変更
+  const { appId, jsToken, browserId, ndus, dpLogId } = config.credentials || config;
+  const url = "https://www.1024terabox.com/api/filemanager";
 
-  // クエリパラメータを設定
   const params = {
     opera: "delete",
     app_id: appId,
     jsToken: jsToken,
+    "dp-logid": dpLogId,
   };
 
-  // URLSearchParamsは自動的にエンコードしますが、
-  // さらに明示的にエンコードしたい場合は encodeURIComponent を使います。
   const data = new URLSearchParams();
-  // JSON形式の filelist をエンコードして追加
   data.append("filelist", JSON.stringify(filelist));
 
-  // ヘッダー情報を設定
   const headers = {
     "Cookie": `browserid=${browserId}; ndus=${ndus};`,
   };
 
   try {
-    // APIリクエストを送信
     const response = await axios.post(url, data.toString(), {
       headers,
       params,
     });
-
-    // レスポンスを返す
     return response.data;
   } catch (error) {
-    // エラーを投げる
     throw error.response ? error.response.data : error.message;
   }
 };
 
-// モジュールとしてエクスポート
-module.exports = {
-  deleteFile,
-};
+module.exports = { deleteFile };

package/lib/helpers/fileMove.js

@@ -1,46 +1,33 @@
 const axios = require("axios");
 
-// ファイル移動APIリクエスト関数
 const moveFile = async (filelist, config) => {
-  // config が { credentials: { ... } } か、直接 { ndus, appId, jsToken, browserId } かを判定
-  const { appId, jsToken, browserId, ndus } = config.credentials || config;
-  const url = "https://www.1024terabox.com/api/filemanager"; // URLを変更
+  const { appId, jsToken, browserId, ndus, dpLogId } = config.credentials || config;
+  const url = "https://www.1024terabox.com/api/filemanager";
 
-  // クエリパラメータを設定（operaの値を "move" に変更）
   const params = {
     opera: "move",
     app_id: appId,
     jsToken: jsToken,
+    "dp-logid": dpLogId,
   };
 
-  // URLSearchParamsを使用してForm dataを作成
   const data = new URLSearchParams();
-  // JSON形式の filelist をエンコードして追加
-  // 例: [{"path":"/b","dest":"/a","newname":"c"}]
   data.append("filelist", JSON.stringify(filelist));
 
-  // ヘッダー情報を設定
   const headers = {
     "Cookie": `browserid=${browserId}; ndus=${ndus};`,
     "Content-Type": "application/x-www-form-urlencoded",
   };
 
   try {
-    // APIリクエストを送信
     const response = await axios.post(url, data.toString(), {
       headers,
       params,
     });
-
-    // レスポンスを返す
     return response.data;
   } catch (error) {
-    // エラーを投げる
     throw error.response ? error.response.data : error.message;
   }
 };
 
-// モジュールとしてエクスポート
-module.exports = {
-  moveFile,
-};
+module.exports = { moveFile };