douyin-downloader 0.1.0

package/dist/src/douyin/download/video-downloader.js

@@ -0,0 +1,223 @@
+"use strict";
+// Copied from src/download/video-downloader.ts
+// Original file path: src/download/video-downloader.ts
+/**
+ * 影片下載核心功能
+ * 實現單個影片的下載邏輯
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadVideo = downloadVideo;
+exports.getVideoSize = getVideoSize;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const file_1 = require("../../utils/file"); // Updated path to shared utils
+const path_formatter_1 = require("./path-formatter"); // Keep formatOutputPath, remove ensureDirectoryExists
+const error_handler_1 = require("./error-handler"); // Keep local error types for now
+const retry_1 = require("../../utils/retry"); // Import withRetry from shared utils
+/**
+ * 下載單個抖音影片
+ * @param videoInfo 影片資訊
+ * @param destPath 目標路徑（檔案或目錄）
+ * @param options 下載選項
+ * @returns Promise<string> 下載完成的檔案路徑
+ */
+async function downloadVideo(videoInfo, // Use common VideoInfo
+destPath, options = {}, downloadUrls // 下載URL列表參數，可以是單個URL或URL列表
+) {
+    const { retries = 3, timeout = 60000, headers = {}, onProgress, // Keep for backward compatibility? Or remove? Let's keep for now but prioritize onFileProgress
+    onFileProgress, // Add the new option
+    checkExisting = true, overwrite = false, useSubfolders = true, filenameTemplate = "{date}-{title}" } = options;
+    let finalPath = ''; // Declare finalPath outside the try block
+    try {
+        // 檢查視頻播放 URL 是否存在
+        if (!videoInfo.videoPlayUrl) {
+            throw new error_handler_1.DownloadError(`影片 ${videoInfo.id} 無有效的播放 URL`, videoInfo.id, 'INVALID_URL', false);
+        }
+        // --- 確定最終的檔案路徑 ---
+        // finalPath is already declared above
+        const destPathStats = await fs_extra_1.default.stat(destPath).catch(() => null);
+        if (destPathStats && destPathStats.isDirectory()) {
+            // destPath 是現有目錄，使用 formatOutputPath
+            logger_1.downloadLogger.debug(`destPath (${destPath}) 是現有目錄。使用 formatOutputPath。`);
+            finalPath = (0, path_formatter_1.formatOutputPath)(videoInfo, destPath, { useSubfolders, filenameTemplate });
+        }
+        else if (!destPathStats && (destPath.endsWith(path_1.default.sep) || destPath.endsWith('/'))) {
+            // destPath 不存在但以分隔符結尾，視為目錄
+            logger_1.downloadLogger.debug(`destPath (${destPath}) 不存在但以分隔符結尾。視為目錄並使用 formatOutputPath。`);
+            finalPath = (0, path_formatter_1.formatOutputPath)(videoInfo, destPath, { useSubfolders, filenameTemplate });
+        }
+        else if (destPathStats && destPathStats.isFile()) {
+            // destPath 是現有檔案 (可能來自 -f 或先前下載)
+            logger_1.downloadLogger.debug(`destPath (${destPath}) 是現有檔案。直接使用。`);
+            finalPath = destPath; // 直接使用路徑
+        }
+        else if (!destPathStats) {
+            // destPath 不存在，檢查父目錄
+            const parentDir = path_1.default.dirname(destPath);
+            // 檢查父目錄是否為空或根目錄，避免對根目錄調用 fs.stat
+            let parentDirExists = false;
+            if (parentDir && parentDir !== destPath) { // 確保 parentDir 不是自身 (例如 "/")
+                try {
+                    const parentDirStats = await fs_extra_1.default.stat(parentDir);
+                    parentDirExists = parentDirStats.isDirectory();
+                }
+                catch {
+                    parentDirExists = false;
+                }
+            }
+            else if (parentDir === path_1.default.dirname(parentDir)) { // 檢查是否為根目錄 (e.g., '/' or 'C:\')
+                parentDirExists = true; // 根目錄總是存在
+            }
+            if (parentDirExists) {
+                // 父目錄存在，假定 destPath 是檔案路徑 (來自 -f)
+                logger_1.downloadLogger.debug(`destPath (${destPath}) 不存在，但父目錄存在。假定為檔案路徑並直接使用。`);
+                finalPath = destPath; // 直接使用路徑
+            }
+            else {
+                // 父目錄不存在，假定 destPath 是目錄路徑 (來自 -d 指定新目錄)
+                logger_1.downloadLogger.debug(`destPath (${destPath}) 及其父目錄不存在。視為目錄並使用 formatOutputPath。`);
+                finalPath = (0, path_formatter_1.formatOutputPath)(videoInfo, destPath, { useSubfolders, filenameTemplate });
+            }
+        }
+        else {
+            // 不應發生，但預設為目錄行為
+            logger_1.downloadLogger.warn(`無法確定 destPath (${destPath}) 的類型。預設為目錄行為。`);
+            finalPath = (0, path_formatter_1.formatOutputPath)(videoInfo, destPath, { useSubfolders, filenameTemplate });
+        }
+        // ---
+        // 確保最終 finalPath 的父目錄存在
+        await (0, file_1.ensureDirectoryExists)(path_1.default.dirname(finalPath));
+        // 檢查檔案是否已存在
+        if (checkExisting) {
+            const fileExists = await fs_extra_1.default.pathExists(finalPath);
+            if (fileExists && !overwrite) {
+                logger_1.downloadLogger.info(`檔案已存在且不覆蓋: ${finalPath}`);
+                return finalPath;
+            }
+            else if (fileExists) {
+                logger_1.downloadLogger.warn(`檔案已存在，將被覆蓋: ${finalPath}`);
+            }
+        }
+        // 下載影片
+        logger_1.downloadLogger.info(`開始下載影片: ${videoInfo.title || videoInfo.id}`);
+        logger_1.downloadLogger.debug(`下載 URL: ${videoInfo.videoPlayUrl}`);
+        logger_1.downloadLogger.debug(`保存路徑: ${finalPath}`);
+        // 設置請求頭
+        const downloadHeaders = {
+            'Referer': `https://www.douyin.com/video/${videoInfo.id}`,
+            ...headers
+        };
+        // 使用重試機制下載
+        // Use the imported withRetry from shared utils
+        await (0, retry_1.withRetry)(
+        // Add type for progressCallback (assuming it's (progress: number) => void based on usage)
+        // The function passed to withRetry doesn't receive progressCallback directly.
+        // Progress should be handled via the options passed to downloadFile.
+        async () => {
+            await (0, file_1.downloadFile)(videoInfo.videoPlayUrl, finalPath, {
+                headers: downloadHeaders,
+                timeout,
+                // Pass the correct callback (onFileProgress or onProgress) to downloadFile's onProgress
+                onProgress: (downloaded, total) => {
+                    const progress = (total && total > 0) ? Math.round((downloaded / total) * 100) : 0;
+                    const fileProgressCallback = onFileProgress || onProgress; // Prioritize onFileProgress
+                    if (fileProgressCallback) {
+                        fileProgressCallback(progress);
+                    }
+                }
+            });
+            return true;
+        }, 
+        // Options for withRetry
+        {
+            retries,
+            onRetry: (error, attempt) => {
+                logger_1.downloadLogger.warn(`下載影片 ${videoInfo.id} 失敗，重試 #${attempt}/${retries}:`, error.message);
+            },
+            // Example: Only retry on specific errors if needed
+            shouldRetry: (error) => {
+                if (error instanceof error_handler_1.DownloadError) {
+                    return error.isRetryable();
+                }
+                // Optionally retry other generic errors based on message, etc.
+                return true; // Default: retry most errors
+            }
+        });
+        logger_1.downloadLogger.info(`影片下載完成: ${finalPath}`);
+        return finalPath;
+    }
+    catch (error) {
+        const errorMessage = (0, error_handler_1.getDownloadErrorMessage)(error, videoInfo.videoPlayUrl || videoInfo.id);
+        logger_1.downloadLogger.error(`下載影片 ${videoInfo.id} 失敗:`, new Error(errorMessage));
+        // 如果檔案已經部分寫入，則刪除它
+        // 使用上面已確定的 finalPath 變數
+        try {
+            // const finalPath = formatOutputPath(videoInfo, destPath, { // 不再需要重新計算
+            //   useSubfolders,
+            //   filenameTemplate
+            // });
+            if (await fs_extra_1.default.pathExists(finalPath)) {
+                await fs_extra_1.default.unlink(finalPath);
+                logger_1.downloadLogger.debug(`刪除不完整的下載檔案: ${finalPath}`);
+            }
+        }
+        catch (unlinkError) {
+            logger_1.downloadLogger.warn(`刪除不完整的檔案失敗:`, unlinkError);
+        }
+        // 嘗試使用下載URL列表
+        if (downloadUrls && downloadUrls.length > 0) {
+            // 使用第一個下載URL，並將剩餘的URL傳遞給遞迴調用
+            const nextUrl = downloadUrls[0];
+            const remainingUrls = downloadUrls.slice(1);
+            logger_1.downloadLogger.info(`嘗試使用其他下載URL下載影片 ${videoInfo.id}，剩餘 ${downloadUrls.length} 個下載URL`);
+            // 創建一個新的videoInfo對象，使用下一個下載URL
+            const newVideoInfo = { ...videoInfo, videoPlayUrl: nextUrl };
+            // 遞迴調用自身，嘗試使用其他下載URL
+            return await downloadVideo(newVideoInfo, destPath, options, remainingUrls);
+        }
+        throw new error_handler_1.DownloadError(errorMessage, videoInfo.id, 'DOWNLOAD_FAILED', false);
+    }
+}
+/**
+ * 獲取影片的下載大小
+ * @param url 影片 URL
+ * @param headers 請求頭
+ * @returns Promise<number> 檔案大小（位元組）
+ */
+async function getVideoSize(url, headers = {}) {
+    try {
+        // 發送 HEAD 請求獲取檔案大小
+        const response = await fetch(url, {
+            method: 'HEAD',
+            headers
+        });
+        if (!response.ok) {
+            throw new error_handler_1.DownloadError(`獲取影片大小失敗: ${response.status} ${response.statusText}`, url, 'HEAD_REQUEST_FAILED', true);
+        }
+        // 讀取 Content-Length 頭
+        const contentLength = response.headers.get('content-length');
+        if (!contentLength) {
+            logger_1.downloadLogger.warn(`無法獲取影片大小，伺服器未返回 Content-Length 頭: ${url}`);
+            return 0;
+        }
+        // 轉換為數字
+        const size = parseInt(contentLength, 10);
+        if (isNaN(size)) {
+            logger_1.downloadLogger.warn(`無法解析影片大小: ${contentLength}, ${url}`);
+            return 0;
+        }
+        return size;
+    }
+    catch (error) {
+        if (error instanceof error_handler_1.DownloadError) {
+            throw error;
+        }
+        logger_1.downloadLogger.error(`獲取影片大小失敗: ${url}`, error instanceof Error ? error : new Error(String(error)));
+        throw new error_handler_1.DownloadError(`獲取影片大小失敗: ${error.message}`, url, 'GET_SIZE_FAILED', true);
+    }
+}
+//# sourceMappingURL=video-downloader.js.map

package/dist/src/douyin/download/video-downloader.js.map

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

package/dist/src/douyin/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 抖音影片解析與下載套件
+ * 提供對抖音平台視頻的解析和下載功能
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * 免責聲明：本套件僅供學習和個人使用。請遵守抖音平台的服務條款和相關法規。
+ * 用戶須對使用本套件的行為負責，開發者不對任何濫用行為或因此產生的後果負責。
+ * 請尊重原創作者的著作權，不要未經授權分發下載的內容。
+ *
+ * 參考來源：此模組改寫自原本存放於 src/ 下的抖音相關功能
+ * 但架構已重新組織並與 TikTok 功能相互平行
+ * 需要驗證：整體 API 設計是否符合用戶需求和最佳實踐
+ */
+export { login, isValidCookie, loadAndValidateCookie, getDefaultCookiePath, saveCookie, loadCookie, getAppDataDir } from './auth';
+export { extractDouyinLinks, containsDouyinLink, parseDouyinLinks, resolveShortUrl } from './parser';
+export { fetchVideosInfoText, fetchVideosInfoUrls, fetchVideoDetail, extractSecUserId, fetchUserVideos } from './info';
+export { downloadVideo, downloadVideos, downloadVideosFromText } from './download';

package/dist/src/douyin/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * 抖音影片解析與下載套件
+ * 提供對抖音平台視頻的解析和下載功能
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * 免責聲明：本套件僅供學習和個人使用。請遵守抖音平台的服務條款和相關法規。
+ * 用戶須對使用本套件的行為負責，開發者不對任何濫用行為或因此產生的後果負責。
+ * 請尊重原創作者的著作權，不要未經授權分發下載的內容。
+ *
+ * 參考來源：此模組改寫自原本存放於 src/ 下的抖音相關功能
+ * 但架構已重新組織並與 TikTok 功能相互平行
+ * 需要驗證：整體 API 設計是否符合用戶需求和最佳實踐
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadVideosFromText = exports.downloadVideos = exports.downloadVideo = exports.fetchUserVideos = exports.extractSecUserId = exports.fetchVideoDetail = exports.fetchVideosInfoUrls = exports.fetchVideosInfoText = exports.resolveShortUrl = exports.parseDouyinLinks = exports.containsDouyinLink = exports.extractDouyinLinks = exports.getAppDataDir = exports.loadCookie = exports.saveCookie = exports.getDefaultCookiePath = exports.loadAndValidateCookie = exports.isValidCookie = exports.login = void 0;
+// ================= 認證與登入模組 (implements AuthService implicitly) =================
+// 導出 auth 子模組中的所有功能
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "login", { enumerable: true, get: function () { return auth_1.login; } });
+Object.defineProperty(exports, "isValidCookie", { enumerable: true, get: function () { return auth_1.isValidCookie; } });
+Object.defineProperty(exports, "loadAndValidateCookie", { enumerable: true, get: function () { return auth_1.loadAndValidateCookie; } });
+Object.defineProperty(exports, "getDefaultCookiePath", { enumerable: true, get: function () { return auth_1.getDefaultCookiePath; } });
+Object.defineProperty(exports, "saveCookie", { enumerable: true, get: function () { return auth_1.saveCookie; } });
+Object.defineProperty(exports, "loadCookie", { enumerable: true, get: function () { return auth_1.loadCookie; } });
+Object.defineProperty(exports, "getAppDataDir", { enumerable: true, get: function () { return auth_1.getAppDataDir; } }); // Moved from utils
+// ================= 解析模組 (implements ParserService implicitly) =================
+// 導出 parser 子模組中的所有功能
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "extractDouyinLinks", { enumerable: true, get: function () { return parser_1.extractDouyinLinks; } });
+Object.defineProperty(exports, "containsDouyinLink", { enumerable: true, get: function () { return parser_1.containsDouyinLink; } });
+Object.defineProperty(exports, "parseDouyinLinks", { enumerable: true, get: function () { return parser_1.parseDouyinLinks; } });
+Object.defineProperty(exports, "resolveShortUrl", { enumerable: true, get: function () { return parser_1.resolveShortUrl; } });
+// ================= 影片資訊模組 (implements InfoService implicitly) =================
+// 導出 info 子模組中的所有功能
+var info_1 = require("./info");
+Object.defineProperty(exports, "fetchVideosInfoText", { enumerable: true, get: function () { return info_1.fetchVideosInfoText; } });
+Object.defineProperty(exports, "fetchVideosInfoUrls", { enumerable: true, get: function () { return info_1.fetchVideosInfoUrls; } });
+Object.defineProperty(exports, "fetchVideoDetail", { enumerable: true, get: function () { return info_1.fetchVideoDetail; } });
+Object.defineProperty(exports, "extractSecUserId", { enumerable: true, get: function () { return info_1.extractSecUserId; } });
+Object.defineProperty(exports, "fetchUserVideos", { enumerable: true, get: function () { return info_1.fetchUserVideos; } });
+// ================= 下載模組 (implements DownloadService implicitly) =================
+// 導出 download 子模組中的所有功能
+var download_1 = require("./download");
+Object.defineProperty(exports, "downloadVideo", { enumerable: true, get: function () { return download_1.downloadVideo; } });
+Object.defineProperty(exports, "downloadVideos", { enumerable: true, get: function () { return download_1.downloadVideos; } });
+Object.defineProperty(exports, "downloadVideosFromText", { enumerable: true, get: function () { return download_1.downloadVideosFromText; } });
+// ================= 工具函數 (Moved to src/utils) =================
+// Removed export block for './utils'
+//# sourceMappingURL=index.js.map

package/dist/src/douyin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/douyin/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,kFAAkF;AAClF,oBAAoB;AACpB,+BAQgB;AAPd,6FAAA,KAAK,OAAA;AACL,qGAAA,aAAa,OAAA;AACb,6GAAA,qBAAqB,OAAA;AACrB,4GAAA,oBAAoB,OAAA;AACpB,kGAAA,UAAU,OAAA;AACV,kGAAA,UAAU,OAAA;AACV,qGAAA,aAAa,OAAA,CAAC,mBAAmB;AAGnC,iFAAiF;AACjF,sBAAsB;AACtB,mCAKkB;AAJhB,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA;AAGjB,iFAAiF;AACjF,oBAAoB;AACpB,+BAMgB;AALd,2GAAA,mBAAmB,OAAA;AACnB,2GAAA,mBAAmB,OAAA;AACnB,wGAAA,gBAAgB,OAAA;AAChB,wGAAA,gBAAgB,OAAA;AAChB,uGAAA,eAAe,OAAA;AAGjB,mFAAmF;AACnF,wBAAwB;AACxB,uCAIoB;AAHlB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,kHAAA,sBAAsB,OAAA;AAGxB,gEAAgE;AAChE,qCAAqC"}

package/dist/src/douyin/info/batch-processor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 批量處理功能
+ * 處理多個影片URL的順序獲取（一個接一個）
+ */
+import { VideoInfo, FetchVideoOptions } from '../../types';
+import { Page } from 'puppeteer';
+/**
+ * 批量處理多個影片 URL 的資訊獲取（順序處理，非並行）
+ * @param videoUrls 影片 URL 陣列
+ * @param cookie 抖音 Cookie 字串
+ * @param options 獲取選項
+ * @returns Promise<VideoInfoResult[]> 影片資訊結果陣列
+ */
+export declare function processBatch(videoUrls: string[], page: Page, // Changed: Accept Page object
+options?: FetchVideoOptions): Promise<VideoInfo[]>;

package/dist/src/douyin/info/batch-processor.js

@@ -0,0 +1,65 @@
+"use strict";
+// Copied from src/info/batch-processor.ts
+// Original file path: src/info/batch-processor.ts
+/**
+ * 批量處理功能
+ * 處理多個影片URL的順序獲取（一個接一個）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processBatch = processBatch;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const retry_1 = require("../../utils/retry"); // Updated path to shared utils
+const fetch_video_detail_1 = require("./fetch-video-detail");
+/**
+ * 批量處理多個影片 URL 的資訊獲取（順序處理，非並行）
+ * @param videoUrls 影片 URL 陣列
+ * @param cookie 抖音 Cookie 字串
+ * @param options 獲取選項
+ * @returns Promise<VideoInfoResult[]> 影片資訊結果陣列
+ */
+async function processBatch(videoUrls, page, // Changed: Accept Page object
+// cookie: string, // Removed
+options = {}) {
+    const { onProgress } = options;
+    if (!videoUrls || videoUrls.length === 0) {
+        logger_1.infoLogger.warn('沒有提供要處理的影片 URL');
+        return [];
+    }
+    // Removed: Cookie check, assuming page is valid
+    logger_1.infoLogger.info(`[processBatch] 開始順序處理 ${videoUrls.length} 個影片 URL（一個接一個）`);
+    const results = []; // Use common VideoInfo
+    // 順序處理每個 URL（一個接一個）
+    for (let index = 0; index < videoUrls.length; index++) {
+        const url = videoUrls[index];
+        logger_1.infoLogger.debug(`[processBatch] 處理第 ${index + 1}/${videoUrls.length} 個影片 URL: ${url}`);
+        try {
+            // 使用 withRetry 為每個任務添加重試機制
+            const result = await (0, retry_1.withRetry)(async () => {
+                // Pass page instead of cookie to fetchVideoDetail
+                return await (0, fetch_video_detail_1.fetchVideoDetail)(page, url);
+            }, { retries: 2 });
+            // 在此記錄每個單獨的結果，方便調試
+            if (result) {
+                logger_1.infoLogger.debug(`[processBatch] 成功獲取影片資訊: ${result.title}`);
+            }
+            else {
+                logger_1.infoLogger.debug(`[processBatch] 無法獲取影片資訊: ${url}`);
+            }
+            results.push(result);
+        }
+        catch (error) {
+            logger_1.infoLogger.error(`[processBatch] 處理影片 URL 失敗: ${url}`, error instanceof Error ? error : new Error(String(error)));
+            results.push(null);
+        }
+        // 更新進度
+        if (onProgress) {
+            logger_1.infoLogger.debug(`[processBatch] 批量處理進度: ${index + 1}/${videoUrls.length}`);
+            onProgress(index + 1, videoUrls.length);
+        }
+    }
+    // 過濾掉 null 結果
+    const validResults = results.filter((result) => result !== null); // Use type predicate for filtering
+    logger_1.infoLogger.info(`[processBatch] 批量處理完成，成功獲取 ${validResults.length}/${videoUrls.length} 個影片的資訊`);
+    return validResults;
+}
+//# sourceMappingURL=batch-processor.js.map

package/dist/src/douyin/info/batch-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-processor.js","sourceRoot":"","sources":["../../../../src/douyin/info/batch-processor.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,kDAAkD;AAClD;;;GAGG;;AAeH,oCAyDC;AAtED,+CAA0D,CAAC,sCAAsC;AACjG,6CAA8C,CAAC,+BAA+B;AAC9E,6DAAwD;AAIxD;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,SAAmB,EACnB,IAAU,EAAE,8BAA8B;AAC1C,6BAA6B;AAC7B,UAA6B,EAAE;IAE/B,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE/B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,mBAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gDAAgD;IAEhD,mBAAM,CAAC,IAAI,CAAC,yBAAyB,SAAS,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAExE,MAAM,OAAO,GAAyB,EAAE,CAAC,CAAC,uBAAuB;IAEjE,oBAAoB;IACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,mBAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAS,EAAC,KAAK,IAAI,EAAE;gBACxC,kDAAkD;gBAClD,OAAO,MAAM,IAAA,qCAAgB,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAEnB,mBAAmB;YACnB,IAAI,MAAM,EAAE,CAAC;gBACX,mBAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,mBAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mBAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9G,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO;QACP,IAAI,UAAU,EAAE,CAAC;YACf,mBAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAuB,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,mCAAmC;IAE1H,mBAAM,CAAC,IAAI,CAAC,8BAA8B,YAAY,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC;IAE5F,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/src/douyin/info/browser-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 瀏覽器管理模組
+ * 使用 Puppeteer 提供瀏覽器實例管理
+ */
+import { Browser, Page } from 'puppeteer';
+interface BrowserManagerOptions {
+    headless?: boolean;
+    timeout?: number;
+    userAgent?: string;
+}
+/**
+ * 瀏覽器管理器
+ * 使用單例模式管理 Puppeteer 瀏覽器實例
+ */
+export declare class BrowserManager {
+    private static instance;
+    private browser;
+    private browserInitPromise;
+    private options;
+    /**
+     * 獲取 BrowserManager 單例
+     * @param options 瀏覽器選項
+     * @returns BrowserManager 實例
+     */
+    static getInstance(options?: BrowserManagerOptions): BrowserManager;
+    /**
+     * 私有構造函數，防止直接創建實例
+     * @param options 瀏覽器選項
+     */
+    private constructor();
+    /**
+     * 獲取瀏覽器實例
+     * 如果實例不存在，則創建新實例
+     * @returns Promise<Browser>
+     */
+    getBrowser(): Promise<Browser>;
+    /**
+     * 創建新的頁面
+     * @param cookies 可選的 Cookie 字符串
+     * @returns Promise<Page>
+     */
+    newPage(cookies?: string): Promise<Page>;
+    /**
+     * 設置頁面的 Cookie
+     * @param page Puppeteer 頁面實例
+     * @param cookieString Cookie 字符串
+     */
+    setCookies(page: Page, cookieString: string): Promise<void>;
+    /**
+     * 關閉瀏覽器實例
+     */
+    close(): Promise<void>;
+}
+export declare const browserManager: BrowserManager;
+export declare function cleanupBrowser(): Promise<void>;
+export {};