feat: implement multi-provider YouTube transcript downloader with fallback support

Dockerfile

@@ -1,12 +1,19 @@
 # 1. اختيار النسخة الأساسية
-FROM python:3.10-slim
+FROM python:3.11-slim
 
 # 2. تسطيب برامج النظام (ffmpeg للتعامل مع الصوت)
 RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
     ffmpeg \
+    openssl \
     curl \
+    nodejs \
     && rm -rf /var/lib/apt/lists/*
 
+ENV SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt \
+    REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt \
+    CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
+
 # 3. تجهيز فولدر المشروع
 WORKDIR /app
 
@@ -22,4 +29,4 @@ RUN chown -R 1000:1000 /app
 USER 1000
 
 # 7. أمر تشغيل السيرفر الأساسي
-CMD ["uvicorn", "src.api.main:app", "--host", "0.0.0.0", "--port", "7860"]
+CMD ["uvicorn", "src.api.main:app", "--host", "0.0.0.0", "--port", "7860"]

src/api/downloader.py

@@ -18,6 +18,8 @@ _FAST_FAIL_SSL_MARKERS = (
     "SSLEOFError",
     "EOF occurred in violation of protocol",
     "TLS",
+    "TLS connect error",
+    "invalid library",
 )
 
 
@@ -185,6 +187,7 @@ class YouTubeDownloader:
             'no_warnings': True,
             'extract_flat': False,
         }
+        self._apply_youtube_network_options(ydl_opts)
         self._apply_cookie_options(ydl_opts)
 
         try:
@@ -254,6 +257,7 @@ class YouTubeDownloader:
                 }
             ],
         }
+        self._apply_youtube_network_options(ydl_opts)
         self._apply_cookie_options(ydl_opts)
 
         failures: List[str] = []
@@ -311,6 +315,31 @@ class YouTubeDownloader:
         if cookie_file:
             ydl_opts["cookiefile"] = str(cookie_file)
 
+    def _apply_youtube_network_options(self, ydl_opts: dict) -> None:
+        ydl_opts.update(
+            {
+                "source_address": "0.0.0.0",
+                "socket_timeout": 30,
+                "retries": 5,
+                "fragment_retries": 5,
+                "nocheckcertificate": True,
+                "geo_bypass": True,
+                "http_headers": {
+                    "User-Agent": (
+                        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+                        "AppleWebKit/537.36 (KHTML, like Gecko) "
+                        "Chrome/124.0.0.0 Safari/537.36"
+                    ),
+                    "Accept-Language": "en-US,en;q=0.9",
+                },
+                "extractor_args": {
+                    "youtube": {
+                        "player_client": ["android", "web_safari", "tv"],
+                    },
+                },
+            }
+        )
+
     def _resolve_cookie_file(self) -> Path | None:
         if self._youtube_cookies_file:
             cookie_path = Path(self._youtube_cookies_file)