shadowx-fbdl 1.0.0

package/README.md

@@ -0,0 +1,86 @@
+shadowx-fbdl
+
+🤖DEV : Mueid Mursalin Rifat
+
+🚀 Simple Facebook video downloader - Supports FB, FB Watch, Reels & Shares
+
+📦 Install
+
+```bash
+npm install shadowx-fbdl
+```
+
+🚀 Quick Usage
+
+```javascript
+const ShadowXFB = require('shadowx-fbdl');
+const fbdl = new ShadowXFB();
+
+// Download Facebook video
+fbdl.download('https://fb.watch/abc123/')
+  .then(result => {
+    console.log('Title:', result.video.title);
+    console.log('Download URL:', result.download.url);
+  })
+  .catch(error => console.log(error.message));
+```
+
+📋 Examples
+
+Get video info only
+
+```javascript
+const info = await fbdl.getInfo('https://fb.watch/abc123/');
+```
+
+Get direct download URL
+
+```javascript
+const url = await fbdl.getDownloadUrl('https://fb.watch/abc123/');
+```
+
+Check if URL is valid
+
+```javascript
+if (fbdl.isValidUrl('https://fb.watch/abc123/')) {
+  console.log('✅ Valid Facebook URL');
+}
+```
+
+🔗 Supported URLs
+
+· https://www.facebook.com/watch?v=ID
+· https://fb.watch/ID/
+· https://www.facebook.com/reel/ID
+· https://www.facebook.com/share/v/ID/
+
+📤 Response Example
+
+```javascript
+{
+  video: {
+    title: "Video Title",
+    duration: "2:30",
+    uploader: "Page Name",
+    views: "1.2M"
+  },
+  download: {
+    quality: "HD",
+    size: "5.2 MB",
+    url: "https://.../video.mp4"
+  }
+}
+```
+
+⚙️ Options
+
+```javascript
+const fbdl = new ShadowXFB({
+  timeout: 30000,        // Timeout in ms
+  apiKey: 'shadowx'       // API key
+});
+```
+
+📝 License
+
+MIT ©

package/index.js

@@ -0,0 +1,384 @@
+const axios = require('axios');
+
+class ShadowXFB {
+  constructor(options = {}) {
+    this.baseURL = options.baseURL || 'https://shadowx-downloader.vercel.app';
+    this.apiKey = options.apiKey || 'shadowx';
+    this.timeout = options.timeout || 30000;
+    this.userAgent = options.userAgent || 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+    
+    // Create axios instance with default config
+    this.client = axios.create({
+      baseURL: this.baseURL,
+      timeout: this.timeout,
+      headers: {
+        'User-Agent': this.userAgent,
+        'Accept': 'application/json'
+      }
+    });
+  }
+
+  /**
+   * Get package metadata
+   * @returns {Object} Metadata information
+   */
+  static getMeta() {
+    return {
+      name: "shadowx-fbdl",
+      version: "2.0.0",
+      description: "Download videos from Facebook (FB, FB Watch, Reels, Shares)",
+      author: "Mueid Mursalin Rifat",
+      license: "MIT",
+      supported_urls: [
+        "https://www.facebook.com/watch?v=VIDEO_ID",
+        "https://fb.watch/VIDEO_ID/",
+        "https://www.facebook.com/reel/VIDEO_ID",
+        "https://www.facebook.com/share/v/VIDEO_ID/",
+        "https://www.facebook.com/username/videos/VIDEO_ID"
+      ]
+    };
+  }
+
+  /**
+   * Validate Facebook URL
+   * @param {string} url - URL to validate
+   * @returns {boolean} True if valid Facebook video URL
+   */
+  isValidUrl(url) {
+    if (!url || typeof url !== 'string') return false;
+    
+    const patterns = [
+      /facebook\.com\/.*\/videos/i,
+      /facebook\.com\/watch(?:\?v=|.*?\bv=)/i,
+      /fb\.watch\//i,
+      /facebook\.com\/reel/i,
+      /facebook\.com\/share\/v/i,
+      /fb\.com\//i,
+      /facebook\.com\/[^\/]+\/videos/i,
+      /web\.facebook\.com/i
+    ];
+    
+    return patterns.some(pattern => pattern.test(url));
+  }
+
+  /**
+   * Extract video ID from Facebook URL
+   * @param {string} url - Facebook URL
+   * @returns {string|null} Video ID or null
+   */
+  extractVideoId(url) {
+    const patterns = [
+      /videos[\/=](\d+)/i,
+      /watch\?v=(\d+)/i,
+      /reel\/(\d+)/i,
+      /share\/v\/(\d+)/i,
+      /fb\.watch\/([a-zA-Z0-9]+)/i,
+      /\/(\d+)\//
+    ];
+    
+    for (const pattern of patterns) {
+      const match = url.match(pattern);
+      if (match) return match[1];
+    }
+    
+    return null;
+  }
+
+  /**
+   * Download Facebook video
+   * @param {string} url - Facebook video URL
+   * @param {Object} options - Download options
+   * @returns {Promise<Object>} Video information and download links
+   */
+  async download(url, options = {}) {
+    // Validate input
+    if (!url) {
+      throw new Error('Facebook URL is required');
+    }
+
+    if (!this.isValidUrl(url)) {
+      throw new Error('Invalid Facebook URL format. Supported: Watch, Reels, Shares, FB Watch links');
+    }
+
+    const startTime = Date.now();
+    const videoId = this.extractVideoId(url);
+
+    try {
+      console.log(`🚀 shadowx-fbdl: Fetching video from ${url}`);
+
+      // Make request to ShadowX API
+      const response = await this.client.get('/dl', {
+        params: {
+          url: url,
+          key: options.apiKey || this.apiKey
+        },
+        timeout: options.timeout || this.timeout
+      });
+
+      const data = response.data;
+      const endTime = Date.now();
+      const downloadTime = ((endTime - startTime) / 1000).toFixed(2);
+
+      // Check API response
+      if (!data || !data.success) {
+        throw new Error(data?.error || 'Failed to fetch video information');
+      }
+
+      // Format the response
+      return this._formatResponse(data, url, videoId, downloadTime);
+
+    } catch (error) {
+      throw this._handleError(error, url);
+    }
+  }
+
+  /**
+   * Format API response
+   * @param {Object} data - Raw API data
+   * @param {string} originalUrl - Original URL
+   * @param {string} videoId - Video ID
+   * @param {string} downloadTime - Download time
+   * @returns {Object} Formatted response
+   * @private
+   */
+  _formatResponse(data, originalUrl, videoId, downloadTime) {
+    const baseURL = this.baseURL;
+    const downloadUrl = data.download?.url ? 
+      (data.download.url.startsWith('http') ? data.download.url : `${baseURL}${data.download.url}`) : 
+      null;
+
+    // Generate filename
+    const filename = data.download?.filename || 
+                     `facebook_video_${videoId || Date.now()}.mp4`;
+
+    // Calculate file size in human readable format
+    const filesizeBytes = data.download?.filesize_bytes || 0;
+    const filesizeMB = filesizeBytes ? (filesizeBytes / (1024 * 1024)).toFixed(2) : 0;
+
+    return {
+      success: true,
+      message: 'Video fetched successfully',
+      
+      // Package info
+      package: {
+        name: 'shadowx-fbdl',
+        version: '2.0.0',
+        author: 'Mueid Mursalin Rifat'
+      },
+      
+      // Video metadata
+      video: {
+        id: data.id || videoId || 'N/A',
+        title: data.title || 'Facebook Video',
+        description: data.description || '',
+        duration: data.duration || 'Unknown',
+        thumbnail: data.thumbnail || null,
+        uploader: data.uploader || 'Unknown',
+        uploader_id: data.uploader_id || null,
+        view_count: this._formatNumber(data.view_count),
+        like_count: this._formatNumber(data.like_count),
+        comment_count: this._formatNumber(data.comment_count),
+        share_count: this._formatNumber(data.share_count),
+        was_live: data.was_live || false,
+        platform: data.download?.platform || 'Facebook',
+        url: data.url || originalUrl,
+        created_time: data.created_time || null
+      },
+      
+      // Download information
+      download: {
+        quality: data.download?.quality || 'HD',
+        format: data.download?.format || 'mp4',
+        size: filesizeMB ? `${filesizeMB} MB` : 'Unknown',
+        size_bytes: filesizeBytes,
+        url: downloadUrl,
+        filename: filename,
+        direct_url: downloadUrl, // Alias for url
+        
+        // Additional download info
+        expires_in: data.download?.expires_in || null,
+        download_time: `${downloadTime}s`
+      },
+      
+      // Audio info (if available)
+      audio: data.audio_download ? {
+        url: data.audio_download.url,
+        size: data.audio_download.size,
+        format: data.audio_download.format
+      } : null,
+      
+      // Additional metadata
+      metadata: {
+        requested_url: originalUrl,
+        extracted_id: videoId,
+        timestamp: new Date().toISOString(),
+        api_response_time: downloadTime
+      },
+      
+      // Raw data for debugging
+      raw: data
+    };
+  }
+
+  /**
+   * Format large numbers with K/M/B suffixes
+   * @param {number|string} num - Number to format
+   * @returns {string} Formatted number
+   * @private
+   */
+  _formatNumber(num) {
+    if (!num && num !== 0) return 'N/A';
+    if (typeof num === 'string') num = parseInt(num.replace(/,/g, ''));
+    if (isNaN(num)) return 'N/A';
+    
+    if (num >= 1000000000) return (num / 1000000000).toFixed(1) + 'B';
+    if (num >= 1000000) return (num / 1000000).toFixed(1) + 'M';
+    if (num >= 1000) return (num / 1000).toFixed(1) + 'K';
+    return num.toString();
+  }
+
+  /**
+   * Handle and format errors
+   * @param {Error} error - Error object
+   * @param {string} url - Original URL
+   * @returns {Error} Formatted error
+   * @private
+   */
+  _handleError(error, url) {
+    let errorMessage = 'Failed to download Facebook video';
+    let statusCode = 500;
+    let errorCode = 'UNKNOWN_ERROR';
+
+    if (error.response) {
+      // API responded with error
+      statusCode = error.response.status;
+      const apiError = error.response.data?.error || error.response.statusText;
+      
+      switch (statusCode) {
+        case 400:
+          errorMessage = 'Invalid Facebook URL or video not accessible';
+          errorCode = 'INVALID_URL';
+          break;
+        case 401:
+        case 403:
+          errorMessage = 'Access denied or invalid API key';
+          errorCode = 'ACCESS_DENIED';
+          break;
+        case 404:
+          errorMessage = 'Video not found or has been removed';
+          errorCode = 'VIDEO_NOT_FOUND';
+          break;
+        case 429:
+          errorMessage = 'Rate limit exceeded. Please try again later';
+          errorCode = 'RATE_LIMITED';
+          break;
+        case 500:
+        case 502:
+        case 503:
+          errorMessage = 'Download service is temporarily unavailable';
+          errorCode = 'SERVICE_UNAVAILABLE';
+          break;
+        default:
+          errorMessage = `API Error: ${apiError}`;
+          errorCode = 'API_ERROR';
+      }
+    } else if (error.code === 'ECONNABORTED') {
+      errorMessage = 'Request timeout. The server might be busy';
+      errorCode = 'TIMEOUT';
+      statusCode = 408;
+    } else if (error.code === 'ENOTFOUND') {
+      errorMessage = 'Network error - cannot connect to download server';
+      errorCode = 'NETWORK_ERROR';
+      statusCode = 503;
+    } else if (error.message.includes('Invalid Facebook URL')) {
+      errorMessage = error.message;
+      errorCode = 'VALIDATION_ERROR';
+      statusCode = 400;
+    }
+
+    const formattedError = new Error(errorMessage);
+    formattedError.code = errorCode;
+    formattedError.statusCode = statusCode;
+    formattedError.url = url;
+    formattedError.originalError = error;
+    formattedError.timestamp = new Date().toISOString();
+    formattedError.suggestion = this._getSuggestion(errorCode);
+    
+    return formattedError;
+  }
+
+  /**
+   * Get suggestion based on error code
+   * @param {string} errorCode - Error code
+   * @returns {string} Suggestion
+   * @private
+   */
+  _getSuggestion(errorCode) {
+    const suggestions = {
+      'INVALID_URL': 'Make sure the URL is correct and the video is public',
+      'VIDEO_NOT_FOUND': 'The video may have been deleted or made private',
+      'RATE_LIMITED': 'Wait a few minutes before making more requests',
+      'ACCESS_DENIED': 'Check your API key or try again later',
+      'SERVICE_UNAVAILABLE': 'Try again in a few minutes',
+      'TIMEOUT': 'Try again or use a shorter video',
+      'NETWORK_ERROR': 'Check your internet connection',
+      'VALIDATION_ERROR': 'Use a supported Facebook URL format',
+      'API_ERROR': 'The download service encountered an error',
+      'UNKNOWN_ERROR': 'Please report this issue on GitHub'
+    };
+    
+    return suggestions[errorCode] || 'Please check the URL and try again';
+  }
+
+  /**
+   * Get video information without download links
+   * @param {string} url - Facebook video URL
+   * @returns {Promise<Object>} Video metadata
+   */
+  async getInfo(url) {
+    const result = await this.download(url);
+    // Remove download URLs from response
+    delete result.download.url;
+    delete result.download.direct_url;
+    result.download.available = true;
+    return result;
+  }
+
+  /**
+   * Get download URL only
+   * @param {string} url - Facebook video URL
+   * @param {string} quality - Video quality (hd, sd)
+   * @returns {Promise<string>} Direct download URL
+   */
+  async getDownloadUrl(url, quality = 'hd') {
+    const result = await this.download(url);
+    return result.download.url;
+  }
+
+  /**
+   * Check if URL is downloadable
+   * @param {string} url - Facebook URL
+   * @returns {Promise<boolean>} True if downloadable
+   */
+  async isDownloadable(url) {
+    try {
+      if (!this.isValidUrl(url)) return false;
+      const result = await this.getInfo(url);
+      return result.success && result.download.available;
+    } catch {
+      return false;
+    }
+  }
+}
+
+// Export for CommonJS
+module.exports = ShadowXFB;
+
+// Export factory function
+module.exports.create = (options) => new ShadowXFB(options);
+
+// Export default instance
+module.exports.default = new ShadowXFB();
+
+// Export metadata
+module.exports.meta = ShadowXFB.getMeta();

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "shadowx-fbdl",
+  "version": "1.0.0",
+  "description": "Powerful Facebook video downloader - Supports FB, FB Watch, Reels, Shares using ShadowX API",
+  "main": "index.js",
+  "scripts": {
+    "test": "node examples/basic-usage.js",
+    "start": "node index.js"
+  },
+  "keywords": [
+    "facebook",
+    "downloader",
+    "video",
+    "facebook-video",
+    "fb-downloader",
+    "fb",
+    "reels",
+    "facebook-reels",
+    "facebook-watch",
+    "shadowx",
+    "video-downloader",
+    "social-media-downloader",
+    "facebook-downloader",
+    "fb-video",
+    "reels-downloader"
+  ],
+  "author": "Mueid Mursalin Rifat",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mueidmursalin/shadowx-fbdl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mueidmursalin/shadowx-fbdl/issues"
+  },
+  "homepage": "https://github.com/mueidmursalin/shadowx-fbdl#readme",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE",
+    "examples/"
+  ]
+}