douyin-downloader 0.1.0

package/dist/src/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * 抖音影片解析與下載套件
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * 免責聲明：本套件僅供學習和個人使用。請遵守抖音平台的服務條款和相關法規。
+ * 用戶須對使用本套件的行為負責，開發者不對任何濫用行為或因此產生的後果負責。
+ * 請尊重原創作者的著作權，不要未經授權分發下載的內容。
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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.cleanupBrowser = exports.browserManager = exports.time = exports.timeAsync = exports.PerformanceMonitor = exports.LogLevel = exports.Logger = exports.douyin = exports.ErrorCode = exports.AppError = void 0;
+// 導出類型定義
+__exportStar(require("./types"), exports);
+// 導出錯誤處理
+var error_1 = require("./utils/error"); // Export the actual error class and enum
+Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return error_1.AppError; } });
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return error_1.ErrorCode; } });
+exports.douyin = __importStar(require("./douyin"));
+// ======================== 通用工具 ========================
+// 導出日誌和性能工具
+var logger_1 = require("./utils/logger"); // Corrected path
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+var performance_1 = require("./utils/performance"); // Corrected path
+Object.defineProperty(exports, "PerformanceMonitor", { enumerable: true, get: function () { return performance_1.PerformanceMonitor; } });
+Object.defineProperty(exports, "timeAsync", { enumerable: true, get: function () { return performance_1.timeAsync; } });
+Object.defineProperty(exports, "time", { enumerable: true, get: function () { return performance_1.time; } });
+// 導出瀏覽器管理工具
+var browser_1 = require("./utils/browser"); // Corrected path
+Object.defineProperty(exports, "browserManager", { enumerable: true, get: function () { return browser_1.browserManager; } });
+Object.defineProperty(exports, "cleanupBrowser", { enumerable: true, get: function () { return browser_1.cleanupBrowser; } });
+// 導出其他通用工具 (如果有的話)
+// export * from './utils/index'; // Example if utils/index.ts exports common utilities
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,SAAS;AACT,0CAAwB;AAExB,SAAS;AACT,uCAAoD,CAAC,yCAAyC;AAArF,iGAAA,QAAQ,OAAA;AAAE,kGAAA,SAAS,OAAA;AAE5B,mDAAmC;AAEnC,yDAAyD;AAEzD,YAAY;AACZ,yCAGwB,CAAC,iBAAiB;AAFxC,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AAGV,mDAI6B,CAAC,iBAAiB;AAH7C,iHAAA,kBAAkB,OAAA;AAClB,wGAAA,SAAS,OAAA;AACT,mGAAA,IAAI,OAAA;AAGN,YAAY;AACZ,2CAAiE,CAAC,iBAAiB;AAA1E,yGAAA,cAAc,OAAA;AAAE,yGAAA,cAAc,OAAA;AAEvC,mBAAmB;AACnB,uFAAuF"}

package/dist/src/types.d.ts

@@ -0,0 +1,217 @@
+/**
+ * 基礎選項接口，包含通用配置如並行數、重試次數、超時和進度回調
+ */
+export interface BaseOptions {
+    /** 並行處理請求的數量 */
+    concurrency?: number;
+    /** 網路請求失敗時的重試次數 */
+    retries?: number;
+    /** 請求超時時間（毫秒） */
+    timeout?: number;
+    /**
+     * 進度回調函數
+     * @param current 當前處理的項目數
+     * @param total 總項目數
+     * @param overallProgress 可選的總體進度百分比 (0-100)
+     */
+    onProgress?: (current: number, total: number, overallProgress?: number) => void;
+}
+/**
+ * 登入選項
+ */
+export interface LoginOptions extends BaseOptions {
+    /** Cookie 檔案的儲存路徑 */
+    cookiePath?: string;
+    /** 是否在登入成功或失敗後自動清理瀏覽器資源 */
+    autoCleanup?: boolean;
+}
+/**
+ * 連結解析選項
+ */
+export interface ParseOptions extends BaseOptions {
+    /** 自訂請求時使用的 User-Agent */
+    userAgent?: string;
+}
+/**
+ * 影片資訊獲取選項
+ */
+export interface FetchVideoOptions extends BaseOptions {
+}
+/**
+ * 用戶影片獲取選項
+ */
+export interface UserVideosOptions extends BaseOptions {
+    /** 限制獲取的影片數量，0 表示獲取全部 */
+    limit?: number;
+    /** 用於分頁的游標 (平台特定) */
+    cursor?: string | number;
+    /**
+     * 進度回調函數 (特定於用戶影片獲取)
+     * @param fetchedCount 已獲取的影片數量
+     * @param totalEstimated 預估的總影片數量 (如果可用)
+     */
+    onProgress?: (fetchedCount: number, totalEstimated?: number) => void;
+}
+/**
+ * 影片下載選項
+ */
+export interface DownloadOptions extends BaseOptions {
+    /** 是否覆蓋已存在的檔案，預設 false */
+    overwrite?: boolean;
+    /** 是否按用戶名創建子文件夾，預設 true */
+    useSubfolders?: boolean;
+    /** 檔名模板，預設 "{date}-{title}" */
+    filenameTemplate?: string;
+    /**
+     * 單個文件下載進度回調函數
+     * @param progress 當前文件的下載進度百分比 (0-100)
+     */
+    onFileProgress?: (progress: number) => void;
+    /** 自定義請求頭 */
+    headers?: Record<string, string>;
+}
+/**
+ * 登入結果
+ */
+export interface LoginResult {
+    /** 獲取到的 Cookie 字串 */
+    cookie: string;
+    /** 用於清理登入過程中創建的資源（如瀏覽器實例）的函數 */
+    cleanup: () => Promise<void>;
+}
+/**
+ * 連結解析結果
+ */
+export interface ParseResult {
+    /** 在原始文本中找到的URL */
+    originalUrl: string;
+    /** 標準化後的影片或用戶主頁 URL */
+    standardUrl: string;
+    /** 提取到的 ID (影片 ID 或用戶 ID) */
+    id: string;
+    /** 連結類型 */
+    type: 'video' | 'user' | 'unknown';
+}
+/**
+ * 通用影片資訊結構
+ */
+export interface VideoInfo {
+    /** 平台特定的影片 ID */
+    id: string;
+    /** 影片標題 */
+    title: string;
+    /** 影片描述 */
+    description?: string;
+    /** 用於播放或下載的影片 URL */
+    videoPlayUrl: string;
+    cdnPlayUrls: string[];
+    /** 影片封面圖片 URL */
+    coverUrl?: string;
+    /** 作者暱稱 */
+    userName: string;
+    /** 作者主頁 URL */
+    userUrl: string;
+    /** 平台特定的作者 ID */
+    userId?: string;
+    /** 影片發布日期 (建議 ISO 8601 格式) */
+    releaseDate?: string;
+    /** 影片時長 (秒) */
+    duration?: number;
+    /** 影片統計數據 */
+    stats?: {
+        playCount?: number;
+        likeCount?: number;
+        commentCount?: number;
+        shareCount?: number;
+    };
+}
+/**
+ * 通用用戶影片列表項結構
+ */
+export interface UserVideoItem {
+    /** 平台特定的影片 ID */
+    vid: string;
+    /** 影片描述/標題 */
+    description: string;
+    /** 影片創建時間戳 (秒) */
+    createTime: number;
+    /** 可選的影片播放/下載 URL */
+    videoPlayUrl?: string;
+    /** 作者資訊 */
+    author: {
+        /** 平台特定的作者 ID */
+        id: string;
+        /** 作者暱稱 */
+        nickname: string;
+    };
+    /** 影片統計數據 */
+    stats?: {
+        playCount?: number;
+        likeCount?: number;
+        commentCount?: number;
+        shareCount?: number;
+    };
+}
+/**
+ * 下載結果
+ */
+export interface DownloadResult {
+    /** 原始影片資訊 */
+    videoInfo: VideoInfo;
+    /** 是否下載成功 */
+    success: boolean;
+    /** 下載成功時的檔案路徑 */
+    filePath?: string;
+    /** 下載失敗時的錯誤資訊 */
+    error?: Error;
+}
+/**
+ * 認證服務介面
+ */
+export interface AuthService {
+    login(options?: LoginOptions): Promise<LoginResult>;
+    isValidCookie(cookie: string): Promise<boolean>;
+    loadCookie(cookiePath?: string): Promise<string | null>;
+    saveCookie(cookie: string, cookiePath?: string): Promise<void>;
+    loadAndValidateCookie(cookiePath?: string): Promise<string | null>;
+    getDefaultCookiePath(): string;
+}
+/**
+ * 資訊獲取服務介面
+ */
+export interface InfoService {
+    fetchVideoDetail(url: string, cookie: string, options?: FetchVideoOptions): Promise<VideoInfo | null>;
+    fetchVideosInfoUrls(urls: string[], cookie: string, options?: FetchVideoOptions): Promise<VideoInfo[]>;
+    fetchVideosInfoText(text: string, cookie: string, options?: FetchVideoOptions): Promise<VideoInfo[]>;
+    fetchUserVideos(userUrl: string, cookie: string, limit?: number, options?: UserVideosOptions): Promise<UserVideoItem[]>;
+}
+/**
+ * 下載服務介面
+ */
+export interface DownloadService {
+    downloadVideo(videoInfo: VideoInfo, outputPath: string, options?: DownloadOptions): Promise<DownloadResult>;
+    downloadVideos(videoInfos: VideoInfo[], outputPath: string, options?: DownloadOptions): Promise<DownloadResult[]>;
+    downloadVideosFromUrls(videoUrls: string[], outputPath: string, cookie: string, options?: DownloadOptions): Promise<DownloadResult[]>;
+    downloadVideosFromText(text: string, outputPath: string, cookie: string, options?: DownloadOptions): Promise<DownloadResult[]>;
+}
+/**
+ * 解析器服務介面
+ */
+export interface ParserService {
+    extractLinks(text: string): string[];
+    parseLinks(urls: string[], options?: ParseOptions): Promise<ParseResult[]>;
+    containsLink(text: string): boolean;
+}
+/**
+ * 支持的平台類型
+ */
+export type Platform = 'douyin' | 'tiktok';
+/**
+ * 特定平台的服務集合
+ */
+export interface PlatformServices {
+    auth: AuthService;
+    info: InfoService;
+    download: DownloadService;
+    parser: ParserService;
+}

package/dist/src/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// src/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+// 可以考慮添加一個工廠函數類型定義
+// export type PlatformServiceFactory = (platform: Platform) => PlatformServices;
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,eAAe;;AAsPf,mBAAmB;AACnB,iFAAiF"}

package/dist/src/utils/browser.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @deprecated 通用瀏覽器工具 - 已棄用。請改用 src/douyin/browser/manager.ts 中的函式。
+ * 提供 Puppeteer 瀏覽器管理功能
+ */
+import { Browser, Page } from 'puppeteer';
+/**
+ * @deprecated 瀏覽器管理器選項 - 已棄用。
+ */
+export interface BrowserManagerOptions {
+    headless?: boolean | 'new' | 'shell' | undefined;
+    timeout?: number;
+    userAgent?: string;
+    executablePath?: string;
+    userDataDir?: string;
+}
+/**
+ * @deprecated 登入專用瀏覽器處理結果 - 已棄用。
+ */
+export interface LoginBrowserResult {
+    page: Page;
+    browser: Browser;
+    cleanup: () => Promise<void>;
+}
+/**
+ * @deprecated 瀏覽器管理器 - 已棄用。請改用 src/douyin/browser/manager.ts 中的函式。
+ * 使用單例模式管理 Puppeteer 瀏覽器實例
+ */
+export declare class BrowserManager {
+    private static instance;
+    /**
+     * @deprecated 獲取 BrowserManager 單例 - 已棄用。
+     * @param options 瀏覽器選項
+     * @returns BrowserManager 實例
+     */
+    static getInstance(options?: BrowserManagerOptions): BrowserManager;
+    /**
+     * @deprecated 私有構造函數 - 已棄用。
+     * @param options 瀏覽器選項
+     */
+    private constructor();
+    /**
+     * @deprecated 獲取瀏覽器實例 - 已棄用。
+     * @returns Promise<Browser>
+     */
+    getBrowser(): Promise<Browser>;
+    /**
+     * @deprecated 創建新的頁面 - 已棄用。
+     * @returns Promise<Page>
+     */
+    newPage(targetUrl?: string, cookies?: string, blockResources?: boolean): Promise<Page>;
+    /**
+     * @deprecated 創建用於登入的獨立瀏覽器實例 - 已棄用。
+     * @returns Promise<LoginBrowserResult>
+     */
+    newLoginBrowser(options?: {
+        timeout?: number;
+        userAgent?: string;
+        executablePath?: string;
+        userDataDir?: string;
+    }): Promise<LoginBrowserResult>;
+    /**
+     * @deprecated 設置頁面的 Cookie - 已棄用。
+     */
+    setCookies(page: Page, cookieString: string | undefined, domain?: string): Promise<void>;
+    /**
+     * @deprecated 關閉瀏覽器實例 - 已棄用。
+     */
+    close(): Promise<void>;
+}
+/** @deprecated Use functions from src/douyin/browser/manager.ts instead. */
+export declare const browserManager: BrowserManager;
+/** @deprecated Browser lifecycle should be managed explicitly using closeBrowser from src/douyin/browser/manager.ts. */
+export declare function cleanupBrowser(): Promise<void>;

package/dist/src/utils/browser.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * @deprecated 通用瀏覽器工具 - 已棄用。請改用 src/douyin/browser/manager.ts 中的函式。
+ * 提供 Puppeteer 瀏覽器管理功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserManager = exports.BrowserManager = void 0;
+exports.cleanupBrowser = cleanupBrowser;
+const logger_1 = require("./logger"); // Use the utils logger
+/**
+ * @deprecated 瀏覽器管理器 - 已棄用。請改用 src/douyin/browser/manager.ts 中的函式。
+ * 使用單例模式管理 Puppeteer 瀏覽器實例
+ */
+class BrowserManager {
+    // Keep static instance for basic compatibility, but make it unusable
+    static instance;
+    // Remove internal state
+    // private browser: Browser | null = null;
+    // private browserInitPromise: Promise<Browser> | null = null;
+    // private options: BrowserManagerOptions;
+    /**
+     * @deprecated 獲取 BrowserManager 單例 - 已棄用。
+     * @param options 瀏覽器選項
+     * @returns BrowserManager 實例
+     */
+    static getInstance(options = {}) {
+        logger_1.utilsLogger.error('DEPRECATED: BrowserManager.getInstance is deprecated. Use functions from src/douyin/browser/manager.ts instead.');
+        if (!BrowserManager.instance) {
+            // Still create instance to avoid breaking existing getInstance calls immediately, but log error.
+            BrowserManager.instance = new BrowserManager(options);
+        }
+        return BrowserManager.instance;
+    }
+    /**
+     * @deprecated 私有構造函數 - 已棄用。
+     * @param options 瀏覽器選項
+     */
+    constructor(options) {
+        // Log error only once during construction if instance didn't exist
+        if (!BrowserManager.instance) {
+            logger_1.utilsLogger.error('DEPRECATED: BrowserManager constructor is deprecated and should not be used.');
+        }
+        // this.options = options; // Don't store options
+    }
+    /**
+     * @deprecated 獲取瀏覽器實例 - 已棄用。
+     * @returns Promise<Browser>
+     */
+    async getBrowser() {
+        logger_1.utilsLogger.error('DEPRECATED: BrowserManager.getBrowser is deprecated. Use launchBrowser from src/douyin/browser/manager.ts.');
+        throw new Error('BrowserManager.getBrowser is deprecated.');
+    }
+    /**
+     * @deprecated 創建新的頁面 - 已棄用。
+     * @returns Promise<Page>
+     */
+    async newPage(targetUrl, cookies, blockResources = true) {
+        logger_1.utilsLogger.error('DEPRECATED: BrowserManager.newPage is deprecated. Use newPage from src/douyin/browser/manager.ts.');
+        throw new Error('BrowserManager.newPage is deprecated.');
+    }
+    /**
+     * @deprecated 創建用於登入的獨立瀏覽器實例 - 已棄用。
+     * @returns Promise<LoginBrowserResult>
+     */
+    async newLoginBrowser(options = {}) {
+        logger_1.utilsLogger.error('DEPRECATED: BrowserManager.newLoginBrowser is deprecated. Use launchLoginBrowser from src/douyin/browser/manager.ts.');
+        throw new Error('BrowserManager.newLoginBrowser is deprecated.');
+    }
+    /**
+     * @deprecated 設置頁面的 Cookie - 已棄用。
+     */
+    async setCookies(page, cookieString, domain) {
+        logger_1.utilsLogger.error('DEPRECATED: BrowserManager.setCookies is deprecated. Use setCookiesOnPage from src/douyin/browser/manager.ts.');
+        throw new Error('BrowserManager.setCookies is deprecated.');
+    }
+    /**
+     * @deprecated 關閉瀏覽器實例 - 已棄用。
+     */
+    async close() {
+        logger_1.utilsLogger.warn('DEPRECATED: BrowserManager.close is deprecated and does nothing. Browser lifecycle should be managed explicitly using closeBrowser from src/douyin/browser/manager.ts.');
+        // No operation
+    }
+}
+exports.BrowserManager = BrowserManager;
+// 導出默認的瀏覽器管理器實例
+/** @deprecated Use functions from src/douyin/browser/manager.ts instead. */
+exports.browserManager = BrowserManager.getInstance();
+// 清理函數，用於在進程退出時關閉瀏覽器
+/** @deprecated Browser lifecycle should be managed explicitly using closeBrowser from src/douyin/browser/manager.ts. */
+async function cleanupBrowser() {
+    logger_1.utilsLogger.warn('DEPRECATED: cleanupBrowser is deprecated and does nothing. Ensure browsers are closed explicitly using closeBrowser from src/douyin/browser/manager.ts.');
+    // Do nothing
+}
+// --- Process Exit Handling ---
+// Removed all process exit handling as the singleton is deprecated
+//# sourceMappingURL=browser.js.map

package/dist/src/utils/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/utils/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4HH,wCAGC;AAzHD,qCAAiD,CAAC,uBAAuB;AAyBzE;;;GAGG;AACH,MAAa,cAAc;IACzB,qEAAqE;IAC7D,MAAM,CAAC,QAAQ,CAAiB;IACxC,wBAAwB;IACxB,0CAA0C;IAC1C,8DAA8D;IAC9D,0CAA0C;IAE1C;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,UAAiC,EAAE;QAC3D,oBAAM,CAAC,KAAK,CAAC,iHAAiH,CAAC,CAAC;QAChI,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,iGAAiG;YACjG,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,mEAAmE;QACnE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC3B,oBAAM,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;QACjG,CAAC;QACD,iDAAiD;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,oBAAM,CAAC,KAAK,CAAC,4GAA4G,CAAC,CAAC;QAC3H,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,SAAkB,EAAE,OAAgB,EAAE,iBAA0B,IAAI;QAChF,oBAAM,CAAC,KAAK,CAAC,mGAAmG,CAAC,CAAC;QAClH,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,UAKlB,EAAE;QACJ,oBAAM,CAAC,KAAK,CAAC,sHAAsH,CAAC,CAAC;QACrI,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,YAAgC,EAAE,MAAe;QAC5E,oBAAM,CAAC,KAAK,CAAC,+GAA+G,CAAC,CAAC;QAC9H,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,oBAAM,CAAC,IAAI,CAAC,wKAAwK,CAAC,CAAC;QACtL,eAAe;IACjB,CAAC;CACF;AAjFD,wCAiFC;AAED,gBAAgB;AAChB,4EAA4E;AAC/D,QAAA,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;AAE3D,qBAAqB;AACrB,wHAAwH;AACjH,KAAK,UAAU,cAAc;IAClC,oBAAM,CAAC,IAAI,CAAC,yJAAyJ,CAAC,CAAC;IACvK,aAAa;AACf,CAAC;AAED,gCAAgC;AAChC,mEAAmE"}

package/dist/src/utils/error.d.ts

@@ -0,0 +1,160 @@
+/**
+ * 通用錯誤處理系統
+ * 提供統一的錯誤類型和處理機制
+ */
+/**
+ * 錯誤碼枚舉
+ * 用於標識不同類型的錯誤
+ */
+export declare enum ErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    RATE_LIMIT_ERROR = "RATE_LIMIT_ERROR",
+    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
+    COOKIE_INVALID = "COOKIE_INVALID",
+    COOKIE_EXPIRED = "COOKIE_EXPIRED",
+    CAPTCHA_REQUIRED = "CAPTCHA_REQUIRED",
+    PARSING_ERROR = "PARSING_ERROR",
+    INVALID_URL = "INVALID_URL",
+    RESOURCE_ERROR = "RESOURCE_ERROR",
+    VIDEO_NOT_FOUND = "VIDEO_NOT_FOUND",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
+    CONTENT_RESTRICTED = "CONTENT_RESTRICTED",
+    DOWNLOAD_ERROR = "DOWNLOAD_ERROR",
+    DOWNLOAD_INTERRUPTED = "DOWNLOAD_INTERRUPTED",
+    FILE_SYSTEM_ERROR = "FILE_SYSTEM_ERROR",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    BROWSER_ERROR = "BROWSER_ERROR",
+    BROWSER_LAUNCH_FAILED = "BROWSER_LAUNCH_FAILED",
+    API_ERROR = "API_ERROR"
+}
+/**
+ * 應用程序錯誤類
+ * 統一的錯誤類，包含錯誤碼、原因和其他信息
+ */
+export declare class AppError extends Error {
+    readonly code: ErrorCode;
+    readonly cause?: (Error | unknown) | undefined;
+    readonly details?: Record<string, any> | undefined;
+    /**
+     * 創建應用程序錯誤
+     * @param message 錯誤消息
+     * @param code 錯誤碼，默認為 UNKNOWN_ERROR
+     * @param cause 原始錯誤，用於錯誤鏈
+     * @param details 錯誤詳情，可包含任何額外信息
+     */
+    constructor(message: string, code?: ErrorCode, cause?: (Error | unknown) | undefined, // Allow unknown cause
+    details?: Record<string, any> | undefined);
+    /**
+     * 獲取完整的錯誤消息，包括錯誤碼和詳情
+     */
+    get fullMessage(): string;
+    /**
+     * 判斷錯誤是否可重試
+     * @returns 是否可重試
+     */
+    isRetryable(): boolean;
+    /**
+     * 從通用錯誤創建 AppError
+     * @param error 通用錯誤
+     * @param code 錯誤碼，默認為 UNKNOWN_ERROR
+     * @param defaultMessage 默認錯誤消息，如果原錯誤沒有消息
+     * @returns AppError 實例
+     */
+    static from(error: unknown, code?: ErrorCode, defaultMessage?: string): AppError;
+    /**
+     * 創建網絡錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @returns AppError 實例
+     */
+    static network(message: string, cause?: Error | unknown): AppError;
+    /**
+     * 創建認證錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @returns AppError 實例
+     */
+    static authentication(message: string, cause?: Error | unknown): AppError;
+    /**
+     * 創建解析錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @returns AppError 實例
+     */
+    static parsing(message: string, cause?: Error | unknown): AppError;
+    /**
+     * 創建視頻未找到錯誤
+     * @param message 錯誤消息
+     * @param videoId 視頻ID
+     * @returns AppError 實例
+     */
+    static videoNotFound(message: string, videoId?: string): AppError;
+    /**
+   * 創建用戶未找到錯誤
+   * @param message 錯誤消息
+   * @param userId 用戶ID
+   * @returns AppError 實例
+   */
+    static userNotFound(message: string, userId?: string): AppError;
+    /**
+     * 創建下載錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @param url 下載URL
+     * @returns AppError 實例
+     */
+    static download(message: string, cause?: Error | unknown, url?: string): AppError;
+    /**
+     * 創建文件系統錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @param path 文件路徑
+     * @returns AppError 實例
+     */
+    static fileSystem(message: string, cause?: Error | unknown, path?: string): AppError;
+    /**
+   * 創建權限錯誤
+   * @param message 錯誤消息
+   * @param cause 原始錯誤
+   * @param path 文件路徑
+   * @returns AppError 實例
+   */
+    static permissionDenied(message: string, cause?: Error | unknown, path?: string): AppError;
+    /**
+     * 創建瀏覽器錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @returns AppError 實例
+     */
+    static browser(message: string, cause?: Error | unknown): AppError;
+    /**
+     * 創建API錯誤
+     * @param message 錯誤消息
+     * @param cause 原始錯誤
+     * @param statusCode HTTP狀態碼
+     * @returns AppError 實例
+     */
+    static api(message: string, cause?: Error | unknown, statusCode?: number): AppError;
+    /**
+     * 處理平台API特定錯誤 (需要平台特定實現來覆蓋或擴展)
+     * @param apiResponse API響應
+     * @param platform 平台標識 ('douyin', 'tiktok', etc.)
+     * @returns AppError 實例
+     */
+    static fromApiResponse(apiResponse: any, platform?: string): AppError;
+}
+/**
+ * 解析錯誤消息中的HTTP狀態碼
+ * @param error 錯誤對象
+ * @returns 狀態碼或undefined
+ */
+export declare function parseHttpStatusFromError(error: Error | AppError): number | undefined;
+/**
+ * 解析常見的網絡錯誤
+ * @param error 錯誤對象
+ * @returns 標準化的AppError
+ */
+export declare function parseNetworkError(error: Error | AppError): AppError;