@xbibzlibrary/teraboxscraper

The Ultimate, Highly-Optimized, and Complex Terabox Downloader and Scraper Library for Node.js.

--- ## 🚀 Fitur Utama (Bukan Fitur Sederhana!) Library ini dirancang untuk melampaui batas-batas *scraper* biasa, menawarkan **kompleksitas** dan **keandalan** tingkat tinggi: 1. **Mekanisme Multi-Tahap Canggih**: Menggunakan kombinasi *Web Scraping* (`cheerio`) untuk mengekstrak parameter tersembunyi (`shareid`, `uk`, `sign`, `timestamp`) dari halaman HTML, diikuti dengan panggilan ke *Internal Terabox API* untuk mendapatkan *direct download link* yang valid. 2. **Manajemen Koneksi Powerfull**: Menggunakan `axios` dengan *custom HTTP client* yang mendukung konfigurasi **Proxy** dan **User-Agent** kustom untuk menghindari *rate-limiting* dan *blocking*. 3. **Logging Terstruktur dan Menarik**: Integrasi `pino` dan `pino-pretty` untuk sistem *logging* yang cepat, terstruktur, dan disajikan dengan indah di terminal (tanpa emoji!). 4. **Download Stream-Based dengan Progress Bar**: Mendukung pengunduhan file berbasis *stream* yang efisien, lengkap dengan *callback* untuk membuat *progress bar* yang **informatif** (kecepatan, ETA, persentase) di terminal. 5. **Penanganan Error Maksimal**: Setiap fungsi dikemas dalam objek `ScraperResponse` yang secara eksplisit mengelola status `success`, `data`, dan `error` dengan kode kesalahan yang terperinci (`E_NETWORK_FAIL`, `E_PARSING_FAIL`, dll.). 6. **Dibangun dengan TypeScript**: Memberikan *type safety* dan *developer experience* terbaik untuk proyek-proyek modern. ## 🛠️ Instalasi Pastikan Anda memiliki **Node.js (v18+)** terinstal. ```bash npm install @xbibzlibrary/teraboxscraper # atau yarn add @xbibzlibrary/teraboxscraper ``` ## 📚 Dokumentasi & Cara Kerja ### 1. Mendapatkan Cookie (Kunci Utama) Terabox memerlukan otentikasi untuk mengakses *direct download link*. Anda **wajib** menyediakan cookie `ndus` dari sesi Terabox yang sudah login. 1. Buka [Terabox](https://www.terabox.app) di browser Anda (disarankan Chrome/Edge). 2. Login ke akun Anda. 3. Buka *Developer Tools* (F12), buka tab **Application** -> **Storage** -> **Cookies**. 4. Cari cookie dengan nama `ndus` dan salin nilainya. 5. Format cookie yang digunakan adalah: `"lang=en; ndus=NILAI_NDUS_ANDA;"` ### 2. Penggunaan Dasar Berikut adalah contoh penggunaan yang **kompleks** namun **jelas** untuk mendapatkan info file dan mengunduhnya. ```typescript import { TeraboxScraper, DownloadProgress, Logger, bytesToHuman } from '@xbibzlibrary/teraboxscraper'; import * as path from 'path'; // Inisialisasi Logger untuk output terminal yang menarik const logger = Logger.getInstance({ level: 'info', prettyPrint: true }).getLogger(); // Konfigurasi Anda const YOUR_COOKIE = "lang=en; ndus=YOUR_NDUS_COOKIE_HERE;"; const SHARE_LINK = "https://www.terabox.app/s/xxxxxxxxxxxxxxxx"; /** * Fungsi progress bar kustom yang powerfull untuk terminal */ function customProgressBar(progress: DownloadProgress): void { const totalSizeHuman = bytesToHuman(progress.totalSize); const downloadedHuman = bytesToHuman(progress.downloaded); const speedHuman = bytesToHuman(progress.speedBps) + '/s'; const eta = progress.etaSeconds === Infinity ? 'N/A' : `${progress.etaSeconds.toFixed(0)}s`; const barLength = 40; const filledLength = Math.round(barLength * progress.percentage / 100); const emptyLength = barLength - filledLength; const bar = '█'.repeat(filledLength) + '░'.repeat(emptyLength); process.stdout.write( `\r[${bar}] ${progress.percentage.toFixed(2)}% | ${downloadedHuman} / ${totalSizeHuman} | Speed: ${speedHuman} | ETA: ${eta}` ); } async function startDownload() { try { // 1. Inisialisasi Scraper const scraper = new TeraboxScraper({ cookie: YOUR_COOKIE, timeout: 60000, // proxy: 'http://user:pass@host:port', // Opsi Proxy }); // 2. Ambil Informasi File (Tahap Scraping & API) logger.info(`Memproses link: ${SHARE_LINK}`); const infoResponse = await scraper.getFileInfo(SHARE_LINK); if (!infoResponse.success || !infoResponse.data) { logger.error('Gagal mendapatkan info file.', infoResponse.error); return; } const fileInfo = infoResponse.data; logger.info('Info File Ditemukan:', { Nama: fileInfo.fileName, Ukuran: fileInfo.fileSizeHuman, }); // 3. Unduh File (Tahap Download Stream) const downloadDir = path.join(process.cwd(), 'downloads'); logger.info(`Memulai pengunduhan ke: ${downloadDir}`); const downloadResponse = await scraper.downloadFile( fileInfo, downloadDir, customProgressBar // Callback progress bar ); // Bersihkan baris progress bar process.stdout.write('\r' + ' '.repeat(100) + '\r'); if (!downloadResponse.success || !downloadResponse.data) { logger.error('Pengunduhan gagal total.', downloadResponse.error); return; } logger.info('✅ Pengunduhan Selesai!', { path: downloadResponse.data.filePath, durasi: `${(downloadResponse.data.durationMs / 1000).toFixed(2)} detik`, }); } catch (e) { logger.fatal('Terjadi kesalahan kritis tak terduga.', { error: e }); } } startDownload(); ``` ## 👤 Informasi Pengembang | Kategori | Detail | | :--- | :--- | | **Author** | Xbibz Official | | **Telegram** | [t.me/XbibzOfficial](https://t.me/XbibzOfficial) | | **TikTok** | [tiktok.com/@XbibzOfficiall](https://tiktok.com/@XbibzOfficiall) | | **Donasi** | [ko-fi.com/XbibzOfficial](https://ko-fi.com/XbibzOfficial) |

Dibuat dengan dedikasi oleh Xbibz Official.

--- ## 📄 Lisensi Library ini dirilis di bawah lisensi **ISC**.