douyin-downloader 0.1.0

package/dist/src/douyin/browser/manager.js

@@ -0,0 +1,344 @@
+"use strict";
+// src/douyin/browser/manager.ts
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchBrowser = launchBrowser;
+exports.newPage = newPage;
+exports.setCookiesOnPage = setCookiesOnPage;
+exports.closeBrowser = closeBrowser;
+exports.launchLoginBrowser = launchLoginBrowser;
+const puppeteer_extra_1 = __importDefault(require("puppeteer-extra"));
+const puppeteer_extra_plugin_stealth_1 = __importDefault(require("puppeteer-extra-plugin-stealth"));
+const logger_1 = require("../../utils/logger"); // 確保路徑正確
+const env_paths_1 = __importDefault(require("env-paths")); // 匯入 env-paths
+const path_1 = __importDefault(require("path")); // 匯入 path 模組
+const fs_1 = __importDefault(require("fs")); // 匯入 fs 模組
+// 應用 stealth plugin (理想情況下應在應用程式入口點執行一次)
+// 暫時放在這裡以保持模組封裝性
+// 使用 !puppeteer.plugins.some(...) 檢查確保只應用一次
+if (!puppeteer_extra_1.default.plugins.find((p) => p.name === 'stealth')) {
+    puppeteer_extra_1.default.use((0, puppeteer_extra_plugin_stealth_1.default)());
+    logger_1.utilsLogger.debug('Stealth plugin applied to puppeteer-extra in browser manager.');
+}
+// --- 預設 User Data Directory ---
+// 定義應用程式名稱
+const APP_NAME = 'douyin-downloader';
+// 獲取標準路徑
+const paths = (0, env_paths_1.default)(APP_NAME, { suffix: '' }); // suffix: '' 避免額外的 'nodejs' 路徑
+// 建立 Puppeteer 專用的資料目錄路徑
+const puppeteerUserDataPath = path_1.default.join(paths.data, 'puppeteer');
+// 確保目錄存在
+try {
+    fs_1.default.mkdirSync(puppeteerUserDataPath, { recursive: true });
+    logger_1.utilsLogger.debug(`預設 Puppeteer User Data Directory 設定為: ${puppeteerUserDataPath}`);
+}
+catch (error) {
+    logger_1.utilsLogger.error(`無法創建預設 Puppeteer User Data Directory (${puppeteerUserDataPath}):`, error);
+    // 如果無法創建，則不設定預設值，讓 Puppeteer 使用其內部預設
+}
+/**
+ * 啟動一個新的 Puppeteer 瀏覽器實例。
+ * @param options 啟動選項
+ * @returns Promise<Browser>
+ */
+async function launchBrowser(options = {}) {
+    logger_1.utilsLogger.debug('啟動新的 Puppeteer 瀏覽器實例...', options);
+    let headlessOption;
+    if (options.headless === 'shell') {
+        headlessOption = 'shell';
+    }
+    else if (options.headless === false) {
+        headlessOption = false;
+    }
+    else {
+        // 預設為新版無頭模式 (如果未定義或為 true)
+        // 注意: @types/puppeteer 可能不直接支援 'new' 字面值，使用 true 作為替代
+        // 預設為新版無頭模式 (如果未定義或為 true)
+        // 注意: @types/puppeteer 可能不直接支援 'new' 字面值，使用 true 作為替代
+        // headlessOption = true; // Keep previous logic for reference
+        // Match reference/DouyinParser.ts: force non-headless for login, allow override?
+        // For launchBrowser (general purpose), let's keep the flexible option
+        // For launchLoginBrowser, it forces headless: false
+        // Map 'new' to true, otherwise use the provided value or default undefined to true.
+        if (options.headless === 'new') {
+            headlessOption = true; // Map 'new' to classic headless (true)
+            logger_1.utilsLogger.debug("Mapping headless: 'new' to headless: true");
+        }
+        else {
+            // Assign 'shell', false, true directly. Default undefined to true.
+            headlessOption = options.headless === undefined ? true : options.headless;
+        }
+    }
+    // Revert to more comprehensive args, keeping lang setting
+    const defaultArgs = [
+        '--no-sandbox',
+        '--disable-setuid-sandbox',
+        '--disable-dev-shm-usage', // Crucial for Docker/CI environments
+        // '--disable-accelerated-2d-canvas',
+        '--no-first-run',
+        '--no-zygote',
+        // '--disable-gpu', // Often needed in headless environments
+        // '--disable-extensions',
+        '--disable-background-networking',
+        '--disable-background-timer-throttling',
+        // '--disable-popup-blocking',
+        '--disable-hang-monitor',
+        '--disable-ipc-flooding-protection',
+        '--disable-renderer-backgrounding',
+        '--enable-automation',
+        '--disable-infobars', // Hide "Chrome is controlled by automated test software"
+        '--disable-blink-features=AutomationControlled', // Further hide automation flags
+        '--window-size=1920,1080', // Set window size via args
+        '--lang=zh-CN' // Keep language setting
+    ];
+    if (!options.userDataDir)
+        logger_1.utilsLogger.debug('未提供 userDataDir，將使用預設路徑:', puppeteerUserDataPath);
+    const launchOptions = {
+        headless: headlessOption,
+        executablePath: options.executablePath,
+        // 優先使用選項中提供的 userDataDir，否則使用 env-paths 計算出的預設路徑 (如果成功創建)
+        userDataDir: options.userDataDir ?? (fs_1.default.existsSync(puppeteerUserDataPath) ? puppeteerUserDataPath : undefined),
+        args: [...defaultArgs, ...(options.args || [])], // Combine default and custom args
+        defaultViewport: { width: 1920, height: 1080 }, // Keep null when using window-size arg
+        timeout: options.timeout || 60000,
+        env: {
+            ...process.env, // Inherit existing env vars
+            LANG: 'zh_CN.UTF-8'
+        }
+    };
+    try {
+        const browser = await puppeteer_extra_1.default.launch(launchOptions);
+        const pid = browser.process()?.pid;
+        logger_1.utilsLogger.debug(`Puppeteer 瀏覽器已成功啟動 (PID: ${pid})`);
+        // 監聽斷開連接事件
+        browser.on('disconnected', () => {
+            logger_1.utilsLogger.warn(`Puppeteer 瀏覽器 (PID: ${pid}) 已斷開連接。`);
+        });
+        // 將啟動選項附加到瀏覽器實例上，供 newPage 使用
+        browser.__launchOptions = options;
+        return browser;
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        logger_1.utilsLogger.error('啟動 Puppeteer 瀏覽器失敗:', err);
+        // 考慮拋出更具體的錯誤類型
+        throw new Error(`無法啟動瀏覽器: ${err.message}`);
+    }
+}
+/**
+ * 在指定的瀏覽器實例中創建一個新頁面。
+ * 應用通用設定，如 User-Agent 和資源攔截。
+ * @param browser 瀏覽器實例
+ * @param options 創建頁面的選項 (可覆蓋瀏覽器啟動時的選項)
+ * @returns Promise<Page>
+ */
+async function newPage(browser, options = {}) {
+    // 從瀏覽器實例獲取啟動選項作為預設值
+    const browserLaunchOptions = browser.__launchOptions || {};
+    // 合併選項，優先使用 newPage 傳入的選項
+    const pageOptions = {
+        // Update default User-Agent to match reference/DouyinParser.ts
+        userAgent: options.userAgent ?? browserLaunchOptions.userAgent ?? 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        blockResources: options.blockResources ?? browserLaunchOptions.blockResources ?? false, // 預設阻擋資源
+        timeout: options.timeout ?? browserLaunchOptions.timeout ?? 60000, // 使用瀏覽器或預設超時
+    };
+    logger_1.utilsLogger.debug(`準備獲取或創建新頁面，選項:`, pageOptions);
+    let page;
+    const pages = await browser.pages();
+    // 檢查是否存在一個 'about:blank' 頁面可供重複使用
+    if (pages.length === 1 && pages[0].url() === 'about:blank') {
+        logger_1.utilsLogger.debug('發現一個現有的 about:blank 頁面，將重複使用它。');
+        page = pages[0];
+    }
+    else {
+        logger_1.utilsLogger.debug('未找到可重複使用的 about:blank 頁面，創建新頁面。');
+        page = await browser.newPage();
+    }
+    try {
+        // 設定 User-Agent
+        await page.setUserAgent(pageOptions.userAgent);
+        // 設定 Accept-Language HTTP 標頭
+        await page.setExtraHTTPHeaders({
+            'Accept-Language': 'zh-CN,zh;q=0.9' // Prefer Simplified Chinese
+        });
+        logger_1.utilsLogger.debug('Accept-Language header set to zh-CN');
+        // 設定請求攔截 (資源阻擋)
+        if (pageOptions.blockResources) {
+            await page.setRequestInterception(true);
+            page.on('request', (request) => {
+                const resourceType = request.resourceType();
+                // 阻擋圖片、樣式表、字體、媒體資源
+                if (['image', 'stylesheet', 'font', 'media'].includes(resourceType)) { //
+                    request.abort().catch(e => logger_1.utilsLogger.debug(`無法中止請求 ${request.url()}: ${e.message}`)); // 改用 debug 級別
+                }
+                else {
+                    request.continue().catch(e => logger_1.utilsLogger.debug(`無法繼續請求 ${request.url()}: ${e.message}`)); // 改用 debug 級別
+                }
+            });
+        }
+        // 設定預設超時
+        page.setDefaultNavigationTimeout(pageOptions.timeout * 2); // 導航超時設為兩倍
+        page.setDefaultTimeout(pageOptions.timeout);
+        logger_1.utilsLogger.debug(`頁面創建成功。`);
+        return page;
+    }
+    catch (error) {
+        logger_1.utilsLogger.error('配置新頁面失敗:', error);
+        // 如果頁面已創建但配置失敗，嘗試關閉它
+        if (!page.isClosed()) {
+            await page.close().catch(e => logger_1.utilsLogger.error('配置錯誤後關閉頁面失敗:', e));
+        }
+        throw error; // 重新拋出錯誤
+    }
+}
+/**
+ * 在指定的頁面上設置 Cookie。
+ * @param page Puppeteer 頁面實例
+ * @param cookieString Cookie 字串 (例如來自 document.cookie)
+ * @param domain 可選: Cookie 的域。如果未提供，則嘗試從頁面 URL 推斷。
+ */
+async function setCookiesOnPage(page, cookieString, domain = '.douyin.com') {
+    if (!cookieString) {
+        logger_1.utilsLogger.debug('未提供 cookie 字串，跳過 setCookiesOnPage。');
+        return;
+    }
+    let targetDomain = domain;
+    const pageUrl = page.url();
+    // 如果未提供 domain，嘗試從 page URL 推斷
+    if (!targetDomain && pageUrl && pageUrl !== 'about:blank') {
+        try {
+            targetDomain = new URL(pageUrl).hostname;
+        }
+        catch (e) {
+            logger_1.utilsLogger.warn(`無法從 URL 解析 domain: ${pageUrl}`, e);
+        }
+    }
+    if (!targetDomain) {
+        logger_1.utilsLogger.warn(`無法確定 Cookie 的域 (URL: ${pageUrl})。跳過設置 Cookie。`);
+        return;
+    }
+    try {
+        // Match reference/DouyinParser.ts: Use hardcoded domain
+        const cookieDomain = '.douyin.com';
+        logger_1.utilsLogger.debug(`解析 Cookie，將使用固定 domain: ${cookieDomain} 進行設置`);
+        // 解析 Cookie 字串 (Simplified like reference)
+        const cookiesToSet = cookieString.split(';')
+            .map(pair => {
+            const parts = pair.trim().split('=');
+            if (parts.length >= 2) {
+                const name = parts[0].trim();
+                const value = parts.slice(1).join('=').trim(); // Keep original value, don't decode like current code
+                if (!name || value === undefined)
+                    return null;
+                // Set name, value, domain, and a far-future expires date for persistence
+                const farFuture = new Date();
+                farFuture.setFullYear(farFuture.getFullYear() + 1); // Expire in 1 year
+                return {
+                    name,
+                    value,
+                    domain: cookieDomain,
+                    expires: farFuture.getTime() / 1000, // Puppeteer expects Unix timestamp in seconds
+                    path: '/' // Add common path
+                };
+            }
+            return null;
+        })
+            .filter(cookie => cookie !== null); // Simple filter
+        if (cookiesToSet.length > 0) {
+            // Use 'as any[]' like reference, although CookieParam[] should work if types match
+            await page.setCookie(...cookiesToSet);
+            logger_1.utilsLogger.debug(`為域 ${cookieDomain} 設置了 ${cookiesToSet.length} 個 Cookie`);
+        }
+        else {
+            logger_1.utilsLogger.warn(`從字串解析後沒有有效的 Cookie 可設置: "${cookieString}"`);
+        }
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        logger_1.utilsLogger.error(`設置 Cookie 失敗 (Domain: ${domain}, URL: ${pageUrl}):`, err);
+        // 可選擇重新拋出錯誤或進行其他處理
+    }
+}
+/**
+ * 安全地關閉瀏覽器實例。
+ * @param browser 要關閉的瀏覽器實例
+ */
+async function closeBrowser(browser) {
+    if (browser && browser.isConnected()) {
+        const pid = browser.process()?.pid;
+        logger_1.utilsLogger.debug(`正在關閉瀏覽器實例 (PID: ${pid})...`);
+        try {
+            await browser.close();
+            logger_1.utilsLogger.debug(`瀏覽器實例 (PID: ${pid}) 已成功關閉。`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger_1.utilsLogger.error(`關閉瀏覽器實例 (PID: ${pid}) 失敗:`, err);
+            // 根據需要決定是否重新拋出錯誤
+        }
+    }
+    else {
+        logger_1.utilsLogger.debug('瀏覽器實例已關閉或為 null。');
+    }
+}
+/**
+ * 創建一個專用於登入的瀏覽器實例 (非無頭模式)。
+ * 返回瀏覽器、頁面和一個清理函數。
+ * @param options 登入瀏覽器的特定啟動選項
+ * @returns Promise<{ browser: Browser; page: Page; cleanup: () => Promise<void> }>
+ */
+async function launchLoginBrowser(options = {}) {
+    logger_1.utilsLogger.info('啟動專用登入瀏覽器 (非無頭模式)...');
+    // 強制非無頭模式，並可能使用不同的用戶數據目錄
+    const loginOptions = {
+        ...options,
+        headless: false, // 確保非無頭
+        blockResources: options.blockResources ?? false, // 登入時通常需要看到所有內容
+        timeout: options.timeout || 120000, // 為手動登入設置更長的超時
+    };
+    let browser = null;
+    let page = null;
+    try {
+        // 使用通用的 launchBrowser 啟動瀏覽器
+        browser = await launchBrowser(loginOptions);
+        // 使用通用的 newPage 創建頁面，繼承部分選項
+        page = await newPage(browser, {
+            blockResources: loginOptions.blockResources,
+            timeout: loginOptions.timeout,
+            userAgent: loginOptions.userAgent, // 傳遞指定的 User Agent
+        });
+        // 特別為登入互動增加超時時間
+        page.setDefaultNavigationTimeout(loginOptions.timeout * 2); // 使用 ! 斷言 timeout 已有預設值
+        page.setDefaultTimeout(loginOptions.timeout);
+        // 創建清理函數
+        const cleanup = async () => {
+            logger_1.utilsLogger.debug('開始清理登入瀏覽器資源...');
+            // 先關閉頁面，再關閉瀏覽器
+            if (page && !page.isClosed()) {
+                try {
+                    await page.close();
+                    logger_1.utilsLogger.debug('登入頁面已關閉。');
+                }
+                catch (e) {
+                    logger_1.utilsLogger.error('關閉登入頁面時出錯:', e);
+                }
+            }
+            // 使用通用的 closeBrowser 函數
+            await closeBrowser(browser);
+            logger_1.utilsLogger.debug('登入瀏覽器清理完成。');
+        };
+        return { browser, page, cleanup };
+    }
+    catch (error) {
+        logger_1.utilsLogger.error('啟動或配置登入瀏覽器失敗:', error);
+        // 如果部分組件已創建，嘗試清理
+        if (page && !page.isClosed())
+            await page.close().catch(e => logger_1.utilsLogger.error('登入瀏覽器清理過程中關閉頁面出錯:', e));
+        if (browser)
+            await closeBrowser(browser); // 嘗試關閉瀏覽器
+        throw error; // 重新拋出原始錯誤
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/douyin/browser/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/douyin/browser/manager.ts"],"names":[],"mappings":"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"}

package/dist/src/douyin/download/download-manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 並行下載管理器
+ * 實現多個影片的並行下載和進度追蹤
+ */
+import { VideoInfo, DownloadResult as CommonDownloadResult } from '../../types';
+import { VideoDownloadOptions } from './video-downloader';
+/**
+ * 下載結果
+ */
+/**
+ * 批量下載選項
+ */
+export interface BatchDownloadOptions extends VideoDownloadOptions {
+    concurrency?: number;
+    onBatchProgress?: (current: number, total: number, overallProgress: number) => void;
+}
+/**
+ * 並行下載多個抖音影片
+ * @param videoInfoList 影片資訊列表
+ * @param outputPath 輸出路徑
+ * @param options 下載選項
+ * @returns Promise<DownloadResult[]> 下載結果列表
+ */
+export declare function downloadBatch(videoInfoList: VideoInfo[], // Use common VideoInfo
+outputPath: string, options?: BatchDownloadOptions): Promise<CommonDownloadResult[]>;

package/dist/src/douyin/download/download-manager.js

@@ -0,0 +1,107 @@
+"use strict";
+// Copied from src/download/download-manager.ts
+// Original file path: src/download/download-manager.ts
+/**
+ * 並行下載管理器
+ * 實現多個影片的並行下載和進度追蹤
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadBatch = downloadBatch;
+const video_downloader_1 = require("./video-downloader");
+const retry_1 = require("../../utils/retry"); // Updated path to shared utils
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+/**
+ * 並行下載多個抖音影片
+ * @param videoInfoList 影片資訊列表
+ * @param outputPath 輸出路徑
+ * @param options 下載選項
+ * @returns Promise<DownloadResult[]> 下載結果列表
+ */
+async function downloadBatch(videoInfoList, // Use common VideoInfo
+outputPath, options = {}) {
+    const { concurrency = 3, onBatchProgress, ...videoOptions } = options;
+    const total = videoInfoList.length;
+    logger_1.downloadLogger.info(`開始下載 ${total} 個影片，並行數量: ${concurrency}`);
+    // 用於追蹤每個影片的進度
+    const progressMap = new Map();
+    // 更新總體進度的函數
+    const updateOverallProgress = () => {
+        if (!onBatchProgress)
+            return;
+        // 計算總體進度百分比
+        let totalProgress = 0;
+        progressMap.forEach((progress) => {
+            totalProgress += progress;
+        });
+        const overallProgress = progressMap.size > 0
+            ? Math.round(totalProgress / progressMap.size)
+            : 0;
+        // 回調總體進度
+        onBatchProgress(progressMap.size, total, overallProgress);
+    };
+    // 使用 withConcurrency 並行下載
+    // Use processBatch with correct types and handle its return value { results, errors }
+    const batchOutcome = await (0, retry_1.processBatch)(videoInfoList, async (videoInfo, index) => {
+        try {
+            // 為每個影片創建獨立的進度回調
+            const onProgress = (progress) => {
+                progressMap.set(index, progress);
+                updateOverallProgress();
+            };
+            // 下載影片
+            // Use onFileProgress from videoOptions if available
+            const filePath = await (0, video_downloader_1.downloadVideo)(videoInfo, outputPath, {
+                ...videoOptions,
+                onFileProgress: onProgress // Pass the per-item progress callback to onFileProgress
+            });
+            // Removed the download_url logic as it's not in common VideoInfo
+            // 下載成功，設置進度為 100%
+            progressMap.set(index, 100);
+            updateOverallProgress();
+            // Return structure matching CommonDownloadResult
+            const result = {
+                videoInfo,
+                success: true,
+                filePath
+            };
+            return result;
+        }
+        catch (error) {
+            // 下載失敗，記錄錯誤
+            const errorObj = error instanceof Error ? error : new Error(String(error));
+            logger_1.downloadLogger.error(`下載影片 ${videoInfo.id} 失敗:`, errorObj);
+            // Return structure matching CommonDownloadResult for failure case
+            const result = {
+                videoInfo,
+                success: false,
+                error: errorObj // Use the captured error object
+            };
+            return result;
+        }
+    }, {
+        concurrency,
+        retries: 0, // 在 downloadVideo 中已經有重試機制
+        onProgress: (current, total) => {
+            if (onBatchProgress) {
+                // 這裡只更新完成的影片數量，不包含進度百分比
+                const overallProgress = progressMap.size > 0
+                    ? Math.round(Array.from(progressMap.values()).reduce((sum, p) => sum + p, 0) / progressMap.size)
+                    : 0;
+                onBatchProgress(current, total, overallProgress);
+            }
+        }
+    }); // batchOutcome is { results: CommonDownloadResult[], errors: Error[] }
+    // 統計成功和失敗數量
+    // Extract results and errors
+    const successfulDownloads = batchOutcome.results;
+    const downloadErrors = batchOutcome.errors;
+    const successCount = successfulDownloads.length;
+    const failCount = total - successCount; // Or use downloadErrors.length
+    logger_1.downloadLogger.info(`下載完成，成功: ${successCount}/${total}，失敗: ${failCount}/${total}`);
+    if (downloadErrors.length > 0) {
+        logger_1.downloadLogger.warn(`下載過程中發生 ${downloadErrors.length} 個錯誤`);
+    }
+    // Return the array of successful download results
+    return successfulDownloads;
+}
+//# sourceMappingURL=download-manager.js.map

package/dist/src/douyin/download/download-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-manager.js","sourceRoot":"","sources":["../../../../src/douyin/download/download-manager.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,uDAAuD;AACvD;;;GAGG;;AA2BH,sCA4GC;AApID,yDAAyE;AACzE,6CAAiD,CAAC,+BAA+B;AACjF,+CAA8D,CAAC,sCAAsC;AAerG;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,aAA0B,EAAE,uBAAuB;AACnD,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACtE,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;IAEnC,uBAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,cAAc,WAAW,EAAE,CAAC,CAAC;IAEtD,cAAc;IACd,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,YAAY;IACZ,MAAM,qBAAqB,GAAG,GAAG,EAAE;QACjC,IAAI,CAAC,eAAe;YAAE,OAAO;QAE7B,YAAY;QACZ,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,WAAW,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC/B,aAAa,IAAI,QAAQ,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,GAAG,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC;YAC9C,CAAC,CAAC,CAAC,CAAC;QAEN,SAAS;QACT,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,0BAA0B;IAC1B,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,IAAA,oBAAY,EACrC,aAAa,EACb,KAAK,EAAE,SAAoB,EAAE,KAAa,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAE;gBACtC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACjC,qBAAqB,EAAE,CAAC;YAC1B,CAAC,CAAC;YAEF,OAAO;YACP,oDAAoD;YACpD,MAAM,QAAQ,GAAG,MAAM,IAAA,gCAAa,EAAC,SAAS,EAAE,UAAU,EAAE;gBAC1D,GAAG,YAAY;gBACf,cAAc,EAAE,UAAU,CAAC,wDAAwD;aACpF,CAAC,CAAC;YACH,iEAAiE;YAEjE,kBAAkB;YAClB,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5B,qBAAqB,EAAE,CAAC;YAExB,iDAAiD;YACjD,MAAM,MAAM,GAAyB;gBACnC,SAAS;gBACT,OAAO,EAAE,IAAI;gBACb,QAAQ;aACT,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY;YACZ,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3E,uBAAM,CAAC,KAAK,CAAC,QAAQ,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEnD,kEAAkE;YAClE,MAAM,MAAM,GAAyB;gBACnC,SAAS;gBACT,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,QAAQ,CAAC,gCAAgC;aACjD,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC,EACD;QACE,WAAW;QACX,OAAO,EAAE,CAAC,EAAE,2BAA2B;QACvC,UAAU,EAAE,CAAC,OAAe,EAAE,KAAa,EAAE,EAAE;YAC7C,IAAI,eAAe,EAAE,CAAC;gBACpB,wBAAwB;gBACxB,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,GAAG,CAAC;oBAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;oBAChG,CAAC,CAAC,CAAC,CAAC;gBAEN,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;KACF,CACF,CAAC,CAAC,uEAAuE;IAE1E,YAAY;IACZ,6BAA6B;IAC7B,MAAM,mBAAmB,GAAG,YAAY,CAAC,OAAO,CAAC;IACjD,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC;IAE3C,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC,CAAC,+BAA+B;IAEvE,uBAAM,CAAC,IAAI,CAAC,YAAY,YAAY,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC;IAC3E,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,uBAAM,CAAC,IAAI,CAAC,WAAW,cAAc,CAAC,MAAM,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,kDAAkD;IAClD,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/src/douyin/download/error-handler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 錯誤處理和重試機制
+ * 提供下載錯誤處理和智能重試邏輯
+ */
+/**
+ * 下載錯誤類型
+ */
+export declare class DownloadError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly url: string;
+    constructor(message: string, url: string, code?: string, retryable?: boolean);
+    /**
+     * 判斷錯誤是否可重試
+     */
+    isRetryable(): boolean;
+}
+/**
+ * 重試選項
+ */
+export interface RetryOptions {
+    retries: number;
+    minDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+    onRetry?: (error: Error, attempt: number) => void;
+    onProgress?: (progress: number) => void;
+}
+/**
+ * 帶重試機制的下載函數
+ * @param downloadFn 下載函數
+ * @param url 下載 URL
+ * @param options 重試選項
+ * @returns Promise<T> 下載結果
+ */
+export declare function downloadWithRetry<T>(downloadFn: (onProgress?: (progress: number) => void) => Promise<T>, url: string, options: RetryOptions): Promise<T>;
+/**
+ * 判斷錯誤是否可重試
+ * @param error 錯誤對象
+ * @returns 是否可重試
+ */
+export declare function isRetryableError(error: Error): boolean;
+/**
+ * 處理下載錯誤並返回友好的錯誤消息
+ * @param error 原始錯誤
+ * @param url 下載 URL
+ * @returns 友好的錯誤消息
+ */
+export declare function getDownloadErrorMessage(error: unknown, url: string): string;