douyin-downloader 0.1.0

package/dist/src/douyin/auth/login.js

@@ -0,0 +1,157 @@
+"use strict";
+// Copied from src/auth/login.ts
+// Original file path: src/auth/login.ts
+/**
+ * 瀏覽器自動化登入
+ * 提供抖音自動化登入功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = login;
+// import { browserManager, LoginBrowserResult } from '../../utils/browser'; // Removed old import
+const cookie_storage_1 = require("./cookie-storage");
+const cookie_path_1 = require("./cookie-path");
+const errors_1 = require("./errors");
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const manager_1 = require("../../douyin/browser/manager"); // Import new login browser function and options type
+// 抖音登入 URL
+const LOGIN_URL = 'https://www.douyin.com/';
+// 登入成功所需的所有必要 Cookie 名稱
+const LOGIN_SUCCESS_COOKIE_NAMES = ['login_time', 'IsDouyinActive', 'passport_assist_user']; //['ttwid', 'sessionid', 'uid_tt', 'sid_tt'];
+/**
+ * 登入抖音並獲取 Cookie
+ * 打開瀏覽器進行登入操作，獲取有效的 cookie 字串。
+ * @param savePath 可選的 Cookie 儲存路徑
+ * @param options 登入選項
+ * @returns Promise<string | LoginResult> 如果 autoCleanup 為 true，則只返回 cookie 字串；否則返回包含 cookie 和 cleanup 函數的對象
+ * @throws {LoginError} 如果登入過程中出現錯誤
+ */
+async function login(savePath, options = {}) {
+    let browserResult = null;
+    let page = null; // Keep page variable for consistency
+    try {
+        logger_1.authLogger.info('開始登入抖音...');
+        // Map LoginOptions to LaunchOptions for launchLoginBrowser
+        const launchOpts = {
+            timeout: options.timeout,
+            userAgent: options.userAgent,
+            executablePath: options.executablePath, // Pass through if provided
+            userDataDir: options.userDataDir, // Pass through if provided
+            headless: false // Explicitly set headless to false for login
+        };
+        // Use the new launchLoginBrowser function
+        browserResult = await (0, manager_1.launchLoginBrowser)(launchOpts);
+        page = browserResult.page; // Assign page from the result
+        // 監聽控制台消息
+        page?.on('console', (msg) => logger_1.authLogger.debug('瀏覽器控制台:', msg.text()));
+        // 導航到登入頁面
+        logger_1.authLogger.info(`導航至 ${LOGIN_URL}...`);
+        if (!page)
+            throw new Error('無法獲取瀏覽器頁面');
+        // --- 在導航前設定初始 Cookie ---
+        if (options.initialCookie) {
+            logger_1.authLogger.info('正在設定初始 Cookie...');
+            try {
+                const cookiesToSet = options.initialCookie.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
+                        if (!name || value === undefined)
+                            return null;
+                        // Match reference/DouyinParser.ts: Use hardcoded domain
+                        const domain = '.douyin.com';
+                        return { name, value, domain };
+                    }
+                    return null;
+                }).filter(cookie => cookie !== null); // Simple filter
+                if (cookiesToSet.length > 0) {
+                    // Use 'as any[]' like reference
+                    await page.setCookie(...cookiesToSet);
+                    logger_1.authLogger.info(`成功設定 ${cookiesToSet.length} 個初始 Cookie`);
+                }
+                else {
+                    logger_1.authLogger.warn('提供的 initialCookie 字串解析後為空或無效');
+                }
+            }
+            catch (e) {
+                const cookieErr = e instanceof Error ? e : new Error(String(e));
+                logger_1.authLogger.error('設定初始 Cookie 時出錯:', cookieErr);
+            }
+        }
+        // --- 結束設定初始 Cookie ---
+        await page.goto(LOGIN_URL, { waitUntil: 'networkidle2', timeout: options.timeout || 60000 });
+        logger_1.authLogger.info('請在瀏覽器中完成登入...');
+        logger_1.authLogger.info(`等待登入完成，檢測到所有必要的 Cookie (${LOGIN_SUCCESS_COOKIE_NAMES.join(', ')}) 都存在後將自動獲取 Cookie`);
+        // 等待登入成功的標誌
+        if (!page)
+            throw new Error('無法獲取瀏覽器頁面');
+        await page.waitForFunction((cookieNames) => {
+            const cookieObj = {};
+            document.cookie.split(';').forEach(cookie => {
+                const parts = cookie.trim().split('=');
+                if (parts.length >= 2) {
+                    const name = parts[0];
+                    const value = parts.slice(1).join('=');
+                    cookieObj[name] = decodeURIComponent(value);
+                }
+            });
+            // console.log('cookieObj', cookieObj); // Keep for debugging if needed
+            return cookieNames.every(name => cookieObj[name] !== undefined &&
+                cookieObj[name].trim() !== '');
+        }, { polling: 1000, timeout: options.timeout || 300000 }, LOGIN_SUCCESS_COOKIE_NAMES);
+        logger_1.authLogger.info('登入成功，正在獲取 Cookie...');
+        await new Promise(resolve => setTimeout(resolve, 2000));
+        // 獲取當前頁面的 Cookie
+        if (!page)
+            throw new Error('無法獲取瀏覽器頁面');
+        const cookies = await page.cookies();
+        // 格式化 Cookie 字串
+        const cookieString = cookies
+            .map(cookie => `${cookie.name}=${encodeURIComponent(cookie.value)}`)
+            .join('; ');
+        // 檢查所有必要的 Cookie 是否存在
+        const missingCookies = LOGIN_SUCCESS_COOKIE_NAMES.filter(name => !cookies.some(cookie => cookie.name === name));
+        if (missingCookies.length > 0) {
+            logger_1.authLogger.warn(`有些必要的 Cookie 缺失: ${missingCookies.join(', ')}`);
+        }
+        logger_1.authLogger.info(`成功獲取 Cookie，共 ${cookies.length} 個`);
+        // 儲存 Cookie
+        const finalSavePath = savePath || (0, cookie_path_1.getDefaultCookiePath)();
+        if (finalSavePath) { // Ensure savePath is valid before saving
+            await (0, cookie_storage_1.saveCookie)(cookieString, finalSavePath);
+            logger_1.authLogger.info(`Cookie 已儲存至 ${finalSavePath}`);
+        }
+        // Ensure browserResult is not null before accessing its properties
+        if (!browserResult) {
+            throw new Error("Browser result is unexpectedly null after successful login flow.");
+        }
+        // If autoCleanup is true (default), cleanup and return only the cookie string
+        if (options.autoCleanup !== false) {
+            logger_1.authLogger.debug('自動清理瀏覽器資源');
+            await browserResult.cleanup();
+            return cookieString;
+        }
+        // Return the structure matching LoginResult if autoCleanup is false
+        return { cookie: cookieString, cleanup: browserResult.cleanup };
+    }
+    catch (error) {
+        // 處理錯誤
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorObject = error instanceof Error ? error : new Error(String(error));
+        logger_1.authLogger.error('登入失敗:', errorObject);
+        // 嘗試清理資源
+        if (browserResult) {
+            try {
+                await browserResult.cleanup();
+            }
+            catch (cleanupError) {
+                const cleanupErr = cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError));
+                logger_1.authLogger.error('清理登入瀏覽器資源失敗:', cleanupErr);
+            }
+        }
+        // 創建一個新的 LoginError
+        const err = new errors_1.LoginError(`登入失敗: ${errorMessage}`);
+        throw err;
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/src/douyin/auth/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../../src/douyin/auth/login.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,wCAAwC;AACxC;;;GAGG;;AA8CH,sBA0JC;AArMD,kGAAkG;AAClG,qDAA8C;AAC9C,+CAAqD;AACrD,qCAAsC;AACtC,+CAA0D,CAAC,sCAAsC;AACjG,0DAAiF,CAAC,qDAAqD;AAEvI,WAAW;AACX,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,wBAAwB;AACxB,MAAM,0BAA0B,GAAG,CAAC,YAAY,EAAC,gBAAgB,EAAC,sBAAsB,CAAC,CAAC,CAAA,6CAA6C;AAyBvI;;;;;;;GAOG;AACI,KAAK,UAAU,KAAK,CAAC,QAAiB,EAAE,UAAwB,EAAE;IAGvE,IAAI,aAAa,GAAoC,IAAI,CAAC;IAC1D,IAAI,IAAI,GAAgB,IAAI,CAAC,CAAC,qCAAqC;IAEnE,IAAI,CAAC;QACH,mBAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEzB,2DAA2D;QAC3D,MAAM,UAAU,GAAkB;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,2BAA2B;YACnE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAQ,2BAA2B;YACnE,QAAQ,EAAE,KAAK,CAAC,6CAA6C;SAChE,CAAC;QAEF,0CAA0C;QAC1C,aAAa,GAAG,MAAM,IAAA,4BAAkB,EAAC,UAAU,CAAC,CAAC;QAErD,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,8BAA8B;QAEzD,UAAU;QACV,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,mBAAM,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAEvE,UAAU;QACV,mBAAM,CAAC,IAAI,CAAC,OAAO,SAAS,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAExC,0BAA0B;QAC1B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,mBAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;oBAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACrC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;wBACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;wBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,sBAAsB;wBACpE,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,SAAS;4BAAE,OAAO,IAAI,CAAC;wBAC/C,wDAAwD;wBACxD,MAAM,MAAM,GAAG,aAAa,CAAC;wBAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;oBACjC,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB;gBAEtD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,gCAAgC;oBAClC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,CAAC;oBACtC,mBAAM,CAAC,IAAI,CAAC,QAAQ,YAAY,CAAC,MAAM,aAAa,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,mBAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,SAAS,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChE,mBAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,wBAAwB;QAExB,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;QAE7F,mBAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,mBAAM,CAAC,IAAI,CAAC,2BAA2B,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAElG,YAAY;QACZ,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,eAAe,CACxB,CAAC,WAAW,EAAE,EAAE;YACd,MAAM,SAAS,GAA2B,EAAE,CAAC;YAC7C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACvC,SAAS,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC,CAAC,CAAC;YACH,uEAAuE;YACvE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAC9B,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS;gBAC7B,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAC9B,CAAC;QACJ,CAAC,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,EAAE,EACrD,0BAA0B,CAC3B,CAAC;QAEF,mBAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAExD,iBAAiB;QACjB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAErC,gBAAgB;QAChB,MAAM,YAAY,GAAG,OAAO;aACzB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;aACnE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,sBAAsB;QACtB,MAAM,cAAc,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAC9C,CAAC;QACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,mBAAM,CAAC,IAAI,CAAC,oBAAoB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,mBAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAEjD,YAAY;QACZ,MAAM,aAAa,GAAG,QAAQ,IAAI,IAAA,kCAAoB,GAAE,CAAC;QACzD,IAAI,aAAa,EAAE,CAAC,CAAC,yCAAyC;YAC1D,MAAM,IAAA,2BAAU,EAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAC9C,mBAAM,CAAC,IAAI,CAAC,eAAe,aAAa,EAAE,CAAC,CAAC;QAChD,CAAC;QAGD,mEAAmE;QACnE,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACxF,CAAC;QAED,8EAA8E;QAC9E,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YAClC,mBAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1B,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,oEAAoE;QACpE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;IAElE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;QACP,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9E,mBAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEnC,SAAS;QACT,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;gBAClG,mBAAM,CAAC,KAAK,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,GAAG,GAAG,IAAI,mBAAU,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/src/douyin/auth/saveCookie.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 抖音 Cookie 儲存模組
+ * 儲存 Cookie 到檔案
+ *
+ * @remarks
+ * 參考來源：此功能改寫自原本存放於 src/auth/cookie-storage.ts 的功能
+ * 需要驗證：文件操作是否符合不同平台標準
+ */
+/**
+ * 儲存 Cookie 到檔案
+ * @param cookie Cookie 字串
+ * @param cookiePath 可選的儲存路徑
+ *
+ * @remarks
+ * 基本的文件系統操作
+ */
+export declare function saveCookie(cookie: string, cookiePath?: string): Promise<void>;

package/dist/src/douyin/auth/saveCookie.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * 抖音 Cookie 儲存模組
+ * 儲存 Cookie 到檔案
+ *
+ * @remarks
+ * 參考來源：此功能改寫自原本存放於 src/auth/cookie-storage.ts 的功能
+ * 需要驗證：文件操作是否符合不同平台標準
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveCookie = saveCookie;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const getDefaultCookiePath_1 = require("./getDefaultCookiePath");
+/**
+ * 儲存 Cookie 到檔案
+ * @param cookie Cookie 字串
+ * @param cookiePath 可選的儲存路徑
+ *
+ * @remarks
+ * 基本的文件系統操作
+ */
+async function saveCookie(cookie, cookiePath) {
+    try {
+        // 如果未提供路徑，使用默認路徑
+        const filePath = cookiePath || (0, getDefaultCookiePath_1.getDefaultCookiePath)();
+        // 確保目錄存在
+        await ensureDirectoryExists(path.dirname(filePath));
+        // 寫入 Cookie 到檔案
+        await fs.promises.writeFile(filePath, cookie, 'utf-8');
+        console.log(`Cookie 已保存至 ${filePath}`);
+    }
+    catch (error) {
+        console.error('保存 Cookie 時發生錯誤:', error);
+        throw new Error(`保存 Cookie 失敗: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 確保目錄存在，如不存在則創建
+ * @param dirPath 目錄路徑
+ *
+ * @remarks
+ * 常見的文件操作輔助函數
+ */
+async function ensureDirectoryExists(dirPath) {
+    try {
+        // 檢查目錄是否存在
+        await fs.promises.access(dirPath);
+    }
+    catch (error) {
+        // 目錄不存在，創建目錄
+        await fs.promises.mkdir(dirPath, { recursive: true });
+        console.log(`已創建目錄: ${dirPath}`);
+    }
+}
+//# sourceMappingURL=saveCookie.js.map

package/dist/src/douyin/auth/saveCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveCookie.js","sourceRoot":"","sources":["../../../../src/douyin/auth/saveCookie.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcH,gCAgBC;AA5BD,uCAAyB;AACzB,2CAA6B;AAC7B,iEAA8D;AAE9D;;;;;;;GAOG;AACI,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,UAAmB;IAClE,IAAI,CAAC;QACH,iBAAiB;QACjB,MAAM,QAAQ,GAAG,UAAU,IAAI,IAAA,2CAAoB,GAAE,CAAC;QAEtD,SAAS;QACT,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEpD,gBAAgB;QAChB,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAAe;IAClD,IAAI,CAAC;QACH,WAAW;QACX,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa;QACb,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/src/douyin/auth/validate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cookie 驗證
+ * 提供 Cookie 有效性檢查功能
+ */
+/**
+ * 檢查提供的 cookie 字串是否仍然有效
+ * @param cookie 要驗證的 cookie 字串
+ * @returns Promise<boolean> true 表示有效，false 表示無效
+ * @throws {CookieValidationError} 如果驗證過程中出現錯誤
+ */
+export declare function isValidCookie(cookie: string): Promise<boolean>;

package/dist/src/douyin/auth/validate.js

@@ -0,0 +1,104 @@
+"use strict";
+// Copied from src/auth/validate.ts
+// Original file path: src/auth/validate.ts
+/**
+ * Cookie 驗證
+ * 提供 Cookie 有效性檢查功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidCookie = isValidCookie;
+const manager_1 = require("../browser/manager"); // Import new browser functions
+const errors_1 = require("./errors");
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+/**
+ * 檢查提供的 cookie 字串是否仍然有效
+ * @param cookie 要驗證的 cookie 字串
+ * @returns Promise<boolean> true 表示有效，false 表示無效
+ * @throws {CookieValidationError} 如果驗證過程中出現錯誤
+ */
+async function isValidCookie(cookie) {
+    if (!cookie || cookie.trim() === '') {
+        logger_1.authLogger.warn('提供的 Cookie 為空');
+        return false;
+    }
+    let browser = null;
+    let page = null;
+    try {
+        logger_1.authLogger.debug('正在驗證 Cookie 有效性...');
+        // 啟動瀏覽器
+        browser = await (0, manager_1.launchBrowser)({ headless: true }); // Or use appropriate options
+        // 創建一個頁面來測試 Cookie，禁用資源攔截
+        page = await (0, manager_1.newPage)(browser, { blockResources: false });
+        // 設定 Cookie
+        const targetUrl = 'https://www.douyin.com';
+        await (0, manager_1.setCookiesOnPage)(page, cookie, '.douyin.com');
+        // 導航到抖音首頁 (雖然 newPage 可能已經設定了 domain，但仍需導航)
+        await page.goto(targetUrl, {
+            waitUntil: 'domcontentloaded',
+            timeout: 30000
+        });
+        // 檢查是否存在登入後才會顯示的元素或檢查 Cookie
+        const isLoggedIn = await page.evaluate(() => {
+            // 檢查頁面上的登入狀態
+            // 1. 檢查 login.ts 中使用的所有關鍵 Cookie
+            const cookies = document.cookie;
+            const hasLoginTime = cookies.includes('login_time=');
+            const hasIsDouyinActive = cookies.includes('IsDouyinActive=');
+            const hasPassportAssistUser = cookies.includes('passport_assist_user=');
+            const hasRequiredCookies = hasLoginTime && hasIsDouyinActive && hasPassportAssistUser;
+            // 2. 檢查是否存在表示已登入的元素，例如用戶頭像連結或創作者中心入口
+            //    注意：這些選擇器可能需要根據實際頁面結構調整
+            // const hasAvatarLink = !!document.querySelector('span[data-e2e="live-avatar"]'); // 查找指向個人資料的連結中的圖片
+            // const hasCreatorLink = !!document.querySelector('a[href*="creator.douyin.com"]'); // 查找指向創作者中心的連結
+            const hasLoggedInIndicator = true; // !!hasAvatarLink;// || hasCreatorLink; // 或其他更可靠的選擇器
+            // 記錄檢查結果（在瀏覽器控制台）
+            console.log(`Cookie check (passport_assist_user): ${hasPassportAssistUser}`); // Corrected variable name
+            console.log(`DOM check (Avatar/Creator Link): ${hasLoggedInIndicator}`); // Keep DOM check log for info
+            // 僅依賴 DOM 檢查 (頭像連結)
+            // console.log(`DOM check (Avatar Link): ${hasAvatarLink}`); // 使用之前定義的 hasAvatarLink
+            // 暫時忽略 Cookie 檢查，因為 DOM 元素是更直接的視覺指標
+            // console.log(`Cookie check (login_time): ${hasLoginTime}`);
+            // console.log(`Cookie check (IsDouyinActive): ${hasIsDouyinActive}`);
+            // console.log(`Cookie check (passport_assist_user): ${hasPassportAssistUser}`);
+            return hasRequiredCookies;
+        });
+        logger_1.authLogger.info(`Cookie 驗證結果: ${isLoggedIn ? '有效' : '無效'}`);
+        return isLoggedIn;
+    }
+    catch (error) {
+        // 處理錯誤
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // 創建一個錯誤對象來傳遞給 logger.error
+        const errorObject = error instanceof Error ? error : new Error(String(error));
+        logger_1.authLogger.error('驗證 Cookie 時發生錯誤:', errorObject);
+        // 創建一個新的 CookieValidationError
+        const err = new errors_1.CookieValidationError(`驗證 Cookie 失敗: ${errorMessage}`);
+        throw err;
+    }
+    finally {
+        // 確保頁面被關閉
+        // 確保頁面被關閉
+        if (page) {
+            try {
+                await page.close();
+                logger_1.authLogger.debug('已關閉驗證用頁面');
+            }
+            catch (closeError) {
+                const err = closeError instanceof Error ? closeError : new Error(String(closeError));
+                logger_1.authLogger.error('關閉驗證頁面失敗:', err);
+            }
+        }
+        // 確保瀏覽器被關閉
+        if (browser) {
+            try {
+                await (0, manager_1.closeBrowser)(browser);
+                logger_1.authLogger.debug('已關閉驗證用瀏覽器');
+            }
+            catch (closeError) {
+                const err = closeError instanceof Error ? closeError : new Error(String(closeError));
+                logger_1.authLogger.error('關閉驗證瀏覽器失敗:', err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/douyin/auth/validate.js.map

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

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

@@ -0,0 +1,54 @@
+import { Browser, Page, PuppeteerLaunchOptions } from 'puppeteer';
+/**
+ * 瀏覽器啟動選項
+ */
+export interface LaunchOptions {
+    headless?: PuppeteerLaunchOptions['headless'] | 'new';
+    timeout?: number;
+    userAgent?: string;
+    executablePath?: string;
+    userDataDir?: string;
+    blockResources?: boolean;
+    args?: string[];
+}
+/**
+ * 啟動一個新的 Puppeteer 瀏覽器實例。
+ * @param options 啟動選項
+ * @returns Promise<Browser>
+ */
+export declare function launchBrowser(options?: LaunchOptions): Promise<Browser>;
+/**
+ * 在指定的瀏覽器實例中創建一個新頁面。
+ * 應用通用設定，如 User-Agent 和資源攔截。
+ * @param browser 瀏覽器實例
+ * @param options 創建頁面的選項 (可覆蓋瀏覽器啟動時的選項)
+ * @returns Promise<Page>
+ */
+export declare function newPage(browser: Browser, options?: {
+    userAgent?: string;
+    blockResources?: boolean;
+    timeout?: number;
+}): Promise<Page>;
+/**
+ * 在指定的頁面上設置 Cookie。
+ * @param page Puppeteer 頁面實例
+ * @param cookieString Cookie 字串 (例如來自 document.cookie)
+ * @param domain 可選: Cookie 的域。如果未提供，則嘗試從頁面 URL 推斷。
+ */
+export declare function setCookiesOnPage(page: Page, cookieString: string | undefined, domain?: string): Promise<void>;
+/**
+ * 安全地關閉瀏覽器實例。
+ * @param browser 要關閉的瀏覽器實例
+ */
+export declare function closeBrowser(browser: Browser | null): Promise<void>;
+/**
+ * 創建一個專用於登入的瀏覽器實例 (非無頭模式)。
+ * 返回瀏覽器、頁面和一個清理函數。
+ * @param options 登入瀏覽器的特定啟動選項
+ * @returns Promise<{ browser: Browser; page: Page; cleanup: () => Promise<void> }>
+ */
+export declare function launchLoginBrowser(options?: LaunchOptions): Promise<{
+    browser: Browser;
+    page: Page;
+    cleanup: () => Promise<void>;
+}>;