douyin-downloader 0.1.0

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

@@ -0,0 +1,225 @@
+"use strict";
+// Copied from src/info/browser-manager.ts
+// Original file path: src/info/browser-manager.ts
+/**
+ * 瀏覽器管理模組
+ * 使用 Puppeteer 提供瀏覽器實例管理
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserManager = exports.BrowserManager = void 0;
+exports.cleanupBrowser = cleanupBrowser;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const puppeteer_extra_1 = __importDefault(require("puppeteer-extra"));
+const puppeteer_extra_plugin_stealth_1 = __importDefault(require("puppeteer-extra-plugin-stealth"));
+// Apply the stealth plugin
+puppeteer_extra_1.default.use((0, puppeteer_extra_plugin_stealth_1.default)());
+/**
+ * 瀏覽器管理器
+ * 使用單例模式管理 Puppeteer 瀏覽器實例
+ */
+class BrowserManager {
+    static instance;
+    browser = null;
+    browserInitPromise = null;
+    options;
+    /**
+     * 獲取 BrowserManager 單例
+     * @param options 瀏覽器選項
+     * @returns BrowserManager 實例
+     */
+    static getInstance(options = {}) {
+        if (!BrowserManager.instance) {
+            BrowserManager.instance = new BrowserManager(options);
+        }
+        return BrowserManager.instance;
+    }
+    /**
+     * 私有構造函數，防止直接創建實例
+     * @param options 瀏覽器選項
+     */
+    constructor(options) {
+        this.options = {
+            headless: options.headless !== false, // 默認為 true (無頭模式)
+            timeout: options.timeout || 30000,
+            userAgent: options.userAgent ||
+                'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36',
+        };
+    }
+    /**
+     * 獲取瀏覽器實例
+     * 如果實例不存在，則創建新實例
+     * @returns Promise<Browser>
+     */
+    async getBrowser() {
+        // 如果瀏覽器存在且已連接，直接返回
+        if (this.browser && this.browser.isConnected()) {
+            return this.browser;
+        }
+        // 如果瀏覽器存在但已斷開連接，清除引用
+        if (this.browser && !this.browser.isConnected()) {
+            logger_1.infoLogger.debug('瀏覽器已斷開連接，將創建新實例');
+            this.browser = null;
+            this.browserInitPromise = null;
+        }
+        // 如果有正在進行的初始化，返回該 Promise
+        if (this.browserInitPromise) {
+            return this.browserInitPromise;
+        }
+        logger_1.infoLogger.debug('初始化 Puppeteer 瀏覽器...');
+        // 配置啟動選項
+        const launchOptions = {
+            headless: this.options.headless,
+            args: [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                '--disable-dev-shm-usage',
+                '--disable-accelerated-2d-canvas',
+                '--no-first-run',
+                '--no-zygote',
+                '--disable-gpu',
+                '--disable-extensions',
+                '--disable-background-networking',
+                '--disable-background-timer-throttling',
+                '--disable-backgrounding-occluded-windows',
+                '--disable-breakpad',
+                '--disable-component-extensions-with-background-pages',
+                '--disable-default-apps',
+                '--disable-translate',
+                '--metrics-recording-only'
+            ],
+            defaultViewport: { width: 1920, height: 1080 },
+            timeout: this.options.timeout,
+        };
+        // 使用 Promise 處理初始化，避免多次初始化
+        this.browserInitPromise = (async () => {
+            try {
+                const browser = await puppeteer_extra_1.default.launch(launchOptions);
+                // 監聽斷開連接事件
+                browser.on('disconnected', () => {
+                    logger_1.infoLogger.debug('Puppeteer 瀏覽器已斷開連接');
+                    this.browser = null;
+                    this.browserInitPromise = null;
+                });
+                this.browser = browser;
+                logger_1.infoLogger.debug('Puppeteer 瀏覽器已成功初始化');
+                return browser;
+            }
+            catch (error) {
+                const err = error;
+                logger_1.infoLogger.error('初始化 Puppeteer 瀏覽器失敗:', err);
+                this.browserInitPromise = null;
+                throw err;
+            }
+        })();
+        return this.browserInitPromise;
+    }
+    /**
+     * 創建新的頁面
+     * @param cookies 可選的 Cookie 字符串
+     * @returns Promise<Page>
+     */
+    async newPage(cookies) {
+        const browser = await this.getBrowser();
+        const page = await browser.newPage();
+        // 設置用戶代理
+        await page.setUserAgent(this.options.userAgent || '');
+        // 如果提供了 Cookie，則設置
+        if (cookies) {
+            await this.setCookies(page, cookies);
+        }
+        // 設置請求攔截（優化性能）
+        await page.setRequestInterception(true);
+        page.on('request', (request) => {
+            const resourceType = request.resourceType();
+            // 阻止加載不必要的資源
+            if (['image', 'stylesheet', 'font', 'media'].includes(resourceType)) {
+                request.abort();
+            }
+            else {
+                request.continue();
+            }
+        });
+        return page;
+    }
+    /**
+     * 設置頁面的 Cookie
+     * @param page Puppeteer 頁面實例
+     * @param cookieString Cookie 字符串
+     */
+    async setCookies(page, cookieString) {
+        if (!cookieString)
+            return;
+        try {
+            // 解析 Cookie 字符串
+            const cookies = cookieString.split(';')
+                .map(pair => {
+                const parts = pair.trim().split('=');
+                if (parts.length >= 2) {
+                    return {
+                        name: parts[0],
+                        value: parts.slice(1).join('='),
+                        domain: '.douyin.com' // 設置 domain 以確保 Cookie 生效
+                    };
+                }
+                return null;
+            })
+                .filter(cookie => cookie !== null);
+            if (cookies.length > 0) {
+                await page.setCookie(...cookies);
+                logger_1.infoLogger.debug(`已設置 ${cookies.length} 個 Cookie`);
+            }
+        }
+        catch (error) {
+            const err = error;
+            logger_1.infoLogger.error('設置 Cookie 失敗:', err);
+        }
+    }
+    /**
+     * 關閉瀏覽器實例
+     */
+    async close() {
+        if (this.browser) {
+            try {
+                await this.browser.close();
+                logger_1.infoLogger.debug('Puppeteer 瀏覽器已關閉');
+            }
+            catch (error) {
+                const err = error;
+                logger_1.infoLogger.error('關閉 Puppeteer 瀏覽器失敗:', err);
+            }
+            finally {
+                this.browser = null;
+                this.browserInitPromise = null;
+            }
+        }
+    }
+}
+exports.BrowserManager = BrowserManager;
+// 導出默認的瀏覽器管理器實例
+exports.browserManager = BrowserManager.getInstance();
+// 清理函數，用於在進程退出時關閉瀏覽器
+async function cleanupBrowser() {
+    logger_1.infoLogger.debug('執行瀏覽器清理...');
+    await exports.browserManager.close();
+}
+// 處理進程退出
+process.on('exit', () => {
+    // 同步操作，無法使用 await
+    logger_1.infoLogger.debug('進程退出，開始清理瀏覽器資源');
+});
+// 處理信號中斷（如 Ctrl+C）
+process.on('SIGINT', async () => {
+    logger_1.infoLogger.debug('收到 SIGINT 信號，開始清理瀏覽器資源');
+    await cleanupBrowser();
+    process.exit(0);
+});
+// 處理終止信號
+process.on('SIGTERM', async () => {
+    logger_1.infoLogger.debug('收到 SIGTERM 信號，開始清理瀏覽器資源');
+    await cleanupBrowser();
+    process.exit(0);
+});
+//# sourceMappingURL=browser-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-manager.js","sourceRoot":"","sources":["../../../../src/douyin/info/browser-manager.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,kDAAkD;AAClD;;;GAGG;;;;;;AA0NH,wCAGC;AA1ND,+CAA0D,CAAC,sCAAsC;AACjG,sEAAwC;AACxC,oGAA2D;AAE3D,2BAA2B;AAC3B,yBAAS,CAAC,GAAG,CAAC,IAAA,wCAAa,GAAE,CAAC,CAAC;AAS/B;;;GAGG;AACH,MAAa,cAAc;IACjB,MAAM,CAAC,QAAQ,CAAiB;IAChC,OAAO,GAAmB,IAAI,CAAC;IAC/B,kBAAkB,GAA4B,IAAI,CAAC;IACnD,OAAO,CAAwB;IAEvC;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,UAAiC,EAAE;QAC3D,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,YAAoB,OAA8B;QAChD,IAAI,CAAC,OAAO,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,kBAAkB;YACxD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,SAAS,EACP,OAAO,CAAC,SAAS;gBACjB,iHAAiH;SACpH,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,mBAAmB;QACnB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAED,qBAAqB;QACrB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAChD,mBAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC;QACjC,CAAC;QAED,mBAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAErC,SAAS;QACT,MAAM,aAAa,GAA2B;YAC5C,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAmB;YAC1C,IAAI,EAAE;gBACJ,cAAc;gBACd,0BAA0B;gBAC1B,yBAAyB;gBACzB,iCAAiC;gBACjC,gBAAgB;gBAChB,aAAa;gBACb,eAAe;gBACf,sBAAsB;gBACtB,iCAAiC;gBACjC,uCAAuC;gBACvC,0CAA0C;gBAC1C,oBAAoB;gBACpB,sDAAsD;gBACtD,wBAAwB;gBACxB,qBAAqB;gBACrB,0BAA0B;aAC3B;YACD,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;SAC9B,CAAC;QAEF,2BAA2B;QAC3B,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAK,IAAI,EAAE;YACpC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,yBAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBAEtD,WAAW;gBACX,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;oBAC9B,mBAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;oBACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;oBACpB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACjC,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACvB,mBAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACpC,OAAO,OAAO,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,mBAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;gBAC1C,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBAC/B,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAErC,SAAS;QACT,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAEtD,mBAAmB;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,eAAe;QACf,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAC5C,aAAa;YACb,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,YAAoB;QAC/C,IAAI,CAAC,YAAY;YAAE,OAAO;QAE1B,IAAI,CAAC;YACH,gBAAgB;YAChB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC;iBACpC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACV,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;oBACtB,OAAO;wBACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;wBACd,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;wBAC/B,MAAM,EAAE,aAAa,CAAC,0BAA0B;qBACjD,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;iBACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAU,CAAC;YAE9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC;gBACjC,mBAAM,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,mBAAM,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC3B,mBAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,mBAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA/LD,wCA+LC;AAED,gBAAgB;AACH,QAAA,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;AAE3D,qBAAqB;AACd,KAAK,UAAU,cAAc;IAClC,mBAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3B,MAAM,sBAAc,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS;AACT,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;IACtB,kBAAkB;IAClB,mBAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,mBAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvC,MAAM,cAAc,EAAE,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,SAAS;AACT,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,mBAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxC,MAAM,cAAc,EAAE,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 錯誤處理和重試機制
+ * 處理影片資訊獲取過程中的錯誤，實現智能重試
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    factor: number;
+}
+/**
+ * 判斷錯誤是否可重試
+ * @param error 錯誤對象
+ * @returns boolean 是否可重試
+ */
+export declare function isRetryableError(error: Error): boolean;
+/**
+ * 計算重試延遲時間
+ * @param attempt 當前嘗試次數（從 1 開始）
+ * @param config 重試配置
+ * @returns number 延遲時間（毫秒）
+ */
+export declare function calculateRetryDelay(attempt: number, config?: RetryConfig): number;
+/**
+ * 帶退避策略的重試函數
+ * @param fetcher 執行的函數
+ * @param config 重試配置
+ * @returns Promise<T> 函數執行結果
+ */
+export declare function fetchWithRetry<T>(fetcher: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * 處理特定的抖音 API 錯誤
+ * @param error 錯誤對象
+ * @returns Error 包含有用診斷信息的錯誤
+ */
+export declare function handleDouyinApiError(error: any): Error;

package/dist/src/douyin/info/error-handler.js

@@ -0,0 +1,172 @@
+"use strict";
+// Copied from src/info/error-handler.ts
+// Original file path: src/info/error-handler.ts
+/**
+ * 錯誤處理和重試機制
+ * 處理影片資訊獲取過程中的錯誤，實現智能重試
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRetryableError = isRetryableError;
+exports.calculateRetryDelay = calculateRetryDelay;
+exports.fetchWithRetry = fetchWithRetry;
+exports.handleDouyinApiError = handleDouyinApiError;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+// No need to import withRetry here
+// 可重試的錯誤類型
+const RETRYABLE_ERROR_TYPES = [
+    'TimeoutError',
+    'NetworkError',
+    'ConnectionError',
+    'NavigationError',
+    'AbortError'
+];
+// 默認重試配置
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 15000,
+    factor: 2
+};
+/**
+ * 判斷錯誤是否可重試
+ * @param error 錯誤對象
+ * @returns boolean 是否可重試
+ */
+function isRetryableError(error) {
+    // 檢查錯誤類型
+    if (RETRYABLE_ERROR_TYPES.some(type => error.name.includes(type))) {
+        return true;
+    }
+    // 檢查錯誤消息中的關鍵詞
+    const errorMessage = error.message.toLowerCase();
+    const retryableMessages = [
+        'timeout',
+        'network',
+        'connection',
+        'temporarily unavailable',
+        'rate limit',
+        'too many requests',
+        'server error',
+        'internal error',
+        'socket hang up',
+        'econnreset',
+        'econnrefused',
+        'etimedout'
+    ];
+    if (retryableMessages.some(msg => errorMessage.includes(msg))) {
+        return true;
+    }
+    // 檢查 HTTP 狀態碼（如果存在）
+    if ('statusCode' in error && typeof error.statusCode === 'number') {
+        const statusCode = error.statusCode;
+        // 5xx 錯誤和一些 4xx 錯誤可以重試
+        return statusCode >= 500 || statusCode === 429 || statusCode === 408;
+    }
+    // 默認不重試
+    return false;
+}
+/**
+ * 計算重試延遲時間
+ * @param attempt 當前嘗試次數（從 1 開始）
+ * @param config 重試配置
+ * @returns number 延遲時間（毫秒）
+ */
+function calculateRetryDelay(attempt, config = DEFAULT_RETRY_CONFIG) {
+    // 指數退避策略: baseDelay * (factor ^ (attempt - 1))
+    let delay = config.baseDelay * Math.pow(config.factor, attempt - 1);
+    // 添加隨機抖動，避免多個請求同時重試
+    delay = delay * (0.8 + Math.random() * 0.4);
+    // 限制在最大延遲時間內
+    return Math.min(delay, config.maxDelay);
+}
+/**
+ * 帶退避策略的重試函數
+ * @param fetcher 執行的函數
+ * @param config 重試配置
+ * @returns Promise<T> 函數執行結果
+ */
+async function fetchWithRetry(fetcher, config = {}) {
+    const retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+    let attempt = 0;
+    let lastError = null;
+    while (attempt <= retryConfig.maxRetries) {
+        try {
+            // 嘗試執行操作
+            return await fetcher();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            lastError = err;
+            attempt++;
+            // 如果已達到最大重試次數或錯誤不可重試，則拋出錯誤
+            if (attempt > retryConfig.maxRetries || !isRetryableError(err)) {
+                if (attempt > retryConfig.maxRetries) {
+                    logger_1.infoLogger.debug(`達到最大重試次數: ${err.message}`);
+                }
+                else {
+                    logger_1.infoLogger.debug(`錯誤不可重試: ${err.message}`);
+                }
+                throw err;
+            }
+            // 計算延遲時間
+            const delay = calculateRetryDelay(attempt, retryConfig);
+            logger_1.infoLogger.debug(`操作失敗，${delay}ms 後重試 (嘗試 ${attempt}/${retryConfig.maxRetries}): ${err.message}`);
+            // 等待後重試
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    // 理論上不應該執行到這裡，但為了類型安全
+    throw lastError || new Error('重試失敗');
+}
+/**
+ * 處理特定的抖音 API 錯誤
+ * @param error 錯誤對象
+ * @returns Error 包含有用診斷信息的錯誤
+ */
+function handleDouyinApiError(error) {
+    // 原始錯誤
+    const originalError = error instanceof Error ? error : new Error(String(error));
+    // 嘗試解析抖音特定錯誤
+    try {
+        // 檢查是否包含 JSON 響應
+        if (error.response && typeof error.response.json === 'function') {
+            const responseData = error.response.json();
+            if (responseData && responseData.statusCode) {
+                // 處理特定的抖音 API 錯誤碼
+                switch (responseData.statusCode) {
+                    case 8:
+                        return new Error('抖音 API 請求頻率超過限制，請稍後再試');
+                    case 2101:
+                        return new Error('抖音 Cookie 已失效，請重新登入');
+                    case 2154:
+                        return new Error('該影片需要登入後才能查看');
+                    case 2190:
+                        return new Error('該影片不存在或已被刪除');
+                    default:
+                        return new Error(`抖音 API 錯誤: ${responseData.statusCode} - ${responseData.statusMsg || '未知錯誤'}`);
+                }
+            }
+        }
+    }
+    catch (parseError) {
+        // 解析錯誤，返回原始錯誤
+        logger_1.infoLogger.debug('解析抖音 API 錯誤失敗:', parseError);
+    }
+    // 預處理常見的抖音錯誤信息
+    const errorMessage = originalError.message.toLowerCase();
+    if (errorMessage.includes('cookie') && (errorMessage.includes('invalid') || errorMessage.includes('expired'))) {
+        return new Error('抖音 Cookie 已失效，請重新登入');
+    }
+    if (errorMessage.includes('captcha') || errorMessage.includes('人機驗證')) {
+        return new Error('遇到抖音人機驗證，請稍後再試或更新 Cookie');
+    }
+    if (errorMessage.includes('rate limit') || errorMessage.includes('too many requests')) {
+        return new Error('請求頻率過高，已被抖音限制，請稍後再試');
+    }
+    if (errorMessage.includes('not found') || errorMessage.includes('404')) {
+        return new Error('影片不存在或已被刪除');
+    }
+    // 返回原始錯誤
+    return originalError;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/src/douyin/info/error-handler.js.map

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

package/dist/src/douyin/info/fetch-video-detail.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 影片詳情提取核心功能
+ * 從抖音影片頁面獲取詳細資訊 (基於 reference/DouyinParser.ts 邏輯)
+ */
+import { Page } from 'puppeteer';
+import { VideoInfo } from '../../types';
+/**
+ * 從抖音影片頁面獲取詳細資訊
+ * @param videoUrl 標準的抖音影片 URL
+ * @param cookie 抖音 Cookie 字串
+ * @returns Promise<VideoInfo | null> 影片資訊或 null
+ */
+export declare function fetchVideoDetail(page: Page, // Changed: Accept Page object
+videoUrl: string): Promise<VideoInfo | null>;